> ## Documentation Index
> Fetch the complete documentation index at: https://docs.promete.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Arquitetura — Visão Geral

> Visão geral da arquitetura do Sistema Promete

## 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

```mermaid theme={null}
graph TB
    subgraph "Clientes"
        WEB[Frontend Web<br/>React / Next.js]
        MOB[Mobile<br/>Flutter]
    end
    
    subgraph "Backend"
        API[API Gateway<br/>FastAPI]
        AUTH[Autenticação]
        BL[Lógica de Negócio]
        AI[Agentes de IA]
    end
    
    subgraph "Dados"
        DB[(Banco de Dados)]
        SUP[Supabase]
    end
    
    subgraph "Sistemas Externos"
        WA[WhatsApp Business API]
        EMAIL[Serviços de Email]
        GEO[Geolocalização]
        PAY[Stripe]
    end
    
    WEB --> API
    MOB --> API
    API --> AUTH
    API --> BL
    BL --> AI
    BL --> DB
    BL --> SUP
    BL --> WA
    BL --> EMAIL
    BL --> GEO
    BL --> PAY
```

<Warning>
  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.
</Warning>