Files
group_xinghuo_jinrong/AGENTS.md
T
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

3.1 KiB
Raw Blame History

Agent

⚡ 需要接手/开工,先读项目根「交接文档.md」 —— 三线合并版唯一交接入口: §0 公共层(铁律 / 环境 / 已知坑 / 禁止事项)· §A 风控模块主线 · §B 基金转换(convert)线 · §C 架构改进线。 (该文件在 .gitignore 内、不入库,是给 AI 接手用的本地文件;docs/交接文档-*.md 两份为历史留档,内容已过期,勿读。)

无上下文时先读 docs/memory/MEMORY.md §0 交接清单(5 分钟了解仓库地图、bootstrap、禁止项、下一步)。

阅读顺序

顺序 文件 何时
1 docs/memory/MEMORY.md 每次任务
2 docs/memory/TODO.md 取当前待办
3 docs/memory/REQUIREMENTS.md 对照场景 ID(F/C/A/D/R)
4 docs/memory/FRAMEWORK.md 分层、选型、实现状态表
5 docs/memory/FLOW.md 端到端链路 + §0 bootstrap
6 docs/memory/ENVIRONMENT.md As-Is;Core 为模拟库

原文与深度文档

  • 业务需求:docs/需求拆解/
  • 表结构 SQL:docs/项目框架设计/表设计/
  • 技术选型 / JWT:docs/项目框架设计/技术选型和版本/
  • Core 模拟底座:docs/项目框架设计/Core模拟底座/
  • 业务记忆分层:docs/业务记忆管理/业务记忆管理手册.md
  • 基金转换线(第 5 步 todo 开发进行中 · T+1 受理/确认分离模型):T-1 ~ T-6 ✅ / T-7 ~ T-17 ⬜(当前基线 797 passed / 10 skipped 实测;T-6 真库 verify_convert_accept.py 36/36;下一步 T-7 = 三段编排 + 新增 confirm_service,核心重写);开工入口 交接文档.md §B(§B.11 下一条立项指引 = 最新状态)· docs/PRD/PRD-基金转换交易.md(v1.1)· docs/项目框架设计/架构设计-基金转换交易.md(v2.1)· docs/项目框架设计/开发计划-基金转换交易.md(v2.0 · T-1~T-17 逐任务改法 + DoD)
  • 架构改进线(✅ 2026-09-10 已结项,无待办):开工入口 交接文档.md §C
  • 风控模块主线:交接文档.md §A

代码入口

app/main.py               # FastAPI:路由挂载 + trace/audit 中间件 + lifespan(风控 4 API + /api/simulate + /api/chat 四端点已挂载)
app/api/chat.py           # 对话:POST ""(同步)+ GET /sessions + GET /sessions/{id}/messages + POST /sessions/{id}/close(方案 B)+ POST /stream(SSE 流式,方案 C)
app/api/deps.py           # 鉴权工厂(T-01 JWT:Bearer 优先,dev debug 头兜底)+ 归属断言
app/service/auth_service.py     # Auth SDK:JWT 验签/吊销(T-01);签发 CLI scripts/dev/issue_dev_token.py
app/service/agent_service.py    # LangGraph StateGraph 骨架 + DeepSeek(T-07)
app/config/settings.py    # 双库 jinrong_agent + jinrong_core + risk_* 阈值 + JWT 配置
app/repository/core_ro.py # Core 只读(已实现)
scripts/core/reset.ps1    # 本地灌 Core 模拟库

技术选型硬阀门见 MEMORY 第 3、7 节。Cursor 以 .cursor/rules/project-memory.mdc 为准。