release: v1.0.3 bug fix release

v1.0.3 定位为 bug fix release，收口 v1.0.2 引入的破坏性清理并修复
4 个轻量 bug + 依赖复查 + 版本号治理 + 文档对齐。同时包含此前未提交
的 v1.0.2 全部工作。

v1.0.3 变更：

Fixed:
- generateJTI 忽略 rand.Read 错误（jwt）— 改为 (string, error) 并传播
- QueryBuilder.Page Count 受残留 Limit 截断（repository）— countDB 加 Limit(-1).Offset(-1)
- OSS/本地存储文件名冲突（storage）— 新增 uniqueFilename 加 8 字节随机后缀
- 数据库重试策略对不可恢复错误无效（database）— 新增 isTransientDBError

Dependencies:
- go mod tidy 补全 postgres 方言传递依赖；安全补丁升级
  x/crypto v0.49→v0.53、golang-jwt/jwt/v5 v5.2.1→v5.3.1、gorilla/websocket v1.5.1→v1.5.3

Removed:
- Breaking: 清理 v1.0.2 兼容别名（InitMySQL* / driverName）
- 死代码 database.DBResolver
- 代码中 292 行"评分/理由"自夸注释（#26，23 个文件）

Changed:
- Breaking: 错误码体系重构 CodeSuccess 1→0、CodeFail 0→1，删除 CodeInvalidParams，加编译期防撞码
- database/mysql.go → manager.go；Logger 拆分三独立 core 修复 Tee 重复写入
- 版本号常量化：app.go 新增 const Version 作为唯一来源，CLI/脚手架模板引用之，不再散落字面量

Security:
- CORS 中间件按 W3C 规范修复 Allow-Credentials / Vary: Origin / 非白名单不回显

Added:
- console 包显式 level 控制（SetLevel/WithLevel/LevelSilent，atomic.Int32 并发安全）
- 新增测试 jwt/repository/storage/database/router/middleware/app
- 文档：新增 CHANGELOG.md、Version_v1.0.2_report.md；更新 README/GUIDE 顶部更新日志
- 文档对齐：删除对不存在的 config.DefaultManager() getter 的描述（保持 API 与文档一致）

详见 CHANGELOG.md 与 README.md 更新日志。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

cache/keybuilder.go

@@ -9,8 +9,6 @@ import (
 )
 
 // KeyBuilder 缓存键名构建器
