decidim-stratified_sortitions 0.0.1

data/config/locales/es.yml

@@ -0,0 +1,360 @@
+---
+es:
+  activemodel:
+    attributes:
+      stratified_sortition:
+        created_at: Fecha de creación
+        title: Título
+        description: Descripción
+        num_candidates: Número de personas candidatas a seleccionar
+        selection_criteria: Criterios de elegibilidad
+        selected_profiles_description: Descripción de los perfiles a seleccionar
+    errors:
+      messages:
+        cannot_add_strata_with_sample_participants: "No se pueden añadir estratos cuando ya hay participantes importados"
+        cannot_delete_strata_with_sample_participants: "No se pueden eliminar estratos cuando ya hay participantes importados"
+        cannot_change_stratum_name_with_sample_participants: "No se puede cambiar el nombre del estrato cuando ya hay participantes importados"
+        cannot_change_stratum_kind_with_sample_participants: "No se puede cambiar el tipo del estrato cuando ya hay participantes importados"
+        cannot_add_substrata_with_sample_participants: "No se pueden añadir subestratos cuando ya hay participantes importados"
+        cannot_delete_substrata_with_sample_participants: "No se pueden eliminar subestratos cuando ya hay participantes importados"
+        cannot_change_substratum_name_with_sample_participants: "No se puede cambiar el nombre del subestrato cuando ya hay participantes importados"
+        cannot_change_substratum_value_with_sample_participants: "No se puede cambiar el valor del subestrato cuando ya hay participantes importados"
+        cannot_change_substratum_range_with_sample_participants: "No se puede cambiar el rango del subestrato cuando ya hay participantes importados"
+        cannot_change_num_candidates_when_executed: "No se puede cambiar el número de candidatos después de que el sorteo haya sido ejecutado"
+  decidim:
+    admin:
+      components:
+        index:
+          headers:
+            scope: Ámbito
+    components:
+      stratified_sortitions:
+        name: Sorteos estratificados
+        settings:
+          global:
+            announcement: Aviso
+            publish_sortitions: Publicar gráficos comparativos de los sorteos
+          step:
+            announcement: Aviso
+    stratified_sortitions:
+      admin:
+        actions:
+          configure: Configurar
+          confirm_destroy: ¿Estás seguro de que quieres eliminar este %{name}?
+          destroy: Eliminar
+          duplicate: Duplicar
+          execute: Ejecutar sorteo
+          new_stratified_sortition: "Nuevo sorteo estratificado"
+          title: "Acciones"
+          census_management: Gestionar muestra
+        models:
+          stratified_sortition:
+            fields:
+              created_at: Fecha de creación
+              title: Título
+              description: Descripción
+              num_candidates: Número de candidatas a seleccionar
+              selection_criteria: Criterios de elegibilidad
+              selected_profiles_description: Descripción de los perfiles a seleccionar
+              status: Estado
+        stratified_sortitions:
+          create:
+            error: Ha habido un problema al crear este sorteo estratificado
+            success: Sorteo estratificado creado con éxito
+          destroy:
+            error: Ha habido un problema al eliminar este sorteo estratificado
+            has_problems: Este sorteo estratificado no se pudo eliminar debido a problemas relacionados
+            success: Sorteo estratificado eliminado con éxito
+          execute:
+            candidates: Candidatos
+            chart_results: Gráficos de distribución
+            tab_charts: Gráficos comparativos
+            tab_participants: Participantes seleccionados
+            empty_sample_participants: No se puede ejecutar el sorteo sin un censo cargado
+            execute_stratified_sortition: Ejecutar sorteo estratificado
+            confirm_execute_title: Confirmación
+            confirm_execute_body: Al ejecutar el sorteo este quedará registrado a la plataforma y la acción será irreversible. No se podrán editar los datos, la configuración de los estratos ni la muestra.
+            confirm_execute_ok: Ejecutar sorteo
+            confirm_execute_cancel: Cancelar
+            export: Exportar
+            export_results: Exportar resultados
+            export_csv: Resultados del sorteo estratificado como CSV
+            export_excel: Resultados del sorteo estratificado como Excel
+            export_json: Resultados del sorteo estratificado como JSON
+            export_charts_pdf: Exportar gráficos PDF
+            pdf_title: "Resultados del sorteo %{name}"
+            pdf_subtitle: Gráficos comparativos de distribución de la muestra
+            pdf_belongs_to: "Pertenece a: %{space_name}"
+            pdf_algorithm: "Algoritmo usado: %{algorithm}"
+            pdf_executed_at: "Sorteo realizado el: %{date}"
+            pdf_no_data: Sin datos
+            algorithm: Algoritmo
+            generated_at: Generado el
+            generation_time: Tiempo de generación
+            total_participants: Total de participantes
+            num_panels: Número de paneles
+            selected_at: Seleccionado el
+            verification_seed: Seed de verificación
+            random_value_used: Valor aleatorio utilizado
+            selected_panel_probability: Probabilidad del panel seleccionado
+            selected_participants_title: Participantes seleccionados
+            selected_participants:
+              one: "1 participante seleccionado"
+              other: "%{count} participantes seleccionados"
+            participant_id: ID
+            personal_data_1: Dato personal 1
+            personal_data_2: Dato personal 2
+            personal_data_3: Dato personal 3
+            personal_data_4: Dato personal 4
+            no_results_yet: El sorteo aún no se ha ejecutado.
+            confirm_participants_title: Muestra el listado de las participantes seleccionadas
+            confirm_participants_body: Estás accediendo a información y datos personales. Esta acción quedará registrada.
+            confirm_participants_ok: Muestra
+            confirm_participants_cancel: Cancelar
+            results: Resultados
+            executing_notice: El sorteo se está procesando en segundo plano. Esta página se actualizará cuando haya finalizado.
+            execution_failed: "La ejecución del sorteo ha fallado:"
+            success: Sorteo estratificado ejecutado con éxito
+            executing: El sorteo ha sido encolado y se está procesando en segundo plano.
+            target: Objetivo
+            title: Ejecutar sorteo estratificado
+          export_results:
+            no_results: No hay resultados para exportar. Ejecute el sorteo primero.
+          duplicate:
+            error: Ha habido un problema al duplicar este sorteo estratificado
+            success: Sorteo estratificado duplicado con éxito
+          index:
+            selected: Sorteos estratificados seleccionados
+            title: Sorteos estratificados
+          new:
+            create: Crear
+            title: Nuevo sorteo estratificado
+          edit:
+            title: Editar sorteo estratificado
+            update: Actualizar
+          form:
+            data: Información general
+            description: Descripción
+            name: Nombre
+            published: Publicado
+            selected_profiles_description_help: Puedes indicar, si corresponde, los criterios de estratificación utilizados en el sorteo, y la razón.
+            selection_criteria_help: Puedes indicar, si corresponde, los criterios de elegibilidad de las personas que han sido seleccionadas para participar en el sorteo.
+          strata:
+            title: Estratos
+            add_stratum: Añadir estrato
+          stratum:
+            up: Subir
+            down: Bajar
+            remove: Eliminar
+            name: Nombre
+            kind:
+              numeric_range: Rango numérico
+              title: Tipo
+              value: Valor
+            substrata_title: Subestratos
+            title: Estrato
+          substrata:
+            add_substratum: Añadir subestrato
+          substratum:
+            up: Subir
+            down: Bajar
+            remove: Eliminar
+            name: Nombre
+            value: Valor
+            value_placeholder: Valor
+            range: Rango
+            range_placeholder: Rango (p. ej. 0-18)
+            title: Subestrato
+            max_quota_percentage: Objetivo %
+            max_quota_percentage_placeholder: Objetivo %
+          update:
+            error: Ha habido un problema al actualizar este sorteo estratificado
+            success: Sorteo estratificado actualizado con éxito
+          upload_sample:
+            age: Grupo de edad
+            candidates: Candidatos
+            census_file: Elegir un archivo
+            census_file_label: Archivo excel.csv con los datos del censo
+            configure_strata_first: Primero debes configurar los estratos y subestratos
+            count_uploaded_files: "<b>%{count}</b> registros cargados."
+            description: El archivo de la muestra tiene que ser un CSV y tiene que tener un formatsimilar al del ejemplo siguiente:<br>Puedes descargar y utilizar la plantilla.
+            download_template: "Descargar plantilla"
+            download_template_csv: "Descargar plantilla como CSV"
+            download_template_xlsx: "Descargar plantilla como XLSX"
+            example: "Dato candidato 1,Dato candidato 2,Dato candidato 3,Dato candidato 4,Estrato 1,Estrato 2,Estrato 3,Estrato N<br>example@example.com,D,Superiores,34<br>example@example.com,E,Superiores,24<br><br>. . ."
+            example_headers:
+              personal_data_1: "Dato personal 1 (identificador único)"
+              personal_data_2: "Dato personal 2"
+              personal_data_3: "Dato personal 3"
+              personal_data_4: "Dato personal 4"
+              gender: "Género"
+              age: "Edad"
+            example_rows:
+              - - "11111111X"
+                - "Nombre ejemplo 1"
+                - "Teléfono Ejemplo 1"
+                - "correo1@ejemplo.com"
+                - "Hombre"
+                - "45"
+              - - "22222222Y"
+                - "Nombre ejemplo 2"
+                - "Teléfono Ejemplo 2"
+                - "correo2@ejemplo.com"
+                - "Mujer"
+                - "42"
+            execute_stratified_sortition: Ejecutar sorteo
+            execute_stratified_sortition_help: El sorteo no se puede ejecutar hasta que no se carguen registros.
+            filename_data: "%{filename}, el día %{date}, número de registros %{count}"
+            gender: Género
+            last_upload_date: La última carga fue el día %{date}
+            help: Las cuatro primeras columnas son datos del candidato, por ejemplo correo electrónico, DNI, teléfono o dirección y las siguientes columnas son los estratos definidos en el sorteo estratificado. Cada fila representa un candidato.
+            no_data: No hay datos
+            place: Lugar de nacimiento
+            remove_uploaded_samples: Eliminar todos los registros
+            confirm_remove_uploaded_samples: ¿Estás seguro de que quieres eliminar todas las muestras cargadas?
+            strata_not_configured: Primero debes configurar los estratos y subestratos
+            target: Objetivo
+            title: Gestionar muestra
+            upload_census: Subir una nueva muestra
+            upload_file: Subir nueva muestra
+            uploaded_file: Datos de la muestra cargada
+            uploaded_files: "Se han agregado los siguientes archivos:"
+            no_uploaded_files: "No hay archivos cargados."
+            help_csv: "<b>El archivo a cargar tiene que seguir las siguientes instrucciones:</b>
+              <ul><li>El formato del fichero tiene que ser .csv. Puedes descargar una plantilla.</li>
+              <li>La primera columna es obligatoria. Es el identificador único de cada participante y puede ser el DNI, un código generado aleatoriamente o cualquier otra forma de identificación que se quiera usar.</li>
+              <li>Las columnas 2,3 y 4 (Dato personal 2, 3, 4) son opcionales y no se utilizan para hacer el sorteo. Sirven para añadir los datos de contacto de cada participante.</li>
+              <li>Las columnas de los estratos son obligatorias y tienen que tener el mismo orden y nombre que el que hayamos configurado en el apartado anterior.</li>
+              <li>La información a incluir en las columnas tiene que coincidir con alguno de los Valores que hayamos indicado para cada estrato.</li>
+              <li>Si una participante no tiene datos en alguno de los estratos o no coincide con alguno de los valores configurados, será excluida del sorteo.</li></ul>"
+            help_submit: 'Al "Guardar" el sistema realizará la carga en segundo plano, puede tardar varios minutos dependiendo del volumen de participantes, por lo que al finalizar la carga será notificado vía email con el resultado.'
+        import_mailer:
+          subject: "Resultado de la importación de la muestra"
+          import:
+            ready: "La importación de la muestra ha finalizado correctamente."
+            total_rows: "Total de filas"
+            imported_rows: "Importadas correctamente"
+            failed_rows: "Filas con errores"
+            errors_summary: "Total de filas: %{total}. Importadas correctamente: %{imported}. Filas con errores: %{failed}."
+            see_details: "Los identificadores de los participantes los cuales han tenido error son:"
+            participant_id: "Identificador del participante:"
+        samples:
+          template:
+            personal_data_1: "Dato personal 1 (identificador único)"
+            personal_data_2: "Dato personal 2"
+            personal_data_3: "Dato personal 3"
+            personal_data_4: "Dato personal 4"
+          import_success: "La muestra se ha importado correctamente."
+          import_failed: "Ha ocurrido un error al importar la muestra: %{error}"
+          errors:
+            no_file: "No se ha seleccionado ningún archivo."
+            no_strata: "Debes configurar los estratos y subestratos antes de subir una muestra."
+            pending: "Solo puedes subir muestras cuando el sorteo estratificado está en estado pendiente."
+        sample_imports:
+          create:
+            success: "La muestra se está cargando en segundo plano. Cuando termine recibirás un correo con el resumen de la importación."
+          remove_uploaded_samples:
+            enqueued: "La eliminación de la muestra ha sido encolada y se procesará en segundo plano."
+            success: "Las muestras cargadas se han eliminado correctamente."
+            error: "Ha ocurrido un error al eliminar las muestras cargadas."
+      stratified_sortitions:
+        count:
+          candidates_count:
+            one: 1 candidato
+            other: "%{count} candidatos"
+        filters:
+          all: Todos
+          pending: Pendiente
+          executing: Ejecutando
+          executed: Ejecutado
+          failed: Fallido
+          state: Estado
+        index:
+          empty: Aún no hay sorteos estratificados.
+        orders:
+          label: 'Ordenar sorteos estratificados por:'
+          random: Aleatorio
+          recent: Reciente
+        results_count:
+          count:
+            one: Candidato a seleccionar
+            other: Candidatos a seleccionar
+          count_selected:
+            one: Candidato seleccionado
+            other: Candidatos seleccionados
+        show:
+          introduction: 'Esta página contiene los detalles del sorteo estratificado %{reference}. Mediante este sorteo, se han seleccionado %{num_candidates} candidatos utilizando un algoritmo de selección aleatoria estratificada que garantiza la representación justa en todos los estratos definidos.'
+          description: Descripción
+          selection_criteria: Criterios de elegibilidad
+          selected_profiles_description: Descripción de los perfiles seleccionados
+          to_be_selected_profiles_description: Descripción de los perfiles a seleccionar
+          strata: Estratos
+          max_quota: Cuota máxima
+          selected_participants: Participantes seleccionados
+          selected_participants_count:
+            one: Se ha seleccionado 1 participante
+            other: "Se han seleccionado %{count} participantes"
+          sortition_details: Detalles del sorteo
+          num_candidates: Número de candidatas a seleccionar
+          status: Estado
+          strata_count: Número de estratos
+          algorithm: Algoritmo
+          algorithm_name: LEXIMIN
+          algorithm_description: Algoritmo de selección aleatoria estratificada que garantiza la representación justa en todos los estratos definidos
+          reproducibility_details: Reproducibilidad del sorteo
+          verification_seed: Semilla de verificación
+          random_value_used: Valor aleatorio utilizado
+          selected_panel_index: Índice del panel seleccionado
+          selected_at: Seleccionado el
+          strata_charts: Distribución de los perfiles
+          target: Objetivo a conseguir
+          candidates: Candidaturas recibidas
+          no_data: Sin datos
+          results: Resultados del sorteo
+          statuses:
+            pending: Pendiente
+            executing: Ejecutando
+            executed: Ejecutado
+            failed: Fallido
+        stratified_sortition:
+          num_candidates: candidatos a seleccionar
+          strata_count: estratos
+        stratified_sortitions_count:
+          count:
+            one: 1 sorteo estratificado
+            other: "%{count} sorteos estratificados"
+      admin_log:
+        stratified_sortition:
+          create: "%{user_name} ha creado el sorteo estratificado %{resource_name} en %{space_name}"
+          update: "%{user_name} ha actualizado el sorteo estratificado %{resource_name} en %{space_name}"
+          delete: "%{user_name} ha eliminado el sorteo estratificado %{resource_name} en %{space_name}"
+          duplicate: "%{user_name} ha duplicado el sorteo estratificado %{resource_name}"
+          import_sample: "%{user_name} ha importado una muestra en el sorteo estratificado %{resource_name} en %{space_name}"
+          remove_samples: "%{user_name} ha eliminado los registros importados del sorteo estratificado %{resource_name} en %{space_name}"
+          execute: "%{user_name} ha ejecutado el sorteo estratificado %{resource_name} en %{space_name}"
+          export_results: "%{user_name} ha exportado los resultados del sorteo estratificado %{resource_name} en %{space_name}"
+          view_participants: "%{user_name} ha consultado el listado de participantes seleccionadas del sorteo estratificado %{resource_name} en %{space_name}"
+      errors:
+        panel_portfolio:
+          already_sampled: "La cartera ya ha sido muestreada"
+          probabilities_size_mismatch: "deben tener el mismo tamaño que los paneles (%{panels_count} paneles, %{probabilities_count} probabilidades)"
+          probabilities_sum_invalid: "deben sumar 1.0 (actualmente %{total})"
+        feasibility:
+          panel_size_positive: "El tamaño del panel (num_candidates) debe ser un número positivo"
+          no_categories: "No hay categorías (subestratos) definidas. Debe configurar los estratos y subestratos antes de ejecutar el algoritmo"
+          no_volunteers: "No hay voluntarios en el pool. Debe importar participantes antes de ejecutar el sorteo"
+          pool_too_small: "El pool de voluntarios (%{volunteers_count}) es más pequeño que el tamaño del panel (%{panel_size}). Agregue más participantes o reduzca el número de candidatos a seleccionar"
+          stratum_insufficient_quotas: "El estrato '%{stratum_name}' tiene cuotas máximas insuficientes. La suma de cuotas máximas (%{total_max}) es menor que el tamaño del panel (%{panel_size})"
+          stratum_percentages_exceed: "El estrato '%{stratum_name}' tiene porcentajes que suman más del 100%% (%{total_percentage}%%)"
+          substratum_insufficient_volunteers: "El subestrato '%{substratum_name}' del estrato '%{stratum_name}' requiere un mínimo de %{min_quota} voluntarios pero solo tiene %{volunteers_count}"
+          substratum_quota_exceeds_volunteers: "El subestrato '%{substratum_name}' del estrato '%{stratum_name}' tiene una cuota máxima de %{max_quota} (%{percentage}%%) pero solo %{volunteers_count} voluntario(s) pertenecen a esta categoría. Reduzca el porcentaje de cuota máxima o añada más participantes en esta categoría"
+          volunteers_missing_strata: "Hay %{count} voluntario(s) que no tienen asignado un subestrato para cada estrato. Esto puede causar problemas en el algoritmo de selección"
+          no_name: "Sin nombre"
+        fair_sortition:
+          already_performed: "El sorteo ya se ha realizado para este proceso"
+          portfolio_generation_failed: "Error generando la cartera de paneles: %{error}"
+          no_portfolio: "No hay cartera de paneles. Ejecute `generate_portfolio` primero"
+          sampling_failed: "Error en el muestreo: %{error}"
+        leximin:
+          no_feasible_panel: "No se pudo encontrar un panel inicial válido. La combinación de restricciones de cuota (porcentajes máximos) y la muestra disponible hacen imposible formar un panel. Posibles causas: (1) Los porcentajes de cuota máxima de algunos subestratos son demasiado restrictivos para el tamaño de la muestra disponible. (2) No hay suficientes participantes en ciertas combinaciones de subestratos. (3) El número de candidatos a seleccionar es demasiado grande en relación a la muestra. Intente ajustar los porcentajes de cuota máxima o cargue una muestra más grande."
+          internal_error: "Error interno en el algoritmo de selección: %{error}. Por favor, verifique que la configuración de los estratos y los porcentajes de cuota máxima son compatibles con la muestra cargada."

