Course ID schema migration + calendar assignment normalization

.github/workflows/claude-code-review.yml

@@ -33,6 +33,7 @@ jobs:
 
       - name: Run Claude Code Review
         id: claude-review
+        continue-on-error: true
         uses: anthropics/claude-code-action@v1
         with:
           claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}

.github/workflows/claude.yml

@@ -32,6 +32,7 @@ jobs:
 
       - name: Run Claude Code
         id: claude
+        continue-on-error: true
         uses: anthropics/claude-code-action@v1
         with:
           claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}

backend/db/supabase_schema.sql

@@ -1,24 +1,54 @@
 -- ============================================================
--- Sapling — Supabase Schema
+-- Sapling — Supabase Schema (course_id migration)
 -- Run this in: Supabase Dashboard → SQL Editor → New query
 -- ============================================================
 
 -- Users
 CREATE TABLE IF NOT EXISTS users (
-    id          TEXT PRIMARY KEY,
-    name        TEXT NOT NULL,
-    email       TEXT,
-    streak_count INTEGER DEFAULT 0,
+    id               TEXT PRIMARY KEY,
+    name             TEXT NOT NULL,
+    email            TEXT,
+    streak_count     INTEGER DEFAULT 0,
     last_active_date TEXT,
-    room_id     TEXT,
-    created_at  TIMESTAMPTZ DEFAULT now(),
-    google_id   TEXT UNIQUE,
-    avatar_url  TEXT,
-    auth_provider TEXT DEFAULT 'google'
+    room_id          TEXT,
+    created_at       TIMESTAMPTZ DEFAULT now(),
+    google_id        TEXT UNIQUE,
+    avatar_url       TEXT,
+    auth_provider    TEXT DEFAULT 'google'
 );
 
 CREATE INDEX IF NOT EXISTS idx_users_google_id ON users(google_id);
 
