2.4 KiB
2.4 KiB
出行人补全：身份证号自动回填「性别 / 出生日期」（前端对接）
模块：订单 · 补全出行信息弹窗（管理后台） 类型：前端对接说明（纯前端逻辑，后端无改动） 日期：2026-06-28 背景：「补全出行信息」弹窗里，出行人填了身份证号后，性别、出生日期目前还要手动再填一遍。这两项本就编码在身份证号里，前端可在输入证件号后自动解析回填，减少手填和填错。证件号本身已正常入库，后端无需改动。
一、触发条件
- 仅当「证件类型 = 身份证」 时启用自动回填；其它证件类型（护照 / 港澳台通行证等）无法从证件号推导，保持手填。
- 在「证件号」输入变化 / 失焦时，证件号长度为 18 位（现行）或 15 位（旧版）且校验通过，则解析并回填「性别」「出生日期」。
- 回填后两个字段仍允许手动修改（极个别证件号与实际不符时可人工覆盖）。
二、解析规则
18 位身份证（现行标准，绝大多数）
- 出生日期 = 第 7~14 位（
YYYYMMDD）→ 格式化为YYYY-MM-DD - 性别 = 第 17 位：奇数 = 男，偶数 = 女
示例：150782199502081450
- 第 7~14 位 =
19950208→ 出生日期1995-02-08 - 第 17 位 =
5（奇数）→ 性别男
15 位身份证（旧版，少量历史证件）
- 出生日期 = 第 7~12 位（
YYMMDD），年份前补19→19YY-MM-DD - 性别 = 第 15 位（末位）：奇数 = 男，偶数 = 女
三、建议的健壮性处理（前端自行把控）
- 长度不足 / 非 18·15 位 / 非身份证类型：不回填，不报错（用户继续手填）。
- 建议顺带校验 18 位的**校验码（第 18 位）**与出生日期合法性（月 1
12、日 131、不晚于今天）；校验不过则不自动回填，可给轻提示「身份证号格式有误」。 - 第 18 位可能是
X/x，按 18 位身份证规则正常处理（不影响性别取第 17 位、出生日期取第 7~14 位）。 - 回填策略：识别到合法身份证号即覆盖回填这两项；用户手改后以用户值为准。
四、范围
- 涉及页面：订单详情 →「补全出行信息」弹窗的每个出行人卡片。
- 后端：无改动。性别 / 出生日期 / 证件号字段及保存接口均不变，前端回填后按原样提交即可。