# 09_供应商管理增强模块 产品需求文档

## 1. 文档定位

本文档是供应商管理增强模块的生产级 PRD，版本以当前独立 Vue Demo 为准。

- 模块目录：`/Users/deenheao/Nutstore Files/QQ/0-打工/V-working/智航平台商业化/友商竞品/缺失模块PRD/商业化模块Demo/09_供应商管理增强模块`
- 独立 Demo 工程：`/Users/deenheao/Nutstore Files/QQ/0-打工/V-working/智航平台商业化/友商竞品/缺失模块PRD/商业化模块Demo/09_供应商管理增强模块/vue-demo`
- 标准交付包：`/Users/deenheao/Nutstore Files/QQ/0-打工/V-working/智航平台商业化/友商竞品/缺失模块PRD/商业化模块Demo/09_供应商管理增强模块/00_标准交付包`
- Demo 技术口径：Vue 3、Vite、TypeScript、Element Plus、Pinia、Vue Router、MockJS。
- 当前口径变更：原静态 HTML/CSS/JS 方案废弃，所有页面、字段、接口、Mock 和验收均以 `vue-demo` 为准。

## 2. 产品目标

供应商管理增强模块用于补齐智航平台在供应商全生命周期、资质合规、SLA合同履约、工单证据、绩效评分、低代码配置和智能体调用方面的商业化能力。

本模块不重复建设 CMDB、工作流、低代码、ERP 或 AI 盒子系统，而是在智航平台现有基座上形成供应商业务域：

- CMDB：引用设备、系统、站点、专业域和资产对象，支撑供应商服务范围与影响面。
- 低代码：承载评分权重、证照字典、SLA罚则、盒子证据模板等可配置项。
- 工作流：承载准入、整改、暂停派工、续约复盘、月度复盘等审批流。
- AI 盒子：提供现场视频、图片、识别事件、签到与作业证据。
- ERP/采购财务：提供供应商编码、合同金额、结算和预算约束。

## 3. 用户角色

| 角色 | 使用目标 | 核心权限 |
|---|---|---|
| 运维工程师 | 查询供应商、查看服务证据、发起整改或复盘 | 查看台账、详情、工单、证据，提交工作流 |
| 值班经理 | 关注故障响应、逾期工单、现场履约 | 查看总览、台账、履约工单、详情 |
| 总部专家 | 评审专业能力、资质和绩效模型 | 查看全部页面，维护配置中心 |
| 运维管理线 | 管理供应商等级、准入和派工推荐 | 查看全部页面，提交准入/暂停/恢复 |
| 机房现场人员 | 补充现场证据和服务确认 | 查看关联供应商、上传或确认盒子证据 |
| 采购/财务协同角色 | 关注合同金额、续约和罚则 | 查看SLA合同、金额、续约、扣罚建议 |

## 4. 范围边界

### 4.1 本期包含

- 供应商总览驾驶舱。
- 供应商台账、查询、筛选、详情抽屉。
- 资质合规和到期预警。
- SLA合同、罚则和续约管理。
- 履约工单与盒子证据聚合。
- 绩效评分模型和供应商推荐等级。
- 配置中心接入低代码。
- API、Mock 数据、业务表、埋点、CLI 和智能体工具契约。

### 4.2 本期不包含

- 不重建 CMDB 设备模型底表。
- 不重建工作流引擎。
- 不重建低代码配置平台。
- 不重建 AI 盒子视频流平台。
- 不重建 ERP/采购合同主系统。

## 5. 业务状态机

| 当前状态 | 可触发动作 | 下一状态 | 触发系统 | 说明 |
|---|---|---|---|---|
| 准入中 | 准入审批通过 | 可推荐 | 工作流 | 完成资质、服务范围、合同、责任人校验 |
| 可推荐 | 资质到期或SLA下降 | 资质预警 | 定时规则/埋点分析 | 进入预警但仍可派工 |
| 资质预警 | 发起整改 | 处理中 | 工作流 | 需要责任人认领 |
| 处理中 | 整改计划确认 | 整改中 | 工作流 | 开始整改计时 |
| 整改中 | 整改验收通过 | 可推荐 | 工作流/盒子证据 | 恢复推荐与派工 |
| 整改中 | 严重违规或超期 | 暂停派工 | 工作流 | 派工系统应拦截推荐 |
| 暂停派工 | 复盘通过 | 整改中 | 工作流 | 先进入观察期，不直接恢复 |

