feat: 锁定 SQLite 数据库选型(MVP)
- 架构图/SPEC.md/database.md 同步更新 - 移除 Alembic 迁移工具,改用 schema.sql 初始化
This commit is contained in:
3
SPEC.md
3
SPEC.md
@@ -37,7 +37,7 @@
|
|||||||
|------|----------|
|
|------|----------|
|
||||||
| 后台 API | Python / FastAPI(或 Flask) |
|
| 后台 API | Python / FastAPI(或 Flask) |
|
||||||
| H5 前端 | 原生 HTML/CSS/JS,无框架依赖 |
|
| H5 前端 | 原生 HTML/CSS/JS,无框架依赖 |
|
||||||
| 数据库 | PostgreSQL / SQLite(MVP 阶段) |
|
| 数据库 | SQLite(MVP 阶段) |
|
||||||
| 文件存储 | 阿里云 OSS(Bucket: jesxion-ai-studio, Region: oss-cn-beijing) |
|
| 文件存储 | 阿里云 OSS(Bucket: 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 数据库 |
|
||||||
|
|||||||
@@ -26,8 +26,8 @@
|
|||||||
└────────────┬────────────┘ │
|
└────────────┬────────────┘ │
|
||||||
│ │
|
│ │
|
||||||
▼ │
|
▼ │
|
||||||
┌─────────────────────────┐ │
|
┌─────────────────────────┐
|
||||||
│ PostgreSQL │ │
|
│ SQLite │
|
||||||
│ (设备台账/预警记录/ │◀────────────┘
|
│ (设备台账/预警记录/ │◀────────────┘
|
||||||
│ 用户/OSS文件索引) │
|
│ 用户/OSS文件索引) │
|
||||||
└─────────────────────────┘
|
└─────────────────────────┘
|
||||||
|
|||||||
@@ -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] 数据库 → SQLite(MVP)
|
||||||
- [ ] 设备历史数据保留策略(多久归档到 OSS)
|
- [ ] 设备历史数据保留策略(多久归档到 OSS)
|
||||||
- [ ] 多租户隔离方案(MVP 单租户,后续扩展)
|
- [ ] 多租户隔离方案(MVP 单租户,后续扩展)
|
||||||
- [ ] 预警阈值配置(存 DB 还是配置文件)
|
- [ ] 预警阈值配置(存 DB 还是配置文件)
|
||||||
|
|||||||
Reference in New Issue
Block a user