# 郑州智慧工地管理系统 - 产品设计规格书

> 版本: 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，无框架依赖 |
| 数据库 | SQLite（MVP 阶段） |
| 文件存储 | 阿里云 OSS（Bucket: jesxion-ai-studio, Region: oss-cn-beijing） |
| 设备数据 | 已有第三方 API（塔吊/升降机） |

### 文档更新记录

| 日期 | 版本 | 更新内容 |
|------|------|----------|
| 2026-04-14 | v0.1.0 | 初始化草稿，架构设计 |
| 2026-04-14 | v0.1.1 | 锁定预警轮询、JWT 7天、OSS Bucket 配置 |
| 2026-04-14 | v0.1.2 | 锁定 SQLite 数据库 |