# PHITE OPERATIONAL RECORDS V1

> **CANONICAL — LOCKED · DS: V1.0 · 决策依据: D-032 / D-031**
> 状态：**CANONICAL — LOCKED**（D-032）
> V1.0 Foundation Freeze 阻塞关闭时由 Owner 授权创建。这是**归一化规范**，仅提取已实现并验证的既有语法（来自 Project Workspace 金样 / 各金样 / 存活的 Name/Time/Status 原则 / Operational Spacing & Record Rhythm），**非新设计**。
> 已归档的 `phite-operational-grammar.md`（含被拒的 Delivery Spine V2 / 目标刻度 / 偏差 / 十字）**不得**作为本规范依据。

---

## 01 · Purpose · 目的

运营记录（待办行动、重大对象、异常、决策、里程碑、风险、状态行、活动行……）是 PHITE 工具面与控制面的工作单元。本规范定义其**共享语法与间距节奏**，使不同对象的记录在语义上同构、在扫描时一致、在语义上可被 AI 智能体复现。**不是每个记录都需要每个分组**；只呈现记录当前所需的信息。

---

## 02 · Record Anatomy · 记录解剖

一条运营记录由若干**可选分组**组成，自上而下遵循固定次序。各分组**可省略**，但一旦出现，其相对顺序与语义不变。

```
[Identity]  ID（mono，强）
                  [Name / Title]  标题（强，比例字体）
                  [Context / Classification]  sub 行 / 独立 mono 字段
[Owner / Authority]  负责人 / 编制 / 批准（文字）
[Time]              时间（mono，中性次级）
[State]             信号点 + 文字（chip 仅在需要容器时）
[Exception]         例外（文字 + 形状 + 颜色）
[Next Action]       下一动作（安静 mono 文本链接，右对齐）
```

| 分组 | 定义 | 排版 | 典型内容 |
| --- | --- | --- | --- |
| Identity | 唯一对象代码，优先展示 | JetBrains Mono · 强色 | `AX-014`、`PX-4200-PO-8841`、`M-06` |
| Name / Title | 人类可读名称 | Archivo / Noto Sans · 强 | 「签发 R-201 总装图 REV D」 |
| Context / Classification | 对象类型 / 专业 / 类别（独立字段） | sub 行 mono 或独立字段 | 设备 / 采购 / 工艺；`李伟 · 设备` |
| Owner / Authority | 归属 / 编制 / 批准 | 文字（中性） | 李伟 / 潘飞 / 徐祥东 |
| Time | 计划 / 到期 / 实际 / 更新 | mono · 中性次级 | `2026-08-12`、`08-20` |
| State | 当前条件 | 信号点 + 文字 | 进行中 / 已批准 / 编制中 |
| Exception | 需关注 / 例外 | 文字 + 形状 + 颜色 | 逾期 / 延误 / 高风险 / 需决策 |
| Next Action | 下一步动作 | 安静 mono 文本链接 · 右对齐 | 打开 / 催办 / 批准 |

### 2.1 Name vs Classification · 名称与分类分离

名称（Name/Title）与分类（Classification）是**两个语义字段**。它们可以视觉相邻（如 `sub` 行置于标题下），但**不得拼接成同一字段的重复字符串**。

> 禁止：`终缩聚反应器 反应器` 式重复。
> 正确：标题 `终缩聚反应器 R-201`（Title）+ 分类 `设备 · 静设备`（Classification）作为独立 sub 行。

### 2.2 Not every record requires every group

- 简单待办：Identity + Name + Owner + Time + State。
- 高风险对象：Identity + Name + Exception + Owner + Next Action。
- 状态行：Name + State（当前实时）。
- 省略不该省略的例外：当记录「需要关注」时，Exception 分组不得缺失。

---

## 03 · Semantic Grouping · 间距分组（三阶间距）

间距本身是语义信号。三阶间距规则：

| 层级 | 名称 | 作用 | 实现（参考，非全局 token） |
| --- | --- | --- | --- |
| **Micro spacing · 微间距** | 同一语义分组内 | ID 与标题、文字与形  8px | 4–8px（分组内部） |
| **Semantic spacing · 语义间距** | 不同信息分组间 | 记录内 Owner/Time/State 之间的层级与关联 | 8–16px |
| **Structural spacing · 结构间距** | 记录 / 区块之间 | 分隔不同对象，建立可扫描节奏 | 16px+ 或 发丝线 + 段距（结构性） |

