docs: 全面审阅修复

- architecture.md: 全面重写,对齐 Node.js+MySQL 技术栈,
  新增三个模块(隐患随手拍/施工日志/AI分析)到模块列表和架构图,
  更新数据流、租户隔离模型、部署架构、安全设计
- h5.md: 补充 6 个新页面 wireframe(3.7~3.14),
  更新页面清单(15个页面),API endpoint 前缀 /api → /v1,
  更新已知待确认项为已确认状态
- offline.md: 补充 hazards/construction_logs/ai_analyses 三个
  IndexedDB store,更新刷新策略表,
  补充 6 种离线操作类型(action 类型表)
- SPEC.md: 状态升级为"设计完成",版本升至 v0.2.1,
  所有待确认项均已确认(部署地址/推送凭证/OSS路径/JWT/台账)
This commit is contained in:
2026-04-14 16:53:33 +08:00
parent ba5d65d438
commit cb0ef8c30c
4 changed files with 484 additions and 81 deletions

14
SPEC.md
View File

@@ -1,7 +1,7 @@
# 郑州智慧工地管理系统 - 产品设计规格书
> 版本: v0.2.0
> 状态: 设计
> 版本: v0.2.1
> 状态: 设计完成(开发前置条件已确认)
> 仓库: https://git.jesxion.com/jesxion/smart-project
---
@@ -351,8 +351,8 @@ AI 分析由河南三农设备端驱动,设备端 AI 分析完成后,通过
### 7. 待确认
- [ ] 后台 API 公网部署地址阿里云服务器部署时配置)
- [ ] 河南三农设备推送的 appid / secret部署时配置
- [ ] OSS 存储路径规范(目录前缀规则)
- [ ] JWT Secret 管理(环境变量)
- [ ] 设备初始台账导入方式(手动录入还是自动发现)
- [x] ~~后台 API 公网部署地址~~阿里云服务器部署时配置)
- [x] ~~河南三农设备推送的 appid / secret~~部署时配置
- [x] ~~OSS 存储路径规范~~ → 隐患照片 `reports/`、日志照片 `logs/`、AI 分析附件 `ai/`
- [x] ~~JWT Secret 管理~~ → 环境变量 `JWT_SECRET_KEY`
- [x] ~~设备初始台账导入方式~~ → 手动录入河南三农设备 SN