A visão
Uma estrela central, 12 instalações na constelação
Cada cliente é um mundo com a sua própria instalação — banco, credenciais e configuração separados dos demais. Nenhuma delas recebe alteração feita à mão: todas recebem apenas versões publicadas e verificadas, o que torna rastreável exatamente o que está rodando no seu ambiente. A m3ca é a instalação da própria M3 — e o único ponto que enxerga a carteira: licença, cobrança e saúde de cada instalação.
Linhas azuis = federação (API): licença, cobrança, bloqueio, sinal de saúde. Linha dourada = distribuição das versões publicadas (somente leitura nas pontas).
Os mundos
As 12 instâncias
Cada cliente roda a própria instalação, com banco e credenciais próprios, e com os módulos licenciados conforme o contrato. Princípio: máximo aproveitamento de módulos por cliente simulado — cada persona exercita combinações diferentes e vira vitrine comercial de um recorte do sistema. Módulos em dourado = âncora da persona; em verde = integração entre módulos que a persona estreia.
m3ca
a estrela central — nossa própria empresa
Gestão centralizada de todas as instâncias e do negócio: carteira de clientes PJ (licenças por módulo), geração das cobranças mensais conforme contrato, bloqueio/desbloqueio por inadimplência, acompanhamento de cada cliente. A escola saiu daqui em 2026-08-03: o acadêmico de cursos livres e o LataciVerso viraram uma instância-cliente própria, a lataci (Instituto LATACI). A m3ca ficou com o que é da M3 — a federação e a operação comercial da própria empresa.
- Federação: contrato → cobrança mensal (Flexor Financeiro) → status de pagamento → bloqueio remoto na instância do cliente.
- A carteira PJ (instancia/contrato/contrato_modulo) só é populada aqui — inclusive a linha da própria lataci.
- Licencia o catálogo inteiro, e por motivo operacional, não comercial: a m3ca é a bancada onde toda tela é construída e verificada. Módulo ausente do perfil faria o controle de licença devolver 404 em todas as rotas daquele app — e a verificação automática mediria "tela quebrada" numa tela perfeita. A lista ao lado não é, portanto, um recorte de venda; os recortes de verdade são os das outras instalações.
lataci
Instituto LATACI — a escola livre e o simulador, fora da sede
Era a metade "escola" da m3ca até 2026-08-03. Não é IES formal no MEC — oferece cursos livres, de extensão e de iniciação científica, com certificados próprios; os alunos entram pelo funil de captação e são clientes (pessoa física) do mesmo financeiro. Roda também o LataciVerso, o simulador de mercado gamificado, vinculado ao percurso do curso livre (Flexor Aprendizagem), ao banco de questões e ao repositório.
- Funil aluno-cliente: captacao → matricula (curso livre) → cobrança → certificado emitido via Flexor Documentos.
- LataciVerso e seus três spin-offs (conectaverso, progressao, acervo) compartilham o banco Postgres próprio da instância.
centrouniversitario
o mundo acadêmico completo — a instância mais rica
O caso de uso mais completo do conjunto. Exercita o Flexor Acadêmico inteiro (campus, curso, oferta, matricula, estrutura, captacao, protocolo, estagio, stricto) mais indicadores, projetos, eventos e o banco de questões — agora com TRI (calibração de itens e proficiência).
- Vitrine do TRI: banco de questões calibrado, simulado adaptativo, proficiência alimentando indicadores.
- Orçamento institucional (orcamento/orcgeral/orcfolha) + financeiro de mensalidades.
supermercado
varejo de volume — vendas × produto × estoque
O caso de uso de varejo, em que produto, estoque e orçamento se encontram. Vitrine da integração nova Flexor Vendas × Flexor Orçamento: o item de venda referencia o cadastro de produto (preço, estoque, margem), e a venda fechada gera lançamento no financeiro.
- Baixa de estoque na venda; reposição vira demanda; margem por categoria no painel.
- Omni/mídia para ofertas da semana; documentos para contratos de fornecedores.
barbearia
serviço de agenda — a menor instância comercial
A persona Barbearia já existe dentro do app venda (segmento com preset de tema, rótulos e galeria). Aqui ela ganha instância própria e mostra que o M3 serve o pequeno serviço: agendamento, equipe, galeria, cobrança simples.
- Agendamento e funil de vendas do Flexor Vendas; galeria de imagens já pronta.
- Mídia/omni para presença digital; financeiro enxuto (contas a receber do dia).
pequenocomercio
o balcão essencial — prova do tier mínimo
Loja de bairro: vendas + produto + financeiro e nada mais. É a instância que valida o caminho mínimo — quantos módulos dá para desligar e o sistema continua redondo (menu, permissões, painéis e seeds respeitando o perfil de módulos licenciados).
- Mesmo trilho venda↔produto do supermercado, em escala mínima.
- Serve de teste do o controle de licença: módulos não licenciados somem de fato.
escritorioservicos
trabalho por demanda — fluxo, não estoque
Escritório de serviços (contábil/jurídico/consultoria): o valor está no fluxo de trabalho. Âncora em Flexor Demandas (workflow) e Flexor Projetos, com a integração nova omni↔demanda — atendimento omnichannel abre e acompanha demandas.
- Venda de serviço (sem produto físico) → contrato (documento) → faturamento recorrente (financeiro).
- Projetos para trabalhos maiores; adm para a rotina interna.
construtora
o orçamento pesado — obra como projeto
A persona que espreme o Flexor Orçamento inteiro: orçamento de obra (orcamento), plano de contas e centros de custo (orcgeral), folha da obra (orcfolha), insumos (produto). Integração nova orcamento↔projeto: cada obra é um projeto, com medições virando lançamentos no financeiro.
- Composição de custo de obra por insumo (produto) e por etapa (projeto).
- Demandas para o canteiro; documentos para contratos e ARTs.
osc
Instituto Semear — governança colegiada e projeto social
Organização da Sociedade Civil: não vende, não matricula, não fabrica — presta contas. Âncora dupla em Flexor Estrutura (assembleia, conselho de administração, conselho fiscal: composição de cadeiras, mandato, convocação e ata) e Flexor Projetos (o projeto social com suas rubricas e o indicador de resultado que o convênio cobra). É a persona que dá dono a um dado que já existia órfão na forja — o vitrine_mmca_projeto.json é literalmente uma OSC (rubrica "Execução do Projeto Social", "500 famílias… Índice de Vulnerabilidade Social", mutirão com voluntários).
- Estrutura fora do acadêmico: primeira instância a licenciar Flexor Estrutura como módulo próprio, sem Flexor Acadêmico — a composição não referencia curso, e a reunião não referencia espaço de campus.
- Mandato vencendo acende o alerta do estrutura/alertas.py; a ata vira documento assinado no Flexor Documentos.
escolalivre
Escola Livre Artes e Ofícios — ensinar sem a máquina comercial
Escola de cursos livres: marcenaria, cerâmica, panificação, costura. Não emite diploma reconhecido nem matricula em curso formal — ensina, e é só isso que precisa fazer bem. É a persona mais enxuta da constelação e a que prova o oposto de todas as outras: dá para licenciar o ensino puro, com a turma, a aula ao vivo, a trilha e o acervo, sem vendas, sem financeiro e sem atendimento omnichannel — o balcão da escola resolve o resto.
- Trilha de aprendizagem (Flexor Aprendizagem) com a aula ao vivo na Flexor Sala Virtual: a turma acontece, é gravada e fica no acervo.
- Flexor Questões para a avaliação da oficina e Flexor Repositório para apostila, molde e ficha técnica — o material de uma oficina de cerâmica é reaproveitado na turma seguinte.
startupproduto
SaaS self-serve — o cliente entra sozinho
Empresa de produto digital com entrada self-serve: teste gratuito, plano de assinatura, conversão sem vendedor na frente. O funil começa no atendimento (Flexor Omni é o canal de entrada) e vira conta no Flexor Vendas; o suporte e o pedido de funcionalidade viram demanda, e o roteiro do produto é um projeto. Único lugar da constelação com Flexor Clipping: acompanhar marca e concorrência é hábito de quem tem produto, não de quem presta serviço.
- Atendimento → conta → assinatura → cobrança recorrente, com o contrato assinado no Flexor Documentos.
- Sem Flexor Contador: nessa persona a contabilidade é terceirizada, e o que fica dentro é o indicador de negócio (Flexor Indicadores e Flexor Gestor).
startupservico
consultoria e agência — o cliente é conquistado
Consultoria, agência ou integrador: a receita vem de projeto entregue, não de assinatura. O pipeline é consultivo e tem três tempos — proposta (Flexor Orçamento), contrato (Flexor Contratos) e entrega (Flexor Projetos), com alocação por consultor. Licencia Flexor Contador porque aqui a contabilidade é serviço prestado e consumido de perto, e Flexor Compras porque o projeto consome insumo de terceiro.
- Proposta → contrato → projeto → medição → faturamento: o mesmo trilho da construtora, mas com hora de consultor no lugar de insumo de obra.
- Sem Flexor Omni e sem Flexor Clipping: a aquisição é consultiva — relacionamento e indicação —, não um funil que se otimiza.
O elo
Federação m3ca ↔ instâncias
O elo entre a instalação do cliente e a M3 — deliberadamente mínimo. Um canal autenticado por instância, três conversas apenas — licença, cobrança e sinal de saúde. Sem sincronizar dados de negócio do cliente: a federação trafega só o contrato e a saúde da instalação.
Licença
O contrato vive na m3ca (Flexor Cliente: cliente + módulos licenciados + valor mensal por módulo). A instância consulta/recebe seu perfil de licença e o o controle de licença aplica: módulo não licenciado não aparece (menu, rotas, permissões). Status ativa / em carência / bloqueada.
Cobrança
Todo mês a m3ca gera as cobranças no Flexor Financeiro conforme o contrato de cada cliente. Pagamento registrado → instância segue ativa. Vencida → em carência (banner de aviso na instância) → bloqueada (acesso barrado, exceto admin local para regularização/backup).
Sinal de saúde
A instância reporta periodicamente: está viva, versão instalada, contadores básicos (usuários ativos, último acesso). A m3ca acompanha a carteira: quem está atualizado, quem está fora do ar, quem precisa de atenção.
Identidade cross-instância (doutrina fechada 2026-07-19)
A PK é puramente local por banco (mesma pessoa é id 42 na m3ca e id 987 na instância — correto; offset/prefixo por instância é proibido, não sobrevive a dump/restore). Dois carregadores viajam junto: documento (CPF/CNPJ) casa o ente do mundo real entre bancos; identificador (aditivo em pessoa.pessoa e cliente.empresa) identifica aquele registro — estável a renumeração/dump/restore, chave de sincronização. A instância é ignorante (só sabe o próprio identificador e o próprio status de licença); a m3ca é a única autoridade do mapa instância×identificador×id_local×documento — nenhuma instância o consulta (fronteira de privacidade: casar por CPF entre instâncias é socialmente perigoso). O mapa e a conferência (identificador → fallback documento → conflito em fila humana) vivem na m3ca, e só nela.
As pontes
Como os módulos conversam
Os casos de uso acima só funcionam porque os módulos se ligam: a venda que vira contas a receber, o orçamento ancorado num projeto, o atendimento que abre uma demanda, o aluno que vira cliente. O mapa completo dessas pontes — separando o que já está no código do que os casos de uso ainda pedem — ganhou página própria.
12 instalações, cada uma com uma combinação diferente de módulos: é a prova prática da flexibilidade que a vitrine promete. Cada cliente roda a própria instalação, com banco e credenciais próprios.