Codex
39 lines
1.8 KiB
Markdown
39 lines
1.8 KiB
Markdown
# M02-B 微信登录与用户体系
|
||
|
||
- 日期：2026-06-18
|
||
- 起始 commit：`0db9505`
|
||
- 工程 commit：`647ef7c`
|
||
- 推送校验：`HEAD == origin/main == 647ef7c83c402b114d89f1a03314c69a399a4282`
|
||
- ENGINEERING_DELTA=YES
|
||
- 子阶段状态：DONE
|
||
|
||
## 工程增量
|
||
|
||
- 新增租户用户、应用身份和可撤销会话迁移。
|
||
- 新增微信 `jscode2session` 客户端，AppSecret 仅从运行环境 JSON 映射读取。
|
||
- 新增 HS256 JWT 签发/验签，令牌含 tenant、user、session、platform app 与 role version。
|
||
- 新增微信登录、当前用户和注销接口。
|
||
- 所有鉴权均回查 MySQL 会话、用户状态和角色版本。
|
||
|
||
## 已执行验证
|
||
|
||
1. `npm test`（`backend/`）
|
||
- 退出码 0。
|
||
- JWT 签名/篡改/过期、登录、当前用户、注销后拒绝、微信错误映射全部 PASS。
|
||
2. WSL 原生临时副本运行 `bash scripts/dev/wsl/mysql-migration-roundtrip.sh`
|
||
- MySQL `8.4.9-0ubuntu0.26.04.1`。
|
||
- `up → verify → down → up → verify`，22 条 up、12 条 verify、21 条 down。
|
||
- OpenID 用户复用、会话撤销、角色版本即时失效全部 PASS。
|
||
3. `git diff --check`
|
||
- 退出码 0。
|
||
|
||
## 边界与影响
|
||
|
||
- 数据库：新增迁移 `2026061804`。
|
||
- API：新增 `/app-api/auth/wechat-login`、`/app-api/auth/me`、`/app-api/auth/logout`。
|
||
- 配置：新增 JWT TTL、会话 TTL、JWT Secret 与 AppID/AppSecret JSON 映射。
|
||
- 外部依赖：真实微信 code 联调尚需有效 AppSecret；工程适配器、错误处理和自动化测试已完成。
|
||
- 部署影响：生产必须在 `/etc/qipai/qipai.secrets` 配置随机 JWT Secret 和微信 AppSecret 映射。
|
||
- 小程序：未纳管工作区未跟踪模板，ISSUE-007 继续隔离。
|
||
- 下一阶段：M02-C RBAC、门店数据范围和资源归属。
|