+-- Canonical course catalog (no user_id — shared across all students)
+CREATE TABLE IF NOT EXISTS courses (
+    id              TEXT PRIMARY KEY,
+    course_code     TEXT NOT NULL,
+    course_name     TEXT NOT NULL,
+    department      TEXT,
+    credits         INTEGER,
+    semester        TEXT DEFAULT 'Spring 2026',
+    instructor_name TEXT,
+    meeting_times   TEXT,
+    location        TEXT,
+    description     TEXT,
+    syllabus_url    TEXT,
+    school          TEXT,
+    created_at      TIMESTAMPTZ DEFAULT now()
+);
+
+-- Enrollment join table (user ↔ canonical course)
+CREATE TABLE IF NOT EXISTS user_courses (
+    id          TEXT PRIMARY KEY,
+    user_id     TEXT NOT NULL REFERENCES users(id),
+    course_id   TEXT NOT NULL REFERENCES courses(id),
+    color       TEXT,
+    nickname    TEXT,
+    enrolled_at TIMESTAMPTZ DEFAULT now(),
+    UNIQUE (user_id, course_id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_user_courses_user_id ON user_courses(user_id);
+
 -- Knowledge graph nodes
 CREATE TABLE IF NOT EXISTS graph_nodes (
     id              TEXT PRIMARY KEY,
@@ -29,10 +59,13 @@ CREATE TABLE IF NOT EXISTS graph_nodes (
     times_studied   INTEGER DEFAULT 0,
     last_studied_at TIMESTAMPTZ,
     subject         TEXT,
+    course_id       TEXT REFERENCES courses(id),
     created_at      TIMESTAMPTZ DEFAULT now(),
-    mastery_events  JSONB DEFAULT '[]'  -- array of {ts, delta, reason, event_type} — last 20 events
+    mastery_events  JSONB DEFAULT '[]'
 );
 
+CREATE INDEX IF NOT EXISTS idx_graph_nodes_user_course ON graph_nodes(user_id, course_id);
+
 -- Knowledge graph edges
 CREATE TABLE IF NOT EXISTS graph_edges (
     id                TEXT PRIMARY KEY,
@@ -41,42 +74,30 @@ CREATE TABLE IF NOT EXISTS graph_edges (
     target_node_id    TEXT NOT NULL REFERENCES graph_nodes(id),
     strength          DOUBLE PRECISION DEFAULT 0.5,
     created_at        TIMESTAMPTZ DEFAULT now(),
-    relationship_type TEXT DEFAULT 'related'  -- 'prerequisite' | 'builds_on' | 'related'
-);
-
--- Migrations (run these if the table already exists)
--- ALTER TABLE graph_nodes ADD COLUMN IF NOT EXISTS mastery_events JSONB DEFAULT '[]';
--- ALTER TABLE graph_edges ADD COLUMN IF NOT EXISTS relationship_type TEXT DEFAULT 'related';
-
--- Courses
-CREATE TABLE IF NOT EXISTS courses (
-    id          TEXT PRIMARY KEY,
-    user_id     TEXT NOT NULL REFERENCES users(id),
-    course_name TEXT NOT NULL,
-    color       TEXT,
-    created_at  TIMESTAMPTZ DEFAULT now(),
-    UNIQUE (user_id, course_name)
+    relationship_type TEXT DEFAULT 'related'
 );
 
 -- Learning sessions
 CREATE TABLE IF NOT EXISTS sessions (
-    id          TEXT PRIMARY KEY,
-    user_id     TEXT NOT NULL REFERENCES users(id),
-    mode        TEXT NOT NULL,
-    topic       TEXT NOT NULL,
-    started_at  TIMESTAMPTZ DEFAULT now(),
-    ended_at    TIMESTAMPTZ,
-    summary_json JSONB
+    id           TEXT PRIMARY KEY,
+    user_id      TEXT NOT NULL REFERENCES users(id),
+    mode         TEXT NOT NULL,
+    topic        TEXT NOT NULL,
+    course_id    TEXT REFERENCES courses(id),
+    started_at   TIMESTAMPTZ DEFAULT now(),
+    ended_at     TIMESTAMPTZ,
+    summary_json JSONB,
+    name         TEXT
 );
 
 -- Chat messages within a session
 CREATE TABLE IF NOT EXISTS messages (
-    id               TEXT PRIMARY KEY,
-    session_id       TEXT NOT NULL REFERENCES sessions(id),
-    role             TEXT NOT NULL,
-    content          TEXT NOT NULL,
+    id                TEXT PRIMARY KEY,
+    session_id        TEXT NOT NULL REFERENCES sessions(id),
+    role              TEXT NOT NULL,
+    content           TEXT NOT NULL,
     graph_update_json JSONB,
-    created_at       TIMESTAMPTZ DEFAULT now()
+    created_at        TIMESTAMPTZ DEFAULT now()
 );
 
 -- Quiz attempts
@@ -107,14 +128,72 @@ CREATE TABLE IF NOT EXISTS assignments (
     id              TEXT PRIMARY KEY,
     user_id         TEXT NOT NULL REFERENCES users(id),
     title           TEXT NOT NULL,
-    course_name     TEXT,
+    course_id       TEXT REFERENCES courses(id),
     due_date        TEXT NOT NULL,
     assignment_type TEXT,
     notes           TEXT,
     google_event_id TEXT,
     created_at      TIMESTAMPTZ DEFAULT now()
 );
 
+CREATE INDEX IF NOT EXISTS idx_assignments_user_due ON assignments(user_id, due_date);
+
+-- Documents (uploaded course materials)
+CREATE TABLE IF NOT EXISTS documents (
+    id           TEXT PRIMARY KEY,
+    user_id      TEXT NOT NULL REFERENCES users(id),
+    course_id    TEXT NOT NULL REFERENCES courses(id),
+    file_name    TEXT NOT NULL,
+    category     TEXT NOT NULL,
+    summary      TEXT,
+    key_takeaways JSONB,
+    flashcards   JSONB,
+    created_at   TIMESTAMPTZ DEFAULT now(),
+    processed_at TIMESTAMPTZ
+);
+
+-- Study guides
+CREATE TABLE IF NOT EXISTS study_guides (
+    id           TEXT PRIMARY KEY DEFAULT gen_random_uuid()::TEXT,
+    user_id      TEXT NOT NULL REFERENCES users(id),
+    course_id    TEXT NOT NULL REFERENCES courses(id),
+    exam_id      TEXT NOT NULL,
+    generated_at TIMESTAMPTZ DEFAULT now(),
+    content      JSONB NOT NULL
+);
+
+-- Per-concept aggregated course stats (across all enrolled students)
+CREATE TABLE IF NOT EXISTS course_concept_stats (
+    id                    TEXT PRIMARY KEY DEFAULT gen_random_uuid()::TEXT,
+    course_id             TEXT NOT NULL REFERENCES courses(id),
+    concept_name          TEXT NOT NULL,
+    semester              TEXT NOT NULL DEFAULT 'Spring 2026',
+    student_count         INTEGER DEFAULT 0,
+    avg_mastery_score     DOUBLE PRECISION DEFAULT 0.0,
+    pct_mastered          DOUBLE PRECISION DEFAULT 0.0,
+    pct_struggling        DOUBLE PRECISION DEFAULT 0.0,
+    pct_unexplored        DOUBLE PRECISION DEFAULT 0.0,
+    common_misconceptions TEXT[] DEFAULT '{}',
+    effective_explanations TEXT[] DEFAULT '{}',
+    prerequisite_gaps     TEXT[] DEFAULT '{}',
+    updated_at            TIMESTAMPTZ DEFAULT now(),
+    UNIQUE (course_id, concept_name, semester)
+);
+
+-- Course-wide summary (rolled up from course_concept_stats)
+CREATE TABLE IF NOT EXISTS course_summary (
+    course_id               TEXT NOT NULL REFERENCES courses(id),
+    semester                TEXT NOT NULL DEFAULT 'Spring 2026',
+    student_count           INTEGER DEFAULT 0,
+    avg_class_mastery       DOUBLE PRECISION DEFAULT 0.0,
+    top_struggling_concepts TEXT[] DEFAULT '{}',
+    top_mastered_concepts   TEXT[] DEFAULT '{}',
+    summary_text            TEXT,
+    summary_hash            TEXT,
+    updated_at              TIMESTAMPTZ DEFAULT now(),
+    PRIMARY KEY (course_id, semester)
+);
+
 -- Study rooms
 CREATE TABLE IF NOT EXISTS rooms (
     id          TEXT PRIMARY KEY,
@@ -169,21 +248,16 @@ CREATE INDEX IF NOT EXISTS idx_room_messages_room_id ON room_messages(room_id, c
 
 -- Emoji reactions on room messages
 CREATE TABLE IF NOT EXISTS room_reactions (
-    id          UUID PRIMARY KEY DEFAULT gen_random_uuid(),
-    message_id  UUID NOT NULL REFERENCES room_messages(id) ON DELETE CASCADE,
-    user_id     TEXT NOT NULL REFERENCES users(id),
-    emoji       TEXT NOT NULL,
-    created_at  TIMESTAMPTZ DEFAULT now(),
+    id         UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    message_id UUID NOT NULL REFERENCES room_messages(id) ON DELETE CASCADE,
+    user_id    TEXT NOT NULL REFERENCES users(id),
+    emoji      TEXT NOT NULL,
+    created_at TIMESTAMPTZ DEFAULT now(),
     UNIQUE(message_id, user_id, emoji)
 );
 
 CREATE INDEX IF NOT EXISTS idx_room_reactions_message_id ON room_reactions(message_id);
 
--- Migrations (run if tables already exist without these columns):
--- ALTER TABLE room_messages ADD COLUMN IF NOT EXISTS reply_to_id UUID REFERENCES room_messages(id);
--- ALTER TABLE room_messages ADD COLUMN IF NOT EXISTS is_deleted BOOLEAN NOT NULL DEFAULT FALSE;
--- ALTER TABLE room_messages ADD COLUMN IF NOT EXISTS edited_at TIMESTAMPTZ;
-
 -- Cached AI summaries for study rooms
 CREATE TABLE IF NOT EXISTS room_summaries (
     room_id     TEXT PRIMARY KEY REFERENCES rooms(id),
@@ -192,14 +266,7 @@ CREATE TABLE IF NOT EXISTS room_summaries (
     updated_at  TIMESTAMPTZ DEFAULT now()
 );
 
--- Shared course-level learning context (aggregated from all students, no Gemini)
-CREATE TABLE IF NOT EXISTS course_context (
-    course_name   TEXT PRIMARY KEY,
-    context_json  JSONB NOT NULL,
-    student_count INTEGER DEFAULT 0,
-    updated_at    TIMESTAMPTZ DEFAULT now()
-);
-
+-- Flashcards
 CREATE TABLE IF NOT EXISTS flashcards (
     id               TEXT PRIMARY KEY,
     user_id          TEXT NOT NULL REFERENCES users(id),
@@ -214,18 +281,38 @@ CREATE TABLE IF NOT EXISTS flashcards (
 
 CREATE INDEX IF NOT EXISTS idx_flashcards_user_topic ON flashcards(user_id, topic);
 
-CREATE TABLE public.flashcards (
-  id text NOT NULL,
-  user_id text NOT NULL,
-  topic text NOT NULL,
-  front text NOT NULL,
-  back text NOT NULL,
-  times_reviewed integer DEFAULT 0,
-  last_rating integer,
-  last_reviewed_at timestamp with time zone,
-  created_at timestamp with time zone DEFAULT now(),
-  CONSTRAINT flashcards_pkey PRIMARY KEY (id),
-  CONSTRAINT flashcards_user_id_fkey FOREIGN KEY (user_id) REFERENCES public.users(id)
-);
-
-CREATE INDEX IF NOT EXISTS idx_flashcards_user_topic ON public.flashcards(user_id, topic);
+-- Feedback
+CREATE TABLE IF NOT EXISTS feedback (
+    id               SERIAL PRIMARY KEY,
+    user_id          TEXT NOT NULL,
+    type             TEXT NOT NULL,
+    rating           INTEGER NOT NULL,
+    selected_options JSONB DEFAULT '[]',
+    comment          TEXT,
+    session_id       TEXT,
+    topic            TEXT,
+    created_at       TIMESTAMPTZ DEFAULT now()
+);
+
+-- Issue reports
+CREATE TABLE IF NOT EXISTS issue_reports (
+    id               SERIAL PRIMARY KEY,
+    user_id          TEXT NOT NULL,
+    topic            TEXT NOT NULL,
+    description      TEXT NOT NULL,
+    screenshot_urls  JSONB DEFAULT '[]',
+    created_at       TIMESTAMPTZ DEFAULT now()
+);
+
+-- Job applications
+CREATE TABLE IF NOT EXISTS job_applications (
+    id             UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    position       TEXT NOT NULL,
+    full_name      TEXT NOT NULL,
+    email          TEXT NOT NULL,
+    phone          TEXT,
+    linkedin_url   TEXT NOT NULL,
+    resume         TEXT,
+    portfolio_link TEXT,
+    submitted_at   TIMESTAMPTZ DEFAULT now()
+);

backend/main.py

@@ -7,8 +7,11 @@
 
 from config import FRONTEND_URL, PORT
 from routes import graph, learn, quiz, calendar, social, extract, auth, documents, flashcards, study_guide, feedback, careers
-from recost.frameworks.fastapi import RecostMiddleware
 
+try:
+    from recost.frameworks.fastapi import RecostMiddleware
+except ImportError:
+    RecostMiddleware = None  # optional; tests/CI without recost package
 
 load_dotenv(Path(__file__).with_name(".env"))
 
@@ -17,7 +20,7 @@
 
 app = FastAPI(title="Sapling API", version="1.0.0")
 
-if recost_api_key:
+if recost_api_key and RecostMiddleware is not None:
     app.add_middleware(
         RecostMiddleware,
         api_key=recost_api_key,