## 6. 页面与路由

| 路由 | 页面 | Vue 文件 | 业务目标 |
|---|---|---|---|
| `/supplier/overview` | 供应商总览 | `src/views/supplier/overview/Overview.vue` | 模块驾驶舱，承接经营总览、风险预警、集成健康度和月度复盘入口 |
| `/supplier/ledger` | 供应商台账 | `src/views/supplier/ledger/SupplierLedger.vue` | 供应商主数据检索、列表、详情抽屉和CMDB/盒子/ERP/工作流证据穿透 |
| `/supplier/qualification` | 资质合规 | `src/views/supplier/qualification/Qualification.vue` | 证照、人员、安全资质、到期预警、准入/整改状态管理 |
| `/supplier/sla` | SLA合同 | `src/views/supplier/sla/SlaContract.vue` | 合同、服务级别、罚则、续约和履约状态管理 |
| `/supplier/orders` | 履约工单 | `src/views/supplier/orders/WorkOrders.vue` | 从工作流/工单/盒子证据聚合履约过程和逾期闭环 |
| `/supplier/score` | 绩效评分 | `src/views/supplier/score/PerformanceScore.vue` | 评分模型、扣分因子、推荐等级和月度排名 |
| `/supplier/settings` | 配置中心 | `src/views/supplier/settings/Settings.vue` | 低代码配置项、权重模型、证照字典、SLA罚则和盒子证据模板 |
| `/supplier/detail/:id` | 供应商详情隐藏路由 | `src/views/supplier/detail/SupplierDetail.vue` | 从台账抽屉或深链进入的供应商360视图 |

## 7. 页面级功能说明

### 7.1 供应商总览 `/supplier/overview`

页面目标：让管理者快速判断供应商池健康度、风险数量、SLA表现、金额规模和集成基座状态。

必须展示：

- 指标卡：供应商总数、平均健康分、平均SLA、风险供应商数、年度合同金额。
- 趋势区：按月展示健康分、SLA、风险数量变化。
- TOP区：高健康分供应商列表，支持穿透到详情。
- 集成状态区：主门户统一身份、CMDB服务对象、低代码配置表单、工作流审批实例、AI盒子现场证据。
- 月度复盘入口：触发 `submitSupplierWorkflow`，生成月度复盘或专项整改工作流。

验收标准：打开 `/supplier/overview` 后能看到供应商指标、集成状态和复盘入口，且菜单标题显示 `供应商管理系统`。

### 7.2 供应商台账 `/supplier/ledger`

页面目标：以供应商主数据为核心，聚合资质、合同、CMDB对象、盒子、ERP、工作流和履约数据。

必须展示：

- 查询条件：关键词、状态、区域、专业、等级。
- 列表字段：供应商名称、等级、区域、站点、专业、状态、健康分、SLA、响应分钟、逾期工单、合同、金额、到期日、责任人。
- 行操作：查看详情、发起复盘/整改、复制供应商ID。
- 详情抽屉：基础信息、CMDB对象、盒子ID、ERP编码、工作流实例、资质、服务范围、履约证据、时间线。

验收标准：台账页至少展示 5 条供应商 Mock 数据，点击恒冷机电后详情抽屉必须出现 `CMDB-AC-M3-1182` 与 `BOX-B28-AC-021`。

### 7.3 资质合规 `/supplier/qualification`

页面目标：管理供应商证照、人员资质、安全资质、厂家授权和到期风险。

核心功能：

