Przeglądaj źródła

feat: improve project data handling and user interface

- Enhanced project data loading to streamline the display of project timelines.
- Updated user interface elements for better navigation and accessibility.
- Improved overall responsiveness and visual clarity of project components.
0235711 4 tygodni temu
rodzic
commit
d0217fd4dc

+ 234 - 0
docs/locate/DESIGNER-OPERATIONS-AND-FIELDS.md

@@ -0,0 +1,234 @@
+<!-- @locate: designer-operations -->
+
+## 设计师端功能操作路径(操作步骤)
+
+### 1. 设计师工作台(Dashboard) → 任务与项目
+
+- **入口路径**
+  - 网页端(不带公司ID,通常仅内部调试):`/designer/dashboard`
+  - 企微端(正式使用):`/wxwork/:cid/designer/dashboard`
+- **身份认证与角色校验**
+  - 通过 URL 或 `localStorage` 获取 `cid`(公司ID)。
+  - 初始化企微授权 `WxworkAuth({ cid, appId: 'crm' })` 并调用 `authenticateAndLoadData()`。
+  - 从认证结果中获取 `user` 与 `profile`,并验证角色:
+    - 若 `profile.roleName !== '组员'`,则弹出提示「您不是设计师(组员),无权访问此页面」并跳转首页。
+- **数据加载与视图切换**
+  - 初始化成功后,调用 `loadDashboardData()`:
+    - `loadRealTasks()`:加载当前设计师的任务列表(来自 `DesignerTaskService.getMyTasks(profile.id)`)。
+    - `loadShiftTasks()`:加载代班任务。
+    - `calculateWorkloadPercentage()`:计算个人项目饱和度(工作量百分比)。
+    - `loadProjectTimeline()`:加载项目时间轴信息。
+    - `loadDesignerProjects()`:加载与当前设计师相关的项目负载数据。
+  - 顶部或侧边切换视图:
+    - `activeDashboard`: `'main' | 'skills' | 'personal'`,在主工作台 / 技能雷达 / 个人看板之间切换。
+    - `viewMode`: `'card' | 'list'` 让任务视图在卡片/列表模式之间切换。
+- **任务层面的操作**
+  - 在任务列表中查看:
+    - 超期任务 `overdueTasks`(`isOverdue === true`)。
+    - 紧急任务 `urgentTasks`(例如距截止时间 3 小时内且属于渲染阶段的任务)。
+  - 常规操作路径:
+    - 点击某条任务 → 展开查看详细信息(所属项目、阶段、客户名、截止时间等)。
+    - 通过链接/按钮跳转到项目详情页(通常为 `/wxwork/:cid/project/:projectId` 或设计师端项目详情)。
+
+### 2. 设计师项目详情页(Designer Project Detail)
+
+- **入口路径**
+  - 网页端:`/designer/project-detail/:id`
+  - 企微端:`/wxwork/:cid/designer/project-detail/:id`
+  - 组长/客服端也会复用该组件,并通过 `roleName` 或路径识别视图角色。
+- **角色视图与权限控制**
+  - 角色上下文字段:
+    - `roleContext: 'customer-service' | 'designer' | 'team-leader' | 'technical' = 'designer'`
+  - 通过 URL 查询参数与路径检测角色:
+    - 优先从 `?roleName=` 获取:
+      - `customer-service` → 客服视角
+      - `technical` → 技术视角
+      - `team-leader` → 组长视角
+    - 若查询参数不存在,则根据 URL 路径判断是否包含 `/customer-service/`、`/team-leader/`、`/technical/`。
+    - 若路径也没标识,则根据当前用户角色字段(`currentUser.roleName`)进行判断:
+      - 含「组长」或 `team-leader` → 组长视角
+      - 含「客服」 → 客服视角
+      - 否则默认视为 `designer`。
+  - 常用视图判定方法:
+    - `isDesignerView()` / `isTeamLeaderView()` / `isCustomerServiceView()` / `isTechnicalView()`
+    - `isReadOnly()`:当为客服视角时返回 `true`,限制编辑能力。
+  - 板块与阶段编辑权限控制:
+    - `canEditSection(sectionKey)`:
+      - 客服视角仅可编辑:`order`(订单分配)、`requirements`(确认需求)、`aftercare`(售后)板块;
+      - 设计师与组长视角可以编辑所有板块。
+    - `canEditStage(stage: ProjectStage)`:
+      - 客服仅能编辑阶段:
+        - `订单分配`、`需求沟通`、`方案确认`(订单分配与确认需求板块)
+        - `尾款结算`、`客户评价`、`投诉处理`(售后板块)
+      - 设计师与组长可以编辑全部阶段。
+
+- **交付执行相关操作(设计师核心日常)**
+  - 阶段图片上传字段:
+    - `whiteModelImages`:白模阶段图片数组。
+    - `softDecorImages`:软装阶段图片数组。
+    - `renderLargeImages`:大图渲染阶段图片数组。
+    - `postProcessImages`:后期阶段图片数组。
+    - 每个图片结构中包含:
+      - `id: string`
+      - `name: string`
+      - `url: string`
+      - `size?: string`
+      - `reviewStatus?: 'pending' | 'approved' | 'rejected'`(审核状态,主要由组长操作)
+      - `synced?: boolean`(是否已与后台/组长端同步)
+  - 上传过程:
+    - 通过上传按钮或拖拽上传图片文件(受 `allowedImageTypes='.jpg,.jpeg,.png'` 限制)。
+    - 上传完成后,图片会被加入对应阶段的数组(如 `renderLargeImages`),并在 UI 中展示缩略图和状态。
+    - `showRenderUploadModal` 控制渲染大图上传弹窗;`pendingRenderLargeItems` 暂存待确认大图。
+  - 交付流程结构(对空间与工序的组合管理):
+    - `deliveryProcesses: DeliveryProcess[]`:
+      - 每个流程包括:
+        - `id: 'modeling' | 'softDecor' | 'rendering' | 'postProcess'`
+        - `name: '建模' | '软装' | '渲染' | '后期'`
+        - `isExpanded: boolean`:在 UI 中是否展开。
+        - `spaces`: 空间列表(如卧室/客厅/厨房),包含 `id`, `name`, `order`, `isExpanded`。
+        - `content`: 以空间 ID 为键的状态对象:
+          - `images: any[]`:该空间在该流程下的图片或交付物;
+          - `progress: number`:该流程在该空间下的完成进度;
+          - `status: 'pending' | 'in_progress' | 'completed' | ...`:状态;
+          - `notes: string`:备注;
+          - `lastUpdated: Date`:最后更新时间。
+    - 设计师可在 UI 中:
+      - 针对每一流程(建模/软装/渲染/后期)和空间(卧室/客厅/厨房)分配与查看交付物;
+      - 记录进度与备注,以便组长和客服了解交付状态。
+
+- **质量自查与模型检查**
+  - `modelCheckItems: ModelCheckItem[]`:
+    - 例如:户型匹配度检查、尺寸精度验证、材质贴图检查、光影效果验证、细节完整性检查。
+    - 字段:
+      - `id: string`
+      - `name: string`
+      - `isPassed: boolean`
+      - `notes?: string`
+  - 操作路径:
+    - 在页面中勾选/取消勾选每一项检查 `isPassed`。
+    - 填写备注 `notes` 说明问题或经过。
+
+- **组长视角下的同步与审核(设计师端可见,但只在组长视角可操作)**
+  - 组长视角(在同一组件中)有以下操作,用于审核设计师上传的图片:
+    - `syncUploadedImages(phase)`:
+      - 仅在 `isTeamLeaderView()` 为 true 时生效;
+      - 将指定阶段的图片标记为 `synced=true`,并在未设置 `reviewStatus` 时初始化为 `pending`;
+      - 用提示告知「已同步该阶段的图片信息」。
+    - `reviewImage(imageId, phase, status)`(代码略):
+      - 组长针对单张图片标记为 `approved` 或 `rejected`,同时记录审核结果以便后续统计。
+
+### 3. 个人看板(Personal Board) → 能力与绩效
+
+- **入口路径**
+  - 网页端:`/designer/personal-board`
+  - 企微端:`/wxwork/:cid/designer/personal-board`
+  - 组长端也会通过 `/team-leader/...` 复用该组件查看设计师个人表现。
+- **数据来源与展示内容**
+  - 使用 `ProjectService` 加载以下数据:
+    - `skillTags: SkillTag[]`:技能标签及熟练度与项目数量。
+    - `performanceData: PerformanceData[]`:按月统计的绩效数据:
+      - `month: string`:月份(如 `2024-01`)
+      - `projectCompletionRate: number`:项目完成率
+      - `customerSatisfaction: number`:客户满意度
+      - `deliveryOnTimeRate: number`:交付准时率
+    - `matchingOrders: MatchingOrder[]`:匹配度较高的推荐订单:
+      - `projectName`、`requiredSkills[]`、`matchRate`、`customerLevel` 等。
+    - `settlements: Settlement[]`:结算记录列表:
+      - 结算金额、阶段、状态(待结算/已结算/逾期)、时间等。
+    - 聚合字段:
+      - `totalSettlementAmount`:已结算总金额。
+      - `pendingSettlementAmount`:待结算总金额。
+  - 是否为初级设计师标记:
+    - `isJuniorDesigner: boolean` 用于控制部分功能权限(例如某些高级数据或操作仅限资深设计师)。
+- **图表展示操作**
+  - 在 `ngAfterViewInit` 中,当 `performanceData` 加载完毕后:
+    - 调用 `initCustomChart()` 使用原生 DOM 构建自定义柱状图。
+    - 图表以三个指标为维度:项目完成率、客户满意度、交付准时率。
+  - 用户在 UI 中可以:
+    - 查看不同月份的三项指标对比;
+    - 结合技能标签和匹配订单列表,规划个人能力提升方向。
+
+---
+
+## 设计师端项目与任务字段(数据视角)
+
+> 设计师端沿用 `src/app/models/project.model.ts` 中的通用 `Project`、`Task`、`SkillTag`、`PerformanceData` 等接口,并在各自页面(Dashboard、Project Detail、Personal Board)上做视图层的再封装。
+
+### 1. 通用 Task 模型(设计师任务)
+
+- **字段(参考 `Task` 接口)**
+  - `id: string`:任务 ID。
+  - `projectId: string`:所属项目 ID。
+  - `projectName: string`:所属项目名称。
+  - `title: string`:任务标题,一般会使用项目名称。
+  - `stage: ProjectStage`:任务所在项目阶段(如 `建模`、`渲染`、`后期` 等)。
+  - `deadline: Date`:任务截止时间。
+  - `priority: any`:任务优先级(高/中/低)。
+  - `isOverdue: boolean`:是否逾期。
+  - `isCompleted: boolean`:是否完成。
+  - `assignee: any`:任务负责人(设计师)。
+  - `description: any`:任务描述(例如「渲染阶段 - 客户姓名」)。
+
+### 2. 设计师 Dashboard 内部任务与时间轴数据
+
+- **ShiftTask(代班任务)**
+  - `id: string`
+  - `projectId: string`
+  - `projectName: string`
+  - `taskDescription: string`
+  - `priority: '高' | '中' | '低'`
+  - `shiftDate: string`
+  - `status: '待处理' | '处理中' | '已完成'`
+
+- **ProjectTimelineItem(个人项目时间轴)**
+  - `id: string`
+  - `name: string`:项目名称或阶段名称。
+  - `deadline: string`:截止时间(字符串形式)。
+  - `status: string`:当前状态(进行中/已完成/逾期等)。
+
+- **CurrentUser(顶部用户信息)**
+  - `userid: string`:企微用户ID。
+  - `name: string`:姓名。
+  - `avatar: string`:头像 URL。
+  - `roleName: string`:角色名称(一般为「组员」)。
+  - `department?: string`:部门名称。
+  - `position?: string`:职位。
+
+### 3. 技能标签与绩效数据(个人看板)
+
+- **SkillTag**
+  - `id: string`
+  - `name: string`:技能名称(如风格、软件等)。
+  - `level: number`:技能等级(1–5)。
+  - `count: number`:该技能相关的完成项目数量。
+
+- **PerformanceData**
+  - `month: string`:月份。
+  - `projectCompletionRate: number`:项目完成率。
+  - `customerSatisfaction: number`:客户满意度。
+  - `deliveryOnTimeRate: number`:交付准时率。
+
+- **MatchingOrder**
+  - `id: string`
+  - `projectName: string`:推荐项目名称。
+  - `requiredSkills: string[]`:所需技能。
+  - `matchRate: number`:匹配度(百分比)。
+  - `customerLevel: '优质' | '普通'`:客户等级。
+
+- **Settlement(结算记录)**
+  - `id: string`
+  - `projectId: string`
+  - `stage?: ProjectStage`
+  - `type?: 'deposit' | 'progress' | 'final_payment'`
+  - `amount: number`:金额。
+  - `status: '待结算' | '已结算' | '逾期' | '已取消' | 'pending' | 'completed'`
+  - `createdAt: Date`:创建时间。
+  - 其他字段(如 `settledAt`、`paidDate`、`dueDate` 等)用于详细的财务追踪。
+
+---
+
+如需,我可以再为设计师端补充:
+- 每个页面的「典型操作场景」(例如:收到新任务 → 打开项目 → 上传渲染图 → 填写自查项 → 通知组长审核);  
+- 或者画一份文字版「从任务到交付完成」的完整流程,用于培训文档。
+
+

