Hub
O Hub é o núcleo operacional da plataforma Alcance Contabilidade - o conjunto de domínios que sustenta o dia a dia do escritório. Reúne o cadastro de clientes (PF/PJ) e usuários internos, a organização do atendimento em carteiras contábeis, as automações fiscais e de obrigações acessórias (Celery), os conversores de extratos e relatórios bancários, as integrações com bancos e ERPs (Cora, Klingo) e os dashboards que consolidam a operação. É a base usada por toda a equipe da contabilidade e pelos sistemas que orbitam a WebApi.
Dentro da WebApiAlcance, o Hub concentra os domínios operacionais centrais servidos por routers FastAPI sob o prefixo /api/v1/. Cada domínio é um recurso independente com seu próprio base path, escopos e schemas, mas todos compartilham o mesmo contrato de autenticação e o mesmo envelope de resposta. É por aqui que passam o cadastro-mestre (clientes, sócios, serviços, colaboradores), o pipeline de automação (agendamentos, workers, activities, erros) e os dados financeiros importados de terceiros.
Autenticação e envelope padrão
Todos os endpoints exigem Authorization: Bearer <API_KEY> com os escopos apropriados e respondem no envelope padrão { status, message, data }. Veja Autenticação e Conceitos. Domínios como Customers e Worker Automation já são consumidos hoje pelo MCP gateway; outros, sensíveis (como Users), não devem ser expostos a clientes IA.