Arquitetura do Sistema
O Promete é uma plataforma SaaS construída sobre uma arquitetura orientada a serviços (APIs), projetada para suportar crescimento progressivo, evolução contínua e integração com sistemas externos.
Visão Geral
A arquitetura do sistema é composta por três camadas principais:
| Camada | Tecnologia | Responsabilidade |
|---|
| Frontend Web | React, Next.js, TypeScript | Interface web para agentes políticos e assessores |
| Mobile | Flutter | Aplicação móvel para acesso em campo |
| Backend / API | Python (FastAPI), Supabase, Node.js | Lógica de negócio, APIs, processamento de dados |
Princípios Arquiteturais
A arquitetura segue princípios que garantem a sustentabilidade e evolução do sistema ao longo do tempo:
Orientação a APIs — Toda comunicação entre camadas ocorre por meio de APIs RESTful, permitindo que frontend, mobile e integrações externas consumam os mesmos serviços.
Separação de responsabilidades — Cada camada tem responsabilidades bem definidas, facilitando manutenção e evolução independente.
Escalabilidade horizontal — A infraestrutura em nuvem permite escalar componentes individualmente conforme a demanda.
Modularidade — Os módulos do sistema (Relacionamento, Comunicação, Gabinete, etc.) são implementados como serviços independentes que se comunicam via APIs internas.
Diagrama de Alto Nível
Alguns componentes da arquitetura ainda estão em definição (banco de dados, hospedagem, relatórios). Esta documentação será atualizada conforme as decisões forem tomadas.
