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

4.7 KiB

Raw Blame History

任务说明书：H5右侧栏布局调整

版本: v1.0 | 日期: 2026-07-17

📋 基本信息

项目	内容
任务名称	H5右侧栏布局调整
任务ID	#82
优先级	🟡 P2
类型	功能开发
状态	✅ 已完成
负责人	宋献
创建日期	2026-07-17
计划完成日期	2026-07-17

📥 输入项来源

产品需求

来源文档	相关章节	说明
`01-产品文档/01-02产品设计/H5用户端原型图实现概览.md`	§右侧面板	现有右侧栏设计
本需求	原型图v3	调整后的布局要求

原型设计

来源文档	页面	说明
会话页面右侧面板	右侧栏	新布局原型图
`01-产品文档/05-用户端H5/原型-REQ-用户-000-H5用户端-v2.0.html`	完整页面	v2.0 更新：输入栏重构(人工坐席+语音输入)、右边栏布局(排队到底部)

📤 输出成果要求

交付物清单

#	交付物	类型	说明
1	`frontend-h5/src/components/assistant/RightPanel.vue`	代码	调整布局结构
2	`frontend-h5/src/components/assistant/DynamicRecommend.vue`	代码	移除分类标签，仅用颜色区分
3	`frontend-h5/src/components/assistant/QueueWaiting.vue`	代码	压缩高度，新增答题开关
4	部署验证	部署测试	H5构建并部署到测试环境

代码要求

遵循项目代码规范
所有新增代码通过 ESLint 检查

🔧 验证方式

功能验证

验证项	验证方法	预期结果
智能推荐区域显示正常	浏览器访问H5	3张推荐卡片显示，颜色边框正确
自助诊断标题样式统一	浏览器访问H5	与设备信息、智能推荐标题样式一致
排队卡片高度压缩	浏览器访问H5	高度约为原来50%
答题开关功能	点击答题挑战按钮	答题区域展开/折叠
答题默认不显示	刷新H5页面	答题区域默认折叠，不显示
无重复答题内容	点击答题挑战按钮	答题区域只显示一次，无重复
平台统计已移除	浏览器访问H5	四宫格统计不显示

✅ 完成标准

验收条件

代码已提交
H5构建成功
部署到测试环境
功能验证通过
Bug修复验证通过（答题默认不显示、无重复内容）

📊 工作分解

子任务

子任务	负责人	预估工时	状态
调整RightPanel.vue布局结构	宋献	1h	✅ 已完成
修改DynamicRecommend.vue移除分类标签	宋献	0.5h	✅ 已完成
修改QueueWaiting.vue压缩高度+答题开关	宋献	1h	✅ 已完成
构建并部署H5	宋献	0.5h	✅ 已完成
功能验证	宋献	0.5h	✅ 已完成
Bug修复：答题默认显示+重复内容	宋献	0.5h	✅ 已完成

📞 依赖与阻塞

前置依赖

依赖任务	依赖说明	状态
无	独立任务	-

阻塞因素

阻塞项	影响范围	解决方案
无	-	-

📈 变更记录

日期	变更内容	变更人	说明
2026-07-17	创建任务	宋献	初始版本
2026-07-17	Bug修复	宋献	修复答题默认显示、重复内容问题；按钮改名"答题挑战"
2026-07-17	任务完成	宋献	功能开发 + Bug修复已完成并部署
2026-07-24	原型图更新	宋献	H5用户端原型图更新至 v2.0：输入栏重构(人工坐席+语音输入)、右边栏布局(排队到底部)
2026-07-24	部署修复	宋献	修复排队等待位置：使用 flex:1 让智能推荐占据主空间，排队固定底部；部署后企微内用 Ctrl+Shift+R 强制刷新

📎 调整需求说明

需求概述

调整 H5 员工端右侧栏布局和功能：

智能推荐位置调整
- 标题位于自助诊断下方
- 保持一直显示状态
- 预留2-3张卡片高度
推荐内容分区调整
- 取消 L1/L2/L3 分区标题显示（相关推荐/运维提醒/常用资源）
- 颜色边框保留（绿/橙/灰）
- 无分类标签
排队卡片压缩
- 高度压缩50%
- 取消平台实时统计（四宫格）
- 保留：排队位置、前面人数、预计等待时间、积分等级
答题功能
- 答题开关放在排队卡片标题栏右侧
- 点击才展开答题区域，默认折叠

4.7 KiB Raw Blame History

任务说明书：H5右侧栏布局调整

📋 基本信息

📥 输入项来源

产品需求

原型设计

📤 输出成果要求

交付物清单

代码要求

🔧 验证方式

功能验证

✅ 完成标准

验收条件

📊 工作分解

子任务

📞 依赖与阻塞

前置依赖

阻塞因素

📈 变更记录

📎 调整需求说明

需求概述

4.7 KiB

Raw Blame History