aury-boot 0.0.4__py3-none-any.whl → 0.0.7__py3-none-any.whl

aury/boot/commands/generate.py

@@ -183,7 +183,7 @@ MODEL_BASE_CLASSES = {
         "has_timestamps": True,
     },
     "AuditableStateModel": {
-        "desc": "标准模型 + 软删除",
+        "desc": "int 主键 + 软删除（推荐）",
         "features": ["id: int", "created_at", "updated_at", "deleted_at"],
         "id_type": "int",
         "has_timestamps": True,
@@ -195,7 +195,7 @@ MODEL_BASE_CLASSES = {
         "has_timestamps": True,
     },
     "UUIDAuditableStateModel": {
-        "desc": "UUID 主键 + 软删除（推荐）",
+        "desc": "UUID 主键 + 软删除",
         "features": ["id: UUID", "created_at", "updated_at", "deleted_at"],
         "id_type": "uuid",
         "has_timestamps": True,
@@ -219,13 +219,13 @@ MODEL_BASE_CLASSES = {
         "has_timestamps": True,
     },
     "FullFeaturedModel": {
-        "desc": "完整功能 int版",
+        "desc": "int 主键 + 全功能",
         "features": ["id: int", "created_at", "updated_at", "deleted_at", "version"],
         "id_type": "int",
         "has_timestamps": True,
     },
     "FullFeaturedUUIDModel": {
-        "desc": "完整功能 UUID版",
+        "desc": "UUID 主键 + 全功能",
         "features": ["id: UUID", "created_at", "updated_at", "deleted_at", "version"],
         "id_type": "uuid",
         "has_timestamps": True,
@@ -250,9 +250,9 @@ class ModelDefinition:
     def id_type(self) -> str:
         """获取 id 类型：'int' 或 'uuid'。"""
         if self.base_class:
-            return MODEL_BASE_CLASSES.get(self.base_class, {}).get("id_type", "uuid")
-        # 默认通过 soft_delete/timestamps 推断时使用 UUID
-        return "uuid"
+            return MODEL_BASE_CLASSES.get(self.base_class, {}).get("id_type", "int")
+        # 默认使用 int 主键
+        return "int"
 
     @property
     def id_py_type(self) -> str:
@@ -373,14 +373,14 @@ def _collect_base_class_interactive() -> str:
         info = MODEL_BASE_CLASSES[name]
         # 推荐的加标记
         desc = info["desc"]
-        if name == "UUIDAuditableStateModel":
+        if name == "AuditableStateModel":
             desc = f"[bold green]★ {desc}[/bold green]"
         table.add_row(str(i), name, desc, ", ".join(info["features"]))
     
     console.print(table)
     console.print()
     
-    # 默认选择 UUIDAuditableStateModel（第 4 个）
+    # 默认选择 AuditableStateModel（第 4 个）
     choice = Prompt.ask(
         "请选择基类序号",
         default="4",
@@ -556,16 +556,16 @@ def _generate_model_content(model: ModelDefinition) -> str:
         features = base_info.get("features", [])
         base_doc = f"继承 {base_class} 自动获得：\n    - " + "\n    - ".join(features) if features else f"继承 {base_class} 基类。"
     elif model.soft_delete and model.timestamps:
-        base_class = "UUIDAuditableStateModel"
-        base_doc = """继承 UUIDAuditableStateModel 自动获得：
-    - id: UUID 主键
+        base_class = "AuditableStateModel"
+        base_doc = """继承 AuditableStateModel 自动获得：
+    - id: int 自增主键
     - created_at: 创建时间
     - updated_at: 更新时间
     - deleted_at: 软删除时间戳"""
     elif model.timestamps:
-        base_class = "UUIDModel"
-        base_doc = """继承 UUIDModel 自动获得：
-    - id: UUID 主键
+        base_class = "Model"
+        base_doc = """继承 Model 自动获得：
+    - id: int 自增主键
     - created_at: 创建时间
     - updated_at: 更新时间"""
     else:
@@ -773,7 +773,7 @@ def generate_model(
     ),
     base: str | None = typer.Option(
         None, "--base", "-b",
-        help="模型基类（Model/UUIDModel/UUIDAuditableStateModel/VersionedModel 等）"
+        help="模型基类（AuditableStateModel/Model/FullFeaturedModel 等）"
     ),
     force: bool = typer.Option(False, "--force", "-f", help="强制覆盖"),
     no_soft_delete: bool = typer.Option(False, "--no-soft-delete", help="禁用软删除"),
@@ -803,9 +803,9 @@ def generate_model(
         (length)       - 字符串长度，如 str(100)
 
     可用基类：
-        Model, AuditableStateModel, UUIDModel, UUIDAuditableStateModel,
-        VersionedModel, VersionedTimestampedModel, VersionedUUIDModel,
-        FullFeaturedModel, FullFeaturedUUIDModel
+        AuditableStateModel, Model, FullFeaturedModel,
+        UUIDModel, UUIDAuditableStateModel, FullFeaturedUUIDModel,
+        VersionedModel, VersionedTimestampedModel, VersionedUUIDModel
 
     示例：
         aury generate model user
@@ -1104,7 +1104,7 @@ def generate_crud(
     ),
     base: str | None = typer.Option(
         None, "--base", "-b",
-        help="模型基类（Model/UUIDModel/UUIDAuditableStateModel/VersionedModel 等）"
+        help="模型基类（AuditableStateModel/Model/FullFeaturedModel 等）"
     ),
     force: bool = typer.Option(False, "--force", "-f", help="强制覆盖"),
     no_soft_delete: bool = typer.Option(False, "--no-soft-delete", help="禁用软删除"),
@@ -1122,8 +1122,8 @@ def generate_crud(
 
     示例：
         aury generate crud user
-        aury generate crud user --base Model  # 使用 int 主键
-        aury generate crud user --base UUIDAuditableStateModel  # 使用 UUID 主键（推荐）
+        aury generate crud user --base AuditableStateModel  # int 主键 + 软删除（推荐）
+        aury generate crud user --base Model  # int 主键 + 时间戳
         aury generate crud user email:str:unique age:int? --force
         aury generate crud article title:str(200) content:text status:str=draft
     """

aury/boot/commands/init.py

@@ -153,15 +153,29 @@ dev = [
 TEMPLATE_FILE_MAP = {
     "main.py": "main.py.tpl",
     "config.py": "config.py.tpl",
-    ".env.example": "env.example.tpl",
+    ".env.example": "env_templates",  # 特殊处理：拼接 env_templates/ 目录下的所有 .tpl 文件
     ".gitignore": "gitignore.tpl",
     "README.md": "README.md.tpl",
-    "DEVELOPMENT.md": "DEVELOPMENT.md.tpl",
-    "CLI.md": "CLI.md.tpl",
+    "AGENTS.md": "AGENTS.md.tpl",
     "conftest.py": "conftest.py.tpl",
     "admin_console/__init__.py": "admin_console_init.py.tpl",
 }
 
+# env 模板拼接顺序
+ENV_TEMPLATE_ORDER = [
+    "_header.tpl",
+    "service.tpl",
+    "database.tpl",
+    "cache.tpl",
+    "log.tpl",
+    "admin.tpl",
+    "scheduler.tpl",
+    "messaging.tpl",
+    "storage.tpl",
+    "third_party.tpl",
+    "rpc.tpl",
+]
+
 # 模块 __init__.py 模板映射
 MODULE_TEMPLATE_MAP = {
     "api": "api.py.tpl",
@@ -171,8 +185,25 @@ MODULE_TEMPLATE_MAP = {
 }
 
 
+def _read_env_template() -> str:
+    """读取并拼接 env_templates/ 目录下的所有模板文件。"""
+    env_dir = TEMPLATES_DIR / "env_templates"
+    parts = []
+    
+    for tpl_name in ENV_TEMPLATE_ORDER:
+        tpl_path = env_dir / tpl_name
+        if tpl_path.exists():
+            parts.append(tpl_path.read_text(encoding="utf-8"))
+    
+    return "\n".join(parts)
+
+
 def _read_template(name: str) -> str:
     """读取模板文件。"""
+    # 特殊处理 .env.example：拼接 env_templates/ 目录
+    if name == ".env.example":
+        return _read_env_template()
+    
     # 先尝试从映射中查找 .tpl 文件
     tpl_name = TEMPLATE_FILE_MAP.get(name)
     if tpl_name:
@@ -245,22 +276,22 @@ def init_admin_console_module(
         dest.write_text(content, encoding="utf-8")
         result["file_created"] = True
 
-    # 2) 尝试在 .env.example 中开启 ADMIN_* 配置
+    # 2) 尝试在 .env.example 中开启 ADMIN__* 配置
     if enable_env:
         env_example = base_path / ".env.example"
         if env_example.exists():
             try:
                 s = env_example.read_text(encoding="utf-8")
                 s2 = (
-                    s.replace("# ADMIN_ENABLED=false", "ADMIN_ENABLED=true")
-                     .replace("# ADMIN_PATH=/api/admin-console", "ADMIN_PATH=/api/admin-console")
-                     .replace("# ADMIN_AUTH_MODE=basic", "ADMIN_AUTH_MODE=basic")
+                    s.replace("# ADMIN__ENABLED=false", "ADMIN__ENABLED=true")
+                     .replace("# ADMIN__PATH=/api/admin-console", "ADMIN__PATH=/api/admin-console")
+                     .replace("# ADMIN__AUTH__MODE=basic", "ADMIN__AUTH__MODE=basic")
                      .replace(
-                        "# ADMIN_AUTH_SECRET_KEY=CHANGE_ME_TO_A_RANDOM_SECRET",
-                        "ADMIN_AUTH_SECRET_KEY=CHANGE_ME_TO_A_RANDOM_SECRET",
+                        "# ADMIN__AUTH__SECRET_KEY=CHANGE_ME_TO_A_RANDOM_SECRET",
+                        "ADMIN__AUTH__SECRET_KEY=CHANGE_ME_TO_A_RANDOM_SECRET",
                     )
-                     .replace("# ADMIN_AUTH_BASIC_USERNAME=admin", "ADMIN_AUTH_BASIC_USERNAME=admin")
-                     .replace("# ADMIN_AUTH_BASIC_PASSWORD=change_me", "ADMIN_AUTH_BASIC_PASSWORD=change_me")
+                     .replace("# ADMIN__AUTH__BASIC_USERNAME=admin", "ADMIN__AUTH__BASIC_USERNAME=admin")
+                     .replace("# ADMIN__AUTH__BASIC_PASSWORD=change_me", "ADMIN__AUTH__BASIC_PASSWORD=change_me")
                 )
                 if s2 != s:
                     env_example.write_text(s2, encoding="utf-8")
@@ -712,8 +743,7 @@ def init(
         (code_root / "admin_console" / "__init__.py", "admin_console/__init__.py", False),
         (base_path / "tests" / "conftest.py", "conftest.py", False),  # tests 放在项目根目录
         (base_path / "README.md", "README.md", True),  # 覆盖 uv init 创建的默认 README
-        (base_path / "DEVELOPMENT.md", "DEVELOPMENT.md", False),  # 开发指南
-        (base_path / "CLI.md", "CLI.md", False),  # CLI 命令参考
+        (base_path / "AGENTS.md", "AGENTS.md", False),  # AI 编程助手上下文
         (base_path / ".gitignore", ".gitignore", False),  # Git 忽略文件
     ]
 
@@ -806,13 +836,34 @@ def init(
     else:
         console.print("  [dim]ℹ️  migrations/ 目录已存在，跳过[/dim]")
 
-    # 5. 生成 Docker 配置
+    # 5. 生成开发文档 (aury_docs/) - 动态扫描模板目录
+    console.print("\n[bold]📚 生成开发文档...[/bold]")
+    aury_docs_tpl_dir = TEMPLATES_DIR / "aury_docs"
+    aury_docs_dir = base_path / "aury_docs"
+    aury_docs_dir.mkdir(parents=True, exist_ok=True)
+    docs_count = 0
+    if aury_docs_tpl_dir.exists():
+        for tpl_path in sorted(aury_docs_tpl_dir.glob("*.md.tpl")):
+            output_name = tpl_path.stem  # 去掉 .tpl 后缀，保留 .md
+            output_path = aury_docs_dir / output_name
+            if output_path.exists() and not force:
+                continue
+            try:
+                content = tpl_path.read_text(encoding="utf-8")
+                content = content.format(**template_vars)
+                output_path.write_text(content, encoding="utf-8")
+                docs_count += 1
+            except Exception:
+                pass
+    console.print(f"  [green]✅ 已生成 {docs_count} 个文档到 aury_docs/[/green]")
+
+    # 6. 生成 Docker 配置
     if with_docker:
         console.print("\n[bold]🐳 生成 Docker 配置...[/bold]")
         from .docker import docker_init
         docker_init(force=force)
 
-    # 6. 显示结果
+    # 7. 显示结果
     console.print("\n")
 
     tree = Tree(f"[bold cyan]{project_name}/[/bold cyan]")
@@ -821,8 +872,8 @@ def init(
     tree.add("[dim]alembic.ini[/dim]")
     tree.add("[dim]pyproject.toml[/dim]")
     tree.add("[dim]README.md[/dim]")
-    tree.add("[dim]DEVELOPMENT.md[/dim]")
-    tree.add("[dim]CLI.md[/dim]")
+    tree.add("[dim]AGENTS.md[/dim]")
+    tree.add("[blue]aury_docs/[/blue]")
     if with_docker:
         tree.add("[dim]Dockerfile[/dim]")
         tree.add("[dim]docker-compose.yml[/dim]")

aury/boot/commands/server/app.py

@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+import contextlib
 import os
 from pathlib import Path
 import sys
@@ -339,13 +340,11 @@ def dev(
     typer.echo(f"   应用模块: {app_module_path}")
 
     # 在应用启动完成后打印一次服务地址
-    try:
+    with contextlib.suppress(Exception):
         app_instance.add_event_handler(
             "startup",
             lambda: typer.echo(f"✅ 服务已就绪: http://{server_host}:{server_port}"),
         )
-    except Exception:
-        pass
 
     # 默认包含/排除规则（watchfiles 支持）
     reload_includes = [

aury/boot/commands/templates/project/AGENTS.md.tpl

@@ -0,0 +1,221 @@
+# AGENTS.md
+
+> 这是给 AI 编程助手阅读的项目上下文文件。根据开发任务类型，阅读下方「开发任务文档索引」中对应的文档。
+
+## 项目概述
+
+- **项目名称**: {project_name}
+- **包名**: {package_name}
+- **框架**: [Aury Boot](https://github.com/AuriMyth/aury-boot)（基于 FastAPI + SQLAlchemy 2.0 的微服务框架）
+- **Python 版本**: >= 3.13
+- **包管理**: uv（推荐）或 pip
+
+## 常用命令
+
+```bash
+# 开发服务器（热重载）
+aury server dev
+
+# 数据库迁移
+aury migrate make -m "描述"    # 生成迁移
+aury migrate up                # 执行迁移
+aury migrate down              # 回滚迁移
+aury migrate status            # 查看状态
+aury migrate show              # 查看历史
+
+# 测试
+pytest
+pytest tests/test_xxx.py -v
+
+# 代码检查
+ruff check .
+mypy {package_name}/
+```
+
+> ⚠️ **重要**：数据库迁移文件**必须**使用 `aury migrate make` 命令生成，**禁止**手写迁移文件！
+
+## 项目结构
+
+```
+{project_name}/
+├── {package_name}/           # 主代码包
+│   ├── models/               # SQLAlchemy ORM 模型
+│   ├── repositories/         # 数据访问层（Repository 模式）
+│   ├── services/             # 业务逻辑层
+│   ├── schemas/              # Pydantic 请求/响应模型
+│   ├── api/                  # FastAPI 路由
+│   ├── exceptions/           # 业务异常
+│   ├── tasks/                # 异步任务（Dramatiq）
+│   └── schedules/            # 定时任务
+├── aury_docs/               # 开发文档（由 aury docs dev 生成）
+├── tests/                    # 测试
+├── migrations/               # 数据库迁移
+└── main.py                   # 应用入口
+```
+
+## 重要提醒
+
+> **修改代码前，必须先阅读对应的文档！**
+> 
+> 框架的 API 可能与常见框架不同，不要猜测。请查看 `aury_docs/` 下对应的文档。
+
+## 开发任务文档索引
+
+根据你要开发的功能类型，**必须阅读**对应的文档：
+
+### CRUD / 数据库相关（最常见）
+
+开发 CRUD 功能时，按顺序阅读以下文档：
+
+1. **[aury_docs/01-model.md](./aury_docs/01-model.md)** - Model 定义规范
+   - 基类选择（AuditableStateModel 等）
+   - 字段类型映射
+   - 约束定义（软删除模型的复合唯一约束）
+
+2. **[aury_docs/02-repository.md](./aury_docs/02-repository.md)** - Repository 使用
+   - BaseRepository API
+   - Filters 语法（__gt, __like 等）
+   - 自动提交机制
+
+3. **[aury_docs/03-service.md](./aury_docs/03-service.md)** - Service 编写与事务
+   - 事务装饰器 @transactional
+   - 跨 Service 调用
+   - 事务传播 / Savepoints / on_commit 回调
+   - SELECT FOR UPDATE
+
+4. **[aury_docs/04-schema.md](./aury_docs/04-schema.md)** - Pydantic Schema
+   - 请求/响应模型
+   - 常用验证
+
+5. **[aury_docs/05-api.md](./aury_docs/05-api.md)** - API 路由
+   - 路由编写示例
+   - 依赖注入模式
+
+6. **[aury_docs/06-exception.md](./aury_docs/06-exception.md)** - 异常处理
+   - 内置异常
+   - 自定义异常
+
+### 异步任务 / 定时任务
+
+- **[aury_docs/08-scheduler.md](./aury_docs/08-scheduler.md)** - 定时任务（APScheduler）
+- **[aury_docs/09-tasks.md](./aury_docs/09-tasks.md)** - 异步任务（Dramatiq）
+
+### 基础设施
+
+- **[aury_docs/07-cache.md](./aury_docs/07-cache.md)** - 缓存
+- **[aury_docs/10-storage.md](./aury_docs/10-storage.md)** - 对象存储（S3/COS/OSS）
+- **[aury_docs/11-logging.md](./aury_docs/11-logging.md)** - 日志
+- **[aury_docs/12-admin.md](./aury_docs/12-admin.md)** - 管理后台（SQLAdmin）
+- **[aury_docs/13-channel.md](./aury_docs/13-channel.md)** - 流式通道（SSE）
+- **[aury_docs/14-mq.md](./aury_docs/14-mq.md)** - 消息队列
+- **[aury_docs/15-events.md](./aury_docs/15-events.md)** - 事件总线
+
+### 第三方集成
+
+- **[aury_docs/16-adapter.md](./aury_docs/16-adapter.md)** - 第三方接口适配器（Mock/真实切换）
+
+### 配置 / CLI / 环境变量
+
+- **[aury_docs/00-overview.md](./aury_docs/00-overview.md)** - 项目概览与最佳实践
+- **[aury_docs/99-cli.md](./aury_docs/99-cli.md)** - CLI 命令参考
+- **[.env.example](./.env.example)** - 所有可用环境变量
+
+## 代码规范
+
+### Model 规范
+
+- **必须**继承框架预定义基类，**不要**直接继承 `Base`
+- **推荐**使用 `AuditableStateModel`（int 主键 + 时间戳 + 软删除）
+- 软删除模型**必须**使用复合唯一约束（包含 `deleted_at`），不能单独使用 `unique=True`
+- **不建议**使用数据库外键（`ForeignKey`），通过程序控制关系，便于分库分表和微服务拆分
+
+```python
+# ✅ 正确
+from aury.boot.domain.models import AuditableStateModel
+
+class User(AuditableStateModel):
+    __tablename__ = "users"
+    email: Mapped[str] = mapped_column(String(255), index=True)
+    __table_args__ = (
+        UniqueConstraint("email", "deleted_at", name="uq_users_email_deleted"),
+    )
+
+# ❌ 错误：直接继承 Base
+from aury.boot.domain.models.base import Base
+class User(Base): ...
+```
+
+### Service 规范
+
+- 写操作**必须**使用 `@transactional` 装饰器
+- 只读操作可以不加事务装饰器
+- 跨 Service 调用通过共享 session 实现事务共享
+
+```python
+from aury.boot.domain.transaction import transactional
+
+class UserService(BaseService):
+    @transactional
+    async def create(self, data: UserCreate) -> User:
+        # 自动事务管理
+        return await self.repo.create(data.model_dump())
+```
+
+### Manager API 规范
+
+所有基础设施 Manager 统一使用 `initialize()` 方法初始化：
+
+```python
+# ✅ 正确
+from aury.boot.infrastructure.cache import CacheManager
+cache = CacheManager.get_instance()
+await cache.initialize(backend="redis", url="redis://localhost:6379")
+
+from aury.boot.infrastructure.storage import StorageManager, StorageConfig
+storage = StorageManager.get_instance()
+await storage.initialize(StorageConfig(...))
+
+from aury.boot.infrastructure.events import EventBusManager
+events = EventBusManager.get_instance()
+await events.initialize(backend="memory")
+
+# ❗ 注意：没有 configure() 方法，配置直接传入 initialize()
+```
+
+### 异常规范
+
+- **必须**继承框架异常类，**不要**直接继承 `Exception`
+- 使用框架内置异常：`NotFoundError`, `AlreadyExistsError`, `UnauthorizedError` 等
+
+```python
+# ✅ 正确
+from aury.boot.application.errors import NotFoundError
+raise NotFoundError("用户不存在", resource=user_id)
+
+# ❌ 错误
+raise Exception("用户不存在")
+```
+
+### 响应规范
+
+- **不要**自定义通用响应 Schema
+- 使用框架内置：`BaseResponse`, `PaginationResponse`
+
+```python
+from aury.boot.application.interfaces.egress import BaseResponse
+return BaseResponse(code=200, message="成功", data=user)
+```
+
+## 禁止操作
+
+- ❌ 不要直接修改 `aury/boot/` 框架代码
+- ❌ 不要在 Model 中直接使用 `unique=True`（软删除模型）
+- ❌ 不要自定义通用响应 Schema
+- ❌ 不要在 Repository 之外直接操作 session
+- ❌ 不要提交 `.env` 文件到版本库
+
+## 需要确认的操作
+
+- ⚠️ 添加新的 pip 依赖前请确认
+- ⚠️ 修改数据库迁移前请确认
+- ⚠️ 删除文件前请确认

aury/boot/commands/templates/project/README.md.tpl

@@ -106,6 +106,6 @@ aury worker
 
 ## 文档
 
-- [DEVELOPMENT.md](./DEVELOPMENT.md) - 开发指南（代码组织与规范）
-- [CLI.md](./CLI.md) - CLI 命令参考
+- [AGENTS.md](./AGENTS.md) - AI 编程助手上下文
+- [aury_docs/](./aury_docs/) - 开发文档（包含 Model/Service/API 等指南）
 - [Aury Boot 文档](https://github.com/AuriMyth/aury-boot)

aury/boot/commands/templates/project/aury_docs/00-overview.md.tpl

@@ -0,0 +1,59 @@
+# {project_name} 开发指南
+
+本文档基于 [Aury Boot](https://github.com/AuriMyth/aury-boot) 框架。
+
+CLI 命令参考请查看 [99-cli.md](./99-cli.md)。
+
+---
+
+## 目录结构
+
+```
+{project_name}/
+├── {package_name}/              # 代码包（默认 app，可通过 aury init <pkg> 自定义）
+│   ├── models/       # SQLAlchemy ORM 模型
+│   ├── repositories/ # 数据访问层
+│   ├── services/     # 业务逻辑层
+│   ├── schemas/      # Pydantic 请求/响应模型
+│   ├── api/          # FastAPI 路由
+│   ├── exceptions/   # 业务异常
+│   ├── tasks/        # 异步任务（Dramatiq）
+│   └── schedules/    # 定时任务（Scheduler）
+├── tests/            # 测试
+├── migrations/       # 数据库迁移
+└── main.py           # 应用入口
+```
+
+---
+
+## 最佳实践
+
+1. **分层架构**：API → Service → Repository → Model
+2. **事务管理**：在 Service 层使用 `@transactional`，只读操作可不加
+3. **错误处理**：使用框架异常类，全局异常处理器统一处理
+4. **配置管理**：使用 `.env` 文件，不提交到版本库
+5. **日志记录**：使用框架 logger，支持结构化日志和链路追踪
+6. **多实例配置**：环境变量格式 `{{PREFIX}}_{{INSTANCE}}_{{FIELD}}`
+
+---
+
+## 文档索引
+
+### CRUD / 数据库
+- [01-model.md](./01-model.md) - Model 定义
+- [02-repository.md](./02-repository.md) - Repository 使用
+- [03-service.md](./03-service.md) - Service 与事务
+- [04-schema.md](./04-schema.md) - Pydantic Schema
+- [05-api.md](./05-api.md) - API 路由
+- [06-exception.md](./06-exception.md) - 异常处理
+
+### 基础设施
+- [07-cache.md](./07-cache.md) - 缓存
+- [08-scheduler.md](./08-scheduler.md) - 定时任务
+- [09-tasks.md](./09-tasks.md) - 异步任务
+- [10-storage.md](./10-storage.md) - 对象存储
+- [11-logging.md](./11-logging.md) - 日志
+- [12-admin.md](./12-admin.md) - 管理后台
+- [13-channel.md](./13-channel.md) - 流式通道（SSE）
+- [14-mq.md](./14-mq.md) - 消息队列
+- [15-events.md](./15-events.md) - 事件总线