From f31959f88aa64b82ff2ef9ccac9d235ea05e74b9 Mon Sep 17 00:00:00 2001 From: Matheus Nespolo Date: Wed, 7 Oct 2026 15:42:08 -0300 Subject: [PATCH] docs(integracoes): status real do CX9240 e separador; variaveis MQTT alinhadas ao codigo --- docs/ARCHITECTURE.md | 6 +++--- docs/INTEGRATION_GUIDE.md | 5 ++++- 2 files changed, 7 insertions(+), 4 deletions(-) diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md index 1117171..c4b0165 100644 --- a/docs/ARCHITECTURE.md +++ b/docs/ARCHITECTURE.md @@ -223,7 +223,7 @@ As imagens abaixo são anteriores à v3.0 e não mostram os marcos; vale o diagr ### 6.1 Beckhoff CX9240 (Historiador Local MQTT → SQLite) -**Status:** ✅ **CONCLUÍDO E VALIDADO (15/09/2026)** +**Status:** 🟡 **PARCIALMENTE VALIDADO** — persistência e DB comissionados (15/09/2026); fluxo completo Arduino/ESP32 → HiveMQ Cloud → Node.js → CX9240 homologado em 19/09/2026. Pendências: E2E automatizado (card #27) e confirmação do contrato `dataflow/eventos` com o firmware real (ver `docs/INTEGRATION_GUIDE.md` §1.5). - **Hardware/OS:** Beckhoff CX9240 rodando TwinCAT 3 em RT Linux ARM64. - **Banco de Dados:** SQLite local (`/var/lib/dfi/historian.db`) em modo WAL, operado via TF6420 Database Server (SQL Expert Mode). @@ -236,14 +236,14 @@ As imagens abaixo são anteriores à v3.0 e não mostram os marcos; vale o diagr |---|---|---| | `MQTT_PUBLISH` | `false` | habilita a publicação do estoque | | `MQTT_BROKER_URL` / `MQTT_PORT` | `mqtt://127.0.0.1` / `1883` | broker | - | `MQTT_USER` / `MQTT_PASS` | — | credenciais, se houver | + | `MQTT_USER` / `MQTT_PASS` | — | credenciais, se houver (o servidor `server/` usa `MQTT_USERNAME` / `MQTT_PASSWORD`) | | `MQTT_TOPIC_ESTOQUE` | `dataflow/estoque` | tópico de publicação | Passo a passo do lado Beckhoff (DDL SQL, TwinCAT 3): `docs/INTEGRATION_GUIDE.md`. ### 6.2 Separador — Roda de Separação -**Status:** Código comentado; integração em Sprint 5–6 +**Status:** ⬜ **PENDENTE** — não há código ativo na v3.0 do firmware Uno. O trecho antigo (`Stepper.h`, `moverSeparador`) existe só no histórico do git (firmware v2.x). A integração depende da mecânica (Semana 8, Bloco 4). **Hardware:** Motor 28BYJ-48 + ULN2003 (pinos 5-8) **Integração:** Nova etapa FSM após ENTREGANDO_PECA diff --git a/docs/INTEGRATION_GUIDE.md b/docs/INTEGRATION_GUIDE.md index 28283f1..b8d00e3 100644 --- a/docs/INTEGRATION_GUIDE.md +++ b/docs/INTEGRATION_GUIDE.md @@ -1,6 +1,7 @@ # Guia de Integração — Beckhoff CX9240 (Historiador SQLite) + Separador (Roda de Separação) > **Passo a passo para integração final com PC industrial e roda de separação** +> ⚠️ **Status:** a §1 (CX9240) está parcialmente validada. A §2 (separador) é **pendente**: o código da §2.3 é da v2.x e não existe na v3.0 do firmware Uno. > Data: 14/09/2026 · Sprint 5 --- @@ -111,7 +112,9 @@ CREATE TABLE IF NOT EXISTS eventos_log ( sqlite3 /var/lib/dfi/historian.db "SELECT * FROM eventos_hist ORDER BY id DESC LIMIT 10;" ``` -### 1.5 Checklist CX9240 — ✅ CONCLUÍDO (15/09/2026) +### 1.5 Checklist CX9240 — 🟡 PARCIALMENTE VALIDADO (15/09/2026; homologado em 19/09/2026) + +> Pendências: o contrato `dataflow/eventos` (usado por `eventos_hist`) ainda não foi confirmado com o firmware real, porque o simulador publica só `dataflow/estoque`. O card #27 (E2E) só pode ser marcado como concluído após uma execução verde no GitHub Actions da `main`. - [x] Contrato MQTT e payload definidos (`dataflow/estoque` e `dataflow/eventos`) - [x] Publicação MQTT validada no simulador (`MQTT_PUBLISH=true`)