diff --git a/SPEC.md b/SPEC.md index 9192641..83ab494 100644 --- a/SPEC.md +++ b/SPEC.md @@ -38,7 +38,7 @@ | 后台 API | Python / FastAPI(或 Flask) | | H5 前端 | 原生 HTML/CSS/JS,无框架依赖 | | 数据库 | PostgreSQL / SQLite(MVP 阶段) | -| 文件存储 | 阿里云 OSS | +| 文件存储 | 阿里云 OSS(Bucket: jesxion-ai-studio, Region: oss-cn-beijing) | | 设备数据 | 已有第三方 API(塔吊/升降机) | ### 文档更新记录 @@ -46,3 +46,4 @@ | 日期 | 版本 | 更新内容 | |------|------|----------| | 2026-04-14 | v0.1.0 | 初始化草稿,架构设计 | +| 2026-04-14 | v0.1.1 | 锁定预警轮询、JWT 7天、OSS Bucket 配置 | diff --git a/docs/api.md b/docs/api.md index a3f0f1f..5e8000c 100644 --- a/docs/api.md +++ b/docs/api.md @@ -210,6 +210,8 @@ POST /alerts/{alert_id}/ignore ## 5. OSS 文件接口 +> OSS 配置(开发测试): Bucket=`jesxion-ai-studio`, Region=`oss-cn-beijing` + ### 5.1 获取上传凭证(预签名 URL) ``` @@ -288,7 +290,8 @@ GET /oss/download-url ## 7. 待确认 -- [ ] 设备 API 协议格式(塔吊/升降机数据字段) +- [x] 预警推送机制 → 轮询(前端每 30s) +- [x] JWT 有效期 → 7 天 +- [x] OSS 配置 → Bucket=`jesxion-ai-studio`, Region=`oss-cn-beijing` +- [ ] 设备 API 协议格式(塔吊/升降机数据字段)— 厂家文档后续提供 - [ ] JWT Secret 如何管理 -- [ ] 预警推送机制(轮询 vs WebSocket) -- [ ] OSS bucket 名称和目录结构 diff --git a/docs/database.md b/docs/database.md index 249813c..b4f94a5 100644 --- a/docs/database.md +++ b/docs/database.md @@ -189,6 +189,7 @@ alembic upgrade head ## 5. 待确认 +- [x] OSS Bucket → `jesxion-ai-studio`(开发测试阶段) - [ ] 设备历史数据保留策略(多久归档到 OSS) - [ ] 多租户隔离方案(MVP 单租户,后续扩展) - [ ] 预警阈值配置(存 DB 还是配置文件)