uma estrela central · cada cliente, sua própria instalação

CONSTELAÇÃO M3

O M3 Flexor é uma constelação de instâncias federadas: cada cliente com sua própria instalação, banco e credenciais — todas acompanhadas pela instância central m3ca, que cuida do financeiro da empresa, das licenças por módulo e do acompanhamento de cada cliente.

M3 12 instalações · 12 combinações de módulos · um mesmo sistema

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

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.
Flexor FinanceiroFlexor ClienteFlexor Acadêmico Flexor AdministrativoFlexor ClippingFlexor Compras Flexor ContadorFlexor ContratosFlexor Demandas Flexor DocumentosFlexor EstoqueFlexor Estrutura Flexor EventosFlexor GestorFlexor Indicadores Flexor InfraestruturaFlexor IntegraçãoFlexor LataciVerso Flexor LogísticaFlexor MídiaFlexor Omni Flexor OrçamentoFlexor PessoasFlexor Produtos Flexor ProjetosFlexor ProtocolosFlexor Questões Flexor RepositórioFlexor RHFlexor Vendas
Papel únicoA m3ca é a única instância com o lado "servidor" da federação ligado — as demais rodam o lado "cliente" (sinal de saúde + o controle de licença).
LTC

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.
Flexor AcadêmicoFlexor LataciVersoFlexor Cliente Flexor DocumentosFlexor EstruturaFlexor Financeiro Flexor IndicadoresFlexor InfraestruturaFlexor Omni Flexor PessoasFlexor QuestõesFlexor RH
Funil completo, ponta a pontacaptacao → matrícula (curso livre) → cobrança → certificado emitido via Flexor Documentos, e o curso "LataciVerso" com dado de verdade — o simulador passou a licenciar o percurso que de fato vende (Flexor Aprendizagem), em vez do acadêmico que nunca teve dado. O acervo rico do repositório segue sendo o do centrouniversitario, outra persona: os dois têm dado, cada um no seu porte.
CTU

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.
Flexor AcadêmicoFlexor QuestõesFlexor Administrativo Flexor ClienteFlexor ComprasFlexor Demandas Flexor DocumentosFlexor EstoqueFlexor Estrutura Flexor EventosFlexor FinanceiroFlexor Indicadores Flexor InfraestruturaFlexor LataciVersoFlexor Logística Flexor MídiaFlexor OmniFlexor Orçamento Flexor PessoasFlexor ProdutosFlexor Projetos Flexor ProtocolosFlexor RepositórioFlexor RH Flexor Sala Virtual
SM

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.
Flexor VendasFlexor OrçamentoFlexor Cliente Flexor ComprasFlexor EstoqueFlexor Logística Flexor PessoasFlexor ProdutosFlexor RH venda↔produto/estoquevenda→financeiro
BB

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).
Flexor VendasFlexor ClienteFlexor Documentos Flexor FinanceiroFlexor MídiaFlexor Omni Flexor PessoasFlexor RH
PC

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.
Flexor VendasFlexor ClienteFlexor Financeiro Flexor PessoasFlexor RH
ES

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.
Flexor DemandasFlexor ProjetosFlexor Administrativo Flexor ClienteFlexor DocumentosFlexor Financeiro Flexor InfraestruturaFlexor OmniFlexor Pessoas Flexor RHFlexor Vendas omni↔demanda
CT

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.
Flexor OrçamentoFlexor ProjetosFlexor Administrativo Flexor ClienteFlexor ComprasFlexor Demandas Flexor DocumentosFlexor EstoqueFlexor Financeiro Flexor InfraestruturaFlexor LogísticaFlexor Pessoas Flexor ProdutosFlexor RH orcamento↔projeto
OSC

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.
Flexor EstruturaFlexor ProjetosFlexor Administrativo Flexor ClienteFlexor ComprasFlexor Demandas Flexor DocumentosFlexor EstoqueFlexor Eventos Flexor FinanceiroFlexor IndicadoresFlexor Infraestrutura Flexor LogísticaFlexor MídiaFlexor Omni Flexor PessoasFlexor ProdutosFlexor Protocolos Flexor RH estrutura sem acadêmico
O que fica de fora é a decisãoO Flexor Orçamento continua fora, e é a única ausência deliberada da persona: ele é motor de orçamento de venda por produto (composição de custo, medição de obra, venda mensal), e numa OSC o que se chama de orçamento é o orçamento por convênio — que já mora nas rubricas do Flexor Projetos. Mantê-lo daria à organização dois motores de orçamento que se contradizem. Tudo o mais entrou: suprimentos porque compras é inoperável sem o cadastro de produto (é dependência de modelo, não campo opcional), e o almoxarifado porque o Instituto Semear guarda cesta básica, agasalho de campanha e muda de viveiro — coisas com validade, transferência e perda, que é exatamente o que o controle de estoque registra.
ELO

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.
Flexor AprendizagemFlexor Sala VirtualFlexor Cliente Flexor PessoasFlexor QuestõesFlexor Repositório
A prova do mínimo pedagógicoO pequenocomercio prova o caminho mínimo do comércio; esta prova o do ensino. São dois pisos diferentes do mesmo sistema, e não compartilham módulo-âncora nenhum — que é exatamente o que uma plataforma modular precisa demonstrar para não ser só um sistema grande com telas desligadas.
SaaS

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).
Flexor VendasFlexor OmniFlexor Cliente Flexor ClippingFlexor ContratosFlexor Demandas Flexor DocumentosFlexor FinanceiroFlexor Gestor Flexor IndicadoresFlexor IntegraçãoFlexor Pessoas Flexor ProjetosFlexor RH
CS

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.
Flexor ProjetosFlexor ContratosFlexor Cliente Flexor ComprasFlexor ContadorFlexor Demandas Flexor DocumentosFlexor FinanceiroFlexor Gestor Flexor IndicadoresFlexor IntegraçãoFlexor Orçamento Flexor PessoasFlexor RHFlexor Vendas
O par que existe para ser comparadoEsta e a startupproduto têm porte parecido e modelos de aquisição opostos. A diferença entre as duas listas ao lado é a resposta prática à pergunta que todo prospect faz — "o que muda no sistema se eu vendo assinatura em vez de projeto?". Muda o começo do funil, não o sistema.

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.

Propostas vetáveis carência de 10 dias após o vencimento antes do bloqueio · tolerância offline de 7 dias sem sinal de saúde antes de a instância se auto-degradar para "em carência" (evita cliente refém de queda de rede) · no bloqueio, o admin local mantém acesso somente-leitura + tela de regularizaçã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.

Ver as integrações entre módulos →

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.