docs: add maintainable PPMT financial workbook

CLAUDE.md

@@ -45,6 +45,10 @@ pnpm test                                              # 全量，只在改了 t
 
 ## 数据口径
 
+**底稿与图表数据分层。** `data/{company}/rawData/` 是唯一可维护的数据层。当前泡泡玛特的维护入口是其中的 `泡泡玛特_财报分析底稿.xlsx`：人工或 AI 从 PDF、截图、XLSX 提取的基础值先写入这份底稿，并保留来源文件、工作表和定位信息。`data/{company}/*.csv` 是图表运行时投影，只能由脚本生成，禁止手工编辑。
+
+**维护明细，不维护可推导结果。** 收入、门店数、财报科目等基础值应保存；占比、同比、利润率、H2 单半年和分析分类小计应由脚本生成。若财报披露了占比，可作为核对值保留，但不是图表的唯一输入。资产负债表的“类现金/经营类资产/有息负债”等分类以独立规则映射明细科目，不复制成第二套人工数字。
+
 **数值默认保留一位小数。** CSV 数据列与图表展示（柱/点标签、tooltip）统一保留一位小数（如 `71.1`、`311.4%`），四舍五入；确实需要其他精度时必须在 `footnote()` 或代码注释里说明原因。
 
 **CSV 存四位年份**（`2026H1`），简写只在显示层做。核对数据时无歧义。

data/ppmt/rawData/README.md

@@ -0,0 +1,22 @@
+# 泡泡玛特财报分析底稿
+
+本目录是泡泡玛特的唯一维护数据层。日常只维护 [泡泡玛特_财报分析底稿.xlsx](泡泡玛特_财报分析底稿.xlsx)：图表使用的 `data/ppmt/*.csv` 由脚本生成，不直接编辑。
+
+## 工作簿结构
+
+- `说明`：维护入口、口径和颜色约定。
+- `资产负债表`：期末时点的财报明细。
+- `利润表`：半年累计与全年累计的财报明细。
+- `现金流量表`：现金流量表披露的原始明细。
+- `资产分类规则`：把财报明细映射为“类现金、投资资产、有息负债”等分析分类的规则；不维护分类金额。
+- `检查`：资产负债、现金流量的勾稽差额。出现红色警告时，应回到来源核对，不能为了消除警告而改数。
+
+## 更新流程
+
+1. 将新财报 PDF、截图或原始表格保留在 `data/ppmt/raw/`，作为证据文件。
+2. 由 AI 读取证据后，将直接披露的科目、期间和金额录入本工作簿的蓝色数字区域，并记录来源定位。
+3. 检查期间、单位和勾稽关系；确认后再生成图表 CSV 与图表。
+
+只维护基础值：收入、门店数、财报科目等。同比、占比、利润率、H2 单半年和分析分类小计都由后续脚本计算。若财报另有披露占比，可作为核对依据，不应成为第二套手工维护的数据。
+
+期间约定：`FY` 是全年累计/年末，`H1` 是上半年累计/六月末；不得把来源的 `H2` 直接当作下半年单期。金额单位为人民币亿元。

docs/方案设计.md

@@ -23,10 +23,13 @@
 ## 2. 当前架构
 
 ```
-原始财报 / PDF / XLSX（仓库外保存）
+原始财报 / PDF / XLSX / 截图（证据文件）
-   │ 人工、AI 或脚本：抽取、归一化、口径确认
+   │ 人工或 AI 提取、复核并记录来源定位
    ▼
-data/{company}/*.csv                 ← 运行时数据
+data/{company}/rawData/财报分析底稿.xlsx ← 财报分析底稿：唯一可维护的数据层
+   │ 脚本：分类、同比/占比、年度/半年视图、勾稽
+   ▼
+data/{company}/*.csv                  ← 图表运行时数据，可随时重建，禁止手工编辑
    ▼
 manifest.json                        ← 展示编排与图表配置的唯一事实来源
    ├─ chartCatalog                   ← 每张图只定义一次
@@ -69,7 +72,8 @@ js/main.js + js/ui.js                ← 解析引用、渲染三栏、导出和
 - `js/charts/index.js`：注册 `key → build 函数`。
 - `js/charts/*.js`：只处理该图的业务字段与 ECharts 表达。
 - `js/theme.js`：字体、配色、图例、坐标轴、脚注和水印等统一视觉规范。
-- `data/{company}/`：图表需要的规范化 CSV。
+- `data/{company}/rawData/`：财报分析底稿。每家公司以一份可读、可维护的工作簿作为入口；基础科目、期间、单位、来源文件/工作表/定位信息在此维护，分析分类通过独立规则映射，不复制维护分类金额。
+- `data/{company}/*.csv`：图表需要的规范化 CSV，由底稿生成，不是维护入口。
 
 ---