aury-boot 0.0.5__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,7 +153,7 @@ 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",
     "AGENTS.md": "AGENTS.md.tpl",
@@ -161,6 +161,21 @@ TEMPLATE_FILE_MAP = {
     "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",
@@ -170,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:
@@ -244,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")

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

@@ -68,7 +68,7 @@ mypy {package_name}/
 开发 CRUD 功能时，按顺序阅读以下文档：
 
 1. **[aury_docs/01-model.md](./aury_docs/01-model.md)** - Model 定义规范
-   - 基类选择（UUIDAuditableStateModel 等）
+   - 基类选择（AuditableStateModel 等）
    - 字段类型映射
    - 约束定义（软删除模型的复合唯一约束）
 
@@ -110,6 +110,10 @@ mypy {package_name}/
 - **[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)** - 项目概览与最佳实践
@@ -121,15 +125,15 @@ mypy {package_name}/
 ### Model 规范
 
 - **必须**继承框架预定义基类，**不要**直接继承 `Base`
-- **推荐**使用 `UUIDAuditableStateModel`（UUID 主键 + 时间戳 + 软删除）
+- **推荐**使用 `AuditableStateModel`（int 主键 + 时间戳 + 软删除）
 - 软删除模型**必须**使用复合唯一约束（包含 `deleted_at`），不能单独使用 `unique=True`
 - **不建议**使用数据库外键（`ForeignKey`），通过程序控制关系，便于分库分表和微服务拆分
 
 ```python
 # ✅ 正确
-from aury.boot.domain.models import UUIDAuditableStateModel
+from aury.boot.domain.models import AuditableStateModel
 
-class User(UUIDAuditableStateModel):
+class User(AuditableStateModel):
     __tablename__ = "users"
     email: Mapped[str] = mapped_column(String(255), index=True)
     __table_args__ = (

aury/boot/commands/templates/project/aury_docs/01-model.md.tpl

@@ -5,14 +5,15 @@
 框架提供多种预组合基类，按需选择：
 
 | 基类 | 主键 | 时间戳 | 软删除 | 乐观锁 | 场景 |
-|------|------|--------|--------|--------|------|
-| `Model` | int | ✓ | ✗ | ✗ | 简单实体 |
-| `AuditableStateModel` | int | ✓ | ✓ | ✗ | 需软删除 |
-| `UUIDModel` | UUID | ✓ | ✗ | ✗ | 分布式 |
-| `UUIDAuditableStateModel` | UUID | ✓ | ✓ | ✗ | **推荐** |
-| `VersionedModel` | int | ✗ | ✗ | ✓ | 乐观锁 |
-| `VersionedUUIDModel` | UUID | ✓ | ✗ | ✓ | UUID+乐观锁 |
-| `FullFeaturedUUIDModel` | UUID | ✓ | ✓ | ✓ | 全功能 |
+||------|------|--------|--------|--------|------|
+|| `Model` | int | ✓ | ✗ | ✗ | 简单实体 |
+|| `AuditableStateModel` | int | ✓ | ✓ | ✗ | **推荐** |
+|| `FullFeaturedModel` | int | ✓ | ✓ | ✓ | 全功能 |
+|| `UUIDModel` | UUID | ✓ | ✗ | ✗ | UUID主键 |
+|| `UUIDAuditableStateModel` | UUID | ✓ | ✓ | ✗ | UUID+软删除 |
+|| `VersionedModel` | int | ✗ | ✗ | ✓ | 乐观锁 |
+|| `VersionedUUIDModel` | UUID | ✓ | ✗ | ✓ | UUID+乐观锁 |
+|| `FullFeaturedUUIDModel` | UUID | ✓ | ✓ | ✓ | UUID全功能 |
 
 ## 1.2 基类自动提供的字段
 
@@ -70,14 +71,14 @@ version: Mapped[int]  # 版本号，自动管理
 from sqlalchemy import String, Boolean, UniqueConstraint
 from sqlalchemy.orm import Mapped, mapped_column
 
-from aury.boot.domain.models import UUIDAuditableStateModel
+from aury.boot.domain.models import AuditableStateModel
 
 
-class User(UUIDAuditableStateModel):
+class User(AuditableStateModel):
     """User 模型。
 
-    继承 UUIDAuditableStateModel 自动获得：
-    - id: UUID 主键（使用 SQLAlchemyUuid 自动适配数据库）
+    继承 AuditableStateModel 自动获得：
+    - id: int 自增主键
     - created_at, updated_at: 时间戳
     - deleted_at: 软删除支持
     """
@@ -116,7 +117,7 @@ from sqlalchemy import String, Integer, Index, UniqueConstraint
 from sqlalchemy.orm import Mapped, mapped_column
 import uuid
 
-class Example(UUIDAuditableStateModel):
+class Example(AuditableStateModel):
     __tablename__ = "examples"
     
     # 可选字段
@@ -132,7 +133,7 @@ class Example(UUIDAuditableStateModel):
     # 注意：软删除模型不能单独使用 unique=True，必须使用复合唯一约束
     
     # 关联字段（不使用数据库外键，通过程序控制关系）
-    category_id: Mapped[uuid.UUID | None] = mapped_column(index=True)
+    category_id: Mapped[int | None] = mapped_column(index=True)
     
     # 复合索引和复合唯一约束：必须使用 __table_args__（SQLAlchemy 要求）
     # 软删除模型必须使用复合唯一约束（包含 deleted_at），避免删除后无法插入相同值
@@ -143,7 +144,7 @@ class Example(UUIDAuditableStateModel):
 
 
 # 非软删除模型可以直接使用 unique=True 和 index=True
-class Config(UUIDModel):  # UUIDModel 不包含软删除
+class Config(Model):  # Model 不包含软删除
     __tablename__ = "configs"
     
     # 单列唯一约束：直接在 mapped_column 中使用（推荐）
@@ -179,5 +180,5 @@ class Config(UUIDModel):  # UUIDModel 不包含软删除
    - 简化数据迁移
    ```python
    # 只存储关联 ID，不使用 ForeignKey
-   category_id: Mapped[uuid.UUID | None] = mapped_column(index=True)
+   category_id: Mapped[int | None] = mapped_column(index=True)
    ```

aury/boot/commands/templates/project/aury_docs/11-logging.md.tpl

@@ -1,30 +1,59 @@
 # 日志
 
-基于 loguru 的日志系统，支持结构化日志、链路追踪、性能监控。
+基于 loguru 的日志系统，trace_id 自动注入每条日志，无需手动记录。
 
 ## 11.1 基本用法
 
 ```python
 from aury.boot.common.logging import logger
 
+# trace_id 自动包含在日志格式中，无需手动记录
 logger.info("操作成功")
 logger.warning("警告信息")
-logger.error("错误信息", exc_info=True)
+logger.error("错误信息")
+logger.exception("异常信息")  # 自动记录堆栈
+```
 
-# 绑定上下文
-logger.bind(user_id=123).info("用户操作")
+输出示例：
+```
+2024-01-15 12:00:00 | INFO | app.service:create:42 | abc123 - 操作成功
 ```
 
-## 11.2 链路追踪
+## 11.2 注入用户信息
+
+框架不内置用户系统，但支持注入自定义请求上下文：
 
 ```python
-from aury.boot.common.logging import get_trace_id, set_trace_id
+# app/auth/context.py
+from contextvars import ContextVar
+from aury.boot.common.logging import register_request_context
 
-# 自动生成或获取当前 trace_id
-trace_id = get_trace_id()
+_user_id: ContextVar[str] = ContextVar("user_id", default="")
 
-# 手动设置（如从请求头获取）
-set_trace_id("abc-123")
+def set_user_id(uid: str) -> None:
+    _user_id.set(uid)
+
+# 启动时注册（只需一次）
+register_request_context("user_id", _user_id.get)
+```
+
+在认证中间件中设置（order < 100 以在日志中间件前执行）：
+
+```python
+class AuthMiddleware(Middleware):
+    order = 50  # 在日志中间件(order=100)之前执行
+    
+    async def dispatch(self, request, call_next):
+        user = await verify_token(request)
+        if user:
+            set_user_id(str(user.id))
+        return await call_next(request)
+```
+
+结果：
+```
+← GET /api/users | 状态: 200 | 耗时: 0.05s | Trace-ID: abc123
+[REQUEST_CONTEXT] Trace-ID: abc123 | user_id: 123
 ```
 
 ## 11.3 性能监控装饰器
@@ -41,52 +70,62 @@ async def risky_operation():
     ...
 ```
 
-## 11.4 HTTP 请求日志中间件
+## 11.4 HTTP 请求日志
 
-```python
-from aury.boot.application.middleware.logging import RequestLoggingMiddleware
-
-# 在 FoundationApp 中自动启用，也可手动添加
-app.add_middleware(
-    RequestLoggingMiddleware,
-    log_request_body=True,      # 记录请求体（默认 True）
-    max_body_length=2000,       # 请求体最大记录长度
-    sensitive_fields={{"password", "token"}},  # 敏感字段脱敏
-)
-```
+框架内置 `RequestLoggingMiddleware` 自动记录：
 
-日志输出示例：
 ```
-INFO → POST /api/users | 客户端: 127.0.0.1 | Trace-ID: abc-123
-INFO ← POST /api/users | 状态: 201 | 耗时: 0.052s | Trace-ID: abc-123
+# 请求日志（包含查询参数和请求体）
+→ POST /api/users | 参数: {{'page': '1'}} | Body: {{"name": "test"}} | Trace-ID: abc123
+
+# 响应日志（包含状态码和耗时）
+← POST /api/users | 状态: 201 | 耗时: 0.123s | Trace-ID: abc123
+
+# 慢请求警告（超过 1 秒）
+慢请求: GET /api/reports | 耗时: 2.345s (超过1秒) | Trace-ID: abc123
 ```
 
-## 11.5 WebSocket 日志中间件
+## 11.5 自定义日志文件
+
+为特定业务创建独立的日志文件：
 
 ```python
-from aury.boot.application.middleware.logging import WebSocketLoggingMiddleware
+from aury.boot.common.logging import register_log_sink, logger
 
-app.add_middleware(
-    WebSocketLoggingMiddleware,
-    log_messages=False,         # 是否记录消息内容（默认 False，注意性能和敏感数据）
-    max_message_length=500,     # 消息内容最大记录长度
-)
-```
+# 启动时注册（生成 payment_2024-01-15.log）
+register_log_sink("payment", filter_key="payment")
 
-日志输出示例：
-```
-INFO WS → 连接建立: /ws/chat | 客户端: 127.0.0.1:54321 | Trace-ID: abc-123
-INFO WS ← 连接关闭: /ws/chat | 时长: 120.5s | 收/发: 45/32 | Trace-ID: abc-123
+# 业务代码中使用
+logger.bind(payment=True).info(f"支付成功 | 订单: {{order_id}}")
 ```
 
-## 11.6 自定义日志文件
+## 11.6 异步任务链路追踪
+
+跨进程任务需要手动传递 trace_id：
 
 ```python
-from aury.boot.common.logging import register_log_sink
+from aury.boot.common.logging import get_trace_id, set_trace_id
+
+# 发送任务时传递
+process_order.send(order_id="123", trace_id=get_trace_id())
+
+# 任务执行时恢复
+@tm.conditional_task()
+async def process_order(order_id: str, trace_id: str | None = None):
+    if trace_id:
+        set_trace_id(trace_id)
+    logger.info(f"处理订单: {{order_id}}")  # 自动包含 trace_id
+```
+
+## 11.7 服务上下文隔离
 
-# 注册 access 日志
-register_log_sink("access", filter_key="access")
+日志自动按服务类型分离：
 
-# 写入 access 日志
-logger.bind(access=True).info("GET /api/users 200 0.05s")
+```
+logs/
+├── api_info_2024-01-15.log      # API 服务日志
+├── api_error_2024-01-15.log
+├── scheduler_info_2024-01-15.log # 调度器日志
+├── worker_info_2024-01-15.log    # Worker 日志
+└── access_2024-01-15.log         # HTTP 访问日志
 ```

aury/boot/commands/templates/project/aury_docs/12-admin.md.tpl

@@ -3,28 +3,28 @@
 默认提供可选的 SQLAdmin 后台（组件自动装配）。启用后路径默认为 `/api/admin-console`。
 
 - 组件开关与配置由环境变量控制；启用后框架会在启动时自动挂载后台路由。
-- SQLAdmin 通常需要同步 SQLAlchemy Engine；如果你使用的是异步 `DATABASE_URL`，建议单独设置同步的 `ADMIN_DATABASE_URL`（框架也会尝试自动推导常见驱动映射）。
+- SQLAdmin 通常需要同步 SQLAlchemy Engine；如果你使用的是异步 `DATABASE__URL`，建议单独设置同步的 `ADMIN__DATABASE_URL`（框架也会尝试自动推导常见驱动映射）。
 
 ## 快速启用（.env）
 
 ```bash
 # 启用与基本路径
-ADMIN_ENABLED=true
-ADMIN_PATH=/api/admin-console
+ADMIN__ENABLED=true
+ADMIN__PATH=/api/admin-console
 
 # 认证（二选一，推荐 basic 或 bearer）
-ADMIN_AUTH_MODE=basic
-ADMIN_AUTH_SECRET_KEY=CHANGE_ME_TO_A_RANDOM_SECRET
-ADMIN_AUTH_BASIC_USERNAME=admin
-ADMIN_AUTH_BASIC_PASSWORD=change_me
+ADMIN__AUTH_MODE=basic
+ADMIN__AUTH_SECRET_KEY=CHANGE_ME_TO_A_RANDOM_SECRET
+ADMIN__AUTH_BASIC_USERNAME=admin
+ADMIN__AUTH_BASIC_PASSWORD=change_me
 
 # 如果使用 bearer
-# ADMIN_AUTH_MODE=bearer
-# ADMIN_AUTH_SECRET_KEY=CHANGE_ME
-# ADMIN_AUTH_BEARER_TOKENS=["token1","token2"]
+# ADMIN__AUTH_MODE=bearer
+# ADMIN__AUTH_SECRET_KEY=CHANGE_ME
+# ADMIN__AUTH_BEARER_TOKENS=["token1","token2"]
 
 # 如需显式提供同步数据库 URL（可选）
-# ADMIN_DATABASE_URL=postgresql+psycopg://user:pass@localhost:5432/{project_name}
+# ADMIN__DATABASE_URL=postgresql+psycopg://user:pass@localhost:5432/{project_name}
 ```
 
 ## 注册后台视图
@@ -48,9 +48,9 @@ ADMIN_VIEWS = [UserAdmin]
 
 ## 自定义认证（可选，高阶）
 
-- 通过 `ADMIN_AUTH_BACKEND=module:attr` 指定自定义 backend；或在 `admin_console.py` 实现 `register_admin_auth(config)` 返回 SQLAdmin 的 `AuthenticationBackend`。
-- 生产环境下必须设置 `ADMIN_AUTH_SECRET_KEY`，不允许 `none` 模式。
+- 通过 `ADMIN__AUTH_BACKEND=module:attr` 指定自定义 backend；或在 `admin_console.py` 实现 `register_admin_auth(config)` 返回 SQLAdmin 的 `AuthenticationBackend`。
+- 生产环境下必须设置 `ADMIN__AUTH_SECRET_KEY`，不允许 `none` 模式。
 
 ## 访问
 
-启动服务后访问：`http://localhost:8000/api/admin-console`（或你配置的 `ADMIN_PATH`）。
+启动服务后访问：`http://localhost:8000/api/admin-console`（或你配置的 `ADMIN__PATH`）。