> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# Visão geral de módulos

Contratos pequenos que tornam a infraestrutura mais fácil de compreender e reutilizar.

## Leia a base em linguagem simples

A autenticação verifica quem fez login. Uma sessão lembra desse login. Um espaço de trabalho mantém juntos os registros de uma pessoa ou equipe. O faturamento registra pagamentos; um direito concede acesso a um recurso. Um trabalho executa trabalho fora de uma solicitação de página. O email transacional envia mensagens acionadas por ações do aplicativo, como códigos de login, em vez de divulgação de marketing.

Um adaptador conecta um serviço à mesma interface do aplicativo. Adaptadores locais ou falsos permitem explorar sem contas de provedor. Quando precisar de um serviço real, selecione um provedor e siga seu guia de configuração; você não precisa configurar todos os módulos de uma vez. Comece com banco de dados e login e, em seguida, ative pagamentos, IA e trabalho em segundo plano somente quando seu produto precisar deles.

[Comece com dados persistentes](https://supastack.dev/pt/docs/web/database.md)

[Entenda o login real](https://supastack.dev/pt/docs/modules/auth.md)

[Encontre o guia de configuração de um recurso](https://supastack.dev/pt/docs/web/project-structure.md)


## Compõe as capacidades de que precisas

Os pacotes partilhados fornecem identidade, persistência de workspace, faturação, IA, jobs em segundo plano, email transacional e observabilidade. As apps compõem estes módulos; a lógica de domínio do produto fica fora do Starter Core.

Prefere o contrato existente ao integrar uma funcionalidade. Se não conseguir descrever o comportamento de que precisas, torna essa limitação explícita antes de o estender.


## Segue a propriedade ao longo do fluxo

Uma sessão identifica um utilizador. Um workspace delimita os seus registos. As permissões autorizam capacidades. Uma tarefa em segundo plano transporta contexto de confiança para a execução. Os registos de utilização e auditoria permitem depois à aplicação prestar contas do trabalho.


## Usa adaptadores locais para verificações deterministas

Os adaptadores fake/locais suportam testes repetíveis sem pedidos pagos a fornecedores. Fornecedores reais são verificados através de um caminho de smoke configurado à parte. Um teste de adaptador é evidência sobre o contrato, não uma prova de entrega ou persistência real.


## Seguinte

[Ambiente e configuração](https://supastack.dev/pt/docs/modules/config.md)