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

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/{CLI.md.tpl → 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_REDIS_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

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

@@ -0,0 +1,49 @@
+
+# =============================================================================
+# 健康检查配置 (HEALTH_CHECK__)
+# =============================================================================
+# 健康检查端点路径
+# HEALTH_CHECK__PATH=/api/health
+# 是否启用健康检查端点
+# HEALTH_CHECK__ENABLED=true
+
+# =============================================================================
+# CORS 配置 (CORS__)
+# =============================================================================
+# 允许的 CORS 源（生产环境应设置具体域名）
+# CORS__ORIGINS=["*"]
+# 是否允许 CORS 凭据
+# CORS__ALLOW_CREDENTIALS=true
+# 允许的 CORS 方法
+# CORS__ALLOW_METHODS=["*"]
+# 允许的 CORS 头
+# CORS__ALLOW_HEADERS=["*"]
+
+# =============================================================================
+# 管理后台配置 (ADMIN__) - SQLAdmin Admin Console
+# =============================================================================
+# 是否启用管理后台（生产建议仅内网或配合反向代理）
+# ADMIN__ENABLED=false
+# 管理后台路径（默认 /api/admin-console，避免与业务 URL 冲突）
+# ADMIN__PATH=/api/admin-console
+#
+# SQLAdmin 通常要求同步 SQLAlchemy Engine：
+# - 若 DATABASE__URL 使用的是异步驱动（如 postgresql+asyncpg），建议显式提供同步 URL 覆盖
+# ADMIN__DATABASE_URL=postgresql+psycopg://user:pass@localhost:5432/{project_name_snake}
+#
+# 可选：显式指定项目侧模块（用于注册 views/auth）
+# ADMIN__VIEWS_MODULE={project_name_snake}.admin_console
+#
+# 认证配置 (嵌套格式: ADMIN__AUTH__{{FIELD}})
+# ADMIN__AUTH__MODE=basic
+# ADMIN__AUTH__SECRET_KEY=CHANGE_ME_TO_A_RANDOM_SECRET
+#
+# basic：登录页用户名/密码
+# ADMIN__AUTH__BASIC_USERNAME=admin
+# ADMIN__AUTH__BASIC_PASSWORD=change_me
+#
+# bearer：token 白名单（也支持在登录页输入 token）
+# ADMIN__AUTH__BEARER_TOKENS=["change_me_token"]
+#
+# custom/jwt：自定义认证后端（动态导入）
+# ADMIN__AUTH__BACKEND=yourpkg.admin_auth:backend

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

@@ -0,0 +1,14 @@
+
+# =============================================================================
+# 缓存配置 (CACHE__)
+# =============================================================================
+# 单实例配置:
+# CACHE__CACHE_TYPE=memory
+# CACHE__URL=redis://localhost:6379/0
+# CACHE__MAX_SIZE=1000
+
+# 多实例配置 (格式: CACHE__{{INSTANCE}}__{{FIELD}}):
+# CACHE__DEFAULT__BACKEND=memory
+# CACHE__DEFAULT__MAX_SIZE=1000
+# CACHE__SESSION__BACKEND=redis
+# CACHE__SESSION__URL=redis://localhost:6379/2

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

@@ -0,0 +1,22 @@
+
+# =============================================================================
+# 数据库配置 (DATABASE__)
+# =============================================================================
+# 单实例配置:
+# DATABASE__URL=sqlite+aiosqlite:///./dev.db
+# PostgreSQL: postgresql+asyncpg://user:pass@localhost:5432/{project_name_snake}
+# MySQL: mysql+aiomysql://user:pass@localhost:3306/{project_name_snake}
+
+# 连接池配置
+# DATABASE__POOL_SIZE=5
+# DATABASE__MAX_OVERFLOW=10
+# DATABASE__POOL_RECYCLE=3600
+# DATABASE__POOL_TIMEOUT=30
+# DATABASE__POOL_PRE_PING=true
+# DATABASE__ECHO=false
+
+# 多实例配置 (格式: DATABASE__{{INSTANCE}}__{{FIELD}}):
+# DATABASE__DEFAULT__URL=postgresql+asyncpg://user:pass@localhost:5432/{project_name_snake}
+# DATABASE__DEFAULT__POOL_SIZE=5
+# DATABASE__READONLY__URL=postgresql+asyncpg://user:pass@replica:5432/{project_name_snake}
+# DATABASE__READONLY__POOL_SIZE=10

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

@@ -0,0 +1,18 @@
+
+# =============================================================================
+# 日志配置 (LOG__)
+# =============================================================================
+# 日志级别: DEBUG / INFO / WARNING / ERROR / CRITICAL
+# LOG__LEVEL=INFO
+# 日志文件目录
+# LOG__DIR=logs
+# 日志文件轮转时间 (HH:MM 格式)
+# LOG__ROTATION_TIME=00:00
+# 日志文件轮转大小阈值
+# LOG__ROTATION_SIZE=100 MB
+# 日志文件保留天数
+# LOG__RETENTION_DAYS=7
+# 是否启用日志文件轮转
+# LOG__ENABLE_FILE_ROTATION=true
+# 是否输出日志到控制台
+# LOG__ENABLE_CONSOLE=true

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

@@ -0,0 +1,46 @@
+
+# =============================================================================
+# 流式通道配置 (CHANNEL__) - SSE/实时通信
+# =============================================================================
+# 多实例配置 (格式: CHANNEL__{{INSTANCE}}__{{FIELD}}):
+# CHANNEL__DEFAULT__BACKEND=memory
+# CHANNEL__SHARED__BACKEND=redis
+# CHANNEL__SHARED__URL=redis://localhost:6379/3
+# CHANNEL__SHARED__KEY_PREFIX=channel:
+# CHANNEL__SHARED__TTL=86400
+
+# =============================================================================
+# 消息队列配置 (MQ__)
+# =============================================================================
+# 单实例配置:
+# MQ__ENABLED=false
+# MQ__BROKER_URL=redis://localhost:6379/4
+
+# 多实例配置 (格式: MQ__{{INSTANCE}}__{{FIELD}}):
+# MQ__DEFAULT__BACKEND=redis
+# MQ__DEFAULT__URL=redis://localhost:6379/4
+# MQ__DEFAULT__MAX_CONNECTIONS=10
+#
+# RabbitMQ 后端:
+# MQ__ORDERS__BACKEND=rabbitmq
+# MQ__ORDERS__URL=amqp://guest:guest@localhost:5672/orders
+# MQ__ORDERS__PREFETCH_COUNT=10
+
+# =============================================================================
+# 事件总线配置 (EVENT__)
+# =============================================================================
+# 单实例配置:
+# EVENT__BROKER_URL=
+# EVENT__EXCHANGE_NAME=aury.events
+
+# 多实例配置 (格式: EVENT__{{INSTANCE}}__{{FIELD}}):
+# EVENT__DEFAULT__BACKEND=memory
+# EVENT__DISTRIBUTED__BACKEND=redis
+# EVENT__DISTRIBUTED__URL=redis://localhost:6379/5
+# EVENT__DISTRIBUTED__KEY_PREFIX=events:
+#
+# RabbitMQ 后端:
+# EVENT__DOMAIN__BACKEND=rabbitmq
+# EVENT__DOMAIN__URL=amqp://guest:guest@localhost:5672/
+# EVENT__DOMAIN__EXCHANGE_NAME=domain.events
+# EVENT__DOMAIN__EXCHANGE_TYPE=topic

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

@@ -0,0 +1,28 @@
+
+# =============================================================================
+# RPC 客户端配置 (RPC_CLIENT__)
+# =============================================================================
+# 服务地址映射 {service_name: url}
+# RPC_CLIENT__SERVICES={"user-service": "http://localhost:8001"}
+# 默认超时时间（秒）
+# RPC_CLIENT__DEFAULT_TIMEOUT=30
+# 默认重试次数
+# RPC_CLIENT__DEFAULT_RETRY_TIMES=3
+# DNS 解析使用的协议
+# RPC_CLIENT__DNS_SCHEME=http
+# DNS 解析默认端口
+# RPC_CLIENT__DNS_PORT=80
+# 是否使用 DNS 回退（K8s/Docker Compose 自动 DNS）
+# RPC_CLIENT__USE_DNS_FALLBACK=true
+
+# =============================================================================
+# RPC 服务注册配置 (RPC_SERVICE__)
+# =============================================================================
+# 服务名称（用于注册）
+# RPC_SERVICE__NAME={project_name_snake}
+# 服务地址（用于注册）
+# RPC_SERVICE__URL=http://localhost:8000
+# 健康检查 URL（用于注册）
+# RPC_SERVICE__HEALTH_CHECK_URL=http://localhost:8000/api/health
+# 是否自动注册到服务注册中心
+# RPC_SERVICE__AUTO_REGISTER=false