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

aury/boot/commands/templates/project/aury_docs/13-channel.md.tpl

@@ -2,33 +2,40 @@
 
 用于 SSE（Server-Sent Events）和实时通信。支持 memory 和 redis 后端。
 
+## 核心概念
+
+- **ChannelManager**：管理器，支持命名多实例（如 sse、notification 独立管理）
+- **channel 参数**：通道名/Topic，用于区分不同的消息流（如 `user:123`、`order:456`）
+
 ## 13.1 基本用法
 
 ```python
 from aury.boot.infrastructure.channel import ChannelManager
 
-# 获取实例
-channel = ChannelManager.get_instance()
+# 命名多实例（推荐）- 不同业务场景使用不同实例
+sse_channel = ChannelManager.get_instance("sse")
+notification_channel = ChannelManager.get_instance("notification")
 
-# 初始化（Memory 后端 - 单进程）
-await channel.initialize(backend="memory")
+# Memory 后端（单进程）
+await sse_channel.initialize(backend="memory")
 
-# 初始化（Redis 后端 - 多进程/分布式）
+# Redis 后端（多进程/分布式）
 from aury.boot.infrastructure.clients.redis import RedisClient
 redis_client = RedisClient.get_instance()
 await redis_client.initialize(url="redis://localhost:6379/0")
-await channel.initialize(backend="redis", redis_client=redis_client)
+await notification_channel.initialize(backend="redis", redis_client=redis_client)
 ```
 
-## 13.2 发布消息
+## 13.2 发布和订阅（Topic 管理）
 
 ```python
-# 发布消息到频道
-await channel.publish("user:123", {{"event": "message", "data": "hello"}})
+# 发布消息到指定 Topic
+await sse_channel.publish("user:123", {{"event": "message", "data": "hello"}})
+await sse_channel.publish("order:456", {{"status": "shipped"}})
 
 # 发布到多个用户
 for user_id in user_ids:
-    await channel.publish(f"user:{{user_id}}", notification)
+    await sse_channel.publish(f"user:{{user_id}}", notification)
 ```
 
 ## 13.3 SSE 端点示例
@@ -42,14 +49,17 @@ from fastapi.responses import StreamingResponse
 from aury.boot.infrastructure.channel import ChannelManager
 
 router = APIRouter(tags=["SSE"])
-channel = ChannelManager.get_instance()
+
+# 获取命名实例（在 app 启动时已初始化）
+sse_channel = ChannelManager.get_instance("sse")
 
 
 @router.get("/sse/{{user_id}}")
 async def sse_stream(user_id: str):
     \"\"\"SSE 实时消息流。\"\"\"
     async def event_generator():
