源码仓库结构
后端按四域分层，三端工程独立；contracts 保存接口主源，deploy 保存开发与交付工具。
文档导航
本页目录
各目录承担什么职责？
| 目录 | 主要内容 | 检查重点 |
|---|---|---|
| backend | 四域及单体装配 | 业务与技术边界 |
| frontend/admin | 管理页面与接口调用 | 权限、错误、修订 |
| frontend/pc | PC消费者页面 | 会话、路由与公开读取 |
| frontend/mobile | 移动Web工程 | 官方工具链与目标平台 |
| contracts | OpenAPI主源 | 请求、响应和身份要求 |
| deploy | 环境、迁移与发行工具 | 写入范围及秘密管理 |
如何只读检查接口主源？
python3 -c "import json; p=json.load(open('contracts/admin.openapi.json')); print(p['openapi']); print(len(p['paths']))"
该命令解析当前契约并显示路径数量，用于检查文件完整性；路径数量不是产品性能或业务完成率。
文件生成后能否手改？
单体版仓库保留 OpenAPI 契约，管理端和 PC 端提供依据该契约生成接口类型的命令。
Admin的 src/api/schema.d.ts 和PC的 app/api/schema.d.ts 由接口类型命令生成。修改合同后生成，再核对调用点；不同时维护两份手写类型权威。各端构建输出不放入源码目录当作第二份实现。
怎样从页面找到业务来源？
沿页面组件、集中API模块、OpenAPI路径、控制器、core用例与仓储向下检查。配置、权限和迁移与用例一起核对，不从控制器名称推断第三方通道已联调。