Jesxion
6c8760c6c5
- 新增第0章：设备推送协议（认证+统一入口+塔吊4接口+升降机4接口） - 架构图更新：数据流改为厂家主动推送 - 推送地址/appid/secret待部署时配置 - API文档结构重排，H5接口和设备接口分开
1.8 KiB
1.8 KiB
郑州智慧工地管理系统 - 产品设计规格书
版本: v0.1.0 draft
状态: 设计中
仓库: https://git.jesxion.com/jesxion/smart-project
文档索引
| 文档 | 说明 |
|---|---|
| architecture.md | 系统架构设计 |
| api.md | 后台 API 接口设计 |
| database.md | 数据库表结构设计 |
| h5.md | H5 页面结构与交互设计 |
| offline.md | 离线数据方案 |
项目概述
背景
郑州智慧工地项目面向施工现场安全管理的数字化升级需求，提供塔吊、升降机等特种设备的实时监测与预警功能。
核心功能
- 设备监控：塔吊、升降机实时数据接入（来自已有 API）
- 预警管理：设备异常实时推送与记录
- H5 移动端：移动端随时查看设备状态、接收预警
- 数据持久化：监测数据与预警记录云端存储
技术栈
| 层级 | 技术选型 |
|---|---|
| 后台 API | Python / FastAPI（或 Flask） |
| H5 前端 | 原生 HTML/CSS/JS，无框架依赖 |
| 数据库 | SQLite（MVP 阶段） |
| 文件存储 | 阿里云 OSS（Bucket: jesxion-ai-studio, Region: oss-cn-beijing） |
| 设备数据 | 河南三农厂家系统推送（统一推送接口 POST /input/post/call） |
文档更新记录
| 日期 | 版本 | 更新内容 |
|---|---|---|
| 2026-04-14 | v0.1.0 | 初始化草稿，架构设计 |
| 2026-04-14 | v0.1.1 | 锁定预警轮询、JWT 7天、OSS Bucket 配置 |
| 2026-04-14 | v0.1.2 | 锁定 SQLite 数据库 |
| 2026-04-14 | v0.1.3 | 确认设备 API 自带预警判断，移除本地阈值配置 |
| 2026-04-14 | v0.1.4 | 确认河南三农推送协议（8个接口，appid/secret部署时配置） |