Manual Arquitetural do Ecossistema Maker & Hardware Lab · Artes do Sul

🛡️ Sentinel Status

  • Status: 🟢 Operacional / Canônico 2026
  • Tier: S+
  • Health: 99% / ROI Potencial: Centralização e documentação técnica completa do ecossistema Maker, integrando prototipagem de hardware, telemetria de sensores, automação residencial com Home Assistant OS, virtualização Proxmox VE, redes mesh ESP-NOW e aceleração de IA na borda.
  • Stack: HTML5, CSS3 (Cyber-Growth Design System), Vanilla JS, PWA (Service Worker + Web Manifest), JSON, ESP32 (ESP-IDF / Arduino / ESPHome), Raspberry Pi (Zero W / Pi 5), M5Stack (Cardputer / Atom Echo / CoreS3), Proxmox VE 8.x, HAOS 13+, Zigbee 3.0 (SLZB-06 / Z2M), NUT (Network UPS Tools), LoRa 915MHz, Tailscale WireGuard.

1. Visão Geral e Filosofia Arquitetural

O Ecossistema Maker Artes do Sul é uma federação de aplicações web progressivas (PWAs) independentes e de alto desempenho, interconectadas pelo Hub Central Maker (maker.artesdosul.com) e pelo componente global Ecosystem Switcher (btnEcosystemSwitcher).

Pilares Fundamentais:

  1. Soberania e Privacidade Local: Todos os nós de telemetria, brokers MQTT, automações e sínteses de voz operam 100% na rede local (Local-First), sem dependência de nuvens proprietárias.
  2. Eficiência Energética (6W a 10W 24/7): O servidor central de automação e homelab é dimensionado sobre Mini PCs Intel x86 (N100/N150) ou nós solares de baixo consumo (60µA deep sleep), garantindo custo elétrico inferior a R$ 5,00/mês e sobrevivência de várias horas em baterias/nobreaks.
  3. Padrão Estético Cyber-Growth: Interfaces ricas com paleta dark profunda, gradientes mesh, tipografia com Google Fonts (Bricolage Grotesque, IBM Plex Sans, JetBrains Mono), micro-animações, modo Kiosk e persistência de bancada em localStorage.
  4. Resiliência Industrial: Esquemas elétricos com proteção de entradas GPIO (divisores de tensão em sensores 5V, isolamento óptico em relés e boias magnéticas de backup contra cavitação).

2. Mapa dos Hubs e PWAs do Ecossistema

graph TD
  MakerHub["🌐 HUB MAKER<br>maker.artesdosul.com<br><i>(Sentinel Command Center)</i>"]
  
  Oficina["🛠️ OFICINA MAKER<br>oficina.artesdosul.com<br><i>(Bancada de Hardware & BOM)</i>"]
  HAOS["🏠 HAOS & PROXMOX<br>haos.artesdosul.com<br><i>(Central de Automação & Homelab)</i>"]
  M5Stack["📟 M5STACK LAB<br>m5stack.artesdosul.com<br><i>(Controladores ESP32 & Grove)</i>"]
  ESPNOW["📡 REDE ESP-NOW<br>espnow.artesdosul.com<br><i>(Mesh P2P Sub-50ms & Solar)</i>"]
  Homelab["⚡ HOMELAB AI 2026<br>homelab.artesdosul.com<br><i>(NPU 40 TOPS & Edge AI)</i>"]
  Embedded["🔬 EMBEDDED 2026<br>embedded.artesdosul.com<br><i>(Matriz SoCs & Power Sim)</i>"]

  MakerHub --> Oficina
  MakerHub --> HAOS
  MakerHub --> M5Stack
  MakerHub --> ESPNOW
  MakerHub --> Homelab
  MakerHub --> Embedded

  Oficina <--> HAOS
  M5Stack <--> HAOS
  ESPNOW <--> HAOS
  HAOS <--> Homelab

3. Detalhamento dos PWAs Canônicos

3.1. 🌐 Hub Central Maker (maker.artesdosul.com)

  • Diretório: d:\artesdosul\artesdosul\maker\
  • Porta Local Padrão: 8769
  • Função: Dashboard Sentinel agregador inspirado em selva.artesdosul.com. Mapeia os 12 nós do ecossistema, calcula a saúde média da frota, gerencia a trilha de exploração do visitante (Checklist) e fornece console de eventos em tempo real.

3.2. 🛠️ Oficina Maker & Hardware Lab (oficina.artesdosul.com)

  • Diretório: d:\artesdosul\artesdosul\oficina\
  • Porta Local Padrão: 8767
  • Função: Bancada interativa de prototipagem, pinagens GPIO/Grove, esquemas elétricos e dimensionamento de campo.

3.3. 🏠 Home Assistant OS & Proxmox Hub (haos.artesdosul.com)

  • Diretório: d:\artesdosul\artesdosul\haos\
  • Porta Local Padrão: 8768
  • Função: Central de implantação da infraestrutura residencial no Mini PC Intel N100 (6W).

3.4. 📡 Rede ESP-NOW Cisterna (espnow.artesdosul.com)

  • Diretório: d:\artesdosul\artesdosul\espnow\
  • Função: Rede sem fio ponto a ponto (P2P) de longo alcance sem necessidade de roteador Wi-Fi com latência sub-50ms e nós solares.

3.5. 📟 M5Stack Device Lab (m5stack.artesdosul.com)

  • Diretório: d:\artesdosul\artesdosul\m5stack\
  • Função: Catálogo modular de controladores da família ESP32-S3 e sensores Grove Port A.

3.6. ⚡ Homelab & Edge AI 2026 (homelab.artesdosul.com)

  • Diretório: d:\artesdosul\artesdosul\homelab\
  • Função: Arquitetura de computação de borda de 4 camadas com NPU 40 TOPS (Hailo-10H) e energia solar.

3.7. 🔬 Guia Embarcados & IoT 2026 (embedded.artesdosul.com)

  • Diretório: d:\artesdosul\artesdosul\embedded\
  • Função: Matriz comparativa de microcontroladores e SoCs modernos com simulador de consumo de energia.

4. O Componente Global btnEcosystemSwitcher

Cada PWA carrega o componente modal js/ecosystem-switcher.js para permitir alternar com 1 clique entre qualquer um dos nós do ecossistema.

5. Matriz de Execução Local e Portas

PWA / Aplicação Comando de Execução Rápida Porta Padrão
🌐 Maker Hub npx --yes serve maker ou python -m http.server 8769 --directory maker 8769
🛠️ Oficina Maker npx --yes serve oficina ou python -m http.server 8767 --directory oficina 8767
🏠 HAOS Lab npx --yes serve haos ou python -m http.server 8768 --directory haos 8768
📡 Rede ESP-NOW npx --yes serve espnow ou python -m http.server 8770 --directory espnow 8770
📟 M5Stack Lab npx --yes serve m5stack ou python -m http.server 8771 --directory m5stack 8771
⚡ Homelab AI npx --yes serve homelab ou python -m http.server 8772 --directory homelab 8772
🔬 Embedded 2026 npx --yes serve embedded ou python -m http.server 8773 --directory embedded 8773