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érminoDefiniciónDueño
VisitorPersona no autenticadaContent
LeadContacto comercial captadoCRM
OrganizationEmpresa cliente o LogicCore, con identidad estableCRM
ContactPersona de contacto asociada a una organizaciónCRM
UserPrincipal autenticadoIdentity
MembershipRelación user-organización-rolIdentity
OpportunityPotencial negocio en pipelineCRM
ProjectRequestSolicitud inicial del cliente; aún no es proyecto contratadoIntake
EvaluationAnálisis interno de viabilidad y alcanceIntake
EstimateEstimación interna versionadaSales
ProposalOferta al cliente con vigencia y versiónSales
StatementOfWorkDefinición contractual de alcance/entregablesSales
ContractAcuerdo aceptado y versionadoContracts
ProjectTrabajo autorizado para ejecuciónDelivery
MilestoneCompromiso verificable del proyectoDelivery
DeliverableEntrega que puede requerir aceptaciónDelivery
ChangeRequestModificación propuesta de alcance/costo/plazoDelivery
InvoiceDocumento de cobro con identidad fiscal externa cuando apliqueFinance
PaymentPago registrado/verificado con referencia externaFinance
CreditNoteAjuste financiero según normativaFinance
TicketSolicitud de soporte con visibilidad y SLASupport
AuditEventRegistro inmutable de acción sensiblePlatform

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

  1. El User puede tener memberships en varias Organizations; solo roles explícitos permiten actuar por una.
  2. Un cliente nunca puede leer proyectos, documentos, facturas o tickets ajenos. Autorizar por recurso en backend, no solo ocultar navegación.
  3. LogicCore puede acceder a datos necesarios por rol interno; operaciones sensibles exigen auditoría.
  4. ProjectRequest, Proposal, Contract, Project e Invoice son entidades distintas; no reutilizar IDs ni confundir estados.
  5. Los importes conservan moneda ISO, unidades monetarias exactas y tasa/impuesto explicitados; no float para dinero.
  6. Adjuntos se almacenan fuera de la DB con metadatos, ACL y análisis antimalware a evaluar.
  7. 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.