SmarterMCP

Servidor MCP de nível empresarial que emite eventos operacionais reais e métricas para alimentar painéis de decisão, pilotos e sistemas de negócios automatizados em qualquer nuvem

Documentação

Smarter-SPECS

Especificações técnicas do ecossistema Smarter LATAM.

Estrutura

Diretório	Conteúdo
`specs/`	Protocolos e especificações formais
`architecture/`	Infraestrutura VPS, serviços, rede
`api/`	Documentação de APIs (Smarter Food API)
`modules/`	Documentação por módulo de código
`runbooks/`	Procedimentos operativos

Protocolo Smarter v1.0

Ver specs/protocolo.md

Princípio: Verdade = coerência(.env ∩ contexto ∩ input_usuario)

4 Estados: VALIDADO | SUSPEITO | INCOERENTE | PENDENTE

Smarter Food API

Ver api/index.md

FastAPI v2.0.0 | Port 8002 | Gemini 2.5 Flash
Contrato de Incoerência antes de IA
4 estados de validação verificados

Arquitetura VPS

Ver architecture/index.md

28 domínios no Caddy
22 contêineres Docker
Ollama + Gemini + n8n + Odoo + Chatwoot

Regras Críticas

Código sem .md → inválido
Mudança na lógica → requer atualização de doc
Doc desatualizada → sistema incoerente
Deploy sem doc → FAIL