feat: 锁定已确认的设计决策

- 预警推送: 轮询(前端每30s)
- JWT有效期: 7天
- OSS: Bucket=jesxion-ai-studio, Region=oss-cn-beijing
- 待确认项: 设备API协议(JWT Secret待定)
This commit is contained in:
2026-04-14 11:44:29 +08:00
parent 86777f585e
commit 0c37da0744
3 changed files with 9 additions and 4 deletions

View File

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

View File

@@ -210,6 +210,8 @@ POST /alerts/{alert_id}/ignore
## 5. OSS 文件接口 ## 5. OSS 文件接口
> OSS 配置(开发测试): Bucket=`jesxion-ai-studio`, Region=`oss-cn-beijing`
### 5.1 获取上传凭证(预签名 URL ### 5.1 获取上传凭证(预签名 URL
``` ```
@@ -288,7 +290,8 @@ GET /oss/download-url
## 7. 待确认 ## 7. 待确认
- [ ] 设备 API 协议格式(塔吊/升降机数据字段 - [x] 预警推送机制 → 轮询(前端每 30s
- [x] JWT 有效期 → 7 天
- [x] OSS 配置 → Bucket=`jesxion-ai-studio`, Region=`oss-cn-beijing`
- [ ] 设备 API 协议格式(塔吊/升降机数据字段)— 厂家文档后续提供
- [ ] JWT Secret 如何管理 - [ ] JWT Secret 如何管理
- [ ] 预警推送机制(轮询 vs WebSocket
- [ ] OSS bucket 名称和目录结构

View File

@@ -189,6 +189,7 @@ alembic upgrade head
## 5. 待确认 ## 5. 待确认
- [x] OSS Bucket → `jesxion-ai-studio`(开发测试阶段)
- [ ] 设备历史数据保留策略(多久归档到 OSS - [ ] 设备历史数据保留策略(多久归档到 OSS
- [ ] 多租户隔离方案MVP 单租户,后续扩展) - [ ] 多租户隔离方案MVP 单租户,后续扩展)
- [ ] 预警阈值配置(存 DB 还是配置文件) - [ ] 预警阈值配置(存 DB 还是配置文件)