chore(release): v0.5.0-beta 发版准备
主要改动: backend 业务: - feat(error-codes): 统一错误码表 E1011/E1012 拆码 - E1011 AUTH_PASSWORD_WRONG: 本地密码错误 - E1012 AUTH_FIRST_LOGIN_PASSWORD_REQUIRED: 首次登录请先设置密码 - E1015 AUTH_OLD_PASSWORD_REQUIRED: 改密需要旧密码 - E1016 AUTH_OLD_PASSWORD_WRONG: 旧密码错误 - fix(agents): P0 降级放行时,如坐席已注册但未设密码,正确 raise 1012 (修复前会撞 1011 本地密码错误,与场景不符) - feat(approval): 审批模块 (T审批/A审批) - feat(config): approval_template_resource / approval_template_device 配置 - feat(main): /ready, /metrics, /version 端点(K8s 友好) backend 测试: - test(agents): 新增 test_agents.py — 3 个 Fix-4 降级登录测试 - 错误密码拒绝 - 缺密码拒绝 - 正确密码通过 pytest tests/test_agents.py → 3/3 通过 - test(conftest): 模块级 mock + slowapi 限流重置 + UTF-8 patch 解决 Windows pytest GBK 读 .env 失败 + 降级路径无法测试 仓库治理: - chore(gitignore): 排除 .workbuddy/memory/(workbuddy 本地记忆) - chore(docs): 重命名两份 IT 文档(前缀加智能区分版本) 部署与文档: - docs: RELEASE_NOTES_v0.5.0-beta.md / dashboard.html / 需求-发版预览页面 - docs: 部署、架构、PRD、安全、评审报告等同步 v0.5.0-beta - deploy-server: 打包脚本、nginx、docker-compose 版本号 bump 前端 (frontend-h5 / frontend-agent / frontend-admin / frontend-portal): - index.html / package.json 版本号与构建号 bump 自动验收(RELEASE_NOTES L100-104): - [x] pytest tests/test_agents.py -v → 3 passed - [x] grep Bs7ucT backend frontend-h5 frontend-agent → 无输出 - [x] grep AppException(101[123]) backend → 仅 1 处(登录场景 1012) - [ ] npm run build (frontend-h5 / frontend-agent) → 合并后跑 后续: 合并 feature/t-1-t4-merge → main,tag v0.5.0-beta
This commit is contained in:
Simon
@@ -0,0 +1,186 @@
|
||||
# 智能IT支持服务台 - 版本更新说明
|
||||
|
||||
**版本**: v1.1.0
|
||||
**更新日期**: 2026-06-14
|
||||
**文档状态**: 待审核
|
||||
|
||||
---
|
||||
|
||||
## 一、本次更新内容
|
||||
|
||||
### 1.1 新增功能
|
||||
|
||||
| 功能 | 说明 | 优先级 |
|
||||
|------|------|--------|
|
||||
| 消息撤回 | 2分钟内可撤回自己的消息 | P0 |
|
||||
| 消息删除 | 删除自己的消息 | P0 |
|
||||
| 消息状态 | 支持 sending/sent/delivered/read/recalled 状态 | P0 |
|
||||
| 标记已读 | 一键标记会话已读 | P1 |
|
||||
| 图片上传 | 支持图片上传（≤10MB） | P1 |
|
||||
| 文件上传 | 支持文件上传（≤10MB） | P1 |
|
||||
|
||||
### 1.2 架构优化
|
||||
|
||||
| 优化项 | 说明 |
|
||||
|--------|------|
|
||||
| Health Check | 所有容器已配置健康检查 |
|
||||
| 自动重启 | 容器崩溃自动重启（restart: unless-stopped） |
|
||||
| AI Gateway 设计 | 预留多模型切换架构 |
|
||||
|
||||
### 1.3 安全增强
|
||||
|
||||
| 功能 | 说明 |
|
||||
|------|------|
|
||||
| OTP 双因素认证 | 访问管理后台时二次验证 |
|
||||
| 操作审计 | 关键操作日志记录（规划中） |
|
||||
|
||||
---
|
||||
|
||||
## 二、需要同步的代码
|
||||
|
||||
### 2.1 后端文件
|
||||
|
||||
| 文件 | 改动 | 说明 |
|
||||
|------|------|------|
|
||||
| `app/models/message.py` | 修改 | 添加 status、recallable_until 字段 |
|
||||
| `app/api/messages.py` | 修改 | 添加撤回/删除/标记已读/上传 API |
|
||||
| `app/api/ws_manager.py` | 修改 | 添加消息状态广播 |
|
||||
| `docker-compose.yml` | 修改 | healthcheck 已配置 |
|
||||
|
||||
### 2.2 数据库变更
|
||||
|
||||
```sql
|
||||
-- 需要执行的 SQL 迁移
|
||||
ALTER TABLE messages ADD COLUMN status VARCHAR(20) DEFAULT 'sent';
|
||||
ALTER TABLE messages ADD COLUMN recallable_until TIMESTAMP;
|
||||
```
|
||||
|
||||
### 2.3 前端文件（如果有）
|
||||
|
||||
| 文件 | 说明 |
|
||||
|------|------|
|
||||
| 消息操作菜单 | 撤回/删除按钮 |
|
||||
| 消息状态显示 | 状态图标 |
|
||||
| 已读标记 | 一键已读 |
|
||||
|
||||
---
|
||||
|
||||
## 三、部署步骤
|
||||
|
||||
### 3.1 本地打包
|
||||
|
||||
```bash
|
||||
# 后端打包
|
||||
cd backend
|
||||
docker build -t wecom-it-desk-backend:latest .
|
||||
|
||||
# 导出镜像
|
||||
docker save wecom-it-desk-backend:latest -o wecom-it-desk-backend.tar
|
||||
```
|
||||
|
||||
### 3.2 服务器部署
|
||||
|
||||
```bash
|
||||
# 1. 上传镜像到堡垒机
|
||||
# 堡垒机: sxn@10.212.189.210:2222 (OTP)
|
||||
# 目标路径: /tmp/
|
||||
|
||||
# 2. SSH 到正式服务器
|
||||
ssh sxn@10.212.189.210 -p 2222
|
||||
ssh 10.90.5.110
|
||||
|
||||
# 3. 导入镜像
|
||||
docker load -i /tmp/wecom-it-desk-backend.tar
|
||||
|
||||
# 4. 解决容器冲突（重要！）
|
||||
docker rm -f wecom_it_redis wecom_it_backend wecom_it_postgres wecom_it_nginx 2>/dev/null
|
||||
|
||||
# 5. 重新启动
|
||||
docker compose -p root up -d
|
||||
|
||||
# 6. 执行数据库迁移
|
||||
docker compose exec backend python -c "from app.database import engine; engine.execute('ALTER TABLE messages ADD COLUMN status VARCHAR(20) DEFAULT 'sent'')"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 四、验证清单
|
||||
|
||||
### 4.1 健康检查
|
||||
|
||||
| 检查项 | 命令 | 预期结果 |
|
||||
|--------|------|----------|
|
||||
| 后端服务 | `curl -s http://localhost:8000/health` | `{"status": "ok"}` |
|
||||
| Nginx | `curl -s http://localhost:80/itdesk/health` | `{"status": "ok"}` |
|
||||
| 数据库 | `docker compose exec backend python -c "from app.database import engine; print('OK')"` | OK |
|
||||
| Redis | `docker compose exec redis redis-cli ping` | PONG |
|
||||
|
||||
### 4.2 API 测试
|
||||
|
||||
| API | 方法 | 测试命令 |
|
||||
|-----|------|----------|
|
||||
| 撤回消息 | POST | `curl -X POST http://localhost:8000/api/messages/{id}/recall` |
|
||||
| 删除消息 | DELETE | `curl -X DELETE http://localhost:8000/api/messages/{id}` |
|
||||
| 标记已读 | POST | `curl -X POST http://localhost:8000/api/conversations/{id}/mark-read` |
|
||||
| 图片上传 | POST | `curl -X POST -F "file=@test.jpg" http://localhost:8000/api/messages/image` |
|
||||
|
||||
### 4.3 功能测试
|
||||
|
||||
| 功能 | 测试场景 | 预期结果 |
|
||||
|------|----------|----------|
|
||||
| 消息发送 | 发送文本消息 | 消息正常显示 |
|
||||
| 消息撤回 | 2分钟内撤回 | 状态变为 recalled |
|
||||
| 消息撤回 | 超过2分钟 | 返回 403 错误 |
|
||||
| 标记已读 | 点击已读 | 所有消息标记为已读 |
|
||||
|
||||
---
|
||||
|
||||
## 五、已知问题与限制
|
||||
|
||||
### 5.1 待解决
|
||||
|
||||
| 问题 | 状态 | 说明 |
|
||||
|------|------|------|
|
||||
| 容器冲突 | 进行中 | 需指定项目名 `-p root` |
|
||||
| 前端同步 | 待确认 | 可能需要更新前端代码 |
|
||||
|
||||
### 5.2 已知限制
|
||||
|
||||
| 限制 | 说明 |
|
||||
|------|------|
|
||||
| 单节点部署 | MVP 阶段保持单节点 |
|
||||
| 文件大小 | 单文件 ≤10MB |
|
||||
| 撤回时间 | 2分钟后不可撤回 |
|
||||
|
||||
---
|
||||
|
||||
## 六、回滚方案
|
||||
|
||||
如果部署失败，执行：
|
||||
|
||||
```bash
|
||||
# 停止服务
|
||||
docker compose -p root down
|
||||
|
||||
# 恢复旧镜像（如果有备份）
|
||||
docker load -i wecom-it-desk-backend-old.tar
|
||||
|
||||
# 使用备份的配置启动
|
||||
docker compose -p root up -d
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 七、联系人
|
||||
|
||||
| 角色 | 联系人 | 说明 |
|
||||
|------|--------|------|
|
||||
| 产品负责人 | 许清楚 | PRD 确认 |
|
||||
| 技术负责人 | 寇豆码 | 代码审查 |
|
||||
| QA 负责人 | 严过关 | 测试验证 |
|
||||
| 运维负责人 | 宋献 | 部署执行 |
|
||||
|
||||
---
|
||||
|
||||
**文档版本**: 1.0
|
||||
**审核状态**: 待审核
|
||||
Reference in New Issue
Block a user