spec pipeline updates + doc updates + viewer updates + schema updates + tool additions

backend/app/preview.py

@@ -2,6 +2,7 @@ import json
 
 from app.services.books import parse_books
 from app.services.deterministic import compute_course_type, compute_hours, compute_program
+from app.supabase import supabase
 
 
 def _lines(value) -> list[str]:
@@ -56,7 +57,16 @@ def build_course_preview(row: dict) -> dict:
 
     practical_hours = int(hours["practical_hours"] or 0)
     status = str(row.get("status") or content.get("status") or "")
+
+    objectives = _lines(row.get("objectives") or content.get("objectives"))[:4]
+    course_outcomes = _lines(row.get("course_outcomes") or content.get("course_outcomes"))[:4]
+    units = row.get("units") or content.get("units") or []
+    lab_experiments = _lines(row.get("lab_experiments") or content.get("lab_experiments"))[:10] if practical_hours else []
+    text_books = parse_books(row.get("text_books") or content.get("text_books")) or parse_books(submission.get("text_books"))
+    reference_books = parse_books(row.get("reference_books") or content.get("reference_books")) or parse_books(submission.get("reference_books"))
+    has_content = any([objectives, course_outcomes, units, lab_experiments, text_books, reference_books])
     return {
+        "refined_id": row.get("id"),
         "course_code": str(row.get("course_code") or content.get("course_code") or ""),
         "course_title": str(row.get("course_title") or content.get("course_title") or ""),
         "program": str(program),
@@ -67,15 +77,32 @@ def build_course_preview(row: dict) -> dict:
         "credits": str(hours["credits"]),
         "semester": str(row.get("semester") or content.get("semester") or ""),
         "course_type": str(course_type),
+        "is_elective": bool(row.get("is_elective") or content.get("is_elective") or False),
         "status": status,
-        "render_detail": status != "summary_only",
+        "render_detail": status != "summary_only" and has_content,
         "tools_languages": _text(row.get("tools_languages"), content.get("tools_languages"), submission.get("preferred_tools")),
         "desirable_knowledge": _text(row.get("desirable_knowledge"), content.get("desirable_knowledge")),
         "prelude": row.get("prelude") or content.get("prelude") or "",
-        "objectives": _lines(row.get("objectives") or content.get("objectives"))[:4],
-        "course_outcomes": _lines(row.get("course_outcomes") or content.get("course_outcomes"))[:4],
-        "units": row.get("units") or content.get("units") or [],
-        "lab_experiments": _lines(row.get("lab_experiments") or content.get("lab_experiments"))[:10] if practical_hours else [],
-        "text_books": parse_books(row.get("text_books") or content.get("text_books")) or parse_books(submission.get("text_books")),
-        "reference_books": parse_books(row.get("reference_books") or content.get("reference_books")) or parse_books(submission.get("reference_books")),
+        "objectives": objectives,
+        "course_outcomes": course_outcomes,
+        "units": units,
+        "lab_experiments": lab_experiments,
+        "text_books": text_books,
+        "reference_books": reference_books,
+    }
+
+
+def build_specialization_context(academic_year: str = "") -> dict:
+    """Load specialization tracks and their elective assignments for template rendering.
+
+    academic_year is accepted for forward compatibility (multiple batches) but the
+    current single-batch deployment returns every track. Filtering by an empty or
+    mismatched year would hide all tracks, so we load them all and let the caller
+    scope by semester inside the template.
+    """
+    specs = supabase.table("specialization_definitions").select("*").order("semester").order("letter").execute().data
+    assignments = supabase.table("course_specialization_assignments").select("*").execute().data
+    return {
+        "specializations": specs,
+        "specialization_assignments": assignments,
     }

backend/app/rendering.py

@@ -2,6 +2,7 @@ import re
 from pathlib import Path
 
 from jinja2 import Environment, FileSystemLoader, select_autoescape
+from jinja2.ext import do
 from markupsafe import Markup, escape
 
 APP_DIR = Path(__file__).resolve().parent
@@ -22,7 +23,7 @@ def _find_frontend_dir() -> Path:
 
 
 FRONTEND_DIR = _find_frontend_dir()
-templates = Environment(loader=FileSystemLoader(APP_DIR / "templates"), autoescape=select_autoescape(["html", "xml"]))
+templates = Environment(loader=FileSystemLoader(APP_DIR / "templates"), autoescape=select_autoescape(["html", "xml"]), extensions=[do])
 URL_RE = re.compile(r"https?://[^\s<>()]+")
 YEAR_RE = re.compile(r"\d{4}")
 
@@ -71,3 +72,15 @@ def course_code_for_year(value: str, semester, curriculum_year: str) -> str:
 templates.filters["linkify"] = linkify
 templates.filters["course_code_for_year"] = course_code_for_year
 templates.globals["batch_label"] = batch_label
+
+SEMESTER_NAMES = {
+    "1": "I",
+    "2": "II",
+    "3": "III",
+    "4": "IV",
+    "5": "V",
+    "6": "VI",
+    "7": "VII",
+    "8": "VIII",
+}
+templates.globals["SEMESTER_NAMES"] = SEMESTER_NAMES

backend/app/routes/chat.py

@@ -135,12 +135,13 @@ When the user asks to change the active course, call create_course_draft with th
 When the user asks for changes across multiple courses or an uploaded document, inspect the curriculum or attachment text, then call create_document_draft with the affected courses.
 When the user asks what changed, call diff_course_json or read the relevant draft before answering.
 For broad document requests, use get_curriculum_json to inspect the whole syllabus before proposing edits.
+For specialization management, call list_specializations to discover tracks, define_specialization to create one, and assign_elective_to_tracks / get_course_assignments to categorize electives.
 To fetch a public URL, call fetch_url and use the returned text.
 To search the web for current information, call web_search with a query.
 Never apply a draft, never claim a draft was applied, and never claim the refined database was changed.
 After creating a draft, tell the user to review the diff in the Review panel before applying it.
 After calling a tool, summarize the result for the user in natural language. Do not call another tool — stop and respond to the user.
-Do not change deterministic fields such as program, hours, credits, or course type.
+To change deterministic fields (program, hours, credits, course_type), call update_deterministic_fields. This creates a draft that is blocked until the user explicitly approves it in the Review panel. Confirm with the user before changing these fields.
 
 Course data access — prefer granular tools over full JSON:
 - get_course_codes: lightweight IDs (refined_id, course_code, title, semester) — use for lists/lookups

backend/app/routes/courses.py

@@ -16,11 +16,26 @@ def list_courses():
         rows = attach_submissions(rows)
     except APIError as exc:
         raise database_http_exception(exc) from exc
-    courses = [build_course_preview(row) | {"id": row["id"]} for row in rows]
+    courses = [build_course_preview(row) | {"id": row["id"], "visible": row.get("visible", True)} for row in rows]
     courses.sort(key=lambda item: (int(item.get("semester") or 0), item.get("course_code") or "", item.get("course_title") or ""))
     return {"courses": courses}
 
 
+@router.patch("/courses/{refined_id}/visible")
+def set_visibility(refined_id: int, body: dict):
+    visible = body.get("visible")
+    if not isinstance(visible, bool):
+        raise HTTPException(status_code=400, detail="visible must be a boolean")
+    try:
+        row = first_row(supabase.table("refined_submissions").select("id").eq("id", refined_id).neq("status", "archived"))
+        if not row:
+            raise HTTPException(status_code=404, detail="Course not found")
+        result = supabase.table("refined_submissions").update({"visible": visible}).eq("id", refined_id).execute()
+    except APIError as exc:
+        raise database_http_exception(exc) from exc
+    return {"message": "Visibility updated", "course": result.data[0] if result.data else None}
+
+
 @router.delete("/courses/{refined_id}")
 def delete_course(refined_id: int):
     try:

backend/app/routes/preview.py

@@ -2,7 +2,7 @@ from fastapi import APIRouter, HTTPException, Query
 from fastapi.responses import HTMLResponse, Response
 from weasyprint import HTML
 
-from app.preview import build_course_preview
+from app.preview import build_course_preview, build_specialization_context
 from app.rendering import FRONTEND_DIR, templates
 from app.services.curriculum import attach_submissions, ordered_courses, selected_curriculum_year
 from app.supabase import first_row, supabase
@@ -12,13 +12,13 @@ router = APIRouter()
 
 @router.get("/preview/semester/{sem}/courses")
 def list_courses(sem: int):
-    result = supabase.table("refined_submissions").select("id").neq("status", "archived").eq("semester", sem).order("id").execute()
+    result = supabase.table("refined_submissions").select("id").neq("status", "archived").eq("visible", True).eq("semester", sem).order("id").execute()
     return {"course_ids": [row["id"] for row in result.data]}
 
 
 @router.get("/preview/courses")
 def list_all_courses():
-    result = supabase.table("refined_submissions").select("id,semester,course_code").neq("status", "archived").execute()
+    result = supabase.table("refined_submissions").select("id,semester,course_code").neq("status", "archived").eq("visible", True).execute()
     rows = sorted(result.data, key=lambda row: (int(row.get("semester") or 0), str(row.get("course_code") or ""), int(row.get("id") or 0)))
     return {"course_ids": [row["id"] for row in rows]}
 
@@ -39,7 +39,7 @@ def preview_course(refined_id: int, curriculum_year: str | None = Query(None)):
 
 @router.get("/preview/html")
 def preview_all_html(curriculum_year: str | None = Query(None)):
-    result = supabase.table("refined_submissions").select("*").neq("status", "archived").execute()
+    result = supabase.table("refined_submissions").select("*").neq("status", "archived").eq("visible", True).execute()
     courses = ordered_courses(result.data)
     html = templates.get_template("jinja_sample.html").render(
         courses=courses,
@@ -47,13 +47,14 @@ def preview_all_html(curriculum_year: str | None = Query(None)):
         curriculum_year=selected_curriculum_year(curriculum_year),
         asset_root="/",
         show_summaries=True,
+        **build_specialization_context(selected_curriculum_year(curriculum_year)),
     )
     return HTMLResponse(html, headers={"Cache-Control": "no-store"})
 
 
 @router.get("/preview/pdf")
 def download_all_pdf(download: bool = Query(False), curriculum_year: str | None = Query(None)):
