# 后端服务仓

本目录采用 BSM-SDK Core 分层：每个 Go 进程均使用 `cmd`、`internal/config`、`internal/impl`、`internal/logic`、`internal/models`、`internal/routers`、`etc`、`scripts`、`test` 和 `Makefile` 约定。

| 目录 | 进程与职责 |
| --- | --- |
| `api` | Gin HTTP API / BFF、同步事务、JWT 鉴权与统一响应 |
| `worker` | Outbox 投递、超时扫描与可重试异步任务 |
| `iot-client` | 管理系统/App 的设备上下行 HTTP 边界、幂等受理与状态查询 |
| `iot-server` | 外部 MQTT Broker 会话、厂商二进制协议、遥测、命令与回执 |

四个进程沿用统一的工程机制；API 是命令、Outbox 和上行报文的数据库事实主责，Worker 负责投递，IoT Client 负责系统接口，IoT Server 负责设备协议。