xinghuo/group_xinghuo_jinrong
1
0
Fork 0
Code Issues Pull Requests 2 Actions Packages Projects Releases Wiki Activity
144 Commits 9 Branches 1 Tag
d2d00dd50c45c79f67b33a7bbb3eccaa89e26889
Commit Graph
37 Commits
Author SHA1 Message Date
GaoYiYuan_0626 b411d5a087 T-14/T-17 开口闭环：PRD §2.5.3 修订 + truncate 舍去法接入 + R-12 定稿（用户三项拍板 · 849 绿 / 真库 9/9） 
① PRD §2.5.3 修订：删「易方达 ETF 场外取整数位」（无证据且有反证，真实整数位载体为场内），改记「2 位主流 + 舍去型真实存在」，版本块加注记
② rounding_mode=truncate 消费接入（用户拍板补做）：
   - core_ro.get_share_rounding = 位数+模式回退链单点（规则行 → core_product → 默认 2/half_up，mode 白名单读取即校验，get_share_digits 转薄包装）
   - calc.product_round/in_qty 加 mode 参数（truncate → ROUND_DOWN）
   - 确认段 + 申购折算两处透传；载体 09-seed-org.sql ⑦ 段 PROD-005828（product 层回退，零转换场景引用）
   - 测试 +7（842→849）：calc 4 + 确认段 2（truncate 34945.53 vs half_up .54 分化 + 回退链遮蔽语义）+ 申购段 1
   - 突变：两调用点同拆 mode 透传 → 2 红，还原绿；真库 9/9（seed 新增 ⑫ 载体在位断言）
③ R-12 口径裁定追认定稿：条目回写开发计划（NULL 不参与 A/C 判定 / 同类走一般转换规则）

审核教训留痕：PRD 独立 AI 三轮审查未抓出外部事实断言无出处 —— 联网核实铁律再添例证
文档：开发计划 T-14 开口闭环段 + 基线 849 · 日志新节 · TODO/MEMORY/AGENTS/交接文档开口清零
 2026-09-12 14:31:35 +08:00
GaoYiYuan_0626 1a615bbbef 基金转换 T+1 模型：T-14 D27 产品舍入真正接入 + 联网核实纠偏（837 绿 / 真库 9/9 / 种子 v1.1 全 2 位） 
- 接入面 4 处单点收敛：core_ro.get_share_digits（唯一回退链：规则行→core_product.share_digits→PLACES=2）· calc.in_qty 加 digits=PLACES 可选参数 · 确认段（business_type=convert）· 网关申购折算（subscribe）；redeem 份额申报无折算无消费方
- 边界裁定：只接落库侧（开发计划 DoD 即边界），响应展示维持 q(D2) 收敛（2 位产品逐字节零漂移）；PRD §2.5.2 展示按产品覆盖为登记开口
- 联网核实（用户铁律）：主流 2 位 ✅ · 位数按各基金合同配置 ✅（南方 2012 调整公告）· 舍去 TRUNCATE 型真实存在 ✅ · 货基 2 位 ✅ · 「指数基金份额 4 位」证伪 ❌（ETF 联接/指数合同全 2 位）→ 11-seed-share-rule.sql v1.1：3 产品 9 行 4→2 + 头注重写为核实出处；「易方达 ETF 场外整数位」无证据有反证（登记开口待拍板）
- 测试 +7（830→837 零回归）：calc 层 2 + confirm 段 3（回退链三层各 1 + business_type 干扰行）+ 申购段 2；4 位种子行 = D27 机制验证载体（docstring 钉明）
- 突变验证 2 组（confirm/gateway digits 改固定 2 → 各 2 红，还原零残留）；真库 9/9 退出码 0（seed 重灌 42 行全 2 位生效）
- 开口 2 项待用户拍板：① PRD §2.5.3 易方达句修订 ② rounding_mode=truncate 消费接入（真实存在、T-14 范围外）
 2026-09-12 12:41:20 +08:00
GaoYiYuan_0626 3bc84a093d 基金转换 T+1 模型：T-13 convert_fund 退役 + 并发面重写 + 全量门禁（830 绿 / 真库 9/9 / 紧池 100%） 2026-09-12 11:52:27 +08:00
GaoYiYuan_0626 03feacf173 基金转换 T+1 模型：T-12 补偿 + SLA 清理切 Core 链路 + confirm_one 引擎异常留痕修复 
- cleanup_pending_convert.py 整体重写：扫描对象迁 Core（list_inflight_before 扫
  accepted/nav_pending 严格早于 cutoff → 条件 UPDATE 置 expired，S2 不硬删、
  幂等不加锁）；SLA 边界 = 当前业务日上推 convert_confirm_sla_days 个交易日
  00:00（previous_biz_day 链式，与 confirm_batch._window_start 同口径）；
  --days/--dry-run；不动 agent 镜像（T-4 契约）
