Files

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

3.5 KiB

Raw Blame History

任务说明书：企微图片消息无法预览

版本: v1.1 | 日期: 2026-07-20

📋 基本信息

项目	内容
任务名称	企微图片消息无法预览
任务ID	#80
优先级	🟠 P1
类型	Bug修复
状态	已部署，存在遗留问题
负责人	Duckula
创建日期	2026-07-16
计划完成日期	2026-07-16
关联缺陷单	BUG-20260720-01（需刷新才显示）

📥 输入项来源

问题反馈

来源	说明
用户反馈	用户通过企业微信发送的图片消息，坐席端无法预览也无法打开图片内容

技术分析

来源文档	相关章节	说明
`backend/app/api/wecom_callback.py`	§图片消息处理	只保存 pic_url 临时URL，未下载到本地
`frontend-agent/src/components/chat/MessageBubble.vue`	§图片渲染	使用 media_url 或 extra_data.pic_url

2026-07-16 新增尝试

#	方法	结果	说明
1	修改上传路径为 `uploads/images`（使用 Docker volume）	已部署	代码已更新到正确路径
2	WebSocket 广播添加 `extra_data`（含 local_media_url）	已部署	前端已支持接收
3	Nginx 配置 `/media/` 代理到后端 `/media/`	已部署	代理链路已配置

待排查问题

#	问题	状态
1	图片是否成功保存到 `/app/uploads/images/`	✅ 已验证
2	WebSocket 是否正确推送 local_media_url	✅ 已验证
3	前端是否正确显示图片	⚠️ 部分验证 - 需刷新才显示

遗留问题 (BUG-20260720-01)

问题描述	现象	状态
首次加载不显示	坐席打开会话时图片空白/占位	待排查
需刷新才显示	刷新页面或切换会话后图片正常	待排查

遗留问题已创建缺陷单: docs/03-测试文档/05-缺陷单/BUG-坐席-图片预览刷新-001.md

📤 输出成果要求

交付物清单

#	交付物	类型	说明
1	wecom_service.py 新增 download_media 方法	代码	下载企微媒体文件到本地
2	wecom_callback.py 图片消息处理逻辑	代码	调用下载方法并保存本地URL
3	后端部署验证	部署	重启后端容器验证功能

代码要求

遵循项目代码规范
新增方法添加单元测试

🔧 验证方式

功能验证

验证项	验证方法	预期结果
企微发送图片	通过企微发送图片到IT服务台	坐席端可正常预览图片
图片下载	查看后端 media/images/ 目录	图片文件已保存
图片访问	点击图片查看大图	可正常打开

✅ 完成标准

验收条件

代码合入主干分支
企微发送图片功能测试通过
坐席端图片预览正常

📊 工作分解

子任务

子任务	负责人	预估工时	状态
在 wecom_service.py 添加 download_media 方法	Duckula	1h	待开始
修改 wecom_callback.py 图片处理逻辑	Duckula	1h	待开始
部署后端并验证功能	Duckula	0.5h	待开始

📈 变更记录

日期	变更内容	变更人	说明
2026-07-16	创建任务	Duckula	初始版本

3.5 KiB Raw Blame History Unescape Escape

任务说明书：企微图片消息无法预览

📋 基本信息

📥 输入项来源

问题反馈

技术分析

2026-07-16 新增尝试

待排查问题

遗留问题 (BUG-20260720-01)

📤 输出成果要求

交付物清单

代码要求

🔧 验证方式

功能验证

✅ 完成标准

验收条件

📊 工作分解

子任务

📈 变更记录

3.5 KiB

Raw Blame History