### 3.1 规范原则

1. **Controlled Density ≠ Compression**：密度是正当的（宪法 P5「Density Is Legitimate」），但不得以压缩替代层级。
2. **Spacing communicates semantic grouping**：间距必须让用户「看出」哪些信息属于同一分组、哪些是新的记录/区块——靠间距与发丝线，不靠容器。
3. 优先级：先靠间距 / 对齐 / 目录结构，其次才引入分隔与容器（宪法 P10「Hierarchy Before Containers」）。

---

## 04 · Time · 时间语言

- 时间**默认是次级元数据**（mono、中性次级、右对齐或靠近 Owner）。
- 时间表达集：`创建 / 更新 / 计划 / 要求 / 到期 / 预测 / 实际 / 发布 / 完成 / 逾期`。所有页面共用同一套中性次级时间样式，不得每页发明各自日期风格。
- **例外（Severity-bearing）**：当「时间本身是问题」时，时间参与例外表达——如逾期日期变红并带文本 `· 逾期 N`（`2026-08-30 · 逾期`）。此时时间不再中性，而是承载 Severity（与状态五轴 Severity 轴一致）。
- 正常时间保持中性；仅逾期/滞留的时间才上色。

---

## 05 · Status · 状态表达

- **不默认「每个状态 = 圆角彩色 pill」**。容器（chip/badge）只在「状态是主要筛选/扫描对象」且需要强含界时才使用。
- 默认顺序：**纯文字 + 信号点**（密集表，最克制）→ 信号点（证据链）→ chip（状态需强扫描时）→ 生命周期标记 → 严重度标记 → 权威指示。
- 状态语义来自状态五轴（D-010，`phite-system.md` §11）：State（条件）用文字 + 点，Severity（严重度）用文字 + 形状 + 颜色，Activity（当前/选中）用青。
- **容器必须有语义目的**；若层级可仅靠排版/间距/点+文字建立，就不加 pill。

---

## 06 · Exception & Attention · 例外与关注

- 例外（逾期 / 延误 / 风险 / 阻塞 / 关键 / 缺证据 / 待审批）是**须被立即看到**的信息。
- **关键工程含义不得只靠颜色**：必须文字 + 形状（点/标记/位置）+ 颜色（宪法 P12、无障碍 §14、状态五轴 Severity）。
- 例外表达保持克制，不破坏整体信息层级：优先用**行内例外标记 + 文字**，比给整行上主色更少干扰（见 §07 Row State）。

---

## 07 · Row State · 行状态

| 行状态 | 处理 | 依据 |
| --- | --- | --- |
| Default | 无额外样式 | — |
| Hover | 背景 = Surface-2（浅）/ 高层面（深） | 中性 |
| **Selected** | **青左条 + Surface 背景**（可选批量计数文字）；可含 Activity/当前（P2 允许 Selected 用青） | D-005 / P2 |
| **Attention** | **局部表达**：在相关单元格/列内用例外标记（文字+形状+颜色），**而非整行染色** | §06 / P10 |
| Disabled | 低对比中性（唯一允许降低对比的状态） | 无障碍 §14 |
| Completed | 信号点转绿（记录级），文字不弱化 | 状态五轴 |

> Selected 属于 P2（Current/Active/Selected 可用青）；Attention 不默认整行染色——局部表达更克制且不破坏密度（宪法 P5/P10）。

---

## 08 · Reference · 规范依据与关联

- 宪法：P2（青）/ P5（密度合法）/ P6（对象解剖）/ P10（层级先于容器）/ P12（AI 可复现）。
- 决策：D-010（状态五轴）、D-005（青语义）、D-032（本规范）。
- 状态 / 无障碍 / 记录分组扩展见 `phite-system.md` §11/§14。
- 已实现的运营记录金样：`project-workspace.html`（待办行动 / 里程碑）、`procurement-workspace.html`、`document-register.html`、`equipment-register.html`。
- 记录级生命周期链（Equipment/Procurement）与里程碑语法：沿用金样实现，本规范暂不新增对象化图案（V1 冻结范围内只归一化既有语法）。

---

_本规范为 V1.0 Foundation Freeze 阻塞关闭产物；不引入新视觉或新对象模式。_
