教程总览
tutorials/ 目录是 AgileLabs Framework 的主线教程入口，按“从零搭起来”的顺序组织内容。这里优先回答“第一步做什么、下一步接什么、代码放哪里”，适合第一次从后端初始化一路走到前端初始化的人。
教程定位
- 教程页回答“从零怎么做”，强调连续步骤和最小闭环。
- 任务页回答“我现在要做什么”，强调快速定位。
- 规范页回答“必须怎么做”，强调正式规则。
- 主题页回答“为什么这么做、还能怎么扩展”，强调原理和扩展。
教程主线
配套代码规则
- 每篇教程必须在正文的
## 配套代码段落中指向一个当前仓库内的样例说明页。 - 教程配套代码统一收敛到 samples/tutorials。
- 同一条主线的样例目录保持最终完成态，教程正文负责指出当前步骤应关注的文件和命令。
- 当前仓库默认维护三套样例：后端主线、前端主线和联调/托管说明。
- 样例目录只保留源码、配置和说明，不提交构建输出。
怎么配合样例阅读
- 先看教程页，明确当前这一步的目标、前置条件和验证结果。
- 再打开对应样例 README，确认当前主线最终会落成什么目录边界。
- 教程正文里的“当前关注文件”只解决本步骤最关键的几个文件，不要求一次看完整套样例。
- 需要联调或托管时，再切到
fullstack-starter，不要在后端或前端教程里维护第三份重复工程。