- compensate_convert 从 v1.0 Deprecated 组救回在役：详情侧 Core 三件套前置校验
  （流水≥2 → confirmed → 明细非空，任一不满足 missing 零写入），补写与确认段
  第⑧步同口径 sync_mirror + confirmed 审计 phase=confirm-compensate
- convert_request_repository +list_inflight_before（T-12 专用捞单，R-2 守卫复用）
- 修复 confirm_one 第⑦步引擎异常只 log 不留痕（全仓唯一不落痕路径，补偿侧
  「人工核对」保护对主链路失效）：except 补写 decision='engine_error' 审计 +
  engine_error 标志贯穿审计与响应（D17 不阻断保留；三链路与 v1.0/gateway 对齐）
- verify_convert_compensate.py 整体重写 T+1 链路：受理→确认双失败→Core 三件套
  对表→补偿/cleanup，真库 56/56 退出码 0 残留 0（受理日/SLA 边界走真库交易日历
  链式推算，A 股最长连续休市 2020 春节 10 天已联网核实留痕）
- 测试：补偿用例 4 改 + 2 增、cleanup 段重写 + 窗口等价新用例、并发补偿 T+1 造数
  + 真库清场补 core_convert_request（FK 1451）、engine 异常用例断言翻转
  （不阻断但留痕+标记）；全量 849 passed / 10 skipped（846+3 零回归）；
  突变 4 组全被抓还原（cleanup 窗口反转 5 红 / 前置守卫 1 红 / 真库
  expired→cancelled 2 红 / 真库 nav_stale 1 红）
 2026-09-12 10:54:49 +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 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 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 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 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 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_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 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 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 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 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 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 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 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 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 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 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
GaoYiYuan_0626 6195349dd6 feat: main 集成(路由挂载/trace 中间件/lifespan) + B7 挂账收口(引擎工厂/统一错误体/锁公共化/L3 缓存 DEL/死代码清理/处置原子事务/启动期 debug 校验, B7) 2026-09-06 20:48:50 +08:00
GaoYiYuan_0626 03f8b63780 fix: FR-4 payload 上下文补组装/种子名单唯一命中/规则流水升序等(B4 评审 P1-1、P2-2~5、P3×7) 2026-09-06 17:40:13 +08:00
GaoYiYuan_0626 e8e5f7e981 feat: AML 名单匹配/全量扫描 + 事件引擎编排 + R-05 scoring 占位(B4) 2026-09-06 17:19:54 +08:00
GaoYiYuan_0626 026c4ce75c fix: L3 乐观锁防丢更新/last_alert_id 保留语义/竞态日志(B3 评审 P1-1、P2-1~5) 2026-09-06 16:42:18 +08:00
GaoYiYuan_0626 6f38c9b129 feat: 预警聚合/去重/审计/PubSub 推送 alert_service(B2) 2026-09-06 15:44:34 +08:00
GaoYiYuan_0626 4eb8b462cd feat: risk_repository 风控四表读写(A3) 2026-09-06 15:15:51 +08:00
GaoYiYuan_0626 fdf0c9675f feat: core_ro 扩展当日申赎合计查询 sum_trades_on_date(A2) 2026-09-06 15:11:01 +08:00
zhanghongyu_0626 1ddd44a6cb Add core database support and enhance documentation 
- Introduced `MYSQL_CORE_DATABASE` in `.env.example` and `settings.py` for core database configuration.
- Added `CoreReadOnlyRepository` for read-only access to the `jinrong_core` database.
- Updated `AGENTS.md`, `README.md`, and various documentation files to reflect new agent onboarding processes and project structure.
- Revised requirements in `requirements.txt` to include `langgraph` and `langchain-core`.
- Enhanced `FLOW.md` with local bootstrap instructions for setting up the core simulation environment.
- Added new scripts for database creation and seeding for the core simulation library.
- Improved overall documentation for clarity on project architecture and memory management.
- Updated `TODO.md` to reflect current development priorities and tasks.
 2026-09-05 17:39:16 +08:00