ttheo.
Voltar

Sistemas modulares

Quando usar Sistema Modular (vs App único)

Quando usar Sistema Modular

A escolha mais importante ao começar um app na plataforma. Errar custa tempo de retrabalho.

Decisão em 30 segundos

Responda 4 perguntas. Se 2 ou mais forem "sim" → use Sistema Modular (Wizard).

#PerguntaSim → modular
1Vai ter 3 ou mais entidades de dados (clientes, produtos, pedidos, etc)?✓
2Vai ter vários fluxos (cadastrar + listar + dashboard + relatórios)?✓
3Vai ter perfis diferentes (admin vê tudo, vendedor só sua carteira)?✓
4Você descreveria como "sistema", "plataforma" ou "gestão de"?✓

Como cada caminho funciona

App único (caminho normal)

  • 1 tela só (ou poucas com Bea.useUrlState)
  • 1 entidade principal, 1-2 fluxos
  • Limite prático: ~2000 linhas de código
  • Exemplos: calculadora, lista de tarefas, cadastro simples

Sistema modular (Wizard)

  • 1 app pai + N sub-apps (módulos independentes)
  • Compartilham tabelas comuns (schema declarado no pai)
  • Cada sub-app foca em UMA função (CRUD de clientes, Pipeline, Relatórios...)
  • IA gera código menor por sub-app → menos chance de erro
  • Exemplos: CRM, ERP, helpdesk, gestão de projetos

Exemplos concretos

✅ App único faz sentido pra:

PedidoPor quê
"Calculadora de juros compostos"1 fluxo, sem persistência
"Lista de tarefas pessoal"1 entidade (tarefas)
"Conversor de unidades"Sem entidade
"Cadastro simples de clientes com busca"1 entidade, 1 fluxo (CRUD)
"Página de orçamento"1 fluxo de cálculo

✅ Sistema modular faz sentido pra:

PedidoSub-apps típicos
"CRM comercial"Clientes · Pipeline · Relatórios
"ERP de loja"Produtos · Pedidos · Estoque · Vendas
"Helpdesk"Tickets · Atendimento · SLA · Relatórios
"Gestão de projetos"Projetos · Tasks · Kanban · Dashboard
"Clínica"Pacientes · Agenda · Prontuário · Financeiro
"Imobiliária"Imóveis · Clientes · Visitas · Contratos

Sinais que você ESCOLHEU ERRADO

Sinais de que deveria ter usado modular (e foi de app único):

  • Você passou de 2000 linhas e a IA começou a cortar código
  • Cada nova feature pedida pra IA "atrapalha" outras existentes
  • Mensagem "Resposta cortada no meio" começa a aparecer
  • Você gostaria de dar permissões diferentes pra parte X e parte Y

Sinais de que deveria ter usado app único (e foi de modular):

  • Você criou um sistema com 1 sub-app só
  • O wizard propôs 6 sub-apps e você não sabe pra que serve metade
  • Cada sub-app é só 10 linhas de código

Como começar do jeito certo

App único

  1. Dashboard → digite a descrição → "Criar"
  2. Pronto — modo IA externa ou interna depois

Sistema modular

  1. Dashboard → link "Sistema modular →" (no rodapé do campo)
  2. OU /creator/wizard direto
  3. Descreva o sistema em 1-2 parágrafos
  4. IA propõe estrutura → você revisa → cria

Dica do wizard: ele tem um botão "Não sabe como descrever? Use IA externa pra te ajudar" — copia um meta-prompt pra você usar no ChatGPT/Claude.ai/Gemini.

Já tenho um app único — dá pra migrar?

Sim, mas exige trabalho manual:

  1. Wizard cria o sistema modular novo (com schema)
  2. Você pede pra IA: "Migra os dados do app app_<old>_x7k2 pra app_<new>_shared_clientes"
  3. Cada sub-app implementado conforme o original

Pra sistemas muito grandes, geralmente vale recomeçar com o wizard — design fica mais limpo.

Próximos passos