签入版本

CLAUDE.md

@@ -16,6 +16,7 @@ GoFrame v2 后端已按 `document/architecture.md`（唯一权威定稿）完整
 
 - **主键统一 int 数据库自增**（2026-10-13 定稿）：禁用雪花算法（`utility/id` 已删除）；新增后用 `result.LastInsertId()` 回读；hooks 不填 id
 - 软删列统一 `del_flag`；表前缀 `goframe_`
+- **配置环境变量覆盖**（2026-10-20 定稿）：`utility/config.RegisterEnvOverride()` 在 cmd.Run 最先接线 env-first 适配器（包装默认文件适配器，gcfg.Adapter 官方扩展点），12-Factor 优先级 GF_ 环境变量 > config.yaml；键名=配置路径大写下划线（`database.default.link` → `GF_DATABASE_DEFAULT_LINK`，**不存在 GF_GENV_ 前缀**）；仅覆盖配置文件已有键，空值视为未设置；docker 部署经 compose environment 块把 .env 友好名（MYSQL_HOST 等）映射为 GF_ 规范键，勿原名透传
 - 新增模块四件套平铺放置（api/v1、controller、logic、service 各一文件，同包 init 自动注册，无需 blank import）；service 接口手维护；路由注册由生成器自动写入或手动 `router.go` `Bind(controller.CXxx)`
 - **定时任务处理方法在 `internal/task`**：调度器与注册表在 internal/logic 的 job 模块（`logic.RegisterJobHandler`）；任务实现平铺 `internal/task/{任务名}.go`，init 中自注册（注册名=url 字段值，http(s) 地址除外），依赖单向 task→logic（任务可复用 base 共享能力，logic 禁止反向 import task）；由 `internal/cmd` 空白导入触发加载；调度消费 execute_policy（1并行/2单例/3放弃）与 is_sync（1同步/0异步），策略2/3叠加 `job:lock:{id}` 执行锁（utility/cache SET NX，多实例共享，TTL 300s 兜底）；内置 LogClean 任务每日 02:30 分批物理清理三张日志表（保留天数 `job.logRetentionDays` 默认90，任务参数 retentionDays 可覆盖）
 - **monitor 域三个无表模块**：在线用户（`/onlineUser/page`+`forceLogout`，登录 MarkOnline/登出 MarkOffline 写 `online:jti` zset+info 键，踢出=拉黑 jti）、服务器监控（`/server/info`：runtime/磁盘分平台文件 server_monitor_windows/other.go/MySQL/Redis 连通）、缓存监控（`/cache/info`：Redis INFO 解析，内存降级时返回 mode=memory）；前端 `ui/src/views/monitor/{online,server,cache}`；OpenAPI 经 bind.go 补注册后 `/api.json` 全量可用