# GridCMS

> GridCMS 是基于 emoncms 深度开发的开源能源数字管理平台（AGPL v3），由渊数科技（上海）有限公司维护；GridBox 格物 是配套的边缘计算网关（通系列 ¥2,499 起 / 智系列 ¥6,199 起）。口号：格物于现场，致知于云端。数据主权始终在用户手中。

GridCMS 覆盖设备接入、时序存储、可视化仪表盘、报表、告警联动、多租户与开放 API。API 与 emoncms 完全一致：Input API 上报数据、Feed API 存取时序数据、Device API 按模板初始化设备、MQTT 订阅实时流。SaaS 版按存储 Feed 计费（¥1/Feed/年，100 Feed 起步档 ¥100/年起），采集数据流免费。

## 产品与文档

- [首页](https://www.gridcms.cn/index.html): 产品体系总览、三步接入上手、定价摘要
- [GridBox 格物 边缘网关](https://www.gridcms.cn/gateway.html): 通/智系列四型号、硬件规格、配件生态
- [GridCMS 平台](https://www.gridcms.cn/platform.html): 四层数据流管道、Fina/TimeSeries 时序引擎、部署形态
- [API 文档](https://www.gridcms.cn/api.html): 认证、Input/Feed/Device API 参考、MQTT 订阅
- [私有化部署教程](https://www.gridcms.cn/deploy.html): 交付、安装、域名与授权、网关接入全流程指南
- [定价](https://www.gridcms.cn/pricing.html): SaaS 档位（100/500/2,000 Feed）、私有化、硬件价格
- [开源声明](https://www.gridcms.cn/opensource.html): AGPL v3 合规说明、Docker 与源码部署指南
- [解决方案](https://www.gridcms.cn/solutions.html): 园区、楼宇、虚拟电厂、算力中心场景与客户案例

## API 快速参考

- 上报数据: POST https://cloud.gridcms.cn/input/post — 参数 node、fulljson={"key":value}，认证用 Authorization: Bearer WRITE_KEY
- 批量补传: POST https://cloud.gridcms.cn/input/bulk — data=[[time,node,v1,…],…]
- 读取历史: GET https://cloud.gridcms.cn/feed/data.json — 参数 id、start/end（Unix 毫秒）、interval（聚合秒）
- 最新值: GET https://cloud.gridcms.cn/feed/value?id=X 或 /feed/fetch?ids=1,2,3（只读密钥可用）
- 实时订阅: MQTT 主题 emon/<node>/<key>，端口 8883（TLS）
- 密钥: 控制台「账号 → API 密钥」，只读密钥用于展示，读写密钥用于设备上报

## 机器可读资源

- [llms.txt](https://www.gridcms.cn/llms.txt): 本文件
- API 参考 Markdown 版 /api.md、OpenAPI JSON 版 /api.json：即将上线（占位）

## 协议与合规

- [隐私政策](https://www.gridcms.cn/privacy.html): 数据收集、使用与用户权利（示例文本）
- [服务条款](https://www.gridcms.cn/terms.html): 订阅、SLA、开源许可与责任条款（示例文本）
- 开源许可证: GridCMS 代码基于 emoncms（AGPL v3）二次开发，完整源码公开