@studious-lms/server 1.23.0 → 1.25.0

package/.env.example

@@ -21,7 +21,6 @@ PORT=3001
 NODE_ENV=development
 
 # Admin panel (tRPC `admin.*`): comma/whitespace-separated user UUIDs. Required in production; optional in dev (empty = any signed-in user can call admin).
-ADMIN_PANEL_USER_IDS=""
 
 # Logging Configuration
 # Options: debug, info, warn, error

package/data/curriculum/nepal-cdc-g4-g5/README.md

@@ -0,0 +1,90 @@
+# Nepal CDC G4–5 Curriculum Pack (Phase A)
+
+Curriculum Development Centre (CDC) **Student Evaluation Guidelines 2083** for Grades 4–5 — 100% formative assessment with per-subject, per-unit learning-outcome forms rated **1–4** (Below Basic / Basic / Proficient / Advanced).
+
+## Source
+
+- Document: आधारभूत तह कक्षा ४–५ मा विद्यार्थी मूल्याङ्कन मार्गदर्शन, २०८३
+- CDC guidelines index: https://moecdc.gov.np/category/guidelines/
+- PDF: see `manifest.json` → `source.url`
+
+## Layout
+
+| Path | Purpose |
+| --- | --- |
+| `manifest.json` | Pack metadata, mapping notes, stats |
+| `proficiency-scale.json` | Shared 1–4 levels + `GradingBoundary` payload |
+| `subjects/*.json` | Per-subject unit forms → MarkScheme templates |
+
+## Mapping onto Studious
+
+| CDC concept | Studious object |
+| --- | --- |
+| Unit / content-area learning-outcome form | Department `MarkScheme` (`departmentId` set, `classId` null) |
+| Learning outcome indicator | `structured.criteria[]` (each with the same 1–4 `levels`) |
+| Proficiency labels 1–4 | Criterion levels **and** a department `GradingBoundary` (percentage bands for CDC formula) |
+| Grade / subject metadata | Tags: `Grade 4`, `Grade 5`, subject key, `CDC-2083`, `formative` |
+
+Frontend presets `GradingBoundaryTemplates.nepal` (NEB letter grades) and `RubricTemplates.neb_assessment` are **not** this pack — they are NEB-style helpers.
+
+### CDC percentage formula
+
+```
+achievement % = (sum of outcome ratings) / (4 × number of outcomes) × 100
+```
+
+Boundary bands (equal quartiles of that percentage):
+
+| Label | min% | max% |
+| --- | --- | --- |
+| Advanced | 75 | 100 |
+| Proficient | 50 | 74 |
+| Basic | 25 | 49 |
+| Below Basic | 0 | 24 |
+
+## Import
+
+```bash
+# Dry run
+npm run curriculum:import-nepal-cdc -- --departmentId=<uuid> --dry-run
+
+# Import all G4+G5 subjects into a department template library
+npm run curriculum:import-nepal-cdc -- --departmentId=<uuid>
+
+# Filter
+npm run curriculum:import-nepal-cdc -- --departmentId=<uuid> --grades=4 --subjects=english,mathematics
+```
+
+After import, templates appear under **School Admin → Departments → Templates**. Teachers apply them to a class via the institution panel (`department.applyRubricTemplate` / `applyBoundaryTemplate`).
+
+There is no bulk admin UI for this pack; the script is the Phase A import path.
+
+## Filling TODO placeholders
+
+Many Nepali-script outcome texts could not be reliably OCR’d. In subject JSON files:
+
+1. Find criteria whose `description` or `title` starts with `TODO:`.
+2. Replace with the official indicator text from the matching Annex 3 form in the PDF.
+3. Set `meta.transcriptionStatus` (and the unit’s `transcriptionStatus`) to `"verified"`.
+4. Re-run the import with `--force` **or** edit the department template in the admin UI.
+
+### Transcription status values
+
+| Status | Meaning |
+| --- | --- |
+| `from-pdf-english` | Extracted from English annex text |
+| `ocr-corrected` | Recovered from noisy Devanagari OCR + English gloss |
+| `partial` | Some outcomes filled, some TODO |
+| `scaffold` / `scaffold-titles` | Titles present; outcome text still TODO |
+| `todo` | Per-criterion placeholder |
+| `verified` | Spot-checked by a Nepali speaker (target state) |
+
+## Out of scope (Phase A)
+
+- Phase B mastery / longitudinal tracking grid
+- Annex 4 annual transcript (tracked separately as A4)
+- Mother-tongue / local subject national forms (school-defined per CDC)
+
+## Spot-check flag
+
+**A Nepali speaker should spot-check all Devanagari titles and OCR-corrected outcome text against the official PDF before production use.**

