xinghuo/group_xinghuo_jinrong
1
0
Fork 0
Code Issues Pull Requests 2 Actions Packages Projects Releases Wiki Activity
131 Commits 9 Branches 1 Tag
34c7d0840db12202b2b8dc10596c5f3f7d1f5191
Commit Graph
11 Commits
Author SHA1 Message Date
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 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 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 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 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 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 3e40a2bb49 fix: B6 评审修复——鉴权审计统一 deny/401 留痕、start_date/end_date 对齐 PRD、simulate 回挂鉴权、异常与审计注入收敛 
- P1-1: 403/401 全部经 deps.deny/_authz_audit 留痕(event_type='authz')
- P2-1: GET /alerts 参数名 start_date/end_date 对齐 PRD;page/page_size 用 fastapi.Query
- P2-2: /api/simulate/trade 回挂 get_auth_context(risk_demo 或本人),越权 403+审计
- P2-3: suitability/aml 直调补审计+request_ref 透传
- P3-1: 多角色 fail-closed 口径固化进测试;P3-3/P3-4 core_ro/risk_repo 必传;
  P3-5 LookupError→NotFoundError 统一;P3-9 alert_service import 上提
- 测试: test_risk_api 权限矩阵/审计断言/多角色组合/非 dev 拒绝;
  test_trade_gateway 客户本人 vs 越权 403(P3-4 模拟 _repo 注入 sqlite)
- 挂账: P3-2/P3-7(响应外壳+disclaimer)→B7;P3-6(scan 幂等)→B9b 前
 2026-09-06 18:58:48 +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 2a95b65ec8 feat: 模拟交易网关(suitability 阻断→落库→引擎, convert 400, B5) 2026-09-06 18:05:44 +08:00