# 界面原型总览（00-overview）

> 配套《售后问题闭环系统 · 建设规格书 V0.2》《技术设计稿 V0.1》。
> 本目录 = 界面原型（HTML）+ 开发规格（MD，本文件所在目录）。

## 阅读约定（重要）

| 载体 | 作用 | 冲突时以谁为准 |
|---|---|---|
| `pages/*.html` | 视觉与布局基准：结构、层级、密度、状态色 | — |
| `md/*.md` | 行为契约：字段来源、校验、接口、权限、边界 | **MD 为准**，并回改 HTML |
| 规格书 V0.2 | 业务规则唯一真相（状态机/时限/校验/矩阵） | **规格书为准** |

## 页面清单

| 页面 | 文件 | 角色视角 | 里程碑 |
|---|---|---|---|
| 登录 | `login.html` | — | M0 |
| 我的待办 HUB | `hub.html` | 售后经理 | M2（骨架 M0） |
| 问题单列表 | `issues.html` | 售后文员 | M1 |
| 新建问题单 | `issue-new.html` | 售后文员 | M1 |
| 问题单详情 | `issue-detail.html` | 售后经理 | M1（关闭/挂起 M1，落地物区 M2） |
| ECN 变更单 | `ecn.html` | 技术（整改负责人） | M3（M2 出只读版） |
| 停滞看板 | `board.html` | 总经理 | M3 |
| 月度复盘 | `report.html` | 总经理 | M3 |
| 设备档案 | `archive.html` | 售后文员 | M1 |
| **知识库** | `knowledge.html` | 质量（知识管理员） | M2 |
| **智能体中心** | `agents.html` | 售后经理 | M2 |
| **企微消息预览** | `wecom.html` | 评审展示页 | M2（推送上线） |
| **整体系统架构** | `architecture.html` | 评审展示页 | 持续维护 |

4D／TIP／PCR／售后工单等其余落地物表单页与 ECN 页同构（表头＋状态步进＋子表＋校验清单），ECN 页确认后批量套用，不再单独出原型。

## AI 辅助约定（v1.1 起）

- 智能体矩阵与边界见 `ai-agents.md`（**七个智能体**：跟踪哨兵/受理助理/维修顾问/质量分析/变更协调/知识管理员/运营摘要；每个含技能/工具/记忆三要素）。
- 界面四形态：全局 AI 助手抽屉（每页右下角，回答带 ⚡技能/🔧工具/🧠记忆 标注）、就地「✦」区块、知识引用、**智能体中心页＋断点雷达（V1.3）**。
- 铁律：**AI 只做查询、提取、草稿、建议、触达；定级、签批、关闭、降级、锁定永远由人执行**。时限与闸门（A1–A15）由确定性规则引擎负责，AI 不参与判定。
- 交互：左侧菜单可收缩（☰，状态记忆）。
- **V1.3 更名**：系统名调整为「TIGO 售后多智能体闭环平台」，突出多智能体平台定位；业务规则文档（规格书）标题暂不变。

## 视觉约定

- 色系与送审文档一致：主色蓝 `#185fa5`；P0 红 / P1 琥珀 / P2 灰；成功绿；派生/只读统一灰底＋🔒 标记。
- 顶栏深蓝 `#22303f`；左侧菜单 212px；内容区卡片化，圆角 10px。
- 全部原型页顶栏带「示意数据」黄标，正式版移除。

## 到正式开发的映射

- 原型 1:1 对应 tigo-loop 业务后台的前端模块（工作台 `pages/loop/*`），API 前缀 `/api/loop/*`（工作台反代签名）。
- 每页 MD 内的「接口草案」路径即开发落点；字段表直连 S1–S11 表结构。
- 移动端（企微内 H5）M2 起适配，优先 HUB 与通知落地页；本批原型为桌面版。