-// 评分: ⭐⭐⭐⭐⭐
-// 理由: 多项目共用 Redis 时，通过前缀避免 key 冲突
 // 使用场景: 多个小项目共用一台 Redis 服务器，每个项目设置不同前缀
 type KeyBuilder struct {
 	prefix     string // 项目/站点前缀，如 "site_a"
@@ -22,8 +20,6 @@ type KeyBuilder struct {
 type KeyBuilderOption func(*KeyBuilder)
 
 // WithPrefix 设置前缀（项目/站点别名）
-// 评分: ⭐⭐⭐⭐⭐
-// 理由: 核心配置，用于区分不同项目
 // 示例: WithPrefix("site_a") -> 所有 key 自动添加 "site_a" 前缀
 func WithPrefix(prefix string) KeyBuilderOption {
 	return func(kb *KeyBuilder) {
@@ -32,8 +28,6 @@ func WithPrefix(prefix string) KeyBuilderOption {
 }
 
 // WithSeparator 设置分隔符
-// 评分: ⭐⭐⭐⭐
-// 理由: 可自定义分隔符，适应不同命名风格
 // 示例: WithSeparator(":") -> "site_a:user:1"
 func WithSeparator(separator string) KeyBuilderOption {
 	return func(kb *KeyBuilder) {
@@ -42,8 +36,6 @@ func WithSeparator(separator string) KeyBuilderOption {
 }
 
 // WithCacheType 设置缓存类型标识
-// 评分: ⭐⭐⭐⭐
-// 理由: 区分缓存用途，便于管理
 // 示例: WithCacheType("session") -> "session_site_a_user:1"
 func WithCacheType(cacheType string) KeyBuilderOption {
 	return func(kb *KeyBuilder) {
@@ -52,8 +44,6 @@ func WithCacheType(cacheType string) KeyBuilderOption {
 }
 
 // NewKeyBuilder 创建键名构建器
-// 评分: ⭐⭐⭐⭐⭐
-// 理由: 链式配置，灵活易用
 func NewKeyBuilder(opts ...KeyBuilderOption) *KeyBuilder {
 	kb := &KeyBuilder{
 		prefix:     "",
@@ -67,8 +57,6 @@ func NewKeyBuilder(opts ...KeyBuilderOption) *KeyBuilder {
 }
 
 // Build 构建完整键名
-// 评分: ⭐⭐⭐⭐⭐
-// 理由: 自动拼接前缀，避免手动拼接错误
 // 格式: {cacheType}{separator}{prefix}{separator}{key}
 // 示例: kb.Build("user:1") -> "cache_site_a_user:1"
 func (kb *KeyBuilder) Build(key string) string {
@@ -84,8 +72,6 @@ func (kb *KeyBuilder) Build(key string) string {
 }
 
 // BuildTemp 构建临时缓存键名（带过期时间）
-// 评分: ⭐⭐⭐⭐⭐
-// 理由: 区分临时和永久缓存，便于批量管理
 // 格式: "temp{separator}{prefix}{separator}{key}"
 func (kb *KeyBuilder) BuildTemp(key string) string {
 	parts := []string{"temp"}
@@ -97,8 +83,6 @@ func (kb *KeyBuilder) BuildTemp(key string) string {
 }
 
 // BuildPerm 构建永久缓存键名（不带过期时间）
-// 评分: ⭐⭐⭐⭐⭐
-// 理由: 永久存储的数据使用不同标识
 // 格式: "perm{separator}{prefix}{separator}{key}"
 func (kb *KeyBuilder) BuildPerm(key string) string {
 	parts := []string{"perm"}
@@ -110,8 +94,6 @@ func (kb *KeyBuilder) BuildPerm(key string) string {
 }
 
 // BuildLock 构建分布式锁键名
-// 评分: ⭐⭐⭐⭐⭐
-// 理由: 锁使用独立命名空间，避免与业务缓存冲突
 // 格式: "lock{separator}{prefix}{separator}{key}"
 func (kb *KeyBuilder) BuildLock(key string) string {
 	parts := []string{"lock"}
@@ -123,8 +105,6 @@ func (kb *KeyBuilder) BuildLock(key string) string {
 }
 
 // BuildCounter 构建计数器键名
-// 评分: ⭐⭐⭐⭐⭐
-// 理由: 计数器使用独立命名空间
 // 格式: "counter{separator}{prefix}{separator}{key}"
 func (kb *KeyBuilder) BuildCounter(key string) string {
 	parts := []string{"counter"}
@@ -136,8 +116,6 @@ func (kb *KeyBuilder) BuildCounter(key string) string {
 }
 
 // BuildSession 构建会话键名
-// 评分: ⭐⭐⭐⭐⭐
-// 理由: 会话缓存统一管理
 // 格式: "session{separator}{prefix}{separator}{key}"
 func (kb *KeyBuilder) BuildSession(key string) string {
 	parts := []string{"session"}
@@ -149,8 +127,6 @@ func (kb *KeyBuilder) BuildSession(key string) string {
 }
 
 // BuildPattern 构建匹配模式（用于 SCAN/Keys）
-// 评分: ⭐⭐⭐⭐⭐
-// 理由: 批量查询/删除时使用
 // 示例: kb.BuildPattern("user:*") -> "cache_site_a_user:*"
 func (kb *KeyBuilder) BuildPattern(pattern string) string {
 	return kb.Build(pattern)
@@ -162,8 +138,6 @@ func (kb *KeyBuilder) GetPrefix() string {
 }
 
 // SetPrefix 动态设置前缀
-// 评分: ⭐⭐⭐⭐
-// 理由: 运行时可切换前缀，适用于多租户场景
 func (kb *KeyBuilder) SetPrefix(prefix string) *KeyBuilder {
 	kb.prefix = prefix
 	return kb
@@ -174,8 +148,6 @@ func (kb *KeyBuilder) SetPrefix(prefix string) *KeyBuilder {
 var globalKeyBuilder *KeyBuilder
 
 // InitKeyBuilder 初始化全局键名构建器
-// 评分: ⭐⭐⭐⭐⭐
-// 理由: 应用启动时配置，全局统一命名
 // 参数: prefix 站点别名，如果为空则自动从配置读取
 // 示例:
 //
@@ -196,8 +168,6 @@ func InitKeyBuilder(prefix string, opts ...KeyBuilderOption) {
 }
 
 // AutoInitKeyBuilder 自动从配置初始化键名构建器
-// 评分: ⭐⭐⭐⭐⭐
-// 理由: 无需手动传入参数，完全依赖配置文件
 // 配置示例:
 //
 //	app:
@@ -208,8 +178,6 @@ func AutoInitKeyBuilder(opts ...KeyBuilderOption) {
 }
 
 // GetKeyBuilder 获取全局键名构建器
-// 评分: ⭐⭐⭐⭐⭐
-// 理由: 如果未初始化，自动从配置创建
 func GetKeyBuilder() *KeyBuilder {
 	if globalKeyBuilder == nil {
 		// 自动从配置初始化
@@ -219,8 +187,6 @@ func GetKeyBuilder() *KeyBuilder {
 }
 
 // K 快捷构建键名（使用全局构建器）
-// 评分: ⭐⭐⭐⭐⭐
-// 理由: 简短易用，减少代码量
 // 示例: cache.K("user:1") -> 自动添加前缀
 func K(key string) string {
 	return GetKeyBuilder().Build(key)
@@ -254,8 +220,6 @@ func KSession(key string) string {
 // ===== 带键名构建器的缓存操作 =====
 
 // SetWithPrefix 带前缀的缓存设置
-// 评分: ⭐⭐⭐⭐⭐
-// 理由: 自动添加前缀，简化调用
 func SetWithPrefix(ctx context.Context, key string, value any, ttl time.Duration, prefix string) error {
 	kb := NewKeyBuilder(WithPrefix(prefix))
 	return GetCache().Set(ctx, kb.Build(key), value, ttl)

cache/lock.go

@@ -58,8 +58,6 @@ end
 `
 
 // NewLock 创建分布式锁
-// 评分: ⭐⭐⭐⭐⭐
-// 理由: 使用 UUID 作为 Token，保证锁的安全释放
 // 参数: key 锁名称，ttl 锁定时长
 // 返回: LockToken 用于后续解锁或续期
 func NewLock(ctx context.Context, key string, ttl time.Duration) (*LockToken, error) {
@@ -93,8 +91,6 @@ func Lock(ctx context.Context, key string, ttl time.Duration) (bool, error) {
 }
 
 // Unlock 安全释放锁
-// 评分: ⭐⭐⭐⭐⭐
-// 理由: 使用 Lua 脚本保证只有锁的持有者才能释放
 func Unlock(ctx context.Context, token *LockToken) error {
 	if database.RedisClient == nil {
 		return ErrRedisNotReady
@@ -126,8 +122,6 @@ func UnlockByKey(ctx context.Context, key string) error {
 }
 
 // ExtendLock 续期锁
-// 评分: ⭐⭐⭐⭐⭐
-// 理由: 长任务执行时防止锁过期被其他客户端抢占
 // 参数: token 锁令牌，ttl 新的过期时间
 func ExtendLock(ctx context.Context, token *LockToken, ttl time.Duration) error {
 	if database.RedisClient == nil {
@@ -153,8 +147,6 @@ func ExtendLock(ctx context.Context, token *LockToken, ttl time.Duration) error
 }
 
 // TryLock 尝试获取锁，失败时等待重试
-// 评分: ⭐⭐⭐⭐⭐
-// 理由: 高并发场景常用，避免立即失败
 func TryLock(ctx context.Context, key string, ttl time.Duration, retryInterval time.Duration, maxRetry int) (*LockToken, error) {
 	for i := 0; i < maxRetry; i++ {
 		token, err := NewLock(ctx, key, ttl)
@@ -170,8 +162,6 @@ func TryLock(ctx context.Context, key string, ttl time.Duration, retryInterval t
 }
 
 // WithLock 使用分布式锁执行函数（自动管理锁）
-// 评分: ⭐⭐⭐⭐⭐
-// 理由: 自动获取、续期、释放锁，避免忘记释放
 // 参数: key 锁名称，ttl 锁定时长，fn 业务函数
 // 注意: 如果任务执行时间超过 ttl，需要设置更长的 ttl 或使用 WithLockAutoExtend
 func WithLock(ctx context.Context, key string, ttl time.Duration, fn func() error) error {
@@ -188,8 +178,6 @@ func WithLock(ctx context.Context, key string, ttl time.Duration, fn func() erro
 }
 
 // WithLockAutoExtend 使用分布式锁执行函数（自动续期）
-// 评分: ⭐⭐⭐⭐⭐
-// 理由: 长任务执行时自动续期，防止锁过期
 // 参数: key 锁名称，initialTTL 初始锁定时长，extendInterval 续期间隔，fn 业务函数
 func WithLockAutoExtend(ctx context.Context, key string, initialTTL time.Duration, extendInterval time.Duration, fn func() error) error {
 	token, err := NewLock(ctx, key, initialTTL)