Initial commit for Hugging Face Space

Dockerfile

@@ -0,0 +1,10 @@
+FROM python:3.11-slim
+WORKDIR /app
+ENV PYTHONDONTWRITEBYTECODE=1 PYTHONUNBUFFERED=1
+RUN pip install --no-cache-dir flask==3.0.0 jinja2==3.1.3 itsdangerous==2.2.0 click==8.1.7
+# copy common utilities from project root (build context is project root)
+COPY ./common /app/common
+# copy only the minerva-lite service files into /app
+COPY ./minerva-lite /app
+EXPOSE 8000
+CMD ["python", "app.py"]

app.py

@@ -0,0 +1,280 @@
+from flask import Flask, render_template, request, jsonify, redirect, url_for, session
+import sqlite3, pathlib
+from functools import wraps
+
+
+APP = Flask(__name__)
+APP.secret_key = "dev-minerva-lite"  # session for term selection
+ROOT = pathlib.Path(__file__).parent
+DB_PATH = ROOT / "db" / "minerva.sqlite3"
+
+STEP_DESTINATIONS = {
+    "home": {"endpoint": "registration_menu", "label": "Registration Menu"},
+    "search": {"endpoint": "search", "label": "Search Class Schedule"},
+    "add_drop": {"endpoint": "add_drop", "label": "Add or Drop Course Sections"},
+    "schedule": {"endpoint": "schedule", "label": "Student Schedule"},
+    "schedule_week": {"endpoint": "schedule_week", "label": "Weekly Schedule View"},
+    "accounts": {"endpoint": "accounts", "label": "Tuition Fee and Legal Status"},
+}
+
+STEP_KEYS_BY_ENDPOINT = {
+    "registration_menu": "home",
+    "search": "search",
+    "add_drop": "add_drop",
+    "schedule": "schedule",
+    "schedule_week": "schedule_week",
+    "accounts": "accounts",
+}
+
+
+def require_term(step_key):
+    def decorator(func):
+        @wraps(func)
+        def wrapper(*args, **kwargs):
+            if not session.get("term_confirmed"):
+                return redirect(url_for("select_term", next=step_key))
+            return func(*args, **kwargs)
+        return wrapper
+    return decorator
+
+if not DB_PATH.exists():
+    import seed  # side effect: creates DB
+
+def q(sql, *params):
+    con = sqlite3.connect(DB_PATH)
+    con.row_factory = sqlite3.Row
+    cur = con.execute(sql, params)
+    rows = [dict(r) for r in cur.fetchall()]
+    con.close()
+    return rows
+
+
+def execute(sql, *params):
+    with sqlite3.connect(DB_PATH) as con:
+        con.execute(sql, params)
+        con.commit()
+
+
+@APP.get("/status")
+def status():
+    return jsonify({"service": "minerva-lite", "ok": True})
+
+
+@APP.get("/")
+def registration_menu():
+    msg = request.args.get("msg", "")
+    return render_template("registration_menu.html", msg=msg)
+
+
+@APP.get("/search")
+@require_term("search")
+def search():
+    subject = request.args.get("subject", "").strip().upper()
+    number = request.args.get("number", "").strip()
+    title = request.args.get("title", "").strip()
+    campus = request.args.get("campus", "").strip()
+    term = session.get("term", "Fall 2025")
+
+    sql = "SELECT * FROM courses WHERE 1=1"
+    args = []
+    if term:
+        sql += " AND term = ?"
+        args.append(term)
+    if subject:
+        sql += " AND subject = ?"
+        args.append(subject)
+    if number:
+        sql += " AND number LIKE ?"
+        args.append(f"%{number}%")
+    if title:
+        sql += " AND lower(title) LIKE ?"
+        args.append(f"%{title.lower()}%")
+    if campus:
+        sql += " AND campus = ?"
+        args.append(campus)
+    sql += " ORDER BY subject, number"
+    results = q(sql, *args)
+    return render_template("search.html", results=results)
+
+
+@APP.post("/add")
+def add_course():
+    crn = request.form.get("crn", "").strip()
+    if not crn:
+        return redirect(url_for("add_drop", msg="Enter a CRN."))
+    # Check if exists and open
+    rows = q("SELECT * FROM courses WHERE crn=?", crn)
+    if not rows:
+        return redirect(url_for("add_drop", msg="Invalid CRN."))
+    course = rows[0]
+    # Ensure CRN belongs to the currently selected term
+    current_term = session.get("term", "Fall 2025")
+    if course.get("term") != current_term:
+        return redirect(url_for("add_drop", msg=f"CRN not in {current_term} term."))
+    reg = q("SELECT * FROM registrations WHERE student_id=1 AND crn=?", crn)
+    if reg:
+        return redirect(url_for("add_drop", msg="Already registered."))
+    if course["seats_taken"] >= course["seats_total"]:
+        return redirect(url_for("add_drop", msg="Section full."))
+    execute("INSERT INTO registrations(student_id,crn) VALUES(1,?)", crn)
+    execute(
+        "UPDATE courses SET seats_taken = seats_taken + 1 WHERE crn=?",
+        crn,
+    )
+    return redirect(url_for("schedule", msg="Added CRN %s" % crn))
+
+
+@APP.post("/drop")
+def drop_course():
+    crn = request.form.get("crn", "").strip()
+    reg = q("SELECT * FROM registrations WHERE student_id=1 AND crn=?", crn)
+    if not reg:
+        return redirect(url_for("schedule", msg="Not registered."))
+    execute("DELETE FROM registrations WHERE student_id=1 AND crn=?", crn)
+    execute(
+        "UPDATE courses SET seats_taken = CASE WHEN seats_taken>0 THEN seats_taken-1 ELSE 0 END WHERE crn=?",
+        crn,
+    )
+    return redirect(url_for("schedule", msg="Dropped CRN %s" % crn))
+
+
+@APP.get("/add-drop")
+@require_term("add_drop")
+def add_drop():
+    msg = request.args.get("msg", "")
+    current_term = session.get("term", "Fall 2025")
+    regs = q(
+        "SELECT c.* FROM registrations r JOIN courses c ON r.crn=c.crn WHERE r.student_id=1 AND c.term=? ORDER BY c.subject, c.number",
+        current_term,
+    )
+    return render_template("add_drop.html", regs=regs, msg=msg)
+
+
+@APP.get("/schedule")
+@require_term("schedule")
+def schedule():
+    msg = request.args.get("msg", "")
+    current_term = session.get("term", "Fall 2025")
+    regs = q(
+        "SELECT c.* FROM registrations r JOIN courses c ON r.crn=c.crn WHERE r.student_id=1 AND c.term=? ORDER BY c.subject, c.number",
+        current_term,
+    )
+    return render_template("schedule.html", regs=regs, msg=msg)
+
+
+def _parse_time_range(range_str):
+    try:
+        s, e = [t.strip() for t in range_str.split("-")]
+        sh, sm = [int(x) for x in s.split(":")]
+        eh, em = [int(x) for x in e.split(":")]
+        return sh * 60 + sm, eh * 60 + em
+    except Exception:
+        return None, None
+
+
+@APP.get("/schedule-week")
+@require_term("schedule_week")
+def schedule_week():
+    # Build weekly event blocks for registered sections
+    current_term = session.get("term", "Fall")
+    regs = q(
+        "SELECT c.* FROM registrations r JOIN courses c ON r.crn=c.crn WHERE r.student_id=1 AND c.term=?",
+        current_term,
+    )
+    start_day_min = 8 * 60  # 08:00 grid start
+    end_day_min = 18 * 60   # 18:00 grid end
+    span = end_day_min - start_day_min
+    grid_px = 800  # matches CSS .grid-body height
+    day_map = {"M": 1, "T": 2, "W": 3, "R": 4, "F": 5}
+
+    events = []
+    for c in regs:
+        smin, emin = _parse_time_range(c.get("time") or "")
+        if smin is None:
+            continue
+        duration = max(emin - smin, 30)
+        # pixel-perfect placement using the same 800px grid height
+        top_px = max(int(round((smin - start_day_min) / span * grid_px)), 0)
+        height_px = max(int(round(duration / span * grid_px)), 2)
+        for ch in (c.get("days") or ""):  # e.g., "MWF" or "TR"
+            if ch in day_map:
+                events.append({
+                    "day_col": day_map[ch],
+                    "title": f"{c['subject']} {c['number']}",
+                    "subtitle": c["title"],
+                    "time": c["time"],
+                    "top_px": top_px,
+                    "height_px": height_px,
+                    "crn": c["crn"],
+                })
+
+    # Time labels every hour for the left rail
+    time_labels = []
+    for h in range(8, 18):
+        time_labels.append(f"{h:02d}:00")
+
+    return render_template(
+        "schedule_week.html",
+        events=events,
+        time_labels=time_labels,
+    )
+
+
+@APP.get("/accounts")
+@require_term("accounts")
+def accounts():
+    return render_template("accounts.html")
+
+
+@APP.post("/set-term")
+def set_term():
+    term = request.form.get("term", "").strip().title()
+    if term not in ("Fall 2025", "Winter 2026", "Summer 2026"):
+        return redirect(url_for("registration_menu", msg="Invalid term."))
+    session["term"] = term
+    session["term_confirmed"] = True
+    next_key = request.form.get("next", "").strip()
+    if next_key in STEP_DESTINATIONS:
+        endpoint = STEP_DESTINATIONS[next_key]["endpoint"]
+        return redirect(url_for(endpoint))
+    # Redirect back to the referrer if possible
+    ref = request.headers.get("Referer")
+    return redirect(ref or url_for("registration_menu", msg=f"Term set to {term}"))
+
+
+@APP.get("/select-term")
+def select_term():
+    next_key = request.args.get("next", "search").strip()
+    destination = STEP_DESTINATIONS.get(next_key, STEP_DESTINATIONS["search"])
+    if request.args.get("reset"):
+        session["term_confirmed"] = False
+    return render_template(
+        "select_term.html",
+        next_key=next_key,
+        destination_label=destination["label"],
+    )
+
+
+@APP.context_processor
+def inject_term():
+    current_step_key = STEP_KEYS_BY_ENDPOINT.get(request.endpoint, "")
+    if request.endpoint == "select_term":
+        current_step_key = request.args.get("next", current_step_key or "search")
+    return {
+        "current_term": session.get("term", "Fall 2025"),
+        "terms": ["Fall 2025", "Winter 2026", "Summer 2026"],
+        "term_confirmed": session.get("term_confirmed", False),
+        "current_step_key": current_step_key,
+    }
+
+
+@APP.get("/reset")
+def reset():
+    if DB_PATH.exists():
+        DB_PATH.unlink()
+    import seed  # re-seed
+    return jsonify({"reset": True})
+
+
+if __name__ == "__main__":
+    APP.run(host="0.0.0.0", port=8000)

