Onboarding — novo desenvolvedor

Última atualização: 16/09/2026.

Objetivo: no primeiro dia você sobe o AMPLIA, entende o mapa mental e faz uma alteração segura (docs ou flag). Sem acesso a produção no dia 1.

Dia 0 — acessos

Peça ao time:

Leia, nesta ordem:

Siga setup.md até o smoke test (health.php + login).

Confirme:

CSS compilado (npm run build:css);
um White Label de teste e um usuário representante (para ver o recorte de dados diferente do super-admin);
MOVINGPAY_TOKEN_USAGE_*=HML se for bater em API externa.

Não é Laravel. Cada tela e cada API são arquivos PHP.
Tenant = White Label. Super-admin vê tudo (white_label_id nulo).
Permissão = flag + escopo do WL. A UI mente; a API manda.
SQL no serviço. Endpoint fino, serviço gordo.
Precificação tem dois modelos (custo efetivo e MDR) e três níveis (padrão, usuário, White Label) com herança.
Estabelecimento é o módulo mais pesado: cadastro local, remoto (adquirente), documentos, KYC, painel user_ec.

Onde mexer:

Quero mudar	Pasta
Tela	`frontend/pages/<modulo>/` + CSS/JS em `assets/`
Menu	`components/menu-lateral.php`
Endpoint	`backend/api/<modulo>/`
Regra / SQL	`backend/src/services/<modulo>/`
Integração	`backend/src/integrations/`
Schema	`database/migrations/`

Abra backend/api/auth/permissoes.php e veja o bootstrap.
No browser logado, chame o mesmo endpoint e compare o hash com o que assets/js/cp-permissions-live.js usa.
Crie um lead (se o módulo Comercial estiver ligado no tenant) e um estabelecimento em rascunho.
Troque de usuário para um representante e confirme que a listagem encolhe.

Prefira docs/ ou uma correção localizada. Branch feat|fix|docs/... a partir de Develop. Template em .github/PULL_REQUEST_TEMPLATE.md.

Se for endpoint novo: registre em api/endpoints.md e na matriz de permissões.