Domain model
Ubiquitous language: Organization, Membership, ProjectRequest and more (DOC-002).
Source: docs/domain/DOC-002-domain-model.md
DOC-002: Modelo conceptual de dominio
Estado: Draft 2026-11-12. Fuente de requisitos: DOC-001 v2.0. No es schema Prisma ni autorización para implementar sin briefs.
Lenguaje ubicuo
| Término | Definición | Dueño |
|---|---|---|
| Visitor | Persona no autenticada | Content |
| Lead | Contacto comercial captado | CRM |
| Organization | Empresa cliente o LogicCore, con identidad estable | CRM |
| Contact | Persona de contacto asociada a una organización | CRM |
| User | Principal autenticado | Identity |
| Membership | Relación user-organización-rol | Identity |
| Opportunity | Potencial negocio en pipeline | CRM |
| ProjectRequest | Solicitud inicial del cliente; aún no es proyecto contratado | Intake |
| Evaluation | Análisis interno de viabilidad y alcance | Intake |
| Estimate | Estimación interna versionada | Sales |
| Proposal | Oferta al cliente con vigencia y versión | Sales |
| StatementOfWork | Definición contractual de alcance/entregables | Sales |
| Contract | Acuerdo aceptado y versionado | Contracts |
| Project | Trabajo autorizado para ejecución | Delivery |
| Milestone | Compromiso verificable del proyecto | Delivery |
| Deliverable | Entrega que puede requerir aceptación | Delivery |
| ChangeRequest | Modificación propuesta de alcance/costo/plazo | Delivery |
| Invoice | Documento de cobro con identidad fiscal externa cuando aplique | Finance |
| Payment | Pago registrado/verificado con referencia externa | Finance |
| CreditNote | Ajuste financiero según normativa | Finance |
| Ticket | Solicitud de soporte con visibilidad y SLA | Support |
| AuditEvent | Registro inmutable de acción sensible | Platform |
Ciclos de vida sugeridos
- ProjectRequest: draft → submitted → under_review → needs_information → qualified / rejected / withdrawn; transiciones auditadas.
- Proposal: draft → issued → viewed → accepted / declined / expired / superseded. Solo versión issued puede aceptarse.
- Project: planned → active → on_hold → completed → closed / cancelled.
- Invoice: draft → issued → partially_paid / paid / overdue / voided; ajustes posteriores por nota de crédito cuando aplique.
- Payment: pending → verified / failed / refunded / disputed; webhook y conciliación idempotentes.
Reglas
- El User puede tener memberships en varias Organizations; solo roles explícitos permiten actuar por una.
- Un cliente nunca puede leer proyectos, documentos, facturas o tickets ajenos. Autorizar por recurso en backend, no solo ocultar navegación.
- LogicCore puede acceder a datos necesarios por rol interno; operaciones sensibles exigen auditoría.
- ProjectRequest, Proposal, Contract, Project e Invoice son entidades distintas; no reutilizar IDs ni confundir estados.
- Los importes conservan moneda ISO, unidades monetarias exactas y tasa/impuesto explicitados; no float para dinero.
- Adjuntos se almacenan fuera de la DB con metadatos, ACL y análisis antimalware a evaluar.
- Eventos recomendados: LeadCaptured, ProjectRequestSubmitted, EvaluationCompleted, ProposalIssued, ProposalAccepted, ContractActivated, MilestoneAccepted, InvoiceIssued, PaymentVerified, TicketOpened.
Context map
CRM → Intake → Sales → Contracts → Delivery → Finance; Support referencia Organization/Project sin apropiarse de ellos. Identity publica autorización transversal. Integraciones mediante contratos y eventos. El diseño lógico/físico se define por feature.