Organizações
Organizações são os tenants (inquilinos) da plataforma. Cada organização é um negócio que usa o Faturamento Automático para cobrar seus próprios clientes.
Campos da Organização
| Campo | Descrição |
|---|---|
| ID externo | Identificador único para integrações externas |
| Nome | Nome da organização |
| Tipo de documento | CPF ou CNPJ |
| Número do documento | CPF ou CNPJ (normalizado, apenas dígitos) |
| E-mail principal de contato | |
| Telefone | Telefone de contato |
| Endereços | Lista de endereços |
| Status | active (padrão) |
Bootstrap Automático
Ao criar uma organização, o sistema automaticamente:
- Cria a empresa padrão com os mesmos dados cadastrais
- Cria os papéis de dashboard padrão (owner, admin, viewer)
- Cria o usuário proprietário com o e-mail da organização
Ciclo de Vida
- Criar: Fornece dados cadastrais, recebe organização pronta com empresa e usuários
- Atualizar: Nome, contato e endereços editáveis
- Deletar: Soft delete (apenas se não houver contas de cobrança ativas)
Modelo de Dados
A organização utiliza uma Pessoa (Person com type=organization) para armazenar os dados cadastrais. Isso permite que organizações e clientes compartilhem o mesmo modelo flexível de dados.