 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
|
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
|
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 |
|