feat: update programs and courseOfferings schemas

Author: chenxin-yan

apps/web/src/modules/course-selection/components/CourseSectionItem.tsx

@@ -48,7 +48,7 @@ export const CourseSectionItem = ({
           {offering.days.map((day) => day.slice(0, 3).toUpperCase()).join(", ")}{" "}
           {offering.startTime} - {offering.endTime}
         </div>
-        <div>{offering.location}</div>
+        <div>{offering.location ?? "TBD"}</div>
         <div className="capitalize">
           {offering.term} {offering.year}
         </div>

packages/server/convex/http.ts

@@ -111,22 +111,25 @@ export const ZUpsertProgramWithRequirements = z.object({
     z.discriminatedUnion("type", [
       z.object({
         isMajor: z.boolean(),
+        description: z.optional(z.string()),
         type: z.literal("required"),
         courses: z.array(z.string()),
       }),
       z.object({
         isMajor: z.boolean(),
+        description: z.optional(z.string()),
         type: z.literal("alternative"),
         courses: z.array(z.string()),
       }),
       z.object({
         isMajor: z.boolean(),
+        description: z.optional(z.string()),
         type: z.literal("options"),
         courses: z.array(z.string()),
         courseLevels: z.array(
           z.object({
-            program: z.string(),
-            level: z.coerce.number(),
+            program: z.string(), // CSCI-UA
+            level: z.coerce.number(), // 4
           }),
         ),
         creditsRequired: z.number(),
@@ -143,6 +146,7 @@ export const ZUpsertRequirements = z.array(
         z.transform((val) => val as Id<"programs">),
       ),
       isMajor: z.boolean(),
+      description: z.optional(z.string()),
       type: z.literal("required"),
       courses: z.array(z.string()),
     }),
@@ -152,6 +156,7 @@ export const ZUpsertRequirements = z.array(
         z.transform((val) => val as Id<"programs">),
       ),
       isMajor: z.boolean(),
+      description: z.optional(z.string()),
       type: z.literal("alternative"),
       courses: z.array(z.string()),
     }),
@@ -161,6 +166,7 @@ export const ZUpsertRequirements = z.array(
         z.transform((val) => val as Id<"programs">),
       ),
       isMajor: z.boolean(),
+      description: z.optional(z.string()),
       type: z.literal("options"),
       courses: z.array(z.string()),
       courseLevels: z.array(
@@ -206,14 +212,17 @@ export const ZUpsertPrerequisites = z.array(
 
 export const ZUpsertCourseOfferings = z.array(
   z.object({
-    courseCode: z.string(),
-    classNumber: z.number(),
-    title: z.string(),
+    courseCode: z.string(), // CSCI-UA 102
+    classNumber: z.number(), // 10349
+    title: z.optional(z.string()),
     section: z.string(),
-    year: z.number(),
+    description: z.optional(z.string()),
+    year: z.number(), // 2025
     term: z.enum(["spring", "summer", "fall", "j-term"]),
+    level: z.enum(["undergraduate", "graduate"]),
+    school: ZSchoolName,
     instructor: z.array(z.string()),
-    location: z.string(),
+    location: z.optional(z.string()),
     days: z.array(
       z.enum([
         "monday",
@@ -225,8 +234,8 @@ export const ZUpsertCourseOfferings = z.array(
         "sunday",
       ]),
     ),
-    startTime: z.string(),
-    endTime: z.string(),
+    startTime: z.string(), // 13:00
+    endTime: z.string(), // 14:15
     status: z.enum(["open", "closed", "waitlist"]),
     waitlistNum: z.optional(z.number()),
     isCorequisite: z._default(z.boolean(), false),

packages/server/convex/requirements.ts

@@ -13,6 +13,7 @@ export const createRequirementsInternal = internalMutation({
           return ctx.db.insert("requirements", {
             programId: newReq.programId,
             isMajor: newReq.isMajor,
+            description: newReq.description,
             type: newReq.type,
             courses: newReq.courses,
             courseLevels: newReq.courseLevels,
@@ -22,6 +23,7 @@ export const createRequirementsInternal = internalMutation({
         return ctx.db.insert("requirements", {
           programId: newReq.programId,
           isMajor: newReq.isMajor,
+          description: newReq.description,
           type: newReq.type,
           courses: newReq.courses,
         });

packages/server/convex/schemas/courseOfferings.ts

@@ -1,17 +1,21 @@
 import { v } from "convex/values";
+import { schoolName } from "./schools";
 
 const courseOfferings = {
   courseCode: v.string(), // CSCI-UA 102
   classNumber: v.number(), // 10349
   title: v.optional(v.string()),
   section: v.string(), // 001
+  description: v.optional(v.string()),
   year: v.number(), // 2025
   term: v.union(
     v.literal("spring"),
     v.literal("summer"),
     v.literal("fall"),
     v.literal("j-term"),
   ),
+  level: v.union(v.literal("undergraduate"), v.literal("graduate")),
+  school: schoolName,
   instructor: v.array(v.string()),
   location: v.optional(v.string()),
   days: v.array(

packages/server/convex/schemas/programs.ts

@@ -12,18 +12,21 @@ const requirements = v.union(
   v.object({
     programId: v.id("programs"),
     isMajor: v.boolean(),
+    description: v.optional(v.string()),
     type: v.literal("required"),
     courses: v.array(v.string()), // course code
   }),
   v.object({
     programId: v.id("programs"),
     isMajor: v.boolean(),
+    description: v.optional(v.string()),
     type: v.literal("alternative"),
     courses: v.array(v.string()), // course code
   }),
   v.object({
     programId: v.id("programs"),
     isMajor: v.boolean(),
+    description: v.optional(v.string()),
     type: v.literal("options"),
     courses: v.array(v.string()), // course code
     courseLevels: v.array(

packages/server/convex/seed.ts

@@ -115,15 +115,18 @@ export const seedAll = internalMutation({
       v.object({
         courseCode: v.string(),
         classNumber: v.number(),
-        title: v.string(),
+        title: v.optional(v.string()),
         section: v.string(),
+        description: v.optional(v.string()),
         year: v.number(),
         term: v.union(
           v.literal("spring"),
           v.literal("summer"),
           v.literal("fall"),
           v.literal("j-term"),
         ),
+        level: v.union(v.literal("undergraduate"), v.literal("graduate")),
+        school: schoolName,
         instructor: v.array(v.string()),
         location: v.optional(v.string()),
         days: v.array(
@@ -174,18 +177,21 @@ export const seedAll = internalMutation({
         v.object({
           programName: v.string(),
           isMajor: v.boolean(),
+          description: v.optional(v.string()),
           type: v.literal("required"),
           courses: v.array(v.string()),
         }),
         v.object({
           programName: v.string(),
           isMajor: v.boolean(),
+          description: v.optional(v.string()),
           type: v.literal("alternative"),
           courses: v.array(v.string()),
         }),
         v.object({
           programName: v.string(),
           isMajor: v.boolean(),
+          description: v.optional(v.string()),
           type: v.literal("options"),
           courses: v.array(v.string()),
           courseLevels: v.array(
@@ -354,6 +360,7 @@ export const seedAll = internalMutation({
         await ctx.db.insert("requirements", {
           programId,
           isMajor: req.isMajor,
+          description: req.description,
           type: req.type,
           courses: req.courses,
           courseLevels: req.courseLevels,
@@ -363,6 +370,7 @@ export const seedAll = internalMutation({
         await ctx.db.insert("requirements", {
           programId,
           isMajor: req.isMajor,
+          description: req.description,
           type: req.type,
           courses: req.courses,
         });