yss-project/docs/locate/TEAM-LEADER-OPERATIONS-AND-FIELDS.md

组长端功能操作路径（操作步骤）

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：本地构建的搜索索引（项目名+设计师名小写拼接）。

以上字段主要用于组长工作台页面做排序、筛选、搜索以及在项目卡片上展示「阶段进度条」「临期/逾期标识」「质量评级」等信息，并决定点击项目时跳转到哪个阶段的详情页。

---

如需后续扩展，我可以基于本文件继续添加：

• 按「页面维度」的字段表（例如：工作台/团队管理/质量管理分别用到哪些字段）；
• 或者导出为对外说明文档（仅保留业务含义，不暴露内部实现细节）。