diff --git a/SPEC.md b/SPEC.md index 83ab494..094fb04 100644 --- a/SPEC.md +++ b/SPEC.md @@ -37,7 +37,7 @@ |------|----------| | 后台 API | Python / FastAPI(或 Flask) | | H5 前端 | 原生 HTML/CSS/JS,无框架依赖 | -| 数据库 | PostgreSQL / SQLite(MVP 阶段) | +| 数据库 | SQLite(MVP 阶段) | | 文件存储 | 阿里云 OSS(Bucket: jesxion-ai-studio, Region: oss-cn-beijing) | | 设备数据 | 已有第三方 API(塔吊/升降机) | @@ -47,3 +47,4 @@ |------|------|----------| | 2026-04-14 | v0.1.0 | 初始化草稿,架构设计 | | 2026-04-14 | v0.1.1 | 锁定预警轮询、JWT 7天、OSS Bucket 配置 | +| 2026-04-14 | v0.1.2 | 锁定 SQLite 数据库 | diff --git a/docs/architecture.md b/docs/architecture.md index ae52645..885ab68 100644 --- a/docs/architecture.md +++ b/docs/architecture.md @@ -26,8 +26,8 @@ └────────────┬────────────┘ │ │ │ ▼ │ - ┌─────────────────────────┐ │ - │ PostgreSQL │ │ + ┌─────────────────────────┐ + │ SQLite │ │ (设备台账/预警记录/ │◀────────────┘ │ 用户/OSS文件索引) │ └─────────────────────────┘ diff --git a/docs/database.md b/docs/database.md index b4f94a5..f7cbbdb 100644 --- a/docs/database.md +++ b/docs/database.md @@ -1,6 +1,6 @@ # 数据库表结构设计 -> 状态: 设计中(MVP 版本,PostgreSQL) +> 状态: 设计中(MVP 版本,SQLite) --- @@ -170,26 +170,26 @@ oss_files ─────────────────────── --- -## 4. 迁移工具 +## 4. 数据库初始化 -使用 **Alembic** 管理数据库迁移: +MVP 阶段使用 SQLite,`schema.sql` 定义建表语句,启动时自动初始化: ```bash -# 初始化 -alembic init alembic +# 手动初始化(可选,生产环境自动执行) +sqlite3 smart_project.db < schema.sql -# 生成迁移脚本 -alembic revision --autogenerate -m "init schema" - -# 执行迁移 -alembic upgrade head +# 或通过 Python 脚本 +python -m src.db.init_db ``` +> SQLite 无需迁移工具,每次表结构变更手动更新 `schema.sql` 并重启服务即可。 + --- ## 5. 待确认 - [x] OSS Bucket → `jesxion-ai-studio`(开发测试阶段) +- [x] 数据库 → SQLite(MVP) - [ ] 设备历史数据保留策略(多久归档到 OSS) - [ ] 多租户隔离方案(MVP 单租户,后续扩展) - [ ] 预警阈值配置(存 DB 还是配置文件)