data/courses_seed.json

@@ -0,0 +1,23 @@
+{
+  "courses": [
+    {"crn": "10001", "subject": "COMP", "number": "202", "title": "Foundations of Programming", "credits": 3, "days": "MWF", "time": "10:00-10:50", "campus": "Downtown", "seats_total": 200, "seats_taken": 160},
+    {"crn": "10002", "subject": "COMP", "number": "250", "title": "Introduction to Computer Science", "credits": 3, "days": "TR",   "time": "11:35-12:55", "campus": "Downtown", "seats_total": 180, "seats_taken": 175},
+    {"crn": "10003", "subject": "COMP", "number": "364", "title": "Bioinformatics", "credits": 3, "days": "TR",   "time": "13:05-14:25", "campus": "Downtown", "seats_total": 90,  "seats_taken": 55},
+    {"crn": "10004", "subject": "COMP", "number": "421", "title": "Database Systems", "credits": 3, "days": "MW",  "time": "14:35-15:55", "campus": "Downtown", "seats_total": 120, "seats_taken": 120},
+    {"crn": "10005", "subject": "MATH", "number": "222", "title": "Calculus 3", "credits": 3, "days": "MWF", "time": "12:35-13:25", "campus": "Downtown", "seats_total": 250, "seats_taken": 230},
+    {"crn": "10006", "subject": "PHYS", "number": "101", "title": "Introductory Physics", "credits": 3, "days": "TR", "time": "08:35-09:55", "campus": "Downtown", "seats_total": 140, "seats_taken": 100},
+    {"crn": "10007", "subject": "ECON", "number": "230", "title": "Microeconomic Analysis", "credits": 3, "days": "MWF", "time": "09:35-10:25", "campus": "Downtown", "seats_total": 160, "seats_taken": 155},
+    {"crn": "10008", "subject": "BIOL", "number": "111", "title": "Principles of Biology", "credits": 3, "days": "TR", "time": "10:05-11:25", "campus": "Downtown", "seats_total": 180, "seats_taken": 90},
+    {"crn": "10009", "subject": "CHEM", "number": "120", "title": "General Chemistry", "credits": 3, "days": "MWF", "time": "11:35-12:25", "campus": "Downtown", "seats_total": 220, "seats_taken": 210},
+    {"crn": "10010", "subject": "ENGL", "number": "199", "title": "Introduction to Literature", "credits": 3, "days": "TR", "time": "14:35-15:55", "campus": "Downtown", "seats_total": 80,  "seats_taken": 60},
+    {"crn": "10011", "subject": "PSYC", "number": "100", "title": "Introduction to Psychology", "credits": 3, "days": "MW", "time": "16:05-17:25", "campus": "Downtown", "seats_total": 240, "seats_taken": 220},
+    {"crn": "10012", "subject": "COMP", "number": "424", "title": "Artificial Intelligence", "credits": 3, "days": "TR",   "time": "09:05-10:25", "campus": "Downtown", "seats_total": 120, "seats_taken": 80},
+    {"crn": "10013", "subject": "COMP", "number": "551", "title": "Applied Machine Learning", "credits": 3, "days": "TR",   "time": "13:35-14:55", "campus": "Downtown", "seats_total": 90,  "seats_taken": 70},
+    {"crn": "10014", "subject": "MATH", "number": "223", "title": "Linear Algebra", "credits": 3, "days": "MWF", "time": "11:35-12:25", "campus": "Downtown", "seats_total": 200, "seats_taken": 180},
+    {"crn": "10015", "subject": "STAT", "number": "260", "title": "Introduction to Statistics", "credits": 3, "days": "TR",   "time": "12:35-13:55", "campus": "Downtown", "seats_total": 160, "seats_taken": 130},
+    {"crn": "10016", "subject": "ECON", "number": "340", "title": "Macroeconomic Theory", "credits": 3, "days": "MW",  "time": "15:05-16:25", "campus": "Downtown", "seats_total": 100, "seats_taken": 85},
+    {"crn": "10017", "subject": "HIST", "number": "210", "title": "Modern World History", "credits": 3, "days": "MWF", "time": "13:35-14:25", "campus": "Downtown", "seats_total": 140, "seats_taken": 95},
+    {"crn": "10018", "subject": "PHYS", "number": "230", "title": "Electricity and Magnetism", "credits": 3, "days": "TR",   "time": "16:05-17:25", "campus": "Downtown", "seats_total": 110, "seats_taken": 60},
+    {"crn": "10019", "subject": "ENGL", "number": "315", "title": "Creative Writing Workshop", "credits": 3, "days": "MW",  "time": "09:05-10:25", "campus": "Downtown", "seats_total": 60,  "seats_taken": 45}
+  ]
+}

