🏠 Smart Home Hub — IoT Local-First Platform
Plataforma residencial inteligente local-first, com controle direto na rede local, telemetria em tempo real, automações e interface dark-mode.
O sistema recebe dados de dispositivos comerciais (Sonoff, Tuya) via MQTT e protocolos locais, processa a telemetria com Clean Architecture + CQRS no back-end, e reflete cada mudança em tempo real no painel web via SignalR — sem depender de nuvem de terceiros para o controle básico da casa.
⚡ Destaques
- Local-First & Baixa Latência — comunicação direta na LAN via TCP/UDP, com driver nativo Tuya (v3.1 a v3.5, incluindo AES-GCM) e MQTT nativo (Sonoff/Tasmota/ESPHome).
- Backend em CQRS —
.NET 10, Mediator (source generators), Result Pattern e validação com FluentValidation.
- Telemetria em TimescaleDB — hypertables append-only para métricas de energia e para a trilha de auditoria (
SystemEvents), com agregações contínuas.
- Automações reais — motor de disparo com múltiplas ações por regra, wizard de criação, diagrama de fluxo e histórico de execução.
- Tempo real de ponta a ponta — SignalR sincroniza dispositivos, mídia (Spotify/TV), telemetria e execuções de automação sem precisar de F5.
- Design System Dark-Mode — escada semântica de superfícies (
index.css), Feature-Sliced Design (FSD) estrito, i18n (PT/EN).
🏛️ Arquitetura
┌──────────────────┐ WebSocket (SignalR) / REST ┌───────────────────────┐
│ React 19 + FSD │ ◄──────────────────────────────────► │ ASP.NET Core API │
│ Tailwind CSS v4 │ │ CQRS / Mediator │
└──────────────────┘ └──────────┬────────────┘
│
┌───────────────────────────────────────────────┼─────────────────────────┐
▼ ▼ ▼
┌─────────────────────────┐ ┌──────────────────────┐ ┌──────────────────────┐
│ PostgreSQL + TimescaleDB │ │ Eclipse Mosquitto │ │ Drivers Locais LAN │
│ (config + telemetria + │ │ (Broker MQTT) │ │ (Tuya AES-GCM, │
│ SystemEvents) │ │ │ │ Google Cast/ADB) │
└─────────────────────────┘ └──────────────────────┘ └──────────────────────┘
🛠️ Stack
| Camada | Tecnologia |
|---|
| Infraestrutura | Docker Compose (bancos de dados e broker) |
| Banco de Dados | PostgreSQL + TimescaleDB (séries temporais e auditoria) |
| Mensageria | Eclipse Mosquitto (MQTT) |
| Segurança | Firebase Auth (usuários e tokens JWT) |
| Back-end | C# .NET 10 — ASP.NET Core Minimal APIs + Worker Services |
| Observabilidade | Serilog (logging estruturado) + Scalar (OpenAPI UI) |
| Front-end | React 19 + TypeScript, Vite, Tailwind CSS v4, Shadcn/Radix, Zustand, TanStack Query |
| Tempo Real | SignalR (WebSockets) |
| Descoberta Automática | mDNS, SSDP/UPnP, MQTT Discovery e Tuya UDP |
| Integrações | Spotify Web API (playback remoto) e Android TV/Google Cast via ADB de rede |
📖 Documentação aprofundada de cada camada:
- ⚙️ Back-end — Clean Architecture, CQRS, EF Core, drivers de protocolo
- 🎨 Front-end — Feature-Sliced Design, Design System, roteamento e estado
🖼️ Capturas de Tela
| Dashboard | Histórico de Eventos |
|---|
| |
| Automações | Descoberta de Dispositivos |
|---|
| |
🚀 Como Rodar (Ambiente Local)
Pré-requisitos: Docker Desktop, .NET 10 SDK, Node.js 22+
1. Clone o repositório
git clone https://github.com/seu-usuario/smart-home-hub.git
cd smart-home-hub
2. Configure as variáveis de ambiente
cp backend/.env.example backend/.env
cp frontend/.env.example frontend/.env.local
Preencha as credenciais do Postgres, Firebase e Spotify em backend/.env, e as chaves públicas do Firebase Web em frontend/.env.local (veja os comentários de cada arquivo para onde obter cada valor).
3. Suba a infraestrutura (Postgres/TimescaleDB + Mosquitto)
docker-compose up -d
4. Inicie o back-end
dotnet run --project backend/src/SmartHomeHub.Api
API em http://localhost:5252 — documentação OpenAPI em http://localhost:5252/scalar/v1.
5. Inicie o front-end
cd frontend
npm install
npm run dev
Web app disponível em http://localhost:5173.
💡 Sem hardware físico à mão? O Dev Tools Hub (/dev-tools, só em ambiente de desenvolvimento) simula uma casa inteira — dispositivos, telemetria e conectividade — sem precisar de nada real. Veja a seção Fase 4.8 no roadmap.
🧪 Testes & Qualidade
# Back-end (unitários + integração via Testcontainers)
dotnet test
# Front-end (Vitest + Playwright E2E)
npm run test:run
npm run test:e2e
🗺️ Roadmap de Desenvolvimento
✅ Fase 1: Fundação da Infraestrutura
✅ Fase 2: Motor do Back-end, Segurança e Observabilidade
✅ Fase 3: Comunicação IoT e Base de Testes
⏳ Fase 4: Painel de Controle — React + TypeScript (fase atual)
Fase 4.1–4.3: Base, Auth, Dispositivos e Ambientes (Concluídas)
Fase 4.4: Grupos de Dispositivos (Concluída)
Fase 4.5: Telemetria, Métricas e Histórico de Eventos (Concluída)
Fase 4.6: Testes, Qualidade & i18n (Concluída)
Fase 4.7: Descoberta Automática & Integrações de Terceiros
Fase 4.8: Dev Tools Hub (fora do roadmap original — só ambiente de desenvolvimento)
⏳ Fase 5: Automações
🔮 Visão de Futuro (v2.0 e Escala)
- ☁️ Cloud Proxy — acesso remoto seguro sem Port Forwarding
- 🔬 Microsserviços — extrair o Telemetry Worker de alta volumetria (Go/Rust)
- 📊 Observabilidade Centralizada — Prometheus + Grafana sobre as agregações do TimescaleDB
- 🤖 Automações Preditivas — modelos locais de ML sobre hábitos históricos de consumo
- 🎙️ Assistentes de Voz — Custom Skills para Alexa e Google Assistant via Cloud Proxy
