EAOS Master Manual Coverage
EAOS 手册不是一本孤立的 Word，而是一组可版本管理、可发布、可驱动开发的工程文档。每一卷都必须说明：它解决什么问题、谁使用它、依赖哪些文档、产出哪些开发任务。
Manual Volumes
| Code | Volume | Status | Purpose |
|---|---|---|---|
| EPA-000 | Software Constitution | draft | 最高设计原则 |
| EPA-001 | Product Requirements | draft | 产品边界、用户、场景、里程碑 |
| EPA-002 | Domain Driven Design | draft | 领域模型、边界上下文、领域事件 |
| EPA-003 | System Architecture | draft | C4、模块、部署、质量属性 |
| EPA-004 | Database Design | draft | 数据实体、迁移、审计、治理 |
| EPA-005 | AI Center | draft | 模型、Prompt、Agent、工作流、评估 |
| EPA-006 | Operations | draft | Git、CI、发布、备份、维护 |
| EPA-007 | Website Forum Points Commerce | draft | 主站、论坛、积分、商城 |
| EPA-008 | Testing And Quality | draft | 测试策略、验收标准、质量门禁 |
| EPA-009 | Deployment Infrastructure | draft | GitHub Pages、后端、数据库、对象存储 |
| EPA-010 | Admin Console | draft | 后台管理、内容、课程、积分、订单 |
| EPA-011 | Compliance Risk Governance | draft | 隐私、版权、未成年人、积分规则、支付边界 |
| EPA-012 | Content Operations | draft | SEO、更新节奏、论坛运营、课程上新 |
| EPA-013 | Community Management | draft | 训练营社群、咨询项目、企微、微信群、服务号 |
| EPA-014 | WeChat WeCom Integrations | draft | 企业微信、微信群、服务号适配、同步和审计 |
| EPA-015 | Offline Class Zone | draft | 线下讲座建班、邀请码链接、互动课件、手机号入班、现场进度和成果沉淀 |
Chapter Engine
每一卷的章节默认按这个引擎推进：
- 本卷解决的真实问题。
- 当前阶段边界。
- 核心概念和术语。
- 主要流程。
- 数据对象或配置对象。
- 权限和安全边界。
- 验收标准。
- 风险与后续演进。
Completion Rule
当一卷从 draft 升级到 accepted，必须同时满足：
- 文档包含场景、流程、数据、权限、验收、风险。
- 如果涉及 API，已更新
openapi/eaos.v0.yaml。 - 如果涉及数据，已更新
prisma/schema.prisma。 - 如果涉及网站，已更新
site/或对应应用代码。 node scripts/doctor.mjs通过。
Executable Handbooks
EPA-000 至 EPA-012 定义系统边界，下面的子手册定义日常怎么做。它们是开发、运营和发布时的操作入口。
| Handbook | Use When | Required Evidence |
|---|---|---|
| Product Planning Handbook | 新增网站页面、课程产品、AI 能力或业务切片 | 需求卡、用户故事、验收清单 |
| Forum Points Commerce Handbook | 设计论坛、积分、商城、订单和权益链路 | 积分规则、API 契约、风控边界 |
| Admin Operations Handbook | 运营后台、审核内容、处理积分和商品状态 | 角色边界、审计日志、事故处理 |
| Quality Release Handbook | 提交、验收、发布和回滚 | doctor 输出、浏览器验收、风险清单 |
EPA-013 社群管理是咨询和线上训练营的业务核心。EPA-014 进一步约束企业微信、微信群和微信服务号的服务端接入。涉及外部微信生态同步、消息触达、入群、回调或训练营陪伴服务的需求，必须先更新 EPA-013/EPA-014，再进入 API 或页面实现。
Current Build Path
当前项目按下列顺序推进：
- 手册定义产品和工程边界。
- 静态站提供可访问的学习、论坛、商城和积分中心。
- API 原型验证论坛、积分、商品、订单和后台。
- 后续迁移到生产数据库、鉴权、审核和权益发放。
- 微信生态接入通过服务端适配器和渠道同步任务逐步生产化。
任何新功能如果无法放入上述手册之一，先补手册，再写代码。