data/config/locales/oc.yml

@@ -0,0 +1,2 @@
+---
+oc:

data/config/routes.rb

@@ -0,0 +1 @@
+

data/db/migrate/20251023103900_create_decidim_stratified_sortitions_stratified_sortitions.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+class CreateDecidimStratifiedSortitionsStratifiedSortitions < ActiveRecord::Migration[5.2]
+  def change
+    create_table :decidim_stratified_sortitions_stratified_sortitions do |t|
+      t.jsonb :title
+      t.integer :num_candidates, null: false
+      t.jsonb :description
+      t.jsonb :selection_criteria
+      t.jsonb :selected_profiles_description
+      t.references :decidim_component, index: false, null: false
+
+      t.timestamps
+    end
+
+    add_index :decidim_stratified_sortitions_stratified_sortitions, :decidim_component_id, name: "index_decidim_stratified_sortitions_component_id"
+  end
+end

data/db/migrate/20251104120000_create_stratified_sortitions_strata_and_substrata.decidim_stratified_sortitions.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+class CreateDecidimStratifiedSortitionsStrataAndSubstrata < ActiveRecord::Migration[7.0]
+  def change
+    create_table :decidim_stratified_sortitions_strata do |t|
+      t.jsonb :name, null: false, default: "{}"
+      t.string :kind, null: false
+      t.integer :decidim_stratified_sortition_id, null: false
+
+      t.timestamps
+    end
+
+    add_index :decidim_stratified_sortitions_strata, :decidim_stratified_sortition_id, name: "index_strata_on_sortition_id"
+
+    create_table :decidim_stratified_sortitions_substrata do |t|
+      t.jsonb :name, null: false, default: "{}"
+      t.jsonb :value, null: false, default: "{}"
+      t.string :range
+      t.string :weighing
+      t.integer :decidim_stratified_sortitions_stratum_id, null: false
+
+      t.timestamps
+    end
+
+    add_index :decidim_stratified_sortitions_substrata, :decidim_stratified_sortitions_stratum_id, name: "index_substrata_on_stratum_id"
+  end
+end

