族人数据模板填写说明

谱名：族谱上正式登记的名字，通常按"字辈"排出来的正式名，区别于日常叫的实名/小名。进了谱就得用谱名。实操：在世族人谱名栏可直接填常用名；若家族有谱名传统，则填谱上那个名（如长辈按派语起的"张永福"）。

字号（字）：古代男子成年（20 岁冠礼）后取的"表字"，用于社交互称，同辈不能直呼其名。如诸葛亮，名亮、字孔明。女子传统上不取字，女丁字号多留空；"号"是后来自取的别号，可并入字号栏。示例：字德明、号南山。

字辈（辈分字 / 派语）：家族每一代共用一个字，写在名字固定位置（多在中间）以区分辈分。如"永、志、承、先、德"五代轮着用。填法：只填那个辈分字本身（如"承"），别填全名；留空也行（非必填），但填上谱系更清晰。

朝向（墓向）：坟墓 / 先茔的坐向，风水用语，和"葬地"配合记录。标准填法两种：
① 通俗八向（推荐大多数家庭）：坐北朝南、坐东朝西、坐南朝北、坐西朝东，及四斜角如 坐东北朝西南；
② 专业二十四山向（懂风水者用，每 15° 一档）：格式"X 山 Y 向"，如 子山午向（正坐北朝南）、壬山丙向、艮山坤向。
⚠ 建议整本谱统一一种写法，别混用。

1. 第一行表头不要改、不要删。系统靠表头识别每一列；习惯用别的叫法也支持（见第六节"表头别名"），但建议直接用模板列名最省事。
2. 【谱名】和【实名】至少填一个，否则这一行会被跳过。
3. 【世代】必填，且必须填阿拉伯数字（1、2、3……）。始祖（第一代）填 1。填"一世""第一代"会被当成无效数字报错。
4. 【性别】留空默认按"男"。女性务必填 女（或 2 / f / female），否则错归为男。
5. 一行只填一位族人。配偶、子女都另起一行，不要塞同一格。

在父亲列填这位族人父亲的谱名或实名，系统会把两人连成父子，自动生成世系树和"某人之子"等关系；母亲同理填在母亲列。

• 匹配规则：按名字查找，系统已有 + 本次新加的族人都能匹配。所以父亲可以排在儿子后面几行，也能正确连上。
• 同名冲突：族里若有重名，可能连错。尽量用"谱名+实名"区分，或先在系统手动建好再导入。
• 父亲/母亲名字在表里找不到对应族人时，这一行照常录入，但父子/母子关系会连不上（导入结果会提示），需后续手动补。

后台只认系统里已经存在的房支名称。若还没建好"长房/二房"，直接填会提示"房支不存在"并置空。两种做法：

• 先到系统「房支管理」建好房支，再导入时填对应名称；
• 或这一列先留空，导入后到系统里再分配。

"生/卒"列后台按文本保存，格式不限。但为排版整齐，建议全表统一用：

• 只知年份：1900
• 知到月：1900-05
• 知到日：1900-05-12

民国年份建议换算成公元年，或直接写明"民国十二年"等也可。

若更习惯别的列名，系统也能识别以下叫法（大小写、空格不限）：

上传后系统会返回"成功导入 N 条"，若有跳过或关系未建立会列出明细。建议导入后到「族人名录」核对：

1. 世系树是否正确（父亲/母亲关系连上没有）；
2. 女性族人性别是否归对；
3. 房支是否识别；
4. 有问题的行按提示手动补全即可。