xinghuo/group_xinghuo_jinrong
1
0
Fork 0
Code Issues Pull Requests 2 Actions Packages Projects Releases Wiki Activity
108 Commits 9 Branches 1 Tag
4fd2ec05c8b7c3b3f58dfe4f41bd4ecf5cac72c2
Commit Graph
7 Commits
Author SHA1 Message Date
GaoYiYuan_0626 497cee289f docs: 交接文档合并为单一入口 + 全仓指向统一到 交接文档.md §A/§B/§C 
背景：交接文档的定位是「给 AI 接手用的入口」，此前三份分散（项目根 交接文档.md
+ docs/交接文档-基金转换.md + docs/交接文档-架构改进.md），且 docs/ 两份停留在旧版
（v1.0 / v1.1，不含 T-0~T-2b、609 passed、D20 实施等进度），新会话极易被误导。

改动：
- 三份合并为项目根 交接文档.md v3.0（545 行 = §0 公共层 + §A 风控主线 + §B 基金转换线
  + §C 架构改进线）；该文件在 .gitignore:47 内，按用户要求不入库（交接文档只留本地）
- 全仓指向统一到 交接文档.md §A/§B/§C：AGENTS.md（含顶部新增「接手先读交接文档.md」）、
  docs/memory/{MEMORY,TODO,FRAMEWORK,ITERATION}、PRD-架构改进与稳定性加固、
  开发计划-架构改进、TODO-架构改进、开发计划-基金转换交易
- 两份 docs/交接文档-*.md 加「已废弃（2026-09-10）· 勿读」横幅并指向新入口，
  保留作历史留档（不删除）
- 记录事故：对 docs/ 下中文名文件使用 git rm 会静默抹除整个 docs/ 目录（复现 2 次、
  退出码 0），已零损失恢复；纪律写入 交接文档.md §0.4 与工作区记忆

无代码改动；pytest 609 passed / 3 skipped。
 2026-09-10 15:04:13 +08:00
GaoYiYuan_0626 c5182f1910 feat(convert): 基金转换 T-0/T-0b 门禁 + T-1 数据层 + T-2/T-2b 纯函数与实算回填 
T-0 / T-0b（门禁 · 2026-09-10）
- T-0：sqlite 与 MySQL 结构对齐 —— core_holding 统一为 qty/cost_amount/as_of/pnl_pct
  + PK + UNIQUE(customer_id, product_id)；补 core_product_nav；新增建库自校验
  _assert_ddl_aligned()（R-g）；test_db.py 增 3 条门禁用例（含反向验证门禁失效）
- T-0b：DB 账号分离（D20）—— 新增 scripts/core/00-grant.sql（三账号逐表授权）；
  settings.py 增 3 组账号；db.py 改 get_engine(db, role)，缓存键改为 (库名, 角色)，
  账号未配置回退单账号；core_ro→ro / gateway_repository→rw / risk·session_repository→rw；
  tests/conftest.py 四处显式 role="admin"（R-e）

T-1（数据层）
- scripts/core/01-ddl.sql：新建 core_fee_rule / core_share_lot / core_convert_lot_detail；
  core_trade 加 convert_group_id + idx_convert_group；core_product 加 8 列 + fee_rate 补 COMMENT
- 新增 07-seed-fee-rule.sql（赎回费 5 档 × 14 产品，按 22 号文 §10）/ 08-seed-share-lot.sql
  （58 行持仓 → 61 行批次，Σ remain_qty 恒等于 qty）/ 09-seed-org.sql（管理人 + TA +
  申购费率 + 最低持有余额，v1.1 按「管理人全产品线」重排）
- reset.ps1 追加 07/08/09；02-mysql-agent专用.sql 追加 risk_convert_detail
- tests/_ddl.py 同步 4 表 + 新增 REQUIRED_CONVERT_TABLES 建库门禁
- 新增 scripts/dev/verify_convert_seed.py（pymysql 等价 reset 流程 + 8 条 DoD 断言，
  含断言 ⑧「费率档 ↔ product_type 匹配」，越档即 FAIL）

T-2 / T-2b（纯函数包 + 示例实算回填）
- 新增 app/service/convert/ 7 文件：__init__ / types / calc / fee / nav / lot_bootstrap / errors
  （纯函数，不查库、不碰 SQL；所有量化显式 ROUND_HALF_UP；lot_bootstrap 用 zlib.crc32
   保证 D18 跨进程同源）
- 新增 tests/test_convert_calc.py 93 用例（12 类：HALF_UP 反向自证 / 分档边界 /
  FIFO 含同 confirmed_at 兜底 / 双口径 / 强制全转与强制赎回 / PRD §5.3 全链自证 /
  纯函数零 IO 依赖断言）
- 重写 scripts/dev/calc_convert_demo.py：去掉脚本内公式副本，改为调用生产 calc.py，
  末尾与 PRD §5.3 逐项比对（不一致即退出码 1），兼作一致性门禁

验证
- pytest 609 passed / 3 skipped（516 → +93，零回归）
- verify_convert_seed.py 8/8 PASS；calc_convert_demo.py 15/15 与 PRD §5.3 一致

文档：PRD v0.9.1（费率分类修正）· 架构 §7 签名回填 / §8.3 错误码注 / §15 T-2 完成 ·
开发计划 §1.5 新增 R-h + §4.2·§4.3 执行记录 · AGENTS.md · docs/memory
 2026-09-10 14:45:55 +08:00
