# TODOLIST 代办事项
## 第三方接口的代办工作
- [ ] 渲染监听：渲酷农场渲染进度的数据对接及交付阶段，渲染任务的选择设置
- [ ] 会话归档：群聊消息监听的权限审核与数据采集分析
- [ ] 小程序订单：从数据库小程序商城同步订单到客服系统
    - 订单同步、项目创建、报价分配、拉群成组

## 项目管理流程优化
- [ ] 智能交付：交付页面，拖拽文件，并细化大模型识别文件类型与空间的功能
- [ ] 改图工单：改图是独立于初期报价，后期延续的灵活工单，需要独立设计
- [ ] 员工问卷：专业特长及偏好问卷功能
- [ ] 方案深化：参考图区分软装、硬装、氛围等用途标签，对应不同分析结果

## 2025-10-29

### 管理后台仪表板数据修复
- [x] **进行中项目统计修复**：修正查询逻辑，正确排除待分配、已完成、已取消状态及订单分配阶段的项目。
- [x] **已完成项目统计修复**：使用OR查询同时统计status='已完成'和currentStage='售后归档'的项目。
- [x] **设计师总数统计修复**：修正查询字段从identity改为roleName，使用'组员'作为设计师标识，与组长工作台保持一致。
- [x] **客户总数统计修复**：正确查询ContactInfo表，添加多租户过滤和已删除过滤。
- [x] **收入统计修复**：从Project表的data.pricing.totalAmount字段正确计算总收入，包含多个降级取值逻辑。
- [x] **多租户隔离**：所有统计查询增加company指针过滤，确保数据安全隔离。
- [x] **详细调试日志**：为所有统计方法添加详细的console日志，便于问题排查和数据验证。
- [x] **备用查询方案**：设计师统计增加备用查询逻辑，查询失败时自动尝试手动统计角色分布。

### 项目管理页面清理
- [x] **移除测试按钮**：移除"测试案例自动创建"按钮及相关测试功能，页面更简洁。
- [x] **简化依赖**：移除TestProjectCompleteService的导入和依赖注入。
- [x] **代码优化**：删除updateTestProject()方法及其所有相关逻辑。

### 客户画像面板优化（管理后台）
- [x] **修复跟进记录乱码**：智能识别企微userid，优先显示真实姓名，无法获取时显示"企微用户"而非乱码。
- [x] **增强版时间线样式**：全新的渐变卡片式设计，包含紫色主题渐变、动画效果、悬停交互。
- [x] **精美头部设计**：渐变图标容器、大号标题、紫色数量徽章。
- [x] **时间线标记优化**：渐变圆点（首条绿色脉冲动画）、渐变连接线。
- [x] **卡片式内容展示**：渐变背景、操作员头像、操作类型徽章、时间戳。
- [x] **悬停交互动效**：边框变紫色、阴影加深、卡片右移4px。
- [x] **响应式布局**：完整的移动端适配（<768px），自动调整尺寸和间距。
- [x] **入场动画**：slideInUp 0.4s 动画效果，视觉流畅。

### 客户画像组件修复（Wxwork项目模块）
- [x] **HTML结构修复**：移除.timeline-dot内的错误内容标签，避免重复显示。
- [x] **数据处理优化**：智能处理企微userid，优先级：备注名 > 真实姓名 > "企微用户"。
- [x] **内容简化**：跟进记录content简化为"添加客户"，不再重复显示userid。
- [x] **乱码过滤规则**：检测以'woAs2q'开头的企微userid特征，自动过滤。
- [x] **统一用户体验**：与管理后台客户画像组件使用相同的乱码处理逻辑。

### 群组管理编辑面板优化
- [x] **卡片式布局设计**：群组信息展示卡片和编辑表单卡片分离，信息层次清晰。
- [x] **渐变美学**：紫色主题渐变（#667eea → #764ba2）贯穿整个设计。
- [x] **增强的下拉选择器**：自定义SVG箭头、渐变边框、4px光晕聚焦效果。
- [x] **iOS风格切换开关**：圆角滑块设计，启用绿色渐变，禁用红色渐变，平滑动画。
- [x] **帮助文本提示**：左侧紫色边框、图标说明、渐变背景。
- [x] **精美按钮设计**：渐变背景、波纹点击动画、悬停上浮效果。
- [x] **完整响应式**：移动端自适应布局，保持视觉比例。