data/db/migrate/20251219120000_create_sample_imports.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+class CreateSampleImports < ActiveRecord::Migration[7.0]
+  def change
+    create_table :decidim_stratified_sortitions_sample_imports do |t|
+      t.references :stratified_sortition, null: false, foreign_key: { to_table: :decidim_stratified_sortitions_stratified_sortitions },
+                                          index: { name: "idx_sample_imports_on_sortition_id" }
+      t.string :filename
+      t.integer :total_rows, default: 0
+      t.integer :imported_rows, default: 0
+      t.integer :failed_rows, default: 0
+      t.jsonb :import_errors, default: {}
+      t.string :status, default: "pending"
+      t.timestamps
+    end
+  end
+end

data/db/migrate/20251219120100_create_sample_participants.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+class CreateSampleParticipants < ActiveRecord::Migration[7.0]
+  def change
+    create_table :decidim_stratified_sortitions_sample_participants do |t|
+      t.references :decidim_stratified_sortition, null: false, foreign_key: { to_table: :decidim_stratified_sortitions_stratified_sortitions },
+                                                  index: { name: "idx_sample_part_on_sortition_id" }
+      t.references :decidim_stratified_sortitions_sample_import, foreign_key: { to_table: :decidim_stratified_sortitions_sample_imports },
+                                                                 index: { name: "idx_sample_part_on_sample_import_id" }
+      t.string :personal_data_1, null: false
+      t.string :personal_data_2
+      t.string :personal_data_3
+      t.string :personal_data_4
+      t.jsonb :column_values, default: []
+      t.string :reference_code
+      t.timestamps
+    end
+  end
+end

