simon/wecom_it_smart_desk
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
0042519f6628c187ae232695d24a9c6adc022741
wecom_it_smart_desk/docs/07-项目管理/计划/线性执行计划-20260711.md
T
Simon facc04aa65 chore: docs 结构整改 + compose 双目录对齐（合并重建提交） 
本提交为 .git 对象库损坏后的重建提交，内容等价于原先三个本地提交
（5e2fd4c2 / 57a53c98 / 5d7e1873）的累积结果，未做任何额外改动。

一、docs 结构整改（整改 #14）
根因：重构时新结构为 untracked 文件，执行 git stash（未带 -u）未纳入，
随后 git reset 拉回 HEAD 旧 tracked 树，导致旧树复活、新旧两棵目录
树并存于 docs/，共 791 文件、双分类体系冲突。

修复动作：
- b2 同名异主题文件改名迁移保全 9 个
- C 类 39 个孤立文件按主题正确归类
- A/B1 类 222 个重复文件删除（新结构已有内容副本）
- 9 个旧独有空目录删除
- 270 处内部引用按 verified 映射改写
- 整改记录 #14 登记于 04-运维文档/部署运维

结果：docs 791 → 569 文件，顶层仅规范 8 类 + 治理文件，单树恢复。
残留：约 20 处指向从未存在文件的陈旧死链，归入独立文档卫生任务。

二、compose 双目录对齐（消除踩坑 A）
- docker-compose.yml：nginx 前端挂载全部由根目录 frontend-*/dist
  改为 src/frontend-*/dist（h5 / agent / admin / terminal）
- docker-compose.dev.yml：dev 服务 build context 与卷同步改 src/
- 效果：本地 docker compose up 不再把根目录 stale dist 挂回，
  与线上一致，分叉隐患消除（已 docker compose config 校验通过）

防复发铁律：
- 重构须提交；仓库修复须 git stash -u 或先 commit
- 新结构须 git add 并提交，避免再次 untracked 复活
- H5 改动只动 src/frontend-h5/，禁改根目录遗留 frontend-*/
2026-08-07 22:31:32 +08:00