requirements.txt

@@ -0,0 +1,7 @@
+flask==3.0.0
+Flask-Session
+jinja2==3.1.3
+itsdangerous==2.2.0
+click==8.1.7
+werkzeug==3.0.1
+markupsafe==2.1.3

schema.sql

@@ -0,0 +1,30 @@
+DROP TABLE IF EXISTS registrations;
+DROP TABLE IF EXISTS students;
+DROP TABLE IF EXISTS courses;
+
+CREATE TABLE courses (
+    crn TEXT PRIMARY KEY,
+    subject TEXT NOT NULL,
+    number TEXT NOT NULL,
+    title TEXT NOT NULL,
+    credits REAL NOT NULL,
+    days TEXT,
+    time TEXT,
+    campus TEXT NOT NULL,
+    term TEXT NOT NULL,
+    seats_total INTEGER NOT NULL,
+    seats_taken INTEGER NOT NULL DEFAULT 0
+);
+
+CREATE TABLE students (
+    id INTEGER PRIMARY KEY,
+    name TEXT
+);
+
+CREATE TABLE registrations (
+    student_id INTEGER NOT NULL,
+    crn TEXT NOT NULL,
+    PRIMARY KEY (student_id, crn),
+    FOREIGN KEY(student_id) REFERENCES students(id),
+    FOREIGN KEY(crn) REFERENCES courses(crn)
+);

seed.py

@@ -0,0 +1,89 @@
+import os, sqlite3, pathlib, random
+from common.seed_utils import init_db, load_json
+
+
+ROOT = pathlib.Path(__file__).parent
+DB_PATH = ROOT / "db" / "minerva.sqlite3"
+SCHEMA = ROOT / "schema.sql"
+SEED_JSON = ROOT / "data" / "courses_seed.json"
+SEED = int(os.environ.get("APP_SEED", 42))
+random.seed(SEED)
+
+
+init_db(DB_PATH, SCHEMA)
+seed = load_json(SEED_JSON)
+
+TERMS = ["Fall 2025", "Winter 2026", "Summer 2026"]
+TERM_PREFIX = {"Fall 2025": "1", "Winter 2026": "2", "Summer 2026": "3"}
+
+
+def _normalize_terms(terms_list):
+    # Accept plain season names or fully labeled ones and normalize
+    norm = []
+    for t in terms_list:
+        tl = str(t).strip()
+        low = tl.lower()
+        if tl in TERMS:
+            norm.append(tl)
+        elif "fall" in low:
+            norm.append("Fall 2025")
+        elif "winter" in low:
+            norm.append("Winter 2026")
+        elif "summer" in low:
+            norm.append("Summer 2026")
+    # Deduplicate while preserving order
+    out = []
+    for t in norm:
+        if t not in out:
+            out.append(t)
+    return out
+
+
+def _pick_terms_for_course(crn_str):
+    # Deterministic selection: some courses in 1 term, some in 2, some in all 3
+    try:
+        base_seed = SEED + int("".join(ch for ch in crn_str if ch.isdigit()))
+    except Exception:
+        base_seed = SEED
+    rnd = random.Random(base_seed)
+    p = rnd.random()
+    if p < 0.4:
+        k = 1
+    elif p < 0.8:
+        k = 2
+    else:
+        k = 3
+    return rnd.sample(TERMS, k)
+
+with sqlite3.connect(DB_PATH) as con:
+    # Seed one demo student
+    con.execute("INSERT INTO students(id, name) VALUES(1, ?)", ("Demo Student",))
+    # Seed courses with variable term availability
+    for c in seed["courses"]:
+        explicit_terms = _normalize_terms(c.get("terms", [])) if isinstance(c, dict) else []
+        terms_for_course = explicit_terms or _pick_terms_for_course(str(c.get("crn", "")))
+        for term in terms_for_course:
+            base_crn = str(c["crn"])  # from JSON
+            # Prefix CRN by term to ensure uniqueness across terms
+            crn = f"{TERM_PREFIX[term]}{base_crn}"
+            con.execute(
+                """
+                INSERT INTO courses(crn,subject,number,title,credits,days,time,campus,term,seats_total,seats_taken)
+                VALUES(?,?,?,?,?,?,?,?,?,?,?)
+                """,
+                (
+                    crn,
+                    c["subject"],
+                    c["number"],
+                    c["title"],
+                    float(c["credits"]),
+                    c.get("days", ""),
+                    c.get("time", ""),
+                    c.get("campus", "Downtown"),
+                    term,
+                    int(c.get("seats_total", 100)),
+                    int(c.get("seats_taken", 0)),
+                ),
+            )
+    con.commit()
+print("Minerva-Lite seeded.")

