From 0c37da07448296e87734c2e36bf251a90961c9c9 Mon Sep 17 00:00:00 2001 From: Jesxion Date: Tue, 14 Apr 2026 11:44:29 +0800 Subject: [PATCH] =?UTF-8?q?feat:=20=E9=94=81=E5=AE=9A=E5=B7=B2=E7=A1=AE?= =?UTF-8?q?=E8=AE=A4=E7=9A=84=E8=AE=BE=E8=AE=A1=E5=86=B3=E7=AD=96?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 预警推送: 轮询（前端每30s） - JWT有效期: 7天 - OSS: Bucket=jesxion-ai-studio, Region=oss-cn-beijing - 待确认项: 设备API协议(JWT Secret待定) --- SPEC.md | 3 ++- docs/api.md | 9 ++++++--- docs/database.md | 1 + 3 files changed, 9 insertions(+), 4 deletions(-) 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 还是配置文件）