refactor: rename iot client to stateless gateway

2026-08-03 14:43:39 +08:00
parent 5edca1524f
commit aaede08f88
26 changed files with 92 additions and 111 deletions
--- a/backend/iot-gateway/README.md
+++ b/backend/iot-gateway/README.md
@@ -0,0 +1,5 @@
+# IoT Gateway
+
+API/Worker 与 IoT Server 之间的无状态轻网关。外部业务请求必须先经过 Platform API 的 JWT、角色、对象归属和安全状态校验；Worker 使用内部令牌经本服务下发命令。网关不保存命令、幂等或设备事实，只透传 `identity`、`idempotency_key` 和过期时间，并返回 IoT Server 的派发结果。
+
+设备上行报文由 IoT Server 回调本服务，再转交 Platform API 持久化和审计；命令与幂等事实、最终状态查询统一由 API/PostgreSQL 提供。