selectors.json

@@ -0,0 +1,29 @@
+{
+  "menu_home": "[data-test=menu-home]",
+  "menu_search": "[data-test=menu-search]",
+  "menu_adddrop": "[data-test=menu-adddrop]",
+  "menu_schedule": "[data-test=menu-schedule]",
+  "menu_schedule_week": "[data-test=menu-schedule-week]",
+  "change_term_link": "[data-test=change-term-link]",
+
+  "search_subject": "[data-test=search-subject]",
+  "search_number": "[data-test=search-number]",
+  "search_title": "[data-test=search-title]",
+  "search_campus": "[data-test=search-campus]",
+  "search_openonly": "[data-test=search-openonly]",
+  "search_button": "[data-test=search-button]",
+
+  "course_row": "[data-test=course-row]",
+  "course_crn": "[data-test=course-crn]",
+  "add_button": "[data-test=add-button]",
+
+  "add_crn_input": "[data-test=add-crn-input]",
+  "add_submit": "[data-test=add-submit]",
+  "schedule_row": "[data-test=schedule-row]",
+  "drop_button": "[data-test=drop-button]",
+
+  "notice": "[data-test=notice]",
+  "week_event": "[data-test=week-event]",
+  "term_select": "[data-test=term-select]",
+  "term_submit": "[data-test=term-submit]"
+}

static/styles.css

