## 1. 依赖与配置 - [x] 1.1 添加 `redis`、`pymysql` 依赖到 `requirements.txt` - [x] 1.2 在 `app/config.py` 中新增 Redis 和 MySQL 连接配置项(host、port、user、password、database) - [x] 1.3 在 `docker-compose.yml` 中新增 Redis 和 MySQL 服务定义 ## 2. 数据库模型与初始化 - [x] 2.1 创建 `app/mysql_database.py`,实现 MySQL 连接引擎和 SessionLocal - [x] 2.2 创建 `app/redis_client.py`,实现 Redis 连接池和客户端封装 - [x] 2.3 在 `app/main.py` 的 `lifespan` 中初始化 Redis 和 MySQL 连接,检测可用性 - [x] 2.4 创建 MySQL 表结构初始化脚本(复用现有 ORM 模型) ## 3. 数据迁移 - [x] 3.1 创建数据迁移脚本,从 SQLite 读取历史数据并写入 MySQL - [x] 3.2 在应用启动时检测 MySQL 表是否为空,自动触发迁移 ## 4. 存储管理层 - [x] 4.1 创建 `app/storage_manager.py`,实现 `StorageManager` 抽象层 - [x] 4.2 实现 Redis 缓存读取逻辑(命中返回,未命中回源 MySQL 并回填) - [x] 4.3 实现 MySQL 持久化读写逻辑 - [x] 4.4 实现三级降级策略(Redis → MySQL → SQLite) - [x] 4.5 实现降级状态检测和恢复机制 ## 5. 双写与缓存一致性 - [x] 5.1 实现刷新接口双写逻辑:先删 Redis 缓存,再写 MySQL,最后更新 Redis - [x] 5.2 实现双写顺序保证和错误处理(MySQL 失败回滚,Redis 失败记录日志) - [x] 5.3 实现缓存未命中回填逻辑(TTL 30 天) ## 6. 接口改造 - [x] 6.1 改造 `app/services/cache.py` 中的行情数据读取接口,使用 `StorageManager` - [x] 6.2 改造 `app/services/cache.py` 中的刷新接口,使用双写逻辑 - [x] 6.3 改造 `app/services/cache.py`,使用 `StorageManager` 写入数据(API 层零改动) ## 7. 测试与验证 - [x] 7.1 验证 Redis 缓存命中场景 - [x] 7.2 验证 Redis 缓存未命中回源 MySQL 场景 - [x] 7.3 验证 Redis 不可用降级到 MySQL 场景 - [x] 7.4 验证 Redis 和 MySQL 均不可用降级到 SQLite 场景 - [x] 7.5 验证刷新接口双写一致性 - [x] 7.6 验证数据迁移完整性