GitLab

同步生成文件以匹配最新的 schema 与运行时变更

修复软删除拦截器使用错误，确保默认查询过滤已删记录
仓储层改用 ent.Tx 与扫描辅助，避免 sql.Tx 断言问题
同步更新集成测试以覆盖事务与统计变动

创建/删除用户失败时优先展示后端 message\n保留原有兜底提示

避免软删除钩子类型断言失败导致 500\n删除无记录时返回未找到错误并记录日志

问题：创建用户时发生 panic，错误信息为
"interface conversion: sql.ExecQuerier is *sql.Tx, not *sql.DB"

原因：基于事务创建的 ent client 在调用 Close() 时，ent 的 sql driver
会尝试将 ExecQuerier 断言为 *sql.DB 来关闭连接，但实际类型是 *sql.Tx

修复：移除对 txClient.Close() 的调用，事务的清理通过
sqlTx.Rollback() 和 sqlTx.Commit() 完成即可

影响范围：
- user_repo.go: Create 和 Update 方法
- group_repo.go: Delete 方法

🤖 Generated with [Claude Code](https://claude.com/claude-code

)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

覆盖管理员创建用户与注册流程的关键失败分支\n完善创建成功路径的断言

新增 AdminService 删除路径单元测试与规范场景更新\n同步调整 Google API Key 中间件测试桩与签名

- 新增 AccountService.Delete 方法的 4 个测试用例
- 新增 ApiKeyService.Delete 方法的 4 个测试用例
- 使用 stub 模式隔离数据库依赖，验证权限检查和缓存清理逻辑
- 添加详细的中文注释说明测试设计和预期行为

🤖 Generated with [Claude Code](https://claude.com/claude-code

)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

- 新增 ExistsByID 方法用于账号存在性检查，避免加载完整对象
- 新增 GetOwnerID 方法用于 API Key 所有权验证，仅查询 user_id 字段
- 优化 AccountService.Delete 使用轻量级存在性检查
- 优化 ApiKeyService.Delete 使用轻量级权限验证
- 改进前端删除错误提示，显示后端返回的具体错误消息
- 添加详细的中文注释说明优化原因

🤖 Generated with [Claude Code](https://claude.com/claude-code

)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

允许通过构建参数/脚本选项切换基础镜像来源，避免镜像源 403 影响构建

确保安装时至少存在一个默认分组

新增迁移补齐 cache_creation_5m_tokens/cache_creation_1h_tokens 列，并从旧列回填数据

新增 build_docker.sh 脚本，支持以下功能：
- -t, --tag: 指定镜像标签 (默认: latest)
- -r, --registry: 指定镜像仓库地址
- -p, --push: 构建后推送镜像到仓库
- --no-cache: 不使用 Docker 构建缓存

自动获取 Git 版本信息并注入到构建参数中。

🤖 Generated with [Claude Code](https://claude.com/claude-code

)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

该文件是 GORM 迁移到 Ent ORM 过程中遗留的，仍然导入了
gorm.io/gorm，导致 Docker 构建失败。

文件中的功能已被迁移到 SQL 迁移文件中：
- fixInvalidExpiresAt → 006_fix_invalid_subscription_expires_at.sql
- ensureDefaultGroups → 001_init.sql

🤖 Generated with [Claude Code](https://claude.com/claude-code

)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

通过迁移补种默认 groups 记录，避免新装空分组
迁移锁改为 try lock + 重试并加入超时
写入 usage_logs 时保留 rate_multiplier=0 语义
测试: go test ./...

将仓储层/基础设施改为 Ent + 原生 SQL 执行路径，并移除 AutoMigrate 与 GORM 依赖。
重构内容包括：
- 仓储层改用 Ent/SQL（含 usage_log/account 等复杂查询），统一错误映射
- 基础设施与 setup 初始化切换为 Ent + SQL migrations
- 集成测试与 fixtures 迁移到 Ent 事务模型
- 清理遗留 GORM 模型/依赖，补充迁移与文档说明
- 增加根目录 Makefile 便于前后端编译

测试：
- go test -tags unit ./...
- go test -tags integration ./...

- 移除 api_contract_test.go 中的 SettingKeySimpleMode 引用
- 移除期望响应中的 simple_mode 字段
- 修复 NewSettingHandler 调用参数数量

移除与 PR #66 冲突的旧版简易模式实现（commit 7d4b7dee）。
新版简易模式通过 run_mode 配置文件/环境变量控制，无需数据库设置。

后端变更：
- 移除 SettingKeySimpleMode 常量
- 移除 SystemSettings/PublicSettings 中的 SimpleMode 字段
- 移除 setting_handler 中的简易模式切换逻辑
- 移除 userService 依赖（不再需要自动设置管理员并发数）

前端变更：
- 移除 appStore.simpleMode 状态
- 移除设置页面的"使用模式"设置区块
- 移除 GroupsView 中的简易模式相关逻辑
- 移除相关国际化文案

- Remove unused simpleMode variable in AppSidebar.vue
- Add run_mode to AuthResponse.user type definition

**问题**：
1. login/register 未处理 run_mode，导致 authStore.runMode 不更新
2. 侧边栏使用 simpleMode.value，与路由守卫的 authStore.isSimpleMode 不一致

**修复**：
1. 在 login() 和 register() 中提取并设置 run_mode
2. 统一侧边栏使用 authStore.isSimpleMode

**影响**：
- 路由守卫现在可以正确工作
- 前端UI状态与后端配置保持一致
- 登录/注册后立即生效，无需刷新