@@ -0,0 +1,382 @@
+:root{
+  --brand:#b70000;
+  --brand-dark:#7a0000;
+  --bg:#f1f3f8;
+  --text:#1d1d1f;
+  --muted:#4e5a6b;
+  --border:#d4d8e0;
+  --surface:#fff;
+  --accent:#0d4f9a;
+  --notice-bg:#fff7c2;
+  --nav:#0c2340;
+}
+
+*{box-sizing:border-box}
+body{
+  font-family: "Segoe UI", "Helvetica Neue", Arial, sans-serif;
+  margin:0;
+  color:var(--text);
+  background:var(--bg);
+}
+.minerva-skin{
+  min-height:100vh;
+  display:flex;
+  flex-direction:column;
+  background:linear-gradient(180deg,#e7ebf5 0%,#f7f8fb 160%);
+}
+.container{
+  max-width:1280px;
+  width:92vw;
+  margin:0 auto;
+  padding:0 18px;
+}
+
+.sr-only{
+  position:absolute;
+  width:1px;
+  height:1px;
+  padding:0;
+  margin:-1px;
+  overflow:hidden;
+  clip:rect(0,0,0,0);
+  border:0;
+}
+
+.minerva-header{
+  box-shadow:0 2px 6px rgba(12,19,31,.2);
+  background:#dcdfe6;
+}
+.hero-strip{
+  background:linear-gradient(135deg,#cfd4de 10%,#edf0f6 60%);
+  border-bottom:2px solid #b8bec8;
+}
+.hero-inner{
+  display:flex;
+  align-items:center;
+  justify-content:space-between;
+  min-height:90px;
+  padding:.85rem 16px;
+  gap:1.5rem;
+}
+.hero-brand{display:flex;align-items:center;gap:1rem}
+.hero-logo{
+  background:#c02827;
+  color:#fff;
+  font-weight:600;
+  font-size:1.1rem;
+  padding:.5rem 1.1rem;
+  border-radius:6px;
+  text-transform:uppercase;
+  letter-spacing:.05em;
+  box-shadow:0 2px 4px rgba(0,0,0,.2);
+}
+.hero-wordmark-main{
+  font-size:1.8rem;
+  color:#1e1e1e;
+  font-weight:600;
+}
+.hero-wordmark-sub{
+  font-size:.8rem;
+  text-transform:uppercase;
+  letter-spacing:.08em;
+  color:#4b4f5a;
+}
+.hero-figure{
+  flex:0 0 180px;
+  height:90px;
+  background:linear-gradient(120deg,#920707,#f8c4c4);
+  border-radius:999px 0 0 999px;
+  box-shadow:inset 0 0 25px rgba(0,0,0,.2);
+}
+.tab-row{
+  background:linear-gradient(180deg,#f5f6fb 0%,#e1e6f0 100%);
+  border-bottom:1px solid #c2c7d3;
+  box-shadow:inset 0 1px 0 rgba(255,255,255,.7);
+  padding-bottom:.5rem;
+  margin-bottom:1.5rem;
+}
+.tab-nav{
+  display:flex;
+  align-items:center;
+  justify-content:center;
+  padding:0 16px;
+}
+.tab-links{
+  display:flex;
+  gap:.25rem;
+  flex-wrap:wrap;
+  justify-content:center;
+}
+.tab-links a{
+  min-width:150px;
+  text-align:center;
+  padding:.6rem 0;
+  text-transform:uppercase;
+  font-weight:600;
+  font-size:.85rem;
+  letter-spacing:.05em;
+  color:#1f2a44;
+  text-decoration:none;
+  border:1px solid #cfd5e2;
+  border-bottom:3px solid transparent;
+  border-top-left-radius:6px;
+  border-top-right-radius:6px;
+  background:linear-gradient(180deg,#fcfcff 0%,#eef1f6 100%);
+  box-shadow:0 1px 1px rgba(14,23,39,.08);
+  transition:all .2s ease;
+}
+.tab-links a:hover{
+  color:#b00000;
+  border-bottom-color:#b00000;
+}
+.tab-links a.is-active{
+  color:#960000;
+  background:#fff;
+  border-color:#b00000;
+  border-bottom-color:#fff;
+  box-shadow:0 4px 10px rgba(13,25,44,.12);
+}
+
+main{
+  padding:2rem 0;
+  flex:1;
+}
+.page{
+  background:var(--surface);
+  border:1px solid var(--border);
+  border-top:4px solid #f4c542;
+  box-shadow:0 8px 20px rgba(12,19,31,.12);
+  margin-top:-20px;
+  padding:2.25rem 1.5rem;
+}
+.page-heading{
+  display:flex;
+  align-items:center;
+  justify-content:space-between;
+  gap:1rem;
+  margin-bottom:1.5rem;
+  flex-wrap:wrap;
+}
+.page-heading h1{margin:0;color:#a10f0f}
+.term-chip{
+  border:1px solid #d2d7e5;
+  background:#f4f5fb;
+  padding:.35rem .85rem;
+  border-radius:999px;
+  font-size:.85rem;
+  font-weight:600;
+  color:#1c2750;
+  text-transform:uppercase;
+  letter-spacing:.04em;
+}
+.term-footer{
+  background:#e0e4f0;
+  border-top:1px solid #c3c8d5;
+  margin-top:auto;
+}
+.term-footer-inner{
+  display:flex;
+  justify-content:center;
+  gap:.6rem;
+  font-size:.85rem;
+  padding:.65rem 16px;
+  color:#1f2a44;
+  flex-wrap:wrap;
+}
+.term-footer-inner a{
+  color:#940b0b;
+  font-weight:600;
+  text-decoration:none;
+}
+.term-footer-inner a:hover{text-decoration:underline}
+.page-lead{display:flex;flex-direction:column;gap:1rem;margin-bottom:2rem}
+.page-title{margin:0;color:#a10f0f;font-size:1.8rem;font-weight:700}
+
+.term-gate{
+  border:1px solid var(--border);
+  background:#fff;
+  padding:2rem;
+  box-shadow:0 8px 20px rgba(15,23,38,.08);
+}
+.term-gate h1{margin-top:0;color:#a10f0f}
+.term-gate-form{
+  display:flex;
+  flex-direction:column;
+  gap:1rem;
+  max-width:320px;
+  margin-top:1rem;
+}
+
+.highlight-panel{
+  border:1px solid var(--border);
+  padding:1rem;
+  border-radius:4px;
+  display:flex;
+  gap:1rem;
+  align-items:center;
+  font-size:.95rem;
+  line-height:1.5;
+}
+.highlight-blue{background:#e4f1ff;border-color:#b4d4fa}
+.highlight-yellow{background:#fff8d9;border-color:#f3d98c}
+.highlight-link{
+  color:#0c3f91;
+  font-weight:700;
+  text-decoration:none;
+}
+.highlight-link:hover{text-decoration:underline}
+
+.content-panel{
+  border:1px solid var(--border);
+  padding:1.5rem;
+  margin-bottom:2rem;
+  background:#fff;
+}
+.guidance p{margin-top:0;margin-bottom:1rem;line-height:1.6}
+.guidance a{color:#0d4f9a}
+.inline-callout{
+  background:#fff3a6;
+  border-left:4px solid #f5c400;
+  padding:.75rem 1rem;
+  font-weight:600;
+}
+
+.step-grid{
+  display:flex;
+  flex-direction:column;
+  gap:1.2rem;
+  margin-bottom:2rem;
+}
+.step-card{
+  border:1px solid #cfd6e4;
+  background:#fdfdff;
+  padding:1.25rem;
+  box-shadow:0 2px 6px rgba(15,33,55,.08);
+  display:flex;
+  flex-direction:column;
+  gap:.75rem;
+}
+.step-card header{display:flex;gap:.8rem;align-items:center}
+.step-number{
+  background:#f4c542;
+  color:#381d00;
+  font-weight:700;
+  min-width:54px;
+  text-align:center;
+  border-radius:999px;
+  padding:.3rem 0;
+}
+.step-card h2{
+  margin:0;
+  font-size:1.05rem;
+  color:#092352;
+}
+.step-card p{margin:0;line-height:1.45;font-size:.92rem;color:#2f3847}
+.step-link{
+  margin-top:auto;
+  font-weight:600;
+  color:var(--accent);
+  text-decoration:none;
+}
+.step-link:hover{text-decoration:underline}
+
+.support h3{margin-top:0;color:#0c2340}
+
+.notice{background:var(--notice-bg);border:1px solid var(--border);padding:.6rem .8rem;border-radius:4px}
+.muted{color:var(--muted)}
+
+/* Forms */
+label{font-size:.9rem;color:var(--muted);display:flex;flex-direction:column;gap:.25rem}
+input[type=text], select{
+  border:1px solid var(--border);
+  padding:.45rem .5rem;border-radius:6px;background:var(--surface);
+}
+.form-grid{display:flex;gap:.6rem;flex-wrap:wrap;align-items:end;margin:.75rem 0 1rem}
+
+.btn{border:1px solid var(--border);border-radius:6px;padding:.45rem .7rem;cursor:pointer;background:#fff}
+.btn:hover{filter:brightness(0.98)}
+.btn:disabled{opacity:.5;cursor:not-allowed}
+.btn-primary{background:var(--brand);border-color:var(--brand);color:#fff}
+.btn-danger{background:#a61b1b;border-color:#a61b1b;color:#fff}
+
+/* Tables */
+table{border-collapse:collapse;width:100%;background:var(--surface);border:1px solid var(--border)}
+thead th{background:#f1f3f5;color:#111;text-align:left}
+th,td{padding:.55rem .6rem;border-bottom:1px solid var(--border)}
+tbody tr:nth-child(even){background:#fafbfc}
+tbody tr:hover{background:#f5f7fb}
+
+.seat-pill{display:inline-block;padding:.15rem .5rem;border-radius:999px;font-size:.78rem;border:1px solid var(--border)}
+.seat-pill.open{background:#e8fff1;border-color:#a7e4bf;color:#186a3b}
+.seat-pill.full{background:#ffe8e8;border-color:#f1b3b3;color:#7d1b1b}
+
+/* Weekly schedule */
+.week-grid{
+  display:grid;
+  grid-template-columns:80px 1fr;
+  gap:12px;
+  width:100%;
+}
+/* Left time rail: 10 rows (08:00–18:00) each 80px tall */
+.times{display:grid;grid-template-rows:repeat(10,80px);padding-top:48px}
+.time{font-size:.85rem;color:var(--muted);display:flex;align-items:center;justify-content:center}
+.days{display:grid;grid-template-rows:48px 800px}
+.days>.hdr{display:grid;grid-template-columns:repeat(5,1fr);gap:8px;align-items:center}
+.days>.hdr>div{font-weight:600;color:#111;display:flex;align-items:center;justify-content:center;height:48px}
+.grid-body{position:relative;border:1px solid var(--border);background:var(--surface);border-radius:8px;overflow:hidden}
+.grid-body{display:grid;grid-template-columns:repeat(5,1fr)}
+.grid-body>.col{position:relative}
+.grid-body>.col:not(:last-child){border-right:1px solid #e7edf5}
+.grid-body::before{content:"";position:absolute;left:0;right:0;top:0;bottom:0;background:linear-gradient(to bottom, transparent 95%, #eef2f7 96%);background-size:100% 80px;pointer-events:none}
+.grid-body{height:800px}
+.event{position:absolute;left:0;right:0;margin:0 8px;border-radius:8px;padding:.3rem .4rem;background:#eef5ff;border:1px solid #cfe0ff;box-shadow:0 1px 0 rgba(0,0,0,.04)}
+.event-title{font-size:.85rem;font-weight:600;line-height:1.1}
+.event-sub{font-size:.78rem;color:var(--muted);line-height:1.1}
+.event-time{font-size:.78rem;line-height:1.1}
+.event-title,.event-sub,.event-time{overflow-wrap:anywhere}
+
+/* Responsive adjustments */
+@media (max-width: 1100px){
+  .container{
+    width:100%;
+    max-width:1100px;
+    padding:0 14px;
+  }
+  .hero-figure{flex:0 0 120px;height:70px}
+}
+@media (max-width: 900px){
+  .hero-inner{flex-direction:column;align-items:flex-start;text-align:left}
+  .hero-brand{flex-wrap:wrap}
+  .hero-figure{display:none}
+  .tab-nav{justify-content:flex-start}
+  .tab-links{
+    flex-wrap:nowrap;
+    overflow-x:auto;
+    justify-content:flex-start;
+    padding-bottom:.5rem;
+  }
+  .tab-links a{min-width:140px;font-size:.78rem}
+  .side-panel{flex-direction:row;flex-wrap:wrap;max-width:none}
+  .callout{flex:1 1 240px}
+  .highlight-panel{flex:1 1 260px}
+}
+@media (max-width: 700px){
+  .container{padding:0 12px}
+  .hero-wordmark-main{font-size:1.4rem}
+  .hero-wordmark-sub{font-size:.7rem}
+  .hero-logo{font-size:1rem}
+  .form-grid{flex-direction:column;align-items:stretch}
+  table{display:block;overflow-x:auto}
+  thead,tbody,tr,th,td{white-space:nowrap}
+  .step-card{padding:1rem}
+  .callout{flex-direction:column;align-items:flex-start}
+  .term-footer-inner{flex-direction:column;gap:.4rem;text-align:center}
+}
+@media (max-width: 520px){
+  .hero-brand{align-items:flex-start}
+  .tab-links a{min-width:120px;padding:.5rem .3rem}
+  .week-grid{grid-template-columns:1fr}
+  .times{display:none}
+  .grid-body{grid-template-columns:repeat(5, minmax(120px,1fr));overflow-x:auto}
+  .grid-body>.col:not(:last-child){border-right:1px solid #e7edf5}
+}

templates/accounts.html

@@ -0,0 +1,18 @@
+{% extends "base.html" %}
+{% block content %}
+<div class="page-heading">
+  <h1>Tuition Fee and Legal Status</h1>
+  {% if term_confirmed %}
+  <span class="term-chip">Term: {{ current_term }}</span>
+  {% endif %}
+</div>
+<section class="content-panel">
+  <p>
+    This simplified Minerva environment does not include full billing services, but you can use this page to confirm
+    that the correct term is active before reviewing statements in other systems.
+  </p>
+  <p class="muted">
+    Select Step 6 from the registration menu to return here after adjusting your term.
+  </p>
+</section>
+{% endblock %}

templates/add_drop.html

@@ -0,0 +1,45 @@
+{% extends "base.html" %}
+{% block content %}
+<div class="page-heading">
+  <h1>Quick Add or Drop Course Sections</h1>
+  {% if term_confirmed %}
+  <span class="term-chip">Term: {{ current_term }}</span>
+  {% endif %}
+</div>
+
+<form method="POST" action="/add" class="form-grid" style="margin-bottom:1rem">
+  <label>CRN
+    <input data-test="add-crn-input" type="text" name="crn" placeholder="e.g., 12345" />
+  </label>
+  <button class="btn btn-primary" data-test="add-submit" type="submit">Add</button>
+</form>
+
+<h2>Registered Sections</h2>
+<table>
+  <thead>
+    <tr>
+      <th>CRN</th><th>Subject</th><th>Number</th><th>Title</th><th>Schedule</th><th>Campus</th><th></th>
+    </tr>
+  </thead>
+  <tbody>
+    {% for c in regs %}
+    <tr data-test="schedule-row">
+      <td>{{ c['crn'] }}</td>
+      <td>{{ c['subject'] }}</td>
+      <td>{{ c['number'] }}</td>
+      <td>{{ c['title'] }}</td>
+      <td>{{ c['days'] }} {{ c['time'] }}</td>
+      <td>{{ c['campus'] }}</td>
+      <td>
+        <form method="POST" action="/drop">
+          <input type="hidden" name="crn" value="{{ c['crn'] }}" />
+          <button class="btn btn-danger" data-test="drop-button" type="submit">Drop</button>
+        </form>
+      </td>
+    </tr>
+    {% else %}
+    <tr><td colspan="7">No registered sections.</td></tr>
+    {% endfor %}
+  </tbody>
+</table>
+{% endblock %}

templates/base.html

@@ -0,0 +1,82 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>{{ title or 'Minerva - Registration' }}</title>
+    <link rel="stylesheet" href="/static/styles.css" />
+  </head>
+  <body class="minerva-skin">
+    <header class="minerva-header">
+      <div class="hero-strip">
+        <div class="container hero-inner">
+          <div class="hero-brand" data-test="logo">
+            <div class="hero-wordmark">
+              <div class="hero-wordmark-main">Minerva</div>
+              <div class="hero-wordmark-sub">
+                Registration &amp; Student Records
+              </div>
+            </div>
+          </div>
+          <div class="hero-figure" aria-hidden="true"></div>
+        </div>
+      </div>
+      {% set current_path = request.path %} {% set pending_tab =
+      request.args.get('next') if request.endpoint == 'select_term' else '' %}
+      {% set change_term_next = pending_tab or current_step_key or 'search' %}
+      <div class="tab-row">
+        <div class="container tab-nav">
+          <nav class="tab-links">
+            <a
+              href="/"
+              data-test="menu-home"
+              class="{% if current_path == '/' %}is-active{% endif %}"
+              >Registration Menu</a
+            >
+            <a
+              href="{% if term_confirmed %}/search{% else %}/select-term?next=search{% endif %}"
+              data-test="menu-search"
+              class="{% if current_path.startswith('/search') or pending_tab=='search' %}is-active{% endif %}"
+              >Search Class</a
+            >
+            <a
+              href="{% if term_confirmed %}/add-drop{% else %}/select-term?next=add_drop{% endif %}"
+              data-test="menu-adddrop"
+              class="{% if current_path.startswith('/add-drop') or pending_tab=='add_drop' %}is-active{% endif %}"
+              >Add/Drop</a
+            >
+            <a
+              href="{% if term_confirmed %}/schedule{% else %}/select-term?next=schedule{% endif %}"
+              data-test="menu-schedule"
+              class="{% if (current_path.startswith('/schedule') and not current_path.startswith('/schedule-week')) or pending_tab=='schedule' %}is-active{% endif %}"
+              >Student Schedule</a
+            >
+            <a
+              href="{% if term_confirmed %}/schedule-week{% else %}/select-term?next=schedule_week{% endif %}"
+              data-test="menu-schedule-week"
+              class="{% if current_path.startswith('/schedule-week') or pending_tab=='schedule_week' %}is-active{% endif %}"
+              >Weekly View</a
+            >
+          </nav>
+        </div>
+      </div>
+    </header>
+    <main class="page container">
+      {% if msg %}
+      <p class="notice" data-test="notice">{{ msg }}</p>
+      {% endif %} {% block content %}{% endblock %}
+    </main>
+    <footer class="term-footer">
+      <div class="container term-footer-inner">
+        <span>Need to work in another term?</span>
+        <a
+          href="/select-term?reset=1&amp;next={{ change_term_next }}"
+          data-test="change-term-link"
+          >Change Term</a
+        >
+        
+      </div>
+    </footer>
+    <!-- status link removed from UI; endpoint remains for health checks -->
+  </body>
+</html>

templates/registration_menu.html

@@ -0,0 +1,81 @@
+{% extends "base.html" %}
+{% block content %}
+<section class="page-lead">
+  <h1 class="page-title">Registration Menu</h1>
+</section>
+
+<section class="step-grid">
+  <article class="step-card">
+    <header>
+      <div class="step-number">Step 1</div>
+      <h2>Check Your Registration Eligibility and Verify Your Curriculum</h2>
+    </header>
+    <p>
+      Confirm that you have resolved all holds, outstanding transcripts, or advising requirements that could prevent
+      registration. Review your primary faculty, program, and concentration selections before continuing.
+    </p>
+    <a class="step-link" href="#" aria-label="Student Records Menu">Go to Student Records Menu</a>
+  </article>
+
+  <article class="step-card">
+    <header>
+      <div class="step-number">Step 2</div>
+      <h2>Search Class and Add Course Sections</h2>
+    </header>
+    <p>
+      Choose the schedule term, search by subject or CRN, and add courses to your worksheet. Visualize potential
+      conflicts and note seats that may be available on the waitlist (space permitting).
+    </p>
+    <a class="step-link" href="{% if term_confirmed %}/search{% else %}/select-term?next=search{% endif %}" data-test="menu-step-search">Launch Search Class</a>
+  </article>
+
+  <article class="step-card">
+    <header>
+      <div class="step-number">Step 3</div>
+      <h2>Quick Add or Drop Course Sections</h2>
+    </header>
+    <p>
+      Have a CRN ready? Use Quick Add to enter it directly, or drop from the list of registered sections. Select the
+      satisfactory/unsatisfactory grade mode when eligible.
+    </p>
+    <a class="step-link" href="{% if term_confirmed %}/add-drop{% else %}/select-term?next=add_drop{% endif %}" data-test="menu-step-adddrop">Open Add/Drop by CRN</a>
+  </article>
+
+  <article class="step-card">
+    <header>
+      <div class="step-number">Step 4</div>
+      <h2>View Student Schedule by Course Section</h2>
+    </header>
+    <p>
+      Display locations, meeting dates, instructors, and any notes attached to your registered sections as well as
+      waitlisted courses in one consolidated view.
+    </p>
+    <a class="step-link" href="{% if term_confirmed %}/schedule{% else %}/select-term?next=schedule{% endif %}" data-test="menu-step-schedule">View Student Schedule</a>
+  </article>
+
+  <article class="step-card">
+    <header>
+      <div class="step-number">Step 5</div>
+      <h2>View Personal Weekly Class Schedule</h2>
+    </header>
+    <p>
+      Review your classes in a weekly calendar grid. Print the schedule or save as PDF to confirm room locations on the
+      first day of class.
+    </p>
+    <a class="step-link" href="{% if term_confirmed %}/schedule-week{% else %}/select-term?next=schedule_week{% endif %}" data-test="menu-step-weekly">Weekly Schedule View</a>
+  </article>
+
+  <article class="step-card">
+    <header>
+      <div class="step-number">Step 6</div>
+      <h2>View Tuition Fee and Legal Status</h2>
+    </header>
+    <p>
+      Verify your status, outstanding balances, and legal statements for the term to avoid late fees or enrollment
+      interruptions.
+    </p>
+    <a class="step-link" href="{% if term_confirmed %}/accounts{% else %}/select-term?next=accounts{% endif %}">Go to Student Accounts</a>
+  </article>
+</section>
+
+{% endblock %}

templates/schedule.html

@@ -0,0 +1,37 @@
+{% extends "base.html" %}
+{% block content %}
+<div class="page-heading">
+  <h1>Student Schedule</h1>
+  {% if term_confirmed %}
+  <span class="term-chip">Term: {{ current_term }}</span>
+  {% endif %}
+</div>
+
+<table>
+  <thead>
+    <tr>
+      <th>CRN</th><th>Subject</th><th>Number</th><th>Title</th><th>Schedule</th><th>Campus</th><th></th>
+    </tr>
+  </thead>
+  <tbody>
+    {% for c in regs %}
+    <tr data-test="schedule-row">
+      <td>{{ c['crn'] }}</td>
+      <td>{{ c['subject'] }}</td>
+      <td>{{ c['number'] }}</td>
+      <td>{{ c['title'] }}</td>
+      <td>{{ c['days'] }} {{ c['time'] }}</td>
+      <td>{{ c['campus'] }}</td>
+      <td>
+        <form method="POST" action="/drop">
+          <input type="hidden" name="crn" value="{{ c['crn'] }}" />
+          <button class="btn btn-danger" data-test="drop-button" type="submit">Drop</button>
+        </form>
+      </td>
+    </tr>
+    {% else %}
+    <tr><td colspan="7">No registered sections.</td></tr>
+    {% endfor %}
+  </tbody>
+</table>
+{% endblock %}

templates/schedule_week.html

@@ -0,0 +1,43 @@
+{% extends "base.html" %}
+{% block content %}
+<div class="page-heading">
+  <h1>Weekly Schedule</h1>
+  {% if term_confirmed %}
+  <span class="term-chip">Term: {{ current_term }}</span>
+  {% endif %}
+</div>
+
+<div class="week-grid">
+  <div class="times">
+    {% for t in time_labels %}
+      <div class="time">{{ t }}</div>
+    {% endfor %}
+  </div>
+  <div class="days">
+    <div class="hdr">
+      <div>Mon</div>
+      <div>Tue</div>
+      <div>Wed</div>
+      <div>Thu</div>
+      <div>Fri</div>
+    </div>
+    <div class="grid-body">
+      {% for col in range(1,6) %}
+      <div class="col">
+        {% for e in events %}
+          {% if e.day_col == col %}
+          <div class="event" style="top: {{ e.top_px }}px; height: {{ e.height_px }}px" data-test="week-event">
+            <div class="event-title">{{ e.title }}</div>
+            <div class="event-sub">{{ e.subtitle }}</div>
+            <div class="event-time">{{ e.time }}</div>
+          </div>
+          {% endif %}
+        {% endfor %}
+      </div>
+      {% endfor %}
+    </div>
+  </div>
+</div>
+
+<p class="muted" style="margin-top:.5rem">Grid spans 08:00–18:00. Events are approximate visualizations.</p>
+{% endblock %}

templates/search.html

@@ -0,0 +1,65 @@
+{% extends "base.html" %}
+{% block content %}
+<div class="page-heading">
+  <h1>Search Class</h1>
+  {% if term_confirmed %}
+  <span class="term-chip">Term: {{ current_term }}</span>
+  {% endif %}
+</div>
+
+<form method="GET" action="/search" class="form-grid">
+  <label>Subject
+    <input data-test="search-subject" type="text" name="subject" value="{{ request.args.get('subject','') }}" placeholder="e.g., COMP" />
+  </label>
+  <label>Number
+    <input data-test="search-number" type="text" name="number" value="{{ request.args.get('number','') }}" placeholder="e.g., 250" />
+  </label>
+  <label>Title contains
+    <input data-test="search-title" type="text" name="title" value="{{ request.args.get('title','') }}" placeholder="e.g., data" />
+  </label>
+  <label>Campus
+    <input data-test="search-campus" type="text" name="campus" value="{{ request.args.get('campus','') }}" placeholder="e.g., Downtown" />
+  </label>
+  <button class="btn btn-primary" data-test="search-button" type="submit">Search</button>
+</form>
+
+<table>
+  <thead>
+    <tr>
+      <th>CRN</th>
+      <th>Subject</th>
+      <th>Number</th>
+      <th>Title</th>
+      <th>Days/Time</th>
+      <th>Campus</th>
+      <th>Seats</th>
+      <th></th>
+    </tr>
+  </thead>
+  <tbody>
+    {% for c in results %}
+    <tr data-test="course-row">
+      <td data-test="course-crn">{{ c['crn'] }}</td>
+      <td>{{ c['subject'] }}</td>
+      <td>{{ c['number'] }}</td>
+      <td>{{ c['title'] }}</td>
+      <td>{{ c['days'] }} {{ c['time'] }}</td>
+      <td>{{ c['campus'] }}</td>
+      <td>
+        <span class="seat-pill {{ 'full' if c['seats_taken']>=c['seats_total'] else 'open' }}">
+          {{ c['seats_taken'] }}/{{ c['seats_total'] }} {{ 'Full' if c['seats_taken']>=c['seats_total'] else 'Open' }}
+        </span>
+      </td>
+      <td>
+        <form method="POST" action="/add">
+          <input type="hidden" name="crn" value="{{ c['crn'] }}" />
+          <button class="btn btn-primary" data-test="add-button" type="submit" {% if c['seats_taken']>=c['seats_total'] %}disabled{% endif %}>Add</button>
+        </form>
+      </td>
+    </tr>
+    {% else %}
+    <tr><td colspan="8">No sections match your search.</td></tr>
+    {% endfor %}
+  </tbody>
+</table>
+{% endblock %}

templates/select_term.html

@@ -0,0 +1,21 @@
+{% extends "base.html" %}
+{% block content %}
+<section class="term-gate">
+  <h1>Select Term</h1>
+  <p>
+    Before continuing to <strong>{{ destination_label }}</strong>, confirm the McGill term you wish to work with.
+  </p>
+  <form method="POST" action="/set-term" class="term-gate-form">
+    <input type="hidden" name="next" value="{{ next_key }}" />
+    <label>
+      Select a Term:
+      <select name="term" required data-test="term-select">
+        {% for t in terms %}
+        <option value="{{ t }}" {% if t==current_term %}selected{% endif %}>{{ t }}</option>
+        {% endfor %}
+      </select>
+    </label>
+    <button class="btn btn-primary" type="submit" data-test="term-submit">Continue</button>
+  </form>
+</section>
+{% endblock %}