-    result = supabase.table("refined_submissions").select("*").neq("status", "archived").execute()
+    result = supabase.table("refined_submissions").select("*").neq("status", "archived").eq("visible", True).execute()
     courses = ordered_courses(result.data)
     html = templates.get_template("jinja_sample.html").render(
         courses=courses,
@@ -61,6 +62,7 @@ def download_all_pdf(download: bool = Query(False), curriculum_year: str | None
         curriculum_year=selected_curriculum_year(curriculum_year),
         asset_root="",
         show_summaries=True,
+        **build_specialization_context(selected_curriculum_year(curriculum_year)),
     )
     pdf = HTML(string=html, base_url=str(FRONTEND_DIR)).write_pdf()
     return pdf_response(pdf, "curriculum-preview.pdf", download)
@@ -68,7 +70,7 @@ def download_all_pdf(download: bool = Query(False), curriculum_year: str | None
 
 @router.get("/preview/semester/{sem}/pdf")
 def download_pdf(sem: int, download: bool = Query(False), curriculum_year: str | None = Query(None)):
-    result = supabase.table("refined_submissions").select("*").neq("status", "archived").eq("semester", sem).order("id").execute()
+    result = supabase.table("refined_submissions").select("*").neq("status", "archived").eq("visible", True).eq("semester", sem).order("id").execute()
     courses = ordered_courses(result.data)
     html = templates.get_template("jinja_sample.html").render(
         courses=courses,
@@ -76,6 +78,7 @@ def download_pdf(sem: int, download: bool = Query(False), curriculum_year: str |
         curriculum_year=selected_curriculum_year(curriculum_year),
         asset_root="",
         show_summaries=True,
+        **build_specialization_context(selected_curriculum_year(curriculum_year)),
     )
     pdf = HTML(string=html, base_url=str(FRONTEND_DIR)).write_pdf()
     return pdf_response(pdf, f"semester-{sem}.pdf", download)

backend/app/routes/versions.py

@@ -2,7 +2,7 @@ from fastapi import APIRouter, HTTPException, Query
 from fastapi.responses import HTMLResponse
 from postgrest.exceptions import APIError
 
-from app.preview import build_course_preview
+from app.preview import build_course_preview, build_specialization_context
 from app.rendering import templates
 from app.services.curriculum import attach_submissions, DEFAULT_CURRICULUM_YEAR, selected_curriculum_year, update_refined_fields
 from app.services.diffing import diff_course
@@ -218,6 +218,7 @@ def preview_version(version_id: int, diff: bool = Query(False), curriculum_year:
             curriculum_year=selected_curriculum_year(curriculum_year),
             asset_root="/",
             show_summaries=True,
+            **build_specialization_context(selected_curriculum_year(curriculum_year)),
         )
         return HTMLResponse(html, headers={"Cache-Control": "no-store"})
 
@@ -233,8 +234,9 @@ def preview_version(version_id: int, diff: bool = Query(False), curriculum_year:
         if current_course:
             base = dict(current_course)
             proposed = dict(v_course)
-            course_diff = _build_course_diff(base, proposed)
-            course_diffs.append({"base": base, "proposed": proposed, "course_diff": course_diff})
+            course_diff = _build_course_diff(proposed, base)
+            if any(v is not None for v in course_diff.values()):
+                course_diffs.append({"base": base, "proposed": proposed, "course_diff": course_diff})
 
     html = templates.get_template("jinja_diff.html").render(
         course_diffs=course_diffs,

backend/app/services/agent_tools.py

@@ -438,6 +438,109 @@ def _create_curriculum_version(arguments: dict) -> dict:
     return {"version": version}
 
 
+def _define_specialization(arguments: dict) -> dict:
+    semester = _require_int(arguments, "semester")
+    name = str(arguments.get("name") or "").strip()
+    if not name:
+        raise ValueError("name is required")
+    letter = str(arguments.get("letter") or "").strip().upper()
+    if not letter:
+        existing = supabase.table("specialization_definitions").select("letter").eq("semester", semester).execute().data
+        used = {row["letter"] for row in existing}
+        for candidate in "ABCDEFGHIJKLMNOPQRSTUVWXYZ":
+            if candidate not in used:
+                letter = candidate
+                break
+        if not letter:
+            raise ValueError("No free specialization letter available for this semester")
+    academic_year = str(arguments.get("academic_year") or "").strip()
+    key = str(arguments.get("key") or "").strip().upper()
+    if not key:
+        key = name.split("(")[-1].rstrip(")") if "(" in name else name[:3].upper()
+    row = supabase.table("specialization_definitions").insert(
+        {"semester": semester, "letter": letter, "name": name, "key": key, "academic_year": academic_year}
+    ).execute().data[0]
+    return {"specialization": row}
+
+
+def _list_specializations(arguments: dict) -> dict:
+    query = supabase.table("specialization_definitions").select("*")
+    if arguments.get("semester") is not None:
+        query = query.eq("semester", int(arguments["semester"]))
+    return {"specializations": query.order("semester").order("letter").execute().data}
+
+
+def _assign_elective_to_tracks(arguments: dict) -> dict:
+    refined_id = _require_int(arguments, "refined_id")
+    spec_ids = arguments.get("specialization_ids")
+    if not isinstance(spec_ids, list) or not spec_ids:
+        raise ValueError("specialization_ids must be a non-empty array")
+    created = 0
+    for spec_id in spec_ids:
+        existing = (
+            supabase.table("course_specialization_assignments")
+            .select("id")
+            .eq("refined_id", refined_id)
+            .eq("specialization_id", int(spec_id))
+            .execute()
+            .data
+        )
+        if not existing:
+            supabase.table("course_specialization_assignments").insert(
+                {"refined_id": refined_id, "specialization_id": int(spec_id)}
+            ).execute()
+            created += 1
+    supabase.table("refined_submissions").update({"is_elective": True}).eq("id", refined_id).execute()
+    return {"assignments_created": created}
+
+
+def _remove_elective_from_tracks(arguments: dict) -> dict:
+    refined_id = _require_int(arguments, "refined_id")
+    spec_ids = arguments.get("specialization_ids")
+    if not isinstance(spec_ids, list) or not spec_ids:
+        raise ValueError("specialization_ids must be a non-empty array")
+    removed = 0
+    for spec_id in spec_ids:
+        result = (
+            supabase.table("course_specialization_assignments")
+            .delete()
+            .eq("refined_id", refined_id)
+            .eq("specialization_id", int(spec_id))
+            .execute()
+        )
+        removed += len(result.data or [])
+    return {"assignments_removed": removed}
+
+
+def _get_course_assignments(arguments: dict) -> dict:
+    refined_id = _require_int(arguments, "refined_id")
+    assignments = (
+        supabase.table("course_specialization_assignments")
+        .select("*, specialization_definitions(*)")
+        .eq("refined_id", refined_id)
+        .execute()
+        .data
+    )
+    return {"refined_id": refined_id, "assignments": assignments}
+
+
+def _update_deterministic_fields(arguments: dict) -> dict:
+    from app.services.diffing import PROTECTED_FIELDS
+
+    refined_id = _require_int(arguments, "refined_id")
+    fields = _require_dict(arguments, "fields")
+    protected = {key: value for key, value in fields.items() if key in PROTECTED_FIELDS}
+    if not protected:
+        raise ValueError("No deterministic fields provided. Use create_course_draft for other fields.")
+    record = draft_record(refined_id, protected, str(arguments.get("reason") or "Explicit user request to change deterministic fields"))
+    record["status"] = "blocked"
+    draft = supabase.table("agent_drafts").insert(record).execute().data[0]
+    return {
+        "draft": draft,
+        "warning": "This draft modifies deterministic fields (program, hours, credits, course_type). The user must explicitly approve it in the Review panel before it is applied.",
+    }
+
+
 def _signal_done(arguments: dict) -> dict:
     summary = str(arguments.get("summary") or "").strip()
     if not summary:
@@ -636,6 +739,81 @@ TOOLS: dict[str, AgentTool] = {
         },
         _create_curriculum_version,
     ),
+    "define_specialization": AgentTool(
+        "define_specialization",
+        "Create a specialization track (e.g. Machine Intelligence and Data Science) for a given semester. The letter (A, B, C...) is auto-assigned if omitted. Used to set up the elective specialization brackets.",
+        {
+            **OBJECT,
+            "properties": {
+                "semester": {"type": "integer", "minimum": 1, "maximum": 8, "description": "Semester the specialization applies to (5 or 6 for electives)"},
+                "name": {"type": "string", "description": "Full specialization name, e.g. 'Machine Intelligence and Data Science (MIDS)'"},
+                "letter": {"type": "string", "description": "Optional letter label (A, B, C). Auto-assigned if omitted."},
+                "key": {"type": "string", "description": "Optional short key (SCC, MIDS, CSCS). Derived from name if omitted."},
+                "academic_year": {"type": "string", "description": "Optional academic year batch, e.g. 2025-26"},
+            },
+            "required": ["semester", "name"],
+        },
+        _define_specialization,
+    ),
+    "list_specializations": AgentTool(
+        "list_specializations",
+        "List specialization track definitions, optionally filtered by semester. Use to discover which tracks exist before assigning electives.",
+        {
+            **OBJECT,
+            "properties": {"semester": {"type": "integer", "minimum": 1, "maximum": 8}},
+        },
+        _list_specializations,
+    ),
+    "assign_elective_to_tracks": AgentTool(
+        "assign_elective_to_tracks",
+        "Categorize an elective course into one or more specialization tracks by their specialization_id. Also marks the course as an elective. Use after determining (e.g. via AI analysis) which tracks the course belongs to.",
+        {
+            **OBJECT,
+            "properties": {
+                "refined_id": {"type": "integer"},
+                "specialization_ids": {"type": "array", "items": {"type": "integer"}, "description": "Specialization track IDs to assign the elective to"},
+            },
+            "required": ["refined_id", "specialization_ids"],
+        },
+        _assign_elective_to_tracks,
+    ),
+    "remove_elective_from_tracks": AgentTool(
+        "remove_elective_from_tracks",
+        "Remove an elective course from one or more specialization tracks.",
+        {
+            **OBJECT,
+            "properties": {
+                "refined_id": {"type": "integer"},
+                "specialization_ids": {"type": "array", "items": {"type": "integer"}, "description": "Specialization track IDs to remove the elective from"},
+            },
+            "required": ["refined_id", "specialization_ids"],
+        },
+        _remove_elective_from_tracks,
+    ),
+    "get_course_assignments": AgentTool(
+        "get_course_assignments",
+        "Return which specialization tracks a course currently belongs to, including the track definitions.",
+        {
+            **OBJECT,
+            "properties": {"refined_id": {"type": "integer"}},
+            "required": ["refined_id"],
+        },
+        _get_course_assignments,
+    ),
+    "update_deterministic_fields": AgentTool(
+        "update_deterministic_fields",
+        "Create a reviewable draft that changes deterministic/protected fields (program, lecture_hours, tutorial_hours, practical_hours, self_study, credits, course_type). This is the ONLY way to modify those fields. The resulting draft is blocked until the user explicitly approves it in the Review panel. Always confirm with the user before calling this.",
+        {
+            **OBJECT,
+            "properties": {
+                "refined_id": {"type": "integer"},
+                "fields": {"type": "object", "description": "Protected fields to change, e.g. {\"credits\": 5, \"lecture_hours\": 4}"},
+                "reason": {"type": "string"},
+            },
+            "required": ["refined_id", "fields"],
+        },
+        _update_deterministic_fields,
+    ),
     "signal_done": AgentTool(
         "signal_done",
         "Signal that the agent has completed the user's request. Provide a concise summary of what was accomplished. This ends the agent's turn.",

backend/app/services/curriculum.py

@@ -82,7 +82,17 @@ def ordered_courses(rows: list[dict]) -> list[dict]:
     return [build_course_preview(row) for row in rows]
 
 
-def course_sort_key(row: dict) -> tuple[int, int, int]:
+def course_credits(row: dict) -> int:
+    value = row.get("credits")
+    if value not in (None, ""):
+        return int(value)
+    category = str((row.get("_submission") or {}).get("credit_category") or "").strip()
+    if category.isdigit():
+        return int(category)
+    return 0
+
+
+def course_sort_key(row: dict) -> tuple[int, int, int, int]:
     semester = int(row.get("semester") or 0)
     code = str(row.get("course_code") or "").replace(" ", "").upper()
     order = SOURCE_ORDER.get(code)
@@ -90,7 +100,7 @@ def course_sort_key(row: dict) -> tuple[int, int, int]:
         order = elective_order(code, "AA", "AB")
     if order is None and semester == 6:
         order = elective_order(code, "BA", "BB")
-    return semester, order or 900, int(row.get("id") or 0)
+    return semester, -course_credits(row), order or 900, int(row.get("id") or 0)
 
 
 def elective_order(code: str, first_group: str, second_group: str) -> int | None:

backend/app/services/schema.py

@@ -13,6 +13,8 @@ REQUIRED_TABLES = (
     "chat_sessions",
     "chat_messages",
     "chat_attachments",
+    "specialization_definitions",
+    "course_specialization_assignments",
 )
 
 

backend/app/templates/jinja_1_to_8.html

@@ -1,7 +1,3 @@
-{% macro semester_name(value) -%}
-  {{ {"1": "I", "2": "II", "3": "III", "4": "IV", "7": "VII", "8": "VIII"}.get(value|string, value) }}
-{%- endmacro %}
-
 {% macro course_row(course, number) -%}
   <tr>
     <td class="center">{{ number }}</td>
@@ -53,7 +49,7 @@
   {% endfor %}
 
   {% if totals.count %}
-    <h2 class="semester-title">{{ semester_name(summary_semester) }} SEMESTER {{ batch_label(summary_semester, curriculum_year) }}</h2>
+            <h2 class="semester-title">{{ SEMESTER_NAMES[summary_semester|string] }} SEMESTER {{ batch_label(summary_semester, curriculum_year) }}</h2>
     <table class="meta summary-table">
       <colgroup>
         <col class="summary-number" />
@@ -185,7 +181,7 @@
           {% endfor %}
 
           {% if totals.count %}
-            <h2 class="semester-title">{{ semester_name(summary_semester) }} SEMESTER {{ batch_label(summary_semester, curriculum_year) }}</h2>
+            <h2 class="semester-title">{{ SEMESTER_NAMES[summary_semester|string] }} SEMESTER {{ batch_label(summary_semester, curriculum_year) }}</h2>
             <table class="meta summary-table final-year-table">
               <colgroup>
                 <col class="final-number" />

backend/app/templates/jinja_sem_5_6.html

@@ -1,22 +1,18 @@
-{% macro semester_name(value) -%}
-  {{ {"5": "V", "6": "VI"}.get(value|string, value) }}
-{%- endmacro %}
-
 {% macro course_row(course, number) -%}
   {% set code = course.course_code|string|upper|replace(" ", "") %}
   {% set title = course.course_title|string|lower %}
   {% set is_placeholder = code.endswith("X") or title in ["elective i", "elective ii", "elective iii", "elective iv"] %}
   {% set is_no_course = "no course offered" in title %}
-  {% set is_elective = ("AA" in code or "AB" in code or "BA" in code or "BB" in code) and not is_placeholder and not is_no_course %}
+  {% set is_elective = course.is_elective %}
   <tr>
     <td class="center">{{ number }}</td>
     <td>{{ course.course_code | course_code_for_year(course.semester, curriculum_year) }}</td>
     <td>{{ course.course_title }}</td>
-    <td class="center">{% if is_no_course %}{% elif is_elective %}4{% else %}{{ course.lecture_hours }}{% endif %}</td>
-    <td class="center">{% if is_no_course %}{% elif is_elective %}0{% else %}{{ course.tutorial_hours }}{% endif %}</td>
-    <td class="center">{% if is_no_course %}{% elif is_elective %}0{% else %}{{ course.practical_hours }}{% endif %}</td>
-    <td class="center">{% if is_no_course %}{% elif is_elective %}4{% else %}{{ course.self_study }}{% endif %}</td>
-    <td class="center">{% if is_no_course %}{% elif is_elective %}4{% else %}{{ course.credits }}{% endif %}</td>
+    <td class="center">{% if is_no_course %}{% elif is_placeholder %}{% else %}{{ course.lecture_hours }}{% endif %}</td>
+    <td class="center">{% if is_no_course %}{% elif is_placeholder %}{% else %}{{ course.tutorial_hours }}{% endif %}</td>
+    <td class="center">{% if is_no_course %}{% elif is_placeholder %}{% else %}{{ course.practical_hours }}{% endif %}</td>
+    <td class="center">{% if is_no_course %}{% elif is_placeholder %}{% else %}{{ course.self_study }}{% endif %}</td>
+    <td class="center">{% if is_no_course %}{% elif is_placeholder %}{% else %}{{ course.credits }}{% endif %}</td>
     <td>{{ course.tools_languages }}</td>
     <td>{% if is_no_course %}{% elif is_elective or is_placeholder %}Elective Course{% else %}{{ course.course_type }}{% endif %}</td>
   </tr>
@@ -26,10 +22,39 @@
   {% if total != credit_total %}{{ credit_total }}/{{ total }}{% else %}{{ total }}{% endif %}
 {%- endmacro %}
 
-{% macro specialization_codes(codes, summary_semester, curriculum_year) -%}
-  {% for code in codes %}
-    <p>{{ ("UE00CS" ~ code) | course_code_for_year(summary_semester, curriculum_year) }}</p>
+{% macro spec_codes_for(spec, summary_semester) -%}
+  {% set first = [] %}
+  {% set second = [] %}
+  {% for assign in specialization_assignments|default([]) %}
+    {% if assign.specialization_id == spec.id %}
+      {% for c in course_list %}
+        {% set code = c.course_code|string|upper|replace(" ", "") %}
+        {% set title = c.course_title|string|lower %}
+        {% set is_placeholder = code.endswith("X") or title in ["elective i", "elective ii", "elective iii", "elective iv"] %}
+        {% set is_no_course = "no course offered" in title %}
+        {% if c.refined_id|string == assign.refined_id|string
+              and c.semester|string == summary_semester|string
+              and c.is_elective
+              and not is_placeholder
+              and not is_no_course %}
+          {% set adjusted = c.course_code | course_code_for_year(c.semester, curriculum_year) %}
+          {% if (summary_semester == 5 and "AA" in code) or (summary_semester == 6 and "BA" in code) %}
+            {% do first.append(adjusted) %}
+          {% elif (summary_semester == 5 and "AB" in code) or (summary_semester == 6 and "BB" in code) %}
+            {% do second.append(adjusted) %}
+          {% else %}
+            {% do first.append(adjusted) %}
+          {% endif %}
+        {% endif %}
+      {% endfor %}
+    {% endif %}
   {% endfor %}
+  <tr>
+    <td class="center">{{ spec.letter }}</td>
+    <td>{{ spec.name }}</td>
+    <td>{% for code in first %}<p>{{ code }}</p>{% endfor %}</td>
+    <td>{% for code in second %}<p>{{ code }}</p>{% endfor %}</td>
+  </tr>
 {%- endmacro %}
 
 {% set requested_semester = semester|string if semester is defined and semester else "" %}
@@ -39,11 +64,9 @@
     {% for summary_course in course_list %}
       {% set code = summary_course.course_code|string|upper|replace(" ", "") %}
       {% set title = summary_course.course_title|string|lower %}
-      {% set course_type = summary_course.course_type|string|lower %}
       {% set is_placeholder = code.endswith("X") or title in ["elective i", "elective ii", "elective iii", "elective iv"] %}
-      {% set has_elective_code = "AA" in code or "AB" in code or "BA" in code or "BB" in code %}
-      {% set is_actual_elective = has_elective_code and not is_placeholder %}
-      {% if summary_course.semester|string == summary_semester|string and not is_actual_elective %}
+      {% set is_no_course = "no course offered" in title %}
+      {% if summary_course.semester|string == summary_semester|string and not summary_course.is_elective and not is_placeholder and not is_no_course %}
         {% set credit_value = summary_course.credits|int %}
         {% set totals.count = totals.count + 1 %}
         {% set totals.lecture = totals.lecture + summary_course.lecture_hours|int %}
@@ -56,23 +79,24 @@
         {% endif %}
       {% endif %}
     {% endfor %}
+    {% set placeholder_names = ["Elective I", "Elective II"] if summary_semester == 5 else ["Elective III", "Elective IV"] %}
+    {% set has_real_courses = totals.count > 0 %}
+    {% if has_real_courses %}
+      {% set totals.count = totals.count + placeholder_names|length %}
+      {% set totals.credits = totals.credits + placeholder_names|length * 4 %}
+    {% endif %}
 
     {% set elective_a = namespace(count=0) %}
     {% set elective_b = namespace(count=0) %}
     {% for summary_course in course_list %}
       {% set code = summary_course.course_code|string|upper|replace(" ", "") %}
       {% set title = summary_course.course_title|string|lower %}
-      {% set course_type = summary_course.course_type|string|lower %}
       {% set is_placeholder = code.endswith("X") or title in ["elective i", "elective ii", "elective iii", "elective iv"] %}
-      {% set is_elective = not is_placeholder %}
-      {% if summary_course.semester|string == summary_semester|string and is_elective %}
-        {% if summary_semester == 5 and "AA" in code %}
+      {% set is_no_course = "no course offered" in title %}
+      {% if summary_course.semester|string == summary_semester|string and summary_course.is_elective and not is_placeholder and not is_no_course %}
+        {% if (summary_semester == 5 and "AA" in code) or (summary_semester == 6 and "BA" in code) %}
           {% set elective_a.count = elective_a.count + 1 %}
-        {% elif summary_semester == 5 and "AB" in code %}
-          {% set elective_b.count = elective_b.count + 1 %}
-        {% elif summary_semester == 6 and "BA" in code %}
-          {% set elective_a.count = elective_a.count + 1 %}
-        {% elif summary_semester == 6 and "BB" in code %}
+        {% elif (summary_semester == 5 and "AB" in code) or (summary_semester == 6 and "BB" in code) %}
           {% set elective_b.count = elective_b.count + 1 %}
         {% endif %}
       {% endif %}
@@ -84,7 +108,7 @@
           <img class="seal" src="{{ asset_root | default('') }}images/image2.png" alt="PES University logo" />
           <img class="wordmark" src="{{ asset_root | default('') }}images/image1.png" alt="PES University" />
         </header>
-        <h2 class="semester-title">{{ semester_name(summary_semester) }} SEMESTER {{ batch_label(summary_semester, curriculum_year) }}</h2>
+        <h2 class="semester-title">{{ SEMESTER_NAMES[summary_semester|string] }} SEMESTER {{ batch_label(summary_semester, curriculum_year) }}</h2>
 
         {% if totals.count %}
           <table class="meta summary-table">
@@ -121,15 +145,30 @@
               {% for summary_course in course_list %}
                 {% set code = summary_course.course_code|string|upper|replace(" ", "") %}
                 {% set title = summary_course.course_title|string|lower %}
-                {% set course_type = summary_course.course_type|string|lower %}
                 {% set is_placeholder = code.endswith("X") or title in ["elective i", "elective ii", "elective iii", "elective iv"] %}
-                {% set has_elective_code = "AA" in code or "AB" in code or "BA" in code or "BB" in code %}
-                {% set is_actual_elective = has_elective_code and not is_placeholder %}
-                {% if summary_course.semester|string == summary_semester|string and not is_actual_elective %}
+                {% set is_no_course = "no course offered" in title %}
+                {% if summary_course.semester|string == summary_semester|string and not summary_course.is_elective and not is_placeholder and not is_no_course %}
                   {{ course_row(summary_course, row.number) }}
                   {% set row.number = row.number + 1 %}
                 {% endif %}
               {% endfor %}
+              {% if has_real_courses %}
+              {% for pname in placeholder_names %}
+                <tr>
+                  <td class="center">{{ row.number }}</td>
+                  <td></td>
+                  <td>{{ pname }}</td>
+                  <td class="center"></td>
+                  <td class="center"></td>
+                  <td class="center"></td>
+                  <td class="center"></td>
+                  <td class="center">4</td>
+                  <td></td>
+                  <td>Elective Course</td>
+                </tr>
+                {% set row.number = row.number + 1 %}
+              {% endfor %}
+              {% endif %}
               <tr>
                 <th colspan="3" class="center">Total</th>
                 <td class="center">{{ total_cell(totals.lecture, totals.lecture_credit) }}</td>
@@ -145,6 +184,8 @@
         {% endif %}
 
         {% for group in ["a", "b"] %}
+          {% set group_count = elective_a.count if group == "a" else elective_b.count %}
+          {% if group_count %}
             <table class="meta summary-table">
               <colgroup>
                 <col class="summary-number" />
@@ -172,38 +213,27 @@
                 {% for summary_course in course_list %}
                   {% set code = summary_course.course_code|string|upper|replace(" ", "") %}
                   {% set title = summary_course.course_title|string|lower %}
-                  {% set course_type = summary_course.course_type|string|lower %}
                   {% set is_placeholder = code.endswith("X") or title in ["elective i", "elective ii", "elective iii", "elective iv"] %}
-                  {% set is_elective = not is_placeholder %}
+                  {% set is_no_course = "no course offered" in title %}
                   {% set is_group_a = (summary_semester == 5 and "AA" in code) or (summary_semester == 6 and "BA" in code) %}
                   {% set is_group_b = (summary_semester == 5 and "AB" in code) or (summary_semester == 6 and "BB" in code) %}
-                  {% if summary_course.semester|string == summary_semester|string and is_elective and ((group == "a" and is_group_a) or (group == "b" and is_group_b)) %}
+                  {% if summary_course.semester|string == summary_semester|string and summary_course.is_elective and not is_placeholder and not is_no_course and ((group == "a" and is_group_a) or (group == "b" and is_group_b)) %}
                     {{ course_row(summary_course, row.number) }}
                     {% set row.number = row.number + 1 %}
                   {% endif %}
                 {% endfor %}
               </tbody>
             </table>
+          {% endif %}
         {% endfor %}
 
-        {% if summary_semester in [5, 6] %}
-          {% if summary_semester == 5 %}
-            {% set first_label = "Elective-I" %}
-            {% set second_label = "Elective-II" %}
-            {% set specializations = [
-              {"letter": "A", "name": "System and Core Computing (SCC)", "first": ["342AA1", "342AA8", "342AA9"], "second": ["343AB1", "343AB2", "343AB3", "343AB4", "343AB8"]},
-              {"letter": "B", "name": "Machine Intelligence and Data Science (MIDS)", "first": ["342AA2", "342AA5", "342AA6", "342AA8"], "second": ["343AB1", "342AB2", "342AB7"]},
-              {"letter": "C", "name": "Cyber Security and Connected Systems (CSCS)", "first": ["342AA3", "342AA4", "342AA5", "342AA7"], "second": ["343AB5", "342AB6", "342AB7"]},
-            ] %}
-          {% else %}
-            {% set first_label = "Elective-III" %}
-            {% set second_label = "Elective-IV" %}
-            {% set specializations = [
-              {"letter": "A", "name": "System and Core Computing (SCC)", "first": ["342BA1", "342BA2", "342BA3"], "second": ["343BB1", "343BB3", "343BB5", "343BB10"]},
-              {"letter": "B", "name": "Machine Intelligence and Data Science (MIDS)", "first": ["342BA2", "342BA3", "342BA4", "342BA7", "342BA10"], "second": ["343BB2", "343BB4", "343BB7", "343BB9", "343BB10"]},
-              {"letter": "C", "name": "Cyber Security and Connected Systems (CSCS)", "first": ["342BA5", "342BA6", "342BA7", "342BA8"], "second": ["343BB6", "343BB7", "343BB8", "343BB9", "343BB11", "343BB12"]},
-            ] %}
+        {% set semester_specs = [] %}
+        {% for spec in specializations|default([]) %}
+          {% if spec.semester|string == summary_semester|string %}
+            {% do semester_specs.append(spec) %}
           {% endif %}
+        {% endfor %}
+        {% if semester_specs %}
           <table class="meta summary-table specialization-table">
             <colgroup>
               <col class="summary-number" />
@@ -218,16 +248,11 @@
               <tr>
                 <th class="center">Sl. No.</th>
                 <th>Specialization</th>
-                <th>{{ first_label }}</th>
-                <th>{{ second_label }}</th>
+                <th>{{ "Elective-I" if summary_semester == 5 else "Elective-III" }}</th>
+                <th>{{ "Elective-II" if summary_semester == 5 else "Elective-IV" }}</th>
               </tr>
-              {% for specialization in specializations %}
-                <tr>
-                  <td class="center">{{ specialization.letter }}</td>
-                  <td>{{ specialization.name }}</td>
-                  <td>{{ specialization_codes(specialization.first, summary_semester, curriculum_year) }}</td>
-                  <td>{{ specialization_codes(specialization.second, summary_semester, curriculum_year) }}</td>
-                </tr>
+              {% for spec in semester_specs %}
+                {{ spec_codes_for(spec, summary_semester) }}
               {% endfor %}
             </tbody>
           </table>

docs/index.md

@@ -163,6 +163,12 @@ The templates compose like this:
 WeasyPrint turns the rendered HTML into PDF for the `/preview/pdf` and
 `/preview/semester/{sem}/pdf` endpoints.
 
+Course ordering within a semester is set by `course_sort_key` in
+`services/curriculum.py`: courses sort by credits descending (5 before 4 before 2
+before 0), then by the explicit `SOURCE_ORDER` position (or the `elective_order`
+suffix rule for semesters 5/6), then by database id. Courses with `visible = false`
+are excluded from all rendered output.
+
 ### 4. Specialization System (dynamic)
 
 Specialization brackets and elective membership are fully data-driven.
@@ -323,8 +329,12 @@ Run `docs/schema.sql` in the Supabase SQL editor. Required tables:
 
 Key columns on `refined_submissions`: `course_code, course_title, semester,
 credit_category, program, lecture_hours, tutorial_hours, practical_hours, self_study,
-credits, course_type, is_elective, units (jsonb), objectives/text_books/… (arrays),
-status`.
+credits, course_type, is_elective, visible, units (jsonb), objectives/text_books/…
+(arrays), status`.
+
+`visible` (default `true`) controls whether a course renders in preview/PDF output.
+Toggle it from the course management page. Hidden courses stay in the database and
+remain editable but are excluded from every rendered document.
 
 Verify with `GET /api/health/schema`.
 
@@ -431,5 +441,5 @@ Either is fine; keep it isolated so it does not block the submission response.
 Templates live in `backend/app/templates/`. They receive context built in
 `services/preview.py` + the route. Prefer adding data to `build_course_preview` /
 `build_specialization_context` over hardcoding anything in HTML. The `do` extension
-is enabled, so mutable `{% set x = [] %}{% do x.append(...) %}` works. Always read
+is enabled, so mutable {% raw %}`{% set x = [] %}{% do x.append(...) %}`{% endraw %} works. Always read
 list context through `|default([])` so a missing key never crashes rendering.

docs/schema.sql

@@ -34,6 +34,7 @@ create table if not exists refined_submissions (
   credits int not null default 0,
   course_type text not null default '',
   is_elective boolean not null default false,
+  visible boolean not null default true,
   units jsonb not null default '[]'::jsonb,
   objectives text not null default '',
   course_outcomes text not null default '',

frontend/auth/index.html

@@ -3,6 +3,7 @@
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <link rel="icon" type="image/png" href="../images/SE1128.png" />
     <title>Sign In - PESU Curriculum Automation</title>
     <link rel="stylesheet" href="../shared.css" />
     <link rel="stylesheet" href="auth.css" />

frontend/courses/courses.css

@@ -99,6 +99,18 @@ th {
   background: #f8fafc;
 }
 
+td.center {
+  text-align: center;
+}
+
+.hidden-row {
+  opacity: 0.5;
+}
+
+.hidden-row td:not(.center) {
+  text-decoration: line-through;
+}
+
 .details {
   display: grid;
   gap: 8px;

frontend/courses/courses.js

@@ -1,4 +1,5 @@
 const semester = document.getElementById("semester");
+const visibility = document.getElementById("visibility");
 const search = document.getElementById("search");
 const statusText = document.getElementById("status");
 const table = document.getElementById("course-table");
@@ -19,6 +20,8 @@ function cell(text) {
 function courseMatches(course) {
   const query = search.value.trim().toLowerCase();
   if (semester.value && String(course.semester) !== semester.value) return false;
+  if (visibility.value === "visible" && course.visible === false) return false;
+  if (visibility.value === "hidden" && course.visible !== false) return false;
   if (!query) return true;
   return `${course.course_code} ${course.course_title}`.toLowerCase().includes(query);
 }
@@ -26,7 +29,7 @@ function courseMatches(course) {
 function detailsRow(course) {
   const row = document.createElement("tr");
   const td = document.createElement("td");
-  td.colSpan = 5;
+  td.colSpan = 6;
   const details = document.createElement("div");
   details.className = "details";
   details.append(
@@ -54,7 +57,7 @@ function render() {
   if (!visible.length) {
     const row = document.createElement("tr");
     const td = document.createElement("td");
-    td.colSpan = 5;
+    td.colSpan = 6;
     td.className = "empty";
     td.textContent = "No courses found.";
     row.appendChild(td);
@@ -65,9 +68,20 @@ function render() {
 
   visible.forEach((course) => {
     const row = document.createElement("tr");
-    row.className = "course-row";
+    row.className = course.visible === false ? "course-row hidden-row" : "course-row";
     row.append(cell(course.semester), cell(course.course_code), cell(course.course_title), cell(course.credits));
 
+    const visibleCell = document.createElement("td");
+    visibleCell.className = "center";
+    const toggle = document.createElement("input");
+    toggle.type = "checkbox";
+    toggle.checked = course.visible !== false;
+    toggle.title = "Include in rendered documents";
+    toggle.addEventListener("click", (event) => event.stopPropagation());
+    toggle.addEventListener("change", () => setVisibility(course, toggle));
+    visibleCell.appendChild(toggle);
+    row.appendChild(visibleCell);
+
     const action = document.createElement("td");
     const remove = document.createElement("button");
     remove.type = "button";
@@ -90,6 +104,23 @@ function render() {
   setStatus(`${visible.length} course${visible.length === 1 ? "" : "s"}.`, "ready");
 }
 
+async function setVisibility(course, toggle) {
+  const next = toggle.checked;
+  setStatus("Updating visibility...");
+  const response = await fetch(`/api/courses/${course.id}/visible`, {
+    method: "PATCH",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ visible: next }),
+  });
+  if (!response.ok) {
+    toggle.checked = !next;
+    setStatus("Unable to update visibility.", "error");
+    return;
+  }
+  course.visible = next;
+  render();
+}
+
 async function deleteCourse(course) {
   if (!confirm(`Delete ${course.course_code || course.course_title}?`)) return;
   setStatus("Deleting course...");
@@ -110,6 +141,7 @@ async function loadCourses() {
 }
 
 semester.addEventListener("change", render);
+visibility.addEventListener("change", render);
 search.addEventListener("input", render);
 
 loadCourses().catch((error) => {

frontend/courses/index.html

@@ -3,6 +3,7 @@
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <link rel="icon" type="image/png" href="../images/SE1128.png" />
     <title>Course Management</title>
     <link rel="stylesheet" href="courses.css" />
     <script src="courses.js" defer></script>
@@ -33,6 +34,11 @@
             <option value="7">Semester 7</option>
             <option value="8">Semester 8</option>
           </select>
+          <select id="visibility" aria-label="Visibility">
+            <option value="">All courses</option>
+            <option value="visible">Visible only</option>
+            <option value="hidden">Hidden only</option>
+          </select>
           <input id="search" type="search" aria-label="Search courses" />
           <span class="status-line" id="status"></span>
         </div>
@@ -45,6 +51,7 @@
                 <th>Code</th>
                 <th>Course</th>
                 <th>Credits</th>
+                <th>Visible</th>
                 <th></th>
               </tr>
             </thead>

frontend/form/form.css

@@ -1,101 +1,157 @@
 @import "../shared.css";
 
+*, *::before, *::after {
+  box-sizing: border-box;
+  margin: 0;
+  padding: 0;
+}
+
+:root {
+  --bg: var(--page-bg);
+  --text: var(--pesu-blue);
+  --text-secondary: #5a6b8a;
+  --accent: var(--pesu-orange);
+  --accent-hover: #e05e00;
+  --optional: #8a9bb5;
+}
+
+body {
+  font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
+  background: var(--bg);
+  color: var(--text);
+  line-height: 1.6;
+  min-height: 100dvh;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  padding: 1rem;
+}
+
 .container {
-  max-width: 720px;
-  margin: 40px auto;
-  padding: 0 16px;
+  width: 100%;
+  max-width: 640px;
 }
 
 .card {
   background: var(--surface);
   border: 1px solid var(--border);
   border-radius: 12px;
-  padding: 32px;
-  box-shadow: 0 4px 24px rgba(0, 55, 123, 0.06);
+  padding: 2rem;
 }
 
-.card h1 {
-  margin: 0 0 8px;
-  font-size: 28px;
+h1 {
+  font-size: 1.5rem;
   font-weight: 700;
-  color: var(--pesu-blue);
+  margin-bottom: 0.25rem;
 }
 
 .subtitle {
-  margin: 0 0 24px;
-  color: var(--muted);
-  font-size: 14px;
+  color: var(--text-secondary);
+  font-size: 0.875rem;
+  margin-bottom: 1.5rem;
 }
 
 fieldset {
   border: none;
-  padding: 0;
-  margin: 0 0 24px;
+  margin-bottom: 1.5rem;
 }
 
 legend {
-  font-size: 14px;
   font-weight: 600;
-  color: var(--pesu-blue);
-  margin-bottom: 12px;
-  padding-bottom: 4px;
-  border-bottom: 2px solid var(--pesu-blue);
+  font-size: 1.125rem;
+  margin-bottom: 1rem;
+  padding-bottom: 0.5rem;
+  border-bottom: 1px solid var(--border);
+  width: 100%;
 }
 
 label {
   display: block;
-  font-size: 13px;
+  font-size: 0.875rem;
   font-weight: 500;
-  color: var(--text);
-  margin-bottom: 6px;
-}
-
-.optional {
-  font-weight: 400;
-  color: var(--muted);
-  font-size: 12px;
+  margin-top: 1rem;
+  margin-bottom: 0.25rem;
 }
 
-input[type="email"],
-input[type="text"],
-textarea {
+input, select, textarea {
   width: 100%;
-  box-sizing: border-box;
-  border: 1px solid var(--border-strong);
-  border-radius: 6px;
-  padding: 10px 12px;
-  font: 14px/1.4 Arial, sans-serif;
-  color: var(--text);
-  background: var(--surface);
-  transition: border-color 0.15s, box-shadow 0.15s;
+  font-family: inherit;
+  background-color: var(--surface);
+  transition: border-color 0.15s;
 }
 
-input:focus,
-textarea:focus {
+input:focus, select:focus, textarea:focus {
   outline: none;
-  border-color: var(--pesu-blue);
-  box-shadow: 0 0 0 3px rgba(0, 55, 123, 0.12);
+  border-color: var(--accent);
 }
 
 textarea {
   resize: vertical;
-  min-height: 100px;
 }
 
 .hint {
   display: block;
-  margin-top: 4px;
-  font-size: 12px;
-  color: var(--muted);
+  font-size: 0.75rem;
+  color: var(--text-secondary);
+  margin-top: 0.25rem;
+}
+
+.optional {
+  color: var(--optional);
+  font-weight: 400;
+  font-size: 0.75rem;
+}
+
+button {
+  width: 100%;
+  padding: 0.625rem;
+  border: none;
+  border-radius: 6px;
+  background: var(--accent);
+  color: var(--bg);
+  font-size: 0.875rem;
+  font-weight: 600;
+  cursor: pointer;
+  margin-top: 1rem;
+  transition: background 0.15s;
+}
+
+button:hover {
+  background: var(--accent-hover);
+}
+
+button:disabled {
+  opacity: 0.5;
+  cursor: not-allowed;
+}
+
+#result {
+  margin-top: 1rem;
+  padding: 1rem;
+  border-radius: 6px;
+  font-size: 0.875rem;
+  white-space: pre-wrap;
+}
+
+#result.success {
+  background: var(--success-bg);
+  color: var(--success);
+  border: 1px solid var(--success);
+}
+
+#result.error {
+  background: var(--error-bg);
+  color: var(--error);
+  border: 1px solid var(--error);
 }
 
 .code-preview {
-  margin-top: 8px;
-  padding: 12px;
+  margin-top: 0.5rem;
+  padding: 0.75rem;
   background: #f0f4f8;
   border: 1px solid var(--border);
   border-radius: 8px;
-  font-size: 13px;
+  font-size: 0.8125rem;
   color: var(--text);
 }
 
@@ -105,15 +161,15 @@ textarea {
 
 .code-preview strong {
   display: block;
-  margin-bottom: 8px;
-  color: var(--pesu-blue);
+  margin-bottom: 0.5rem;
+  color: var(--accent);
 }
 
 .badge {
   display: inline-block;
   padding: 2px 8px;
   margin: 2px 4px 2px 0;
-  font-size: 11px;
+  font-size: 0.6875rem;
   font-weight: 600;
   border-radius: 4px;
   background: var(--pesu-blue);
@@ -124,60 +180,20 @@ textarea {
   background: var(--pesu-orange);
 }
 
-button[type="submit"] {
-  width: 100%;
-  padding: 14px;
-  font-size: 15px;
-  font-weight: 600;
-  color: white;
-  background: var(--pesu-blue);
-  border: none;
-  border-radius: 8px;
-  cursor: pointer;
-  transition: background 0.15s;
-}
-
-button[type="submit"]:hover:not(:disabled) {
-  background: #002d66;
-}
-
-button[type="submit"]:disabled {
-  opacity: 0.6;
-  cursor: not-allowed;
-}
-
-#result {
-  margin-top: 16px;
-  padding: 14px;
-  border-radius: 8px;
-  font-size: 14px;
-  text-align: center;
-}
-
-#result.hidden {
+.hidden {
   display: none;
 }
 
-#result.error {
-  background: var(--error-bg);
-  color: var(--error);
-  border: 1px solid var(--error);
-}
-
-#result.success {
-  background: var(--success-bg);
-  color: var(--success);
-  border: 1px solid var(--success);
-}
-
 .form-link {
-  display: inline-block;
-  margin-top: 16px;
-  font-size: 14px;
-  color: var(--pesu-blue);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  margin-top: 8px;
+  color: var(--text);
+  font-size: 13px;
   text-decoration: none;
 }
 
 .form-link:hover {
-  text-decoration: underline;
-}
+  color: var(--accent);
+}

frontend/form/form.js

@@ -27,8 +27,7 @@ function parseCode(code) {
   const offering = DEPT_OFFERING[dept] || "CS";
   const target = DEPT_TARGET[dept] || "CSE";
   let credit = "4";
-  if (suffix === "A" || suffix === "B") credit = "4";
-  else if (suffix === "A*" || suffix === "B*") credit = "0";
+  if (suffix === "A*" || suffix === "B*") credit = "0";
   else if (suffix.endsWith("XX") || suffix.endsWith("AX") || suffix.endsWith("BX") || ["AXX","ABX","BAX","BBX"].includes(suffix)) credit = "5";
   const isLateral = suffix.includes("*");
   return { year, dept, semester, offering, target, credit, isLateral, baseCode: c };

frontend/form/index.html

@@ -3,6 +3,7 @@
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <link rel="icon" type="image/png" href="../images/SE1128.png" />
     <title>Course Submission - PESU</title>
     <link rel="stylesheet" href="form.css" />
     <script src="form.js" defer></script>

frontend/index.html

@@ -3,6 +3,7 @@
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <link rel="icon" type="image/png" href="images/SE1128.png" />
     <title>PESU Curriculum Automation</title>
     <link rel="stylesheet" href="home/home.css" />
   </head>

frontend/live-editor/index.html

@@ -3,6 +3,7 @@
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <link rel="icon" type="image/png" href="../images/SE1128.png" />
     <title>Live Editor - PESU</title>
     <link rel="stylesheet" href="live-editor.css" />
   </head>
@@ -34,6 +35,15 @@
         <button id="restore-version" type="button">Restore</button>
       </div>
 
+      <div class="toolbar-group layout-controls">
+        <button id="toggle-pane" type="button" class="icon-btn" title="Expand chat / collapse preview">
+          <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">
+            <rect x="3" y="4" width="18" height="16" rx="2" />
+            <line x1="14" y1="4" x2="14" y2="20" />
+          </svg>
+        </button>
+      </div>
+
       <div class="toolbar-group auth-controls">
         <button id="logout-btn" type="button" class="icon-btn" title="Sign Out">
           <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">

frontend/live-editor/live-editor.css

@@ -43,9 +43,9 @@ select,
 input,
 button,
 a {
-  height: 34px;
+  height: 36px;
   border: 1px solid #9ca3af;
-  border-radius: 4px;
+  border-radius: 6px;
   background-color: #fff;
   color: #111827;
   font-size: 14px;
@@ -53,8 +53,7 @@ a {
 
 select {
   min-width: 150px;
-  max-width: 280px;
-  background-color: #f8fafc;
+  background-color: var(--surface);
   appearance: none;
   background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='12' height='12' viewBox='0 0 24 24' fill='none' stroke='%236b7280' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpolyline points='6 9 12 15 18 9'%3E%3C/polyline%3E%3C/svg%3E");
   background-repeat: no-repeat;
@@ -62,6 +61,11 @@ select {
   background-size: 14px;
   padding-right: 28px;
   cursor: pointer;
+  transition: border-color 0.15s;
+}
+
+select:hover {
+  border-color: #6b7280;
 }
 
 button {
@@ -216,6 +220,11 @@ button:disabled {
   gap: 12px;
   min-height: 0;
   padding: 12px;
+  transition: grid-template-columns 0.18s ease;
+}
+
+.workspace.chat-focus {
+  grid-template-columns: minmax(0, 1fr) minmax(360px, 1.5fr);
 }
 
 .preview-pane,
@@ -335,6 +344,12 @@ iframe {
   color: #00377b;
 }
 
+.icon-btn.active {
+  background: #00377b;
+  border-color: #00377b;
+  color: #fff;
+}
+
 .chat-log {
   min-height: 0;
   overflow: auto;

frontend/live-editor/live-editor.js

@@ -38,6 +38,7 @@ const reviewSummary = document.getElementById("review-summary");
 const diffView = document.getElementById("diff-view");
 const previewDraft = document.getElementById("preview-draft");
 const applyDraft = document.getElementById("apply-draft");
+const togglePane = document.getElementById("toggle-pane");
 const logoutBtn = document.getElementById("logout-btn");
 let activeCourseId = "";
 let activeDraftId = "";
@@ -765,6 +766,14 @@ async function loadSemester(sem) {
 chatTab.addEventListener("click", () => setTab("chat"));
 fieldsTab.addEventListener("click", () => setTab("fields"));
 reviewTab.addEventListener("click", () => setTab("review"));
+if (togglePane) {
+  togglePane.addEventListener("click", () => {
+    const workspace = document.querySelector(".workspace");
+    const focused = workspace.classList.toggle("chat-focus");
+    togglePane.title = focused ? "Collapse chat / expand preview" : "Expand chat / collapse preview";
+    togglePane.classList.toggle("active", focused);
+  });
+}
 viewer.addEventListener("load", () => loading.classList.remove("active"));
 preview.addEventListener("click", () => {
   if (viewer.src && viewer.src !== "about:blank") viewer.src = viewer.src;

frontend/preview/index.html

@@ -3,6 +3,7 @@
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width,initial-scale=1.0" />
+    <link rel="icon" type="image/png" href="../images/SE1128.png" />
     <title>Curriculum Preview</title>
     <link rel="stylesheet" href="preview.css" />
   </head>

frontend/versions/index.html

@@ -3,6 +3,7 @@
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <link rel="icon" type="image/png" href="../images/SE1128.png" />
     <title>Curriculum Versions</title>
     <link rel="stylesheet" href="versions.css" />
     <script src="/shared/auth-guard.js"></script>

frontend/versions/versions.js

@@ -166,7 +166,7 @@ async function loadVersions() {
 function loadVersion(versionId) {
   activeVersionId = String(versionId);
   versionList.querySelectorAll(".tree-item").forEach((el) => el.classList.toggle("active", el.dataset.versionId === String(versionId)));
-  viewer.src = `/api/versions/${versionId}/preview?diff=1`;
+  viewer.src = `/api/versions/${versionId}/preview?diff=1&_t=${Date.now()}`;
   openEditor.href = `/live-editor/?version=${versionId}`;
   openEditor.hidden = false;
   setStatus(`Viewing diff for snapshot ${versionId}`);

tests/test_preview.py

@@ -1,8 +1,46 @@
 from app.preview import build_course_preview
 from app.rendering import templates
-from app.services.curriculum import ordered_courses
+from app.services.curriculum import course_credits, ordered_courses
 
 
+# ---------------------------------------------------------------------------
+# _course helper
+# ---------------------------------------------------------------------------
+
+def _course(**values):
+    course = {
+        "course_code": "",
+        "course_title": "",
+        "program": "B. TECH",
+        "lecture_hours": "4",
+        "tutorial_hours": "0",
+        "practical_hours": "0",
+        "self_study": "4",
+        "credits": "4",
+        "semester": "5",
+        "course_type": "Core Course",
+        "tools_languages": "",
+        "desirable_knowledge": "",
+        "prelude": "",
+        "objectives": [],
+        "course_outcomes": [],
+        "units": [],
+        "lab_experiments": [],
+        "text_books": [],
+        "reference_books": [],
+        "is_elective": False,
+        "status": "refined",
+        "render_detail": True,
+        "refined_id": 1,
+    }
+    course.update(values)
+    return course
+
+
+# ---------------------------------------------------------------------------
+# build_course_preview: deterministic fields
+# ---------------------------------------------------------------------------
+
 def test_preview_uses_submission_deterministic_fields():
     row = {
         "course_title": "Data Structures",
@@ -12,7 +50,6 @@ def test_preview_uses_submission_deterministic_fields():
         "lecture_hours": 0,
         "_submission": {"credit_category": "5", "target_department": "CSE"},
     }
-
     course = build_course_preview(row)
 
     assert course["program"] == "B. TECH"
@@ -35,7 +72,6 @@ def test_preview_keeps_refined_source_values_when_present():
         "credits": 8,
         "_submission": {"credit_category": "4", "target_department": "CSE"},
     }
-
     course = build_course_preview(row)
 
     assert course["practical_hours"] == "16"
@@ -43,15 +79,76 @@ def test_preview_keeps_refined_source_values_when_present():
     assert course["course_type"] == "Internship"
 
 
+# ---------------------------------------------------------------------------
+# build_course_preview: render_detail / has_content
+# ---------------------------------------------------------------------------
+
+def test_render_detail_false_when_no_content():
+    row = {
+        "course_title": "Empty Course",
+        "semester": 3,
+        "_submission": {"credit_category": "4", "target_department": "CSE"},
+    }
+    course = build_course_preview(row)
+    assert course["render_detail"] is False
+
+
+def test_render_detail_true_when_has_objectives():
+    row = {
+        "course_title": "Course With Content",
+        "semester": 3,
+        "objectives": ["Objective 1"],
+        "_submission": {"credit_category": "4", "target_department": "CSE"},
+    }
+    course = build_course_preview(row)
+    assert course["render_detail"] is True
+
+
+def test_render_detail_true_when_has_text_books():
+    row = {
+        "course_title": "Course With Books",
+        "semester": 3,
+        "text_books": "1. Some Book",
+        "_submission": {"credit_category": "4", "target_department": "CSE"},
+    }
+    course = build_course_preview(row)
+    assert course["render_detail"] is True
+
+
+def test_render_detail_true_when_has_units():
+    row = {
+        "course_title": "Course With Units",
+        "semester": 3,
+        "units": [{"title": "Unit 1", "content": "Content", "hours": 4}],
+        "_submission": {"credit_category": "4", "target_department": "CSE"},
+    }
+    course = build_course_preview(row)
+    assert course["render_detail"] is True
+
+
+def test_render_detail_false_when_summary_only_even_with_content():
+    row = {
+        "course_title": "Hidden Course",
+        "semester": 3,
+        "status": "summary_only",
+        "objectives": ["Objective 1"],
+        "_submission": {"credit_category": "4", "target_department": "CSE"},
+    }
+    course = build_course_preview(row)
+    assert course["render_detail"] is False
+
+
+# ---------------------------------------------------------------------------
+# build_course_preview: books / experiments
+# ---------------------------------------------------------------------------
+
 def test_preview_suppresses_labs_for_theory_course():
     row = {
         "course_title": "Theory",
         "lab_experiments": ["Lab that should not render"],
         "_submission": {"credit_category": "4", "target_department": "CSE"},
     }
-
     course = build_course_preview(row)
-
     assert course["lab_experiments"] == []
 
 
@@ -61,9 +158,7 @@ def test_preview_parses_numbered_books():
         "text_books": ["1. First Book, 2024. 2. Second Book, 2025."],
         "_submission": {"credit_category": "4", "target_department": "CSE"},
     }
-
     course = build_course_preview(row)
-
     assert course["text_books"] == ["First Book, 2024.", "Second Book, 2025."]
 
 
@@ -78,37 +173,75 @@ Outcome               should not render
 """,
         "_submission": {"credit_category": "4", "target_department": "CSE"},
     }
-
     course = build_course_preview(row)
-
     assert course["reference_books"] == ["First Reference, 2024.", "Second Reference, 2025."]
 
 
-def _course(**values):
-    course = {
-        "course_code": "",
-        "course_title": "",
-        "program": "B. TECH",
-        "lecture_hours": "4",
-        "tutorial_hours": "0",
-        "practical_hours": "0",
-        "self_study": "4",
-        "credits": "4",
-        "semester": "5",
-        "course_type": "Core Course",
-        "tools_languages": "",
-        "desirable_knowledge": "",
-        "prelude": "",
-        "objectives": [],
-        "course_outcomes": [],
-        "units": [],
-        "lab_experiments": [],
-        "text_books": [],
-        "reference_books": [],
-    }
-    course.update(values)
-    return course
+# ---------------------------------------------------------------------------
+# course_credits helper
+# ---------------------------------------------------------------------------
+
+def test_course_credits_reads_from_credits_column():
+    assert course_credits({"credits": 5}) == 5
+
+
+def test_course_credits_falls_back_to_submission_category():
+    assert course_credits({"_submission": {"credit_category": "2"}}) == 2
+
+
+def test_course_credits_returns_zero_for_empty_row():
+    assert course_credits({}) == 0
+
+
+def test_course_credits_prefers_credits_over_category():
+    assert course_credits({"credits": 4, "_submission": {"credit_category": "2"}}) == 4
+
 
+# ---------------------------------------------------------------------------
+# ordered_courses: credit sort
+# ---------------------------------------------------------------------------
+
+def test_ordered_courses_sorts_by_credits_descending():
+    rows = [
+        {"id": 1, "semester": 3, "course_code": "UE99XX111A", "course_title": "Two Credit", "credits": 2},
+        {"id": 2, "semester": 3, "course_code": "UE99XX222A", "course_title": "Five Credit", "credits": 5},
+        {"id": 3, "semester": 3, "course_code": "UE99XX333A", "course_title": "Four Credit", "credits": 4},
+    ]
+    courses = ordered_courses(rows)
+    assert [c["course_title"] for c in courses] == ["Five Credit", "Four Credit", "Two Credit"]
+
+
+def test_ordered_courses_reads_credits_from_submission_category():
+    rows = [
+        {"id": 1, "semester": 4, "course_code": "UE99XX111A", "course_title": "Theory", "_submission": {"credit_category": "2"}},
+        {"id": 2, "semester": 4, "course_code": "UE99XX222A", "course_title": "Lab Integrated", "_submission": {"credit_category": "5"}},
+    ]
+    courses = ordered_courses(rows)
+    assert [c["course_title"] for c in courses] == ["Lab Integrated", "Theory"]
+
+
+def test_ordered_courses_preserves_order_within_same_credits():
+    rows = [
+        {"id": 6, "semester": 5, "course_code": "UE23CS320A", "course_title": "Capstone Project", "credits": 2},
+        {"id": 1, "semester": 5, "course_code": "UE23CS351A", "course_title": "Database Management System", "credits": 5},
+    ]
+    courses = ordered_courses(rows)
+    assert [c["course_title"] for c in courses] == ["Database Management System", "Capstone Project"]
+
+
+def test_ordered_courses_separates_semesters():
+    rows = [
+        {"id": 1, "semester": 3, "course_code": "UE99XX111A", "course_title": "Sem 3 Course", "credits": 4},
+        {"id": 2, "semester": 1, "course_code": "UE99XX222A", "course_title": "Sem 1 Course", "credits": 5},
+    ]
+    courses = ordered_courses(rows)
+    assert courses[0]["semester"] == "1"
+    assert courses[1]["semester"] == "3"
+
+
+# ---------------------------------------------------------------------------
+# Template: semester summary tables
+# ---------------------------------------------------------------------------
 
 def test_curriculum_template_renders_regular_semester_summary():
     html = templates.get_template("jinja_sample.html").render(
@@ -121,7 +254,6 @@ def test_curriculum_template_renders_regular_semester_summary():
         asset_root="",
         show_summaries=True,
     )
-
     assert "III SEMESTER (2024-28 BATCH)" in html
     assert "UE24CS251A" in html
     assert "Digital Design" in html
@@ -141,30 +273,86 @@ def test_curriculum_template_clubs_semester_one_and_two_summary():
         show_summaries=True,
     )
     early = html.split("III SEMESTER", 1)[0]
-
     assert "I SEMESTER (2025-29 BATCH)" in early
     assert "II SEMESTER (2025-29 BATCH)" in early
     assert early.count('class="summary-page"') == 1
 
 
+def test_curriculum_template_renders_final_year_summary():
+    html = templates.get_template("jinja_sample.html").render(
+        courses=[
+            _course(course_code="UE22CS441A", course_title="Capstone Project Phase-III", semester="7", lecture_hours="0", practical_hours="16", self_study="4", credits="4", course_type="Project Work"),
+            _course(course_code="UZ22UZ422A", course_title="Technical writing", semester="7", lecture_hours="0", tutorial_hours="2", self_study="2", credits="2", course_type="Special Topic"),
+            _course(course_code="UE22CS421B", course_title="Capstone Project Phase-IV", semester="8", lecture_hours="0", practical_hours="8", self_study="4", credits="4", course_type="Project Work"),
+            _course(course_code="UE22CS461XB", course_title="Internship", semester="8", lecture_hours="0", practical_hours="16", self_study="8", credits="8", course_type="Internship"),
+        ],
+        semester="",
+        curriculum_year="2025-2026",
+        asset_root="",
+        show_summaries=True,
+    )
+    assert "VII SEMESTER (2022-26 BATCH)" in html
+    assert "VIII SEMESTER (2022-26 BATCH)" in html
+    assert "Technical writing" in html
+    assert "Internship" in html
+
+
+def test_summary_only_courses_do_not_render_detail_pages():
+    html = templates.get_template("jinja_sample.html").render(
+        courses=[
+            _course(course_code="UZ24UZ221A", course_title="CIE L1", semester="3", credits="2", lecture_hours="2", self_study="2", course_type="Special Topic", status="summary_only", render_detail=False),
+        ],
+        semester=3,
+        curriculum_year="2025-2026",
+        asset_root="",
+        show_summaries=True,
+    )
+    assert "CIE L1" in html
+    assert "Course Objectives:" not in html
+
+
+def test_empty_content_course_skips_detail_page():
+    html = templates.get_template("jinja_sample.html").render(
+        courses=[
+            _course(course_code="UE99XX111A", course_title="Bare Course", semester="3", credits="2", render_detail=False),
+        ],
+        semester=3,
+        curriculum_year="2025-2026",
+        asset_root="",
+        show_summaries=True,
+    )
+    assert "Bare Course" in html
+    assert "Course Objectives:" not in html
+
+
+# ---------------------------------------------------------------------------
+# Template: semester 5/6 elective summaries + placeholders
+# ---------------------------------------------------------------------------
+
 def test_curriculum_template_renders_semester_five_elective_summary():
     html = templates.get_template("jinja_sample.html").render(
         courses=[
-            _course(course_code="UE23CS351A", course_title="Database Management System", semester="5", lecture_hours="4", practical_hours="2", self_study="5", credits="5", course_type="Core Course-Lab Integrated"),
-            _course(course_code="UE23CS342AAX", course_title="Elective I", semester="5", course_type="Elective Course"),
-            _course(course_code="UE23CS342AA1", course_title="Advanced Algorithms", semester="5", course_type="Elective Course", tools_languages="C++"),
-            _course(course_code="UE23CS343AB1", course_title="Image Processing", semester="5", course_type="Elective Course", tools_languages="Python"),
+            _course(refined_id=1, course_code="UE23CS351A", course_title="Database Management System", semester="5", lecture_hours="4", practical_hours="2", self_study="5", credits="5", course_type="Core Course-Lab Integrated", is_elective=False),
+            _course(refined_id=2, course_code="UE23CS342AAX", course_title="Elective I", semester="5", course_type="Elective Course", is_elective=True),
+            _course(refined_id=3, course_code="UE23CS342AA1", course_title="Advanced Algorithms", semester="5", course_type="Elective Course", tools_languages="C++", is_elective=True),
+            _course(refined_id=4, course_code="UE23CS343AB1", course_title="Image Processing", semester="5", course_type="Elective Course", tools_languages="Python", is_elective=True),
         ],
         semester=5,
         curriculum_year="2025-2026",
         asset_root="",
         show_summaries=True,
+        specializations=[
+            {"id": 1, "semester": 5, "letter": "A", "name": "System and Core Computing (SCC)", "key": "SCC", "academic_year": ""},
+            {"id": 2, "semester": 5, "letter": "B", "name": "Machine Intelligence and Data Science (MIDS)", "key": "MIDS", "academic_year": ""},
+            {"id": 3, "semester": 5, "letter": "C", "name": "Cyber Security and Connected Systems (CSCS)", "key": "CSCS", "academic_year": ""},
+        ],
+        specialization_assignments=[
+            {"refined_id": 3, "specialization_id": 1},
+        ],
     )
-
     assert "V SEMESTER (2023-27 BATCH)" in html
     assert "Elective-I" in html
     assert "Elective-II" in html
-    assert "Elective I" in html
     assert "Advanced Algorithms" in html
     assert "Image Processing" in html
     assert "ELECTIVES TO BE OPTED FOR SPECIALIZATION" in html
@@ -175,192 +363,121 @@ def test_curriculum_template_renders_semester_five_elective_summary():
 def test_curriculum_template_renders_semester_six_elective_groups():
     html = templates.get_template("jinja_sample.html").render(
         courses=[
-            _course(course_code="UE23CS351B", course_title="Cloud Computing", semester="6", practical_hours="2", self_study="5", credits="5", course_type="Core Course-Lab Integrated"),
-            _course(course_code="UE23CS342BAX", course_title="Elective III", semester="6", course_type="Elective Course"),
-            _course(course_code="UE23CS343BBX", course_title="Elective IV", semester="6", course_type="Elective Course"),
-            _course(course_code="UE23CS342BA1", course_title="Supply Chain Management for Engineers", semester="6", course_type="Elective Course"),
-            _course(course_code="UE23CS343BB1", course_title="Heterogeneous Parallelism", semester="6", course_type="Elective Course"),
+            _course(refined_id=1, course_code="UE23CS351B", course_title="Cloud Computing", semester="6", practical_hours="2", self_study="5", credits="5", course_type="Core Course-Lab Integrated", is_elective=False),
+            _course(refined_id=2, course_code="UE23CS342BAX", course_title="Elective III", semester="6", course_type="Elective Course", is_elective=True),
+            _course(refined_id=3, course_code="UE23CS343BBX", course_title="Elective IV", semester="6", course_type="Elective Course", is_elective=True),
+            _course(refined_id=4, course_code="UE23CS342BA1", course_title="Supply Chain Management for Engineers", semester="6", course_type="Elective Course", is_elective=True),
+            _course(refined_id=5, course_code="UE23CS343BB1", course_title="Heterogeneous Parallelism", semester="6", course_type="Elective Course", is_elective=True),
         ],
         semester=6,
         curriculum_year="2025-2026",
         asset_root="",
         show_summaries=True,
+        specializations=[
+            {"id": 1, "semester": 6, "letter": "A", "name": "System and Core Computing (SCC)", "key": "SCC", "academic_year": ""},
+            {"id": 2, "semester": 6, "letter": "B", "name": "Machine Intelligence and Data Science (MIDS)", "key": "MIDS", "academic_year": ""},
+            {"id": 3, "semester": 6, "letter": "C", "name": "Cyber Security and Connected Systems (CSCS)", "key": "CSCS", "academic_year": ""},
+        ],
+        specialization_assignments=[
+            {"refined_id": 5, "specialization_id": 3},
+        ],
     )
-
     assert "VI SEMESTER (2023-27 BATCH)" in html
     assert "Elective-III" in html
     assert "Elective-IV" in html
     assert "ELECTIVES TO BE OPTED FOR SPECIALIZATION" in html
-    assert "UE23CS343BB12" in html
+    assert "UE23CS343BB1" in html
 
 
-def test_curriculum_template_renders_final_year_summary():
+def test_sem5_core_table_excludes_electives_and_placeholders():
     html = templates.get_template("jinja_sample.html").render(
         courses=[
-            _course(course_code="UE22CS441A", course_title="Capstone Project Phase-III", semester="7", lecture_hours="0", practical_hours="16", self_study="4", credits="4", course_type="Project Work"),
-            _course(course_code="UZ22UZ422A", course_title="Technical writing", semester="7", lecture_hours="0", tutorial_hours="2", self_study="2", credits="2", course_type="Special Topic"),
-            _course(course_code="UE22AM421AXX", course_title="Special Topic", semester="7", lecture_hours="0", tutorial_hours="2", self_study="2", credits="2", course_type="Special Topic"),
-            _course(course_code="UE22CS421B", course_title="Capstone Project Phase-IV", semester="8", lecture_hours="0", practical_hours="8", self_study="4", credits="4", course_type="Project Work"),
-            _course(course_code="UE22CS461XB", course_title="Internship", semester="8", lecture_hours="0", practical_hours="16", self_study="8", credits="8", course_type="Internship"),
+            _course(refined_id=1, course_code="UE23CS351A", course_title="DBMS", semester="5", credits="4", is_elective=False),
+            _course(refined_id=2, course_code="UE23CS342AAX", course_title="Elective I", semester="5", is_elective=True),
+            _course(refined_id=3, course_code="UE23CS342AA1", course_title="Advanced Algorithms", semester="5", is_elective=True),
+            _course(refined_id=4, course_code="UE23CS342AA2", course_title="Cloud Architecture", semester="5", is_elective=True),
         ],
-        semester="",
+        semester=5,
         curriculum_year="2025-2026",
         asset_root="",
         show_summaries=True,
     )
+    core_section = html.split("Elective-I", 1)[0]
+    assert "DBMS" in core_section
+    assert "Advanced Algorithms" not in core_section
+    assert "Cloud Architecture" not in core_section
 
-    assert "VII SEMESTER (2022-26 BATCH)" in html
-    assert "VIII SEMESTER (2022-26 BATCH)" in html
-    assert "Technical writing" in html
-    assert "Internship" in html
-    assert "AI Tools / Tools / Languages" not in html.split("VII SEMESTER", 1)[1].split("</article>", 1)[0]
+
+def test_sem5_core_table_excludes_no_course_offered():
+    html = templates.get_template("jinja_sample.html").render(
+        courses=[
+            _course(refined_id=1, course_code="UE23CS351A", course_title="DBMS", semester="5", credits="4", is_elective=False),
+            _course(refined_id=2, course_code="UE23CS999A", course_title="No Course Offered", semester="5", credits="0", is_elective=False, render_detail=False),
+        ],
+        semester=5,
+        curriculum_year="2025-2026",
+        asset_root="",
+        show_summaries=True,
+    )
+    sem_section = html.split("V SEMESTER", 1)[1] if "V SEMESTER" in html else ""
+    assert "DBMS" in sem_section
+    assert "No Course Offered" not in sem_section
 
 
-def test_summary_only_courses_do_not_render_detail_pages():
+def test_sem5_summary_shows_placeholder_electives():
     html = templates.get_template("jinja_sample.html").render(
         courses=[
-            _course(course_code="UZ24UZ221A", course_title="CIE L1", semester="3", credits="2", lecture_hours="2", self_study="2", course_type="Special Topic", status="summary_only", render_detail=False),
+            _course(refined_id=1, course_code="UE23CS351A", course_title="DBMS", semester="5", credits="4", is_elective=False),
+            _course(refined_id=2, course_code="UE23CS342AA1", course_title="Advanced Algorithms", semester="5", credits="4", is_elective=True),
         ],
-        semester=3,
+        semester=5,
         curriculum_year="2025-2026",
         asset_root="",
         show_summaries=True,
     )
+    assert "Elective I" in html
+    assert "Elective II" in html
 
-    assert "CIE L1" in html
-    assert "Course Objectives:" not in html
 
+def test_sem6_summary_shows_placeholder_electives():
+    html = templates.get_template("jinja_sample.html").render(
+        courses=[
+            _course(refined_id=1, course_code="UE23CS351B", course_title="Cloud Computing", semester="6", credits="4", is_elective=False),
+            _course(refined_id=3, course_code="UE23CS343BB1", course_title="Heterogeneous Parallelism", semester="6", credits="4", is_elective=True),
+        ],
+        semester=6,
+        curriculum_year="2025-2026",
+        asset_root="",
+        show_summaries=True,
+    )
+    assert "Elective III" in html
+    assert "Elective IV" in html
 
-def test_ordered_courses_preserves_refined_order_within_semester():
-    rows = [
-        {"id": 6, "semester": 5, "course_code": "UE23CS320A", "course_title": "Capstone Project", "credits": 2},
-        {"id": 1, "semester": 5, "course_code": "UE23CS351A", "course_title": "Database Management System", "credits": 5},
-    ]
 
-    courses = ordered_courses(rows)
+def test_sem5_summary_total_includes_placeholder_credits():
+    html = templates.get_template("jinja_sample.html").render(
+        courses=[
+            _course(refined_id=1, course_code="UE23CS351A", course_title="DBMS", semester="5", credits="4", is_elective=False),
+            _course(refined_id=2, course_code="UE23CS342AA1", course_title="Advanced Algorithms", semester="5", credits="4", is_elective=True),
+        ],
+        semester=5,
+        curriculum_year="2025-2026",
+        asset_root="",
+        show_summaries=True,
+    )
+    sem5_section = html.split("V SEMESTER", 1)[1].split("</tbody>", 1)[0]
+    assert ">12<" in sem5_section
+
 
-    assert [course["course_title"] for course in courses] == ["Database Management System", "Capstone Project"]
-
-
-def test_preview_html_endpoint_returns_html(monkeypatch):
-    from app.routes import preview
-
-    # Mock the supabase chain
-    class MockExecute:
-        def execute(self):
-            return type("Result", (), {"data": [
-                {"id": 1, "course_code": "CS101", "course_title": "Test Course", "semester": "1", "credits": "4", "status": "refined", "lecture_hours": "4", "tutorial_hours": "0", "practical_hours": "0", "self_study": "4"}
-            ]})()
-
-    class MockSelect:
-        def neq(self, *args, **kwargs):
-            return self
-        def execute(self):
-            return MockExecute().execute()
-
-    class MockTable:
-        def select(self, *args, **kwargs):
-            return MockSelect()
-        def neq(self, *args, **kwargs):
-            return self
-
-    def mock_table(name):
-        return MockTable()
-
-    monkeypatch.setattr(preview.supabase, "table", mock_table)
-
-    # Mock ordered_courses to return a simple dict with all required fields
-    def mock_ordered_courses(rows):
-        return [{
-            "course_code": "CS101",
-            "course_title": "Test Course",
-            "semester": "1",
-            "credits": "4",
-            "lecture_hours": "4",
-            "tutorial_hours": "0",
-            "practical_hours": "0",
-            "self_study": "4",
-            "course_type": "Core Course",
-            "program": "B. TECH",
-            "tools_languages": "",
-            "desirable_knowledge": "",
-            "prelude": "",
-            "objectives": [],
-            "course_outcomes": [],
-            "units": [],
-            "lab_experiments": [],
-            "text_books": [],
-            "reference_books": [],
-            "render_detail": True,
-        }]
-
-    monkeypatch.setattr(preview, "ordered_courses", mock_ordered_courses)
-
-    # Call the endpoint function
-    resp = preview.preview_all_html(None)
-
-    # Should return HTMLResponse
-    from fastapi.responses import HTMLResponse
-    assert isinstance(resp, HTMLResponse)
-    # HTML should contain the course title
-    assert "Test Course" in resp.body.decode()
-
-
-def test_preview_pdf_endpoint_returns_pdf(monkeypatch):
-    from app.routes import preview
-
-    class MockExecute:
-        def execute(self):
-            return type("Result", (), {"data": [
-                {"id": 1, "course_code": "CS101", "course_title": "Test Course", "semester": "1", "credits": "4", "status": "refined", "lecture_hours": "4", "tutorial_hours": "0", "practical_hours": "0", "self_study": "4"}
-            ]})()
-
-    class MockSelect:
-        def neq(self, *args, **kwargs):
-            return self
-        def execute(self):
-            return MockExecute().execute()
-
-    class MockTable:
-        def select(self, *args, **kwargs):
-            return MockSelect()
-
-    def mock_table(name):
-        return MockTable()
-
-    monkeypatch.setattr(preview.supabase, "table", mock_table)
-
-    def mock_ordered_courses(rows):
-        return [{
-            "course_code": "CS101",
-            "course_title": "Test Course",
-            "semester": "1",
-            "credits": "4",
-            "lecture_hours": "4",
-            "tutorial_hours": "0",
-            "practical_hours": "0",
-            "self_study": "4",
-            "course_type": "Core Course",
-            "program": "B. TECH",
-            "tools_languages": "",
-            "desirable_knowledge": "",
-            "prelude": "",
-            "objectives": [],
-            "course_outcomes": [],
-            "units": [],
-            "lab_experiments": [],
-            "text_books": [],
-            "reference_books": [],
-            "render_detail": True,
-        }]
-
-    monkeypatch.setattr(preview, "ordered_courses", mock_ordered_courses)
-
-    # WeasyPrint will fail without fonts, so just check it attempts to generate
-    try:
-        resp = preview.download_all_pdf(False, "")
-        assert hasattr(resp, "media_type")
-        assert resp.media_type == "application/pdf"
-    except Exception:
-        # WeasyPrint may fail in test env without fonts - that's OK
-        pass
+def test_no_summary_page_for_empty_semester():
+    html = templates.get_template("jinja_sample.html").render(
+        courses=[
+            _course(course_code="UE99XX111A", course_title="Sem 3 Only", semester="3", credits="4"),
+        ],
+        semester="",
+        curriculum_year="2025-2026",
+        asset_root="",
+        show_summaries=True,
+    )
+    assert "V SEMESTER" not in html
+    assert "VI SEMESTER" not in html