data/db/migrate/20251219120200_create_sample_participant_strata.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+class CreateSampleParticipantStrata < ActiveRecord::Migration[7.0]
+  def change
+    create_table :decidim_stratified_sortitions_sample_participant_strata do |t|
+      t.references :decidim_stratified_sortitions_sample_participant, null: false, foreign_key: true, index: { name: "idx_sample_part_strata_on_participants" }
+      t.references :decidim_stratified_sortitions_stratum, null: false, foreign_key: true, index: { name: "idx_sample_part_strata_on_strata" }
+      t.references :decidim_stratified_sortitions_substratum,
+                   null: true,
+                   foreign_key: { to_table: :decidim_stratified_sortitions_substrata },
+                   index: { name: "idx_sample_part_strata_on_substrata" }
+      t.string :raw_value
+      t.timestamps
+    end
+  end
+end

data/db/migrate/20251230130000_change_value_to_text_in_substrata.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+class ChangeValueToTextInSubstrata < ActiveRecord::Migration[7.0]
+  def up
+    change_column :decidim_stratified_sortitions_substrata, :value, :text
+  end
+
+  def down
+    change_column :decidim_stratified_sortitions_substrata, :value, :jsonb
+  end
+end

data/db/migrate/20260102114744_add_status_to_stratified_sortitions.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+class AddStatusToStratifiedSortitions < ActiveRecord::Migration[7.0]
+  def up
+    add_column :decidim_stratified_sortitions_stratified_sortitions, :status, :string, default: "pending"
+  end
+
+  def down
+    remove_column :decidim_stratified_sortitions_stratified_sortitions, :status
+  end
+end

