# 租户模块生产级 PRD

## 1. 模块定位

租户模块属于智航平台“系统中心”能力域，商业化等级为“B级治理能力”。模块目标不是新建孤立系统，而是在智航现有主门户、CMDB、低代码、工作流、报表中心、盒子/边缘能力之上，补齐“租户档案、资源边界、服务包、SLA和盒子交付状态统一运营”这一可售卖、可交付、可运营、可被智能体调用的产品能力。

## 2. 用户角色与任务

| 角色 | 核心诉求 | 主要操作 | 验收关注 |
| --- | --- | --- | --- |
| 运维经理 | 掌握整体状态、风险和闭环效率 | 查看驾驶舱、审批关键动作、导出报告 | 指标可解释、风险可追踪、闭环可审计 |
| 专业工程师 | 处理专业对象和现场任务 | 查看详情、执行处置、上传证据、推进状态 | 字段准确、流程清晰、盒子证据可用 |
| 值班员 | 快速识别待办和异常 | 接单、筛选、查看提醒、发起协助 | 入口明显、误操作可恢复 |
| 供应商/外包 | 完成被分配的履约动作 | 接收任务、提交结果、补充材料 | 权限边界清晰、验收口径明确 |
| 管理层/客户 | 查看服务质量和经营价值 | 看报表、看趋势、看成本收益 | 数据可信、可导出、可对账 |
| 用户智能体 | 通过 CLI/MCP 自动查询和执行动作 | 调用命令/API/MCP Tool | 输入输出稳定、可审计、可限权 |

## 3. 业务目标与指标

| 目标 | 指标 | 计算口径 | Demo 对应 |
| --- | --- | --- | --- |
| 提升闭环效率 | 平均处理时长下降 | 从创建/发现到关闭的时长，排除暂停时间 | 租户总览 |
| 提升数据可用性 | CMDB/盒子关联率 | 有关联对象数 / 模块业务对象总数 | 详情页与证据区 |
| 提升管理可视化 | 核心看板访问率 | 访问驾驶舱用户数 / 目标用户数 | KPI 卡片与总览页 |
| 提升自动化能力 | CLI/MCP 调用成功率 | 成功调用次数 / 总调用次数 | CLI_AND_AGENT_SPEC.md |
| 降低卡点 | 关键漏斗流失率下降 | 进入流程但未完成核心动作的用户占比 | TRACKING_PLAN.md |

## 4. 功能范围

### 4.1 本期必须实现

1. 租户总览：提供 租户 的 租户总览 页面能力，包含查询、筛选、详情、状态推进、证据查看和导出。
2. 合同与服务包：提供 租户 的 合同与服务包 页面能力，包含查询、筛选、详情、状态推进、证据查看和导出。
3. 资源绑定：提供 租户 的 资源绑定 页面能力，包含查询、筛选、详情、状态推进、证据查看和导出。
4. 盒子交付：提供 租户 的 盒子交付 页面能力，包含查询、筛选、详情、状态推进、证据查看和导出。
5. SLA与账单：提供 租户 的 SLA与账单 页面能力，包含查询、筛选、详情、状态推进、证据查看和导出。
6. 推进闭环：提供 租户 的 推进闭环 页面能力，包含查询、筛选、详情、状态推进、证据查看和导出。
7. 详情：提供 租户 的 详情 页面能力，包含查询、筛选、详情、状态推进、证据查看和导出。

### 4.2 关键页面操作

1. 租户总览：需要在 PRD、API、埋点、CLI/MCP 中均有对应说明。
2. 合同与服务包：需要在 PRD、API、埋点、CLI/MCP 中均有对应说明。
3. 资源绑定：需要在 PRD、API、埋点、CLI/MCP 中均有对应说明。
4. 盒子交付：需要在 PRD、API、埋点、CLI/MCP 中均有对应说明。
5. SLA与账单：需要在 PRD、API、埋点、CLI/MCP 中均有对应说明。
6. 执行闭环动作：需要在 PRD、API、埋点、CLI/MCP 中均有对应说明。
7. 导出演示报表：需要在 PRD、API、埋点、CLI/MCP 中均有对应说明。
8. 导出交付包：需要在 PRD、API、埋点、CLI/MCP 中均有对应说明。

