ums

DocumentType — Arquitectura de Agregados

Contexto Delimitado: Aprobaciones
Raíz de Agregado: DocumentType
Módulo: Ums.Domain.Approvals.DocumentType
Estado: Producción

---

1. Visión General del Agregado

Propósito

El agregado DocumentType gobierna las clasificaciones, reglas y esquemas de políticas para los documentos subidos por los usuarios (ej., Pasaportes, Documentos de certificación). Declara umbrales críticos (Criticity), vincula intervalos de notificación recurrentes (entidades NotificationRule) y configura acciones proactivas de cumplimiento de seguridad (entidad EnforcementPolicy) para ejecutarse automáticamente cuando un documento obligatorio expira o se elimina. A través de la entidad hija NotificationRule, se define un umbral de advertencia reactivo para el cumplimiento de documentos.

Responsabilidad de Negocio

• Registrar y clasificar documentos de verificación corporativa.
• Establecer pautas de criticidad (Baja, Media, Alta, Crítica).
• Mantener intervalos dinámicos de notificación para alertar previamente a los usuarios antes de que expire un documento a través de NotificationRule.
• Definir canales de transmisión de alertas (correo electrónico, SMS, etc.).
• Definir bloqueos automáticos de cumplimiento (ej., Bloqueo de acceso, restricción de perfiles) cuando fallan los elementos críticos de cumplimiento.

Raíz de Agregado

DocumentType es la raíz del agregado. Definir acciones de cumplimiento o configurar alertas de notificación debe realizarse a través de él para aplicar las invariantes. La entidad NotificationRule no puede existir ni realizar transiciones de estado fuera de las restricciones de ciclo de vida de su DocumentType padre.

Invariantes y Reglas de Consistencia

1. Cada DocumentType debe poseer un Code único dentro de su espacio de nombres de TenantId.
2. Unicidad de DaysBefore (INV-DT2): Los umbrales de alerta (DaysBefore) en las NotificationRules propias deben ser únicos en la lista de reglas.
3. Mandatos Críticos (INV-DT1): Si un DocumentType se establece en Critical, debe tener exactamente una EnforcementPolicy activa definida para garantizar el cumplimiento del sistema.
4. Política Única (INV-DT3): Solo se permite una EnforcementPolicy activa por DocumentType.
5. Coincidencia de Criticidad (INV-DT4): Los tipos de documentos que no son críticos/altos no pueden aplicar acciones de cumplimiento como BlockUser o RestrictProfile.
6. Días Antes Válidos (INV-NR1): En NotificationRule, DaysBefore debe ser un número entero positivo estrictamente mayor que cero.
7. Canales Válidos (INV-NR2): La colección Channels en NotificationRule debe contener al menos un canal de notificación válido (Email, SMS, WebPortal) y no puede ser nula ni vacía.

Entidades Relacionadas / Objetos de Valor

| Entidad / VO | Tipo | Propietario | Descripción | |—|—|—|—| | DocumentTypeId | Objeto de Valor | | Identificador de raíz de agregado | | DocumentCriticity | Enumerado | | LOW · MEDIUM · HIGH · CRITICAL | | NotificationRule | Entidad | Propia | Define el umbral de advertencia reactivo de expiración | | NotificationRuleId | Objeto de Valor | Entidad Hija | Identificador único de la regla de notificación | | NotificationChannel | Enumerado | Entidad Hija | EMAIL · SMS · IN_APP · WEB_PUSH | | EnforcementPolicy | Entidad | Propia | Detalla períodos de gracia y bloqueos | | Code | Objeto de Valor | Entidad Hija | Identificador de tipo de notificación | | AuditValueObject | Objeto de Valor | | Rastrea metadatos de creación y modificación |

Eventos de Dominio

