Work for YILI

Appearance

邮件标题：20260903-技术评审-营销活动中心-Job表新增sub_type字段

邮件正文：

晓娜、建新： 已完成针对【Job 表新增 sub_type 字段技术方案】的技术评审，现将评审结论、风险判断及后续执行安排同步如下，便于各方对齐认知并落实执行。

项目名称： 营销活动中心 评审时间： 2026/09/03 参与评审人： 王建朝、贾继伟、马奇、郝梓斐（方案汇报） 评审结果： 通过

一、技术方案背景 ​

  • 业务场景：液奶事业部积分商城「新增盘点编辑任务」中，任务配置页需以树状结构展示可选职务。现有 job 表仅以 type 字段区分内部人员（INTERIOR）与外部人员（EXTERNAL），无法支撑外部人员按经销商人员、门店人员、导购人员细分展示，故新增 sub_type 职务子类型字段。该字段仅用于页面树形列表分层展示（第一层按 type、第二层按 sub_type、第三层挂具体职务），不参与任务执行的任何编码与逻辑判断。
  • 需求目标：数据来源为主数据推送 + 固定数据（非人工录入维护）；需补充字段使用场景说明、历史数据初始化方案及 job 表数据资产维护，明确「仅供展示」的边界。

二、技术方案要点 ​

  • 整体流程：job 表新增 sub_type（VARCHAR(20)，位于 type 之后）→ 历史数据初始化（内部人员按 type=1 置 '1'；经销商人员按 ext_person 表 job_code 关联回填 '2'；门店人员按固定 code 列表回填 '3'）→ 查询有效职务（status=ENABLE、statusCode=VALID）→ 按 type → sub_type 分组构建三级职务树 → 页面仅展示。
  • 存储与调用：数据由逻辑写入——内部人员职务由主数据推送人员信息后按人取职务，job 表不存在则该职务新增、已存在不重复新增；经销商人员、门店人员分别经 ext_person 推送及固定数据维护。
  • 服务边界：sub_type 为纯展示字段，不参与盘点任务执行的逻辑判断。

三、决议事项 ​

  • 补充字段用途说明：在方案中说明 sub_type 仅用于盘点编辑任务配置页职务树的三级分层展示、不参与任务执行逻辑判断（补使用场景描述，不贴构建树等代码），由郝梓斐负责补充。
  • 补充历史数据初始化方案：技术方案需纳入初始化逻辑/脚本说明——内部人员置 '1'、经销商人员从 ext_person 按 job_code 检索职务后回填 '2'、门店人员按固定 code 列表写死回填 '3'，由郝梓斐负责，补充后请评审老师快速复审。
  • 维护 job 表数据资产：同步维护 job 表数据资产（数据字典）文档，数据来源口径按「主数据推送 + 固定数据」记录，由郝梓斐负责，参考文档由贾继伟提供对齐。
  • 评审材料口径：以使用场景/流程描述为准，构建树等实现细节属代码 review 范畴，不纳入方案文档。

四、方案地址 ​