# 目标件约定 —— 设计答案怎么交,平移才接得住

目标件是**带脚本演示页**(照仓里 PRD 方法论):第一身份是给人看、给人认可的设计答案,
第二身份是活动开发者平移的底稿。权威契约在 `docs/HTML报告生成规范.md`,本文只讲
目标件这一侧的交付约定。

## 1. 平移边界(骨架已标好)

| 段 | 平移时 |
|---|---|
| doctype / head / 包装层 CSS(`⇩ standalone 包装层` 标记段) | 丢弃 |
| PRD_CSS / BIND_CSS(assemble.py 抽来的) | 丢弃 —— 真模版从活动自己的 `views/` import |
| ONE_CSS(本件自有补丁段) | **随模版走**,补在 BIND_CSS 之后;纪律与 BIND_CSS 同:只补不改 |
| `⇩⇩ 模版片段` 到 `⇧⇧` 之间的标记 | 就是要平移的正文 |
| 所有 `<script>` 标签 | **整段剥掉**(所以演示行为别写成内联 `on*=`,散在标记里剥不净) |
| 尾部「平移指引」注释 | 给活动开发者读,不平移 |

`<html class="editable">` 是给编辑态样式(闸/红带)显形用的;生产里由宿主挂,不进模版。

## 2. 演示脚本的三条规矩

1. **集中**:全部写在文尾的 `<script>` 标签里,标记面零内联事件(check.py 会拦);
2. **初始画面自足**:脚本删掉后页面内容仍然完整正确 —— 脚本只做演示交互
   (开编辑、改数重算、切状态),不负责造内容;
3. **不引外部**:无 CDN、无外链(check.py 会拦)。

## 3. 设计上行与建模欠账

版面服务业务,不服务现有台账:来源标签、档位、命中留痕、数轴 —— 业务需要就摆,
数字按人读形态(9.2% 不是 0.092)。代价是一笔账要记清:**平移指引的「建模欠账」清单**,
逐条点名本件摆了、现有台账还没有的列与口径(该加哪张表哪一列、哪些该 required、
存储口径要不要改人读形态)。欠账不记,平移的人分不清哪些是真数据哪些是设计愿望。

能映射现有台账的格子,顺手预埋真钩子(`data-slot`/`data-col`/`data-edit`,键名逐字抄
目标活动 `manifest.ts` 的 `declarations.ledger`)—— 省平移的事,但不为它牺牲版面。

## 4. 示例数据真实感

- PN 像 PN(`SS8050`、`TL072CDR`),价格量级对(阻容几分几毛、IC 几块几十),
  年用量千/万级;业务素材见 `docs/MVP示例工作流.html`;
- 人名/公司名用中文;报告上不摆系统内英文名(状态/表/列/口),表头一律人读名;
- 演示的数自己要对得上账(偏离度 = (拟报−基准)÷基准 这类,逐行可复算);
- 不编造没有来源的数据画面:真系统里没有写入方的数据,如实空着并写明为什么。

## 5. 自检与走查

- `python3 scripts/check.py 目标件.html` 13 条底线全绿(它不判设计);
- 浏览器走查:整页读一遍(版面像不像家族、信息层次立不立得住)→ 点一遍演示交互
  (编辑开不开、改数重算对不对)→ 拉窄窗口看响应式 → 尾部平移指引读一遍
  (欠账清单是否把编的列全点到了)。