# 运转系统 API

> 参考来源：`docs/superpowers/specs/2026-05-18-operation-system-engine-design.md`

## 健康检查

- `GET /api/health` — 返回应用名称和状态

## 日志

- `GET /api/logs` — 拉取日志内容
- `GET /api/logs/stream` — SSE 增量推送

## 文档

- `GET /api/docs/api-md` — 获取本 API 文档
- `GET /api/docs/readme-md` — 获取 README

## 平台基础接口

复用 `plc_platform_core::handler::platform_routes`：源 / 设备 / 点位 / 标签 / 页面。

## 工位配置（§9.1.1）

- `GET /api/station` — 列出工位（可选 `?line_code=`）
- `POST /api/station` — 新建工位
- `GET /api/station/{id}` — 工位详情含信号绑定
- `PUT /api/station/{id}` — 更新工位
- `DELETE /api/station/{id}`
- `POST /api/station/{id}/signal` — Upsert 工位信号绑定
- `DELETE /api/station/{id}/signal/{role}`

## 流程段配置（§9.1.1）

- `GET /api/segment`（可选 `?line_code=`）
- `POST /api/segment`
- `GET /api/segment/{id}`
- `GET /api/segment/{id}/detail` — 包含 step / interlock / resource
- `PUT /api/segment/{id}`
- `DELETE /api/segment/{id}`
- `GET /api/segment/{id}/step`
- `POST /api/segment/{id}/step`
- `PUT /api/segment/{id}/step/{step_no}`
- `DELETE /api/segment/{id}/step/{step_no}`
- `GET /api/segment/{id}/interlock`
- `POST /api/segment/{id}/interlock`
- `DELETE /api/segment/{id}/interlock/{interlock_id}`
- `GET /api/segment/{id}/resource`
- `PUT /api/segment/{id}/resource` — 用新的 `resource_keys` 数组整体替换

## 段运行控制（§9.2）

- `POST /api/control/segment/{id}/start-auto`
- `POST /api/control/segment/{id}/stop-auto`
- `POST /api/control/segment/{id}/ack-fault`
- `POST /api/control/segment/{id}/reset` — 仅在 Blocked / Faulted / ManualAckRequired 状态允许
- `POST /api/control/segment/batch-start-auto`
- `POST /api/control/segment/batch-stop-auto`

## 运行态查询（§9.3）

- `GET /api/runtime/overview` — 所有段 + 资源占用快照
- `GET /api/runtime/segment/{id}` — 单段配置 + runtime
- `GET /api/runtime/station/{id}` — 工位信号 + 最新点位监控值

## WebSocket（§8.2）

- `GET /ws/public` — 推送
  - `point_new_value`（核心）
  - `event_created`（核心）
  - `app_event`：`{ app: "operation-system", event_type: "segment_runtime_changed", data: SegmentRuntime }`