xinghuo/group_xinghuo_jinrong
1
0
Fork 0
Code Issues Pull Requests 2 Actions Packages Projects Releases Wiki Activity
134 Commits 9 Branches 1 Tag
b4a61dc306ae4012ce0100240a24213daf472988
Commit Graph
100 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
GaoYiYuan_0626 b4a61dc306 文档：T-11 回写 + 全仓进度一致性（开发计划 DoD 全勾 + 执行记录 / 交接文档 v4.1 / TODO / MEMORY / AGENTS / 当日日志） 2026-09-12 09:35:13 +08:00
GaoYiYuan_0626 b2d8a90ad2 基金转换 T+1 模型：T-11 core_tools 汇总去重 + 持仓过滤（确认段场景补用例，生产代码零改动） 2026-09-12 09:35:13 +08:00
GaoYiYuan_0626 5a784dc185 文档：T-10 回写 + 全仓进度一致性（开发计划 DoD 全勾 + 执行记录） 
- 开发计划 v2.0：T-10 六项 DoD 全勾（申购落批次 / 哨兵不超扣 / T+2 半开区间
  双向 / 金额公式 D26 / 转换后不超扣验收 9 / rebuild 无漂移）+ 新增执行记录
  （改法、验证证据 844 passed、真库 89/89、突防验证、3 处断点与口径）
- 交接文档 v4.0（gitignore 不入库，本轮未提交）
- AGENTS.md 入口引用 → T-1~T-10 ✅ / 844 / 89/89 / 下一步 T-11
- docs/memory/TODO.md：T-10 完成条目 + 待办行 T-11~T-17
- docs/memory/MEMORY.md：进度 + 自检第 5/6 问 → 844 / T-1~T-10
 2026-09-11 21:24:40 +08:00
GaoYiYuan_0626 34c7d0840d 基金转换 T+1 模型：T-10 普通申赎批次维护 + T+2 校验 + rebuild_lots 
FR-C16 份额批次全生命周期 + FR-C25 T+2 可赎回 + redeem 份额申报 D26 落地普通赎回侧：

- trade_gateway：_redeem_quote 走 available_qty_with_inflight 硬校验（R-3，
  申报超可赎抛 InsufficientShares 不静默裁剪）；_maintain_lots redeem 分支
  三重裁剪 = T+2 过滤 → D8 补建 → 在途占用 → 哨兵 FIFO 扣减；subscribe 落新批次
- core_ro.list_share_lots / share_lot_repository.select_for_convert 加
  available_from T+2 半开区间过滤（R-4，日历缺行降级不过滤，金额/扣减同口径）
- gateway_repository 扣批次加哨兵 remain_qty >= :q（rowcount!=1 回滚防超扣）

验证：test_share_lot +10 / test_trade_gateway +1 → 全量 844 passed / 10 skipped
（基线 834 + 11 零回归）；真库 verify_convert_api 89/89（H 节提前 + H2 在途
占用拦截断言）；rebuild_lots --dry-run 58 持仓 0 补建 0 写入；突防验证区分度成立
 2026-09-11 21:24:32 +08:00
GaoYiYuan_0626 6ecde37885 文档：convert_fund 退役并入 T-13（用户 2026-09-11 裁定） 
开发计划 T-13 目标/改法 6/DoD/风险补「convert_fund 退役 + 清理 v1.0 依赖链」；
TODO 待办行补注裁定。本地提交，未推送远程
 2026-09-11 20:42:37 +08:00
GaoYiYuan_0626 2277d61568 文档：T-9 回写 + 全仓进度一致性（开发计划 DoD 全勾 + 执行记录 / 交接文档 v3.9 / TODO / 两份 MEMORY / AGENTS.md） 
开发计划 T-9 新增执行记录（附 2 处口径缺陷细节）；各入口进度统一
T-1~T-9 ✅ / 834 passed / 真库 verify_convert_api 88/88 / 下一步 T-10
 2026-09-11 20:37:51 +08:00
GaoYiYuan_0626 e04b44c44a 基金转换 T+1 模型：T-9 api 层（受理 202 + 撤单/确认/查询接口 + 网关分派 + redeem 份额申报） 
三接口路径以 PRD 为准（裁定 11/12）：
- app/api/convert_admin.py 新增 POST /api/simulate/trade/convert/{gid}/cancel（交易 owner 闸门）
  + POST /api/admin/convert/confirm?accept_date=（risk_officer）+ GET /api/simulate/trade/convert/{gid}（查询 scope 闸门）
- simulate.py convert 分支受理 202 + 受理回执（两类 202 分辨 accepted/processing）
- trade_gateway 分派改调 accept_convert（SUPPORTED_TRADE_TYPES 维持 2 类型）
- redeem 份额申报（D26/R-6：qty 入参，_redeem_quote = qty * T 净值 - 赎回费）
- errors.py 新增 CANCEL_NOT_ALLOWED / CONCURRENT_CONFLICT（均 409）

修正 2 处口径缺陷（测试打穿揭示，非只改测试）：
- _rebuild_quote 的 out_nav 改直读 core_convert_lot_detail.nav（反推致 1.3604 -> 1.3600 漂移）
- _accept_idempotent 字段面扩展与受理回执对齐（幂等重试客户端可取到预计确认日）

验证：端到端 13 passed（T+1 两段链路重写）；全量 834 passed / 10 skipped；
真库 verify_convert_api.py 88/88，存量 4 脚本零回归；3 组突变验证命中后还原
 2026-09-11 20:37:45 +08:00
GaoYiYuan_0626 9f28633e55 文档：T-8 回写 + 全仓进度一致性复核（订正 5 处漏同步） 
本轮在 T-8 提交（57f16a5）后做文档回写，并对全仓「同一事实的副本」做一致性扫描，
发现并当场订正 5 处漏同步（均属上次改了主状态位、漏改副本）：

- AGENTS.md 入口引用（最重要，属项目记忆已强调的「全仓同步入口引用」漏项）：
  T-1~T-6 ✅/797 基线/下一步 T-7 → T-1~T-8 ✅/829 基线/下一步 T-9；
  T-6 真库 verify_convert_accept.py 36/36 → 37/37，并并列 83/83、39/39。
- docs/memory/TODO.md：汇总待办行「T-8 ~ T-17（含已完成之引擎时机）」→「T-9 ~ T-17」；
  为 v0.x 线引用块加编号歧义提示（其 T-11/T-12 与新线同号且均涉 amount_view，易混）。
- docs/memory/MEMORY.md：自检问答第 6 问进度 T-1~T-7 ✅/827 → T-1~T-8 ✅/829。
- 开发计划（T-8 执行期订正，承 57f16a5 代码提交）：
  就地订正 T-7 执行记录第 2 条「T-8 剩余仅为 rules.amount_view」之误（F-10 明确 T-8 不动去重口径，属 T-11）；
  新增 T-8「执行记录」5 条差异裁定；DoD 全勾。

不入库但同批完成（交接文档.md 受 .gitignore 忽略）：
  - 顶部版本 v3.7 → v3.8；§③ 表格行；§B.11 状态块（T-8 完成 + 两处订正）；
  - 开工纪律行 T-1~T-6 → T-1~T-8；
  - §B.11「未落地（T-1 起执行）」立项期清单 → 「已落地」并附实测行号
    （01-ddl.sql 272/297/305 行；已进 reset.ps1 与 verify_convert_seed.py 清单），原文折叠留痕。

复核：全量 pytest -q → 829 passed / 10 skipped（16.37s，零失败）。
 2026-09-11 19:53:31 +08:00
GaoYiYuan_0626 57f16a50a1 基金转换 T+1 模型：T-8 引擎时机收口（调用点唯一性守护 + 受理不触引擎 + 真库链路切 T+1） 
【范围澄清】
引擎调用点在 T-7 即已迁到确认事务 commit 之后（engine_call.run_convert_engine 唯一出口），
受理段 accept_convert 自实现起就不含引擎调用 → R-7 已满足。本轮补齐**守护与端到端验证**。
注意 F-10 已明确：T-8 **不动**去重口径（amount_view 三处消费方原样不动，那是 T-11 的范围）。

