Alinhamento com o corpus
a3-vision-os: a estratégia de ICP institucional (PMEs amplas, vertical não obrigatória) está emcontexto/CONTEXT.mdecontexto/vendas/icp-global.md. Este README descreve o software Vision como produto atual — páginas e domínios de dados aqui incluem forte legado para fluxo tipo mediacão/imóveis, sem isso definir só o tipo de empresa que pode contratar método de infraestrutura documentado no Markdown.
Aplicação web (Next.js) que funciona como painel operacional e inteligência comercial (UX atual com forte legado em corretagem / imóveis no produto): dashboards, relatórios com IA, Diagnóstico Vivo, CEO Virtual e Motor Comercial, persistência Supabase, IA multi‑provedor (Anthropic, OpenAI, Gemini / OpenRouter).
Produto A3 Vision relacionado
Motor Comercial (e wedge Diagnóstico Vivo / CEO de Bolso, conforme módulos descritos no README).
Status
Ativo (stack alinhada ao CONTEXT.md e ADR-001).
Stack
- Linguagem: TypeScript
- Framework: Next.js 15 (App Router), React 19, Tailwind CSS 4
- Banco de dados: Supabase (PostgreSQL + Auth + RLS)
- Dependências chave:
@supabase/ssr,@supabase/supabase-js,@anthropic-ai/sdk,pdf-parse,xlsx,zod,react-hook-form
Responsabilidade no ecossistema
É o repositório de execução do produto descrito no CONTEXT: ingestão/estruturação de contexto do cliente e geração diagnóstico/playbook por IA (a3-vision-os guarda o método e texto canónico). O caso uso UI atual inclui forte componente médio operacional modelo imobiliário; isso não substitui o ICP institucional aberto aos setores escritos nos docs de empresa.
Dependências
- Depende de: Supabase (projeto cloud); APIs de IA (Anthropic / OpenAI / Gemini conforme env); opcionalmente Firecrawl para ingestão de URLs (env comentado em
.env.local.example). - Usado por: Equipe A3 Vision e clientes finais pela instância instalada. Conteúdos mercado/canónico ficam sempre em
a3-vision-os.
Variáveis de ambiente necessárias
Ver .env.local.example: NEXT_PUBLIC_SUPABASE_URL, NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY, SUPABASE_SECRET_KEY, AI_PROVIDER, AI_MODEL (opcional), AI_PROVIDER_MOTOR, AI_MODEL_MOTOR (opcional), ANTHROPIC_API_KEY, OPENAI_API_KEY, OPENROUTER_API_KEY, OPENAI_BASE_URL, OPENROUTER_HTTP_REFERER, OPENROUTER_APP_TITLE, GOOGLE_AI_API_KEY, FIRECRAWL_API_KEY, FIRECRAWL_API_URL, KB_RAG_ENABLED.
Como rodar localmente
npm install → copiar .env.local.example para .env.local e preencher → aplicar migrações SQL no Supabase na ordem indicada no README → npm run create-admin (primeiro admin) → npm run dev.
Observações
- O README cita integração opcional com Firecrawl (cloud); não confundir com repositórios externos ignorados neste mapeamento.
- Inconsistência com CONTEXT.md: na seção 3 do CONTEXT aparecem oito nomes de tabelas no schema Supabase; o ADR-001 no mesmo repositório fala em “7 tabelas”. Registrar qual contagem está correta na próxima revisão de documentação.