Appearance
jeeflow 设计原理
面向引擎开发者/贡献者：解释"为什么这么设计"。行为规范见 SPEC.md。
阅读顺序
| # | 主题 | 内容 |
|---|---|---|
| 01 | 架构总览 | 分层架构、零依赖决策、一次请求的生命周期、四版模块对照 |
| 02 | 领域模型 | DDD 聚合根为什么这么切、引擎与聚合根的分工 |
| 03 | 执行引擎 | 启动/完成/决策/fork-join/会签/驳回的完整旅程 |
| 04 | 扩展机制 | 拦截器、事件、HandlerRegistry（自写 IoC） |
| 05 | SPI 设计 | 必选/可选 SPI 的边界、为什么仓储是唯一必须 |
| 06 | 契约约定 | 引擎与调用方的边界：applicant/驳回退回/submitType/变量注入 |
| 07 | 管理扩展与门面 | v1.1.0：扩展仓储 SPI 与统一门面的决策（集成反馈驱动） |
| 08 | 引擎元数据 | v1.4.0：值漂移问题、枚举字典与注册式清单的决策 |
07/08 记录 v1.1.0 / v1.4.0 的演进决策——前 6 篇是 v1.0 基础设计， 后 2 篇是真实集成方反馈驱动的增量设计。
写作约定
- 语言无关：正文用图 + 伪代码 + 表，不贴源码
- 源码锚点：文末表格给出四版关键文件路径，读者自行查阅
- 四版代码与本文档同步演进；文档变更先于代码变更（契约先行）
- 分层边界：本文档只讲"为什么"；"必须怎么做"在 规范（Spec）， "怎么用"在 用户指南
系列文章
本文档可直接作为系列文章底稿（每篇 ≈ 一篇文章），发布时移除源码锚点表，文末附仓库链接。