ADR-001 — Stack tecnológico (produto central / app cliente)

**Data:** 2025 **Status:** Aceito **Decisor:** Müller (CEO) **Organização:** A3 Vision

contexto/empresa/historico-decisoes/ADR-001-stack-tecnologico.md

Contexto

A A3 Vision precisa de um stack para executar o produto central: processamento de contexto do cliente, geração de diagnósticos e playbooks via IA e entrega de artefatos.

Decisão

Stack primário: Next.js + Supabase + Claude API

Repositório: Vision (workspace separado).

Alternativas consideradas

Python / FastAPI + Airflow: mais robusto para processamento pesado, OCR em PDFs escaneados, filas assíncronas — deferido para fase de maior escala.

Racional

  • Stack já implementada no repositório Vision
  • Supabase cobre banco, auth e storage com baixo overhead operacional
  • Claude API integra bem via Next.js para a fase atual
  • FastAPI / Airflow só quando houver 15–20 engajamentos simultâneos ou gargalo mensurável

Trigger de revisão

  • Base de clientes em 15–20 engajamentos simultâneos
  • Necessidade real de OCR em escala
  • Filas assíncronas como gargalo mensurável

Schema Supabase (Vision)

Tabelas documentadas no repo Vision (lista de referência):
clients, engagements, raw_inputs, structured_data, artifacts, negotiations, patterns, reviews — 8 entidades; validar nomenclatura final na documentação do código.