张胜宇
44b57a56ce
docs(D2.9): 补精确 G 组出口语义（P0/P1/P2 与 E5c）+ 两条判分别名说明
2026-09-20 17:32:16 +08:00
张胜宇
eb1822d802
docs(W18): D2.4 索引口径更正为 AUTOINDEX（v1.6）+ D2.9 手动对话测试用例成文 + 空白消息 500 修复
...
- D2.4 v1.3 -> v1.6：索引统一 AUTOINDEX（设计初稿 HNSW/IVF_FLAT 未落地，实库直查为据）
更正 9 处 + 新增 §4.1 索引口径落地注；语料 628 -> 675 块并补 fin_basic_collection 说明
（三集合仍是唯一默认检索面，basic 并入会使 M-1 100% -> 91.3%）
- 新增 客服agent/D2.9-客服Agent手动对话测试用例-2026-09-20.md：
46 条金标逐条可问 + 11 条边界 Z 组 + 判分四问 + M-1~M-10 手动汇总 + 真 HTTP 核验配方
实测登记 3 项缺口：空白消息 500（已修）/ 语料档位口径矛盾（待裁定）/ 重复问句漂移（待裁定）
- 修修复：message 纯空白 500 -> 422 AGENT_INPUT_INVALID（入口补判据 + 回归测试）
- tools/chat_console.py 提示语去掉已下线产品名（季季盈）
- 落档：D1.1 §27（60 -> 61 份 / 客服agent 8 -> 9 份 / 注入校验 56 -> 57）、D2.1 v6.33、D1.6 §4.46
- 门禁：check_authoritative_docs 通过、_consistency.py GATE PASS、pytest 1915 passed / 0 failed
2026-09-20 17:31:40 +08:00
张胜宇
921de2cfc3
docs(W17): 知识库 RAG 全链路与选型说明成文（D2.8）—— 按八阶段讲清解析/切片/检索增强 + 4 张流程图
...
新增 客服agent\D2.8-客服Agent知识库RAG全链路与选型说明-2026-09-20.md（域 2，D2.x 续号，683 行）。
- 按流程逐步：语料与解析 → 切片 → 向量化 → 存储 → 入库七步 → 在线八步 → 检索增强 7 个动作 → 阈值与五出口。
- 4 张 Mermaid 图：端到端全景 / 切片与派生字段 / 检索增强 / 出口决策树。
- 切片写透：叶子标题策略（对照三种真实情况）、表格逐行拆自解释小块（父子块）、表头 bug 与自检守卫。
- 检索增强 7 动作：向量召回 / 字面召回（专有名词，条件触发）/ 父块带回 ×0.9 / doc_id 去重 / 兄弟子块归并 / 整节块保底席位 / 证据包三种形态。
- 阈值取证：0.75/0.55/0.07/0.40/0.5，MIN_GAP 实测标定区间 (0.0649, 0.0759)。
- 选型原因：8 项决策 26 备选，逐项含否决理由与演进触发条件。
- 实测：切片件 675 块，Milvus 四集合 count(*) 150/191/288/46 与切片件逐集合一致，索引全 Finished。
- 新登记 3 项不一致（只登记不修复）：① 文档写 HNSW/IVF_FLAT 而实库是 AUTOINDEX；② tools\configure_embedding_endpoint.py 会建出第二个 embedding 端点（重跑可能造成索引与查询不同模型的无声质量崩塌）；③ agent_faq_synonym 表检索链路不读（术语归一化未落地）。
- 计数同步：D1.1 v1.6→v1.7，59→60 份（58→59 份编号），客服agent\ 7→8 份；§4.0 总表与 §4.1 明细各新增 D2.8 行；注入校验 55→56 份；新增 §26 轮次段。
- D2.1 标题 v6.31→v6.32；D1.6 新增 §4.45（含一处自我更正：误读旧 JSON 导致"实库缺 family_id/param_class/intent"的错误结论）。
- 本轮不改代码、未跑金标评测；门禁：check_authoritative_docs.py 通过 + _consistency.py GATE PASS。
2026-09-20 16:58:42 +08:00
张胜宇
bcedf71e12
docs(W16): 中长期记忆与画像联动设计成文（D2.7）—— 三问直答 / 五道闸门取证 / INV-M1~M6 / 废弃理由更正
...
新增 客服agent\D2.7-客服Agent中长期记忆与画像联动设计-2026-09-20.md（域 2，D2.x 续号）。
- 主设计主张：让记忆改变「系统行为」而非「模型输入」——记忆只作确定性信号（检索分区加权 / 澄清候选排序 / E2 计算入参 / 适当性过滤），永不进生成上下文（FR-CS-009 + FR-CS-049）。
- 新增记忆子域不变量 INV-M1~INV-M6（INV-M6：记忆只能收窄、不能放宽）。
- 登记两处过期理由：D2.2 §1.7 第 12 项 + 第 998 行澄清框仍引「投顾已整体清除」，而投顾已于 2026-09-20 恢复（D4.7）。
- 计数同步：D1.1 v1.5→v1.6，58→59 份（57→58 份编号），客服agent\ 6→7 份；§4.0 总表与 §4.1 明细各新增 D2.7 行；注入校验 54→55 份；新增 §25 轮次段。
- D2.1 标题 v6.30→v6.31（新增 v6.31 段）；D1.6 新增 §4.44。
- 本轮不改代码、不改行为；门禁：check_authoritative_docs.py 通过（54 份无编号冲突）+ _consistency.py GATE PASS。
2026-09-20 16:31:29 +08:00
张胜宇
e28e1f3900
docs(W16): 落档「Agent 与用户画像关系 / 对话能否更新画像 / 中长期记忆」咨询轮 —— D2.1 v6.30 / D1.6 §4.43 / D1.1 §24 版本位
2026-09-20 16:25:44 +08:00
张胜宇
c3d57fbf3f
feat(cs)+docs: 修掉 P1 错分「风险测评结果」—— 画像问答改由受控工具作答（W15）
...
背景（用户提问触发）：
§1.2.1「客户能看本人的持仓/交易/账户/画像与风评」与 §1.4.5 P1
「账户与个人数据（含风险测评结果）Agent 无权限读取」读起来互相矛盾。
实测根因（两处）：
1) route_message() 在画像分支之前，且 P1_KEYWORDS 含裸词「风险测评结果」
⇒「我的风险等级是多少」走画像作答，
「我的风险测评结果是什么」被降级成「无法读取本人账户数据」
—— 同一诉求两种结论，属「能答而不答」（H-03 同类）。
2) 画像词在前、账户词在后的混问法漏网
（「我的风险测评结果和持仓一起给我」落 P3 ⇒ 只答画像、静默忽略账户诉求）。
依据（决定性）：D2.2 §1.7 第 21 项「画像问答字段直返」；
D3.1 §0.3 术语表「画像问答属客服能力，与持仓查询严格区分」。
代码：
- app/core/customer_service_rules.py：P1_KEYWORDS 移除裸词 + 口径说明；
P1_PATTERNS 新增混问法守卫（第一人称 + 画像词 + 并列连词 + 账户词）。
- customer_service.py / profile_projection.py：补「投影层白名单 ⊇ 客服对话
渲染集」口径（total_asset / behavior_score / risk_tags 刻意不陈述，
渲染它们等于用画像工具绕过 P1）。
守卫：
- test_customer_service_rules.py：RT-004 → None；新增 RT-004b → P1；
SAFETY_CASES 由字面区间改显式名单（RT-004b 字母后缀会落区间外被静默漏掉）。
- test_customer_service_agent.py：画像端到端 3 条 + 混问法反向守卫。
安全不降：答案只来自 query_customer_profile（self 作用域 + 字段白名单 + 工具
审计），查不到失败关闭、绝不猜等级；P0/P2 未动、P1 其余字面未动；
混问法仍走 P1；访客问画像仍引导登录。
文档：D2.2 v2.5→v2.6 / D3.1 v2.4→v2.5 / D2.6 更正 / D4.6 追加 §3（不改正文）
/ D1.1 §24 + 版本位 / D1.6 §4.41 修正误记 + §4.42 / D2.1 v6.29。
实测：pytest 1914 passed / 3 skipped / 0 failed（+5）；ruff 20（无新债）；
check_authoritative_docs 54 文档无冲突；_consistency GATE PASS；
http_probe 11/11；定向真机复验 9/9；portal_api_check 35/0/5；
e2e_smoke 31/31；fe_boundary 12/12；demo.ps1 五项自检全过。
2026-09-20 16:22:02 +08:00
张胜宇
56cb15342b
docs(D1.1): 历史轮次里 docs/46-47 的指针补改名记录（指向 §23 的 docs/48-49）
2026-09-20 15:27:45 +08:00
张胜宇
c91bbcbdc1
feat(ops)+docs: 密钥轮换工具 + 两份文档目录审计收口（D1.1 §23 / D2.1 v6.26）
...
一、密钥轮换（新增工具 + 操作手册）
- 新增 tools/rotate_api_keys.py：--check 体检 + 交互式轮换；getpass 不回显、
自动备份 .env.bak-<时间戳>（已被 ignore 命中）、校验不过整体不写入、
三个 Qwen 变量写同一值 / 两个 DeepSeek 变量写同一值。
实测 --check：Qwen 三变量同值且非空、DeepSeek 两变量同值且非空。
- 新增 开发文档/D3.8-模型密钥轮换与凭据安全操作手册-2026-09-20.md（CS-OPS-2026-023）：
.env 5 个变量与读取方取证、五步流程、3 个坑、复核清单、回退方式、能力边界。
- 口径确认：model_endpoint_config.secret_ref 存变量名 ⇒ 轮换只改 .env，不动 DB；
但必须重启 API + Worker。
二、门禁修复：docs/ 编号撞车
- tools/check_authoritative_docs.py（D3.4 N-14 登记的验收命令集之一）实测 FAIL：
我方 docs/46 docs/47（2026-09-20 建）与投顾组 docs/46-投顾Agent需求文档.md
docs/47-投顾Agent功能架构文档.md（2026-09-16 建）同号。
- 按「后到者让位」改名：docs/48-可改文件白名单.md / docs/49-底座会签申请单-2026-09-19.md，
同步 8 处引用。修复后：checked 54 documents, no number collision，exit 0。
三、前端品牌残留（W12 合并静默回退）
- employee-advisor/dashboard/index.html 与 customer/advisor-plans/index.html 的
<title> 仍是 南方财富（投顾组分支带回）→ 按 DEC-27 改为 南方基金。
- HTTP 实测两页标题已正确；全仓 app/ 复查 南方财富 = 0。
四、文档口径校准（12 处事实漂移）
- D1.1：D2.1 版本 v5.3 → v6.26（§4.0 / §4.1 / §1 / §2 四处长期错误）；
§8 四行遗留项闭合（D-5 / D-6 / D-7 / 仓库副本同步）+ 新增 §22 §23 留痕；
§10.2「本区不在任何 git 仓库内」更正为已入库；新增两编号 ⇒ 计数 56 → 58 全量同步。
- D2.2：顶栏徽标 v2.4 与元数据 v2.5 自相矛盾 → 统一；「投顾已清除」→ 状态更新
（模块 2026-09-20 已恢复，但客服范围裁定 §1.7 / RK-10 不变）。
- D2.3：徽标 v1.0 · 7 批次 51 项 → v1.1 · 8 批次 57 项；投顾清除后果 + §7.1 头号风险
+ 风险表 + 不触碰行全部加恢复口径。
- D2.4：v1.3 变更说明 ⑦ / §1.4 Out of scope / Q-09 加投顾恢复口径。
- D2.5：advisor_t 自相矛盾口径改写为账号表一行 + 口径更正；五项自检首选改为
一键脚本 启动演示.bat / demo.ps1；补 D3.8 与未发布 advisor:* 白名单登记。
- D2.6：门禁数字 1856/2 → 1909/3 skipped、ruff 19 → 20、补 portal_api_check 行；
§10 两项已闭环（密钥轮换已工具化、A-10 组 3/4 已补签）；头部加 W12/W13 状态更新。
- D4.5：顶部状态更新补指向 D4.7。
- 新增 开发文档/D4.7-投顾模块恢复记录-2026-09-20.md（CS-PURGE-2026-014）：
时间线、8 项恢复动作、客服线不变的结论、DEC-19 理由更正、遗留 1 项、失误登记。
- _consistency.py（维护侧）：§三 改为「投顾状态口径检查」，合法语境扩为
清除史 / 恢复史 / 不属本 Agent 范围。
五、回归实测（全绿）
- pytest -q：1909 passed / 3 skipped / 0 failed
- ruff check app tools tests：20（与 W12 持平，未引入新债）
- mypy app：2（= 既有基线）
- tools/check_authoritative_docs.py：54 文档无编号冲突（exit 0）
- tools/e2e_smoke_test.py --read-only：31/31
- tools/portal_api_check.py：40 项 通过 35 / 失败 0 / 跳过 5
- _eval_harness/http_probe.py：11/11 succeeded
- _consistency.py：GATE PASS
- demo.ps1 -SkipStart -NoBrowser：五项自检全过、退出码 0
- 权威副本 ↔ 仓库：逐字节一致（客服agent 24 / 开发文档 52）
六、未做（如实登记）
- 投顾 config_release 工具白名单（advisor:*）仍未发布 ⇒ 投顾 Agent 工具调用 fail closed
（实测 active_agent_tools 仅 customer_service:* 4 项 + risk:* 4 项）。与客服线无关；
要演投顾线先跑 tools/publish_advisor_demo_config.py --apply。
- 两把 key 的实际轮换需你在控制台建新 key（无法代做），流程见 D3.8。
2026-09-20 15:27:07 +08:00
张胜宇
4306326a56
docs: 落档本轮（演示一键启动 + 权威文档入库 + 回归复跑）
...
- `开发文档/D1.6` 新增 **§4.38**：本轮指令原文、`demo.ps1`/`启动演示.bat` 的职责与实测结果、
两个真实问题（PS 5.1 传参吞双引号 ⇒ 改走 stdin；终端乱码经复核是捕获侧假象）、
**权威文档入库的关键判断**（仓库内是 2026-09-16 前的过期副本 + 旧文件名，少 49 份 ⇒
按「权威覆盖过期」入库并复核零差异）、入库前密钥扫描结论、回归复跑全表、推送记录。
- `客服agent/D2.1` 升 **v6.25**：同上要点的执行看板口径，并写明「后续同步文档一律按
权威副本 -> 仓库 单向覆盖」。
- 两份文件的仓库副本与权威副本**逐字节一致**（已复核）。
回归（入库后跑）：pytest 1909 passed / 3 skipped / 0 failed；ruff 20；mypy app 2；
e2e_smoke 31/31；portal_api_check 40 项 35/0/5；http_probe 11/11；_consistency GATE PASS。
2026-09-20 15:09:12 +08:00
张胜宇
bc61d5c579
docs: 入库权威文档目录（客服agent/ 24 份 + 开发文档/ 50 份，替换旧命名的过期副本）
...
## 为什么做这一步
权威文档 74 份此前**只在本机**，评审者 clone 分支后看不到任何设计文档；而仓库里那两份同名目录
是 **2026-09-16 之前的过期副本，连文件名都是旧的**（无体系编号）。本次按「**权威覆盖过期**」入库。
## 入库内容
| 目录 | 文件数 | 体积 | 说明 |
|---|---|---|---|
| `客服agent/` | 24 | 0.77 MB | `D2.1`~`D2.6` 对外交付四件套 + 演示脚本/答辩报告 + `_build` 构建工具 |
| `开发文档/` | 50 | 2.16 MB | `D1.x` 索引与决策、`D3.x` 方案、`D4.x` 清除与重构留痕、`D5.x` 业务流程、`D6.x` 业务事实基座、`D7.x` 交付物、`D8.x` 规范 |
**旧的过期副本整体移除**（`客服Agent执行Todolist.md` → `D2.1-客服Agent执行Todolist.md` 之类
的改名 + 新增 `D2.5`/`D2.6`），入库后目录内容与权威副本**逐文件一致（零差异，已复核）**。
## 入库前的安全扫描（必须留痕）
- 扫描规则：`sk-` 类密钥 / `Bearer` 长串 / `password=`、`api_key=` 赋值 / 会话中出现过的两把明文 key 片段。
- 结论：**真实密钥只出现在 `.env`**（已被 `.gitignore` 命中，未入库）；`.env.example` 与
`config/risk.env.example` 只有**空占位**。
- 文档内唯一命中是 `D3.1` 里一处**截断的示例 JWT**（`Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...`），
末尾带省略号，是接口文档的示意值，**不是可用凭据**。
2026-09-20 15:03:15 +08:00
张胜宇
e0992c663e
feat(demo): 新增演示一键启动脚本（demo.ps1 + 启动演示.bat）
...
演示真正要做的事只有一件：**把要看的前端页面按顺序打开，并确认环境真的就绪**。
原先只有 `start.ps1`（起服务），演示前还得手工跑行情刷新与五项自检，容易漏。
本次新增：
- `start.ps1`：不动（它已经幂等，缺什么补什么，重复执行不会起第二个 API/Worker）。
- `demo.ps1`：在 start.ps1 之上补三件事 ——
① **刷新行情**：下单要求行情快照落在 15 分钟有效期内（`trade_service.MAX_QUOTE_AGE`），
过期后所有委托直接 503，而系统没有自动刷新机制；
② **五项自检**：口径与 `客服agent/D2.5` §1 完全一致（容器三件套 / 向量库三集合计数 /
Worker 在跑 / 行情有效期 / `milvus_local_uri` 开关为空）；
③ **打开演示页面**：访客页（客服浮窗主战场）+ 客户登录页。
另把「**登录限流 10 次 / 60 秒**，不要反复登录」这条最容易造成假故障的提醒印在「开讲前必看」。
- `启动演示.bat`（GBK，与本仓库既有 .bat 同编码）：双击即用，参数透传给 demo.ps1。
实测（本机）：`启动演示.bat -SkipStart -NoBrowser` 与完整路径（含调用 start.ps1）
均 **五项自检全过、退出码 0**。
排错留痕（避免后人改回去）：Milvus 探测代码原本用 `& $Python -c $probe` 传参，
Windows PowerShell 5.1 传原生命令参数时会把内嵌双引号吞掉（报 `unterminated string literal`）
⇒ 改为经 **stdin** 传给 python，并在脚本里写明原因。
2026-09-20 15:02:53 +08:00
张胜宇
e5b4d02b0d
merge: 集成投顾组 3 个提交（解除与「投顾模块清除」的冲突）+ 客服 Agent 重构收口
...
## 为什么要合并
远端 `origin/qyqy_develop` 领先 3 个提交（`5607751` / `2fe7d0c` / `74b7d00`：投顾需求与架构文档、
客户主动申报投顾方案 + 受理自动出草稿、方案交付落点与推荐依据 LLM 增强），而本地 `5d0becb`
按 `D4.4` / `D4.5`（CS-PURGE-2026-012/013）把投顾模块整体清除了。**两个目标不可兼得**：
远端新代码反向 import 已被清除的模块（`app.model.investment_goal`、
`app.service.product_recommendation_service`、`app.service.advisor_rollout_service`），
强行推进只会让两边都跑不起来。
**裁定：投顾组的新功能 > 本地的投顾清除。** 依据是 `D4.4` §0-②③ 自己写下的风险
——按名字清投顾会同时拆掉产品数据底座与 MVP 硬阻断，并失去"改 6 个底座文件时的对照组"。
本次合并因此**恢复投顾模块**；就代码面而言，`D4.4` / `D4.5` 的清除结果被本次合并取代
（留痕见 `开发文档\D1.6` §4.37）。
## 冲突怎么解的（12 处）
- **8 处 modify/delete 取远端**：`recommendations.py` / `product_recommendation_service.py` /
`employee-advisor/dashboard/{actions-module.js,dashboard.css,dashboard.js,index.html}` /
`tools/{check_portal_modules.py,grant_advisor_role.py}` —— 即"我删、远端改"，保留投顾文件。
- **3 处内容冲突取远端**：`app/main.py`（投顾 import 与 `include_router`）、
`common/api-client.js`（投顾端点表）、`tests/unit/api/test_portal_frontend.py`（4 条投顾前端契约）。
- **1 处取远端 + 保留我方**：`app/main.py` 解除冲突的同时，保留本轮的
`/customer-service-test` 挂载移除（该联调页与用例已随重构作废）。
## 因"取消清除"而必须回滚的语义改动（否则恢复出来的投顾代码跑不动）
- `app/service/agent/bootstrap.py`：恢复 `AdvisorAgent` 与 5 个投顾工具注册
（`query_investment_goal` / `analyze_portfolio` / `generate_asset_allocation` /
`recommend_products` / `compare_products`）；客服 Agent 注释按本轮口径保留。
- `app/core/config.py`：恢复 `advisor_rollout_enabled` / `advisor_rollout_customer_ids`。
- `app/static/portal/common/layout/app-shell.js`：恢复投顾工作台导航与 `advisor` 角色名。
- `tools/seed_test_rbac.py`：恢复"admin 取全量元组"的授权模型（保留远端新增的
9070-9074 权限码与客户侧 9071/9072 绑定）。
- `tools/portal_api_check.py`：恢复投顾实测用例（AD003/AD005/AD011/A047 与 `advisor_t` 登录），
并**新增判定**：被渲染的集合为空（0 条）时判 `SKIP` 而不是 `FAIL`
—— "没有行"与"字段没带"是两回事，混报会把排查方向带偏。
- `app/static/portal/common/api-client.js`：以远端为基准，重新叠加本轮的
**访客令牌 `Authorization` 优先**修复（浮窗访客身份稳定性）。
## 数据库夹具同步（代码恢复 ⇒ 夹具也要恢复）
- `tools/grant_advisor_role.py`：新建 `advisor` 角色并授权（实测 34 项权限）。
- `tools/create_test_user.py --id 9020 --username advisor_t --role advisor`：重建演示账号。
## 集成期发现并修掉的过期断言
- `tests/unit/test_advisor_migration_contract.py`：alembic 末端钉死值仍是
`20260914_baseline_auto_increment`，而远端新增了 `20260916_advisor_service_request`
⇒ 这条断言**在远端分支上本身就是红的**。本次把它更新到新末端并补了注释。
## 验证（本机实测）
| 门禁 | 结果 |
|---|---|
| `pytest -q`（全量，含集成） | **1909 passed / 3 skipped / 0 failed** |
| `ruff check app tools tests` | 20（远端分支 22，本地仅客服线基线 19） |
| `mypy app` | 2（= 既有基线） |
| `tools/portal_api_check.py` | 40 项：通过 35 / 失败 0 / 跳过 5 |
| `tools/e2e_smoke_test.py --read-only` | 31/31 |
| `_eval_harness/http_probe.py` | 11/11 succeeded |
| `_consistency.py` | GATE PASS |
| `_fe_boundary_http.py`（前端入参边界真机） | 全部符合预期 |
## 未做（如实登记）
- **投顾演示数据未灌**：`AD011` / `A047` 需要 `advisor_product_suitability_reference`
这类带 `source_url` + `document_sha256` 的证据行，而披露文件不在仓库里；
`tools/seed_advisor_demo.py` 明确"不编证据"（fail closed），故这两条按空集 SKIP。
- **客服线文档目录仍未入库**：`客服agent/`、`开发文档/`（权威副本在本机）与
`_chunks_report.txt`（本地构建产物）依旧排除在提交之外。
2026-09-20 14:52:35 +08:00
张胜宇
5d0becb67d
客服 Agent 重构收口：五出口决策链 + 知识库档位隔离 + 前端入参边界（答辩演示版本）
...
一、客服 Agent 智能增强（正面回应"不智能、动不动就转人工"）
- 决策链由 2 个出口扩到 5 个：E1 澄清 / E2 计算型 / E3 知识直返 / E4 证据约束生成 / E5 分级回退
- 转人工从"默认动作"降为最后一档 E5c，只保留 4 类白名单：
P0 反诈 / P1 账户与个人数据 / P2 写操作与争议 / 用户明确要求人工
- 46 条金标实测（修复前 → 修复后）：
转人工率 43.5% → 10.9%；出口准确率 45.7% → 100%；事实正确率 69.6% → 100%
禁忌违反 1 → 0；档位越权 / 无出处数字 / 误拒 四项零容忍全 0
- 安全不变量 INV-1~INV-5；零容忍规则未删，改的是挂载点
（输出侧字面黑名单 → 检索层档位隔离 + 判定层合规词表 + 输出守护）
二、知识库：档位单点化与物理隔离
- 新增 app/core/knowledge_tier.py 作为档位规则唯一落点（G-03），
knowledge_contracts.py 原定义块改为显式再导出（X as X，非副本）
- 档位过滤由 bool 默认值（fail-open）改为 tiers 必填集合（缺参即 TypeError）
- Milvus 侧四集合按 visibility 分区键物理隔离；双 schema 收敛为一套
- 新增 app/core/actor.py：访客三元组与匿名判定的唯一构造/判定点（G-01/G-01b）
- 新增 app/core/fund_fee_rules.py：费率计算纯函数
三、前端入参边界对齐（本轮 W11 新修，4 处"校验宽于存储"）
- message 加 max_length=8000（与浮窗 widget.js 的 maxlength 一致）
- session_id 加 1—64；idempotency_key 上限 128 → 64（对齐列宽 String(64)）
- feedback_type 加 max_length=32（对齐列宽 String(32)）
- 8 条路径参数补 min_length=1 + max_length=64 + 字符集正则
（{session_id} / {run_id} / {handover_id}）
- 改前超限值会落到 MySQL 才失败（500）；改后一律 422 AGENT_INPUT_INVALID + 字段级定位
- 新增 tests/unit/api/test_frontend_boundaries.py（33 例），含"端点表 ↔ OpenAPI 全量对照"
四、投顾模块整体清除（D4.4 / D4.5）
- 删除投顾相关 controller / schema / model / repository / service 及门户页面
- tools/portal_api_check.py 同步作废 AD003/AD005/AD011/A047 四条用例与 advisor_t 登录
（端点与账号均已不存在，此前稳定报 3 条假红）
五、验证（提交前实测）
- pytest -q：1856 passed / 2 skipped / 0 failed
- ruff check app tools tests：19（= 基线）；mypy app：2（= 基线）
- 前端接口契约体检 portal_api_check.py：38 项，通过 34，失败 0，跳过 4
- 全链路冒烟 e2e_smoke_test.py --read-only：31/31
- HTTP 全链路探针 http_probe.py：11/11 succeeded
- 跨文档一致性 _consistency.py：GATE PASS
- 真机边界复验 12 条：12/12 符合预期
六、纪律与文档
- 可改文件白名单 A-09（docs/46）与底座会签申请单 A-10（docs/47，组 1—组 4 全部受理）
- 零 DDL：未新增/修改任何表结构，89 张业务表与基线一致
- 证据留痕：docs/evidence/**（含 46 条金标 score、快照、清除与重建记录）
- 未提交（刻意排除，见提交说明）：仓库内 客服agent/ 与 开发文档/ 是 2026-09-16 前的
过期副本（Todolist 440 行 vs 权威 D2.1 1167 行），权威正本在仓库外；
_chunks_report.txt 是 tools/build_knowledge_chunks.py 生成的本地产物
2026-09-20 14:33:30 +08:00
张胜宇
3134fe5dd0
Merge branch 'qyqy_develop' of http://47.106.207.27:3000/AI260626/group_fqcd_jr into qyqy_develop
2026-09-14 01:45:47 +08:00
张胜宇
f5d1b24618
merge qyqy_develop and retain risk review updates
2026-09-14 01:41:02 +08:00
张胜宇
5929eb151b
merge: integrate latest qyqy_develop changes
2026-09-13 23:10:46 +08:00
张胜宇
3325232e2a
feat(portal): complete advisor workspace operations
2026-09-13 23:04:35 +08:00
张胜宇
aa4b9bf367
Merge remote-tracking branch 'origin/qyqy_develop' into qyqy_develop
2026-09-13 19:26:31 +08:00
张胜宇
e3c316aafb
Enforce trading authorization and suitability checks
2026-09-13 19:24:59 +08:00
张胜宇
b9aafce120
Merge remote-tracking branch 'origin/qyqy_develop' into qyqy_develop
2026-09-13 18:33:34 +08:00
张胜宇
e740a58e9d
前端2
2026-09-13 18:31:38 +08:00
张胜宇
e38ece32bf
前端提交
2026-09-13 15:56:54 +08:00
张胜宇
0ee3e894e7
merge: integrate latest qyqy_develop + push docs/41
2026-09-12 17:14:36 +08:00
张胜宇
ebc3fe4cbe
feat(§T): 账户看板 + 场内模拟交易 9 端点（用户自助首版）
...
新增 §T 用户自助段（docs/05 §19 新号段 7 个 = A×40/C×7/K×4/M×4/O×3/R×4/T×9）：
- T001 GET /api/v1/users/me/account/dashboard — 账户/资金/持仓/盈亏汇总
- T002 POST /api/v1/users/me/orders — 委托提交（首版 market 立即全额成交）
- T003 / T004 / T005 委托列表/详情/撤单
- T006 GET /api/v1/users/me/holdings — 持仓列表（含市值/盈亏/当日盈亏）
- T007 / T008 成交记录列表/详情
- T009 GET /api/v1/users/me/cash-ledger — 资金账本
要点（与 docs/00 §6.6 一致）：
- 首版市价委托立即全额成交，不实现撮合队列/部分成交；T005 撤单首版对任何在场委托返回 ORDER_NOT_CANCELLABLE (409)
- 价格来源复用 base FundQuoteService；service 层不二次封装（满足 AGENTS 第 2 条）
- 首版风控 3 条硬性：产品可交易、客户适当性、持仓比例上限（fin_market_price 缺失或过期 → 拒绝买入）
- 数据库零修改：10 张 fin_* 表全部 docs/00 既定，本批 PR 改列类型与可空性均 0；底座实际偏差（id 无 AUTO_INCREMENT、所谓'生成列'是普通 NOT NULL）由 service _next_id / 业务派生值补偿
注册 API：9 端点均注册进 app.main；user=9001(cust)'s id 写账
权限码（tools/seed_test_rbac.py 同步登记 + CUSTOMER 全量）：
9047 account:read:self
9048 trade:order:create
9049 trade:order:read
9050 trade:order:cancel
9051 holding:read:self
9052 trade:txn:read
错误码（app/core/errors.py + docs/05 §3.6 + tests/unit/core/test_errors.py DOCUMENTED 三方同步）：
404 ACCOUNT_NOT_FOUND / ORDER_NOT_FOUND
409 ORDER_NOT_CANCELLABLE
422 INSUFFICIENT_FUNDS / INSUFFICIENT_HOLDING / HOLDING_RATIO_EXCEEDED / SUITABILITY_MISMATCH / PRODUCT_NOT_TRADABLE
503 FUND_QUOTE_UNAVAILABLE（可重试）
新增：app/api/controllers/trading.py / app/api/schemas/trading.py / app/service/trade_service.py / tools/seed_sim_account_demo.py / tests/unit/service/test_trade_service.py(unit×8) / tests/contract/test_trading_endpoint_contract.py(contract×11)
修改：app/main.py(挂载 controller) / app/core/errors.py(10 新异常类) / tools/seed_test_rbac.py / docs/05-接口文档.md(§19 T001-T009 + §3.6 9 新码) / tests/unit/core/test_errors.py(DOCUMENTED 同步)
门禁：pytest tests/unit tests/contract 1313 passed (+19 新增) / ruff all clean / 三道守卫全过
2026-09-12 15:50:37 +08:00
张胜宇
c5adf01603
test: 补端点编号守卫与权限判定的 HTTP 层用例
...
补两道守卫，覆盖 2026-09-12 那次合并评审暴露出来的两个盲区。
一、`docs/05` §19 端点编号唯一性（新增 `tools/check_docs_endpoint_ids.py`）
- 背景：`tools/check_authoritative_docs.py` 只校验 `docs/` 的**文件名编号**，不校验
§19 的**端点编号**。两条线各自新增端点时都占了 `A034`/`A035`，合并后 §19 同时
存在两个 `A034` 与两个 `A035`，而文档守卫照样通过 —— 编号复用会静默遗留。
- 口径要点：**不枚举前缀白名单**，前缀从数据里归纳后连同数量一起输出。同一件事上
还踩过一次"扫描正则写成 `[AMKCS]`，漏掉 `O`/`R` 两段，把 62 个端点报成 55 个"——
漏掉的号段一旦被复用，脚本仍会报"重复 0"。所以覆盖报告会打印
`62 个端点编号 / 6 个号段（A×40、C×7、K×4、M×4、O×3、R×4）`，让漏扫本身可见。
- 只读、不依赖任何环境变量（纯解析文档），可在裸检出环境直接跑。
二、端点权限判定的 HTTP 层用例（新增 `tests/unit/api/test_permission_enforcement.py`）
- 背景：既有用例都通过 `build_request_context` 覆写注入**已经带好权限**的上下文，
只覆盖"有权限能通"，覆盖不到"缺权限必须被拒"。而"权限码在库里根本不存在"这类
环境数据问题（本次三个新权限码）恰恰只会在这一层暴露：权限判定发生在身份解析之后，
服务层测试自己构造 `RequestContext`，权限字段由测试塞入，所以全绿也照样漏。
- 覆盖客服二期三个权限码对应的 5 个端点：
`handover:read`（工单列表/详情）、`memory:candidate:review`（候选列表/审核）、
`memory:candidate:confirm`（用户确认）。
- 正反双向断言：缺权限 → 必须 403 且错误码为 `AGENT_PERMISSION_DENIED`；
带权限 → **不能**再是 403（这一条把端点要求的权限码钉住，改动即红）。
- 只替换两处边界：`build_request_context`（跳过 JWT 与身份库）与
`AuthorizationService` 的审计落库（内存替身）；真实路由、真实权限判定与真实 403 信封。
- 已做反向验证：给一个不存在的权限码时，5 个端点全部被拒（403），确认正向断言非空过。
验证（隔离 worktree，基线 `origin/qyqy_develop` = 4d8edb4）：
pytest tests/unit tests/contract -> 1294 passed, 2 skipped, 0 failed；
ruff check app tests tools alembic 全通过；mypy app 244 源文件 0 错；
check_authoritative_docs（50 份文档无撞号）与本脚本均通过。
2026-09-12 12:57:16 +08:00
张胜宇
f68b052a69
fix: 端点编号去重与 milvus-lite 降为可选依赖
...
按 qyqy 在 PR #7 评审中的要求处理两项：
- docs/05-接口文档.md §19：客服画像候选的两个端点由 A034/A035 改为 A039/A040。
原编号与 qyqy 侧登录 / RBAC 只读接口（A034-A038）重复；docs 守卫脚本只校验
文档文件名编号、不校验 §19 端点编号，因此该重复会静默遗留。改后全表 55 个
端点编号唯一。
- pyproject.toml / requirements.txt：milvus-lite 由主 dependencies 挪到
[project.optional-dependencies] dev；requirements.txt 只保留说明性注释，
不再作为生效依赖。理由：它仅用于本地开发（Docker Milvus 未运行时的本地
持久化向量库），进主依赖会让生产环境多背一个包。
验证：pytest tests/unit tests/contract -> 1275 passed, 2 skipped, 0 failed；
ruff check app tests tools alembic 通过；mypy app 通过（244 个源文件）。
2026-09-12 11:53:35 +08:00
张胜宇
9aaacc242f
chore: 清理违反底座规则的死代码并修正接口文档编号
...
- 删除生产死代码 app/service/knowledge_tool_service.py 与
app/infrastructure/milvus_knowledge_adapter.py：后者硬编码 Milvus 字段名，
违反 AGENTS.md §E，且仅被前者引用；生产检索链路实际走
knowledge_search_tool -> KnowledgeSearchService -> knowledge_schema 运行时探测。
- 删除上述两模块的单测，以及依赖 legacy 位置参数构造的
tests/unit/service/test_knowledge_retrieval.py。
- app/service/knowledge_retrieval_service.py 整文件回退底座版本，
移除 legacy 双构造与重复检索实现。
- docs/05-接口文档.md：客服画像候选改登记为 §8.5，恢复 §8.2 解析知识引用；
既有 §8.1-§8.4 编号全部保持，修复此前出现两个 8.3 的问题。
- app/model/profile.py：current_customer_id 改为普通可空列映射，与
alembic/baseline_generated.sql 及真实库一致；原 Computed 声明会让 ORM 把该列
从 INSERT 中排除，与「必须显式写入」的实际 schema 不符。
- 新增 docs/客服Agent接入底座扩展说明_v1.md，供集成分支评审逐项确认。
验证：pytest tests/unit tests/contract -> 1275 passed, 2 skipped, 0 failed；
ruff check app tests tools alembic 通过；mypy app 通过（244 个源文件）。
2026-09-12 11:15:24 +08:00
张胜宇
e85989b344
merge: integrate latest qyqy_develop (auth login + RBAC read) into ZSY branch
...
Incremental merge on top of ef701c8bbf623abbf623a
2026-09-12 10:37:53 +08:00
张胜宇
ef701c844c
merge: integrate ZSY customer service and profile capabilities
2026-09-11 22:31:51 +08:00
张胜宇
cbcf7c7444
feat: add milvus profile projection
2026-09-11 20:45:50 +08:00
张胜宇
50a611274a
feat: target memory sync event replay
2026-09-11 20:26:05 +08:00
张胜宇
5e848f5690
feat: wire neo4j projection into worker
2026-09-11 20:19:34 +08:00
张胜宇
6c605ec3c1
feat: add memory sync outbox worker
2026-09-11 20:07:55 +08:00
张胜宇
f167390a8a
feat: add neo4j profile projection adapter
2026-09-11 19:54:46 +08:00
张胜宇
5777f0f86e
feat: include memory sources in profile sync events
2026-09-11 19:37:18 +08:00
张胜宇
2de1735673
docs: define profile projection protocol
2026-09-11 19:24:57 +08:00
张胜宇
1eb04f28b1
test: fix mysql profile snapshot cleanup
2026-09-11 18:09:36 +08:00
张胜宇
27174b9ce2
feat: generate approved profile snapshots
2026-09-11 17:58:46 +08:00
张胜宇
a769130658
feat: add profile candidate review workflow
2026-09-11 17:47:06 +08:00
张胜宇
3a21afa847
feat: add customer profile candidate flow
2026-09-11 17:16:43 +08:00
张胜宇
ef098e6a4b
feat: complete customer service safety and handover flow
2026-09-11 16:11:30 +08:00
张胜宇
0059701509
fix: persist visitor handover tickets anonymously
2026-09-11 11:57:48 +08:00
张胜宇
9220b7b47c
feat: integrate customer service agent into ZSY develop
...
# Conflicts:
# app/core/config.py
# app/main.py
# app/service/agent/bootstrap.py
2026-09-11 10:46:56 +08:00
张胜宇
a229ec276e
docs: add phase one integration gate
2026-09-11 10:27:29 +08:00
张胜宇
c76b763101
feat: configure local customer service knowledge runtime
2026-09-11 10:13:48 +08:00
张胜宇
bc2f521c2e
feat: add guarded knowledge publication tool
2026-09-10 22:08:15 +08:00
张胜宇
24f75636a0
feat: add knowledge import preflight
2026-09-10 20:22:53 +08:00
张胜宇
e9b3d272f0
feat: add governed customer service agent
2026-09-10 19:51:08 +08:00
张胜宇
511a8ca18f
feat: add governed public knowledge retrieval
2026-09-10 18:42:44 +08:00
张胜宇
ba22a2220f
feat: preserve isolated visitor agent runtime
2026-09-10 17:36:39 +08:00
张胜宇
8e36a9941d
merge: preserve existing business features on new foundation
2026-09-10 17:26:52 +08:00
张胜宇
a789872c79
test: record pre-migration workspace evidence
2026-09-10 17:11:52 +08:00
张胜宇
d0793355fc
docs: add foundation migration implementation plan
2026-09-10 16:59:53 +08:00
张胜宇
5ebed374c4
docs: add safe foundation migration design
2026-09-10 16:36:36 +08:00
张胜宇
ad7172367a
feat: add limited visitor tokens
2026-09-10 13:56:08 +08:00
张胜宇
c6be99078e
chore: ignore local worktrees
2026-09-10 13:33:59 +08:00
张胜宇