花名册导入字段

可接受的表头

导入器接受中文和英文表头变体，它们映射到：

• id
• 姓名（canonicalName）
• 拼音（pinyin）
• 分组（group）
• 启用（active）
• 删除（delete）

字段规则

字段	必需	可接受的值	说明
id	可选	正整数	更新和删除时必需。
姓名	通常是	任何非空字符串	标准化后必须唯一。
拼音	可选	文本	当姓名变更且拼音为空时自动生成。
分组	可选	文本	按分组标准化逻辑规范化。
启用	可选	true/false、yes/no、y/n、1/0、是/否、启用/停用	无效布尔值文本会导致拒绝。
删除	可选	true/false、yes/no、y/n、1/0、是/否	删除行必须包含 id。

操作结果

• add（新增）：创建新花名册行。
• update（更新）：按 id 更新现有花名册行。
• delete（删除）：按 id 删除花名册行。
• reject（拒绝）：因校验错误跳过行。

重要行为

• 一次导入中重复的显式 ID 会被拒绝。
• 删除花名册行可能级联删除关联的昵称匹配行。
• 导入返回新增/更新/删除/拒绝的汇总计数。