data/db/migrate/20260109105643_allow_null_value_in_substrata.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+class AllowNullValueInSubstrata < ActiveRecord::Migration[7.0]
+  def change
+    change_table :decidim_stratified_sortitions_substrata, bulk: true do |t|
+      t.change_null :value, true
+      t.change_default :value, nil
+    end
+  end
+end

data/db/migrate/20260113121726_add_position_to_strata_and_substrata.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+class AddPositionToStrataAndSubstrata < ActiveRecord::Migration[7.0]
+  def change
+    add_column :decidim_stratified_sortitions_substrata, :position, :integer
+    add_column :decidim_stratified_sortitions_strata, :position, :integer
+  end
+end

data/db/migrate/20260127100000_rename_weighing_to_max_quota_percentage.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+# This migration renames the 'weighing' column to 'max_quota_percentage' for clarity.
+# The column stores the target percentage for each substratum category.
+# For the LEXIMIN algorithm:
+#   - min_quota is implicitly 0 (no minimum required for any category)
+#   - max_quota is calculated as: (max_quota_percentage / 100.0) * panel_size
+class RenameWeighingToMaxQuotaPercentage < ActiveRecord::Migration[7.0]
+  def change
+    rename_column :decidim_stratified_sortitions_substrata, :weighing, :max_quota_percentage
+  end
+end