【新增测试】
- test_convert_engine.py：test_process_convert_event_has_single_call_site —— AST 统计
  app/ 下 process_convert_event( 的 Call 节点**恰 1 处**且宿主为 run_convert_engine。
  用 AST 而非字符串匹配：engine_call.py 的说明段含该字样，会被误判。
  **已做突变验证**（临时加第二处调用 → 断言变红，随后还原）。
- test_convert_accept.py：受理无副作用用例补「不触引擎」断言 —— 受理后 risk_alert 0 行、
  无 pass / engine_error 审计（验收 29 前半）。
- test_convert_confirm.py：test_real_engine_on_confirm_dedupes_daily_total —— 确认链路接
  **真引擎**（不注入 hook）：正证（阈值夹逼 → RISK-002 不命中，去重生效）+ 反证（阈值下调
  → 命中，证明确认段确实跑过引擎），并断言一张单 / payload.events 两条 / 去重不删行（验收 5/6/7）。
  **已做突变验证**（禁用引擎调用 → 变红，随后还原）。

【真库脚本】
verify_convert_engine.py 整体切换 T+1 链路（此前走 v1.0 convert_fund）：
受理 accept_convert → 确认 confirm_one；新增 A0 组「受理不触引擎」；A~F 组保留原断言
（引擎出单 / RISK-002 夹逼 / 去重不删行 / 幂等重放 / 无命中 / 清理自检）。真库 39/39 一致。
- 折算期望改用 T 日净值（未知价法），不再沿用批次买入净值 alloc.nav；
- 基准日取真库日历中位开市日，T+1 = 下一交易日；
- 阈值必须显式传给 confirm_one —— 缺省退回 settings 默认会把 RISK-002 误判为命中，
  症状像「去重失效」，实为口径没传（首轮实跑被 B 组断言捕获，已钉进注释）。

【回归】
全量 829 passed / 10 skipped（827 → +2）；复跑 T-6 verify_convert_accept 37/37、
T-7 verify_convert_confirm 83/83、v1.0 链路 verify_convert_service 35/35，均零失败。
 2026-09-11 19:48:53 +08:00
GaoYiYuan_0626 0e27fec5cb 文档：T-7 确认段落地回写（开发计划 DoD 全勾 + 执行记录 / 交接文档 §B.11 / TODO / 两处 MEMORY） 
- 开发计划 T-7：DoD 9 项勾选 + 新增「执行记录」小节，逐条留痕 6 处与计划的差异裁定：
  ① 确认段不做最低持有重判（计划缺口，强制全转属受理段决策，受理单 remark 传承）；
  ② 新增 format/audit/engine_call 三共用模块（后者顺带完成 T-8 的「引擎时机改」）；
  ③ nav.py 未改（确认段直调 core_ro.get_nav_on，取 T−1 路径随 v1.0 convert_fund 一并删）；
  ④ test_convert_integration 改写推迟到 T-9（需端到端真接口）；
  ⑤ 受理单置 confirmed 并入 apply_convert 同事务（防「批次已扣、状态未置」中间态）；
  ⑥ MySQL rowcount=changed rows 陷阱（nav_pending 重试不得复用冲突判定）。
- 交接文档 §B.11：T-6→T-7 完成、基线 797→827、真库 36/36→37/37 与 83/83、
  新增 T-7 实施期发现段、下一步 T-8/T-9（并注明 T-8 范围已缩小）。
- docs/memory/TODO.md：进度行 + T-6 真库数 + T-7 条目勾选与详述。
- .workbuddy/memory/MEMORY.md 与 docs/memory/MEMORY.md：进度与关键裁定同步；
  当日工作日志补「续 3：T-7 确认段落地」。
 2026-09-11 19:37:30 +08:00
GaoYiYuan_0626 048f1a9e1e 基金转换 T+1 模型：T-7 确认段落地（confirm_service 三段编排 + T+1 批处理） 
【新增】
- app/service/convert/confirm_service.py：confirm_one（8 步确认）+ confirm_batch
  （按业务日捞单 / 整批锁 / 串行 / 单笔容错）。关键裁定：
  · T 日净值用 get_nav_on 精确匹配，缺则 nav_pending（绝不回退旧净值）；
  · 扣批次 + 2 条流水 + 转入批次 + 两端持仓 + 明细 + 受理单置 confirmed
    同处一个 Core 单库事务，状态被抢（rowcount!=1）→ 整事务回滚；
  · 引擎在事务 commit 后跑，异常不阻断已成立的交易（FR-C28）；
  · 部分成交 actual=min(申请,可用)，被抢部分占用自然释放（R-10）。
- app/service/convert/format.py / audit.py / engine_call.py：展示规格、审计、
  引擎调用三处共用出口抽出（受理/确认两段不再各写一份，避免口径漂移）。
- scripts/dev/verify_convert_confirm.py：真库验证 81 项断言，含 PRD §5.3.2
  示例在真库上逐字节重放（68020.00/612.18/67407.82/333.36/67074.46/34945.54/-0.0049）。

【修复 · 受理-确认接口契约缺口】
强制全转是**受理段决策**（受理时 qty 已收敛为实际全转量），确认段拿不到原始
申请量、无法复现该判定。修法：
- 受理段把 forced_full_transfer 落受理单 remark（新增 REMARK_FULL_TRANSFER）；
- 确认段改为**继承受理决策、不再重判最低持有**（plan_lots 不传 min_hold_qty）
  —— 重判会因 T→T+1 可用份额变化得出与受理承诺不一致的结论（擅自扩大客户指令）；
- remark 支持多标记 `;` 连接（full_transfer;partial）。
- MySQL rowcount=changed rows 陷阱：nav_pending 重试不得复用 transition_status
  的冲突判定，改为 status 未变时不迁移、返回 transitioned=False。

【其他】
- convert_service：新增 cancel_convert（T 日撤单，两道闸门）、_t1_t2_dates
  （日历边界 None 容错）；受理响应改为 PRD §5.3.1 字段；convert_fund 标 Deprecated。
- convert_core_repository：ConvertApplyInput 加 convert_request_id/diff_fee/
  request_remark；_apply_convert_once 末步 _confirm_request 事务内置状态守卫。
- convert_request_repository：_end_of_day 统一闭区间语义；新增 reject()。
- 测试：新增 tests/test_convert_confirm.py（24 例）；全量 827 passed / 10 skipped。
 2026-09-11 19:35:37 +08:00
GaoYiYuan_0626 f056fcd007 基金转换 T+1 模型：T-1~T-6 落地（DDL/数据层/语义收窄/锁/受理事务） 
AIcoding 第 5 步 todo 开发（开发计划 v2.0）前半段：

- T-1 3 张新表 DDL（core_convert_request 6 态 ENUM / core_trade_calendar /
  core_share_rule）+ 种子 + sqlite 单一事实源同步 + 列清单断言
- T-2/T-2b calc 扩展（product_round/redeem_amount/partial_qty）+ 真实净值实算回填
- T-3 convert_request_repository（6 态 + 条件 UPDATE 守卫）+ core_ro 三读方法
  + share_lot_repository.available_qty_with_inflight（R-3 在途占用推导）
- T-4 convert_repository.sync_mirror 成为 risk_convert_detail 唯一进度镜像写入口
  （旧三方法标 Deprecated，T-7 后删）
- T-5 locks.py 锁键构造器 convert_req_lock_key / convert_confirm_lock_key
- T-6 convert_service.accept_convert 受理事务（八步：锁→幂等→校验→受理日顺延
  →在途占用校验→落单→镜像+审计→202；不扣份额/不折算/不写流水）
  + tests/test_convert_accept.py（16 用例）
  + scripts/dev/verify_convert_accept.py（真库 36/36 一致）
  + trading_calendar.py 纯函数包（R-5）+ 21 用例

T-6 真库实测暴露并修复：confirm_eta 在日历数据边界抛 ValueError，会让已落库
的受理单在调用方眼里变 500；改为展示性字段容错 + 单测守护。

基线：798 passed / 10 skipped，零回归。
 2026-09-11 19:21:15 +08:00
GaoYiYuan_0626 3b781f8823 文档：开发计划 §10.6 回写死锁重试后补（43cf2a1）执行记录 2026-09-10 20:32:44 +08:00
GaoYiYuan_0626 43cf2a1372 基金转换 T-13 后补：apply_convert 死锁 1213 服务端自动重试（用户拍板） 
- 跨客户并发 InnoDB 1213 死锁由「抛给上层」改为数据访问层自动重试整个事务
  （MySQL 官方口径 Retry the entire transaction）；重试次数/退避基数走
  settings（convert_deadlock_retry_max/base_ms），只重试 1213，1205 等照旧上抛
- 真库证据：8 客户并发实测触发 4 次 1213，服务端重试全部第 1 次收敛，
  外部退避兜底 0 次触发，8/8 成功、份额守恒
- sqlite 单测 +3（重试后落库/预算耗尽上抛/1205 不重试）+ 2 组突变验证命中后恢复
- 全量 739 passed/10 skipped；CONVERT_STRESS 并发 9/9；真库 apply 24/24、service 35/35 零回归
 2026-09-10 20:30:30 +08:00
GaoYiYuan_0626 96fe1511d6 文档：回写 T-13 提交号 c56ea8d 
docs/memory/2026-09-10.md 补记 T-13 已提交与领先远程 16 个提交。
 2026-09-10 19:46:28 +08:00
GaoYiYuan_0626 c56ea8d50e 基金转换 T-13：全量回归 + 50 并发压测 + 性能实测补录 
交付：新增 tests/test_convert_concurrency.py（9 条 · CONVERT_STRESS 门禁）+ test_convert_service 同键重试 3 条；app/repository/convert_repository.insert_placeholder 改三步法（R-a）、app/service/convert/convert_service.py 幂等判定 pending→202。

修复 2 处并发缺陷（压测暴露，sqlite 不可见）：① 阶段一失败后同键重试永久 503（占位朴素 INSERT 撞 uk_group/uk_idem）；② 同键竞态子窗口 A 真·双扣 / B 双扣+503（撞 uk_idem 直穿）。

验证：pytest 736 passed / 10 skipped（+5，跑两遍稳定）；CONVERT_STRESS=1 并发 9/9；按 SOP 重灌双库复跑零回归；7 个 convert 真库脚本复跑零回归；突变 4 组全部精准命中。50 并发不超卖（成交 20~25）、紧池退避 40/50=80%（不够用）、松池 100%、跨客户 1213 死锁登记待评估；性能端到端 P50 44.2/max 59.8ms、阶段一 P50 9.8/max 16.7ms（未触阈值、未改实测值）。

文档：PRD v0.9.3（§9 第 18 条实测补录）+ 开发计划 §10（10.1~10.5）+ docs/memory/{TODO,MEMORY,FRAMEWORK,ITERATION,2026-09-10}。
 2026-09-10 19:46:08 +08:00
GaoYiYuan_0626 f1666b78de 文档：回写 T-12 提交号 
- docs/memory/2026-09-10.md 的 T-12 小节补 commit `22f2a41`
 2026-09-10 19:00:11 +08:00
GaoYiYuan_0626 22f2a41192 基金转换 T-12：补偿脚本（详情 + 预警） 
阶段二失败（或阶段 1.5 引擎失败）后，仅凭 Core 侧数据把「详情 + 预警」两件事补回来
（PRD §7.1 / 架构 §5.4）。

落地（改 3 + 新增 2 脚本 + 测试 2 文件）
- convert_service：新增公开 compensate_convert(group_id, ...) —— 补偿的服务端单点入口
  · 锁键 convert:rerun:{gid}，与 convert_fund 幂等重试路径同一个键
  · 详情侧：非 completed 才补写，复用 _finalize_from_core（不另写第二份阶段二）
  · 预警侧：幂等锚点 = 转出端 out_trade_id，复用 find_alerts_by_trade；
    命中即 skipped，否则跑 process_convert_event
- risk_repository：has_engine_error_audit 加 decision 参数（默认值不变）
  · convert 线阶段 1.5 失败审计用 engine_error，普通交易用 risk_engine_error，不是同一个码
- rebuild_alerts.py：新增 --convert-group（与 location 参数 trade_ids 互斥），薄封装
- 新增 scripts/agent/cleanup_pending_convert.py（架构 §2 与开发计划 §9 指定路径）：
  超 convert_compensate_sla_hours 的 pending 占位 → status='expired'（标记不硬删，S2）
- 新增 scripts/dev/verify_convert_compensate.py：真库验证脚本（MySQL 8.0.46）
- 测试 +12：test_convert_service +4（补写 / 幂等 / missing / locked）、
  test_demo_scripts +8（--convert-group 分派与接线 + cleanup 脚本）

state 四态与 CLI 退出码
- rebuilt(0) / skipped(0 幂等) / missing(1 零写入) / locked(3)
- 退出码 2 保留给 argparse 用法错误，故 locked 取 3

真库专属证据（sqlite 单测给不了的，本任务核心增量）
- status='expired' 在 MySQL ENUM 上被接受（sqlite 该列是 VARCHAR，写什么都收）
- created_at < cutoff 在 DATETIME(3) 上的时间边界正确（超时进候选 / 未超时不进 / 复跑幂等）
- input_summary 是真 JSON 列，而 has_engine_error_audit 用 LIKE 判定：脚本先断言
  information_schema 的 DATA_TYPE='json' 再验命中，并反向断言决策码不匹配则不命中

顺带收口（用户指示）
- core_ro.concentration_profile 补 h.qty > 0，与 list_holdings 真正同口径
  · ratio 不变（归零行市值为 0），但 rows 不再多出已清仓产品、不虚占截断判定位
  · 新用例含跨出口一致性断言；突变验证：去掉 qty > 0 → 精准 1 条红

验证
- pytest -q → 731 passed / 3 skipped（基线 719 加 12，零回归）
- 突变验证 3 组精准命中：去掉幂等锚点（1 红）/ 去掉 status 过滤（2 红）/ 补偿无视锁（1 红）
- 真库 verify_convert_compensate.py 34/34，隔离数据零残留
- 全套 7 个真库脚本复跑零回归：seed 全 PASS / apply 24 / service 35 / engine 31 / lots 20 / tools 14 / compensate 34
 2026-09-10 18:59:42 +08:00
GaoYiYuan_0626 a6ac39edd6 基金转换 T-11：工具与 SQL 汇总去重（FR-C15 / R-d） 
convert 在 core_trade 落两条流水（转出 redeem + 转入 subscribe，共享 convert_group_id），
所有金额聚合读取方必须只计一次，否则同笔转换金额翻倍。

落地（改码 3 处 + 新增 1 脚本 + 测试 3 文件）
- rules.py：_amount_view → 公开 amount_view（提升而非复制别名，全仓唯一金额聚合口径）；
  docstring 补「跨模块共用」说明
- core_tools.py：query_recent_trades 的 sum_amount 改走 amount_view（FR-C15）；
  items / total_count 保持全量不变——两条流水是真实的两笔权益变动，读到两条是对的
- core_ro.py：list_holdings 加 h.qty > 0（convert 转出全部份额留下的 qty=0 归零行不是持仓）；
  sum_trades_on_date 加 convert 去重条件（R-d），组内只计转出端
- 新增 tests/test_core_tools.py（3 条：汇总不翻倍 / 跨口径一致性 / 持仓不返回 qty=0 行）
- tests/test_core_ro_sum.py 追加 1 条 convert 去重用例（既有断言零改动）
- 新增 scripts/dev/verify_convert_tools.py：真库验证脚本（MySQL 8.0.46）

执行期裁定 2 条（已留痕）
- _amount_view 提升为公开而非复制：一个函数两个名字会漂移（自检第 13 问）
- SQL 条件从 IS NULL 扩为 IS NULL OR = ''：Python 的 if not gid 把空串当无组，
  而 SQL 里 '' IS NULL 恒假。真库实证：只写 IS NULL → 合计数 400000（正确 450000，漏算 50000）。
  不加则 RISK-002 漏算，且 sqlite 单测若只造 NULL 数据永远发现不了
- 等价性边界：组内无 redeem 时 SQL 丢整组、amount_view 保留首条；由 R-b 保证不可达

验证
- pytest -q → 718 passed / 3 skipped（基线 714 加 4，零回归）
- 突变验证 3 组均精准命中：去掉去重条件（2 红）/ 去掉 qty>0（1 红）/ 汇总不走 amount_view（2 红）
- 真库 verify_convert_tools.py 14/14，隔离数据零残留
- 复跑受影响真库脚本零回归：T-8 31/31、T-7 35/35、T-10 20/20
 2026-09-10 18:40:27 +08:00
GaoYiYuan_0626 5c2dc94b40 文档：回写 T-10 提交记录与订正后口径 
- docs/memory/2026-09-10.md 追加 T-10 提交记录（5e6fa06，领先远程 11 个提交、未推送）、
  提交含三部分说明、订正后口径（redeem 的 amount ÷ 净值 属项目简化，见 PRD §10.1）
- 记录交接文档 §B 两处状态漏改的订正（原仍写「下一步 = T-10」，已改为 T-10 已完成）
 2026-09-10 18:29:57 +08:00
GaoYiYuan_0626 5e6fa06d03 基金转换 T-10：普通申赎批次维护（FR-C16） 
让 core_trade 的普通申赎同步维护 core_share_lot 批次，为 convert 提供权威份额口径。

落地（改码 3 处 + 新增 2 个脚本）
- gateway_repository：新增 insert_share_lots / deduct_share_lots，各自单事务、走 rw 账号；
  只落已分配结果、不含分配逻辑，避免出现第二份 FIFO 口径
- share_lot_repository：__init__ 增可选 core_ro 入参，让 trade_gateway 复用同一份 FIFO 选批口径（D18）
- trade_gateway：新增 _nav_as_of / _maintain_lots，在落流水后、规则引擎前调用
  · subscribe：取 T 日（含）前最新净值 → qty = amount ÷ 净值（2 位 HALF_UP）→ 建批次（confirmed_at = T）
  · redeem：FIFO 扣减；无批次但有持仓 → D8 兜底补建后再扣；两者皆无 → 降级跳过
  · 整段 try 包住，任何异常只 warning，绝不阻断交易（R-c(1)）
- 新增 scripts/core/rebuild_lots.py：按 core_holding 快照重建批次（L-7），与网关 D8 同调 bootstrap_lots；
  默认只补建无批次的持仓行（幂等），--force 才先删后建，--dry-run 只报告
- 新增 scripts/dev/verify_convert_lots.py：真库验证脚本（MySQL 8.0.46）

口径订正（联网查证 4 家管理人业务规则后）
- redeem 的 amount ÷ 净值 折算属本项目简化建模，不是行业标准
- 行业铁律是「金额申购、份额赎回」：投资者以份额申报，登记机构按 T 日净值算金额
  （睿远业务规则 §65 / 华泰保兴 §69 / 东方基金 §57 / 国投瑞银 §33；无一家公募支持按金额赎回）
- 派生风险：未知价法下 T 日净值当日不可得（T+1 公告），_nav_as_of 实取 T−1 净值，
  故此处算出的份额只是估算值
- 已记入 PRD §10.1 已知差异清单；trade_gateway 注释同步订正

验证
- pytest -q → 714 passed / 3 skipped（基线 697 加 17，零回归）
- R16 test_redeem_accepted_without_alert 零改动通过（由 R-c(1) 降级保住）
- 真库 20/20；T-6 24/24、T-7 35/35 复跑零回归；真库隔离数据零残留
- 突变验证 2 组：切断接线 → 精准 2 条红；关掉 D8 兜底 → 精准 2 条红（含 D18 同源断言）
 2026-09-10 18:28:48 +08:00
GaoYiYuan_0626 e80098b32f 文档订正：远程状态认知纠错（refs/remotes 写入不落盘）+ 交接清单过期基线 
T-8/T-9 提交时两次依据 git branch -r / branch -vv 判定「远程分支不见了」并向用户报警，
两次均为误报。本次深挖确认根因，并订正此前写入的错误表述。

- docs/memory/MEMORY.md 交接清单第 7 问重写：
  本仓 .git/refs/remotes/** 写入不落盘 —— git update-ref refs/remotes/origin/X 返回 0、
  reflog 也建了，但松散引用消失，且会把整个 refs/remotes/origin/ 目录删掉（含手工放进的文件）；
  git fetch 报告 [new branch] ... -> origin/risk-control-agent 后同样不落盘。
  故此前记的「stale tracking ref，git fetch 即恢复」是错的，fetch 并不修复。
  对照证据：写 refs/heads/** 完全正常；同一 git（2.55.0.windows.3）在 /tmp 新建仓库里写
  refs/remotes/** 完全正常 → 只此仓库特有；已排除外部进程删目录（marker 静置存活）、
  重解析点（lstat FILE_ATTRIBUTE_REPARSE_POINT=False）、hooks / commondir / 浅克隆。
  补绕过方案：packed-refs 是可靠存储，手工追加 <sha> refs/remotes/origin/<name> 后
  git branch -r 立即正常（还原=删掉该行）。
  补影响面：提交 / fetch 抓对象 / push 均不受影响（git push --dry-run 实测
  fffb78a..d0097d6 成功），仅影响本地显示与上游跟踪。
  顺手订正验证条目里过期的「516 passed / 3 skipped」→ 697，及第 73 行同款旧表述。
- docs/memory/2026-09-10.md 追加排查记录：7 条可复现证据 + 三步对照实验 + 绕过方案 + 影响面。
 2026-09-10 18:07:43 +08:00
GaoYiYuan_0626 d0097d6004 基金转换 T-9：API 模型 + 网关分派（HTTP 层 convert 走通）+ 展示位数口径修复 
一、T-9 本体：HTTP 层 convert 端到端走通

- api/simulate.py：TradeRequest 三型字段分池（subscribe/redeem → product_id+amount；
  convert → from/to_product_id + qty + 可选 client_request_id）+ model_validator 分支校验；
  未知类型放行给网关抛 400（保住既有 purchase → 400 断言）；model_dump(exclude_none=True)；
  PROCESSING → 202；异常捕获由 except LookupError 收窄为 except NotFoundError
  （原写法把 KeyError 这类编程错误静默转成 404，实测掩盖 convert 分支真实诊断）。
- gateway/trade_gateway.py：移除 convert 显式拒绝，新增 _submit_convert 分派
  （只做参数映射 + 仓储装配）；convert 不写 trade_request 审计（审计归 convert_service）。
- utils/response.py：错误体合入 exc.extra（TOO_MANY_LOTS 的 batch_count/max_lots）；
  既有 ApiError 无 extra 属性 → 老错误体逐字节不变。
- utils/trace.py + main.py：正则收敛单点定义。执行期发现 trace.py 与 main.py 各有一份
  内容完全相同的白名单副本 —— S4 要防的「漂移」其实已经发生，现将常量上移 trace.py
  成公开 HEADER_ID_PATTERN（同时解决 main→simulate 反向导入成环）。

二、展示位数口径修复（执行期发现 → 联网核验 → 修复 → 文档订正）

发现：同一逻辑响应两种写法 —— 首次 "53456.95" vs 幂等重放 "53456.9500"，数值相等、字符串不等。
根因不是 T-7 写错，是契约缺位：§2.5 只规定「金额/份额 2 位」，净值、费率、申请份额的
回显位数根本没定义 → 实现只能 str(Decimal) 原样出网 → 位数随数据来源漂移。

修复：convert_service 新增 _q(value, unit) + _D2/_D4 规格常量作对外唯一出口 ——
金额/份额 2 位、净值/费率/份额尾差 4 位；响应 + 审计 summary + 异常日志共用该出口；
原 _s() 全部替换。首次路径幂等（除 requested_qty/actual_qty/lot[].qty 由 4 位补齐 2 位外不变）。

依据（2026-09-10 联网核验 7 家管理人公告）：金额/份额「四舍五入保留至小数点后两位」；
「申请转换份额精确到小数点后两位」；净值保留 4 位第 5 位四舍五入（中欧/国泰公告由 3 位提高至 4 位）；
费率以百分比 2 位表示。已知不统一：易方达 ETF 场外份额取整数位、南方基金取截断 → 取主流口径
并记入 PRD 已知差异（未来接真实 TA 需按基金合同配置化）。

三、文档订正

- PRD → v0.9.2：§2.5 拆 2.5.1 计算精度 / 2.5.2 展示位数（新增按字段分类的规格表 + 外部依据）；
  §5.3 示例 requested_qty/actual_qty/lot_breakdown[].qty 4 位 → 2 位（原示例与 §2.5
  「计算与对外展示按 2 位」自相矛盾，属漏改）；字段类型约定补「位数不自由 + 两条路径须逐字节一致」。
- 架构 → v1.0.1：§1 原则 11 补「str() 前必须按 §2.5.2 量化」，无结构变更。

四、验证

- 新增 tests/test_convert_integration.py（8 条真 MySQL 端到端，CNV-TEST-/TRD-TEST- 前缀隔离）：
  折算与 PRD §5.3 逐项吻合、两条流水同组、持仓与批次如实变动、明细 completed + 审计、
  幂等重试不产生第二组、跨主体 400、未知类型 400，以及
  「首次与重放逐字段逐字节相等」+「展示位数规格」两条新闸门。
- test_trade_gateway.py +17（11 条错误码映射全表参数化 · 202 · 200 透传 · 不写 trade_request 审计）。
- test_integration_risk.py：R15 处置 —— 端到端已迁入新文件，原槽位改造为
  test_invalid_type_400_and_no_new_trade_audit（改用 purchase 触发），保住「校验失败不落审计」不变量。
- pytest -q → 697 passed / 3 skipped（基线 672 +25，零回归）。
- 真库复跑：T-6 24/24 · T-7 35/35 · T-8 31/31；calc_convert_demo.py 15/15。
- 突变验证 4 组：关掉 convert 分派 → 21 条红；关掉错误体 extra 展开 → 精准 1 条；
  关掉 client_request_id 正则 → 精准 1 条；关掉 _q() 展示量化 → 2 条红
  （assert '50000.0000' == '50000' 直接复现原缺陷）。均已恢复。
 2026-09-10 18:00:20 +08:00
GaoYiYuan_0626 7ad1c8204d 基金转换 T-8：规则引擎改造（_amount_view 去重视图 + process_convert_event） 
一次转换落两条流水（转出 redeem + 转入 subscribe，同 convert_group_id），
金额聚合类规则若两条都算会翻倍报假预警，故按「逐笔 / 聚合」拆成两个视图。

- rules.py：新增 _amount_view —— 同组内只保留 redeem 那条（无 convert_group_id
  的交易恒等通过、组内无 redeem 保首条、绝不删行）；run_rules 双视图分流：
  RISK-001/003/004 用全量 eligible（逐笔判定），RISK-002/005 走金额视图去重。
- alert_service.py：抽出公开 build_trade_event（事件体结构唯一定义），
  record_trade_alerts 新增可选 events 参数；缺省 None 退化为单条，
  既有调用零改动。新建单落 payload.events 全部，聚合追加只追首条（只认转出端）。
- engine.py：抽 _run 共用实现；process_trade_event 变薄封装（签名与行为不变）；
  新增 process_convert_event(out_trade, in_trade, ...) 与 _notify_error_hook
  （hook 自身异常吞掉，原始异常照常上抛）。

实质影响：阶段 1.5 从「ImportError 静默跳过」变为「真跑」——T-7 部署时
process_convert_event 不存在，T-8 落地后同一笔转换会真实出单 + 写 L3 + 落审计；
T-7 真库脚本复跑仍 35/35，无连带破坏。

验证：新增 tests/test_convert_engine.py（15 用例）+ test_convert_service.py
接线回归 1 条；pytest 672 passed / 3 skipped（基线 656 +16，零回归）；
新增 scripts/dev/verify_convert_engine.py 真 MySQL 验证 31/31；
突变验证（关掉去重视图 → 4 条变红）确认用例非假绿。
 2026-09-10 17:34:35 +08:00
GaoYiYuan_0626 318cb39a1f 基金转换 T-7：convert_service 八步编排（关键路径 · 幂等前置 + 三阶段） 
- 新增 app/service/convert/convert_service.py：八步编排（①-④ 校验不落库 / ⑤ 占位 /
  ⑥ apply_convert / ⑦ 阶段 1.5 引擎不阻断 / ⑧ 回写 + 审计），幂等判定前置到校验之前
  以修复同键重试误报 InsufficientShares
- 新增 tests/test_convert_service.py（17 用例）
- 新增 scripts/dev/verify_convert_service.py（真 MySQL 验证 35/35）
- 改 app/repository/convert_repository.py：complete_convert 由纯 UPDATE 改三步法
  upsert（无占位直跑也能落完成行，R-a 口径）
- 改 app/repository/core_ro.py：新增 has_convert_trades / list_convert_trades /
  list_convert_lot_details 三个只读方法
- 改 app/config/settings.py：新增 6 个 convert 配置项
- 修 tests/test_convert_calc.py：TestPurity 排除编排层 convert_service.py

基线 639 → 656 passed / 3 skipped，零回归
 2026-09-10 17:12:01 +08:00
GaoYiYuan_0626 82c9467fb7 基金转换 T-6：apply_convert 阶段一单事务（core 库唯一写入口） 
新增 app/gateway/convert_core_repository.py：两条流水（redeem/subscribe，
R-b 不使用 ENUM 的 convert）+ N×条件 UPDATE 批次扣减 + 转入新批次
+ 两端 core_holding + N×计费明细，全部收口在 with engine.begin() 单事务。

实现级要点（与开发计划 §6.1 的三处差异，已回写该节执行记录）：
- core_holding 改用「基于列当前值的增量 UPDATE」，入参不带持仓快照：
  MySQL 的 UPDATE 是当前读，并发两笔自然累加；用快照算绝对值会互相覆盖。
- 数值参数参与算术时写成 (:x + 0.0)：实测 sqlite 在 UPDATE 算术表达式中
  不把 TEXT 绑定参数转数值（传 '120' 时 c 不变），加 +0.0 后两库一致。
- pnl_pct 拆成独立 UPDATE 重算，避开 MySQL「SET 从左到右」的顺序坑。

验证：pytest 639 passed / 3 skipped（基线 634 +5，零回归）；
新增 scripts/dev/verify_convert_apply.py 真 MySQL 验证 24/24 一致，
含真并发两笔首次转入同一产品的终态断言（MySQL RR 的 gap lock 实测留痕）。
 2026-09-10 16:26:42 +08:00
GaoYiYuan_0626andWorkBuddy 4fd2ec05c8 基金转换 T-4+T-5（并行组 A）：convert_repository 代理侧 + locks.try_lock 非阻塞抢锁 
T-4（convert_repository · agent 库 risk_convert_detail）：
- 新增 7 方法：insert_placeholder(占位 pending) / complete_convert(回写 completed+折算详情)
  / mark_failed / get_by_group_id / get_by_client_request_id(None 直接返回 None)
  / list_expired_candidates(hours) / mark_expired(S2 标记不硬删)
- 引擎走 agent 库 rw（D20）；status 5 值枚举；不与 risk_repository 混职责
- Decimal 折算字段经 _to_bind 转 float 绑定（sqlite 不支持直接绑 Decimal，同 T-3）

T-5（locks.try_lock）：
- 单次非阻塞抢锁：抢到返回 _Token(with 进入 True)，抢不到立即 _NoLock(进入 False，不等不降级)
- Redis 不可用退回进程内 Lock.acquire(blocking=False)；_NoLock.__enter__ 返回 False 避免 with None 报错
- 不改 run_locked（D4：其等 2s 后降级 fn(False)，语义相反；3 处调用点零改动）

测试：test_convert_repository.py 6 用例 + test_locks_redis.py +4 用例（既有 6 例零改动）
pytest 全量 634 passed / 3 skipped（基线 624 + 10，零回归）

Co-Authored-By: WorkBuddy <workbuddy@tencent.com>
 2026-09-10 15:53:31 +08:00
GaoYiYuan_0626andWorkBuddy 3244922a55 基金转换 T-3：core_ro 新增 5 个只读方法 + share_lot_repository 读侧 
- core_ro 新增 get_nav_as_of(D10) / get_redeem_fee_rules / list_share_lots(S1 确定性排序)
  / sum_remain_qty(仅 >0) / get_holding；不动 get_latest_nav 与 list_trades_range 白名单
- 新增 share_lot_repository：core_share_lot 读侧 FIFO 贪心选批 + 汇总，排序复用 core_ro 的 ORDER BY(D18 单一副本)
- 新增 tests/test_share_lot.py 15 用例；pytest 全量 624 passed / 3 skipped(基线 609，零回归)
- 同步开发计划 §5.1 执行记录与交接文档 §B 状态(v1.5 / T-3 ✅ / 基线 624)

Co-Authored-By: WorkBuddy <workbuddy@tencent.com>
 2026-09-10 15:42:55 +08:00
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 fffb78a11c docs: 记忆文件同步架构改进交付态（纯文档，零代码） 
- 架构设计说明书.md：同步桌面终版——§2.1 补 trace 顺序测试守卫、§4.2.1 无 key 告警闭环、
  §4.3.4 重写为 Redis 双层锁（TTL 30s/Lua 释放/进程内备）、§5.3/§6.10/§7.1/§7.2/§7.3/§7.4/§9.4
  锁与告警状态更新、基线 510
- FRAMEWORK/FLOW/REQUIREMENTS：风控 Tool 四→五（补 query_overdue_alerts）、词表 42→45 口径
- README：risk-m3 tag 注记 + API 契约表改五只读 Tool
- 注：交接文档.md v2.2 同步更新（该文件被 .gitignore 忽略，仅本地）
 2026-09-09 20:06:53 +08:00
GaoYiYuan_0626 d102beadd8 docs(MEMORY): 移除误称「老洪」，统一用中性「用户」指代 2026-09-09 19:10:59 +08:00
GaoYiYuan_0626 05096a81db docs(MEMORY): 明确远程合并责任边界——合并 main 归执行人，不归用户，AI 不主动发起/执行 PR 2026-09-09 19:09:16 +08:00
GaoYiYuan_0626 fbfa196af2 docs(README): 重写为「更新说明」小节，突出 Redis 双层分布式锁改动并修正已推送状态 2026-09-09 19:06:45 +08:00
GaoYiYuan_0626 fadc5e1697 docs(MEMORY): 架构改进状态由「待 push」更正为「已推送 origin/risk-control-agent」 2026-09-09 18:58:13 +08:00
GaoYiYuan_0626 f733fc2305 docs: 记录架构改进 T-101~T-202 完成（pytest 510 绿，待合并） 
- README 新增「架构改进与稳定性加固」小节 + 503→510 计数
- MEMORY §0/§1/§4/§7 同步 510 绿与分支状态 + locks 双层锁说明
- TODO 已完成区补 T-101~T-202 合并提示（零接口/表变更）
 2026-09-09 18:30:44 +08:00
GaoYiYuan_0626 7230d80477 docs: 修正 2026-09-09 日志中关于测试数记录的表述 2026-09-09 18:16:17 +08:00
GaoYiYuan_0626 e80f5a1b8c docs(架构改进): 回写执行状态，纠正测试数为实测 510 
- TODO-架构改进.md：T-101~T-202 全部勾选；用例数由 hy3 记录的 511 纠正为
  实测 510（503 基线 + 6 条锁测试 + 1 条中间件顺序守卫）；手工冒烟项保持
  未勾选并标注待执行，避免被误读为已验证
- 交接文档-架构改进.md：升 v1.1，新增「当前状态」块（已完成/遗留/改动文件
  清单）、§2 状态列、§7.3 勾选、§10 收尾动作；注明《架构设计说明书》存在
  两个文件并存（架构设计-风控模块.md 与全量版 架构设计说明书.md），避免改错
- docs/memory/2026-09-09.md：追加 commit 037ce7e 的提交与复核记录
 2026-09-09 18:15:08 +08:00
GaoYiYuan_0626 adac28f6f7 架构改进收尾：勾选 TODO T-101~T-202 并追加实施记录 
- docs/项目框架设计/TODO-架构改进.md：T-101~T-202 逐项勾选，补充实测用例数（510）与文档文件名差异备注
- docs/memory/2026-09-09.md：新增实施记录（改动文件、纪律核查、未做项）
- 实现代码已于 037ce7e 提交，pytest 510 绿，未 push
 2026-09-09 18:13:54 +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 2d0e2fa0fe docs: README/AGENTS/MEMORY 同步前端接入面（方案 B+C）与 503 基线 2026-09-08 14:29:33 +08:00
GaoYiYuan_0626 458dbdc7a6 docs: 登记方案 C 交付与遗留项 2026-09-08 14:24:08 +08:00
GaoYiYuan_0626 01ec5fce32 feat(chat): 新增 SSE 流式对话端点 POST /api/chat/stream（方案 C） 
契约（OpenAI 兼容 chunk，AI SDK / fetch-event-source 可直接接）：
首帧 meta（session_id/trace_id/disclaimer）→ delta → finish_reason=stop → [DONE]。
前端侧：免责声明由首帧下发、前端常驻渲染；落库文本仍按原口径拼尾部。

设计拍板：
1. 新增独立端点，原 POST /api/chat 契约与既有测试零影响；
2. 鉴权/限流/输入防护全部在返回 StreamingResponse 之前完成（SSE 一开就改不了
   状态码），401/403/404/409/429/400 仍是普通 JSON；
3. 整轮一次性落库：中途异常/断连不落消息（Tool 留痕已落可审计），不产生
   半截内容污染历史窗口。

实现：
- agent_service：抽 needs_disclaimer/_degraded_reply/_base_state；新增 stream_chat
  生成器（Tool 节点同步跑完再推 LLM 文本，无 key 走降级整块）；
- api/chat：抽 _guard_request（准入→空白→限流→注入拦截）与 _prepare_turn
  （归属+会话解析/创建），同步与流式共用，守卫零偏差；
- session_repository：新增 insert_turn——user+assistant 同事务落库 + 事务内
  取 seq，修掉评审 P0（落库失败会半截落且前端收不到 [DONE] 挂起）与 P1
  （两次写非原子）；同步端点一并改用。

测试：新增 9 例（契约/免责/降级/异常不落库/落库失败/鉴权边界/超长/closed/Tool
留痕），全量 pytest 494→503 绿。遗留：无心跳帧（长生成空隙靠反代 timeout 配置），
断连留空会话待清理策略。
 2026-09-08 14:23:33 +08:00
GaoYiYuan_0626 af7ba00327 docs: 同步前端接入方案 B 交付与风险经理对话线口径 2026-09-08 14:08:42 +08:00
GaoYiYuan_0626 8328c2403e feat(chat): 新增前端拉侧三端点（会话列表/历史消息/关闭会话） 
方案 B：补前端对话页「拉」侧能力（chat 此前只有 POST 发消息）：
- GET /api/chat/sessions：本人 + 本 Agent 线会话分页列表（created_at 倒序，total 供分页器）
- GET /api/chat/sessions/{id}/messages：历史消息 seq_no 升序分页（closed 会话仍可读）
- POST /api/chat/sessions/{id}/close：active→closed + closed_at；重复/非 active 409

守卫复用：抽取 _resolve_agent_type / _assert_chat_entry / _guard_session，
POST "" 改为复用同套守卫（行为零回归）；risk_manager 在对话线数据面保持
同口径 403（PRD 4A.1 冻结）；会话仓储新增 list_sessions / list_messages_page /
close_session（条件更新防并发静默写）。

测试：新增 12 例（分页、越权 403+留痕、404、409、manager 拒绝、limit 钳制、
JWT 通道），路由挂载清单同步；全量 pytest 482→494 绿。独立 AI 评审 P0=0，
P1（close 并发 rowcount 静默 200）已修复。
 2026-09-08 14:07:38 +08:00
GaoYiYuan_0626 08e831aaf1 docs: README 重写——面向后续人员的分支导览 
- 新增「你是哪种后续人员」分流表：接手开发/合并执行人/需求评审/环境演示各取所读
- 模块交付状态+里程碑表(m1~m4 全量)+模块自治架构定位说明
- 铁律速览(六条红线) / 后端结构注释细化(scripts/tests/data 职责)
- 快速启动更新：测试基线 406→482；演示库重灌两步缺一不可警告；JWT 调用示例(签发+双头)；dev debug 头兜底说明
- 核心接口一览表(6 端点×权限矩阵)
- 文档地图补全：合并注意事项/边界标注/需求拆解/业务记忆管理
 2026-09-07 20:55:00 +08:00
GaoYiYuan_0626 96dcec931e docs: 合并注意事项手册(给合并执行人) + 文档口径清理 
- 新增《合并注意事项-风控模块并入main.md》：面向合并执行人的 AL-09 操作手册——
  基底锁定(本地 main 3995cb4,origin/main 停在 Initial commit 勿用)/20 冲突文件
  指引裁决表/14 个静默并入文件清单(11 代码+3 测试,双套风险与边界防呆)/三处
  硬伤处置(issuer 不统一/STAFF-90001 必保/infer_roles fail-open P1)/合并后
  必测清单(边界测试→中间件顺序→chat 签名→重灌→全量)/演示库重灌提醒
- TODO/MEMORY 口径落账：接口实调验收通过(2026-09-07 AI 代验:三接口契约+三
  鉴权边界 401/403/403 零偏差,前端未 init 口径为后端接口验证)；合并 main
  移交合并执行人；模块侧开放项=actor_id 透传评估+前端入口归属拍板；修正
  AL-09 旧口径(9 文件→实测 20 文件)；删重复待办行
 2026-09-07 20:52:58 +08:00
GaoYiYuan_0626 cfbd056e32 docs: 统一重构档措辞——验收门改为『合并 main 前交付检查点（非分支开发阻塞）』；同步分支已推送远程 + 本地跟踪已建立 + 领先 origin/main 84/落后 0 2026-09-07 20:27:22 +08:00
GaoYiYuan_0626 1d00e53c8e docs: C4~C6 收尾—挂账 #1~#9 逐项核对结论 + risk-m4 tag 落账同步 2026-09-07 20:07:47 +08:00
GaoYiYuan_0626 323d98bdc2 docs: C4~C6 文档落账同步（勾 TODO/MEMORY/交接文档 + 演示 SOP A-12 + 02-redis-keys C6 联动） 
- TODO/MEMORY/交接文档：C4/C5/C6 全部标记完成，基线更新为 482 绿（406+30+17+17+12）
- 演示 SOP 补 A-12 代理人行为链走查步骤（debug 头透传 actor + cron 扫描脚本）
- 02-redis-keys.md §2.6 C6 联动清单（代理人维度独立出单线/推送/去重口径）
 2026-09-07 19:57:52 +08:00
GaoYiYuan_0626 66ec7eba08 feat: C6 FR-10 代理人行为链 RISK-008 
代理人异常行为链识别（RISK-008）落地：
- 新增 agent_behavior_service：三条件证据聚合（A 诱导调仓/B AUTH_403_SCOPE 越权试探/C AUTH_403_NOT_OWNER|NOT_ASSIGNED 越权查询），按代理人维度独立出 pattern 单，payload.actor_id 指向代理人，审计仅 INSERT event_type=agent_behavior_detected。
- risk_repository 新增 list_audit_events / find_agent_behavior_alert / merge_agent_behavior_payload（同日同代理人一张单，证据并集）。
- trade_gateway.submit_trade 补 actor_id 透传（代理人发起交易归属发起人，缺省 SYSTEM）；simulate 路由传入 auth.actor_id。
- chat_tools 新增 query_agent_behavior 只读 Tool（agent_id 过滤 + 客户脱敏），tool_service 补意图词与摘要。
- scripts/cron/agent_behavior_scan.py 定时扫描脚本。
- 修复 append_alert_event 序列化缺 default=str（C6 evidence 含 datetime 字段）。
- 单测 12 例（_count_induce 边界 / 三条件 / 出单去重 / payload 归属 / Tool 过滤脱敏）。
全量 pytest 482 passed 0 failed（470 基线 + 12 C6）。
 2026-09-07 19:53:39 +08:00
GaoYiYuan_0626 90d0660b44 feat: C5 FR-9 预警处置时效升级（RISK-007，P0） 
- 仓储：新增 list_pending_alerts_all / update_alert_escalation（统一读改写 payload，
  升级标记独占写入，status/handler_* 列不碰；_parse_alert 补 created_at/handled_at
  字符串→datetime 解析，兼容 sqlite 原生 DDL）
- escalation_service.scan_and_escalate：扫描判级（普通 4h/24h、AML 1h/4h 短通道）、
  幂等闸门（仅升不降）、先持久化再推送、按 (customer_id,level) 降噪合并一次推送、
  通知链累积（L1 含 risk_manager / L2 含 compliance）、逐单+任务级审计
- scripts/cron/escalation_scan.py：15min 定时扫描壳（sys.path 引导 + new_trace + JSON 摘要）
- 对话线 query_overdue_alerts Tool + 注册表 + 意图词（置于 alert_query 之前）+ summarize 分支
- C5 前置：seed STAFF-31001/31002(risk_manager) + deps 矩阵放行 + chat.py 显式 deny +
  risk.py 台账全量只读分支；JWT 手册 §5.3/§5.4/§6.1 增补 risk_manager
- 测试：conftest 回拨 fixture + test_escalation_service(9) + risk_api/manager(5) +
  chat deny(1) + chat_tools overdue(2)；全量 470 绿（453+17）
 2026-09-07 19:28:04 +08:00
GaoYiYuan_0626 fe4801bc0a feat: C4 FR-8 持仓集中度预警（RISK-006） 
依据《实现方案-风控追加需求v1.1-C4C6.md》§2；不改表结构（alert_type/status
复用 payload 承载，audit_log.event_type 为 VARCHAR 可直接扩）。

1. settings.py + .env.example：一次性加齐风控追加 v1.1 共 11 项配置（C4~C6 共用）。
2. core_ro.concentration_profile(customer_id, limit=500)：一次 SQL 取明细
   （LIMIT limit+1 探测截断）+ Python 端按 min_risk_code in (R4,R5) 聚合；
   收口挂账 #1（PRD 字面为 list_holdings，改聚合封装，docstring 注明偏离）。
3. rules.py：RULE_SCORES/RULE_ALERT_TYPES 加 RISK-006=60/pattern；RuleHit 加
   alert_subtype；RiskThresholds 加 concentration_threshold 且 from_settings
   必须补读（评审 P1-2：漏读会让 conftest monkeypatch 失效打穿现有断言）；
   新增纯函数 rule_concentration——空仓不触发、截断视同达标（保守告警）、
   阈值边界 79.9% 不触发 / 80% 触发、R4+R5 为 0 不触发。
4. engine.process_trade_event：run_rules 之后、record_trade_alerts 之前并入
   集中度命中（不动 run_rules 签名）；命中后 L3 打 high_risk_concentration
   标签 + 写 risk_concentration 审计（金额只落合计与前 5 条摘要）。
5. risk_repository：find_pending_event_alert 改候选 LIMIT 50 + Python 过滤掉
   payload.alert_subtype 含 agent_behavior 的单（评审 P0-1：代理人维度行为链单
   不得充当客户维度事件单的聚合锚点）；append_alert_event 加 extra_subtypes
   合并进 payload.alert_subtype（不传时行为与原先一致，向后兼容）。
6. alert_service：subtypes 集合维护（空集不注入 payload，评审 P2-3）；
   追加时 alert_type 按「老单规则 ∪ 本批规则」重算（评审 P1-3，修掉既有
   large_amount 单被本批仅 RISK-006(60) 翻转为 pattern 的缺陷）；
   _publish_alert 加 notify_role/extra 可选参数（C5/C6 复用）。
7. 对话线：chat_tools.customer_context 加 profile（concentration_ratio/
   r45_value/total_value/holdings_truncated），tool_service.summarize 加
   「高风险持仓占比 X%（仅供参考）」；不新增意图词。
8. 02-redis-keys.md 增补 alert_subtype / escalation_level 附加推送字段。

测试：conftest 加 autouse _disable_concentration_rule（阈值推 1.01 做回归隔离，
现有用例断言零改动）；test_risk_rules 加 RISK-006 纯函数 6 例；新建
tests/test_concentration_c4.py 11 例（与 RISK-001 同单聚合、score max=70、
L3 tag、risk_concentration 审计、仅集中度也出单、subtype 合并、P0-1 回归、
alert_type 不翻转、对话线 ratio）。全量 453 绿（436 + 17）。
 2026-09-07 19:05:02 +08:00
GaoYiYuan_0626 8c226f0c6d chore: 风控Agent模块自治边界标注 + AL-09 合并预处置 
背景：远端 main 新提交 3995cb4（09-07 17:20，交接文档漏记）为 Wave 0 鉴权/
chat/防护平行实现，与已完工 T-01/T-02/T-03/T-06 同名不同路径；试合并实测
20 文件冲突（原记 9 个），另有 13 个 main 新增文件不报冲突会静默并入。
拍板：风控 Agent 按独立封装模块自治，与宿主耦合收敛到 4 个接缝。

1. 《风控Agent模块边界与合并接缝标注》入库存档：A~D 四类文件归属表；
   4 接缝（S1 挂载点 main.py / S2 AuthContext / S3 settings / S4 引擎工厂）；
   20 冲突文件逐个裁决（core_ro、model/suitability、conftest、02-seed-base
   以模块版为准；chat/main/settings/agent_service 等公共层以 main 为主）；
   三处硬伤处置：issuer 不一致改为适配器映射不统一、STAFF-90001 必保、
   main infer_roles 未知 actor 默认 analyst（fail-open）记宿主侧 P1。
2. app/api/auth_adapter.py：S2 接缝适配器预制件（当前未接线，AL-09 接入）。
   鸭子类型读宿主 ctx 故不依赖宿主文件；sub→actor_id、trace_id→contextvar、
   perm_matches 兼容宿主 `前缀:*` 通配；缺主体即 HostAuthAdapterError，
   fail-closed 不静默降级。
3. tests/test_module_boundary.py：边界防呆 4 类断言——模块私有文件存在、
   禁止跨层 import 宿主私有实现（gateway.*/config.database/middleware.*/
   utils.input_guard/model.schemas）、AuthContext 契约完整（actor_id 与
   has_role 多参）、settings 私有字段与 AGENT_TYPES 四值不漂移。
4. tests/test_auth_adapter.py：适配器 11 例（映射/回退/fail-closed/trace 绑定/通配）。

基线：406 → 436 全绿（演示库已按演练 SOP §2 重灌：AML 8 条 / 演示 7 行 / sync 33 rows）。
 2026-09-07 18:28:18 +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 b5fd52ef02 AL-08: 演示库重灌与种子核对对齐 main 基准——prepare_risk_demo.sql 改写 expires_at 口径(演示客户刷新为测评 90 天前/剩余 275 天,CUST-1004 保持过期演示 FM-03,替代 SUIT-008 evaluated_at+365 旧写法)；演示 SOP 同步(§2 完成标志 33 客户口径+expires_at 剩余天数,A-1 预期改 SUIT_RISK_MISMATCH,A-2 改 FM-01 SUIT_AGE_CONFIRM 网点确认)；网关阻断响应补全 main 契约字段(match_result/mismatch_type/requires_disclosure/needs_branch_confirm/rule_refs)+audit detail 加 block_response_code；集成测试 4 例旧口径断言更新(A-1 trace 一致性断机器码/A-1 audit JSON 断机器码/A-2 重写为 FM-01 语义/settings 退役断言)。SOP §2 脚本化全量重灌双库验证通过(AML 8 条/演示 7 行/sync 33 rows)；全量 406 passed 0 failed 0 skipped(集成测试真库走 21 列新表+expires_at 数据恢复执行) 2026-09-07 17:49:39 +08:00
GaoYiYuan_0626 ec11ec42c0 AL-07: test_suitability 按 main 契约重写——七判定路径正反例(not_found 客户/产品两向/FM-03 过期/JR-AST-PRO 专业豁免优先于矩阵 forbidden/JR-AST-012 矩阵 forbidden/矩阵缺行 fail-closed/allowed/矩阵披露与产品 requires_disclosure 两源/FM-01 age70+R5 阻断+69岁与R2 两边界)；compute_rule_refs 四类组合(含报告样例 过期+不匹配→['JR-AST-012','FM-03'])；build_suitability_log_row 逐字段 21 列映射断言+bool→int 转换；服务集成端到端(21 列落库/check_source r02_trade 与 r02_chat/actor_id/request_ref 透传/兼容字段 rule_id=机器码 映射/NotFound 结构化不抛)；MySQL 方言冒烟(真库连通时验 SQL 可执行性,未灌库自动 skip)。可控日期用远未来/远过去 expires_at 种子。全量 395 passed 0 failed；1 skip=集成模块待 AL-08 重灌演示 SQL expires_at 2026-09-07 17:42:55 +08:00
GaoYiYuan_0626 38da477be4 AL-06: 对话 Tool 与 API 响应对齐 main 基准——chat_tools.suitability_check 返回体扩展 match_result/mismatch_type/requires_disclosure/needs_branch_confirm/block_response_code/rule_refs(替代 rule_id/reasons/effective_level 展示)，check_source='r02_chat'，not_found 转结构化 found=False(NotFoundError except 死代码清除)；tool_service.summarize suitability 分支按新枚举重写文案(网点当面确认 FM-01/签署风险揭示书/测评过期 FM-03/专业豁免,附 rule_refs 依据)；risk_api 断言改 block_response_code。全量 373 passed 0 failed(1 skip=test_suitability 占位待 AL-07)。遗留：chat 链路 risk_suitability_log.actor_id 暂落 SYSTEM(run_tool 统一透传需动 core_tools/kb_tools 冻结 func 契约,发起者留痕已由 agent_tool_call 覆盖) 2026-09-07 17:39:04 +08:00
GaoYiYuan_0626 adf5e8013a AL-05: suitability 服务重构换核对齐 main 基准——判定内核由 SUIT-001~008 纯函数矩阵改为 core_ro.check_suitability(C×R 数据驱动)；SuitabilityResult 扩 main 新字段(match_result 五值/mismatch_type 七值/requires_disclosure/needs_branch_confirm/block_response_code/rule_refs)并保留旧字段兼容层(rule_id=机器码别名/effective_level=customer_level/reasons=[reason])；check_core/cap_by_age/match_by_matrix/is_assessment_valid 删除(SUIT-006 被 FM-01 替换,SUIT-008 被 FM-03 expires_at 替换)；settings.risk_assessment_valid_days 退役(.env/.env.example 注释)；NotFoundError 不再抛(not_found 结构化,main 契约)；写库走 build_suitability_log_row + insert_suitability_log 升级 21 列(rule_refs JSON 序列化)；check_source 参数化(网关 r02_trade/risk.py manual)+actor_id 透传；网关阻断响应补 block_response_code；model 抽 compute_rule_refs 公共函数防两处漂移；测试配套：_ddl 加矩阵 25 行种子 helper、conftest fixture 灌种子+集成就位校验改 expires_at 口径、trade_gateway/risk_api fixture 补种子与 expires_at、404 两例改 200+blocked 新契约、repository 21 列断言、settings 退役断言、test_suitability 占位 skip 待 AL-07 重写。sqlite 端到端七语义+落库验证通过；剩 4 failed 均为 chat_tools/API 旧展示断言(AL-06 处理) 2026-09-07 17:34:32 +08:00
GaoYiYuan_0626 c92f0d7020 AL-04: 引入 model/suitability.py 对齐 main 基准——build_suitability_log_row 原样引入(check 结果→risk_suitability_log INSERT 行映射;rule_refs 组合:JR-AST-012 等级不配/FM-03 风评过期/FM-01 网点确认/JR-AST-PRO 专业豁免;CheckSource 四值 Literal) 2026-09-07 17:12:46 +08:00
GaoYiYuan_0626 ba3465a953 AL-03: core_ro.py 融合对齐 main 基准——我方骨架保留(utils/db.get_engine 统一引擎工厂,main 自带 create_engine 工厂不采纳;风控扩展 get_trade_by_id/sum_trades_on_date/list_trades_range/list_active_customers 全保留)，吸收 main 四项+1：①get_customer_l0 扩列版(c.*+风评新列+risk_is_expired) ②check_suitability+_suitability_result(C×R 矩阵判定,判定链 not_found→FM-03 过期→JR-AST-PRO 豁免→JR-AST-012 矩阵→披露→FM-01 网点确认) ③list_products_for_customer(C-11) ④list_holdings 合并(limit=500 截断防护+min_subscribe_amount/term_days 新列) ⑤list_trades(差距#13 新查询能力)。移植坑消解：main 三处 CURDATE() SQL 表达式统一改 Python 端 _is_expired 计算(sqlite 测试库兼容),date/datetime/str 统一 _as_date 归一。双方言验收：MySQL 真库(not_found/expired 真跑)+sqlite 七路径可控日期验证通过；pytest 失败面与 AL-02 基线一致(15 failed 均旧契约断言) 2026-09-07 17:11:52 +08:00
GaoYiYuan_0626 e99ec6775a AL-02: risk_suitability_log 重建 21 列对齐 main 基准——底座 SQL 采纳 main 版(product_name/investor_category/match_result 五值/mismatch_type 七值/requires_disclosure/needs_branch_confirm/risk_was_expired/block_response_code/check_source 四值/actor_id/rule_refs JSON + 6 索引)；07-说明.md 直接采用 main 版 P0 契约；tests/_ddl.py sqlite 同步(21 列 + core_suitability_rule 新表 + core_customer/core_customer_risk/core_product 扩列，VARCHAR 近似 ENUM 与现有风格一致)；修 test_risk_api 位置式 INSERT 补列名。全列 INSERT 验收通过；剩余 15 failed 均为旧契约断言(报告预告作废集，AL-05/06/07 清零) 2026-09-07 17:05:15 +08:00
GaoYiYuan_0626 bb244f43a3 AL-01: Core 库表结构对齐 main 基准——01-ddl 采纳 main 版(新增 core_suitability_rule C×R 矩阵表+FK/core_customer KYC 扩列含 is_hnw/core_customer_risk 七新列含 expires_at+investor_category/core_product 起购金额/期限/揭示书列/core_trade AML 扩列/core_cash_flow flow_subtype)；02~06 种子采纳 main 版(33 客户含 CUST-DEMO-A~E/14 产品/矩阵 25 行)；保留我方独有 STAFF-90001 风控演示账号；README 种子规模与矩阵口径同步。非交互重灌验证通过(矩阵 25/客户 33/产品 14/风评 33) 2026-09-07 16:57:15 +08:00
GaoYiYuan_0626 eae28bee4e docs: PRD/规则表/开发计划合并需求追加 v1.1 修订 2026-09-07 12:46:59 +08:00
GaoYiYuan_0626 21f63a95ee chore: .gitignore 忽略风控需求追加过程文档 v1.1 2026-09-07 12:42:59 +08:00
GaoYiYuan_0626 9cc2e59bb7 fix: T-21 评审闭环(P1-1 MILVUS_URI 遮蔽)——milvus_service 环境防御顺序重排: settings 先初始化(干净读 .env)→os.environ 归位合法 http 占位(仅替换文件 URI)→import pymilvus; 原顺序下 pydantic 读到被污染 env 会把 .env 的 MILVUS_URI 一并遮蔽(最坏 import 顺序真连接事故); 最坏顺序断言+全量 425 绿+端到端检索通过 2026-09-07 12:24:46 +08:00
GaoYiYuan_0626 8fbbca6bb2 docs: T-21 文档同步——TODO 勾选(完成详情+三坑收口)/MEMORY 交接清单与仓库地图/FLOW milvus_tool 状态改已做; 下一项=前端 React 入口 2026-09-07 12:12:36 +08:00
GaoYiYuan_0626 535c8a0a20 fix: T21 真库联调三坑——①Milvus Lite 文件库跨进程重开 collection released, ensure_collection 补显式 load(单测同进程覆盖不到); ②faiss 不支持中文路径(faiss C++ IO), 本机 .env 改英文绝对路径 C:/Users/YUAN/.jinrong/milvus/, .env.example 加警告; ③build_kb 直跑 sys.path 引导项目根(同 rebuild_alerts 先例); 真库 24 块入库+检索验收通过(基金申购 Top3 命中申赎规则, 溯源完整), 425 绿 2026-09-07 12:11:10 +08:00
GaoYiYuan_0626 1c51149912 feat: T21-5 知识库 Tool 接入对话——kb_tools(search_knowledge)挂统一注册表第三层; ToolSpec 新增 skip_access_check(公开知识无归属语义, advisor 无绑定客户可查, 意图层限定 customer/advisor); 意图关键词 customer/advisor 组尾挂 kb 词(Core 词优先, risk 不开放); tool_node 按 spec 白名单注入 query; summarize 溯源口径; 单测 13 例, 425 绿 2026-09-07 12:05:36 +08:00
GaoYiYuan_0626 e2a444453e feat: T21-4 RAG 检索编排——rag_service.search_knowledge(query→bge-m3 向量→Milvus 检索→chunks+source_refs 溯源去重), 异常原样上抛不吞(防 LLM 编造回答), 空白 query 短路, ensure_collection 幂等防御; 单测 8 例注入 mock, 412 绿 2026-09-07 12:01:45 +08:00
GaoYiYuan_0626 974fff9507 fix: T21-3 补丁——.gitignore 白名单 data/kb/*.md(演示手册入库可复现, 真实产品文档仍忽略), 补提交 6 只产品手册 md 2026-09-07 11:57:36 +08:00
GaoYiYuan_0626 7edf522aff feat: T21-3 知识库首批数据+入库脚本——data/kb 6 只种子产品手册(每只 prospectus/fee/rule/risk 四节 24 块, 费率与 core_product seed 对齐)+build_kb.py(front-matter+节标题切块/doc_type 白名单/Core 权威元数据缺省即中止/一次批量 embedding/upsert 幂等/--dry-run); 脚本单测 10 例, 404 绿 2026-09-07 11:55:24 +08:00
GaoYiYuan_0626 1056a95343 feat: T21-2 Milvus 接入层——kb_product_rules 幂等建集合(冻结 11 字段+AUTOINDEX COSINE)+upsert 入库+search_kb(溯源字段必带+effective_date 合规过滤+标量过滤); 规避 pymilvus 3.x import 阶段读 .env 文件 URI 炸 import 的坑(setdefault 预置合法 MILVUS_URI); 单测 8 例真 Lite 临时库, 394 绿 2026-09-07 11:49:43 +08:00
GaoYiYuan_0626 e34973f018 feat: T21-1 embedding 服务——Ollama bge-m3 批量 /api/embed(1024 维), 连接/模型/结构/维度四类失败一律 EmbeddingError 不静默降级(拍板口径), 空输入短路; settings 增 embed_dim/embed_timeout; 单测 10 例 mock HTTP 不依赖 Ollama, 386 绿 2026-09-07 11:46:24 +08:00
GaoYiYuan_0626 5f32dd349c docs: T-03 文档同步(378 绿, 评审 PASS with findings P0=0)——TODO 勾选 + MEMORY/FRAMEWORK/REQUIREMENTS F-03 状态改为完成 + 下一步 T-21/前端 2026-09-07 11:18:28 +08:00
GaoYiYuan_0626 207fc79f61 test: T-03 评审闭环(PASS, P0=0)——P2-1 词表规范化断言修正/P2-2 补 7 条同构变体(你现在是管理员/ignore the above instructions 等)+变体单测/P2-3 窗口 TTL 断言+EXPIRE 失败取舍锁定; P3 session_id 落库截断+trace 兜底注释, 378 绿 2026-09-07 11:16:15 +08:00
GaoYiYuan_0626 cc6f34fbbd feat: T-03 输入防护限流(T3-3)——actor 级 Redis 固定窗口 30 次/分(settings 可调), 超限 429 GUARD_RATE_LIMITED+留痕, Redis 故障 fail-open, 测试 4 例(429/窗口滚动/fail-open/注入计数), 376 绿 2026-09-07 11:10:26 +08:00
GaoYiYuan_0626 65b45aa917 feat: T-03 输入防护接入 chat(T3-2)——注入/超长命中即拒 400 + input_guard_log 留痕(fail-fast 不建会话, 留痕降级不改拒绝语义), Pydantic 硬顶 20000, 集成测试 7 例 2026-09-07 11:02:36 +08:00
GaoYiYuan_0626 497554da43 feat: T-03 输入防护服务(T3-1)——input_guard 纯函数检测(注入短语词表/oversize 4000) + 单测 20 例(不误杀用例/判定顺序锁定), 365 绿 2026-09-07 10:59:25 +08:00
GaoYiYuan_0626 e5937d6ac9 docs: 阶段C 文档同步(345 绿, tag risk-m3, 独立评审 PASS P0=0) 
- docs/memory/TODO.md: 勾选风控阶段 C 完结(C0~C3)
- docs/memory/MEMORY.md: §0/§1/仓库地图更新至阶段 C 收尾 + 下一步 T-21/T-03/前端
- .gitignore: 正式忽略交接文档.md 与 .workbuddy/(过程文件不提交约定)
 2026-09-07 10:36:51 +08:00
GaoYiYuan_0626 c92d8c7783 test: 阶段C 评审 P2 补 advisor 归属覆盖与空 product_id 单测(345 绿) 2026-09-07 10:31:58 +08:00
GaoYiYuan_0626 930ea9db56 feat: 阶段C 风控对话线(C1 四只读 Tool + C2 risk 分支意图 + C3 A-6 验收与边界) 
- C1: app/service/risk/chat_tools.py 新增 alert_query/customer_context/suitability_check/aml_lookup 四只读 Tool，挂 RISK_TOOL_REGISTRY（与 core_tools.ToolSpec 同构）
- C1: tool_service.run_tool 改查 core+risk 统一注册表并恒传 risk_repo；_normalize_params 读 spec 白名单；core_tools 三函数加 risk_repo=None；summarize 补四工具分支
- C2: match_intent 按 agent 分组扩 risk 关键词；agent_service.tool_node 守卫放宽（requires_customer=False 的 Tool 允许无绑定客户运行，支撑 A-6 全局待审）
- C3: A-6 验收（risk_officer 问待审预警→alert_query 全量→回复含待审数）+ 诱导处置边界（无处置 Tool、系统提示禁自动处置、诱导只触发只读且预警状态不变）
- 测试 tests/test_risk_chat_tools.py（21 例）；全量 pytest 342 绿（原 321 + 21）
 2026-09-07 10:26:54 +08:00
GaoYiYuan_0626 d56f73ff73 chore: 阶段C 增补 pytest-asyncio 依赖(C0) 2026-09-07 10:26:24 +08:00
GaoYiYuan_0626 397c0b2092 docs: 同步交接文档至 T-04 复审闭环(321 绿) + MEMORY/FLOW/TODO 测试数 297→321 + T-04 评审闭环状态 2026-09-07 09:59:37 +08:00
GaoYiYuan_0626 1216d26083 fix: T-04 复审闭环——P2-1 test_chat 夹具补 _risk_repo 打桩(防越权双写写脏演示 MySQL)/P3 归属码改为显式集合+前缀兜底/truncated 判定多取 1 条防恰好 500 误报, 321 绿 2026-09-07 09:51:38 +08:00
GaoYiYuan_0626 40a9ee21a6 fix: T-04 评审闭环——P1-1 留痕降级提 error 带定位字段/P1-2 对话越权接鉴权双写(utils/authz.py 下沉公共出口,deps 复用,service 不反向依赖 api)/P2 入参白名单+days 钳制[1,365]/list_holdings SQL LIMIT+truncated/时间窗集中 _now_naive; 补测 24 例(days 边界/非法入参/inactive 归属/双写断言/降级日志/上下文截断), 321 绿 2026-09-07 09:42:37 +08:00
GaoYiYuan_0626 301c78edc3 feat: T-04 Core RO Tool 节点——chat Tool 接入+归属校验+agent_tool_call 落库 
- app/tool/core_tools.py: 三只读 Tool(query_customer_profile/holdings/recent_trades, Core RO 仅 SELECT) + TOOL_REGISTRY 白名单(requires_customer); JSON 安全化(Decimal 两位/时间 isoformat)
- app/service/tool_service.py: match_intent 关键词意图(仅 customer/advisor; risk/analyst 空转归 C1/C2) + assert_tool_access 归属断言(customer 本人/advisor assigned/risk_officer 全量/其余拒, 口径对齐 deps.assert_customer_access) + run_tool 编排(白名单→校验→执行→agent_tool_call 落库, 落库失败降级 warning)
- agent_service: 图 START→tool→llm→guard; Tool 结果注入 LLM 上下文(SystemMessage); 降级回复带 Tool 摘要; chat() 可选 session 上下文(缺省空转, T-07 兼容)
- session_repository: insert_tool_call(message_id 一期 NULL, session_id+trace_id 可还原)
- 归属拒绝口径: Tool 层不抛 403 改 blocked 留痕(AUTH_403_* 同码), 对话内呈现——API 层 deny 铁律不变
- tests: test_chat_tools 20 例(三态+落库字段+降级+图注入) + test_chat 4 例(全链路/JWT 外 debug 通道), _ddl 补 agent_tool_call/core_holding, 297 绿
- 真库冒烟: uvicorn+真 MySQL/Redis chat 触发持仓查询 success 落痕 47ms, 现场已清理
 2026-09-07 08:43:36 +08:00
GaoYiYuan_0626 3c3ce4e5d6 docs: 交接文档增量同步——演示库状态更新(已按 SOP 重灌+冒烟清理, pytest 可直接跑, 走查后需再重灌) + FLOW 尾注补 python-jose 漏装坑(与 redis 包同类, 附 import 自检命令) + JWT 默认密钥 warning 属预期/DEEPSEEK 空 chat 降级入本机状态 + AGENTS.md 代码入口刷新(main 全路由/鉴权工厂/Auth SDK/StateGraph) 2026-09-07 08:15:50 +08:00
GaoYiYuan_0626 b97e77747a docs: M2 收尾复核闭环(M4)+Wave 0 状态同步——M4 复核记录(任务映射/T-30~T-32 边界收口/成功体不包裹演进口径维持/agent_message.trace_id 请求级口径/会话枚举取舍登记), TODO(T-01/T-02/T-06/T-07 勾选+T-30~T-32 收口), MEMORY(§0 进度/仓库地图/下一步/273 绿), FLOW(§0 JWT 已做/§1 链路/§2 对话主链路状态), FRAMEWORK(能力模块+分层), REQUIREMENTS(F-01/F-02 完成/F-03 部分), 开发计划头注, 演示 SOP 补 JWT 通道签发演示 2026-09-07 03:08:27 +08:00
GaoYiYuan_0626 61711cb70a fix: Wave 0 独立 AI 评审闭环(有条件通过→闭环, 273 绿)——P2-1 python-jose>=3.5.0(防 CVE-2024-33663/33664) P2-2 audit 降级+OPTIONS 测试 P2-3 JWT 通道 chat 3 例 P2-4 debug 兜底双闸门(dev+无 RS256 公钥) P2-5 留痕失败降级显式化(401/403 拒绝语义不漂移, _safe_unauth_audit 保护 repo 构造); P3 顺手: 401 归 platform/值域外 400 补留痕/Bearer 大小写不敏感/jti 加 uuid/CLI permissions+exp 上限/dev 默认密钥 warning/LLM 单例加锁/chat 主角色优先序+message strip+guard 日志脱敏/必填 claims 参数化+none 算法固化; P3 登记项(会话枚举/seq_no 锁/trace_id 口径/文档同步)归 M4 文档 2026-09-07 03:03:12 +08:00
GaoYiYuan_0626 ee5c78af66 feat: T-06 chat 最小闭环——api/chat(X-Agent-Type 分流+准入矩阵+customer 归属固定本人/advisor G-01 归属校验+SessionGuard actor/agent 一致+closed 409) + session_repository(agent_session/agent_message, 派生表补 alias 修 MySQL 1248) + memory_service(Redis 窗口 sess:{agent}:{id}:msgs TTL2h N20, miss/异常回源 MySQL) + main 挂载 + tests/test_chat 12 例, 260 绿 2026-09-07 02:41:42 +08:00
GaoYiYuan_0626 fb18c04a8a feat: T-07 LangGraph StateGraph 骨架——compose(system 四 Agent 边界 prompt)→llm(DeepSeek/langchain-openai, 无 key 降级)→guard(customer/risk 免责声明+has_disclaimer, 未知类型 fail-safe 最严口径) + chat() 入口 + 图/LLM 单例缓存与测试隔离出口 + tests/test_agent_service 8 例(mock LLM 不依赖外网) 2026-09-07 02:34:57 +08:00
GaoYiYuan_0626 3cec034026 feat: T-02 审计中间件——http_access 全量访问审计(auth 注入 request.state, 排障路径跳过, 写库失败降级) + 独立 request_id(X-Request-Id 白名单透传贯通, B7 复审 P3-4) + 422/404/405/500 统一错误体(500 由 trace 中间件兜底生成并回写 trace 头, B7 复审 P2-2) + input_guard_log 双写(deps 401/403 留痕, platform 网关跳过 ENUM 口径, 挂账⑧收口) + repo.insert_input_guard_log + tests/test_audit_middleware 12 例, 240 绿 2026-09-07 02:32:03 +08:00
GaoYiYuan_0626 36f476f450 feat: T-01 JWT 鉴权——auth_service(Auth SDK: HS256/RS256 验签+必填claims显式校验+jti吊销 fail-open) + deps 工厂替换(Bearer 全环境, debug 头降级 dev 兜底) + X-Agent-Type 交叉校验(手册§4.6/§5.4 准入矩阵) + issue_dev_token CLI + redis_gateway exists/set_ex + lifespan 改验 jwt_ready + tests/test_auth_jwt 18 例, 228 绿 2026-09-07 02:23:33 +08:00
GaoYiYuan_0626 725a38d203 docs: 交接文档 B9b 后同步——MEMORY §0 补演示库走查残留警告(pytest 集成防护 fail 属预期, 先按 SOP 重灌)+B9b 评审闭环+阶段优先级改 Wave 0+文档资产表加演示 SOP, FLOW §0 状态行与本机 pytest 表述限定, 测试数统一 209 2026-09-07 02:04:32 +08:00
GaoYiYuan_0626 539d4915d7 fix: B9b 复审闭环——P2-1 SOP 交互重灌补 DROP jinrong_agent(reset.ps1 只重建 core+裸 CREATE TABLE 会 1050 中止); P2-2 补做 T-31 名下 P2-8 手工 SQL 对照收口(4 组合真库 SQL 推导与函数判定一致, 登记 SOP 核查单附行); P2-3 SOP 走查范围与 11/11 口径统一(A-6 归 M3/A-8 映射交代); P3: A-4/A-9 COUNT 当日窗+已处置单幂等用例+suitability/check 阻断响应补 G-08 两要素(advice/notice)+记忆文档数字同步; 留痕 scan_all 幂等读后写无锁取舍; 209 绿 2026-09-07 01:59:15 +08:00
GaoYiYuan_0626 03d77b9451 feat: B9b 演示走查——核查单收口: ①预警类 API 固定 disclaimer(alerts/handle/aml-scan) ②aml/scan 幂等防护(find_recent_aml_alert 同客户当日已有 aml 单不出单+skipped_existing) ⑥集成测试前置断言(A-1/A-3/A-4 清洁检查 fail+重灌提示, A-5 按 trade_id 定位); 演示 SOP 落地(脚本化重灌 MYSQL_PWD 方式); 真服务走查 A-1~A-5/A-7/A-9+核查单①②④⑤ 11/11 PASS(核查单⑥防护现场复现), 208 绿; M2 达成 2026-09-07 01:36:44 +08:00
GaoYiYuan_0626 e62fb1d291 fix: B9a 复审闭环——P2-1 skipped 分支 has_engine_error_audit 中间态警示(input_summary LIKE)+docstring 局限声明; P2-2 非首笔 trade 幂等用例; P3 顺手: 双脚本连接自检/ImportError 分支/非 dict payload raw 兜底/get_trade_by_id confirmed 过滤/勿并行声明, 8 例 204 绿, warning 路径真库复验后清理; docs 同步复审结论 2026-09-07 01:02:12 +08:00
GaoYiYuan_0626 fdf487dc32 feat: B9a 演示/运维脚本——subscribe_alerts(risk:pub:alert 订阅演示/连接自检/--duration) + rebuild_alerts(按 trade_id 幂等重放: find_alerts_by_trade payload LIKE 查已入单防重复出单与重复 append, 含 aml/已处置单) + core_ro.get_trade_by_id 只读扩展 + test_demo_scripts 5 例, 201 绿; 真库手工验证(出单→幂等 skip→missing exit1; 订阅端到端 trace 贯通)后现场清理; docs 同步(TODO/MEMORY/FLOW/开发计划) 2026-09-07 00:43:25 +08:00