feat: 初始化设计文档草稿

- SPEC.md: 项目概览与文档索引
- docs/architecture.md: 系统架构设计
- docs/api.md: 后台 API 接口设计
- docs/database.md: 数据库表结构设计
- docs/h5.md: H5 页面结构与交互设计
- docs/offline.md: 离线数据方案

状态: 设计中,待设备API协议确认后细化
This commit is contained in:
2026-04-14 11:25:17 +08:00
commit 86777f585e
6 changed files with 1165 additions and 0 deletions

48
SPEC.md Normal file
View File

@@ -0,0 +1,48 @@
# 郑州智慧工地管理系统 - 产品设计规格书
> 版本: v0.1.0 draft
> 状态: 设计中
> 仓库: https://git.jesxion.com/jesxion/smart-project
---
## 文档索引
| 文档 | 说明 |
|------|------|
| [architecture.md](./architecture.md) | 系统架构设计 |
| [api.md](./api.md) | 后台 API 接口设计 |
| [database.md](./database.md) | 数据库表结构设计 |
| [h5.md](./h5.md) | H5 页面结构与交互设计 |
| [offline.md](./offline.md) | 离线数据方案 |
---
## 项目概述
### 背景
郑州智慧工地项目面向施工现场安全管理的数字化升级需求,提供塔吊、升降机等特种设备的实时监测与预警功能。
### 核心功能
- **设备监控**:塔吊、升降机实时数据接入(来自已有 API
- **预警管理**:设备异常实时推送与记录
- **H5 移动端**:移动端随时查看设备状态、接收预警
- **数据持久化**:监测数据与预警记录云端存储
### 技术栈
| 层级 | 技术选型 |
|------|----------|
| 后台 API | Python / FastAPI或 Flask |
| H5 前端 | 原生 HTML/CSS/JS无框架依赖 |
| 数据库 | PostgreSQL / SQLiteMVP 阶段) |
| 文件存储 | 阿里云 OSS |
| 设备数据 | 已有第三方 API塔吊/升降机) |
### 文档更新记录
| 日期 | 版本 | 更新内容 |
|------|------|----------|
| 2026-04-14 | v0.1.0 | 初始化草稿,架构设计 |