开发手册总览#

开发手册是中心服务器的场景层集成文档（分层术语见根目录 CONTEXT.md「文档分层模型」）：讲业务动线、接入流程与判定口径，不复述端点字段级事实——参数、请求/响应字段、错误码、权限点的唯一权威源是 API 域清单层（data-service 端点清单、device-service 端点清单、agent-service 端点页），业务语义见各服务 business 页，MQTT 全量事实见 MQTT 清单。

四个分册#

分册	视角	内容
机构场景 App 接口文档	部署客群（机构 Web/App）	385 个冻结 inventory 操作的正本/缺口体系：接入约定、15 个业务域操作页、五条业务流程与覆盖对账
零售场景 App 接口文档	部署客群（消费类手机 App）	账号与个人空间、设备绑定与分享的叙事页、五条对接流程与覆盖对账
采集服务器接入	接入视角（采集服务器软件）	采集服务软件对接平台：设备入库同步、消息链、data/v1 指令服务面与运维命令
记录仪设备接入	接入视角（记录仪固件/设备侧）	设备侧 MQTT 上行/下行、文件上传与固件升级、在线状态维护

分册之间的引用方向：场景页链接清单层与 business 页取事实；接入视角章只做导航级复述与动线重组。原 integration-manual（数据服务/设备服务两个纯索引空壳，未承载任何契约事实）已并入 development-manual 各分册与 API 域各服务三件套（standards / endpoints / business）。