feat: 更新 .env.example 文件，新增彩票业务配置与 Redis、邮件、队列等环境变量，优化开发环境设置

.env.example

@@ -1,101 +1,206 @@
-APP_NAME=Lottery
-APP_ENV=local
-APP_KEY=
-APP_DEBUG=true
-APP_URL=http://localhost
+# =============================================================================
+# 应用核心（config/app.php）
+# =============================================================================
 
+# 应用显示名（邮件发件人名、日志等会引用）
+APP_NAME=Lottery
+# 运行环境：local / staging / production（影响缓存、调试与安全策略）
+APP_ENV=local
+# 应用密钥；留空时执行 php artisan key:generate 生成（勿提交真实值到 Git）
+APP_KEY=
+# 是否输出详细错误页与堆栈（生产环境务必为 false）
+APP_DEBUG=true
+# 应用根 URL（生成链接、邮件、部分驱动依赖；与 php artisan serve 端口一致时带上 :8000）
+APP_URL=http://localhost:8000
+
+# =============================================================================
+# 语言与假数据（config/app.php）
+# =============================================================================
+
+# PHP 应用默认语言代码
 APP_LOCALE=en
+# 翻译缺失时的回退语言
 APP_FALLBACK_LOCALE=en
+# Faker 造数用的区域（如 zh_CN、en_US）
 APP_FAKER_LOCALE=en_US
 
+# =============================================================================
+# 维护模式（config/app.php）
+# =============================================================================
+
+# 维护模式驱动：file（写 storage/framework/down）或可使用其他存储
 APP_MAINTENANCE_DRIVER=file
+# 使用 database 驱动维护状态时的存储配置（与 file 二选一场景下再取消注释）
 # APP_MAINTENANCE_STORE=database
 
+# 内置 PHP 开发服务器 worker 数量（多核本机可酌情打开）
 # PHP_CLI_SERVER_WORKERS=4
 
+# =============================================================================
+# 密码哈希（config/hashing.php）
+# =============================================================================
+
+# bcrypt 迭代轮数；越大越慢越安全，测试环境可略低
 BCRYPT_ROUNDS=12
 
+# =============================================================================
+# 日志（config/logging.php）
+# =============================================================================
+
+# 默认日志通道名，对应下方 LOG_STACK 中的通道之一
 LOG_CHANNEL=stack
+# stack 通道所包含的子通道，逗号分隔，如 single、daily
 LOG_STACK=single
+# 弃用警告单独输出到的通道；null 表示忽略
 LOG_DEPRECATIONS_CHANNEL=null
+# 日志级别：debug / info / notice / warning / error / critical / alert / emergency
 LOG_LEVEL=debug
 
-DB_CONNECTION=pgsql
-DB_HOST=127.0.0.1
-DB_PORT=5432
-DB_DATABASE=lottery
-DB_USERNAME=kang
-DB_PASSWORD=123456
+# =============================================================================
+# 数据库（config/database.php）
+# =============================================================================
 
+# 连接名：pgsql / mysql / sqlite 等
+DB_CONNECTION=pgsql
+# 数据库主机
+DB_HOST=127.0.0.1
+# 数据库端口（PostgreSQL 默认 5432）
+DB_PORT=5432
+# 数据库名
+DB_DATABASE=lottery
+# 数据库用户名（示例留空，本机按实际填写）
+DB_USERNAME=
+# 数据库密码（示例留空）
+DB_PASSWORD=
+# 完整数据库 URL，若设置可覆盖上述分散配置（一般留空）
+# DB_URL=
+
+# =============================================================================
+# Session（config/session.php）
+# =============================================================================
+
+# 会话驱动：file / cookie / database / redis 等
 SESSION_DRIVER=database
+# 会话存活时间（分钟）
 SESSION_LIFETIME=120
+# 是否加密会话数据
 SESSION_ENCRYPT=false
+# Cookie 路径，一般根路径 /
 SESSION_PATH=/
+# Cookie 域；单域本地开发常用 null
 SESSION_DOMAIN=null
 
-BROADCAST_CONNECTION=log
-FILESYSTEM_DISK=local
-# 本地可用 database；上线建议 redis（与产品文档：赔付池 Lua / 队列）
-QUEUE_CONNECTION=database
+# =============================================================================
+# 广播与文件（config/broadcasting.php、config/filesystems.php）
+# =============================================================================
 
-# 本地可用 database；实现赔付池与热点缓存后改为 redis
+# 广播驱动：log / pusher / redis 等（未用实时广播可保持 log）
+BROADCAST_CONNECTION=log
+# 默认文件存储盘：local / s3 等
+FILESYSTEM_DISK=local
+
+# =============================================================================
+# 队列与缓存（config/queue.php、config/cache.php）
+# =============================================================================
+
+# 队列驱动：sync（同步）/ database / redis 等；本地常用 database
+QUEUE_CONNECTION=database
+# 缓存存储：file / database / redis 等；与 Redis 赔付池等能力对接前可用 database
 CACHE_STORE=database
+# 缓存键全局前缀；多环境共 Redis 时可用于隔离，一般可留空使用框架默认
 # CACHE_PREFIX=
 
+# =============================================================================
+# Memcached（config/cache.php；未用可保持默认）
+# =============================================================================
+
 MEMCACHED_HOST=127.0.0.1
 
+# =============================================================================
+# Redis（config/database.php 中 redis 连接）
+# =============================================================================
+
+# Redis 客户端扩展：phpredis / predis
 REDIS_CLIENT=phpredis
 REDIS_HOST=127.0.0.1