### 客服工作台数据修复与优化
- [x] **待分配项目统计修复**：从status='待分配'改为统计currentStage='订单分配'的项目，与业务逻辑对齐。
- [x] **项目总数统计**：点击"项目总数"按钮跳转到项目列表并显示所有项目（filter=all）。
- [x] **待分配项目筛选**：点击"待分配项目数"按钮跳转到项目列表并筛选订单分配阶段项目（filter=pending）。
- [x] **查询参数路由**：项目列表支持queryParams筛选，接收filter参数自动应用对应过滤器。
- [x] **客户端筛选**：获取所有项目后在客户端筛选订单分配阶段，确保统计准确性。
- [x] **数据实时同步**：所有统计数据从Parse数据库实时查询，确保数据准确性。
- [x] **详细调试日志**：添加console日志输出，便于验证筛选逻辑和数据准确性。

### 客服项目看板功能
- [x] **四阶段看板**：订单分配、确认需求、交付执行、售后四个核心阶段的看板视图。
- [x] **三种视图模式**：卡片视图、列表视图、监控大盘视图自由切换。
- [x] **项目搜索功能**：支持按项目名称或客户名称搜索，实时筛选。
- [x] **状态筛选器**：按项目阶段快速筛选，支持全部、订单分配、确认需求等。
- [x] **紧急状态标识**：自动识别临近截止日期的项目，显示紧急标签。
- [x] **项目详情跳转**：点击项目卡片跳转到详情页，支持项目管理操作。
- [x] **响应式布局**：完整的移动端适配，卡片和列表自适应布局。

### 案例库数据统计功能整合与优化
- [x] **精美数据统计按钮**：在案例库页面头部增加"数据统计"按钮，点击展开/收起统计面板。
- [x] **Top 5 分享案例统计**：展示分享次数最多的5个案例，前3名有特殊徽章（金、银、铜）。
- [x] **客户最喜欢风格统计**：按风格标签统计收藏数，显示前5个最受欢迎的风格。
- [x] **设计师推荐率统计**：计算每个设计师的作品推荐率（优秀案例数/总案例数），显示前5名。
- [x] **统计面板精美样式**：渐变背景、彩色图标、排名徽章、悬停动画等现代化设计。
- [x] **自动更新统计**：案例加载后自动计算统计数据，支持筛选后的实时更新。
- [x] **空状态友好提示**：暂无数据时显示友好的空状态图标和提示文字。
- [x] **响应式布局**：统计面板在桌面端3列布局，移动端自动切换为单列。
- [x] **展开/收起动画**：统计面板使用slideDown动画效果，视觉流畅。

### 项目到案例自动同步验证与调试
- [x] 增强调试日志：CaseService添加详细的查询结果日志，包括案例数量和示例数据。
- [x] 同步逻辑验证：验证ProjectToCaseService的自动创建流程正常工作。
- [x] 测试按钮确认：确认管理后台的"测试案例自动创建"按钮可用。
- [x] 数据库连接检查：通过日志确认Parse数据库连接和查询正常。
- [x] 空案例库提示：当没有案例时显示友好提示，引导用户创建测试项目。
- [x] **修复isPublished筛选逻辑**：案例库明确传入`isPublished: undefined`时，不再默认筛选已发布案例，可以显示所有已完成项目。
- [x] 完整测试文档：创建详细的测试验证指南（TEST-CASE-SYNC-VERIFICATION.md）和快速开始指南（QUICK-START-CASE-SYNC.md）。

