启用/禁用磁盘分区（server data partition）#

验证状态：存在关键缺口，不可作为完整契约发布。Web 发送与应答消费已源码核验；采集服务器侧 data/v1 服务源码不在本工作区，分区操作的服务端行为与失败语义缺证。 适用基线：源码归纳 @ 2026-09-14

用途与场景#

启用或禁用采集服务器上某个磁盘分区并设置其写入顺序，是磁盘设置页磁盘行开关的动作。本页是 server/{deviceNo}/data/v1/partition 写命令的唯一操作正本；读取见读取磁盘信息。

使用位置#

页面/功能	角色或空间分支
磁盘设置页·磁盘行"启用"开关（构造）、（参数组装）	当前 $spaceId；$deviceNo 来自路由

对应 inventory operationId：mqtt-set-server-var-data-v1-partition-abdf970c。

端点#

MQTT 发布 server/{deviceNo}/data/v1/partition（Web → Broker → 采集服务器直连，应答按 reply topic 回流；中心网关不消费）— 启用/禁用某个磁盘分区并设置写入顺序。

通道口径：该 topic 不在中心消费/发布点清单内（网关默认订阅清单无 server/+/data/#，见MQTT 主题清单 · 服务端订阅面）；应答回流、凭据与 QoS 等 wire 约定见MQTT 连接与消息边界。

请求形态 JSON 对象 {id, reply, params:{partPath, enabled, orderNum}}（无 sub 成员；三值取自读取磁盘信息应答行）。

动线与完成判据#

层级	判据
发布完成	publishAsync Promise 成功
请求关联	应答到达专用 reply topic 即消费；不校验 id 回显；无超时
业务完成	应答 status===200 视为受理成功；页面随后立即重读磁盘列表以回显实际状态
服务器执行	分区是否真正启停、是否需要刷新服务才生效，以重读结果与 modified 标志间接观察；服务器侧执行语义缺证

错误与边界#

• Web 只区分 status===200 与其他；失败原因字段缺证。
• 无超时、无重试：应答不到达时 UI 无反馈，开关状态以重读为准。
• 修改后若读数 modified=true，需触发磁盘服务刷新使配置生效。
• MQTT 族公共边界见MQTT 连接与消息边界。

调用关系与资源清理#

• 读写对：与读取磁盘信息共用 reply 命名空间；成功后立即重读。
• 与触发磁盘服务刷新的先后关系：分区变更积累到 modified 后由用户显式刷新服务。
• 无订阅资源；页面卸载清空本地发送队列，不撤销已发布命令。

已知缺口#

1. 采集服务器侧服务源码不在本工作区：partPath/orderNum 的服务端校验、部分成功语义、失败应答形态（非 200 时的 error 结构）缺证。
2. orderNum 的取值约束（是否允许重复/乱序）缺证。
3. Broker ACL、服务器订阅证据与部署环境一致性待部署核验。