GaoYiYuan_0626 ea9a132a40 docs: 基金转换（convert）设计阶段成果入库 
此前 AIcoding 第 1~3 步的产出仅存在于本地磁盘、未纳入版本库，本次一次性入库，
补齐「设计可追溯」。本提交为纯文档 + 一个实算脚本，**代码零改动**，接口契约与表结构不变。

入库 6 个文件：

- docs/PRD/PRD-基金转换交易.md（v0.9 · 需求权威：FR-C1~C16 / §4 表结构 / §5 接口 / §9 验收）
- docs/项目框架设计/架构设计-基金转换交易.md（v1.0 · 实现依据：D1~D20 / §5 事务补偿 /
  §11.1 DB 账号分离 / §15 任务映射 T-0~T-13 与 §15.1 依赖拓扑）
- docs/项目框架设计/基金转换-审查意见处置表.md（33 条外审处置 + §九 用户拍板记录）
- docs/项目框架设计/评审待办-风控主架构与基金转换.md（评审逐条判定 + 核实证据）
- docs/交接文档-基金转换.md（本线交接入口，读完即可开工）
- scripts/dev/calc_convert_demo.py（PRD §5.3 主示例实算回填脚本——派生值禁手算）

门控：PRD 已定稿并经独立评审闭环（M-7 已满足）；架构 v1.0 独立评审 13 条建议 0 悬空。
下一步：AIcoding 第 4 步「产出开发计划」，输入为架构 §15 / §15.1。
 2026-09-10 11:29:55 +08:00
GaoYiYuan_0626 037ce7edca docs(架构改进): 补齐 PRD/开发计划/TODO/交接文档，落地无密钥告警与 Redis 分布式锁 
一、流程文档（按 AIcoding 六步落地，供新会话从交接文档开工）
- 新增 docs/PRD/PRD-架构改进与稳定性加固.md：6 条 FR（文档勘误、非缺陷说明、
  无密钥启动告警、审计失败告警、Redis 分布式锁、中间件顺序测试）
- 新增 docs/项目框架设计/改进方案评审-问题清单与对比.md：24 项问题分档 A~G，
  经两轮独立 AI 评审，无阻断级错误
- 新增 docs/项目框架设计/开发计划-架构改进.md：HOW 层设计，含合并前只做低风险
  11 项的批次策略
- 新增 docs/项目框架设计/TODO-架构改进.md：T-101~T-109、T-201~T-202 可勾选项
- 新增 docs/交接文档-架构改进.md：自包含交接入口，hy3 新会话可直接开工
- 新增 docs/项目框架设计/架构设计说明书.md：按模块/分层逐一讲解的全量架构说明

二、代码改动（T-107/108/109、T-201.1、T-201.2）
- app/main.py：启动时 DEEPSEEK_API_KEY 缺失告警，明确告知将走降级回复
- app/utils/authz.py：越权审计失败日志补 trace_id，便于串联全链路
- app/api/audit_middleware.py：审计失败日志补 status/path/request_id
- app/service/risk/redis_gateway.py：新增 acquire_lock（SET NX EX）与
  release_lock（Lua 原子释放，只删自己的锁）
- app/service/risk/locks.py：run_locked 改为双层锁，Redis 为主、进程内锁为备；
  Redis 超时沿用 fn(locked=False) 降级语义，Redis 不可用（含测试 Fake 缺方法的
  AttributeError）安全退回进程内锁，绝不抛异常

三、文档勘误（A1/A2/A3）
- MEMORY.md：文件数 42→45、Tools 4→5
- 02-mysql-agent专用.sql：会话表 5→6
- 架构设计-风控模块.md：同步更正

四、测试
- 新增 tests/test_locks_redis.py：覆盖抢锁成功、占用超时、Redis 故障降级、
  Fake 缺方法降级、只删自己锁、三处调用点 key 前缀
- tests/test_audit_middleware.py：补充告警字段断言
- 全量 pytest 510 passed（原基线 503）
 2026-09-09 18:10:03 +08:00
GaoYiYuan_0626 1ac331b281 docs: 阶段一 AL-01~08 完成落账 + 文档同步——六件套反映换核完成(406 绿基线 425→406/SUIT-001~008 退役改 core_ro.check_suitability C×R 矩阵+JR-AST/FM 契约/risk_suitability_log 21 列/种子 33 客户 14 产品/risk-m1 已补打指向 3c07de6)；TODO 进行中改阶段一验收门(唯一卡点=用户目视确认)+AL-09/10/11 待办；ITERATION 追加阶段一完成行；REQUIREMENTS R-02 换核标注；开发计划 M1 改已补打；入库存档《修改报告-对齐main基准.md》(阶段一执行依据)与《实现方案-风控追加需求v1.1-C4C6.md》(阶段二编码依据)；吸收上会话遗留同步(分支口径 risk-control-agent/PRD v1.1 冻结标注/T-21 评审闭环/T-03/C1~C3 落账/交接文档指引) 2026-09-07 18:01:16 +08:00
GaoYiYuan_0626 eae28bee4e docs: PRD/规则表/开发计划合并需求追加 v1.1 修订 2026-09-07 12:46:59 +08:00
GaoYiYuan_0626 487b9da5b1 docs: 风控模块 PRD v1.0/规则附表/架构 v1.1/开发计划 v1.1 + 文档联动修正 2026-09-06 15:09:13 +08:00