+# Redis 密码；无认证填 null
 REDIS_PASSWORD=null
 REDIS_PORT=6379
+# 默认 Redis 逻辑库编号（与 session/queue 共用连接时注意规划）
+REDIS_DB=0
+# 专用于 cache 连接的逻辑库编号（config 中 default 与 cache 两套连接）
+REDIS_CACHE_DB=1
 
+# =============================================================================
+# 邮件（config/mail.php）
+# =============================================================================
+
+# 邮件驱动：smtp / log（仅写日志）等
 MAIL_MAILER=log
+# TLS 方案等（smtp+URL 时用；一般用框架默认）
 MAIL_SCHEME=null
 MAIL_HOST=127.0.0.1
 MAIL_PORT=2525
 MAIL_USERNAME=null
 MAIL_PASSWORD=null
+# 默认发件人邮箱
 MAIL_FROM_ADDRESS="hello@example.com"
+# 默认发件显示名（可引用 APP_NAME）
 MAIL_FROM_NAME="${APP_NAME}"
 
+# =============================================================================
+# AWS S3 等（config/filesystems.php；未用 S3 可留空）
+# =============================================================================
+
+# IAM 访问键 ID（仅在使用 S3/队列等 AWS 能力时必填）
 AWS_ACCESS_KEY_ID=
+# IAM Secret
 AWS_SECRET_ACCESS_KEY=
 AWS_DEFAULT_REGION=us-east-1
 AWS_BUCKET=
+# 兼容 MinIO 等路径风格 Endpoint 时使用 true
 AWS_USE_PATH_STYLE_ENDPOINT=false
 
+# =============================================================================
+# 前端 Vite（vite 构建时注入）
+# =============================================================================
+
+# 供前端读取的应用名，通常与 APP_NAME 一致
 VITE_APP_NAME="${APP_NAME}"
 
-# ---------------------------------------------------------------------------
-# 彩票业务（按对接填写；勿把真实密钥提交到 Git，只在本地 .env 写）
-# ---------------------------------------------------------------------------
+# =============================================================================
+# 彩票业务（config/lottery.php、database/seeders；密钥仅写本机 .env）
+# =============================================================================
 
-# 默认结算币种（PRD：NPR）
+# 默认结算币种（产品约定，如 NPR）
 LOTTERY_DEFAULT_CURRENCY=NPR
-
-# 本地开发：Bearer dev:{数据库 players.id}（仅 APP_ENV=local 且为 true 时生效）
+# lottery_settings 表读缓存 TTL（秒）；调小更易立即看到后台改值，调大减库压
+LOTTERY_SETTINGS_CACHE_TTL=60
+# 本地开发：Authorization: Bearer dev:{players.id}；仅 APP_ENV=local 且为 true 时生效，生产务必 false
 LOTTERY_PLAYER_AUTH_DEV_BYPASS=false
 
-# db:seed — 管理员种子为 admin@admin.com / 123456（非 production）；勿用于生产库
-# db:seed — 演示玩家钱包余额（最小货币单位整数）
-# DEV_SEED_WALLET_BALANCE_MINOR=125000
-# DEV_SEED_WALLET_FROZEN_MINOR=0
+# 校验主站 JWT 的算法（与签发方一致）
+LOTTERY_JWT_ALGORITHM=HS256
+# JWT 内表示站点编码的 claim 名
+LOTTERY_JWT_CLAIM_SITE_CODE=site_code
+# JWT 内表示主站玩家标识的 claim 名
+LOTTERY_JWT_CLAIM_SITE_PLAYER_ID=site_player_id
 
-# JWT 内站点/玩家字段名（与主站签发约定一致）
-# LOTTERY_JWT_ALGORITHM=HS256
-# LOTTERY_JWT_CLAIM_SITE_CODE=site_code
-# LOTTERY_JWT_CLAIM_SITE_PLAYER_ID=site_player_id
+# 主站站点根 URL（SSO、跳转等）
+MAIN_SITE_BASE_URL=
+# 主站 JWT 验签密钥（与主站约定，勿泄露）
+MAIN_SITE_SSO_JWT_SECRET=
+# 主站钱包接口基地址
+MAIN_SITE_WALLET_API_URL=
+# 主站钱包接口访问密钥
+MAIN_SITE_WALLET_API_KEY=
+# 主站钱包 HTTP 超时（秒）
+MAIN_SITE_WALLET_TIMEOUT=10
 
-# 主站 SSO / 钱包（名称可按实际接口调整）
-# MAIN_SITE_BASE_URL=
-# MAIN_SITE_SSO_JWT_SECRET=
-# MAIN_SITE_WALLET_API_URL=
-# MAIN_SITE_WALLET_API_KEY=
-# MAIN_SITE_WALLET_TIMEOUT=10
+# db:seed 演示玩家钱包：可用余额（最小货币单位，整数）
+DEV_SEED_WALLET_BALANCE_MINOR=125000
+# db:seed 演示玩家钱包：冻结余额（最小货币单位，整数）
+DEV_SEED_WALLET_FROZEN_MINOR=0
 
-# Sanctum：H5 / Next 管理端与 API 不同端口时需配置可识别的前端域名
-# SANCTUM_STATEFUL_DOMAINS=localhost,localhost:3000,127.0.0.1
-
-# Redis 库划分（可选，与 CACHE / SESSION 分开时用）
-# REDIS_DB=0
-# REDIS_CACHE_DB=1
+# Sanctum SPA 场景：与 API 不同端口的前端域名列表，逗号分隔，用于有状态 Cookie 鉴权
+SANCTUM_STATEFUL_DOMAINS=