simon/wecom_it_smart_desk
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
c1d5dd584c944747e856b2ceff4f1bb7e29a5165
wecom_it_smart_desk/docs/07-项目管理/任务说明书/任务说明书-REQ-通用-006-预生产测试通道.md
T
Simon c1d5dd584c [REQ-通用-006] 预生产测试通道：三端测试登录入口 + 文档链 + 部署脚本 
- 三端 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 在线。
2026-08-11 11:29:20 +08:00

2.9 KiB
Raw Blame History

任务说明书-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（已存在，零改动）
src/backend/app/main.py（DEV_MODE 挂载逻辑）
src/frontend-agent/src/views/Login.vue + stores/agent.ts（坐席）
src/frontend-admin/src/views/Login.vue（管理）
src/frontend-h5/src/（H5 登录与 token）
线上 /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
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 初版 宋献 预生产测试通道任务书
Reference in New Issue View Git Blame Copy Permalink