Backend de academia sobre Evo (W12) + endpoint MCP para agentes de IA

O modelo de dados de uma academia conectado à API real do Evo (W12) via proxy — config-as-code e exposto via MCP para um agente de IA ler e gravar. É o mesmo contrato canônico do template gym, só que sobre um sistema de gestão real: o backend por trás do agente de WhatsApp gym-leads-evo e a prova de integração da vertical academia.

O que faz

• Espelha o contrato canônico do gym (leads, alunos, planos, sessões, agendamentos, presença, matrículas) sobre a Evo (W12).
• Proxia as coleções de operação para a API do Evo via external sources, com field_mapping (contrato canônico ↔ payload do Evo).
• Mantém activities e plans nativos na rekor — a Evo não expõe catálogo de modalidades nem de planos.
• Já trata as idiossincrasias do Evo: create_lead exige email, session_id é composto e list_free_sessions exige date.
• Expõe dois endpoints MCP: gym-leads-evo (captação) e gym-members-evo (suporte ao aluno).

Pra quem é

Quem quer provar a vertical academia contra um sistema de gestão real (Evo / W12) — mesmo agente e mesmo contrato do gym nativo, trocando só o backend.

O que vem dentro

Nove collections com JSON Schema — as de operação proxiadas para a Evo (evo-integracao-api.w12app.com.br) e activities/plans nativas — mais dois endpoints MCP Factory já curados. A autenticação com a Evo usa um secret de vault (secret_ref: vault:evo-api-token, placeholder org-scoped). Sem habilitar a integração, o backend roda em modo seed local (prod-safe).

Faça seu

Depois de rekor template pull gym-evo, suba como qualquer database:

rekor databases create gym-evo --name "Gym (Evo / W12)"
rekor push gym-evo
rekor databases promote gym-evo --from <preview>

Para ir ao ar contra um tenant Evo real, crie o secret evo-api-token no vault, ajuste o idBranch nas URLs dos sources para a sua filial e habilite a integração — o modo seed (desabilitado) é para testar o agente sem tocar a Evo de produção. Para o backend nativo de referência (sem integração), veja o template gym.

rekor template pull gym-evo --lang pt