Tudo o que a sua IA precisa para construir sobre a Brief App.

O BriefApp TechConsult Contability é uma plataforma corporativa exposta via Model Context Protocol (MCP) e HTTP Streaming, projetada para capacitar agentes de IA (Claude Code, Cursor, Antigravity, Windsurf, ChatGPT) a operar inteligência financeira e contábil em nível de analistas sêniores.

• Arquitetura de Dados: MinIO (object storage S3 para arquivos brutos), LanceDB (banco vetorial para RAG contábil), DuckDB (motor OLAP in-process ultrarrápido para Parquet), SQLite (formulários dinâmicos e auditoria) e Datalake Medallion particionado.
• Transporte MCP: Suporte nativo a HTTP Streaming (SSE) e Stdio. Endpoint local padrão: http://localhost:58180/mcp.
• Multi-tenant Obrigatório: Toda operação exige clientId. Nenhum dado vaza entre empresas clientes.
• Guardrail Read-Only em SQL: Consultas no Datalake e formulários aceitam estritamente comandos SELECT e WITH. Mutações ocorrem exclusivamente por tools autenticadas com auditoria.
• Generative + UI: O agente de IA projeta e compõe telas completas de relatórios executivos com Apache ECharts, cards de KPIs e navegação drilldown.

Diferente de sistemas convencionais que apenas retornam tabelas ou resumos em texto, o Generative + UI do TechConsult permite que o agente gere interfaces analíticas completas prontas para consumo executivo.

1. Relatórios Snapshot vs. Ao Vivo

• generate_report_html: Gera um relatório HTML estático e imutável a partir de dados consolidados, ideal para fechamentos contábeis mensais e envio para diretoria.
• generate_live_report: Gera uma página conectada em tempo real que consulta dinamicamente a camada Gold a cada acesso do usuário, exibindo números atualizados.
• publish_report: Publica o relatório no portal corporativo gerando uma URL segura com token de acesso.

2. Gráficos ECharts Integrados

O motor renderiza nativamente os seguintes componentes visuais:

• Waterfall (Cascata DRE): Receita Bruta → Deduções → Margem de Contribuição → Despesas Fixas → EBITDA → Lucro Líquido.
• Barras Empilhadas: Comparativo orçado vs. realizado por centro de custo e mês.
• Séries Temporais com Zoom: Fluxo de caixa diário com saldo acumulado e previsões estatísticas.
• Heatmap Tributário: Calendário de impostos com severidade e vencimento.

3. Navegação Drilldown em Modal

Usuários podem clicar em qualquer barra ou conta contábil para abrir um modal ou banner com a abertura detalhada de lançamentos individuais.

Para eliminar alucinações e assegurar dados auditáveis, o TechConsult implementa o padrão industrial Medallion com governança por schema:

Fluxo Pré-Relatório Obrigatório: O agente de IA deve SEMPRE invocar get_gold_catalog(clientId) antes de conceber relatórios. Se os dados já estiverem modelados na Gold, usa query_gold_catalog — nunca reprocessando dados brutos da Bronze.

Documentos fiscais e bancários frequentemente chegam em formatos não-estruturados (PDFs escaneados de extratos, notas de prestação de serviços, contratos sociais e recibos).

1. Parsing via Apache Tika: Extrai texto integral, OCR e metadados estruturados do arquivo armazenado no MinIO.
2. Estruturação com Gemini Flash: Converte linhas de extrato desordenadas em colunas padronizadas: data, historico, documento, valor, tipo (D/C) e saldo.
3. Indexação no LanceDB: Gera embeddings vetoriais para busca semântica veloz. Cláusulas de contratos e justificativas fiscais podem ser localizadas com search_financial_data ou search_hybrid.

O TechConsult inclui um widget de chat flutuante de IA (disponível via chatbotWidget.service.js) que pode ser embutido em qualquer relatório executivo, dashboard ou portal.

• Conversa Contextual: O usuário clica no botão flutuante e faz perguntas em linguagem natural diretamente sobre o relatório ("Qual filial teve maior crescimento de margem?", "Por que as despesas gerais subiram em março?").
• Theming Automático: O widget herda a paleta de cores primárias, gradientes e logotipo do cliente configurados em set_client_theme.
• Streaming & Tool Calls: Suporte a respostas em tempo real com indicador visual de status e execução de consultas analíticas nos bastidores.

Para empresas com operações de comércio eletrônico, o TechConsult possui um módulo especializado de reconciliação fiscal e contábil integrado à VTEX:

• Worker em Background: O serviço vtex-worker (porta 58480) sincroniza periodicamente pedidos, notas fiscais emitidas, taxas de marketplace e split de pagamentos.
• Command Center Interativo: Dashboard executivo completo (gerado via vtexCommandCenter.service.js) com conciliação entre pedidos faturados no ERP e recebimentos das adquirentes.
• Pipelines Automatizados: Ingestão na camada Bronze, validação fiscal na Silver e relatórios de margem bruta por canal de venda na Gold.

O TechConsult disponibiliza integração nativa com o Windows Explorer para agilizar o envio de arquivos e pastas contábeis:

• Clique direito em qualquer arquivo: Exibe a opção "Enviar para o TechConsult" → abre modal de escolha de cliente, faz upload para o MinIO e dispara a indexação no LanceDB automaticamente.
• Clique direito em qualquer pasta: Exibe a opção "Enviar pasta para o TechConsult" → varre recursivamente todos os arquivos contábeis da pasta preservando a estrutura de subdiretórios no MinIO.
• Instalação Fácil: Execute powershell -ExecutionPolicy Bypass -File "install/register-context-menu.ps1" no terminal.

Nem todos os dados nascem em planilhas ou ERPs. Provisões contábeis, aprovações de diretoria, notas explicativas e cadastros de centros de custo necessitam de coleta manual controlada.

• generate_form: A IA define schema JSON com tipos (texto, moeda, data, select, lookup), regras de obrigatoriedade e gera tabela SQLite dedicada.
• query_form_data: Consulta registros com filtros, paginação e ordenação via SQL seguro.
• update_form_record & set_form_record_status: Atualiza registros com registro obrigatório de autor, timestamp e justificativa.
• get_record_history: Trilha completa de auditoria demonstrando quem alterou o quê em cada campo contábil.
• get_form_import_template & import_form_data: Baixa template Excel com validação prévia de tipos antes da ingestão em massa.

Cada empresa cliente possui sua identidade visual única. O TechConsult permite configurar o tema de marca por cliente:

call_tool("set_client_theme", {
  "clientId": "acme_corp",
  "theme": {
    "companyName": "Acme Indústria e Comércio",
    "primaryColor": "#1e3a8a",
    "secondaryColor": "#0284c7",
    "fontFamily": "Inter, sans-serif",
    "logoUrl": "https://minio.briefapp.br/acme/logo.png"
  }
})

Injeção Automática: O tema é injetado no cabeçalho e componentes de todo relatório HTML gerado, formulário público e portal de visualização.

Para proteger dados financeiros críticos em ambientes de produção corporativos, o servidor TechConsult impõe políticas rígidas:

• SQL Read-Only: Nenhuma query enviada via MCP pode conter INSERT, UPDATE, DELETE, DROP, ALTER ou TRUNCATE. Tentativas são rejeitadas na camada do parser com erro 403.
• Isolamento Físico de Buckets & Schemas: Todos os caminhos no MinIO são prefixados por clientId/, tabelas no banco de formulários utilizam separação estrita e bancos vetoriais LanceDB são particionados.
• Sem Acesso Direto à Infraestrutura: O agente de IA opera exclusivamente através das tools MCP disponibilizadas.