R524809财报图表 · Joey 谨制
基于 ECharts 5.5 的财报数据可视化项目，采用“Joey 风格”。
修改 CSV 数据，刷新页面即可更新图表；每张图表都可独立导出为高清 PNG。
快速开始
首次使用时，在项目根目录安装依赖：
pnpm install
1. 启动开发服务器（支持热更新）
# 方案 A：Vite 开发服务器
pnpm dev
# 方案 B：直接双击项目根目录的 `.start.command`
# 脚本会启动 Vite 并自动打开浏览器
2. 打开浏览器
访问 http://localhost:8899。页面左侧选择公司，中间用 Tab 切换分析维度，右侧可跳转到当前分类的图表。
修改 js/ 或 css/ 后页面会热更新；修改 manifest.json 或 data/**/*.csv 后页面会自动整页刷新。
需要生成静态发布文件时：
pnpm build
pnpm preview
构建结果位于 dist/，其中包含运行所需的 manifest 与 CSV，不包含 data/ppmt/raw/ 中的原始 PDF/XLSX。
当前 manifest 内登记了 5 张示例图表和 22 张泡泡玛特财报图表：
示例图表：
- 存货、营收与存货周转天数 — 双柱 + 折线，双 Y 轴
- 利润率与费用率拆解 — 四条率线对比
- 毛利率与非国际净利率 — 两条主要率线
- 营收到利润的增速对比 — 四条增速线
- 人民币汇率两种口径 — 中间价 vs 在岸即期，带说明卡片
泡泡玛特财报分析： 6. 资产结构演变 — 堆叠柱状图展示类现金、应收账款、投资、经营资产 7. 盈利能力分析 — 营收、毛利、净利润及毛利率变化 8. 主要 IP 收入趋势 — 多条折线展示 MOLLY、SKULLPANDA、CRYBABY 等 IP 表现 9. 品类收入结构 — 毛绒、手办、MEGA、衍生品的占比和增长 10. 利润流向（2026H1） — 桑基图，营收拆到成本、费用、净利 11. 区域渠道同比增速 — 分区域 × 渠道的增速对比 12. 营收到利润的增速对比 — 泡泡玛特口径 13. 利润率与费用率拆解 — 毛利率、销售/管理费用率、非 GAAP 净利率 14. 净利率同比拆解 — 瀑布图，含税盾换算与税率单列项 15. 核心利润及同比增速 — 柱 + 折线 16. 核心利润率 — 毛利率 − 销售费用率 − 管理费用率 17. 主要 IP 收入占比（2026H1） — 饼图，右侧图例带收入与占比 18. 各 IP 半年收入占比（21H1-26H1） — 归一化堆叠柱状图，看收入结构变迁 19. 除 THE MONSTERS 外的 IP 收入及同比 — 柱 + 折线双轴，剔掉爆款看其余盘子 20. 区域渠道分布（2026H1） — 左右堆叠条形图，对比各区域线上与线下渠道收入 21. 区域渠道同比增速趋势 — 热力图查看区域 × 渠道的历史同比变化
3. 修改数据
编辑对应公司的 CSV，保存后点击页面右上角的 「重新加载数据」 按钮。数据目录按公司划分，例如 data/ppmt/ppmt_profit.csv、data/demo/inventory.csv。
CSV 格式：首行是表头，逗号分隔，数字列会自动转换。示例：
period,inventory,revenue,turnover_days
22H1,9.6,23.6,160
22年,8.7,46.2,154
4. 导出图表
每张图表右上角都有 「导出 PNG」 按钮，点击即可下载 2 倍分辨率的图片（适合微信公众号等场景）。
项目结构
smart-fin-chart/
├── index.html # 主页面
├── manifest.json # 公司、Tab、图表、CSV 的唯一配置来源
├── data/ # 数据文件（按公司划分）
│ ├── demo/
│ └── ppmt/
│ └── raw/ # 用户提供的原始 xlsx / PDF
├── js/
│ ├── main.js # 入口：读取 manifest、渲染、导出 PNG
│ ├── ui.js # 三栏 UI 构建
│ ├── csv.js # CSV 解析工具
│ ├── theme.js # 主题：配色、字体、水印、共享系列构造器
│ └── charts/ # 图表构建函数与 registry
├── test/
│ └── regress.mjs # 回归测试：遍历 manifest + 样式规范断言
└── css/
└── style.css # 页面样式
测试
pnpm test
用 ECharts 的 SSR 模式遍历 manifest 中的图表并渲染成 SVG，断言：
legend.top= 85、grid.top= 145（统一间距）- 折线
symbolSize= 9、borderWidth= 2.5（空心圆点规范） - SVG 属性未被字体名里的引号提前闭合
回归测试会遍历 manifest.json，不用再手工维护图表清单。
设计原则
统一的视觉语言
所有图表共用 js/theme.js 的配色、字体、坐标轴样式，确保视觉一致性：
- 配色：低饱和莫兰迪系（棕色、沙色、珊瑚红、海军蓝等）
- 字体：苹方 / 微软雅黑，中文友好
- 坐标轴：只留浅灰网格线，去掉轴线的存在感
- 水印：全画布平铺"Joey 谨制"，旋转 20°，透明度 0.10
数据标签全标注
每个数据点都显示标签，避免读者"猜数值"。密集时上下交错放置（见图 2），不用 hover tooltip 替代。
底部注释
重要的计算口径、数据来源写在图表底部（用 graphic.text），不依赖外部文档。
常见问题
Q：为什么必须用本地服务器，不能直接双击 index.html？
A：浏览器的同源策略禁止 file:// 协议读取 CSV，会报 CORS 错误。启动服务器后用 http:// 访问即可。
Q：修改 CSV 后刷新页面，图表没变化？
A：点击页面右上角的 「重新加载数据」 按钮。普通刷新可能吃到浏览器缓存，按钮会加时间戳绕过缓存。
Q：如何添加新图表？
A：
- 在
data/下创建新 CSV - 在
js/charts/下创建新.js，从theme.js取共享配置（lineSeries()、barSeries()、standardLegend()、periodAxis），不要手写等价值 - 在
js/charts/index.js注册 chart key - 在
manifest.json对应公司的chartCatalog中登记图表配置，再在需要展示的 Tab 的chartRefs中引用它；概览可直接引用同一图表 ID，无需复制配置 - 跑
node test/regress.mjs <chart-id>；浏览器检查标签、颜色和脚注
Q：能改水印文字吗？
A：编辑 js/theme.js 的 WATERMARK_TEXT 常量。
Q：能改配色吗？
A：编辑 js/theme.js 的 PALETTE 对象，所有图表自动同步。
技术细节
- ECharts 5.5.1：从 jsDelivr CDN 加载，无需额外安装 ECharts
- ES6 Modules：用原生
<script type="module">，无构建步骤 - Canvas 渲染：页面用 canvas（性能好），导出时用 ECharts 自带的
getDataURL生成 PNG - 响应式：window resize 时重绘（水印数量跟着画布尺寸变化）
许可
本项目代码采用 MIT 协议，数据仅供示例。