# 蓝湖数据字典原型 vs crm-dict：功能与接口参数对齐（wayfinder 建图）

## 调研结论（已核完）

**原型侧**（蓝湖《商机业务》bade4454，本地 `D:\code\crm-需求梳理\lanhu-mcp\data\axure_extract_bade4454_screenshots\` 已有 233 页提取产物，无需重新拉取）：
- 管理端两变体：`a7-4-1_数据字典`（平铺版）与 `a7-5-1_数据字典`（含**二级字典项**、"默认项禁止停用"、分组编码/字典键值必填等增量，疑为现行版）；另有新增/编辑/详情弹窗页与商机侧 `a3-4-6`/`a7-3-2-6`「商机相关字典」页
- 按用户澄清：**原型条目数据是示例，不做种子值对齐；只比对功能完整性与接口出入参覆盖度**

**代码侧**（`crm-dict`，ADR-0015 + `.scratch/data-dictionary/` 票 01-09 已完成）：
- 端点骨架齐全：group `page/saveOrUpdate/delete/status/enabled-list`；item `page/saveOrUpdate/delete/force-delete/status/set-default/enabled-list`
- DTO 已含 `parentId/children/isDefault/referenced/effectiveSelectable` 等，二级字典项模型已具备
- **已见缺口**：`GroupPageParam` 仅 `status`（原型要求分组名称/编码模糊查询）；`ItemPageParam` 仅 `groupId+status`（原型要求字典名称/编码模糊查询）；「商机相关字典」页无对应端点；`bruno-sync.config.json` menuBindings 无数据字典条目
- **口径冲突候选**：默认项停用规则（a7-4-1"停用即取消默认" vs a7-5-1"默认项禁止停用"）、必填性、权限模型（原型"仅超级管理员" vs 代码 `dict:*` 权限点，已有 ADR 拍板）、`opportunity_status` 字典 4 项 vs 代码 5 态枚举的建模差异

## 本会话执行步骤（wayfinder「建图」模式）

### 1. 存放 Cookie
把用户提供的 cookie 写入 `D:\code\crm-需求梳理\lanhu-mcp\.env` 的 `LANHU_COOKIE` 行（目录已 gitignore；本地提取仅在抽查发现过期时才需重新拉取，故 cookie 备用存放）。

### 2. 建图 `.scratch/dict-alignment/`（map.md + issues/）
- **Destination**：crm-dict 的功能与接口出入参与蓝湖数据字典原型一致——逐条差距有"改/不改（已合理偏离）"拍板，改造落地有测试，bruno 接口文档同步更新
- **Notes**：原型产物路径与 .txt 优先原则；cookie 位置；必读背景（ADR-0015、data-dictionary 票 09、crm-dict/CONTEXT.md）；"示例数据不入库"的用户澄清
- **Out of scope**：种子数据值对齐、前端实现、线索/客户域字典消费改动、商机规则子域其他页面
- **5 张票**：
  | # | 票名 | 类型 | 阻塞 |
  |---|---|---|---|
  | 01 | 原型功能与接口需求清单（规则全集+查询/列表字段+弹窗出入参；a7-4-1 vs a7-5-1 版本裁定） | research (AFK) | — |
  | 02 | crm-dict 代码功能与接口现状盘点（端点/参数/DTO/服务规则/商机消费点/现有 bruno 文档） | research (AFK) | — |
  | 03 | 差距矩阵逐条拍板（缺参数补齐、默认项停用规则二选一、二级项编辑规则、商机相关字典页归属、状态字典化否等） | grilling (HITL) | 01,02 |
  | 04 | 改造实施（按 03 拍板改代码+测试） | task (HITL) | 03 |
  | 05 | 接口文档同步（menuBindings/深 tag/bruno 文档再生成与校验） | task (HITL) | 04 |

### 3. 并发开两个 research 子代理（各自先认领票，产出资产 `assets/prototype-feature-inventory.md` / `assets/code-inventory.md`，完成后回写票 Answer + map 的 Decisions-so-far）

### 4. 汇报
图链接 + frontier（01/02 完成、03 待与用户 grill）+ 下一步指引。

本会话建图后即收（wayfinder 规矩：grilling 票 03 留待下个会话与用户逐条拍板，04/05 在拍板后执行）。