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
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
2026-09-11 19:53:31 +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
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
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
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
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
458dbdc7a6
docs: 登记方案 C 交付与遗留项
2026-09-08 14:24:08 +08:00
GaoYiYuan_0626
af7ba00327
docs: 同步前端接入方案 B 交付与风险经理对话线口径
2026-09-08 14:08:42 +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
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
8fbbca6bb2
docs: T-21 文档同步——TODO 勾选(完成详情+三坑收口)/MEMORY 交接清单与仓库地图/FLOW milvus_tool 状态改已做; 下一项=前端 React 入口
2026-09-07 12:12:36 +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
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
397c0b2092
docs: 同步交接文档至 T-04 复审闭环(321 绿) + MEMORY/FLOW/TODO 测试数 297→321 + T-04 评审闭环状态
2026-09-07 09:59: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
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
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
GaoYiYuan_0626
be44d569a4
docs: 交接文档 B8 后全面同步——MEMORY 进度/B7·B8 复审闭环/196 绿/bootstrap 本机就位注记, FLOW §0 补本机状态与已知坑(mysql.exe 路径/reset.ps1 交互卡死), TODO 进行中改 B9a
2026-09-07 00:01:52 +08:00
GaoYiYuan_0626
516b1132a3
fix: B8 复审 P1-1——conftest except pytest.SkipRequested 引用不存在属性致 skip 路径炸收集(删, Skipped 继承 BaseException 直传, 错密码故障注入验证 skip 不 error); P3 顺手: teardown l3_snapshot 哨兵 + A-1 补 trace 响应头/suitability_log 两环; P2-1 演示库耦合前置断言挂 B9b 核查单⑥
2026-09-06 23:52:59 +08:00
GaoYiYuan_0626
c6ad0885d3
test: B8 收敛——sqlite 测试 DDL 单一事实源 _ddl.py(10 文件 45 处手写 DDL 清零)+localtime 时区收敛(B5 评审 P3-4, utcnow 边界修复)+测试内遗留建表清理, 196 绿; docs 同步 B8 完成状态
2026-09-06 23:37:03 +08:00
GaoYiYuan_0626
fe29b736ea
fix: B7 复审 P1-1——dispose_engines 显式 Engine.dispose()(手写单例字典替代 lru_cache, test_db 3 例, 独立评审有条件通过→闭环)
2026-09-06 23:06:32 +08:00
GaoYiYuan_0626
6195349dd6
feat: main 集成(路由挂载/trace 中间件/lifespan) + B7 挂账收口(引擎工厂/统一错误体/锁公共化/L3 缓存 DEL/死代码清理/处置原子事务/启动期 debug 校验, B7)
2026-09-06 20:48:50 +08:00
GaoYiYuan_0626
a78e9d4d31
fix: B6 复审收口——测试 Redis 隔离/网关审计口径 platform/死常量清理/回归断言补强
...
- P2: test_risk_api env 注入 FakePublisher,aml 推送不触真 Redis
- P3: deny/_authz_audit 增 agent_type 参数,simulate 越权审计传 platform
(与网关放行审计同口径);删 HANDLE_RESULTS 死常量(Literal 单处定义)
- P3: 补 start_date/end_date 过滤+分页 422 边界+suitability api 层审计断言;
补 app/service/risk/__init__.py
- 挂账: B7 行新增④项(启动期拒绝/引擎工厂覆盖三实例化点/handle 原子性/
input_guard_log);B9b 行核查单(disclaimer/scan 幂等/Swagger 手测/analyst);
TODO.md T-30/T-31/T-32 进度同步
2026-09-06 19:21:15 +08:00
GaoYiYuan_0626
46a1f24870
fix: 引擎异常审计降级/审计全量输入输出/TRD-TEST 注入点(B5 评审 P1-1、P2-1~3、P3 批量)
2026-09-06 18:17:44 +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
25fc1ebdd7
docs: 阶段 A 评审挂账登记(MySQL 对照→B9b/B2 职责/B3 并发/B6 枚举校验/B7 引擎工厂)
2026-09-06 15:37:42 +08:00
GaoYiYuan_0626
487b9da5b1
docs: 风控模块 PRD v1.0/规则附表/架构 v1.1/开发计划 v1.1 + 文档联动修正
2026-09-06 15:09:13 +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
zhanghongyu_0626
0374010b37
Implement initial project structure and setup
2026-09-05 17:09:21 +08:00
GaoYiYuan_0626
zhanghongyu_0626