Documenta arquitetura e testes do projeto

README.md

@@ -172,11 +172,17 @@ Diferente do modo real, os tempos de verificação/acionamento/entrega são temp
 DataFlowInventory/
 ├── arduino/
 │   └── data_flow_inventory/
-│       └── data_flow_inventory.ino        # Código Arduino (FSM + Serial JSON)
+│       ├── data_flow_inventory.ino        # Sketch do Arduino (setup/loop)
+│       ├── config.h                       # Pinos, prazos por esteira e constantes
+│       └── src/
+│           ├── logica/                    # FSM, supervisor de entrega, protocolo, filtro, telas (testável em g++)
+│           └── hw/                        # Motores, sensores, LCD, comunicação e diagnóstico
 │
 ├── esp32/
-│   └── gateway_mqtt/
-│       └── gateway_mqtt.ino               # Código ESP32 (Serial ↔ MQTT)
+│   ├── gateway_mqtt/
+│   │   ├── gateway_mqtt.ino               # Código ESP32 (Serial ↔ MQTT)
+│   │   └── secrets.h.example              # Modelo das credenciais (secrets.h não versionado)
+│   └── test_mqtt_cloud/                   # Sketch de teste de conexão com o HiveMQ Cloud
 │
 ├── server/
 │   ├── package.json                       # Dependências Node.js
@@ -208,15 +214,19 @@ DataFlowInventory/
 │   ├── esteira_peca_b/                    # Teste 5: duas esteiras (A+B) com FSM completa
 │   ├── mqtt_probe/                        # Sonda MQTT (escuta dataflow/# com timestamp)
 │   ├── server_metrics/                    # Testes das métricas e da infra de observabilidade (sem Docker)
-│   ├── frontend/                          # Testes unitários do frontend
-│   └── frontend_smoke/                    # Testes de fumaça com Playwright
+│   ├── firmware_uno/                      # Testes da lógica do Uno (g++ + Makefile, tempo simulado)
+│   ├── frontend/                          # Testes unitários do frontend (node --test)
+│   └── frontend_smoke/                    # Testes E2E com Playwright (portas 3100–3102)
 │
 ├── docs/
 │   ├── ARCHITECTURE.md                    # Referência técnica única (arquitetura, tópicos, mensagens, observabilidade)
 │   ├── DEPLOYMENT.md                      # Implantação do zero
 │   ├── CI-CD.md, CHANGELOG.md             # Pipelines e histórico de mudanças
 │   ├── INTEGRATION_GUIDE.md               # Integração Beckhoff CX9240
 │   ├── broker_local_mosquitto.md          # Teste local com Mosquitto (sem nuvem)
+│   ├── FRONTEND.md                        # Guia do dashboard e da estrutura do frontend
+│   ├── DIVULGACAO.md                      # Material de divulgação do projeto
+│   ├── cards_comments/                    # Comentários dos cards de planejamento
 │   ├── grafana/                           # Dashboards versionados
 │   ├── artigo/
 │   │   └── Projeto de pesquisa - Final.docx   # Documentação acadêmica

docs/CHANGELOG.md

@@ -15,6 +15,8 @@ Convenção de seções: `Adicionado`, `Alterado`, `Corrigido`, `Segurança`, `R
 ### Adicionado
 
 - **Cobertura E2E do dashboard (card #27):** Playwright agora valida feedback de comandos ocupados/inválidos/limitados, estoque esgotado e recuperação por reset, reconexão WebSocket sincronizando estado, e `/api/status` nos modos servidor sem broker e simulador. O simulador aceita `ESTOQUE_INICIAL` (padrão 15) para testes isolados; execução documentada em `docs/CI-CD.md` e `CONTRIBUTING.md`.
+  - 8 testes novos: 3 em `comandos-recusados` (sistema ocupado, peça inválida, rate limit), 1 em `sem-estoque`, 1 de reconexão em `resiliencia` e 3 em `api-status` (503 do servidor sem broker, recusa com broker offline, 404 do simulador). Suíte serial (`workers: 1`), portas 3100–3102; em CI, 1 retentativa e `maxFailures: 3`
+  - **Validação parcial:** uma execução registrou 31 testes passando e 2 falhas; os testes novos e o cenário de rate limit passaram isoladamente. A suíte completa **ainda não foi reexecutada** após a última correção, portanto não há confirmação de execução totalmente verde
 
 ### Alterado