Arquitetura do Sistema

O Cidadão.AI é um sistema multi-agente distribuído, construído com tecnologias modernas para garantir escalabilidade, confiabilidade e transparência total.

Visão Geral

17
Agentes de IA
24/7
Monitoramento
100%
Open Source

Stack Tecnológico

Backend Core

FastAPI

Framework web moderno e assíncrono para APIs de alta performance

Python 3.11+

Linguagem principal com tipagem estática via Pydantic

Inteligência Artificial

LangChain

Framework para construção de aplicações com LLMs

CrewAI

Orquestração de agentes autônomos colaborativos

Groq LPU

Inferência ultrarrápida para processamento em tempo real

Armazenamento & Cache

PostgreSQL

Banco de dados relacional para persistência de longo prazo

Redis

Cache em memória para performance e filas de processamento

Observabilidade

Prometheus

Coleta e armazenamento de métricas

Grafana

Dashboards e visualização de métricas

OpenTelemetry

Rastreamento distribuído e observabilidade

Fluxo de Dados

  1. Coleta: Agentes monitoram APIs públicas e portais de transparência
  2. Processamento: IA analisa dados em busca de padrões e anomalias
  3. Validação: Sistema verifica informações com múltiplas fontes
  4. Armazenamento: Dados estruturados no PostgreSQL, cache no Redis
  5. Notificação: Alertas em tempo real sobre descobertas relevantes
  6. Apresentação: Dashboards e APIs para acesso público

Segurança & Conformidade

Medidas de Segurança

  • Criptografia end-to-end para dados sensíveis
  • Autenticação JWT com refresh tokens
  • Rate limiting e proteção DDoS
  • Auditoria completa de todas as ações
  • Isolamento de containers Docker

Conformidade Legal

  • 100% compatível com LGPD
  • Lei de Acesso à Informação (LAI)
  • Marco Civil da Internet
  • Padrões OWASP de segurança
  • ISO 27001 (em processo)

APIs Públicas

Endpoints Principais

GET /api/agents - Lista todos os agentes
GET /api/agents/{agent_id}/status - Status do agente
POST /api/investigate - Solicitar investigação
GET /api/anomalies - Anomalias detectadas
GET /api/reports - Relatórios gerados
WS /ws/alerts - WebSocket para alertas em tempo real

Monitoramento & SLAs

99.9%
Uptime Garantido
<100ms
Latência P95
24/7
Monitoramento

Contribuindo

O Cidadão.AI é um projeto open source e acolhe contribuições da comunidade. Visite nosso repositório no GitHub para:

  • Reportar bugs e sugerir melhorias
  • Contribuir com código e documentação
  • Propor novos agentes e funcionalidades
  • Participar das discussões técnicas
  • Auditar nossa segurança e processos