From 34a65ef657c4f48bb9723175fed921a4cabc1805 Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Sun, 28 Jun 2026 10:08:46 +0800 Subject: [PATCH] =?UTF-8?q?docs(order/traveler):=20=E8=A1=A5=E5=85=A8?= =?UTF-8?q?=E5=87=BA=E8=A1=8C=E4=BF=A1=E6=81=AF=20=E8=BA=AB=E4=BB=BD?= =?UTF-8?q?=E8=AF=81=E5=8F=B7=E8=87=AA=E5=8A=A8=E5=9B=9E=E5=A1=AB=E6=80=A7?= =?UTF-8?q?=E5=88=AB/=E5=87=BA=E7=94=9F=E6=97=A5=E6=9C=9F(=E5=89=8D?= =?UTF-8?q?=E7=AB=AF=E5=AF=B9=E6=8E=A5,=20=E5=90=8E=E7=AB=AF=E6=97=A0?= =?UTF-8?q?=E6=94=B9=E5=8A=A8)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...证件号自动回填性别出生日期-前端对接-管理后台.md | 40 +++++++++++++++++++ 1 file changed, 40 insertions(+) create mode 100644 changelogs-v2/2026-06/35_出行人补全证件号自动回填性别出生日期-前端对接-管理后台.md diff --git a/changelogs-v2/2026-06/35_出行人补全证件号自动回填性别出生日期-前端对接-管理后台.md b/changelogs-v2/2026-06/35_出行人补全证件号自动回填性别出生日期-前端对接-管理后台.md new file mode 100644 index 0000000..12f625c --- /dev/null +++ b/changelogs-v2/2026-06/35_出行人补全证件号自动回填性别出生日期-前端对接-管理后台.md @@ -0,0 +1,40 @@ +# 出行人补全：身份证号自动回填「性别 / 出生日期」（前端对接） + +> 模块：订单 · 补全出行信息弹窗（管理后台） +> 类型：**前端对接说明（纯前端逻辑，后端无改动）** +> 日期：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、日 1~31、不晚于今天）；校验不过则不自动回填，可给轻提示「身份证号格式有误」。 +- 第 18 位可能是 `X/x`，按 18 位身份证规则正常处理（不影响性别取第 17 位、出生日期取第 7~14 位）。 +- 回填策略：识别到合法身份证号即覆盖回填这两项；用户手改后以用户值为准。 + +## 四、范围 + +- 涉及页面：订单详情 →「补全出行信息」弹窗的每个出行人卡片。 +- 后端：**无改动**。性别 / 出生日期 / 证件号字段及保存接口均不变，前端回填后按原样提交即可。