# 08 — 内置字典幂等初始化脚本

**What to build:** 部署时把首批内置字典（`builtin=true`）幂等导入：按 `(group_code, item_code)` upsert，只处理 builtin=true、绝不触碰 builtin=false；只加/改不删（Excel 消失的项不自动删）；导入前校验编码唯一、同组值不重、引用分组存在、每组至多一个启用默认项、字段格式合法；任何时候可重跑。内置字典可改名/描述/排序/启停，不可删除。

**Blocked by:** 04（与 05/06/07 并行）

**Status:** completed

- [x] 初始化器（CommandLineRunner）实现 upsert 语义；builtin=false 数据跳过且不报错
- [x] 导入前校验齐全，失败 fail-fast 并给出明确错误信息
- [x] 种子默认项仅在分组尚无默认时设置（不覆盖管理员已设默认）
- [x] 种子数据源留有 Excel 替换口（首批以代码内种子表为准，注释说明 Excel 到来后替换）