crm-backend-matt/.scratch/customer-contact-graph/issues/01-spec-freeze.md

01 · spec 冻结：图谱数据模型与契约设计

• Type: grilling
• Status: open
• Blocked by: 00（原型 demo 验收通过后继续；以 demo 为活参照——demo 里 mock 实现的规则 = 逐组定稿的素材与对照物）

Question

对照原型需求权威（.scratch/opportunity-bugfix/lanhu-pages/A4-4-2_客户详情（联系人）.md u533 列表侧 + u536 图谱 15 条），HITL grilling 逐组定稿并产出 spec.md：

1. 边模型：多父 DAG（原型允许一联系人多上级）；边表字段（customer_id / parent_contact_id / child_contact_id / source=auto|manual）；系统边删除的持久否决（原型第 9 条：删除系统生成的连线并保存后不再自动恢复——tombstone 还是边行 status）；自连/循环/重复的拒绝口径与错误码。
2. 自动生成算法：job_title_level → 层级位置（越高越靠上、同级并列、多顶层并列、公司节点固定居中）；自定义职务/层级为空 → 「未识别层级」区不生成连线；职务修改后的增量语义（全量重建 vs 差异）。
3. 布局持久化：拖拽位置是否随「保存」落库（原型第 12 条「保存本次新增、删除和调整的关系」）；归属 per customer 全局共享（推荐）还是 per user。
4. 并发冲突（原型第 14 条）：关系被他人修改的检测方案（版本号 / updated_at）与冲突响应形态。
5. job_title 字典设计：原型职务集（董事长/股东/采购经理/市场经理/采购专员/市场专员/人事经理/投标商务·其他）→ 标准职务 code/name/category/level 枚举 + 职务二级联动选择器（类别→职务）的字典查询契约；层级分档规则由产品定（grill 向用户要分档表）。
6. contact_source 字典值（原型出现：转介绍/组会/组局；W-01 销号口径）。
7. 新端点契约清单：图谱读 / 边 add / 边 delete / 布局 save / 关系变更日志 / 明文查看 reveal + 查看日志 / 批量导出 / 页内编辑批量保存 / 快速添加多行 / 导入三段式 —— 逐端点 method+路径+入参+出参+错误码（错误码段沿用 67xxx 还是新段？）；过 ADR-0017 flat 纪律。
8. 埋点表：明文查看日志（操作人/时间/联系人/是否命中号码），是否进 oplog 或独立表。
9. 联系人导入：表复用深度（复用 customer_import_* 形态 vs 独立 contact_import_*）、Analyzer 预检校验清单（迁移 D-05/D-04 教训：NOT NULL 无默认列群必填前移 + clip500）、导入触发图谱自动更新的落点。
10. 图谱规模上限记录（单客户数百联系人时的布局与读端点预案）。

交付：.scratch/customer-contact-graph/spec.md（D 决策 + 新表 DDL 草案 + 端点契约表 + 字典值定稿）——02~07 的唯一输入。