@startuml uml-package-diagram

!include _style.iuml
skinparam packageStyle rectangle
title Diagrama UML de Paquetes — Monorepo ExpressMX

top to bottom direction

package "apps" as appsGroup {
    package "@expressmx/web\nNext.js 16 / RSC" as web <<application>>
    package "@expressmx/mobile-client\nExpo / RN" as mclient <<application>>
    package "@expressmx/mobile-provider\nExpo / RN" as mprov <<application>>
}

package "packages" as packagesGroup {
    package "@expressmx/database\npg + queries SQL" as db <<library>>
    package "@expressmx/validations\nZod schemas" as validations <<library>>
    package "@expressmx/types\ntipos compartidos" as types <<library>>
    package "@expressmx/utils\nhelpers puros" as utils <<library>>
}

package "packages/config" as configGroup {
    package "@expressmx/config-typescript" as tsConfig <<config>>
    package "@expressmx/config-eslint"     as esConfig <<config>>
}

package "migrations" as migrationsGroup <<sql-migrations>> {
    note as migNote
        001 auth_credentials_and_reset
        002 fix_usuarios_uuid_default
        003 pins_soporte_cliente
        004 rbac_permisos_zero_trust
        005 audit_correlacion
        006 support_itsm
    end note
}

package "docs" as docsGroup <<documentation>> {
    note as docsNote
        architecture
        errors
        mobile-client
        sessions
        auth-recovery
        design-source
    end note
}

package "infra (no implementado)" as infraGroup <<infrastructure>> {
    note as infraNote
        docker (vacio)
        k8s    (vacio)
    end note
}

' Runtime dependencies
web ..> db
web ..> validations
web ..> types
web ..> utils

mclient ..> validations
mclient ..> types
mclient ..> utils

mprov ..> validations
mprov ..> types
mprov ..> utils

types ..> validations

' Dev dependencies (resumido en flecha agregada)
appsGroup ..> tsConfig : <<dev>>
appsGroup ..> esConfig : <<dev>>
packagesGroup ..> tsConfig : <<dev>>

' Logical
db ..> migrationsGroup : <<consume>>
docsGroup ..> packagesGroup : <<documenta>>
docsGroup ..> appsGroup     : <<documenta>>

note right of mclient
  Apps moviles NUNCA importan
  @expressmx/database (regla de
  arquitectura). Hablan al backend
  por REST + JWT.
end note

footer Fuente: pnpm-workspace.yaml + apps/*/package.json + packages/*/package.json
@enduml