mirror of
https://github.com/fawney19/Aether.git
synced 2026-09-02 09:20:22 +08:00
97b0146ce9
后端: - SQL count 查询统一改用 func.count() 子查询替代 query.count() - Dashboard/Audit 等页面多次独立查询合并为单次聚合查询 - Provider summary 列表改为批量查询消除 N+1 问题 - DailyStats 逐天循环查询改为 CASE 分桶单次查询 - 使用 load_only() 减少不必要的列加载 - cache_decorator 支持嵌套属性路径解析(dotted vary_by) - 多个管理/公共端点新增 @cache_result 缓存装饰 前端: - cache.ts 新增 in-flight 请求复用、dedupedRequest、buildCacheKey - 大量 API 调用添加前端缓存或去重 - 多个页面定时器在标签页隐藏时暂停、可见时恢复 - Auth 检查从 setInterval 改为 storage + visibilitychange 事件驱动 - 请求竞态防护(requestId 模式) 数据库: - Usage 表新增 idx_usage_status_user_created 复合索引
Aether - 数据库迁移说明
当前版本
- Revision ID:
aether_baseline - 创建日期: 2025-12-06
- 状态: 全新基线
迁移历史
所有历史增量迁移已清理，当前以完整 schema 作为新起点。
核心数据库结构
用户系统
- users: 用户账户管理
- api_keys: API 密钥管理
- user_quotas: 用户配额管理
- user_preferences: 用户偏好设置
Provider 三层架构
- providers: LLM 提供商配置
- provider_endpoints: Provider 的 API 端点配置
- provider_api_keys: Endpoint 的具体 API 密钥
- api_key_provider_mappings: 用户 API Key 到 Provider 的映射关系
模型系统
- global_models: 统一模型定义（GlobalModel）
- models: Provider 的模型实现和价格配置
- model_mappings: 统一的别名与降级映射表
监控和追踪
- usage: API 使用记录
- request_candidates: 请求候选记录
- provider_usage_tracking: Provider 使用统计
- audit_logs: 系统审计日志
系统功能
- announcements: 系统公告
- announcement_reads: 公告阅读记录
- system_configs: 系统配置
从旧数据库迁移
如需从旧数据库迁移数据，请使用迁移脚本：
# 设置环境变量
export OLD_DATABASE_URL="postgresql://user:pass@old-host:5432/old_db"
export NEW_DATABASE_URL="postgresql://user:pass@new-host:5432/aether"
# 干运行（查看迁移量）
python scripts/migrate_data.py --dry-run
# 执行迁移
python scripts/migrate_data.py
# 只迁移特定表
python scripts/migrate_data.py --tables users,providers,api_keys
# 跳过大表
python scripts/migrate_data.py --skip usage,audit_logs
新数据库初始化
# 1. 运行迁移创建表结构
DATABASE_URL="postgresql://user:pass@host:5432/aether" uv run alembic upgrade head
# 2. 初始化管理员账户
python -m src.database.init_db
未来迁移
基于 aether_baseline 创建增量迁移：
# 修改模型后，生成新的迁移
DATABASE_URL="..." uv run alembic revision --autogenerate -m "描述变更"
# 应用迁移
DATABASE_URL="..." uv run alembic upgrade head