Modeling real-world courses

const course = await hk.courses.create({
  title: "Introduction to Python",
  description: "An 8-week intro to programming",
  metadata: {
    moodle_format: "weeks",
    moodle_category: "Programming"
  },
  external_ids: { moodle: "course_1234" }
});

const week1 = await hk.units.create({
  course_id: course.id,
  title: "Week 1 — Syntax basics",
  position: 1,
  external_ids: { moodle: "section_1" }
});

await hk.lessons.create({
  unit_id: week1.id,
  type: "markdown",
  title: "Variables and types",
  content: "# Variables\n\nIn Python...",
  external_ids: { moodle: "course_module_45" }
});

const quiz = await hk.activities.create({
  unit_id: week1.id,
  type: "quiz",
  title: "End-of-week 1 quiz",
  external_ids: { moodle: "course_module_46" }
});

await hk.questions.create({
  activity_id: quiz.id,
  type: "multiple_choice",
  prompt: "What is the type of 3.14?",
  options: ["int", "float", "str"],
  correct_answer: 1
});

const af = await hk.courses.create({
  title: "Actividades de gestión administrativa",
  metadata: {
    codigo_sepe: "ADGD0308",
    familia_profesional: "Administración y gestión",
    nivel_qualificacion: "2",
    horas_totales: "880"
  }
});

// Módulo formativo (top-level unit)
const mf1 = await hk.units.create({
  course_id: af.id,
  title: "MF0233_2 — Ofimática",
  position: 1,
  metadata: {
    codigo_mf: "MF0233_2",
    horas: "190",
    transversal: true
  }
});

// Unidad formativa nested inside MF1
const uf1 = await hk.units.create({
  course_id: af.id,
  parent_unit_id: mf1.id,
  title: "UF0319 — Sistema operativo y búsqueda de información",
  position: 1,
  metadata: { codigo_uf: "UF0319", horas: "30" }
});

// Epígrafes = lessons
await hk.lessons.create({
  unit_id: uf1.id,
  type: "markdown",
  title: "1.1 Introducción al ordenador",
  content: "...",
  metadata: { epigrafe: "1.1" }
});

await hk.lessons.create({
  unit_id: uf1.id,
  type: "markdown",
  title: "1.2 Hardware básico",
  content: "...",
  metadata: { epigrafe: "1.2" }
});

// The May 2026 cohort being delivered to a specific group
const convocatoria = await hk.cohorts.create({
  course_id: af.id,
  title: "Convocatoria mayo 2026 — Madrid",
  starts_at: "2026-05-20",
  ends_at: "2026-11-20",
  metadata: {
    expediente_fundae: "F262345",
    modalidad: "teleformacion",
    centro: "Centro Madrid"
  }
});

await hk.enrollments.create({
  cohort_id: convocatoria.id,
  student_id: "usr_alice",
  role: "student"
});

const cs101 = await hk.courses.create({
  title: "Introduction to Computer Science",
  description: "Foundational CS using Python",
  metadata: {
    course_code: "CS 101",
    department: "Computer Science",
    credits: "4",
    catalog_level: "undergraduate-100"
  }
});

const week1 = await hk.units.create({
  course_id: cs101.id,
  title: "Week 1 — Computation and variables",
  position: 1,
  metadata: { week_number: "1" }
});

await hk.lessons.create({
  unit_id: week1.id,
  type: "video",
  title: "Lecture 1.1 — What is computation?",
  content: { video_url: "...", duration_seconds: 2700 }
});

await hk.lessons.create({
  unit_id: week1.id,
  type: "markdown",
  title: "Reading — Sipser Ch. 1.1",
  content: "..."
});

const pset1 = await hk.assignments.create({
  unit_id: week1.id,
  title: "Problem Set 1",
  points_possible: 100,
  due_offset_days: 7
});

// Two different runs of the same course, no content duplication
const fall2026 = await hk.cohorts.create({
  course_id: cs101.id,
  title: "CS 101 — Fall 2026, Section 001",
  starts_at: "2026-09-08",
  ends_at: "2026-12-18",
  metadata: {
    term: "Fall 2026",
    section_number: "001",
    crn: "12345",
    meeting_pattern: "MWF 10:00-10:50",
    room: "Stata 32-123"
  }
});

const spring2027 = await hk.cohorts.create({
  course_id: cs101.id,
  title: "CS 101 — Spring 2027, Section 001",
  starts_at: "2027-01-15",
  ends_at: "2027-05-20",
  metadata: { term: "Spring 2027", crn: "67890" }
});

// Per-cohort schedule override on the shared content
await hk.cohorts.scheduleAssignment({
  cohort_id: fall2026.id,
  assignment_id: pset1.id,
  due_date: "2026-09-22T23:59:00Z"
});

// LTI launch — if the university runs Canvas as the official LMS
await hk.cohorts.connectLTI({
  cohort_id: fall2026.id,
  platform_issuer: "https://canvas.school.edu",
  context_id: "canvas_course_99887"
});

// 1. The catalog of standalone courses
const python = await hk.courses.create({
  title: "Python from zero",
  description: "Fundamentals of Python programming"
});
const anthropic = await hk.courses.create({
  title: "Building with the Anthropic API",
  description: "Claude, tool use, agents"
});
const rag = await hk.courses.create({
  title: "Production-grade RAG",
  description: "Retrieval, embeddings, evals"
});

// 2. The bundle: a lightweight program referencing courses
const aiSpec = await hk.programs.create({
  title: "AI Specialization",
  description: "Master Python, LLM APIs and RAG in six months",
  course_ids: [python.id, anthropic.id, rag.id],
  metadata: {
    estimated_hours: "180",
    level: "intermediate",
    certificate: "true"
  }
});

// 3a. Cohort attached to the PROGRAM — the 2026 intake of the bundle
const intake2026 = await hk.cohorts.create({
  program_id: aiSpec.id,           // ← program_id, not course_id
  title: "AI Specialization — 2026 cohort",
  starts_at: "2026-01-15",
  ends_at: "2026-07-15",
  metadata: { capacity: "100" }
});

// 3b. Or cohort attached to a single course — for à-la-carte buyers
const pythonQ1 = await hk.cohorts.create({
  course_id: python.id,
  title: "Python — Q1 2026"
});

// 4. Pricing — Prices point at either a course or a program
await hk.prices.create({
  program_id: aiSpec.id,
  amount: 99900,
  currency: "EUR",
  type: "one_time"
});
await hk.prices.create({
  course_id: python.id,
  amount: 19900,
  currency: "EUR",
  type: "one_time"
});

// 5. Enrollments — same primitive, different cohort
await hk.enrollments.create({
  cohort_id: intake2026.id,        // bought the bundle
  student_id: "usr_alice"
});
await hk.enrollments.create({
  cohort_id: pythonQ1.id,          // bought Python only
  student_id: "usr_bob"
});

await hk.programs.create({
  // ...
  cohort_strategy: "subcohorts"   // default is "unified"
});

const capstone = await hk.courses.create({
  title: "AI Specialization — Capstone Project",
  description: "Final cross-disciplinary project",
  metadata: {
    capstone: "true",
    access_via: "program_only"     // your business layer enforces this
  }
});

await hk.programs.update(aiSpec.id, {
  course_ids: [python.id, anthropic.id, rag.id, capstone.id]
});