| Evento | Desencadenante | |—|—| | DocumentTypeRegisteredEvent | Se registra con éxito una nueva categoría de documento | | NotificationRuleConfiguredEvent | Se configura una regla de pre-alerta de vencimiento | | NotificationRuleRemovedEvent | Se elimina una regla de pre-alerta | | EnforcementPolicyDefinedEvent | Se define un bloqueo de cumplimiento | | EnforcementPolicyUpdatedEvent | Se actualizan los parámetros de cumplimiento |

Comandos / Casos de Uso

| Comando | Descripción | |—|—| | CreateDocumentTypeCommand | Registrar un nuevo tipo de documento con parámetros por defecto | | ConfigureNotificationRuleCommand | Configurar un nuevo umbral de alerta y sus canales | | RemoveNotificationRuleCommand | Eliminar una regla de pre-alerta de notificación existente | | DefineEnforcementPolicyCommand | Añadir una política de cumplimiento de bloqueo o degradación de perfil | | UpdateEnforcementPolicyCommand | Modificar las acciones o períodos de gracia de una política |

Límites de Repositorio / Servicio

• IDocumentTypeRepository — Persiste los esquemas de clasificación.
• Acotado estrictamente por TenantId para evitar cruces de configuración entre inquilinos.

---

2. Modelo de Dominio

Clases / Entidades / Objetos de Valor

DocumentType (Raíz de Agregado)
├── Props: DocumentTypeProps
│   ├── Id: DocumentTypeId
│   ├── TenantId: TenantId
│   ├── Code: Code
│   ├── Name: Name
│   ├── Description: Description
│   ├── Criticity: DocumentCriticity
│   └── Audit: AuditValueObject
├── Hijos
│   └── IReadOnlyCollection<NotificationRule>
│       └── Props: NotificationRuleProps
│           ├── Id: NotificationRuleId
│           ├── DaysBefore: int
│           ├── Channels: NotificationChannel[]
│           ├── Code: Code
│           └── Description: Description
└── Hijo (Anulable)
    └── EnforcementPolicy

---

3. Diagramas de Modelo de Objetos

classDiagram
    direction LR
    class DocumentType {
        +Guid Id
        +Guid TenantId
        +Code Code
        +Name Name
        +Description Description
        +DocumentCriticity Criticity
        +List~NotificationRule~ NotificationRules
        +EnforcementPolicy EnforcementPolicy
        +Create()
        +ConfigureNotificationRule()
        +DefineEnforcementPolicy()
    }
    class DocumentCriticity {
        <<enumeration>>
        LOW
        MEDIUM
        HIGH
        CRITICAL
    }
    class NotificationRule {
        +Guid Id
        +int DaysBefore
        +NotificationChannel[] Channels
        +Code Code
        +Description Description
        +Create()
    }
    class NotificationChannel {
        <<enumeration>>
        EMAIL
        SMS
        IN_APP
        WEB_PUSH
    }
    class EnforcementPolicy {
        +Guid Id
        +AccessEnforcementAction ActionOnExpiration
        +int? GracePeriodDays
    }
    DocumentType "1" *-- "1" DocumentCriticity
    DocumentType "1" *-- "0..*" NotificationRule
    DocumentType "1" *-- "0..1" EnforcementPolicy
    NotificationRule "1" *-- "1..*" NotificationChannel

---

4. Diagramas de Secuencia

Flujo para Definir Política de Cumplimiento

sequenceDiagram
    participant C as AdministradorInquilino
    participant H as DefinePolicyHandler
    participant R as IDocumentTypeRepository
    participant D as DocumentType (AR)

    C->>H: DefineEnforcementPolicyCommand(docTypeId, action, graceDays)
    H->>R: GetById(docTypeId)
    R-->>H: DocumentType (AR)
    H->>D: DefineEnforcementPolicy(action, graceDays, actorId)
    D->>D: Validar INV-DT4 (restricciones no críticas)
    D->>D: Validar INV-DT3 (límite de política única)
    D->>D: Levantar EnforcementPolicyDefinedEvent
    H->>R: Save(docType)
    R-->>H: ok
    H-->>C: ok