- 资质类型分组：企业资质、人员证书、厂家授权、安全培训、备案文件。
- 到期风险识别：到期前 90/60/30 天分级预警。
- 准入校验：准入中供应商必须满足必填资质清单。
- 整改闭环：资质缺失可直接发起工作流，绑定证据。
- 盒子证据：现场作业资格与实际到场人员可通过 AI 盒子视频/签到辅助核验。

### 7.4 SLA合同 `/supplier/sla`

页面目标：把合同条款、SLA阈值、罚则、续约和履约结果放在一个页面中管理。

核心功能：

- 合同清单：合同号、供应商、合同类型、金额、状态。
- SLA条款：响应、到场、闭环、P1/P2/P3分级。
- 罚则条款：扣罚比例、一次性罚款、安全一票否决。
- 续约提醒：按 `renewalDate` 生成续约预警。
- 关联工单：从工作流/工单系统汇总实际履约结果。

### 7.5 履约工单 `/supplier/orders`

页面目标：把供应商承诺和真实执行证据关联起来，避免供应商评价只靠人工印象。

核心功能：

- 按供应商、专业、站点、状态、逾期维度筛选工单。
- 展示响应时间、到场时间、闭环时间、逾期原因。
- 关联 AI 盒子视频、图片、识别事件、签到记录。
- 支持对逾期/返工/安全违规发起整改工作流。

### 7.6 绩效评分 `/supplier/score`

页面目标：形成可解释的供应商健康分，用于派工推荐、续约、整改和淘汰。

评分因子：

- SLA达成率，建议权重 30%。
- 逾期工单和返工，建议权重 20%。
- 资质合规，建议权重 20%。
- 盒子证据质量，建议权重 15%。
- 专家/站点评价，建议权重 10%。
- 安全违规，一票否决或强扣分，建议权重 5%。

### 7.7 配置中心 `/supplier/settings`

页面目标：把可变规则交给低代码和权限控制，不把业务规则写死在前端。

当前配置项：

- 评分模型权重 `V2026.06-1`。
- 证照类型字典 `V2026.06-2`。
- SLA罚则模板 `V2026.06-3`。
- AI盒子证据模板 `V2026.06-6`。

### 7.8 供应商详情 `/supplier/detail/:id`

页面目标：作为深链和详情抽屉的数据口径，支撑智能体、CLI和页面穿透。

必须展示：

- 供应商基础信息。
- CMDB对象列表。
- AI盒子ID与证据摘要。
- ERP供应商编码。
- 工作流实例。
- 合同、服务范围、资质、时间线。

## 8. 业务规则

| 规则 | 描述 | 执行位置 |
|---|---|---|
| 暂停派工拦截 | `status=暂停派工` 的供应商不得进入推荐派工清单 | 后端服务/派工系统 |
| 资质预警 | 证照到期前90天进入预警，30天进入强预警 | 定时任务/低代码规则 |
| SLA扣罚 | SLA低于合同阈值自动生成扣罚建议 | 后端服务/工作流 |
| 盒子证据强绑定 | 现场类服务必须至少关联一类AI盒子证据 | 工作流提交校验 |
| CMDB对象必填 | 供应商服务范围必须绑定站点或设备对象 | 准入审批校验 |
| 状态变更留痕 | 状态变化必须进入timeline并写入审计 | 后端服务 |

## 9. 非功能需求

| 类型 | 要求 |
|---|---|
| 性能 | 台账列表 1000 条以内查询响应小于 1 秒；详情接口 P95 小于 800ms |
| 可用性 | CMDB/盒子/ERP任一集成不可用时，页面展示降级状态，不阻断主台账查询 |
| 权限 | 配置中心仅总部专家、运维管理线、运维工程师可见；暂停/恢复派工需要管理权限 |
| 审计 | 所有状态变更、工作流提交、CLI调用、智能体调用必须写审计表 |
| 可观测 | 页面访问、查询、详情打开、工作流提交、接口失败都必须埋点 |
| 安全 | CLI和智能体调用必须走统一身份、租户、角色和操作审计 |