会员批量导入

适用角色：租户管理员（老板/店长）；被授予「会员导入」按钮权限的员工账号关联文档：会员登录与密码重置

从其他系统（博卡、有赞、Excel 老台账）迁过来的会员，逐个建档太慢。租户 PC 后台的会员列表支持 Excel 批量导入，一次最多 500 行。

1. 入口与权限

入口位置：租户 PC 后台 → 会员管理 → 会员列表 → 「导入」按钮（在「导出」左边）

列	必填	留空时的口径
手机号码	✅	无默认，留空该行报错。它同时是查重依据：同租户内已有会员用这个号码，就按「已存在」处理
会员姓名	✅	无默认，留空该行报错
性别	❌	填 `男 / 女 / 未知`，其他写法该行报错；留空时新增按系统默认（男），覆盖更新时保持原值不动
生日	❌	填 `2026-01-01`、`2026/1/1` 这类年月日（Excel 原生日期单元格也认）；留空不写；写 `1990-13-01` 这种不存在的日期该行报错
状态	❌	填 `正常 / 停用`；留空时新增按「正常」，覆盖更新时保持原状态（不会把已停用会员悄悄改回正常）
登录密码	❌	只在新增会员时生效：留空取默认密码 `123456`；填了必须符合 6-20 位、不含空格与 `< > " ' \| \` 的规则，否则该行报错。覆盖更新不会改密码，已有会员改密请用列表行的「重置密码」
备注	❌	留空时新增写空、覆盖更新时保持原备注

选中填好的 .xls / .xlsx 文件，弹窗左上可勾「是否更新已经存在的会员数据」：
- 不勾（默认）：手机号已存在 → 该行报错，不动原会员；
- 勾上：手机号已存在 → 按模板里的值覆盖该会员的姓名/性别/生日/状态/备注（密码不动）。
点「确定」上传，弹窗回显结果：共 N 行：新增 x 行、更新 y 行、失败 z 行，失败行逐条列出「第 X 行：原因」，行号就是 Excel 里的原表格行号，直接回到文件定位即可。列表页随之刷新。

单次最多 500 行，超了整份文件直接拒绝（不做「先写一半再报错」），请拆分文件分批导入。
每行都要单独做一次登录密码加密，500 行大约需要 45 秒，上传后请耐心等待弹窗结果，不要重复点「确定」。行数多时建议按 200 行左右拆批。
失败行不影响其他行：有任何失败行时，成功的那些行已经写进库了。修正失败行后，勾上「是否更新已经存在的会员数据」重传同一份文件即可——已成功的行会被同样的值覆盖，不会产生重复会员。
导入的会员归入操作人自己所在的门店（模板没有门店列）。会员册本身是全门店共享的：任何门店都能查到、核销这些会员，所以只有归属统计会记在操作人门店。需要归到别家门店，请在新增页面手工建档。
手机号、姓名入库是加密存储的，导入后列表里显示为 138****1111，与手工新增完全一致；按手机号筛选时要填完整号码。
状态填 停用 的新增/覆盖，会让该会员在所有手机/设备上的登录态立即失效（与后台手工停用同一口径）。
导入不会自动打标签、不会发会员卡券/余额。卡券与余额迁移是另一条能力，尚未上线，请联系平台运营。