EcoWeb — Documentação Oficial
EcoWeb é uma plataforma web de gestão ambiental e operacional desenvolvida para monitoramento de equipamentos, telemetria, qualidade da água e gestão comercial/operacional.
Explore a documentação
Visão Geral
Stack tecnológico, estrutura do monorepo e início rápido.
Arquitetura
Design do sistema: BFF Pattern, C4 Model, módulos e fluxos de dados.
Casos de Uso
Fluxos de autenticação, CRUD de usuários, telemetria e mais.
Funcionalidades
Dashboard, módulos de gestão, monitoramento e relatórios.
Referência de API
Todos os endpoints do BFF com parâmetros, headers e exemplos.
Componentes
UI primitives, componentes de domínio e hooks reutilizáveis.
Deploy
Docker, variáveis de ambiente, Nginx e guia de produção.
Guia do Desenvolvedor
DDD, padrões de código, como adicionar features ao monorepo.
Visão rápida do sistema
| Camada | Tecnologia | Propósito |
|---|---|---|
| Frontend | Next.js 15 + React 19 | Interface web (App Router) |
| BFF | Next.js API Routes | Proxy autenticado para Strapi e EcoAPI |
| CMS/Auth | Strapi v5 | Usuários, permissões, empresas, navegação |
| API Operacional | EcoAPI (Node/Python) | Telemetria, equipamentos, consumo hídrico |
| Sessão | Cookie HttpOnly (tk_uac, tk_api) | JWT seguro, server-side only |
| Estilos | Tailwind CSS + shadcn/ui | Design system consistente |
| Estado | TanStack Query + Context API | Cache de dados e estado global |
| Monorepo | TurboRepo + npm workspaces | Pacotes compartilhados de auth e UI |