feat: replace iot adapter with mqtt command pipeline
This commit is contained in:
13
AGENTS.md
13
AGENTS.md
@@ -13,7 +13,7 @@
|
||||
- 验收范围:`docs/12-验收与迭代规划.md`
|
||||
2. 检查 `git status`,保留用户已有改动;不要顺手格式化、重写或删除无关文件。
|
||||
3. 区分三类内容:
|
||||
- `frontend/platform_admin`、`backend/{api,worker,iot}` 是当前业务实现。
|
||||
- `frontend/platform_admin`、`backend/{api,worker,iot-client,iot-server}` 是当前业务实现。
|
||||
- `docs/10-技术实现规划.md` 中尚不存在的目录和系统属于规划,不得为完成局部任务擅自创建空壳工程。
|
||||
4. 需求不明确时以文档中的系统主责、数据主责和安全规则为边界;不得把标为“待确认”的事项自行固化为政策。
|
||||
5. 文档之间出现冲突时按以下顺序处理:
|
||||
@@ -29,7 +29,8 @@
|
||||
|
||||
- `backend/api`:Gin HTTP API/BFF、鉴权、同步业务事务、数据库事实和审计。
|
||||
- `backend/worker`:Outbox 投递、Redis Streams 消费、告警、派单、通知、对账和超时任务。当前主要是 Mock 边界,未确定持久化消息契约前不要伪造完整实现。
|
||||
- `backend/iot`:MQTT 会话、协议适配、遥测、设备命令和回执。当前使用 Mock 适配,不得假定已连接真实设备或 Broker。
|
||||
- `backend/iot-client`:管理系统/App 的设备上下行 HTTP 边界;不得绕过 API 的业务鉴权和安全状态校验。
|
||||
- `backend/iot-server`:外部 MQTT Broker 会话、厂商协议、遥测、设备命令和回执;本地配置不代表已完成真实设备联调。
|
||||
- `frontend/platform_admin`:平台级治理、运营、财务、安全、主数据和审计界面;后端资源契约是其资源和操作能力的依据。
|
||||
- `docs`:产品和技术基线;涉及业务口径、实体、状态、权限或跨端流程的变更必须同步更新相应文档。
|
||||
- `doc`:原始设计图和协议附件,仅作需求来源;不要批量改名、压缩或重写。
|
||||
@@ -39,7 +40,7 @@
|
||||
- 平台总后台不承接气站、配送点、生产单位的日常重复操作。
|
||||
- 气站、配送点、生产、API 中心的业务事实各有唯一主责系统;其他系统通过 API、事件或只读聚合使用。
|
||||
- API 中心只管理接口产品和调用方,不能绕过业务服务直接写业务数据库。
|
||||
- `api` 不应承担长期运行的异步循环;`worker` 不应复制同步领域事务;`iot` 不应内嵌交易、资金或后台页面逻辑。
|
||||
- `api` 不应承担长期运行的异步循环;`worker` 不应复制同步领域事务;两个 IoT 进程不应内嵌交易、资金或后台页面逻辑。
|
||||
|
||||
### 目录归属规则
|
||||
|
||||
@@ -59,7 +60,8 @@ platforms/
|
||||
backend/
|
||||
api/ # 当前:同步 HTTP API/BFF
|
||||
worker/ # 当前:异步任务和事件消费
|
||||
iot/ # 当前:MQTT 与设备协议边界
|
||||
iot-client/ # 当前:管理系统/App 的设备上下行接口
|
||||
iot-server/ # 当前:MQTT 与设备协议边界
|
||||
contracts/
|
||||
openapi/ # 规划:HTTP 契约
|
||||
asyncapi/ # 规划:MQTT/事件契约
|
||||
@@ -145,7 +147,8 @@ go build ./cmd/main/main.go
|
||||
|
||||
# Worker / IoT(改动对应模块时)
|
||||
cd backend/worker && go test ./... && go build ./cmd/main/main.go
|
||||
cd backend/iot && go test ./... && go build ./cmd/main/main.go
|
||||
cd backend/iot-client && go test ./... && go build ./cmd/main/main.go
|
||||
cd backend/iot-server && go test ./... && go build ./cmd/main/main.go
|
||||
|
||||
# 平台总后台
|
||||
cd frontend/platform_admin
|
||||
|
||||
Reference in New Issue
Block a user