由于简易模式会自动创建3个默认分组（anthropic-default, openai-default, gemini-default），
需要更新测试用例的预期数量：
- TestList: 期望5个分组（3个默认 + 2个测试）
- TestListActive: 期望4个活跃分组（3个默认 + 1个测试）
- TestListActiveByPlatform: 期望2个Anthropic分组（1个默认 + 1个测试）
- TestListWithFilters_Platform: 期望2个OpenAI分组（1个默认 + 1个测试）

**问题**：
- 使用 toISOString() 格式化日期导致UTC时区问题
- 在UTC+8时区凌晨时，日期会显示为前一天
- 日期范围初始化在 onMounted 中导致重复渲染和请求

**修复**：
- 统一使用本地时区格式化日期
- 在变量声明时就初始化日期范围，避免延迟初始化
- 移除 initializeDateRange() 函数，直接在声明时设置正确值
- 添加 formatLocalDate() 辅助函数统一日期格式化逻辑

**影响范围**：
- 用户仪表盘 (DashboardView)
- 管理员仪表盘 (admin/DashboardView)
- 用户使用记录 (UsageView)
- 管理员使用记录 (admin/UsageView)

**效果**：
- 日期范围正确包含当天数据
- 避免页面加载时的重复请求
- 改善用户体验，减少不必要的重新渲染

**功能概述**：
实现简易模式(Simple Mode)，为个人用户和小团队提供简化的使用体验，隐藏复杂的分组、订阅、配额等概念。

**后端改动**：
1. 配置系统
   - 新增 run_mode 配置项（standard/simple）
   - 支持环境变量 RUN_MODE
   - 默认值为 standard

2. 数据库初始化
   - 自动创建3个默认分组：anthropic-default、openai-default、gemini-default
   - 默认分组配置：无并发限制、active状态、非独占
   - 幂等性保证：重复启动不会重复创建

3. 账号管理
   - 创建账号时自动绑定对应平台的默认分组
   - 如果未指定分组，自动查找并绑定默认分组

**前端改动**：
1. 状态管理
   - authStore 新增 isSimpleMode 计算属性
   - 从后端API获取并同步运行模式

2. UI隐藏
   - 侧边栏：隐藏分组管理、订阅管理、兑换码菜单
   - 账号管理页面：隐藏分组列
   - 创建/编辑账号对话框：隐藏分组选择器

3. 路由守卫
   - 限制访问分组、订阅、兑换码相关页面
   - 访问受限页面时自动重定向到仪表板

**配置示例**：
```yaml
run_mode: simple

run_mode: standard
```

**影响范围**：
- 后端：配置、数据库迁移、账号服务
- 前端：认证状态、路由、UI组件
- 部署：配置文件示例

**兼容性**：
- 简易模式和标准模式可无缝切换
- 不需要数据迁移
- 现有数据不受影响

- 添加 OpenAI/Gemini 平台的 baseUrlHint 和 apiKeyHint 国际化文案
- 修改 CreateAccountModal 和 EditAccountModal 根据平台显示正确提示
- 将重复的平台判断逻辑抽取为 computed 属性，优化代码结构

问题：
1. WindowStats 与 API 响应一起缓存 10 分钟，导致费用数据更新延迟
2. 当 5h 窗口未激活（ResetsAt 为空）时，FiveHour 为 nil，导致所有窗口的 WindowStats 都无法显示

修复：
- 分离缓存：API 响应缓存 10 分钟，窗口统计独立缓存 1 分钟
- RemainingSeconds 每次请求时实时计算
- FiveHour 对象始终创建（即使 ResetsAt 为空）
- addWindowStats 增强防护，支持 FiveHour 为 nil 时仍处理其他窗口

API 响应新增 simple_mode 字段，同步更新测试期望值

- 测试文件添加第三个参数 userService（nil）
- Handler 添加 userService 空指针检查，防止测试环境 panic

- 修改下拉框宽度策略为 min-w-full w-max max-w-[300px]，允许自动扩展
- 添加 left-0 确保下拉框左对齐
- 为选项标签添加 flex-1 min-w-0 text-left 确保正确布局

新增简单模式设置，适合个人使用场景：
- 隐藏多用户管理相关菜单（用户管理、兑换码等）
- 自动关闭用户注册功能
- 管理员并发数自动设为无限制(99999)
- 侧边栏根据模式动态调整菜单项

同时优化分组页面的"专属分组"功能，添加帮助提示说明使用场景

- 移除未使用的 hasExpandableActions 计算属性
- 移除未使用的 toggleActionsExpanded 函数
- 修复 TypeScript 类型检查错误

- 移除操作列表头的展开/折叠按钮和图标
- 该功能已被操作列内的'更多'按钮替代
- 保留底层的展开/收起逻辑供'更多'按钮使用

- 修复RedeemView订阅刷新失败导致流程中断的问题
  将订阅刷新隔离到独立try/catch，失败时仅显示警告
- 修复DataTable resize事件监听器泄漏问题
  确保添加和移除使用同一个回调引用
- 修复订阅状态缓存导致强制刷新失效的问题
  force=true时绕过activePromise缓存，clear()清空缓存
- 修复图表主题切换后颜色不更新的问题
  添加图表ref并在主题切换时调用update()方法

- 在 Dashboard 页面加载时强制刷新订阅状态
- 在兑换订阅卡密后立即刷新订阅状态
- 清理订阅轮询相关注释