Simon
c1d5dd584c
- 三端 Login.vue（坐席/管理/H5）新增「测试账号登录」面板：探测 /api/dev/health 决定可见性，公网 403 自动隐藏，免企微扫码登录（token 写入对应 localStorage 键） - 新增 REQ-通用-006 文档链五件套：PRD / 技术方案 / 任务说明书 / 测试用例 / 部署方案（product-doc-standard 规范） - 版本迭代总览追加 v5.1（预生产测试通道）行 - 部署辅助脚本：nginx /api/dev/ 内网闸门注入、H5 版本化 v20260808→v20260811 升级 部署已落地预生产（10.90.5.110）：公网 /api/dev/* 403、内网 200、三端登录页新 hash 在线。
71 lines
2.9 KiB
Markdown
71 lines
2.9 KiB
Markdown
# 任务说明书-REQ-通用-006-预生产测试通道
|
||
|
||
> **版本**: v1.0 | **日期**: 2026-08-11 | **状态**: [待评审]
|
||
> **作者**: 宋献 | **审核**: —
|
||
> **关联需求编号**: REQ-通用-006
|
||
> **关联PRD**: `../../01-产品文档/00-产品规划/PRD-REQ-通用-006-预生产测试通道-v1.0.md`
|
||
> **关联技术方案**: `../../02-技术文档/技术方案-REQ-通用-006-预生产测试通道-v1.0.md`
|
||
> **需求类型**: 新增
|
||
|
||
---
|
||
|
||
## 📥 输入项来源
|
||
|
||
| 输入 | 来源 |
|
||
|------|------|
|
||
| 产品需求 | `PRD-REQ-通用-006-预生产测试通道-v1.0.md` |
|
||
| 技术方案 | `技术方案-REQ-通用-006-预生产测试通道-v1.0.md` |
|
||
| 需了解的现有代码 | `src/backend/app/api/dev_auth.py`（已存在，零改动）<br>`src/backend/app/main.py`（DEV_MODE 挂载逻辑）<br>`src/frontend-agent/src/views/Login.vue` + `stores/agent.ts`（坐席）<br>`src/frontend-admin/src/views/Login.vue`（管理）<br>`src/frontend-h5/src/`（H5 登录与 token）<br>线上 `/opt/wecom-it-desk/docker-compose.yml` + `nginx/nginx.conf` |
|
||
|
||
---
|
||
|
||
## 📤 输出成果要求
|
||
|
||
| # | 产出 | 位置 | 说明 |
|
||
|---|------|------|------|
|
||
| O-1 | 预生产 compose 注入 `DEV_MODE=true` | 预生产 `/opt/wecom-it-desk/docker-compose.yml` | 仅预生产；新生产禁止 |
|
||
| O-2 | nginx `/api/dev/` 内网白名单闸门 | 预生产 `nginx/nginx.conf` | allow 内网三网段 + deny all |
|
||
| O-3 | 三端前端测试登录入口 | `src/frontend-agent|admin|h5` 登录页 | 探测 `/api/dev/health` 决定可见性 |
|
||
| O-4 | 三端 dist 构建产物 | `src/frontend-*/dist/` | 部署预生产 |
|
||
|
||
---
|
||
|
||
## 🔧 验证方式
|
||
|
||
| # | 验证 | 方法 |
|
||
|---|------|------|
|
||
| V-1 | 内网 mock 登录 | 内网 `curl GET /api/dev/login?userid=dev-agent-001&role=agent` → 200 + token |
|
||
| V-2 | 公网 403 | 公网 `curl GET /api/dev/health` → 403 |
|
||
| V-3 | 业务未误伤 | 公网 `curl GET /api/health` → 200 |
|
||
| V-4 | 前端入口 | 内网浏览器打开三端登录页 → 显示测试账号面板 → 一键登录进业务页 |
|
||
| V-5 | 主登录回归 | 企微扫码/OAuth 正常 |
|
||
| V-6 | token 有效 | Redis 可查 token，TTL 8h |
|
||
|
||
---
|
||
|
||
## ✅ 完成标准
|
||
|
||
- [ ] V-1 ~ V-6 全部通过
|
||
- [ ] 预生产 DEV_MODE 注入方式、nginx 闸门配置已落 DEPLOY 文档
|
||
- [ ] 新生产环境 compose 无 `DEV_MODE`（安全隔离确认项，写入上线 checklist）
|
||
- [ ] 变更记录已追加
|
||
|
||
---
|
||
|
||
## WBS 阶段
|
||
|
||
| 阶段 | 内容 | 优先级 | 状态 |
|
||
|------|------|--------|------|
|
||
| P0 | 预生产 compose 注入 DEV_MODE + 后端重启 | P0 | ☐ |
|
||
| P1 | nginx `/api/dev/` 闸门 + reload + 双向 curl 验证 | P1 | ☐ |
|
||
| P2 | 三端前端测试登录入口开发 + 构建 | P2 | ☐ |
|
||
| P3 | 预生产部署 dist + 全量验证（V-1~V-6） | P2 | ☐ |
|
||
|
||
---
|
||
|
||
## 变更记录
|
||
|
||
| 日期 | 版本 | 变更内容 | 变更人 | 变更原因 |
|
||
|------|------|----------|--------|----------|
|
||
| 2026-08-11 | v1.0 | 初版 | 宋献 | 预生产测试通道任务书 |
|