feat: 增加宁德时代的图表
This commit is contained in:
R524809
@@ -29,6 +29,41 @@ pnpm test # 全量，只在改了 t
|
||||
|
||||
它会断言 `legend.top`、`grid.top`、折线 `symbolSize`/`borderWidth`，并检查 SVG 字体引号。回归测试直接遍历 `manifest.json` 的 `chartCatalog`，新增图只要完成 registry 与 manifest 登记就会被测到。
|
||||
|
||||
**带参数的图要另外跑参数测试。** 通用回归永远按默认值渲染，跑不到手输参数那条路径：
|
||||
|
||||
```bash
|
||||
pnpm test:param # 甜蜜击球区「现价」参数：标线位置 + 插值结果（两家公司 6 张图）
|
||||
```
|
||||
|
||||
**手输参数的图还要量几何、而且必须扫全价位。** 参数测试只查数值对不对，查不出「标签撞在一起」；而碰撞窗口常常只有几个价位宽 —— 甜蜜击球区实测：现价贴数据区下沿时顶部标注会撞左上角的区域带标签（宁德只有 220–240 会撞，抽查 310/400/700 全绿），现价落进关键价位旁一个数据格时两个数据标签会叠（宁德只在 265±20、腾讯只在 404.5±17）：
|
||||
|
||||
```bash
|
||||
cp ~/.workbuddy/skills/smart-fin-chart-add-chart/scripts/geometry_check.mjs tmp_geometry.mjs
|
||||
node tmp_geometry.mjs --sweep sweet-tencent-price-ev sweet-catl-any-price # 全价位扫描
|
||||
node tmp_geometry.mjs --w=940 sweet-tencent-price-ev # 换画布宽度
|
||||
rm tmp_geometry.mjs
|
||||
```
|
||||
|
||||
## 图表参数（tab 级控件）
|
||||
|
||||
可手输的参数在 `manifest.json` 的 **tab** 上声明，不是在卡片上 —— 同一 tab 里的图共用一套口径（现价对三张击球区图是同一个事实），卡片级会变成三个各说各话的输入框：
|
||||
|
||||
```json
|
||||
"tabs": [{ "id": "catl", "name": "宁德时代",
|
||||
"controls": [{ "id": "price", "type": "number", "label": "现价", "unit": "元",
|
||||
"value": 316.21, "min": 220, "max": 700, "step": 1 }],
|
||||
"chartRefs": ["..."] }]
|
||||
```
|
||||
|
||||
- 链路：`renderTabControls`（ui.js，纯 DOM）→ `applyTabParam`（main.js，校验 + 防抖）→ `refreshChartParams`（复用实例 `setOption`，不 dispose 重建）→ 图表 builder 的第三个参数 `params`。
|
||||
- **位置**：`shell.params` 是页面里独立的一行，钉在 tab 栏正下方，与 tab 栏同处一个 sticky 容器 `.tab-header`（两行各自 sticky 就得给参数行算「tab 栏高度」的偏移，而 tab 栏会换行、窄屏还横向滚动，高度不固定）。没有 `controls` 的 tab 由 JS 置 `hidden`，整行含虚线分隔一并消失。改动这里要连带核对 `.card` 的 `scroll-margin-top`（桌面 128px / ≤880px 160px，= 页头底边 + 18px 呼吸）。
|
||||
- builder 签名写成 `(rows, { width, height, params })`，取值用 `resolvePrice(params)` 之类带兜底的解析函数：**没有 params 时必须回落到默认值**，否则 SSR 回归测试与脚本会拿到 NaN。
|
||||
- **可输区间 = 数据区，不是坐标轴**：手输值靠相邻行线性插值取值，落在数据区外只能得到 NaN。轴可以比数据区宽一点（留白），输入区间不行。
|
||||
- 手输值通常不是数据行，所以那些「只标关键价位」的 `labeledPrices` 要按数据行命中与否决定是否带上它，并做避让（见 `sweet_spot.js` 的 `refLabels`）：现价与某个关键价位落在**同一个数据格**内时只留现价 —— 两个标签数值几乎相同、包围盒会实打实叠在一起。阈值取数据格步长（20）而不是现算像素，因为标签宽约 43px、每元约 1.8px，像素阈值会随轴范围漂。
|
||||
- **「现价」这类跟随输入变化的 graphic 标注要画在绘图区上方那条留白带里**（`top: LAYOUT.gridTop - 30`），不要贴绘图区顶边（`gridTop + 4`）：贴边时它和绘图区顶行的文字抢位置，手输值落在低价端必然相撞（宁德 220 元时与「卖出区 >30x」重叠 35×8px）。画在外面只剩居中的图例在它上方，永不相交，顺带消除了「换个价、标注就上下跳」。
|
||||
- **纵轴下限要给「区域带名字」那一条留位置。** 纵向区域带的名字画在绘图区底边上方 12–25px，若数据线能压到接近下限，线标签就会和带名字重叠（宁德图 3 的「仅价差年化」在 700 元处跌到 -4.7%，轴下限 -10 只留 5.3pp 余量，手输 680 元时「-3.8%」压住「卖出区」22×7px）。改轴下限比挪标签便宜：图 3 的纵轴两家现在都是 -20 起。
|
||||
- 默认值的同源方要写在注释里。现价这套：`sweet_spot.js` 的 `profile.priceDefault`、manifest 的 `controls[].value`、`build_sweet_spot_catl.py` / `build_sweet_spot_tencent.py` 三处一起改。
|
||||
|
||||
**右侧纵向图例的图会报 `legend.top=middle (期望85)`，这是预期的，不要去"修"。** 那条断言的 85px 基准是给顶部横向图例定的，对 `orient: 'vertical'` + `top: 'middle'` 的图不适用（`ppmt_ip_share`、`ppmt_ip_share_history` 都会报）。
|
||||
|
||||
## 踩过的坑
|
||||
@@ -61,6 +96,25 @@ pnpm test # 全量，只在改了 t
|
||||
|
||||
**桥图/瀑布图要验算闭合。** 各项占营收比是税前口径，加总到净利率前须乘税盾 `(1 - 有效税率)`；税率变化单独成项。恒等式 `净利率 = 税前利润率 × (1-税率)`，分解为 `Δ净 = Δ税前×(1-t₁) − 税前₂×Δt`。改完核对首尾误差应 < 0.05pct。
|
||||
|
||||
## 甜蜜击球区板块（股价 ↔ 估值）
|
||||
|
||||
菜单 id `sweet-spot`，两个 tab（`catl` 宁德时代 / `tencent` 腾讯控股），各三张图，**共用一套通用 builder**：
|
||||
|
||||
| | 宁德时代 | 腾讯控股 |
|
||||
| --- | --- | --- |
|
||||
| 纵轴口径 | `PE = 市值 ÷ 2026E 归母净利` | `EV/EBIT =（市值 − 非经营资产）÷ TTM EBIT` |
|
||||
| 扣什么 | 类现金 2,263.8 亿（纯现金，准现金） | 净现金 581.9 + 上市投资 4,872.0 + 非上市投资 387.9 = 5,841.8 亿（股权，会波动） |
|
||||
| 甜蜜区锚 | 13 / 15.5 / 25 / 30x（资料库原表五档） | 8 / 10 / 12x（巴菲特原始锚，白送 / 甜点 / 上沿） |
|
||||
| 数据区 / 输入区 | 220–700 元 | 240–640 港元 |
|
||||
| 默认现价 | 316.21 元（2026-09-15） | 426.8 港元（2026-09-17） |
|
||||
|
||||
**两家的口径差异不是随意选的**：宁德的类现金是现金，扣掉不改变分子的性质，PE 口径成立；腾讯的「类现金」主体是 5,260 亿投资组合（股权会波动），只扣净现金 581.9 亿几乎不改变倍数（少 0.23x），必须连投资组合一起扣才是经营资产的真实价格 —— 图 2 的三层线（不扣 / 只扣净现金 / 全扣）就是为把「漏扣投资组合会得出超上沿的假阴性」这件事画出来。
|
||||
|
||||
- 代码结构：`js/charts/sweet_spot.js` 里 `PROFILES = { catl, tencent }` 两个配置块 + 三个通用 builder（`buildMultipleChart` / `buildAssetTierChart` / `buildAnyPriceChart`），导出 6 个图表函数。**加第三家公司不要复制粘贴 builder**，照着配置块的字段补齐即可。
|
||||
- CSV 由 `scripts/build_sweet_spot_catl.py` / `build_sweet_spot_tencent.py` 生成，禁止手工编辑。改股本、汇率、利润预期 → 改脚本常量 → 重跑 → 图表自动跟着走（区域边界是从 CSV 反解的，没写死）。
|
||||
- 区域边界的**股价**必须从数据反解（`multToPrice`），缺席的阈值**留 `null` 占位不要 filter 掉**，否则后面档位整体前移一格（表现为「偏贵」色带铺到轴右端、最贵那档退化成零宽，且不报错）。
|
||||
- 验证：`node test/sweet_spot_param.mjs`（42 项，独立复算公式）+ `geometry_check.mjs --sweep`（全价位量几何）。
|
||||
|
||||
## 配色
|
||||
|
||||
**正式方向：轻快消费。** 柱线组合图的现金流、利润与同比使用 `FINANCIAL_COLORS`，渠道结构使用 `CHANNEL_COLORS`，瀑布图使用 `BRIDGE_COLORS`（蓝色基准、青绿色正向、珊瑚红负向）；不要在图表文件里为相同财务/渠道语义重写十六进制颜色。柱状系列负责分类，折线只保留一条高辨识度强调色。
|
||||
|
||||
Reference in New Issue
Block a user