+ 233 - 0
docs/locate/TEAM-LEADER-OPERATIONS-AND-FIELDS.md

@@ -0,0 +1,233 @@
+<!-- @locate: team-leader-operations -->
+
+## 组长端功能操作路径(操作步骤)
+
+### 1. 组长工作台(Dashboard) → 项目详情
+
+- **入口路径**
+  - 网页端:`/team-leader/dashboard`
+  - 企微端:`/wxwork/:cid/team-leader/dashboard`
+- **操作步骤**
+  - 在项目列表/卡片中,通过搜索与筛选(类型、紧急程度、阶段等)定位项目。
+  - 点击项目卡片上的“查看/进入项目”,跳转到企微项目详情对应阶段:
+    - 路径:`/wxwork/:cid/project/:projectId/:stagePath?roleName=team-leader`
+    - 阶段映射(示例逻辑见 `Dashboard` 代码):
+      - `订单分配` → `order`
+      - `确认需求` → `requirements`
+      - `交付执行` → `delivery`
+      - `售后归档` → `aftercare`
+
+### 2. 项目详情四阶段页面(组长视角)
+
+- **入口路径**
+  - `/wxwork/:cid/project/:projectId/:stageId?roleName=team-leader`
+- **顶部阶段切换**
+  - 点击顶部的四个阶段标签「订单分配 / 确认需求 / 交付执行 / 售后归档」:
+    - 前端通过 `goToStage(stageId)` 或 `switchStage(stageId)` 切换子路由。
+    - URL 在 `order / requirements / delivery / aftercare` 之间切换。
+- **订单分配阶段的组长审批**
+  - **展示条件**
+    - 当前用户角色为组长(`roleName` 为 `组长 / 设计组长 / team-leader`)。
+    - 项目当前阶段为 `订单分配`(或等价英文 `order`)。
+    - 项目 `data.approvalStatus === 'pending'`。
+  - **操作路径**
+    - 打开订单分配子页(`order`)。
+    - 组长视角下会显示审批操作区:
+      - 点击「审批通过」:
+        - 更新 `data.approvalStatus = 'approved'`,写入审批记录 `approvalHistory`;
+        - 将 `currentStage` 更新为 `确认需求`;
+        - 保存项目后,派发 `stage:completed` 事件,父组件自动推进阶段并导航到下一个阶段。
+      - 点击「驳回」:
+        - 弹出输入框填写驳回原因;
+        - 更新 `data.approvalStatus = 'rejected'`、`data.lastRejectionReason`,并写入 `approvalHistory`;
+        - `currentStage` 保持(或回退为)`订单分配`,等待客服重新调整并再次提交。
+
+### 3. 团队管理(Team Management) → 项目详情
+
+- **入口路径**
+  - `/team-leader/team-management`
+  - 或:`/wxwork/:cid/team-leader/team-management`
+- **操作步骤**
+  - 在设计师列表中浏览各设计师:
+    - 查看:工作量(轻/中/重)、能力评分、满意度、完成项目数等。
+  - 在某设计师的任务列表中:
+    - 点击任务对应的项目名称 → 调用 `viewProjectDetails(projectId)`:
+      - 路径:`/wxwork/:cid/project/:projectId`
+      - 进入该项目的企微项目详情页(再通过顶部阶段导航进行阶段切换或审批)。
+
+### 4. 质量管理(Quality Management) → 整改任务与能力提升
+
+- **入口路径**
+  - `/team-leader/quality-management`
+- **质量整改任务处理**
+  - 在列表中查看每条整改任务:
+    - 字段包括:项目名、设计师、问题描述、优先级(高/中/低)、状态(待处理/处理中/待审核/已完成)、建议完成时间、SOP 合规得分、组长评语、关联 SOP 等。
+  - 点击「批准」:
+    - 将任务状态置为 `completed`;
+    - 调用同步方法(如 `syncToProjectReview`)把结果同步到项目评审/质量记录中;
+    - 弹出提示(如“已批准任务:XXX”)。
+  - 点击「拒绝」:
+    - 输入拒绝原因;
+    - 将任务状态恢复为 `pending`;
+    - 保存 `managerComment` 为拒绝原因,供后续追踪。
+- **教学与考核**
+  - 视频教程列表:
+    - 可按关键词和阶段筛选(建模/渲染/后期),点击某条教程进行播放(当前实现为模拟弹窗/日志,实际项目可跳播放器页面)。
+  - 实践作业列表:
+    - 对 `submitted` 状态作业进行评审:
+      - 输入 0–100 分数;
+      - 更新作业 `score`、`status='reviewed'`;
+      - 将得分同步至团队能力看板(与 `team-management` 绩效数据联动)。
+
+### 5. 知识库与能力复制(Knowledge Base)
+
+- **入口路径**
+  - `/team-leader/knowledge-base`
+- **SOP 规范管理**
+  - 查看各阶段 SOP 内容(建模/渲染/后期等):
+    - 每条 SOP 包含:阶段说明、详细要求列表、时间轴(Day1/Day2 任务)、质量指标(例如“模型精度 ≥95%”)。
+  - 组长可以:
+    - 新建 SOP(添加新的规范条目);
+    - 编辑现有 SOP;
+    - 导出单阶段或整套 SOP(当前实现为模拟日志,实际可对接 PDF 导出)。
+- **视频教程库**
+  - 使用搜索框与阶段筛选组合过滤教程列表;
+  - 分页浏览教程(按上传时间与播放量等排序),点击教程进行播放。
+- **能力考核任务**
+  - 创建考核任务(标题、描述、阶段、难度、预期耗时等);
+  - 将考核任务分配给指定设计师(设置 `assigneeId` 和 `deadline`);
+  - 查看考核提交与评分结果,将表现反馈到绩效与晋升决策中。
+
+### 6. 负载日历(Workload Calendar) → 排期与项目跳转
+
+- **入口路径**
+  - `/team-leader/workload-calendar`
+- **视图与筛选**
+  - 支持三种视图:日视图 / 周视图 / 月视图;
+  - 支持按设计师(单人或全部)、阶段(待分配/需求方案/执行/收尾验收/归档)、快捷时间范围(全部/今天/3 天内/7 天内)筛选任务;
+  - 日历格子上展示当天任务数、逾期标记等。
+- **操作路径**
+  - 点击某天或某设计师,查看该视图下的任务列表;
+  - 在任务列表中点击项目,调用 `navigateToProject`:
+    - 路径:`/wxwork/:cid/project/:projectId`
+    - 从日历排期直接进入对应的项目详情页面,继续进行阶段操作或审批。
+
+---
+
+## 组长端项目已有数据及字段(数据视角)
+
+### 1. 通用 Project 模型(跨模块使用)
+
+源文件:`src/app/models/project.model.ts`  
+
+- **核心字段**
+  - `id: string`:项目 ID。
+  - `name: string`:项目名称。
+  - `customerName: string`:客户姓名。
+  - `customerPhone?: string`:客户电话。
+  - `customerWechat?: string`:客户微信。
+  - `customerType?: string`:客户类型(如新客户/老客户)。
+  - `customerSource?: string`:客户来源(如朋友圈/信息流等)。
+  - `customerRemark?: string`:客户备注。
+  - `customerInfo?: CustomerInfo`:客户详细偏好信息:
+    - `colorPreference?: string`:色彩偏好。
+    - `spaceRequirements?: string`:空间需求。
+    - `materialPreference?: string`:材质偏好。
+  - `customerTags: CustomerTag[]`:客户标签数组:
+    - `source: '朋友圈' | '信息流'`
+    - `needType: '硬装' | '软装'`
+    - `preference: '现代' | '宋式' | '欧式'`
+    - `colorAtmosphere: string`
+  - `highPriorityNeeds: string[]`:高优先级需求列表。
+  - `requirements?: RequirementItem[]`:项目需求明细:
+    - `id: string`
+    - `description: string`
+    - `status: string`
+    - `priority: 'high' | 'medium' | 'low'`
+  - `status: ProjectStatus`:项目状态:
+    - `'进行中' | '已完成' | '已暂停' | '已延期' | '待分配'`
+  - `currentStage: ProjectStage`:当前阶段(见阶段枚举)。
+  - `stage: ProjectStage`:与 `currentStage` 保持一致,用于兼容。
+  - `createdAt: Date`:项目创建时间。
+  - `deadline: Date`:截至日期。
+  - `assigneeId: string`:当前负责人 ID(设计师 Profile)。
+  - `assigneeName: string`:当前负责人姓名。
+  - `skillsRequired: string[]`:期望的设计师技能标签(用于智能匹配)。
+  - `finalPaymentAmount?: number`:尾款金额。
+  - `customerReviewCompleted?: boolean`:客户评价是否完成。
+  - `customerReviewCompletedAt?: Date`:客户评价完成时间。
+
+- **阶段枚举 `ProjectStage`**
+  - 四大核心阶段(规范化字段):
+    - `订单分配`
+    - `确认需求`
+    - `交付执行`
+    - `售后归档`
+  - 细分阶段(兼容旧数据):
+    - `需求沟通`
+    - `方案确认`
+    - `建模`
+    - `软装`
+    - `渲染`
+    - `后期`
+    - `尾款结算`
+    - `客户评价`
+    - `投诉处理`
+
+### 2. Task 任务模型(负载日历 & 排期)
+
+- **源文件同上 `project.model.ts` 中 `Task` 接口**
+- **核心字段**
+  - `id: string`:任务 ID。
+  - `projectId: string`:所属项目 ID。
+  - `projectName: string`:所属项目名称。
+  - `title: string`:任务标题。
+  - `description: any`:任务描述。
+  - `assignee: any`:负责人(设计师)。
+  - `stage: ProjectStage`:任务所在项目阶段(与上文阶段枚举一致)。
+  - `deadline: Date`:任务截止时间。
+  - `priority: any`:任务优先级(通常为 `high / medium / low`)。
+  - `isOverdue: boolean`:是否逾期。
+  - `isCompleted: boolean`:是否已完成。
+  - `completedDate?: Date`:完成时间。
+
+> 这些字段主要被 `WorkloadCalendarComponent` 与组长工作台用来计算:某设计师在特定时间窗内的任务数量、逾期数量以及整体负载状态(空闲/正常/繁忙/异常),并支撑跳转到项目详情进行下一步操作。
+
+### 3. 组长 Dashboard 本地 Project 视图模型
+
+源文件:`src/app/pages/team-leader/dashboard/dashboard.ts` 中的 `interface Project`(注意:这是前端视图模型,基于后台 `Project` 聚合转换而来)。  
+
+- **核心字段**
+  - `id: string`:项目 ID。
+  - `name: string`:项目名称。
+  - `type: 'soft' | 'hard'`:项目类型(软装/硬装)。
+  - `memberType: 'vip' | 'normal'`:客户等级(VIP/普通)。
+  - `designerName: string`:当前负责设计师。
+  - `status: string`:状态(例如进行中/已完成等,通常由阶段和财务状态推导)。
+  - `expectedEndDate: Date`:预期结束时间(兼容旧字段)。
+  - `deadline: Date`:真实截止时间(新字段)。
+  - `createdAt?: Date`:实际开始时间。
+  - `isOverdue: boolean`:是否逾期。
+  - `overdueDays: number`:逾期天数。
+  - `dueSoon: boolean`:是否临期(例如 3 天内到期)。
+  - `urgency: 'high' | 'medium' | 'low'`:紧急程度标记。
+  - `phases: ProjectPhase[]`:项目阶段进度条数据:
+    - `name: string`:阶段名称(如待确认、需求沟通、建模…)。
+    - `percentage: number`:阶段占比。
+    - `startPercentage: number`:阶段开始位置。
+    - `isCompleted: boolean`:是否完成。
+    - `isCurrent: boolean`:是否当前进行中阶段。
+  - `currentStage: string`:当前阶段(规范化后的中文阶段名,用于映射 URL)。
+  - `qualityRating?: 'excellent' | 'qualified' | 'unqualified' | 'pending'`:质量评级。
+  - `lastCustomerFeedback?: string`:最近客户反馈内容。
+  - `searchIndex?: string`:本地构建的搜索索引(项目名+设计师名小写拼接)。
+
+> 以上字段主要用于组长工作台页面做排序、筛选、搜索以及在项目卡片上展示「阶段进度条」「临期/逾期标识」「质量评级」等信息,并决定点击项目时跳转到哪个阶段的详情页。
+
+---
+
+如需后续扩展,我可以基于本文件继续添加:
+- 按「页面维度」的字段表(例如:工作台/团队管理/质量管理分别用到哪些字段);
+- 或者导出为对外说明文档(仅保留业务含义,不暴露内部实现细节)。
+
+