feat: Implement SAM structure mirroring in PostgreSQL for study plans and courses

- Added functionality to save study plans and courses in SAM format to PostgreSQL.
- Updated SQL queries to reflect SAM-native column names and handle conflicts appropriately.
- Introduced new fields in the Asset model for English level and SAM identifiers.
- Enhanced the TestTemplateForm component to manage linked assets and shared materials.
- Created a new AdminSharedMaterialsPage for uploading ZIP files of shared materials.
- Added migrations to create SAM mirror tables and update the assets table with new columns.

services/cms-service/migrations/20260406203000_add_assets_english_level.sql

@@ -0,0 +1,5 @@
+ALTER TABLE assets
+ADD COLUMN IF NOT EXISTS english_level TEXT;
+
+CREATE INDEX IF NOT EXISTS idx_assets_org_english_level
+ON assets (organization_id, english_level);

services/cms-service/migrations/20260406212000_add_assets_sam_structure.sql

@@ -0,0 +1,6 @@
+ALTER TABLE assets
+ADD COLUMN IF NOT EXISTS sam_plan_id INTEGER,
+ADD COLUMN IF NOT EXISTS sam_course_id INTEGER;
+
+CREATE INDEX IF NOT EXISTS idx_assets_org_sam_plan_course
+ON assets (organization_id, sam_plan_id, sam_course_id);

services/cms-service/migrations/20260406214000_create_sam_mirror_tables.sql

@@ -0,0 +1,73 @@
+CREATE TABLE IF NOT EXISTS sam_study_plans (
+    id BIGSERIAL PRIMARY KEY,
+    organization_id UUID NOT NULL REFERENCES organizations(id) ON DELETE CASCADE,
+    idPlanDeEstudios INTEGER NOT NULL,
+    Nombre TEXT NOT NULL,
+    Activo BOOLEAN NOT NULL DEFAULT TRUE,
+    created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+    updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+    UNIQUE (organization_id, idPlanDeEstudios)
+);
+
+CREATE INDEX IF NOT EXISTS idx_sam_study_plans_org_activo
+ON sam_study_plans (organization_id, Activo);
+
+CREATE TABLE IF NOT EXISTS sam_courses (
+    id BIGSERIAL PRIMARY KEY,
+    organization_id UUID NOT NULL REFERENCES organizations(id) ON DELETE CASCADE,
+    idCursos INTEGER NOT NULL,
+    idPlanDeEstudios INTEGER NOT NULL,
+    NombreCurso TEXT NOT NULL,
+    NivelCurso INTEGER,
+    Duracion DOUBLE PRECISION,
+    Activo BOOLEAN NOT NULL DEFAULT TRUE,
+    created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+    updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+    UNIQUE (organization_id, idCursos),
+    FOREIGN KEY (organization_id, idPlanDeEstudios)
+        REFERENCES sam_study_plans (organization_id, idPlanDeEstudios)
+        ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_sam_courses_org_plan
+ON sam_courses (organization_id, idPlanDeEstudios, Activo);
+
+-- Backfill from existing metadata tables when available.
+INSERT INTO sam_study_plans (organization_id, idPlanDeEstudios, Nombre, Activo)
+SELECT
+    organization_id,
+    mysql_id,
+    name,
+    COALESCE(is_active, TRUE)
+FROM mysql_study_plans
+ON CONFLICT (organization_id, idPlanDeEstudios) DO UPDATE SET
+    Nombre = EXCLUDED.Nombre,
+    Activo = EXCLUDED.Activo,
+    updated_at = NOW();
+
+INSERT INTO sam_courses (
+    organization_id,
+    idCursos,
+    idPlanDeEstudios,
+    NombreCurso,
+    NivelCurso,
+    Duracion,
+    Activo
+)
+SELECT
+    mc.organization_id,
+    mc.mysql_id,
+    msp.mysql_id,
+    mc.name,
+    mc.level,
+    mc.duracion,
+    COALESCE(mc.is_active, TRUE)
+FROM mysql_courses mc
+JOIN mysql_study_plans msp ON msp.id = mc.study_plan_id
+ON CONFLICT (organization_id, idCursos) DO UPDATE SET
+    idPlanDeEstudios = EXCLUDED.idPlanDeEstudios,
+    NombreCurso = EXCLUDED.NombreCurso,
+    NivelCurso = EXCLUDED.NivelCurso,
+    Duracion = EXCLUDED.Duracion,
+    Activo = EXCLUDED.Activo,
+    updated_at = NOW();