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

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

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

@@ -0,0 +1,18 @@
+
+# =============================================================================
+# 调度器配置 (SCHEDULER__)
+# =============================================================================
+# 是否在 API 服务中启用内嵌调度器
+# SCHEDULER__ENABLED=true
+# 定时任务模块列表（为空时自动发现 schedules 模块）
+# SCHEDULER__SCHEDULE_MODULES=[]
+
+# =============================================================================
+# 任务队列配置 (TASK__)
+# =============================================================================
+# 任务队列代理 URL（如 Redis 或 RabbitMQ）
+# TASK__BROKER_URL=redis://localhost:6379/1
+# 最大重试次数
+# TASK__MAX_RETRIES=3
+# 任务超时时间（秒）
+# TASK__TIMEOUT=3600

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

@@ -0,0 +1,18 @@
+
+# =============================================================================
+# 服务配置 (SERVICE__)
+# =============================================================================
+# 服务名称，用于日志目录区分
+SERVICE__NAME={project_name_snake}
+# 服务类型: api / worker
+# SERVICE__TYPE=api
+
+# =============================================================================
+# 服务器配置 (SERVER__)
+# =============================================================================
+# SERVER__HOST=*********
+# SERVER__PORT=8000
+# 工作进程数（生产环境建议设为 CPU 核心数）
+# SERVER__WORKERS=1
+# 是否启用热重载（生产环境应设为 false）
+# SERVER__RELOAD=true

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

@@ -0,0 +1,38 @@
+
+# =============================================================================
+# 数据库迁移配置 (MIGRATION__)
+# =============================================================================
+# Alembic 配置文件路径
+# MIGRATION__CONFIG_PATH=alembic.ini
+# Alembic 迁移脚本目录
+# MIGRATION__SCRIPT_LOCATION=migrations
+# 是否自动创建迁移配置和目录
+# MIGRATION__AUTO_CREATE=true
+
+# =============================================================================
+# 对象存储配置 (STORAGE__) - 基于 aury-sdk-storage
+# =============================================================================
+# 是否启用存储组件
+# STORAGE__ENABLED=true
+# 存储类型: local / s3 / cos / oss
+# STORAGE__TYPE=local
+#
+# 本地存储（开发环境）
+# STORAGE__BASE_PATH=./storage
+#
+# S3/COS/OSS 通用配置
+# STORAGE__ACCESS_KEY_ID=AKIDxxxxx
+# STORAGE__ACCESS_KEY_SECRET=xxxxx
+# STORAGE__SESSION_TOKEN=
+# STORAGE__ENDPOINT=https://cos.ap-guangzhou.myqcloud.com
+# STORAGE__REGION=ap-guangzhou
+# STORAGE__BUCKET_NAME=my-bucket-1250000000
+# STORAGE__ADDRESSING_STYLE=virtual
+#
+# STS AssumeRole（可选，服务端自动刷新凭证）
+# STORAGE__ROLE_ARN=
+# STORAGE__ROLE_SESSION_NAME=aury-storage
+# STORAGE__EXTERNAL_ID=
+# STORAGE__STS_ENDPOINT=
+# STORAGE__STS_REGION=
+# STORAGE__STS_DURATION_SECONDS=3600

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

@@ -0,0 +1,43 @@
+
+# =============================================================================
+# 第三方接口适配器配置 (THIRD_PARTY__)
+# =============================================================================
+# 用于配置支付、短信、微信等第三方接口的模式切换和挡板设置
+# 格式: THIRD_PARTY__{{ADAPTER_NAME}}__{{FIELD}}
+#
+# 模式说明:
+# - real: 真实调用第三方接口（生产环境）
+# - sandbox: 调用第三方沙箱环境（如果有）
+# - mock: 使用本地挡板实现，不发出真实请求（测试/开发环境）
+# - disabled: 禁用该接口，调用时抛出 AdapterDisabledError
+#
+# ---------- 支付接口示例 (PAYMENT) ----------
+# THIRD_PARTY__PAYMENT__ENABLED=true
+# THIRD_PARTY__PAYMENT__MODE=mock
+# THIRD_PARTY__PAYMENT__BASE_URL=https://api.payment.com/v1
+# THIRD_PARTY__PAYMENT__SANDBOX_URL=https://sandbox.payment.com/v1
+# THIRD_PARTY__PAYMENT__API_KEY=sk_live_xxx
+# THIRD_PARTY__PAYMENT__API_SECRET=
+# THIRD_PARTY__PAYMENT__TIMEOUT=30
+# THIRD_PARTY__PAYMENT__RETRY_TIMES=3
+# THIRD_PARTY__PAYMENT__METHOD_MODES={"query": "real", "refund": "disabled"}
+# THIRD_PARTY__PAYMENT__MOCK_STRATEGY=success
+# THIRD_PARTY__PAYMENT__MOCK_DELAY=0.1
+# THIRD_PARTY__PAYMENT__MOCK_DEFAULT_RESPONSE={"success": true, "mock": true}
+#
+# ---------- 短信接口示例 (SMS) ----------
+# THIRD_PARTY__SMS__ENABLED=true
+# THIRD_PARTY__SMS__MODE=mock
+# THIRD_PARTY__SMS__BASE_URL=https://sms.aliyuncs.com
+# THIRD_PARTY__SMS__API_KEY=LTAI5xxx
+# THIRD_PARTY__SMS__API_SECRET=xxx
+# THIRD_PARTY__SMS__TIMEOUT=10
+# THIRD_PARTY__SMS__MOCK_STRATEGY=success
+# THIRD_PARTY__SMS__MOCK_DEFAULT_RESPONSE={"code": "OK", "message": "mock sent"}
+#
+# ---------- 微信接口示例 (WECHAT) ----------
+# THIRD_PARTY__WECHAT__ENABLED=true
+# THIRD_PARTY__WECHAT__MODE=mock
+# THIRD_PARTY__WECHAT__BASE_URL=https://api.weixin.qq.com
+# THIRD_PARTY__WECHAT__TIMEOUT=15
+# THIRD_PARTY__WECHAT__EXTRA={"appid": "wx123", "secret": "xxx"}