group_fqcd_jr

390 Commits 12 Branches 0 Tags

3 Commits

Include renames

Author	SHA1	Message	Date
lzf_0626	076d786bc6	补齐客服转人工工单流：从"只能看"到"能推进"（基线状态机，不自行发明） ## 问题 `svc_handover_ticket` 的 DDL 与状态机在 `docs/02` §7.2 早就定好了（pending → assigned → processing → resolved → closed，未解决可 cancelled），但平台只有 handover:read（只读队列）：没有任何入口能改状态、assigned_to / accepted_at / resolved_at / closed_at / resolution 五列全库 0 非空，于是 40 张工单永远停在 pending —— 用户看到的就是"工单全都长一样"。 ## 改了什么后端： - 新增 `app/service/customer_service_handover_action_service.py`：五个动作（分配/接单/解决/关闭/取消），`SELECT ... FOR UPDATE` 锁单后判状态；接单允许从 pending 自助接管（同时记受理人）；取消不写 closed_at（该列属 closed 状态）；每次流转写一条 interaction_audit（handover.assigned/accepted/resolved/closed/cancelled）；非法流转 409、坐席不存在 422、工单不存在 404；回包不含 customer_id/session_id。 - 只读服务保持只读（读侧与写侧是两条边界，单测守着"读侧不许长出写方法"），但列表支持 `?status=` 六态筛选、详情补上受理人与流转时间（坐席侧路由信息，非客户数据）。 - `app/api/controllers/admin.py`：五个 action 端点 A049–A053 （assignments / acceptances / resolutions / closures / cancellations），走 `ApiTransactionService.execute_in` —— 幂等记录与业务写入同事务、重复键回放。 - 权限：新增 `handover:write`（9069，只授 admin），已并进种子 `tools/seed_test_rbac.py`；配套幂等脚本 `tools/grant_handover_write_permission.py`。前端（管理员工作台 · 转人工工单页）： - 按状态给按钮（待处理→分配/直接接单、已分配→接单、处理中→解决、已解决→关闭、未解决都可取消），加了状态筛选与"刷新"；摘要弹窗补上受理人与四个时间点、处置结论。 - api-client 注册五个端点；workspace.js 的 api-client 引用与页面自身的 ?v= 一并升版，避免浏览器拿旧缓存（旧缓存里没有这些端点）。冒烟与测试： - `tools/e2e_smoke_test.py`：B 段建的测试工单由 F 段走完分配→接单→解决→关闭收尾 —— 既不再把测试件堆在 pending 队列里（此前每次冒烟攒一张），又让每次冒烟都覆盖一遍状态机。总数 40 → 44 项，实测 44/44 全绿。 - 新增单测 24 条（状态机合法/非法路径、越权、坐席不存在、审计、视图不泄漏客户标识）与一条真机集成用例（HTTP 十步 + 数据库侧审计证据 + 自动清理）。 - 读侧那条"详情不得返回 assigned_to"的旧断言按新口径更新，并写清为什么。 ## 验证 - `pytest tests/unit tests/contract` → 1489 passed, 2 skipped, 0 failed - 新增集成用例通过；`tests/integration` 全量跑时 `test_memory_extraction` / `test_run_cancellation_mysql` 两条偶发红 —— 单独跑都通过，是 AGENTS.md 已登记的"常驻 Worker 抢队列"（跑验收前须先停 Worker） - `tools/portal_api_check.py` → 41 项通过 39、失败 0 - `tools/e2e_smoke_test.py` → 44/44 全通过 - `python tools/check_rbac_seed_consistency.py` → 通过（种子 63 条权限） - 真机 HTTP 实测：分配→接单→解决→关闭四步 200 且时间戳齐全；取消路径 200 且 closed_at 为空；同键重发回放不二次推进；对已关闭工单再分配 409；风控账号处置 403 ## 文档 `docs/44-演示流程.md`（场景 4/8 + 命令 + 44 项）、`docs/演示用/后端接口文档`（新增 §11.4b 与 A049–A053）、`docs/演示用/全功能流程-大白话版.md`（工单页签改"读写"+ 已知偏差）、 `AGENTS.md`（9066-9069 号段演进 + 冒烟 44 项）	2026-09-15 00:41:59 +08:00
lzf_0626	f37fd922a1	fix(seed): 演示预警的状态口径与代码对齐，并补 closed_at ## 结论：risk_action_service 没问题，我先前是误判 esolve（完成结案）写全了 status="已结案" + closed_at + handle_result（risk_action_service.py:105-107）， exclude 同样（:67-71）。我报的"结案没写 closed_at"看到的那条 ALDEMO0003 其实是种子预置样本，不是我以为的自己创建的那条 —— 我的冒烟脚本用 ALDEMO{时分秒} 命名，撞上了种子的 ALDEMO0001-0003，"已存在则跳过"把创建挡掉，随后处置全 409，串起来就像"结案没写时间"。真正的问题在种子数据，两处： 1) 状态口径与代码不一致：ALDEMO0003 写成 status="已关闭"，而 isk_action_service 里没有任何动作会产生这个状态（状态机只有待处理 / 调查中 / 已排除 / 已结案）。演示时会被当成系统行为，排查时又查不到出处。按它的 close_reason 语义（低风险 + 已核验为正常交易），它就是关闭误报 → 改为"已排除"。 2) 终态缺 closed_at：那条有 close_reason 却没有 closed_at，自相矛盾；而且 isk_repository 按 closed_at 统计"当日结案"，缺了它会被漏掉。 INSERT 补上该列，样本用 closed_at_offset_minutes 给值。 ## 顺带修掉冒烟脚本的撞号预警编号前缀 ALDEMO → E2E，注释里写明原因 —— 免得下次又操作到种子样本、还把现象当成新 bug。 ## 验证 - ALDEMO0003 现为 status=已排除 + closed_at 有值 - 库里所有终态预警（已排除/已结案）都带 closed_at；进行中的（调查中）不带 —— 口径一致 - 自己创建的两条走 resolve 后 status=已结案且 closed_at/handle_result 都有值 - 冒烟重跑：40/40 通过，新造预警编号 E2E134351，处置闭环三段全 PASS 门禁：ruff 通过 / mypy 250 文件 0 错 / 单元+契约 1381 passed 2 skipped。	2026-09-13 21:44:08 +08:00
lzf_0626	2fcc4939e7	feat(tools): 新增全流程端到端冒烟脚本 e2e_smoke_test.py 把验收清单里"能用接口判定"的部分自动化：6 条线 40 项，打真实 HTTP、逐条打印 PASS/FAIL。不是 pytest 的替代 —— 单测看代码正确性，它看"部署后底座是不是活的"。覆盖： A 访客令牌 → 提问 → 收到回答 → 未转人工 B 客户登录 → 看板/持仓/流水 → 真实下单成交 → 委托详情 → 会话与转人工 C 风控概览/队列/详情/八类证据/通知/扫描 → 处置闭环（确认→调查→结案） D 投顾已发布方案 E 运营场外邮件与邮箱状态 F 管理员角色/权限/身份/配置发布/模型端点/审计/转人工工单/画像候选两个实现细节值得留意： - 各端点 data 形状不统一（角色列表裸数组、持仓在 holdings、成交明细在 transactions、资金流水在 entries、知识列表不套 data），所以这里用 listed(payload, keys) 依次尝试，并在注释里写明"别猜字段名"—— 我自己写联调脚本时连续猜错三次。 - 库里没有"待处理"预警时自动造一条*再验证处置闭环，否则该环节只能跳过（实测库里的预警常常都已被处置过，第一次跑就跳过了）。新增 --read-only：跳过所有写操作，用于生产或不想动数据时。实测：40/40 通过（含真实下单 201 已成交、风控处置闭环三段全 PASS）。 docs/40 补上"一键冒烟"一节。	2026-09-13 21:39:37 +08:00

