38 lines
2.3 KiB
Markdown
38 lines
2.3 KiB
Markdown
# 会会数字分身 · 真实短信验证码登录 — 落地说明（2026-07-21）
|
||
|
||
## 功能状态：✅ 已端到端上线（测试环境）
|
||
|
||
真实手机号 + 会会短信验证码登录现已完整可用，前端已部署、后端已对接会会开放平台（fat-open）。
|
||
|
||
## 访问地址
|
||
- 登录页：`http://192.168.1.188:8099/#/login/sms`（需与本机同网段或通过隧道访问）
|
||
- API 基址：前端经 nginx `/api` 代理至后端 `avatar-backend:8000`
|
||
|
||
## 使用流程（用户侧）
|
||
1. 浏览器打开登录页，输入**本人真实手机号**（11 位）。
|
||
2. 点「获取验证码」→ 触发会会开放平台真实短信下发。
|
||
3. 手机收到 6 位验证码，填入。
|
||
4. 点「登录 / 创建分身」→ 后端换会会 `access_token` + `userId`，自动建/链本地 `users` 表（按 `huihui_user_id` 唯一），签发本系统 `app_token` 作为会话并跳转到首页。
|
||
|
||
## 技术链路
|
||
- 前端 `SmsLogin.vue` → `sendSmsCode(phone)` / `loginBySms(phone, code)`
|
||
→ `POST /huihui/sms/send` `{phone}`、`POST /huihui/sms/login` `{phone, code}`
|
||
- 后端 `routers/huihui_auth.py`：
|
||
- 发码：`POST /open/mobile/sms/code`（query，公共字段签名，北京时间戳）
|
||
- 登录：`POST /open/login/token`（formData，`loginType=code`、`isRegister=true`）
|
||
- 签名范式与会会 `sign(1).js` 逐字节一致
|
||
- 关键修复：容器用 `timezone(timedelta(hours=8))` 生成时间戳，规避会会网关按北京时间校验导致的"签名验证失败"。
|
||
|
||
## 本次变更
|
||
1. `src/views/SmsLogin.vue`：移除「演示模式」误导性 banner 与 devCode 自动填入，纯真实模式；保留玻璃态 UI / 渐变 CTA / 倒计时等 Premium 视觉。
|
||
2. 本地 `vite build` → `rsync dist/` 至 geo-server → `docker cp` 进 `avatar-test-frontend` 容器并重启，完成部署（前端容器已 3 天旧构建，现已更新）。
|
||
|
||
## 部署后验证
|
||
- ✅ 新 `SmsLogin` chunk 已含「会会数字分身」文案（确认新前端生效）
|
||
- ✅ `GET /api/huihui/me` 经代理返回 `401 未登录`（路由存活、代理通）
|
||
- ✅ 后端 `:8011` 直连同结果
|
||
|
||
## 备注
|
||
- 真实短信由会会 fat-open 网关下发，需用户本人手机号完成最后一步登录。
|
||
- 如需我代为触发一次真实短信以验证会会集成，请提供接收验证码的手机号。
|