08 现场勘察子表

Type: grilling Status: resolved Blocked by: 03

一、定位

现场勘察（site survey）= 记录商机某次到客户现场勘察的结果单据（现场条件/客户需求/安装环境/工程师建议 + 附件）。住 crm-opportunity。原型 A3-1-1-1-4（列表Tab）+ A3-1-1-2-10 新增（弹窗）。

存档：research-a31114-site-survey.md。

一个商机可多条勘察记录（多次勘察分组展示、按顺序）；每条归属当前商机。
保留历史不覆盖：同一商机多次勘察 = 新增多条区分（无编辑覆盖旧记录的语义，编辑仅限有权限时改本条）。
无状态机：勘察记录没有草稿/提交/审批态——填完即一条完整记录（对比方案卡有状态机，勘察无）。
无阶段绑定：勘察不绑定阶段节点，是自由记录（回答票原问题：自由记录，不绑阶段）。
工程师从组织架构选：按姓名/部门/职位查询 → 选一名主要工程师（复用 crm-auth 组织架构 + SysUser，非自由文本）。每条勘察一名主要工程师。
附件属于具体某一次勘察记录（原型明证：「附件可关联到具体某一次现场勘察记录」）。

原型字段	必填	类型	落库字段	说明
申请方式	必填	下拉	`apply_way`	工单申请/线下申请等，选项来源系统配置（→ `crm-dict` 字典）
勘察次数	必填	下拉	`survey_seq`	手选四档枚举（第一次/第二次/第三次/三次以上）→ `crm-dict`「勘察次数」分组；列表页展示「次数」。非自增序号（“三次以上”是封顶档）
现场勘察日期	必填	日期	`survey_date`	现场勘察发生的日期（原型带 `*`=必填，用户图上确认标签为「现场勘察日期」；存档 line 924/1020 的“预计重启/看场日期”系 analyze 归纳噪声，以图为准）
申请单号	选填	文本	`apply_no`	外部申请单号，可空；列表页「申请单号」
主要工程师	必填*	人员单选	`engineer_user_id`	引用 `crm-auth` SysUser；列表展示姓名/所属部门/联系方式(脱敏)
勘察补充说明	选填	多行文本	`survey_desc`	现场环境/客户需求/安装条件/设备数量/特殊要求/工程师建议（原型无 `*`，照原型选填，不加码）
相关附件	选填	文件上传	→ 附件子表（见四）	现场照片/资料包/图纸/说明文件

「建议必填」= 原型措辞，落地按必填或软提示，⚠ 建模时定；engineer_user_id 是否绝对必填按「每条选一名主要工程师」定为必填。

表 opportunity_site_survey（crm-opportunity）

字段	说明
`id` / `opp_id`	主键 / 属哪个商机
`apply_way` / `survey_seq` / `survey_date` / `apply_no`	见上（`apply_way`/`survey_seq` 引用字典；`survey_date` 必填）
`engineer_user_id`	主要工程师（`crm-auth` SysUser）
`survey_desc`	勘察补充说明（长文本）
BaseEntity	含 create_by（谁录的）等

✅ 勘察次数 = 手选四档枚举（产品拍板 P1-2）：第一次/第二次/第三次/三次以上（原型 line 919-922），走 crm-dict「勘察次数」分组，非系统自增。
「联系方式」列表列 = 由 engineer_user_id 反查 SysUser 电话脱敏展示，不冗余存。

现场勘察附件不独立建表，复用票 09 定的商机附件子表（crm-file 契约），通过「业务类型 + 业务 id」定位到具体勘察记录。
即附件表带 biz_type（如 SITE_SURVEY）+ biz_id（= opportunity_site_survey.id），实现「附件关联到具体某一次勘察」。
与方案卡附件、商机通用附件同机制（票 07/09），避免每个子表各建一套附件表。
→ 传出票 09：附件子表 biz_type 枚举需含 SITE_SURVEY。

回填票 09：商机附件子表 biz_type 枚举加 SITE_SURVEY（+ 方案卡 SCHEME_CARD、跟进 FOLLOW_UP 等，票 09 统一定）。
回填 crm-dict：新增字典分组 申请方式（工单申请/线下申请…）、勘察次数（第一次/第二次/第三次/三次以上，P1-2 拍板）——列入字典清单。
CONTEXT.md：新增【现场勘察】术语（多条、无状态机、不绑阶段、工程师引用 SysUser、附件复用 crm-file）。