package/data/curriculum/nepal-cdc-g4-g5/manifest.json

@@ -0,0 +1,97 @@
+{
+  "id": "nepal-cdc-g4-g5-2083",
+  "name": "Nepal CDC Grades 4–5 Student Evaluation Guidelines 2083",
+  "nameNe": "आधारभूत तह कक्षा ४–५ मा विद्यार्थी मूल्याङ्कन मार्गदर्शन, २०८३",
+  "version": "0.1.0-phase-a",
+  "phase": "A",
+  "assessmentModel": "100% formative / continuous classroom-based assessment",
+  "ratingScale": "1–4 (Below Basic / Basic / Proficient / Advanced)",
+  "source": {
+    "publisher": "Curriculum Development Centre (CDC), Sanothimi, Bhaktapur",
+    "document": "Student Evaluation Guidelines for Basic Level Grades 4–5, 2083 B.S.",
+    "url": "https://giwmscdnone.gov.np/media/pdf_upload/%E0%A4%B5%E0%A4%BF%E0%A4%A6%E0%A5%8D%E0%A4%AF%E0%A4%BE%E0%A4%B0%E0%A5%8D%E0%A4%A5%E0%A5%80%20%E0%A4%AE%E0%A5%82%E0%A4%B2%E0%A5%8D%E0%A4%AF%E0%A4%BE%E0%A4%99%E0%A5%8D%E0%A4%95%E0%A4%A8%20%E0%A4%AE%E0%A4%BE%E0%A4%B0%E0%A5%8D%E0%A4%97%E0%A4%A6%E0%A4%B0%E0%A5%8D%E0%A4%B6%E0%A4%A8%20%E0%A5%A8%E0%A5%A6%E0%A5%AE%E0%A5%A9_eorih3h.pdf",
+    "cdcPage": "https://moecdc.gov.np/category/guidelines/"
+  },
+  "mapping": {
+    "unitForm": "MarkScheme department template (classId null, departmentId set); each learning outcome → criteria[] with shared 1–4 levels",
+    "proficiencyScale": "GradingBoundary department template; percentage bands for CDC (sum ratings)/(4N)×100",
+    "tags": "Grade 4 | Grade 5 | subject key | CDC-2083 | formative via Tag attach to RUBRIC/BOUNDARY",
+    "frontendPresets": "studious GradingBoundaryTemplates.nepal (NEB letter) and RubricTemplates.neb_assessment are separate NEB presets, not CDC 1–4"
+  },
+  "outOfScope": [
+    "Phase B mastery tracking grid",
+    "Annex-4 annual transcript (A4)",
+    "Mother-tongue/local subject national forms"
+  ],
+  "spotCheckRequired": true,
+  "spotCheckNote": "Nepali-script titles and many outcome texts were OCR-corrected or left as TODO. A Nepali speaker must spot-check against the official PDF before production use.",
+  "subjects": [
+    {
+      "key": "nepali",
+      "nameEn": "Nepali",
+      "nameNe": "नेपाली",
+      "annex": "3 (क)",
+      "unitCount": 30,
+      "file": "subjects/nepali.json"
+    },
+    {
+      "key": "english",
+      "nameEn": "English",
+      "nameNe": "अङ्ग्रेजी",
+      "annex": "3 (ख)",
+      "unitCount": 33,
+      "file": "subjects/english.json"
+    },
+    {
+      "key": "mathematics",
+      "nameEn": "Mathematics",
+      "nameNe": "गणित",
+      "annex": "3 (ग)",
+      "unitCount": 9,
+      "file": "subjects/mathematics.json"
+    },
+    {
+      "key": "social-studies",
+      "nameEn": "Social Studies and Human Value Education",
+      "nameNe": "सामाजिक अध्ययन तथा मानव मूल्य शिक्षा",
+      "annex": "3 (घ)",
+      "unitCount": 14,
+      "file": "subjects/social-studies.json"
+    },
+    {
+      "key": "science-technology",
+      "nameEn": "Science and Technology",
+      "nameNe": "विज्ञान तथा प्रविधि",
+      "annex": "3 (ङ)",
+      "unitCount": 16,
+      "file": "subjects/science-technology.json"
+    },
+    {
+      "key": "health-physical-creative-arts",
+      "nameEn": "Health, Physical and Creative Arts",
+      "nameNe": "स्वास्थ्य, शारीरिक तथा सिर्जनात्मक कला",
+      "annex": "3 (च)",
+      "unitCount": 26,
+      "file": "subjects/health-physical-creative-arts.json"
+    },
+    {
+      "key": "mother-tongue-local",
+      "nameEn": "Mother Tongue / Local Subject",
+      "nameNe": "मातृभाषा / स्थानीय विषय",
+      "annex": "school-defined",
+      "note": "CDC states tools for mother-tongue/local subject are prepared locally; no fixed national unit forms in this pack.",
+      "units": []
+    }
+  ],
+  "files": {
+    "proficiencyScale": "proficiency-scale.json",
+    "subjectsDir": "subjects/"
+  },
+  "stats": {
+    "unitForms": 128,
+    "fromPdfEnglish": 33,
+    "ocrCorrected": 13,
+    "partial": 1,
+    "scaffold": 81
+  }
+}