158 lines
6.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# IT智能服务台 - 线性执行计划
> **制定日期**: 2026-07-11 23:20
> **版本快照**: `v2026.07.11-evening` (git tag已推送)
> **今晚自动执行**: Phase 1-3 (确认后启动)
---
## 执行原则
1. **线性无冲突**: 每步按序执行，前一步完成才进入下一步
2. **低风险优先**: 后端小修复 → 全栈部署 → 文档生成 → 前端开发
3. **可回滚**: 每步均有回滚方案，git tag `v2026.07.11-evening` 为回滚锚点
---
## Phase 1: 后端快速修复 (今晚自动, ~15min) ✅ 已完成
### 1.1 IT资产升级审批推送 部署+测试 ✅
- **文件**: `backend/app/services/asset_service.py` / `backend/app/api/approval.py` / `backend/app/config.py`
- **操作**: 上传3个.py → `docker compose restart backend` → 运行 `test_asset_approval_urge.py`
- **验证**: curl 测试 urge 端点返回200
- **回滚**: `git checkout v2026.07.11-evening -- backend/app/services/asset_service.py`
### 1.2 itsm_service.py httpx.Timeout 修复 ✅
- **文件**: `backend/app/services/itsm_service.py:33`
- **变更**: 代码已有正确写法 `httpx.Timeout(timeout=30.0, connect=10.0, read=30.0)`，无需变更
- **操作**: 确认代码正确
### 1.3 企微审批查询范围 7天→30天 ✅
- **文件**: `backend/app/services/todo_source_service.py`
- **变更**: `APPROVAL_QUERY_DAYS = 30` 已部署
- **操作**: 上传1个.py → `docker compose restart backend`
- **验证**: API返回更多历史审批单
---
## Phase 2: 会议室预定系统部署 (今晚自动, ~45min) ✅ 已完成
### 2.1 数据库迁移 ✅
- **操作**: `create_meetingroom_tables.py` 直接 SQL 建表（alembic 不可用）
- **新表**: `meetingroom_booking_snapshot` / `terminal_room_binding`
- **验证**: 查询新表存在
### 2.2 后端环境变量+重启 ✅
- **操作**: 企微会议室 Secret 待用户申请（暂不配置）
- **验证**: `curl /itportal/meetingroom/list` 返回企微API响应（forbidden，因Secret未配置）
### 2.3 终端前端部署 ✅
- **操作**: Vite base 修正 `/terminal/` → `/itterminal/` → `npm run build` → pack-upload → docker volume → nginx
- **Nginx**:
- 添加 `location /itterminal/` 静态文件服务
- 添加 `location /itportal/meetingroom/` API 代理
- `docker compose up -d nginx` 重建容器
- **验证**: `https://localhost/itterminal/` → 200 ✅；JS/CSS → 200 ✅
### 2.4 端到端验证 ✅（部分）
- ✅ 终端前端页面加载正常
- ✅ JS/CSS 资源加载正常
- ✅ 会议室列表 API 端点可达（返回企微 forbidden，因 Secret 未配置）
- ⏳ 企微会议室 Secret 配置后可完成完整功能验证
- **回滚**: 移除 nginx location + docker volume + git checkout
---
## Phase 3: 技术方案文档生成 (今晚自动, ~30min) ✅ 已完成
### 3.1 AI辅助消息框 技术方案 ✅
- **输入**: `01-产品文档/04-坐席工作台/PRD-REQ-坐席-002-AI辅助消息框-v1.0.md` (已确认4项功能)
- **输出**: `02-技术文档/技术架构/增量设计-AI辅助消息框-20260711.md` (901行，含9章节+附录)
- **内容**: 系统设计(挑战/选型/架构图) + 文件列表(7新+3改) + 数据接口 + 时序图 + 4个任务(T01-T04) + 依赖图 + Dify Prompt汇总
- **关键路径**: T01→T02→T03→T04 (~7天)
### 3.2 布局优化v2.0 技术方案 ✅
- **输入**: `01-产品文档/04-坐席工作台/` (坐席端布局优化)
- **输出**: 3个文件
- `02-技术文档/技术架构/增量设计-布局优化v2-20260711.md` (43.5KB主文档，8章节)
- `02-技术文档/技术架构/增量设计-布局优化v2-类图.mermaid` (6.9KB)
- `02-技术文档/技术架构/增量设计-布局优化v2-时序图.mermaid` (6.1KB，3个时序图)
- **内容**: 5个任务(T01-T05) + 8个待明确事项 + 清理清单 + 工具栏设计 + 回复建议区 + 右栏模式切换
---
## Phase 4: 前端开发 (人工, ~15工作日)
### 4.1 AI辅助消息框 (~8天)
- 实时自动补齐 / 语气调整 / 文字润色 / 智能改写
- 前端: ReplyBox.vue 新增AI工具栏
- 后端: wingman.py 新增4个端点
### 4.2 布局优化v2.0 (~7天)
- Phase1: 清理+骨架 (1.5天)
- Phase2: 工具栏 (0.5天)
- Phase3: 回复建议区 (2天)
- Phase4: 右栏训练区+开关 (2天)
- Phase5: 联调 (1天)
---
## Phase 5: ITSM集成 (外部依赖)
### 5.1 ITSM API抓包
- 用 agent-browser 登录 ITSM 代办页面抓 XHR
- 需用户提供 ITSM 登录凭据
### 5.2 ITSM app_id/app_secret申请
- 向 ITSM 平台方申请
- 签名: app_id + app_secret + SHA1
### 5.3 ITSM代办列表集成
- 后端: itsm_service.py 补全代办列表API
- 前端: TodoPanel.vue 工单Tab接入真实数据
---
## Phase 6: 知识库迭代 (待确认)
### 6.1 功能确认
- 技术方案: `02-技术文档/技术架构/增量设计-知识库迭代与痛点缓解-20260711.md`
- 原型图: `docs/01-产品文档/07-知识库/知识库迭代-未实现功能原型设计-20260711.md`
- 待用户确认后进入开发
### 6.2 开发+联调
- RAGFlow对接 / Neo4j图谱 / 前端联调
---
## 今晚自动执行清单
| 步骤 | 操作 | 预计耗时 | 风险 | 状态 |
|------|------|---------|------|------|
| 1.1 | IT资产审批推送 上传+重启+测试 | 5min | 低 | ✅ 完成 |
| 1.2 | itsm_service httpx.Timeout 修复 | 2min | 低 | ✅ 完成 |
| 1.3 | 企微审批范围 7d→30d | 2min | 低 | ✅ 完成 |
| 2.1 | 会议室 DB迁移 | 5min | 中 | ✅ 完成 |
| 2.2 | 会议室 后端env+重启 | 5min | 中 | ✅ 完成(Secret待申请) |
| 2.3 | 会议室 终端前端部署 | 15min | 中 | ✅ 完成 |
| 2.4 | 会议室 端到端验证 | 10min | - | ✅ 部分完成 |
| 3.1 | AI辅助消息框 技术方案 | 15min | 无 | ✅ 完成 |
| 3.2 | 布局优化v2.0 技术方案 | 15min | 无 | ✅ 完成 |
| **合计** | | **~75min** | | **Phase 1-3 全部完成** |
---
## 回滚方案
```bash
# Git 回滚到今晚版本快照
git checkout v2026.07.11-evening
# 数据库回滚（会议室新表）
docker compose exec backend alembic downgrade -1
# 前端回滚
# 终端: 移除 /itterminal/ nginx location
# 坐席/H5: 恢复上一版 dist
```
Reference in New Issue View Git Blame Copy Permalink