项目结构

apps/web                 React + Vite 前端
apps/docs                Docusaurus 文档站
apps/api                 Cloudflare Worker API
packages/shared-types    API DTO 与共享类型
packages/api-client      typed fetch client
libs/d1-schema           D1 / SQLite 迁移
libs/d1-repository       D1 查询仓库
libs/d1-writer           写入契约说明
libs/object-store        对象存储契约说明
libs/tenhou-core         天凤领域契约说明
services/pipeline        Python 发现、解析、写入、聚合流水线
tests                    dependency-free unittest 与前端契约测试
infra                    Cloudflare Worker / Pages 配置

边界

前端只消费 API DTO，不直接了解 D1 表结构。
Worker API 只读 D1 查询表，不在请求路径中做重型解析。
Pipeline 负责发现、抓取策略、解析、写入、聚合和校验。
D1 保存窄表、事实表和聚合结果；R2 或本地对象存储保存原始与中间对象。

边界​

边界