-        async for message in channel.subscribe(f"user:{{user_id}}"):
+        # user_id 作为 Topic，区分不同用户的消息流
+        async for message in sse_channel.subscribe(f"user:{{user_id}}"):
             yield f"data: {{json.dumps(message)}}\n\n"
     
     return StreamingResponse(
@@ -61,32 +71,34 @@ async def sse_stream(user_id: str):
 
 @router.post("/notify/{{user_id}}")
 async def send_notification(user_id: str, message: str):
-    \"\"\"发送通知。\"\"\"
-    await channel.publish(f"user:{{user_id}}", {{"message": message}})
+    \"\"\"\u53d1\u9001\u901a\u77e5\u3002\"\"\"
+    await sse_channel.publish(f"user:{{user_id}}", {{"message": message}})
     return {{"status": "sent"}}
 ```
 
-## 13.4 多实例
+## 13.4 应用场景示例
 
 ```python
-# 不同用途的通道实例
-notifications = ChannelManager.get_instance("notifications")
-chat = ChannelManager.get_instance("chat")
-
-# 分别初始化
-await notifications.initialize(backend="redis", redis_client=redis_client)
-await chat.initialize(backend="redis", redis_client=redis_client)
+# 不同业务场景使用不同的命名实例
+sse_channel = ChannelManager.get_instance("sse")           # 前端 SSE 推送
+chat_channel = ChannelManager.get_instance("chat")         # 聊天消息
+notify_channel = ChannelManager.get_instance("notify")     # 系统通知
+
+# 分别初始化（可使用不同后端）
+await sse_channel.initialize(backend="memory")  # 单进程即可
+await chat_channel.initialize(backend="redis", redis_client=redis_client)  # 需要跨进程
+await notify_channel.initialize(backend="redis", redis_client=redis_client)
 ```
 
 ## 13.5 环境变量
 
 ```bash
 # 默认实例
-CHANNEL_BACKEND=memory
+CHANNEL__BACKEND=memory
 
-# 多实例（格式：CHANNEL_{{INSTANCE}}_{{FIELD}}）
-CHANNEL_DEFAULT_BACKEND=redis
-CHANNEL_DEFAULT_URL=redis://localhost:6379/3
-CHANNEL_NOTIFICATIONS_BACKEND=redis
-CHANNEL_NOTIFICATIONS_URL=redis://localhost:6379/4
+# 多实例（格式：CHANNEL__{{INSTANCE}}__{{FIELD}}）
+CHANNEL__DEFAULT__BACKEND=redis
+CHANNEL__DEFAULT__URL=redis://localhost:6379/3
+CHANNEL__NOTIFICATIONS__BACKEND=redis
+CHANNEL__NOTIFICATIONS__URL=redis://localhost:6379/4
 ```

aury/boot/commands/templates/project/aury_docs/14-mq.md.tpl

@@ -85,15 +85,15 @@ await notifications_mq.initialize(backend="redis", url="redis://localhost:6379/5
 
 ```bash
 # 默认实例
-MQ_BACKEND=redis
-MQ_URL=redis://localhost:6379/0
-
-# 多实例（格式：MQ_{{INSTANCE}}_{{FIELD}}）
-MQ_DEFAULT_BACKEND=redis
-MQ_DEFAULT_URL=redis://localhost:6379/4
-MQ_ORDERS_BACKEND=rabbitmq
-MQ_ORDERS_URL=amqp://guest:guest@localhost:5672/
-MQ_ORDERS_PREFETCH_COUNT=10
+MQ__BACKEND=redis
+MQ__URL=redis://localhost:6379/0
+
+# 多实例（格式：MQ__{{INSTANCE}}__{{FIELD}}）
+MQ__DEFAULT__BACKEND=redis
+MQ__DEFAULT__URL=redis://localhost:6379/4
+MQ__ORDERS__BACKEND=rabbitmq
+MQ__ORDERS__URL=amqp://guest:guest@localhost:5672/
+MQ__ORDERS__PREFETCH_COUNT=10
 ```
 
 ## 14.6 与异步任务（Dramatiq）的区别

aury/boot/commands/templates/project/aury_docs/15-events.md.tpl

@@ -130,14 +130,14 @@ await bus.initialize(
 
 ```bash
 # 默认实例
-EVENT_BACKEND=memory
-
-# 多实例（格式：EVENT_{{INSTANCE}}_{{FIELD}}）
-EVENT_DEFAULT_BACKEND=redis
-EVENT_DEFAULT_URL=redis://localhost:6379/5
-EVENT_DOMAIN_BACKEND=rabbitmq
-EVENT_DOMAIN_URL=amqp://guest:guest@localhost:5672/
-EVENT_DOMAIN_EXCHANGE_NAME=domain.events
+EVENT__BACKEND=memory
+
+# 多实例（格式：EVENT__{{INSTANCE}}__{{FIELD}}）
+EVENT__DEFAULT__BACKEND=redis
+EVENT__DEFAULT__URL=redis://localhost:6379/5
+EVENT__DOMAIN__BACKEND=rabbitmq
+EVENT__DOMAIN__URL=amqp://guest:guest@localhost:5672/
+EVENT__DOMAIN__EXCHANGE_NAME=domain.events
 ```
 
 ## 15.6 最佳实践

aury/boot/commands/templates/project/aury_docs/16-adapter.md.tpl

@@ -0,0 +1,403 @@
+# Adapter（第三方接口适配器）
+
+## 16.1 概述
+
+Adapter 模块用于封装第三方接口（如支付、短信、微信等外部服务）的调用，支持在不同环境（开发、测试、生产）中灵活切换真实调用与 Mock 实现。
+
+**核心特性**：
+- 多模式支持：`real`（真实调用）、`sandbox`（沙箱环境）、`mock`（本地 Mock）、`disabled`（禁用）
+- 方法级模式覆盖：同一 Adapter 的不同方法可以使用不同模式
+- 装饰器式 Mock：使用 `.mock` 链式方法定义 Mock 逻辑
+- 调用记录：测试时可追踪所有调用历史
+
+## 16.2 基础用法
+
+**文件**: `{package_name}/adapters/payment_adapter.py`
+
+```python
+"""支付适配器。"""
+
+from aury.boot.application.adapter import (
+    BaseAdapter,
+    AdapterSettings,
+    adapter_method,
+)
+
+
+class PaymentAdapter(BaseAdapter):
+    """支付第三方适配器。"""
+
+    @adapter_method("create_order")
+    async def create_order(self, amount: int, order_id: str) -> dict:
+        """创建支付订单（真实实现）。"""
+        # 真实调用第三方 API
+        response = await self.http_client.post(
+            "https://api.payment.com/orders",
+            json={"amount": amount, "order_id": order_id},
+        )
+        return response.json()
+
+    @create_order.mock
+    async def create_order_mock(self, amount: int, order_id: str) -> dict:
+        """创建支付订单（Mock 实现）。"""
+        if amount > 100000:
+            return {"success": False, "error": "金额超限"}
+        return {
+            "success": True,
+            "transaction_id": f"mock_tx_{order_id}",
+            "amount": amount,
+        }
+
+    @adapter_method("query_order")
+    async def query_order(self, transaction_id: str) -> dict:
+        """查询支付订单。"""
+        response = await self.http_client.get(
+            f"https://api.payment.com/orders/{transaction_id}"
+        )
+        return response.json()
+
+    @query_order.mock
+    async def query_order_mock(self, transaction_id: str) -> dict:
+        """查询支付订单（Mock）。"""
+        return {
+            "transaction_id": transaction_id,
+            "status": "paid",
+            "mock": True,
+        }
+```
+
+## 16.3 Adapter 配置
+
+### 环境变量配置
+
+```bash
+# .env
+
+# 全局模式：real / sandbox / mock / disabled
+THIRD_PARTY__GATEWAY_MODE=mock
+
+# 方法级模式覆盖（JSON 格式）
+# 例如：query 方法使用 real，其他方法使用全局配置
+THIRD_PARTY__METHOD_MODES={"query_order": "real"}
+
+# Mock 策略：decorator（装饰器）/ auto（自动生成）
+THIRD_PARTY__MOCK_STRATEGY=decorator
+
+# 调试模式
+THIRD_PARTY__DEBUG=true
+```
+
+### 代码配置
+
+```python
+from aury.boot.application.adapter import AdapterSettings
+
+# 方式 1：从环境变量加载
+settings = AdapterSettings()
+
+# 方式 2：代码显式配置
+settings = AdapterSettings(
+    mode="mock",
+    method_modes={
+        "query_order": "real",  # query_order 使用真实调用
+        "create_order": "mock", # create_order 使用 Mock
+    },
+    debug=True,
+)
+
+# 创建 Adapter 实例
+adapter = PaymentAdapter("payment", settings)
+```
+
+## 16.4 使用 HttpAdapter
+
+对于 HTTP 类第三方 API，推荐使用 `HttpAdapter`：
+
+```python
+from aury.boot.application.adapter import HttpAdapter, AdapterSettings, adapter_method
+
+
+class WechatAdapter(HttpAdapter):
+    """微信 API 适配器。"""
+
+    def __init__(self, settings: AdapterSettings | None = None):
+        super().__init__(
+            name="wechat",
+            settings=settings,
+            base_url="https://api.weixin.qq.com",
+            timeout=30.0,
+        )
+
+    async def _prepare_headers(self, headers: dict | None) -> dict:
+        """添加认证头。"""
+        headers = await super()._prepare_headers(headers)
+        headers["Authorization"] = f"Bearer {await self._get_access_token()}"
+        return headers
+
+    @adapter_method("send_message")
+    async def send_message(self, openid: str, content: str) -> dict:
+        """发送消息。"""
+        return await self._request(
+            "POST",
+            "/cgi-bin/message/send",
+            json={"touser": openid, "content": content},
+        )
+
+    @send_message.mock
+    async def send_message_mock(self, openid: str, content: str) -> dict:
+        """发送消息（Mock）。"""
+        return {"errcode": 0, "errmsg": "ok", "mock": True}
+```
+
+## 16.5 方法级模式覆盖
+
+同一 Adapter 的不同方法可以使用不同模式：
+
+```python
+settings = AdapterSettings(
+    mode="mock",  # 默认 Mock
+    method_modes={
+        "query_order": "real",      # 查询走真实接口
+        "create_order": "mock",     # 创建走 Mock
+        "refund": "disabled",       # 退款禁用
+    },
+)
+
+adapter = PaymentAdapter("payment", settings)
+
+# query_order 会调用真实 API
+result = await adapter.query_order("tx_123")
+
+# create_order 会调用 Mock 方法
+result = await adapter.create_order(100, "order_123")
+
+# refund 会抛出 AdapterDisabledError
+result = await adapter.refund("tx_123")  # 抛出异常
+```
+
+## 16.6 测试中使用
+
+### 调用记录追踪
+
+```python
+import pytest
+from {package_name}.adapters.payment_adapter import PaymentAdapter
+from aury.boot.application.adapter import AdapterSettings
+
+
+@pytest.fixture
+def payment_adapter():
+    settings = AdapterSettings(mode="mock")
+    return PaymentAdapter("payment", settings)
+
+
+async def test_create_order(payment_adapter):
+    """测试创建订单。"""
+    result = await payment_adapter.create_order(100, "order_001")
+
+    assert result["success"] is True
+    assert result["mock"] is True
+
+    # 检查调用记录
+    history = payment_adapter.call_history
+    assert len(history) == 1
+    assert history[0].method == "create_order"
+    assert history[0].args == (100, "order_001")
+    assert history[0].result == result
+
+
+async def test_amount_limit(payment_adapter):
+    """测试金额超限。"""
+    result = await payment_adapter.create_order(200000, "order_002")
+
+    assert result["success"] is False
+    assert "超限" in result["error"]
+
+
+async def test_clear_history(payment_adapter):
+    """测试清除调用记录。"""
+    await payment_adapter.create_order(100, "order_001")
+    await payment_adapter.query_order("tx_001")
+
+    assert len(payment_adapter.call_history) == 2
+
+    payment_adapter.clear_history()
+    assert len(payment_adapter.call_history) == 0
+```
+
+## 16.7 高级用法
+
+### 钩子方法
+
+```python
+class PaymentAdapter(HttpAdapter):
+    """带钩子的支付适配器。"""
+
+    async def _on_before_call(
+        self, method: str, args: tuple, kwargs: dict
+    ) -> None:
+        """调用前钩子。"""
+        logger.info(f"调用 {method}，参数: {args}")
+
+    async def _on_after_call(
+        self, method: str, args: tuple, kwargs: dict, result: Any
+    ) -> None:
+        """调用后钩子。"""
+        logger.info(f"{method} 返回: {result}")
+
+    async def _on_call_error(
+        self, method: str, args: tuple, kwargs: dict, error: Exception
+    ) -> None:
+        """调用异常钩子。"""
+        logger.error(f"{method} 异常: {error}")
+        # 可以在这里发送告警
+```
+
+### 复合适配器
+
+```python
+class CompositePaymentAdapter(BaseAdapter):
+    """组合多个支付渠道。"""
+
+    def __init__(self, settings: AdapterSettings | None = None):
+        super().__init__("composite_payment", settings)
+        self.alipay = AlipayAdapter(settings)
+        self.wechat = WechatAdapter(settings)
+
+    @adapter_method("pay")
+    async def pay(self, channel: str, amount: int, order_id: str) -> dict:
+        """根据渠道选择支付方式。"""
+        if channel == "alipay":
+            return await self.alipay.create_order(amount, order_id)
+        elif channel == "wechat":
+            return await self.wechat.create_order(amount, order_id)
+        else:
+            raise ValueError(f"不支持的支付渠道: {channel}")
+
+    @pay.mock
+    async def pay_mock(self, channel: str, amount: int, order_id: str) -> dict:
+        """统一 Mock 实现。"""
+        return {
+            "success": True,
+            "channel": channel,
+            "transaction_id": f"mock_{channel}_{order_id}",
+        }
+```
+
+## 16.8 异常处理
+
+```python
+from aury.boot.application.adapter import (
+    AdapterError,
+    AdapterDisabledError,
+    AdapterTimeoutError,
+    AdapterValidationError,
+)
+
+try:
+    result = await adapter.create_order(100, "order_001")
+except AdapterDisabledError:
+    logger.warning("支付适配器已禁用")
+    # 降级处理
+except AdapterTimeoutError:
+    logger.error("支付适配器超时")
+    # 重试或告警
+except AdapterValidationError as e:
+    logger.error(f"参数校验失败: {e}")
+except AdapterError as e:
+    logger.error(f"适配器错误: {e}")
+```
+
+## 16.9 最佳实践
+
+### 1. Adapter 放置位置
+
+```
+{package_name}/
+├── adapters/                 # 第三方适配器
+│   ├── __init__.py
+│   ├── payment_adapter.py    # 支付适配器
+│   ├── sms_adapter.py        # 短信适配器
+│   └── wechat_adapter.py     # 微信适配器
+```
+
+### 2. Mock 逻辑应覆盖边界情况
+
+```python
+@create_order.mock
+async def create_order_mock(self, amount: int, order_id: str) -> dict:
+    """Mock 应模拟各种场景。"""
+    # 模拟金额校验
+    if amount <= 0:
+        return {"success": False, "error": "金额必须大于0"}
+    if amount > 100000:
+        return {"success": False, "error": "金额超限"}
+
+    # 模拟偶发失败（可选）
+    import random
+    if random.random() < 0.01:
+        return {"success": False, "error": "系统繁忙"}
+
+    return {"success": True, "transaction_id": f"mock_{order_id}"}
+```
+
+### 3. 环境配置建议
+
+```bash
+# 开发环境 (.env.development)
+THIRD_PARTY__GATEWAY_MODE=mock
+THIRD_PARTY__DEBUG=true
+
+# 测试环境 (.env.testing)
+THIRD_PARTY__GATEWAY_MODE=mock
+THIRD_PARTY__METHOD_MODES={"query": "sandbox"}
+
+# 生产环境 (.env.production)
+THIRD_PARTY__GATEWAY_MODE=real
+THIRD_PARTY__DEBUG=false
+```
+
+### 4. 在 Service 中使用
+
+```python
+from sqlalchemy.ext.asyncio import AsyncSession
+
+from aury.boot.domain.service.base import BaseService
+from aury.boot.domain.transaction import transactional
+
+from {package_name}.adapters.payment_adapter import PaymentAdapter
+from {package_name}.repositories.order_repository import OrderRepository
+
+
+class OrderService(BaseService):
+    """订单服务。"""
+
+    def __init__(self, session: AsyncSession, payment: PaymentAdapter):
+        super().__init__(session)
+        self.order_repo = OrderRepository(session)
+        self.payment = payment
+
+    @transactional
+    async def create_order(self, user_id: str, amount: int) -> Order:
+        """创建订单并发起支付。"""
+        # 1. 创建订单记录
+        order = await self.order_repo.create({
+            "user_id": user_id,
+            "amount": amount,
+            "status": "pending",
+        })
+
+        # 2. 调用支付适配器
+        pay_result = await self.payment.create_order(amount, str(order.id))
+
+        if not pay_result["success"]:
+            raise PaymentError(pay_result["error"])
+
+        # 3. 更新订单状态
+        await self.order_repo.update(order, {
+            "transaction_id": pay_result["transaction_id"],
+            "status": "paid",
+        })
+
+        return order
+```

aury/boot/commands/templates/project/aury_docs/99-cli.md.tpl

@@ -36,10 +36,10 @@ aury generate schema user     # Pydantic Schema
 aury generate model user --fields "name:str,email:str,age:int"
 
 # 指定模型基类
-aury generate model user --base UUIDAuditableStateModel  # UUID主键 + 软删除（推荐）
-aury generate model user --base UUIDModel                # UUID主键 + 时间戳
+aury generate model user --base AuditableStateModel      # int主键 + 软删除（推荐）
 aury generate model user --base Model                    # int主键 + 时间戳
-aury generate model user --base VersionedUUIDModel       # UUID + 乐观锁 + 时间戳
+aury generate model user --base FullFeaturedModel        # int主键 + 全功能
+aury generate model user --base UUIDAuditableStateModel  # UUID主键（如需要）
 ```
 
 ## 数据库迁移
@@ -65,13 +65,13 @@ aury worker       # 运行 Dramatiq Worker
 
 | 变量 | 说明 | 默认值 |
 |------|------|--------|
-| `DATABASE_URL` | 数据库连接 URL | `sqlite+aiosqlite:///./dev.db` |
-| `CACHE_TYPE` | 缓存类型 (memory/redis) | `memory` |
-| `CACHE_URL` | Redis URL | - |
-| `LOG_LEVEL` | 日志级别 | `INFO` |
-| `LOG_DIR` | 日志目录 | `logs` |
-| `SCHEDULER_ENABLED` | 启用内嵌调度器 | `true` |
-| `TASK_BROKER_URL` | 任务队列 Broker URL | - |
+| `DATABASE__URL` | 数据库连接 URL | `sqlite+aiosqlite:///./dev.db` |
+| `CACHE__CACHE_TYPE` | 缓存类型 (memory/redis) | `memory` |
+| `CACHE__URL` | Redis URL | - |
+| `LOG__LEVEL` | 日志级别 | `INFO` |
+| `LOG__DIR` | 日志目录 | `logs` |
+| `SCHEDULER__ENABLED` | 启用内嵌调度器 | `true` |
+| `TASK__BROKER_URL` | 任务队列 Broker URL | - |
 
 ## 管理后台（Admin Console）
 
@@ -81,12 +81,12 @@ aury worker       # 运行 Dramatiq Worker
 
 | 变量 | 说明 | 默认值 |
 |------|------|--------|
-| `ADMIN_ENABLED` | 是否启用管理后台 | `false` |
-| `ADMIN_PATH` | 管理后台路径 | `/api/admin-console` |
-| `ADMIN_DATABASE_URL` | 管理后台同步数据库 URL（可覆盖自动推导） | - |
-| `ADMIN_AUTH_MODE` | 认证模式（basic/bearer/none/custom/jwt） | `basic` |
-| `ADMIN_AUTH_SECRET_KEY` | session 签名密钥（生产必配） | - |
-| `ADMIN_AUTH_BASIC_USERNAME` | basic 用户名 | - |
-| `ADMIN_AUTH_BASIC_PASSWORD` | basic 密码 | - |
-| `ADMIN_AUTH_BEARER_TOKENS` | bearer token 白名单 | `[]` |
-| `ADMIN_AUTH_BACKEND` | 自定义认证后端导入路径（module:attr） | - |
+| `ADMIN__ENABLED` | 是否启用管理后台 | `false` |
+| `ADMIN__PATH` | 管理后台路径 | `/api/admin-console` |
+| `ADMIN__DATABASE_URL` | 管理后台同步数据库 URL（可覆盖自动推导） | - |
+| `ADMIN__AUTH_MODE` | 认证模式（basic/bearer/none/custom/jwt） | `basic` |
+| `ADMIN__AUTH_SECRET_KEY` | session 签名密钥（生产必配） | - |
+| `ADMIN__AUTH_BASIC_USERNAME` | basic 用户名 | - |
+| `ADMIN__AUTH_BASIC_PASSWORD` | basic 密码 | - |
+| `ADMIN__AUTH_BEARER_TOKENS` | bearer token 白名单 | `[]` |
+| `ADMIN__AUTH_BACKEND` | 自定义认证后端导入路径（module:attr） | - |

aury/boot/commands/templates/project/config.py.tpl

@@ -2,11 +2,11 @@
 
 配置优先级：命令行参数 > 环境变量 > .env 文件 > 默认值
 
-环境变量示例：
-    DATABASE_URL=postgresql+asyncpg://user:pass@localhost:5432/mydb
-    CACHE_TYPE=redis
-    CACHE_URL=redis://localhost:6379/0
-    LOG_LEVEL=INFO
+环境变量格式（使用双下划线分层）：
+    DATABASE__URL=postgresql+asyncpg://user:pass@localhost:5432/mydb
+    CACHE__CACHE_TYPE=redis
+    CACHE__URL=redis://localhost:6379/0
+    LOG__LEVEL=INFO
 """
 
 from aury.boot.application.config import BaseConfig
@@ -16,11 +16,11 @@ class AppConfig(BaseConfig):
     """{project_name} 配置。
     
     继承 BaseConfig 获得所有默认配置项：
-    - server: 服务器配置
-    - database: 数据库配置
-    - cache: 缓存配置
-    - log: 日志配置
-    - migration: 迁移配置
+    - server: 服务器配置 (SERVER__*)
+    - database: 数据库配置 (DATABASE__*)
+    - cache: 缓存配置 (CACHE__*)
+    - log: 日志配置 (LOG__*)
+    - migration: 迁移配置 (MIGRATION__*)
     
     可以在这里添加自定义配置项。
     """

aury/boot/commands/templates/project/env_templates/_header.tpl

@@ -0,0 +1,10 @@
+# =============================================================================
+# {project_name} 环境变量配置
+# =============================================================================
+# 复制此文件为 .env 并根据实际情况修改
+# 所有配置项均有默认值，只需取消注释并修改需要覆盖的项
+#
+# 环境变量格式说明:
+# - 使用双下划线 (__) 作为层级分隔符
+# - 单实例: {{SECTION}}__{{FIELD}}=value
+# - 多实例: {{SECTION}}__{{INSTANCE}}__{{FIELD}}=value