### 项目到案例自动创建功能
- [x] 项目售后归档阶段自动创建案例：当项目进入"售后归档"阶段时，系统自动创建对应案例并同步到案例库。
- [x] 测试项目完成服务：新增 `TestProjectCompleteService`，可一键完成测试项目的所有阶段并验证案例创建。
- [x] 项目数据自动填充：自动填充项目的面积、户型、预算、设计亮点、材料等完整信息。
- [x] 示例产品创建：自动创建主卧、客厅、厨房三个空间的效果图和产品数据。
- [x] 数据完整映射：项目数据自动映射到案例的 `info` 和 `data` 对象，包括预算、时间线、亮点等。
- [x] 案例库展示验证：案例在客服案例库中正确显示，包含封面图、标签、价格等信息。
- [x] 测试按钮集成：在项目管理页面增加"测试案例自动创建"按钮，方便快速测试。
- [x] Pointer创建方法修复：统一使用对象字面量 `{ __type: 'Pointer', className: 'xxx', objectId: 'xxx' }` 创建指针。

### 案例库页面优化
- [x] 移除手动创建案例功能：移除"创建案例"按钮和案例管理模态框，只保留自动同步的案例展示。
- [x] 精美页面头部：渐变背景的头部，显示"已完成项目案例库"标题、案例总数和本月新增统计。
- [x] 完成信息展示：每个案例显示"售后归档完成"徽章和完成时间。
- [x] 项目价格展示：以渐变卡片形式显示项目总额，突出显示金额信息。
- [x] 优化案例网格布局：调整卡片最小宽度和间距，让案例展示更美观。
- [x] 自动计算本月新增：动态计算并显示当月新增的已完成项目案例数量。
- [x] 只读案例库：移除所有编辑、删除功能，专注于展示已完成的项目案例。

### 技术优化
- [x] 修复 FmodeParse 中 Pointer 创建方法，不再使用 `createWithoutData`。
- [x] 新增详细的测试指南文档 `TEST-CASE-AUTO-CREATE.md`。
- [x] 服务解耦：`TestProjectCompleteService` 负责测试流程，`ProjectToCaseService` 负责案例创建逻辑。
- [x] Case接口完善：添加 `roomType`, `totalPrice`, `completionDate`, `tag` 等字段，支持完整数据展示。

- [ ] 设计师端接入数据库

### 组长端订单审批

- [x] 新增订单审批面板：客服提交订单分配后，组长可在独立面板中查看项目信息、报价总额、设计师分配详情。
- [x] 审批操作：支持通过或驳回订单，驳回时需选择原因（报价不合理、设计师分配不当、项目信息不完整等）并可补充说明。
- [x] 仪表盘数据统计：新增"待组长确认项目"指标卡片，实时显示待审批订单数量，点击可快速筛选。
- [x] 状态标识：待审批项目在看板中显示专属徽章，方便快速识别。
- [x] 审批历史记录：记录每次提交与审批的时间、提交人、审批结果等信息。
- [x] 驳回后重新提交：客服可查看驳回原因，修改后重新提交审批。

### 组长端工作量负载管理

- [x] 工作量负载概览：优化组长工作台负载概览功能，展示团队整体工作量分布，支持按设计师、时间维度查看。
- [x] 项目负载时间轴：后端数据接通，实时展示项目在时间轴上的分布，方便组长进行资源调度。
- [x] 看板优化：优化项目负载看板的交互与视觉效果，提升数据可读性。

### 设计师详情与负载管理

- [x] 设计师详情页项目列表：展示设计师当前负责的所有项目，支持查看项目状态、进度等信息。
- [x] 负载详细日历功能：日历视图展示设计师每日负载项目情况，直观了解设计师工作安排。
- [x] 设计师请假审批：组长可在设计师详情页审批请假申请，并在日历中标记请假状态。
- [x] 真实数据接通：设计师数据与企业微信同步，确保信息准确性。

### 组长端身份认证与权限