Author

SHA1

Message

Date

lzf_0626

076d786bc6

补齐客服转人工工单流：从"只能看"到"能推进"（基线状态机，不自行发明）

## 问题
`svc_handover_ticket` 的 DDL 与状态机在 `docs/02` §7.2 早就定好了
（pending → assigned → processing → resolved → closed，未解决可 cancelled），
但平台**只有 handover:read（只读队列）**：没有任何入口能改状态、assigned_to /
accepted_at / resolved_at / closed_at / resolution 五列**全库 0 非空**，
于是 40 张工单永远停在 pending —— 用户看到的就是"工单全都长一样"。

## 改了什么
后端：
- 新增 `app/service/customer_service_handover_action_service.py`：五个动作
  （分配/接单/解决/关闭/取消），`SELECT ... FOR UPDATE` 锁单后判状态；
  接单允许从 pending 自助接管（同时记受理人）；取消不写 closed_at（该列属 closed 状态）；
  每次流转写一条 interaction_audit（handover.assigned/accepted/resolved/closed/cancelled）；
  非法流转 409、坐席不存在 422、工单不存在 404；回包不含 customer_id/session_id。
- 只读服务保持只读（读侧与写侧是两条边界，单测守着"读侧不许长出写方法"），
  但列表支持 `?status=` 六态筛选、详情补上受理人与流转时间（坐席侧路由信息，非客户数据）。
