feat: 锁定 SQLite 数据库选型(MVP)

- 架构图/SPEC.md/database.md 同步更新
- 移除 Alembic 迁移工具,改用 schema.sql 初始化
This commit is contained in:
2026-04-14 11:46:40 +08:00
parent 0c37da0744
commit b985912234
3 changed files with 14 additions and 13 deletions

View File

@@ -37,7 +37,7 @@
|------|----------| |------|----------|
| 后台 API | Python / FastAPI或 Flask | | 后台 API | Python / FastAPI或 Flask |
| H5 前端 | 原生 HTML/CSS/JS无框架依赖 | | H5 前端 | 原生 HTML/CSS/JS无框架依赖 |
| 数据库 | PostgreSQL / SQLiteMVP 阶段) | | 数据库 | SQLiteMVP 阶段) |
| 文件存储 | 阿里云 OSSBucket: jesxion-ai-studio, Region: oss-cn-beijing | | 文件存储 | 阿里云 OSSBucket: jesxion-ai-studio, Region: oss-cn-beijing |
| 设备数据 | 已有第三方 API塔吊/升降机) | | 设备数据 | 已有第三方 API塔吊/升降机) |
@@ -47,3 +47,4 @@
|------|------|----------| |------|------|----------|
| 2026-04-14 | v0.1.0 | 初始化草稿,架构设计 | | 2026-04-14 | v0.1.0 | 初始化草稿,架构设计 |
| 2026-04-14 | v0.1.1 | 锁定预警轮询、JWT 7天、OSS Bucket 配置 | | 2026-04-14 | v0.1.1 | 锁定预警轮询、JWT 7天、OSS Bucket 配置 |
| 2026-04-14 | v0.1.2 | 锁定 SQLite 数据库 |

View File

@@ -26,8 +26,8 @@
└────────────┬────────────┘ │ └────────────┬────────────┘ │
│ │ │ │
▼ │ ▼ │
┌─────────────────────────┐ ┌─────────────────────────┐
PostgreSQL │ SQLite
│ (设备台账/预警记录/ │◀────────────┘ │ (设备台账/预警记录/ │◀────────────┘
│ 用户/OSS文件索引) │ │ 用户/OSS文件索引) │
└─────────────────────────┘ └─────────────────────────┘

View File

@@ -1,6 +1,6 @@
# 数据库表结构设计 # 数据库表结构设计
> 状态: 设计中MVP 版本,PostgreSQL > 状态: 设计中MVP 版本SQLite
--- ---
@@ -170,26 +170,26 @@ oss_files ───────────────────────
--- ---
## 4. 迁移工具 ## 4. 数据库初始化
使用 **Alembic** 管理数据库迁移 MVP 阶段使用 SQLite`schema.sql` 定义建表语句,启动时自动初始化
```bash ```bash
# 初始化 # 手动初始化(可选,生产环境自动执行)
alembic init alembic sqlite3 smart_project.db < schema.sql
# 生成迁移脚本 # 或通过 Python 脚本
alembic revision --autogenerate -m "init schema" python -m src.db.init_db
# 执行迁移
alembic upgrade head
``` ```
> SQLite 无需迁移工具,每次表结构变更手动更新 `schema.sql` 并重启服务即可。
--- ---
## 5. 待确认 ## 5. 待确认
- [x] OSS Bucket → `jesxion-ai-studio`(开发测试阶段) - [x] OSS Bucket → `jesxion-ai-studio`(开发测试阶段)
- [x] 数据库 → SQLiteMVP
- [ ] 设备历史数据保留策略(多久归档到 OSS - [ ] 设备历史数据保留策略(多久归档到 OSS
- [ ] 多租户隔离方案MVP 单租户,后续扩展) - [ ] 多租户隔离方案MVP 单租户,后续扩展)
- [ ] 预警阈值配置(存 DB 还是配置文件) - [ ] 预警阈值配置(存 DB 还是配置文件)