Model de dades Fase 1A

flowchart LR
  ORG["orgs
centre · arrel multi-tenant"]

  USR["usuaris
compte que entra i paga"]
  ROL["rols · permisos
19 permisos, àmbit per rol"]

  FAM["families
familia_usuaris"]
  ALU["alumnes
+ alumne_salut"]

  ACA["temporades · etapes
cursos · festius"]
  CAT["activitats
+ traduccions, imatges, catàlegs"]
  HOR["horaris · horari_dies
combinacions · blocs · preu_trams"]

  INS["inscripcions
+ dies, blocs, docs, autoritzacions"]
  ABS["absencies"]
  PAG["pagaments
Stripe només externs"]
  COM["plantilles_email
enviaments"]

  CFG["configuracions
consentiments · textos_legals"]
  AUD["audit_logs · exportacions
processos"]
  CKE["clickedu_sincronitzacions
clickedu_cache"]
  MIG["legacy_*
migracio_files · incidencies"]

  ORG --> USR
  ORG --> ACA
  ORG --> CAT
  USR --> ROL
  USR --> FAM
  FAM --> ALU
  ACA --> CAT
  CAT --> HOR
  ALU --> INS
  HOR --> INS
  USR --> INS
  INS --> ABS
  INS --> PAG
  INS --> COM
  CFG --> INS
  INS --> AUD
  CKE --> ALU
  MIG --> INS
  MIG --> CAT
  MIG --> USR

erDiagram
  orgs {
    text name
    text code UK
    text timezone
    text default_locale "ca"
    bool active
  }
  usuaris {
    uuid org_id FK
    enum kind "intern / extern / treballador"
    enum auth_source "clickedu / local"
    text clickedu_username UK "identificador únic d accés"
    text cognito_sub UK
    text email UK "únic dins del centre"
    text dni UK "amb lletra de control · duplicats només contra la nostra BD"
    text given_name
    text surname_1
    text surname_2
    enum status "actiu / pendent_validacio / suspes"
    bool is_staff "treballador del centre"
    text password_hash "mai autentica · Post-Auth Lambda, futura migració"
  }
  rols {
    uuid org_id FK
    text code UK "grup de Cognito"
    text name
    bool is_predefined "11 rols predefinits"
    timestamptz suspended_at "suspensió temporal"
    uuid cloned_from_rol_id FK
  }
  permisos {
    text code UK "catàleg tancat de 19"
    text name
    enum level "baix / mitja / mitja_alt / alt / molt_alt"
  }
  rol_permisos {
    uuid rol_id FK
    uuid permis_id FK
    enum scope "si / parcial / lectura / assignades / propies / del_dia / disponibles / crear / agregat"
  }
  usuari_rols {
    uuid usuari_id FK
    uuid rol_id FK
    timestamptz assigned_at
    uuid assigned_by_usuari_id FK
  }

  orgs ||--o{ usuaris : "conté"
  orgs ||--o{ rols : "conté"
  usuaris ||--o{ usuari_rols : "té assignats"
  rols ||--o{ usuari_rols : "assignat a"
  rols ||--o{ rol_permisos : "atorga"
  permisos ||--o{ rol_permisos : "atorgat per"
  rols }o--|| rols : "clonat de"

erDiagram
  families {
    uuid org_id FK
    text clickedu_family_id UK
    text label "per a la cerca administrativa"
  }
  familia_usuaris {
    uuid familia_id FK
    uuid usuari_id FK
    enum relation "pare / mare / tutor"
    bool is_primary
    bool custody_exclusive "si no, la confirmació va als dos tutors"
  }
  alumnes {
    uuid org_id FK
    uuid familia_id FK
    text given_name
    text surname_1
    text surname_2
    date birth_date "filtre per edat i regles de curs"
    text dni
    uuid curs_id FK "sense curs vàlid no es pot inscriure"
    text clickedu_student_id UK
    enum origin "clickedu / local"
    text health_card_number "catsalut · dada sensible"
    bool active
  }
  alumne_salut {
    uuid alumne_id PK "1 a 1 · retenció i consentiment propis"
    text allergies
    text obs_alimentacio
    text obs_natacio
    text malalties
    bool share_with_monitors "consentiment explícit"
  }
  usuaris {
    uuid id PK
    enum kind "intern / extern / treballador"
  }
  cursos {
    uuid id PK
    text code
  }

  families ||--o{ familia_usuaris : "té titulars"
  usuaris ||--o{ familia_usuaris : "pertany a"
  families ||--o{ alumnes : "té fills"
  alumnes ||--|| alumne_salut : "dades de salut"
  cursos ||--o{ alumnes : "matriculats a"

erDiagram
  temporades {
    uuid org_id FK
    text code UK "2026-2027"
    date date_from
    date date_to
    bool is_current
    date promotion_date "per defecte 1 de juny"
  }
  etapes {
    uuid org_id FK
    text code UK
    int ordre
    bool active
  }
  cursos {
    uuid org_id FK
    uuid etapa_id FK
    text code UK
    int ordre
    uuid next_curs_id FK "el +1 de la promoció es declara"
    timestamptz enrolment_opens_at "per defecte per curs"
    timestamptz enrolment_closes_at
    bool active
  }
  festius {
    uuid temporada_id FK
    date date
    text name
  }
  etapa_traduccions {
    uuid etapa_id FK
    text locale "ca obligatori · es i en amb fallback"
    text name
  }
  curs_traduccions {
    uuid curs_id FK
    text locale
    text name
  }

  temporades ||--o{ festius : "té festius"
  etapes ||--o{ cursos : "agrupa"
  etapes ||--o{ etapa_traduccions : "traduïda a"
  cursos ||--o{ curs_traduccions : "traduït a"
  cursos }o--|| cursos : "promociona cap a"

erDiagram
  activitats {
    uuid org_id FK
    uuid temporada_id FK
    uuid tipus_activitat_id FK
    enum seccio "extraescolars / altres"
    enum audience "interns / externs / tots"
    date date_from
    date date_to
    timestamptz enrolment_opens_at "NULL hereta del curs"
    timestamptz enrolment_closes_at
    enum state "esborrany / publicada / validada / finalitzada / arxivada"
    bool published_admin_only "només alta manual"
    bool competition
    enum payment_card "obligatori / opcional / no_aplica · només externs"
    int min_period_value "NULL hereta de la configuració global"
    enum min_period_unit "cap / dia / setmana / mes / trimestre / curs"
    bool places_shared "compartides entre cursos o per curs"
    uuid duplicated_from_activitat_id FK
    bool active
  }
  activitat_traduccions {
    uuid activitat_id FK
    text locale
    text name "obligatori en ca"
    text description
    text conditions
  }
  tipus_activitats {
    uuid org_id FK
    enum seccio "categories fitades per secció"
    text code UK
    text responsible_name
    int ordre
    bool active
  }
  tipus_activitat_responsables {
    uuid tipus_activitat_id FK
    text email
  }
  activitat_cursos {
    uuid activitat_id FK
    uuid curs_id FK
  }
  activitat_imatges {
    uuid activitat_id FK
    text storage_key "S3"
    int ordre "és l ordre del portal"
    bool is_cover
  }
  activitat_imatge_traduccions {
    uuid activitat_imatge_id FK
    text locale
    text caption "destí de titol_2 de GNA"
  }
  activitat_responsables {
    uuid activitat_id FK
    text email
    enum kind "responsable / competicio"
  }
  materials {
    uuid org_id FK
    text code
    numeric price
    int min_qty "peu_minim"
    int max_qty "peu_maxim"
    bool active
  }
  activitat_materials {
    uuid activitat_id FK
    uuid material_id FK
    bool required
  }
  autoritzacions {
    uuid org_id FK
    text code
    bool active
  }
  activitat_autoritzacions {
    uuid activitat_id FK
    uuid autoritzacio_id FK
    bool mandatory "obligatòria bloqueja la confirmació"
  }
  documentacions {
    uuid org_id FK
    text code
    enum kind "requerida / lliurament"
    bool active
  }
  activitat_documentacions {
    uuid activitat_id FK
    uuid documentacio_id FK
    bool required
    bool blocks_confirmation "els PDF no bloquegen per defecte"
  }
  activitat_adjunts {
    uuid activitat_id FK
    text storage_key
    text name
    bool prefill "s omple amb les dades de la inscripció"
  }
  temporades {
    uuid id PK
    text code
  }

  temporades ||--o{ activitats : "conté"
  tipus_activitats ||--o{ activitats : "categoritza"
  tipus_activitats ||--o{ tipus_activitat_responsables : "notifica a"
  activitats ||--o{ activitat_traduccions : "traduïda a"
  activitats ||--o{ activitat_cursos : "oberta a"
  activitats ||--o{ activitat_imatges : "il·lustrada per"
  activitat_imatges ||--o{ activitat_imatge_traduccions : "peu de foto"
  activitats ||--o{ activitat_responsables : "notifica a"
  activitats ||--o{ activitat_materials : "requereix"
  materials ||--o{ activitat_materials : "usat per"
  activitats ||--o{ activitat_autoritzacions : "demana"
  autoritzacions ||--o{ activitat_autoritzacions : "demanada per"
  activitats ||--o{ activitat_documentacions : "demana"
  documentacions ||--o{ activitat_documentacions : "demanada per"
  activitats ||--o{ activitat_adjunts : "adjunta"
  activitats }o--|| activitats : "duplicada de"

erDiagram
  horaris {
    uuid activitat_id FK
    uuid curs_id FK "NULL val per a tots els cursos"
    enum kind "fix / a_convenir"
    int places
    int places_minimes
    int cupo
    int ordre
    bool active
  }
  horari_dies {
    uuid horari_id FK
    int weekday "1 a 7 · substitueix dia_1..7"
    time time_from
    time time_to
    int places "capacitat · l ocupació es calcula"
    int places_minimes
    int cupo
    numeric price
  }
  horari_combinacions {
    uuid horari_id FK
    text label
    numeric price "preuc1..3 de GNA"
    bool mandatory_days "dies obligatoris"
  }
  horari_combinacio_dies {
    uuid horari_combinacio_id FK
    int weekday
  }
  blocs {
    uuid org_id FK
    uuid temporada_id FK
    text code
    date date_from
    date date_to
    int ordre
  }
  horari_blocs {
    uuid horari_id FK
    uuid bloc_id FK
    int places
    int cupo
  }
  horari_bloc_franges {
    uuid horari_bloc_id FK
    int ordre "1 a 3 · normalitza hora_inici_1..3"
    time time_from
    time time_to
    numeric price
  }
  preu_trams {
    uuid activitat_id FK
    uuid horari_id FK "NULL val per a tota l activitat"
    enum target "base / treballador / fill_treballador / familiar_treballador / extern"
    enum mode "fix / percentatge"
    numeric value "sense tram definit s aplica el base"
  }
  activitats {
    uuid id PK
    enum seccio "extraescolars / altres"
  }
  cursos {
    uuid id PK
    text code
  }

  activitats ||--o{ horaris : "té"
  cursos ||--o{ horaris : "restringeix"
  horaris ||--o{ horari_dies : "es fa els dies"
  horaris ||--o{ horari_combinacions : "ofereix combinacions"
  horari_combinacions ||--o{ horari_combinacio_dies : "inclou"
  horaris ||--o{ horari_blocs : "per període"
  blocs ||--o{ horari_blocs : "aplicat a"
  horari_blocs ||--o{ horari_bloc_franges : "amb franges"
  activitats ||--o{ preu_trams : "tarifa"
  horaris ||--o{ preu_trams : "tarifa pròpia"

erDiagram
  inscripcions {
    uuid org_id FK
    uuid temporada_id FK
    uuid alumne_id FK
    uuid activitat_id FK
    uuid horari_id FK
    uuid horari_combinacio_id FK
    uuid usuari_id FK "el compte titular, qui paga"
    uuid created_by_usuari_id FK "pot ser administració"
    bool es_administrativa "permet excedir restriccions amb avís"
    text admin_reason "motiu registrat de l excepció"
    enum state "preinscripcio / pendent_de_completar / confirmada / pendent_validacio_documents / baixa / cancellada"
    numeric price_base
    numeric discount_pct
    text discount_reason "treballador / multi_fill / multi_activitat"
    numeric total
    timestamptz enrolled_at
    date effective_from
    date effective_to
    timestamptz baixa_requested_at
    date baixa_effective_at "segons el dia límit configurat"
    text baixa_reason "el motiu que escriu la família"
    uuid previous_inscripcio_id FK "cadena del canvi d activitat"
    inet ip "traçabilitat de les autoritzacions"
    text comments
  }
  inscripcio_dies {
    uuid inscripcio_id FK
    int weekday
    time time_from
    time time_to
  }
  inscripcio_blocs {
    uuid inscripcio_id FK
    uuid bloc_id FK "les setmanes escollides"
  }
  inscripcio_preferencies_horari {
    uuid inscripcio_id FK
    int ordre "1 a 3"
    uuid horari_id FK
    text note
    bool assigned "la coordinació assigna"
  }
  inscripcio_materials {
    uuid inscripcio_id FK
    uuid material_id FK
    int qty
    numeric unit_price
  }
  inscripcio_autoritzacions {
    uuid inscripcio_id FK
    uuid autoritzacio_id FK
    bool granted
    timestamptz granted_at
    uuid granted_by_usuari_id FK
    inet ip "IP i segell de temps substitueixen el PIN"
  }
  inscripcio_documents {
    uuid inscripcio_id FK
    uuid documentacio_id FK
    text storage_key "S3 xifrat, URL signada"
    text file_hash
    timestamptz uploaded_at
    enum state "pendent / pujat / validat / rebutjat"
    uuid reviewed_by_usuari_id FK
    text review_note
  }
  inscripcio_estats {
    uuid inscripcio_id FK
    enum from_state
    enum to_state
    timestamptz at
    uuid by_usuari_id FK "NULL és el sistema"
    text reason
  }
  alumnes {
    uuid id PK
    date birth_date
  }
  activitats {
    uuid id PK
    enum state "esborrany / publicada / validada / finalitzada / arxivada"
  }
  horaris {
    uuid id PK
    enum kind "fix / a_convenir"
  }

  alumnes ||--o{ inscripcions : "inscrit a"
  activitats ||--o{ inscripcions : "rep"
  horaris ||--o{ inscripcions : "assignat a"
  inscripcions ||--o{ inscripcio_dies : "els dies"
  inscripcions ||--o{ inscripcio_blocs : "els períodes"
  inscripcions ||--o{ inscripcio_preferencies_horari : "preferències a convenir"
  inscripcions ||--o{ inscripcio_materials : "amb material"
  inscripcions ||--o{ inscripcio_autoritzacions : "autoritzacions"
  inscripcions ||--o{ inscripcio_documents : "documentació"
  inscripcions ||--o{ inscripcio_estats : "historial d estats"
  inscripcions }o--|| inscripcions : "substitueix"

erDiagram
  motius_absencia {
    uuid org_id FK
    text code
    int ordre
    bool active
  }
  motiu_absencia_traduccions {
    uuid motiu_absencia_id FK
    text locale
    text name
  }
  absencies {
    uuid org_id FK
    uuid alumne_id FK
    uuid inscripcio_id FK
    date date
    uuid motiu_absencia_id FK
    text note
    timestamptz communicated_at
    uuid communicated_by_usuari_id FK
  }
  alumnes {
    uuid id PK
  }
  inscripcions {
    uuid id PK
    enum state
  }

  motius_absencia ||--o{ motiu_absencia_traduccions : "traduït a"
  motius_absencia ||--o{ absencies : "motiu de"
  alumnes ||--o{ absencies : "absent"
  inscripcions ||--o{ absencies : "de la sessió"

erDiagram
  pagaments {
    uuid org_id FK
    uuid usuari_id FK
    enum method "targeta / transferencia / fora_de_plataforma"
    enum provider "stripe o cap"
    numeric amount
    enum state "pendent / pagat / fallit / retornat"
    text stripe_payment_intent_id
    text stripe_subscription_id "recurrent mensual"
    timestamptz paid_at
  }
  pagament_linies {
    uuid pagament_id FK
    uuid inscripcio_id FK
    numeric amount
  }
  devolucions {
    uuid pagament_id FK
    numeric amount
    text reason
    text stripe_refund_id
    timestamptz at
    uuid by_usuari_id FK
  }
  descomptes {
    uuid org_id FK
    enum code "treballador / multi_fill / multi_activitat"
    enum mode "fix / percentatge"
    numeric value "treballador 50 per cent per defecte"
    bool active
  }
  usuaris {
    uuid id PK
    enum kind "intern paga fora de la plataforma"
  }
  inscripcions {
    uuid id PK
    numeric total
  }

  usuaris ||--o{ pagaments : "paga"
  pagaments ||--o{ pagament_linies : "cobreix"
  inscripcions ||--o{ pagament_linies : "pagada per"
  pagaments ||--o{ devolucions : "retorna"

erDiagram
  plantilles_email {
    uuid org_id FK
    text code UK
    enum event "confirmacio / baixa / recordatori / assignacio_horari / preinscripcio / document_pendent"
    bool active
    bool auto_send "desactivable per a proves"
  }
  plantilla_email_traduccions {
    uuid plantilla_id FK
    text locale
    text subject
    text body_html
  }
  enviaments {
    uuid plantilla_id FK
    text to_email
    uuid inscripcio_id FK
    uuid usuari_id FK
    enum state "en_cua / enviat / fallit"
    text provider_message_id "SES"
    timestamptz sent_at
    text error
  }
  inscripcions {
    uuid id PK
  }

  plantilles_email ||--o{ plantilla_email_traduccions : "traduïda a"
  plantilles_email ||--o{ enviaments : "genera"
  inscripcions ||--o{ enviaments : "notificada per"

erDiagram
  configuracions {
    uuid org_id FK
    text key UK
    jsonb value
    enum group "calendari / dates_inscripcio / descomptes / cataleg / textos_legals / idioma"
    uuid updated_by_usuari_id FK
  }
  consentiments {
    uuid org_id FK
    text code
    enum ambit "registre / inscripcio / ambdos"
    bool mandatory
    int ordre
    bool active
  }
  consentiment_traduccions {
    uuid consentiment_id FK
    text locale
    text name
    text text
  }
  consentiment_atorgaments {
    uuid consentiment_id FK
    uuid usuari_id FK
    uuid alumne_id FK "p. ex. compartir al·lèrgies amb els monitors"
    bool granted
    timestamptz at
    inet ip
    timestamptz revoked_at "dret d oposició i limitació"
  }
  textos_legals {
    uuid org_id FK
    enum code "rgpd / condicions / cookies"
  }
  text_legal_traduccions {
    uuid text_legal_id FK
    text locale
    text body_html
  }
  sollicituds_rgpd {
    uuid usuari_id FK
    enum kind "acces / rectificacio / oposicio / supressio"
    enum state "rebuda / en_analisi / aprovada / denegada / executada"
    timestamptz requested_at
    timestamptz resolved_at "revisió manual, 30 dies com a màxim"
    uuid resolved_by_usuari_id FK
    text legal_retention_note "què es conserva per obligació legal"
    text export_storage_key "JSON i PDF llegible en menys d un minut"
  }
  usuaris {
    uuid id PK
  }

  consentiments ||--o{ consentiment_traduccions : "traduït a"
  consentiments ||--o{ consentiment_atorgaments : "atorgat com"
  usuaris ||--o{ consentiment_atorgaments : "atorga"
  usuaris ||--o{ sollicituds_rgpd : "exerceix drets"
  textos_legals ||--o{ text_legal_traduccions : "traduït a"

erDiagram
  audit_logs {
    uuid org_id FK
    uuid usuari_id FK
    inet ip
    text action
    text entity_type
    uuid entity_id
    enum permission_level "tot alt i molt_alt"
    jsonb before
    jsonb after
    timestamptz at "immutable · retenció 5 anys"
  }
  exportacions {
    uuid org_id FK
    uuid usuari_id FK
    enum kind "inscripcions / usuaris / pagaments / audit"
    jsonb filters
    int row_count
    text storage_key
    timestamptz at
  }
  processos {
    uuid org_id FK
    text code UK "promocio_cursos / sincronitzacio_clickedu / recordatoris_documents / expiracio_activitats"
    text schedule "editable"
    bool enabled
    timestamptz last_run_at
    timestamptz next_run_at
  }
  execucions_proces {
    uuid proces_id FK
    timestamptz started_at
    timestamptz finished_at
    enum state "ok / parcial / fallida"
    jsonb summary
    text error
  }
  usuaris {
    uuid id PK
  }

  usuaris ||--o{ audit_logs : "actua"
  usuaris ||--o{ exportacions : "exporta"
  processos ||--o{ execucions_proces : "s executa"

erDiagram
  clickedu_sincronitzacions {
    uuid org_id FK
    enum trigger "login / manual"
    timestamptz started_at
    timestamptz finished_at
    enum state "ok / parcial / fallida"
    int students_seen
    int changes_applied
    jsonb errors "3 reintents i avís · mai sobreescriure"
  }
  clickedu_cache {
    uuid usuari_id FK
    jsonb payload "alumnes, cursos, etapes, famílies, contacte, al·lèrgies · cap credencial"
    timestamptz fetched_at
    timestamptz expires_at "conté dades personals · retenció pròpia"
  }
  usuaris {
    uuid id PK
    text clickedu_username UK
  }
  alumnes {
    uuid id PK
    text clickedu_student_id UK
    enum origin "clickedu / local"
  }

  usuaris ||--o| clickedu_cache : "cau de sessió"
  clickedu_sincronitzacions ||--o{ alumnes : "actualitza"

erDiagram
  legacy_inscripcions {
    text codi "totes les columnes com a text"
    text tot_lo_altre "sense FK, sense enums, sense obligatorietat"
  }
  legacy_w_activitats {
    text codi
    text tot_lo_altre
  }
  legacy_registre_estiu {
    text codi
    text tot_lo_altre "les credencials es descarten a la importació"
  }
  migracio_execucions {
    text source_hash "identifica quin bolcat es va llegir"
    timestamptz started_at
    timestamptz finished_at
    enum state "en_curs / ok / amb_incidencies / fallida"
    jsonb counts "llegides, creades, omeses, deduplicades per taula"
  }
  migracio_files {
    uuid execucio_id FK
    text legacy_font UK "el codi de GNA només és únic dins la seva taula"
    text legacy_codi UK
    text target_table
    uuid target_id
    enum action "creada / actualitzada / omesa / fusionada"
  }
  migracio_incidencies {
    uuid execucio_id FK
    text legacy_font
    text legacy_codi
    enum severity "avis / error"
    enum code "referencia_penjada / duplicat / codificacio / valor_invalid / credencial_descartada"
    jsonb detail
  }
  inscripcions {
    uuid id PK
    text legacy_font
    text legacy_codi
  }
  activitats {
    uuid id PK
    text legacy_font
    text legacy_codi
  }
  usuaris {
    uuid id PK
    text legacy_font
    text legacy_codi
  }

  migracio_execucions ||--o{ migracio_files : "registra"
  migracio_execucions ||--o{ migracio_incidencies : "reporta"
  legacy_inscripcions ||--o{ migracio_files : "transformada en"
  legacy_w_activitats ||--o{ migracio_files : "transformada en"
  legacy_registre_estiu ||--o{ migracio_files : "transformada en"
  migracio_files ||--o| inscripcions : "apunta a"
  migracio_files ||--o| activitats : "apunta a"
  migracio_files ||--o| usuaris : "apunta a"