Pular para o conteúdo principal

24 documentos marcados com "engenharia"

Ver todas as etiquetas

Adapter Mensageria (Futuro)

Especificação do adapter desacoplado para integração com apps de mensageria — escopo futuro, não faz parte do MVP.

ADR-001: FastAPI

Por que escolhemos FastAPI como framework web Python para o CARla.

Assistente IA

Chat conversacional com SSE streaming, histórico de conversas e escalonamento humano.

Autenticação

Fluxo OAuth2 PKCE com Gov.br, estrutura do JWT e RBAC por role.

Banco de Dados

PostgreSQL 16 + PostGIS + pgvector — schema, extensões e decisões de modelo.

Bounded Contexts

Os seis contextos delimitados da Carla e como eles se relacionam.

Documentos

Upload multipart, OCR assíncrono e consulta de status de validação.

Estratégia de IA

LLM agnóstico com Adapter Pattern, RAG com pgvector e conformidade LGPD.

Estratégia de Testes

Pirâmide de testes do CARla — filosofia, cobertura mínima e quality gates de CI.

Event Storming

Mapeamento de atores, comandos, eventos e políticas por Bounded Context.

Mensageria

RabbitMQ — exchanges, filas, DLQ, retry policy e Outbox Pattern.

Portal do Analista

Endpoints da fila de processos, dossiê automático, aprovação e rejeição.

Princípios das APIs

Convenções REST, envelope de resposta, paginação cursor-based e códigos de erro.

Processos CAR

Endpoints para criação, submissão, consulta e gerenciamento de processos CAR.

Serviços

Responsabilidades, portas e estrutura interna de cada container do CARla.

Testes de Carga

k6 — cenários de carga, thresholds e interpretação de resultados.

Testes E2E

Playwright — fluxos críticos do cidadão e do analista.

Testes Unitários

pytest — exemplos de testes de domínio para entidades, value objects e serviços.

Visão Geral

Modelo C4 do CARla — contexto, containers e arquitetura lógica.