|
@@ -28,7 +28,7 @@ C 端 app 现仅支持「手机号 + 短信验证码」登录（`/infouser/user/
|
|
|
- **FR-002**: 凭证校验三选一：Apple=验 ES256 identityToken 取 sub；Google=tokeninfo HTTP 验真取 sub 并校 audience；LINE=前端传授权 code，后端用 code+clientSecret+clientId 向 `oauth2/v2.1/token` 换 access_token，再调 v2/profile 取 userId（Authorization Code 流程，不直接收前端 accessToken）。
|
|
- **FR-002**: 凭证校验三选一：Apple=验 ES256 identityToken 取 sub；Google=tokeninfo HTTP 验真取 sub 并校 audience；LINE=前端传授权 code，后端用 code+clientSecret+clientId 向 `oauth2/v2.1/token` 换 access_token，再调 v2/profile 取 userId（Authorization Code 流程，不直接收前端 accessToken）。
|
|
|
- **FR-003**: 按 (provider, providerUid) 查 `info_user_oauth`：命中→校验用户 status/del_flag 正常后直接签发 token（claim `provider`）返回；未命中→缓存 {provider,providerUid} 到 Redis(短TTL)，返回 `needPhone` + tempKey。
|
|
- **FR-003**: 按 (provider, providerUid) 查 `info_user_oauth`：命中→校验用户 status/del_flag 正常后直接签发 token（claim `provider`）返回；未命中→缓存 {provider,providerUid} 到 Redis(短TTL)，返回 `needPhone` + tempKey。
|
|
|
- **FR-004**: 提供 `POST /infouser/user/oauthBindPhone {tempKey, phone, code, ...}`：取回缓存的 providerUid + 验短信码（复用 lodeing 逻辑，含万能码 8888）→ `getuser(phone)`：已注册→关联；未注册→`createUser` 新建；随后 insert `info_user_oauth(user_id, provider, provider_uid)`。
|
|
- **FR-004**: 提供 `POST /infouser/user/oauthBindPhone {tempKey, phone, code, ...}`：取回缓存的 providerUid + 验短信码（复用 lodeing 逻辑，含万能码 8888）→ `getuser(phone)`：已注册→关联；未注册→`createUser` 新建；随后 insert `info_user_oauth(user_id, provider, provider_uid)`。
|
|
|
-- **FR-005**: 新建用户昵称统一用手机号（与现有 createUser 一致），avatar 留空，不用 provider 的昵称/头像。
|
|
|
|
|
|
|
+- **FR-005**: 新建用户的 `info_user.nick_name` 统一用手机号（与现有 createUser 一致），avatar 留空；三方资料不得覆盖用户主昵称/头像。第三方名称的独立展示见下方 2026-09-24 后续增量。
|
|
|
- **FR-006**: token claim 增加 `provider` 字段（apple/google/line；手机号登录为 phone），供登录渠道统计或「未绑手机限制」类约束使用。
|
|
- **FR-006**: token claim 增加 `provider` 字段（apple/google/line；手机号登录为 phone），供登录渠道统计或「未绑手机限制」类约束使用。
|
|
|
- **FR-007**: 登录端点 `@Anonymous` 放行；受保护接口继续走 `@Auth`，零额外接入。
|
|
- **FR-007**: 登录端点 `@Anonymous` 放行；受保护接口继续走 `@Auth`，零额外接入。
|
|
|
- **FR-008**: 凭证校验失败 / tempKey 过期 / 短信码错误 → 明确错误提示，不签发 token、不建账号。
|
|
- **FR-008**: 凭证校验失败 / tempKey 过期 / 短信码错误 → 明确错误提示，不签发 token、不建账号。
|
|
@@ -50,3 +50,12 @@ C 端 app 现仅支持「手机号 + 短信验证码」登录（`/infouser/user/
|
|
|
- 后台管理端解绑/查看三方绑定（后续增量）。
|
|
- 后台管理端解绑/查看三方绑定（后续增量）。
|
|
|
- 第三家以上三方（微信/Facebook）——表结构已可扩展，但本期只接 Apple/Google/LINE。
|
|
- 第三家以上三方（微信/Facebook）——表结构已可扩展，但本期只接 Apple/Google/LINE。
|
|
|
- Apple 隐藏邮箱中转、refresh_token 续期等高级场景。
|
|
- Apple 隐藏邮箱中转、refresh_token 续期等高级场景。
|
|
|
|
|
+
|
|
|
|
|
+## 2026-09-24 后续增量：登录渠道与第三方名称展示（待实施）
|
|
|
|
|
+
|
|
|
|
|
+- 用户端分别展示原有 `info_user.nick_name`、本次登录渠道（Apple / LINE）及该渠道的第三方名称。用户修改昵称仍走原有资料修改流程；切换登录渠道不得覆盖 `info_user.nick_name`，也不得把不同 `user_id` 的三方身份视为同一账号。
|
|
|
|
|
+- `info_user_oauth.user_id` 只表示账号绑定关系，不表示“最近一次登录”。当前 `provider` 记录在本次登录的 JWT 会话中，`info_user` 不保存最近登录渠道；本增量展示的是本次会话的登录方式，不是跨设备共享的历史“最后一次登录方式”。
|
|
|
|
|
+- 第三方名称按绑定身份独立保存于 `info_user_oauth.provider_display_name`（新增可空字段）；本次登录为 LINE 时显示 LINE 名称，为 Apple 时显示 Apple 名称，不使用其他渠道的名称。当前表尚无此字段，待实施后才可用。
|
|
|
|
|
+- LINE：每次成功登录且取得带 `profile` 权限的资料时，读取 `displayName` 并刷新对应绑定记录；获取失败时保留已保存的名称，不影响登录。
|
|
|
|
|
+- Apple：首次授权取得用户共享的 `fullName` 时保存到对应绑定记录；后续登录不要求再次取得名称。历史账号未保存过 Apple 名称或用户未共享名称时，该名称允许为空，用户端仅展示“Apple 登录”及原有昵称，不伪造 Apple 名称。
|
|
|
|
|
+- 本增量仅记录需求，尚未修改 App、后端、数据库或现有账号数据；实施时须同步更新接口契约、数据模型、SQL 和验证用例。
|
qmj