Merge pull request #391 from DataScience-GT/fix/restore-bootcamp-curriculum

Restore the twelve-week bootcamp syllabus, and pin its shape

Author: aamoghS

docs/operations/testing.md

@@ -43,7 +43,7 @@ Tests use `src/test/create-mock-context.ts` and `.internal-tests/_db-tx-mock.ts`
 
 ## Mainweb
 
-`sites/mainweb/lib/*.test.ts` — phone formatting, hackathon slugs, `safe-callback`.
+`sites/mainweb/lib/*.test.ts` — phone formatting, hackathon slugs, `safe-callback`, and the hand-edited syllabus constant (`bootcamp-schedule.test.ts` — unique, gapless week numbers and https notebook links).
 
 ## Hacklytics
 

sites/mainweb/lib/bootcamp-schedule.test.ts

@@ -0,0 +1,80 @@
+import { describe, it, expect } from "vitest";
+import {
+  BOOTCAMP_CURRICULUM,
+  BOOTCAMP_MEETING_TIME,
+  BOOTCAMP_ROOM,
+  BOOTCAMP_WORKSPACE_URL,
+  weekEntry,
+} from "./bootcamp-schedule";
+
+// A hand-edited constant published on a public page. Most of this is vacuous
+// while it is empty — these arm themselves the moment the real weeks are typed
+// in, which is the one moment nobody runs a test on purpose.
+
+describe("BOOTCAMP_CURRICULUM", () => {
+  it("numbers each week once", () => {
+    const weeks = BOOTCAMP_CURRICULUM.map((entry) => entry.week);
+    // A duplicate wins the `find` in weekEntry and drops the other week.
+    expect(new Set(weeks).size).toBe(weeks.length);
+  });
+
+  it("counts up", () => {
+    const weeks = BOOTCAMP_CURRICULUM.map((entry) => entry.week);
+    expect(weeks).toEqual([...weeks].sort((a, b) => a - b));
+  });
+
+  it("starts at week 1 and leaves no gap", () => {
+    // Sessions reference weeks by number; a gap renders with no title.
+    BOOTCAMP_CURRICULUM.forEach((entry, index) => {
+      expect(entry.week).toBe(index + 1);
+    });
+  });
+
+  it("gives every week something to render", () => {
+    for (const entry of BOOTCAMP_CURRICULUM) {
+      expect(entry.title.trim()).not.toBe("");
+      expect(entry.desc.trim()).not.toBe("");
+    }
+  });
+
+  it("links notebooks over https, or not at all", () => {
+    for (const entry of BOOTCAMP_CURRICULUM) {
+      if (entry.deepnoteUrl === undefined) continue;
+      expect(entry.deepnoteUrl).toMatch(/^https:\/\//);
+    }
+  });
+});
+
+describe("the unset values", () => {
+  it("are null rather than an empty string", () => {
+    // Surfaces test for null; "" slips through as a blank room and a dead button.
+    for (const value of [
+      BOOTCAMP_ROOM,
+      BOOTCAMP_MEETING_TIME,
+      BOOTCAMP_WORKSPACE_URL,
+    ]) {
+      expect(value === null || value.trim() !== "").toBe(true);
+    }
+  });
+
+  it("points the workspace button at https once it is set", () => {
+    if (BOOTCAMP_WORKSPACE_URL === null) return;
+    expect(BOOTCAMP_WORKSPACE_URL).toMatch(/^https:\/\//);
+  });
+});
+
+describe("weekEntry", () => {
+  it("finds nothing for an event with no week on it", () => {
+    expect(weekEntry(null)).toBeUndefined();
+  });
+
+  it("finds nothing for a week the syllabus does not describe", () => {
+    expect(weekEntry(999)).toBeUndefined();
+  });
+
+  it("finds each week it does describe", () => {
+    for (const entry of BOOTCAMP_CURRICULUM) {
+      expect(weekEntry(entry.week)).toBe(entry);
+    }
+  });
+});

sites/mainweb/lib/bootcamp-schedule.ts

@@ -29,11 +29,69 @@ export const BOOTCAMP_START_DATE: string | null = "September 22, 2026";
 /** The Deepnote workspace every session works out of. */
 export const BOOTCAMP_WORKSPACE_URL: string | null = null;
 
-// Empty until the real syllabus is written. The twelve weeks that used to sit
-// here were placeholder copy, and a made-up curriculum on a public page is
-// worse than saying it is coming. Every surface renders "updating soon" while
-// this is empty.
-export const BOOTCAMP_CURRICULUM: BootcampWeek[] = [];
+// Restored from f515a3d9. Confirm the titles before the term starts.
+export const BOOTCAMP_CURRICULUM: BootcampWeek[] = [
+  {
+    week: 1,
+    title: "Python Basics & Setup",
+    desc: "Variables, data types, and environment configuration.",
+  },
+  {
+    week: 2,
+    title: "Control Flow & Structures",
+    desc: "Loops, conditionals, lists, and dictionaries.",
+  },
+  {
+    week: 3,
+    title: "Functions & Modules",
+    desc: "Writing reusable code and organizing projects.",
+  },
+  {
+    week: 4,
+    title: "Object-Oriented Programming",
+    desc: "Classes, inheritance, and Pythonic design.",
+  },
+  {
+    week: 5,
+    title: "File Handling & APIs",
+    desc: "Reading files, writing data, and making web requests.",
+  },
+  {
+    week: 6,
+    title: "Pandas & NumPy",
+    desc: "Introduction to fast numerical computing and DataFrames.",
+  },
+  {
+    week: 7,
+    title: "Data Cleaning",
+    desc: "Handling missing values, merging, and data transformations.",
+  },
+  {
+    week: 8,
+    title: "Exploratory Data Analysis",
+    desc: "Extracting insights and statistical summaries from data.",
+  },
+  {
+    week: 9,
+    title: "Data Visualization",
+    desc: "Creating stunning charts using Matplotlib and Seaborn.",
+  },
+  {
+    week: 10,
+    title: "Intro to Machine Learning",
+    desc: "Core concepts, train/test splits, and Scikit-Learn.",
+  },
+  {
+    week: 11,
+    title: "Supervised Learning",
+    desc: "Linear regression, logistic regression, and decision trees.",
+  },
+  {
+    week: 12,
+    title: "Capstone Project",
+    desc: "Build an end-to-end data science portfolio piece.",
+  },
+];
 
 /** The curriculum entry a session's week number refers to, if there is one. */
 export const weekEntry = (week: number | null) =>