- [x] 企业微信账号身份认证：组长通过企业微信身份认证后，系统自动识别其组长角色。
- [x] 组员信息展示：认证成功后自动显示该组所有组员信息，方便管理。
- [x] 导航条优化：组长端导航条显示组长个人信息（头像、姓名、角色），提升身份识别度。
- [x] 多交互功能：组长端与项目详情页实现多处交互联动，包括审批面板、成员管理、进度跟踪等。


## 2025-10-25
- [x] 报价规则：价格报价器的细节规则优化
    - 报价细项的优化与合并
        - 内部执行报价分为：建模阶段、软装渲染、公司分配
            - 建模阶段：占比10%
            - 软装渲染：占比40%
            - 公司分配：占比50%
        - 报价自动分配比例是指在原有三级报价总价基础上，自动填写三类分配金额
    - 按默认比例分配 + 人工填写报价
- [x] 组员派单：根据新的空间报价，修改派单逻辑，增加已派单成员移除的功能
- [x] 项目信息：修复小图日期、交付日期的时间选择组件，小图日期必填


# CHANGELOG 更新日志

## 2025-10-24
### 项目启动访谈问卷
- [x] 新增项目问卷：面向客户的首次需求调研，3-5分钟选择式题目，覆盖基础需求、核心侧重、协作节奏、特殊提醒四大模块。
- [x] 快速入口：项目详情的客户卡片展示问卷状态；未填写显示“发送问卷”，已填写显示“查看问卷”。
- [x] 群聊发送：支持在企业微信群聊一键发送问卷链接，客户点击即可填写。
- [x] 多联系人支持：同一项目的多个联系人可分别填写，答卷独立保存。
- [x] 结果查看：客服/组员/组长可随时查看已填写的问卷结果。
- [x] 自动保存与完成标记：答题过程逐题自动保存；提交后标记完成并记录时间。
- [x] 联系人信息补全：问卷中填写的姓名/手机号可同步至联系人资料；手机号对非本人脱敏显示。
- [x] 权限与隐私：客户本人与内部成员可查看完整结果，其他外部联系人无权查看。

### 页面手机端适配
- [x] 项目详情-文件，标题与筛选操作栏，紧凑布局
- [x] 项目详情-成员，标题与筛选操作栏，紧凑布局
- [x] 项目详情-问题，标题与筛选操作栏，紧凑布局并全屏弹窗

### 组员分配（项目详情页）
- [x] 增加删除组员功能，将组员移出项目组
- [x] 企业微信SDK：添加成员后，自动邀请进群（企业微信PC/手机端）

## 2025-10-23

### 员工管理（后台）
- [x] 员工列表显示头像与职位，缺失头像自动使用统一占位图，列表更整齐。
- [x] 员工详情弹窗更丰富：手机号、邮箱、企微ID、身份、部门、入职时间、技能与工作量等一目了然。
- [x] 弹窗样式与布局优化，对齐与间距更合理，信息更易读。

### 表格与界面一致性
- [x] 多页面的列宽与对齐优化，整体信息密度与可读性提升，浏览体验更统一。

### 稳定性与兼容性
- [x] 刷新后列表自动同步最新数据，减少信息不一致的情况。
- [x] 无跟进记录时自动显示历史跟进信息，保证页面内容完整性。
## 2025-10-22

### 客户选择与详情体验
- [x] 项目页支持便捷选择或创建客户，已建档/未建档清晰分区，搜索更高效。
- [x] 新增“一键刷新客户信息”，可同步企业微信的最新资料，名单与详情保持一致。
- [x] 客户详情以侧栏弹窗方式展示，点击返回或遮罩即可关闭，不会跳转到错误页面。
- [x] 跟进记录默认显示当前项目的记录，支持切换查看该客户的全部跟进历史。

### 客户信息显示优化
- [x] 统一头像占位图为 `/assets/images/default-avatar.svg`，列表与详情一致，缺失头像时显示更友好。
- [x] “所在群聊”改为纵向列表，信息展示更完整，阅读更舒适。

### 客户管理（后台）
- [x] 客户列表增加头像、类型、名称等信息显示，点击即可查看详情。
- [x] 在详情中可直接刷新客户数据，确保资料实时准确。