### 4.3 明确不做

- 不替代智航 CMDB 的主数据建模，只引用和回写必要业务关联状态。
- 不替代工作流引擎，只定义流程模板、触发参数和状态回写。
- 不替代报表平台，只定义指标口径、数据集和默认看板。
- 不替代盒子平台，只定义盒子在本模块中的采集、核验、离线和证据回传职责。

## 5. 核心业务对象

主业务对象：`tenant_record`。该对象必须贯穿 Demo 页面、Mock 数据、业务表、API、埋点和 CLI/MCP。

关键字段：`tenant_id`, `name`, `status`, `cmdb_resource_id`, `workflow_instance_id`, `box_id`, `created_at`, `updated_at`, `id`, `package`, `health`, `resource`

## 6. 状态机摘要

状态集合：`draft`, `active`, `pending_review`, `risk`, `disabled`, `archived`。每次状态变化必须写入状态流转表、操作日志表，并在存在流程动作时关联 `workflow_instance_id`。涉及现场验证的状态必须关联 `box_id` 或 `evidence_id`。

## 7. 体验与交互原则

- 驾驶舱优先呈现风险、待办、趋势、价值，不是简单列表。
- 列表默认按风险和待办优先级排序。
- 详情页必须同时展示业务字段、CMDB 关联、工作流进度、盒子证据和操作日志。
- 所有批量操作必须支持二次确认、失败明细和可追溯结果。
- 所有导出动作必须进入埋点和审计。

## 8. 技术方案摘要

- 前端：模块 Demo 当前以独立 HTML/CSS/JS 呈现；生产态建议纳入智航主门户微前端或低代码页面容器。
- 后端：新增本模块业务服务或商业化模块服务，不侵入 CMDB 核心表。
- 数据：新增模块业务表、明细表、状态表、证据表、配置表、埋点事实表。
- 集成：通过 CMDB API 读取资源/设备/空间/租户，通过工作流 API 发起审批/派工/验收，通过盒子 API 接收现场证据。
- 智能体：核心查询、创建、推进、导出能力必须提供 CLI 和 MCP Tool。

## 9. 验收标准

| 验收项 | 通过标准 |
| --- | --- |
| 功能完整性 | FEATURE_MAP 中的 P0/P1 功能在 Demo 或 PRD 中均有明确落点 |
| 页面一致性 | PAGE_REQUIREMENTS 的页面与 index.html 中的导航/按钮/卡片/列表一致 |
| 数据一致性 | FIELD_DICTIONARY、DB_TABLE_SPEC、MOCK_DATA.json 字段可映射 |
| 接口一致性 | API_SPEC 覆盖 GUI 和 CLI 的核心动作 |
| 埋点一致性 | TRACKING_PLAN 覆盖访问、筛选、详情、提交、状态推进、导出、错误 |
| CLI/智能体一致性 | CLI_AND_AGENT_SPEC 提供 JSON 输出、退出码和 MCP Tool Schema |
| 审计合规 | 所有状态变化、导出、批量操作、智能体调用均留痕 |

## 10. 生产级深审补充索引

- `BUSINESS_RULES.md`：业务规则、字段校验、Demo 动作规则和基座约束。
- `PERMISSION_AND_EXCEPTIONS.md`：角色权限矩阵、异常处理、智能体调用安全边界。
- `REPORTING_AND_ACCEPTANCE.md`：报表指标、测试用例、生产发布门槛。

## PRD.md 审计锚点

本文件 `PRD.md` 是本模块生产级主 PRD，其他功能地图、页面需求、状态机、字段字典、业务表、接口、埋点、CLI/MCP 和 Demo 对齐文档均从本文件索引。