Clientes (Personas)
Los clientes son representados por el modelo Persona (Person) con diferentes tipos según el contexto.
Tipos de Persona
| Tipo | Descripción |
|---|---|
organization | Tenant/organización que usa la plataforma |
customer | Cliente de una organización |
contact | Contacto secundario |
Campos del Cliente
| Campo | Descripción |
|---|---|
| Nombre | Nombre o razón social |
| Apodo | Nombre comercial |
| Nombre legal | Razón social completa |
| Tipo de documento | CPF o CNPJ |
| Número del documento | Normalizado (solo dígitos) |
| Naturaleza | natural (persona física) o juridical (persona jurídica) |
| Fecha de nacimiento | Opcional |
| Direcciones | Lista de direcciones (JSON) |
| Teléfonos | Lista de teléfonos (JSON) |
| E-mails | Lista de e-mails (JSON) |
| Sitios web | Lista de websites (JSON) |
| Tags | Lista de tags para categorización |
| Notas | Observaciones internas |
| Datos personalizados | Campos customizados (JSON) |
Jerarquía
Los clientes pertenecen a una organización vía el campo parent_id:
Organización (type=organization, parentId=null)
├── Cliente A (type=customer, parentId=org_id)
├── Cliente B (type=customer, parentId=org_id)
└── Contacto (type=contact, parentId=org_id)
Validaciones
- Número de documento único dentro de la organización
- Código externo (
external_id) único por organización - Restricciones en el formato del documento: CPF (11 dígitos) o CNPJ (14 dígitos)
Capturas de pantalla
Lista de clientes
La pantalla /dashboard/customers lista los clientes de la organización con búsqueda por nombre, documento o e-mail. La tabla muestra el documento, el e-mail, el total de cuentas de cobro vinculadas y el MRR consolidado.
Detalle del cliente
La página /dashboard/customers/[id] reúne los datos de registro, las cuentas de cobro vinculadas, suscripciones, facturas, pagos, NF-e y auditoría — todo en un único contexto para soporte y finanzas.
