# PHITE DOCUMENT SURFACE V1

> 状态：**CANONICAL — LOCKED**（`handbook.html` 已批准为 Golden Sample）
> 适用范围：Handbook 章节、SOP、操作手册、工程标准、技术规程、受控内部文档、长篇工程参考。
> 不适用于：工具面（登记表/采购/工作台）与控制面（项目控制/执行控制）。

---

## 01 · Surface Model · 三类表面

PHITE 界面分三类表面（P13）：

| 表面 | 环境 | 导航 | 实例 |
| --- | --- | --- | --- |
| **Tool Surface · 工具面** | Light | 图标活动栏 + 模块侧栏 | 工程文档登记表、采购工作台、EPC 项目工作台 |
| **Control Surface · 控制面** | Dark | 图标活动栏 + 控制侧栏 | 项目控制、执行控制 |
| **Document Surface · 文档面** | Light · Read | 无图标活动栏；文本目录 + 面包屑 + 搜索 | Handbook、SOP、手册、标准、规程 |

---

## 02 · Golden Sample Registration · 金样注册

- **文件**：`handbook.html`
- **内容**：PX-4200 · PET 化学回收装置 · 第 3 章《PET 化学回收工艺》
- **状态**：已批准为 **Document Surface 规范样本**。未来文档面以本样本为参照实现。

---

## 03 · Rule 1 — Full-width Shell, Constrained Reading Canvas

**Rule**：应用壳占据全部视口宽度；不对壳或主工作区施加居中的 max-width。结构为 `[TOC][MAIN FLEX]`；Main 内部使用单独受限的阅读画布。

```
[TOC 240px] [ MAIN — flex:1 ]
                 └── Reading Canvas — max 可读宽度，居中
```

- TOC 从壳左缘开始。
- Main 消耗全部剩余宽度。
- 阅读画布在 Main 内居中，行长刻意受限。
- TOC 折叠后 Main 回收全部宽度，阅读画布自动重新居中。

**Principle**：**壳宽与阅读宽是两个不同的关注点。** 导航属于壳，可读行长属于文档画布。

提取参考值（非全局 token）：

| 项 | 值 | 性质 |
| --- | --- | --- |
| TOC 宽 | 240px | 提取参考 |
| 阅读画布 max-width | 840px | 提取参考（可读行长） |
| 命令栏高 | 50px | 提取参考 |

---

## 04 · Rule 2 — Persistent TOC Controller

**Rule**：TOC/侧栏开关属于常驻命令栏，不属于可折叠 TOC 自身。

要求：

- 展开/收起两态均可见。
- 使用克制的标准「侧栏/目录」图标，非装饰图标。
- `aria-expanded` + `aria-controls`。
- 移动端覆盖层使用同一控制器。

**Principle**：**控制不得随其控制的表面一起消失。**

---

## 05 · Rule 3 — Document Surface Navigation

**Keep**：PHITE Logo、面包屑/上下文路径、常驻 TOC 控制、命令/搜索入口、文档状态、用户/头像、文本章节目录、安静的跨表面返回链接。

**Avoid**：工具面图标活动栏、模块图标导航、ERP 式模块切换。

跨表面导航（如「返回工作台」）必须保持视觉安静——文字链接或面包屑，不使用强调按钮或图标。

---

## 06 · Rule 4 — Document Hierarchy

文档面层级（自顶向下）：

1. 应用命令栏
2. 章节/导航 TOC
3. 受控文档元数据（标题栏）
4. 文档面包屑/上下文
5. 章节号
6. 章节标题
7. 导语/摘要
8. 阅读元数据（章节/页/修订/阅读时长）
9. 小节层级（H2/H3）
10. 工程注释（callout）
11. 技术表格 / 配置引用
12. 参考文献
13. 修订历史

文档元数据（文档号、修订、状态、专业、编制、校核、批准、密级）属于**文档系统**，不是通用页面 chrome。

---

## 07 · Rule 5 — Density Principle

文档面既不是营销页，也不是 ERP 工具屏。优化：

- 长时阅读
- 技术扫描
- 工程权威
- 受控文档可追溯
- 克制的层级
- 稳定的行长

避免：

- 仪表盘卡片
- 不必要的带边框容器
- 过多图标
- 活动栏
- 装饰性渐变
- 过大的 SaaS 式标题
- 通用营销页构图

---

## 08 · Reusable Tokens / Layout Rules

只提取稳定项，其余局部测量不全局化：

- 壳：`width:100%`；`grid-template-columns:240px 1fr`（折叠 `0 1fr`）。
- 阅读画布：`max-width:840px; margin:0 auto`。
- 命令栏：`height:50px`；`position:sticky`。
- TOC 开关：32px 方形，`aria-expanded`/`aria-controls`。

> 字号、行高、边距、callout 内边距等仍为局部实现，待未来正式 token 化时再议。

---

## 09 · Conflict Check · 冲突检查

- 与 P13（表面分工）一致；P13 已更新为三类表面。
- 与 P3（Light Means Work）、P10（层级先于容器）、P1（精准先于装饰）一致。
- 与 D-022/D-023 一致。
- **无冲突**。