Avançado

Sub-apps (parent / child)

Sub-apps

Pra apps grandes (>6 entidades, >1500 linhas), divida em sub-apps — apps independentes que compartilham dados.

Quando dividir

SintomaSolução
App ficou >2000 linhasDivide em sub-apps
5+ telas muito diferentesCada uma vira sub-app
Múltiplos perfis (admin, vendedor, cliente)Sub-app por perfil

Estrutura

App pai: "Sistema Vendas"
├── Sub-app: "Cadastro de produtos"
├── Sub-app: "Pedidos"
├── Sub-app: "Clientes"
└── Sub-app: "Relatórios"

Criar sub-app

App pai → Configurações → Sub-appsNovo:

  • Nome
  • (Cria com parent_id apontando pro app pai)

Cross-data automático

Sub-apps de mesma "família" (mesmo parent) leem tabelas uns dos outros sem precisar de connection:

// Sub-app "Pedidos" lê tabela do sub-app "Clientes":
await Bea.db.query("SELECT * FROM app_clientes_x7m2");

Acesso é read-only entre siblings — escrita só nas próprias tabelas.

Navegação

Sub-apps aparecem no submenu lateral quando você abre o pai:

🏢 Acme Corp
├── 📦 Sistema Vendas
│   ├── 🛒 Cadastro de produtos
│   ├── 📋 Pedidos
│   ├── 👥 Clientes
│   └── 📊 Relatórios

Deploy

Cada sub-app pode ser deployado separadamente com seu próprio subdomínio:

  • produtos-x.beadev.ai
  • pedidos-x.beadev.ai

Ou todos como rotas no domínio do pai:

  • vendas.beadev.ai/produtos
  • vendas.beadev.ai/pedidos