---

5. Modelo ER

erDiagram
    TENANT ||--o{ DOCUMENT_TYPE : "configura"
    DOCUMENT_TYPE ||--o{ NOTIFICATION_RULE : "define"
    DOCUMENT_TYPE ||--o| ENFORCEMENT_POLICY : "restringe"

    DOCUMENT_TYPE {
        uniqueidentifier DocumentTypeId PK
        uniqueidentifier TenantId FK
        nvarchar Code "Único por TenantId"
        nvarchar Name
        nvarchar Description
        nvarchar Criticity "LOW-MEDIUM-HIGH-CRITICAL"
        datetime2 UpdatedAt
        uniqueidentifier UpdatedBy
    }
    NOTIFICATION_RULE {
        uniqueidentifier RuleId PK
        uniqueidentifier DocumentTypeId FK
        int DaysBefore "Único por DocumentTypeId"
        nvarchar ChannelsJson "Matriz serializada de canales"
        nvarchar Code
        nvarchar Description
    }
    ENFORCEMENT_POLICY {
        uniqueidentifier PolicyId PK
        uniqueidentifier DocumentTypeId FK
        nvarchar ActionOnExpiration "BlockUser-RestrictProfile-Notify"
        int GracePeriodDays "Nullable"
    }

Reglas de Aislamiento de Inquilinos

• Los esquemas clasificados están particionados estrictamente por TenantId. Todas las consultas de enrutamiento de verificación imponen límites de aislamiento.
• NotificationRule es acotado a través de su agregado padre y hereda todas las restricciones de filtrado multi-inquilino.

---

6. Integración de Contexto Delimitado

• Aguas Arriba: Hereda las reglas de contexto de Identidad (validando registros de inquilinos).
• Aguas Abajo: Consultado por UserDocument para verificar los umbrales de alerta, y por AccessEnforcementPolicy durante los pases de verificación de cumplimiento. Las alertas configuradas a través de NotificationRule son procesadas por ejecutores en segundo plano para notificar a los usuarios.

---

7. Capa de Aplicación

• CreateDocumentTypeCommand -> Entradas: TenantId, Code, Name, Description, Criticity -> Retorna: Guid
• ConfigureNotificationRuleCommand -> Entradas: DocumentTypeId, DaysBefore, Channels, Code, Description -> Retorna: void
• RemoveNotificationRuleCommand -> Entradas: DocumentTypeId, RuleId -> Retorna: void
• DefineEnforcementPolicyCommand -> Entradas: DocumentTypeId, Action, GracePeriodDays? -> Retorna: void

---

8. Infraestructura/Persistencia

• Índice: Índice único en TenantId, Code. En NotificationRule, índice compuesto en DocumentTypeId, DaysBefore para asegurar unicidad.
• Transacción: Las actualizaciones de hijos (políticas y entradas de reglas de pre-alerta) se almacenan de forma atómica dentro de la transacción de base de datos del padre DOCUMENT_TYPE.

---

9. Seguridad y Cumplimiento

• Ajustar la clasificación o reglas críticas: Restringido estrictamente a los roles de Tenant:Admin. (Las configuraciones de NotificationRule se heredan de esta seguridad).
• Cumplimiento: Alterar las reglas de cumplimiento representa un alto impacto de seguridad y desencadena un registro de auditoría de alta gravedad.

---

10. Decisiones Técnicas

• Consolidar los modelos de NotificationRule pre-alerta y EnforcementPolicy como elementos secundarios dentro del agregado DocumentType protege los límites del dominio contra restricciones divididas.
• Almacenar los canales de comunicación permitidos como una matriz serializada (ChannelsJson) garantiza la flexibilidad sin sobrecargar de consultas complejas.

---

Volver al Índice de Aprobaciones

This site is open source. Improve this page.