data/db/migrate/20260127120000_create_panel_portfolios.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+# Migration to create the panel_portfolios table for storing
+# LEXIMIN-generated panels before sampling.
+#
+# This enables a two-phase sortition process:
+# 1. Generate portfolio (expensive, can be done in background)
+# 2. Sample from portfolio (fast, can be done publicly)
+class CreatePanelPortfolios < ActiveRecord::Migration[7.0]
+  def change
+    create_table :decidim_stratified_sortitions_panel_portfolios do |t|
+      t.references :decidim_stratified_sortitions_stratified_sortition,
+                   null: false,
+                   foreign_key: { to_table: :decidim_stratified_sortitions_stratified_sortitions },
+                   index: { name: "idx_panel_portfolios_on_sortition_id" }
+
+      # Panel data (JSON arrays)
+      # panels: [[id1, id2, ...], [id3, id4, ...], ...]
+      # probabilities: [0.3, 0.25, ...]
+      # selection_probabilities: { participant_id => probability, ... }
+      t.jsonb :panels, null: false, default: []
+      t.jsonb :probabilities, null: false, default: []
+      t.jsonb :selection_probabilities, null: false, default: {}
+
+      # Generation metadata
+      t.datetime :generated_at, null: false
+      t.float :generation_time_seconds
+      t.integer :num_iterations
+      t.boolean :convergence_achieved, null: false, default: false
+
+      # Sampling result (null until sampled)
+      t.integer :selected_panel_index
+      t.datetime :selected_at
+      t.string :verification_seed
+      t.float :random_value_used
+
+      t.timestamps
+    end
+
+    # Ensure only one portfolio per sortition
+    add_index :decidim_stratified_sortitions_panel_portfolios,
+              :decidim_stratified_sortitions_stratified_sortition_id,
+              unique: true,
+              name: "idx_panel_portfolios_unique_sortition"
+  end
+end