- `app/api/controllers/admin.py`：五个 action 端点 A049–A053
  （assignments / acceptances / resolutions / closures / cancellations），
  走 `ApiTransactionService.execute_in` —— 幂等记录与业务写入同事务、重复键回放。
- 权限：新增 `handover:write`（9069，只授 admin），已并进种子
  `tools/seed_test_rbac.py`；配套幂等脚本 `tools/grant_handover_write_permission.py`。

前端（管理员工作台 · 转人工工单页）：
- 按状态给按钮（待处理→分配/直接接单、已分配→接单、处理中→解决、已解决→关闭、
  未解决都可取消），加了状态筛选与"刷新"；摘要弹窗补上受理人与四个时间点、处置结论。
- api-client 注册五个端点；workspace.js 的 api-client 引用与页面自身的 ?v= 一并升版，
  避免浏览器拿旧缓存（旧缓存里没有这些端点）。

冒烟与测试：
- `tools/e2e_smoke_test.py`：B 段建的测试工单由 F 段走完 分配→接单→解决→关闭 收尾
  —— 既不再把测试件堆在 pending 队列里（此前每次冒烟攒一张），又让每次冒烟都覆盖一遍状态机。
  总数 40 → 44 项，实测 44/44 全绿。
- 新增单测 24 条（状态机合法/非法路径、越权、坐席不存在、审计、视图不泄漏客户标识）
  与一条真机集成用例（HTTP 十步 + 数据库侧审计证据 + 自动清理）。
- 读侧那条"详情不得返回 assigned_to"的旧断言按新口径更新，并写清为什么。

## 验证
- `pytest tests/unit tests/contract` → 1489 passed, 2 skipped, 0 failed
- 新增集成用例通过；`tests/integration` 全量跑时
  `test_memory_extraction` / `test_run_cancellation_mysql` 两条偶发红 —— 单独跑都通过，
  是 AGENTS.md 已登记的"常驻 Worker 抢队列"（跑验收前须先停 Worker）
- `tools/portal_api_check.py` → 41 项通过 39、失败 0
- `tools/e2e_smoke_test.py` → 44/44 全通过
- `python tools/check_rbac_seed_consistency.py` → 通过（种子 63 条权限）
- 真机 HTTP 实测：分配→接单→解决→关闭四步 200 且时间戳齐全；取消路径 200 且 closed_at 为空；
  同键重发回放不二次推进；对已关闭工单再分配 409；风控账号处置 403

## 文档
`docs/44-演示流程.md`（场景 4/8 + 命令 + 44 项）、`docs/演示用/后端接口文档`（新增 §11.4b 与
A049–A053）、`docs/演示用/全功能流程-大白话版.md`（工单页签改"读写"+ 已知偏差）、
`AGENTS.md`（9066-9069 号段演进 + 冒烟 44 项）