package/data/curriculum/nepal-cdc-g4-g5/proficiency-scale.json

@@ -0,0 +1,76 @@
+{
+  "id": "cdc-g4-g5-proficiency-1-4",
+  "levels": [
+    {
+      "id": "advanced",
+      "name": "Advanced",
+      "nameNe": "उच्च",
+      "points": 4,
+      "color": "#059669",
+      "description": "Learning outcome fully achieved (सिकाइ उपलब्धि पूर्ण रूपमा हासिल गरेको)"
+    },
+    {
+      "id": "proficient",
+      "name": "Proficient",
+      "nameNe": "दक्ष",
+      "points": 3,
+      "color": "#2563eb",
+      "description": "Learning outcome mostly achieved (सिकाइ उपलब्धि धेरैजसो हासिल गरेको)"
+    },
+    {
+      "id": "basic",
+      "name": "Basic",
+      "nameNe": "आधारभूत",
+      "points": 2,
+      "color": "#ca8a04",
+      "description": "Learning outcome partially achieved; remedial learning needed"
+    },
+    {
+      "id": "below-basic",
+      "name": "Below Basic",
+      "nameNe": "आधारभूतभन्दा कम",
+      "points": 1,
+      "color": "#dc2626",
+      "description": "Learning outcome not achieved; remedial learning needed"
+    }
+  ],
+  "gradingBoundary": {
+    "name": "Nepal CDC G4-5 Proficiency Scale (1-4)",
+    "description": "CDC Student Evaluation Guidelines 2083 formative proficiency scale. Percentage bands assume CDC formula: (sum of 1-4 ratings) / (4 × outcomes) × 100.",
+    "source": "CDC Student Evaluation Guidelines 2083, Table 2",
+    "boundaries": [
+      {
+        "id": "advanced",
+        "grade": "Advanced",
+        "minPercentage": 75,
+        "maxPercentage": 100,
+        "color": "#059669",
+        "description": "Avg rating ≈ 3–4 (उच्च / Advanced)"
+      },
+      {
+        "id": "proficient",
+        "grade": "Proficient",
+        "minPercentage": 50,
+        "maxPercentage": 74,
+        "color": "#2563eb",
+        "description": "Avg rating ≈ 2–3 (दक्ष / Proficient)"
+      },
+      {
+        "id": "basic",
+        "grade": "Basic",
+        "minPercentage": 25,
+        "maxPercentage": 49,
+        "color": "#ca8a04",
+        "description": "Avg rating ≈ 1–2 (आधारभूत / Basic)"
+      },
+      {
+        "id": "below-basic",
+        "grade": "Below Basic",
+        "minPercentage": 0,
+        "maxPercentage": 24,
+        "color": "#dc2626",
+        "description": "Avg rating ≈ 1 (आधारभूतभन्दा कम / Below Basic)"
+      }
+    ]
+  }
+}