data/db/migrate/20260518000000_add_foreign_key_to_stratified_sortitions_component.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+class AddForeignKeyToStratifiedSortitionsComponent < ActiveRecord::Migration[5.2]
+  def change
+    add_foreign_key :decidim_stratified_sortitions_stratified_sortitions,
+                    :decidim_components,
+                    column: :decidim_component_id,
+                    on_delete: :cascade
+  end
+end

data/db/migrate/20260521000000_add_cascade_to_stratified_sortitions_foreign_keys.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+class AddCascadeToStratifiedSortitionsForeignKeys < ActiveRecord::Migration[7.0]
+  def change
+    add_foreign_key :decidim_stratified_sortitions_strata,
+                    :decidim_stratified_sortitions_stratified_sortitions,
+                    column: :decidim_stratified_sortition_id,
+                    on_delete: :cascade
+
+    add_foreign_key :decidim_stratified_sortitions_substrata,
+                    :decidim_stratified_sortitions_strata,
+                    column: :decidim_stratified_sortitions_stratum_id,
+                    on_delete: :cascade
+
+    remove_foreign_key :decidim_stratified_sortitions_sample_imports,
+                       column: :stratified_sortition_id
+    add_foreign_key :decidim_stratified_sortitions_sample_imports,
+                    :decidim_stratified_sortitions_stratified_sortitions,
+                    column: :stratified_sortition_id,
+                    on_delete: :cascade
+
+    remove_foreign_key :decidim_stratified_sortitions_sample_participants,
+                       column: :decidim_stratified_sortition_id
+    add_foreign_key :decidim_stratified_sortitions_sample_participants,
+                    :decidim_stratified_sortitions_stratified_sortitions,
+                    column: :decidim_stratified_sortition_id,
+                    on_delete: :cascade
+
+    remove_foreign_key :decidim_stratified_sortitions_sample_participants,
+                       column: :decidim_stratified_sortitions_sample_import_id
+    add_foreign_key :decidim_stratified_sortitions_sample_participants,
+                    :decidim_stratified_sortitions_sample_imports,
+                    column: :decidim_stratified_sortitions_sample_import_id,
+                    on_delete: :cascade
+
+    remove_foreign_key :decidim_stratified_sortitions_sample_participant_strata,
+                       column: :decidim_stratified_sortitions_sample_participant_id
+    add_foreign_key :decidim_stratified_sortitions_sample_participant_strata,
+                    :decidim_stratified_sortitions_sample_participants,
+                    column: :decidim_stratified_sortitions_sample_participant_id,
+                    on_delete: :cascade
+
+    remove_foreign_key :decidim_stratified_sortitions_sample_participant_strata,
+                       column: :decidim_stratified_sortitions_stratum_id
+    add_foreign_key :decidim_stratified_sortitions_sample_participant_strata,
+                    :decidim_stratified_sortitions_strata,
+                    column: :decidim_stratified_sortitions_stratum_id,
+                    on_delete: :cascade
+
+    remove_foreign_key :decidim_stratified_sortitions_sample_participant_strata,
+                       column: :decidim_stratified_sortitions_substratum_id
+    add_foreign_key :decidim_stratified_sortitions_sample_participant_strata,
+                    :decidim_stratified_sortitions_substrata,
+                    column: :decidim_stratified_sortitions_substratum_id,
+                    on_delete: :cascade
+
+    remove_foreign_key :decidim_stratified_sortitions_panel_portfolios,
+                       column: :decidim_stratified_sortitions_stratified_sortition_id
+    add_foreign_key :decidim_stratified_sortitions_panel_portfolios,
+                    :decidim_stratified_sortitions_stratified_sortitions,
+                    column: :decidim_stratified_sortitions_stratified_sortition_id,
+                    on_delete: :cascade
+  end
+end