2026-09-15 00:41:59 +08:00

lzf_0626

f37fd922a1

fix(seed): 演示预警的状态口径与代码对齐，并补 closed_at

## 结论：risk_action_service 没问题，我先前是误判


esolve（完成结案）写全了 status="已结案" + closed_at + handle_result（risk_action_service.py:105-107），
exclude 同样（:67-71）。我报的"结案没写 closed_at"看到的那条 ALDEMO0003
其实是**种子预置样本**，不是我以为的自己创建的那条 —— 我的冒烟脚本用
ALDEMO{时分秒} 命名，**撞上了种子的 ALDEMO0001-0003**，"已存在则跳过"把创建挡掉，
随后处置全 409，串起来就像"结案没写时间"。

真正的问题在种子数据，两处：

1) **状态口径与代码不一致**：ALDEMO0003 写成 status="已关闭"，而
   
isk_action_service 里**没有任何动作会产生这个状态**（状态机只有
   待处理 / 调查中 / 已排除 / 已结案）。演示时会被当成系统行为，排查时又查不到出处。
   按它的 close_reason 语义（低风险 + 已核验为正常交易），它就是**关闭误报** → 改为"已排除"。

2) **终态缺 closed_at**：那条有 close_reason 却没有 closed_at，自相矛盾；
   而且 
isk_repository 按 closed_at 统计"当日结案"，缺了它会被漏掉。
   INSERT 补上该列，样本用 closed_at_offset_minutes 给值。

## 顺带修掉冒烟脚本的撞号

预警编号前缀 ALDEMO → E2E，注释里写明原因 —— 免得下次又操作到种子样本、
还把现象当成新 bug。

## 验证

- ALDEMO0003 现为 status=已排除 + closed_at 有值
- 库里所有终态预警（已排除/已结案）都带 closed_at；进行中的（调查中）不带 —— 口径一致
- 自己创建的两条走 resolve 后 status=已结案 且 closed_at/handle_result 都有值
- 冒烟重跑：40/40 通过，新造预警编号 E2E134351，处置闭环三段全 PASS

门禁：ruff 通过 / mypy 250 文件 0 错 / 单元+契约 1381 passed 2 skipped。

2026-09-13 21:44:08 +08:00

lzf_0626

2fcc4939e7

feat(tools): 新增全流程端到端冒烟脚本 e2e_smoke_test.py

把验收清单里"能用接口判定"的部分自动化：6 条线 40 项，打真实 HTTP、逐条打印 PASS/FAIL。
不是 pytest 的替代 —— 单测看代码正确性，它看"部署后底座是不是活的"。

覆盖：
  A 访客  令牌 → 提问 → 收到回答 → 未转人工
  B 客户  登录 → 看板/持仓/流水 → 真实下单成交 → 委托详情 → 会话与转人工
  C 风控  概览/队列/详情/八类证据/通知/扫描 → 处置闭环（确认→调查→结案）
  D 投顾  已发布方案     E 运营  场外邮件与邮箱状态
  F 管理员 角色/权限/身份/配置发布/模型端点/审计/转人工工单/画像候选

两个实现细节值得留意：
- **各端点 data 形状不统一**（角色列表裸数组、持仓在 holdings、成交明细在 transactions、
  资金流水在 entries、知识列表不套 data），所以这里用 listed(payload, *keys) 依次尝试，
  并在注释里写明"别猜字段名"—— 我自己写联调脚本时连续猜错三次。
- 库里没有"待处理"预警时**自动造一条**再验证处置闭环，否则该环节只能跳过
  （实测库里的预警常常都已被处置过，第一次跑就跳过了）。

新增 --read-only：跳过所有写操作，用于生产或不想动数据时。

实测：40/40 通过（含真实下单 201 已成交、风控处置闭环三段全 PASS）。

docs/40 补上"一键冒烟"一节。

2026-09-13 21:39:37 +08:00