email 为主登录标识

背景

username 与 email 双标识并存导致登录歧义与唯一约束冲突。

决策

登录标识按是否含 @ 分流（username 字符集与 email 互斥保证无歧义）；email 必填且注册/登录共用 normalizeEmail；username 可选但保留 UNIQUE（NULL 豁免）；登录链路验证最宽容（正则仅限注册/改密）；API 字段名沿用 username 保持兼容；OIDC name 回退 email。

后果与现状对照

V020 迁移在库；部署验证清单 等运维文档的登录口径以此为准。