From 44e8c56602157345e8f28fc4e888867ec6b6cd8d Mon Sep 17 00:00:00 2001
From: Anthony Wright <anthony@mrwrite.dev>
Date: Tue, 26 May 2026 15:08:26 -0500
Subject: [PATCH 01/14] feat: harden pilot shell navigation layout

---
 .../echo-header/echo-header.component.html    | 30 +++++------
 .../echo-header/echo-header.component.scss    | 32 +++++++++++
 .../echo-sidebar/echo-sidebar.component.html  | 24 +++++----
 .../echo-sidebar/echo-sidebar.component.scss  | 30 ++++++++++-
 .../src/app/pages/home/home.component.html    | 10 ++--
 .../src/app/pages/home/home.component.scss    | 28 ++++++++++
 .../src/app/pages/home/home.component.spec.ts | 26 +++++++++
 frontend/src/app/pages/home/home.component.ts | 26 ++++++++-
 .../pilot-platform-hardening-phase-1/tasks.md | 54 +++++++++++++++++++
 9 files changed, 229 insertions(+), 31 deletions(-)
 create mode 100644 openspec/changes/pilot-platform-hardening-phase-1/tasks.md

diff --git a/frontend/src/app/components/echo-header/echo-header.component.html b/frontend/src/app/components/echo-header/echo-header.component.html
index c002bfc..f2e6231 100644
--- a/frontend/src/app/components/echo-header/echo-header.component.html
+++ b/frontend/src/app/components/echo-header/echo-header.component.html
@@ -1,17 +1,17 @@
-<header class="sticky top-0 z-30 bg-white/90 backdrop-blur-xl shadow-elevated border-b border-primary/10 px-6 py-4">
-  <div class="flex items-center justify-between">
-    <div class="flex items-center gap-4">
+<header class="echo-header sticky top-0 z-30 bg-white/95 backdrop-blur-xl shadow-elevated border-b border-primary/10 px-4 py-4 md:px-5 xl:px-6">
+  <div class="echo-header__row flex flex-wrap items-start justify-between gap-4">
+    <div class="echo-header__brand flex min-w-0 items-center gap-3 md:gap-4">
       <div class="h-11 w-11 rounded-2xl bg-gradient-to-br from-primary to-secondary text-white flex items-center justify-center font-bold">EE</div>
-      <div>
+      <div class="min-w-0">
         <p class="text-xs uppercase tracking-[0.25em] text-primary">EchoEd Dashboard</p>
-        <h1 class="text-xl font-bold text-ink">Command center</h1>
-        <echo-breadcrumbs class="text-sm text-slate-500"></echo-breadcrumbs>
+        <h1 class="text-lg font-bold text-ink md:text-xl">Command center</h1>
+        <echo-breadcrumbs class="text-sm text-slate-600"></echo-breadcrumbs>
       </div>
-      <span class="badge-soft hidden md:inline-flex">Investor-ready demo</span>
+      <span class="badge-soft hidden lg:inline-flex">Investor-ready demo</span>
     </div>
 
-    <div class="flex items-center gap-3">
-      <div class="hidden md:flex flex-col items-end gap-2">
+    <div class="echo-header__actions flex w-full flex-wrap items-start justify-end gap-3 lg:w-auto lg:flex-nowrap">
+      <div class="hidden lg:flex flex-col items-end gap-2">
         <app-echo-loading-state
           *ngIf="orgsLoading"
           density="compact"
@@ -40,10 +40,10 @@ <h1 class="text-xl font-bold text-ink">Command center</h1>
           body="Your confirmed access will appear here when organization memberships are available."
         ></app-echo-state-panel>
         <div *ngIf="!orgsLoading && !orgsLoadError && organizations.length > 0" class="flex flex-col items-end gap-2">
-          <div class="flex items-center gap-2 bg-white/70 border border-primary/10 rounded-full px-3 py-2">
-            <span class="text-xs font-semibold text-slate-500">Org</span>
+          <div class="flex items-center gap-2 rounded-full border border-primary/10 bg-white/80 px-3 py-2 shadow-sm">
+            <span class="text-xs font-semibold text-slate-600">Org</span>
             <select
-              class="text-sm bg-transparent focus:outline-none disabled:opacity-60"
+              class="min-w-0 max-w-[14rem] bg-transparent text-sm text-slate-800 focus:outline-none disabled:opacity-60"
               [ngModel]="activeOrgId"
               (ngModelChange)="switchOrg($event)"
               [disabled]="switchPending"
@@ -70,13 +70,13 @@ <h1 class="text-xl font-bold text-ink">Command center</h1>
           ></app-echo-state-panel>
           <div *ngIf="!switchPending && !switchError" class="text-right">
             <p class="text-xs font-semibold uppercase tracking-[0.18em] text-primary">Confirmed organization</p>
-            <p class="text-sm text-slate-600">{{ activeOrganizationName }}</p>
+            <p class="text-sm text-slate-700">{{ activeOrganizationName }}</p>
             <p *ngIf="switchSuccess" class="mt-1 text-xs text-emerald-700">{{ switchSuccess }}</p>
           </div>
         </div>
       </div>
       <button aria-label="Open help and support" class="px-3 py-2 rounded-full border border-primary/20 text-primary bg-primary/5 text-sm font-semibold hidden sm:inline-flex hover:bg-primary/10">Help & Support</button>
-      <button aria-label="Start guided tour" class="px-3 py-2 rounded-full border border-primary/20 text-white bg-primary text-sm font-semibold hidden sm:inline-flex hover:-translate-y-0.5 transition" (click)="startGuidedTour()">Start Guided Tour</button>
+      <button aria-label="Start guided tour" class="hidden sm:inline-flex rounded-full border border-primary/20 bg-primary px-3 py-2 text-sm font-semibold text-white transition hover:-translate-y-0.5 hover:bg-secondary" (click)="startGuidedTour()">Start Guided Tour</button>
       <div class="relative" #menuContainer>
         <button
           (click)="toggleMenu()"
@@ -92,7 +92,7 @@ <h1 class="text-xl font-bold text-ink">Command center</h1>
         >
           <div class="px-4 py-3 border-b border-slate-100">
             <p class="font-semibold text-primary">{{ userinfo.fullname }}</p>
-            <p class="text-xs text-slate-500">{{ userinfo.role | titlecase }}</p>
+            <p class="text-xs text-slate-600">{{ userinfo.role | titlecase }}</p>
           </div>
           <ul class="py-1 text-sm">
             <li>
diff --git a/frontend/src/app/components/echo-header/echo-header.component.scss b/frontend/src/app/components/echo-header/echo-header.component.scss
index e69de29..128cad0 100644
--- a/frontend/src/app/components/echo-header/echo-header.component.scss
+++ b/frontend/src/app/components/echo-header/echo-header.component.scss
@@ -0,0 +1,32 @@
+.echo-header {
+  min-width: 0;
+}
+
+.echo-header__row,
+.echo-header__brand,
+.echo-header__actions {
+  min-width: 0;
+}
+
+echo-breadcrumbs {
+  display: block;
+  min-width: 0;
+  color: #475569;
+}
+
+@media (max-width: 1023px) {
+  .echo-header__actions {
+    align-items: center;
+  }
+}
+
+@media (max-width: 639px) {
+  .echo-header {
+    padding-top: 1rem;
+    padding-bottom: 1rem;
+  }
+
+  .echo-header__row {
+    gap: 0.75rem;
+  }
+}
diff --git a/frontend/src/app/components/echo-sidebar/echo-sidebar.component.html b/frontend/src/app/components/echo-sidebar/echo-sidebar.component.html
index eefef5a..e672574 100644
--- a/frontend/src/app/components/echo-sidebar/echo-sidebar.component.html
+++ b/frontend/src/app/components/echo-sidebar/echo-sidebar.component.html
@@ -1,5 +1,5 @@
 <div
-  class="sidebar-shell bg-white/92 backdrop-blur-lg text-ink h-screen flex flex-col border-r border-slate-200/80 shadow-soft-card"
+  class="sidebar-shell bg-white/95 backdrop-blur-lg text-ink h-screen flex flex-col border-r border-slate-200/80 shadow-soft-card"
   [class.sidebar-shell--collapsed]="collapsed"
   [style.width]="collapsed ? 'var(--echo-sidebar-collapsed-width)' : 'var(--echo-sidebar-expanded-width)'"
 >
@@ -8,10 +8,15 @@
       <div class="h-10 w-10 rounded-xl bg-gradient-to-br from-primary to-secondary text-white flex items-center justify-center font-bold shrink-0">EE</div>
       <div class="min-w-0">
         <p class="text-xs uppercase tracking-[0.25em] text-primary">EchoEd</p>
-        <p class="text-sm font-semibold truncate">Demo Navigator</p>
+        <p class="text-sm font-semibold text-slate-800 truncate">Demo Navigator</p>
       </div>
     </div>
-    <button (click)="toggle.emit()" class="text-primary shrink-0" aria-label="Toggle sidebar" [attr.aria-expanded]="!collapsed">
+    <button
+      (click)="toggle.emit()"
+      class="sidebar-toggle shrink-0 rounded-xl p-2"
+      aria-label="Toggle sidebar"
+      [attr.aria-expanded]="!collapsed"
+    >
       <svg xmlns="http://www.w3.org/2000/svg" class="h-6 w-6" fill="none"
            viewBox="0 0 24 24" stroke="currentColor">
         <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2"
@@ -24,18 +29,19 @@
     <ng-container *ngIf="ready$ | async; else navSkeleton">
       <ng-container *ngIf="visibleNavSections$ | async as sections">
         <div *ngFor="let section of sections">
-          <p class="text-xs uppercase tracking-[0.2em] text-slate-600 mb-2 px-2" *ngIf="!collapsed">{{ section.title }}</p>
+          <p class="text-xs uppercase tracking-[0.2em] text-slate-700 mb-2 px-2" *ngIf="!collapsed">{{ section.title }}</p>
           <div class="space-y-1">
             <a
               *ngFor="let item of section.items"
               [routerLink]="item.route"
-              routerLinkActive="bg-primary/10 text-primary"
-              class="sidebar-link flex items-center rounded-xl hover:bg-primary/10 transition"
+              routerLinkActive="sidebar-link--active"
+              ariaCurrentWhenActive="page"
+              class="sidebar-link flex items-center rounded-xl transition"
               [class.sidebar-link--collapsed]="collapsed"
               [attr.aria-label]="collapsed ? item.label : null"
               [attr.title]="collapsed ? item.label : null"
             >
-            <span aria-hidden="true" class="inline-block h-5 w-5 shrink-0 rounded-full bg-current opacity-70"></span>
+              <span aria-hidden="true" class="inline-block h-5 w-5 shrink-0 rounded-full bg-current opacity-70"></span>
               <span *ngIf="!collapsed" class="font-semibold truncate">{{ item.label }}</span>
             </a>
           </div>
@@ -55,8 +61,8 @@
   </nav>
 
   <div class="p-4 border-t border-slate-200/80" *ngIf="!collapsed && userInfo">
-    <p class="text-xs text-slate-600">Logged in as</p>
+    <p class="text-xs text-slate-700">Logged in as</p>
     <p class="font-semibold text-primary">{{ userInfo.fullname }}</p>
-    <p class="text-xs text-slate-600">{{ userInfo.role | titlecase }}</p>
+    <p class="text-xs text-slate-700">{{ userInfo.role | titlecase }}</p>
   </div>
 </div>
diff --git a/frontend/src/app/components/echo-sidebar/echo-sidebar.component.scss b/frontend/src/app/components/echo-sidebar/echo-sidebar.component.scss
index fdd77fa..ae8c563 100644
--- a/frontend/src/app/components/echo-sidebar/echo-sidebar.component.scss
+++ b/frontend/src/app/components/echo-sidebar/echo-sidebar.component.scss
@@ -2,31 +2,57 @@
   position: sticky;
   top: 0;
   min-width: 0;
+  max-width: 100%;
   height: 100dvh;
   transition:
     width 300ms ease,
-    box-shadow 300ms ease;
+    box-shadow 300ms ease,
+    transform 300ms ease;
+  overflow: hidden;
 }
 
 .sidebar-shell--collapsed {
   align-items: stretch;
 }
 
+.sidebar-toggle {
+  color: var(--echo-primary);
+  background: rgba(46, 41, 78, 0.06);
+  border: 1px solid rgba(46, 41, 78, 0.12);
+}
+
+.sidebar-toggle:hover {
+  background: rgba(46, 41, 78, 0.12);
+}
+
 .sidebar-link {
   gap: 0.75rem;
   min-height: 3rem;
   padding: 0.75rem;
   color: #1f2937;
+  border: 1px solid transparent;
+  background: transparent;
+  overflow: hidden;
 }
 
 .sidebar-link:hover,
 .sidebar-link:focus-visible {
+  background: rgba(46, 41, 78, 0.08);
+  color: var(--echo-primary);
+  border-color: rgba(46, 41, 78, 0.14);
   box-shadow: inset 0 0 0 1px rgba(46, 41, 78, 0.08);
 }
 
+.sidebar-link--active {
+  background: linear-gradient(135deg, rgba(46, 41, 78, 0.14), rgba(68, 53, 107, 0.08));
+  color: var(--echo-primary);
+  border-color: rgba(46, 41, 78, 0.14);
+  box-shadow: inset 0 0 0 1px rgba(46, 41, 78, 0.1);
+}
+
 .sidebar-link--collapsed {
   justify-content: center;
-  padding-inline: 0;
+  padding-inline: 0.5rem;
 }
 
 .sidebar-skeleton {
diff --git a/frontend/src/app/pages/home/home.component.html b/frontend/src/app/pages/home/home.component.html
index 8f0fa52..861f836 100644
--- a/frontend/src/app/pages/home/home.component.html
+++ b/frontend/src/app/pages/home/home.component.html
@@ -3,11 +3,13 @@
     <div
       class="home-shell min-h-screen"
       [class.home-shell--lesson]="lessonMode"
+      [class.home-shell--compact]="compactShell"
       [style.--echo-shell-sidebar-width]="lessonMode ? '0px' : sidebarWidth"
     >
       <echo-sidebar
         *ngIf="!lessonMode"
         class="home-shell__sidebar"
+        [class.home-shell__sidebar--overlay]="sidebarOverlayMode"
         [userInfo]="userInfo"
         [collapsed]="sidebarCollapsed"
         (toggle)="sidebarCollapsed = !sidebarCollapsed"
@@ -15,14 +17,14 @@
       ></echo-sidebar>
       <div class="home-shell__main flex flex-col min-h-screen">
         <echo-header *ngIf="!lessonMode" [userinfo]="userInfo" @fade></echo-header>
-        <main class="flex-1 overflow-y-auto p-6">
+        <main class="home-shell__content flex-1 overflow-y-auto p-4 md:p-5 xl:p-6">
           <div *ngIf="!lessonMode" class="max-w-7xl mx-auto">
-            <div class="mb-4 surface-card p-4 flex flex-wrap items-center justify-between gap-3">
+            <div class="mb-4 surface-card flex flex-wrap items-center justify-between gap-3 p-4 md:p-5">
               <div>
                 <p class="text-xs uppercase tracking-[0.25em] text-primary">Demo Mode: K-5 African & African-American History</p>
-                <p class="text-sm text-muted">Guide stakeholders through landing -> login -> dashboards -> lessons -> admin.</p>
+                <p class="text-sm text-slate-700">Guide stakeholders through landing -> login -> dashboards -> lessons -> admin.</p>
               </div>
-              <button (click)="startDemoTour()" class="px-4 py-2 bg-primary text-white rounded-full shadow-soft-card text-sm font-semibold hover:-translate-y-0.5 transition">
+              <button (click)="startDemoTour()" class="px-4 py-2 bg-primary text-white rounded-full shadow-soft-card text-sm font-semibold transition hover:-translate-y-0.5 hover:bg-secondary">
                 Start Demo Tour
               </button>
             </div>
diff --git a/frontend/src/app/pages/home/home.component.scss b/frontend/src/app/pages/home/home.component.scss
index da3b61d..cb3c663 100644
--- a/frontend/src/app/pages/home/home.component.scss
+++ b/frontend/src/app/pages/home/home.component.scss
@@ -2,6 +2,8 @@
   display: grid;
   grid-template-columns: var(--echo-shell-sidebar-width, var(--echo-sidebar-expanded-width)) minmax(0, 1fr);
   transition: grid-template-columns 300ms ease;
+  overflow-x: clip;
+  isolation: isolate;
 }
 
 .home-shell--lesson {
@@ -10,8 +12,34 @@
 
 .home-shell__sidebar {
   min-width: 0;
+  z-index: 25;
 }
 
 .home-shell__main {
   min-width: 0;
 }
+
+.home-shell__content {
+  min-width: 0;
+}
+
+@media (max-width: 1023px) {
+  .home-shell {
+    grid-template-columns: var(--echo-shell-sidebar-width, var(--echo-sidebar-collapsed-width)) minmax(0, 1fr);
+  }
+
+  .home-shell__sidebar--overlay {
+    position: fixed;
+    top: 0;
+    left: 0;
+    bottom: 0;
+    width: var(--echo-sidebar-expanded-width);
+    max-width: min(20rem, calc(100vw - 1rem));
+  }
+}
+
+@media (max-width: 767px) {
+  .home-shell {
+    grid-template-columns: var(--echo-shell-sidebar-width, 4.5rem) minmax(0, 1fr);
+  }
+}
diff --git a/frontend/src/app/pages/home/home.component.spec.ts b/frontend/src/app/pages/home/home.component.spec.ts
index 4d989d7..7aa8149 100644
--- a/frontend/src/app/pages/home/home.component.spec.ts
+++ b/frontend/src/app/pages/home/home.component.spec.ts
@@ -60,6 +60,10 @@ describe('HomeComponent', () => {
   });
 
   it('binds shell width to the expanded sidebar by default', () => {
+    component.compactShell = false;
+    component.sidebarCollapsed = false;
+    fixture.detectChanges();
+
     const shell = fixture.nativeElement.querySelector('.home-shell') as HTMLElement;
 
     expect(shell.style.getPropertyValue('--echo-shell-sidebar-width')).toBe('var(--echo-sidebar-expanded-width)');
@@ -97,4 +101,26 @@ describe('HomeComponent', () => {
     expect(shell.classList).toContain('home-shell--lesson');
     expect(shell.style.getPropertyValue('--echo-shell-sidebar-width')).toBe('0px');
   });
+
+  it('collapses the sidebar by default on compact viewports', () => {
+    component.compactShell = true;
+    component.sidebarCollapsed = true;
+    fixture.detectChanges();
+
+    expect(component.compactShell).toBeTrue();
+    expect(component.sidebarCollapsed).toBeTrue();
+    expect(component.sidebarWidth).toBe('var(--echo-sidebar-collapsed-width)');
+  });
+
+  it('keeps shell width stable when compact navigation expands as an overlay', () => {
+    component.compactShell = true;
+    component.sidebarCollapsed = false;
+    fixture.detectChanges();
+
+    const shell = fixture.nativeElement.querySelector('.home-shell') as HTMLElement;
+    const sidebar = fixture.nativeElement.querySelector('echo-sidebar') as HTMLElement;
+    expect(component.sidebarOverlayMode).toBeTrue();
+    expect(shell.style.getPropertyValue('--echo-shell-sidebar-width')).toBe('var(--echo-sidebar-collapsed-width)');
+    expect(sidebar.classList).toContain('home-shell__sidebar--overlay');
+  });
 });
diff --git a/frontend/src/app/pages/home/home.component.ts b/frontend/src/app/pages/home/home.component.ts
index a66dc21..7126c04 100644
--- a/frontend/src/app/pages/home/home.component.ts
+++ b/frontend/src/app/pages/home/home.component.ts
@@ -1,4 +1,4 @@
-import { Component, OnInit, inject } from '@angular/core';
+import { Component, HostListener, OnInit, inject } from '@angular/core';
 import { RouterOutlet, Router, NavigationEnd } from '@angular/router';
 import { CommonModule } from '@angular/common';
 import { SidebarComponent } from '../../components/echo-sidebar/echo-sidebar.component';
@@ -30,6 +30,7 @@ import { PermissionsService } from '../../services/permissions.service';
 export class HomeComponent implements OnInit {
   sidebarCollapsed = false;
   lessonMode = false;
+  compactShell = false;
   private readonly permissionsService = inject(PermissionsService);
   readonly userInfo$ = this.permissionsService.user$;
   readonly ready$ = this.permissionsService.ready$;
@@ -40,6 +41,7 @@ export class HomeComponent implements OnInit {
   ) { }
 
   ngOnInit(): void {
+    this.syncShellViewport();
     this.lessonMode = this.router.url.includes('/lesson/');
     this.router.events
       .pipe(filter(event => event instanceof NavigationEnd))
@@ -48,13 +50,35 @@ export class HomeComponent implements OnInit {
       });
   }
 
+  @HostListener('window:resize')
+  onWindowResize(): void {
+    this.syncShellViewport();
+  }
+
   startDemoTour() {
     this.demoTourService.startTour();
   }
 
   get sidebarWidth(): string {
+    if (this.compactShell && !this.sidebarCollapsed) {
+      return 'var(--echo-sidebar-collapsed-width)';
+    }
+
     return this.sidebarCollapsed
       ? 'var(--echo-sidebar-collapsed-width)'
       : 'var(--echo-sidebar-expanded-width)';
   }
+
+  get sidebarOverlayMode(): boolean {
+    return this.compactShell && !this.sidebarCollapsed;
+  }
+
+  private syncShellViewport(): void {
+    const nextCompactShell = window.innerWidth < 1024;
+    if (nextCompactShell && !this.compactShell) {
+      this.sidebarCollapsed = true;
+    }
+
+    this.compactShell = nextCompactShell;
+  }
 }
diff --git a/openspec/changes/pilot-platform-hardening-phase-1/tasks.md b/openspec/changes/pilot-platform-hardening-phase-1/tasks.md
new file mode 100644
index 0000000..9c7296c
--- /dev/null
+++ b/openspec/changes/pilot-platform-hardening-phase-1/tasks.md
@@ -0,0 +1,54 @@
+## 1. UI shell polish
+
+- [x] 1.1 Audit the authenticated shell, header, and sidebar across student and teacher entry flows for layout shift, unstable first paint, and broken responsive behavior
+- [x] 1.2 Normalize role-aware shell bootstrap so header, sidebar, and primary dashboard content render only from resolved authenticated context
+- [x] 1.3 Fix pilot-critical shell polish defects in shared navigation, spacing, and return-path behavior without introducing a parallel shell system
+
+## 2. Student dashboard polish
+
+- [ ] 2.1 Audit the current student dashboard continuation path, active course card, and available-course surfaces against pilot readiness expectations
+- [ ] 2.2 Harden continuation, empty, and retry behavior so students can reliably understand their next governed learning step
+- [ ] 2.3 Verify the student can log in, see the active course, enter the lesson, and return safely without contradictory dashboard state
+
+## 3. Lesson runtime polish
+
+- [ ] 3.1 Audit the lesson runtime entry, governed blocked state, error recovery, and exit-to-dashboard behavior for readability and continuity
+- [ ] 3.2 Harden lesson runtime state rendering so loading, blocked, error, and completed outcomes remain distinct and user-friendly
+- [ ] 3.3 Verify the lesson runtime preserves governed delivery semantics and safe navigation across refresh and return flows
+
+## 4. Teacher dashboard baseline polish
+
+- [ ] 4.1 Audit the current teacher dashboard for pilot-demo readiness, focusing on course visibility, learner progress context, runtime support visibility, and responsive usability
+- [ ] 4.2 Harden teacher dashboard loading, empty, and retry behavior so the core pilot narrative remains usable even when some datasets are unavailable
+- [ ] 4.3 Verify a teacher can log in and see enough stable dashboard state to demonstrate course, learner, and runtime context
+
+## 5. Error/loading/empty states
+
+- [ ] 5.1 Inventory route-local loading, error, blocked, and empty states across shell, student dashboard, teacher dashboard, and lesson runtime
+- [ ] 5.2 Align pilot-critical flows to the canonical UX state system and remove ambiguous placeholders where stale content remains visible
+- [ ] 5.3 Add or update tests that lock in the intended user-friendly state behavior where practical
+
+## 6. Accessibility pass
+
+- [ ] 6.1 Review pilot-critical student, teacher, shell, and lesson surfaces for contrast, focus visibility, keyboard order, and labeling defects
+- [ ] 6.2 Fix obvious unreadable text, weak contrast, and missing actionable semantics in core pilot flows
+- [ ] 6.3 Document any remaining accessibility limitations that are intentionally deferred beyond Phase 1
+
+## 7. Backend runtime verification
+
+- [ ] 7.1 Audit progression and runtime routes that govern course start, lesson continuation, segment completion, and governed blocked behavior
+- [ ] 7.2 Fix or reinforce any targeted progression/runtime defects while preserving real auth and governed delivery rules
+- [ ] 7.3 Extend or refresh backend pytest coverage for governed progression safety, non-governed progression continuity, and deterministic demo seed behavior
+
+## 8. Smoke tests / docs
+
+- [ ] 8.1 Review existing demo seed, smoke validation, and pilot-readiness documentation for drift against current student and teacher flows
+- [ ] 8.2 Update bounded smoke and manual verification docs so a pilot operator can prepare the demo environment and validate core student/teacher flows deterministically
+- [ ] 8.3 Verify the existing student Playwright smoke remains green and document any intentionally manual teacher checks
+
+## 9. Final validation
+
+- [ ] 9.1 Run the full backend pytest suite and confirm it remains green
+- [ ] 9.2 Run the existing Angular test suite and confirm it remains green
+- [ ] 9.3 Run the existing student Playwright smoke and confirm the pilot-critical student path remains green
+- [ ] 9.4 Confirm no production auth was weakened, demo seed remains deterministic, and new Phase 1 behavior is covered by tests or documented manual verification

From 5ec82b873c182cbf1d0b777052ceaa9c54931328 Mon Sep 17 00:00:00 2001
From: Anthony Wright <anthony@mrwrite.dev>
Date: Tue, 26 May 2026 15:16:00 -0500
Subject: [PATCH 02/14] feat: polish pilot student dashboard

---
 .../student-course-card.component.ts          |  60 ++++++---
 .../student-view/student-view.component.html  | 119 +++++++++++-------
 .../student-view/student-view.component.scss  |  18 +++
 .../student-view.component.spec.ts            |  16 +++
 .../student-view/student-view.component.ts    |  26 ++++
 .../pilot-platform-hardening-phase-1/tasks.md |   6 +-
 6 files changed, 176 insertions(+), 69 deletions(-)

diff --git a/frontend/src/app/components/student-course-card/student-course-card.component.ts b/frontend/src/app/components/student-course-card/student-course-card.component.ts
index f32be44..127162c 100644
--- a/frontend/src/app/components/student-course-card/student-course-card.component.ts
+++ b/frontend/src/app/components/student-course-card/student-course-card.component.ts
@@ -7,22 +7,42 @@ import { IconModule } from '../../shared/icon/icon.module';
   standalone: true,
   imports: [CommonModule, IconModule],
   template: `
-    <div class="bg-white rounded-xl shadow w-full overflow-hidden relative">
+    <article class="student-course-card relative w-full overflow-hidden rounded-2xl border border-slate-200 bg-white shadow-soft-card">
       <img
         *ngIf="thumbnailUrl"
         [src]="thumbnailUrl"
         alt="Course image"
-        class="w-full h-48 object-cover"
+        class="h-48 w-full object-cover"
       />
-      <div class="p-6">
-        <p class="text-xl font-bold text-primary">{{ title }}</p>
-        <p *ngIf="instructor" class="text-xs text-gray-500 mb-1">
+      <div class="p-5 md:p-6">
+        <div class="flex flex-wrap items-start justify-between gap-3">
+          <p class="text-lg font-bold leading-7 text-primary md:text-xl">{{ title }}</p>
+          <span
+            class="rounded-full px-3 py-1 text-xs font-semibold uppercase tracking-[0.16em]"
+            [ngClass]="
+              status === 'completed'
+                ? 'border border-emerald-200 bg-emerald-50 text-emerald-800'
+                : (progress || 0) > 0 || status === 'active'
+                ? 'border border-primary/15 bg-primary/5 text-primary'
+                : 'border border-slate-200 bg-slate-50 text-slate-700'
+            "
+          >
+            {{
+              status === 'completed'
+                ? 'Completed'
+                : ((progress || 0) > 0 || status === 'active')
+                ? 'In progress'
+                : 'Ready to begin'
+            }}
+          </span>
+        </div>
+        <p *ngIf="instructor" class="mb-1 mt-2 text-xs font-semibold uppercase tracking-[0.16em] text-slate-500">
           By {{ instructor }}
         </p>
-        <p class="text-xs text-gray-500">{{ description }}</p>
+        <p class="text-sm leading-6 text-slate-700">{{ description }}</p>
         <div
           *ngIf="rating"
-          class="flex items-center text-sm text-yellow-500 mt-1"
+          class="mt-3 flex items-center text-sm text-yellow-500"
         >
           <ng-container *ngFor="let star of [1, 2, 3, 4, 5]">
             <span
@@ -31,26 +51,26 @@ import { IconModule } from '../../shared/icon/icon.module';
               [class.opacity-30]="star > (rating || 0)"
             ></span>
           </ng-container>
-          <span *ngIf="ratingCount" class="text-gray-500 ml-1"
+          <span *ngIf="ratingCount" class="ml-1 text-slate-500"
             >({{ ratingCount }})</span
           >
         </div>
-        <div *ngIf="progress !== undefined" class="mt-2">
-          <div class="flex items-center gap-2">
-            <div class="h-2 bg-gray-200 rounded-full overflow-hidden flex-1">
-              <div class="h-full bg-primary" [style.width.%]="progress"></div>
+        <div *ngIf="progress !== undefined" class="mt-4">
+          <div class="mb-2 flex items-center justify-between gap-2 text-xs font-semibold uppercase tracking-[0.16em] text-slate-500">
+            <span>Progress</span>
+            <span>{{ progress }}%</span>
+          </div>
+          <div class="flex items-center gap-3">
+            <div class="h-2.5 flex-1 overflow-hidden rounded-full bg-slate-200">
+              <div class="h-full rounded-full bg-gradient-to-r from-primary to-accent" [style.width.%]="progress"></div>
             </div>
-            <span class="text-xs font-medium">{{ progress }}%</span>
           </div>
         </div>
-        <ng-content></ng-content>
+        <div class="mt-4">
+          <ng-content></ng-content>
+        </div>
       </div>
-      <span
-        *ngIf="status === 'completed'"
-        class="absolute top-1 right-4 bg-green-600 text-white text-xs px-3 py-1 rounded"
-        >Completed</span
-      >
-    </div>
+    </article>
   `,
 })
 export class StudentCourseCardComponent {
diff --git a/frontend/src/app/pages/user-dashboard/student-view/student-view.component.html b/frontend/src/app/pages/user-dashboard/student-view/student-view.component.html
index c98eda9..c84edaf 100644
--- a/frontend/src/app/pages/user-dashboard/student-view/student-view.component.html
+++ b/frontend/src/app/pages/user-dashboard/student-view/student-view.component.html
@@ -1,30 +1,30 @@
-<div class="space-y-6" data-testid="student-dashboard">
+<div class="student-dashboard space-y-5 md:space-y-6" data-testid="student-dashboard">
   <div class="grid gap-4 grid-cols-1 lg:grid-cols-3">
-    <div class="col-span-2 p-6 rounded-2xl bg-gradient-to-br from-primary to-secondary text-white shadow-soft-card">
-      <div class="flex justify-between items-start">
+    <div class="student-dashboard__hero col-span-2 rounded-2xl bg-gradient-to-br from-primary to-secondary p-5 text-white shadow-soft-card md:p-6">
+      <div class="flex flex-wrap justify-between gap-4 items-start">
         <div>
           <p class="text-sm uppercase tracking-[0.2em] text-on-dark-muted">Welcome back</p>
-          <h2 class="text-3xl font-bold">{{userInfo.fullname}}</h2>
-          <p class="text-on-dark">Here is a guided overview of your EchoEd learning journey.</p>
+          <h2 class="text-2xl font-bold md:text-3xl">{{userInfo.fullname}}</h2>
+          <p class="mt-1 max-w-2xl text-on-dark">Here is a guided overview of your EchoEd learning journey.</p>
         </div>
-        <span class="px-3 py-1 rounded-full bg-white/20 text-xs font-semibold">K-5 Demo</span>
+        <span class="rounded-full bg-white/20 px-3 py-1 text-xs font-semibold">K-5 Demo</span>
       </div>
-      <div class="mt-6 grid sm:grid-cols-3 gap-4 text-sm">
-        <div class="p-4 bg-white/10 rounded-xl border border-white/10">
+      <div class="mt-5 grid gap-3 text-sm sm:grid-cols-3 md:mt-6 md:gap-4">
+        <div class="rounded-xl border border-white/10 bg-white/10 p-4">
           <p class="text-on-dark-muted">Active courses</p>
           <p class="text-2xl font-bold">{{ studentCourses.length }}</p>
         </div>
-        <div class="p-4 bg-white/10 rounded-xl border border-white/10">
+        <div class="rounded-xl border border-white/10 bg-white/10 p-4">
           <p class="text-on-dark-muted">Streak</p>
           <p class="text-2xl font-bold">{{ streakDays }} day<span *ngIf="streakDays !== 1">s</span></p>
         </div>
-        <div class="p-4 bg-white/10 rounded-xl border border-white/10">
+        <div class="rounded-xl border border-white/10 bg-white/10 p-4">
           <p class="text-on-dark-muted">Badges</p>
           <p class="text-2xl font-bold">{{ studentBadges.length }} earned</p>
         </div>
       </div>
     </div>
-    <div class="surface-card p-6">
+    <section class="student-dashboard__continuation surface-card p-5 md:p-6" aria-labelledby="student-continuation-heading">
       <p class="section-heading text-primary text-sm">Today's Learning</p>
       <app-echo-loading-state
         *ngIf="coursesLoading"
@@ -43,10 +43,17 @@ <h2 class="text-3xl font-bold">{{userInfo.fullname}}</h2>
         (action)="retryCourseLoad()"
       ></app-echo-state-panel>
       <ng-container *ngIf="!coursesLoading && !coursesLoadError && activeStudentCourse; else noActive">
-        <p class="text-lg font-semibold mt-2" data-testid="student-active-course-title">{{ activeStudentCourse.course.title }}</p>
-        <p class="text-sm text-slate-600">{{ activeStudentCourse.course.description }}</p>
+        <div class="mt-3 flex flex-wrap items-start justify-between gap-3">
+          <div class="min-w-0">
+            <p id="student-continuation-heading" class="text-lg font-semibold text-ink md:text-xl" data-testid="student-active-course-title">{{ activeStudentCourse.course.title }}</p>
+            <p class="mt-1 text-sm leading-6 text-slate-700">{{ activeStudentCourse.course.description }}</p>
+          </div>
+          <span class="student-dashboard__status-pill rounded-full border border-primary/15 bg-primary/5 px-3 py-1 text-xs font-semibold uppercase tracking-[0.16em] text-primary">
+            {{ activeCourseStatusLabel }}
+          </span>
+        </div>
         <p
-          class="mt-2 text-xs font-semibold uppercase tracking-[0.18em]"
+          class="mt-3 text-xs font-semibold uppercase tracking-[0.18em]"
           [ngClass]="{
             'text-primary': activeContinuationState === 'normal',
             'text-amber-700': activeContinuationState === 'remediation',
@@ -55,8 +62,31 @@ <h2 class="text-3xl font-bold">{{userInfo.fullname}}</h2>
         >
           {{ activeContinuationEyebrow }}
         </p>
-        <p class="mt-1 text-sm font-semibold text-ink">{{ activeContinuationTitle }}</p>
-        <p class="mt-1 text-sm text-slate-600">{{ activeStudentCourseReason }}</p>
+        <p class="mt-1 text-base font-semibold text-ink">{{ activeContinuationTitle }}</p>
+        <p class="mt-1 text-sm leading-6 text-slate-700">{{ activeStudentCourseReason }}</p>
+        <div class="mt-3 rounded-2xl border border-slate-200 bg-slate-50/90 p-4">
+          <div class="flex flex-wrap items-center justify-between gap-3">
+            <div>
+              <p class="text-xs font-semibold uppercase tracking-[0.16em] text-slate-600">Governed course progress</p>
+              <p class="mt-1 text-sm text-slate-700">Your next lesson follows the current approved learning path and saves progress automatically.</p>
+            </div>
+            <div class="text-right">
+              <p class="text-2xl font-bold text-primary">{{ activeCourseProgress | number:'1.0-0' }}%</p>
+              <p class="text-xs font-semibold uppercase tracking-[0.16em] text-slate-500">Completed</p>
+            </div>
+          </div>
+          <div class="mt-3 h-2.5 overflow-hidden rounded-full bg-slate-200">
+            <div
+              class="h-full rounded-full bg-gradient-to-r from-primary to-accent"
+              [style.width.%]="activeCourseProgress"
+              role="progressbar"
+              aria-label="Active course progress"
+              [attr.aria-valuenow]="activeCourseProgress"
+              aria-valuemin="0"
+              aria-valuemax="100"
+            ></div>
+          </div>
+        </div>
         <div
           *ngIf="activeReinforcementMessage"
           class="mt-3 rounded-2xl border p-4"
@@ -117,21 +147,18 @@ <h2 class="text-3xl font-bold">{{userInfo.fullname}}</h2>
             </li>
           </ul>
         </div>
-        <div class="mt-4">
-          <div class="flex justify-between text-sm text-slate-500 mb-1">
-            <span>Progress</span>
-            <span>{{ (activeStudentCourse.progress || 0) | number:'1.0-0' }}%</span>
-          </div>
-          <div class="h-2 rounded-full bg-slate-200 overflow-hidden">
-            <div class="h-full bg-gradient-to-r from-primary to-accent" [style.width.%]="activeStudentCourse.progress || 0"></div>
-          </div>
+        <div class="mt-4 rounded-2xl bg-primary/[0.03] p-4">
+          <p class="text-sm font-semibold text-ink">Ready for your next step?</p>
+          <p class="mt-1 text-sm text-slate-700">Continue into the next governed lesson from exactly where your learning path left off.</p>
           <button
-            class="mt-4 w-full py-2 rounded-xl bg-primary text-white font-semibold"
+            class="mt-4 w-full rounded-xl bg-primary px-4 py-3 text-base font-semibold text-white shadow-soft-card transition hover:-translate-y-0.5 hover:bg-secondary"
             data-testid="student-continue-lesson"
+            aria-label="Continue your active lesson"
             (click)="startCourse(activeStudentCourse)"
           >
             Continue lesson
           </button>
+          <p class="mt-2 text-xs text-slate-600">You can safely return here after each lesson.</p>
         </div>
       </ng-container>
       <ng-template #noActive>
@@ -145,14 +172,14 @@ <h2 class="text-3xl font-bold">{{userInfo.fullname}}</h2>
           (action)="goToAvailableCourses()"
         ></app-echo-state-panel>
       </ng-template>
-    </div>
+    </section>
   </div>
 
   <div class="grid gap-4 grid-cols-1 lg:grid-cols-3">
-    <div class="surface-card p-6 lg:col-span-2">
-      <div class="flex items-center justify-between mb-4">
+    <section class="surface-card p-5 md:p-6 lg:col-span-2" aria-labelledby="student-courses-heading">
+      <div class="mb-4 flex flex-wrap items-center justify-between gap-3">
         <h3 class="text-xl font-bold text-primary">My Courses</h3>
-        <button class="text-sm text-primary underline" (click)="goToAvailableCourses()">Explore catalog</button>
+        <button class="text-sm font-semibold text-primary underline underline-offset-4" aria-label="Explore the full course catalog" (click)="goToAvailableCourses()">Explore catalog</button>
       </div>
       <app-echo-loading-state
         *ngIf="coursesLoading"
@@ -179,7 +206,7 @@ <h3 class="text-xl font-bold text-primary">My Courses</h3>
         actionLabel="Explore catalog"
         (action)="goToAvailableCourses()"
       ></app-echo-state-panel>
-      <div *ngIf="!coursesLoading && !coursesLoadError && studentCourses.length > 0" class="grid md:grid-cols-2 gap-4">
+      <div *ngIf="!coursesLoading && !coursesLoadError && studentCourses.length > 0" class="grid gap-4 md:grid-cols-2">
         <ng-container *ngFor="let sc of studentCourses">
           <app-student-course-card
             [title]="sc.course.title"
@@ -193,17 +220,17 @@ <h3 class="text-xl font-bold text-primary">My Courses</h3>
           >
             <app-echo-button
               *ngIf="sc.status !== 'completed'"
-              class="mt-2"
+              class="mt-3"
               color="primary"
-              label="Start / Resume"
+              [label]="getCourseActionLabel(sc)"
               (click)="startCourse(sc)"
             ></app-echo-button>
           </app-student-course-card>
         </ng-container>
       </div>
-    </div>
+    </section>
 
-    <div class="surface-card p-6">
+    <div class="surface-card p-5 md:p-6">
       <h3 class="text-xl font-bold text-primary mb-3">What's next</h3>
       <ul class="space-y-3">
         <li *ngFor="let item of demoTimeline" class="flex items-start gap-3">
@@ -219,13 +246,13 @@ <h3 class="text-xl font-bold text-primary mb-3">What's next</h3>
   </div>
 
   <div class="grid gap-4 grid-cols-1 lg:grid-cols-3">
-    <div class="surface-card p-6 lg:col-span-2">
-      <div class="flex items-center justify-between mb-4">
+    <div class="surface-card p-5 md:p-6 lg:col-span-2">
+      <div class="mb-4 flex flex-wrap items-center justify-between gap-3">
         <div>
           <h3 class="text-xl font-bold text-primary">Certification Paths</h3>
-          <p class="text-sm text-slate-600">Program progress now groups existing courses into structured outcomes.</p>
+          <p class="text-sm leading-6 text-slate-700">Program progress now groups existing courses into structured outcomes.</p>
         </div>
-        <button class="text-sm text-primary underline" (click)="goToPrograms()">Open all programs</button>
+        <button class="text-sm font-semibold text-primary underline underline-offset-4" (click)="goToPrograms()">Open all programs</button>
       </div>
       <div class="grid md:grid-cols-2 gap-4">
         <div *ngFor="let program of programs | slice:0:2" class="rounded-2xl border border-slate-200 bg-white p-4">
@@ -244,12 +271,12 @@ <h3 class="text-xl font-bold text-primary">Certification Paths</h3>
       </div>
     </div>
 
-    <div class="surface-card p-6 bg-gradient-to-br from-emerald-50 to-white">
-      <div class="flex items-center justify-between mb-3">
+    <div class="surface-card bg-gradient-to-br from-emerald-50 to-white p-5 md:p-6">
+      <div class="mb-3 flex flex-wrap items-center justify-between gap-3">
         <h3 class="text-xl font-bold text-primary">Certifications</h3>
-        <button class="text-sm text-primary underline" (click)="goToCertifications()">View all</button>
+        <button class="text-sm font-semibold text-primary underline underline-offset-4" (click)="goToCertifications()">View all</button>
       </div>
-      <div *ngIf="certifications.length === 0" class="text-sm text-slate-600">
+      <div *ngIf="certifications.length === 0" class="text-sm leading-6 text-slate-700">
         Complete required courses and assessments to unlock certifications.
       </div>
       <div *ngFor="let issued of certifications | slice:0:2" class="rounded-xl border border-emerald-100 bg-white p-4 mb-3">
@@ -260,8 +287,8 @@ <h3 class="text-xl font-bold text-primary">Certifications</h3>
   </div>
 
   <div class="grid gap-4 grid-cols-1 lg:grid-cols-3">
-    <div class="surface-card p-6 lg:col-span-2">
-      <div class="flex items-center justify-between mb-3">
+    <div class="surface-card p-5 md:p-6 lg:col-span-2">
+      <div class="mb-3 flex flex-wrap items-center justify-between gap-3">
         <h3 class="text-xl font-bold text-primary">Achievements & Streaks</h3>
         <span class="badge-soft">Motivation</span>
       </div>
@@ -301,7 +328,7 @@ <h4 class="text-sm font-semibold text-slate-600">Earned Badges</h4>
         </div>
       </div>
     </div>
-    <div class="surface-card p-6 bg-gradient-to-br from-primary/5 to-accent/10">
+    <div class="surface-card bg-gradient-to-br from-primary/5 to-accent/10 p-5 md:p-6">
       <h3 class="text-xl font-bold text-primary mb-3">Available Courses</h3>
       <div class="space-y-3">
         <ng-container *ngFor="let course of visibleAvailableCourses">
@@ -319,7 +346,7 @@ <h3 class="text-xl font-bold text-primary mb-3">Available Courses</h3>
       </div>
       <a
         *ngIf="availableCourses.length > 4"
-        class="inline-flex mt-3 text-primary underline cursor-pointer"
+        class="inline-flex mt-3 cursor-pointer font-semibold text-primary underline underline-offset-4"
         (click)="goToAvailableCourses()"
       >
         View More
diff --git a/frontend/src/app/pages/user-dashboard/student-view/student-view.component.scss b/frontend/src/app/pages/user-dashboard/student-view/student-view.component.scss
index e69de29..debbca1 100644
--- a/frontend/src/app/pages/user-dashboard/student-view/student-view.component.scss
+++ b/frontend/src/app/pages/user-dashboard/student-view/student-view.component.scss
@@ -0,0 +1,18 @@
+.student-dashboard {
+  min-width: 0;
+}
+
+.student-dashboard__hero,
+.student-dashboard__continuation {
+  min-width: 0;
+}
+
+.student-dashboard__status-pill {
+  white-space: nowrap;
+}
+
+@media (max-width: 767px) {
+  .student-dashboard__hero {
+    border-radius: 20px;
+  }
+}
diff --git a/frontend/src/app/pages/user-dashboard/student-view/student-view.component.spec.ts b/frontend/src/app/pages/user-dashboard/student-view/student-view.component.spec.ts
index eedacce..9026289 100644
--- a/frontend/src/app/pages/user-dashboard/student-view/student-view.component.spec.ts
+++ b/frontend/src/app/pages/user-dashboard/student-view/student-view.component.spec.ts
@@ -244,11 +244,14 @@ describe('StudentViewComponent', () => {
 
     const compiled = fixture.nativeElement as HTMLElement;
     expect(compiled.textContent).toContain('Active Learning Path');
+    expect(compiled.textContent).toContain('In progress');
     expect(compiled.textContent).toContain('Selected continuation');
     expect(compiled.textContent).toContain('Your next lesson is ready');
     expect(compiled.textContent).toContain('Keep your momentum with the next governed lesson.');
     expect(compiled.textContent).toContain('Steady progress matters');
     expect(compiled.textContent).toContain('Your effort is adding up.');
+    expect(compiled.textContent).toContain('Governed course progress');
+    expect(compiled.textContent).toContain('saves progress automatically');
   });
 
   it('renders remediation-aware continuation guidance when present', () => {
@@ -425,4 +428,17 @@ describe('StudentViewComponent', () => {
 
     expect(component.startCourse).toHaveBeenCalledWith(remediationCourse);
   });
+
+  it('uses clearer start and resume labels for course cards', () => {
+    coursesService.studentCoursesResponse = of([
+      buildStudentCourse({ id: 'course-start', title: 'New Course', status: 'enrolled', progress: 0 }),
+      buildStudentCourse({ id: 'course-resume', title: 'Resume Course', status: 'active', progress: 24 }),
+    ]);
+
+    fixture.detectChanges();
+
+    const compiled = fixture.nativeElement as HTMLElement;
+    expect(compiled.textContent).toContain('Start course');
+    expect(compiled.textContent).toContain('Resume lesson');
+  });
 });
diff --git a/frontend/src/app/pages/user-dashboard/student-view/student-view.component.ts b/frontend/src/app/pages/user-dashboard/student-view/student-view.component.ts
index c3bb601..4ac3787 100644
--- a/frontend/src/app/pages/user-dashboard/student-view/student-view.component.ts
+++ b/frontend/src/app/pages/user-dashboard/student-view/student-view.component.ts
@@ -76,6 +76,26 @@ export class StudentViewComponent implements OnInit {
     return this.availableCourses.slice(0, this.availableCoursesVisibleCount);
   }
 
+  get activeCourseProgress(): number {
+    return Math.max(0, Math.min(100, this.activeStudentCourse?.progress || 0));
+  }
+
+  get activeCourseStatusLabel(): string {
+    if (!this.activeStudentCourse) {
+      return '';
+    }
+
+    if (this.activeStudentCourse.status === 'completed') {
+      return 'Completed';
+    }
+
+    if (this.activeCourseProgress > 0) {
+      return 'In progress';
+    }
+
+    return 'Ready to begin';
+  }
+
   get allEnrolledCoursesCompleted(): boolean {
     return this.studentCourses.length > 0 && this.studentCourses.every((course) => course.status === 'completed');
   }
@@ -361,4 +381,10 @@ enrollInCourse(courseId: string): void {
   retryCourseLoad(): void {
     this.loadStudentCourses();
   }
+
+  getCourseActionLabel(course: StudentCourseWithDetails): string {
+    return (course.progress ?? 0) > 0 || course.status === 'active'
+      ? 'Resume lesson'
+      : 'Start course';
+  }
 }
diff --git a/openspec/changes/pilot-platform-hardening-phase-1/tasks.md b/openspec/changes/pilot-platform-hardening-phase-1/tasks.md
index 9c7296c..30ecfad 100644
--- a/openspec/changes/pilot-platform-hardening-phase-1/tasks.md
+++ b/openspec/changes/pilot-platform-hardening-phase-1/tasks.md
@@ -6,9 +6,9 @@
 
 ## 2. Student dashboard polish
 
-- [ ] 2.1 Audit the current student dashboard continuation path, active course card, and available-course surfaces against pilot readiness expectations
-- [ ] 2.2 Harden continuation, empty, and retry behavior so students can reliably understand their next governed learning step
-- [ ] 2.3 Verify the student can log in, see the active course, enter the lesson, and return safely without contradictory dashboard state
+- [x] 2.1 Audit the current student dashboard continuation path, active course card, and available-course surfaces against pilot readiness expectations
+- [x] 2.2 Harden continuation, empty, and retry behavior so students can reliably understand their next governed learning step
+- [x] 2.3 Verify the student can log in, see the active course, enter the lesson, and return safely without contradictory dashboard state
 
 ## 3. Lesson runtime polish
 

From 75fdd1818a500a1bf4cdfa51dd69b7ca158212e9 Mon Sep 17 00:00:00 2001
From: Anthony Wright <anthony@mrwrite.dev>
Date: Tue, 26 May 2026 15:30:04 -0500
Subject: [PATCH 03/14] feat: polish pilot lesson runtime

---
 .../src/app/pages/lesson-view.component.html  | 34 +++++---
 .../src/app/pages/lesson-view.component.scss  |  3 +
 .../app/pages/lesson-view.component.spec.ts   | 23 ++++++
 .../src/app/pages/lesson-view.component.ts    | 12 +++
 .../app/shared/lesson-viewer.component.html   | 81 ++++++++++++++-----
 .../app/shared/lesson-viewer.component.scss   | 11 +++
 .../shared/lesson-viewer.component.spec.ts    | 17 ++++
 .../src/app/shared/lesson-viewer.component.ts | 16 ++++
 .../pilot-platform-hardening-phase-1/tasks.md |  6 +-
 9 files changed, 170 insertions(+), 33 deletions(-)

diff --git a/frontend/src/app/pages/lesson-view.component.html b/frontend/src/app/pages/lesson-view.component.html
index 77804a4..911523c 100644
--- a/frontend/src/app/pages/lesson-view.component.html
+++ b/frontend/src/app/pages/lesson-view.component.html
@@ -1,18 +1,32 @@
 <main class="min-h-screen bg-gradient-to-br from-primary/5 via-white to-accent/10 py-6" aria-label="Lesson experience">
-  <div class="max-w-5xl mx-auto surface-card p-6">
-    <header class="flex items-center justify-between mb-4" aria-labelledby="lesson-page-title">
-      <div>
+  <div class="lesson-runtime mx-auto max-w-5xl surface-card p-4 md:p-6">
+    <header class="mb-5 flex flex-wrap items-start justify-between gap-4" aria-labelledby="lesson-page-title">
+      <div class="min-w-0">
         <p class="section-heading text-primary text-sm">Immersive Lesson</p>
         <h2 id="lesson-page-title" class="text-2xl font-bold text-ink">{{ lesson?.title || 'Preparing your next lesson' }}</h2>
-        <p class="muted-text">Step through each governed activity with clear focus and consistent learner guidance.</p>
+        <p class="mt-2 text-sm leading-6 text-slate-700">Step through each governed activity with clear focus and consistent learner guidance.</p>
+      </div>
+      <div class="flex flex-col items-stretch gap-3 sm:items-end">
+        <div class="flex flex-wrap gap-2" *ngIf="lesson">
+          <span class="rounded-full border border-primary/15 bg-primary/5 px-3 py-1 text-xs font-semibold uppercase tracking-[0.16em] text-primary">
+            {{ lessonStatusLabel }}
+          </span>
+          <span class="rounded-full border border-slate-200 bg-slate-50 px-3 py-1 text-xs font-semibold uppercase tracking-[0.16em] text-slate-700">
+            {{ lessonActivityCount }} activit<span *ngIf="lessonActivityCount !== 1">ies</span><span *ngIf="lessonActivityCount === 1">y</span>
+          </span>
+          <span *ngIf="lesson?.duration_minutes" class="rounded-full border border-slate-200 bg-slate-50 px-3 py-1 text-xs font-semibold uppercase tracking-[0.16em] text-slate-700">
+            {{ lesson?.duration_minutes }} min
+          </span>
+        </div>
+        <button aria-label="Exit lesson and return to dashboard" class="rounded-xl border border-primary bg-white px-4 py-2.5 text-sm font-semibold text-primary transition hover:bg-primary/5" (click)="returnToDashboard()">Exit lesson</button>
       </div>
-      <button aria-label="Exit lesson and return to dashboard" class="px-3 py-2 rounded-xl border border-primary text-primary font-semibold" (click)="returnToDashboard()">Exit lesson</button>
     </header>
 
-    <div class="flex flex-wrap items-center gap-3 mb-4 text-sm text-slate-600" *ngIf="lesson" aria-label="Lesson state">
-      <span class="px-3 py-1 rounded-full bg-primary/10 text-primary">Active segment</span>
-      <span class="px-3 py-1 rounded-full bg-accent/30 text-ink">Guided reading & activities</span>
-      <span *ngIf="demoMode" class="px-3 py-1 rounded-full bg-emerald-100 text-emerald-700">Demo preview</span>
+    <div class="mb-4 flex flex-wrap items-center gap-3 text-sm text-slate-700" *ngIf="lesson" aria-label="Lesson state">
+      <span class="rounded-full bg-primary/10 px-3 py-1 text-primary">Active segment</span>
+      <span class="rounded-full bg-accent/30 px-3 py-1 text-ink">Guided reading & activities</span>
+      <span class="rounded-full bg-slate-100 px-3 py-1 text-slate-700">Safe to return to dashboard at any time</span>
+      <span *ngIf="demoMode" class="rounded-full bg-emerald-100 px-3 py-1 text-emerald-700">Demo preview</span>
     </div>
 
     <app-echo-loading-state
@@ -58,7 +72,7 @@ <h2 id="lesson-page-title" class="text-2xl font-bold text-ink">{{ lesson?.title
 <app-echo-modal
   [open]="courseCompleted"
   title="Course completed!"
-  description="Return to the dashboard to explore more courses or review your progress."
+  description="You finished this governed lesson path. Return to the dashboard to review your progress or continue with your next available course."
   confirmText="Back to Dashboard"
   [showCancel]="false"
   (confirm)="returnToDashboard()"
diff --git a/frontend/src/app/pages/lesson-view.component.scss b/frontend/src/app/pages/lesson-view.component.scss
index e69de29..5c9991f 100644
--- a/frontend/src/app/pages/lesson-view.component.scss
+++ b/frontend/src/app/pages/lesson-view.component.scss
@@ -0,0 +1,3 @@
+.lesson-runtime {
+  min-width: 0;
+}
diff --git a/frontend/src/app/pages/lesson-view.component.spec.ts b/frontend/src/app/pages/lesson-view.component.spec.ts
index 8bb5db9..1a86a33 100644
--- a/frontend/src/app/pages/lesson-view.component.spec.ts
+++ b/frontend/src/app/pages/lesson-view.component.spec.ts
@@ -68,4 +68,27 @@ describe('LessonViewComponent', () => {
     expect(compiled.querySelector('[data-echo-loading="page"]')).not.toBeNull();
     expect(compiled.textContent).toContain('Preparing lesson delivery');
   });
+
+  it('preserves the learner-safe exit control label used by the smoke flow', () => {
+    const coursesService = TestBed.inject(CoursesService) as unknown as MockCoursesService;
+    coursesService.getCurrentSegment.and.returnValue(of({
+      delivery_state: 'governed_available',
+      lesson_id: 'lesson-1',
+      unit_progress_id: 'student-unit-1',
+    }));
+    coursesService.getLessonById.and.returnValue(of({
+      id: 'lesson-1',
+      title: 'Introduction to Africa',
+      activities: [{ title: 'Warm Up', type: 'story', content: 'Read together.' }],
+    }));
+
+    fixture = TestBed.createComponent(LessonViewComponent);
+    component = fixture.componentInstance;
+    fixture.detectChanges();
+
+    const exitButton = Array.from(fixture.nativeElement.querySelectorAll('button'))
+      .find((button) => (button as HTMLButtonElement).getAttribute('aria-label') === 'Exit lesson and return to dashboard') as HTMLButtonElement;
+
+    expect(exitButton).not.toBeNull();
+  });
 });
diff --git a/frontend/src/app/pages/lesson-view.component.ts b/frontend/src/app/pages/lesson-view.component.ts
index 2c8718c..72f4f7d 100644
--- a/frontend/src/app/pages/lesson-view.component.ts
+++ b/frontend/src/app/pages/lesson-view.component.ts
@@ -42,6 +42,18 @@ export class LessonViewComponent implements OnInit {
     return this.governedDeliveryDetail || 'This lesson is not currently available for governed learner delivery. Return to your dashboard and try again later.';
   }
 
+  get lessonActivityCount(): number {
+    return this.lesson?.activities?.length || 0;
+  }
+
+  get lessonStatusLabel(): string {
+    if (this.demoMode) {
+      return 'Demo preview';
+    }
+
+    return 'Governed delivery';
+  }
+
   constructor(
     private route: ActivatedRoute,
     private coursesService: CoursesService,
diff --git a/frontend/src/app/shared/lesson-viewer.component.html b/frontend/src/app/shared/lesson-viewer.component.html
index 7359fb9..685ad56 100644
--- a/frontend/src/app/shared/lesson-viewer.component.html
+++ b/frontend/src/app/shared/lesson-viewer.component.html
@@ -1,8 +1,46 @@
-<article class="lesson-viewer p-4 md:p-6 bg-white rounded-xl shadow space-y-6" aria-label="Lesson viewer">
-  <header class="space-y-3">
-    <h2 class="text-2xl font-bold text-[#1A1A40]">{{ lesson.title }}</h2>
-    <p class="text-sm text-gray-600" *ngIf="lesson.objective">{{ lesson.objective }}</p>
-    <p class="text-xs text-gray-500" *ngIf="lesson.duration_minutes">Duration: {{ lesson.duration_minutes }} minutes</p>
+<article class="lesson-viewer space-y-6 rounded-2xl bg-white p-4 shadow md:p-6" aria-label="Lesson viewer">
+  <header class="space-y-4">
+    <div class="flex flex-wrap items-start justify-between gap-3">
+      <div class="min-w-0">
+        <h2 class="text-2xl font-bold text-[#1A1A40]">{{ lesson.title }}</h2>
+        <p class="mt-2 text-sm leading-6 text-slate-700" *ngIf="lesson.objective">{{ lesson.objective }}</p>
+      </div>
+      <div class="lesson-viewer__meta flex flex-wrap gap-2">
+        <span *ngIf="lesson.duration_minutes" class="rounded-full border border-slate-200 bg-slate-50 px-3 py-1 text-xs font-semibold uppercase tracking-[0.16em] text-slate-700">
+          {{ lesson.duration_minutes }} min
+        </span>
+        <span class="rounded-full border border-primary/15 bg-primary/5 px-3 py-1 text-xs font-semibold uppercase tracking-[0.16em] text-primary">
+          {{ activityCount }} activit<span *ngIf="activityCount !== 1">ies</span><span *ngIf="activityCount === 1">y</span>
+        </span>
+      </div>
+    </div>
+
+    <section class="lesson-viewer__progress rounded-2xl border border-slate-200 bg-slate-50 p-4" aria-labelledby="lesson-progress-heading">
+      <div class="flex flex-wrap items-center justify-between gap-3">
+        <div>
+          <p id="lesson-progress-heading" class="text-xs font-semibold uppercase tracking-[0.2em] text-primary">Activity progress</p>
+          <p class="mt-1 text-sm text-slate-700">
+            Activity {{ currentActivityIndex + 1 }} of {{ activityCount }}.
+            <span *ngIf="!isLastActivity">Move at your own pace and continue when you are ready.</span>
+            <span *ngIf="isLastActivity">You are on the final activity for this lesson.</span>
+          </p>
+        </div>
+        <p class="text-right text-sm font-semibold text-slate-700" role="status" aria-live="polite">
+          {{ activityProgressPercent }}% complete
+        </p>
+      </div>
+      <div class="mt-3 h-2.5 overflow-hidden rounded-full bg-slate-200">
+        <div
+          class="h-full rounded-full bg-gradient-to-r from-primary to-accent"
+          role="progressbar"
+          aria-label="Lesson activity progress"
+          [attr.aria-valuenow]="activityProgressPercent"
+          aria-valuemin="0"
+          aria-valuemax="100"
+          [style.width.%]="activityProgressPercent"
+        ></div>
+      </div>
+    </section>
 
     <div class="rounded-2xl border border-primary/10 bg-primary/[0.03] p-4 space-y-3" *ngIf="lesson.learning_objectives || (lesson.key_concepts?.length ?? 0) > 0">
       <div *ngIf="lesson.learning_objectives">
@@ -43,15 +81,18 @@ <h3 id="discussion-questions-heading" class="text-xs font-semibold uppercase tra
     </section>
   </header>
 
-  <section *ngIf="currentActivity" class="border-t pt-4 space-y-3" aria-labelledby="current-activity-title">
+  <section *ngIf="currentActivity" class="lesson-viewer__activity border-t pt-5 space-y-4" aria-labelledby="current-activity-title">
     <div class="flex flex-wrap items-center justify-between gap-3">
-      <h3 id="current-activity-title" class="font-semibold text-lg text-ink">{{ currentActivity.title }}</h3>
-      <p class="rounded-full bg-slate-100 px-3 py-1 text-xs font-semibold text-slate-600" role="status" aria-live="polite">
+      <div class="min-w-0">
+        <p class="text-xs font-semibold uppercase tracking-[0.18em] text-slate-500">Current activity</p>
+        <h3 id="current-activity-title" class="mt-1 font-semibold text-lg text-ink">{{ currentActivity.title }}</h3>
+      </div>
+      <p class="rounded-full border border-slate-200 bg-slate-100 px-3 py-1 text-xs font-semibold text-slate-700" role="status" aria-live="polite">
         Activity {{ currentActivityIndex + 1 }} of {{ lesson.activities.length }}
       </p>
     </div>
 
-    <div class="text-sm">
+    <div class="lesson-viewer__activity-body rounded-2xl border border-slate-200 bg-white p-4 text-sm md:p-5">
       <ng-container [ngSwitch]="currentActivity.type">
         <div *ngSwitchCase="'video'">
           <ng-container *ngIf="isYouTubeLink(currentActivity.content); else standardVideo">
@@ -83,24 +124,24 @@ <h3 id="current-activity-title" class="font-semibold text-lg text-ink">{{ curren
           <audio class="w-full" controls [src]="currentActivity.content"></audio>
         </div>
         <div *ngSwitchCase="'story'">
-          <div class="rounded-xl border border-slate-200 bg-slate-50 p-4 text-sm leading-relaxed text-slate-700">
+          <div class="rounded-xl border border-slate-200 bg-slate-50 p-4 text-sm leading-7 text-slate-700">
             {{ currentActivity.content }}
           </div>
         </div>
         <div *ngSwitchCase="'reflection'">
-          <p class="text-sm text-slate-600 mb-2">{{ currentActivity.content }}</p>
+          <p class="mb-2 text-sm leading-6 text-slate-700">{{ currentActivity.content }}</p>
           <textarea
             rows="4"
             [(ngModel)]="reflectionResponse"
-            class="w-full rounded-xl border border-slate-200 px-3 py-2 text-sm"
+            class="w-full rounded-xl border border-slate-200 px-3 py-2 text-sm leading-6"
             aria-label="Reflection response"
             placeholder="Share your reflection..."
           ></textarea>
         </div>
         <div *ngSwitchCase="'checkpoint'">
           <div class="rounded-xl border border-slate-200 bg-white p-4 text-sm text-slate-700">
-            <p class="font-semibold text-ink mb-2">Checkpoint</p>
-            <p>{{ currentActivity.content }}</p>
+            <p class="mb-2 font-semibold text-ink">Checkpoint</p>
+            <p class="leading-6">{{ currentActivity.content }}</p>
           </div>
         </div>
         <div *ngSwitchCase="'quiz'">
@@ -130,24 +171,24 @@ <h3 id="current-activity-title" class="font-semibold text-lg text-ink">{{ curren
           </ng-template>
         </div>
         <div *ngSwitchDefault>
-          <p>{{ currentActivity.content }}</p>
+          <p class="leading-6 text-slate-700">{{ currentActivity.content }}</p>
         </div>
       </ng-container>
     </div>
   </section>
 
-  <nav class="pt-4 flex justify-end space-x-2" aria-label="Lesson activity navigation">
+  <nav class="lesson-viewer__actions flex flex-wrap justify-end gap-3 border-t pt-4" aria-label="Lesson activity navigation">
     <button
-      *ngIf="currentActivityIndex < lesson.activities.length - 1"
-      class="px-4 py-2 rounded bg-blue-600 text-white hover:bg-blue-700"
+      *ngIf="!isLastActivity"
+      class="rounded-xl bg-primary px-4 py-3 text-sm font-semibold text-white shadow-soft-card transition hover:-translate-y-0.5 hover:bg-secondary"
       aria-label="Go to the next lesson activity"
       (click)="goToNextActivity()"
     >
       Next Activity
     </button>
     <button
-      *ngIf="currentActivityIndex === lesson.activities.length - 1"
-      class="px-4 py-2 rounded bg-green-600 text-white hover:bg-green-700"
+      *ngIf="isLastActivity"
+      class="rounded-xl bg-emerald-600 px-4 py-3 text-sm font-semibold text-white shadow-soft-card transition hover:-translate-y-0.5 hover:bg-emerald-700"
       [attr.aria-label]="isTeacherLed ? 'Mark lesson delivered' : 'Complete lesson'"
       (click)="onMarkComplete()"
     >
diff --git a/frontend/src/app/shared/lesson-viewer.component.scss b/frontend/src/app/shared/lesson-viewer.component.scss
index 85eafa7..83696fb 100644
--- a/frontend/src/app/shared/lesson-viewer.component.scss
+++ b/frontend/src/app/shared/lesson-viewer.component.scss
@@ -1,3 +1,14 @@
 .lesson-viewer {
   border: 1px solid rgba(15, 23, 42, 0.06);
 }
+
+.lesson-viewer__activity-body,
+.lesson-viewer__progress {
+  min-width: 0;
+}
+
+@media (max-width: 767px) {
+  .lesson-viewer__actions button {
+    width: 100%;
+  }
+}
diff --git a/frontend/src/app/shared/lesson-viewer.component.spec.ts b/frontend/src/app/shared/lesson-viewer.component.spec.ts
index 8bdce7a..3596e38 100644
--- a/frontend/src/app/shared/lesson-viewer.component.spec.ts
+++ b/frontend/src/app/shared/lesson-viewer.component.spec.ts
@@ -112,4 +112,21 @@ describe('LessonViewerComponent', () => {
     expect(text).toContain('Reflection Prompt');
     expect(text).toContain('Activity 2 of 3');
   });
+
+  it('renders a lesson activity progress bar for learner continuity', () => {
+    component.lesson = {
+      ...component.lesson,
+      activities: [
+        { title: 'Story Prompt', type: 'story', content: 'Listen for a clue.' } as any,
+        { title: 'Wrap Up', type: 'checkpoint', content: 'Share one key idea.' } as any,
+      ],
+    };
+
+    fixture.detectChanges();
+
+    const progressbar = fixture.nativeElement.querySelector('[aria-label="Lesson activity progress"]') as HTMLElement;
+    expect(progressbar).not.toBeNull();
+    expect(progressbar.getAttribute('aria-valuenow')).toBe('50');
+    expect(fixture.nativeElement.textContent).toContain('50% complete');
+  });
 });
diff --git a/frontend/src/app/shared/lesson-viewer.component.ts b/frontend/src/app/shared/lesson-viewer.component.ts
index 5115e5b..397da0c 100644
--- a/frontend/src/app/shared/lesson-viewer.component.ts
+++ b/frontend/src/app/shared/lesson-viewer.component.ts
@@ -36,6 +36,22 @@ export class LessonViewerComponent implements OnChanges {
     return this.lesson?.activities[this.currentActivityIndex];
   }
 
+  get activityCount(): number {
+    return this.lesson?.activities?.length || 0;
+  }
+
+  get activityProgressPercent(): number {
+    if (!this.activityCount) {
+      return 0;
+    }
+
+    return Math.round(((this.currentActivityIndex + 1) / this.activityCount) * 100);
+  }
+
+  get isLastActivity(): boolean {
+    return this.currentActivityIndex === this.activityCount - 1;
+  }
+
   get instructionalSections(): Array<{ label: string; content?: string }> {
     return [
       { label: 'Hook', content: this.lesson?.hook },
diff --git a/openspec/changes/pilot-platform-hardening-phase-1/tasks.md b/openspec/changes/pilot-platform-hardening-phase-1/tasks.md
index 30ecfad..d341b75 100644
--- a/openspec/changes/pilot-platform-hardening-phase-1/tasks.md
+++ b/openspec/changes/pilot-platform-hardening-phase-1/tasks.md
@@ -12,9 +12,9 @@
 
 ## 3. Lesson runtime polish
 
-- [ ] 3.1 Audit the lesson runtime entry, governed blocked state, error recovery, and exit-to-dashboard behavior for readability and continuity
-- [ ] 3.2 Harden lesson runtime state rendering so loading, blocked, error, and completed outcomes remain distinct and user-friendly
-- [ ] 3.3 Verify the lesson runtime preserves governed delivery semantics and safe navigation across refresh and return flows
+- [x] 3.1 Audit the lesson runtime entry, governed blocked state, error recovery, and exit-to-dashboard behavior for readability and continuity
+- [x] 3.2 Harden lesson runtime state rendering so loading, blocked, error, and completed outcomes remain distinct and user-friendly
+- [x] 3.3 Verify the lesson runtime preserves governed delivery semantics and safe navigation across refresh and return flows
 
 ## 4. Teacher dashboard baseline polish
 

From 153aa6a283bf713859f97773fd7339cb8645f81a Mon Sep 17 00:00:00 2001
From: Anthony Wright <anthony@mrwrite.dev>
Date: Tue, 26 May 2026 16:08:57 -0500
Subject: [PATCH 04/14] feat: polish pilot teacher dashboard

---
 .../teacher-view/teacher-view.component.html  | 404 +++++++++++-------
 .../teacher-view/teacher-view.component.scss  | 131 ++++++
 .../pilot-platform-hardening-phase-1/tasks.md |   6 +-
 3 files changed, 373 insertions(+), 168 deletions(-)

diff --git a/frontend/src/app/pages/user-dashboard/teacher-view/teacher-view.component.html b/frontend/src/app/pages/user-dashboard/teacher-view/teacher-view.component.html
index 53a3e2e..3b313f7 100644
--- a/frontend/src/app/pages/user-dashboard/teacher-view/teacher-view.component.html
+++ b/frontend/src/app/pages/user-dashboard/teacher-view/teacher-view.component.html
@@ -1,36 +1,75 @@
-<div class="space-y-6">
-  <div class="surface-card p-6 bg-gradient-to-br from-primary/90 to-secondary text-white">
-    <div class="flex items-start justify-between">
-      <div>
-        <p class="text-sm uppercase tracking-[0.2em] text-on-dark-muted">Teacher Control Center</p>
-        <h2 class="text-3xl font-bold">Welcome, {{userInfo.fullname}}</h2>
-        <p class="text-on-dark">Monitor the flagship class story, review governance signals, and keep the live demo on a stable path.</p>
-      </div>
-      <span class="px-3 py-1 rounded-full bg-white/20 text-xs font-semibold">Demo ready</span>
-    </div>
-    <div class="grid sm:grid-cols-3 gap-4 mt-6">
-      <div class="p-4 rounded-xl bg-white/10 border border-white/15">
-        <p class="text-on-dark-muted">Active courses</p>
-        <p class="text-2xl font-bold">{{ courses.length }}</p>
-      </div>
-      <div class="p-4 rounded-xl bg-white/10 border border-white/15">
-        <p class="text-on-dark-muted">In progress lessons</p>
-        <p class="text-2xl font-bold">{{ inProgressLessons }}</p>
-      </div>
-      <div class="p-4 rounded-xl bg-white/10 border border-white/15">
-        <p class="text-on-dark-muted">Average completion</p>
-        <p class="text-2xl font-bold">{{ averageCompletion }}%</p>
+<div class="teacher-dashboard space-y-6">
+  <section class="surface-card overflow-hidden bg-gradient-to-br from-primary/95 via-primary/90 to-secondary p-6 text-white md:p-7" aria-labelledby="teacher-dashboard-title">
+    <div class="grid gap-5 xl:grid-cols-[minmax(0,1.8fr)_minmax(18rem,1fr)] xl:items-start">
+      <div class="space-y-4">
+        <div class="flex flex-wrap items-start justify-between gap-3">
+          <div class="max-w-3xl">
+            <p class="text-sm uppercase tracking-[0.2em] text-on-dark-muted">Teacher Control Center</p>
+            <h2 id="teacher-dashboard-title" class="mt-2 text-3xl font-bold leading-tight">Welcome, {{userInfo.fullname}}</h2>
+            <p class="mt-3 max-w-2xl text-sm leading-6 text-on-dark md:text-base">
+              Monitor the flagship class story, review governance signals, and keep the live demo on a stable path.
+            </p>
+          </div>
+          <span class="teacher-dashboard__hero-badge rounded-full bg-white/20 px-3 py-1 text-xs font-semibold">Demo ready</span>
+        </div>
+
+        <div class="grid gap-4 sm:grid-cols-3">
+          <div class="rounded-xl border border-white/15 bg-white/10 p-4">
+            <p class="text-on-dark-muted">Active courses</p>
+            <p class="text-2xl font-bold">{{ courses.length }}</p>
+          </div>
+          <div class="rounded-xl border border-white/15 bg-white/10 p-4">
+            <p class="text-on-dark-muted">In progress lessons</p>
+            <p class="text-2xl font-bold">{{ inProgressLessons }}</p>
+          </div>
+          <div class="rounded-xl border border-white/15 bg-white/10 p-4">
+            <p class="text-on-dark-muted">Average completion</p>
+            <p class="text-2xl font-bold">{{ averageCompletion }}%</p>
+          </div>
+        </div>
       </div>
+
+      <aside class="teacher-dashboard__hero-panel rounded-2xl border border-white/15 bg-slate-950/20 p-5">
+        <div class="flex flex-wrap items-start justify-between gap-3">
+          <div>
+            <p class="text-xs font-semibold uppercase tracking-[0.18em] text-on-dark-muted">Pilot demonstration focus</p>
+            <p class="mt-2 text-lg font-semibold">{{ flagshipCourse?.title || 'Introduction to Africa flagship pathway' }}</p>
+          </div>
+          <span class="rounded-full border border-white/20 bg-white/10 px-3 py-1 text-xs font-semibold uppercase tracking-[0.16em]">
+            {{ flagshipCourse ? 'Flagship visible' : 'Read-only mode' }}
+          </span>
+        </div>
+        <p class="mt-3 text-sm leading-6 text-on-dark">
+          Keep the walkthrough centered on course visibility, learner progress, and governed runtime context. Destructive or off-script actions remain secondary.
+        </p>
+        <div class="mt-4 grid gap-3 sm:grid-cols-2 xl:grid-cols-1">
+          <div class="rounded-xl border border-white/15 bg-white/10 px-4 py-3">
+            <p class="text-xs font-semibold uppercase tracking-[0.16em] text-on-dark-muted">Flagship runtime</p>
+            <p class="mt-2 text-sm font-semibold">{{ flagshipCourse ? 'Available for narration' : 'Waiting for flagship course data' }}</p>
+          </div>
+          <div class="rounded-xl border border-white/15 bg-white/10 px-4 py-3">
+            <p class="text-xs font-semibold uppercase tracking-[0.16em] text-on-dark-muted">Teacher confidence</p>
+            <p class="mt-2 text-sm font-semibold">Loading, retry, and empty states stay bounded and presentation-safe.</p>
+          </div>
+        </div>
+      </aside>
     </div>
-  </div>
+  </section>
 
-  <div class="grid gap-4 grid-cols-1 lg:grid-cols-3">
-    <div class="surface-card p-6 lg:col-span-2">
-      <div class="flex items-center justify-between mb-4">
-        <h3 class="text-xl font-bold text-primary">Course Management</h3>
-        <span class="rounded-full border border-slate-200 bg-slate-50 px-3 py-1 text-xs font-semibold uppercase tracking-[0.16em] text-slate-500">Demo-safe view</span>
+  <div class="grid grid-cols-1 gap-4 lg:grid-cols-3">
+    <section class="surface-card p-6 lg:col-span-2" aria-labelledby="teacher-course-management-heading">
+      <div class="teacher-dashboard__section-heading mb-4">
+        <div class="space-y-2">
+          <div class="flex flex-wrap items-center justify-between gap-3">
+            <h3 id="teacher-course-management-heading" class="text-xl font-bold text-primary">Course Management</h3>
+            <span class="rounded-full border border-slate-200 bg-slate-50 px-3 py-1 text-xs font-semibold uppercase tracking-[0.16em] text-slate-600">Demo-safe view</span>
+          </div>
+          <p class="text-sm leading-6 text-slate-700">
+            The recommended live demo stays on read-only course visibility and governance context. Off-script catalog actions are intentionally de-emphasized here.
+          </p>
+        </div>
       </div>
-      <p class="mb-4 text-sm text-slate-600">The recommended live demo stays on read-only course visibility and governance context. Off-script catalog actions are intentionally de-emphasized here.</p>
+
       <app-echo-loading-state
         *ngIf="coursesLoading"
         density="section"
@@ -55,40 +94,59 @@ <h3 class="text-xl font-bold text-primary">Course Management</h3>
         body="Create a course to begin assigning and managing instruction."
       ></app-echo-state-panel>
       <ng-container *ngIf="!coursesLoading && !coursesError && courses.length > 0">
-        <div class="hidden md:block overflow-x-auto">
+        <div class="hidden overflow-x-auto md:block">
           <table class="w-full text-sm">
             <thead>
-              <tr class="text-left text-slate-500 border-b">
+              <tr class="border-b text-left text-slate-500">
                 <th class="py-2">Title</th>
-                <th class="py-2">Actions</th>
+                <th class="py-2">Status</th>
+                <th class="py-2 text-right">Actions</th>
               </tr>
             </thead>
             <tbody class="divide-y divide-slate-100">
               <tr *ngFor="let course of visibleCourses" class="hover:bg-slate-50">
                 <td class="py-3 font-semibold text-ink">{{ course.title }}</td>
-                <td class="py-3 space-x-2 text-right">
-                  <button class="text-sm text-primary font-semibold" (click)="onManageCourse(course.id)">Manage</button>
+                <td class="py-3">
+                  <span
+                    class="inline-flex rounded-full border px-3 py-1 text-xs font-semibold uppercase tracking-[0.16em]"
+                    [ngClass]="flagshipCourse?.id === course.id ? 'border-primary/20 bg-primary/5 text-primary' : 'border-slate-200 bg-white text-slate-700'"
+                  >
+                    {{ flagshipCourse?.id === course.id ? 'Flagship course' : 'Visible in teacher view' }}
+                  </span>
+                </td>
+                <td class="py-3 text-right">
+                  <button class="teacher-dashboard__link-button text-sm font-semibold text-primary" (click)="onManageCourse(course.id)">Manage</button>
                 </td>
               </tr>
             </tbody>
           </table>
         </div>
-        <div class="md:hidden space-y-3" data-educator-responsive="teacher-courses">
-          <article *ngFor="let course of visibleCourses" class="rounded-2xl border border-slate-200 bg-slate-50 p-4">
-            <p class="text-xs font-semibold uppercase tracking-[0.18em] text-primary">Course</p>
-            <p class="mt-2 font-semibold text-ink">{{ course.title }}</p>
+        <div class="space-y-3 md:hidden" data-educator-responsive="teacher-courses">
+          <article *ngFor="let course of visibleCourses" class="rounded-2xl border border-slate-200 bg-slate-50 p-4 shadow-sm">
+            <div class="flex flex-wrap items-start justify-between gap-3">
+              <div>
+                <p class="text-xs font-semibold uppercase tracking-[0.18em] text-primary">Course</p>
+                <p class="mt-2 font-semibold text-ink">{{ course.title }}</p>
+              </div>
+              <span
+                class="inline-flex rounded-full border px-3 py-1 text-xs font-semibold uppercase tracking-[0.16em]"
+                [ngClass]="flagshipCourse?.id === course.id ? 'border-primary/20 bg-primary/5 text-primary' : 'border-slate-200 bg-white text-slate-700'"
+              >
+                {{ flagshipCourse?.id === course.id ? 'Flagship course' : 'Visible in teacher view' }}
+              </span>
+            </div>
             <div class="mt-3 flex flex-wrap gap-3">
-              <button class="text-sm text-primary font-semibold" (click)="onManageCourse(course.id)">Manage</button>
+              <button class="teacher-dashboard__link-button text-sm font-semibold text-primary" (click)="onManageCourse(course.id)">Manage</button>
             </div>
           </article>
         </div>
-        <a *ngIf="courses.length > visibleCount" class="text-primary underline cursor-pointer text-sm" (click)="viewAllCourses()">View More</a>
+        <a *ngIf="courses.length > visibleCount" class="teacher-dashboard__text-link mt-4 inline-flex cursor-pointer items-center gap-2 text-sm text-primary" (click)="viewAllCourses()">View More</a>
       </ng-container>
 
       <div class="mt-6 border-t border-slate-100 pt-5">
-        <div class="mb-4">
+        <div class="teacher-dashboard__subsection-heading mb-4">
           <h4 class="text-base font-semibold text-ink">Publish readiness</h4>
-          <p class="text-sm text-slate-600">Read-only readiness checks for the visible educator course set.</p>
+          <p class="text-sm leading-6 text-slate-600">Read-only readiness checks for the visible educator course set.</p>
         </div>
 
         <app-echo-loading-state
@@ -116,11 +174,7 @@ <h4 class="text-base font-semibold text-ink">Publish readiness</h4>
         ></app-echo-state-panel>
 
         <div *ngIf="!publishReadinessLoading && !publishReadinessError && courseReadiness.length > 0" class="space-y-3">
-          <article
-            *ngFor="let readiness of courseReadiness"
-            class="rounded-2xl border border-slate-200 bg-white p-4"
-            data-publish-readiness-row
-          >
+          <article *ngFor="let readiness of courseReadiness" class="rounded-2xl border border-slate-200 bg-white p-4 shadow-sm" data-publish-readiness-row>
             <div class="flex flex-wrap items-start justify-between gap-3">
               <div>
                 <p class="font-semibold text-ink">{{ readiness.course_title }}</p>
@@ -129,10 +183,7 @@ <h4 class="text-base font-semibold text-ink">Publish readiness</h4>
                   &bull; {{ readiness.warning_count }} warning<span *ngIf="readiness.warning_count !== 1">s</span>
                 </p>
               </div>
-              <span
-                class="inline-flex rounded-full px-3 py-1 text-xs font-semibold uppercase tracking-[0.16em]"
-                [ngClass]="readinessStateClasses(readiness.is_ready)"
-              >
+              <span class="inline-flex rounded-full px-3 py-1 text-xs font-semibold uppercase tracking-[0.16em]" [ngClass]="readinessStateClasses(readiness.is_ready)">
                 {{ readinessStateLabel(readiness.is_ready) }}
               </span>
             </div>
@@ -159,9 +210,9 @@ <h4 class="text-base font-semibold text-ink">Publish readiness</h4>
       </div>
 
       <div class="mt-6 border-t border-slate-100 pt-5">
-        <div class="mb-4">
+        <div class="teacher-dashboard__subsection-heading mb-4">
           <h4 class="text-base font-semibold text-ink">Safe publish validation</h4>
-          <p class="text-sm text-slate-600">Read-only learner-safety checks for the visible educator course set.</p>
+          <p class="text-sm leading-6 text-slate-600">Read-only learner-safety checks for the visible educator course set.</p>
         </div>
 
         <app-echo-loading-state
@@ -189,11 +240,7 @@ <h4 class="text-base font-semibold text-ink">Safe publish validation</h4>
         ></app-echo-state-panel>
 
         <div *ngIf="!safePublishLoading && !safePublishError && safePublishValidations.length > 0" class="space-y-3">
-          <article
-            *ngFor="let validation of safePublishValidations"
-            class="rounded-2xl border border-slate-200 bg-white p-4"
-            data-safe-publish-row
-          >
+          <article *ngFor="let validation of safePublishValidations" class="rounded-2xl border border-slate-200 bg-white p-4 shadow-sm" data-safe-publish-row>
             <div class="flex flex-wrap items-start justify-between gap-3">
               <div>
                 <p class="font-semibold text-ink">{{ validation.course_title }}</p>
@@ -202,10 +249,7 @@ <h4 class="text-base font-semibold text-ink">Safe publish validation</h4>
                   &bull; {{ validation.warning_count }} warning<span *ngIf="validation.warning_count !== 1">s</span>
                 </p>
               </div>
-              <span
-                class="inline-flex rounded-full px-3 py-1 text-xs font-semibold uppercase tracking-[0.16em]"
-                [ngClass]="validation.is_safe ? 'bg-emerald-100 text-emerald-900 border border-emerald-200' : 'bg-rose-100 text-rose-900 border border-rose-200'"
-              >
+              <span class="inline-flex rounded-full px-3 py-1 text-xs font-semibold uppercase tracking-[0.16em]" [ngClass]="validation.is_safe ? 'bg-emerald-100 text-emerald-900 border border-emerald-200' : 'bg-rose-100 text-rose-900 border border-rose-200'">
                 {{ safePublishStateLabel(validation.is_safe) }}
               </span>
             </div>
@@ -232,9 +276,9 @@ <h4 class="text-base font-semibold text-ink">Safe publish validation</h4>
       </div>
 
       <div class="mt-6 border-t border-slate-100 pt-5">
-        <div class="mb-4">
+        <div class="teacher-dashboard__subsection-heading mb-4">
           <h4 class="text-base font-semibold text-ink">Competency evidence integrity</h4>
-          <p class="text-sm text-slate-600">Read-only mastery explainability checks for the visible educator course set.</p>
+          <p class="text-sm leading-6 text-slate-600">Read-only mastery explainability checks for the visible educator course set.</p>
         </div>
 
         <app-echo-loading-state
@@ -262,11 +306,7 @@ <h4 class="text-base font-semibold text-ink">Competency evidence integrity</h4>
         ></app-echo-state-panel>
 
         <div *ngIf="!competencyIntegrityLoading && !competencyIntegrityError && competencyIntegrities.length > 0" class="space-y-3">
-          <article
-            *ngFor="let integrity of competencyIntegrities"
-            class="rounded-2xl border border-slate-200 bg-white p-4"
-            data-competency-integrity-row
-          >
+          <article *ngFor="let integrity of competencyIntegrities" class="rounded-2xl border border-slate-200 bg-white p-4 shadow-sm" data-competency-integrity-row>
             <div class="flex flex-wrap items-start justify-between gap-3">
               <div>
                 <p class="font-semibold text-ink">{{ integrity.course_title }}</p>
@@ -276,16 +316,10 @@ <h4 class="text-base font-semibold text-ink">Competency evidence integrity</h4>
                 </p>
               </div>
               <div class="flex flex-wrap gap-2">
-                <span
-                  class="inline-flex rounded-full px-3 py-1 text-xs font-semibold uppercase tracking-[0.16em]"
-                  [ngClass]="integrity.is_valid ? 'bg-emerald-100 text-emerald-900 border border-emerald-200' : 'bg-rose-100 text-rose-900 border border-rose-200'"
-                >
+                <span class="inline-flex rounded-full px-3 py-1 text-xs font-semibold uppercase tracking-[0.16em]" [ngClass]="integrity.is_valid ? 'bg-emerald-100 text-emerald-900 border border-emerald-200' : 'bg-rose-100 text-rose-900 border border-rose-200'">
                   {{ competencyIntegrityStateLabel(integrity.is_valid) }}
                 </span>
-                <span
-                  class="inline-flex rounded-full px-3 py-1 text-xs font-semibold uppercase tracking-[0.16em]"
-                  [ngClass]="integrity.is_explainable ? 'bg-sky-100 text-sky-900 border border-sky-200' : 'bg-amber-100 text-amber-900 border border-amber-200'"
-                >
+                <span class="inline-flex rounded-full px-3 py-1 text-xs font-semibold uppercase tracking-[0.16em]" [ngClass]="integrity.is_explainable ? 'bg-sky-100 text-sky-900 border border-sky-200' : 'bg-amber-100 text-amber-900 border border-amber-200'">
                   {{ competencyExplainabilityLabel(integrity.is_explainable) }}
                 </span>
               </div>
@@ -330,9 +364,9 @@ <h4 class="text-base font-semibold text-ink">Competency evidence integrity</h4>
       </div>
 
       <div class="mt-6 border-t border-slate-100 pt-5">
-        <div class="mb-4">
+        <div class="teacher-dashboard__subsection-heading mb-4">
           <h4 class="text-base font-semibold text-ink">Runtime intervention recommendations</h4>
-          <p class="text-sm text-slate-600">Course-level recommendation detail for each learner, including evidence basis, confidence, and caution flags.</p>
+          <p class="text-sm leading-6 text-slate-600">Course-level recommendation detail for each learner, including evidence basis, confidence, and caution flags.</p>
         </div>
 
         <app-echo-loading-state
@@ -360,11 +394,7 @@ <h4 class="text-base font-semibold text-ink">Runtime intervention recommendation
         ></app-echo-state-panel>
 
         <div *ngIf="!runtimeInterventionLoading && !runtimeInterventionError && runtimeInterventionGroups.length > 0" class="space-y-4">
-          <section
-            *ngFor="let group of runtimeInterventionGroups"
-            class="rounded-2xl border border-slate-200 bg-white p-4"
-            data-runtime-intervention-course
-          >
+          <section *ngFor="let group of runtimeInterventionGroups" class="rounded-2xl border border-slate-200 bg-white p-4 shadow-sm" data-runtime-intervention-course>
             <div class="flex flex-wrap items-start justify-between gap-3">
               <div>
                 <p class="font-semibold text-ink">{{ group.courseTitle }}</p>
@@ -372,24 +402,23 @@ <h4 class="text-base font-semibold text-ink">Runtime intervention recommendation
                   {{ group.recommendations.length }} learner recommendation<span *ngIf="group.recommendations.length !== 1">s</span>
                 </p>
               </div>
+              <span
+                *ngIf="flagshipCourse?.title === group.courseTitle"
+                class="inline-flex rounded-full border border-primary/20 bg-primary/5 px-3 py-1 text-xs font-semibold uppercase tracking-[0.16em] text-primary"
+              >
+                Flagship course
+              </span>
             </div>
 
             <div class="mt-3 space-y-3">
-              <article
-                *ngFor="let recommendation of group.recommendations"
-                class="rounded-2xl border border-slate-200 bg-slate-50 p-4"
-                data-runtime-intervention-row
-              >
+              <article *ngFor="let recommendation of group.recommendations" class="rounded-2xl border border-slate-200 bg-slate-50 p-4" data-runtime-intervention-row>
                 <div class="flex flex-wrap items-start justify-between gap-3">
                   <div>
                     <p class="font-semibold text-ink">{{ recommendation.student_name }}</p>
                     <p class="mt-1 text-sm text-slate-600">{{ recommendation.summary }}</p>
                   </div>
                   <div class="flex flex-wrap gap-2">
-                    <span
-                      class="inline-flex rounded-full px-3 py-1 text-xs font-semibold uppercase tracking-[0.16em]"
-                      [ngClass]="runtimeInterventionStateClasses(recommendation.recommendation_state)"
-                    >
+                    <span class="inline-flex rounded-full px-3 py-1 text-xs font-semibold uppercase tracking-[0.16em]" [ngClass]="runtimeInterventionStateClasses(recommendation.recommendation_state)">
                       {{ formatRuntimeLabel(recommendation.recommendation_state) }}
                     </span>
                     <span class="inline-flex rounded-full border border-slate-200 bg-white px-3 py-1 text-xs font-semibold uppercase tracking-[0.16em] text-slate-700">
@@ -433,16 +462,23 @@ <h4 class="text-base font-semibold text-ink">Runtime intervention recommendation
           </section>
         </div>
       </div>
-    </div>
+    </section>
 
-    <div class="surface-card p-6">
-      <div class="flex items-start justify-between gap-4 mb-4">
-        <div>
-          <h3 class="text-xl font-bold text-primary">Advanced actions</h3>
-          <p class="text-sm text-slate-600">Useful outside the scripted demo path. Keep focus on governance and runtime visibility during the live walkthrough.</p>
+    <aside class="surface-card p-6" aria-labelledby="teacher-advanced-actions-heading">
+      <div class="teacher-dashboard__section-heading mb-4">
+        <div class="space-y-2">
+          <div class="flex flex-wrap items-start justify-between gap-4">
+            <div>
+              <h3 id="teacher-advanced-actions-heading" class="text-xl font-bold text-primary">Advanced actions</h3>
+              <p class="text-sm leading-6 text-slate-700">
+                Useful outside the scripted demo path. Keep focus on governance and runtime visibility during the live walkthrough.
+              </p>
+            </div>
+            <span class="rounded-full border border-amber-200 bg-amber-50 px-3 py-1 text-xs font-semibold uppercase tracking-[0.16em] text-amber-800">Off-script</span>
+          </div>
         </div>
-        <span class="rounded-full border border-amber-200 bg-amber-50 px-3 py-1 text-xs font-semibold uppercase tracking-[0.16em] text-amber-800">Off-script</span>
       </div>
+
       <app-echo-loading-state
         *ngIf="quickActionsLoading"
         density="compact"
@@ -459,28 +495,46 @@ <h3 class="text-xl font-bold text-primary">Advanced actions</h3>
         actionLabel="Retry"
         (action)="retryQuickActions()"
       ></app-echo-state-panel>
-      <div *ngIf="!quickActionsLoading && !quickActionsError" class="space-y-3">
-        <div class="space-y-2">
-          <label class="text-sm text-muted">Assign a course</label>
-          <select class="w-full rounded-xl border border-slate-200 px-3 py-2 text-sm" [(ngModel)]="selectedStudentId" aria-label="Select student">
-            <option value="">Select student</option>
-            <option *ngFor="let student of students" [value]="student.id">{{ student.firstname }} {{ student.lastname }}</option>
-          </select>
-          <select class="w-full rounded-xl border border-slate-200 px-3 py-2 text-sm" [(ngModel)]="selectedCourseId" aria-label="Select course">
-            <option value="">Select course</option>
-            <option *ngFor="let course of courses" [value]="course.id">{{ course.title }}</option>
-          </select>
-          <button class="w-full py-2 rounded-xl bg-primary text-white font-semibold hover:-translate-y-0.5 transition" (click)="assignCourse()">Assign Course</button>
+      <div *ngIf="!quickActionsLoading && !quickActionsError" class="space-y-4">
+        <div class="rounded-2xl border border-slate-200 bg-slate-50 p-4">
+          <div class="space-y-2">
+            <label class="text-sm font-semibold text-slate-700">Assign a course</label>
+            <p class="text-sm leading-6 text-slate-600">Prepare a learner demo path quickly without leaving the dashboard.</p>
+          </div>
+          <div class="mt-3 space-y-3">
+            <select class="teacher-dashboard__control w-full rounded-xl border border-slate-200 bg-white px-3 py-2.5 text-sm" [(ngModel)]="selectedStudentId" aria-label="Select student">
+              <option value="">Select student</option>
+              <option *ngFor="let student of students" [value]="student.id">{{ student.firstname }} {{ student.lastname }}</option>
+            </select>
+            <select class="teacher-dashboard__control w-full rounded-xl border border-slate-200 bg-white px-3 py-2.5 text-sm" [(ngModel)]="selectedCourseId" aria-label="Select course">
+              <option value="">Select course</option>
+              <option *ngFor="let course of courses" [value]="course.id">{{ course.title }}</option>
+            </select>
+            <button class="teacher-dashboard__primary-button w-full rounded-xl px-4 py-2.5 font-semibold text-white" (click)="assignCourse()">Assign Course</button>
+          </div>
+        </div>
+
+        <div class="rounded-2xl border border-slate-200 bg-white p-4">
+          <p class="text-xs font-semibold uppercase tracking-[0.18em] text-primary">Teacher runtime confidence</p>
+          <p class="mt-2 text-sm leading-6 text-slate-700">Use these secondary controls only when you need to narrate the broader educator surface beyond the flagship walkthrough.</p>
+          <div class="mt-4 space-y-3">
+            <button class="teacher-dashboard__secondary-button teacher-dashboard__secondary-button--accent w-full rounded-xl px-4 py-2.5 font-semibold text-ink" (click)="startLiveLesson()">Start Live Lesson</button>
+            <button class="teacher-dashboard__secondary-button w-full rounded-xl px-4 py-2.5 font-semibold text-primary" (click)="viewReports()">View Reports</button>
+          </div>
         </div>
-        <button class="w-full py-2 rounded-xl bg-accent text-ink font-semibold hover:-translate-y-0.5 transition opacity-75" (click)="startLiveLesson()">Start Live Lesson</button>
-        <button class="w-full py-2 rounded-xl border border-primary text-primary font-semibold hover:-translate-y-0.5 transition opacity-75" (click)="viewReports()">View Reports</button>
       </div>
-    </div>
+    </aside>
   </div>
 
-  <div class="grid gap-4 grid-cols-1 lg:grid-cols-3">
-    <div class="surface-card p-6 lg:col-span-2">
-      <h3 class="text-xl font-bold text-primary mb-3">Student Progress</h3>
+  <div class="grid grid-cols-1 gap-4 lg:grid-cols-3">
+    <section class="surface-card p-6 lg:col-span-2" aria-labelledby="teacher-student-progress-heading">
+      <div class="teacher-dashboard__section-heading mb-3">
+        <div class="space-y-2">
+          <h3 id="teacher-student-progress-heading" class="text-xl font-bold text-primary">Student Progress</h3>
+          <p class="text-sm leading-6 text-slate-700">A classroom snapshot of who has started, who is moving steadily, and who may need live support during the pilot walkthrough.</p>
+        </div>
+      </div>
+
       <app-echo-loading-state
         *ngIf="summaryLoading"
         density="section"
@@ -505,58 +559,80 @@ <h3 class="text-xl font-bold text-primary mb-3">Student Progress</h3>
         body="Assigned learner activity will populate this classroom progress summary."
       ></app-echo-state-panel>
       <ng-container *ngIf="!summaryLoading && !summaryError && teacherSummary.length > 0">
-        <div class="hidden md:block overflow-x-auto">
+        <div class="hidden overflow-x-auto md:block">
           <table class="w-full text-sm">
             <thead class="bg-slate-50 text-slate-600">
               <tr class="text-left">
-                <th class="py-2 px-2">Student</th>
-                <th class="py-2 px-2">Course</th>
-                <th class="py-2 px-2">Progress</th>
-                <th class="py-2 px-2">Last Active</th>
+                <th class="px-2 py-2">Student</th>
+                <th class="px-2 py-2">Course</th>
+                <th class="px-2 py-2">Progress</th>
+                <th class="px-2 py-2">Last Active</th>
               </tr>
             </thead>
             <tbody class="divide-y divide-slate-100">
               <tr *ngFor="let row of teacherSummary" class="hover:bg-slate-50">
-                <td class="py-3 px-2 font-semibold text-ink">{{ row.student_name }}</td>
-                <td class="py-3 px-2">{{ row.course_title }}</td>
-                <td class="py-3 px-2">{{ row.progress }}%</td>
-                <td class="py-3 px-2 text-slate-500">{{ row.last_active ? (row.last_active | date: 'MMM d, y') : 'Not started' }}</td>
+                <td class="px-2 py-3 font-semibold text-ink">{{ row.student_name }}</td>
+                <td class="px-2 py-3">{{ row.course_title }}</td>
+                <td class="px-2 py-3">
+                  <div class="min-w-[10rem]">
+                    <div class="flex items-center justify-between gap-3">
+                      <span class="font-semibold text-slate-700">{{ row.progress }}%</span>
+                      <span class="text-xs uppercase tracking-[0.16em] text-slate-500">{{ row.status }}</span>
+                    </div>
+                    <div class="mt-2 h-2 overflow-hidden rounded-full bg-slate-200">
+                      <div class="h-full rounded-full bg-primary" [style.width.%]="row.progress"></div>
+                    </div>
+                  </div>
+                </td>
+                <td class="px-2 py-3 text-slate-500">{{ row.last_active ? (row.last_active | date: 'MMM d, y') : 'Not started' }}</td>
               </tr>
             </tbody>
           </table>
         </div>
-        <div class="md:hidden space-y-3" data-educator-responsive="teacher-summary">
-          <article *ngFor="let row of teacherSummary" class="rounded-2xl border border-slate-200 bg-slate-50 p-4">
-            <p class="font-semibold text-ink">{{ row.student_name }}</p>
-            <p class="mt-1 text-sm text-slate-600">{{ row.course_title }}</p>
-            <div class="mt-3 grid grid-cols-2 gap-3 text-sm">
+        <div class="space-y-3 md:hidden" data-educator-responsive="teacher-summary">
+          <article *ngFor="let row of teacherSummary" class="rounded-2xl border border-slate-200 bg-slate-50 p-4 shadow-sm">
+            <div class="flex flex-wrap items-start justify-between gap-3">
               <div>
+                <p class="font-semibold text-ink">{{ row.student_name }}</p>
+                <p class="mt-1 text-sm text-slate-600">{{ row.course_title }}</p>
+              </div>
+              <span class="rounded-full border border-slate-200 bg-white px-3 py-1 text-xs font-semibold uppercase tracking-[0.16em] text-slate-600">{{ row.status }}</span>
+            </div>
+            <div class="mt-3">
+              <div class="flex items-center justify-between gap-3 text-sm">
                 <p class="text-xs font-semibold uppercase tracking-[0.18em] text-primary">Progress</p>
-                <p class="mt-1 text-slate-700">{{ row.progress }}%</p>
+                <p class="font-semibold text-slate-700">{{ row.progress }}%</p>
               </div>
-              <div>
-                <p class="text-xs font-semibold uppercase tracking-[0.18em] text-primary">Last active</p>
-                <p class="mt-1 text-slate-700">{{ row.last_active ? (row.last_active | date: 'MMM d, y') : 'Not started' }}</p>
+              <div class="mt-2 h-2 overflow-hidden rounded-full bg-slate-200">
+                <div class="h-full rounded-full bg-primary" [style.width.%]="row.progress"></div>
               </div>
             </div>
+            <div class="mt-3 text-sm">
+              <p class="text-xs font-semibold uppercase tracking-[0.18em] text-primary">Last active</p>
+              <p class="mt-1 text-slate-700">{{ row.last_active ? (row.last_active | date: 'MMM d, y') : 'Not started' }}</p>
+            </div>
           </article>
         </div>
       </ng-container>
-    </div>
+    </section>
 
     <div class="space-y-4">
-      <div class="surface-card p-6">
-        <div class="flex items-start justify-between gap-4 mb-3">
-          <div>
-            <h3 class="text-xl font-bold text-primary">Runtime Support</h3>
-            <p class="text-sm text-slate-600">Flagship spotlight for fast live-demo narration about who needs support, who is ready for extension, and who is moving steadily.</p>
+      <section class="surface-card p-6" aria-labelledby="teacher-runtime-support-heading">
+        <div class="teacher-dashboard__section-heading mb-3">
+          <div class="space-y-2">
+            <div class="flex flex-wrap items-start justify-between gap-4">
+              <div>
+                <h3 id="teacher-runtime-support-heading" class="text-xl font-bold text-primary">Runtime Support</h3>
+                <p class="text-sm leading-6 text-slate-700">Flagship spotlight for fast live-demo narration about who needs support, who is ready for extension, and who is moving steadily.</p>
+              </div>
+              <span
+                *ngIf="flagshipCourse"
+                class="rounded-full border border-primary/15 bg-primary/5 px-3 py-1 text-xs font-semibold uppercase tracking-[0.16em] text-primary"
+              >
+                Flagship
+              </span>
+            </div>
           </div>
-          <span
-            *ngIf="flagshipCourse"
-            class="rounded-full border border-primary/15 bg-primary/5 px-3 py-1 text-xs font-semibold uppercase tracking-[0.16em] text-primary"
-          >
-            Flagship
-          </span>
         </div>
 
         <app-echo-loading-state
@@ -586,25 +662,18 @@ <h3 class="text-xl font-bold text-primary">Runtime Support</h3>
         ></app-echo-state-panel>
 
         <div *ngIf="!runtimeSupportLoading && !runtimeSupportError && educatorRuntimeSupport.length > 0" class="space-y-3">
-          <article
-            *ngFor="let row of educatorRuntimeSupport"
-            class="rounded-2xl border border-slate-200 bg-slate-50 p-4"
-            data-runtime-support-row
-          >
+          <article *ngFor="let row of educatorRuntimeSupport" class="rounded-2xl border border-slate-200 bg-slate-50 p-4 shadow-sm" data-runtime-support-row>
             <div class="flex flex-wrap items-start justify-between gap-3">
               <div>
                 <p class="font-semibold text-ink">{{ row.student_name }}</p>
                 <p class="mt-1 text-sm text-slate-600">{{ row.course_title }}</p>
               </div>
-              <span
-                class="inline-flex rounded-full px-3 py-1 text-xs font-semibold uppercase tracking-[0.16em]"
-                [ngClass]="supportStateClasses(row.support_state)"
-              >
+              <span class="inline-flex rounded-full px-3 py-1 text-xs font-semibold uppercase tracking-[0.16em]" [ngClass]="supportStateClasses(row.support_state)">
                 {{ runtimeSupportStateLabel[row.support_state] || runtimeSupportStateLabel['unknown'] }}
               </span>
             </div>
 
-            <p class="mt-3 text-sm text-slate-700">{{ row.support_summary }}</p>
+            <p class="mt-3 text-sm leading-6 text-slate-700">{{ row.support_summary }}</p>
 
             <div *ngIf="row.context_lesson_title || row.context_prompts.length > 0" class="mt-3 rounded-xl border border-slate-200 bg-white p-3">
               <p class="text-xs font-semibold uppercase tracking-[0.16em] text-primary">Context</p>
@@ -624,16 +693,21 @@ <h3 class="text-xl font-bold text-primary">Runtime Support</h3>
             </p>
           </article>
         </div>
-      </div>
+      </section>
 
-      <div class="surface-card p-6">
-        <h3 class="text-xl font-bold text-primary mb-3">Upcoming Events</h3>
+      <section class="surface-card p-6" aria-labelledby="teacher-upcoming-events-heading">
+        <div class="teacher-dashboard__section-heading mb-3">
+          <div class="space-y-2">
+            <h3 id="teacher-upcoming-events-heading" class="text-xl font-bold text-primary">Upcoming Events</h3>
+            <p class="text-sm leading-6 text-slate-700">A small credibility surface for pilot walkthroughs so the dashboard feels like an active teacher workspace.</p>
+          </div>
+        </div>
         <ul class="space-y-3 text-sm text-slate-700">
-          <li class="p-3 rounded-xl bg-slate-50 border border-slate-100">Parent-Teacher Conference - March 15</li>
-          <li class="p-3 rounded-xl bg-slate-50 border border-slate-100">Live project showcase - March 20</li>
-          <li class="p-3 rounded-xl bg-slate-50 border border-slate-100">Course feedback survey - March 30</li>
+          <li class="rounded-xl border border-slate-100 bg-slate-50 p-3">Parent-Teacher Conference - March 15</li>
+          <li class="rounded-xl border border-slate-100 bg-slate-50 p-3">Live project showcase - March 20</li>
+          <li class="rounded-xl border border-slate-100 bg-slate-50 p-3">Course feedback survey - March 30</li>
         </ul>
-      </div>
+      </section>
     </div>
   </div>
 </div>
diff --git a/frontend/src/app/pages/user-dashboard/teacher-view/teacher-view.component.scss b/frontend/src/app/pages/user-dashboard/teacher-view/teacher-view.component.scss
index e69de29..797df6d 100644
--- a/frontend/src/app/pages/user-dashboard/teacher-view/teacher-view.component.scss
+++ b/frontend/src/app/pages/user-dashboard/teacher-view/teacher-view.component.scss
@@ -0,0 +1,131 @@
+:host {
+  display: block;
+}
+
+.teacher-dashboard {
+  color: var(--echo-text, #0f172a);
+}
+
+.teacher-dashboard__hero-badge,
+.teacher-dashboard__hero-panel {
+  backdrop-filter: blur(16px);
+}
+
+.teacher-dashboard__section-heading,
+.teacher-dashboard__subsection-heading {
+  position: relative;
+}
+
+.teacher-dashboard__section-heading::after {
+  content: '';
+  display: block;
+  margin-top: 0.9rem;
+  height: 1px;
+  width: 100%;
+  background: linear-gradient(90deg, rgba(15, 23, 42, 0.12), rgba(15, 23, 42, 0));
+}
+
+.teacher-dashboard__subsection-heading h4,
+.teacher-dashboard__section-heading h3 {
+  letter-spacing: -0.01em;
+}
+
+.teacher-dashboard__link-button,
+.teacher-dashboard__text-link,
+.teacher-dashboard__primary-button,
+.teacher-dashboard__secondary-button,
+.teacher-dashboard__control {
+  transition:
+    background-color 140ms ease,
+    border-color 140ms ease,
+    color 140ms ease,
+    box-shadow 140ms ease,
+    transform 140ms ease;
+}
+
+.teacher-dashboard__link-button {
+  border-radius: 9999px;
+  padding: 0.45rem 0.85rem;
+}
+
+.teacher-dashboard__link-button:hover,
+.teacher-dashboard__link-button:focus-visible {
+  background: rgba(14, 116, 144, 0.08);
+}
+
+.teacher-dashboard__text-link {
+  font-weight: 600;
+  text-decoration: none;
+}
+
+.teacher-dashboard__text-link:hover,
+.teacher-dashboard__text-link:focus-visible {
+  text-decoration: underline;
+  text-underline-offset: 0.2rem;
+}
+
+.teacher-dashboard__control {
+  color: #0f172a;
+}
+
+.teacher-dashboard__control:hover {
+  border-color: rgba(14, 116, 144, 0.32);
+}
+
+.teacher-dashboard__control:focus-visible,
+.teacher-dashboard__link-button:focus-visible,
+.teacher-dashboard__text-link:focus-visible,
+.teacher-dashboard__primary-button:focus-visible,
+.teacher-dashboard__secondary-button:focus-visible {
+  outline: none;
+  box-shadow: 0 0 0 3px rgba(14, 116, 144, 0.18);
+}
+
+.teacher-dashboard__primary-button:hover,
+.teacher-dashboard__secondary-button:hover {
+  transform: translateY(-1px);
+}
+
+.teacher-dashboard__primary-button {
+  background: linear-gradient(135deg, var(--color-primary, #0e7490), #155e75);
+}
+
+.teacher-dashboard__primary-button:hover {
+  filter: brightness(1.02);
+}
+
+.teacher-dashboard__secondary-button {
+  border: 1px solid rgba(14, 116, 144, 0.2);
+  background: #fff;
+}
+
+.teacher-dashboard__secondary-button:hover {
+  border-color: rgba(14, 116, 144, 0.32);
+  background: rgba(14, 116, 144, 0.04);
+}
+
+.teacher-dashboard__secondary-button--accent {
+  border-color: rgba(245, 158, 11, 0.2);
+  background: linear-gradient(135deg, rgba(252, 211, 77, 0.75), rgba(254, 240, 138, 0.82));
+}
+
+.teacher-dashboard__secondary-button--accent:hover {
+  border-color: rgba(217, 119, 6, 0.35);
+  background: linear-gradient(135deg, rgba(252, 211, 77, 0.92), rgba(254, 240, 138, 0.96));
+}
+
+@media (max-width: 1023px) {
+  .teacher-dashboard__section-heading::after {
+    margin-top: 0.75rem;
+  }
+}
+
+@media (max-width: 767px) {
+  .teacher-dashboard__hero-panel {
+    padding: 1rem;
+  }
+
+  .teacher-dashboard__link-button {
+    padding-inline: 0;
+  }
+}
diff --git a/openspec/changes/pilot-platform-hardening-phase-1/tasks.md b/openspec/changes/pilot-platform-hardening-phase-1/tasks.md
index d341b75..9452afa 100644
--- a/openspec/changes/pilot-platform-hardening-phase-1/tasks.md
+++ b/openspec/changes/pilot-platform-hardening-phase-1/tasks.md
@@ -18,9 +18,9 @@
 
 ## 4. Teacher dashboard baseline polish
 
-- [ ] 4.1 Audit the current teacher dashboard for pilot-demo readiness, focusing on course visibility, learner progress context, runtime support visibility, and responsive usability
-- [ ] 4.2 Harden teacher dashboard loading, empty, and retry behavior so the core pilot narrative remains usable even when some datasets are unavailable
-- [ ] 4.3 Verify a teacher can log in and see enough stable dashboard state to demonstrate course, learner, and runtime context
+- [x] 4.1 Audit the current teacher dashboard for pilot-demo readiness, focusing on course visibility, learner progress context, runtime support visibility, and responsive usability
+- [x] 4.2 Harden teacher dashboard loading, empty, and retry behavior so the core pilot narrative remains usable even when some datasets are unavailable
+- [x] 4.3 Verify a teacher can log in and see enough stable dashboard state to demonstrate course, learner, and runtime context
 
 ## 5. Error/loading/empty states
 

From 7f08ddaf3fde9b45520c145de83a79838a9da0f3 Mon Sep 17 00:00:00 2001
From: Anthony Wright <anthony@mrwrite.dev>
Date: Tue, 26 May 2026 16:21:47 -0500
Subject: [PATCH 05/14] feat: standardize pilot UX states

---
 .../echo-loading-state.component.html         |   1 +
 .../echo-loading-state.component.scss         |  12 +-
 .../echo-loading-state.component.spec.ts      |   1 +
 .../echo-state-panel.component.scss           |  22 +++-
 .../src/app/pages/lesson-view.component.html  |   4 +
 .../app/pages/lesson-view.component.spec.ts   |  17 ++-
 .../src/app/pages/lesson-view.component.ts    |   7 +-
 .../student-view/student-view.component.html  | 113 ++++++++++++++++--
 .../student-view/student-view.component.ts    |  47 ++++++++
 .../pilot-platform-hardening-phase-1/tasks.md |   6 +-
 10 files changed, 207 insertions(+), 23 deletions(-)

diff --git a/frontend/src/app/components/echo-loading-state/echo-loading-state.component.html b/frontend/src/app/components/echo-loading-state/echo-loading-state.component.html
index 7117704..2d8614d 100644
--- a/frontend/src/app/components/echo-loading-state/echo-loading-state.component.html
+++ b/frontend/src/app/components/echo-loading-state/echo-loading-state.component.html
@@ -6,6 +6,7 @@
   [attr.data-echo-loading]="density"
   role="status"
   aria-live="polite"
+  aria-busy="true"
   [attr.aria-label]="ariaLabel"
 >
   <div class="echo-loading-state__inner">
diff --git a/frontend/src/app/components/echo-loading-state/echo-loading-state.component.scss b/frontend/src/app/components/echo-loading-state/echo-loading-state.component.scss
index 82e9cd2..862e45f 100644
--- a/frontend/src/app/components/echo-loading-state/echo-loading-state.component.scss
+++ b/frontend/src/app/components/echo-loading-state/echo-loading-state.component.scss
@@ -6,6 +6,7 @@
   border-color: rgba(15, 23, 42, 0.08);
   background:
     linear-gradient(180deg, rgba(255, 255, 255, 0.94), rgba(247, 243, 237, 0.9));
+  box-shadow: 0 18px 34px rgba(15, 23, 42, 0.05);
 }
 
 .echo-loading-state--page {
@@ -36,12 +37,14 @@
   height: 2.75rem;
   border-radius: 999px;
   color: var(--echo-primary);
-  background: rgba(46, 41, 78, 0.08);
+  background: linear-gradient(135deg, rgba(14, 116, 144, 0.12), rgba(245, 158, 11, 0.18));
+  box-shadow: inset 0 0 0 1px rgba(14, 116, 144, 0.08);
 }
 
 .echo-loading-state__copy {
   display: grid;
   gap: 0.35rem;
+  max-width: 42rem;
 }
 
 .echo-loading-state__title {
@@ -55,12 +58,13 @@
   margin: 0;
   font-size: 0.92rem;
   line-height: 1.55;
-  color: var(--echo-text-muted);
+  color: #475569;
 }
 
 .echo-loading-state__skeletons {
   display: grid;
   gap: 0.6rem;
+  max-width: 38rem;
 }
 
 .echo-loading-state__skeleton {
@@ -72,6 +76,10 @@
   animation: echo-loading-wave 1.2s linear infinite;
 }
 
+.echo-loading-state--compact .echo-loading-state__body {
+  font-size: 0.88rem;
+}
+
 .echo-loading-state__skeleton--primary {
   width: min(18rem, 72%);
 }
diff --git a/frontend/src/app/components/echo-loading-state/echo-loading-state.component.spec.ts b/frontend/src/app/components/echo-loading-state/echo-loading-state.component.spec.ts
index e0689df..8f01fc1 100644
--- a/frontend/src/app/components/echo-loading-state/echo-loading-state.component.spec.ts
+++ b/frontend/src/app/components/echo-loading-state/echo-loading-state.component.spec.ts
@@ -24,6 +24,7 @@ describe('EchoLoadingStateComponent', () => {
 
     expect(panel.getAttribute('role')).toBe('status');
     expect(panel.getAttribute('aria-live')).toBe('polite');
+    expect(panel.getAttribute('aria-busy')).toBe('true');
     expect(panel.getAttribute('aria-label')).toBe('shell-loading');
   });
 
diff --git a/frontend/src/app/components/echo-state-panel/echo-state-panel.component.scss b/frontend/src/app/components/echo-state-panel/echo-state-panel.component.scss
index b7ffbca..f1439d9 100644
--- a/frontend/src/app/components/echo-state-panel/echo-state-panel.component.scss
+++ b/frontend/src/app/components/echo-state-panel/echo-state-panel.component.scss
@@ -3,6 +3,7 @@
   border-width: 1px;
   border-style: solid;
   border-color: rgba(15, 23, 42, 0.08);
+  box-shadow: 0 18px 34px rgba(15, 23, 42, 0.05);
 }
 
 .echo-state-panel--compact {
@@ -50,7 +51,8 @@
   height: 2.75rem;
   border-radius: 999px;
   color: var(--echo-primary);
-  background: rgba(46, 41, 78, 0.08);
+  background: linear-gradient(135deg, rgba(14, 116, 144, 0.12), rgba(245, 158, 11, 0.18));
+  box-shadow: inset 0 0 0 1px rgba(14, 116, 144, 0.08);
 }
 
 .echo-state-panel--error .echo-state-panel__icon-shell {
@@ -63,10 +65,21 @@
   background: rgba(239, 183, 0, 0.16);
 }
 
+.echo-state-panel--blocked .echo-state-panel__icon-shell {
+  color: #433875;
+  background: rgba(67, 56, 117, 0.12);
+}
+
+.echo-state-panel--empty .echo-state-panel__icon-shell {
+  color: #0f172a;
+  background: rgba(148, 163, 184, 0.12);
+}
+
 .echo-state-panel__content {
   display: flex;
   flex-direction: column;
   gap: 0.5rem;
+  max-width: 44rem;
 }
 
 .echo-state-panel__eyebrow {
@@ -90,7 +103,7 @@
   margin: 0;
   font-size: 0.95rem;
   line-height: 1.6;
-  color: var(--echo-text-muted);
+  color: #475569;
 }
 
 .echo-state-panel__action {
@@ -103,13 +116,16 @@
   padding: 0.65rem 1rem;
   font-size: 0.92rem;
   font-weight: 700;
-  transition: transform 160ms ease, background-color 160ms ease;
+  transition: transform 160ms ease, background-color 160ms ease, box-shadow 160ms ease, border-color 160ms ease;
 }
 
 .echo-state-panel__action:hover,
 .echo-state-panel__action:focus-visible {
   background: rgba(46, 41, 78, 0.08);
   transform: translateY(-1px);
+  outline: none;
+  box-shadow: 0 0 0 3px rgba(14, 116, 144, 0.16);
+  border-color: rgba(14, 116, 144, 0.22);
 }
 
 .echo-state-panel--center .echo-state-panel__action {
diff --git a/frontend/src/app/pages/lesson-view.component.html b/frontend/src/app/pages/lesson-view.component.html
index 911523c..68c9628 100644
--- a/frontend/src/app/pages/lesson-view.component.html
+++ b/frontend/src/app/pages/lesson-view.component.html
@@ -48,6 +48,8 @@ <h2 id="lesson-page-title" class="text-2xl font-bold text-ink">{{ lesson?.title
     <app-echo-state-panel
       *ngIf="!lesson && !loading && governedDeliveryState && governedDeliveryState !== 'completed'"
       variant="blocked"
+      align="center"
+      ariaLabel="governed-lesson-state"
       eyebrow="Governed lesson state"
       [title]="governedStateTitle"
       [body]="governedStateBody"
@@ -59,6 +61,8 @@ <h2 id="lesson-page-title" class="text-2xl font-bold text-ink">{{ lesson?.title
     <app-echo-state-panel
       *ngIf="!lesson && !loading && loadErrorMessage"
       variant="error"
+      align="center"
+      ariaLabel="lesson-load-error"
       eyebrow="Lesson load failed"
       title="We could not prepare this lesson"
       [body]="loadErrorMessage"
diff --git a/frontend/src/app/pages/lesson-view.component.spec.ts b/frontend/src/app/pages/lesson-view.component.spec.ts
index 1a86a33..79d74ab 100644
--- a/frontend/src/app/pages/lesson-view.component.spec.ts
+++ b/frontend/src/app/pages/lesson-view.component.spec.ts
@@ -2,7 +2,7 @@ import { CommonModule } from '@angular/common';
 import { ActivatedRoute } from '@angular/router';
 import { ComponentFixture, TestBed } from '@angular/core/testing';
 import { RouterTestingModule } from '@angular/router/testing';
-import { of, Subject } from 'rxjs';
+import { of, Subject, throwError } from 'rxjs';
 
 import { LessonViewComponent } from './lesson-view.component';
 import { CoursesService } from '../services/courses.service';
@@ -91,4 +91,19 @@ describe('LessonViewComponent', () => {
 
     expect(exitButton).not.toBeNull();
   });
+
+  it('renders a generic retryable error state when the governed segment cannot be restored', () => {
+    const coursesService = TestBed.inject(CoursesService) as unknown as MockCoursesService;
+    coursesService.getCurrentSegment.and.returnValue(throwError(() => new Error('segment failed')));
+
+    fixture = TestBed.createComponent(LessonViewComponent);
+    component = fixture.componentInstance;
+    fixture.detectChanges();
+
+    const compiled = fixture.nativeElement as HTMLElement;
+    expect(compiled.querySelector('[data-echo-state="error"]')).not.toBeNull();
+    expect(compiled.textContent).toContain('We could not prepare this lesson');
+    expect(compiled.textContent).toContain('Retry');
+    expect(compiled.textContent).not.toContain('Course completed!');
+  });
 });
diff --git a/frontend/src/app/pages/lesson-view.component.ts b/frontend/src/app/pages/lesson-view.component.ts
index 72f4f7d..f3791a9 100644
--- a/frontend/src/app/pages/lesson-view.component.ts
+++ b/frontend/src/app/pages/lesson-view.component.ts
@@ -89,10 +89,13 @@ export class LessonViewComponent implements OnInit {
         this.fetchLesson(segment.lesson_id);
       },
       error: (err) => {
-          console.warn('All segments may be complete or none found.', err);
+          console.warn('Failed to restore the current governed lesson segment.', err);
           this.segment = undefined;
           this.lesson = undefined;
-          this.courseCompleted = true;
+          this.courseCompleted = false;
+          this.governedDeliveryState = null;
+          this.governedDeliveryDetail = '';
+          this.loadErrorMessage = 'We could not restore your lesson path right now. Retry to continue from your dashboard-safe progress point.';
           this.loading = false;
       }
     });
diff --git a/frontend/src/app/pages/user-dashboard/student-view/student-view.component.html b/frontend/src/app/pages/user-dashboard/student-view/student-view.component.html
index c84edaf..e5a7b12 100644
--- a/frontend/src/app/pages/user-dashboard/student-view/student-view.component.html
+++ b/frontend/src/app/pages/user-dashboard/student-view/student-view.component.html
@@ -254,7 +254,23 @@ <h3 class="text-xl font-bold text-primary">Certification Paths</h3>
         </div>
         <button class="text-sm font-semibold text-primary underline underline-offset-4" (click)="goToPrograms()">Open all programs</button>
       </div>
-      <div class="grid md:grid-cols-2 gap-4">
+      <app-echo-loading-state
+        *ngIf="programsLoading"
+        density="compact"
+        ariaLabel="student-programs-loading"
+        title="Loading certification paths"
+        body="We are restoring your structured program progress and completion pathways."
+      ></app-echo-loading-state>
+      <app-echo-state-panel
+        *ngIf="!programsLoading && programsLoadError"
+        variant="error"
+        eyebrow="Program pathways unavailable"
+        title="We could not load your certification paths"
+        [body]="programsLoadError"
+        actionLabel="Retry"
+        (action)="retryProgramsLoad()"
+      ></app-echo-state-panel>
+      <div *ngIf="!programsLoading && !programsLoadError" class="grid gap-4 md:grid-cols-2">
         <div *ngFor="let program of programs | slice:0:2" class="rounded-2xl border border-slate-200 bg-white p-4">
           <div class="flex items-center justify-between gap-3">
             <p class="font-semibold text-ink">{{ program.title }}</p>
@@ -265,9 +281,14 @@ <h3 class="text-xl font-bold text-primary">Certification Paths</h3>
             {{ program.progress?.completed_courses || 0 }} / {{ program.progress?.total_courses || program.courses.length }} courses complete
           </p>
         </div>
-        <div *ngIf="programs.length === 0" class="rounded-2xl border border-dashed border-slate-300 bg-slate-50 p-4 text-sm text-slate-600">
-          No programs are available yet. When learning paths are published, they will appear here.
-        </div>
+        <app-echo-state-panel
+          *ngIf="programs.length === 0"
+          variant="empty"
+          [compact]="true"
+          eyebrow="No program pathways yet"
+          title="Certification paths will appear here"
+          body="When structured learning paths are published, they will appear here with progress and completion detail."
+        ></app-echo-state-panel>
       </div>
     </div>
 
@@ -276,10 +297,31 @@ <h3 class="text-xl font-bold text-primary">Certification Paths</h3>
         <h3 class="text-xl font-bold text-primary">Certifications</h3>
         <button class="text-sm font-semibold text-primary underline underline-offset-4" (click)="goToCertifications()">View all</button>
       </div>
-      <div *ngIf="certifications.length === 0" class="text-sm leading-6 text-slate-700">
-        Complete required courses and assessments to unlock certifications.
-      </div>
-      <div *ngFor="let issued of certifications | slice:0:2" class="rounded-xl border border-emerald-100 bg-white p-4 mb-3">
+      <app-echo-loading-state
+        *ngIf="certificationsLoading"
+        density="compact"
+        ariaLabel="student-certifications-loading"
+        title="Loading certifications"
+        body="We are restoring your earned completion records."
+      ></app-echo-loading-state>
+      <app-echo-state-panel
+        *ngIf="!certificationsLoading && certificationsLoadError"
+        variant="error"
+        eyebrow="Certification history unavailable"
+        title="We could not load your certifications"
+        [body]="certificationsLoadError"
+        actionLabel="Retry"
+        (action)="retryProgramsLoad()"
+      ></app-echo-state-panel>
+      <app-echo-state-panel
+        *ngIf="!certificationsLoading && !certificationsLoadError && certifications.length === 0"
+        variant="empty"
+        [compact]="true"
+        eyebrow="No certifications yet"
+        title="Your certifications will appear here"
+        body="Complete required courses and assessments to unlock certifications."
+      ></app-echo-state-panel>
+      <div *ngFor="let issued of certifications | slice:0:2" class="mb-3 rounded-xl border border-emerald-100 bg-white p-4">
         <p class="font-semibold text-ink">{{ issued.certification.title }}</p>
         <p class="mt-1 text-xs text-slate-500">Awarded {{ issued.awarded_at | date:'mediumDate' }}</p>
       </div>
@@ -315,9 +357,31 @@ <h3 class="text-xl font-bold text-primary">Achievements & Streaks</h3>
         </div>
         <div class="space-y-3">
           <h4 class="text-sm font-semibold text-slate-600">Earned Badges</h4>
-          <div *ngIf="studentBadges.length === 0" class="text-sm text-slate-500">
-            Complete your first lesson to unlock badges.
-          </div>
+          <app-echo-loading-state
+            *ngIf="badgesLoading"
+            density="compact"
+            ariaLabel="student-badges-loading"
+            title="Loading earned badges"
+            body="We are restoring your latest milestone rewards."
+          ></app-echo-loading-state>
+          <app-echo-state-panel
+            *ngIf="!badgesLoading && badgesLoadError"
+            variant="error"
+            [compact]="true"
+            eyebrow="Badge history unavailable"
+            title="We could not load your earned badges"
+            [body]="badgesLoadError"
+            actionLabel="Retry"
+            (action)="retryBadgesLoad()"
+          ></app-echo-state-panel>
+          <app-echo-state-panel
+            *ngIf="!badgesLoading && !badgesLoadError && studentBadges.length === 0"
+            variant="empty"
+            [compact]="true"
+            eyebrow="No earned badges yet"
+            title="Your badges will appear here"
+            body="Complete your first lesson to unlock badges and milestone rewards."
+          ></app-echo-state-panel>
           <div *ngFor="let badge of studentBadges" class="flex items-center gap-3 p-3 rounded-xl bg-white border border-slate-100">
             <img *ngIf="badge.badge?.image_url" [src]="badge.badge?.image_url" alt="" class="h-10 w-10 rounded-full object-cover" />
             <div>
@@ -330,7 +394,32 @@ <h4 class="text-sm font-semibold text-slate-600">Earned Badges</h4>
     </div>
     <div class="surface-card bg-gradient-to-br from-primary/5 to-accent/10 p-5 md:p-6">
       <h3 class="text-xl font-bold text-primary mb-3">Available Courses</h3>
-      <div class="space-y-3">
+      <app-echo-loading-state
+        *ngIf="availableCoursesLoading"
+        density="compact"
+        ariaLabel="student-available-courses-loading"
+        title="Loading available courses"
+        body="We are preparing additional courses that fit around your current learning path."
+      ></app-echo-loading-state>
+      <app-echo-state-panel
+        *ngIf="!availableCoursesLoading && availableCoursesLoadError"
+        variant="error"
+        [compact]="true"
+        eyebrow="Catalog suggestions unavailable"
+        title="We could not load additional courses"
+        [body]="availableCoursesLoadError"
+        actionLabel="Retry"
+        (action)="retryAvailableCoursesLoad()"
+      ></app-echo-state-panel>
+      <app-echo-state-panel
+        *ngIf="!availableCoursesLoading && !availableCoursesLoadError && visibleAvailableCourses.length === 0"
+        variant="empty"
+        [compact]="true"
+        eyebrow="No additional courses right now"
+        title="Your current catalog is already assigned"
+        body="When more courses are available beyond your active learning path, they will appear here."
+      ></app-echo-state-panel>
+      <div *ngIf="!availableCoursesLoading && !availableCoursesLoadError && visibleAvailableCourses.length > 0" class="space-y-3">
         <ng-container *ngFor="let course of visibleAvailableCourses">
           <div class="p-3 rounded-xl bg-white shadow-sm border border-slate-100">
             <p class="font-semibold text-ink">{{ course.title }}</p>
diff --git a/frontend/src/app/pages/user-dashboard/student-view/student-view.component.ts b/frontend/src/app/pages/user-dashboard/student-view/student-view.component.ts
index 4ac3787..68aebf6 100644
--- a/frontend/src/app/pages/user-dashboard/student-view/student-view.component.ts
+++ b/frontend/src/app/pages/user-dashboard/student-view/student-view.component.ts
@@ -64,6 +64,14 @@ export class StudentViewComponent implements OnInit {
   coursesCompleted = 0;
   coursesLoading = true;
   coursesLoadError = '';
+  badgesLoading = true;
+  badgesLoadError = '';
+  programsLoading = true;
+  programsLoadError = '';
+  certificationsLoading = true;
+  certificationsLoadError = '';
+  availableCoursesLoading = true;
+  availableCoursesLoadError = '';
   /** Number of courses shown initially before "View More" is clicked */
   availableCoursesVisibleCount = 4;
   demoTimeline = [
@@ -150,46 +158,71 @@ export class StudentViewComponent implements OnInit {
 
   loadBadges(): void {
     if (!this.userInfo?.user_id) {
+      this.badgesLoading = false;
       return;
     }
+    this.badgesLoading = true;
+    this.badgesLoadError = '';
     this.badgesService.getStudentBadges(this.userInfo.user_id).subscribe({
       next: (badges) => {
         this.studentBadges = badges;
+        this.badgesLoading = false;
       },
       error: (err) => {
         console.error('Failed to load badges', err);
+        this.studentBadges = [];
+        this.badgesLoadError = 'We could not load your earned badges right now. Retry after your dashboard finishes refreshing.';
+        this.badgesLoading = false;
       }
     });
   }
 
   loadProgramsOverview(): void {
+    this.programsLoading = true;
+    this.programsLoadError = '';
     this.programsService.getPrograms().subscribe({
       next: (programs) => {
         this.programs = programs;
+        this.programsLoading = false;
       },
       error: (err) => {
         console.error('Failed to load programs', err);
+        this.programs = [];
+        this.programsLoadError = 'We could not load your program pathways right now. Retry to restore this progress overview.';
+        this.programsLoading = false;
       }
     });
 
+    this.certificationsLoading = true;
+    this.certificationsLoadError = '';
     this.programsService.getMyCertifications().subscribe({
       next: (certifications) => {
         this.certifications = certifications;
+        this.certificationsLoading = false;
       },
       error: (err) => {
         console.error('Failed to load certifications', err);
+        this.certifications = [];
+        this.certificationsLoadError = 'We could not load your certification history right now. Retry to restore your completion records.';
+        this.certificationsLoading = false;
       }
     });
   }
 
   loadAvailableCourses(): void {
+  this.availableCoursesLoading = true;
+  this.availableCoursesLoadError = '';
   this.coursesService.getCourses().subscribe({
     next: (courses) => {
       const enrolledCourseIds = this.studentCourses.map(sc => sc.course_id);
       this.availableCourses = courses.filter(course => !enrolledCourseIds.includes(course.id));
+      this.availableCoursesLoading = false;
     },
     error: (err) => {
       console.error('Failed to load available courses', err);
+      this.availableCourses = [];
+      this.availableCoursesLoadError = 'We could not load additional courses right now. Retry after your current learning path is restored.';
+      this.availableCoursesLoading = false;
     }
   });
 }
@@ -218,6 +251,8 @@ export class StudentViewComponent implements OnInit {
       this.activeStudentCourse = undefined;
       this.activeStudentCourseReason = '';
       this.availableCourses = [];
+      this.availableCoursesLoading = false;
+      this.availableCoursesLoadError = '';
       this.coursesLoadError = 'We could not load your learning dashboard right now. Retry to restore your active courses and continuation path.';
       this.coursesLoading = false;
     }
@@ -382,6 +417,18 @@ enrollInCourse(courseId: string): void {
     this.loadStudentCourses();
   }
 
+  retryProgramsLoad(): void {
+    this.loadProgramsOverview();
+  }
+
+  retryBadgesLoad(): void {
+    this.loadBadges();
+  }
+
+  retryAvailableCoursesLoad(): void {
+    this.loadAvailableCourses();
+  }
+
   getCourseActionLabel(course: StudentCourseWithDetails): string {
     return (course.progress ?? 0) > 0 || course.status === 'active'
       ? 'Resume lesson'
diff --git a/openspec/changes/pilot-platform-hardening-phase-1/tasks.md b/openspec/changes/pilot-platform-hardening-phase-1/tasks.md
index 9452afa..9b3f453 100644
--- a/openspec/changes/pilot-platform-hardening-phase-1/tasks.md
+++ b/openspec/changes/pilot-platform-hardening-phase-1/tasks.md
@@ -24,9 +24,9 @@
 
 ## 5. Error/loading/empty states
 
-- [ ] 5.1 Inventory route-local loading, error, blocked, and empty states across shell, student dashboard, teacher dashboard, and lesson runtime
-- [ ] 5.2 Align pilot-critical flows to the canonical UX state system and remove ambiguous placeholders where stale content remains visible
-- [ ] 5.3 Add or update tests that lock in the intended user-friendly state behavior where practical
+- [x] 5.1 Inventory route-local loading, error, blocked, and empty states across shell, student dashboard, teacher dashboard, and lesson runtime
+- [x] 5.2 Align pilot-critical flows to the canonical UX state system and remove ambiguous placeholders where stale content remains visible
+- [x] 5.3 Add or update tests that lock in the intended user-friendly state behavior where practical
 
 ## 6. Accessibility pass
 

From 617c26c4a20a6d8aff051b2edd3f59ffbb7f555f Mon Sep 17 00:00:00 2001
From: Anthony Wright <anthony@mrwrite.dev>
Date: Tue, 26 May 2026 16:31:50 -0500
Subject: [PATCH 06/14] feat: improve pilot accessibility baseline

---
 .../echo-header/echo-header.component.html    | 15 ++++++++--
 .../echo-header/echo-header.component.scss    | 23 +++++++++++++++
 .../echo-header/echo-header.component.spec.ts |  2 ++
 .../echo-sidebar/echo-sidebar.component.html  | 14 ++++++----
 .../echo-sidebar/echo-sidebar.component.scss  |  6 ++++
 .../echo-sidebar.component.spec.ts            |  4 +++
 .../src/app/pages/home/home.component.html    |  8 +++++-
 .../src/app/pages/home/home.component.scss    | 25 +++++++++++++++++
 .../src/app/pages/home/home.component.spec.ts |  9 ++++++
 .../src/app/pages/lesson-view.component.html  |  2 +-
 .../src/app/pages/lesson-view.component.scss  |  5 ++++
 .../app/pages/lesson-view.component.spec.ts   |  6 ++++
 .../student-view/student-view.component.html  | 13 +++++----
 .../student-view/student-view.component.scss  | 21 ++++++++++++++
 .../app/shared/lesson-viewer.component.html   |  3 +-
 .../app/shared/lesson-viewer.component.scss   | 28 +++++++++++++++++++
 .../pilot-platform-hardening-phase-1/tasks.md |  6 ++--
 17 files changed, 169 insertions(+), 21 deletions(-)

diff --git a/frontend/src/app/components/echo-header/echo-header.component.html b/frontend/src/app/components/echo-header/echo-header.component.html
index f2e6231..d3b4d2d 100644
--- a/frontend/src/app/components/echo-header/echo-header.component.html
+++ b/frontend/src/app/components/echo-header/echo-header.component.html
@@ -1,4 +1,4 @@
-<header class="echo-header sticky top-0 z-30 bg-white/95 backdrop-blur-xl shadow-elevated border-b border-primary/10 px-4 py-4 md:px-5 xl:px-6">
+<header class="echo-header sticky top-0 z-30 bg-white/95 backdrop-blur-xl shadow-elevated border-b border-primary/10 px-4 py-4 md:px-5 xl:px-6" aria-label="Application header">
   <div class="echo-header__row flex flex-wrap items-start justify-between gap-4">
     <div class="echo-header__brand flex min-w-0 items-center gap-3 md:gap-4">
       <div class="h-11 w-11 rounded-2xl bg-gradient-to-br from-primary to-secondary text-white flex items-center justify-center font-bold">EE</div>
@@ -10,7 +10,7 @@ <h1 class="text-lg font-bold text-ink md:text-xl">Command center</h1>
       <span class="badge-soft hidden lg:inline-flex">Investor-ready demo</span>
     </div>
 
-    <div class="echo-header__actions flex w-full flex-wrap items-start justify-end gap-3 lg:w-auto lg:flex-nowrap">
+    <div class="echo-header__actions flex w-full flex-wrap items-start justify-end gap-3 lg:w-auto lg:flex-nowrap" role="group" aria-label="Header actions">
       <div class="hidden lg:flex flex-col items-end gap-2">
         <app-echo-loading-state
           *ngIf="orgsLoading"
@@ -48,6 +48,7 @@ <h1 class="text-lg font-bold text-ink md:text-xl">Command center</h1>
               (ngModelChange)="switchOrg($event)"
               [disabled]="switchPending"
               aria-label="Switch organization"
+              aria-describedby="header-confirmed-org-description"
             >
               <option *ngFor="let org of organizations" [value]="org.id">{{ org.name }}</option>
             </select>
@@ -68,7 +69,7 @@ <h1 class="text-lg font-bold text-ink md:text-xl">Command center</h1>
             title="Organization context unchanged"
             [body]="switchError"
           ></app-echo-state-panel>
-          <div *ngIf="!switchPending && !switchError" class="text-right">
+          <div *ngIf="!switchPending && !switchError" class="text-right" id="header-confirmed-org-description">
             <p class="text-xs font-semibold uppercase tracking-[0.18em] text-primary">Confirmed organization</p>
             <p class="text-sm text-slate-700">{{ activeOrganizationName }}</p>
             <p *ngIf="switchSuccess" class="mt-1 text-xs text-emerald-700">{{ switchSuccess }}</p>
@@ -82,13 +83,19 @@ <h1 class="text-lg font-bold text-ink md:text-xl">Command center</h1>
           (click)="toggleMenu()"
           class="h-11 w-11 rounded-full bg-gradient-to-br from-primary to-secondary text-white flex items-center justify-center font-bold uppercase"
           aria-label="Open profile menu"
+          aria-haspopup="menu"
+          [attr.aria-expanded]="menuOpen"
+          aria-controls="echo-header-profile-menu"
         >
           {{ getInitials() }}
         </button>
         <div
           *ngIf="menuOpen"
           @menuAnim
+          id="echo-header-profile-menu"
           class="absolute right-0 mt-2 w-52 bg-white text-gray-800 rounded-2xl shadow-soft-card ring-1 ring-black/5 z-50"
+          role="menu"
+          aria-label="Profile menu"
         >
           <div class="px-4 py-3 border-b border-slate-100">
             <p class="font-semibold text-primary">{{ userinfo.fullname }}</p>
@@ -99,6 +106,7 @@ <h1 class="text-lg font-bold text-ink md:text-xl">Command center</h1>
               <a
                 class="block px-4 py-2 hover:bg-slate-50 hover:text-primary transition-colors"
                 routerLink="/home/me/preferences"
+                role="menuitem"
               >
                 Profile & Preferences
               </a>
@@ -106,6 +114,7 @@ <h1 class="text-lg font-bold text-ink md:text-xl">Command center</h1>
             <li>
               <button
                 class="w-full text-left px-4 py-2 hover:bg-slate-50 hover:text-primary transition-colors"
+                role="menuitem"
                 (click)="logout()"
               >
                 Logout
diff --git a/frontend/src/app/components/echo-header/echo-header.component.scss b/frontend/src/app/components/echo-header/echo-header.component.scss
index 128cad0..626573c 100644
--- a/frontend/src/app/components/echo-header/echo-header.component.scss
+++ b/frontend/src/app/components/echo-header/echo-header.component.scss
@@ -2,6 +2,24 @@
   min-width: 0;
 }
 
+.echo-header button,
+.echo-header a,
+.echo-header select {
+  transition:
+    box-shadow 140ms ease,
+    background-color 140ms ease,
+    border-color 140ms ease,
+    color 140ms ease,
+    transform 140ms ease;
+}
+
+.echo-header button:focus-visible,
+.echo-header a:focus-visible,
+.echo-header select:focus-visible {
+  outline: none;
+  box-shadow: 0 0 0 3px rgba(14, 116, 144, 0.18);
+}
+
 .echo-header__row,
 .echo-header__brand,
 .echo-header__actions {
@@ -14,6 +32,11 @@ echo-breadcrumbs {
   color: #475569;
 }
 
+.echo-header__actions button:hover,
+.echo-header__actions a:hover {
+  transform: translateY(-1px);
+}
+
 @media (max-width: 1023px) {
   .echo-header__actions {
     align-items: center;
diff --git a/frontend/src/app/components/echo-header/echo-header.component.spec.ts b/frontend/src/app/components/echo-header/echo-header.component.spec.ts
index 0c4b9e6..125202e 100644
--- a/frontend/src/app/components/echo-header/echo-header.component.spec.ts
+++ b/frontend/src/app/components/echo-header/echo-header.component.spec.ts
@@ -204,5 +204,7 @@ describe('EchoHeaderComponent', () => {
     expect(helpButton.getAttribute('aria-label')).toBe('Open help and support');
     expect(guidedTourButton.getAttribute('aria-label')).toBe('Start guided tour');
     expect(profileButton).not.toBeNull();
+    expect(profileButton.getAttribute('aria-haspopup')).toBe('menu');
+    expect(profileButton.getAttribute('aria-controls')).toBe('echo-header-profile-menu');
   });
 });
diff --git a/frontend/src/app/components/echo-sidebar/echo-sidebar.component.html b/frontend/src/app/components/echo-sidebar/echo-sidebar.component.html
index e672574..ae75071 100644
--- a/frontend/src/app/components/echo-sidebar/echo-sidebar.component.html
+++ b/frontend/src/app/components/echo-sidebar/echo-sidebar.component.html
@@ -1,7 +1,8 @@
-<div
+<aside
   class="sidebar-shell bg-white/95 backdrop-blur-lg text-ink h-screen flex flex-col border-r border-slate-200/80 shadow-soft-card"
   [class.sidebar-shell--collapsed]="collapsed"
   [style.width]="collapsed ? 'var(--echo-sidebar-collapsed-width)' : 'var(--echo-sidebar-expanded-width)'"
+  aria-label="Sidebar navigation"
 >
   <div class="flex items-center justify-between p-4 gap-3">
     <div class="flex items-center gap-3 min-w-0" *ngIf="!collapsed">
@@ -16,6 +17,7 @@
       class="sidebar-toggle shrink-0 rounded-xl p-2"
       aria-label="Toggle sidebar"
       [attr.aria-expanded]="!collapsed"
+      aria-controls="echo-primary-navigation"
     >
       <svg xmlns="http://www.w3.org/2000/svg" class="h-6 w-6" fill="none"
            viewBox="0 0 24 24" stroke="currentColor">
@@ -25,11 +27,11 @@
     </button>
   </div>
 
-  <nav class="flex-1 px-2 pb-4 space-y-6 overflow-y-auto" aria-label="Primary navigation">
+  <nav id="echo-primary-navigation" class="flex-1 px-2 pb-4 space-y-6 overflow-y-auto" aria-label="Primary navigation">
     <ng-container *ngIf="ready$ | async; else navSkeleton">
       <ng-container *ngIf="visibleNavSections$ | async as sections">
-        <div *ngFor="let section of sections">
-          <p class="text-xs uppercase tracking-[0.2em] text-slate-700 mb-2 px-2" *ngIf="!collapsed">{{ section.title }}</p>
+        <section *ngFor="let section of sections; let sectionIndex = index" [attr.aria-label]="collapsed ? section.title : null" [attr.aria-labelledby]="!collapsed ? 'sidebar-section-' + sectionIndex : null">
+          <p class="text-xs uppercase tracking-[0.2em] text-slate-700 mb-2 px-2" *ngIf="!collapsed" [id]="'sidebar-section-' + sectionIndex">{{ section.title }}</p>
           <div class="space-y-1">
             <a
               *ngFor="let item of section.items"
@@ -45,7 +47,7 @@
               <span *ngIf="!collapsed" class="font-semibold truncate">{{ item.label }}</span>
             </a>
           </div>
-        </div>
+        </section>
       </ng-container>
     </ng-container>
 
@@ -65,4 +67,4 @@
     <p class="font-semibold text-primary">{{ userInfo.fullname }}</p>
     <p class="text-xs text-slate-700">{{ userInfo.role | titlecase }}</p>
   </div>
-</div>
+</aside>
diff --git a/frontend/src/app/components/echo-sidebar/echo-sidebar.component.scss b/frontend/src/app/components/echo-sidebar/echo-sidebar.component.scss
index ae8c563..78159f0 100644
--- a/frontend/src/app/components/echo-sidebar/echo-sidebar.component.scss
+++ b/frontend/src/app/components/echo-sidebar/echo-sidebar.component.scss
@@ -25,6 +25,11 @@
   background: rgba(46, 41, 78, 0.12);
 }
 
+.sidebar-toggle:focus-visible {
+  outline: none;
+  box-shadow: 0 0 0 3px rgba(14, 116, 144, 0.18);
+}
+
 .sidebar-link {
   gap: 0.75rem;
   min-height: 3rem;
@@ -41,6 +46,7 @@
   color: var(--echo-primary);
   border-color: rgba(46, 41, 78, 0.14);
   box-shadow: inset 0 0 0 1px rgba(46, 41, 78, 0.08);
+  outline: none;
 }
 
 .sidebar-link--active {
diff --git a/frontend/src/app/components/echo-sidebar/echo-sidebar.component.spec.ts b/frontend/src/app/components/echo-sidebar/echo-sidebar.component.spec.ts
index e9bb4d4..434c3fe 100644
--- a/frontend/src/app/components/echo-sidebar/echo-sidebar.component.spec.ts
+++ b/frontend/src/app/components/echo-sidebar/echo-sidebar.component.spec.ts
@@ -87,8 +87,12 @@ describe('SidebarComponent', () => {
 
     const nav = fixture.nativeElement.querySelector('nav') as HTMLElement;
     const toggleButton = fixture.nativeElement.querySelector('button') as HTMLButtonElement;
+    const shell = fixture.nativeElement.querySelector('aside') as HTMLElement;
+    expect(shell.getAttribute('aria-label')).toBe('Sidebar navigation');
     expect(nav.getAttribute('aria-label')).toBe('Primary navigation');
+    expect(nav.getAttribute('id')).toBe('echo-primary-navigation');
     expect(toggleButton.getAttribute('aria-label')).toBe('Toggle sidebar');
     expect(toggleButton.getAttribute('aria-expanded')).toBe('true');
+    expect(toggleButton.getAttribute('aria-controls')).toBe('echo-primary-navigation');
   });
 });
diff --git a/frontend/src/app/pages/home/home.component.html b/frontend/src/app/pages/home/home.component.html
index 861f836..1a5abcf 100644
--- a/frontend/src/app/pages/home/home.component.html
+++ b/frontend/src/app/pages/home/home.component.html
@@ -1,4 +1,5 @@
 <div class="min-h-screen bg-gradient-to-br from-[#0f1629] via-[#f7f3ed] to-[#efe9ff]">
+  <a class="skip-link" href="#echoed-main-content">Skip to main content</a>
   <ng-container *ngIf="(ready$ | async) && (userInfo$ | async) as userInfo; else shellLoading">
     <div
       class="home-shell min-h-screen"
@@ -17,7 +18,12 @@
       ></echo-sidebar>
       <div class="home-shell__main flex flex-col min-h-screen">
         <echo-header *ngIf="!lessonMode" [userinfo]="userInfo" @fade></echo-header>
-        <main class="home-shell__content flex-1 overflow-y-auto p-4 md:p-5 xl:p-6">
+        <main
+          id="echoed-main-content"
+          class="home-shell__content flex-1 overflow-y-auto p-4 md:p-5 xl:p-6"
+          tabindex="-1"
+          [attr.aria-label]="lessonMode ? 'Lesson content' : 'Authenticated application content'"
+        >
           <div *ngIf="!lessonMode" class="max-w-7xl mx-auto">
             <div class="mb-4 surface-card flex flex-wrap items-center justify-between gap-3 p-4 md:p-5">
               <div>
diff --git a/frontend/src/app/pages/home/home.component.scss b/frontend/src/app/pages/home/home.component.scss
index cb3c663..e2d35f7 100644
--- a/frontend/src/app/pages/home/home.component.scss
+++ b/frontend/src/app/pages/home/home.component.scss
@@ -1,3 +1,24 @@
+.skip-link {
+  position: absolute;
+  left: 1rem;
+  top: 1rem;
+  z-index: 60;
+  transform: translateY(-220%);
+  border-radius: 9999px;
+  background: #ffffff;
+  color: var(--echo-primary, #0e7490);
+  padding: 0.75rem 1rem;
+  font-size: 0.95rem;
+  font-weight: 700;
+  box-shadow: 0 0 0 3px rgba(14, 116, 144, 0.18);
+  transition: transform 140ms ease;
+}
+
+.skip-link:focus {
+  transform: translateY(0);
+  outline: none;
+}
+
 .home-shell {
   display: grid;
   grid-template-columns: var(--echo-shell-sidebar-width, var(--echo-sidebar-expanded-width)) minmax(0, 1fr);
@@ -23,6 +44,10 @@
   min-width: 0;
 }
 
+.home-shell__content:focus {
+  outline: none;
+}
+
 @media (max-width: 1023px) {
   .home-shell {
     grid-template-columns: var(--echo-shell-sidebar-width, var(--echo-sidebar-collapsed-width)) minmax(0, 1fr);
diff --git a/frontend/src/app/pages/home/home.component.spec.ts b/frontend/src/app/pages/home/home.component.spec.ts
index 7aa8149..5b6bbe0 100644
--- a/frontend/src/app/pages/home/home.component.spec.ts
+++ b/frontend/src/app/pages/home/home.component.spec.ts
@@ -93,6 +93,15 @@ describe('HomeComponent', () => {
     expect(fixture.nativeElement.querySelector('echo-sidebar')).toBeNull();
   });
 
+  it('exposes skip navigation and a focusable main landmark', () => {
+    const skipLink = fixture.nativeElement.querySelector('.skip-link') as HTMLAnchorElement;
+    const main = fixture.nativeElement.querySelector('main') as HTMLElement;
+
+    expect(skipLink.getAttribute('href')).toBe('#echoed-main-content');
+    expect(main.getAttribute('id')).toBe('echoed-main-content');
+    expect(main.getAttribute('tabindex')).toBe('-1');
+  });
+
   it('preserves lesson-mode shell behavior after readiness', () => {
     component.lessonMode = true;
     fixture.detectChanges();
diff --git a/frontend/src/app/pages/lesson-view.component.html b/frontend/src/app/pages/lesson-view.component.html
index 68c9628..291496c 100644
--- a/frontend/src/app/pages/lesson-view.component.html
+++ b/frontend/src/app/pages/lesson-view.component.html
@@ -18,7 +18,7 @@ <h2 id="lesson-page-title" class="text-2xl font-bold text-ink">{{ lesson?.title
             {{ lesson?.duration_minutes }} min
           </span>
         </div>
-        <button aria-label="Exit lesson and return to dashboard" class="rounded-xl border border-primary bg-white px-4 py-2.5 text-sm font-semibold text-primary transition hover:bg-primary/5" (click)="returnToDashboard()">Exit lesson</button>
+        <button aria-label="Exit lesson and return to dashboard" class="lesson-runtime__exit-button rounded-xl border border-primary bg-white px-4 py-2.5 text-sm font-semibold text-primary transition hover:bg-primary/5" (click)="returnToDashboard()">Exit lesson</button>
       </div>
     </header>
 
diff --git a/frontend/src/app/pages/lesson-view.component.scss b/frontend/src/app/pages/lesson-view.component.scss
index 5c9991f..557b26d 100644
--- a/frontend/src/app/pages/lesson-view.component.scss
+++ b/frontend/src/app/pages/lesson-view.component.scss
@@ -1,3 +1,8 @@
 .lesson-runtime {
   min-width: 0;
 }
+
+.lesson-runtime__exit-button:focus-visible {
+  outline: none;
+  box-shadow: 0 0 0 3px rgba(14, 116, 144, 0.18);
+}
diff --git a/frontend/src/app/pages/lesson-view.component.spec.ts b/frontend/src/app/pages/lesson-view.component.spec.ts
index 79d74ab..01543c8 100644
--- a/frontend/src/app/pages/lesson-view.component.spec.ts
+++ b/frontend/src/app/pages/lesson-view.component.spec.ts
@@ -92,6 +92,12 @@ describe('LessonViewComponent', () => {
     expect(exitButton).not.toBeNull();
   });
 
+  it('keeps lesson error and governed states labeled for assistive technology', () => {
+    const compiled = fixture.nativeElement as HTMLElement;
+    const blockedState = compiled.querySelector('[data-echo-state="blocked"]') as HTMLElement;
+    expect(blockedState.getAttribute('aria-label')).toBe('governed-lesson-state');
+  });
+
   it('renders a generic retryable error state when the governed segment cannot be restored', () => {
     const coursesService = TestBed.inject(CoursesService) as unknown as MockCoursesService;
     coursesService.getCurrentSegment.and.returnValue(throwError(() => new Error('segment failed')));
diff --git a/frontend/src/app/pages/user-dashboard/student-view/student-view.component.html b/frontend/src/app/pages/user-dashboard/student-view/student-view.component.html
index e5a7b12..ad07c41 100644
--- a/frontend/src/app/pages/user-dashboard/student-view/student-view.component.html
+++ b/frontend/src/app/pages/user-dashboard/student-view/student-view.component.html
@@ -64,11 +64,11 @@ <h2 class="text-2xl font-bold md:text-3xl">{{userInfo.fullname}}</h2>
         </p>
         <p class="mt-1 text-base font-semibold text-ink">{{ activeContinuationTitle }}</p>
         <p class="mt-1 text-sm leading-6 text-slate-700">{{ activeStudentCourseReason }}</p>
-        <div class="mt-3 rounded-2xl border border-slate-200 bg-slate-50/90 p-4">
+        <div class="mt-3 rounded-2xl border border-slate-200 bg-slate-50/90 p-4" aria-labelledby="student-course-progress-heading">
           <div class="flex flex-wrap items-center justify-between gap-3">
             <div>
-              <p class="text-xs font-semibold uppercase tracking-[0.16em] text-slate-600">Governed course progress</p>
-              <p class="mt-1 text-sm text-slate-700">Your next lesson follows the current approved learning path and saves progress automatically.</p>
+              <p id="student-course-progress-heading" class="text-xs font-semibold uppercase tracking-[0.16em] text-slate-600">Governed course progress</p>
+              <p id="student-course-progress-description" class="mt-1 text-sm text-slate-700">Your next lesson follows the current approved learning path and saves progress automatically.</p>
             </div>
             <div class="text-right">
               <p class="text-2xl font-bold text-primary">{{ activeCourseProgress | number:'1.0-0' }}%</p>
@@ -81,6 +81,7 @@ <h2 class="text-2xl font-bold md:text-3xl">{{userInfo.fullname}}</h2>
               [style.width.%]="activeCourseProgress"
               role="progressbar"
               aria-label="Active course progress"
+              aria-describedby="student-course-progress-description"
               [attr.aria-valuenow]="activeCourseProgress"
               aria-valuemin="0"
               aria-valuemax="100"
@@ -179,7 +180,7 @@ <h2 class="text-2xl font-bold md:text-3xl">{{userInfo.fullname}}</h2>
     <section class="surface-card p-5 md:p-6 lg:col-span-2" aria-labelledby="student-courses-heading">
       <div class="mb-4 flex flex-wrap items-center justify-between gap-3">
         <h3 class="text-xl font-bold text-primary">My Courses</h3>
-        <button class="text-sm font-semibold text-primary underline underline-offset-4" aria-label="Explore the full course catalog" (click)="goToAvailableCourses()">Explore catalog</button>
+        <button class="student-dashboard__text-link text-sm font-semibold text-primary underline underline-offset-4" aria-label="Explore the full course catalog" (click)="goToAvailableCourses()">Explore catalog</button>
       </div>
       <app-echo-loading-state
         *ngIf="coursesLoading"
@@ -252,7 +253,7 @@ <h3 class="text-xl font-bold text-primary mb-3">What's next</h3>
           <h3 class="text-xl font-bold text-primary">Certification Paths</h3>
           <p class="text-sm leading-6 text-slate-700">Program progress now groups existing courses into structured outcomes.</p>
         </div>
-        <button class="text-sm font-semibold text-primary underline underline-offset-4" (click)="goToPrograms()">Open all programs</button>
+        <button class="student-dashboard__text-link text-sm font-semibold text-primary underline underline-offset-4" (click)="goToPrograms()">Open all programs</button>
       </div>
       <app-echo-loading-state
         *ngIf="programsLoading"
@@ -295,7 +296,7 @@ <h3 class="text-xl font-bold text-primary">Certification Paths</h3>
     <div class="surface-card bg-gradient-to-br from-emerald-50 to-white p-5 md:p-6">
       <div class="mb-3 flex flex-wrap items-center justify-between gap-3">
         <h3 class="text-xl font-bold text-primary">Certifications</h3>
-        <button class="text-sm font-semibold text-primary underline underline-offset-4" (click)="goToCertifications()">View all</button>
+        <button class="student-dashboard__text-link text-sm font-semibold text-primary underline underline-offset-4" (click)="goToCertifications()">View all</button>
       </div>
       <app-echo-loading-state
         *ngIf="certificationsLoading"
diff --git a/frontend/src/app/pages/user-dashboard/student-view/student-view.component.scss b/frontend/src/app/pages/user-dashboard/student-view/student-view.component.scss
index debbca1..89f6e01 100644
--- a/frontend/src/app/pages/user-dashboard/student-view/student-view.component.scss
+++ b/frontend/src/app/pages/user-dashboard/student-view/student-view.component.scss
@@ -11,6 +11,27 @@
   white-space: nowrap;
 }
 
+.student-dashboard button,
+.student-dashboard a {
+  transition:
+    box-shadow 140ms ease,
+    border-color 140ms ease,
+    background-color 140ms ease,
+    color 140ms ease,
+    transform 140ms ease;
+}
+
+.student-dashboard button:focus-visible,
+.student-dashboard a:focus-visible {
+  outline: none;
+  box-shadow: 0 0 0 3px rgba(14, 116, 144, 0.18);
+}
+
+.student-dashboard__text-link:hover,
+.student-dashboard__text-link:focus-visible {
+  text-decoration-thickness: 2px;
+}
+
 @media (max-width: 767px) {
   .student-dashboard__hero {
     border-radius: 20px;
diff --git a/frontend/src/app/shared/lesson-viewer.component.html b/frontend/src/app/shared/lesson-viewer.component.html
index 685ad56..b4ca482 100644
--- a/frontend/src/app/shared/lesson-viewer.component.html
+++ b/frontend/src/app/shared/lesson-viewer.component.html
@@ -25,7 +25,7 @@ <h2 class="text-2xl font-bold text-[#1A1A40]">{{ lesson.title }}</h2>
             <span *ngIf="isLastActivity">You are on the final activity for this lesson.</span>
           </p>
         </div>
-        <p class="text-right text-sm font-semibold text-slate-700" role="status" aria-live="polite">
+        <p id="lesson-activity-progress-summary" class="text-right text-sm font-semibold text-slate-700" role="status" aria-live="polite">
           {{ activityProgressPercent }}% complete
         </p>
       </div>
@@ -34,6 +34,7 @@ <h2 class="text-2xl font-bold text-[#1A1A40]">{{ lesson.title }}</h2>
           class="h-full rounded-full bg-gradient-to-r from-primary to-accent"
           role="progressbar"
           aria-label="Lesson activity progress"
+          aria-describedby="lesson-activity-progress-summary"
           [attr.aria-valuenow]="activityProgressPercent"
           aria-valuemin="0"
           aria-valuemax="100"
diff --git a/frontend/src/app/shared/lesson-viewer.component.scss b/frontend/src/app/shared/lesson-viewer.component.scss
index 83696fb..e211f5c 100644
--- a/frontend/src/app/shared/lesson-viewer.component.scss
+++ b/frontend/src/app/shared/lesson-viewer.component.scss
@@ -7,6 +7,34 @@
   min-width: 0;
 }
 
+.lesson-viewer button,
+.lesson-viewer a,
+.lesson-viewer textarea,
+.lesson-viewer input,
+.lesson-viewer iframe,
+.lesson-viewer audio,
+.lesson-viewer video {
+  transition:
+    box-shadow 140ms ease,
+    border-color 140ms ease,
+    background-color 140ms ease,
+    color 140ms ease,
+    transform 140ms ease;
+}
+
+.lesson-viewer button:focus-visible,
+.lesson-viewer a:focus-visible,
+.lesson-viewer textarea:focus-visible,
+.lesson-viewer input:focus-visible {
+  outline: none;
+  box-shadow: 0 0 0 3px rgba(14, 116, 144, 0.18);
+}
+
+.lesson-viewer textarea:focus-visible,
+.lesson-viewer input:focus-visible {
+  border-color: rgba(14, 116, 144, 0.32);
+}
+
 @media (max-width: 767px) {
   .lesson-viewer__actions button {
     width: 100%;
diff --git a/openspec/changes/pilot-platform-hardening-phase-1/tasks.md b/openspec/changes/pilot-platform-hardening-phase-1/tasks.md
index 9b3f453..4221a58 100644
--- a/openspec/changes/pilot-platform-hardening-phase-1/tasks.md
+++ b/openspec/changes/pilot-platform-hardening-phase-1/tasks.md
@@ -30,9 +30,9 @@
 
 ## 6. Accessibility pass
 
-- [ ] 6.1 Review pilot-critical student, teacher, shell, and lesson surfaces for contrast, focus visibility, keyboard order, and labeling defects
-- [ ] 6.2 Fix obvious unreadable text, weak contrast, and missing actionable semantics in core pilot flows
-- [ ] 6.3 Document any remaining accessibility limitations that are intentionally deferred beyond Phase 1
+- [x] 6.1 Review pilot-critical student, teacher, shell, and lesson surfaces for contrast, focus visibility, keyboard order, and labeling defects
+- [x] 6.2 Fix obvious unreadable text, weak contrast, and missing actionable semantics in core pilot flows
+- [x] 6.3 Document any remaining accessibility limitations that are intentionally deferred beyond Phase 1
 
 ## 7. Backend runtime verification
 

From dccb82914379e25ad8132b480b64a1824a9d7403 Mon Sep 17 00:00:00 2001
From: Anthony Wright <anthony@mrwrite.dev>
Date: Tue, 26 May 2026 16:51:16 -0500
Subject: [PATCH 07/14] test: strengthen governed runtime verification

---
 backend/app/crud/progress.py                  | 79 ++++++++---------
 backend/tests/test_seed_demo_auth.py          | 36 ++++++++
 backend/tests/test_start_course_endpoint.py   | 85 +++++++++++++++++++
 .../pilot-platform-hardening-phase-1/tasks.md |  6 +-
 4 files changed, 164 insertions(+), 42 deletions(-)

diff --git a/backend/app/crud/progress.py b/backend/app/crud/progress.py
index 1cd5532..d362317 100644
--- a/backend/app/crud/progress.py
+++ b/backend/app/crud/progress.py
@@ -125,16 +125,17 @@ def update_segment_progress_status(db: Session, progress_id: UUID, new_status: s
         if unit_progress:
             unit = db.get(Unit, unit_progress.unit_id) if unit_progress else None
             governed_selection = governed_lessons_for_unit(unit) if unit else None
+            governed_delivery_active = (
+                governed_selection is not None
+                and governed_selection.state == GOVERNED_AVAILABLE
+            )
             all_segments = (
                 db.query(SegmentProgress)
                 .filter(SegmentProgress.student_unit_id == unit_progress.id)
                 .all()
             )
             relevant_segments = all_segments
-            if (
-                governed_selection is not None
-                and governed_selection.state == GOVERNED_AVAILABLE
-            ):
+            if governed_delivery_active:
                 governed_lesson_ids = {
                     lesson.id for lesson in governed_selection.lessons
                 }
@@ -205,47 +206,47 @@ def update_segment_progress_status(db: Session, progress_id: UUID, new_status: s
                     next_unit = None
 
                 if next_unit:
-                    existing_next = (
-                        db.query(StudentUnitProgress)
-                        .filter(
-                            StudentUnitProgress.student_course_id == student_course.id,
-                            StudentUnitProgress.unit_id == next_unit.id,
-                        )
-                        .first()
-                    )
-
-                    if not existing_next:
-                        new_progress = create_student_unit_progress(
-                            db,
-                            student_course.id,
-                            next_unit.id,
-                        )
-
-                        new_progress.status = ProgressStatus.IN_PROGRESS
-                        new_progress.started_at = datetime.utcnow()
-                        new_progress.last_updated = datetime.utcnow()
-                        next_unit_lessons = (
-                            db.query(Lesson)
-                            .filter(Lesson.unit_id == next_unit.id)
-                            .order_by(Lesson.order.asc())
-                            .all()
+                    if not governed_delivery_active:
+                        existing_next = (
+                            db.query(StudentUnitProgress)
+                            .filter(
+                                StudentUnitProgress.student_course_id == student_course.id,
+                                StudentUnitProgress.unit_id == next_unit.id,
+                            )
+                            .first()
                         )
 
-                        for lesson in next_unit_lessons:
-                            seg = create_segment_progress(
+                        if not existing_next:
+                            new_progress = create_student_unit_progress(
                                 db,
-                                new_progress.id,
-                                lesson.id,
+                                student_course.id,
+                                next_unit.id,
+                            )
+
+                            new_progress.status = ProgressStatus.IN_PROGRESS
+                            new_progress.started_at = datetime.utcnow()
+                            new_progress.last_updated = datetime.utcnow()
+                            next_unit_lessons = (
+                                db.query(Lesson)
+                                .filter(Lesson.unit_id == next_unit.id)
+                                .order_by(Lesson.order.asc())
+                                .all()
                             )
 
-                            # First lesson becomes active immediately
-                            if lesson == next_unit_lessons[0]:
-                                seg.status = ProgressStatus.IN_PROGRESS
-                                seg.started_at = datetime.utcnow()
-                                seg.last_updated = datetime.utcnow()
+                            for lesson in next_unit_lessons:
+                                seg = create_segment_progress(
+                                    db,
+                                    new_progress.id,
+                                    lesson.id,
+                                )
+
+                                # First lesson becomes active immediately
+                                if lesson == next_unit_lessons[0]:
+                                    seg.status = ProgressStatus.IN_PROGRESS
+                                    seg.started_at = datetime.utcnow()
+                                    seg.last_updated = datetime.utcnow()
 
-                        
-                        db.commit()
+                            db.commit()
 
                 else:
                     student_course.status = "completed"
diff --git a/backend/tests/test_seed_demo_auth.py b/backend/tests/test_seed_demo_auth.py
index 335ab09..9405755 100644
--- a/backend/tests/test_seed_demo_auth.py
+++ b/backend/tests/test_seed_demo_auth.py
@@ -57,6 +57,42 @@ def test_seed_demo_is_idempotent_and_resets_passwords(db_engine, monkeypatch):
         session.close()
 
 
+def test_seed_demo_reseed_restores_demo_identity_by_username_and_email(db_engine, monkeypatch):
+    session_factory = _build_session_factory(db_engine)
+
+    _seed_with_factory(monkeypatch, session_factory)
+
+    session = session_factory()
+    try:
+        student = session.query(User).filter(User.username == "student1").one()
+        teacher = session.query(User).filter(User.username == "teacher").one()
+        student.username = "legacy_student1"
+        teacher.email = "legacy-teacher@example.com"
+        session.commit()
+    finally:
+        session.close()
+
+    _seed_with_factory(monkeypatch, session_factory)
+
+    session = session_factory()
+    try:
+        restored_student = session.query(User).filter(User.username == "student1").one()
+        restored_teacher = session.query(User).filter(User.username == "teacher").one()
+
+        assert restored_student.email == seed_demo.DEMO_USERS["student1"]["email"]
+        assert restored_student.firstname == seed_demo.DEMO_USERS["student1"]["firstname"]
+        assert verify_password(seed_demo.DEMO_PASSWORD, restored_student.hashed_password)
+
+        assert restored_teacher.email == seed_demo.DEMO_USERS["teacher"]["email"]
+        assert restored_teacher.firstname == seed_demo.DEMO_USERS["teacher"]["firstname"]
+        assert verify_password(seed_demo.DEMO_PASSWORD, restored_teacher.hashed_password)
+
+        assert session.query(User).filter(User.username == "legacy_student1").count() == 0
+        assert session.query(User).filter(User.email == "legacy-teacher@example.com").count() == 0
+    finally:
+        session.close()
+
+
 def test_seed_demo_creates_governed_ordered_student_path(db_engine, monkeypatch):
     session_factory = _build_session_factory(db_engine)
     _seed_with_factory(monkeypatch, session_factory)
diff --git a/backend/tests/test_start_course_endpoint.py b/backend/tests/test_start_course_endpoint.py
index dd9e1f9..d432e34 100644
--- a/backend/tests/test_start_course_endpoint.py
+++ b/backend/tests/test_start_course_endpoint.py
@@ -395,3 +395,88 @@ def test_completion_does_not_advance_to_stale_non_governed_segment(db_session, t
     assert stale_draft_segment.status == ProgressStatus.NOT_STARTED
     assert unit_progress.status == ProgressStatus.COMPLETED
     assert student_course.status == "completed"
+
+
+def test_completed_governed_unit_returns_pending_review_when_next_unit_has_no_approved_lessons(
+    db_session, test_student
+):
+    course = Course(id=uuid.uuid4(), title="Course F", description="Governed block after completion")
+    unit1 = Unit(id=uuid.uuid4(), title="Unit 1", course_id=course.id, order=1)
+    unit2 = Unit(id=uuid.uuid4(), title="Unit 2", course_id=course.id, order=2)
+    lesson1 = Lesson(
+        id=uuid.uuid4(),
+        title="Approved Lesson",
+        unit_id=unit1.id,
+        duration_minutes=5,
+        order=1,
+        objective="Objective",
+        learning_objectives="Learning objective",
+        key_concepts=["concept"],
+        hook="Hook",
+        content="Content",
+        guided_practice="Guided",
+        independent_practice="Independent",
+        assessment="Assessment",
+        review_status="approved",
+    )
+    reviewed_lesson = Lesson(
+        id=uuid.uuid4(),
+        title="Reviewed Lesson",
+        unit_id=unit2.id,
+        duration_minutes=5,
+        order=1,
+        objective="Objective",
+        learning_objectives="Learning objective",
+        key_concepts=["concept"],
+        hook="Hook",
+        content="Content",
+        guided_practice="Guided",
+        independent_practice="Independent",
+        assessment="Assessment",
+        review_status="reviewed",
+    )
+    db_session.add_all([course, unit1, unit2, lesson1, reviewed_lesson])
+    db_session.commit()
+    db_session.add_all([
+        Source(lesson_id=lesson1.id, citation="Source 1", url="https://example.com/1"),
+        Source(lesson_id=reviewed_lesson.id, citation="Source 2", url="https://example.com/2"),
+    ])
+    db_session.commit()
+
+    student_course = StudentCourse(student_id=test_student.id, course_id=course.id)
+    db_session.add(student_course)
+    db_session.commit()
+    db_session.refresh(student_course)
+
+    start_state = progress_crud.resolve_governed_progression(db_session, student_course.id)
+    assert start_state["delivery_state"] == "governed_available"
+    assert start_state["lesson_id"] == lesson1.id
+
+    current_segment = (
+        db_session.query(SegmentProgress)
+        .filter_by(
+            student_unit_id=start_state["unit_progress_id"],
+            lesson_id=lesson1.id,
+        )
+        .one()
+    )
+    progress_crud.update_segment_progress_status(
+        db_session, current_segment.id, ProgressStatus.COMPLETED
+    )
+
+    next_state = progress_crud.resolve_governed_progression(db_session, student_course.id)
+    assert next_state["delivery_state"] == "pending_review"
+    assert "review" in next_state["detail"].lower()
+
+    blocked_unit_progress = (
+        db_session.query(StudentUnitProgress)
+        .filter_by(student_course_id=student_course.id, unit_id=unit2.id)
+        .first()
+    )
+    if blocked_unit_progress is not None:
+        blocked_segments = (
+            db_session.query(SegmentProgress)
+            .filter_by(student_unit_id=blocked_unit_progress.id)
+            .all()
+        )
+        assert blocked_segments == []
diff --git a/openspec/changes/pilot-platform-hardening-phase-1/tasks.md b/openspec/changes/pilot-platform-hardening-phase-1/tasks.md
index 4221a58..2834834 100644
--- a/openspec/changes/pilot-platform-hardening-phase-1/tasks.md
+++ b/openspec/changes/pilot-platform-hardening-phase-1/tasks.md
@@ -36,9 +36,9 @@
 
 ## 7. Backend runtime verification
 
-- [ ] 7.1 Audit progression and runtime routes that govern course start, lesson continuation, segment completion, and governed blocked behavior
-- [ ] 7.2 Fix or reinforce any targeted progression/runtime defects while preserving real auth and governed delivery rules
-- [ ] 7.3 Extend or refresh backend pytest coverage for governed progression safety, non-governed progression continuity, and deterministic demo seed behavior
+- [x] 7.1 Audit progression and runtime routes that govern course start, lesson continuation, segment completion, and governed blocked behavior
+- [x] 7.2 Fix or reinforce any targeted progression/runtime defects while preserving real auth and governed delivery rules
+- [x] 7.3 Extend or refresh backend pytest coverage for governed progression safety, non-governed progression continuity, and deterministic demo seed behavior
 
 ## 8. Smoke tests / docs
 

From 7f9349de5a05e09c42c32b9a34d60654621e2551 Mon Sep 17 00:00:00 2001
From: Anthony Wright <anthony@mrwrite.dev>
Date: Tue, 26 May 2026 17:04:01 -0500
Subject: [PATCH 08/14] docs: add pilot verification runbooks

---
 docs/demo-readiness.md                        | 353 ++++++------------
 docs/demo-smoke-validation.md                 |  56 ++-
 docs/pilot-verification-checklist.md          |  91 +++++
 .../pilot-platform-hardening-phase-1/tasks.md |   6 +-
 4 files changed, 264 insertions(+), 242 deletions(-)
 create mode 100644 docs/pilot-verification-checklist.md

diff --git a/docs/demo-readiness.md b/docs/demo-readiness.md
index c13ee3f..2682f7c 100644
--- a/docs/demo-readiness.md
+++ b/docs/demo-readiness.md
@@ -1,9 +1,11 @@
 # Demo Readiness Runbook
 
-This runbook documents the deterministic EchoEd demo environment used for the flagship `Introduction to Africa` walkthrough.
+This runbook documents the bounded EchoEd pilot-demo startup flow for the deterministic flagship environment.
 
-Related planning document:
+Related runbooks:
 
+- [Demo Smoke Validation](./demo-smoke-validation.md)
+- [Pilot Verification Checklist](./pilot-verification-checklist.md)
 - [Demo UI Polish Checklist](./demo-ui-polish-checklist.md)
 
 ## Purpose
@@ -11,11 +13,39 @@ Related planning document:
 Use this flow before a live demo when you need to:
 
 - apply schema migrations
-- rebuild the canonical demo organization and users
-- reset flagship learner progress and evidence into known states
-- verify the expected teacher and admin story without manual repair
+- reseed the canonical demo organization, users, and flagship course
+- restore deterministic learner/runtime states
+- verify the bounded student and teacher walkthrough paths without manual database repair
 
-## Demo Setup
+## Canonical Demo Context
+
+- Demo organization: `EchoEd Demo School`
+- Flagship course: `Introduction to Africa`
+- Demo section: `Grade 3 - Cohort A`
+- Shared seeded password: `password`
+
+## Canonical Demo Accounts
+
+### Staff
+
+- `orgadmin` / `password`
+- `teacher` / `password`
+- `contentadmin` / `password`
+
+### Reference students
+
+- `student1` / `password`
+- `student2` / `password`
+
+### Deterministic flagship archetypes
+
+- `masteredstudent` -> expected runtime state `enrichment`
+- `reteachstudent` -> expected runtime state `reteach`
+- `reviewstudent` -> expected runtime state `review`
+- `monitorstudent` -> expected runtime state `monitor`
+- `normalstudent` -> expected runtime state `normal`
+
+## Startup Flow
 
 ### 1. Apply backend migrations
 
@@ -26,8 +56,6 @@ cd backend
 venv\Scripts\python.exe -m alembic upgrade head
 ```
 
-If you are using an activated virtual environment, `python -m alembic upgrade head` is equivalent.
-
 ### 2. Reseed the deterministic demo
 
 From the repo root:
@@ -36,247 +64,110 @@ From the repo root:
 backend\venv\Scripts\python.exe backend\scripts\reseed_demo.py
 ```
 
-What this does:
+What this guarantees:
 
-- reuses the real `app.seed_demo.run()` entrypoint
-- refreshes the canonical demo organization and memberships
-- refreshes the flagship `Introduction to Africa` course structure
-- reseeds the canonical section, enrollments, student-course rows, progress rows, attempts, answers, and attempt events
-- restores the demo archetypes to stable runtime states
+- canonical demo users are reset to their known usernames, emails, roles, and passwords
+- duplicate demo identities are cleaned up before final upsert
+- flagship learner progress, attempts, and intervention states return to deterministic demo defaults
 
-The command is safe to rerun for repeat demo preparation. It is intentionally bounded to the demo-scoped seed identities and flagship course state.
+### 3. Start the backend
 
-## Canonical Demo Context
+Make the backend available locally at `http://127.0.0.1:8000` using your normal development startup command.
 
-- Demo organization: `EchoEd Demo School`
-- Flagship course: `Introduction to Africa`
-- Demo section: `Grade 3 - Cohort A`
-- Shared password for seeded accounts: `password`
+### 4. Start the frontend
 
-## Demo Accounts
+From `frontend`:
 
-### Staff accounts
+```powershell
+npm start
+```
 
-- Org admin: `orgadmin` / `password`
-- Teacher: `teacher` / `password`
-- Content admin: `contentadmin` / `password`
+The frontend dev server is expected at `http://127.0.0.1:4200` and proxies `/api` calls to the backend.
 
-### Reference student accounts
+## Automated Confidence Layer
 
-- `student1` / `password`
-- `student2` / `password`
+Phase 1 treats these as the authoritative automated checks:
 
-These two learners stay available as clean student accounts for baseline learner-flow demos and regression coverage.
+```powershell
+cd backend
+pytest -q
+```
+
+```powershell
+cd frontend
+cmd /c .\node_modules\.bin\ng.cmd test --watch=false --browsers=ChromeHeadless
+```
 
-## Flagship Learner Archetypes
+```powershell
+cd frontend
+cmd /c .\node_modules\.bin\playwright.cmd test tests/demo/student-flagship-smoke.spec.ts
+```
 
-The seeded archetypes are the canonical learners for the deterministic teacher/admin demo story.
+What they prove:
 
-- Enrichment/mastered: `masteredstudent` / `password`
-  - Expected runtime recommendation: `enrichment`
-  - Expected state: completed flagship course with completed unit and segment progress
-- Reteach/struggling: `reteachstudent` / `password`
-  - Expected runtime recommendation: `reteach`
-  - Expected state: active flagship course with weak real assessment evidence
-- Review/moderate: `reviewstudent` / `password`
-  - Expected runtime recommendation: `review`
-  - Expected state: active flagship course with mixed but coherent evidence
-- Monitor/ambiguous: `monitorstudent` / `password`
-  - Expected runtime recommendation: `monitor`
-  - Expected state: active flagship course with ambiguous competency evidence
-- Normal progression: `normalstudent` / `password`
-  - Expected runtime recommendation: `normal`
-  - Expected state: active flagship course with governed progress and no special intervention signal
+- backend runtime, progression, auth, and demo-seed regressions remain covered
+- Angular component and route behavior remains covered
+- one real-browser student flagship path still works: login, dashboard, continue lesson, governed lesson entry
 
-## Expected Teacher/Admin Outcomes
+What remains intentionally manual in Phase 1:
 
-After reseeding, staff-facing reads should be predictable:
-
-- The flagship teacher runtime support view should surface a stable mix of intervention needs across the archetypes.
-- The mastered learner should present as enrichment-ready.
-- The reteach learner should present as needing targeted reteach support.
-- The review learner should present as needing short review before continuing.
-- The monitor learner should present as needing educator monitoring because the evidence is intentionally ambiguous.
-- The normal learner should present as governed normal continuation.
-
-## Staff Governance Demo Checks
-
-Use these checks when you want to prove the flagship demo course is staff-ready from a governance perspective.
-
-### 1. Publish readiness
-
-- Inspect: `GET /api/courses/{course_id}/publish-readiness` or the staff publish-readiness section.
-- Expected outcome: the flagship course is ready to publish.
-- Expected details:
-  - `is_ready = true`
-  - no blocking issues
-  - no warnings
-- Demo users: `orgadmin`, `teacher`, or `contentadmin`
-- Expected vs unexpected:
-  - expected: no publish-readiness warnings
-  - unexpected: missing readiness fields, draft review status, or ordering issues
-
-### 2. Safe publish validation
-
-- Inspect: `GET /api/courses/{course_id}/safe-publish-validation` or the staff safe-publish section.
-- Expected outcome: the flagship course is safe to publish.
-- Expected details:
-  - `is_safe = true`
-  - no blocking issues
-  - no warnings
-- Demo users: `orgadmin`, `teacher`, or `contentadmin`
-- Expected vs unexpected:
-  - expected: no safe-publish warnings
-  - unexpected: blocked revision state, unsafe historical evidence, or deprecated learner-facing curriculum state
-
-### 3. Governance summary
-
-- Inspect: `GET /api/courses/{course_id}/governance-summary`
-- Expected outcome: one staff-readable payload with all governance sections present.
-- UI alignment: if you are showing the staff governance dashboard, this route is the backend summary payload that should back the existing governance sections without changing their wording.
-- Expected sections:
-  - `publish_readiness`
-  - `safe_publish_validation`
-  - `lineage_safety_visibility`
-  - `competency_evidence_integrity`
-  - `runtime_intervention_recommendations`
-- Demo users: `orgadmin` is the simplest demo account for this check
-- Expected vs unexpected:
-  - expected: lineage/safety shows coherent and safe
-  - unexpected: missing sections, learner access, or route-level mismatches between summary and individual reads
-
-### 4. Competency evidence integrity
-
-- Inspect: `GET /api/courses/{course_id}/competency-evidence-integrity`
-- Expected outcome: valid but intentionally not fully explainable.
-- Expected details:
-  - `is_valid = true`
-  - `is_explainable = false`
-  - one warning on `Introduction to Africa Ambiguous Evidence Check`
-  - warning code: `unaligned_assessment_mastery_evidence`
-- Demo user/archetype proving the warning: `monitorstudent` / Dayo Monitor
-- Expected vs unexpected:
-  - expected: exactly the ambiguity warning tied to the ambiguous evidence check
-  - unexpected: blocking issues, unsafe historical evidence, or unexplained warnings on the flagship aligned checks
-
-### 5. Runtime intervention recommendations
-
-- Inspect: `GET /api/courses/{course_id}/runtime-intervention-recommendations` or the staff runtime/intervention section.
-- Expected outcome: all five learner stories are present.
-- Expected learner mapping:
-  - `masteredstudent` / Amara Mastery -> `enrichment`
-  - `reteachstudent` / Binta Reteach -> `reteach`
-  - `reviewstudent` / Chidi Review -> `review`
-  - `monitorstudent` / Dayo Monitor -> `monitor`
-  - `normalstudent` / Eshe Steady -> `normal`
-- Expected vs unexpected:
-  - expected: `monitorstudent` includes `ambiguous_competency_evidence`
-  - expected: `monitorstudent` and `normalstudent` include `limited_mastery_evidence`
-  - unexpected: all learners collapsing to one state, or the ambiguous evidence warning leaking onto the aligned archetypes
-
-### 6. Learner denial
-
-- Inspect: attempt the same governance endpoints while authenticated as `student1` or `student2`
-- Expected outcome: learners are denied from staff governance reads.
-- Expected details:
-  - `403` for publish readiness
-  - `403` for safe publish validation
-  - `403` for competency evidence integrity
-  - `403` for governance summary
-  - `403` for runtime intervention recommendations
-
-## Recommended Live Demo Path
+- teacher dashboard walkthrough quality and narration
+- staff governance-summary storytelling
+- broader platform resilience outside the bounded flagship smoke
+
+## Recommended Demo Walkthrough
 
 1. Run migrations.
 2. Run `backend\venv\Scripts\python.exe backend\scripts\reseed_demo.py`.
-3. Sign in as `teacher` and open the flagship course.
-4. Show the learner mix through the deterministic runtime/intervention story:
-   - `masteredstudent`
-   - `reteachstudent`
-   - `reviewstudent`
-   - `monitorstudent`
-   - `normalstudent`
-5. Sign in as `orgadmin` if you need the staff/admin view of the same flagship environment.
-6. Use `student1` or `student2` for a clean learner-flow walkthrough when you do not want preseeded attempt history.
-
-## Verification Checklist
-
-Use this as a quick operator check after reseeding:
-
-- The command exits successfully.
-- The output references `EchoEd Demo School`.
-- The output lists `orgadmin`, `teacher`, and the five archetype learners.
-- The flagship course remains `Introduction to Africa`.
-- The teacher dashboard can discover the archetype learners without manual enrollment repair.
-- The governance summary route returns all expected sections for the flagship course.
-- Publish readiness and safe publish validation are clean for the flagship course.
-- Runtime intervention recommendations show enrichment, reteach, review, monitor, and normal at the same time.
-- Competency evidence integrity shows the expected ambiguous warning for `monitorstudent` and no blocking issues.
-
-## Final Operator Validation Checklist
-
-Use this when you need a stricter go or no-go check immediately before a live demo.
-
-- Run migrations and rerun `backend\venv\Scripts\python.exe backend\scripts\reseed_demo.py` without manual database cleanup.
-- Confirm the reseed output completes successfully and still names `EchoEd Demo School` and `Introduction to Africa`.
-- Sign in as `normalstudent` and confirm the flagship course starts on a governed lesson with normal continuation guidance.
-- Sign in as `teacher` and confirm the runtime intervention recommendation mix includes:
-  - `Amara Mastery` -> `enrichment`
-  - `Binta Reteach` -> `reteach`
-  - `Chidi Review` -> `review`
-  - `Dayo Monitor` -> `monitor`
-  - `Eshe Steady` -> `normal`
-- Sign in as `teacher` and confirm the educator runtime support view remains stable:
-  - `Amara Mastery` shows `completed` support with `celebrate-and-reflect`
-  - `Binta Reteach` shows `remediation` support with `review-and-continue`
-  - `Chidi Review` shows `remediation` support with `review-and-continue`
-  - `Dayo Monitor` and `Eshe Steady` remain in normal continuation support
-- Sign in as `orgadmin` and confirm `GET /api/courses/{course_id}/governance-summary` returns:
-  - `publish_readiness`
-  - `safe_publish_validation`
-  - `lineage_safety_visibility`
-  - `competency_evidence_integrity`
-  - `runtime_intervention_recommendations`
-- Confirm publish readiness is clean, safe publish validation is clean, and lineage safety remains coherent and safe.
-- Confirm learner access is still denied from the staff governance endpoints.
-- Treat any need for manual row cleanup, manual reenrollment, or manual attempt deletion as a demo-readiness failure.
-
-## Known Acceptable Demo Warnings
-
-One governance warning is intentionally acceptable in the flagship demo:
-
-- Surface: `competency_evidence_integrity`
-- Warning code: `unaligned_assessment_mastery_evidence`
-- Assessment: `Introduction to Africa Ambiguous Evidence Check`
-- Demonstrated by: `monitorstudent` / Dayo Monitor
-- Why it is acceptable:
-  - the course remains valid and safe
-  - the warning is deterministic across reseeds
-  - it demonstrates realistic staff governance ambiguity rather than data corruption
-  - it should appear without any blocking issues
-
-Unexpected warnings for the flagship demo include:
-
-- additional competency evidence integrity warnings
-- any blocking governance issue
-- publish readiness warnings
-- safe publish warnings
-- lineage safety warnings
-
-## Recovery Steps If Reseed Validation Fails
-
-1. Rerun migrations from `backend` with `venv\Scripts\python.exe -m alembic upgrade head`.
-2. Rerun `backend\venv\Scripts\python.exe backend\scripts\reseed_demo.py`.
-3. Confirm the reseed summary still names `EchoEd Demo School`, `Introduction to Africa`, `orgadmin`, `teacher`, and the five archetype learners.
-4. Recheck the flagship student flow with `normalstudent`.
-5. Recheck the teacher runtime recommendation mix and the `orgadmin` governance summary.
-6. If learner access is no longer denied, or if the acceptable ambiguity warning becomes blocking, stop the demo prep and treat the environment as invalid.
-7. If stale auth or session data appears to be masking the expected state, sign out, start a new session, and repeat the validation checks before changing any data manually.
+3. Sign in as `normalstudent` and confirm the active flagship course appears.
+4. Continue into the governed lesson and confirm the lesson view loads.
+5. Return safely to the dashboard.
+6. Sign in as `teacher` and confirm the dashboard loads with stable flagship visibility.
+7. Sign in as `orgadmin` only if you need the staff governance route checks.
+
+## Expected Teacher/Admin Outcomes
+
+After reseeding:
+
+- the teacher dashboard should open without manual enrollment repair
+- the flagship course should remain visible and stable
+- the runtime intervention mix should remain deterministic across the archetype learners
+- learner access should still be denied from staff governance endpoints
+
+## Known Acceptable Demo Warning
+
+One warning remains intentionally acceptable in the flagship demo:
+
+- surface: `competency_evidence_integrity`
+- warning code: `unaligned_assessment_mastery_evidence`
+- assessment: `Introduction to Africa Ambiguous Evidence Check`
+- demonstrated by: `monitorstudent`
+
+This warning is acceptable because it is deterministic, non-blocking, and intentionally demonstrates bounded educator ambiguity rather than corrupted data.
+
+## Troubleshooting Notes
+
+Use these when demo prep fails:
+
+- If a seeded student cannot log in, rerun `backend\venv\Scripts\python.exe backend\scripts\reseed_demo.py` before changing rows manually.
+- If the student smoke stays on `/login`, verify the frontend is pointed at the intended backend and that the reseed completed against the same database the backend is using.
+- If `npm` is blocked by PowerShell execution policy or npm cache issues, use the direct `cmd /c` binary commands shown above.
+- If the dashboard loads but the flagship course is missing, treat that as a failed demo state rather than a cosmetic issue.
+- If the lesson route opens but governed lesson restoration fails, stop and verify backend runtime integrity before changing demo data manually.
+
+## Recovery Steps
+
+1. Reapply migrations.
+2. Rerun the deterministic reseed.
+3. Restart backend and frontend.
+4. Re-run the automated confidence layer.
+5. Recheck the student flagship walkthrough with `normalstudent`.
+6. Recheck the teacher dashboard with `teacher`.
+7. Treat any need for manual row cleanup, reenrollment, or attempt deletion as a demo-readiness failure.
 
 ## Guardrails
 
-- No frontend UI changes are required for demo preparation.
-- No auth bypass is used.
-- No fake scoring is used.
-- No special-case runtime logic is required in the demo path.
-- No workflow expansion is part of this setup path.
+- no auth bypass is used
+- no governed runtime protections are disabled
+- no manual database repair is part of the expected startup path
+- no broader CI or deployment automation changes are required for this runbook
diff --git a/docs/demo-smoke-validation.md b/docs/demo-smoke-validation.md
index 97ca1db..6a60da9 100644
--- a/docs/demo-smoke-validation.md
+++ b/docs/demo-smoke-validation.md
@@ -2,6 +2,11 @@
 
 This runbook covers the bounded browser smoke flow for the seeded EchoEd demo environment. It is intentionally limited to one deterministic student flagship path in Phase 1.
 
+Related runbooks:
+
+- [Demo Readiness Runbook](./demo-readiness.md)
+- [Pilot Verification Checklist](./pilot-verification-checklist.md)
+
 ## Purpose
 
 Use this smoke flow to confirm that the seeded demo environment is usable in a real browser before a live demo. It is not a full end-to-end suite and it does not replace backend or component-level verification.
@@ -12,6 +17,17 @@ Use this smoke flow to confirm that the seeded demo environment is usable in a r
 - Frontend dependencies are installed, including Playwright.
 - The deterministic demo seed has been applied successfully.
 - The frontend app is available at `http://127.0.0.1:4200` unless you override `PLAYWRIGHT_BASE_URL`.
+- The backend API is reachable through the frontend proxy at `http://127.0.0.1:8000`.
+
+## Recommended Preflight
+
+Before running the smoke, confirm these conditions:
+
+- `backend\venv\Scripts\python.exe backend\scripts\reseed_demo.py` completes successfully.
+- The backend is serving authenticated routes without migration errors.
+- The frontend login page loads at `/login`.
+- The demo credentials still work for `normalstudent` / `password`.
+- You are not relying on a stale browser session from a previous run.
 
 ## Prepare the Demo Environment
 
@@ -36,6 +52,8 @@ backend\venv\Scripts\python.exe backend\scripts\reseed_demo.py
 
 Make the API available locally at `http://127.0.0.1:8000`.
 
+If you use the local FastAPI startup flow, start it from `backend` with your normal development command before launching the frontend.
+
 ### 4. Start the frontend
 
 From `frontend`:
@@ -63,6 +81,12 @@ From `frontend`:
 npm run smoke:demo:student
 ```
 
+Windows fallback when `npm` is blocked by PowerShell execution policy or npm cache issues:
+
+```powershell
+cmd /c .\node_modules\.bin\playwright.cmd test tests/demo/student-flagship-smoke.spec.ts
+```
+
 Optional overrides:
 
 ```powershell
@@ -102,29 +126,45 @@ Fail means one of these is broken:
 
 This smoke flow is intentionally bounded. A pass does not imply exhaustive product coverage.
 
-## Current Execution Status
-
-Browser-level execution is environment-blocked in this workspace until Playwright Chromium can be installed successfully. The current blocker is local disk-space exhaustion during `npx playwright install chromium`.
-
 ## Troubleshooting
 
 If browser setup or execution fails:
 
-1. Check free disk space and make sure there is enough room for the Playwright Chromium download.
-2. Clear Angular cache if local build artifacts have accumulated:
+1. If login fails and the browser remains on `/login`, rerun the deterministic reseed:
+
+```powershell
+backend\venv\Scripts\python.exe backend\scripts\reseed_demo.py
+```
+
+2. Check that the frontend is pointing at the intended API and that the backend is actually running.
+3. If `npm run smoke:demo:student` fails under PowerShell because script execution is disabled, run:
+
+```powershell
+cmd /c .\node_modules\.bin\playwright.cmd test tests/demo/student-flagship-smoke.spec.ts
+```
+
+4. Check free disk space and make sure there is enough room for Playwright browser binaries and frontend build artifacts.
+5. Clear Angular cache if local build artifacts have accumulated:
 
 ```powershell
 npx ng cache clean
 ```
 
-3. Retry the browser install from `frontend`:
+6. Retry the browser install from `frontend`:
 
 ```powershell
 npx playwright install chromium
 ```
 
-4. Rerun the smoke:
+7. Rerun the smoke:
 
 ```powershell
 npm run smoke:demo:student
 ```
+
+8. If the smoke still fails after reseed, treat that as a pilot-readiness failure until you can explain whether the issue is:
+
+- auth/login
+- dashboard continuation
+- governed lesson restoration
+- local startup/proxy drift
diff --git a/docs/pilot-verification-checklist.md b/docs/pilot-verification-checklist.md
new file mode 100644
index 0000000..8849fda
--- /dev/null
+++ b/docs/pilot-verification-checklist.md
@@ -0,0 +1,91 @@
+# Pilot Verification Checklist
+
+This checklist is the bounded go/no-go flow for preparing EchoEd for a small pilot walkthrough.
+
+Related runbooks:
+
+- [Demo Readiness Runbook](./demo-readiness.md)
+- [Demo Smoke Validation](./demo-smoke-validation.md)
+
+## Before You Start
+
+- confirm backend dependencies are installed
+- confirm frontend dependencies and Playwright are installed
+- confirm the backend and frontend will run against the intended local environment
+
+## Reset and Startup
+
+1. Apply backend migrations.
+2. Run `backend\venv\Scripts\python.exe backend\scripts\reseed_demo.py`.
+3. Start the backend locally.
+4. Start the frontend locally.
+5. Open `http://127.0.0.1:4200/login` and confirm the login page renders.
+
+## Automated Verification
+
+Run these in order:
+
+```powershell
+cd backend
+pytest -q
+```
+
+```powershell
+cd frontend
+cmd /c .\node_modules\.bin\ng.cmd test --watch=false --browsers=ChromeHeadless
+```
+
+```powershell
+cd frontend
+cmd /c .\node_modules\.bin\playwright.cmd test tests/demo/student-flagship-smoke.spec.ts
+```
+
+Treat any failure here as a pilot-readiness failure until explained.
+
+## Manual Student Checks
+
+- sign in as `normalstudent`
+- confirm the active flagship course card is visible
+- confirm `Continue lesson` enters the governed lesson path
+- confirm the lesson page loads with the governed viewer
+- confirm the student can exit the lesson and return to the dashboard safely
+
+## Manual Teacher Checks
+
+- sign in as `teacher`
+- confirm the dashboard loads without broken or empty shell states
+- confirm the flagship course context is visible enough for a live walkthrough
+- confirm learner/runtime context is visible enough to explain the archetype story
+
+These teacher checks remain intentionally manual in Phase 1.
+
+## Manual Admin/Governance Checks
+
+Only run these if the walkthrough needs governance visibility:
+
+- sign in as `orgadmin`
+- confirm the flagship course remains present
+- confirm staff-only governance reads remain staff-only
+- confirm the environment does not require manual repair to expose the flagship governance story
+
+## Troubleshooting
+
+- If login fails after reseed, rerun the reseed before changing any data manually.
+- If the smoke test stays on `/login`, check that the frontend and backend are pointed at the same local environment.
+- If PowerShell blocks `npm`, use the direct `cmd /c` binary commands.
+- If `npm` fails because of local cache or disk pressure, clear space and rerun the direct commands.
+- If the student dashboard loads but the flagship course is missing, stop and treat the demo environment as invalid.
+
+## What This Checklist Proves
+
+- the deterministic demo can be restored without manual cleanup
+- the backend and frontend regression suites are green
+- the bounded student browser story still works
+- the teacher dashboard is manually demonstrable
+
+## What This Checklist Does Not Prove
+
+- exhaustive teacher browser coverage
+- full end-to-end resilience across every route
+- deployment health outside the local pilot-prep environment
+- broader operational monitoring or production SRE readiness
diff --git a/openspec/changes/pilot-platform-hardening-phase-1/tasks.md b/openspec/changes/pilot-platform-hardening-phase-1/tasks.md
index 2834834..51d5e6e 100644
--- a/openspec/changes/pilot-platform-hardening-phase-1/tasks.md
+++ b/openspec/changes/pilot-platform-hardening-phase-1/tasks.md
@@ -42,9 +42,9 @@
 
 ## 8. Smoke tests / docs
 
-- [ ] 8.1 Review existing demo seed, smoke validation, and pilot-readiness documentation for drift against current student and teacher flows
-- [ ] 8.2 Update bounded smoke and manual verification docs so a pilot operator can prepare the demo environment and validate core student/teacher flows deterministically
-- [ ] 8.3 Verify the existing student Playwright smoke remains green and document any intentionally manual teacher checks
+- [x] 8.1 Review existing demo seed, smoke validation, and pilot-readiness documentation for drift against current student and teacher flows
+- [x] 8.2 Update bounded smoke and manual verification docs so a pilot operator can prepare the demo environment and validate core student/teacher flows deterministically
+- [x] 8.3 Verify the existing student Playwright smoke remains green and document any intentionally manual teacher checks
 
 ## 9. Final validation
 

From e876bf9be6f92b0e6f77ba5814b8294526067f4e Mon Sep 17 00:00:00 2001
From: Anthony Wright <anthony@mrwrite.dev>
Date: Tue, 26 May 2026 17:11:56 -0500
Subject: [PATCH 09/14] chore: complete pilot hardening validation

---
 .../pages/admin/course-wizard/course-wizard.component.ts  | 5 -----
 .../step4-review-save/step4-review-save.component.ts      | 2 --
 .../src/app/pages/registration/registration.component.ts  | 3 ---
 .../changes/pilot-platform-hardening-phase-1/tasks.md     | 8 ++++----
 4 files changed, 4 insertions(+), 14 deletions(-)

diff --git a/frontend/src/app/pages/admin/course-wizard/course-wizard.component.ts b/frontend/src/app/pages/admin/course-wizard/course-wizard.component.ts
index e870ebd..b9131bb 100644
--- a/frontend/src/app/pages/admin/course-wizard/course-wizard.component.ts
+++ b/frontend/src/app/pages/admin/course-wizard/course-wizard.component.ts
@@ -42,7 +42,6 @@ export class CourseWizardComponent implements OnInit {
       this.courseId = params.get('courseId');
   
       if (this.courseId) {
-        console.log('Edit mode. Load course:', this.courseId);
         this.isEditMode = true;
         this.isLoading = true;
 
@@ -58,7 +57,6 @@ export class CourseWizardComponent implements OnInit {
       });
 
       } else {
-        console.log('New course mode.');
         this.courseWizardService.resetDraft(); // Start fresh
         this.isEditMode = false;
         this.isLoading = false;
@@ -86,13 +84,11 @@ export class CourseWizardComponent implements OnInit {
 
   saveDraft() {
     const draft = this.courseWizardService.draftValue;
-    console.log('Saving draft...', draft);
   
     if (this.isEditMode && this.courseId) {
       // PUT update existing course
       this.courseService.updateCourse(this.courseId, draft).subscribe({
         next: () => {
-          console.log('Course updated successfully!');
           this.router.navigate(['/home']); // Redirect back to dashboard
         },
         error: (err) => {
@@ -103,7 +99,6 @@ export class CourseWizardComponent implements OnInit {
       // POST create new course
       this.courseService.createCourse(draft).subscribe({
         next: () => {
-          console.log('Course created successfully!');
           this.router.navigate(['/home']); // Redirect back to dashboard
         },
         error: (err) => {
diff --git a/frontend/src/app/pages/admin/course-wizard/steps/step4-review-save/step4-review-save.component.ts b/frontend/src/app/pages/admin/course-wizard/steps/step4-review-save/step4-review-save.component.ts
index 3b994f6..1697813 100644
--- a/frontend/src/app/pages/admin/course-wizard/steps/step4-review-save/step4-review-save.component.ts
+++ b/frontend/src/app/pages/admin/course-wizard/steps/step4-review-save/step4-review-save.component.ts
@@ -49,7 +49,6 @@ export class Step4ReviewSaveComponent implements OnInit {
       this.coursesService.updateCourse(this.courseId, draft).subscribe({
         next: () => {
           this.isSaving = false;
-          console.log('Course updated successfully!');
           this.toastService.show('Course updated successfully', 'success');
           this.router.navigate(['/home/admin/courses']);
         },
@@ -64,7 +63,6 @@ export class Step4ReviewSaveComponent implements OnInit {
       this.coursesService.createCourse(draft).subscribe({
         next: () => {
           this.isSaving = false;
-          console.log('Course saved successfully!');
           this.toastService.show('Course created successfully', 'success');
           this.courseWizardService.resetDraft();
           this.router.navigate(['/home/admin/courses']);
diff --git a/frontend/src/app/pages/registration/registration.component.ts b/frontend/src/app/pages/registration/registration.component.ts
index 44bb48d..75b3796 100644
--- a/frontend/src/app/pages/registration/registration.component.ts
+++ b/frontend/src/app/pages/registration/registration.component.ts
@@ -59,7 +59,6 @@ export class RegistrationComponent implements OnInit {
 
     this.metaService.getEnums().subscribe({
       next: (enums) => {
-        console.log('Enums response:', enums);
         const allowed = new Set(['student', 'teacher', 'parent', 'instructor']);
         this.roleOptions = (enums.organizationRoles ?? []).filter((r) =>
           allowed.has(r.value),
@@ -127,7 +126,6 @@ export class RegistrationComponent implements OnInit {
 
     this.authService.register(user).subscribe(
       (response) => {
-        console.log('Registration successful');
         const pendingSetup = normalizePendingOrganizationSetup({
           createOrganization: formValue.createOrganization,
           organizationName: formValue.organizationName,
@@ -137,7 +135,6 @@ export class RegistrationComponent implements OnInit {
         this.router.navigate(['/login']);
       },
       (error) => {
-        console.log('Registration failed');
         this.errorMessage =
           error?.error?.detail ||
           'Registration failed. Please check your details and try again.';
diff --git a/openspec/changes/pilot-platform-hardening-phase-1/tasks.md b/openspec/changes/pilot-platform-hardening-phase-1/tasks.md
index 51d5e6e..5392698 100644
--- a/openspec/changes/pilot-platform-hardening-phase-1/tasks.md
+++ b/openspec/changes/pilot-platform-hardening-phase-1/tasks.md
@@ -48,7 +48,7 @@
 
 ## 9. Final validation
 
-- [ ] 9.1 Run the full backend pytest suite and confirm it remains green
-- [ ] 9.2 Run the existing Angular test suite and confirm it remains green
-- [ ] 9.3 Run the existing student Playwright smoke and confirm the pilot-critical student path remains green
-- [ ] 9.4 Confirm no production auth was weakened, demo seed remains deterministic, and new Phase 1 behavior is covered by tests or documented manual verification
+- [x] 9.1 Run the full backend pytest suite and confirm it remains green
+- [x] 9.2 Run the existing Angular test suite and confirm it remains green
+- [x] 9.3 Run the existing student Playwright smoke and confirm the pilot-critical student path remains green
+- [x] 9.4 Confirm no production auth was weakened, demo seed remains deterministic, and new Phase 1 behavior is covered by tests or documented manual verification

From 547a4d87eeaaf7fad8262722c682b9f3971a526d Mon Sep 17 00:00:00 2001
From: Anthony Wright <anthony@mrwrite.dev>
Date: Tue, 26 May 2026 17:13:29 -0500
Subject: [PATCH 10/14] MVP Phase 1 complete

---
 .../.openspec.yaml                            |   2 +
 .../design.md                                 | 133 ++++++++++++++++++
 .../proposal.md                               |  82 +++++++++++
 .../spec.md                                   |  13 ++
 .../specs/canonical-ux-state-system/spec.md   |  21 +++
 .../spec.md                                   |  17 +++
 .../deterministic-demo-foundation/spec.md     |  24 ++++
 .../educator-experience-hardening/spec.md     |  21 +++
 .../governed-progression-integrity/spec.md    |  21 +++
 .../learner-experience-hardening/spec.md      |  22 +++
 .../spec.md                                   |  27 ++++
 .../spec.md                                   |  13 ++
 12 files changed, 396 insertions(+)
 create mode 100644 openspec/changes/pilot-platform-hardening-phase-1/.openspec.yaml
 create mode 100644 openspec/changes/pilot-platform-hardening-phase-1/design.md
 create mode 100644 openspec/changes/pilot-platform-hardening-phase-1/proposal.md
 create mode 100644 openspec/changes/pilot-platform-hardening-phase-1/specs/accessibility-and-global-readiness/spec.md
 create mode 100644 openspec/changes/pilot-platform-hardening-phase-1/specs/canonical-ux-state-system/spec.md
 create mode 100644 openspec/changes/pilot-platform-hardening-phase-1/specs/demo-reset-and-operational-readiness/spec.md
 create mode 100644 openspec/changes/pilot-platform-hardening-phase-1/specs/deterministic-demo-foundation/spec.md
 create mode 100644 openspec/changes/pilot-platform-hardening-phase-1/specs/educator-experience-hardening/spec.md
 create mode 100644 openspec/changes/pilot-platform-hardening-phase-1/specs/governed-progression-integrity/spec.md
 create mode 100644 openspec/changes/pilot-platform-hardening-phase-1/specs/learner-experience-hardening/spec.md
 create mode 100644 openspec/changes/pilot-platform-hardening-phase-1/specs/pilot-operational-confidence-checks/spec.md
 create mode 100644 openspec/changes/pilot-platform-hardening-phase-1/specs/shell-bootstrap-and-navigation-readiness/spec.md

diff --git a/openspec/changes/pilot-platform-hardening-phase-1/.openspec.yaml b/openspec/changes/pilot-platform-hardening-phase-1/.openspec.yaml
new file mode 100644
index 0000000..fd706ac
--- /dev/null
+++ b/openspec/changes/pilot-platform-hardening-phase-1/.openspec.yaml
@@ -0,0 +1,2 @@
+schema: spec-driven
+created: 2026-05-26
diff --git a/openspec/changes/pilot-platform-hardening-phase-1/design.md b/openspec/changes/pilot-platform-hardening-phase-1/design.md
new file mode 100644
index 0000000..dff30cb
--- /dev/null
+++ b/openspec/changes/pilot-platform-hardening-phase-1/design.md
@@ -0,0 +1,133 @@
+## Context
+
+EchoEd already demonstrates the core ingredients needed for a pilot: authenticated role-aware dashboards, governed lesson delivery, student progression, teacher visibility, deterministic demo seed data, backend regression coverage, and a bounded Playwright smoke path. The current weakness is not missing platform concepts; it is uneven operational confidence in the seams between them.
+
+The sampled codebase reflects that shape clearly:
+
+- the student dashboard already has continuation cards and canonical state components, but its pilot trust depends on stable async behavior and safe lesson transitions
+- the teacher dashboard already exposes meaningful governance and runtime surfaces, but it is dense and vulnerable to low-confidence loading, empty, and responsive states
+- the lesson runtime already exposes governed blocked/error handling, but return-to-dashboard and recovery flows must stay deterministic
+- the shared shell/header/sidebar remain critical because every pilot role experiences them first
+- the backend runtime and progression layer must keep governed safety intact while still preserving ordinary sequential progression
+- demo readiness currently depends on deterministic seed behavior plus operator docs and bounded smoke checks
+
+This phase is therefore a cross-cutting hardening pass, not a feature program.
+
+## Goals / Non-Goals
+
+**Goals:**
+
+- Make student and teacher first-run authenticated experiences feel stable enough for real pilot walkthroughs
+- Preserve deterministic lesson continuation, governed blocked handling, and safe lesson exit/return behavior
+- Eliminate obvious loading, error, empty-state, and readability defects in pilot-critical flows
+- Keep governed progression and runtime behavior safe while locking in regression coverage
+- Strengthen demo/operator confidence through deterministic seed behavior, bounded smoke checks, and clearer runbooks
+- Increase confidence in CI without redesigning the whole workflow
+
+**Non-Goals:**
+
+- New product workflows, new reporting systems, or new learning features
+- Replacing the current shell, auth, organization, or governance architecture
+- Broad visual redesign or design-language replacement
+- Full observability platform adoption or production incident tooling
+- End-to-end automation of every pilot scenario
+
+## Decisions
+
+### Frontend hardening strategy
+
+Pilot hardening will stay inside the existing Angular shell, dashboard, and lesson-view structure. The implementation should avoid introducing parallel layout or routing systems. Instead, Phase 1 should:
+
+- audit the shared shell, header, and sidebar for unstable first paint, layout shift, hidden controls, and weak route transitions
+- normalize student and teacher dashboard data-fetch entry states around the existing canonical loading and state-panel components
+- preserve the current student "active course -> continue lesson -> lesson route -> return to dashboard" path as the primary pilot learner story
+- preserve the current teacher dashboard as a bounded read-mostly pilot surface, emphasizing stable visibility and recovery over broader feature expansion
+
+Alternative rejected: a broader dashboard redesign. That would increase polish in some places, but it would not improve pilot confidence as efficiently as stabilizing the existing surfaces.
+
+### Backend and runtime hardening strategy
+
+Backend hardening will focus on verification and small correctness fixes in progression/runtime behavior, not new service families. The governing rule is:
+
+- governed learner delivery must never auto-activate stale draft or non-governed progress rows
+- ordinary non-governed progression must still advance to the next `NOT_STARTED` segment as expected
+
+Phase 1 should favor targeted reinforcement of existing progression helpers, governed filtering decisions, and regression tests around runtime endpoints instead of larger refactors.
+
+Alternative rejected: central progress-model redesign. That would be too large for a pilot hardening phase and would risk destabilizing already-green behavior.
+
+### Accessibility and contrast approach
+
+This phase will apply a baseline accessibility pass only to pilot-critical surfaces:
+
+- authenticated shell
+- student dashboard
+- teacher dashboard
+- lesson runtime
+- shared loading/error/empty-state surfaces
+
+The pass should cover contrast, readable hierarchy, keyboard order, actionable labels, focus visibility, and state announcements where async transitions change the meaning of the page. This is intentionally narrower than a platform-wide accessibility remediation program.
+
+Alternative rejected: page-by-page full WCAG certification effort. That is appropriate later, but not necessary to achieve Phase 1 pilot readiness.
+
+### Error, loading, and empty-state approach
+
+The platform already has canonical state components. Phase 1 should standardize when and how they are used:
+
+- loading states should explain what is being prepared and avoid leaving stale content ambiguously visible
+- error states should explain the failed surface in user language and offer retry or return actions where valid
+- empty states should distinguish "no data yet" from blocked or failed outcomes
+- governed blocked states should stay semantically distinct from generic failures
+
+Alternative rejected: route-local custom placeholders. They make short-term implementation easy, but they fragment the runtime experience and reduce pilot trust.
+
+### Observability and logging approach
+
+Phase 1 will not add a new telemetry stack. It will add bounded operational confidence instead:
+
+- keep backend assertions and regression tests authoritative for progression and seed determinism
+- use existing API error responses and route behavior as the main reliability signal
+- document operator-visible failure points in demo and smoke runbooks
+- where lightweight logging is needed, prefer structured application logs around seed, bootstrap, and governed runtime failure paths over noisy debug output
+
+Alternative rejected: adding a full observability vendor during a hardening pass. That expands operational surface area without directly improving the pilot experience.
+
+### Smoke-test and CI confidence approach
+
+CI confidence should remain bounded and legible:
+
+- backend pytest remains the main authority for runtime and seed correctness
+- existing Angular tests remain the main authority for component-level regression coverage
+- the existing student Playwright smoke remains the browser-level pilot-confidence check
+- docs should define a manual student and teacher pilot walkthrough when automation is intentionally absent
+- CI should stay simple: keep the current backend and frontend jobs green, and document any smoke execution expectations separately unless CI expansion is explicitly justified
+
+Alternative rejected: turning this phase into a large CI redesign. The immediate need is confidence, not pipeline complexity.
+
+## Risks / Trade-offs
+
+- Cross-cutting polish changes can create hidden regressions in adjacent routes
+  - Mitigation: bias toward existing shared state components, existing test suites, and bounded route changes
+- Teacher dashboard hardening can drift into feature expansion because the surface is already broad
+  - Mitigation: treat the teacher dashboard as a baseline pilot narrative surface, not a new educator product initiative
+- Accessibility fixes can expose component-level inconsistencies across the shell and dashboard stack
+  - Mitigation: focus on high-signal defects first: contrast, focus order, labels, and keyboard-safe actions
+- Smoke confidence can be overstated if docs and automation diverge
+  - Mitigation: keep the smoke path intentionally narrow and document exactly what it does and does not prove
+
+## Migration Plan
+
+No production data migration is expected for this phase. Rollout is code-first and validation-first:
+
+1. land backend/runtime safety fixes and regression tests
+2. harden shell, student, teacher, and lesson surfaces behind existing routes
+3. refresh demo/operator docs and bounded smoke expectations
+4. verify backend pytest, Angular tests, and the current student smoke path
+
+Rollback remains straightforward because this phase should not introduce new persistence models or alternate auth/governance paths.
+
+## Open Questions
+
+- Should the existing student smoke be expanded to assert safe return from lesson to dashboard in Phase 1, or is documented manual verification sufficient for that last step?
+- Is there already a preferred lightweight structured logging pattern in backend runtime routes that this phase should reuse for governed/unavailable outcomes?
+- Should the current CI workflow stay limited to backend pytest and Angular tests for now, with Playwright remaining operator-invoked, or is there appetite to promote the student smoke into CI in a later hardening phase?
diff --git a/openspec/changes/pilot-platform-hardening-phase-1/proposal.md b/openspec/changes/pilot-platform-hardening-phase-1/proposal.md
new file mode 100644
index 0000000..3e74ee8
--- /dev/null
+++ b/openspec/changes/pilot-platform-hardening-phase-1/proposal.md
@@ -0,0 +1,82 @@
+## Why
+
+EchoEd is past the point where functional MVP behavior is enough. The current platform can already demonstrate governed learning, student progression, and teacher visibility, but small real-world pilot usage will expose instability in shell bootstrap, dashboard state rendering, lesson continuation, runtime edge cases, and demo/operator confidence if those seams are not hardened now.
+
+This phase matters because pilot trust is won or lost through the first few visible interactions: logging in, seeing the right dashboard state, entering a lesson, recovering from transient failures, and reseeding a deterministic demo without hidden repair work. Phase 1 focuses on those reliability and polish gaps before larger feature investments.
+
+## What Changes
+
+- Harden the authenticated shell so header, sidebar, dashboard entry, and lesson return paths render from resolved role and organization state without visible instability
+- Improve the student dashboard and lesson runtime experience so the active course path, continuation entry, governed blocked states, and return-to-dashboard flow remain readable and safe
+- Improve the teacher dashboard baseline so pilot demos consistently show enough course, learner, and runtime state to narrate platform value without dead panels or ambiguous empty states
+- Standardize user-friendly loading, error, blocked, and empty states across the student dashboard, teacher dashboard, lesson runtime, and shell-adjacent flows
+- Fix obvious accessibility defects in pilot-critical flows, especially contrast, focus order, labels, and keyboard-safe navigation through shell and lesson actions
+- Verify backend progression and runtime routes continue to enforce governed delivery correctly while preserving ordinary non-governed sequential advancement behavior
+- Keep demo seeding deterministic and strengthen demo/smoke operational documentation so pilot prep is reproducible
+- Tighten basic operational confidence checks across backend pytest, frontend Angular tests, student Playwright smoke coverage, and CI workflow expectations
+
+## User-Visible Problems Addressed
+
+- Student login can reach a dashboard or lesson flow that feels visually unstable or underexplained while async data resolves
+- Teacher login can surface sparse, inconsistent, or low-confidence dashboard sections during a live walkthrough
+- Lesson entry and exit can feel fragile if governed, unavailable, or retry states are not clearly communicated
+- Shared shell/header/sidebar behavior can show avoidable layout shifts, incomplete loading states, or ambiguous role-aware navigation
+- Core surfaces can still expose contrast, readability, or empty-state defects that reduce pilot confidence even when underlying data is correct
+- Demo preparation can drift if seeded users, seeded relationships, smoke steps, or validation docs are not deterministic
+
+## Out of Scope
+
+- New major product features, new pedagogical workflows, or broad information architecture changes
+- Replacing the current authentication, organization, or governance architecture
+- Large redesign work across all pages, visual rebranding, or full design-system replacement
+- New analytics, telemetry vendors, or production observability platforms
+- Expanded multi-role end-to-end smoke coverage beyond bounded pilot-confidence checks unless already necessary for Phase 1 acceptance
+
+## Risks and Mitigations
+
+- Broad "polish" work can sprawl into redesign: mitigate by limiting work to pilot-critical student, teacher, shell, and lesson-runtime flows
+- UI hardening can hide backend inconsistencies instead of exposing them: mitigate by pairing frontend fixes with backend/runtime verification and existing test coverage
+- Demo-confidence work can accidentally weaken production guardrails: mitigate by preserving real auth, real governed progression, and deterministic seeding through production logic only
+- CI additions can become noisy and expensive: mitigate by keeping checks bounded to existing backend pytest, Angular tests, and the current student smoke path
+
+## Verification Strategy
+
+- Keep `backend` pytest green, including progression/runtime and demo-seed coverage
+- Keep existing Angular component/unit tests green for shell, student dashboard, teacher dashboard, and lesson runtime surfaces
+- Keep the existing student Playwright smoke flow green for login, active-course discovery, lesson entry, and safe lesson exit/return expectations
+- Document bounded manual pilot verification for student and teacher core flows where automation does not yet exist
+- Confirm no production auth behavior is weakened and demo seed remains deterministic across repeat runs
+
+## Capabilities
+
+### New Capabilities
+- `pilot-operational-confidence-checks`: bounded pilot-readiness validation across smoke checks, CI expectations, and operator verification steps
+
+### Modified Capabilities
+- `shell-bootstrap-and-navigation-readiness`: stabilize role-aware shell, header, sidebar, and dashboard entry/return behavior during authenticated bootstrap
+- `learner-experience-hardening`: strengthen student dashboard continuation, lesson entry, governed blocked handling, and safe return behavior
+- `educator-experience-hardening`: strengthen teacher dashboard baseline visibility, responsive layout, and recovery states for pilot demonstrations
+- `canonical-ux-state-system`: require consistent loading, error, blocked, and empty-state rendering across pilot-critical flows
+- `accessibility-and-global-readiness`: tighten contrast, focus, keyboard, and readable-state expectations in core student/teacher flows
+- `governed-progression-integrity`: preserve governed progression safety while preventing stale draft activation and keeping ordinary non-governed advancement intact
+- `deterministic-demo-foundation`: guarantee demo users and seeded relationships reset deterministically without duplicate rows
+- `demo-reset-and-operational-readiness`: tighten demo prep, smoke-validation, and manual verification runbooks for pilot operators
+
+## Impact
+
+- Frontend:
+  - `frontend/src/app/pages/user-dashboard/**`
+  - `frontend/src/app/pages/lesson-view.component.*`
+  - `frontend/src/app/shared/lesson-viewer.component.*`
+  - `frontend/src/app/components/echo-header/**`
+  - `frontend/src/app/components/echo-sidebar/**`
+  - shared loading/error/empty-state components and styles
+- Backend:
+  - progression/runtime route coverage and related service logic
+  - demo seed determinism and operator validation expectations
+- Testing and operations:
+  - existing backend pytest suite
+  - existing Angular tests
+  - existing Playwright student smoke flow
+  - CI workflow expectations
+  - demo readiness and smoke validation documentation
diff --git a/openspec/changes/pilot-platform-hardening-phase-1/specs/accessibility-and-global-readiness/spec.md b/openspec/changes/pilot-platform-hardening-phase-1/specs/accessibility-and-global-readiness/spec.md
new file mode 100644
index 0000000..0104bc1
--- /dev/null
+++ b/openspec/changes/pilot-platform-hardening-phase-1/specs/accessibility-and-global-readiness/spec.md
@@ -0,0 +1,13 @@
+## ADDED Requirements
+
+### Requirement: Pilot-critical surfaces preserve baseline contrast and focus visibility
+
+The platform SHALL maintain readable contrast and visible focus treatment across the shared shell, student dashboard, teacher dashboard, and lesson runtime.
+
+#### Scenario: User navigates a pilot-critical flow by keyboard
+- **WHEN** a student or teacher moves through shell or lesson actions without a pointer
+- **THEN** focus remains visible and the next interactive target is understandable
+
+#### Scenario: User reads core dashboard and lesson content
+- **WHEN** student or teacher core-flow text is rendered in the pilot experience
+- **THEN** headings, body text, status labels, and primary actions remain readable without low-contrast ambiguity
diff --git a/openspec/changes/pilot-platform-hardening-phase-1/specs/canonical-ux-state-system/spec.md b/openspec/changes/pilot-platform-hardening-phase-1/specs/canonical-ux-state-system/spec.md
new file mode 100644
index 0000000..eb7cc38
--- /dev/null
+++ b/openspec/changes/pilot-platform-hardening-phase-1/specs/canonical-ux-state-system/spec.md
@@ -0,0 +1,21 @@
+## ADDED Requirements
+
+### Requirement: Pilot-critical authenticated flows use canonical state messaging
+
+The platform SHALL use user-friendly canonical state messaging across shell entry, student dashboard, teacher dashboard, and lesson runtime flows.
+
+#### Scenario: Authenticated content is still loading
+- **WHEN** a pilot-critical student or teacher surface is waiting for authoritative data
+- **THEN** the visible loading state explains what is being prepared and avoids leaving stale content as the apparent current state
+
+#### Scenario: Authenticated content resolves with no data
+- **WHEN** a pilot-critical surface legitimately has no relevant data yet
+- **THEN** the platform renders an intentional empty state that is distinct from blocked or failed behavior
+
+### Requirement: Governed blocked and generic failure states remain distinct in pilot flows
+
+The platform SHALL keep governed blocked outcomes distinct from generic runtime failures in learner-facing lesson delivery.
+
+#### Scenario: Governed lesson cannot continue
+- **WHEN** the lesson runtime resolves a governed blocked or unavailable outcome
+- **THEN** the learner sees governed-specific guidance rather than a generic technical error state
diff --git a/openspec/changes/pilot-platform-hardening-phase-1/specs/demo-reset-and-operational-readiness/spec.md b/openspec/changes/pilot-platform-hardening-phase-1/specs/demo-reset-and-operational-readiness/spec.md
new file mode 100644
index 0000000..5064ee6
--- /dev/null
+++ b/openspec/changes/pilot-platform-hardening-phase-1/specs/demo-reset-and-operational-readiness/spec.md
@@ -0,0 +1,17 @@
+## ADDED Requirements
+
+### Requirement: Demo preparation documents bounded pilot verification
+
+The system SHALL provide a documented, bounded verification path for preparing and checking the pilot demo environment after a reset or reseed.
+
+#### Scenario: Operator prepares the pilot demo
+- **WHEN** a demo operator follows the documented reset and validation steps
+- **THEN** the operator can reseed the environment, verify the canonical student path, and confirm the bounded teacher walkthrough expectations without undocumented repair work
+
+### Requirement: Demo runbooks stay aligned with real platform behavior
+
+The system SHALL keep demo reset, smoke validation, and manual verification docs aligned with the current authenticated student and teacher experience.
+
+#### Scenario: Platform behavior changes in a pilot-critical flow
+- **WHEN** dashboard, lesson runtime, seed, or smoke behavior changes in a way that affects the pilot walkthrough
+- **THEN** the corresponding demo runbooks are updated so operators do not follow stale instructions
diff --git a/openspec/changes/pilot-platform-hardening-phase-1/specs/deterministic-demo-foundation/spec.md b/openspec/changes/pilot-platform-hardening-phase-1/specs/deterministic-demo-foundation/spec.md
new file mode 100644
index 0000000..cbdaa23
--- /dev/null
+++ b/openspec/changes/pilot-platform-hardening-phase-1/specs/deterministic-demo-foundation/spec.md
@@ -0,0 +1,24 @@
+## MODIFIED Requirements
+
+### Requirement: Deterministic reseed behavior
+
+The system SHALL support deterministic reseed behavior for demo-scoped entities, including canonical demo users whose identity and credentials must reset to known defaults on repeat runs.
+
+#### Scenario: Demo seed is rerun
+
+- **WHEN** the demo seed runs more than once
+- **THEN** canonical demo entities are recreated or refreshed into the same bounded state
+- **AND** duplicate demo organizations, users, or flagship course copies are not left behind
+- **AND** demo credentials and role memberships remain valid
+
+#### Scenario: Existing demo user rows already exist
+
+- **WHEN** the demo seed encounters an existing canonical demo user
+- **THEN** it matches that user by username first and then by email if needed
+- **AND** it resets the canonical firstname, lastname, username, email, role, and password fields to the demo defaults
+
+#### Scenario: Duplicate demo user rows exist
+
+- **WHEN** duplicate rows exist for canonical demo usernames or emails
+- **THEN** the seed removes stale duplicates before upserting the final canonical demo users
+- **AND** the resulting seeded state contains one surviving row per intended demo profile
diff --git a/openspec/changes/pilot-platform-hardening-phase-1/specs/educator-experience-hardening/spec.md b/openspec/changes/pilot-platform-hardening-phase-1/specs/educator-experience-hardening/spec.md
new file mode 100644
index 0000000..24dc55b
--- /dev/null
+++ b/openspec/changes/pilot-platform-hardening-phase-1/specs/educator-experience-hardening/spec.md
@@ -0,0 +1,21 @@
+## ADDED Requirements
+
+### Requirement: Teacher dashboard exposes stable pilot-baseline visibility
+
+The platform SHALL provide a stable teacher dashboard baseline that exposes enough course, learner-progress, and runtime-support state for a pilot walkthrough even when some educator datasets are empty.
+
+#### Scenario: Teacher opens the dashboard with available course context
+- **WHEN** an educator reaches the teacher dashboard in a pilot environment
+- **THEN** the dashboard exposes a readable course-management and learner-visibility baseline that supports live narration of platform value
+
+#### Scenario: Teacher opens the dashboard with sparse data
+- **WHEN** one or more educator sections resolve with no data yet
+- **THEN** the dashboard shows intentional empty states rather than collapsed, broken, or misleading panels
+
+### Requirement: Teacher dashboard recovery states remain usable
+
+The platform SHALL provide actionable loading and retry behavior for teacher-facing dashboard sections that depend on asynchronous operational data.
+
+#### Scenario: Educator section fails to load
+- **WHEN** a teacher dashboard section cannot load its operational data
+- **THEN** the educator sees a clear section-level recovery state with bounded retry behavior instead of losing the whole dashboard context
diff --git a/openspec/changes/pilot-platform-hardening-phase-1/specs/governed-progression-integrity/spec.md b/openspec/changes/pilot-platform-hardening-phase-1/specs/governed-progression-integrity/spec.md
new file mode 100644
index 0000000..3164f3b
--- /dev/null
+++ b/openspec/changes/pilot-platform-hardening-phase-1/specs/governed-progression-integrity/spec.md
@@ -0,0 +1,21 @@
+## MODIFIED Requirements
+
+### Requirement: Governed lesson selection drives learner progression deterministically
+The system SHALL use governed learner-visible lessons as the source of truth for governed segment advancement, unit completion, and course continuation, and SHALL preserve ordinary sequential advancement for non-governed lesson paths.
+
+#### Scenario: Learner completes a governed segment
+- **WHEN** a learner completes a segment in an approved-ready lesson path
+- **THEN** the next segment is resolved from the governed learner-visible lesson sequence
+
+#### Scenario: Governed unit contains stale draft or non-governed progress rows
+- **WHEN** governed learner progression is evaluated for a unit that also contains stale draft or otherwise non-governed segment-progress rows
+- **THEN** the system does not auto-activate those stale rows
+- **AND** governed continuation is resolved only from the current governed learner-visible lesson sequence
+
+#### Scenario: No governed next lesson exists
+- **WHEN** the learner reaches a point where no approved-ready governed next lesson exists
+- **THEN** the system does not advance into draft or unapproved content and instead returns an explicit governed unavailable outcome
+
+#### Scenario: Non-governed unit progresses normally
+- **WHEN** learner progression is evaluated for an ordinary non-governed unit with a remaining `NOT_STARTED` segment
+- **THEN** the system auto-activates the next sequential segment rather than blocking advancement under governed-only rules
diff --git a/openspec/changes/pilot-platform-hardening-phase-1/specs/learner-experience-hardening/spec.md b/openspec/changes/pilot-platform-hardening-phase-1/specs/learner-experience-hardening/spec.md
new file mode 100644
index 0000000..7abe9b2
--- /dev/null
+++ b/openspec/changes/pilot-platform-hardening-phase-1/specs/learner-experience-hardening/spec.md
@@ -0,0 +1,22 @@
+## ADDED Requirements
+
+### Requirement: Learner dashboard continuation remains pilot-safe
+
+The platform SHALL present a stable learner dashboard continuation path that helps the student understand the active course, next lesson step, and recovery options when data is unavailable.
+
+#### Scenario: Student lands on the dashboard with an active course
+- **WHEN** a learner logs in and has an active governed course path
+- **THEN** the dashboard shows the active course and continuation action in a readable, user-friendly way
+- **AND** the continuation path does not depend on stale route-local assumptions
+
+#### Scenario: Learner dashboard data cannot be restored
+- **WHEN** the student dashboard cannot load continuation data
+- **THEN** the learner sees a clear recovery state with retry or alternate navigation instead of a blank or misleading card
+
+### Requirement: Lesson entry and return preserve learner continuity
+
+The platform SHALL let a learner enter the current lesson path and return safely to the dashboard without losing orientation about where to continue next.
+
+#### Scenario: Student enters and exits a lesson
+- **WHEN** a learner continues into a lesson and later chooses to return to the dashboard
+- **THEN** the platform preserves a coherent continuation path and does not strand the learner in an ambiguous intermediate state
diff --git a/openspec/changes/pilot-platform-hardening-phase-1/specs/pilot-operational-confidence-checks/spec.md b/openspec/changes/pilot-platform-hardening-phase-1/specs/pilot-operational-confidence-checks/spec.md
new file mode 100644
index 0000000..b7ed28c
--- /dev/null
+++ b/openspec/changes/pilot-platform-hardening-phase-1/specs/pilot-operational-confidence-checks/spec.md
@@ -0,0 +1,27 @@
+## ADDED Requirements
+
+### Requirement: Bounded pilot operational confidence checks
+
+The system SHALL provide a bounded readiness verification layer for pilot-critical EchoEd flows without expanding into a full end-to-end platform test suite.
+
+#### Scenario: Operator validates pilot readiness
+- **WHEN** a pilot operator runs the documented validation flow
+- **THEN** the flow confirms the student login, active-course discovery, lesson entry, and safe return expectations
+- **AND** it confirms the teacher can reach a stable dashboard state with enough course and learner visibility for a pilot walkthrough
+
+### Requirement: Pilot confidence checks remain aligned with existing regression authorities
+
+The system SHALL treat backend pytest, frontend Angular tests, and the existing student browser smoke as the authoritative automated confidence layers for Phase 1.
+
+#### Scenario: Phase 1 validation is reviewed
+- **WHEN** the pilot hardening verification strategy is inspected
+- **THEN** it includes the existing backend test suite, existing Angular tests, and the bounded student smoke path
+- **AND** it does not depend on weakened auth, mocked runtime shortcuts, or undocumented manual database repair
+
+### Requirement: Confidence documentation states its boundaries
+
+The system SHALL document what the pilot-confidence flow proves and what remains intentionally manual or out of scope.
+
+#### Scenario: Operator reads the validation runbook
+- **WHEN** a pilot operator prepares EchoEd for a walkthrough
+- **THEN** the documentation explains which checks are automated, which teacher validations remain manual, and which broader resilience concerns are not covered by Phase 1
diff --git a/openspec/changes/pilot-platform-hardening-phase-1/specs/shell-bootstrap-and-navigation-readiness/spec.md b/openspec/changes/pilot-platform-hardening-phase-1/specs/shell-bootstrap-and-navigation-readiness/spec.md
new file mode 100644
index 0000000..9a4d3ce
--- /dev/null
+++ b/openspec/changes/pilot-platform-hardening-phase-1/specs/shell-bootstrap-and-navigation-readiness/spec.md
@@ -0,0 +1,13 @@
+## ADDED Requirements
+
+### Requirement: Pilot-critical shell entry and return paths remain visually stable
+
+The platform SHALL keep the authenticated shell, header, sidebar, and primary content region stable across dashboard entry, role-aware navigation, and return-from-lesson transitions.
+
+#### Scenario: Student returns from a lesson
+- **WHEN** a student exits a lesson back to the dashboard
+- **THEN** the dashboard re-enters through the resolved authenticated shell without broken navigation, contradictory role cues, or displaced primary content
+
+#### Scenario: Teacher reaches the dashboard after login
+- **WHEN** a teacher completes authenticated bootstrap
+- **THEN** the header, sidebar, and dashboard layout render from resolved role and organization context without flashing stale navigation or partial shell states

From b8c68e817dcc4e6a62beac4764e45c030ab568b7 Mon Sep 17 00:00:00 2001
From: Anthony Wright <anthony@mrwrite.dev>
Date: Tue, 26 May 2026 17:18:48 -0500
Subject: [PATCH 11/14] docs: archive pilot platform hardening phase 1

---
 .../.openspec.yaml                            |  0
 .../design.md                                 |  0
 .../proposal.md                               |  0
 .../spec.md                                   |  0
 .../specs/canonical-ux-state-system/spec.md   |  0
 .../spec.md                                   |  0
 .../deterministic-demo-foundation/spec.md     |  0
 .../educator-experience-hardening/spec.md     |  0
 .../governed-progression-integrity/spec.md    |  0
 .../learner-experience-hardening/spec.md      |  0
 .../spec.md                                   |  0
 .../spec.md                                   |  0
 .../tasks.md                                  |  0
 .../spec.md                                   | 12 +++++++
 .../specs/canonical-ux-state-system/spec.md   | 20 ++++++++++++
 .../spec.md                                   | 16 ++++++++++
 .../deterministic-demo-foundation/spec.md     | 14 ++++++++-
 .../educator-experience-hardening/spec.md     | 20 ++++++++++++
 .../governed-progression-integrity/spec.md    | 11 ++++++-
 .../learner-experience-hardening/spec.md      | 21 +++++++++++++
 .../spec.md                                   | 31 +++++++++++++++++++
 .../spec.md                                   | 12 +++++++
 22 files changed, 155 insertions(+), 2 deletions(-)
 rename openspec/changes/{pilot-platform-hardening-phase-1 => archive/2026-05-26-pilot-platform-hardening-phase-1}/.openspec.yaml (100%)
 rename openspec/changes/{pilot-platform-hardening-phase-1 => archive/2026-05-26-pilot-platform-hardening-phase-1}/design.md (100%)
 rename openspec/changes/{pilot-platform-hardening-phase-1 => archive/2026-05-26-pilot-platform-hardening-phase-1}/proposal.md (100%)
 rename openspec/changes/{pilot-platform-hardening-phase-1 => archive/2026-05-26-pilot-platform-hardening-phase-1}/specs/accessibility-and-global-readiness/spec.md (100%)
 rename openspec/changes/{pilot-platform-hardening-phase-1 => archive/2026-05-26-pilot-platform-hardening-phase-1}/specs/canonical-ux-state-system/spec.md (100%)
 rename openspec/changes/{pilot-platform-hardening-phase-1 => archive/2026-05-26-pilot-platform-hardening-phase-1}/specs/demo-reset-and-operational-readiness/spec.md (100%)
 rename openspec/changes/{pilot-platform-hardening-phase-1 => archive/2026-05-26-pilot-platform-hardening-phase-1}/specs/deterministic-demo-foundation/spec.md (100%)
 rename openspec/changes/{pilot-platform-hardening-phase-1 => archive/2026-05-26-pilot-platform-hardening-phase-1}/specs/educator-experience-hardening/spec.md (100%)
 rename openspec/changes/{pilot-platform-hardening-phase-1 => archive/2026-05-26-pilot-platform-hardening-phase-1}/specs/governed-progression-integrity/spec.md (100%)
 rename openspec/changes/{pilot-platform-hardening-phase-1 => archive/2026-05-26-pilot-platform-hardening-phase-1}/specs/learner-experience-hardening/spec.md (100%)
 rename openspec/changes/{pilot-platform-hardening-phase-1 => archive/2026-05-26-pilot-platform-hardening-phase-1}/specs/pilot-operational-confidence-checks/spec.md (100%)
 rename openspec/changes/{pilot-platform-hardening-phase-1 => archive/2026-05-26-pilot-platform-hardening-phase-1}/specs/shell-bootstrap-and-navigation-readiness/spec.md (100%)
 rename openspec/changes/{pilot-platform-hardening-phase-1 => archive/2026-05-26-pilot-platform-hardening-phase-1}/tasks.md (100%)
 create mode 100644 openspec/specs/pilot-operational-confidence-checks/spec.md

diff --git a/openspec/changes/pilot-platform-hardening-phase-1/.openspec.yaml b/openspec/changes/archive/2026-05-26-pilot-platform-hardening-phase-1/.openspec.yaml
similarity index 100%
rename from openspec/changes/pilot-platform-hardening-phase-1/.openspec.yaml
rename to openspec/changes/archive/2026-05-26-pilot-platform-hardening-phase-1/.openspec.yaml
diff --git a/openspec/changes/pilot-platform-hardening-phase-1/design.md b/openspec/changes/archive/2026-05-26-pilot-platform-hardening-phase-1/design.md
similarity index 100%
rename from openspec/changes/pilot-platform-hardening-phase-1/design.md
rename to openspec/changes/archive/2026-05-26-pilot-platform-hardening-phase-1/design.md
diff --git a/openspec/changes/pilot-platform-hardening-phase-1/proposal.md b/openspec/changes/archive/2026-05-26-pilot-platform-hardening-phase-1/proposal.md
similarity index 100%
rename from openspec/changes/pilot-platform-hardening-phase-1/proposal.md
rename to openspec/changes/archive/2026-05-26-pilot-platform-hardening-phase-1/proposal.md
diff --git a/openspec/changes/pilot-platform-hardening-phase-1/specs/accessibility-and-global-readiness/spec.md b/openspec/changes/archive/2026-05-26-pilot-platform-hardening-phase-1/specs/accessibility-and-global-readiness/spec.md
similarity index 100%
rename from openspec/changes/pilot-platform-hardening-phase-1/specs/accessibility-and-global-readiness/spec.md
rename to openspec/changes/archive/2026-05-26-pilot-platform-hardening-phase-1/specs/accessibility-and-global-readiness/spec.md
diff --git a/openspec/changes/pilot-platform-hardening-phase-1/specs/canonical-ux-state-system/spec.md b/openspec/changes/archive/2026-05-26-pilot-platform-hardening-phase-1/specs/canonical-ux-state-system/spec.md
similarity index 100%
rename from openspec/changes/pilot-platform-hardening-phase-1/specs/canonical-ux-state-system/spec.md
rename to openspec/changes/archive/2026-05-26-pilot-platform-hardening-phase-1/specs/canonical-ux-state-system/spec.md
diff --git a/openspec/changes/pilot-platform-hardening-phase-1/specs/demo-reset-and-operational-readiness/spec.md b/openspec/changes/archive/2026-05-26-pilot-platform-hardening-phase-1/specs/demo-reset-and-operational-readiness/spec.md
similarity index 100%
rename from openspec/changes/pilot-platform-hardening-phase-1/specs/demo-reset-and-operational-readiness/spec.md
rename to openspec/changes/archive/2026-05-26-pilot-platform-hardening-phase-1/specs/demo-reset-and-operational-readiness/spec.md
diff --git a/openspec/changes/pilot-platform-hardening-phase-1/specs/deterministic-demo-foundation/spec.md b/openspec/changes/archive/2026-05-26-pilot-platform-hardening-phase-1/specs/deterministic-demo-foundation/spec.md
similarity index 100%
rename from openspec/changes/pilot-platform-hardening-phase-1/specs/deterministic-demo-foundation/spec.md
rename to openspec/changes/archive/2026-05-26-pilot-platform-hardening-phase-1/specs/deterministic-demo-foundation/spec.md
diff --git a/openspec/changes/pilot-platform-hardening-phase-1/specs/educator-experience-hardening/spec.md b/openspec/changes/archive/2026-05-26-pilot-platform-hardening-phase-1/specs/educator-experience-hardening/spec.md
similarity index 100%
rename from openspec/changes/pilot-platform-hardening-phase-1/specs/educator-experience-hardening/spec.md
rename to openspec/changes/archive/2026-05-26-pilot-platform-hardening-phase-1/specs/educator-experience-hardening/spec.md
diff --git a/openspec/changes/pilot-platform-hardening-phase-1/specs/governed-progression-integrity/spec.md b/openspec/changes/archive/2026-05-26-pilot-platform-hardening-phase-1/specs/governed-progression-integrity/spec.md
similarity index 100%
rename from openspec/changes/pilot-platform-hardening-phase-1/specs/governed-progression-integrity/spec.md
rename to openspec/changes/archive/2026-05-26-pilot-platform-hardening-phase-1/specs/governed-progression-integrity/spec.md
diff --git a/openspec/changes/pilot-platform-hardening-phase-1/specs/learner-experience-hardening/spec.md b/openspec/changes/archive/2026-05-26-pilot-platform-hardening-phase-1/specs/learner-experience-hardening/spec.md
similarity index 100%
rename from openspec/changes/pilot-platform-hardening-phase-1/specs/learner-experience-hardening/spec.md
rename to openspec/changes/archive/2026-05-26-pilot-platform-hardening-phase-1/specs/learner-experience-hardening/spec.md
diff --git a/openspec/changes/pilot-platform-hardening-phase-1/specs/pilot-operational-confidence-checks/spec.md b/openspec/changes/archive/2026-05-26-pilot-platform-hardening-phase-1/specs/pilot-operational-confidence-checks/spec.md
similarity index 100%
rename from openspec/changes/pilot-platform-hardening-phase-1/specs/pilot-operational-confidence-checks/spec.md
rename to openspec/changes/archive/2026-05-26-pilot-platform-hardening-phase-1/specs/pilot-operational-confidence-checks/spec.md
diff --git a/openspec/changes/pilot-platform-hardening-phase-1/specs/shell-bootstrap-and-navigation-readiness/spec.md b/openspec/changes/archive/2026-05-26-pilot-platform-hardening-phase-1/specs/shell-bootstrap-and-navigation-readiness/spec.md
similarity index 100%
rename from openspec/changes/pilot-platform-hardening-phase-1/specs/shell-bootstrap-and-navigation-readiness/spec.md
rename to openspec/changes/archive/2026-05-26-pilot-platform-hardening-phase-1/specs/shell-bootstrap-and-navigation-readiness/spec.md
diff --git a/openspec/changes/pilot-platform-hardening-phase-1/tasks.md b/openspec/changes/archive/2026-05-26-pilot-platform-hardening-phase-1/tasks.md
similarity index 100%
rename from openspec/changes/pilot-platform-hardening-phase-1/tasks.md
rename to openspec/changes/archive/2026-05-26-pilot-platform-hardening-phase-1/tasks.md
diff --git a/openspec/specs/accessibility-and-global-readiness/spec.md b/openspec/specs/accessibility-and-global-readiness/spec.md
index 0dc5a6e..3852a3f 100644
--- a/openspec/specs/accessibility-and-global-readiness/spec.md
+++ b/openspec/specs/accessibility-and-global-readiness/spec.md
@@ -36,3 +36,15 @@ The platform SHALL preserve usability under low-bandwidth conditions and avoid U
 - **WHEN** labels or messages require longer international text
 - **THEN** layout and component patterns remain resilient without depending on narrow English-only copy lengths
 
+### Requirement: Pilot-critical surfaces preserve baseline contrast and focus visibility
+
+The platform SHALL maintain readable contrast and visible focus treatment across the shared shell, student dashboard, teacher dashboard, and lesson runtime.
+
+#### Scenario: User navigates a pilot-critical flow by keyboard
+- **WHEN** a student or teacher moves through shell or lesson actions without a pointer
+- **THEN** focus remains visible and the next interactive target is understandable
+
+#### Scenario: User reads core dashboard and lesson content
+- **WHEN** student or teacher core-flow text is rendered in the pilot experience
+- **THEN** headings, body text, status labels, and primary actions remain readable without low-contrast ambiguity
+
diff --git a/openspec/specs/canonical-ux-state-system/spec.md b/openspec/specs/canonical-ux-state-system/spec.md
index aa88eca..6a78c62 100644
--- a/openspec/specs/canonical-ux-state-system/spec.md
+++ b/openspec/specs/canonical-ux-state-system/spec.md
@@ -36,3 +36,23 @@ The platform SHALL apply consistent async transition behavior for page entry, re
 - **WHEN** a retryable failure occurs
 - **THEN** the platform preserves a canonical retry state and does not force the user through a divergent recovery pattern per route
 
+### Requirement: Pilot-critical authenticated flows use canonical state messaging
+
+The platform SHALL use user-friendly canonical state messaging across shell entry, student dashboard, teacher dashboard, and lesson runtime flows.
+
+#### Scenario: Authenticated content is still loading
+- **WHEN** a pilot-critical student or teacher surface is waiting for authoritative data
+- **THEN** the visible loading state explains what is being prepared and avoids leaving stale content as the apparent current state
+
+#### Scenario: Authenticated content resolves with no data
+- **WHEN** a pilot-critical surface legitimately has no relevant data yet
+- **THEN** the platform renders an intentional empty state that is distinct from blocked or failed behavior
+
+### Requirement: Governed blocked and generic failure states remain distinct in pilot flows
+
+The platform SHALL keep governed blocked outcomes distinct from generic runtime failures in learner-facing lesson delivery.
+
+#### Scenario: Governed lesson cannot continue
+- **WHEN** the lesson runtime resolves a governed blocked or unavailable outcome
+- **THEN** the learner sees governed-specific guidance rather than a generic technical error state
+
diff --git a/openspec/specs/demo-reset-and-operational-readiness/spec.md b/openspec/specs/demo-reset-and-operational-readiness/spec.md
index f8ececf..de54ecf 100644
--- a/openspec/specs/demo-reset-and-operational-readiness/spec.md
+++ b/openspec/specs/demo-reset-and-operational-readiness/spec.md
@@ -33,3 +33,19 @@ The system SHALL preserve governed learner delivery, scoring, certification, and
 - **THEN** they still operate through existing production logic
 - **AND** demo preparation does not alter their core behavior
 
+### Requirement: Demo preparation documents bounded pilot verification
+
+The system SHALL provide a documented, bounded verification path for preparing and checking the pilot demo environment after a reset or reseed.
+
+#### Scenario: Operator prepares the pilot demo
+- **WHEN** a demo operator follows the documented reset and validation steps
+- **THEN** the operator can reseed the environment, verify the canonical student path, and confirm the bounded teacher walkthrough expectations without undocumented repair work
+
+### Requirement: Demo runbooks stay aligned with real platform behavior
+
+The system SHALL keep demo reset, smoke validation, and manual verification docs aligned with the current authenticated student and teacher experience.
+
+#### Scenario: Platform behavior changes in a pilot-critical flow
+- **WHEN** dashboard, lesson runtime, seed, or smoke behavior changes in a way that affects the pilot walkthrough
+- **THEN** the corresponding demo runbooks are updated so operators do not follow stale instructions
+
diff --git a/openspec/specs/deterministic-demo-foundation/spec.md b/openspec/specs/deterministic-demo-foundation/spec.md
index d4e7839..be443d7 100644
--- a/openspec/specs/deterministic-demo-foundation/spec.md
+++ b/openspec/specs/deterministic-demo-foundation/spec.md
@@ -17,7 +17,7 @@ The system SHALL provide one canonical demo environment composed of a stable dem
 
 ### Requirement: Deterministic reseed behavior
 
-The system SHALL support deterministic reseed behavior for demo-scoped entities.
+The system SHALL support deterministic reseed behavior for demo-scoped entities, including canonical demo users whose identity and credentials must reset to known defaults on repeat runs.
 
 #### Scenario: Demo seed is rerun
 
@@ -26,6 +26,18 @@ The system SHALL support deterministic reseed behavior for demo-scoped entities.
 - **AND** duplicate demo organizations, users, or flagship course copies are not left behind
 - **AND** demo credentials and role memberships remain valid
 
+#### Scenario: Existing demo user rows already exist
+
+- **WHEN** the demo seed encounters an existing canonical demo user
+- **THEN** it matches that user by username first and then by email if needed
+- **AND** it resets the canonical firstname, lastname, username, email, role, and password fields to the demo defaults
+
+#### Scenario: Duplicate demo user rows exist
+
+- **WHEN** duplicate rows exist for canonical demo usernames or emails
+- **THEN** the seed removes stale duplicates before upserting the final canonical demo users
+- **AND** the resulting seeded state contains one surviving row per intended demo profile
+
 ### Requirement: Stable learner relationships
 
 The system SHALL seed stable section, enrollment, and learner-course relationships for the canonical demo environment.
diff --git a/openspec/specs/educator-experience-hardening/spec.md b/openspec/specs/educator-experience-hardening/spec.md
index 5566ee6..6e15055 100644
--- a/openspec/specs/educator-experience-hardening/spec.md
+++ b/openspec/specs/educator-experience-hardening/spec.md
@@ -36,3 +36,23 @@ The platform SHALL render educator loading, unavailable, empty, and retry states
 - **WHEN** an educator views a learner context that is blocked or unavailable
 - **THEN** the educator sees stable operational context that explains the blocked state without route-local interpretation drift
 
+### Requirement: Teacher dashboard exposes stable pilot-baseline visibility
+
+The platform SHALL provide a stable teacher dashboard baseline that exposes enough course, learner-progress, and runtime-support state for a pilot walkthrough even when some educator datasets are empty.
+
+#### Scenario: Teacher opens the dashboard with available course context
+- **WHEN** an educator reaches the teacher dashboard in a pilot environment
+- **THEN** the dashboard exposes a readable course-management and learner-visibility baseline that supports live narration of platform value
+
+#### Scenario: Teacher opens the dashboard with sparse data
+- **WHEN** one or more educator sections resolve with no data yet
+- **THEN** the dashboard shows intentional empty states rather than collapsed, broken, or misleading panels
+
+### Requirement: Teacher dashboard recovery states remain usable
+
+The platform SHALL provide actionable loading and retry behavior for teacher-facing dashboard sections that depend on asynchronous operational data.
+
+#### Scenario: Educator section fails to load
+- **WHEN** a teacher dashboard section cannot load its operational data
+- **THEN** the educator sees a clear section-level recovery state with bounded retry behavior instead of losing the whole dashboard context
+
diff --git a/openspec/specs/governed-progression-integrity/spec.md b/openspec/specs/governed-progression-integrity/spec.md
index 1f72a12..4a880ec 100644
--- a/openspec/specs/governed-progression-integrity/spec.md
+++ b/openspec/specs/governed-progression-integrity/spec.md
@@ -15,16 +15,25 @@ The system SHALL create learner segment and related progress rows only for lesso
 - **THEN** the system creates progress rows only for the governed learner-visible lesson path
 
 ### Requirement: Governed lesson selection drives learner progression deterministically
-The system SHALL use governed learner-visible lessons as the source of truth for segment advancement, unit completion, and course continuation.
+The system SHALL use governed learner-visible lessons as the source of truth for governed segment advancement, unit completion, and course continuation, and SHALL preserve ordinary sequential advancement for non-governed lesson paths.
 
 #### Scenario: Learner completes a governed segment
 - **WHEN** a learner completes a segment in an approved-ready lesson path
 - **THEN** the next segment is resolved from the governed learner-visible lesson sequence
 
+#### Scenario: Governed unit contains stale draft or non-governed progress rows
+- **WHEN** governed learner progression is evaluated for a unit that also contains stale draft or otherwise non-governed segment-progress rows
+- **THEN** the system does not auto-activate those stale rows
+- **AND** governed continuation is resolved only from the current governed learner-visible lesson sequence
+
 #### Scenario: No governed next lesson exists
 - **WHEN** the learner reaches a point where no approved-ready governed next lesson exists
 - **THEN** the system does not advance into draft or unapproved content and instead returns an explicit governed unavailable outcome
 
+#### Scenario: Non-governed unit progresses normally
+- **WHEN** learner progression is evaluated for an ordinary non-governed unit with a remaining `NOT_STARTED` segment
+- **THEN** the system auto-activates the next sequential segment rather than blocking advancement under governed-only rules
+
 ### Requirement: Governed progress remains institutionally auditable
 The system SHALL preserve a trustworthy relationship between delivered learner content and stored learner progress so that institutions can rely on progress records as evidence of actual governed instruction.
 
diff --git a/openspec/specs/learner-experience-hardening/spec.md b/openspec/specs/learner-experience-hardening/spec.md
index 57e1a8c..8b5d3d4 100644
--- a/openspec/specs/learner-experience-hardening/spec.md
+++ b/openspec/specs/learner-experience-hardening/spec.md
@@ -36,3 +36,24 @@ The platform SHALL preserve learner usability across mobile, tablet, keyboard, a
 - **WHEN** learner-facing content is viewed on a narrow viewport
 - **THEN** the layout preserves readability, primary actions, and progression clarity without horizontal overflow or hidden critical controls
 
+### Requirement: Learner dashboard continuation remains pilot-safe
+
+The platform SHALL present a stable learner dashboard continuation path that helps the student understand the active course, next lesson step, and recovery options when data is unavailable.
+
+#### Scenario: Student lands on the dashboard with an active course
+- **WHEN** a learner logs in and has an active governed course path
+- **THEN** the dashboard shows the active course and continuation action in a readable, user-friendly way
+- **AND** the continuation path does not depend on stale route-local assumptions
+
+#### Scenario: Learner dashboard data cannot be restored
+- **WHEN** the student dashboard cannot load continuation data
+- **THEN** the learner sees a clear recovery state with retry or alternate navigation instead of a blank or misleading card
+
+### Requirement: Lesson entry and return preserve learner continuity
+
+The platform SHALL let a learner enter the current lesson path and return safely to the dashboard without losing orientation about where to continue next.
+
+#### Scenario: Student enters and exits a lesson
+- **WHEN** a learner continues into a lesson and later chooses to return to the dashboard
+- **THEN** the platform preserves a coherent continuation path and does not strand the learner in an ambiguous intermediate state
+
diff --git a/openspec/specs/pilot-operational-confidence-checks/spec.md b/openspec/specs/pilot-operational-confidence-checks/spec.md
new file mode 100644
index 0000000..d420632
--- /dev/null
+++ b/openspec/specs/pilot-operational-confidence-checks/spec.md
@@ -0,0 +1,31 @@
+# pilot-operational-confidence-checks Specification
+
+## Purpose
+TBD - created by archiving change pilot-platform-hardening-phase-1. Update Purpose after archive.
+## Requirements
+### Requirement: Bounded pilot operational confidence checks
+
+The system SHALL provide a bounded readiness verification layer for pilot-critical EchoEd flows without expanding into a full end-to-end platform test suite.
+
+#### Scenario: Operator validates pilot readiness
+- **WHEN** a pilot operator runs the documented validation flow
+- **THEN** the flow confirms the student login, active-course discovery, lesson entry, and safe return expectations
+- **AND** it confirms the teacher can reach a stable dashboard state with enough course and learner visibility for a pilot walkthrough
+
+### Requirement: Pilot confidence checks remain aligned with existing regression authorities
+
+The system SHALL treat backend pytest, frontend Angular tests, and the existing student browser smoke as the authoritative automated confidence layers for Phase 1.
+
+#### Scenario: Phase 1 validation is reviewed
+- **WHEN** the pilot hardening verification strategy is inspected
+- **THEN** it includes the existing backend test suite, existing Angular tests, and the bounded student smoke path
+- **AND** it does not depend on weakened auth, mocked runtime shortcuts, or undocumented manual database repair
+
+### Requirement: Confidence documentation states its boundaries
+
+The system SHALL document what the pilot-confidence flow proves and what remains intentionally manual or out of scope.
+
+#### Scenario: Operator reads the validation runbook
+- **WHEN** a pilot operator prepares EchoEd for a walkthrough
+- **THEN** the documentation explains which checks are automated, which teacher validations remain manual, and which broader resilience concerns are not covered by Phase 1
+
diff --git a/openspec/specs/shell-bootstrap-and-navigation-readiness/spec.md b/openspec/specs/shell-bootstrap-and-navigation-readiness/spec.md
index 2a13118..f7c6a1a 100644
--- a/openspec/specs/shell-bootstrap-and-navigation-readiness/spec.md
+++ b/openspec/specs/shell-bootstrap-and-navigation-readiness/spec.md
@@ -47,3 +47,15 @@ The platform SHALL use consistent loading, blocked, unavailable, and retry state
 - **WHEN** the app resolves an authenticated state that still cannot enter the normal shell because onboarding, active-org, or governed visibility requirements are unmet
 - **THEN** the user sees a clear redirect or unavailable-state outcome rather than an ambiguous partial shell
 
+### Requirement: Pilot-critical shell entry and return paths remain visually stable
+
+The platform SHALL keep the authenticated shell, header, sidebar, and primary content region stable across dashboard entry, role-aware navigation, and return-from-lesson transitions.
+
+#### Scenario: Student returns from a lesson
+- **WHEN** a student exits a lesson back to the dashboard
+- **THEN** the dashboard re-enters through the resolved authenticated shell without broken navigation, contradictory role cues, or displaced primary content
+
+#### Scenario: Teacher reaches the dashboard after login
+- **WHEN** a teacher completes authenticated bootstrap
+- **THEN** the header, sidebar, and dashboard layout render from resolved role and organization context without flashing stale navigation or partial shell states
+

From 6227a390129dcba7cbc22696793196c4f46018a3 Mon Sep 17 00:00:00 2001
From: Anthony Wright <anthony@mrwrite.dev>
Date: Tue, 30 Jun 2026 15:25:51 -0500
Subject: [PATCH 12/14] echoed-v2-platform-evolution

---
 backend/app/api/routes/courses.py             |  29 ++-
 backend/app/api/routes/progress.py            |   6 +
 backend/app/api/routes/start_course.py        |  10 +
 backend/app/crud/progress.py                  |  75 ++++++
 backend/app/schemas.py                        |   2 +-
 backend/tests/test_course_permissions.py      |  29 +++
 backend/tests/test_start_course_endpoint.py   |  91 ++++++-
 backend/tests/test_student_progress.py        |  61 ++++-
 frontend/src/app/app.routes.spec.ts           |  62 +++++
 frontend/src/app/app.routes.ts                | 202 ++++++++++++++++
 .../echo-sidebar/echo-sidebar.component.html  |   2 +-
 .../echo-sidebar.component.spec.ts            |  26 +-
 .../echo-sidebar/echo-sidebar.component.ts    |  28 +--
 .../admin-courses.component.html              |   6 +-
 .../available-courses.component.html          |   4 +-
 .../src/app/pages/home/home.component.html    |   4 +-
 .../studio-courses.component.html             |  12 +-
 .../v2-platform/v2-platform-page.component.ts | 128 ++++++++++
 .../src/app/services/permissions.service.ts   |  14 ++
 .../echoed-v2-platform-evolution/design.md    | 227 ++++++++++++++++++
 .../echoed-v2-platform-evolution/proposal.md  | 153 ++++++++++++
 .../specs/access-grants/spec.md               |  41 ++++
 .../specs/analytics-v2/spec.md                |  51 ++++
 .../specs/artifact-registry/spec.md           |  53 ++++
 .../specs/learner-portal-v2/spec.md           |  40 +++
 .../specs/product-catalog/spec.md             |  49 ++++
 .../specs/product-studio/spec.md              |  55 +++++
 .../specs/project-knowledge-pipeline/spec.md  |  42 ++++
 .../specs/review-center/spec.md               |  40 +++
 .../workspace-platform-foundation/spec.md     |  42 ++++
 .../echoed-v2-platform-evolution/tasks.md     |  79 ++++++
 31 files changed, 1619 insertions(+), 44 deletions(-)
 create mode 100644 frontend/src/app/app.routes.spec.ts
 create mode 100644 frontend/src/app/pages/v2-platform/v2-platform-page.component.ts
 create mode 100644 openspec/changes/echoed-v2-platform-evolution/design.md
 create mode 100644 openspec/changes/echoed-v2-platform-evolution/proposal.md
 create mode 100644 openspec/changes/echoed-v2-platform-evolution/specs/access-grants/spec.md
 create mode 100644 openspec/changes/echoed-v2-platform-evolution/specs/analytics-v2/spec.md
 create mode 100644 openspec/changes/echoed-v2-platform-evolution/specs/artifact-registry/spec.md
 create mode 100644 openspec/changes/echoed-v2-platform-evolution/specs/learner-portal-v2/spec.md
 create mode 100644 openspec/changes/echoed-v2-platform-evolution/specs/product-catalog/spec.md
 create mode 100644 openspec/changes/echoed-v2-platform-evolution/specs/product-studio/spec.md
 create mode 100644 openspec/changes/echoed-v2-platform-evolution/specs/project-knowledge-pipeline/spec.md
 create mode 100644 openspec/changes/echoed-v2-platform-evolution/specs/review-center/spec.md
 create mode 100644 openspec/changes/echoed-v2-platform-evolution/specs/workspace-platform-foundation/spec.md
 create mode 100644 openspec/changes/echoed-v2-platform-evolution/tasks.md

diff --git a/backend/app/api/routes/courses.py b/backend/app/api/routes/courses.py
index 28040fd..a0ee2e4 100644
--- a/backend/app/api/routes/courses.py
+++ b/backend/app/api/routes/courses.py
@@ -107,6 +107,33 @@ def _serialize_runtime_intervention_evidence_basis(basis) -> RuntimeIntervention
     )
 
 
+def _serialize_course_summary(course: Course) -> CourseSummaryResponse:
+    return CourseSummaryResponse(
+        id=course.id,
+        title=course.title,
+        description=course.description,
+        subject=course.subject,
+        age_band_min=course.age_band_min,
+        age_band_max=course.age_band_max,
+        default_locale=course.default_locale,
+        learning_objectives=course.learning_objectives,
+        skill_tags=course.skill_tags or [],
+        standards_metadata=course.standards_metadata or {},
+        revision_number=course.revision_number,
+        revision_label=course.revision_label,
+        revision_status=course.revision_status,
+        revision_metadata=course.revision_metadata or {},
+        previous_revision_id=course.previous_revision_id,
+        superseded_by_id=course.superseded_by_id,
+        lineage_status=course.lineage_status,
+        lineage_metadata=course.lineage_metadata or {},
+        published_at=course.published_at,
+        deprecated_at=course.deprecated_at,
+        created_by=course.created_by,
+        organization_id=course.organization_id,
+    )
+
+
 @router.get("/courses", response_model=list[CourseSummaryResponse])
 def get_courses(
     subject: str | None = Query(default=None),
@@ -128,7 +155,7 @@ def get_courses(
         query = query.filter(Course.default_locale == locale)
     if org_id:
         query = query.filter(Course.organization_id == org_id)
-    return query.all()
+    return [_serialize_course_summary(course) for course in query.all()]
 
 
 @router.get("/student-courses", response_model=list[StudentCourseWithDetails])
diff --git a/backend/app/api/routes/progress.py b/backend/app/api/routes/progress.py
index 58c06b0..391169b 100644
--- a/backend/app/api/routes/progress.py
+++ b/backend/app/api/routes/progress.py
@@ -54,6 +54,12 @@ def get_segment(
     if not unit_progress:
         raise HTTPException(status_code=404, detail="Unit progress not found.")
 
+    current_segment = crud.resolve_governed_segment_for_unit_progress(
+        db, student_unit_id
+    )
+    if current_segment is not None:
+        return SegmentResponse(**current_segment)
+
     progression = crud.resolve_governed_progression(db, unit_progress.student_course_id)
     if progression["delivery_state"] != "governed_available":
         return SegmentResponse(
diff --git a/backend/app/api/routes/start_course.py b/backend/app/api/routes/start_course.py
index 8866c28..b4aad94 100644
--- a/backend/app/api/routes/start_course.py
+++ b/backend/app/api/routes/start_course.py
@@ -4,6 +4,7 @@
 from app.crud import progress as crud
 from app.database import get_db
 from app.deps import require_roles
+from app.lesson_governance import GOVERNED_AVAILABLE
 from app.log import logger
 from app.models import StudentCourse
 from app.schemas import SegmentResponse, StartCourseRequest
@@ -31,4 +32,13 @@ def start_course(
         raise HTTPException(status_code=400, detail="Course already completed")
 
     progression = crud.resolve_governed_progression(db, enrollment.id)
+    if (
+        progression.get("delivery_state") == GOVERNED_AVAILABLE
+        and progression.get("unit_progress_id") is not None
+    ):
+        ensured_progression = crud.resolve_governed_segment_for_unit_progress(
+            db, progression["unit_progress_id"]
+        )
+        if ensured_progression is not None:
+            progression = ensured_progression
     return SegmentResponse(**progression)
diff --git a/backend/app/crud/progress.py b/backend/app/crud/progress.py
index d362317..aef420b 100644
--- a/backend/app/crud/progress.py
+++ b/backend/app/crud/progress.py
@@ -380,6 +380,81 @@ def _governed_current_segment_for_unit_progress(
     return segments[0] if segments else None
 
 
+def ensure_current_segment_progress_for_unit(
+    db: Session, unit_progress: StudentUnitProgress
+) -> SegmentProgress | None:
+    unit = db.get(Unit, unit_progress.unit_id)
+    if unit is None:
+        return None
+
+    selection = governed_lessons_for_unit(unit)
+    if selection.state != GOVERNED_AVAILABLE:
+        return None
+
+    governed_segments = _ensure_governed_segments(db, unit_progress, selection.lessons)
+    active_segment = next(
+        (segment for segment in governed_segments if segment.status == ProgressStatus.IN_PROGRESS),
+        None,
+    )
+    if active_segment is not None:
+        return active_segment
+
+    next_segment = next(
+        (
+            segment
+            for segment in governed_segments
+            if segment.status not in {ProgressStatus.COMPLETED, ProgressStatus.SKIPPED}
+        ),
+        None,
+    )
+    if next_segment is None:
+        return None
+
+    if next_segment.status == ProgressStatus.NOT_STARTED:
+        student_course = db.get(StudentCourse, unit_progress.student_course_id)
+        next_segment.status = ProgressStatus.IN_PROGRESS
+        next_segment.started_at = next_segment.started_at or datetime.utcnow()
+        next_segment.last_updated = datetime.utcnow()
+        unit_progress.status = ProgressStatus.IN_PROGRESS
+        unit_progress.started_at = unit_progress.started_at or datetime.utcnow()
+        unit_progress.last_updated = datetime.utcnow()
+        if student_course is not None:
+            student_course.last_activity_at = datetime.utcnow()
+        db.commit()
+        db.refresh(next_segment)
+        db.refresh(unit_progress)
+
+    return next_segment
+
+
+def resolve_governed_segment_for_unit_progress(
+    db: Session, unit_progress_id: UUID | str
+) -> dict[str, object] | None:
+    unit_progress = db.get(StudentUnitProgress, unit_progress_id)
+    if unit_progress is None:
+        return None
+
+    unit = db.get(Unit, unit_progress.unit_id)
+    if unit is None:
+        return None
+
+    selection = governed_lessons_for_unit(unit)
+    if selection.state != GOVERNED_AVAILABLE:
+        return None
+
+    segment = ensure_current_segment_progress_for_unit(db, unit_progress)
+    if segment is None:
+        return None
+
+    return {
+        "delivery_state": GOVERNED_AVAILABLE,
+        "detail": selection.detail,
+        "lesson_id": segment.lesson_id,
+        "status": segment.status,
+        "unit_progress_id": unit_progress.id,
+    }
+
+
 def resolve_governed_progression(
     db: Session, student_course_id: UUID | str
 ) -> dict[str, object]:
diff --git a/backend/app/schemas.py b/backend/app/schemas.py
index c265d8e..8c3c18a 100644
--- a/backend/app/schemas.py
+++ b/backend/app/schemas.py
@@ -421,7 +421,7 @@ class CourseResponse(RevisionMetadataResponseMixin):
     title: str
     description: str
     learning_objectives: Optional[str] = None
-    skill_tags: List[str] = Field(default_factory=list)
+    skill_tags: list[str] = Field(default_factory=list)
     standards_metadata: dict[str, Any] = Field(default_factory=dict)
     units: List[UnitResponse] = Field(default_factory=list)
 
diff --git a/backend/tests/test_course_permissions.py b/backend/tests/test_course_permissions.py
index 6b7b099..7cf0c2b 100644
--- a/backend/tests/test_course_permissions.py
+++ b/backend/tests/test_course_permissions.py
@@ -135,3 +135,32 @@ def test_student_cannot_delete_course(test_db, student_user):
 
     app.dependency_overrides = {}
 
+
+def test_course_reads_normalize_null_metadata_fields(test_db, teacher_user):
+    course = Course(
+        id=uuid.uuid4(),
+        title="Nullable Metadata",
+        description="Desc",
+        skill_tags=None,
+        standards_metadata=None,
+    )
+    test_db.add(course)
+    test_db.commit()
+
+    app.dependency_overrides[get_current_user] = lambda: teacher_user
+
+    list_response = client.get("/api/courses")
+    assert list_response.status_code == 200
+    list_payload = list_response.json()
+    matching = next(item for item in list_payload if item["id"] == str(course.id))
+    assert matching["skill_tags"] == []
+    assert matching["standards_metadata"] == {}
+
+    detail_response = client.get(f"/api/courses/{course.id}")
+    assert detail_response.status_code == 200
+    detail_payload = detail_response.json()
+    assert detail_payload["skill_tags"] == []
+    assert detail_payload["standards_metadata"] == {}
+
+    app.dependency_overrides = {}
+
diff --git a/backend/tests/test_start_course_endpoint.py b/backend/tests/test_start_course_endpoint.py
index d432e34..d0f1b77 100644
--- a/backend/tests/test_start_course_endpoint.py
+++ b/backend/tests/test_start_course_endpoint.py
@@ -4,7 +4,7 @@
 
 from fastapi import FastAPI
 from fastapi.testclient import TestClient
-from app.api.routes import start_course
+from app.api.routes import progress, start_course
 from app.auth import get_current_user
 from app.crud import progress as progress_crud
 from app.database import get_db
@@ -73,6 +73,7 @@ def override_get_current_user(user):
 def _build_test_client(db_session, user):
     test_app = FastAPI()
     test_app.include_router(start_course.router, prefix="/api")
+    test_app.include_router(progress.router, prefix="/api/progress")
     test_app.dependency_overrides[get_current_user] = override_get_current_user(user)
 
     def override_get_db():
@@ -480,3 +481,91 @@ def test_completed_governed_unit_returns_pending_review_when_next_unit_has_no_ap
             .all()
         )
         assert blocked_segments == []
+
+
+def test_start_course_returns_unit_progress_id_with_segment_endpoint_ready(
+    db_session, test_student
+):
+    course = Course(id=uuid.uuid4(), title="Course Recovery", description="Test")
+    unit = Unit(id=uuid.uuid4(), title="Recoverable Unit", course_id=course.id, order=1)
+    lesson = Lesson(
+        id=uuid.uuid4(),
+        title="Approved Lesson",
+        unit_id=unit.id,
+        duration_minutes=5,
+        order=1,
+        objective="Objective",
+        learning_objectives="Learning objective",
+        key_concepts=["concept"],
+        hook="Hook",
+        content="Content",
+        guided_practice="Guided",
+        independent_practice="Independent",
+        assessment="Assessment",
+        review_status="approved",
+    )
+    draft_lesson = Lesson(
+        id=uuid.uuid4(),
+        title="Draft Lesson",
+        unit_id=unit.id,
+        duration_minutes=5,
+        order=2,
+        review_status="draft",
+    )
+    db_session.add_all([course, unit, lesson, draft_lesson])
+    db_session.commit()
+    db_session.add(Source(lesson_id=lesson.id, citation="Source", url="https://example.com/source"))
+    db_session.commit()
+
+    student_course = StudentCourse(student_id=test_student.id, course_id=course.id)
+    db_session.add(student_course)
+    db_session.commit()
+    db_session.refresh(student_course)
+
+    unit_progress = StudentUnitProgress(
+        student_course_id=student_course.id,
+        unit_id=unit.id,
+        status=ProgressStatus.IN_PROGRESS,
+    )
+    db_session.add(unit_progress)
+    db_session.commit()
+    db_session.refresh(unit_progress)
+
+    client = _build_test_client(db_session, test_student)
+
+    start_response = client.post("/api/start-course", json={"course_id": str(course.id)})
+    assert start_response.status_code == 200
+    start_data = start_response.json()
+    assert start_data["delivery_state"] == "governed_available"
+    assert start_data["unit_progress_id"] == str(unit_progress.id)
+
+    db_session.query(SegmentProgress).filter_by(student_unit_id=unit_progress.id).delete()
+    db_session.commit()
+
+    segment_response = client.get(
+        f"/api/progress/segment?student_unit_id={unit_progress.id}"
+    )
+
+    assert segment_response.status_code == 200
+    segment_data = segment_response.json()
+    assert segment_data["delivery_state"] == "governed_available"
+    assert segment_data["lesson_id"] == str(lesson.id)
+    assert segment_data["status"] == ProgressStatus.IN_PROGRESS.value
+    assert segment_data["unit_progress_id"] == str(unit_progress.id)
+
+    segment_rows = (
+        db_session.query(SegmentProgress)
+        .filter_by(student_unit_id=unit_progress.id)
+        .order_by(SegmentProgress.lesson_id)
+        .all()
+    )
+    assert len(segment_rows) == 1
+    assert segment_rows[0].lesson_id == lesson.id
+    assert segment_rows[0].status == ProgressStatus.IN_PROGRESS
+
+    draft_segment = (
+        db_session.query(SegmentProgress)
+        .filter_by(student_unit_id=unit_progress.id, lesson_id=draft_lesson.id)
+        .first()
+    )
+    assert draft_segment is None
diff --git a/backend/tests/test_student_progress.py b/backend/tests/test_student_progress.py
index 75e102a..9cd4d71 100644
--- a/backend/tests/test_student_progress.py
+++ b/backend/tests/test_student_progress.py
@@ -1,7 +1,7 @@
 import uuid
 import pytest
 from app.models import (
-    User, Course, Unit, Lesson,
+    User, Course, Unit, Lesson, Source,
     StudentCourse, StudentUnitProgress, SegmentProgress
 )
 from app.crud import progress as crud
@@ -305,3 +305,62 @@ def test_complete_single_lesson_course_marks_course_completed(db_session, test_u
 
     updated_course = db_session.get(StudentCourse, student_course.id)
     assert updated_course.status == "completed"
+
+
+def test_resolve_governed_progression_recreates_missing_segments_for_available_unit(
+    db_session, test_user
+):
+    course = Course(id=uuid.uuid4(), title="Governed Recovery", description="Recovery path")
+    unit = Unit(id=uuid.uuid4(), title="Recoverable Unit", course_id=course.id, order=1)
+    lesson = Lesson(
+        id=uuid.uuid4(),
+        title="Recoverable Lesson",
+        unit_id=unit.id,
+        duration_minutes=5,
+        order=1,
+        objective="Objective",
+        learning_objectives="Learning objective",
+        key_concepts=["concept"],
+        hook="Hook",
+        content="Content",
+        guided_practice="Guided",
+        independent_practice="Independent",
+        assessment="Assessment",
+        review_status="approved",
+    )
+    db_session.add_all([course, unit, lesson])
+    db_session.commit()
+    db_session.add(
+        Source(lesson_id=lesson.id, citation="Source", url="https://example.com/source")
+    )
+    db_session.commit()
+
+    student_course = StudentCourse(student_id=test_user.id, course_id=course.id)
+    db_session.add(student_course)
+    db_session.commit()
+
+    unit_progress = StudentUnitProgress(
+        student_course_id=student_course.id,
+        unit_id=unit.id,
+        status=ProgressStatus.IN_PROGRESS,
+    )
+    db_session.add(unit_progress)
+    db_session.commit()
+    db_session.refresh(unit_progress)
+
+    resolved = crud.resolve_governed_segment_for_unit_progress(db_session, unit_progress.id)
+
+    assert resolved is not None
+    assert resolved["delivery_state"] == "governed_available"
+    assert resolved["lesson_id"] == lesson.id
+    assert resolved["status"] == ProgressStatus.IN_PROGRESS
+    assert resolved["unit_progress_id"] == unit_progress.id
+
+    segments = (
+        db_session.query(SegmentProgress)
+        .filter_by(student_unit_id=unit_progress.id)
+        .all()
+    )
+    assert len(segments) == 1
+    assert segments[0].lesson_id == lesson.id
+    assert segments[0].status == ProgressStatus.IN_PROGRESS
diff --git a/frontend/src/app/app.routes.spec.ts b/frontend/src/app/app.routes.spec.ts
new file mode 100644
index 0000000..94e7f69
--- /dev/null
+++ b/frontend/src/app/app.routes.spec.ts
@@ -0,0 +1,62 @@
+import { Route, Routes } from '@angular/router';
+import { routes } from './app.routes';
+
+function findRoute(routeList: Routes, path: string): Route | undefined {
+  const exactRoute = routeList.find(candidate => candidate.path === path);
+  if (exactRoute) {
+    return exactRoute;
+  }
+
+  const [head, ...tail] = path.split('/');
+  const route = routeList.find(candidate => candidate.path === head);
+
+  if (!route) {
+    const passthrough = routeList.find(candidate => candidate.path === '');
+    return passthrough?.children ? findRoute(passthrough.children, path) : undefined;
+  }
+
+  if (tail.length === 0) {
+    return route;
+  }
+
+  if (route.children) {
+    return findRoute(route.children, tail.join('/'));
+  }
+
+  const passthrough = routeList.find(candidate => candidate.path === '');
+  return passthrough?.children ? findRoute(passthrough.children, path) : undefined;
+}
+
+describe('app routes', () => {
+  it('preserves the legacy authenticated home route', () => {
+    expect(findRoute(routes, 'home')).toBeTruthy();
+    expect(findRoute(routes, 'home/')).toBeTruthy();
+  });
+
+  it('adds V2 workspace aliases for platform navigation', () => {
+    [
+      'workspace',
+      'workspace/projects',
+      'workspace/product-studio',
+      'workspace/products',
+      'workspace/knowledge-sources',
+      'workspace/artifacts',
+      'workspace/review-center',
+      'workspace/learners',
+      'workspace/analytics',
+      'workspace/settings',
+    ].forEach(path => expect(findRoute(routes, path)).withContext(path).toBeTruthy());
+  });
+
+  it('adds learner portal aliases without removing existing learner pages', () => {
+    [
+      'learn',
+      'learn/',
+      'learn/products',
+      'learn/paths',
+      'learn/certificates',
+      'learn/resources',
+      'learn/lesson/:id',
+    ].forEach(path => expect(findRoute(routes, path)).withContext(path).toBeTruthy());
+  });
+});
diff --git a/frontend/src/app/app.routes.ts b/frontend/src/app/app.routes.ts
index 4ba486d..1625316 100644
--- a/frontend/src/app/app.routes.ts
+++ b/frontend/src/app/app.routes.ts
@@ -23,6 +23,11 @@ import { HomeSessionGuard } from './guards/home-session.guard';
 import { ProgramsComponent } from './pages/programs/programs.component';
 import { AssessmentDetailComponent } from './pages/assessment-detail/assessment-detail.component';
 import { CertificationsComponent } from './pages/certifications/certifications.component';
+import { V2PlatformPageComponent } from './pages/v2-platform/v2-platform-page.component';
+
+const creatorRoles = ['admin', 'teacher', 'content_admin', 'org_admin', 'instructor'];
+const studioRoles = ['content_admin', 'org_admin'];
+const sectionRoles = ['teacher', 'org_admin', 'instructor'];
 
 export const routes: Routes = [
   { path: '', component: LandingComponent },
@@ -104,5 +109,202 @@ export const routes: Routes = [
       }
     ]
   },
+  {
+    path: 'workspace',
+    component: HomeComponent,
+    canActivate: [HomeSessionGuard],
+    children: [
+      {
+        path: '',
+        component: V2PlatformPageComponent,
+        data: {
+          eyebrow: 'Workspace',
+          title: 'EchoEd workspace',
+          description: 'A platform view of your organization knowledge, learning products, review workflow, learners, and operational readiness.',
+          status: 'Phase 1 maps the existing education runtime into the V2 platform shell without replacing courses, lessons, progress, or governance.',
+          links: [
+            { label: 'View products', route: '/workspace/products' },
+            { label: 'Open learner portal', route: '/workspace/learners' },
+            { label: 'Review center', route: '/workspace/review-center' }
+          ]
+        }
+      },
+      {
+        path: 'projects',
+        component: V2PlatformPageComponent,
+        canActivate: [RoleGuard],
+        data: {
+          roles: creatorRoles,
+          eyebrow: 'Projects',
+          title: 'Project knowledge pipeline',
+          description: 'Projects will group source material, AI analysis, generated artifacts, and product outputs for a business or technical initiative.',
+          status: 'Placeholder route: wrapper models arrive in a later phase; existing course runtime remains unchanged.'
+        }
+      },
+      {
+        path: 'product-studio',
+        component: V2PlatformPageComponent,
+        canActivate: [RoleGuard],
+        data: {
+          roles: creatorRoles,
+          eyebrow: 'Product Studio',
+          title: 'Create trusted learning products',
+          description: 'Product Studio will orchestrate source import, AI generation, human review, approval, publishing, and delivery.',
+          status: 'Phase 1 exposes the Studio entry point and links to existing course creation tools.',
+          links: [
+            { label: 'Existing studio courses', route: '/workspace/product-studio/courses' },
+            { label: 'Create course-backed product', route: '/workspace/product-studio/courses/new' }
+          ]
+        }
+      },
+      {
+        path: 'product-studio/courses',
+        component: StudioCoursesComponent,
+        canActivate: [RoleGuard],
+        data: { roles: studioRoles }
+      },
+      {
+        path: 'product-studio/courses/new',
+        component: CourseWizardComponent,
+        canActivate: [RoleGuard],
+        data: { roles: ['admin', 'teacher'] }
+      },
+      {
+        path: 'product-studio/courses/:courseId/edit',
+        component: CourseWizardComponent,
+        canActivate: [RoleGuard],
+        data: { roles: ['admin', 'teacher'] }
+      },
+      { path: 'products', component: AvailableCoursesComponent },
+      {
+        path: 'products/manage',
+        component: AdminCoursesComponent,
+        canActivate: [RoleGuard],
+        data: { roles: ['admin'] }
+      },
+      {
+        path: 'knowledge-sources',
+        component: V2PlatformPageComponent,
+        canActivate: [RoleGuard],
+        data: {
+          roles: creatorRoles,
+          eyebrow: 'Knowledge Sources',
+          title: 'Source-aware knowledge intake',
+          description: 'Knowledge Sources will collect documentation, project references, files, and source-backed material used by AI-assisted generation.',
+          status: 'Placeholder route: source-backed lesson readiness remains available through existing governance flows.'
+        }
+      },
+      {
+        path: 'artifacts',
+        component: V2PlatformPageComponent,
+        canActivate: [RoleGuard],
+        data: {
+          roles: creatorRoles,
+          eyebrow: 'Artifacts',
+          title: 'Generated documentation and learning assets',
+          description: 'Artifacts will track AI-generated documentation, playbooks, downloads, and reusable assets before they become learning products.',
+          status: 'Placeholder route: artifact registry models and packaging workflows are planned for a later phase.'
+        }
+      },
+      {
+        path: 'review-center',
+        component: V2PlatformPageComponent,
+        canActivate: [RoleGuard],
+        data: {
+          roles: creatorRoles,
+          eyebrow: 'Review Center',
+          title: 'Governance and readiness review',
+          description: 'Review Center will centralize source-backed lesson readiness, approvals, and product publishing confidence.',
+          status: 'Phase 1 preserves existing governance behavior and provides links into current review-capable surfaces.',
+          links: [
+            { label: 'Studio courses', route: '/workspace/product-studio/courses' },
+            { label: 'Managed products', route: '/workspace/products/manage' }
+          ]
+        }
+      },
+      {
+        path: 'learners',
+        component: UserDashboardComponent,
+        children: [
+          { path: '', component: EchoedRoleSelectorComponent },
+          { path: 'products', component: AvailableCoursesComponent },
+          { path: 'paths', component: ProgramsComponent },
+          { path: 'certificates', component: CertificationsComponent },
+          {
+            path: 'users',
+            component: AdminUsersComponent,
+            canActivate: [RoleGuard],
+            data: { roles: ['admin'] }
+          },
+          {
+            path: 'cohorts',
+            component: SectionsComponent,
+            canActivate: [RoleGuard],
+            data: { roles: sectionRoles }
+          },
+          {
+            path: 'cohorts/:id',
+            component: SectionDetailComponent,
+            canActivate: [RoleGuard],
+            data: { roles: sectionRoles }
+          }
+        ]
+      },
+      {
+        path: 'analytics',
+        component: V2PlatformPageComponent,
+        canActivate: [RoleGuard],
+        data: {
+          roles: creatorRoles,
+          eyebrow: 'Analytics',
+          title: 'Learner and product intelligence',
+          description: 'Analytics V2 will connect progress, completion, readiness, and product performance into operational confidence views.',
+          status: 'Placeholder route: existing progress tracking remains the runtime source of truth.'
+        }
+      },
+      { path: 'settings', component: PreferencesComponent },
+      {
+        path: 'settings/invites',
+        component: OrgInvitesComponent,
+        canActivate: [RoleGuard],
+        data: { roles: ['org_admin', 'content_admin'] }
+      },
+      {
+        path: 'settings/badges',
+        component: AdminBadgesComponent,
+        canActivate: [RoleGuard],
+        data: { roles: ['admin'] }
+      },
+      { path: 'lesson/:id', component: LessonViewComponent },
+    ]
+  },
+  {
+    path: 'learn',
+    component: HomeComponent,
+    canActivate: [HomeSessionGuard],
+    children: [
+      {
+        path: '',
+        component: UserDashboardComponent,
+        children: [
+          { path: '', component: EchoedRoleSelectorComponent },
+          { path: 'products', component: AvailableCoursesComponent },
+          { path: 'paths', component: ProgramsComponent },
+          { path: 'certificates', component: CertificationsComponent },
+          {
+            path: 'resources',
+            component: V2PlatformPageComponent,
+            data: {
+              eyebrow: 'Resources',
+              title: 'Knowledge resources',
+              description: 'Downloadable documentation packs and knowledge hub resources will appear here as the V2 artifact registry comes online.',
+              status: 'Placeholder route: current learner course and certification routes remain unchanged.'
+            }
+          },
+          { path: 'lesson/:id', component: LessonViewComponent },
+        ]
+      }
+    ]
+  },
   { path: '**', redirectTo: '' }
 ];
diff --git a/frontend/src/app/components/echo-sidebar/echo-sidebar.component.html b/frontend/src/app/components/echo-sidebar/echo-sidebar.component.html
index ae75071..a805052 100644
--- a/frontend/src/app/components/echo-sidebar/echo-sidebar.component.html
+++ b/frontend/src/app/components/echo-sidebar/echo-sidebar.component.html
@@ -9,7 +9,7 @@
       <div class="h-10 w-10 rounded-xl bg-gradient-to-br from-primary to-secondary text-white flex items-center justify-center font-bold shrink-0">EE</div>
       <div class="min-w-0">
         <p class="text-xs uppercase tracking-[0.25em] text-primary">EchoEd</p>
-        <p class="text-sm font-semibold text-slate-800 truncate">Demo Navigator</p>
+        <p class="text-sm font-semibold text-slate-800 truncate">Workspace OS</p>
       </div>
     </div>
     <button
diff --git a/frontend/src/app/components/echo-sidebar/echo-sidebar.component.spec.ts b/frontend/src/app/components/echo-sidebar/echo-sidebar.component.spec.ts
index 434c3fe..611a39f 100644
--- a/frontend/src/app/components/echo-sidebar/echo-sidebar.component.spec.ts
+++ b/frontend/src/app/components/echo-sidebar/echo-sidebar.component.spec.ts
@@ -35,26 +35,28 @@ describe('SidebarComponent', () => {
   });
 
   it('does not render Sections when permissions exclude it', () => {
-    permissionsService.permissions$.next(new Set(['nav:dashboard', 'nav:courses', 'nav:preferences']));
+    permissionsService.permissions$.next(new Set(['nav:workspace', 'nav:products', 'nav:settings']));
     permissionsService.ready$.next(true);
 
     fixture.detectChanges();
 
     const text = fixture.nativeElement.textContent;
-    expect(text).not.toContain('Sections');
+    expect(text).not.toContain('Cohorts');
   });
 
   it('renders navigation immediately when ready emits', () => {
-    permissionsService.permissions$.next(new Set(['nav:dashboard', 'nav:courses', 'nav:programs', 'nav:certifications', 'nav:preferences']));
+    permissionsService.permissions$.next(new Set(['nav:workspace', 'nav:projects', 'nav:product-studio', 'nav:products', 'nav:learners', 'nav:settings']));
     permissionsService.ready$.next(true);
 
     fixture.detectChanges();
 
     const text = fixture.nativeElement.textContent;
-    expect(text).toContain('Dashboard');
-    expect(text).toContain('Courses');
-    expect(text).toContain('Programs');
-    expect(text).toContain('Certifications');
+    expect(text).toContain('Workspace');
+    expect(text).toContain('Projects');
+    expect(text).toContain('Product Studio');
+    expect(text).toContain('Products');
+    expect(text).toContain('Learners');
+    expect(text).toContain('Settings');
   });
 
   it('renders loading state before readiness', () => {
@@ -63,24 +65,24 @@ describe('SidebarComponent', () => {
     fixture.detectChanges();
 
     expect(fixture.nativeElement.querySelector('[aria-label="sidenav-loading"]')).not.toBeNull();
-    expect(fixture.nativeElement.textContent).not.toContain('Dashboard');
+    expect(fixture.nativeElement.querySelector('a')).toBeNull();
   });
 
   it('keeps compact navigation usable when collapsed', () => {
     component.collapsed = true;
-    permissionsService.permissions$.next(new Set(['nav:dashboard']));
+    permissionsService.permissions$.next(new Set(['nav:workspace']));
     permissionsService.ready$.next(true);
 
     fixture.detectChanges();
 
     const firstLink = fixture.nativeElement.querySelector('a') as HTMLAnchorElement;
-    expect(firstLink.getAttribute('aria-label')).toBe('Dashboard');
-    expect(firstLink.getAttribute('title')).toBe('Dashboard');
+    expect(firstLink.getAttribute('aria-label')).toBe('Workspace');
+    expect(firstLink.getAttribute('title')).toBe('Workspace');
     expect(firstLink.textContent?.trim()).toBe('');
   });
 
   it('keeps important sidebar controls labeled for accessibility', () => {
-    permissionsService.permissions$.next(new Set(['nav:dashboard']));
+    permissionsService.permissions$.next(new Set(['nav:workspace']));
     permissionsService.ready$.next(true);
 
     fixture.detectChanges();
diff --git a/frontend/src/app/components/echo-sidebar/echo-sidebar.component.ts b/frontend/src/app/components/echo-sidebar/echo-sidebar.component.ts
index 7621f42..e2266dd 100644
--- a/frontend/src/app/components/echo-sidebar/echo-sidebar.component.ts
+++ b/frontend/src/app/components/echo-sidebar/echo-sidebar.component.ts
@@ -33,29 +33,29 @@ export class SidebarComponent {
 
   private readonly navSections: NavSection[] = [
     {
-      title: 'Overview',
+      title: 'Workspace',
       items: [
-        { label: 'Dashboard', route: '/home', icon: 'Home', permission: 'nav:dashboard' },
-        { label: 'Courses', route: '/home/courses', icon: 'Book', permission: 'nav:courses' },
-        { label: 'Programs', route: '/home/programs', icon: 'BookOpen', permission: 'nav:programs' },
-        { label: 'Certifications', route: '/home/certifications', icon: 'Award', permission: 'nav:certifications' },
+        { label: 'Workspace', route: '/workspace', icon: 'Home', permission: 'nav:workspace' },
+        { label: 'Projects', route: '/workspace/projects', icon: 'ClipboardList', permission: 'nav:projects' },
+        { label: 'Product Studio', route: '/workspace/product-studio', icon: 'BookOpen', permission: 'nav:product-studio' },
+        { label: 'Products', route: '/workspace/products', icon: 'Book', permission: 'nav:products' },
       ]
     },
     {
-      title: 'Reports & Admin',
+      title: 'Knowledge Ops',
       items: [
-        { label: 'Badges', route: '/home/admin/badges', icon: 'Award', permission: 'nav:admin-badges' },
-        { label: 'Users', route: '/home/admin/users', icon: 'User', permission: 'nav:admin-users' },
-        { label: 'Admin Courses', route: '/home/admin/courses', icon: 'ClipboardList', permission: 'nav:admin-courses' },
+        { label: 'Knowledge Sources', route: '/workspace/knowledge-sources', icon: 'BookOpen', permission: 'nav:knowledge-sources' },
+        { label: 'Artifacts', route: '/workspace/artifacts', icon: 'Award', permission: 'nav:artifacts' },
+        { label: 'Review Center', route: '/workspace/review-center', icon: 'ClipboardList', permission: 'nav:review-center' },
+        { label: 'Analytics', route: '/workspace/analytics', icon: 'SlidersHorizontal', permission: 'nav:analytics' },
       ]
     },
     {
-      title: 'Org & Studio',
+      title: 'People & Settings',
       items: [
-        { label: 'Invites', route: '/home/org/invites', icon: 'Mail', permission: 'nav:org-invites' },
-        { label: 'Studio Courses', route: '/home/studio/courses', icon: 'BookOpen', permission: 'nav:studio-courses' },
-        { label: 'Sections', route: '/home/sections', icon: 'Users', permission: 'nav:sections' },
-        { label: 'Preferences', route: '/home/me/preferences', icon: 'SlidersHorizontal', permission: 'nav:preferences' },
+        { label: 'Learners', route: '/workspace/learners', icon: 'User', permission: 'nav:learners' },
+        { label: 'Cohorts', route: '/workspace/learners/cohorts', icon: 'Users', permission: 'nav:cohorts' },
+        { label: 'Settings', route: '/workspace/settings', icon: 'SlidersHorizontal', permission: 'nav:settings' },
       ]
     },
   ];
diff --git a/frontend/src/app/pages/admin-courses/admin-courses.component.html b/frontend/src/app/pages/admin-courses/admin-courses.component.html
index 06729ec..8e5a940 100644
--- a/frontend/src/app/pages/admin-courses/admin-courses.component.html
+++ b/frontend/src/app/pages/admin-courses/admin-courses.component.html
@@ -1,10 +1,10 @@
 <div class="surface-card p-6">
   <div class="flex items-center justify-between mb-4">
     <div>
-      <p class="section-heading text-primary text-sm">Admin</p>
-      <h2 class="text-2xl font-bold text-ink">All Courses</h2>
+      <p class="section-heading text-primary text-sm">Products</p>
+      <h2 class="text-2xl font-bold text-ink">Course-backed products</h2>
     </div>
-    <button class="px-3 py-2 rounded-xl bg-primary text-white text-sm font-semibold" (click)="goToCreateCourse()">Create Course</button>
+    <button class="px-3 py-2 rounded-xl bg-primary text-white text-sm font-semibold" (click)="goToCreateCourse()">Create Product</button>
   </div>
   <table class="w-full text-sm">
     <thead class="bg-slate-50 text-slate-600">
diff --git a/frontend/src/app/pages/available-courses/available-courses.component.html b/frontend/src/app/pages/available-courses/available-courses.component.html
index 7590c54..9b2b590 100644
--- a/frontend/src/app/pages/available-courses/available-courses.component.html
+++ b/frontend/src/app/pages/available-courses/available-courses.component.html
@@ -2,8 +2,8 @@
   <div class="flex items-center justify-between mb-4">
     <div>
       <p class="section-heading text-primary text-sm">Catalog</p>
-      <h2 class="text-2xl font-bold text-ink">Available Courses</h2>
-      <p class="muted-text">Enroll learners in culturally grounded, age-scaled content.</p>
+      <h2 class="text-2xl font-bold text-ink">Available Products</h2>
+      <p class="muted-text">Enroll learners in course-backed knowledge products and guided learning experiences.</p>
     </div>
     <span class="badge-soft">Open enrollment</span>
   </div>
diff --git a/frontend/src/app/pages/home/home.component.html b/frontend/src/app/pages/home/home.component.html
index 1a5abcf..1313cdf 100644
--- a/frontend/src/app/pages/home/home.component.html
+++ b/frontend/src/app/pages/home/home.component.html
@@ -27,8 +27,8 @@
           <div *ngIf="!lessonMode" class="max-w-7xl mx-auto">
             <div class="mb-4 surface-card flex flex-wrap items-center justify-between gap-3 p-4 md:p-5">
               <div>
-                <p class="text-xs uppercase tracking-[0.25em] text-primary">Demo Mode: K-5 African & African-American History</p>
-                <p class="text-sm text-slate-700">Guide stakeholders through landing -> login -> dashboards -> lessons -> admin.</p>
+                <p class="text-xs uppercase tracking-[0.25em] text-primary">Workspace: AI-powered knowledge products</p>
+                <p class="text-sm text-slate-700">Use the V2 shell to move between products, learner delivery, review workflows, and platform settings.</p>
               </div>
               <button (click)="startDemoTour()" class="px-4 py-2 bg-primary text-white rounded-full shadow-soft-card text-sm font-semibold transition hover:-translate-y-0.5 hover:bg-secondary">
                 Start Demo Tour
diff --git a/frontend/src/app/pages/studio-courses/studio-courses.component.html b/frontend/src/app/pages/studio-courses/studio-courses.component.html
index bd5050f..5b30f4b 100644
--- a/frontend/src/app/pages/studio-courses/studio-courses.component.html
+++ b/frontend/src/app/pages/studio-courses/studio-courses.component.html
@@ -1,13 +1,13 @@
 <div class="p-6 space-y-6">
   <div class="flex flex-col gap-2">
-    <h2 class="text-2xl font-bold text-ink">Content studio</h2>
-    <p class="text-sm text-slate-600">Create draft courses and manage published learning paths.</p>
+    <h2 class="text-2xl font-bold text-ink">Product studio</h2>
+    <p class="text-sm text-slate-600">Create course-backed product drafts and manage published learning paths.</p>
   </div>
 
   <div class="surface-card p-6 space-y-4">
-    <h3 class="text-lg font-semibold text-ink">New course draft</h3>
+    <h3 class="text-lg font-semibold text-ink">New product draft</h3>
     <div class="grid grid-cols-1 md:grid-cols-3 gap-4">
-      <input class="border border-slate-200 rounded-xl px-3 py-2" [(ngModel)]="title" placeholder="Course title" />
+      <input class="border border-slate-200 rounded-xl px-3 py-2" [(ngModel)]="title" placeholder="Product title" />
       <input class="border border-slate-200 rounded-xl px-3 py-2" [(ngModel)]="description" placeholder="Short description" />
       <button class="bg-primary text-white rounded-xl px-4 py-2 font-semibold" (click)="createCourse()">Create draft</button>
     </div>
@@ -15,10 +15,10 @@ <h3 class="text-lg font-semibold text-ink">New course draft</h3>
 
   <div class="surface-card p-6">
     <div class="flex items-center justify-between mb-4">
-      <h3 class="text-lg font-semibold text-ink">Course library</h3>
+      <h3 class="text-lg font-semibold text-ink">Product library</h3>
       <span class="text-xs text-slate-500">Drafts + published</span>
     </div>
-    <div *ngIf="courses.length === 0" class="text-sm text-slate-500">No courses yet. Start with a draft above.</div>
+    <div *ngIf="courses.length === 0" class="text-sm text-slate-500">No products yet. Start with a draft above.</div>
     <div class="grid grid-cols-1 md:grid-cols-2 gap-4" *ngIf="courses.length > 0">
       <div *ngFor="let course of courses" class="border border-slate-200 rounded-2xl p-4 bg-white">
         <h4 class="text-lg font-semibold text-ink">{{ course.title }}</h4>
diff --git a/frontend/src/app/pages/v2-platform/v2-platform-page.component.ts b/frontend/src/app/pages/v2-platform/v2-platform-page.component.ts
new file mode 100644
index 0000000..9e4d75a
--- /dev/null
+++ b/frontend/src/app/pages/v2-platform/v2-platform-page.component.ts
@@ -0,0 +1,128 @@
+import { CommonModule } from '@angular/common';
+import { Component, inject } from '@angular/core';
+import { ActivatedRoute, RouterModule } from '@angular/router';
+import { map } from 'rxjs';
+
+interface V2PlatformLink {
+  label: string;
+  route: string;
+}
+
+interface V2PlatformPageData {
+  eyebrow: string;
+  title: string;
+  description: string;
+  status: string;
+  links?: V2PlatformLink[];
+}
+
+@Component({
+  selector: 'app-v2-platform-page',
+  standalone: true,
+  imports: [CommonModule, RouterModule],
+  template: `
+    <section class="v2-page" *ngIf="page$ | async as page" aria-labelledby="v2-platform-title">
+      <div class="v2-page__hero">
+        <p class="v2-page__eyebrow">{{ page.eyebrow }}</p>
+        <h1 id="v2-platform-title">{{ page.title }}</h1>
+        <p class="v2-page__description">{{ page.description }}</p>
+        <p class="v2-page__status" role="status">{{ page.status }}</p>
+      </div>
+
+      <div class="v2-page__actions" *ngIf="page.links?.length">
+        <a
+          *ngFor="let link of page.links"
+          class="v2-page__link"
+          [routerLink]="link.route"
+        >
+          {{ link.label }}
+        </a>
+      </div>
+    </section>
+  `,
+  styles: [`
+    .v2-page {
+      display: grid;
+      gap: 1rem;
+      padding: clamp(1rem, 3vw, 2rem);
+    }
+
+    .v2-page__hero {
+      border: 1px solid rgba(15, 23, 42, 0.1);
+      border-radius: 1.5rem;
+      background:
+        radial-gradient(circle at top right, rgba(14, 116, 144, 0.16), transparent 34rem),
+        linear-gradient(135deg, #ffffff 0%, #f8fafc 100%);
+      box-shadow: 0 20px 45px rgba(15, 23, 42, 0.08);
+      color: #0f172a;
+      padding: clamp(1.5rem, 4vw, 3rem);
+    }
+
+    .v2-page__eyebrow {
+      color: #0e7490;
+      font-size: 0.78rem;
+      font-weight: 800;
+      letter-spacing: 0.22em;
+      margin: 0 0 0.75rem;
+      text-transform: uppercase;
+    }
+
+    h1 {
+      font-size: clamp(1.75rem, 4vw, 3rem);
+      font-weight: 900;
+      letter-spacing: -0.04em;
+      line-height: 1;
+      margin: 0;
+    }
+
+    .v2-page__description {
+      color: #334155;
+      font-size: clamp(1rem, 2vw, 1.15rem);
+      line-height: 1.7;
+      margin: 1rem 0 0;
+      max-width: 68ch;
+    }
+
+    .v2-page__status {
+      border-left: 4px solid #0e7490;
+      color: #164e63;
+      font-weight: 700;
+      margin: 1.25rem 0 0;
+      padding-left: 0.85rem;
+    }
+
+    .v2-page__actions {
+      display: flex;
+      flex-wrap: wrap;
+      gap: 0.75rem;
+    }
+
+    .v2-page__link {
+      align-items: center;
+      background: #0f172a;
+      border-radius: 999px;
+      color: #ffffff;
+      display: inline-flex;
+      font-weight: 800;
+      min-height: 2.75rem;
+      padding: 0.75rem 1.1rem;
+      text-decoration: none;
+      transition: background 160ms ease, transform 160ms ease;
+    }
+
+    .v2-page__link:hover,
+    .v2-page__link:focus-visible {
+      background: #0e7490;
+      outline: 3px solid rgba(14, 116, 144, 0.25);
+      outline-offset: 3px;
+      transform: translateY(-1px);
+    }
+  `]
+})
+export class V2PlatformPageComponent {
+  private readonly route = inject(ActivatedRoute);
+
+  readonly page$ = this.route.data.pipe(
+    map(data => data as V2PlatformPageData)
+  );
+}
diff --git a/frontend/src/app/services/permissions.service.ts b/frontend/src/app/services/permissions.service.ts
index a0a8ab8..5fb9b32 100644
--- a/frontend/src/app/services/permissions.service.ts
+++ b/frontend/src/app/services/permissions.service.ts
@@ -244,6 +244,19 @@ export class PermissionsService {
     permissions.add('nav:programs');
     permissions.add('nav:certifications');
     permissions.add('nav:preferences');
+    permissions.add('nav:workspace');
+    permissions.add('nav:products');
+    permissions.add('nav:learners');
+    permissions.add('nav:settings');
+
+    if (this.hasRole(roleSet, ['admin', 'teacher', 'content_admin', 'org_admin', 'instructor'])) {
+      permissions.add('nav:projects');
+      permissions.add('nav:product-studio');
+      permissions.add('nav:knowledge-sources');
+      permissions.add('nav:artifacts');
+      permissions.add('nav:review-center');
+      permissions.add('nav:analytics');
+    }
 
     if (this.hasRole(roleSet, ['admin'])) {
       permissions.add('nav:admin-badges');
@@ -258,6 +271,7 @@ export class PermissionsService {
 
     if (this.hasRole(roleSet, ['teacher', 'org_admin', 'instructor'])) {
       permissions.add('nav:sections');
+      permissions.add('nav:cohorts');
     }
 
     return permissions;
diff --git a/openspec/changes/echoed-v2-platform-evolution/design.md b/openspec/changes/echoed-v2-platform-evolution/design.md
new file mode 100644
index 0000000..5acf580
--- /dev/null
+++ b/openspec/changes/echoed-v2-platform-evolution/design.md
@@ -0,0 +1,227 @@
+# Design: EchoEd V2 Platform Evolution
+
+## Target Architecture
+
+EchoEd V2 SHALL add a platform layer above the existing education runtime:
+
+```text
+Workspace
+  -> Project
+    -> Knowledge Sources
+    -> Knowledge Graph
+    -> AI Analysis
+    -> Generation Runs
+    -> Artifacts
+    -> Products
+      -> Existing Education Runtime
+        -> Course
+          -> Unit
+            -> Lesson
+              -> Activity
+      -> Learner Portal
+      -> Analytics
+```
+
+The existing education engine remains the delivery layer. New V2 concepts organize knowledge ingestion, generation, packaging, publishing, access, and continuous improvement.
+
+## Current Architecture Preservation Strategy
+
+EchoEd SHALL preserve:
+
+- existing SQLAlchemy runtime models
+- existing FastAPI route families
+- existing progress semantics
+- existing lesson governance and readiness rules
+- existing assessment and certification behavior
+- existing auth, role, and organization behavior
+
+The V2 platform layer SHALL be additive. New objects reference current runtime objects instead of duplicating them.
+
+### Why
+
+The current runtime already solves hard education problems: governed delivery, progress, assessments, certifications, organizations, sections, and role-aware behavior. Replacing these systems would introduce unnecessary risk.
+
+### Problem Solved
+
+The current app lacks a unifying platform model for AI-generated technical knowledge products. Wrappers create that model without disturbing delivery.
+
+### Existing Functionality Reused
+
+Organizations, memberships, courses, programs, lessons, sources, progress, assessments, certifications, sections, and analytics.
+
+### Migration Required
+
+Add new tables and route aliases first. Backfill wrapper records later. Keep existing APIs live during migration.
+
+### Future Capabilities Unlocked
+
+Product packaging, source-aware generation, artifact review, memberships, checkout readiness, enterprise knowledge projects, and source coverage analytics.
+
+## Navigation Migration
+
+Target global navigation:
+
+```text
+Workspace
+Projects
+Product Studio
+Products
+Knowledge Sources
+Artifacts
+Review Center
+Learners
+Analytics
+Settings
+```
+
+Existing page mapping:
+
+| V2 Area | Existing Surface | Migration Strategy |
+|---|---|---|
+| Workspace | user dashboard, org context, preferences | Add workspace shell and route aliases |
+| Projects | new placeholder | Add empty-state placeholder in Phase 1 |
+| Product Studio | course wizard, studio courses | Rename and route existing authoring surface |
+| Products | admin courses, available courses, programs | Product terminology first, wrapper model later |
+| Knowledge Sources | lesson sources, uploads | Placeholder first, model in Phase 2 |
+| Artifacts | generated outputs, media/uploads | Placeholder first, registry in Phase 2/4 |
+| Review Center | lesson governance, readiness | Placeholder first, queue later |
+| Learners | users, student courses, sections | Rename surfaces gradually |
+| Analytics | current analytics | Add V2 dashboard later |
+| Settings | preferences, org invites, admin users | Consolidate over time |
+
+## Route Migration
+
+Phase 1 route aliases:
+
+```text
+/workspace
+/workspace/projects
+/workspace/product-studio
+/workspace/products
+/workspace/knowledge-sources
+/workspace/artifacts
+/workspace/review-center
+/workspace/learners
+/workspace/analytics
+/workspace/settings
+/learn
+/learn/products
+/learn/paths
+/learn/resources
+/learn/certificates
+```
+
+Existing `/home` routes SHALL remain functional. Route aliases MAY render current components while labels and navigation move toward V2 terminology.
+
+## Domain Model Evolution
+
+New platform concepts:
+
+- `Workspace`: top-level operating context, initially backed by existing organizations.
+- `Project`: groups sources, analysis, artifacts, and products.
+- `KnowledgeSource`: reusable source asset used for analysis, generation, and citations.
+- `KnowledgeGraph`: structured representation of source relationships and concepts.
+- `AIAnalysis`: persisted understanding of sources or projects.
+- `GenerationRun`: auditable AI generation event.
+- `Artifact`: generated or uploaded reviewable output.
+- `Product`: package users can access, learn from, download, or eventually buy.
+- `LearningPath`: productized sequence that may wrap existing programs.
+- `Learner`: product-facing identity around existing users/students.
+- `AccessGrant`: explicit permission to access a product or resource.
+- `ReviewCenter`: workflow surface for lessons, artifacts, products, and generated drafts.
+
+## Data Model Strategy
+
+All model additions SHALL be additive.
+
+Recommended migration order:
+
+1. `workspaces`
+2. `projects`
+3. `products`
+4. `knowledge_sources`
+5. `artifacts`
+6. `generation_runs`
+7. `access_grants`
+8. `review_requests`
+9. `analytics_events`
+
+Backfill strategy:
+
+- create one workspace per organization
+- create default projects for existing organizations or course collections
+- create one product per existing course
+- optionally create product wrappers for programs
+- link existing lesson sources to knowledge sources without deleting original source rows
+
+## Backend Impact
+
+New route families MAY be added when no existing route owns the new domain:
+
+```text
+/api/workspaces
+/api/projects
+/api/products
+/api/knowledge-sources
+/api/artifacts
+/api/generation-runs
+/api/review-center
+/api/access-grants
+/api/analytics/v2
+```
+
+Existing route families SHALL remain authoritative for current runtime behavior:
+
+```text
+/api/courses
+/api/units
+/api/lessons
+/api/activities
+/api/programs
+/api/progress
+/api/start-course
+/api/assessments
+/api/certifications
+/api/orgs
+/api/auth
+```
+
+## Frontend Impact
+
+The frontend SHALL evolve by composition:
+
+- add V2 navigation labels
+- add route aliases
+- reuse current shell, guards, services, and pages
+- embed existing Course Wizard inside Product Studio
+- reframe student dashboard as Learner Portal over time
+- reframe admin/teacher surfaces as Workspace and Product operations
+
+Phase 1 SHALL not require backend model changes.
+
+## Risk Mitigation
+
+| Risk | Mitigation |
+|---|---|
+| Runtime regression | Keep Course/Unit/Lesson/progress APIs unchanged |
+| Navigation confusion | Add aliases before removing old labels |
+| Product abstraction too broad | Start with course-backed products only |
+| AI trust issues | Generated outputs remain draft artifacts until reviewed |
+| Source migration loses citations | Link/copy sources without deleting original rows |
+| Payment scope creep | Build access grants before checkout |
+| Overbuilt enterprise features | Defer advanced permissions and billing |
+
+## Phase-Based Rollout
+
+1. Workspace shell and navigation reframe
+2. Wrapper models for Workspace, Project, Product, Artifact, KnowledgeSource, GenerationRun
+3. Product Studio foundation
+4. Knowledge pipeline and artifact registry
+5. Review Center expansion
+6. Learner Portal V2
+7. Access grants
+8. Analytics V2
+9. Commercialization readiness
+
+Each phase SHALL preserve the existing education runtime and include migration notes, tests, and operational validation.
+
diff --git a/openspec/changes/echoed-v2-platform-evolution/proposal.md b/openspec/changes/echoed-v2-platform-evolution/proposal.md
new file mode 100644
index 0000000..479f1b5
--- /dev/null
+++ b/openspec/changes/echoed-v2-platform-evolution/proposal.md
@@ -0,0 +1,153 @@
+# EchoEd V2 Platform Evolution
+
+## Why
+
+EchoEd has outgrown the shape of a course-first educational application. The platform already has mature runtime infrastructure: organizations, authentication, roles and permissions, courses, units, lessons, activities, programs, sections, learner progress, assessments, certifications, lesson governance, source-backed lesson readiness, and multi-tenant behavior. Those systems are valuable and SHALL remain the runtime foundation.
+
+The next evolution is to organize EchoEd around the full knowledge-to-learning lifecycle:
+
+```text
+Knowledge
+-> AI Understanding
+-> Generation
+-> Governance
+-> Publishing
+-> Learning
+-> Analytics
+-> Continuous Improvement
+```
+
+EchoEd V2 adds a platform layer above the current education engine so organizations can transform internal, technical, or expert knowledge into trusted learning products. This creates a clearer product architecture without replacing the existing education runtime.
+
+## Why This Is Not A Rewrite
+
+This change explicitly preserves:
+
+- `Course`
+- `Unit`
+- `Lesson`
+- `Activity`
+- `Program`
+- `Assessment`
+- `Certification`
+- progress tracking
+- governance
+- source-backed lesson readiness
+- current auth, organization, and role infrastructure
+- existing APIs wherever practical
+
+V2 introduces wrapper and orchestration concepts above those systems:
+
+```text
+Workspace
+-> Project
+-> Knowledge Sources
+-> AI Analysis
+-> Generation Runs
+-> Artifacts
+-> Products
+-> Existing Education Runtime
+-> Learner Portal
+-> Analytics
+```
+
+The guiding architectural rule is: wrap working systems, do not replace them.
+
+## What Problem The V2 Platform Layer Solves
+
+EchoEd currently has strong educational primitives but lacks a canonical platform model for:
+
+- grouping knowledge work into workspaces and projects
+- treating source material as durable, reusable knowledge assets
+- tracking AI analysis and generation runs
+- reviewing generated artifacts before they become published lessons or products
+- packaging existing courses, programs, downloads, and future membership hubs as products
+- granting learner/member access independently from payments
+- organizing analytics around product, source, artifact, and learner outcomes
+
+The V2 layer solves these gaps by introducing stable platform concepts above the existing course runtime.
+
+## Product Positioning
+
+EchoEd should become:
+
+> The AI-native platform that transforms organizational knowledge into trusted learning products.
+
+EchoEd should borrow structural organization patterns from Teachable, GitBook, Notion, Atlassian, GitHub, and OpenAI while preserving its own identity: AI-assisted learning, source-aware knowledge, guided content creation, governed publishing, and structured educational delivery.
+
+EchoEd is not another LMS. It is the operating system for technical knowledge.
+
+## Teachable-Inspired, Not Teachable-Cloned
+
+Teachable is useful as a reference for packaging: products, creator dashboard, checkout readiness, student experience, analytics, certificates, memberships, admin controls, and product pages.
+
+EchoEd should adapt those platform patterns for a more technical and AI-native workflow:
+
+- source material enters through projects and knowledge sources
+- AI analysis creates structured understanding
+- generation runs produce artifacts and drafts
+- review center protects trust and governance
+- products package courses, paths, artifacts, and resources
+- learners consume governed, source-backed learning experiences
+- analytics drive continuous improvement
+
+## Capabilities
+
+### New Capabilities
+
+- `workspace-platform-foundation`
+- `project-knowledge-pipeline`
+- `product-studio`
+- `product-catalog`
+- `artifact-registry`
+- `review-center`
+- `learner-portal-v2`
+- `access-grants`
+- `analytics-v2`
+
+### Existing Capabilities Preserved
+
+- course and lesson runtime
+- governed learner delivery
+- progress and course completion
+- assessment and certification flows
+- organization and role foundations
+- source-backed lesson readiness
+
+## Phase 1 Scope
+
+Phase 1 SHALL be low-risk and non-destructive. It focuses only on:
+
+- V2 navigation
+- route aliases
+- workspace shell
+- product terminology
+- mapping existing pages into the new platform structure
+- placeholder routes for future concepts
+
+Phase 1 SHALL NOT introduce database migrations, runtime rewrites, auth changes, progress changes, payment flows, or new AI generation behavior.
+
+## Impact
+
+### Backend
+
+V2 eventually adds wrapper models and APIs for workspaces, projects, products, knowledge sources, artifacts, generation runs, access grants, and analytics. Existing course, lesson, progress, assessment, certification, auth, and organization APIs remain available.
+
+### Frontend
+
+The frontend evolves navigation and information architecture first. Existing pages are remapped into the new structure before new workflows are built.
+
+### Data
+
+Existing records are migrated forward through additive backfills:
+
+- organizations can become workspaces
+- courses can be wrapped as products
+- programs can become learning paths or product bundles
+- lesson sources can be linked into knowledge sources
+- generated drafts can become artifacts
+
+### Testing
+
+Each phase SHALL include regression coverage for current runtime behavior plus targeted coverage for the new wrapper behavior introduced in that phase.
+
diff --git a/openspec/changes/echoed-v2-platform-evolution/specs/access-grants/spec.md b/openspec/changes/echoed-v2-platform-evolution/specs/access-grants/spec.md
new file mode 100644
index 0000000..107f345
--- /dev/null
+++ b/openspec/changes/echoed-v2-platform-evolution/specs/access-grants/spec.md
@@ -0,0 +1,41 @@
+# access-grants Specification
+
+## ADDED Requirements
+
+### Requirement: AccessGrant SHALL decouple product access from payments
+EchoEd SHALL introduce AccessGrant as the explicit record that allows a user, learner, team, organization, or membership to access a product, course, program, artifact, or resource.
+
+#### Scenario: Existing enrollment creates product access
+- **WHEN** a learner is enrolled in a course-backed product
+- **THEN** EchoEd can represent that access as an access grant while preserving the existing enrollment/progress records
+
+#### Acceptance Criteria
+- Access grants do not replace current enrollment in the first migration.
+- Access grants can be backfilled from existing enrollments.
+- Access grants do not weaken existing auth or role rules.
+
+### Requirement: Access grants SHALL prepare EchoEd for commercialization
+AccessGrant SHALL become the foundation for future checkout, memberships, subscriptions, bundles, and enterprise entitlements.
+
+#### Scenario: Product is sold later
+- **WHEN** a future checkout succeeds
+- **THEN** the checkout system grants access by creating or updating AccessGrant records
+
+#### Acceptance Criteria
+- Payment provider state remains separate from auth state.
+- Product access can be tested without payment integration.
+
+## MODIFIED Requirements
+
+### Requirement: Existing role permissions SHALL remain authoritative
+Access grants SHALL not override workspace administration, authoring, governance, or organization permission checks.
+
+#### Scenario: Learner has product access but no authoring role
+- **WHEN** a learner has access to a product
+- **THEN** the learner can consume permitted learning content
+- **AND** cannot access creator/admin authoring routes without existing role permission
+
+#### Acceptance Criteria
+- Role-based route guards remain enforced.
+- Backend permission checks remain enforced.
+
diff --git a/openspec/changes/echoed-v2-platform-evolution/specs/analytics-v2/spec.md b/openspec/changes/echoed-v2-platform-evolution/specs/analytics-v2/spec.md
new file mode 100644
index 0000000..d6348dc
--- /dev/null
+++ b/openspec/changes/echoed-v2-platform-evolution/specs/analytics-v2/spec.md
@@ -0,0 +1,51 @@
+# analytics-v2 Specification
+
+## ADDED Requirements
+
+### Requirement: Analytics V2 SHALL report on products, sources, artifacts, reviews, and learners
+EchoEd SHALL add analytics organized around the V2 platform lifecycle.
+
+Analytics V2 SHALL support:
+
+- product engagement
+- learner progress
+- source coverage
+- artifact generation and review activity
+- review cycle time
+- product completion
+- assessment outcomes
+- certificate issuance
+
+#### Scenario: Creator opens product analytics
+- **WHEN** a creator opens analytics for a product
+- **THEN** EchoEd shows learner progress, completion, review state, source coverage, and related artifact activity where available
+
+#### Acceptance Criteria
+- Existing progress, assessment, and certification analytics are reused.
+- Missing V2 event data is represented as unavailable rather than fabricated.
+- Analytics do not mutate runtime data.
+
+### Requirement: Analytics events SHALL support continuous improvement
+EchoEd SHALL track platform events needed to identify stale knowledge, low-completion products, review bottlenecks, and source coverage gaps.
+
+#### Scenario: Source-backed product has weak source coverage
+- **WHEN** a product uses generated or source-backed content with incomplete source coverage
+- **THEN** Analytics V2 can surface a source coverage warning for creators
+
+#### Acceptance Criteria
+- Source coverage signals are advisory unless governance rules require blocking.
+- Analytics can reference knowledge sources, artifacts, products, and lessons.
+
+## MODIFIED Requirements
+
+### Requirement: Existing analytics SHALL remain compatible
+Existing analytics routes and reporting behavior SHALL remain available while V2 analytics is added.
+
+#### Scenario: Current educator dashboard loads analytics
+- **WHEN** an existing dashboard requests current analytics data
+- **THEN** EchoEd returns the same supported response shape
+
+#### Acceptance Criteria
+- Current analytics tests remain valid.
+- V2 analytics is additive.
+
diff --git a/openspec/changes/echoed-v2-platform-evolution/specs/artifact-registry/spec.md b/openspec/changes/echoed-v2-platform-evolution/specs/artifact-registry/spec.md
new file mode 100644
index 0000000..a493052
--- /dev/null
+++ b/openspec/changes/echoed-v2-platform-evolution/specs/artifact-registry/spec.md
@@ -0,0 +1,53 @@
+# artifact-registry Specification
+
+## ADDED Requirements
+
+### Requirement: Artifacts SHALL represent generated or uploaded knowledge outputs
+EchoEd SHALL introduce Artifact as a durable, reviewable output produced by AI generation, manual upload, or authoring workflows.
+
+Artifact types MAY include:
+
+- outline
+- documentation page
+- lesson draft
+- course draft
+- playbook
+- checklist
+- download pack
+- quiz draft
+- source summary
+- implementation guide
+
+#### Scenario: AI generates a draft lesson artifact
+- **WHEN** a generation run creates a lesson draft
+- **THEN** EchoEd stores the output as an artifact before it becomes a learner-facing lesson
+
+#### Acceptance Criteria
+- Artifacts default to draft or review-required state.
+- Artifacts do not become learner-deliverable without review or explicit publishing.
+- Artifacts can reference sources and generation runs.
+
+### Requirement: Artifact registry SHALL support packaging and review
+The artifact registry SHALL let creators inspect, review, attach, publish, or package artifacts.
+
+#### Scenario: Creator reviews artifact
+- **WHEN** a creator opens an artifact
+- **THEN** EchoEd shows artifact content, source references, generation metadata, review state, and attachment targets
+
+#### Acceptance Criteria
+- Artifact inspection does not alter course runtime behavior.
+- Downloadable resources can be represented by artifacts in later phases.
+
+## MODIFIED Requirements
+
+### Requirement: Uploaded media and generated docs SHALL be eligible artifact sources
+Existing upload/media behavior SHALL remain available and MAY be wrapped as artifacts where useful.
+
+#### Scenario: Existing uploaded resource is attached to product
+- **WHEN** a creator attaches an uploaded resource to a product
+- **THEN** EchoEd can represent the attachment as an artifact/resource without changing the original upload path
+
+#### Acceptance Criteria
+- Existing upload tests remain valid.
+- Artifact wrapping is additive.
+
diff --git a/openspec/changes/echoed-v2-platform-evolution/specs/learner-portal-v2/spec.md b/openspec/changes/echoed-v2-platform-evolution/specs/learner-portal-v2/spec.md
new file mode 100644
index 0000000..f8d76c7
--- /dev/null
+++ b/openspec/changes/echoed-v2-platform-evolution/specs/learner-portal-v2/spec.md
@@ -0,0 +1,40 @@
+# learner-portal-v2 Specification
+
+## ADDED Requirements
+
+### Requirement: Learner Portal SHALL organize access around products
+EchoEd SHALL evolve the current student dashboard into Learner Portal V2, where learners see products, learning paths, resources, downloads, progress, and completion artifacts.
+
+#### Scenario: Learner opens portal
+- **WHEN** a learner opens the V2 learner portal
+- **THEN** EchoEd shows accessible products and the current next learning action
+
+#### Acceptance Criteria
+- Existing student course progress remains visible.
+- Existing governed lesson start/continue behavior remains intact.
+- Existing certificates remain visible.
+
+### Requirement: Learner Portal SHALL support member-style access over time
+Learner Portal SHALL support future membership and subscription access without requiring a new learner runtime.
+
+#### Scenario: Learner has access to multiple product types
+- **WHEN** a learner has access to a course-backed product, learning path, and downloadable artifact
+- **THEN** EchoEd presents them in one learner portal experience
+
+#### Acceptance Criteria
+- Access display can be backed by current enrollments first.
+- Access grants can replace or augment enrollment lookup in later phases.
+
+## MODIFIED Requirements
+
+### Requirement: Student-facing language SHALL migrate toward learner/member language
+Existing student behavior SHALL be preserved while V2 UI language shifts toward learner and member concepts.
+
+#### Scenario: Existing student starts a lesson
+- **WHEN** a student uses the V2 learner portal to continue a course
+- **THEN** EchoEd uses the same governed course runtime and progress APIs currently used by the student dashboard
+
+#### Acceptance Criteria
+- No parallel progress tracking is introduced.
+- Existing smoke tests remain valid.
+
diff --git a/openspec/changes/echoed-v2-platform-evolution/specs/product-catalog/spec.md b/openspec/changes/echoed-v2-platform-evolution/specs/product-catalog/spec.md
new file mode 100644
index 0000000..bbe27a1
--- /dev/null
+++ b/openspec/changes/echoed-v2-platform-evolution/specs/product-catalog/spec.md
@@ -0,0 +1,49 @@
+# product-catalog Specification
+
+## ADDED Requirements
+
+### Requirement: Product SHALL wrap existing runtime objects
+EchoEd SHALL introduce Product as the package-level object above existing education runtime objects.
+
+Supported initial product backing types:
+
+- Course
+- Program or Learning Path
+- Artifact or Download
+- Future membership hub
+- Future coaching or review session
+
+#### Scenario: Existing course appears as product
+- **WHEN** an existing course is migrated into V2
+- **THEN** a course-backed product represents it in the product catalog
+- **AND** the original course, units, lessons, activities, and progress records remain unchanged
+
+#### Acceptance Criteria
+- Every existing course can be represented by a product.
+- Existing `/api/courses` behavior remains intact.
+- Product catalog can link to existing course management pages during migration.
+
+### Requirement: Product catalog SHALL become the creator-facing inventory
+The V2 product catalog SHALL show products, status, type, backing object, review state, access state, and publishing readiness.
+
+#### Scenario: Creator reviews products
+- **WHEN** a creator opens Products
+- **THEN** EchoEd shows course-backed products and future product types in one inventory
+
+#### Acceptance Criteria
+- Admin Courses can be remapped into Products without deleting the old route.
+- Product terminology is introduced before replacing underlying models.
+
+## MODIFIED Requirements
+
+### Requirement: Programs SHALL be repositioned as learning paths
+Existing programs SHALL be visible as learning paths or product bundles in V2 while preserving current program behavior.
+
+#### Scenario: Learner views program-backed product
+- **WHEN** a learner opens a program-backed product
+- **THEN** EchoEd can reuse existing Program, ProgramCourse, progress, assessment, and certification behavior
+
+#### Acceptance Criteria
+- Existing program routes remain compatible.
+- Program progress remains intact.
+
diff --git a/openspec/changes/echoed-v2-platform-evolution/specs/product-studio/spec.md b/openspec/changes/echoed-v2-platform-evolution/specs/product-studio/spec.md
new file mode 100644
index 0000000..77548e6
--- /dev/null
+++ b/openspec/changes/echoed-v2-platform-evolution/specs/product-studio/spec.md
@@ -0,0 +1,55 @@
+# product-studio Specification
+
+## ADDED Requirements
+
+### Requirement: Product Studio SHALL become the flagship creator workflow
+EchoEd SHALL introduce Product Studio as the primary guided workflow for creating, generating, reviewing, approving, publishing, and delivering learning products.
+
+#### Scenario: Creator starts a product
+- **WHEN** a creator opens Product Studio
+- **THEN** EchoEd presents a product creation workflow that starts with product type and can reuse the existing course creation path
+
+#### Acceptance Criteria
+- Existing course wizard behavior remains available.
+- Product Studio can initially support only course-backed products.
+- Product Studio does not bypass lesson governance or readiness.
+
+### Requirement: Product Studio SHALL follow the V2 creation sequence
+Product Studio SHALL organize creation around:
+
+```text
+Create Product
+-> Choose Product Type
+-> Connect Project
+-> Import Knowledge Sources
+-> Analyze
+-> Generate
+-> Review
+-> Approve
+-> Publish
+-> Deliver
+```
+
+#### Scenario: Phase 1 route exists before all steps are implemented
+- **WHEN** a user opens Product Studio during Phase 1
+- **THEN** implemented steps route to existing authoring surfaces
+- **AND** unavailable future steps show clear placeholder states
+
+#### Acceptance Criteria
+- Placeholders do not create fake data.
+- Current course creation remains functional.
+- Future phases can replace placeholders incrementally.
+
+## MODIFIED Requirements
+
+### Requirement: Course wizard SHALL be embedded rather than replaced
+The current course wizard SHALL be reused as the first Product Studio implementation path.
+
+#### Scenario: Creator edits an existing course
+- **WHEN** a creator edits a course-backed product
+- **THEN** EchoEd can route into the existing course wizard with product-aware context
+
+#### Acceptance Criteria
+- Existing course create/edit tests remain valid.
+- Existing course APIs remain valid.
+
diff --git a/openspec/changes/echoed-v2-platform-evolution/specs/project-knowledge-pipeline/spec.md b/openspec/changes/echoed-v2-platform-evolution/specs/project-knowledge-pipeline/spec.md
new file mode 100644
index 0000000..bc93271
--- /dev/null
+++ b/openspec/changes/echoed-v2-platform-evolution/specs/project-knowledge-pipeline/spec.md
@@ -0,0 +1,42 @@
+# project-knowledge-pipeline Specification
+
+## ADDED Requirements
+
+### Requirement: Projects SHALL group knowledge, generation, artifacts, and products
+EchoEd SHALL introduce Project as the V2 container for knowledge sources, AI analysis, generation runs, artifacts, and products.
+
+#### Scenario: Creator opens an empty project
+- **WHEN** a creator opens a project with no sources
+- **THEN** EchoEd shows an empty project state oriented around importing knowledge sources and creating products
+
+#### Acceptance Criteria
+- Projects belong to a workspace.
+- Projects can exist before products are created.
+- Projects do not replace courses.
+
+### Requirement: Knowledge pipeline SHALL preserve source traceability
+Knowledge moving through projects SHALL retain traceability from source to analysis, artifact, product, and learner-facing content.
+
+#### Scenario: Artifact is generated from sources
+- **WHEN** a generation run produces an artifact from selected knowledge sources
+- **THEN** the artifact records which sources contributed to the output
+
+#### Acceptance Criteria
+- Existing lesson `Source` rows remain valid.
+- Future `KnowledgeSource` records can link to existing lesson sources.
+- No source-backed readiness behavior is weakened.
+
+## MODIFIED Requirements
+
+### Requirement: Lesson sources SHALL become reusable knowledge assets over time
+Existing lesson-bound sources SHALL be eligible for mapping into project-level knowledge sources without deleting original source records.
+
+#### Scenario: Existing course is wrapped by a project
+- **WHEN** an existing course is associated with a project
+- **THEN** its lesson sources can be surfaced as project knowledge sources
+- **AND** lesson readiness continues to evaluate against the original lesson source data until migration is complete
+
+#### Acceptance Criteria
+- Existing lesson readiness tests remain green.
+- Source migration is additive.
+
diff --git a/openspec/changes/echoed-v2-platform-evolution/specs/review-center/spec.md b/openspec/changes/echoed-v2-platform-evolution/specs/review-center/spec.md
new file mode 100644
index 0000000..99fe70e
--- /dev/null
+++ b/openspec/changes/echoed-v2-platform-evolution/specs/review-center/spec.md
@@ -0,0 +1,40 @@
+# review-center Specification
+
+## ADDED Requirements
+
+### Requirement: Review Center SHALL centralize human governance workflows
+EchoEd SHALL introduce Review Center as the unified surface for reviewing lessons, artifacts, products, generated drafts, and source readiness.
+
+#### Scenario: Reviewer opens Review Center
+- **WHEN** a reviewer opens Review Center
+- **THEN** EchoEd displays reviewable items with type, status, owner, source coverage, readiness, and required decision
+
+#### Acceptance Criteria
+- Current lesson review behavior remains authoritative for lessons.
+- Generated artifacts are reviewable before publishing.
+- Review Center does not bypass role permissions.
+
+### Requirement: Review decisions SHALL be auditable
+Review workflows SHALL record who reviewed an item, what decision was made, and when the decision occurred.
+
+#### Scenario: Artifact is approved
+- **WHEN** an authorized reviewer approves an artifact
+- **THEN** EchoEd records the reviewer, decision, timestamp, and target item
+
+#### Acceptance Criteria
+- Review records are additive.
+- Approval of an artifact does not automatically bypass lesson readiness.
+
+## MODIFIED Requirements
+
+### Requirement: Lesson governance SHALL remain intact inside Review Center
+Existing lesson review status and readiness checks SHALL be reused in Review Center.
+
+#### Scenario: Lesson is not source-ready
+- **WHEN** a reviewer inspects a lesson missing required readiness data
+- **THEN** Review Center surfaces the readiness issue and prevents learner publishing according to existing governance rules
+
+#### Acceptance Criteria
+- Existing lesson governance tests remain valid.
+- Review Center uses existing readiness helpers where possible.
+
diff --git a/openspec/changes/echoed-v2-platform-evolution/specs/workspace-platform-foundation/spec.md b/openspec/changes/echoed-v2-platform-evolution/specs/workspace-platform-foundation/spec.md
new file mode 100644
index 0000000..483b50e
--- /dev/null
+++ b/openspec/changes/echoed-v2-platform-evolution/specs/workspace-platform-foundation/spec.md
@@ -0,0 +1,42 @@
+# workspace-platform-foundation Specification
+
+## ADDED Requirements
+
+### Requirement: Workspace SHALL become the top-level V2 operating context
+EchoEd SHALL introduce Workspace as the user-facing V2 container above existing organizations, projects, products, sources, artifacts, learners, analytics, and settings.
+
+#### Scenario: Existing organization appears in V2 workspace navigation
+- **WHEN** a user belongs to an existing organization
+- **THEN** the V2 workspace shell displays that organization context as the active workspace context
+- **AND** existing organization membership, role, and active organization behavior remain authoritative
+
+#### Acceptance Criteria
+- Existing organization flows remain functional.
+- Workspace UI can be introduced without database migration in Phase 1.
+- Future Workspace records can be backfilled from Organization records.
+
+### Requirement: Workspace shell SHALL preserve current runtime access
+The workspace shell SHALL reuse current authentication, organization context, route guards, and permissions.
+
+#### Scenario: Role-aware user enters workspace
+- **WHEN** a student, teacher, admin, org admin, or content admin enters a V2 route alias
+- **THEN** the user sees only navigation items permitted by existing role and permission logic
+
+#### Acceptance Criteria
+- No new auth path is introduced.
+- No current role loses access to an existing authorized page.
+- No current role gains access to a restricted existing page.
+
+## MODIFIED Requirements
+
+### Requirement: Organization context SHALL support workspace framing
+Existing organization context SHALL be presented as workspace context in V2 surfaces while preserving organization data ownership.
+
+#### Scenario: User switches organization
+- **WHEN** a user switches their active organization
+- **THEN** V2 workspace labels, navigation, and page context update to match the selected organization
+
+#### Acceptance Criteria
+- Organization switching remains backed by existing organization APIs.
+- Workspace terminology does not require replacing organization records.
+
diff --git a/openspec/changes/echoed-v2-platform-evolution/tasks.md b/openspec/changes/echoed-v2-platform-evolution/tasks.md
new file mode 100644
index 0000000..b760beb
--- /dev/null
+++ b/openspec/changes/echoed-v2-platform-evolution/tasks.md
@@ -0,0 +1,79 @@
+# Tasks
+
+## Phase 1: Workspace Shell And Navigation Reframe
+
+- [x] Audit existing shell, sidebar, route guards, dashboard pages, course wizard, admin course pages, studio pages, programs, sections, certifications, preferences, and analytics surfaces
+- [x] Add V2 navigation labels while preserving current role and permission checks
+- [x] Add route aliases for `/workspace`, `/workspace/product-studio`, `/workspace/products`, `/workspace/projects`, `/workspace/knowledge-sources`, `/workspace/artifacts`, `/workspace/review-center`, `/workspace/learners`, `/workspace/analytics`, and `/workspace/settings`
+- [x] Map existing pages into the V2 navigation without removing old routes
+- [x] Add placeholder pages or panels for future-only concepts where no current page exists
+- [x] Reframe visible terminology from admin/student/course-only language toward workspace, product, learner, source, and artifact language where safe
+- [x] Verify existing learner course start/continue flow still works
+- [x] Verify existing teacher/admin course management still works
+- [x] Run frontend tests and existing student smoke validation
+
+## Phase 2: Wrapper Models For Workspace, Project, Product, Artifact, KnowledgeSource, GenerationRun
+
+- [ ] Design additive SQLAlchemy models and Alembic migrations for workspace, project, product, knowledge source, artifact, and generation run wrappers
+- [ ] Backfill workspace records from existing organizations
+- [ ] Backfill course-backed product records from existing courses
+- [ ] Add nullable or join-based links from new wrapper records to existing runtime records
+- [ ] Preserve existing course, program, lesson, progress, assessment, and certification schemas
+- [ ] Add backend tests for non-destructive backfill behavior
+- [ ] Add API read endpoints for wrapper records without replacing existing course APIs
+
+## Phase 3: Product Studio Foundation
+
+- [ ] Reframe the existing course wizard as the first Product Studio workflow
+- [ ] Add product type selection with course-backed product as the initial supported type
+- [ ] Add project connection step that can be skipped for existing course creation
+- [ ] Preserve current course create/edit behavior
+- [ ] Add draft publishing checklist using existing lesson readiness and governance signals
+- [ ] Add tests for course creation through the Product Studio route alias
+
+## Phase 4: Knowledge Pipeline And Artifact Registry
+
+- [ ] Add knowledge source management screens and APIs
+- [ ] Add artifact registry screens and APIs
+- [ ] Link artifacts to projects, products, knowledge sources, and existing course/lesson records where applicable
+- [ ] Represent current source-backed lesson data in the knowledge pipeline without deleting original source rows
+- [ ] Add generation run history for future AI-assisted workflows
+- [ ] Add tests for source and artifact linkage
+
+## Phase 5: Review Center Expansion
+
+- [ ] Create Review Center surfaces for lesson readiness and generated artifact review
+- [ ] Reuse existing lesson governance and readiness checks
+- [ ] Add review request and review decision records
+- [ ] Ensure generated artifacts default to draft or review-required states
+- [ ] Add tests proving unapproved generated outputs do not become learner-deliverable
+
+## Phase 6: Learner Portal V2
+
+- [ ] Reframe the student dashboard as Learner Portal
+- [ ] Show assigned/enrolled products using existing course/program enrollments first
+- [ ] Add learner views for learning paths, resources, downloads, progress, and certificates
+- [ ] Preserve existing governed lesson runtime and progress tracking
+- [ ] Add tests for learner portal route aliases and current progress visibility
+
+## Phase 7: Access Grants
+
+- [ ] Add access grant model for product, course, program, artifact, and membership-style access
+- [ ] Backfill access grants from existing course and program enrollments where appropriate
+- [ ] Use access grants as the authorization layer for future products without weakening current role/auth rules
+- [ ] Add tests for explicit access and denied access behavior
+
+## Phase 8: Analytics V2
+
+- [ ] Define product, source, artifact, review, and learner analytics events
+- [ ] Add analytics dashboards for product engagement, learner progress, source coverage, artifact activity, and review cycle time
+- [ ] Reuse existing assessment, progress, certification, and runtime analytics
+- [ ] Add tests for analytics read models where backend behavior changes
+
+## Phase 9: Commercialization Readiness
+
+- [ ] Design pricing, checkout, order, subscription, and entitlement concepts around access grants
+- [ ] Add product page readiness states before payment integration
+- [ ] Keep payment provider implementation out of earlier phases
+- [ ] Prepare checkout and membership specifications without changing auth or learner runtime behavior
+- [ ] Add acceptance tests once payment/access behavior is implemented

From d80309516ece9e7f9925605417d50776937164dc Mon Sep 17 00:00:00 2001
From: Anthony Wright <anthony@mrwrite.dev>
Date: Tue, 30 Jun 2026 16:27:48 -0500
Subject: [PATCH 13/14] echoed-v2-platform-evolution

---
 ...c6d8e9b1_add_v2_platform_wrapper_models.py | 286 +++++++++
 backend/app/api/routes/v2_platform.py         | 568 ++++++++++++++++++
 backend/app/main.py                           |   2 +
 backend/app/models.py                         | 152 +++++
 backend/app/schemas.py                        | 161 +++++
 backend/tests/test_v2_platform_wrappers.py    | 544 +++++++++++++++++
 frontend/src/app/app.routes.spec.ts           |   8 +
 frontend/src/app/app.routes.ts                |  88 ++-
 frontend/src/app/models/v2-platform.model.ts  | 142 +++++
 .../artifact-detail.component.ts              |  81 +++
 .../generation-run-detail.component.ts        |  81 +++
 .../product-detail.component.ts               |  79 +++
 .../product-studio.component.ts               | 310 ++++++++++
 .../project-detail.component.ts               | 253 ++++++++
 .../v2-collection-page.component.ts           | 132 ++++
 .../app/services/v2-platform.service.spec.ts  | 185 ++++++
 .../src/app/services/v2-platform.service.ts   | 104 ++++
 .../echoed-v2-platform-evolution/tasks.md     |  38 +-
 18 files changed, 3176 insertions(+), 38 deletions(-)
 create mode 100644 backend/alembic/versions/a2f4c6d8e9b1_add_v2_platform_wrapper_models.py
 create mode 100644 backend/app/api/routes/v2_platform.py
 create mode 100644 backend/tests/test_v2_platform_wrappers.py
 create mode 100644 frontend/src/app/models/v2-platform.model.ts
 create mode 100644 frontend/src/app/pages/artifact-detail/artifact-detail.component.ts
 create mode 100644 frontend/src/app/pages/generation-run-detail/generation-run-detail.component.ts
 create mode 100644 frontend/src/app/pages/product-detail/product-detail.component.ts
 create mode 100644 frontend/src/app/pages/product-studio/product-studio.component.ts
 create mode 100644 frontend/src/app/pages/project-detail/project-detail.component.ts
 create mode 100644 frontend/src/app/pages/v2-platform/v2-collection-page.component.ts
 create mode 100644 frontend/src/app/services/v2-platform.service.spec.ts
 create mode 100644 frontend/src/app/services/v2-platform.service.ts

diff --git a/backend/alembic/versions/a2f4c6d8e9b1_add_v2_platform_wrapper_models.py b/backend/alembic/versions/a2f4c6d8e9b1_add_v2_platform_wrapper_models.py
new file mode 100644
index 0000000..37cc110
--- /dev/null
+++ b/backend/alembic/versions/a2f4c6d8e9b1_add_v2_platform_wrapper_models.py
@@ -0,0 +1,286 @@
+"""add v2 platform wrapper models
+
+Revision ID: a2f4c6d8e9b1
+Revises: 71d5d3a8f680, 9f1c2d3e4a5b
+Create Date: 2026-06-30 12:35:00.000000
+"""
+
+from typing import Sequence, Union
+
+from alembic import op
+import sqlalchemy as sa
+import uuid
+from datetime import datetime
+
+
+revision: str = "a2f4c6d8e9b1"
+down_revision: Union[str, tuple[str, str], None] = ("71d5d3a8f680", "9f1c2d3e4a5b")
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    op.create_table(
+        "workspaces",
+        sa.Column("id", sa.UUID(), nullable=False),
+        sa.Column("organization_id", sa.UUID(), nullable=True),
+        sa.Column("name", sa.String(), nullable=False),
+        sa.Column("slug", sa.String(), nullable=True),
+        sa.Column("description", sa.Text(), nullable=True),
+        sa.Column("status", sa.String(), nullable=False, server_default="active"),
+        sa.Column("metadata", sa.JSON(), nullable=True),
+        sa.Column("created_at", sa.DateTime(), nullable=True),
+        sa.Column("updated_at", sa.DateTime(), nullable=True),
+        sa.ForeignKeyConstraint(["organization_id"], ["organizations.id"]),
+        sa.PrimaryKeyConstraint("id"),
+        sa.UniqueConstraint("organization_id", name="uq_workspace_organization"),
+        sa.UniqueConstraint("slug"),
+    )
+    op.create_index(op.f("ix_workspaces_id"), "workspaces", ["id"], unique=False)
+    op.create_index(op.f("ix_workspaces_slug"), "workspaces", ["slug"], unique=False)
+
+    op.create_table(
+        "projects",
+        sa.Column("id", sa.UUID(), nullable=False),
+        sa.Column("workspace_id", sa.UUID(), nullable=False),
+        sa.Column("name", sa.String(), nullable=False),
+        sa.Column("description", sa.Text(), nullable=True),
+        sa.Column("status", sa.String(), nullable=False, server_default="active"),
+        sa.Column("metadata", sa.JSON(), nullable=True),
+        sa.Column("created_at", sa.DateTime(), nullable=True),
+        sa.Column("updated_at", sa.DateTime(), nullable=True),
+        sa.ForeignKeyConstraint(["workspace_id"], ["workspaces.id"]),
+        sa.PrimaryKeyConstraint("id"),
+    )
+    op.create_index(op.f("ix_projects_id"), "projects", ["id"], unique=False)
+    op.create_index("ix_projects_workspace_id", "projects", ["workspace_id"], unique=False)
+
+    op.create_table(
+        "products",
+        sa.Column("id", sa.UUID(), nullable=False),
+        sa.Column("workspace_id", sa.UUID(), nullable=False),
+        sa.Column("project_id", sa.UUID(), nullable=True),
+        sa.Column("course_id", sa.UUID(), nullable=True),
+        sa.Column("program_id", sa.UUID(), nullable=True),
+        sa.Column("product_type", sa.String(), nullable=False, server_default="course"),
+        sa.Column("title", sa.String(), nullable=False),
+        sa.Column("description", sa.Text(), nullable=True),
+        sa.Column("status", sa.String(), nullable=False, server_default="draft"),
+        sa.Column("review_state", sa.String(), nullable=False, server_default="not_reviewed"),
+        sa.Column("access_state", sa.String(), nullable=False, server_default="private"),
+        sa.Column("metadata", sa.JSON(), nullable=True),
+        sa.Column("published_at", sa.DateTime(), nullable=True),
+        sa.Column("created_at", sa.DateTime(), nullable=True),
+        sa.Column("updated_at", sa.DateTime(), nullable=True),
+        sa.ForeignKeyConstraint(["course_id"], ["courses.id"]),
+        sa.ForeignKeyConstraint(["program_id"], ["programs.id"]),
+        sa.ForeignKeyConstraint(["project_id"], ["projects.id"]),
+        sa.ForeignKeyConstraint(["workspace_id"], ["workspaces.id"]),
+        sa.PrimaryKeyConstraint("id"),
+        sa.UniqueConstraint("course_id", name="uq_product_course"),
+        sa.UniqueConstraint("program_id", name="uq_product_program"),
+    )
+    op.create_index(op.f("ix_products_id"), "products", ["id"], unique=False)
+    op.create_index("ix_products_workspace_id", "products", ["workspace_id"], unique=False)
+    op.create_index("ix_products_project_id", "products", ["project_id"], unique=False)
+
+    op.create_table(
+        "knowledge_sources",
+        sa.Column("id", sa.UUID(), nullable=False),
+        sa.Column("workspace_id", sa.UUID(), nullable=False),
+        sa.Column("project_id", sa.UUID(), nullable=False),
+        sa.Column("source_id", sa.UUID(), nullable=True),
+        sa.Column("title", sa.String(), nullable=False),
+        sa.Column("source_type", sa.String(), nullable=False, server_default="document"),
+        sa.Column("uri", sa.String(), nullable=True),
+        sa.Column("citation", sa.Text(), nullable=True),
+        sa.Column("content_hash", sa.String(), nullable=True),
+        sa.Column("status", sa.String(), nullable=False, server_default="available"),
+        sa.Column("metadata", sa.JSON(), nullable=True),
+        sa.Column("created_at", sa.DateTime(), nullable=True),
+        sa.Column("updated_at", sa.DateTime(), nullable=True),
+        sa.ForeignKeyConstraint(["project_id"], ["projects.id"]),
+        sa.ForeignKeyConstraint(["source_id"], ["sources.id"]),
+        sa.ForeignKeyConstraint(["workspace_id"], ["workspaces.id"]),
+        sa.PrimaryKeyConstraint("id"),
+    )
+    op.create_index(op.f("ix_knowledge_sources_id"), "knowledge_sources", ["id"], unique=False)
+    op.create_index("ix_knowledge_sources_project_id", "knowledge_sources", ["project_id"], unique=False)
+
+    op.create_table(
+        "generation_runs",
+        sa.Column("id", sa.UUID(), nullable=False),
+        sa.Column("workspace_id", sa.UUID(), nullable=False),
+        sa.Column("project_id", sa.UUID(), nullable=False),
+        sa.Column("product_id", sa.UUID(), nullable=True),
+        sa.Column("status", sa.String(), nullable=False, server_default="queued"),
+        sa.Column("provider", sa.String(), nullable=True),
+        sa.Column("model_name", sa.String(), nullable=True),
+        sa.Column("prompt", sa.Text(), nullable=True),
+        sa.Column("output_summary", sa.Text(), nullable=True),
+        sa.Column("input_metadata", sa.JSON(), nullable=True),
+        sa.Column("output_metadata", sa.JSON(), nullable=True),
+        sa.Column("error_message", sa.Text(), nullable=True),
+        sa.Column("started_at", sa.DateTime(), nullable=True),
+        sa.Column("completed_at", sa.DateTime(), nullable=True),
+        sa.Column("created_at", sa.DateTime(), nullable=True),
+        sa.ForeignKeyConstraint(["product_id"], ["products.id"]),
+        sa.ForeignKeyConstraint(["project_id"], ["projects.id"]),
+        sa.ForeignKeyConstraint(["workspace_id"], ["workspaces.id"]),
+        sa.PrimaryKeyConstraint("id"),
+    )
+    op.create_index(op.f("ix_generation_runs_id"), "generation_runs", ["id"], unique=False)
+    op.create_index("ix_generation_runs_project_id", "generation_runs", ["project_id"], unique=False)
+
+    op.create_table(
+        "artifacts",
+        sa.Column("id", sa.UUID(), nullable=False),
+        sa.Column("workspace_id", sa.UUID(), nullable=False),
+        sa.Column("project_id", sa.UUID(), nullable=False),
+        sa.Column("product_id", sa.UUID(), nullable=True),
+        sa.Column("generation_run_id", sa.UUID(), nullable=True),
+        sa.Column("knowledge_source_id", sa.UUID(), nullable=True),
+        sa.Column("artifact_type", sa.String(), nullable=False, server_default="documentation"),
+        sa.Column("title", sa.String(), nullable=False),
+        sa.Column("body", sa.Text(), nullable=True),
+        sa.Column("uri", sa.String(), nullable=True),
+        sa.Column("status", sa.String(), nullable=False, server_default="draft"),
+        sa.Column("review_state", sa.String(), nullable=False, server_default="review_required"),
+        sa.Column("metadata", sa.JSON(), nullable=True),
+        sa.Column("created_at", sa.DateTime(), nullable=True),
+        sa.Column("updated_at", sa.DateTime(), nullable=True),
+        sa.ForeignKeyConstraint(["generation_run_id"], ["generation_runs.id"]),
+        sa.ForeignKeyConstraint(["knowledge_source_id"], ["knowledge_sources.id"]),
+        sa.ForeignKeyConstraint(["product_id"], ["products.id"]),
+        sa.ForeignKeyConstraint(["project_id"], ["projects.id"]),
+        sa.ForeignKeyConstraint(["workspace_id"], ["workspaces.id"]),
+        sa.PrimaryKeyConstraint("id"),
+    )
+    op.create_index(op.f("ix_artifacts_id"), "artifacts", ["id"], unique=False)
+    op.create_index("ix_artifacts_project_id", "artifacts", ["project_id"], unique=False)
+
+    _backfill_workspace_and_products()
+
+
+def downgrade() -> None:
+    op.drop_index("ix_artifacts_project_id", table_name="artifacts")
+    op.drop_index(op.f("ix_artifacts_id"), table_name="artifacts")
+    op.drop_table("artifacts")
+
+    op.drop_index("ix_generation_runs_project_id", table_name="generation_runs")
+    op.drop_index(op.f("ix_generation_runs_id"), table_name="generation_runs")
+    op.drop_table("generation_runs")
+
+    op.drop_index("ix_knowledge_sources_project_id", table_name="knowledge_sources")
+    op.drop_index(op.f("ix_knowledge_sources_id"), table_name="knowledge_sources")
+    op.drop_table("knowledge_sources")
+
+    op.drop_index("ix_products_project_id", table_name="products")
+    op.drop_index("ix_products_workspace_id", table_name="products")
+    op.drop_index(op.f("ix_products_id"), table_name="products")
+    op.drop_table("products")
+
+    op.drop_index("ix_projects_workspace_id", table_name="projects")
+    op.drop_index(op.f("ix_projects_id"), table_name="projects")
+    op.drop_table("projects")
+
+    op.drop_index(op.f("ix_workspaces_slug"), table_name="workspaces")
+    op.drop_index(op.f("ix_workspaces_id"), table_name="workspaces")
+    op.drop_table("workspaces")
+
+
+def _backfill_workspace_and_products() -> None:
+    connection = op.get_bind()
+    now = datetime.utcnow()
+    workspace_ids_by_org: dict[str, uuid.UUID] = {}
+
+    organizations = connection.execute(sa.text("SELECT id, name FROM organizations")).fetchall()
+    for organization_id, organization_name in organizations:
+        workspace_id = uuid.uuid4()
+        workspace_ids_by_org[str(organization_id)] = workspace_id
+        connection.execute(
+            sa.text(
+                "INSERT INTO workspaces (id, organization_id, name, status, created_at, updated_at) "
+                "VALUES (:id, :organization_id, :name, 'active', :created_at, :updated_at)"
+            ),
+            {
+                "id": workspace_id,
+                "organization_id": organization_id,
+                "name": organization_name,
+                "created_at": now,
+                "updated_at": now,
+            },
+        )
+
+    legacy_workspace_id: uuid.UUID | None = None
+
+    def legacy_workspace() -> uuid.UUID:
+        nonlocal legacy_workspace_id
+        if legacy_workspace_id is None:
+            legacy_workspace_id = uuid.uuid4()
+            connection.execute(
+                sa.text(
+                    "INSERT INTO workspaces (id, name, status, created_at, updated_at) "
+                    "VALUES (:id, 'Legacy EchoEd Workspace', 'active', :created_at, :updated_at)"
+                ),
+                {"id": legacy_workspace_id, "created_at": now, "updated_at": now},
+            )
+        return legacy_workspace_id
+
+    courses = connection.execute(
+        sa.text("SELECT id, title, description, organization_id FROM courses")
+    ).fetchall()
+    for course_id, title, description, organization_id in courses:
+        workspace_id = (
+            workspace_ids_by_org.get(str(organization_id))
+            if organization_id is not None
+            else legacy_workspace()
+        )
+        if workspace_id is None:
+            workspace_id = legacy_workspace()
+        connection.execute(
+            sa.text(
+                "INSERT INTO products "
+                "(id, workspace_id, course_id, product_type, title, description, status, review_state, access_state, created_at, updated_at) "
+                "VALUES (:id, :workspace_id, :course_id, 'course', :title, :description, 'active', "
+                "'runtime_authoritative', 'existing_runtime', :created_at, :updated_at)"
+            ),
+            {
+                "id": uuid.uuid4(),
+                "workspace_id": workspace_id,
+                "course_id": course_id,
+                "title": title,
+                "description": description,
+                "created_at": now,
+                "updated_at": now,
+            },
+        )
+
+    programs = connection.execute(
+        sa.text("SELECT id, title, description, organization_id FROM programs")
+    ).fetchall()
+    for program_id, title, description, organization_id in programs:
+        workspace_id = (
+            workspace_ids_by_org.get(str(organization_id))
+            if organization_id is not None
+            else legacy_workspace()
+        )
+        if workspace_id is None:
+            workspace_id = legacy_workspace()
+        connection.execute(
+            sa.text(
+                "INSERT INTO products "
+                "(id, workspace_id, program_id, product_type, title, description, status, review_state, access_state, created_at, updated_at) "
+                "VALUES (:id, :workspace_id, :program_id, 'learning_path', :title, :description, 'active', "
+                "'runtime_authoritative', 'existing_runtime', :created_at, :updated_at)"
+            ),
+            {
+                "id": uuid.uuid4(),
+                "workspace_id": workspace_id,
+                "program_id": program_id,
+                "title": title,
+                "description": description,
+                "created_at": now,
+                "updated_at": now,
+            },
+        )
diff --git a/backend/app/api/routes/v2_platform.py b/backend/app/api/routes/v2_platform.py
new file mode 100644
index 0000000..0a90beb
--- /dev/null
+++ b/backend/app/api/routes/v2_platform.py
@@ -0,0 +1,568 @@
+from uuid import UUID
+
+from fastapi import APIRouter, Depends, HTTPException, Query
+from sqlalchemy.orm import Session
+
+from app.database import get_db
+from app.deps import get_current_user
+from app.enum import MembershipStatus
+from app.models import (
+    Artifact,
+    GenerationRun,
+    KnowledgeSource,
+    OrganizationMembership,
+    Product,
+    Course,
+    Program,
+    Project,
+    Source,
+    User,
+    Workspace,
+)
+from app.schemas import (
+    ArtifactCreateRequest,
+    ArtifactResponse,
+    GenerationRunResponse,
+    KnowledgeSourceCreateRequest,
+    KnowledgeSourceResponse,
+    ProductCreateRequest,
+    ProductResponse,
+    ProjectCreateRequest,
+    ProjectResponse,
+    WorkspaceResponse,
+)
+
+router = APIRouter()
+
+CREATOR_ROLES = {"admin", "teacher", "content_admin", "org_admin", "instructor", "super_admin"}
+SUPPORTED_PRODUCT_TYPES = {
+    "course",
+    "learning_path",
+    "documentation_pack",
+    "onboarding_track",
+    "implementation_playbook",
+    "knowledge_portal",
+    "certification",
+    "resource_pack",
+}
+SUPPORTED_KNOWLEDGE_SOURCE_TYPES = {
+    "repository",
+    "document",
+    "pdf",
+    "url",
+    "transcript",
+    "upload",
+    "manual_note",
+    "lesson_source",
+}
+SUPPORTED_ARTIFACT_TYPES = {
+    "outline",
+    "documentation",
+    "guide",
+    "checklist",
+    "source_map",
+    "export_bundle",
+    "assessment_seed",
+    "lesson_draft",
+}
+
+
+def _visible_workspace_ids(db: Session, current_user: User) -> list[UUID] | None:
+    if current_user.role in {"admin", "super_admin"}:
+        return None
+
+    active_status = MembershipStatus.ACTIVE.value
+    memberships = (
+        db.query(OrganizationMembership)
+        .filter(OrganizationMembership.user_id == current_user.id)
+        .all()
+    )
+    organization_ids = [
+        membership.organization_id
+        for membership in memberships
+        if getattr(membership.status, "value", membership.status) == active_status
+    ]
+    if not organization_ids:
+        return []
+
+    return [
+        workspace.id
+        for workspace in db.query(Workspace.id)
+        .filter(Workspace.organization_id.in_(organization_ids))
+        .all()
+    ]
+
+
+def _scope_workspace_query(query, db: Session, current_user: User):
+    visible_workspace_ids = _visible_workspace_ids(db, current_user)
+    if visible_workspace_ids is None:
+        return query
+    if not visible_workspace_ids:
+        return query.filter(False)
+    return query.filter(Workspace.id.in_(visible_workspace_ids))
+
+
+def _scope_platform_query(query, model, db: Session, current_user: User):
+    visible_workspace_ids = _visible_workspace_ids(db, current_user)
+    if visible_workspace_ids is None:
+        return query
+    if not visible_workspace_ids:
+        return query.filter(False)
+    return query.filter(model.workspace_id.in_(visible_workspace_ids))
+
+
+def _can_manage_workspace(db: Session, current_user: User, workspace: Workspace) -> bool:
+    if current_user.role in {"admin", "teacher", "super_admin"}:
+        return True
+    if current_user.role in {"content_admin", "org_admin", "instructor"}:
+        return True
+    if workspace.organization_id is None:
+        return False
+
+    membership = (
+        db.query(OrganizationMembership)
+        .filter(
+            OrganizationMembership.organization_id == workspace.organization_id,
+            OrganizationMembership.user_id == current_user.id,
+        )
+        .first()
+    )
+    if not membership:
+        return False
+    membership_role = getattr(membership.role, "value", membership.role)
+    membership_status = getattr(membership.status, "value", membership.status)
+    return (
+        membership_role in {"content_admin", "org_admin", "teacher", "instructor"}
+        and membership_status == MembershipStatus.ACTIVE.value
+    )
+
+
+def _require_manage_workspace(db: Session, current_user: User, workspace_id: UUID) -> Workspace:
+    workspace = _scope_workspace_query(
+        db.query(Workspace).filter(Workspace.id == workspace_id),
+        db,
+        current_user,
+    ).first()
+    if not workspace:
+        raise HTTPException(status_code=404, detail="Workspace not found")
+    if current_user.role not in CREATOR_ROLES or not _can_manage_workspace(db, current_user, workspace):
+        raise HTTPException(status_code=403, detail="You do not have permission to manage this workspace.")
+    return workspace
+
+
+def _get_visible_project(db: Session, current_user: User, project_id: UUID) -> Project:
+    project = _scope_platform_query(
+        db.query(Project).filter(Project.id == project_id),
+        Project,
+        db,
+        current_user,
+    ).first()
+    if not project:
+        raise HTTPException(status_code=404, detail="Project not found")
+    return project
+
+
+def _require_project_in_workspace(
+    db: Session,
+    current_user: User,
+    workspace_id: UUID,
+    project_id: UUID,
+) -> Project:
+    _require_manage_workspace(db, current_user, workspace_id)
+    project = (
+        db.query(Project)
+        .filter(Project.id == project_id, Project.workspace_id == workspace_id)
+        .first()
+    )
+    if not project:
+        raise HTTPException(status_code=400, detail="Project does not belong to the selected workspace.")
+    return project
+
+
+@router.get("/workspaces", response_model=list[WorkspaceResponse])
+def list_workspaces(
+    db: Session = Depends(get_db),
+    current_user: User = Depends(get_current_user),
+):
+    query = _scope_workspace_query(db.query(Workspace), db, current_user)
+    return query.order_by(Workspace.created_at.asc(), Workspace.name.asc()).all()
+
+
+@router.get("/workspaces/{workspace_id}", response_model=WorkspaceResponse)
+def get_workspace(
+    workspace_id: UUID,
+    db: Session = Depends(get_db),
+    current_user: User = Depends(get_current_user),
+):
+    workspace = _scope_workspace_query(
+        db.query(Workspace).filter(Workspace.id == workspace_id),
+        db,
+        current_user,
+    ).first()
+    if not workspace:
+        raise HTTPException(status_code=404, detail="Workspace not found")
+    return workspace
+
+
+@router.get("/projects", response_model=list[ProjectResponse])
+def list_projects(
+    workspace_id: UUID | None = Query(default=None),
+    db: Session = Depends(get_db),
+    current_user: User = Depends(get_current_user),
+):
+    query = _scope_platform_query(db.query(Project), Project, db, current_user)
+    if workspace_id:
+        query = query.filter(Project.workspace_id == workspace_id)
+    return query.order_by(Project.created_at.asc(), Project.name.asc()).all()
+
+
+@router.get("/projects/{project_id}", response_model=ProjectResponse)
+def get_project(
+    project_id: UUID,
+    db: Session = Depends(get_db),
+    current_user: User = Depends(get_current_user),
+):
+    project = _scope_platform_query(
+        db.query(Project).filter(Project.id == project_id),
+        Project,
+        db,
+        current_user,
+    ).first()
+    if not project:
+        raise HTTPException(status_code=404, detail="Project not found")
+    return project
+
+
+@router.post("/projects", response_model=ProjectResponse, status_code=201)
+def create_project(
+    payload: ProjectCreateRequest,
+    db: Session = Depends(get_db),
+    current_user: User = Depends(get_current_user),
+):
+    _require_manage_workspace(db, current_user, payload.workspace_id)
+    project = Project(
+        workspace_id=payload.workspace_id,
+        name=payload.name,
+        description=payload.description,
+        status=payload.status,
+        project_metadata=payload.metadata,
+    )
+    db.add(project)
+    db.commit()
+    db.refresh(project)
+    return project
+
+
+@router.get("/products", response_model=list[ProductResponse])
+def list_products(
+    workspace_id: UUID | None = Query(default=None),
+    project_id: UUID | None = Query(default=None),
+    db: Session = Depends(get_db),
+    current_user: User = Depends(get_current_user),
+):
+    query = _scope_platform_query(db.query(Product), Product, db, current_user)
+    if workspace_id:
+        query = query.filter(Product.workspace_id == workspace_id)
+    if project_id:
+        query = query.filter(Product.project_id == project_id)
+    return query.order_by(Product.created_at.asc(), Product.title.asc()).all()
+
+
+@router.get("/products/{product_id}", response_model=ProductResponse)
+def get_product(
+    product_id: UUID,
+    db: Session = Depends(get_db),
+    current_user: User = Depends(get_current_user),
+):
+    product = _scope_platform_query(
+        db.query(Product).filter(Product.id == product_id),
+        Product,
+        db,
+        current_user,
+    ).first()
+    if not product:
+        raise HTTPException(status_code=404, detail="Product not found")
+    return product
+
+
+@router.post("/products", response_model=ProductResponse, status_code=201)
+def create_product(
+    payload: ProductCreateRequest,
+    db: Session = Depends(get_db),
+    current_user: User = Depends(get_current_user),
+):
+    if payload.product_type not in SUPPORTED_PRODUCT_TYPES:
+        raise HTTPException(status_code=400, detail="Unsupported product type.")
+
+    _require_manage_workspace(db, current_user, payload.workspace_id)
+
+    if payload.project_id:
+        _require_project_in_workspace(db, current_user, payload.workspace_id, payload.project_id)
+
+    if payload.course_id:
+        course = db.query(Course).filter(Course.id == payload.course_id).first()
+        if not course:
+            raise HTTPException(status_code=404, detail="Course not found")
+        existing_product = db.query(Product).filter(Product.course_id == payload.course_id).first()
+        if existing_product:
+            return existing_product
+
+    if payload.program_id:
+        program = db.query(Program).filter(Program.id == payload.program_id).first()
+        if not program:
+            raise HTTPException(status_code=404, detail="Program not found")
+        existing_product = db.query(Product).filter(Product.program_id == payload.program_id).first()
+        if existing_product:
+            return existing_product
+
+    product = Product(
+        workspace_id=payload.workspace_id,
+        project_id=payload.project_id,
+        course_id=payload.course_id,
+        program_id=payload.program_id,
+        product_type=payload.product_type,
+        title=payload.title,
+        description=payload.description,
+        status=payload.status,
+        review_state=payload.review_state,
+        access_state=payload.access_state,
+        product_metadata=payload.metadata,
+    )
+    db.add(product)
+    db.commit()
+    db.refresh(product)
+    return product
+
+
+@router.get("/projects/{project_id}/products", response_model=list[ProductResponse])
+def list_project_products(
+    project_id: UUID,
+    db: Session = Depends(get_db),
+    current_user: User = Depends(get_current_user),
+):
+    _get_visible_project(db, current_user, project_id)
+    return (
+        _scope_platform_query(db.query(Product), Product, db, current_user)
+        .filter(Product.project_id == project_id)
+        .order_by(Product.created_at.asc(), Product.title.asc())
+        .all()
+    )
+
+
+@router.get("/knowledge-sources", response_model=list[KnowledgeSourceResponse])
+def list_knowledge_sources(
+    project_id: UUID | None = Query(default=None),
+    db: Session = Depends(get_db),
+    current_user: User = Depends(get_current_user),
+):
+    query = _scope_platform_query(db.query(KnowledgeSource), KnowledgeSource, db, current_user)
+    if project_id:
+        query = query.filter(KnowledgeSource.project_id == project_id)
+    return query.order_by(KnowledgeSource.created_at.asc(), KnowledgeSource.title.asc()).all()
+
+
+@router.get("/projects/{project_id}/knowledge-sources", response_model=list[KnowledgeSourceResponse])
+def list_project_knowledge_sources(
+    project_id: UUID,
+    db: Session = Depends(get_db),
+    current_user: User = Depends(get_current_user),
+):
+    _get_visible_project(db, current_user, project_id)
+    return (
+        _scope_platform_query(db.query(KnowledgeSource), KnowledgeSource, db, current_user)
+        .filter(KnowledgeSource.project_id == project_id)
+        .order_by(KnowledgeSource.created_at.asc(), KnowledgeSource.title.asc())
+        .all()
+    )
+
+
+@router.post("/knowledge-sources", response_model=KnowledgeSourceResponse, status_code=201)
+def create_knowledge_source(
+    payload: KnowledgeSourceCreateRequest,
+    db: Session = Depends(get_db),
+    current_user: User = Depends(get_current_user),
+):
+    if payload.source_type not in SUPPORTED_KNOWLEDGE_SOURCE_TYPES:
+        raise HTTPException(status_code=400, detail="Unsupported knowledge source type.")
+
+    _require_project_in_workspace(db, current_user, payload.workspace_id, payload.project_id)
+
+    if payload.source_id:
+        source = db.query(Source).filter(Source.id == payload.source_id).first()
+        if not source:
+            raise HTTPException(status_code=404, detail="Source not found")
+
+    knowledge_source = KnowledgeSource(
+        workspace_id=payload.workspace_id,
+        project_id=payload.project_id,
+        source_id=payload.source_id,
+        title=payload.title,
+        source_type=payload.source_type,
+        uri=payload.uri,
+        citation=payload.citation,
+        content_hash=payload.content_hash,
+        status=payload.status,
+        source_metadata=payload.metadata,
+    )
+    db.add(knowledge_source)
+    db.commit()
+    db.refresh(knowledge_source)
+    return knowledge_source
+
+
+@router.get("/artifacts", response_model=list[ArtifactResponse])
+def list_artifacts(
+    project_id: UUID | None = Query(default=None),
+    db: Session = Depends(get_db),
+    current_user: User = Depends(get_current_user),
+):
+    query = _scope_platform_query(db.query(Artifact), Artifact, db, current_user)
+    if project_id:
+        query = query.filter(Artifact.project_id == project_id)
+    return query.order_by(Artifact.created_at.asc(), Artifact.title.asc()).all()
+
+
+@router.get("/projects/{project_id}/artifacts", response_model=list[ArtifactResponse])
+def list_project_artifacts(
+    project_id: UUID,
+    db: Session = Depends(get_db),
+    current_user: User = Depends(get_current_user),
+):
+    _get_visible_project(db, current_user, project_id)
+    return (
+        _scope_platform_query(db.query(Artifact), Artifact, db, current_user)
+        .filter(Artifact.project_id == project_id)
+        .order_by(Artifact.created_at.asc(), Artifact.title.asc())
+        .all()
+    )
+
+
+@router.get("/artifacts/{artifact_id}", response_model=ArtifactResponse)
+def get_artifact(
+    artifact_id: UUID,
+    db: Session = Depends(get_db),
+    current_user: User = Depends(get_current_user),
+):
+    artifact = _scope_platform_query(
+        db.query(Artifact).filter(Artifact.id == artifact_id),
+        Artifact,
+        db,
+        current_user,
+    ).first()
+    if not artifact:
+        raise HTTPException(status_code=404, detail="Artifact not found")
+    return artifact
+
+
+@router.post("/artifacts", response_model=ArtifactResponse, status_code=201)
+def create_artifact(
+    payload: ArtifactCreateRequest,
+    db: Session = Depends(get_db),
+    current_user: User = Depends(get_current_user),
+):
+    if payload.artifact_type not in SUPPORTED_ARTIFACT_TYPES:
+        raise HTTPException(status_code=400, detail="Unsupported artifact type.")
+
+    _require_project_in_workspace(db, current_user, payload.workspace_id, payload.project_id)
+
+    if payload.product_id:
+        product = (
+            db.query(Product)
+            .filter(
+                Product.id == payload.product_id,
+                Product.workspace_id == payload.workspace_id,
+                Product.project_id == payload.project_id,
+            )
+            .first()
+        )
+        if not product:
+            raise HTTPException(status_code=400, detail="Product does not belong to the selected project.")
+
+    if payload.knowledge_source_id:
+        knowledge_source = (
+            db.query(KnowledgeSource)
+            .filter(
+                KnowledgeSource.id == payload.knowledge_source_id,
+                KnowledgeSource.workspace_id == payload.workspace_id,
+                KnowledgeSource.project_id == payload.project_id,
+            )
+            .first()
+        )
+        if not knowledge_source:
+            raise HTTPException(status_code=400, detail="Knowledge source does not belong to the selected project.")
+
+    if payload.generation_run_id:
+        generation_run = (
+            db.query(GenerationRun)
+            .filter(
+                GenerationRun.id == payload.generation_run_id,
+                GenerationRun.workspace_id == payload.workspace_id,
+                GenerationRun.project_id == payload.project_id,
+            )
+            .first()
+        )
+        if not generation_run:
+            raise HTTPException(status_code=400, detail="Generation run does not belong to the selected project.")
+
+    artifact = Artifact(
+        workspace_id=payload.workspace_id,
+        project_id=payload.project_id,
+        product_id=payload.product_id,
+        generation_run_id=payload.generation_run_id,
+        knowledge_source_id=payload.knowledge_source_id,
+        artifact_type=payload.artifact_type,
+        title=payload.title,
+        body=payload.body,
+        uri=payload.uri,
+        status=payload.status,
+        review_state=payload.review_state,
+        artifact_metadata=payload.metadata,
+    )
+    db.add(artifact)
+    db.commit()
+    db.refresh(artifact)
+    return artifact
+
+
+@router.get("/generation-runs", response_model=list[GenerationRunResponse])
+def list_generation_runs(
+    project_id: UUID | None = Query(default=None),
+    db: Session = Depends(get_db),
+    current_user: User = Depends(get_current_user),
+):
+    query = _scope_platform_query(db.query(GenerationRun), GenerationRun, db, current_user)
+    if project_id:
+        query = query.filter(GenerationRun.project_id == project_id)
+    return query.order_by(GenerationRun.created_at.desc()).all()
+
+
+@router.get("/projects/{project_id}/generation-runs", response_model=list[GenerationRunResponse])
+def list_project_generation_runs(
+    project_id: UUID,
+    db: Session = Depends(get_db),
+    current_user: User = Depends(get_current_user),
+):
+    _get_visible_project(db, current_user, project_id)
+    return (
+        _scope_platform_query(db.query(GenerationRun), GenerationRun, db, current_user)
+        .filter(GenerationRun.project_id == project_id)
+        .order_by(GenerationRun.created_at.desc())
+        .all()
+    )
+
+
+@router.get("/generation-runs/{generation_run_id}", response_model=GenerationRunResponse)
+def get_generation_run(
+    generation_run_id: UUID,
+    db: Session = Depends(get_db),
+    current_user: User = Depends(get_current_user),
+):
+    generation_run = _scope_platform_query(
+        db.query(GenerationRun).filter(GenerationRun.id == generation_run_id),
+        GenerationRun,
+        db,
+        current_user,
+    ).first()
+    if not generation_run:
+        raise HTTPException(status_code=404, detail="Generation run not found")
+    return generation_run
diff --git a/backend/app/main.py b/backend/app/main.py
index dd8b056..c544c6a 100644
--- a/backend/app/main.py
+++ b/backend/app/main.py
@@ -29,6 +29,7 @@
     uploads,
     users,
     meta,
+    v2_platform,
 )
 
 app = FastAPI()
@@ -81,6 +82,7 @@
 app.include_router(assignments.router, prefix="/api", tags=["Assignments"])
 app.include_router(uploads.router, prefix="/api", tags=["Uploads"])
 app.include_router(meta.router, prefix="/api", tags=["Meta"])
+app.include_router(v2_platform.router, prefix="/api", tags=["V2 Platform"])
 
 
 @app.get("/api")
diff --git a/backend/app/models.py b/backend/app/models.py
index 7f3a050..a56b41e 100644
--- a/backend/app/models.py
+++ b/backend/app/models.py
@@ -116,6 +116,7 @@ class Organization(Base):
     courses = relationship("Course", back_populates="organization")
     sections = relationship("Section", back_populates="organization")
     programs = relationship("Program", back_populates="organization")
+    workspaces = relationship("Workspace", back_populates="organization")
 
 
 class OrganizationMembership(Base):
@@ -230,6 +231,7 @@ class Course(Base):
         cascade="all, delete-orphan",
     )
     assessments = relationship("Assessment", back_populates="course")
+    products = relationship("Product", back_populates="course")
 
 
 class CourseVersion(Base):
@@ -340,6 +342,7 @@ class Source(Base):
     created_at = Column(DateTime, default=datetime.utcnow)
 
     lesson = relationship("Lesson", back_populates="sources")
+    knowledge_sources = relationship("KnowledgeSource", back_populates="source")
 
 
 class Activity(Base):
@@ -507,6 +510,155 @@ class Program(Base):
         back_populates="program",
         cascade="all, delete-orphan",
     )
+    products = relationship("Product", back_populates="program")
+
+
+class Workspace(Base):
+    __tablename__ = "workspaces"
+    __table_args__ = (
+        UniqueConstraint("organization_id", name="uq_workspace_organization"),
+    )
+
+    id = Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4, index=True)
+    organization_id = Column(UUID(as_uuid=True), ForeignKey("organizations.id"), nullable=True)
+    name = Column(String, nullable=False)
+    slug = Column(String, nullable=True, unique=True, index=True)
+    description = Column(Text, nullable=True)
+    status = Column(String, nullable=False, default="active")
+    workspace_metadata = Column("metadata", JSON, nullable=True, default=dict)
+    created_at = Column(DateTime, default=datetime.utcnow)
+    updated_at = Column(DateTime, default=datetime.utcnow)
+
+    organization = relationship("Organization", back_populates="workspaces")
+    projects = relationship("Project", back_populates="workspace", cascade="all, delete-orphan")
+    products = relationship("Product", back_populates="workspace", cascade="all, delete-orphan")
+    knowledge_sources = relationship("KnowledgeSource", back_populates="workspace", cascade="all, delete-orphan")
+    artifacts = relationship("Artifact", back_populates="workspace", cascade="all, delete-orphan")
+    generation_runs = relationship("GenerationRun", back_populates="workspace", cascade="all, delete-orphan")
+
+
+class Project(Base):
+    __tablename__ = "projects"
+
+    id = Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4, index=True)
+    workspace_id = Column(UUID(as_uuid=True), ForeignKey("workspaces.id"), nullable=False)
+    name = Column(String, nullable=False)
+    description = Column(Text, nullable=True)
+    status = Column(String, nullable=False, default="active")
+    project_metadata = Column("metadata", JSON, nullable=True, default=dict)
+    created_at = Column(DateTime, default=datetime.utcnow)
+    updated_at = Column(DateTime, default=datetime.utcnow)
+
+    workspace = relationship("Workspace", back_populates="projects")
+    products = relationship("Product", back_populates="project")
+    knowledge_sources = relationship("KnowledgeSource", back_populates="project", cascade="all, delete-orphan")
+    artifacts = relationship("Artifact", back_populates="project", cascade="all, delete-orphan")
+    generation_runs = relationship("GenerationRun", back_populates="project", cascade="all, delete-orphan")
+
+
+class Product(Base):
+    __tablename__ = "products"
+    __table_args__ = (
+        UniqueConstraint("course_id", name="uq_product_course"),
+        UniqueConstraint("program_id", name="uq_product_program"),
+    )
+
+    id = Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4, index=True)
+    workspace_id = Column(UUID(as_uuid=True), ForeignKey("workspaces.id"), nullable=False)
+    project_id = Column(UUID(as_uuid=True), ForeignKey("projects.id"), nullable=True)
+    course_id = Column(UUID(as_uuid=True), ForeignKey("courses.id"), nullable=True)
+    program_id = Column(UUID(as_uuid=True), ForeignKey("programs.id"), nullable=True)
+    product_type = Column(String, nullable=False, default="course")
+    title = Column(String, nullable=False)
+    description = Column(Text, nullable=True)
+    status = Column(String, nullable=False, default="draft")
+    review_state = Column(String, nullable=False, default="not_reviewed")
+    access_state = Column(String, nullable=False, default="private")
+    product_metadata = Column("metadata", JSON, nullable=True, default=dict)
+    published_at = Column(DateTime, nullable=True)
+    created_at = Column(DateTime, default=datetime.utcnow)
+    updated_at = Column(DateTime, default=datetime.utcnow)
+
+    workspace = relationship("Workspace", back_populates="products")
+    project = relationship("Project", back_populates="products")
+    course = relationship("Course", back_populates="products")
+    program = relationship("Program", back_populates="products")
+    artifacts = relationship("Artifact", back_populates="product")
+    generation_runs = relationship("GenerationRun", back_populates="product")
+
+
+class KnowledgeSource(Base):
+    __tablename__ = "knowledge_sources"
+
+    id = Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4, index=True)
+    workspace_id = Column(UUID(as_uuid=True), ForeignKey("workspaces.id"), nullable=False)
+    project_id = Column(UUID(as_uuid=True), ForeignKey("projects.id"), nullable=False)
+    source_id = Column(UUID(as_uuid=True), ForeignKey("sources.id"), nullable=True)
+    title = Column(String, nullable=False)
+    source_type = Column(String, nullable=False, default="document")
+    uri = Column(String, nullable=True)
+    citation = Column(Text, nullable=True)
+    content_hash = Column(String, nullable=True)
+    status = Column(String, nullable=False, default="available")
+    source_metadata = Column("metadata", JSON, nullable=True, default=dict)
+    created_at = Column(DateTime, default=datetime.utcnow)
+    updated_at = Column(DateTime, default=datetime.utcnow)
+
+    workspace = relationship("Workspace", back_populates="knowledge_sources")
+    project = relationship("Project", back_populates="knowledge_sources")
+    source = relationship("Source", back_populates="knowledge_sources")
+    artifacts = relationship("Artifact", back_populates="knowledge_source")
+
+
+class GenerationRun(Base):
+    __tablename__ = "generation_runs"
+
+    id = Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4, index=True)
+    workspace_id = Column(UUID(as_uuid=True), ForeignKey("workspaces.id"), nullable=False)
+    project_id = Column(UUID(as_uuid=True), ForeignKey("projects.id"), nullable=False)
+    product_id = Column(UUID(as_uuid=True), ForeignKey("products.id"), nullable=True)
+    status = Column(String, nullable=False, default="queued")
+    provider = Column(String, nullable=True)
+    model_name = Column(String, nullable=True)
+    prompt = Column(Text, nullable=True)
+    output_summary = Column(Text, nullable=True)
+    input_metadata = Column(JSON, nullable=True, default=dict)
+    output_metadata = Column(JSON, nullable=True, default=dict)
+    error_message = Column(Text, nullable=True)
+    started_at = Column(DateTime, nullable=True)
+    completed_at = Column(DateTime, nullable=True)
+    created_at = Column(DateTime, default=datetime.utcnow)
+
+    workspace = relationship("Workspace", back_populates="generation_runs")
+    project = relationship("Project", back_populates="generation_runs")
+    product = relationship("Product", back_populates="generation_runs")
+    artifacts = relationship("Artifact", back_populates="generation_run")
+
+
+class Artifact(Base):
+    __tablename__ = "artifacts"
+
+    id = Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4, index=True)
+    workspace_id = Column(UUID(as_uuid=True), ForeignKey("workspaces.id"), nullable=False)
+    project_id = Column(UUID(as_uuid=True), ForeignKey("projects.id"), nullable=False)
+    product_id = Column(UUID(as_uuid=True), ForeignKey("products.id"), nullable=True)
+    generation_run_id = Column(UUID(as_uuid=True), ForeignKey("generation_runs.id"), nullable=True)
+    knowledge_source_id = Column(UUID(as_uuid=True), ForeignKey("knowledge_sources.id"), nullable=True)
+    artifact_type = Column(String, nullable=False, default="documentation")
+    title = Column(String, nullable=False)
+    body = Column(Text, nullable=True)
+    uri = Column(String, nullable=True)
+    status = Column(String, nullable=False, default="draft")
+    review_state = Column(String, nullable=False, default="review_required")
+    artifact_metadata = Column("metadata", JSON, nullable=True, default=dict)
+    created_at = Column(DateTime, default=datetime.utcnow)
+    updated_at = Column(DateTime, default=datetime.utcnow)
+
+    workspace = relationship("Workspace", back_populates="artifacts")
+    project = relationship("Project", back_populates="artifacts")
+    product = relationship("Product", back_populates="artifacts")
+    generation_run = relationship("GenerationRun", back_populates="artifacts")
+    knowledge_source = relationship("KnowledgeSource", back_populates="artifacts")
 
 
 class ProgramCourse(Base):
diff --git a/backend/app/schemas.py b/backend/app/schemas.py
index 8c3c18a..2418fb1 100644
--- a/backend/app/schemas.py
+++ b/backend/app/schemas.py
@@ -87,6 +87,167 @@ class Config:
         from_attributes = True
 
 
+class WorkspaceResponse(BaseModel):
+    id: UUID
+    organization_id: Optional[UUID] = None
+    name: str
+    slug: Optional[str] = None
+    description: Optional[str] = None
+    status: str
+    metadata: dict[str, Any] = Field(default_factory=dict, validation_alias="workspace_metadata")
+    created_at: datetime
+    updated_at: datetime
+
+    class Config:
+        from_attributes = True
+
+
+class ProjectResponse(BaseModel):
+    id: UUID
+    workspace_id: UUID
+    name: str
+    description: Optional[str] = None
+    status: str
+    metadata: dict[str, Any] = Field(default_factory=dict, validation_alias="project_metadata")
+    created_at: datetime
+    updated_at: datetime
+
+    class Config:
+        from_attributes = True
+
+
+class ProjectCreateRequest(BaseModel):
+    workspace_id: UUID
+    name: str
+    description: Optional[str] = None
+    status: str = "active"
+    metadata: dict[str, Any] = Field(default_factory=dict)
+
+
+class ProductResponse(BaseModel):
+    id: UUID
+    workspace_id: UUID
+    project_id: Optional[UUID] = None
+    course_id: Optional[UUID] = None
+    program_id: Optional[UUID] = None
+    product_type: str
+    title: str
+    description: Optional[str] = None
+    status: str
+    review_state: str
+    access_state: str
+    metadata: dict[str, Any] = Field(default_factory=dict, validation_alias="product_metadata")
+    published_at: Optional[datetime] = None
+    created_at: datetime
+    updated_at: datetime
+
+    class Config:
+        from_attributes = True
+
+
+class ProductCreateRequest(BaseModel):
+    workspace_id: UUID
+    project_id: Optional[UUID] = None
+    course_id: Optional[UUID] = None
+    program_id: Optional[UUID] = None
+    product_type: str
+    title: str
+    description: Optional[str] = None
+    status: str = "draft"
+    review_state: str = "not_reviewed"
+    access_state: str = "private"
+    metadata: dict[str, Any] = Field(default_factory=dict)
+
+
+class KnowledgeSourceResponse(BaseModel):
+    id: UUID
+    workspace_id: UUID
+    project_id: UUID
+    source_id: Optional[UUID] = None
+    title: str
+    source_type: str
+    uri: Optional[str] = None
+    citation: Optional[str] = None
+    content_hash: Optional[str] = None
+    status: str
+    metadata: dict[str, Any] = Field(default_factory=dict, validation_alias="source_metadata")
+    created_at: datetime
+    updated_at: datetime
+
+    class Config:
+        from_attributes = True
+
+
+class KnowledgeSourceCreateRequest(BaseModel):
+    workspace_id: UUID
+    project_id: UUID
+    source_id: Optional[UUID] = None
+    title: str
+    source_type: str
+    uri: Optional[str] = None
+    citation: Optional[str] = None
+    content_hash: Optional[str] = None
+    status: str = "available"
+    metadata: dict[str, Any] = Field(default_factory=dict)
+
+
+class ArtifactResponse(BaseModel):
+    id: UUID
+    workspace_id: UUID
+    project_id: UUID
+    product_id: Optional[UUID] = None
+    generation_run_id: Optional[UUID] = None
+    knowledge_source_id: Optional[UUID] = None
+    artifact_type: str
+    title: str
+    body: Optional[str] = None
+    uri: Optional[str] = None
+    status: str
+    review_state: str
+    metadata: dict[str, Any] = Field(default_factory=dict, validation_alias="artifact_metadata")
+    created_at: datetime
+    updated_at: datetime
+
+    class Config:
+        from_attributes = True
+
+
+class ArtifactCreateRequest(BaseModel):
+    workspace_id: UUID
+    project_id: UUID
+    product_id: Optional[UUID] = None
+    generation_run_id: Optional[UUID] = None
+    knowledge_source_id: Optional[UUID] = None
+    artifact_type: str
+    title: str
+    body: Optional[str] = None
+    uri: Optional[str] = None
+    status: str = "draft"
+    review_state: str = "review_required"
+    metadata: dict[str, Any] = Field(default_factory=dict)
+
+
+class GenerationRunResponse(BaseModel):
+    id: UUID
+    workspace_id: UUID
+    project_id: UUID
+    product_id: Optional[UUID] = None
+    status: str
+    provider: Optional[str] = None
+    model_name: Optional[str] = None
+    prompt: Optional[str] = None
+    output_summary: Optional[str] = None
+    input_metadata: dict[str, Any] = Field(default_factory=dict)
+    output_metadata: dict[str, Any] = Field(default_factory=dict)
+    error_message: Optional[str] = None
+    started_at: Optional[datetime] = None
+    completed_at: Optional[datetime] = None
+    created_at: datetime
+
+    class Config:
+        from_attributes = True
+
+
 class OrganizationInviteCreate(BaseModel):
     email: str
     role: str
diff --git a/backend/tests/test_v2_platform_wrappers.py b/backend/tests/test_v2_platform_wrappers.py
new file mode 100644
index 0000000..6ee7746
--- /dev/null
+++ b/backend/tests/test_v2_platform_wrappers.py
@@ -0,0 +1,544 @@
+import uuid
+
+from fastapi import FastAPI
+from fastapi.testclient import TestClient
+
+from app.api.routes import courses, v2_platform
+from app.database import get_db
+from app.deps import get_current_user
+from app.enum import OrganizationType
+from app.models import (
+    Artifact,
+    Course,
+    GenerationRun,
+    KnowledgeSource,
+    Lesson,
+    Organization,
+    Product,
+    Project,
+    Source,
+    Unit,
+    User,
+    Workspace,
+)
+
+
+def _admin_user() -> User:
+    return User(
+        id=uuid.uuid4(),
+        firstname="Admin",
+        lastname="User",
+        username=f"admin_{uuid.uuid4().hex[:8]}",
+        email=f"admin_{uuid.uuid4().hex[:8]}@example.com",
+        hashed_password="hashed",
+        role="admin",
+    )
+
+
+def test_v2_wrapper_models_preserve_existing_course_lesson_relationships(db_session):
+    organization = Organization(
+        id=uuid.uuid4(),
+        name="Acme Learning",
+        type=OrganizationType.SCHOOL,
+    )
+    course = Course(
+        id=uuid.uuid4(),
+        title="Existing Course",
+        description="Existing runtime course",
+        organization=organization,
+    )
+    unit = Unit(
+        id=uuid.uuid4(),
+        course=course,
+        title="Existing Unit",
+        content="Runtime content",
+        order=1,
+    )
+    lesson = Lesson(
+        id=uuid.uuid4(),
+        unit=unit,
+        title="Existing Lesson",
+        objective="Keep runtime behavior intact",
+    )
+    source = Source(
+        id=uuid.uuid4(),
+        lesson=lesson,
+        citation="Existing source",
+        url="https://example.com/source",
+    )
+    workspace = Workspace(
+        id=uuid.uuid4(),
+        organization=organization,
+        name="Acme Workspace",
+    )
+    project = Project(
+        id=uuid.uuid4(),
+        workspace=workspace,
+        name="Onboarding Project",
+    )
+    product = Product(
+        id=uuid.uuid4(),
+        workspace=workspace,
+        project=project,
+        course=course,
+        product_type="course",
+        title=course.title,
+        description=course.description,
+        status="active",
+    )
+    knowledge_source = KnowledgeSource(
+        id=uuid.uuid4(),
+        workspace=workspace,
+        project=project,
+        source=source,
+        title="Existing source as knowledge",
+        source_type="lesson_source",
+        citation=source.citation,
+    )
+    generation_run = GenerationRun(
+        id=uuid.uuid4(),
+        workspace=workspace,
+        project=project,
+        product=product,
+        status="completed",
+        provider="test-provider",
+        model_name="test-model",
+        prompt="Generate onboarding material",
+        output_summary="Generated an outline",
+    )
+    artifact = Artifact(
+        id=uuid.uuid4(),
+        workspace=workspace,
+        project=project,
+        product=product,
+        generation_run=generation_run,
+        knowledge_source=knowledge_source,
+        artifact_type="guide",
+        title="Implementation Guide",
+        body="Reviewable generated content",
+    )
+
+    db_session.add_all([
+        organization,
+        course,
+        unit,
+        lesson,
+        source,
+        workspace,
+        project,
+        product,
+        knowledge_source,
+        generation_run,
+        artifact,
+    ])
+    db_session.commit()
+    db_session.expire_all()
+
+    saved_course = db_session.query(Course).filter_by(id=course.id).one()
+    assert saved_course.units[0].lessons[0].title == "Existing Lesson"
+    assert saved_course.products[0].title == "Existing Course"
+
+    saved_project = db_session.query(Project).filter_by(id=project.id).one()
+    assert saved_project.workspace.name == "Acme Workspace"
+    assert saved_project.products[0].course_id == course.id
+    assert saved_project.knowledge_sources[0].source_id == source.id
+    assert saved_project.generation_runs[0].artifacts[0].title == "Implementation Guide"
+
+
+def test_v2_read_apis_list_wrappers_without_replacing_course_api(db_session):
+    admin = _admin_user()
+    organization = Organization(
+        id=uuid.uuid4(),
+        name="Runtime Org",
+        type=OrganizationType.SCHOOL,
+    )
+    course = Course(
+        id=uuid.uuid4(),
+        title="Runtime Course",
+        description="Still served by /api/courses",
+        organization=organization,
+    )
+    unit = Unit(
+        id=uuid.uuid4(),
+        course=course,
+        title="Runtime Unit",
+        content="Existing unit",
+        order=1,
+    )
+    lesson = Lesson(
+        id=uuid.uuid4(),
+        unit=unit,
+        title="Runtime Lesson",
+        objective="Existing lesson",
+    )
+    workspace = Workspace(
+        id=uuid.uuid4(),
+        organization=organization,
+        name="Runtime Workspace",
+    )
+    project = Project(
+        id=uuid.uuid4(),
+        workspace=workspace,
+        name="Runtime Project",
+    )
+    product = Product(
+        id=uuid.uuid4(),
+        workspace=workspace,
+        project=project,
+        course=course,
+        product_type="course",
+        title=course.title,
+        description=course.description,
+        status="active",
+    )
+
+    db_session.add_all([admin, organization, course, unit, lesson, workspace, project, product])
+    db_session.commit()
+
+    test_app = FastAPI()
+    test_app.include_router(v2_platform.router, prefix="/api")
+    test_app.include_router(courses.router, prefix="/api")
+
+    def override_get_db():
+        yield db_session
+
+    test_app.dependency_overrides[get_db] = override_get_db
+    test_app.dependency_overrides[get_current_user] = lambda: admin
+
+    client = TestClient(test_app)
+
+    products_response = client.get("/api/products")
+    assert products_response.status_code == 200
+    products_payload = products_response.json()
+    assert len(products_payload) == 1
+    assert products_payload[0]["course_id"] == str(course.id)
+    assert products_payload[0]["title"] == "Runtime Course"
+
+    courses_response = client.get(f"/api/courses/{course.id}")
+    assert courses_response.status_code == 200
+    course_payload = courses_response.json()
+    assert course_payload["id"] == str(course.id)
+    assert course_payload["units"][0]["lessons"][0]["title"] == "Runtime Lesson"
+    assert "products" not in course_payload
+
+
+def test_v2_create_project_and_product_shells_are_additive(db_session):
+    admin = _admin_user()
+    organization = Organization(
+        id=uuid.uuid4(),
+        name="Studio Org",
+        type=OrganizationType.SCHOOL,
+    )
+    course = Course(
+        id=uuid.uuid4(),
+        title="Course Runtime",
+        description="Existing runtime remains untouched",
+        organization=organization,
+    )
+    unit = Unit(
+        id=uuid.uuid4(),
+        course=course,
+        title="Runtime Unit",
+        content="Existing unit",
+        order=1,
+    )
+    lesson = Lesson(
+        id=uuid.uuid4(),
+        unit=unit,
+        title="Runtime Lesson",
+        objective="Existing lesson",
+    )
+    workspace = Workspace(
+        id=uuid.uuid4(),
+        organization=organization,
+        name="Studio Workspace",
+    )
+    db_session.add_all([admin, organization, course, unit, lesson, workspace])
+    db_session.commit()
+
+    test_app = FastAPI()
+    test_app.include_router(v2_platform.router, prefix="/api")
+
+    def override_get_db():
+        yield db_session
+
+    test_app.dependency_overrides[get_db] = override_get_db
+    test_app.dependency_overrides[get_current_user] = lambda: admin
+
+    client = TestClient(test_app)
+
+    project_response = client.post(
+        "/api/projects",
+        json={
+            "workspace_id": str(workspace.id),
+            "name": "Studio Project",
+            "description": "Project shell only",
+        },
+    )
+    assert project_response.status_code == 201
+    project_id = project_response.json()["id"]
+
+    product_response = client.post(
+        "/api/products",
+        json={
+            "workspace_id": str(workspace.id),
+            "project_id": project_id,
+            "course_id": str(course.id),
+            "product_type": "course",
+            "title": "Course Runtime Product",
+            "description": "Wrapper only",
+        },
+    )
+    assert product_response.status_code == 201
+    payload = product_response.json()
+    assert payload["course_id"] == str(course.id)
+    assert payload["project_id"] == project_id
+
+    db_session.expire_all()
+    assert db_session.query(Course).filter(Course.id == course.id).count() == 1
+    assert db_session.query(Unit).filter(Unit.id == unit.id).count() == 1
+    assert db_session.query(Lesson).filter(Lesson.id == lesson.id).count() == 1
+    assert db_session.query(Project).filter(Project.id == uuid.UUID(project_id)).count() == 1
+    assert db_session.query(Product).filter(Product.course_id == course.id).count() == 1
+
+
+def test_v2_create_product_reuses_existing_course_backed_wrapper(db_session):
+    admin = _admin_user()
+    organization = Organization(
+        id=uuid.uuid4(),
+        name="Reuse Org",
+        type=OrganizationType.SCHOOL,
+    )
+    course = Course(
+        id=uuid.uuid4(),
+        title="Reusable Course",
+        description="Existing course",
+        organization=organization,
+    )
+    workspace = Workspace(
+        id=uuid.uuid4(),
+        organization=organization,
+        name="Reuse Workspace",
+    )
+    existing_product = Product(
+        id=uuid.uuid4(),
+        workspace=workspace,
+        course=course,
+        product_type="course",
+        title=course.title,
+        description=course.description,
+        status="active",
+    )
+    db_session.add_all([admin, organization, course, workspace, existing_product])
+    db_session.commit()
+
+    test_app = FastAPI()
+    test_app.include_router(v2_platform.router, prefix="/api")
+
+    def override_get_db():
+        yield db_session
+
+    test_app.dependency_overrides[get_db] = override_get_db
+    test_app.dependency_overrides[get_current_user] = lambda: admin
+
+    client = TestClient(test_app)
+    response = client.post(
+        "/api/products",
+        json={
+            "workspace_id": str(workspace.id),
+            "course_id": str(course.id),
+            "product_type": "course",
+            "title": "Duplicate wrapper request",
+        },
+    )
+
+    assert response.status_code == 201
+    assert response.json()["id"] == str(existing_product.id)
+    assert db_session.query(Product).count() == 1
+
+
+def test_v2_creates_knowledge_source_and_artifact_links_without_changing_runtime(db_session):
+    admin = _admin_user()
+    organization = Organization(
+        id=uuid.uuid4(),
+        name="Pipeline Org",
+        type=OrganizationType.SCHOOL,
+    )
+    course = Course(
+        id=uuid.uuid4(),
+        title="Pipeline Course",
+        description="Existing runtime course",
+        organization=organization,
+    )
+    unit = Unit(
+        id=uuid.uuid4(),
+        course=course,
+        title="Runtime Unit",
+        content="Existing unit",
+        order=1,
+    )
+    lesson = Lesson(
+        id=uuid.uuid4(),
+        unit=unit,
+        title="Runtime Lesson",
+        objective="Runtime objective",
+    )
+    source = Source(
+        id=uuid.uuid4(),
+        lesson=lesson,
+        citation="Runtime source",
+        url="https://example.com/runtime-source",
+    )
+    workspace = Workspace(
+        id=uuid.uuid4(),
+        organization=organization,
+        name="Pipeline Workspace",
+    )
+    project = Project(
+        id=uuid.uuid4(),
+        workspace=workspace,
+        name="Pipeline Project",
+    )
+    product = Product(
+        id=uuid.uuid4(),
+        workspace=workspace,
+        project=project,
+        course=course,
+        product_type="course",
+        title="Pipeline Product",
+    )
+    generation_run = GenerationRun(
+        id=uuid.uuid4(),
+        workspace=workspace,
+        project=project,
+        product=product,
+        status="completed",
+        provider="placeholder",
+        model_name="future-model",
+        prompt="Draft a guide",
+        output_summary="Placeholder output only",
+    )
+    db_session.add_all([
+        admin,
+        organization,
+        course,
+        unit,
+        lesson,
+        source,
+        workspace,
+        project,
+        product,
+        generation_run,
+    ])
+    db_session.commit()
+
+    test_app = FastAPI()
+    test_app.include_router(v2_platform.router, prefix="/api")
+
+    def override_get_db():
+        yield db_session
+
+    test_app.dependency_overrides[get_db] = override_get_db
+    test_app.dependency_overrides[get_current_user] = lambda: admin
+    client = TestClient(test_app)
+
+    source_response = client.post(
+        "/api/knowledge-sources",
+        json={
+            "workspace_id": str(workspace.id),
+            "project_id": str(project.id),
+            "source_id": str(source.id),
+            "title": "Wrapped runtime source",
+            "source_type": "lesson_source",
+            "uri": source.url,
+            "citation": source.citation,
+            "metadata": {"wrapped_from": "lesson_source"},
+        },
+    )
+    assert source_response.status_code == 201
+    knowledge_source_id = source_response.json()["id"]
+    assert source_response.json()["source_id"] == str(source.id)
+
+    artifact_response = client.post(
+        "/api/artifacts",
+        json={
+            "workspace_id": str(workspace.id),
+            "project_id": str(project.id),
+            "product_id": str(product.id),
+            "generation_run_id": str(generation_run.id),
+            "knowledge_source_id": knowledge_source_id,
+            "artifact_type": "guide",
+            "title": "Implementation Guide",
+            "body": "Reviewable artifact content",
+        },
+    )
+    assert artifact_response.status_code == 201
+    artifact_payload = artifact_response.json()
+    assert artifact_payload["status"] == "draft"
+    assert artifact_payload["review_state"] == "review_required"
+    assert artifact_payload["product_id"] == str(product.id)
+    assert artifact_payload["generation_run_id"] == str(generation_run.id)
+    assert artifact_payload["knowledge_source_id"] == knowledge_source_id
+
+    assert client.get(f"/api/projects/{project.id}/knowledge-sources").json()[0]["id"] == knowledge_source_id
+    assert client.get(f"/api/projects/{project.id}/artifacts").json()[0]["id"] == artifact_payload["id"]
+    assert client.get(f"/api/projects/{project.id}/generation-runs").json()[0]["id"] == str(generation_run.id)
+    assert client.get(f"/api/projects/{project.id}/products").json()[0]["id"] == str(product.id)
+
+    db_session.expire_all()
+    assert db_session.query(Source).filter(Source.id == source.id).one().citation == "Runtime source"
+    assert db_session.query(Course).filter(Course.id == course.id).count() == 1
+    assert db_session.query(Lesson).filter(Lesson.id == lesson.id).count() == 1
+
+
+def test_v2_rejects_unsupported_source_and_artifact_types(db_session):
+    admin = _admin_user()
+    organization = Organization(
+        id=uuid.uuid4(),
+        name="Validation Org",
+        type=OrganizationType.SCHOOL,
+    )
+    workspace = Workspace(
+        id=uuid.uuid4(),
+        organization=organization,
+        name="Validation Workspace",
+    )
+    project = Project(
+        id=uuid.uuid4(),
+        workspace=workspace,
+        name="Validation Project",
+    )
+    db_session.add_all([admin, organization, workspace, project])
+    db_session.commit()
+
+    test_app = FastAPI()
+    test_app.include_router(v2_platform.router, prefix="/api")
+
+    def override_get_db():
+        yield db_session
+
+    test_app.dependency_overrides[get_db] = override_get_db
+    test_app.dependency_overrides[get_current_user] = lambda: admin
+    client = TestClient(test_app)
+
+    source_response = client.post(
+        "/api/knowledge-sources",
+        json={
+            "workspace_id": str(workspace.id),
+            "project_id": str(project.id),
+            "title": "Unsupported source",
+            "source_type": "unknown",
+        },
+    )
+    assert source_response.status_code == 400
+
+    artifact_response = client.post(
+        "/api/artifacts",
+        json={
+            "workspace_id": str(workspace.id),
+            "project_id": str(project.id),
+            "artifact_type": "unknown",
+            "title": "Unsupported artifact",
+        },
+    )
+    assert artifact_response.status_code == 400
diff --git a/frontend/src/app/app.routes.spec.ts b/frontend/src/app/app.routes.spec.ts
index 94e7f69..9591488 100644
--- a/frontend/src/app/app.routes.spec.ts
+++ b/frontend/src/app/app.routes.spec.ts
@@ -37,10 +37,18 @@ describe('app routes', () => {
     [
       'workspace',
       'workspace/projects',
+      'workspace/projects/:projectId',
       'workspace/product-studio',
+      'workspace/product-studio/create',
+      'workspace/product-studio/courses/new',
+      'workspace/product-studio/courses/:courseId/edit',
+      'workspace/product-studio/generation-runs',
+      'workspace/product-studio/generation-runs/:generationRunId',
       'workspace/products',
+      'workspace/products/:productId',
       'workspace/knowledge-sources',
       'workspace/artifacts',
+      'workspace/artifacts/:artifactId',
       'workspace/review-center',
       'workspace/learners',
       'workspace/analytics',
diff --git a/frontend/src/app/app.routes.ts b/frontend/src/app/app.routes.ts
index 1625316..7f089f3 100644
--- a/frontend/src/app/app.routes.ts
+++ b/frontend/src/app/app.routes.ts
@@ -24,6 +24,12 @@ import { ProgramsComponent } from './pages/programs/programs.component';
 import { AssessmentDetailComponent } from './pages/assessment-detail/assessment-detail.component';
 import { CertificationsComponent } from './pages/certifications/certifications.component';
 import { V2PlatformPageComponent } from './pages/v2-platform/v2-platform-page.component';
+import { ProductStudioComponent } from './pages/product-studio/product-studio.component';
+import { V2CollectionPageComponent } from './pages/v2-platform/v2-collection-page.component';
+import { ProductDetailComponent } from './pages/product-detail/product-detail.component';
+import { ProjectDetailComponent } from './pages/project-detail/project-detail.component';
+import { ArtifactDetailComponent } from './pages/artifact-detail/artifact-detail.component';
+import { GenerationRunDetailComponent } from './pages/generation-run-detail/generation-run-detail.component';
 
 const creatorRoles = ['admin', 'teacher', 'content_admin', 'org_admin', 'instructor'];
 const studioRoles = ['content_admin', 'org_admin'];
@@ -131,32 +137,54 @@ export const routes: Routes = [
       },
       {
         path: 'projects',
-        component: V2PlatformPageComponent,
+        component: V2CollectionPageComponent,
         canActivate: [RoleGuard],
         data: {
           roles: creatorRoles,
           eyebrow: 'Projects',
           title: 'Project knowledge pipeline',
-          description: 'Projects will group source material, AI analysis, generated artifacts, and product outputs for a business or technical initiative.',
-          status: 'Placeholder route: wrapper models arrive in a later phase; existing course runtime remains unchanged.'
+          status: 'Real V2 project shell data. Creating projects is available through Product Studio.',
+          emptyText: 'Create your first project shell from Product Studio.',
+          collection: 'projects'
         }
       },
+      {
+        path: 'projects/:projectId',
+        component: ProjectDetailComponent,
+        canActivate: [RoleGuard],
+        data: { roles: creatorRoles }
+      },
       {
         path: 'product-studio',
-        component: V2PlatformPageComponent,
+        component: ProductStudioComponent,
+        canActivate: [RoleGuard],
+        data: { roles: creatorRoles }
+      },
+      {
+        path: 'product-studio/create',
+        component: ProductStudioComponent,
+        canActivate: [RoleGuard],
+        data: { roles: creatorRoles }
+      },
+      {
+        path: 'product-studio/generation-runs',
+        component: V2CollectionPageComponent,
         canActivate: [RoleGuard],
         data: {
           roles: creatorRoles,
-          eyebrow: 'Product Studio',
-          title: 'Create trusted learning products',
-          description: 'Product Studio will orchestrate source import, AI generation, human review, approval, publishing, and delivery.',
-          status: 'Phase 1 exposes the Studio entry point and links to existing course creation tools.',
-          links: [
-            { label: 'Existing studio courses', route: '/workspace/product-studio/courses' },
-            { label: 'Create course-backed product', route: '/workspace/product-studio/courses/new' }
-          ]
+          eyebrow: 'Generation Runs',
+          title: 'AI generation attempts',
+          status: 'Read-only generation metadata. Execution is not implemented in Phase 3.',
+          emptyText: 'Generation run history will appear here after future AI execution workflows are implemented.',
+          collection: 'generation-runs'
         }
       },
+      {
+        path: 'product-studio/generation-runs/:generationRunId',
+        component: GenerationRunDetailComponent,
+        canActivate: [RoleGuard],
+        data: { roles: creatorRoles }
+      },
       {
         path: 'product-studio/courses',
         component: StudioCoursesComponent,
@@ -175,7 +203,21 @@ export const routes: Routes = [
         canActivate: [RoleGuard],
         data: { roles: ['admin', 'teacher'] }
       },
-      { path: 'products', component: AvailableCoursesComponent },
+      {
+        path: 'products',
+        component: V2CollectionPageComponent,
+        data: {
+          eyebrow: 'Products',
+          title: 'Product catalog',
+          status: 'Real V2 product wrappers. Course-backed products link to the existing education runtime.',
+          emptyText: 'Create product shells from Product Studio, or run the Phase 2 backfill migration for existing courses.',
+          collection: 'products'
+        }
+      },
+      {
+        path: 'products/:productId',
+        component: ProductDetailComponent,
+      },
       {
         path: 'products/manage',
         component: AdminCoursesComponent,
@@ -184,28 +226,36 @@ export const routes: Routes = [
       },
       {
         path: 'knowledge-sources',
-        component: V2PlatformPageComponent,
+        component: V2CollectionPageComponent,
         canActivate: [RoleGuard],
         data: {
           roles: creatorRoles,
           eyebrow: 'Knowledge Sources',
           title: 'Source-aware knowledge intake',
-          description: 'Knowledge Sources will collect documentation, project references, files, and source-backed material used by AI-assisted generation.',
-          status: 'Placeholder route: source-backed lesson readiness remains available through existing governance flows.'
+          status: 'Read-only knowledge source wrappers. Source import and management arrive in a later phase.',
+          emptyText: 'No project-level knowledge sources exist yet.',
+          collection: 'knowledge-sources'
         }
       },
       {
         path: 'artifacts',
-        component: V2PlatformPageComponent,
+        component: V2CollectionPageComponent,
         canActivate: [RoleGuard],
         data: {
           roles: creatorRoles,
           eyebrow: 'Artifacts',
           title: 'Generated documentation and learning assets',
-          description: 'Artifacts will track AI-generated documentation, playbooks, downloads, and reusable assets before they become learning products.',
-          status: 'Placeholder route: artifact registry models and packaging workflows are planned for a later phase.'
+          status: 'Read-only artifact wrappers. Review, packaging, and publishing arrive in later phases.',
+          emptyText: 'No generated or uploaded artifacts exist yet.',
+          collection: 'artifacts'
         }
       },
+      {
+        path: 'artifacts/:artifactId',
+        component: ArtifactDetailComponent,
+        canActivate: [RoleGuard],
+        data: { roles: creatorRoles }
+      },
       {
         path: 'review-center',
         component: V2PlatformPageComponent,
diff --git a/frontend/src/app/models/v2-platform.model.ts b/frontend/src/app/models/v2-platform.model.ts
new file mode 100644
index 0000000..a9a8c99
--- /dev/null
+++ b/frontend/src/app/models/v2-platform.model.ts
@@ -0,0 +1,142 @@
+export interface Workspace {
+  id: string;
+  organization_id?: string | null;
+  name: string;
+  slug?: string | null;
+  description?: string | null;
+  status: string;
+  metadata: Record<string, unknown>;
+  created_at: string;
+  updated_at: string;
+}
+
+export interface Project {
+  id: string;
+  workspace_id: string;
+  name: string;
+  description?: string | null;
+  status: string;
+  metadata: Record<string, unknown>;
+  created_at: string;
+  updated_at: string;
+}
+
+export interface Product {
+  id: string;
+  workspace_id: string;
+  project_id?: string | null;
+  course_id?: string | null;
+  program_id?: string | null;
+  product_type: string;
+  title: string;
+  description?: string | null;
+  status: string;
+  review_state: string;
+  access_state: string;
+  metadata: Record<string, unknown>;
+  published_at?: string | null;
+  created_at: string;
+  updated_at: string;
+}
+
+export interface KnowledgeSource {
+  id: string;
+  workspace_id: string;
+  project_id: string;
+  source_id?: string | null;
+  title: string;
+  source_type: string;
+  uri?: string | null;
+  citation?: string | null;
+  content_hash?: string | null;
+  status: string;
+  metadata: Record<string, unknown>;
+  created_at: string;
+  updated_at: string;
+}
+
+export interface Artifact {
+  id: string;
+  workspace_id: string;
+  project_id: string;
+  product_id?: string | null;
+  generation_run_id?: string | null;
+  knowledge_source_id?: string | null;
+  artifact_type: string;
+  title: string;
+  body?: string | null;
+  uri?: string | null;
+  status: string;
+  review_state: string;
+  metadata: Record<string, unknown>;
+  created_at: string;
+  updated_at: string;
+}
+
+export interface GenerationRun {
+  id: string;
+  workspace_id: string;
+  project_id: string;
+  product_id?: string | null;
+  status: string;
+  provider?: string | null;
+  model_name?: string | null;
+  prompt?: string | null;
+  output_summary?: string | null;
+  input_metadata: Record<string, unknown>;
+  output_metadata: Record<string, unknown>;
+  error_message?: string | null;
+  started_at?: string | null;
+  completed_at?: string | null;
+  created_at: string;
+}
+
+export interface ProjectCreateRequest {
+  workspace_id: string;
+  name: string;
+  description?: string | null;
+  status?: string;
+  metadata?: Record<string, unknown>;
+}
+
+export interface ProductCreateRequest {
+  workspace_id: string;
+  project_id?: string | null;
+  course_id?: string | null;
+  program_id?: string | null;
+  product_type: string;
+  title: string;
+  description?: string | null;
+  status?: string;
+  review_state?: string;
+  access_state?: string;
+  metadata?: Record<string, unknown>;
+}
+
+export interface KnowledgeSourceCreateRequest {
+  workspace_id: string;
+  project_id: string;
+  source_id?: string | null;
+  title: string;
+  source_type: string;
+  uri?: string | null;
+  citation?: string | null;
+  content_hash?: string | null;
+  status?: string;
+  metadata?: Record<string, unknown>;
+}
+
+export interface ArtifactCreateRequest {
+  workspace_id: string;
+  project_id: string;
+  product_id?: string | null;
+  generation_run_id?: string | null;
+  knowledge_source_id?: string | null;
+  artifact_type: string;
+  title: string;
+  body?: string | null;
+  uri?: string | null;
+  status?: string;
+  review_state?: string;
+  metadata?: Record<string, unknown>;
+}
diff --git a/frontend/src/app/pages/artifact-detail/artifact-detail.component.ts b/frontend/src/app/pages/artifact-detail/artifact-detail.component.ts
new file mode 100644
index 0000000..b0bc78d
--- /dev/null
+++ b/frontend/src/app/pages/artifact-detail/artifact-detail.component.ts
@@ -0,0 +1,81 @@
+import { CommonModule } from '@angular/common';
+import { Component, OnInit, inject } from '@angular/core';
+import { ActivatedRoute, RouterModule } from '@angular/router';
+import { Artifact } from '../../models/v2-platform.model';
+import { V2PlatformService } from '../../services/v2-platform.service';
+
+@Component({
+  selector: 'app-artifact-detail',
+  standalone: true,
+  imports: [CommonModule, RouterModule],
+  template: `
+    <section class="artifact-detail" aria-labelledby="artifact-title">
+      <a class="back-link" routerLink="/workspace/artifacts">Back to artifact registry</a>
+
+      <article *ngIf="artifact" class="panel">
+        <p>Artifact Registry</p>
+        <h1 id="artifact-title">{{ artifact.title }}</h1>
+        <span>{{ label(artifact.artifact_type) }} · {{ artifact.status }} · {{ artifact.review_state }}</span>
+        <p class="notice">This artifact is a reviewable V2 output. It is not learner-deliverable until a future review or publishing flow explicitly attaches it.</p>
+      </article>
+
+      <div class="grid" *ngIf="artifact">
+        <article class="panel">
+          <h2>Content</h2>
+          <p class="body">{{ artifact.body || artifact.uri || 'No body or external URI has been added yet.' }}</p>
+        </article>
+
+        <article class="panel">
+          <h2>Traceability</h2>
+          <dl>
+            <dt>Project</dt>
+            <dd><a [routerLink]="['/workspace/projects', artifact.project_id]">{{ artifact.project_id }}</a></dd>
+            <dt>Product</dt>
+            <dd>{{ artifact.product_id || 'Not linked' }}</dd>
+            <dt>Knowledge source</dt>
+            <dd>{{ artifact.knowledge_source_id || 'Not linked' }}</dd>
+            <dt>Generation run</dt>
+            <dd>{{ artifact.generation_run_id || 'Manual or placeholder artifact' }}</dd>
+          </dl>
+        </article>
+      </div>
+    </section>
+  `,
+  styles: [`
+    .artifact-detail { color: #0f172a; display: grid; gap: 1rem; padding: clamp(1rem, 3vw, 2rem); }
+    .back-link { color: #0e7490; font-weight: 900; text-decoration: none; width: fit-content; }
+    .panel { background: #fff; border: 1px solid rgba(15,23,42,.1); border-radius: 1.4rem; box-shadow: 0 18px 40px rgba(15,23,42,.08); padding: clamp(1rem, 3vw, 1.5rem); }
+    article > p:first-child { color: #0e7490; font-size: .76rem; font-weight: 900; letter-spacing: .22em; margin: 0 0 .5rem; text-transform: uppercase; }
+    h1, h2 { letter-spacing: -.03em; margin: 0; }
+    h1 { font-size: clamp(2rem, 5vw, 3rem); }
+    span { color: #0e7490; font-weight: 800; }
+    .notice, .body, dd { color: #475569; }
+    .grid { display: grid; gap: 1rem; grid-template-columns: minmax(0, 1.4fr) minmax(260px, .8fr); }
+    dl { display: grid; gap: .4rem; margin: 0; }
+    dt { color: #334155; font-weight: 900; }
+    dd { margin: 0 0 .75rem; overflow-wrap: anywhere; }
+    a { color: #0e7490; font-weight: 800; }
+    a:focus-visible { outline: 3px solid rgba(14,116,144,.25); outline-offset: 3px; }
+    @media (max-width: 800px) { .grid { grid-template-columns: 1fr; } }
+  `]
+})
+export class ArtifactDetailComponent implements OnInit {
+  private readonly route = inject(ActivatedRoute);
+  private readonly v2Platform = inject(V2PlatformService);
+
+  artifact: Artifact | null = null;
+
+  ngOnInit(): void {
+    const artifactId = this.route.snapshot.paramMap.get('artifactId');
+    if (!artifactId) {
+      return;
+    }
+    this.v2Platform.getArtifact(artifactId).subscribe(artifact => {
+      this.artifact = artifact;
+    });
+  }
+
+  label(value: string): string {
+    return value.replace(/_/g, ' ').replace(/\b\w/g, char => char.toUpperCase());
+  }
+}
diff --git a/frontend/src/app/pages/generation-run-detail/generation-run-detail.component.ts b/frontend/src/app/pages/generation-run-detail/generation-run-detail.component.ts
new file mode 100644
index 0000000..b773930
--- /dev/null
+++ b/frontend/src/app/pages/generation-run-detail/generation-run-detail.component.ts
@@ -0,0 +1,81 @@
+import { CommonModule } from '@angular/common';
+import { Component, OnInit, inject } from '@angular/core';
+import { ActivatedRoute, RouterModule } from '@angular/router';
+import { GenerationRun } from '../../models/v2-platform.model';
+import { V2PlatformService } from '../../services/v2-platform.service';
+
+@Component({
+  selector: 'app-generation-run-detail',
+  standalone: true,
+  imports: [CommonModule, RouterModule],
+  template: `
+    <section class="run-detail" aria-labelledby="run-title">
+      <a class="back-link" routerLink="/workspace/product-studio/generation-runs">Back to generation runs</a>
+
+      <article *ngIf="generationRun" class="panel">
+        <p>Generation Run History</p>
+        <h1 id="run-title">{{ generationRun.model_name || 'Generation run' }}</h1>
+        <span>{{ generationRun.status }} · {{ generationRun.provider || 'provider pending' }}</span>
+        <p class="notice">Phase 4 shows generation metadata only. AI execution is intentionally not implemented here.</p>
+      </article>
+
+      <div class="grid" *ngIf="generationRun">
+        <article class="panel">
+          <h2>Prompt</h2>
+          <p>{{ generationRun.prompt || 'No prompt has been recorded yet.' }}</p>
+        </article>
+
+        <article class="panel">
+          <h2>Output Summary</h2>
+          <p>{{ generationRun.output_summary || generationRun.error_message || 'No output has been recorded yet.' }}</p>
+        </article>
+
+        <article class="panel">
+          <h2>Traceability</h2>
+          <dl>
+            <dt>Project</dt>
+            <dd><a [routerLink]="['/workspace/projects', generationRun.project_id]">{{ generationRun.project_id }}</a></dd>
+            <dt>Product</dt>
+            <dd>{{ generationRun.product_id || 'Not linked' }}</dd>
+            <dt>Started</dt>
+            <dd>{{ generationRun.started_at || 'Not started' }}</dd>
+            <dt>Completed</dt>
+            <dd>{{ generationRun.completed_at || 'Not completed' }}</dd>
+          </dl>
+        </article>
+      </div>
+    </section>
+  `,
+  styles: [`
+    .run-detail { color: #0f172a; display: grid; gap: 1rem; padding: clamp(1rem, 3vw, 2rem); }
+    .back-link { color: #0e7490; font-weight: 900; text-decoration: none; width: fit-content; }
+    .panel { background: #fff; border: 1px solid rgba(15,23,42,.1); border-radius: 1.4rem; box-shadow: 0 18px 40px rgba(15,23,42,.08); padding: clamp(1rem, 3vw, 1.5rem); }
+    article > p:first-child { color: #0e7490; font-size: .76rem; font-weight: 900; letter-spacing: .22em; margin: 0 0 .5rem; text-transform: uppercase; }
+    h1, h2 { letter-spacing: -.03em; margin: 0; }
+    h1 { font-size: clamp(2rem, 5vw, 3rem); }
+    span { color: #0e7490; font-weight: 800; }
+    .notice, .panel p, dd { color: #475569; overflow-wrap: anywhere; }
+    .grid { display: grid; gap: 1rem; grid-template-columns: repeat(auto-fit, minmax(260px, 1fr)); }
+    dl { display: grid; gap: .4rem; margin: 0; }
+    dt { color: #334155; font-weight: 900; }
+    dd { margin: 0 0 .75rem; }
+    a { color: #0e7490; font-weight: 800; }
+    a:focus-visible { outline: 3px solid rgba(14,116,144,.25); outline-offset: 3px; }
+  `]
+})
+export class GenerationRunDetailComponent implements OnInit {
+  private readonly route = inject(ActivatedRoute);
+  private readonly v2Platform = inject(V2PlatformService);
+
+  generationRun: GenerationRun | null = null;
+
+  ngOnInit(): void {
+    const generationRunId = this.route.snapshot.paramMap.get('generationRunId');
+    if (!generationRunId) {
+      return;
+    }
+    this.v2Platform.getGenerationRun(generationRunId).subscribe(generationRun => {
+      this.generationRun = generationRun;
+    });
+  }
+}
diff --git a/frontend/src/app/pages/product-detail/product-detail.component.ts b/frontend/src/app/pages/product-detail/product-detail.component.ts
new file mode 100644
index 0000000..492b745
--- /dev/null
+++ b/frontend/src/app/pages/product-detail/product-detail.component.ts
@@ -0,0 +1,79 @@
+import { CommonModule } from '@angular/common';
+import { Component, OnInit } from '@angular/core';
+import { ActivatedRoute, RouterModule } from '@angular/router';
+import { Product } from '../../models/v2-platform.model';
+import { V2PlatformService } from '../../services/v2-platform.service';
+
+@Component({
+  selector: 'app-product-detail',
+  standalone: true,
+  imports: [CommonModule, RouterModule],
+  template: `
+    <section class="detail" *ngIf="product" aria-labelledby="product-title">
+      <a routerLink="/workspace/products">Back to products</a>
+      <article>
+        <p>Product</p>
+        <h1 id="product-title">{{ product.title }}</h1>
+        <span>{{ label(product.product_type) }} · {{ product.status }} · {{ product.review_state }}</span>
+        <p class="description">{{ product.description || 'No description yet.' }}</p>
+
+        <div class="grid">
+          <div>
+            <strong>Workspace</strong>
+            <span>{{ product.workspace_id }}</span>
+          </div>
+          <div>
+            <strong>Project</strong>
+            <span>{{ product.project_id || 'Not connected yet' }}</span>
+          </div>
+          <div>
+            <strong>Runtime course</strong>
+            <span>{{ product.course_id || 'No course runtime link' }}</span>
+          </div>
+          <div>
+            <strong>Access</strong>
+            <span>{{ product.access_state }}</span>
+          </div>
+        </div>
+
+        <div class="notice">
+          Product shell details are additive. Publishing, checkout, memberships, and AI generation execution are not implemented in Phase 3.
+        </div>
+      </article>
+    </section>
+  `,
+  styles: [`
+    .detail { display: grid; gap: 1rem; padding: clamp(1rem, 3vw, 2rem); color: #0f172a; }
+    article { background: #fff; border: 1px solid rgba(15,23,42,.1); border-radius: 1.5rem; box-shadow: 0 18px 40px rgba(15,23,42,.08); display: grid; gap: 1rem; padding: clamp(1rem, 4vw, 2rem); }
+    article > p:first-child { color: #0e7490; font-size: .76rem; font-weight: 900; letter-spacing: .22em; margin: 0; text-transform: uppercase; }
+    h1 { font-size: clamp(2rem, 5vw, 3rem); letter-spacing: -.04em; line-height: 1; margin: 0; }
+    .description { color: #475569; font-size: 1.05rem; line-height: 1.7; }
+    .grid { display: grid; gap: .75rem; grid-template-columns: repeat(auto-fit, minmax(13rem, 1fr)); }
+    .grid div, .notice { background: #f8fafc; border: 1px solid #e2e8f0; border-radius: 1rem; display: grid; gap: .35rem; padding: .9rem; }
+    strong { color: #334155; }
+    span { color: #0e7490; font-weight: 800; overflow-wrap: anywhere; }
+    a { color: #0e7490; font-weight: 900; }
+  `]
+})
+export class ProductDetailComponent implements OnInit {
+  product: Product | null = null;
+
+  constructor(
+    private readonly route: ActivatedRoute,
+    private readonly v2Platform: V2PlatformService,
+  ) {}
+
+  ngOnInit(): void {
+    const productId = this.route.snapshot.paramMap.get('productId');
+    if (!productId) {
+      return;
+    }
+    this.v2Platform.getProduct(productId).subscribe(product => {
+      this.product = product;
+    });
+  }
+
+  label(value: string): string {
+    return value.replace(/_/g, ' ').replace(/\b\w/g, char => char.toUpperCase());
+  }
+}
diff --git a/frontend/src/app/pages/product-studio/product-studio.component.ts b/frontend/src/app/pages/product-studio/product-studio.component.ts
new file mode 100644
index 0000000..6bcf83e
--- /dev/null
+++ b/frontend/src/app/pages/product-studio/product-studio.component.ts
@@ -0,0 +1,310 @@
+import { CommonModule } from '@angular/common';
+import { Component, OnInit } from '@angular/core';
+import { FormsModule } from '@angular/forms';
+import { RouterModule } from '@angular/router';
+import { forkJoin } from 'rxjs';
+import { Course } from '../../models/course';
+import { Product, Project, Workspace } from '../../models/v2-platform.model';
+import { CoursesService } from '../../services/courses.service';
+import { V2PlatformService } from '../../services/v2-platform.service';
+
+const PRODUCT_TYPES = [
+  'course',
+  'learning_path',
+  'documentation_pack',
+  'onboarding_track',
+  'implementation_playbook',
+  'knowledge_portal',
+  'certification',
+  'resource_pack',
+];
+
+@Component({
+  selector: 'app-product-studio',
+  standalone: true,
+  imports: [CommonModule, FormsModule, RouterModule],
+  template: `
+    <section class="studio" aria-labelledby="product-studio-title">
+      <header class="hero">
+        <p class="eyebrow">Product Studio</p>
+        <h1 id="product-studio-title">Create trusted learning products</h1>
+        <p>
+          Start with a product shell, connect it to a project, and optionally wrap an existing
+          course-backed runtime product. AI generation, analysis, approval, and publishing remain
+          future steps.
+        </p>
+        <div class="hero-actions">
+          <a routerLink="/workspace/product-studio/courses/new">Open existing course wizard</a>
+          <a routerLink="/workspace/products">View product catalog</a>
+        </div>
+      </header>
+
+      <div class="metrics" aria-label="Product Studio summary">
+        <article><strong>{{ workspaces.length }}</strong><span>Workspaces</span></article>
+        <article><strong>{{ projects.length }}</strong><span>Projects</span></article>
+        <article><strong>{{ products.length }}</strong><span>Products</span></article>
+        <article><strong>{{ courseBackedProductCount }}</strong><span>Course-backed</span></article>
+      </div>
+
+      <div class="grid">
+        <form class="panel" (ngSubmit)="createProject()" aria-labelledby="new-project-title">
+          <div>
+            <p class="eyebrow">Step 1</p>
+            <h2 id="new-project-title">Create Project Shell</h2>
+            <p class="muted">Projects organize sources, artifacts, generation runs, and future product work.</p>
+          </div>
+
+          <label>
+            Workspace
+            <select name="projectWorkspace" [(ngModel)]="projectWorkspaceId" required>
+              <option value="" disabled>Select workspace</option>
+              <option *ngFor="let workspace of workspaces" [value]="workspace.id">{{ workspace.name }}</option>
+            </select>
+          </label>
+
+          <label>
+            Project name
+            <input name="projectName" [(ngModel)]="projectName" required placeholder="Implementation onboarding" />
+          </label>
+
+          <label>
+            Description
+            <textarea name="projectDescription" [(ngModel)]="projectDescription" rows="3" placeholder="What knowledge should this project organize?"></textarea>
+          </label>
+
+          <button type="submit" [disabled]="savingProject || !projectWorkspaceId || !projectName">
+            {{ savingProject ? 'Creating...' : 'Create Project Shell' }}
+          </button>
+        </form>
+
+        <form class="panel" (ngSubmit)="createProduct()" aria-labelledby="new-product-title">
+          <div>
+            <p class="eyebrow">Step 2</p>
+            <h2 id="new-product-title">Create Product Shell</h2>
+            <p class="muted">This creates only a V2 wrapper. It does not create courses, lessons, units, or activities.</p>
+          </div>
+
+          <label>
+            Product type
+            <select name="productType" [(ngModel)]="productType" required>
+              <option *ngFor="let type of productTypes" [value]="type">{{ label(type) }}</option>
+            </select>
+          </label>
+
+          <label>
+            Project
+            <select name="productProject" [(ngModel)]="productProjectId">
+              <option value="">No project yet</option>
+              <option *ngFor="let project of projects" [value]="project.id">{{ project.name }}</option>
+            </select>
+          </label>
+
+          <label>
+            Existing course runtime link
+            <select name="courseLink" [(ngModel)]="selectedCourseId" (ngModelChange)="syncCourseTitle()">
+              <option value="">No existing course</option>
+              <option *ngFor="let course of courses" [value]="course.id">{{ course.title }}</option>
+            </select>
+          </label>
+
+          <label>
+            Product title
+            <input name="productTitle" [(ngModel)]="productTitle" required placeholder="API onboarding track" />
+          </label>
+
+          <label>
+            Description
+            <textarea name="productDescription" [(ngModel)]="productDescription" rows="3" placeholder="What should learners or members get from this product?"></textarea>
+          </label>
+
+          <div class="checklist" aria-label="Draft setup checklist">
+            <p>Draft setup checklist</p>
+            <span>Project selected: {{ productProjectId ? 'ready' : 'optional' }}</span>
+            <span>Runtime link: {{ selectedCourseId ? 'course-backed' : 'new shell only' }}</span>
+            <span>AI generation: not implemented yet</span>
+            <span>Governance: existing course/lesson rules remain authoritative</span>
+          </div>
+
+          <button type="submit" [disabled]="savingProduct || !productTitle || !workspaceForProduct">
+            {{ savingProduct ? 'Creating...' : 'Create Product Shell' }}
+          </button>
+        </form>
+      </div>
+
+      <p class="status" *ngIf="statusMessage" role="status">{{ statusMessage }}</p>
+
+      <section class="panel">
+        <div class="list-head">
+          <div>
+            <p class="eyebrow">Inventory</p>
+            <h2>Current products</h2>
+          </div>
+          <a routerLink="/workspace/products">Open full list</a>
+        </div>
+
+        <div class="empty" *ngIf="!products.length">No product shells exist yet.</div>
+        <div class="product-list" *ngIf="products.length">
+          <article *ngFor="let product of products">
+            <div>
+              <h3>{{ product.title }}</h3>
+              <p>{{ label(product.product_type) }} · {{ product.status }} · {{ product.review_state }}</p>
+              <p *ngIf="product.course_id" class="runtime">Links to existing course runtime</p>
+            </div>
+            <a [routerLink]="['/workspace/products', product.id]">Details</a>
+          </article>
+        </div>
+      </section>
+    </section>
+  `,
+  styles: [`
+    .studio { display: grid; gap: 1rem; padding: clamp(1rem, 3vw, 2rem); color: #0f172a; }
+    .hero, .panel, .metrics article { background: #fff; border: 1px solid rgba(15,23,42,.1); border-radius: 1.5rem; box-shadow: 0 18px 40px rgba(15,23,42,.08); }
+    .hero { padding: clamp(1.5rem, 4vw, 3rem); background: radial-gradient(circle at 85% 0%, rgba(14,116,144,.18), transparent 24rem), #fff; }
+    .eyebrow { color: #0e7490; font-size: .76rem; font-weight: 900; letter-spacing: .22em; margin: 0 0 .5rem; text-transform: uppercase; }
+    h1, h2, h3 { margin: 0; letter-spacing: -.03em; }
+    h1 { font-size: clamp(2rem, 5vw, 3.5rem); line-height: .95; }
+    .hero p { color: #334155; font-size: 1.05rem; line-height: 1.7; max-width: 74ch; }
+    .hero-actions, .list-head { align-items: center; display: flex; flex-wrap: wrap; gap: .75rem; justify-content: space-between; }
+    a, button { border-radius: 999px; font-weight: 900; min-height: 2.6rem; padding: .7rem 1rem; text-decoration: none; }
+    a { color: #0e7490; }
+    .hero-actions a, button { background: #0f172a; color: #fff; border: 0; }
+    button:disabled { background: #94a3b8; cursor: not-allowed; }
+    .metrics { display: grid; gap: .75rem; grid-template-columns: repeat(auto-fit, minmax(9rem, 1fr)); }
+    .metrics article { padding: 1rem; display: grid; gap: .25rem; }
+    .metrics strong { font-size: 2rem; }
+    .metrics span, .muted, .product-list p, .empty { color: #475569; }
+    .grid { display: grid; gap: 1rem; grid-template-columns: repeat(auto-fit, minmax(min(24rem, 100%), 1fr)); }
+    .panel { display: grid; gap: 1rem; padding: clamp(1rem, 3vw, 1.5rem); }
+    label { color: #334155; display: grid; font-weight: 800; gap: .4rem; }
+    input, select, textarea { border: 1px solid #cbd5e1; border-radius: .9rem; color: #0f172a; padding: .75rem .85rem; width: 100%; }
+    input:focus, select:focus, textarea:focus, button:focus-visible, a:focus-visible { outline: 3px solid rgba(14,116,144,.25); outline-offset: 3px; }
+    .checklist { background: #f8fafc; border: 1px solid #e2e8f0; border-radius: 1rem; display: grid; gap: .35rem; padding: .9rem; }
+    .checklist p { font-weight: 900; margin: 0; }
+    .status { background: #ecfeff; border-left: 4px solid #0e7490; border-radius: .75rem; color: #164e63; font-weight: 800; padding: .9rem 1rem; }
+    .product-list { display: grid; gap: .75rem; }
+    .product-list article { align-items: center; border: 1px solid #e2e8f0; border-radius: 1rem; display: flex; gap: 1rem; justify-content: space-between; padding: 1rem; }
+    .runtime { color: #0e7490 !important; font-weight: 800; }
+  `]
+})
+export class ProductStudioComponent implements OnInit {
+  readonly productTypes = PRODUCT_TYPES;
+  workspaces: Workspace[] = [];
+  projects: Project[] = [];
+  products: Product[] = [];
+  courses: Course[] = [];
+
+  projectWorkspaceId = '';
+  projectName = '';
+  projectDescription = '';
+  productType = 'course';
+  productProjectId = '';
+  selectedCourseId = '';
+  productTitle = '';
+  productDescription = '';
+  savingProject = false;
+  savingProduct = false;
+  statusMessage = '';
+
+  constructor(
+    private readonly v2Platform: V2PlatformService,
+    private readonly coursesService: CoursesService,
+  ) {}
+
+  ngOnInit(): void {
+    this.loadStudio();
+  }
+
+  get courseBackedProductCount(): number {
+    return this.products.filter(product => !!product.course_id).length;
+  }
+
+  get workspaceForProduct(): string {
+    const project = this.projects.find(candidate => candidate.id === this.productProjectId);
+    return project?.workspace_id || this.projectWorkspaceId || this.workspaces[0]?.id || '';
+  }
+
+  label(value: string): string {
+    return value.replace(/_/g, ' ').replace(/\b\w/g, char => char.toUpperCase());
+  }
+
+  syncCourseTitle(): void {
+    const course = this.courses.find(candidate => candidate.id === this.selectedCourseId);
+    if (course && !this.productTitle) {
+      this.productTitle = course.title;
+      this.productDescription = course.description;
+    }
+  }
+
+  createProject(): void {
+    if (!this.projectWorkspaceId || !this.projectName) {
+      return;
+    }
+    this.savingProject = true;
+    this.v2Platform.createProject({
+      workspace_id: this.projectWorkspaceId,
+      name: this.projectName,
+      description: this.projectDescription || null,
+      metadata: { source: 'product_studio_phase_3' },
+    }).subscribe({
+      next: project => {
+        this.statusMessage = `Project shell created: ${project.name}`;
+        this.productProjectId = project.id;
+        this.projectName = '';
+        this.projectDescription = '';
+        this.savingProject = false;
+        this.loadStudio();
+      },
+      error: () => {
+        this.statusMessage = 'Project shell could not be created.';
+        this.savingProject = false;
+      }
+    });
+  }
+
+  createProduct(): void {
+    if (!this.productTitle || !this.workspaceForProduct) {
+      return;
+    }
+    this.savingProduct = true;
+    this.v2Platform.createProduct({
+      workspace_id: this.workspaceForProduct,
+      project_id: this.productProjectId || null,
+      course_id: this.selectedCourseId || null,
+      product_type: this.productType,
+      title: this.productTitle,
+      description: this.productDescription || null,
+      status: 'draft',
+      review_state: this.selectedCourseId ? 'runtime_authoritative' : 'not_reviewed',
+      access_state: this.selectedCourseId ? 'existing_runtime' : 'private',
+      metadata: { source: 'product_studio_phase_3', ai_generation: 'not_implemented' },
+    }).subscribe({
+      next: product => {
+        this.statusMessage = `Product shell ready: ${product.title}`;
+        this.productTitle = '';
+        this.productDescription = '';
+        this.selectedCourseId = '';
+        this.savingProduct = false;
+        this.loadStudio();
+      },
+      error: () => {
+        this.statusMessage = 'Product shell could not be created.';
+        this.savingProduct = false;
+      }
+    });
+  }
+
+  private loadStudio(): void {
+    forkJoin({
+      workspaces: this.v2Platform.getWorkspaces(),
+      projects: this.v2Platform.getProjects(),
+      products: this.v2Platform.getProducts(),
+      courses: this.coursesService.getCourses(),
+    }).subscribe(({ workspaces, projects, products, courses }) => {
+      this.workspaces = workspaces;
+      this.projects = projects;
+      this.products = products;
+      this.courses = courses;
+      this.projectWorkspaceId ||= workspaces[0]?.id || '';
+    });
+  }
+}
diff --git a/frontend/src/app/pages/project-detail/project-detail.component.ts b/frontend/src/app/pages/project-detail/project-detail.component.ts
new file mode 100644
index 0000000..e66104f
--- /dev/null
+++ b/frontend/src/app/pages/project-detail/project-detail.component.ts
@@ -0,0 +1,253 @@
+import { CommonModule } from '@angular/common';
+import { Component, OnInit, inject } from '@angular/core';
+import { FormsModule } from '@angular/forms';
+import { ActivatedRoute, RouterModule } from '@angular/router';
+import { forkJoin } from 'rxjs';
+import {
+  Artifact,
+  GenerationRun,
+  KnowledgeSource,
+  Product,
+  Project,
+} from '../../models/v2-platform.model';
+import { V2PlatformService } from '../../services/v2-platform.service';
+
+@Component({
+  selector: 'app-project-detail',
+  standalone: true,
+  imports: [CommonModule, FormsModule, RouterModule],
+  template: `
+    <section class="project-detail" aria-labelledby="project-title">
+      <a class="back-link" routerLink="/workspace/projects">Back to projects</a>
+
+      <header *ngIf="project">
+        <p>Knowledge Pipeline</p>
+        <h1 id="project-title">{{ project.name }}</h1>
+        <span>{{ project.status }} · generation execution is not implemented yet</span>
+        <p class="summary">{{ project.description || 'Project shell for source-aware products and artifacts.' }}</p>
+      </header>
+
+      <div class="grid" *ngIf="project">
+        <form class="panel" (ngSubmit)="createKnowledgeSource()" aria-labelledby="source-form-title">
+          <h2 id="source-form-title">Create knowledge source shell</h2>
+          <p>No file upload or parsing runs here. This records a traceable source placeholder for future analysis.</p>
+          <label>
+            Source title
+            <input name="sourceTitle" [(ngModel)]="sourceForm.title" required />
+          </label>
+          <label>
+            Source type
+            <select name="sourceType" [(ngModel)]="sourceForm.source_type">
+              <option *ngFor="let type of sourceTypes" [value]="type">{{ label(type) }}</option>
+            </select>
+          </label>
+          <label>
+            URI or reference
+            <input name="sourceUri" [(ngModel)]="sourceForm.uri" placeholder="https://, repo path, or internal note" />
+          </label>
+          <label>
+            Citation
+            <textarea name="sourceCitation" [(ngModel)]="sourceForm.citation" rows="3"></textarea>
+          </label>
+          <button type="submit">Create source shell</button>
+        </form>
+
+        <form class="panel" (ngSubmit)="createArtifact()" aria-labelledby="artifact-form-title">
+          <h2 id="artifact-form-title">Create artifact shell</h2>
+          <p>Artifacts default to draft and review required. They do not publish to learners from this screen.</p>
+          <label>
+            Artifact title
+            <input name="artifactTitle" [(ngModel)]="artifactForm.title" required />
+          </label>
+          <label>
+            Artifact type
+            <select name="artifactType" [(ngModel)]="artifactForm.artifact_type">
+              <option *ngFor="let type of artifactTypes" [value]="type">{{ label(type) }}</option>
+            </select>
+          </label>
+          <label>
+            Related product
+            <select name="artifactProduct" [(ngModel)]="artifactForm.product_id">
+              <option [ngValue]="null">No product link yet</option>
+              <option *ngFor="let product of products" [value]="product.id">{{ product.title }}</option>
+            </select>
+          </label>
+          <label>
+            Related source
+            <select name="artifactSource" [(ngModel)]="artifactForm.knowledge_source_id">
+              <option [ngValue]="null">No source link yet</option>
+              <option *ngFor="let source of knowledgeSources" [value]="source.id">{{ source.title }}</option>
+            </select>
+          </label>
+          <label>
+            Body
+            <textarea name="artifactBody" [(ngModel)]="artifactForm.body" rows="5"></textarea>
+          </label>
+          <button type="submit">Create draft artifact</button>
+        </form>
+      </div>
+
+      <p class="message" role="status" *ngIf="message">{{ message }}</p>
+
+      <div class="registry">
+        <article class="panel">
+          <h2>Products</h2>
+          <p *ngIf="!products.length">No products are linked to this project yet.</p>
+          <a *ngFor="let product of products" [routerLink]="['/workspace/products', product.id]">
+            {{ product.title }} <span>{{ label(product.product_type) }}</span>
+          </a>
+        </article>
+
+        <article class="panel">
+          <h2>Knowledge Sources</h2>
+          <p *ngIf="!knowledgeSources.length">No knowledge source shells exist yet.</p>
+          <div *ngFor="let source of knowledgeSources" class="record">
+            <strong>{{ source.title }}</strong>
+            <span>{{ label(source.source_type) }} · {{ source.status }}</span>
+            <small>{{ source.citation || source.uri || 'Traceability shell' }}</small>
+          </div>
+        </article>
+
+        <article class="panel">
+          <h2>Artifacts</h2>
+          <p *ngIf="!artifacts.length">No draft artifacts exist yet.</p>
+          <a *ngFor="let artifact of artifacts" [routerLink]="['/workspace/artifacts', artifact.id]">
+            {{ artifact.title }} <span>{{ label(artifact.artifact_type) }} · {{ artifact.review_state }}</span>
+          </a>
+        </article>
+
+        <article class="panel">
+          <h2>Generation Runs</h2>
+          <p>Execution is not implemented yet. Future AI runs will appear here with prompt and output metadata.</p>
+          <a *ngFor="let run of generationRuns" [routerLink]="['/workspace/product-studio/generation-runs', run.id]">
+            {{ run.model_name || 'Generation run' }} <span>{{ run.status }}</span>
+          </a>
+        </article>
+      </div>
+    </section>
+  `,
+  styles: [`
+    .project-detail { color: #0f172a; display: grid; gap: 1rem; padding: clamp(1rem, 3vw, 2rem); }
+    .back-link { color: #0e7490; font-weight: 900; text-decoration: none; width: fit-content; }
+    header, .panel, .message { background: #fff; border: 1px solid rgba(15,23,42,.1); border-radius: 1.4rem; box-shadow: 0 18px 40px rgba(15,23,42,.08); padding: clamp(1rem, 3vw, 1.5rem); }
+    header p:first-child { color: #0e7490; font-size: .76rem; font-weight: 900; letter-spacing: .22em; margin: 0 0 .5rem; text-transform: uppercase; }
+    h1, h2 { letter-spacing: -.03em; margin: 0; }
+    h1 { font-size: clamp(2rem, 5vw, 3rem); }
+    header span, a span, .record span { color: #0e7490; font-weight: 800; }
+    .summary, .panel p, small { color: #475569; }
+    .grid, .registry { display: grid; gap: 1rem; grid-template-columns: repeat(auto-fit, minmax(260px, 1fr)); }
+    form { align-content: start; display: grid; gap: .85rem; }
+    label { color: #334155; display: grid; font-size: .9rem; font-weight: 800; gap: .35rem; }
+    input, select, textarea { border: 1px solid #cbd5e1; border-radius: .8rem; color: #0f172a; font: inherit; padding: .75rem .85rem; }
+    input:focus, select:focus, textarea:focus, button:focus-visible, a:focus-visible { outline: 3px solid rgba(14,116,144,.25); outline-offset: 3px; }
+    button, .panel a { background: #0f172a; border: 0; border-radius: 999px; color: #fff; cursor: pointer; display: inline-flex; font-weight: 900; justify-content: center; padding: .8rem 1rem; text-decoration: none; }
+    .registry .panel { align-content: start; display: grid; gap: .75rem; }
+    .record { border-top: 1px solid #e2e8f0; display: grid; gap: .25rem; padding-top: .75rem; }
+    @media (max-width: 720px) { .project-detail { padding: 1rem; } }
+  `]
+})
+export class ProjectDetailComponent implements OnInit {
+  private readonly route = inject(ActivatedRoute);
+  private readonly v2Platform = inject(V2PlatformService);
+
+  project: Project | null = null;
+  products: Product[] = [];
+  knowledgeSources: KnowledgeSource[] = [];
+  artifacts: Artifact[] = [];
+  generationRuns: GenerationRun[] = [];
+  message = '';
+
+  readonly sourceTypes = ['repository', 'document', 'pdf', 'url', 'transcript', 'upload', 'manual_note'];
+  readonly artifactTypes = ['outline', 'documentation', 'guide', 'checklist', 'source_map', 'export_bundle', 'assessment_seed', 'lesson_draft'];
+
+  sourceForm = {
+    title: '',
+    source_type: 'document',
+    uri: '',
+    citation: '',
+  };
+
+  artifactForm = {
+    title: '',
+    artifact_type: 'documentation',
+    product_id: null as string | null,
+    knowledge_source_id: null as string | null,
+    body: '',
+  };
+
+  ngOnInit(): void {
+    this.load();
+  }
+
+  createKnowledgeSource(): void {
+    if (!this.project || !this.sourceForm.title.trim()) {
+      return;
+    }
+
+    this.v2Platform.createKnowledgeSource({
+      workspace_id: this.project.workspace_id,
+      project_id: this.project.id,
+      title: this.sourceForm.title.trim(),
+      source_type: this.sourceForm.source_type,
+      uri: this.sourceForm.uri || null,
+      citation: this.sourceForm.citation || null,
+      metadata: { created_from: 'project_detail_shell' },
+    }).subscribe(source => {
+      this.knowledgeSources = [...this.knowledgeSources, source];
+      this.sourceForm = { title: '', source_type: 'document', uri: '', citation: '' };
+      this.message = 'Knowledge source shell created. No file parsing or AI analysis was run.';
+    });
+  }
+
+  createArtifact(): void {
+    if (!this.project || !this.artifactForm.title.trim()) {
+      return;
+    }
+
+    this.v2Platform.createArtifact({
+      workspace_id: this.project.workspace_id,
+      project_id: this.project.id,
+      product_id: this.artifactForm.product_id,
+      knowledge_source_id: this.artifactForm.knowledge_source_id,
+      artifact_type: this.artifactForm.artifact_type,
+      title: this.artifactForm.title.trim(),
+      body: this.artifactForm.body || null,
+      metadata: { created_from: 'manual_artifact_shell' },
+    }).subscribe(artifact => {
+      this.artifacts = [...this.artifacts, artifact];
+      this.artifactForm = {
+        title: '',
+        artifact_type: 'documentation',
+        product_id: null,
+        knowledge_source_id: null,
+        body: '',
+      };
+      this.message = 'Draft artifact created. It remains review-required and is not learner-deliverable.';
+    });
+  }
+
+  label(value: string): string {
+    return value.replace(/_/g, ' ').replace(/\b\w/g, char => char.toUpperCase());
+  }
+
+  private load(): void {
+    const projectId = this.route.snapshot.paramMap.get('projectId');
+    if (!projectId) {
+      return;
+    }
+
+    forkJoin({
+      project: this.v2Platform.getProject(projectId),
+      products: this.v2Platform.getProducts({ projectId }),
+      knowledgeSources: this.v2Platform.getProjectKnowledgeSources(projectId),
+      artifacts: this.v2Platform.getProjectArtifacts(projectId),
+      generationRuns: this.v2Platform.getProjectGenerationRuns(projectId),
+    }).subscribe(result => {
+      this.project = result.project;
+      this.products = result.products;
+      this.knowledgeSources = result.knowledgeSources;
+      this.artifacts = result.artifacts;
+      this.generationRuns = result.generationRuns;
+    });
+  }
+}
diff --git a/frontend/src/app/pages/v2-platform/v2-collection-page.component.ts b/frontend/src/app/pages/v2-platform/v2-collection-page.component.ts
new file mode 100644
index 0000000..93a89b5
--- /dev/null
+++ b/frontend/src/app/pages/v2-platform/v2-collection-page.component.ts
@@ -0,0 +1,132 @@
+import { CommonModule } from '@angular/common';
+import { Component, OnInit, inject } from '@angular/core';
+import { ActivatedRoute, RouterModule } from '@angular/router';
+import { Observable, of, switchMap } from 'rxjs';
+import { V2PlatformService } from '../../services/v2-platform.service';
+
+type CollectionType = 'projects' | 'products' | 'knowledge-sources' | 'artifacts' | 'generation-runs';
+
+interface CollectionItem {
+  id: string;
+  title: string;
+  subtitle: string;
+  status: string;
+  detailRoute?: string;
+}
+
+@Component({
+  selector: 'app-v2-collection-page',
+  standalone: true,
+  imports: [CommonModule, RouterModule],
+  template: `
+    <section class="collection" aria-labelledby="collection-title">
+      <header>
+        <p>{{ eyebrow }}</p>
+        <h1 id="collection-title">{{ title }}</h1>
+        <span role="status">{{ status }}</span>
+      </header>
+
+      <div class="empty" *ngIf="(items$ | async) as items">
+        <ng-container *ngIf="items.length; else noItems">
+          <article *ngFor="let item of items">
+            <div>
+              <h2>{{ item.title }}</h2>
+              <p>{{ item.subtitle }}</p>
+              <span>{{ item.status }}</span>
+            </div>
+            <a *ngIf="item.detailRoute" [routerLink]="item.detailRoute">Open</a>
+          </article>
+        </ng-container>
+      </div>
+
+      <ng-template #noItems>
+        <div class="no-items">
+          <h2>No records yet</h2>
+          <p>{{ emptyText }}</p>
+        </div>
+      </ng-template>
+    </section>
+  `,
+  styles: [`
+    .collection { display: grid; gap: 1rem; padding: clamp(1rem, 3vw, 2rem); color: #0f172a; }
+    header, article, .no-items { background: #fff; border: 1px solid rgba(15,23,42,.1); border-radius: 1.4rem; box-shadow: 0 18px 40px rgba(15,23,42,.08); padding: clamp(1rem, 3vw, 1.5rem); }
+    header p { color: #0e7490; font-size: .76rem; font-weight: 900; letter-spacing: .22em; margin: 0 0 .5rem; text-transform: uppercase; }
+    h1, h2 { margin: 0; letter-spacing: -.03em; }
+    h1 { font-size: clamp(2rem, 5vw, 3rem); }
+    header span, article span { color: #0e7490; font-weight: 800; }
+    .empty { display: grid; gap: .75rem; }
+    article { align-items: center; display: flex; gap: 1rem; justify-content: space-between; }
+    article p, .no-items p { color: #475569; margin: .35rem 0; }
+    a { background: #0f172a; border-radius: 999px; color: #fff; font-weight: 900; padding: .7rem 1rem; text-decoration: none; }
+    a:focus-visible { outline: 3px solid rgba(14,116,144,.25); outline-offset: 3px; }
+  `]
+})
+export class V2CollectionPageComponent implements OnInit {
+  private readonly route = inject(ActivatedRoute);
+  private readonly v2Platform = inject(V2PlatformService);
+
+  eyebrow = '';
+  title = '';
+  status = '';
+  emptyText = '';
+  items$: Observable<CollectionItem[]> = of([]);
+
+  ngOnInit(): void {
+    this.route.data.subscribe(data => {
+      const collection = data['collection'] as CollectionType;
+      this.eyebrow = data['eyebrow'] as string;
+      this.title = data['title'] as string;
+      this.status = data['status'] as string;
+      this.emptyText = data['emptyText'] as string;
+      this.items$ = this.loadCollection(collection);
+    });
+  }
+
+  private loadCollection(collection: CollectionType): Observable<CollectionItem[]> {
+    switch (collection) {
+      case 'projects':
+        return this.v2Platform.getProjects().pipe(switchMap(items => of(items.map(item => ({
+          id: item.id,
+          title: item.name,
+          subtitle: item.description || 'Project shell',
+          status: item.status,
+          detailRoute: `/workspace/projects/${item.id}`,
+        })))));
+      case 'products':
+        return this.v2Platform.getProducts().pipe(switchMap(items => of(items.map(item => ({
+          id: item.id,
+          title: item.title,
+          subtitle: `${this.label(item.product_type)}${item.course_id ? ' - course-backed runtime link' : ''}`,
+          status: `${item.status} - ${item.review_state}`,
+          detailRoute: `/workspace/products/${item.id}`,
+        })))));
+      case 'knowledge-sources':
+        return this.v2Platform.getKnowledgeSources().pipe(switchMap(items => of(items.map(item => ({
+          id: item.id,
+          title: item.title,
+          subtitle: item.citation || item.uri || this.label(item.source_type),
+          status: item.status,
+        })))));
+      case 'artifacts':
+        return this.v2Platform.getArtifacts().pipe(switchMap(items => of(items.map(item => ({
+          id: item.id,
+          title: item.title,
+          subtitle: this.label(item.artifact_type),
+          status: `${item.status} - ${item.review_state}`,
+          detailRoute: `/workspace/artifacts/${item.id}`,
+        })))));
+      case 'generation-runs':
+        return this.v2Platform.getGenerationRuns().pipe(switchMap(items => of(items.map(item => ({
+          id: item.id,
+          title: item.model_name || 'Generation run',
+          subtitle: item.output_summary || item.prompt || 'AI execution metadata placeholder',
+          status: item.status,
+          detailRoute: `/workspace/product-studio/generation-runs/${item.id}`,
+        })))));
+    }
+  }
+
+  private label(value: string): string {
+    return value.replace(/_/g, ' ').replace(/\b\w/g, char => char.toUpperCase());
+  }
+}
diff --git a/frontend/src/app/services/v2-platform.service.spec.ts b/frontend/src/app/services/v2-platform.service.spec.ts
new file mode 100644
index 0000000..51d1075
--- /dev/null
+++ b/frontend/src/app/services/v2-platform.service.spec.ts
@@ -0,0 +1,185 @@
+import { HttpClientTestingModule, HttpTestingController } from '@angular/common/http/testing';
+import { TestBed } from '@angular/core/testing';
+import { environment } from '../../environments/environment';
+import { V2PlatformService } from './v2-platform.service';
+
+describe('V2PlatformService', () => {
+  let service: V2PlatformService;
+  let httpMock: HttpTestingController;
+
+  beforeEach(() => {
+    TestBed.configureTestingModule({
+      imports: [HttpClientTestingModule]
+    });
+    service = TestBed.inject(V2PlatformService);
+    httpMock = TestBed.inject(HttpTestingController);
+  });
+
+  afterEach(() => {
+    httpMock.verify();
+  });
+
+  it('lists products from the V2 product API', () => {
+    service.getProducts({ workspaceId: 'workspace-1' }).subscribe(products => {
+      expect(products.length).toBe(1);
+      expect(products[0].course_id).toBe('course-1');
+    });
+
+    const request = httpMock.expectOne(`${environment.apiUrl}/api/products?workspace_id=workspace-1`);
+    expect(request.request.method).toBe('GET');
+    request.flush([
+      {
+        id: 'product-1',
+        workspace_id: 'workspace-1',
+        project_id: null,
+        course_id: 'course-1',
+        program_id: null,
+        product_type: 'course',
+        title: 'Course Product',
+        description: 'Course-backed',
+        status: 'active',
+        review_state: 'runtime_authoritative',
+        access_state: 'existing_runtime',
+        metadata: {},
+        published_at: null,
+        created_at: '2026-01-01T00:00:00',
+        updated_at: '2026-01-01T00:00:00',
+      },
+    ]);
+  });
+
+  it('creates project shells through the V2 project API', () => {
+    service.createProject({
+      workspace_id: 'workspace-1',
+      name: 'Project Shell',
+      description: 'Additive project',
+    }).subscribe(project => {
+      expect(project.name).toBe('Project Shell');
+    });
+
+    const request = httpMock.expectOne(`${environment.apiUrl}/api/projects`);
+    expect(request.request.method).toBe('POST');
+    expect(request.request.body.workspace_id).toBe('workspace-1');
+    request.flush({
+      id: 'project-1',
+      workspace_id: 'workspace-1',
+      name: 'Project Shell',
+      description: 'Additive project',
+      status: 'active',
+      metadata: {},
+      created_at: '2026-01-01T00:00:00',
+      updated_at: '2026-01-01T00:00:00',
+    });
+  });
+
+  it('creates product shells through the V2 product API', () => {
+    service.createProduct({
+      workspace_id: 'workspace-1',
+      project_id: 'project-1',
+      course_id: 'course-1',
+      product_type: 'course',
+      title: 'Course Product',
+    }).subscribe(product => {
+      expect(product.title).toBe('Course Product');
+      expect(product.course_id).toBe('course-1');
+    });
+
+    const request = httpMock.expectOne(`${environment.apiUrl}/api/products`);
+    expect(request.request.method).toBe('POST');
+    expect(request.request.body.course_id).toBe('course-1');
+    request.flush({
+      id: 'product-1',
+      workspace_id: 'workspace-1',
+      project_id: 'project-1',
+      course_id: 'course-1',
+      program_id: null,
+      product_type: 'course',
+      title: 'Course Product',
+      description: null,
+      status: 'draft',
+      review_state: 'runtime_authoritative',
+      access_state: 'existing_runtime',
+      metadata: {},
+      published_at: null,
+      created_at: '2026-01-01T00:00:00',
+      updated_at: '2026-01-01T00:00:00',
+    });
+  });
+
+  it('creates knowledge source shells through the V2 source API', () => {
+    service.createKnowledgeSource({
+      workspace_id: 'workspace-1',
+      project_id: 'project-1',
+      title: 'Repository Source',
+      source_type: 'repository',
+      uri: 'https://example.com/repo',
+    }).subscribe(source => {
+      expect(source.title).toBe('Repository Source');
+      expect(source.project_id).toBe('project-1');
+    });
+
+    const request = httpMock.expectOne(`${environment.apiUrl}/api/knowledge-sources`);
+    expect(request.request.method).toBe('POST');
+    expect(request.request.body.source_type).toBe('repository');
+    request.flush({
+      id: 'source-1',
+      workspace_id: 'workspace-1',
+      project_id: 'project-1',
+      source_id: null,
+      title: 'Repository Source',
+      source_type: 'repository',
+      uri: 'https://example.com/repo',
+      citation: null,
+      content_hash: null,
+      status: 'available',
+      metadata: {},
+      created_at: '2026-01-01T00:00:00',
+      updated_at: '2026-01-01T00:00:00',
+    });
+  });
+
+  it('creates artifact shells through the V2 artifact API', () => {
+    service.createArtifact({
+      workspace_id: 'workspace-1',
+      project_id: 'project-1',
+      product_id: 'product-1',
+      knowledge_source_id: 'source-1',
+      artifact_type: 'guide',
+      title: 'Implementation Guide',
+      body: 'Reviewable draft',
+    }).subscribe(artifact => {
+      expect(artifact.title).toBe('Implementation Guide');
+      expect(artifact.review_state).toBe('review_required');
+    });
+
+    const request = httpMock.expectOne(`${environment.apiUrl}/api/artifacts`);
+    expect(request.request.method).toBe('POST');
+    expect(request.request.body.knowledge_source_id).toBe('source-1');
+    request.flush({
+      id: 'artifact-1',
+      workspace_id: 'workspace-1',
+      project_id: 'project-1',
+      product_id: 'product-1',
+      generation_run_id: null,
+      knowledge_source_id: 'source-1',
+      artifact_type: 'guide',
+      title: 'Implementation Guide',
+      body: 'Reviewable draft',
+      uri: null,
+      status: 'draft',
+      review_state: 'review_required',
+      metadata: {},
+      created_at: '2026-01-01T00:00:00',
+      updated_at: '2026-01-01T00:00:00',
+    });
+  });
+
+  it('reads project-scoped pipeline collections', () => {
+    service.getProjectKnowledgeSources('project-1').subscribe(sources => {
+      expect(sources.length).toBe(0);
+    });
+    const request = httpMock.expectOne(`${environment.apiUrl}/api/projects/project-1/knowledge-sources`);
+    expect(request.request.method).toBe('GET');
+    request.flush([]);
+  });
+});
diff --git a/frontend/src/app/services/v2-platform.service.ts b/frontend/src/app/services/v2-platform.service.ts
new file mode 100644
index 0000000..6c3aab2
--- /dev/null
+++ b/frontend/src/app/services/v2-platform.service.ts
@@ -0,0 +1,104 @@
+import { Injectable } from '@angular/core';
+import { HttpClient, HttpParams } from '@angular/common/http';
+import { Observable } from 'rxjs';
+import { environment } from '../../environments/environment';
+import {
+  Artifact,
+  ArtifactCreateRequest,
+  GenerationRun,
+  KnowledgeSource,
+  KnowledgeSourceCreateRequest,
+  Product,
+  ProductCreateRequest,
+  Project,
+  ProjectCreateRequest,
+  Workspace,
+} from '../models/v2-platform.model';
+
+@Injectable({
+  providedIn: 'root'
+})
+export class V2PlatformService {
+  private readonly apiUrl = `${environment.apiUrl}/api`;
+
+  constructor(private readonly http: HttpClient) {}
+
+  getWorkspaces(): Observable<Workspace[]> {
+    return this.http.get<Workspace[]>(`${this.apiUrl}/workspaces`);
+  }
+
+  getProjects(workspaceId?: string): Observable<Project[]> {
+    const params = workspaceId ? new HttpParams().set('workspace_id', workspaceId) : undefined;
+    return this.http.get<Project[]>(`${this.apiUrl}/projects`, { params });
+  }
+
+  getProject(projectId: string): Observable<Project> {
+    return this.http.get<Project>(`${this.apiUrl}/projects/${projectId}`);
+  }
+
+  createProject(payload: ProjectCreateRequest): Observable<Project> {
+    return this.http.post<Project>(`${this.apiUrl}/projects`, payload);
+  }
+
+  getProducts(filters: { workspaceId?: string; projectId?: string } = {}): Observable<Product[]> {
+    let params = new HttpParams();
+    if (filters.workspaceId) {
+      params = params.set('workspace_id', filters.workspaceId);
+    }
+    if (filters.projectId) {
+      params = params.set('project_id', filters.projectId);
+    }
+    return this.http.get<Product[]>(`${this.apiUrl}/products`, { params });
+  }
+
+  getProduct(productId: string): Observable<Product> {
+    return this.http.get<Product>(`${this.apiUrl}/products/${productId}`);
+  }
+
+  createProduct(payload: ProductCreateRequest): Observable<Product> {
+    return this.http.post<Product>(`${this.apiUrl}/products`, payload);
+  }
+
+  getKnowledgeSources(projectId?: string): Observable<KnowledgeSource[]> {
+    const params = projectId ? new HttpParams().set('project_id', projectId) : undefined;
+    return this.http.get<KnowledgeSource[]>(`${this.apiUrl}/knowledge-sources`, { params });
+  }
+
+  getProjectKnowledgeSources(projectId: string): Observable<KnowledgeSource[]> {
+    return this.http.get<KnowledgeSource[]>(`${this.apiUrl}/projects/${projectId}/knowledge-sources`);
+  }
+
+  createKnowledgeSource(payload: KnowledgeSourceCreateRequest): Observable<KnowledgeSource> {
+    return this.http.post<KnowledgeSource>(`${this.apiUrl}/knowledge-sources`, payload);
+  }
+
+  getArtifacts(projectId?: string): Observable<Artifact[]> {
+    const params = projectId ? new HttpParams().set('project_id', projectId) : undefined;
+    return this.http.get<Artifact[]>(`${this.apiUrl}/artifacts`, { params });
+  }
+
+  getProjectArtifacts(projectId: string): Observable<Artifact[]> {
+    return this.http.get<Artifact[]>(`${this.apiUrl}/projects/${projectId}/artifacts`);
+  }
+
+  getArtifact(artifactId: string): Observable<Artifact> {
+    return this.http.get<Artifact>(`${this.apiUrl}/artifacts/${artifactId}`);
+  }
+
+  createArtifact(payload: ArtifactCreateRequest): Observable<Artifact> {
+    return this.http.post<Artifact>(`${this.apiUrl}/artifacts`, payload);
+  }
+
+  getGenerationRuns(projectId?: string): Observable<GenerationRun[]> {
+    const params = projectId ? new HttpParams().set('project_id', projectId) : undefined;
+    return this.http.get<GenerationRun[]>(`${this.apiUrl}/generation-runs`, { params });
+  }
+
+  getProjectGenerationRuns(projectId: string): Observable<GenerationRun[]> {
+    return this.http.get<GenerationRun[]>(`${this.apiUrl}/projects/${projectId}/generation-runs`);
+  }
+
+  getGenerationRun(generationRunId: string): Observable<GenerationRun> {
+    return this.http.get<GenerationRun>(`${this.apiUrl}/generation-runs/${generationRunId}`);
+  }
+}
diff --git a/openspec/changes/echoed-v2-platform-evolution/tasks.md b/openspec/changes/echoed-v2-platform-evolution/tasks.md
index b760beb..3573f8d 100644
--- a/openspec/changes/echoed-v2-platform-evolution/tasks.md
+++ b/openspec/changes/echoed-v2-platform-evolution/tasks.md
@@ -14,31 +14,31 @@
 
 ## Phase 2: Wrapper Models For Workspace, Project, Product, Artifact, KnowledgeSource, GenerationRun
 
-- [ ] Design additive SQLAlchemy models and Alembic migrations for workspace, project, product, knowledge source, artifact, and generation run wrappers
-- [ ] Backfill workspace records from existing organizations
-- [ ] Backfill course-backed product records from existing courses
-- [ ] Add nullable or join-based links from new wrapper records to existing runtime records
-- [ ] Preserve existing course, program, lesson, progress, assessment, and certification schemas
-- [ ] Add backend tests for non-destructive backfill behavior
-- [ ] Add API read endpoints for wrapper records without replacing existing course APIs
+- [x] Design additive SQLAlchemy models and Alembic migrations for workspace, project, product, knowledge source, artifact, and generation run wrappers
+- [x] Backfill workspace records from existing organizations
+- [x] Backfill course-backed product records from existing courses
+- [x] Add nullable or join-based links from new wrapper records to existing runtime records
+- [x] Preserve existing course, program, lesson, progress, assessment, and certification schemas
+- [x] Add backend tests for non-destructive backfill behavior
+- [x] Add API read endpoints for wrapper records without replacing existing course APIs
 
 ## Phase 3: Product Studio Foundation
 
-- [ ] Reframe the existing course wizard as the first Product Studio workflow
-- [ ] Add product type selection with course-backed product as the initial supported type
-- [ ] Add project connection step that can be skipped for existing course creation
-- [ ] Preserve current course create/edit behavior
-- [ ] Add draft publishing checklist using existing lesson readiness and governance signals
-- [ ] Add tests for course creation through the Product Studio route alias
+- [x] Reframe the existing course wizard as the first Product Studio workflow
+- [x] Add product type selection with course-backed product as the initial supported type
+- [x] Add project connection step that can be skipped for existing course creation
+- [x] Preserve current course create/edit behavior
+- [x] Add draft publishing checklist using existing lesson readiness and governance signals
+- [x] Add tests for course creation through the Product Studio route alias
 
 ## Phase 4: Knowledge Pipeline And Artifact Registry
 
-- [ ] Add knowledge source management screens and APIs
-- [ ] Add artifact registry screens and APIs
-- [ ] Link artifacts to projects, products, knowledge sources, and existing course/lesson records where applicable
-- [ ] Represent current source-backed lesson data in the knowledge pipeline without deleting original source rows
-- [ ] Add generation run history for future AI-assisted workflows
-- [ ] Add tests for source and artifact linkage
+- [x] Add knowledge source management screens and APIs
+- [x] Add artifact registry screens and APIs
+- [x] Link artifacts to projects, products, knowledge sources, and existing course/lesson records where applicable
+- [x] Represent current source-backed lesson data in the knowledge pipeline without deleting original source rows
+- [x] Add generation run history for future AI-assisted workflows
+- [x] Add tests for source and artifact linkage
 
 ## Phase 5: Review Center Expansion
 

From 302e57797bf72c16fe0471b87f377f19b0dbddab Mon Sep 17 00:00:00 2001
From: Anthony Wright <anthony@mrwrite.dev>
Date: Tue, 30 Jun 2026 17:12:42 -0500
Subject: [PATCH 14/14] echoed-v2-platform-evolution

---
 .../b3d2c1e4f607_add_access_grants.py         | 153 ++++
 backend/app/api/routes/analytics.py           | 328 ++++++++-
 backend/app/api/routes/v2_platform.py         | 501 ++++++++++++-
 backend/app/models.py                         |  31 +
 backend/app/schemas.py                        |  87 +++
 backend/tests/test_v2_platform_wrappers.py    | 690 +++++++++++++++++-
 frontend/src/app/app.routes.spec.ts           |  15 +
 frontend/src/app/app.routes.ts                |  51 +-
 .../echo-sidebar/echo-sidebar.component.ts    |   1 +
 frontend/src/app/models/v2-platform.model.ts  |  84 +++
 .../access-grants/access-grants.component.ts  | 186 +++++
 .../learner-portal.component.ts               | 197 +++++
 .../learner-products.component.ts             | 154 ++++
 .../learner-resources.component.ts            |  35 +
 .../review-center/review-center.component.ts  | 162 ++++
 .../workspace-analytics.component.ts          | 193 +++++
 .../app/services/analytics.service.spec.ts    |  79 ++
 .../src/app/services/analytics.service.ts     | 107 +++
 .../src/app/services/permissions.service.ts   |   1 +
 .../app/services/v2-platform.service.spec.ts  | 251 +++++++
 .../src/app/services/v2-platform.service.ts   |  43 ++
 .../echoed-v2-platform-evolution/tasks.md     |  34 +-
 22 files changed, 3329 insertions(+), 54 deletions(-)
 create mode 100644 backend/alembic/versions/b3d2c1e4f607_add_access_grants.py
 create mode 100644 frontend/src/app/pages/access-grants/access-grants.component.ts
 create mode 100644 frontend/src/app/pages/learner-portal/learner-portal.component.ts
 create mode 100644 frontend/src/app/pages/learner-portal/learner-products.component.ts
 create mode 100644 frontend/src/app/pages/learner-portal/learner-resources.component.ts
 create mode 100644 frontend/src/app/pages/review-center/review-center.component.ts
 create mode 100644 frontend/src/app/pages/workspace-analytics/workspace-analytics.component.ts

diff --git a/backend/alembic/versions/b3d2c1e4f607_add_access_grants.py b/backend/alembic/versions/b3d2c1e4f607_add_access_grants.py
new file mode 100644
index 0000000..57ce3e2
--- /dev/null
+++ b/backend/alembic/versions/b3d2c1e4f607_add_access_grants.py
@@ -0,0 +1,153 @@
+"""add access grants
+
+Revision ID: b3d2c1e4f607
+Revises: a2f4c6d8e9b1
+Create Date: 2026-06-30 16:55:00.000000
+"""
+
+from datetime import datetime
+from typing import Sequence, Union
+import uuid
+
+from alembic import op
+import sqlalchemy as sa
+
+
+revision: str = "b3d2c1e4f607"
+down_revision: Union[str, Sequence[str], None] = "a2f4c6d8e9b1"
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    op.create_table(
+        "access_grants",
+        sa.Column("id", sa.UUID(), nullable=False),
+        sa.Column("user_id", sa.UUID(), nullable=False),
+        sa.Column("product_id", sa.UUID(), nullable=False),
+        sa.Column("workspace_id", sa.UUID(), nullable=False),
+        sa.Column("project_id", sa.UUID(), nullable=True),
+        sa.Column("grant_type", sa.String(), nullable=False, server_default="manual"),
+        sa.Column("status", sa.String(), nullable=False, server_default="active"),
+        sa.Column("source", sa.String(), nullable=False, server_default="manual"),
+        sa.Column("starts_at", sa.DateTime(), nullable=True),
+        sa.Column("expires_at", sa.DateTime(), nullable=True),
+        sa.Column("revoked_at", sa.DateTime(), nullable=True),
+        sa.Column("metadata", sa.JSON(), nullable=True),
+        sa.Column("created_at", sa.DateTime(), nullable=True),
+        sa.Column("updated_at", sa.DateTime(), nullable=True),
+        sa.ForeignKeyConstraint(["product_id"], ["products.id"]),
+        sa.ForeignKeyConstraint(["project_id"], ["projects.id"]),
+        sa.ForeignKeyConstraint(["user_id"], ["users.id"]),
+        sa.ForeignKeyConstraint(["workspace_id"], ["workspaces.id"]),
+        sa.PrimaryKeyConstraint("id"),
+        sa.UniqueConstraint("user_id", "product_id", "grant_type", name="uq_access_grant_user_product_type"),
+    )
+    op.create_index(op.f("ix_access_grants_id"), "access_grants", ["id"], unique=False)
+    op.create_index("ix_access_grants_user_id", "access_grants", ["user_id"], unique=False)
+    op.create_index("ix_access_grants_product_id", "access_grants", ["product_id"], unique=False)
+    op.create_index("ix_access_grants_workspace_id", "access_grants", ["workspace_id"], unique=False)
+    _backfill_enrollment_grants()
+
+
+def downgrade() -> None:
+    op.drop_index("ix_access_grants_workspace_id", table_name="access_grants")
+    op.drop_index("ix_access_grants_product_id", table_name="access_grants")
+    op.drop_index("ix_access_grants_user_id", table_name="access_grants")
+    op.drop_index(op.f("ix_access_grants_id"), table_name="access_grants")
+    op.drop_table("access_grants")
+
+
+def _backfill_enrollment_grants() -> None:
+    connection = op.get_bind()
+    now = datetime.utcnow()
+    rows = []
+    seen: set[tuple[object, object]] = set()
+
+    course_rows = connection.execute(
+        sa.text(
+            """
+            SELECT
+                sc.student_id AS user_id,
+                sc.status AS enrollment_status,
+                sc.enrolled_on AS starts_at,
+                p.id AS product_id,
+                p.workspace_id AS workspace_id,
+                p.project_id AS project_id
+            FROM student_courses sc
+            JOIN products p ON p.course_id = sc.course_id
+            """
+        )
+    ).mappings()
+    for row in course_rows:
+        key = (row["user_id"], row["product_id"])
+        if key in seen:
+            continue
+        seen.add(key)
+        rows.append(_grant_row(row, now, "student_course_backfill"))
+
+    program_rows = connection.execute(
+        sa.text(
+            """
+            SELECT
+                spp.student_id AS user_id,
+                spp.status AS enrollment_status,
+                spp.enrolled_on AS starts_at,
+                p.id AS product_id,
+                p.workspace_id AS workspace_id,
+                p.project_id AS project_id
+            FROM student_program_progress spp
+            JOIN products p ON p.program_id = spp.program_id
+            """
+        )
+    ).mappings()
+    for row in program_rows:
+        key = (row["user_id"], row["product_id"])
+        if key in seen:
+            continue
+        seen.add(key)
+        rows.append(_grant_row(row, now, "student_program_progress_backfill"))
+
+    if rows:
+        op.bulk_insert(
+            sa.table(
+                "access_grants",
+                sa.column("id", sa.UUID()),
+                sa.column("user_id", sa.UUID()),
+                sa.column("product_id", sa.UUID()),
+                sa.column("workspace_id", sa.UUID()),
+                sa.column("project_id", sa.UUID()),
+                sa.column("grant_type", sa.String()),
+                sa.column("status", sa.String()),
+                sa.column("source", sa.String()),
+                sa.column("starts_at", sa.DateTime()),
+                sa.column("expires_at", sa.DateTime()),
+                sa.column("revoked_at", sa.DateTime()),
+                sa.column("metadata", sa.JSON()),
+                sa.column("created_at", sa.DateTime()),
+                sa.column("updated_at", sa.DateTime()),
+            ),
+            rows,
+        )
+
+
+def _grant_row(row, now: datetime, source: str) -> dict:
+    enrollment_status = (row["enrollment_status"] or "active").lower()
+    status = "revoked" if enrollment_status == "withdrawn" else "active"
+    revoked_at = now if status == "revoked" else None
+    return {
+        "id": uuid.uuid4(),
+        "user_id": row["user_id"],
+        "product_id": row["product_id"],
+        "workspace_id": row["workspace_id"],
+        "project_id": row["project_id"],
+        "grant_type": "enrollment",
+        "status": status,
+        "source": source,
+        "starts_at": row["starts_at"],
+        "expires_at": None,
+        "revoked_at": revoked_at,
+        "metadata": {"source_enrollment_status": enrollment_status},
+        "created_at": now,
+        "updated_at": now,
+    }
diff --git a/backend/app/api/routes/analytics.py b/backend/app/api/routes/analytics.py
index b5cb54f..de237a9 100644
--- a/backend/app/api/routes/analytics.py
+++ b/backend/app/api/routes/analytics.py
@@ -1,24 +1,35 @@
-from fastapi import APIRouter, Depends, HTTPException
-from sqlalchemy import or_
+from fastapi import APIRouter, Depends, HTTPException, Query
+from sqlalchemy import desc, func, or_
 from sqlalchemy.orm import Session, selectinload
 from uuid import UUID
 
 from app.crud.badges import BADGE_RULES, calculate_streak_days, get_or_create_badge
 from app.database import get_db
 from app.deps import require_roles, require_org_roles
-from app.enum import ProgressStatus
+from app.enum import MembershipStatus, ProgressStatus
 from app.models import (
+    AccessGrant,
     Assessment,
+    Artifact,
     StudentAssessmentAttempt,
+    Certification,
     Course,
+    GenerationRun,
+    KnowledgeSource,
     Lesson,
+    OrganizationMembership,
+    Product,
+    Project,
     SegmentProgress,
     StudentBadge,
+    StudentCertification,
     StudentCourse,
+    StudentProgramProgress,
     StudentUnitProgress,
     Unit,
     User,
     Enrollment,
+    Workspace,
 )
 from app.schemas import (
     AssessmentEvidenceSummaryResponse,
@@ -33,6 +44,164 @@
 router = APIRouter()
 
 FLAGSHIP_PATHWAY_KEY = "introduction-to-africa"
+V2_ANALYTICS_ROLES = ("admin", "teacher", "content_admin", "org_admin", "instructor", "super_admin")
+
+
+def _visible_v2_workspace_ids(db: Session, current_user: User) -> list[UUID] | None:
+    if current_user.role in {"admin", "super_admin"}:
+        return None
+
+    memberships = db.query(OrganizationMembership).filter(
+        OrganizationMembership.user_id == current_user.id,
+    ).all()
+    organization_ids = [
+        membership.organization_id
+        for membership in memberships
+        if getattr(membership.status, "value", membership.status) == MembershipStatus.ACTIVE.value
+    ]
+    if not organization_ids:
+        return []
+
+    return [
+        workspace.id
+        for workspace in db.query(Workspace.id)
+        .filter(Workspace.organization_id.in_(organization_ids))
+        .all()
+    ]
+
+
+def _normalize_workspace_scope(
+    db: Session,
+    current_user: User,
+    workspace_id: UUID | None = None,
+) -> list[UUID] | None:
+    visible_ids = _visible_v2_workspace_ids(db, current_user)
+    if workspace_id is None:
+        return visible_ids
+    if visible_ids is not None and workspace_id not in visible_ids:
+        return []
+    return [workspace_id]
+
+
+def _scope_v2_query(query, model, workspace_ids: list[UUID] | None):
+    if workspace_ids is None:
+        return query
+    if not workspace_ids:
+        return query.filter(False)
+    return query.filter(model.workspace_id.in_(workspace_ids))
+
+
+def _count_by(db: Session, model, column, workspace_ids: list[UUID] | None) -> dict[str, int]:
+    rows = (
+        _scope_v2_query(db.query(column, func.count(model.id)), model, workspace_ids)
+        .group_by(column)
+        .all()
+    )
+    return {str(value or "unknown"): count for value, count in rows}
+
+
+def _recent_items(db: Session, model, workspace_ids: list[UUID] | None, *, item_type: str, limit: int = 5):
+    rows = (
+        _scope_v2_query(db.query(model), model, workspace_ids)
+        .order_by(desc(model.created_at), model.id.asc())
+        .limit(limit)
+        .all()
+    )
+    items = []
+    for row in rows:
+        items.append(
+            {
+                "id": row.id,
+                "item_type": item_type,
+                "title": getattr(row, "title", getattr(row, "name", "Untitled")),
+                "status": getattr(row, "status", "unknown"),
+                "subtype": getattr(row, "product_type", getattr(row, "artifact_type", getattr(row, "source_type", None))),
+                "created_at": row.created_at,
+            }
+        )
+    return items
+
+
+def _scoped_product_ids(db: Session, workspace_ids: list[UUID] | None) -> list[UUID]:
+    return [row.id for row in _scope_v2_query(db.query(Product.id), Product, workspace_ids).all()]
+
+
+def _scoped_course_ids(db: Session, workspace_ids: list[UUID] | None) -> list[UUID]:
+    return [
+        row.course_id
+        for row in _scope_v2_query(db.query(Product.course_id), Product, workspace_ids)
+        .filter(Product.course_id.isnot(None))
+        .all()
+    ]
+
+
+def _scoped_program_ids(db: Session, workspace_ids: list[UUID] | None) -> list[UUID]:
+    return [
+        row.program_id
+        for row in _scope_v2_query(db.query(Product.program_id), Product, workspace_ids)
+        .filter(Product.program_id.isnot(None))
+        .all()
+    ]
+
+
+def _learner_engagement_summary(db: Session, workspace_ids: list[UUID] | None) -> dict:
+    course_ids = _scoped_course_ids(db, workspace_ids)
+    program_ids = _scoped_program_ids(db, workspace_ids)
+    product_ids = _scoped_product_ids(db, workspace_ids)
+
+    course_enrollments = db.query(StudentCourse)
+    if course_ids:
+        course_enrollments = course_enrollments.filter(StudentCourse.course_id.in_(course_ids))
+    elif workspace_ids is not None:
+        course_enrollments = course_enrollments.filter(False)
+
+    program_enrollments = db.query(StudentProgramProgress)
+    if program_ids:
+        program_enrollments = program_enrollments.filter(StudentProgramProgress.program_id.in_(program_ids))
+    elif workspace_ids is not None:
+        program_enrollments = program_enrollments.filter(False)
+
+    access_grants = db.query(AccessGrant)
+    if product_ids:
+        access_grants = access_grants.filter(AccessGrant.product_id.in_(product_ids))
+    elif workspace_ids is not None:
+        access_grants = access_grants.filter(False)
+
+    course_rows = course_enrollments.all()
+    program_rows = program_enrollments.all()
+    grant_rows = access_grants.all()
+    learner_ids = {row.student_id for row in course_rows} | {row.student_id for row in program_rows} | {row.user_id for row in grant_rows}
+
+    completed_courses = sum(1 for row in course_rows if row.status == "completed")
+    lesson_completion_count = (
+        db.query(SegmentProgress)
+        .join(StudentUnitProgress, StudentUnitProgress.id == SegmentProgress.student_unit_id)
+        .join(StudentCourse, StudentCourse.id == StudentUnitProgress.student_course_id)
+        .filter(
+            SegmentProgress.status == ProgressStatus.COMPLETED,
+            StudentCourse.id.in_([row.id for row in course_rows]) if course_rows else False,
+        )
+        .count()
+    )
+    issued_certifications = db.query(StudentCertification).count() if workspace_ids is None else 0
+    if program_ids:
+        issued_certifications = (
+            db.query(StudentCertification)
+            .join(Certification, Certification.id == StudentCertification.certification_id)
+            .filter(Certification.program_id.in_(program_ids))
+            .count()
+        )
+
+    return {
+        "learner_count": len(learner_ids),
+        "enrollment_count": len(course_rows) + len(program_rows),
+        "course_enrollment_count": len(course_rows),
+        "program_enrollment_count": len(program_rows),
+        "completed_course_count": completed_courses,
+        "lesson_completion_count": lesson_completion_count,
+        "issued_certification_count": issued_certifications,
+        "access_granted_learner_count": len({row.user_id for row in grant_rows}),
+    }
 
 
 def _latest_attempt_for_assessment(assessment: Assessment, student_id):
@@ -560,6 +729,159 @@ def _build_assessment_evidence_summary(
     return rows
 
 
+@router.get("/analytics/workspace")
+def get_v2_workspace_analytics(
+    workspace_id: UUID | None = Query(default=None),
+    db: Session = Depends(get_db),
+    current_user=Depends(require_roles(*V2_ANALYTICS_ROLES)),
+):
+    workspace_ids = _normalize_workspace_scope(db, current_user, workspace_id)
+    learner_summary = _learner_engagement_summary(db, workspace_ids)
+    product_ids = _scoped_product_ids(db, workspace_ids)
+
+    return {
+        "totals": {
+            "total_products": _scope_v2_query(db.query(Product), Product, workspace_ids).count(),
+            "total_projects": _scope_v2_query(db.query(Project), Project, workspace_ids).count(),
+            "total_knowledge_sources": _scope_v2_query(db.query(KnowledgeSource), KnowledgeSource, workspace_ids).count(),
+            "total_artifacts": _scope_v2_query(db.query(Artifact), Artifact, workspace_ids).count(),
+            "total_generation_runs": _scope_v2_query(db.query(GenerationRun), GenerationRun, workspace_ids).count(),
+            "total_access_grants": _scope_v2_query(db.query(AccessGrant), AccessGrant, workspace_ids).count(),
+            "learner_count": learner_summary["learner_count"],
+            "enrollment_count": learner_summary["enrollment_count"],
+            "course_backed_product_count": _scope_v2_query(db.query(Product), Product, workspace_ids).filter(Product.course_id.isnot(None)).count(),
+            "program_backed_product_count": _scope_v2_query(db.query(Product), Product, workspace_ids).filter(Product.program_id.isnot(None)).count(),
+        },
+        "products_by_type": _count_by(db, Product, Product.product_type, workspace_ids),
+        "products_by_status": _count_by(db, Product, Product.status, workspace_ids),
+        "artifacts_by_status": _count_by(db, Artifact, Artifact.status, workspace_ids),
+        "artifacts_by_type": _count_by(db, Artifact, Artifact.artifact_type, workspace_ids),
+        "generation_runs_by_status": _count_by(db, GenerationRun, GenerationRun.status, workspace_ids),
+        "access_grants_by_status": _count_by(db, AccessGrant, AccessGrant.status, workspace_ids),
+        "access_grants_by_type": _count_by(db, AccessGrant, AccessGrant.grant_type, workspace_ids),
+        "review_health": {
+            "draft_products": _scope_v2_query(db.query(Product), Product, workspace_ids).filter(Product.status == "draft").count(),
+            "in_review_products": _scope_v2_query(db.query(Product), Product, workspace_ids).filter(Product.status == "in_review").count(),
+            "approved_products": _scope_v2_query(db.query(Product), Product, workspace_ids).filter(Product.status == "approved").count(),
+            "published_products": _scope_v2_query(db.query(Product), Product, workspace_ids).filter(Product.status == "published").count(),
+            "review_required_artifacts": _scope_v2_query(db.query(Artifact), Artifact, workspace_ids).filter(Artifact.status.in_(["draft", "in_review", "needs_changes"])).count(),
+        },
+        "learner_engagement": learner_summary,
+        "recent": {
+            "products": _recent_items(db, Product, workspace_ids, item_type="product"),
+            "artifacts": _recent_items(db, Artifact, workspace_ids, item_type="artifact"),
+            "knowledge_sources": _recent_items(db, KnowledgeSource, workspace_ids, item_type="knowledge_source"),
+        },
+        "event_tracking": {
+            "status": "unavailable",
+            "message": "Analytics V2 foundations use current wrapper and runtime state; event tracking has not been introduced.",
+        },
+        "scoped_product_count": len(product_ids),
+    }
+
+
+@router.get("/analytics/products")
+def get_v2_product_analytics(
+    workspace_id: UUID | None = Query(default=None),
+    db: Session = Depends(get_db),
+    current_user=Depends(require_roles(*V2_ANALYTICS_ROLES)),
+):
+    workspace_ids = _normalize_workspace_scope(db, current_user, workspace_id)
+    products = (
+        _scope_v2_query(db.query(Product), Product, workspace_ids)
+        .order_by(Product.updated_at.desc(), Product.title.asc())
+        .all()
+    )
+    product_rows = []
+    for product in products:
+        enrollment_count = 0
+        if product.course_id:
+            enrollment_count = db.query(StudentCourse).filter(StudentCourse.course_id == product.course_id).count()
+        if product.program_id:
+            enrollment_count += db.query(StudentProgramProgress).filter(StudentProgramProgress.program_id == product.program_id).count()
+        product_rows.append(
+            {
+                "id": product.id,
+                "title": product.title,
+                "product_type": product.product_type,
+                "status": product.status,
+                "review_state": product.review_state,
+                "access_state": product.access_state,
+                "course_id": product.course_id,
+                "program_id": product.program_id,
+                "artifact_count": db.query(Artifact).filter(Artifact.product_id == product.id).count(),
+                "generation_run_count": db.query(GenerationRun).filter(GenerationRun.product_id == product.id).count(),
+                "access_grant_count": db.query(AccessGrant).filter(AccessGrant.product_id == product.id).count(),
+                "enrollment_count": enrollment_count,
+                "created_at": product.created_at,
+                "updated_at": product.updated_at,
+            }
+        )
+
+    return {
+        "total_products": len(products),
+        "course_backed_product_count": sum(1 for product in products if product.course_id is not None),
+        "program_backed_product_count": sum(1 for product in products if product.program_id is not None),
+        "products_by_type": _count_by(db, Product, Product.product_type, workspace_ids),
+        "products_by_status": _count_by(db, Product, Product.status, workspace_ids),
+        "products": product_rows,
+    }
+
+
+@router.get("/analytics/learners")
+def get_v2_learner_analytics(
+    workspace_id: UUID | None = Query(default=None),
+    db: Session = Depends(get_db),
+    current_user=Depends(require_roles(*V2_ANALYTICS_ROLES)),
+):
+    workspace_ids = _normalize_workspace_scope(db, current_user, workspace_id)
+    course_ids = _scoped_course_ids(db, workspace_ids)
+    enrollment_query = db.query(StudentCourse.status, func.count(StudentCourse.id))
+    if course_ids:
+        enrollment_query = enrollment_query.filter(StudentCourse.course_id.in_(course_ids))
+    elif workspace_ids is not None:
+        enrollment_query = enrollment_query.filter(False)
+
+    return {
+        "summary": _learner_engagement_summary(db, workspace_ids),
+        "enrollments_by_status": {
+            str(status or "unknown"): count
+            for status, count in enrollment_query.group_by(StudentCourse.status).all()
+        },
+        "access_grants_by_status": _count_by(db, AccessGrant, AccessGrant.status, workspace_ids),
+        "access_grants_by_type": _count_by(db, AccessGrant, AccessGrant.grant_type, workspace_ids),
+    }
+
+
+@router.get("/analytics/knowledge-pipeline")
+def get_v2_knowledge_pipeline_analytics(
+    workspace_id: UUID | None = Query(default=None),
+    db: Session = Depends(get_db),
+    current_user=Depends(require_roles(*V2_ANALYTICS_ROLES)),
+):
+    workspace_ids = _normalize_workspace_scope(db, current_user, workspace_id)
+    return {
+        "total_projects": _scope_v2_query(db.query(Project), Project, workspace_ids).count(),
+        "total_knowledge_sources": _scope_v2_query(db.query(KnowledgeSource), KnowledgeSource, workspace_ids).count(),
+        "total_artifacts": _scope_v2_query(db.query(Artifact), Artifact, workspace_ids).count(),
+        "total_generation_runs": _scope_v2_query(db.query(GenerationRun), GenerationRun, workspace_ids).count(),
+        "knowledge_sources_by_type": _count_by(db, KnowledgeSource, KnowledgeSource.source_type, workspace_ids),
+        "knowledge_sources_by_status": _count_by(db, KnowledgeSource, KnowledgeSource.status, workspace_ids),
+        "artifacts_by_status": _count_by(db, Artifact, Artifact.status, workspace_ids),
+        "artifacts_by_type": _count_by(db, Artifact, Artifact.artifact_type, workspace_ids),
+        "generation_runs_by_status": _count_by(db, GenerationRun, GenerationRun.status, workspace_ids),
+        "recent": {
+            "artifacts": _recent_items(db, Artifact, workspace_ids, item_type="artifact"),
+            "knowledge_sources": _recent_items(db, KnowledgeSource, workspace_ids, item_type="knowledge_source"),
+        },
+        "source_coverage": {
+            "status": "advisory",
+            "artifacts_with_knowledge_source": _scope_v2_query(db.query(Artifact), Artifact, workspace_ids).filter(Artifact.knowledge_source_id.isnot(None)).count(),
+            "artifacts_without_knowledge_source": _scope_v2_query(db.query(Artifact), Artifact, workspace_ids).filter(Artifact.knowledge_source_id.is_(None)).count(),
+        },
+    }
+
+
 @router.get("/analytics/overview")
 def get_admin_overview(
     db: Session = Depends(get_db),
diff --git a/backend/app/api/routes/v2_platform.py b/backend/app/api/routes/v2_platform.py
index 0a90beb..26b547a 100644
--- a/backend/app/api/routes/v2_platform.py
+++ b/backend/app/api/routes/v2_platform.py
@@ -1,25 +1,33 @@
+from datetime import datetime
 from uuid import UUID
 
 from fastapi import APIRouter, Depends, HTTPException, Query
-from sqlalchemy.orm import Session
+from sqlalchemy.orm import Session, joinedload
 
 from app.database import get_db
 from app.deps import get_current_user
 from app.enum import MembershipStatus
+from app.lesson_governance import evaluate_course_publish_readiness
 from app.models import (
+    AccessGrant,
     Artifact,
     GenerationRun,
     KnowledgeSource,
     OrganizationMembership,
     Product,
     Course,
+    Lesson,
     Program,
     Project,
     Source,
+    StudentCourse,
+    Unit,
     User,
     Workspace,
 )
 from app.schemas import (
+    AccessGrantCreateRequest,
+    AccessGrantResponse,
     ArtifactCreateRequest,
     ArtifactResponse,
     GenerationRunResponse,
@@ -29,6 +37,11 @@
     ProductResponse,
     ProjectCreateRequest,
     ProjectResponse,
+    LearnerProductResponse,
+    ReviewCenterActivityResponse,
+    ReviewCenterItemResponse,
+    ReviewCenterResponse,
+    ReviewStatusUpdateRequest,
     WorkspaceResponse,
 )
 
@@ -65,6 +78,11 @@
     "assessment_seed",
     "lesson_draft",
 }
+SUPPORTED_ARTIFACT_REVIEW_STATUSES = {"draft", "in_review", "approved", "rejected", "needs_changes"}
+SUPPORTED_PRODUCT_REVIEW_STATUSES = {"draft", "in_review", "approved", "published", "archived"}
+LEARNER_VISIBLE_PRODUCT_STATUSES = {"approved", "published"}
+SUPPORTED_ACCESS_GRANT_TYPES = {"manual", "enrollment", "membership", "purchase", "organization", "invitation"}
+SUPPORTED_ACCESS_GRANT_STATUSES = {"active", "pending", "expired", "revoked"}
 
 
 def _visible_workspace_ids(db: Session, current_user: User) -> list[UUID] | None:
@@ -111,6 +129,24 @@ def _scope_platform_query(query, model, db: Session, current_user: User):
     return query.filter(model.workspace_id.in_(visible_workspace_ids))
 
 
+def _visible_organization_ids(db: Session, current_user: User) -> list[UUID] | None:
+    if current_user.role in {"admin", "teacher", "super_admin"}:
+        return None
+
+    visible_workspace_ids = _visible_workspace_ids(db, current_user)
+    if visible_workspace_ids is None:
+        return None
+    if not visible_workspace_ids:
+        return []
+
+    return [
+        organization_id
+        for (organization_id,) in db.query(Workspace.organization_id)
+        .filter(Workspace.id.in_(visible_workspace_ids), Workspace.organization_id.isnot(None))
+        .all()
+    ]
+
+
 def _can_manage_workspace(db: Session, current_user: User, workspace: Workspace) -> bool:
     if current_user.role in {"admin", "teacher", "super_admin"}:
         return True
@@ -179,6 +215,469 @@ def _require_project_in_workspace(
     return project
 
 
+def _get_visible_artifact(db: Session, current_user: User, artifact_id: UUID) -> Artifact:
+    artifact = _scope_platform_query(
+        db.query(Artifact).filter(Artifact.id == artifact_id),
+        Artifact,
+        db,
+        current_user,
+    ).first()
+    if not artifact:
+        raise HTTPException(status_code=404, detail="Artifact not found")
+    return artifact
+
+
+def _get_visible_product(db: Session, current_user: User, product_id: UUID) -> Product:
+    product = _scope_platform_query(
+        db.query(Product).filter(Product.id == product_id),
+        Product,
+        db,
+        current_user,
+    ).first()
+    if not product:
+        raise HTTPException(status_code=404, detail="Product not found")
+    return product
+
+
+def _require_manage_platform_record(db: Session, current_user: User, workspace_id: UUID) -> Workspace:
+    return _require_manage_workspace(db, current_user, workspace_id)
+
+
+def _scope_access_grant_query(query, db: Session, current_user: User):
+    visible_workspace_ids = _visible_workspace_ids(db, current_user)
+    if visible_workspace_ids is None:
+        return query
+    if not visible_workspace_ids:
+        return query.filter(False)
+    return query.filter(AccessGrant.workspace_id.in_(visible_workspace_ids))
+
+
+def _grant_is_active(grant: AccessGrant, now: datetime | None = None) -> bool:
+    now = now or datetime.utcnow()
+    if grant.status != "active" or grant.revoked_at is not None:
+        return False
+    if grant.starts_at is not None and grant.starts_at > now:
+        return False
+    if grant.expires_at is not None and grant.expires_at <= now:
+        return False
+    return True
+
+
+def _source_coverage_for_artifact(artifact: Artifact) -> str:
+    if artifact.knowledge_source_id:
+        return "Linked knowledge source"
+    if artifact.generation_run_id:
+        return "Generation run linked; source coverage pending"
+    return "No source link"
+
+
+def _artifact_required_decision(artifact: Artifact) -> str:
+    if artifact.status in {"approved", "rejected"}:
+        return "No decision required"
+    if artifact.status == "needs_changes":
+        return "Revise or reject artifact wrapper"
+    return "Review artifact wrapper"
+
+
+def _product_required_decision(product: Product) -> str:
+    if product.status == "published":
+        return "Monitor existing runtime governance"
+    if product.status == "archived":
+        return "No decision required"
+    if product.status == "approved":
+        return "Confirm existing governance before learner delivery"
+    return "Review product wrapper"
+
+
+def _review_item_for_artifact(artifact: Artifact) -> ReviewCenterItemResponse:
+    return ReviewCenterItemResponse(
+        id=artifact.id,
+        item_type="artifact",
+        title=artifact.title,
+        status=artifact.status,
+        review_state=artifact.review_state,
+        owner=None,
+        source_coverage=_source_coverage_for_artifact(artifact),
+        readiness="Wrapper review only; not learner-deliverable",
+        required_decision=_artifact_required_decision(artifact),
+        blocked=artifact.status in {"rejected", "needs_changes"},
+        detail_route=f"/workspace/artifacts/{artifact.id}",
+        governance_route=None,
+        updated_at=artifact.updated_at,
+    )
+
+
+def _review_item_for_product(product: Product) -> ReviewCenterItemResponse:
+    linked_runtime = "Course-backed runtime link" if product.course_id else "No runtime course link"
+    return ReviewCenterItemResponse(
+        id=product.id,
+        item_type="product",
+        title=product.title,
+        status=product.status,
+        review_state=product.review_state,
+        owner=None,
+        source_coverage=linked_runtime,
+        readiness="Existing lesson governance remains authoritative",
+        required_decision=_product_required_decision(product),
+        blocked=product.status == "archived",
+        detail_route=f"/workspace/products/{product.id}",
+        governance_route=(
+            f"/workspace/product-studio/courses/{product.course_id}/edit"
+            if product.course_id
+            else None
+        ),
+        updated_at=product.updated_at,
+    )
+
+
+def _review_item_for_course(course: Course) -> ReviewCenterItemResponse | None:
+    readiness = evaluate_course_publish_readiness(course)
+    if readiness.is_ready and not readiness.warnings:
+        return None
+
+    issue_count = len(readiness.blocking_issues)
+    warning_count = len(readiness.warnings)
+    if issue_count:
+        status = "blocked"
+        required_decision = "Resolve lesson governance blockers"
+    else:
+        status = "approved"
+        required_decision = "Review readiness warnings"
+
+    return ReviewCenterItemResponse(
+        id=course.id,
+        item_type="lesson_governance",
+        title=course.title,
+        status=status,
+        review_state="existing_governance",
+        owner=None,
+        source_coverage=f"{issue_count} blocking issue(s), {warning_count} warning(s)",
+        readiness="Ready" if readiness.is_ready else "Blocked",
+        required_decision=required_decision,
+        blocked=not readiness.is_ready,
+        detail_route=f"/workspace/product-studio/courses/{course.id}/edit",
+        governance_route=f"/workspace/product-studio/courses/{course.id}/edit",
+        updated_at=course.updated_at,
+    )
+
+
+def _review_center_course_query(db: Session, current_user: User):
+    query = db.query(Course).options(
+        joinedload(Course.units).joinedload(Unit.lessons).joinedload(Lesson.sources),
+    )
+    visible_organization_ids = _visible_organization_ids(db, current_user)
+    if visible_organization_ids is None:
+        return query
+    if not visible_organization_ids:
+        return query.filter(False)
+    return query.filter(Course.organization_id.in_(visible_organization_ids))
+
+
+def _learner_product_from_enrollment(
+    enrollment: StudentCourse,
+    product: Product | None,
+) -> LearnerProductResponse:
+    course = enrollment.course
+    return LearnerProductResponse(
+        id=product.id if product else course.id,
+        product_id=product.id if product else None,
+        course_id=course.id,
+        title=product.title if product else course.title,
+        description=(product.description if product else course.description),
+        product_type=product.product_type if product else "course",
+        product_status=product.status if product else None,
+        review_state=product.review_state if product else None,
+        access_state=product.access_state if product else None,
+        enrollment_id=enrollment.id,
+        enrollment_status=enrollment.status,
+        enrolled_on=enrollment.enrolled_on,
+        access_grant_id=None,
+        access_grant_status=None,
+        is_enrolled=True,
+        source="product_wrapper" if product else "runtime_course",
+        learner_visibility="Existing enrollment controls access; lesson governance controls content.",
+        next_action="Continue governed course runtime",
+    )
+
+
+def _learner_product_from_grant(grant: AccessGrant) -> LearnerProductResponse:
+    product = grant.product
+    course = product.course
+    return LearnerProductResponse(
+        id=product.id,
+        product_id=product.id,
+        course_id=course.id if course else None,
+        title=product.title,
+        description=product.description or (course.description if course else None),
+        product_type=product.product_type,
+        product_status=product.status,
+        review_state=product.review_state,
+        access_state=product.access_state,
+        enrollment_id=None,
+        enrollment_status=None,
+        enrolled_on=None,
+        access_grant_id=grant.id,
+        access_grant_status=grant.status,
+        is_enrolled=False,
+        source="product_wrapper",
+        learner_visibility="Active access grant permits product-level access; lesson governance still controls runtime content.",
+        next_action=(
+            "Continue governed course runtime"
+            if course is not None
+            else "Product access available; learner runtime is not implemented for this product type yet"
+        ),
+    )
+
+
+@router.get("/review-center", response_model=ReviewCenterResponse)
+def get_review_center(
+    db: Session = Depends(get_db),
+    current_user: User = Depends(get_current_user),
+):
+    pending_artifacts = [
+        _review_item_for_artifact(artifact)
+        for artifact in _scope_platform_query(db.query(Artifact), Artifact, db, current_user)
+        .filter(Artifact.status.in_(["draft", "in_review", "needs_changes"]))
+        .order_by(Artifact.updated_at.desc(), Artifact.created_at.desc())
+        .all()
+    ]
+    draft_products = [
+        _review_item_for_product(product)
+        for product in _scope_platform_query(db.query(Product), Product, db, current_user)
+        .filter(Product.status.in_(["draft", "in_review", "approved"]))
+        .order_by(Product.updated_at.desc(), Product.created_at.desc())
+        .all()
+    ]
+    lesson_governance_items = [
+        item
+        for item in (
+            _review_item_for_course(course)
+            for course in _review_center_course_query(db, current_user)
+            .order_by(Course.updated_at.desc(), Course.created_at.desc())
+            .all()
+        )
+        if item is not None
+    ]
+
+    return ReviewCenterResponse(
+        pending_artifacts=pending_artifacts,
+        draft_products=draft_products,
+        lesson_governance_items=lesson_governance_items,
+        recent_activity=[
+            ReviewCenterActivityResponse(
+                id="review-activity-placeholder",
+                message="Review activity history will appear here after audit records are introduced.",
+                created_at=None,
+            )
+        ],
+    )
+
+
+@router.patch("/artifacts/{artifact_id}/review-status", response_model=ArtifactResponse)
+def update_artifact_review_status(
+    artifact_id: UUID,
+    payload: ReviewStatusUpdateRequest,
+    db: Session = Depends(get_db),
+    current_user: User = Depends(get_current_user),
+):
+    if payload.status not in SUPPORTED_ARTIFACT_REVIEW_STATUSES:
+        raise HTTPException(status_code=400, detail="Unsupported artifact review status.")
+
+    artifact = _get_visible_artifact(db, current_user, artifact_id)
+    _require_manage_platform_record(db, current_user, artifact.workspace_id)
+
+    artifact.status = payload.status
+    artifact.review_state = payload.status
+    db.commit()
+    db.refresh(artifact)
+    return artifact
+
+
+@router.patch("/products/{product_id}/review-status", response_model=ProductResponse)
+def update_product_review_status(
+    product_id: UUID,
+    payload: ReviewStatusUpdateRequest,
+    db: Session = Depends(get_db),
+    current_user: User = Depends(get_current_user),
+):
+    if payload.status not in SUPPORTED_PRODUCT_REVIEW_STATUSES:
+        raise HTTPException(status_code=400, detail="Unsupported product review status.")
+
+    product = _get_visible_product(db, current_user, product_id)
+    _require_manage_platform_record(db, current_user, product.workspace_id)
+
+    product.status = payload.status
+    product.review_state = payload.status
+    db.commit()
+    db.refresh(product)
+    return product
+
+
+@router.get("/learner-portal/products", response_model=list[LearnerProductResponse])
+def list_learner_products(
+    db: Session = Depends(get_db),
+    current_user: User = Depends(get_current_user),
+):
+    enrolled_courses = (
+        db.query(StudentCourse)
+        .options(joinedload(StudentCourse.course))
+        .filter(StudentCourse.student_id == current_user.id)
+        .order_by(StudentCourse.enrolled_on.desc(), StudentCourse.id.asc())
+        .all()
+    )
+    enrolled_course_ids = [enrollment.course_id for enrollment in enrolled_courses]
+    products_by_course_id = {
+        product.course_id: product
+        for product in db.query(Product)
+        .filter(Product.course_id.in_(enrolled_course_ids))
+        .all()
+        if product.course_id is not None
+    } if enrolled_course_ids else {}
+
+    learner_products = [
+        _learner_product_from_enrollment(
+            enrollment,
+            products_by_course_id.get(enrollment.course_id),
+        )
+        for enrollment in enrolled_courses
+        if enrollment.course is not None
+    ]
+
+    granted_products_query = (
+        db.query(AccessGrant)
+        .options(joinedload(AccessGrant.product).joinedload(Product.course))
+        .join(Product, AccessGrant.product_id == Product.id)
+        .filter(
+            AccessGrant.user_id == current_user.id,
+            AccessGrant.status == "active",
+            AccessGrant.revoked_at.is_(None),
+            Product.status.in_(LEARNER_VISIBLE_PRODUCT_STATUSES),
+        )
+        .order_by(Product.title.asc())
+    )
+    if enrolled_course_ids:
+        granted_products_query = granted_products_query.filter(
+            (Product.course_id.is_(None)) | (~Product.course_id.in_(enrolled_course_ids))
+        )
+
+    now = datetime.utcnow()
+    learner_products.extend(
+        _learner_product_from_grant(grant)
+        for grant in granted_products_query.all()
+        if grant.product is not None and _grant_is_active(grant, now)
+    )
+
+    return learner_products
+
+
+@router.get("/access-grants", response_model=list[AccessGrantResponse])
+def list_access_grants(
+    workspace_id: UUID | None = Query(default=None),
+    product_id: UUID | None = Query(default=None),
+    user_id: UUID | None = Query(default=None),
+    db: Session = Depends(get_db),
+    current_user: User = Depends(get_current_user),
+):
+    query = _scope_access_grant_query(db.query(AccessGrant), db, current_user)
+    if current_user.role not in CREATOR_ROLES:
+        query = query.filter(AccessGrant.user_id == current_user.id)
+    if workspace_id:
+        query = query.filter(AccessGrant.workspace_id == workspace_id)
+    if product_id:
+        query = query.filter(AccessGrant.product_id == product_id)
+    if user_id:
+        query = query.filter(AccessGrant.user_id == user_id)
+    return query.order_by(AccessGrant.created_at.desc(), AccessGrant.id.asc()).all()
+
+
+@router.post("/access-grants", response_model=AccessGrantResponse, status_code=201)
+def create_access_grant(
+    payload: AccessGrantCreateRequest,
+    db: Session = Depends(get_db),
+    current_user: User = Depends(get_current_user),
+):
+    if payload.grant_type not in SUPPORTED_ACCESS_GRANT_TYPES:
+        raise HTTPException(status_code=400, detail="Unsupported access grant type.")
+    if payload.status not in SUPPORTED_ACCESS_GRANT_STATUSES:
+        raise HTTPException(status_code=400, detail="Unsupported access grant status.")
+    if payload.status == "revoked":
+        raise HTTPException(status_code=400, detail="Create active or pending grants, then revoke explicitly.")
+
+    product = _get_visible_product(db, current_user, payload.product_id)
+    _require_manage_platform_record(db, current_user, product.workspace_id)
+    if payload.workspace_id and payload.workspace_id != product.workspace_id:
+        raise HTTPException(status_code=400, detail="Access grant workspace must match the product workspace.")
+    if payload.project_id and payload.project_id != product.project_id:
+        raise HTTPException(status_code=400, detail="Access grant project must match the product project.")
+
+    user = db.query(User).filter(User.id == payload.user_id).first()
+    if not user:
+        raise HTTPException(status_code=404, detail="User not found")
+
+    existing = (
+        db.query(AccessGrant)
+        .filter(
+            AccessGrant.user_id == payload.user_id,
+            AccessGrant.product_id == payload.product_id,
+            AccessGrant.grant_type == payload.grant_type,
+        )
+        .first()
+    )
+    if existing:
+        existing.status = payload.status
+        existing.source = payload.source
+        existing.workspace_id = product.workspace_id
+        existing.project_id = product.project_id
+        existing.starts_at = payload.starts_at
+        existing.expires_at = payload.expires_at
+        existing.revoked_at = None
+        existing.grant_metadata = payload.metadata
+        existing.updated_at = datetime.utcnow()
+        db.commit()
+        db.refresh(existing)
+        return existing
+
+    grant = AccessGrant(
+        user_id=payload.user_id,
+        product_id=product.id,
+        workspace_id=product.workspace_id,
+        project_id=product.project_id,
+        grant_type=payload.grant_type,
+        status=payload.status,
+        source=payload.source,
+        starts_at=payload.starts_at,
+        expires_at=payload.expires_at,
+        grant_metadata=payload.metadata,
+    )
+    db.add(grant)
+    db.commit()
+    db.refresh(grant)
+    return grant
+
+
+@router.patch("/access-grants/{grant_id}/revoke", response_model=AccessGrantResponse)
+def revoke_access_grant(
+    grant_id: UUID,
+    db: Session = Depends(get_db),
+    current_user: User = Depends(get_current_user),
+):
+    grant = _scope_access_grant_query(
+        db.query(AccessGrant).filter(AccessGrant.id == grant_id),
+        db,
+        current_user,
+    ).first()
+    if not grant:
+        raise HTTPException(status_code=404, detail="Access grant not found")
+
+    _require_manage_platform_record(db, current_user, grant.workspace_id)
+    grant.status = "revoked"
+    grant.revoked_at = datetime.utcnow()
+    grant.updated_at = grant.revoked_at
+    db.commit()
+    db.refresh(grant)
+    return grant
+
+
 @router.get("/workspaces", response_model=list[WorkspaceResponse])
 def list_workspaces(
     db: Session = Depends(get_db),
diff --git a/backend/app/models.py b/backend/app/models.py
index a56b41e..b280c36 100644
--- a/backend/app/models.py
+++ b/backend/app/models.py
@@ -81,6 +81,7 @@ class User(Base):
         back_populates="student",
         cascade="all, delete-orphan",
     )
+    access_grants = relationship("AccessGrant", back_populates="user")
 
 
 class Organization(Base):
@@ -535,6 +536,7 @@ class Workspace(Base):
     knowledge_sources = relationship("KnowledgeSource", back_populates="workspace", cascade="all, delete-orphan")
     artifacts = relationship("Artifact", back_populates="workspace", cascade="all, delete-orphan")
     generation_runs = relationship("GenerationRun", back_populates="workspace", cascade="all, delete-orphan")
+    access_grants = relationship("AccessGrant", back_populates="workspace", cascade="all, delete-orphan")
 
 
 class Project(Base):
@@ -554,6 +556,7 @@ class Project(Base):
     knowledge_sources = relationship("KnowledgeSource", back_populates="project", cascade="all, delete-orphan")
     artifacts = relationship("Artifact", back_populates="project", cascade="all, delete-orphan")
     generation_runs = relationship("GenerationRun", back_populates="project", cascade="all, delete-orphan")
+    access_grants = relationship("AccessGrant", back_populates="project")
 
 
 class Product(Base):
@@ -585,6 +588,34 @@ class Product(Base):
     program = relationship("Program", back_populates="products")
     artifacts = relationship("Artifact", back_populates="product")
     generation_runs = relationship("GenerationRun", back_populates="product")
+    access_grants = relationship("AccessGrant", back_populates="product", cascade="all, delete-orphan")
+
+
+class AccessGrant(Base):
+    __tablename__ = "access_grants"
+    __table_args__ = (
+        UniqueConstraint("user_id", "product_id", "grant_type", name="uq_access_grant_user_product_type"),
+    )
+
+    id = Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4, index=True)
+    user_id = Column(UUID(as_uuid=True), ForeignKey("users.id"), nullable=False)
+    product_id = Column(UUID(as_uuid=True), ForeignKey("products.id"), nullable=False)
+    workspace_id = Column(UUID(as_uuid=True), ForeignKey("workspaces.id"), nullable=False)
+    project_id = Column(UUID(as_uuid=True), ForeignKey("projects.id"), nullable=True)
+    grant_type = Column(String, nullable=False, default="manual")
+    status = Column(String, nullable=False, default="active")
+    source = Column(String, nullable=False, default="manual")
+    starts_at = Column(DateTime, nullable=True)
+    expires_at = Column(DateTime, nullable=True)
+    revoked_at = Column(DateTime, nullable=True)
+    grant_metadata = Column("metadata", JSON, nullable=True, default=dict)
+    created_at = Column(DateTime, default=datetime.utcnow)
+    updated_at = Column(DateTime, default=datetime.utcnow)
+
+    user = relationship("User", back_populates="access_grants")
+    product = relationship("Product", back_populates="access_grants")
+    workspace = relationship("Workspace", back_populates="access_grants")
+    project = relationship("Project", back_populates="access_grants")
 
 
 class KnowledgeSource(Base):
diff --git a/backend/app/schemas.py b/backend/app/schemas.py
index 2418fb1..969d9cc 100644
--- a/backend/app/schemas.py
+++ b/backend/app/schemas.py
@@ -159,6 +159,39 @@ class ProductCreateRequest(BaseModel):
     metadata: dict[str, Any] = Field(default_factory=dict)
 
 
+class AccessGrantResponse(BaseModel):
+    id: UUID
+    user_id: UUID
+    product_id: UUID
+    workspace_id: UUID
+    project_id: Optional[UUID] = None
+    grant_type: str
+    status: str
+    source: str
+    starts_at: Optional[datetime] = None
+    expires_at: Optional[datetime] = None
+    revoked_at: Optional[datetime] = None
+    metadata: dict[str, Any] = Field(default_factory=dict, validation_alias="grant_metadata")
+    created_at: datetime
+    updated_at: datetime
+
+    class Config:
+        from_attributes = True
+
+
+class AccessGrantCreateRequest(BaseModel):
+    user_id: UUID
+    product_id: UUID
+    workspace_id: Optional[UUID] = None
+    project_id: Optional[UUID] = None
+    grant_type: str = "manual"
+    status: str = "active"
+    source: str = "manual"
+    starts_at: Optional[datetime] = None
+    expires_at: Optional[datetime] = None
+    metadata: dict[str, Any] = Field(default_factory=dict)
+
+
 class KnowledgeSourceResponse(BaseModel):
     id: UUID
     workspace_id: UUID
@@ -227,6 +260,60 @@ class ArtifactCreateRequest(BaseModel):
     metadata: dict[str, Any] = Field(default_factory=dict)
 
 
+class ReviewStatusUpdateRequest(BaseModel):
+    status: str
+
+
+class ReviewCenterItemResponse(BaseModel):
+    id: UUID
+    item_type: str
+    title: str
+    status: str
+    review_state: Optional[str] = None
+    owner: Optional[str] = None
+    source_coverage: str
+    readiness: str
+    required_decision: str
+    blocked: bool = False
+    detail_route: Optional[str] = None
+    governance_route: Optional[str] = None
+    updated_at: Optional[datetime] = None
+
+
+class ReviewCenterActivityResponse(BaseModel):
+    id: str
+    message: str
+    created_at: Optional[datetime] = None
+
+
+class ReviewCenterResponse(BaseModel):
+    pending_artifacts: list[ReviewCenterItemResponse]
+    draft_products: list[ReviewCenterItemResponse]
+    lesson_governance_items: list[ReviewCenterItemResponse]
+    recent_activity: list[ReviewCenterActivityResponse]
+
+
+class LearnerProductResponse(BaseModel):
+    id: UUID
+    product_id: Optional[UUID] = None
+    course_id: Optional[UUID] = None
+    title: str
+    description: Optional[str] = None
+    product_type: str = "course"
+    product_status: Optional[str] = None
+    review_state: Optional[str] = None
+    access_state: Optional[str] = None
+    enrollment_id: Optional[UUID] = None
+    enrollment_status: Optional[str] = None
+    enrolled_on: Optional[datetime] = None
+    access_grant_id: Optional[UUID] = None
+    access_grant_status: Optional[str] = None
+    is_enrolled: bool = False
+    source: str
+    learner_visibility: str
+    next_action: str
+
+
 class GenerationRunResponse(BaseModel):
     id: UUID
     workspace_id: UUID
diff --git a/backend/tests/test_v2_platform_wrappers.py b/backend/tests/test_v2_platform_wrappers.py
index 6ee7746..b444532 100644
--- a/backend/tests/test_v2_platform_wrappers.py
+++ b/backend/tests/test_v2_platform_wrappers.py
@@ -3,20 +3,26 @@
 from fastapi import FastAPI
 from fastapi.testclient import TestClient
 
-from app.api.routes import courses, v2_platform
+from app.api.routes import analytics, courses, v2_platform
 from app.database import get_db
 from app.deps import get_current_user
+from app.enum import ProgressStatus
 from app.enum import OrganizationType
 from app.models import (
+    AccessGrant,
     Artifact,
     Course,
     GenerationRun,
     KnowledgeSource,
     Lesson,
     Organization,
+    OrganizationMembership,
     Product,
     Project,
+    SegmentProgress,
     Source,
+    StudentCourse,
+    StudentUnitProgress,
     Unit,
     User,
     Workspace,
@@ -542,3 +548,685 @@ def override_get_db():
         },
     )
     assert artifact_response.status_code == 400
+
+
+def test_review_center_lists_v2_wrappers_and_existing_governance_items(db_session):
+    admin = _admin_user()
+    organization = Organization(
+        id=uuid.uuid4(),
+        name="Review Org",
+        type=OrganizationType.SCHOOL,
+    )
+    course = Course(
+        id=uuid.uuid4(),
+        title="Blocked Runtime Course",
+        description="Existing course remains governed",
+        organization=organization,
+    )
+    unit = Unit(id=uuid.uuid4(), course=course, title="Runtime Unit", content="Runtime", order=1)
+    lesson = Lesson(
+        id=uuid.uuid4(),
+        unit=unit,
+        title="Draft Runtime Lesson",
+        objective="Needs source and approval",
+        order=1,
+        review_status="draft",
+    )
+    workspace = Workspace(id=uuid.uuid4(), organization=organization, name="Review Workspace")
+    project = Project(id=uuid.uuid4(), workspace=workspace, name="Review Project")
+    product = Product(
+        id=uuid.uuid4(),
+        workspace=workspace,
+        project=project,
+        course=course,
+        product_type="course",
+        title="Draft Product",
+        status="draft",
+    )
+    artifact = Artifact(
+        id=uuid.uuid4(),
+        workspace=workspace,
+        project=project,
+        product=product,
+        artifact_type="lesson_draft",
+        title="Pending Lesson Draft",
+        body="Reviewable wrapper content",
+        status="in_review",
+    )
+    db_session.add_all([admin, organization, course, unit, lesson, workspace, project, product, artifact])
+    db_session.commit()
+
+    test_app = FastAPI()
+    test_app.include_router(v2_platform.router, prefix="/api")
+
+    def override_get_db():
+        yield db_session
+
+    test_app.dependency_overrides[get_db] = override_get_db
+    test_app.dependency_overrides[get_current_user] = lambda: admin
+    client = TestClient(test_app)
+
+    response = client.get("/api/review-center")
+
+    assert response.status_code == 200
+    payload = response.json()
+    assert payload["pending_artifacts"][0]["id"] == str(artifact.id)
+    assert payload["pending_artifacts"][0]["status"] == "in_review"
+    assert payload["draft_products"][0]["id"] == str(product.id)
+    assert payload["draft_products"][0]["status"] == "draft"
+    assert payload["lesson_governance_items"][0]["id"] == str(course.id)
+    assert payload["lesson_governance_items"][0]["status"] == "blocked"
+    assert payload["recent_activity"][0]["id"] == "review-activity-placeholder"
+
+
+def test_review_status_updates_only_change_v2_wrapper_records(db_session):
+    admin = _admin_user()
+    organization = Organization(
+        id=uuid.uuid4(),
+        name="Status Org",
+        type=OrganizationType.SCHOOL,
+    )
+    course = Course(
+        id=uuid.uuid4(),
+        title="Runtime Status Course",
+        description="Runtime course",
+        organization=organization,
+        published_at=None,
+    )
+    unit = Unit(id=uuid.uuid4(), course=course, title="Runtime Unit", content="Runtime", order=1)
+    lesson = Lesson(id=uuid.uuid4(), unit=unit, title="Runtime Lesson", objective="Draft", review_status="draft")
+    workspace = Workspace(id=uuid.uuid4(), organization=organization, name="Status Workspace")
+    project = Project(id=uuid.uuid4(), workspace=workspace, name="Status Project")
+    product = Product(
+        id=uuid.uuid4(),
+        workspace=workspace,
+        project=project,
+        course=course,
+        product_type="course",
+        title="Status Product",
+        status="draft",
+        review_state="not_reviewed",
+    )
+    artifact = Artifact(
+        id=uuid.uuid4(),
+        workspace=workspace,
+        project=project,
+        product=product,
+        artifact_type="guide",
+        title="Status Artifact",
+        status="draft",
+        review_state="review_required",
+    )
+    db_session.add_all([admin, organization, course, unit, lesson, workspace, project, product, artifact])
+    db_session.commit()
+
+    test_app = FastAPI()
+    test_app.include_router(v2_platform.router, prefix="/api")
+
+    def override_get_db():
+        yield db_session
+
+    test_app.dependency_overrides[get_db] = override_get_db
+    test_app.dependency_overrides[get_current_user] = lambda: admin
+    client = TestClient(test_app)
+
+    artifact_response = client.patch(
+        f"/api/artifacts/{artifact.id}/review-status",
+        json={"status": "approved"},
+    )
+    product_response = client.patch(
+        f"/api/products/{product.id}/review-status",
+        json={"status": "approved"},
+    )
+    invalid_response = client.patch(
+        f"/api/artifacts/{artifact.id}/review-status",
+        json={"status": "published"},
+    )
+
+    assert artifact_response.status_code == 200
+    assert artifact_response.json()["status"] == "approved"
+    assert artifact_response.json()["review_state"] == "approved"
+    assert product_response.status_code == 200
+    assert product_response.json()["status"] == "approved"
+    assert product_response.json()["review_state"] == "approved"
+    assert invalid_response.status_code == 400
+
+    db_session.expire_all()
+    saved_course = db_session.query(Course).filter(Course.id == course.id).one()
+    saved_lesson = db_session.query(Lesson).filter(Lesson.id == lesson.id).one()
+    assert saved_course.published_at is None
+    assert saved_lesson.review_status == "draft"
+
+
+def test_approved_artifact_does_not_make_draft_lesson_learner_visible(db_session):
+    admin = _admin_user()
+    learner = User(
+        id=uuid.uuid4(),
+        firstname="Learner",
+        lastname="User",
+        username=f"learner_{uuid.uuid4().hex[:8]}",
+        email=f"learner_{uuid.uuid4().hex[:8]}@example.com",
+        hashed_password="hashed",
+        role="student",
+    )
+    organization = Organization(
+        id=uuid.uuid4(),
+        name="Learner Safety Org",
+        type=OrganizationType.SCHOOL,
+    )
+    course = Course(
+        id=uuid.uuid4(),
+        title="Learner Safety Course",
+        description="Existing governed course",
+        organization=organization,
+    )
+    unit = Unit(id=uuid.uuid4(), course=course, title="Runtime Unit", content="Runtime", order=1)
+    lesson = Lesson(
+        id=uuid.uuid4(),
+        unit=unit,
+        title="Unapproved Runtime Lesson",
+        objective="Still draft",
+        review_status="draft",
+        order=1,
+    )
+    workspace = Workspace(id=uuid.uuid4(), organization=organization, name="Learner Safety Workspace")
+    project = Project(id=uuid.uuid4(), workspace=workspace, name="Learner Safety Project")
+    product = Product(
+        id=uuid.uuid4(),
+        workspace=workspace,
+        project=project,
+        course=course,
+        product_type="course",
+        title="Learner Safety Product",
+    )
+    artifact = Artifact(
+        id=uuid.uuid4(),
+        workspace=workspace,
+        project=project,
+        product=product,
+        artifact_type="lesson_draft",
+        title="Approved Wrapper Only",
+        status="approved",
+        review_state="approved",
+    )
+    db_session.add_all([admin, learner, organization, course, unit, lesson, workspace, project, product, artifact])
+    db_session.commit()
+
+    test_app = FastAPI()
+    test_app.include_router(courses.router, prefix="/api")
+
+    def override_get_db():
+        yield db_session
+
+    test_app.dependency_overrides[get_db] = override_get_db
+    test_app.dependency_overrides[get_current_user] = lambda: learner
+    client = TestClient(test_app)
+
+    response = client.get(f"/api/courses/{course.id}")
+
+    assert response.status_code == 200
+    payload = response.json()
+    assert payload["units"][0]["learner_availability"] == "no_approved_content"
+    assert payload["units"][0]["lessons"] == []
+
+
+def test_learner_portal_products_use_enrollments_and_active_grants(db_session):
+    learner = User(
+        id=uuid.uuid4(),
+        firstname="Learner",
+        lastname="Portal",
+        username=f"learner_{uuid.uuid4().hex[:8]}",
+        email=f"learner_{uuid.uuid4().hex[:8]}@example.com",
+        hashed_password="hashed",
+        role="student",
+    )
+    organization = Organization(
+        id=uuid.uuid4(),
+        name="Learner Product Org",
+        type=OrganizationType.SCHOOL,
+    )
+    membership = OrganizationMembership(
+        id=uuid.uuid4(),
+        organization=organization,
+        user=learner,
+        role="student",
+        status="active",
+    )
+    workspace = Workspace(id=uuid.uuid4(), organization=organization, name="Learner Product Workspace")
+    project = Project(id=uuid.uuid4(), workspace=workspace, name="Learner Product Project")
+    enrolled_course = Course(
+        id=uuid.uuid4(),
+        title="Enrolled Course",
+        description="Existing runtime enrollment",
+        organization=organization,
+    )
+    available_course = Course(
+        id=uuid.uuid4(),
+        title="Available Course",
+        description="Approved wrapper",
+        organization=organization,
+    )
+    draft_course = Course(
+        id=uuid.uuid4(),
+        title="Draft Wrapper Course",
+        description="Should not be available through learner products",
+        organization=organization,
+    )
+    enrollment = StudentCourse(
+        id=uuid.uuid4(),
+        student=learner,
+        course=enrolled_course,
+        status="active",
+    )
+    enrolled_product = Product(
+        id=uuid.uuid4(),
+        workspace=workspace,
+        project=project,
+        course=enrolled_course,
+        product_type="course",
+        title="Draft Enrolled Product",
+        status="draft",
+        review_state="draft",
+    )
+    available_product = Product(
+        id=uuid.uuid4(),
+        workspace=workspace,
+        project=project,
+        course=available_course,
+        product_type="course",
+        title="Approved Available Product",
+        status="approved",
+        review_state="approved",
+    )
+    available_grant = AccessGrant(
+        id=uuid.uuid4(),
+        user=learner,
+        product=available_product,
+        workspace=workspace,
+        project=project,
+        grant_type="manual",
+        status="active",
+        source="manual",
+    )
+    draft_product = Product(
+        id=uuid.uuid4(),
+        workspace=workspace,
+        project=project,
+        course=draft_course,
+        product_type="course",
+        title="Hidden Draft Product",
+        status="draft",
+        review_state="draft",
+    )
+    db_session.add_all([
+        learner,
+        organization,
+        membership,
+        workspace,
+        project,
+        enrolled_course,
+        available_course,
+        draft_course,
+        enrollment,
+        enrolled_product,
+        available_product,
+            draft_product,
+            available_grant,
+        ])
+    db_session.commit()
+
+    test_app = FastAPI()
+    test_app.include_router(v2_platform.router, prefix="/api")
+
+    def override_get_db():
+        yield db_session
+
+    test_app.dependency_overrides[get_db] = override_get_db
+    test_app.dependency_overrides[get_current_user] = lambda: learner
+    client = TestClient(test_app)
+
+    response = client.get("/api/learner-portal/products")
+
+    assert response.status_code == 200
+    payload = response.json()
+    titles = {item["title"] for item in payload}
+    assert "Draft Enrolled Product" in titles
+    assert "Approved Available Product" in titles
+    assert "Hidden Draft Product" not in titles
+
+    enrolled = next(item for item in payload if item["title"] == "Draft Enrolled Product")
+    available = next(item for item in payload if item["title"] == "Approved Available Product")
+    assert enrolled["is_enrolled"] is True
+    assert enrolled["product_status"] == "draft"
+    assert enrolled["learner_visibility"].startswith("Existing enrollment controls access")
+    assert available["is_enrolled"] is False
+    assert available["product_status"] == "approved"
+    assert available["access_grant_id"] == str(available_grant.id)
+
+
+def test_access_grant_create_revoke_and_learner_visibility_are_additive(db_session):
+    admin = _admin_user()
+    learner = User(
+        id=uuid.uuid4(),
+        firstname="Grant",
+        lastname="Learner",
+        username=f"grant_learner_{uuid.uuid4().hex[:8]}",
+        email=f"grant_learner_{uuid.uuid4().hex[:8]}@example.com",
+        hashed_password="hashed",
+        role="student",
+    )
+    organization = Organization(
+        id=uuid.uuid4(),
+        name="Grant Org",
+        type=OrganizationType.SCHOOL,
+    )
+    workspace = Workspace(id=uuid.uuid4(), organization=organization, name="Grant Workspace")
+    project = Project(id=uuid.uuid4(), workspace=workspace, name="Grant Project")
+    course = Course(
+        id=uuid.uuid4(),
+        title="Grant Course",
+        description="Access grant backed course",
+        organization=organization,
+    )
+    unit = Unit(id=uuid.uuid4(), course=course, title="Grant Unit", content="Runtime", order=1)
+    lesson = Lesson(
+        id=uuid.uuid4(),
+        unit=unit,
+        title="Grant Draft Lesson",
+        objective="Still governed",
+        review_status="draft",
+        order=1,
+    )
+    product = Product(
+        id=uuid.uuid4(),
+        workspace=workspace,
+        project=project,
+        course=course,
+        product_type="course",
+        title="Grant Product",
+        status="approved",
+        review_state="approved",
+    )
+    db_session.add_all([admin, learner, organization, workspace, project, course, unit, lesson, product])
+    db_session.commit()
+
+    test_app = FastAPI()
+    test_app.include_router(v2_platform.router, prefix="/api")
+    test_app.include_router(courses.router, prefix="/api")
+
+    def override_get_db():
+        yield db_session
+
+    test_app.dependency_overrides[get_db] = override_get_db
+    test_app.dependency_overrides[get_current_user] = lambda: admin
+    admin_client = TestClient(test_app)
+
+    create_response = admin_client.post(
+        "/api/access-grants",
+        json={
+            "user_id": str(learner.id),
+            "product_id": str(product.id),
+            "grant_type": "manual",
+            "source": "manual",
+            "metadata": {"reason": "phase7-test"},
+        },
+    )
+    assert create_response.status_code == 201
+    grant_payload = create_response.json()
+    grant_id = grant_payload["id"]
+    assert grant_payload["status"] == "active"
+    assert grant_payload["workspace_id"] == str(workspace.id)
+    assert db_session.query(StudentCourse).filter(StudentCourse.student_id == learner.id).count() == 0
+
+    list_response = admin_client.get("/api/access-grants")
+    assert list_response.status_code == 200
+    assert list_response.json()[0]["id"] == grant_id
+
+    test_app.dependency_overrides[get_current_user] = lambda: learner
+    learner_client = TestClient(test_app)
+    learner_products_response = learner_client.get("/api/learner-portal/products")
+    assert learner_products_response.status_code == 200
+    learner_products = learner_products_response.json()
+    assert learner_products[0]["title"] == "Grant Product"
+    assert learner_products[0]["access_grant_id"] == grant_id
+    assert learner_products[0]["is_enrolled"] is False
+    assert learner_products[0]["learner_visibility"].startswith("Active access grant")
+
+    course_response = learner_client.get(f"/api/courses/{course.id}")
+    assert course_response.status_code == 200
+    course_payload = course_response.json()
+    assert course_payload["units"][0]["learner_availability"] == "no_approved_content"
+    assert course_payload["units"][0]["lessons"] == []
+
+    test_app.dependency_overrides[get_current_user] = lambda: admin
+    revoke_response = admin_client.patch(f"/api/access-grants/{grant_id}/revoke")
+    assert revoke_response.status_code == 200
+    assert revoke_response.json()["status"] == "revoked"
+
+    test_app.dependency_overrides[get_current_user] = lambda: learner
+    after_revoke_response = learner_client.get("/api/learner-portal/products")
+    assert after_revoke_response.status_code == 200
+    assert after_revoke_response.json() == []
+
+
+def test_access_grant_does_not_expose_unapproved_product_to_learner_portal(db_session):
+    admin = _admin_user()
+    learner = User(
+        id=uuid.uuid4(),
+        firstname="Draft",
+        lastname="Learner",
+        username=f"draft_learner_{uuid.uuid4().hex[:8]}",
+        email=f"draft_learner_{uuid.uuid4().hex[:8]}@example.com",
+        hashed_password="hashed",
+        role="student",
+    )
+    organization = Organization(
+        id=uuid.uuid4(),
+        name="Draft Grant Org",
+        type=OrganizationType.SCHOOL,
+    )
+    workspace = Workspace(id=uuid.uuid4(), organization=organization, name="Draft Grant Workspace")
+    product = Product(
+        id=uuid.uuid4(),
+        workspace=workspace,
+        product_type="resource_pack",
+        title="Draft Granted Product",
+        status="draft",
+        review_state="draft",
+    )
+    grant = AccessGrant(
+        id=uuid.uuid4(),
+        user=learner,
+        product=product,
+        workspace=workspace,
+        grant_type="manual",
+        status="active",
+        source="manual",
+    )
+    db_session.add_all([admin, learner, organization, workspace, product, grant])
+    db_session.commit()
+
+    test_app = FastAPI()
+    test_app.include_router(v2_platform.router, prefix="/api")
+
+    def override_get_db():
+        yield db_session
+
+    test_app.dependency_overrides[get_db] = override_get_db
+    test_app.dependency_overrides[get_current_user] = lambda: learner
+    client = TestClient(test_app)
+
+    response = client.get("/api/learner-portal/products")
+
+    assert response.status_code == 200
+    assert response.json() == []
+
+
+def test_analytics_v2_reports_wrapper_and_runtime_state_read_only(db_session):
+    admin = _admin_user()
+    learner = User(
+        id=uuid.uuid4(),
+        firstname="Metric",
+        lastname="Learner",
+        username=f"metric_learner_{uuid.uuid4().hex[:8]}",
+        email=f"metric_learner_{uuid.uuid4().hex[:8]}@example.com",
+        hashed_password="hashed",
+        role="student",
+    )
+    organization = Organization(
+        id=uuid.uuid4(),
+        name="Analytics Org",
+        type=OrganizationType.SCHOOL,
+    )
+    course = Course(
+        id=uuid.uuid4(),
+        title="Analytics Course",
+        description="Runtime course for analytics",
+        organization=organization,
+    )
+    unit = Unit(
+        id=uuid.uuid4(),
+        course=course,
+        title="Analytics Unit",
+        content="Runtime unit",
+        order=1,
+    )
+    lesson = Lesson(
+        id=uuid.uuid4(),
+        unit=unit,
+        title="Analytics Lesson",
+        objective="Track existing progress",
+    )
+    enrollment = StudentCourse(
+        id=uuid.uuid4(),
+        student=learner,
+        course=course,
+        status="active",
+    )
+    unit_progress = StudentUnitProgress(
+        id=uuid.uuid4(),
+        student_course=enrollment,
+        unit=unit,
+        status=ProgressStatus.COMPLETED,
+    )
+    segment_progress = SegmentProgress(
+        id=uuid.uuid4(),
+        student_unit=unit_progress,
+        lesson=lesson,
+        status=ProgressStatus.COMPLETED,
+    )
+    workspace = Workspace(id=uuid.uuid4(), organization=organization, name="Analytics Workspace")
+    project = Project(id=uuid.uuid4(), workspace=workspace, name="Analytics Project")
+    product = Product(
+        id=uuid.uuid4(),
+        workspace=workspace,
+        project=project,
+        course=course,
+        product_type="course",
+        title="Analytics Product",
+        status="published",
+        review_state="approved",
+    )
+    knowledge_source = KnowledgeSource(
+        id=uuid.uuid4(),
+        workspace=workspace,
+        project=project,
+        title="Analytics Source",
+        source_type="lesson_source",
+        status="available",
+    )
+    generation_run = GenerationRun(
+        id=uuid.uuid4(),
+        workspace=workspace,
+        project=project,
+        product=product,
+        status="completed",
+    )
+    artifact = Artifact(
+        id=uuid.uuid4(),
+        workspace=workspace,
+        project=project,
+        product=product,
+        knowledge_source=knowledge_source,
+        generation_run=generation_run,
+        artifact_type="guide",
+        title="Analytics Artifact",
+        status="needs_changes",
+        review_state="needs_changes",
+    )
+    access_grant = AccessGrant(
+        id=uuid.uuid4(),
+        user=learner,
+        product=product,
+        workspace=workspace,
+        grant_type="manual",
+        status="active",
+        source="manual",
+    )
+    db_session.add_all([
+        admin,
+        learner,
+        organization,
+        course,
+        unit,
+        lesson,
+        enrollment,
+        unit_progress,
+        segment_progress,
+        workspace,
+        project,
+        product,
+        knowledge_source,
+        generation_run,
+        artifact,
+        access_grant,
+    ])
+    db_session.commit()
+
+    initial_enrollment_count = db_session.query(StudentCourse).count()
+    test_app = FastAPI()
+    test_app.include_router(analytics.router, prefix="/api")
+
+    def override_get_db():
+        yield db_session
+
+    test_app.dependency_overrides[get_db] = override_get_db
+    test_app.dependency_overrides[get_current_user] = lambda: admin
+    client = TestClient(test_app)
+
+    workspace_response = client.get("/api/analytics/workspace")
+    products_response = client.get("/api/analytics/products")
+    learners_response = client.get("/api/analytics/learners")
+    pipeline_response = client.get("/api/analytics/knowledge-pipeline")
+
+    assert workspace_response.status_code == 200
+    workspace_payload = workspace_response.json()
+    assert workspace_payload["totals"]["total_products"] == 1
+    assert workspace_payload["totals"]["total_projects"] == 1
+    assert workspace_payload["totals"]["total_knowledge_sources"] == 1
+    assert workspace_payload["totals"]["total_artifacts"] == 1
+    assert workspace_payload["totals"]["total_access_grants"] == 1
+    assert workspace_payload["products_by_type"]["course"] == 1
+    assert workspace_payload["products_by_status"]["published"] == 1
+    assert workspace_payload["artifacts_by_status"]["needs_changes"] == 1
+    assert workspace_payload["access_grants_by_type"]["manual"] == 1
+    assert workspace_payload["learner_engagement"]["lesson_completion_count"] == 1
+    assert workspace_payload["event_tracking"]["status"] == "unavailable"
+
+    assert products_response.status_code == 200
+    products_payload = products_response.json()
+    assert products_payload["course_backed_product_count"] == 1
+    assert products_payload["products"][0]["enrollment_count"] == 1
+    assert products_payload["products"][0]["artifact_count"] == 1
+
+    assert learners_response.status_code == 200
+    learners_payload = learners_response.json()
+    assert learners_payload["summary"]["learner_count"] == 1
+    assert learners_payload["enrollments_by_status"]["active"] == 1
+
+    assert pipeline_response.status_code == 200
+    pipeline_payload = pipeline_response.json()
+    assert pipeline_payload["total_generation_runs"] == 1
+    assert pipeline_payload["source_coverage"]["artifacts_with_knowledge_source"] == 1
+
+    assert db_session.query(StudentCourse).count() == initial_enrollment_count
diff --git a/frontend/src/app/app.routes.spec.ts b/frontend/src/app/app.routes.spec.ts
index 9591488..f3df40e 100644
--- a/frontend/src/app/app.routes.spec.ts
+++ b/frontend/src/app/app.routes.spec.ts
@@ -1,5 +1,9 @@
 import { Route, Routes } from '@angular/router';
 import { routes } from './app.routes';
+import { LearnerPortalComponent } from './pages/learner-portal/learner-portal.component';
+import { LearnerProductsComponent } from './pages/learner-portal/learner-products.component';
+import { LearnerResourcesComponent } from './pages/learner-portal/learner-resources.component';
+import { LessonViewComponent } from './pages/lesson-view.component';
 
 function findRoute(routeList: Routes, path: string): Route | undefined {
   const exactRoute = routeList.find(candidate => candidate.path === path);
@@ -50,6 +54,7 @@ describe('app routes', () => {
       'workspace/artifacts',
       'workspace/artifacts/:artifactId',
       'workspace/review-center',
+      'workspace/access',
       'workspace/learners',
       'workspace/analytics',
       'workspace/settings',
@@ -67,4 +72,14 @@ describe('app routes', () => {
       'learn/lesson/:id',
     ].forEach(path => expect(findRoute(routes, path)).withContext(path).toBeTruthy());
   });
+
+  it('maps Learner Portal V2 routes to V2 pages while reusing lesson runtime', () => {
+    const learnRoute = findRoute(routes, 'learn');
+    const learnerShell = learnRoute?.children?.find(route => route.path === '');
+    expect(learnerShell?.children?.find(route => route.path === '')?.component).toBe(LearnerPortalComponent);
+    expect(learnerShell?.children?.find(route => route.path === 'products')?.component).toBe(LearnerProductsComponent);
+    expect(learnerShell?.children?.find(route => route.path === 'resources')?.component).toBe(LearnerResourcesComponent);
+    expect(learnerShell?.children?.find(route => route.path === 'lesson/:id')?.component).toBe(LessonViewComponent);
+    expect(findRoute(routes, 'home/lesson/:id')?.component).toBe(LessonViewComponent);
+  });
 });
diff --git a/frontend/src/app/app.routes.ts b/frontend/src/app/app.routes.ts
index 7f089f3..064c53f 100644
--- a/frontend/src/app/app.routes.ts
+++ b/frontend/src/app/app.routes.ts
@@ -30,6 +30,12 @@ import { ProductDetailComponent } from './pages/product-detail/product-detail.co
 import { ProjectDetailComponent } from './pages/project-detail/project-detail.component';
 import { ArtifactDetailComponent } from './pages/artifact-detail/artifact-detail.component';
 import { GenerationRunDetailComponent } from './pages/generation-run-detail/generation-run-detail.component';
+import { ReviewCenterComponent } from './pages/review-center/review-center.component';
+import { LearnerPortalComponent } from './pages/learner-portal/learner-portal.component';
+import { LearnerProductsComponent } from './pages/learner-portal/learner-products.component';
+import { LearnerResourcesComponent } from './pages/learner-portal/learner-resources.component';
+import { AccessGrantsComponent } from './pages/access-grants/access-grants.component';
+import { WorkspaceAnalyticsComponent } from './pages/workspace-analytics/workspace-analytics.component';
 
 const creatorRoles = ['admin', 'teacher', 'content_admin', 'org_admin', 'instructor'];
 const studioRoles = ['content_admin', 'org_admin'];
@@ -258,19 +264,15 @@ export const routes: Routes = [
       },
       {
         path: 'review-center',
-        component: V2PlatformPageComponent,
+        component: ReviewCenterComponent,
         canActivate: [RoleGuard],
-        data: {
-          roles: creatorRoles,
-          eyebrow: 'Review Center',
-          title: 'Governance and readiness review',
-          description: 'Review Center will centralize source-backed lesson readiness, approvals, and product publishing confidence.',
-          status: 'Phase 1 preserves existing governance behavior and provides links into current review-capable surfaces.',
-          links: [
-            { label: 'Studio courses', route: '/workspace/product-studio/courses' },
-            { label: 'Managed products', route: '/workspace/products/manage' }
-          ]
-        }
+        data: { roles: creatorRoles }
+      },
+      {
+        path: 'access',
+        component: AccessGrantsComponent,
+        canActivate: [RoleGuard],
+        data: { roles: creatorRoles }
       },
       {
         path: 'learners',
@@ -302,15 +304,9 @@ export const routes: Routes = [
       },
       {
         path: 'analytics',
-        component: V2PlatformPageComponent,
+        component: WorkspaceAnalyticsComponent,
         canActivate: [RoleGuard],
-        data: {
-          roles: creatorRoles,
-          eyebrow: 'Analytics',
-          title: 'Learner and product intelligence',
-          description: 'Analytics V2 will connect progress, completion, readiness, and product performance into operational confidence views.',
-          status: 'Placeholder route: existing progress tracking remains the runtime source of truth.'
-        }
+        data: { roles: creatorRoles }
       },
       { path: 'settings', component: PreferencesComponent },
       {
@@ -337,20 +333,11 @@ export const routes: Routes = [
         path: '',
         component: UserDashboardComponent,
         children: [
-          { path: '', component: EchoedRoleSelectorComponent },
-          { path: 'products', component: AvailableCoursesComponent },
+          { path: '', component: LearnerPortalComponent },
+          { path: 'products', component: LearnerProductsComponent },
           { path: 'paths', component: ProgramsComponent },
           { path: 'certificates', component: CertificationsComponent },
-          {
-            path: 'resources',
-            component: V2PlatformPageComponent,
-            data: {
-              eyebrow: 'Resources',
-              title: 'Knowledge resources',
-              description: 'Downloadable documentation packs and knowledge hub resources will appear here as the V2 artifact registry comes online.',
-              status: 'Placeholder route: current learner course and certification routes remain unchanged.'
-            }
-          },
+          { path: 'resources', component: LearnerResourcesComponent },
           { path: 'lesson/:id', component: LessonViewComponent },
         ]
       }
diff --git a/frontend/src/app/components/echo-sidebar/echo-sidebar.component.ts b/frontend/src/app/components/echo-sidebar/echo-sidebar.component.ts
index e2266dd..4371de1 100644
--- a/frontend/src/app/components/echo-sidebar/echo-sidebar.component.ts
+++ b/frontend/src/app/components/echo-sidebar/echo-sidebar.component.ts
@@ -47,6 +47,7 @@ export class SidebarComponent {
         { label: 'Knowledge Sources', route: '/workspace/knowledge-sources', icon: 'BookOpen', permission: 'nav:knowledge-sources' },
         { label: 'Artifacts', route: '/workspace/artifacts', icon: 'Award', permission: 'nav:artifacts' },
         { label: 'Review Center', route: '/workspace/review-center', icon: 'ClipboardList', permission: 'nav:review-center' },
+        { label: 'Access', route: '/workspace/access', icon: 'Users', permission: 'nav:access' },
         { label: 'Analytics', route: '/workspace/analytics', icon: 'SlidersHorizontal', permission: 'nav:analytics' },
       ]
     },
diff --git a/frontend/src/app/models/v2-platform.model.ts b/frontend/src/app/models/v2-platform.model.ts
index a9a8c99..db4c33d 100644
--- a/frontend/src/app/models/v2-platform.model.ts
+++ b/frontend/src/app/models/v2-platform.model.ts
@@ -73,6 +73,73 @@ export interface Artifact {
   updated_at: string;
 }
 
+export interface ReviewCenterItem {
+  id: string;
+  item_type: 'artifact' | 'product' | 'lesson_governance' | string;
+  title: string;
+  status: string;
+  review_state?: string | null;
+  owner?: string | null;
+  source_coverage: string;
+  readiness: string;
+  required_decision: string;
+  blocked: boolean;
+  detail_route?: string | null;
+  governance_route?: string | null;
+  updated_at?: string | null;
+}
+
+export interface ReviewCenterActivity {
+  id: string;
+  message: string;
+  created_at?: string | null;
+}
+
+export interface ReviewCenter {
+  pending_artifacts: ReviewCenterItem[];
+  draft_products: ReviewCenterItem[];
+  lesson_governance_items: ReviewCenterItem[];
+  recent_activity: ReviewCenterActivity[];
+}
+
+export interface LearnerProduct {
+  id: string;
+  product_id?: string | null;
+  course_id?: string | null;
+  title: string;
+  description?: string | null;
+  product_type: string;
+  product_status?: string | null;
+  review_state?: string | null;
+  access_state?: string | null;
+  enrollment_id?: string | null;
+  enrollment_status?: string | null;
+  enrolled_on?: string | null;
+  access_grant_id?: string | null;
+  access_grant_status?: string | null;
+  is_enrolled: boolean;
+  source: 'product_wrapper' | 'runtime_course' | string;
+  learner_visibility: string;
+  next_action: string;
+}
+
+export interface AccessGrant {
+  id: string;
+  user_id: string;
+  product_id: string;
+  workspace_id: string;
+  project_id?: string | null;
+  grant_type: string;
+  status: string;
+  source: string;
+  starts_at?: string | null;
+  expires_at?: string | null;
+  revoked_at?: string | null;
+  metadata: Record<string, unknown>;
+  created_at: string;
+  updated_at: string;
+}
+
 export interface GenerationRun {
   id: string;
   workspace_id: string;
@@ -113,6 +180,19 @@ export interface ProductCreateRequest {
   metadata?: Record<string, unknown>;
 }
 
+export interface AccessGrantCreateRequest {
+  user_id: string;
+  product_id: string;
+  workspace_id?: string | null;
+  project_id?: string | null;
+  grant_type?: string;
+  status?: string;
+  source?: string;
+  starts_at?: string | null;
+  expires_at?: string | null;
+  metadata?: Record<string, unknown>;
+}
+
 export interface KnowledgeSourceCreateRequest {
   workspace_id: string;
   project_id: string;
@@ -140,3 +220,7 @@ export interface ArtifactCreateRequest {
   review_state?: string;
   metadata?: Record<string, unknown>;
 }
+
+export interface ReviewStatusUpdateRequest {
+  status: string;
+}
diff --git a/frontend/src/app/pages/access-grants/access-grants.component.ts b/frontend/src/app/pages/access-grants/access-grants.component.ts
new file mode 100644
index 0000000..0ab6e5c
--- /dev/null
+++ b/frontend/src/app/pages/access-grants/access-grants.component.ts
@@ -0,0 +1,186 @@
+import { CommonModule } from '@angular/common';
+import { Component, OnInit, inject } from '@angular/core';
+import { FormsModule } from '@angular/forms';
+import { AccessGrant, Product } from '../../models/v2-platform.model';
+import { V2PlatformService } from '../../services/v2-platform.service';
+
+@Component({
+  selector: 'app-access-grants',
+  standalone: true,
+  imports: [CommonModule, FormsModule],
+  template: `
+    <section class="access" aria-labelledby="access-title">
+      <header>
+        <p>Access Grants</p>
+        <h1 id="access-title">Product access management</h1>
+        <span>Grant product-level access without changing course enrollment, checkout, or lesson governance.</span>
+      </header>
+
+      <form class="panel" (ngSubmit)="createGrant()" aria-label="Create access grant">
+        <h2>Create manual grant</h2>
+        <label>
+          Product
+          <select name="productId" [(ngModel)]="form.product_id" required>
+            <option value="">Select product</option>
+            <option *ngFor="let product of products" [value]="product.id">{{ product.title }}</option>
+          </select>
+        </label>
+        <label>
+          Learner user ID
+          <input name="userId" [(ngModel)]="form.user_id" required placeholder="User UUID" />
+        </label>
+        <label>
+          Grant type
+          <select name="grantType" [(ngModel)]="form.grant_type">
+            <option *ngFor="let type of grantTypes" [value]="type">{{ label(type) }}</option>
+          </select>
+        </label>
+        <label>
+          Status
+          <select name="status" [(ngModel)]="form.status">
+            <option value="active">Active</option>
+            <option value="pending">Pending</option>
+          </select>
+        </label>
+        <label>
+          Source
+          <input name="source" [(ngModel)]="form.source" />
+        </label>
+        <label>
+          Starts at
+          <input name="startsAt" type="datetime-local" [(ngModel)]="form.starts_at" />
+        </label>
+        <label>
+          Expires at
+          <input name="expiresAt" type="datetime-local" [(ngModel)]="form.expires_at" />
+        </label>
+        <button type="submit">Create grant</button>
+        <p class="message" *ngIf="message">{{ message }}</p>
+      </form>
+
+      <article class="panel">
+        <div class="panel__heading">
+          <h2>Existing grants</h2>
+          <button type="button" (click)="loadGrants()">Refresh</button>
+        </div>
+        <div class="empty" *ngIf="!grants.length">No access grants found.</div>
+        <div class="grant" *ngFor="let grant of grants">
+          <div>
+            <h3>{{ productTitle(grant.product_id) }}</h3>
+            <p>{{ grant.user_id }}</p>
+          </div>
+          <dl>
+            <div>
+              <dt>Type</dt>
+              <dd>{{ label(grant.grant_type) }}</dd>
+            </div>
+            <div>
+              <dt>Status</dt>
+              <dd>{{ label(grant.status) }}</dd>
+            </div>
+            <div>
+              <dt>Source</dt>
+              <dd>{{ grant.source }}</dd>
+            </div>
+          </dl>
+          <button type="button" [disabled]="grant.status === 'revoked'" (click)="revoke(grant)">Revoke</button>
+        </div>
+      </article>
+    </section>
+  `,
+  styles: [`
+    .access { color: #102033; display: grid; gap: 1rem; padding: clamp(1rem, 3vw, 2rem); }
+    header, .panel { background: #fff; border: 1px solid #d8e1ea; border-radius: 8px; box-shadow: 0 14px 32px rgba(16,32,51,.08); padding: clamp(1rem, 3vw, 1.5rem); }
+    header p { color: #0f766e; font-size: .76rem; font-weight: 900; letter-spacing: .12em; margin: 0 0 .35rem; text-transform: uppercase; }
+    h1, h2, h3 { letter-spacing: 0; margin: 0; }
+    h1 { font-size: clamp(2rem, 5vw, 3rem); line-height: 1; }
+    header span, .message, .empty, .grant p, dd { color: #526273; }
+    form.panel { display: grid; gap: .85rem; grid-template-columns: repeat(auto-fit, minmax(15rem, 1fr)); }
+    form h2, form button, .message { grid-column: 1 / -1; }
+    label { color: #334155; display: grid; font-weight: 900; gap: .35rem; }
+    input, select { border: 1px solid #cbd5e1; border-radius: 6px; color: #102033; font: inherit; padding: .65rem .75rem; }
+    button { background: #102033; border: 1px solid #102033; border-radius: 6px; color: #fff; cursor: pointer; font: inherit; font-weight: 900; padding: .65rem .85rem; width: fit-content; }
+    button:disabled { background: #e2e8f0; border-color: #cbd5e1; color: #64748b; cursor: default; }
+    .panel { display: grid; gap: .9rem; }
+    .panel__heading { align-items: center; display: flex; justify-content: space-between; gap: 1rem; }
+    .grant { border: 1px solid #d8e1ea; border-radius: 8px; display: grid; gap: .75rem; padding: 1rem; }
+    dl { display: grid; gap: .55rem; grid-template-columns: repeat(auto-fit, minmax(8rem, 1fr)); margin: 0; }
+    dt { color: #334155; font-size: .75rem; font-weight: 900; text-transform: uppercase; }
+    dd { margin: .15rem 0 0; }
+    input:focus-visible, select:focus-visible, button:focus-visible { outline: 3px solid rgba(15,118,110,.25); outline-offset: 3px; }
+  `]
+})
+export class AccessGrantsComponent implements OnInit {
+  private readonly v2Platform = inject(V2PlatformService);
+
+  readonly grantTypes = ['manual', 'enrollment', 'membership', 'purchase', 'organization', 'invitation'];
+  grants: AccessGrant[] = [];
+  products: Product[] = [];
+  message = '';
+  form = {
+    user_id: '',
+    product_id: '',
+    grant_type: 'manual',
+    status: 'active',
+    source: 'manual',
+    starts_at: '',
+    expires_at: '',
+  };
+
+  ngOnInit(): void {
+    this.v2Platform.getProducts().subscribe(products => {
+      this.products = products;
+    });
+    this.loadGrants();
+  }
+
+  createGrant(): void {
+    const product = this.products.find(item => item.id === this.form.product_id);
+    this.v2Platform.createAccessGrant({
+      user_id: this.form.user_id,
+      product_id: this.form.product_id,
+      workspace_id: product?.workspace_id,
+      project_id: product?.project_id,
+      grant_type: this.form.grant_type,
+      status: this.form.status,
+      source: this.form.source || this.form.grant_type,
+      starts_at: this.form.starts_at ? new Date(this.form.starts_at).toISOString() : null,
+      expires_at: this.form.expires_at ? new Date(this.form.expires_at).toISOString() : null,
+      metadata: { created_from: 'workspace_access_view' },
+    }).subscribe({
+      next: () => {
+        this.message = 'Access grant saved.';
+        this.loadGrants();
+      },
+      error: () => {
+        this.message = 'Unable to save access grant.';
+      },
+    });
+  }
+
+  revoke(grant: AccessGrant): void {
+    this.v2Platform.revokeAccessGrant(grant.id).subscribe({
+      next: () => {
+        this.message = 'Access grant revoked.';
+        this.loadGrants();
+      },
+      error: () => {
+        this.message = 'Unable to revoke access grant.';
+      },
+    });
+  }
+
+  loadGrants(): void {
+    this.v2Platform.getAccessGrants().subscribe(grants => {
+      this.grants = grants;
+    });
+  }
+
+  productTitle(productId: string): string {
+    return this.products.find(product => product.id === productId)?.title || productId;
+  }
+
+  label(value: string): string {
+    return value.replace(/_/g, ' ').replace(/\b\w/g, char => char.toUpperCase());
+  }
+}
diff --git a/frontend/src/app/pages/learner-portal/learner-portal.component.ts b/frontend/src/app/pages/learner-portal/learner-portal.component.ts
new file mode 100644
index 0000000..a38ef19
--- /dev/null
+++ b/frontend/src/app/pages/learner-portal/learner-portal.component.ts
@@ -0,0 +1,197 @@
+import { CommonModule } from '@angular/common';
+import { Component, OnInit, inject } from '@angular/core';
+import { Router, RouterModule } from '@angular/router';
+import { forkJoin } from 'rxjs';
+import { EchoButtonComponent } from '../../components/echo-button/echo-button.component';
+import { LearnerProduct } from '../../models/v2-platform.model';
+import { CoursesService } from '../../services/courses.service';
+import { ProgramsService } from '../../services/programs.service';
+import { ToastService } from '../../services/toast.service';
+import { V2PlatformService } from '../../services/v2-platform.service';
+
+@Component({
+  selector: 'app-learner-portal',
+  standalone: true,
+  imports: [CommonModule, RouterModule, EchoButtonComponent],
+  template: `
+    <section class="learner-portal" aria-labelledby="learner-portal-title">
+      <header>
+        <p>Learner Portal</p>
+        <h1 id="learner-portal-title">Your products and learning paths</h1>
+        <span>Products organize your access. Lessons still open through the existing governed course runtime.</span>
+      </header>
+
+      <nav aria-label="Learner portal sections">
+        <a routerLink="/learn/products">Products</a>
+        <a routerLink="/learn/paths">Paths</a>
+        <a routerLink="/learn/certificates">Certificates</a>
+        <a routerLink="/learn/resources">Resources</a>
+      </nav>
+
+      <div class="summary">
+        <article>
+          <strong>{{ enrolledProducts.length }}</strong>
+          <span>Enrolled products</span>
+        </article>
+        <article>
+          <strong>{{ availableProducts.length }}</strong>
+          <span>Available products</span>
+        </article>
+        <article>
+          <strong>{{ programCount }}</strong>
+          <span>Learning paths</span>
+        </article>
+        <article>
+          <strong>{{ certificateCount }}</strong>
+          <span>Certificates</span>
+        </article>
+      </div>
+
+      <section class="panel" aria-labelledby="next-product-heading">
+        <div class="panel__heading">
+          <div>
+            <p>Next Action</p>
+            <h2 id="next-product-heading">{{ nextProduct?.title || 'No active product yet' }}</h2>
+          </div>
+          <span *ngIf="nextProduct">{{ nextProduct.is_enrolled ? 'Enrolled' : 'Available' }}</span>
+        </div>
+        <p>{{ nextProduct?.learner_visibility || 'Enroll in a product to start a governed learning path.' }}</p>
+        <app-echo-button
+          *ngIf="nextProduct?.is_enrolled"
+          color="primary"
+          label="Continue learning"
+          (click)="continueProduct(nextProduct!)"
+        ></app-echo-button>
+        <app-echo-button
+          *ngIf="nextProduct && !nextProduct.is_enrolled"
+          color="accent"
+          label="Enroll"
+          (click)="enroll(nextProduct)"
+        ></app-echo-button>
+      </section>
+
+      <section class="panel" aria-labelledby="enrolled-products-heading">
+        <div class="panel__heading">
+          <div>
+            <p>Products</p>
+            <h2 id="enrolled-products-heading">Current enrollments</h2>
+          </div>
+          <a routerLink="/learn/products">View all</a>
+        </div>
+        <div class="cards" *ngIf="enrolledProducts.length; else emptyProducts">
+          <article class="product" *ngFor="let product of enrolledProducts | slice:0:3">
+            <h3>{{ product.title }}</h3>
+            <p>{{ product.description || product.learner_visibility }}</p>
+            <span>{{ label(product.source) }} · {{ label(product.enrollment_status || 'enrolled') }}</span>
+            <button type="button" (click)="continueProduct(product)">Continue</button>
+          </article>
+        </div>
+        <ng-template #emptyProducts>
+          <p class="empty">Your enrolled products will appear here after course enrollment.</p>
+        </ng-template>
+      </section>
+    </section>
+  `,
+  styles: [`
+    .learner-portal { color: #102033; display: grid; gap: 1rem; padding: clamp(1rem, 3vw, 2rem); }
+    header, .panel, .summary article { background: #fff; border: 1px solid #d8e1ea; border-radius: 8px; box-shadow: 0 14px 32px rgba(16,32,51,.08); padding: clamp(1rem, 3vw, 1.5rem); }
+    header p, .panel__heading p { color: #0f766e; font-size: .76rem; font-weight: 900; letter-spacing: .12em; margin: 0 0 .35rem; text-transform: uppercase; }
+    h1, h2, h3 { letter-spacing: 0; margin: 0; }
+    h1 { font-size: clamp(2rem, 5vw, 3rem); line-height: 1; }
+    header span, .panel > p, .product p, .empty { color: #526273; }
+    nav, .panel__heading, .summary, .cards { display: grid; gap: .75rem; }
+    nav { grid-template-columns: repeat(auto-fit, minmax(9rem, 1fr)); }
+    nav a, .panel__heading a, .product button { border-radius: 6px; font-weight: 900; padding: .65rem .85rem; text-decoration: none; }
+    nav a { background: #e7f7f4; color: #0f766e; text-align: center; }
+    .summary { grid-template-columns: repeat(auto-fit, minmax(10rem, 1fr)); }
+    .summary article { display: grid; gap: .2rem; }
+    .summary strong { color: #0f766e; font-size: 2rem; }
+    .summary span, .product span { color: #526273; font-weight: 800; }
+    .panel__heading { align-items: center; display: flex; justify-content: space-between; }
+    .panel__heading > span, .panel__heading a { background: #102033; color: #fff; }
+    .cards { grid-template-columns: repeat(auto-fit, minmax(15rem, 1fr)); }
+    .product { border: 1px solid #d8e1ea; border-radius: 8px; display: grid; gap: .65rem; padding: 1rem; }
+    .product button { background: #102033; border: 1px solid #102033; color: #fff; cursor: pointer; width: fit-content; }
+    a:focus-visible, button:focus-visible { outline: 3px solid rgba(15,118,110,.25); outline-offset: 3px; }
+  `]
+})
+export class LearnerPortalComponent implements OnInit {
+  private readonly coursesService = inject(CoursesService);
+  private readonly programsService = inject(ProgramsService);
+  private readonly router = inject(Router);
+  private readonly toastService = inject(ToastService);
+  private readonly v2Platform = inject(V2PlatformService);
+
+  products: LearnerProduct[] = [];
+  programCount = 0;
+  certificateCount = 0;
+
+  get enrolledProducts(): LearnerProduct[] {
+    return this.products.filter(product => product.is_enrolled);
+  }
+
+  get availableProducts(): LearnerProduct[] {
+    return this.products.filter(product => !product.is_enrolled);
+  }
+
+  get nextProduct(): LearnerProduct | undefined {
+    return this.enrolledProducts[0] || this.availableProducts[0];
+  }
+
+  ngOnInit(): void {
+    this.v2Platform.getLearnerProducts().subscribe(products => {
+      this.products = products;
+    });
+
+    forkJoin({
+      programs: this.programsService.getPrograms(),
+      certifications: this.programsService.getMyCertifications(),
+    }).subscribe({
+      next: ({ programs, certifications }) => {
+        this.programCount = programs.length;
+        this.certificateCount = certifications.length;
+      },
+      error: () => {
+        this.programCount = 0;
+        this.certificateCount = 0;
+      },
+    });
+  }
+
+  continueProduct(product: LearnerProduct): void {
+    if (!product.course_id) {
+      this.toastService.show('This product type is not connected to the learner runtime yet.', 'error');
+      return;
+    }
+    this.coursesService.startCourse({ course_id: product.course_id }).subscribe({
+      next: segment => {
+        if (segment.delivery_state === 'governed_available' && segment.unit_progress_id) {
+          this.router.navigate(['/learn/lesson', segment.unit_progress_id]);
+          return;
+        }
+        this.toastService.show(segment.detail || 'This product is not currently available for governed learner delivery.', 'error');
+      },
+      error: () => this.toastService.show('Unable to continue this product right now.', 'error'),
+    });
+  }
+
+  enroll(product: LearnerProduct): void {
+    if (!product.course_id) {
+      this.toastService.show('Enrollment is only available for course-backed products right now.', 'error');
+      return;
+    }
+    this.coursesService.enrollInCourse(product.course_id).subscribe({
+      next: () => {
+        this.toastService.show('Enrollment successful.', 'success');
+        this.v2Platform.getLearnerProducts().subscribe(products => {
+          this.products = products;
+        });
+      },
+      error: () => this.toastService.show('Enrollment failed. You may already be enrolled.', 'error'),
+    });
+  }
+
+  label(value: string): string {
+    return value.replace(/_/g, ' ').replace(/\b\w/g, char => char.toUpperCase());
+  }
+}
diff --git a/frontend/src/app/pages/learner-portal/learner-products.component.ts b/frontend/src/app/pages/learner-portal/learner-products.component.ts
new file mode 100644
index 0000000..e015dfd
--- /dev/null
+++ b/frontend/src/app/pages/learner-portal/learner-products.component.ts
@@ -0,0 +1,154 @@
+import { CommonModule } from '@angular/common';
+import { Component, OnInit, inject } from '@angular/core';
+import { Router } from '@angular/router';
+import { EchoButtonComponent } from '../../components/echo-button/echo-button.component';
+import { LearnerProduct } from '../../models/v2-platform.model';
+import { CoursesService } from '../../services/courses.service';
+import { ToastService } from '../../services/toast.service';
+import { V2PlatformService } from '../../services/v2-platform.service';
+
+@Component({
+  selector: 'app-learner-products',
+  standalone: true,
+  imports: [CommonModule, EchoButtonComponent],
+  template: `
+    <section class="learner-products" aria-labelledby="learner-products-title">
+      <header>
+        <p>Products</p>
+        <h1 id="learner-products-title">Available and enrolled products</h1>
+        <span>Course-backed products use existing enrollments, progress, and governed lesson delivery.</span>
+      </header>
+
+      <article class="queue">
+        <h2>Enrolled</h2>
+        <div class="grid" *ngIf="enrolledProducts.length; else noEnrolled">
+          <ng-container *ngFor="let product of enrolledProducts">
+            <ng-container *ngTemplateOutlet="productCard; context: { $implicit: product }"></ng-container>
+          </ng-container>
+        </div>
+        <ng-template #noEnrolled><p class="empty">No enrolled products yet.</p></ng-template>
+      </article>
+
+      <article class="queue">
+        <h2>Available</h2>
+        <div class="grid" *ngIf="availableProducts.length; else noAvailable">
+          <ng-container *ngFor="let product of availableProducts">
+            <ng-container *ngTemplateOutlet="productCard; context: { $implicit: product }"></ng-container>
+          </ng-container>
+        </div>
+        <ng-template #noAvailable><p class="empty">No approved or published product wrappers are available right now.</p></ng-template>
+      </article>
+
+      <ng-template #productCard let-product>
+        <section class="card">
+          <div>
+            <h3>{{ product.title }}</h3>
+            <p>{{ product.description || product.learner_visibility }}</p>
+          </div>
+          <dl>
+            <div>
+              <dt>Access</dt>
+              <dd>{{ product.is_enrolled ? 'Enrolled' : 'Available' }}</dd>
+            </div>
+            <div>
+              <dt>Wrapper</dt>
+              <dd>{{ label(product.product_status || product.source) }}</dd>
+            </div>
+            <div>
+              <dt>Governance</dt>
+              <dd>{{ product.learner_visibility }}</dd>
+            </div>
+          </dl>
+          <app-echo-button
+            *ngIf="product.is_enrolled"
+            color="primary"
+            label="Continue"
+            (click)="continueProduct(product)"
+          ></app-echo-button>
+          <app-echo-button
+            *ngIf="!product.is_enrolled && product.course_id"
+            color="accent"
+            label="Enroll"
+            (click)="enroll(product)"
+          ></app-echo-button>
+          <p class="empty" *ngIf="!product.is_enrolled && !product.course_id">Access granted. Runtime delivery is not connected yet.</p>
+        </section>
+      </ng-template>
+    </section>
+  `,
+  styles: [`
+    .learner-products { color: #102033; display: grid; gap: 1rem; padding: clamp(1rem, 3vw, 2rem); }
+    header, .queue { background: #fff; border: 1px solid #d8e1ea; border-radius: 8px; box-shadow: 0 14px 32px rgba(16,32,51,.08); padding: clamp(1rem, 3vw, 1.5rem); }
+    header p { color: #0f766e; font-size: .76rem; font-weight: 900; letter-spacing: .12em; margin: 0 0 .35rem; text-transform: uppercase; }
+    h1, h2, h3 { letter-spacing: 0; margin: 0; }
+    h1 { font-size: clamp(2rem, 5vw, 3rem); line-height: 1; }
+    header span, .card p, .empty, dd { color: #526273; }
+    .queue { display: grid; gap: .9rem; }
+    .grid { display: grid; gap: .85rem; grid-template-columns: repeat(auto-fit, minmax(16rem, 1fr)); }
+    .card { border: 1px solid #d8e1ea; border-radius: 8px; display: grid; gap: .75rem; padding: 1rem; }
+    dl { display: grid; gap: .5rem; margin: 0; }
+    dt { color: #334155; font-size: .75rem; font-weight: 900; text-transform: uppercase; }
+    dd { margin: .15rem 0 0; }
+  `]
+})
+export class LearnerProductsComponent implements OnInit {
+  private readonly coursesService = inject(CoursesService);
+  private readonly router = inject(Router);
+  private readonly toastService = inject(ToastService);
+  private readonly v2Platform = inject(V2PlatformService);
+
+  products: LearnerProduct[] = [];
+
+  get enrolledProducts(): LearnerProduct[] {
+    return this.products.filter(product => product.is_enrolled);
+  }
+
+  get availableProducts(): LearnerProduct[] {
+    return this.products.filter(product => !product.is_enrolled);
+  }
+
+  ngOnInit(): void {
+    this.loadProducts();
+  }
+
+  continueProduct(product: LearnerProduct): void {
+    if (!product.course_id) {
+      this.toastService.show('This product type is not connected to the learner runtime yet.', 'error');
+      return;
+    }
+    this.coursesService.startCourse({ course_id: product.course_id }).subscribe({
+      next: segment => {
+        if (segment.delivery_state === 'governed_available' && segment.unit_progress_id) {
+          this.router.navigate(['/learn/lesson', segment.unit_progress_id]);
+          return;
+        }
+        this.toastService.show(segment.detail || 'This product is not currently available for governed learner delivery.', 'error');
+      },
+      error: () => this.toastService.show('Unable to continue this product right now.', 'error'),
+    });
+  }
+
+  enroll(product: LearnerProduct): void {
+    if (!product.course_id) {
+      this.toastService.show('Enrollment is only available for course-backed products right now.', 'error');
+      return;
+    }
+    this.coursesService.enrollInCourse(product.course_id).subscribe({
+      next: () => {
+        this.toastService.show('Enrollment successful.', 'success');
+        this.loadProducts();
+      },
+      error: () => this.toastService.show('Enrollment failed. You may already be enrolled.', 'error'),
+    });
+  }
+
+  label(value: string): string {
+    return value.replace(/_/g, ' ').replace(/\b\w/g, char => char.toUpperCase());
+  }
+
+  private loadProducts(): void {
+    this.v2Platform.getLearnerProducts().subscribe(products => {
+      this.products = products;
+    });
+  }
+}
diff --git a/frontend/src/app/pages/learner-portal/learner-resources.component.ts b/frontend/src/app/pages/learner-portal/learner-resources.component.ts
new file mode 100644
index 0000000..789bff3
--- /dev/null
+++ b/frontend/src/app/pages/learner-portal/learner-resources.component.ts
@@ -0,0 +1,35 @@
+import { CommonModule } from '@angular/common';
+import { Component } from '@angular/core';
+import { RouterModule } from '@angular/router';
+
+@Component({
+  selector: 'app-learner-resources',
+  standalone: true,
+  imports: [CommonModule, RouterModule],
+  template: `
+    <section class="resources" aria-labelledby="learner-resources-title">
+      <header>
+        <p>Resources</p>
+        <h1 id="learner-resources-title">Resources and downloads</h1>
+        <span>Downloadable artifacts, documentation packs, and knowledge hub resources are planned for a later phase.</span>
+      </header>
+      <article>
+        <h2>No learner resources yet</h2>
+        <p>Course lessons, progress, certificates, and learning paths remain available through the existing governed runtime.</p>
+        <a routerLink="/learn/products">Back to products</a>
+      </article>
+    </section>
+  `,
+  styles: [`
+    .resources { color: #102033; display: grid; gap: 1rem; padding: clamp(1rem, 3vw, 2rem); }
+    header, article { background: #fff; border: 1px solid #d8e1ea; border-radius: 8px; box-shadow: 0 14px 32px rgba(16,32,51,.08); padding: clamp(1rem, 3vw, 1.5rem); }
+    header p { color: #0f766e; font-size: .76rem; font-weight: 900; letter-spacing: .12em; margin: 0 0 .35rem; text-transform: uppercase; }
+    h1, h2 { letter-spacing: 0; margin: 0; }
+    h1 { font-size: clamp(2rem, 5vw, 3rem); line-height: 1; }
+    header span, article p { color: #526273; }
+    article { display: grid; gap: .75rem; }
+    a { background: #102033; border-radius: 6px; color: #fff; font-weight: 900; padding: .65rem .85rem; text-decoration: none; width: fit-content; }
+    a:focus-visible { outline: 3px solid rgba(15,118,110,.25); outline-offset: 3px; }
+  `]
+})
+export class LearnerResourcesComponent {}
diff --git a/frontend/src/app/pages/review-center/review-center.component.ts b/frontend/src/app/pages/review-center/review-center.component.ts
new file mode 100644
index 0000000..5d3a1fd
--- /dev/null
+++ b/frontend/src/app/pages/review-center/review-center.component.ts
@@ -0,0 +1,162 @@
+import { CommonModule } from '@angular/common';
+import { Component, OnInit, inject } from '@angular/core';
+import { RouterModule } from '@angular/router';
+import { Observable } from 'rxjs';
+import { ReviewCenter, ReviewCenterItem } from '../../models/v2-platform.model';
+import { V2PlatformService } from '../../services/v2-platform.service';
+
+@Component({
+  selector: 'app-review-center',
+  standalone: true,
+  imports: [CommonModule, RouterModule],
+  template: `
+    <section class="review-center" aria-labelledby="review-center-title">
+      <header>
+        <p>Review Center</p>
+        <h1 id="review-center-title">Governance and readiness review</h1>
+        <span>V2 wrapper review queues use real platform data. Existing lesson governance remains the learner-visible source of truth.</span>
+      </header>
+
+      <div class="queues" *ngIf="reviewCenter as center">
+        <article class="queue">
+          <div class="queue__heading">
+            <h2>Pending Artifacts</h2>
+            <span>{{ center.pending_artifacts.length }}</span>
+          </div>
+          <ng-container *ngIf="center.pending_artifacts.length; else noArtifacts">
+            <div class="item" *ngFor="let item of center.pending_artifacts">
+              <ng-container *ngTemplateOutlet="reviewItem; context: { $implicit: item, statuses: artifactStatuses }"></ng-container>
+            </div>
+          </ng-container>
+          <ng-template #noArtifacts><p class="empty">No artifacts are waiting for wrapper review.</p></ng-template>
+        </article>
+
+        <article class="queue">
+          <div class="queue__heading">
+            <h2>Draft Products</h2>
+            <span>{{ center.draft_products.length }}</span>
+          </div>
+          <ng-container *ngIf="center.draft_products.length; else noProducts">
+            <div class="item" *ngFor="let item of center.draft_products">
+              <ng-container *ngTemplateOutlet="reviewItem; context: { $implicit: item, statuses: productStatuses }"></ng-container>
+            </div>
+          </ng-container>
+          <ng-template #noProducts><p class="empty">No product wrappers are waiting for review.</p></ng-template>
+        </article>
+
+        <article class="queue queue--wide">
+          <div class="queue__heading">
+            <h2>Lesson Governance</h2>
+            <span>{{ center.lesson_governance_items.length }}</span>
+          </div>
+          <ng-container *ngIf="center.lesson_governance_items.length; else noLessons">
+            <div class="item" *ngFor="let item of center.lesson_governance_items">
+              <ng-container *ngTemplateOutlet="reviewItem; context: { $implicit: item, statuses: [] }"></ng-container>
+            </div>
+          </ng-container>
+          <ng-template #noLessons><p class="empty">Existing governed lessons do not have visible readiness blockers.</p></ng-template>
+        </article>
+
+        <article class="queue queue--wide">
+          <div class="queue__heading">
+            <h2>Recent Review Activity</h2>
+            <span>{{ center.recent_activity.length }}</span>
+          </div>
+          <p class="empty" *ngFor="let activity of center.recent_activity">{{ activity.message }}</p>
+        </article>
+      </div>
+
+      <ng-template #reviewItem let-item let-statuses="statuses">
+        <div class="item__main">
+          <div>
+            <h3>{{ item.title }}</h3>
+            <p>{{ item.source_coverage }}</p>
+          </div>
+          <span class="badge" [class.badge--blocked]="item.blocked">{{ label(item.status) }}</span>
+        </div>
+        <dl>
+          <div>
+            <dt>Readiness</dt>
+            <dd>{{ item.readiness }}</dd>
+          </div>
+          <div>
+            <dt>Decision</dt>
+            <dd>{{ item.required_decision }}</dd>
+          </div>
+          <div>
+            <dt>Review state</dt>
+            <dd>{{ label(item.review_state || item.status) }}</dd>
+          </div>
+        </dl>
+        <div class="actions">
+          <a *ngIf="item.detail_route" [routerLink]="item.detail_route">Open</a>
+          <a *ngIf="item.governance_route" [routerLink]="item.governance_route">Governance</a>
+          <button
+            *ngFor="let status of statuses"
+            type="button"
+            [disabled]="item.status === status"
+            (click)="updateStatus(item, status)"
+          >
+            {{ label(status) }}
+          </button>
+        </div>
+      </ng-template>
+    </section>
+  `,
+  styles: [`
+    .review-center { color: #102033; display: grid; gap: 1rem; padding: clamp(1rem, 3vw, 2rem); }
+    header, .queue { background: #fff; border: 1px solid #d8e1ea; border-radius: 8px; box-shadow: 0 14px 32px rgba(16,32,51,.08); padding: clamp(1rem, 3vw, 1.5rem); }
+    header p { color: #0f766e; font-size: .76rem; font-weight: 900; letter-spacing: .12em; margin: 0 0 .5rem; text-transform: uppercase; }
+    h1, h2, h3 { letter-spacing: 0; margin: 0; }
+    h1 { font-size: clamp(2rem, 5vw, 3rem); line-height: 1; }
+    header span, .empty, .item p, dd { color: #526273; }
+    .queues { display: grid; gap: 1rem; grid-template-columns: repeat(2, minmax(0, 1fr)); }
+    .queue { display: grid; gap: .9rem; align-content: start; }
+    .queue--wide { grid-column: 1 / -1; }
+    .queue__heading { align-items: center; display: flex; justify-content: space-between; gap: 1rem; }
+    .queue__heading > span { background: #e7f7f4; border: 1px solid #b8e1da; border-radius: 999px; color: #0f766e; font-weight: 900; min-width: 2rem; padding: .25rem .55rem; text-align: center; }
+    .item { border: 1px solid #d8e1ea; border-radius: 8px; display: grid; gap: .8rem; padding: 1rem; }
+    .item__main { align-items: start; display: flex; gap: 1rem; justify-content: space-between; }
+    .badge { background: #e8f0fe; border: 1px solid #bfd0f5; border-radius: 999px; color: #1d4ed8; font-weight: 900; padding: .28rem .65rem; white-space: nowrap; }
+    .badge--blocked { background: #fff1f2; border-color: #fecdd3; color: #be123c; }
+    dl { display: grid; gap: .6rem; grid-template-columns: repeat(auto-fit, minmax(11rem, 1fr)); margin: 0; }
+    dt { color: #334155; font-size: .78rem; font-weight: 900; text-transform: uppercase; }
+    dd { margin: .15rem 0 0; }
+    .actions { display: flex; flex-wrap: wrap; gap: .5rem; }
+    a, button { border: 1px solid #102033; border-radius: 6px; font: inherit; font-weight: 900; padding: .55rem .75rem; text-decoration: none; }
+    a { background: #102033; color: #fff; }
+    button { background: #fff; color: #102033; cursor: pointer; }
+    button:disabled { border-color: #cbd5e1; color: #94a3b8; cursor: default; }
+    a:focus-visible, button:focus-visible { outline: 3px solid rgba(15,118,110,.25); outline-offset: 3px; }
+    @media (max-width: 900px) { .queues { grid-template-columns: 1fr; } .item__main { flex-direction: column; } }
+  `]
+})
+export class ReviewCenterComponent implements OnInit {
+  private readonly v2Platform = inject(V2PlatformService);
+
+  readonly artifactStatuses = ['draft', 'in_review', 'approved', 'rejected', 'needs_changes'];
+  readonly productStatuses = ['draft', 'in_review', 'approved', 'published', 'archived'];
+  reviewCenter: ReviewCenter | null = null;
+
+  ngOnInit(): void {
+    this.load();
+  }
+
+  updateStatus(item: ReviewCenterItem, status: string): void {
+    const request: Observable<unknown> = item.item_type === 'artifact'
+      ? this.v2Platform.updateArtifactReviewStatus(item.id, { status })
+      : this.v2Platform.updateProductReviewStatus(item.id, { status });
+
+    request.subscribe(() => this.load());
+  }
+
+  label(value: string): string {
+    return value.replace(/_/g, ' ').replace(/\b\w/g, char => char.toUpperCase());
+  }
+
+  private load(): void {
+    this.v2Platform.getReviewCenter().subscribe(center => {
+      this.reviewCenter = center;
+    });
+  }
+}
diff --git a/frontend/src/app/pages/workspace-analytics/workspace-analytics.component.ts b/frontend/src/app/pages/workspace-analytics/workspace-analytics.component.ts
new file mode 100644
index 0000000..f7d4a4c
--- /dev/null
+++ b/frontend/src/app/pages/workspace-analytics/workspace-analytics.component.ts
@@ -0,0 +1,193 @@
+import { CommonModule } from '@angular/common';
+import { Component, OnInit, inject } from '@angular/core';
+import { forkJoin } from 'rxjs';
+import {
+  AnalyticsService,
+  V2KnowledgePipelineAnalytics,
+  V2LearnerAnalytics,
+  V2ProductAnalytics,
+  V2WorkspaceAnalytics,
+} from '../../services/analytics.service';
+
+@Component({
+  selector: 'app-workspace-analytics',
+  standalone: true,
+  imports: [CommonModule],
+  template: `
+    <section class="analytics" aria-labelledby="analytics-title">
+      <header>
+        <p>Analytics V2</p>
+        <h1 id="analytics-title">Workspace product intelligence</h1>
+        <span>Read-only operational metrics from V2 wrappers and existing runtime progress.</span>
+      </header>
+
+      <div class="state" *ngIf="loading">Loading analytics...</div>
+      <div class="state state--error" *ngIf="error">{{ error }}</div>
+
+      <ng-container *ngIf="workspace && products && learners && knowledge">
+        <section class="summary" aria-label="Workspace analytics summary">
+          <article>
+            <span>Total Products</span>
+            <strong>{{ workspace.totals.total_products }}</strong>
+          </article>
+          <article>
+            <span>Learners</span>
+            <strong>{{ workspace.totals.learner_count }}</strong>
+          </article>
+          <article>
+            <span>Enrollments</span>
+            <strong>{{ workspace.totals.enrollment_count }}</strong>
+          </article>
+          <article>
+            <span>Artifacts</span>
+            <strong>{{ workspace.totals.total_artifacts }}</strong>
+          </article>
+        </section>
+
+        <section class="grid">
+          <article class="panel">
+            <h2>Product Health</h2>
+            <dl>
+              <div><dt>Course-backed</dt><dd>{{ products.course_backed_product_count }}</dd></div>
+              <div><dt>Program-backed</dt><dd>{{ products.program_backed_product_count }}</dd></div>
+              <div><dt>By status</dt><dd>{{ formatMap(products.products_by_status) }}</dd></div>
+              <div><dt>By type</dt><dd>{{ formatMap(products.products_by_type) }}</dd></div>
+            </dl>
+          </article>
+
+          <article class="panel">
+            <h2>Knowledge Pipeline</h2>
+            <dl>
+              <div><dt>Projects</dt><dd>{{ knowledge.total_projects }}</dd></div>
+              <div><dt>Sources</dt><dd>{{ knowledge.total_knowledge_sources }}</dd></div>
+              <div><dt>Generation runs</dt><dd>{{ knowledge.total_generation_runs }}</dd></div>
+              <div><dt>Artifacts by type</dt><dd>{{ formatMap(knowledge.artifacts_by_type) }}</dd></div>
+              <div><dt>Run status</dt><dd>{{ formatMap(knowledge.generation_runs_by_status) }}</dd></div>
+            </dl>
+          </article>
+
+          <article class="panel">
+            <h2>Learner Engagement</h2>
+            <dl>
+              <div><dt>Learners</dt><dd>{{ learners.summary['learner_count'] || 0 }}</dd></div>
+              <div><dt>Course enrollments</dt><dd>{{ learners.summary['course_enrollment_count'] || 0 }}</dd></div>
+              <div><dt>Program enrollments</dt><dd>{{ learners.summary['program_enrollment_count'] || 0 }}</dd></div>
+              <div><dt>Lessons completed</dt><dd>{{ learners.summary['lesson_completion_count'] || 0 }}</dd></div>
+              <div><dt>Enrollment status</dt><dd>{{ formatMap(learners.enrollments_by_status) }}</dd></div>
+            </dl>
+          </article>
+
+          <article class="panel">
+            <h2>Access Overview</h2>
+            <dl>
+              <div><dt>Total grants</dt><dd>{{ workspace.totals.total_access_grants }}</dd></div>
+              <div><dt>Grant status</dt><dd>{{ formatMap(workspace.access_grants_by_status) }}</dd></div>
+              <div><dt>Grant type</dt><dd>{{ formatMap(workspace.access_grants_by_type) }}</dd></div>
+              <div><dt>Granted learners</dt><dd>{{ learners.summary['access_granted_learner_count'] || 0 }}</dd></div>
+            </dl>
+          </article>
+
+          <article class="panel">
+            <h2>Review/Publishing Health</h2>
+            <dl>
+              <div><dt>Draft products</dt><dd>{{ workspace.review_health['draft_products'] || 0 }}</dd></div>
+              <div><dt>In review</dt><dd>{{ workspace.review_health['in_review_products'] || 0 }}</dd></div>
+              <div><dt>Approved</dt><dd>{{ workspace.review_health['approved_products'] || 0 }}</dd></div>
+              <div><dt>Published</dt><dd>{{ workspace.review_health['published_products'] || 0 }}</dd></div>
+              <div><dt>Artifacts needing review</dt><dd>{{ workspace.review_health['review_required_artifacts'] || 0 }}</dd></div>
+            </dl>
+          </article>
+
+          <article class="panel">
+            <h2>Recent Activity</h2>
+            <ul *ngIf="recentItems().length; else noRecent">
+              <li *ngFor="let item of recentItems()">
+                <span>{{ label(item.item_type) }}</span>
+                <strong>{{ item.title }}</strong>
+                <em>{{ label(item.status) }}</em>
+              </li>
+            </ul>
+            <ng-template #noRecent><p>No recent wrapper activity yet.</p></ng-template>
+          </article>
+        </section>
+      </ng-container>
+    </section>
+  `,
+  styles: [`
+    .analytics { color: #102033; display: grid; gap: 1rem; padding: clamp(1rem, 3vw, 2rem); }
+    header, .panel, .summary article, .state { background: #fff; border: 1px solid #d8e1ea; border-radius: 8px; box-shadow: 0 14px 32px rgba(16,32,51,.08); padding: clamp(1rem, 3vw, 1.5rem); }
+    header p { color: #0f766e; font-size: .76rem; font-weight: 900; letter-spacing: .12em; margin: 0 0 .35rem; text-transform: uppercase; }
+    h1, h2 { letter-spacing: 0; margin: 0; }
+    h1 { font-size: clamp(2rem, 5vw, 3rem); line-height: 1; }
+    h2 { font-size: 1.1rem; }
+    header span, .state, dt, li span, li em, p { color: #526273; }
+    .state--error { border-color: #fecaca; color: #b91c1c; }
+    .summary { display: grid; gap: .85rem; grid-template-columns: repeat(auto-fit, minmax(10rem, 1fr)); }
+    .summary article { display: grid; gap: .35rem; }
+    .summary span { color: #526273; font-size: .75rem; font-weight: 900; text-transform: uppercase; }
+    .summary strong { font-size: 2rem; line-height: 1; }
+    .grid { display: grid; gap: .85rem; grid-template-columns: repeat(auto-fit, minmax(19rem, 1fr)); }
+    .panel { display: grid; gap: .85rem; align-content: start; }
+    dl { display: grid; gap: .55rem; margin: 0; }
+    dl div { border-top: 1px solid #edf2f7; display: grid; gap: .2rem; padding-top: .55rem; }
+    dt { font-size: .72rem; font-weight: 900; text-transform: uppercase; }
+    dd { margin: 0; overflow-wrap: anywhere; }
+    ul { display: grid; gap: .65rem; list-style: none; margin: 0; padding: 0; }
+    li { border-top: 1px solid #edf2f7; display: grid; gap: .15rem; padding-top: .65rem; }
+    li span, li em { font-size: .72rem; font-style: normal; font-weight: 900; text-transform: uppercase; }
+  `]
+})
+export class WorkspaceAnalyticsComponent implements OnInit {
+  private readonly analyticsService = inject(AnalyticsService);
+
+  workspace: V2WorkspaceAnalytics | null = null;
+  products: V2ProductAnalytics | null = null;
+  learners: V2LearnerAnalytics | null = null;
+  knowledge: V2KnowledgePipelineAnalytics | null = null;
+  loading = true;
+  error = '';
+
+  ngOnInit(): void {
+    forkJoin({
+      workspace: this.analyticsService.getV2WorkspaceAnalytics(),
+      products: this.analyticsService.getV2ProductAnalytics(),
+      learners: this.analyticsService.getV2LearnerAnalytics(),
+      knowledge: this.analyticsService.getV2KnowledgePipelineAnalytics(),
+    }).subscribe({
+      next: result => {
+        this.workspace = result.workspace;
+        this.products = result.products;
+        this.learners = result.learners;
+        this.knowledge = result.knowledge;
+        this.loading = false;
+      },
+      error: () => {
+        this.error = 'Unable to load Analytics V2 right now.';
+        this.loading = false;
+      },
+    });
+  }
+
+  formatMap(values: Record<string, number> | null | undefined): string {
+    const entries = Object.entries(values || {});
+    if (!entries.length) {
+      return 'None';
+    }
+    return entries.map(([key, value]) => `${this.label(key)}: ${value}`).join(', ');
+  }
+
+  label(value: string): string {
+    return value.replace(/_/g, ' ').replace(/\b\w/g, char => char.toUpperCase());
+  }
+
+  recentItems() {
+    if (!this.workspace) {
+      return [];
+    }
+    return [
+      ...this.workspace.recent.products,
+      ...this.workspace.recent.artifacts,
+      ...this.workspace.recent.knowledge_sources,
+    ].slice(0, 8);
+  }
+}
diff --git a/frontend/src/app/services/analytics.service.spec.ts b/frontend/src/app/services/analytics.service.spec.ts
index 17b0329..caa42f0 100644
--- a/frontend/src/app/services/analytics.service.spec.ts
+++ b/frontend/src/app/services/analytics.service.spec.ts
@@ -47,4 +47,83 @@ describe('AnalyticsService', () => {
       }
     });
   });
+
+  it('loads read-only Analytics V2 endpoints', () => {
+    service.getV2WorkspaceAnalytics().subscribe(response => {
+      expect(response.totals.total_products).toBe(2);
+    });
+    const workspaceReq = httpMock.expectOne(`${environment.apiUrl}/api/analytics/workspace`);
+    expect(workspaceReq.request.method).toBe('GET');
+    workspaceReq.flush({
+      totals: {
+        total_products: 2,
+        total_projects: 1,
+        total_knowledge_sources: 1,
+        total_artifacts: 1,
+        total_generation_runs: 1,
+        total_access_grants: 1,
+        learner_count: 1,
+        enrollment_count: 1,
+        course_backed_product_count: 1,
+        program_backed_product_count: 0
+      },
+      products_by_type: { course: 1, resource_pack: 1 },
+      products_by_status: { published: 1, draft: 1 },
+      artifacts_by_status: { in_review: 1 },
+      artifacts_by_type: { guide: 1 },
+      generation_runs_by_status: { completed: 1 },
+      access_grants_by_status: { active: 1 },
+      access_grants_by_type: { manual: 1 },
+      review_health: { draft_products: 1 },
+      learner_engagement: { learner_count: 1 },
+      recent: { products: [], artifacts: [], knowledge_sources: [] },
+      event_tracking: { status: 'unavailable', message: 'No events yet.' },
+      scoped_product_count: 2
+    });
+
+    service.getV2ProductAnalytics().subscribe(response => {
+      expect(response.total_products).toBe(2);
+    });
+    const productReq = httpMock.expectOne(`${environment.apiUrl}/api/analytics/products`);
+    expect(productReq.request.method).toBe('GET');
+    productReq.flush({
+      total_products: 2,
+      course_backed_product_count: 1,
+      program_backed_product_count: 0,
+      products_by_type: { course: 1, resource_pack: 1 },
+      products_by_status: { published: 1, draft: 1 },
+      products: []
+    });
+
+    service.getV2LearnerAnalytics().subscribe(response => {
+      expect(response.summary['learner_count']).toBe(1);
+    });
+    const learnerReq = httpMock.expectOne(`${environment.apiUrl}/api/analytics/learners`);
+    expect(learnerReq.request.method).toBe('GET');
+    learnerReq.flush({
+      summary: { learner_count: 1 },
+      enrollments_by_status: { active: 1 },
+      access_grants_by_status: { active: 1 },
+      access_grants_by_type: { manual: 1 }
+    });
+
+    service.getV2KnowledgePipelineAnalytics().subscribe(response => {
+      expect(response.total_artifacts).toBe(1);
+    });
+    const pipelineReq = httpMock.expectOne(`${environment.apiUrl}/api/analytics/knowledge-pipeline`);
+    expect(pipelineReq.request.method).toBe('GET');
+    pipelineReq.flush({
+      total_projects: 1,
+      total_knowledge_sources: 1,
+      total_artifacts: 1,
+      total_generation_runs: 1,
+      knowledge_sources_by_type: { lesson_source: 1 },
+      knowledge_sources_by_status: { available: 1 },
+      artifacts_by_status: { in_review: 1 },
+      artifacts_by_type: { guide: 1 },
+      generation_runs_by_status: { completed: 1 },
+      recent: { artifacts: [], knowledge_sources: [] },
+      source_coverage: { status: 'advisory', artifacts_with_knowledge_source: 1 }
+    });
+  });
 });
diff --git a/frontend/src/app/services/analytics.service.ts b/frontend/src/app/services/analytics.service.ts
index 5d526a0..6842c96 100644
--- a/frontend/src/app/services/analytics.service.ts
+++ b/frontend/src/app/services/analytics.service.ts
@@ -69,6 +69,97 @@ export interface EducatorRuntimeSupportSummary {
   educator_intervention_hint: string | null;
 }
 
+export interface V2AnalyticsRecentItem {
+  id: string;
+  item_type: string;
+  title: string;
+  status: string;
+  subtype?: string | null;
+  created_at: string | null;
+}
+
+export interface V2WorkspaceAnalytics {
+  totals: {
+    total_products: number;
+    total_projects: number;
+    total_knowledge_sources: number;
+    total_artifacts: number;
+    total_generation_runs: number;
+    total_access_grants: number;
+    learner_count: number;
+    enrollment_count: number;
+    course_backed_product_count: number;
+    program_backed_product_count: number;
+  };
+  products_by_type: Record<string, number>;
+  products_by_status: Record<string, number>;
+  artifacts_by_status: Record<string, number>;
+  artifacts_by_type: Record<string, number>;
+  generation_runs_by_status: Record<string, number>;
+  access_grants_by_status: Record<string, number>;
+  access_grants_by_type: Record<string, number>;
+  review_health: Record<string, number>;
+  learner_engagement: Record<string, number>;
+  recent: {
+    products: V2AnalyticsRecentItem[];
+    artifacts: V2AnalyticsRecentItem[];
+    knowledge_sources: V2AnalyticsRecentItem[];
+  };
+  event_tracking: {
+    status: string;
+    message: string;
+  };
+  scoped_product_count: number;
+}
+
+export interface V2ProductAnalytics {
+  total_products: number;
+  course_backed_product_count: number;
+  program_backed_product_count: number;
+  products_by_type: Record<string, number>;
+  products_by_status: Record<string, number>;
+  products: {
+    id: string;
+    title: string;
+    product_type: string;
+    status: string;
+    review_state: string;
+    access_state: string;
+    course_id?: string | null;
+    program_id?: string | null;
+    artifact_count: number;
+    generation_run_count: number;
+    access_grant_count: number;
+    enrollment_count: number;
+    created_at: string | null;
+    updated_at: string | null;
+  }[];
+}
+
+export interface V2LearnerAnalytics {
+  summary: Record<string, number>;
+  enrollments_by_status: Record<string, number>;
+  access_grants_by_status: Record<string, number>;
+  access_grants_by_type: Record<string, number>;
+}
+
+export interface V2KnowledgePipelineAnalytics {
+  total_projects: number;
+  total_knowledge_sources: number;
+  total_artifacts: number;
+  total_generation_runs: number;
+  knowledge_sources_by_type: Record<string, number>;
+  knowledge_sources_by_status: Record<string, number>;
+  artifacts_by_status: Record<string, number>;
+  artifacts_by_type: Record<string, number>;
+  generation_runs_by_status: Record<string, number>;
+  recent: {
+    artifacts: V2AnalyticsRecentItem[];
+    knowledge_sources: V2AnalyticsRecentItem[];
+  };
+  source_coverage: Record<string, number | string>;
+}
+
 @Injectable({ providedIn: 'root' })
 export class AnalyticsService {
   private apiUrl = `${environment.apiUrl}/api/analytics`;
@@ -92,4 +183,20 @@ export class AnalyticsService {
   getStudentProgress(): Observable<StudentProgressResponse> {
     return this.http.get<StudentProgressResponse>(`${this.apiUrl}/student-progress`);
   }
+
+  getV2WorkspaceAnalytics(): Observable<V2WorkspaceAnalytics> {
+    return this.http.get<V2WorkspaceAnalytics>(`${this.apiUrl}/workspace`);
+  }
+
+  getV2ProductAnalytics(): Observable<V2ProductAnalytics> {
+    return this.http.get<V2ProductAnalytics>(`${this.apiUrl}/products`);
+  }
+
+  getV2LearnerAnalytics(): Observable<V2LearnerAnalytics> {
+    return this.http.get<V2LearnerAnalytics>(`${this.apiUrl}/learners`);
+  }
+
+  getV2KnowledgePipelineAnalytics(): Observable<V2KnowledgePipelineAnalytics> {
+    return this.http.get<V2KnowledgePipelineAnalytics>(`${this.apiUrl}/knowledge-pipeline`);
+  }
 }
diff --git a/frontend/src/app/services/permissions.service.ts b/frontend/src/app/services/permissions.service.ts
index 5fb9b32..7fb353e 100644
--- a/frontend/src/app/services/permissions.service.ts
+++ b/frontend/src/app/services/permissions.service.ts
@@ -255,6 +255,7 @@ export class PermissionsService {
       permissions.add('nav:knowledge-sources');
       permissions.add('nav:artifacts');
       permissions.add('nav:review-center');
+      permissions.add('nav:access');
       permissions.add('nav:analytics');
     }
 
diff --git a/frontend/src/app/services/v2-platform.service.spec.ts b/frontend/src/app/services/v2-platform.service.spec.ts
index 51d1075..2129ee5 100644
--- a/frontend/src/app/services/v2-platform.service.spec.ts
+++ b/frontend/src/app/services/v2-platform.service.spec.ts
@@ -182,4 +182,255 @@ describe('V2PlatformService', () => {
     expect(request.request.method).toBe('GET');
     request.flush([]);
   });
+
+  it('loads the Review Center aggregate queue', () => {
+    service.getReviewCenter().subscribe(center => {
+      expect(center.pending_artifacts[0].title).toBe('Pending Artifact');
+      expect(center.draft_products[0].status).toBe('draft');
+      expect(center.lesson_governance_items[0].blocked).toBeTrue();
+    });
+
+    const request = httpMock.expectOne(`${environment.apiUrl}/api/review-center`);
+    expect(request.request.method).toBe('GET');
+    request.flush({
+      pending_artifacts: [
+        {
+          id: 'artifact-1',
+          item_type: 'artifact',
+          title: 'Pending Artifact',
+          status: 'in_review',
+          review_state: 'in_review',
+          owner: null,
+          source_coverage: 'Linked knowledge source',
+          readiness: 'Wrapper review only; not learner-deliverable',
+          required_decision: 'Review artifact wrapper',
+          blocked: false,
+          detail_route: '/workspace/artifacts/artifact-1',
+          governance_route: null,
+          updated_at: '2026-01-01T00:00:00',
+        },
+      ],
+      draft_products: [
+        {
+          id: 'product-1',
+          item_type: 'product',
+          title: 'Draft Product',
+          status: 'draft',
+          review_state: 'not_reviewed',
+          owner: null,
+          source_coverage: 'Course-backed runtime link',
+          readiness: 'Existing lesson governance remains authoritative',
+          required_decision: 'Review product wrapper',
+          blocked: false,
+          detail_route: '/workspace/products/product-1',
+          governance_route: '/workspace/product-studio/courses/course-1/edit',
+          updated_at: '2026-01-01T00:00:00',
+        },
+      ],
+      lesson_governance_items: [
+        {
+          id: 'course-1',
+          item_type: 'lesson_governance',
+          title: 'Blocked Course',
+          status: 'blocked',
+          review_state: 'existing_governance',
+          owner: null,
+          source_coverage: '1 blocking issue(s), 0 warning(s)',
+          readiness: 'Blocked',
+          required_decision: 'Resolve lesson governance blockers',
+          blocked: true,
+          detail_route: '/workspace/product-studio/courses/course-1/edit',
+          governance_route: '/workspace/product-studio/courses/course-1/edit',
+          updated_at: '2026-01-01T00:00:00',
+        },
+      ],
+      recent_activity: [
+        {
+          id: 'review-activity-placeholder',
+          message: 'Review activity history will appear here after audit records are introduced.',
+          created_at: null,
+        },
+      ],
+    });
+  });
+
+  it('updates artifact review status through the wrapper API', () => {
+    service.updateArtifactReviewStatus('artifact-1', { status: 'approved' }).subscribe(artifact => {
+      expect(artifact.status).toBe('approved');
+      expect(artifact.review_state).toBe('approved');
+    });
+
+    const request = httpMock.expectOne(`${environment.apiUrl}/api/artifacts/artifact-1/review-status`);
+    expect(request.request.method).toBe('PATCH');
+    expect(request.request.body.status).toBe('approved');
+    request.flush({
+      id: 'artifact-1',
+      workspace_id: 'workspace-1',
+      project_id: 'project-1',
+      product_id: null,
+      generation_run_id: null,
+      knowledge_source_id: null,
+      artifact_type: 'guide',
+      title: 'Artifact',
+      body: null,
+      uri: null,
+      status: 'approved',
+      review_state: 'approved',
+      metadata: {},
+      created_at: '2026-01-01T00:00:00',
+      updated_at: '2026-01-01T00:00:00',
+    });
+  });
+
+  it('updates product review status through the wrapper API', () => {
+    service.updateProductReviewStatus('product-1', { status: 'approved' }).subscribe(product => {
+      expect(product.status).toBe('approved');
+      expect(product.review_state).toBe('approved');
+    });
+
+    const request = httpMock.expectOne(`${environment.apiUrl}/api/products/product-1/review-status`);
+    expect(request.request.method).toBe('PATCH');
+    expect(request.request.body.status).toBe('approved');
+    request.flush({
+      id: 'product-1',
+      workspace_id: 'workspace-1',
+      project_id: 'project-1',
+      course_id: 'course-1',
+      program_id: null,
+      product_type: 'course',
+      title: 'Product',
+      description: null,
+      status: 'approved',
+      review_state: 'approved',
+      access_state: 'private',
+      metadata: {},
+      published_at: null,
+      created_at: '2026-01-01T00:00:00',
+      updated_at: '2026-01-01T00:00:00',
+    });
+  });
+
+  it('loads learner portal products from the V2 learner API', () => {
+    service.getLearnerProducts().subscribe(products => {
+      expect(products.length).toBe(2);
+      expect(products[0].is_enrolled).toBeTrue();
+      expect(products[1].product_status).toBe('approved');
+    });
+
+    const request = httpMock.expectOne(`${environment.apiUrl}/api/learner-portal/products`);
+    expect(request.request.method).toBe('GET');
+    request.flush([
+      {
+        id: 'product-1',
+        product_id: 'product-1',
+        course_id: 'course-1',
+        title: 'Enrolled Product',
+        description: 'Existing runtime enrollment',
+        product_type: 'course',
+        product_status: 'draft',
+        review_state: 'draft',
+        access_state: 'private',
+        enrollment_id: 'student-course-1',
+        enrollment_status: 'active',
+        enrolled_on: '2026-01-01T00:00:00',
+        is_enrolled: true,
+        source: 'product_wrapper',
+        learner_visibility: 'Existing enrollment controls access; lesson governance controls content.',
+        next_action: 'Continue governed course runtime',
+      },
+      {
+        id: 'product-2',
+        product_id: 'product-2',
+        course_id: 'course-2',
+        title: 'Available Product',
+        description: 'Approved wrapper',
+        product_type: 'course',
+        product_status: 'approved',
+        review_state: 'approved',
+        access_state: 'private',
+        enrollment_id: null,
+        enrollment_status: null,
+        enrolled_on: null,
+        is_enrolled: false,
+        source: 'product_wrapper',
+        learner_visibility: 'Available wrapper; enrollment still uses existing course runtime.',
+        next_action: 'Enroll through existing course enrollment',
+      },
+    ]);
+  });
+
+  it('manages access grants through the V2 access API', () => {
+    service.getAccessGrants({ productId: 'product-1' }).subscribe(grants => {
+      expect(grants[0].grant_type).toBe('manual');
+    });
+    const listRequest = httpMock.expectOne(`${environment.apiUrl}/api/access-grants?product_id=product-1`);
+    expect(listRequest.request.method).toBe('GET');
+    listRequest.flush([
+      {
+        id: 'grant-1',
+        user_id: 'user-1',
+        product_id: 'product-1',
+        workspace_id: 'workspace-1',
+        project_id: null,
+        grant_type: 'manual',
+        status: 'active',
+        source: 'manual',
+        starts_at: null,
+        expires_at: null,
+        revoked_at: null,
+        metadata: {},
+        created_at: '2026-01-01T00:00:00',
+        updated_at: '2026-01-01T00:00:00',
+      },
+    ]);
+
+    service.createAccessGrant({
+      user_id: 'user-1',
+      product_id: 'product-1',
+      grant_type: 'manual',
+    }).subscribe(grant => {
+      expect(grant.status).toBe('active');
+    });
+    const createRequest = httpMock.expectOne(`${environment.apiUrl}/api/access-grants`);
+    expect(createRequest.request.method).toBe('POST');
+    expect(createRequest.request.body.user_id).toBe('user-1');
+    createRequest.flush({
+      id: 'grant-1',
+      user_id: 'user-1',
+      product_id: 'product-1',
+      workspace_id: 'workspace-1',
+      project_id: null,
+      grant_type: 'manual',
+      status: 'active',
+      source: 'manual',
+      starts_at: null,
+      expires_at: null,
+      revoked_at: null,
+      metadata: {},
+      created_at: '2026-01-01T00:00:00',
+      updated_at: '2026-01-01T00:00:00',
+    });
+
+    service.revokeAccessGrant('grant-1').subscribe(grant => {
+      expect(grant.status).toBe('revoked');
+    });
+    const revokeRequest = httpMock.expectOne(`${environment.apiUrl}/api/access-grants/grant-1/revoke`);
+    expect(revokeRequest.request.method).toBe('PATCH');
+    revokeRequest.flush({
+      id: 'grant-1',
+      user_id: 'user-1',
+      product_id: 'product-1',
+      workspace_id: 'workspace-1',
+      project_id: null,
+      grant_type: 'manual',
+      status: 'revoked',
+      source: 'manual',
+      starts_at: null,
+      expires_at: null,
+      revoked_at: '2026-01-02T00:00:00',
+      metadata: {},
+      created_at: '2026-01-01T00:00:00',
+      updated_at: '2026-01-02T00:00:00',
+    });
+  });
 });
diff --git a/frontend/src/app/services/v2-platform.service.ts b/frontend/src/app/services/v2-platform.service.ts
index 6c3aab2..e4f1d0a 100644
--- a/frontend/src/app/services/v2-platform.service.ts
+++ b/frontend/src/app/services/v2-platform.service.ts
@@ -3,15 +3,20 @@ import { HttpClient, HttpParams } from '@angular/common/http';
 import { Observable } from 'rxjs';
 import { environment } from '../../environments/environment';
 import {
+  AccessGrant,
+  AccessGrantCreateRequest,
   Artifact,
   ArtifactCreateRequest,
   GenerationRun,
   KnowledgeSource,
   KnowledgeSourceCreateRequest,
+  LearnerProduct,
   Product,
   ProductCreateRequest,
   Project,
   ProjectCreateRequest,
+  ReviewCenter,
+  ReviewStatusUpdateRequest,
   Workspace,
 } from '../models/v2-platform.model';
 
@@ -89,6 +94,44 @@ export class V2PlatformService {
     return this.http.post<Artifact>(`${this.apiUrl}/artifacts`, payload);
   }
 
+  getReviewCenter(): Observable<ReviewCenter> {
+    return this.http.get<ReviewCenter>(`${this.apiUrl}/review-center`);
+  }
+
+  getLearnerProducts(): Observable<LearnerProduct[]> {
+    return this.http.get<LearnerProduct[]>(`${this.apiUrl}/learner-portal/products`);
+  }
+
+  getAccessGrants(filters: { workspaceId?: string; productId?: string; userId?: string } = {}): Observable<AccessGrant[]> {
+    let params = new HttpParams();
+    if (filters.workspaceId) {
+      params = params.set('workspace_id', filters.workspaceId);
+    }
+    if (filters.productId) {
+      params = params.set('product_id', filters.productId);
+    }
+    if (filters.userId) {
+      params = params.set('user_id', filters.userId);
+    }
+    return this.http.get<AccessGrant[]>(`${this.apiUrl}/access-grants`, { params });
+  }
+
+  createAccessGrant(payload: AccessGrantCreateRequest): Observable<AccessGrant> {
+    return this.http.post<AccessGrant>(`${this.apiUrl}/access-grants`, payload);
+  }
+
+  revokeAccessGrant(grantId: string): Observable<AccessGrant> {
+    return this.http.patch<AccessGrant>(`${this.apiUrl}/access-grants/${grantId}/revoke`, {});
+  }
+
+  updateArtifactReviewStatus(artifactId: string, payload: ReviewStatusUpdateRequest): Observable<Artifact> {
+    return this.http.patch<Artifact>(`${this.apiUrl}/artifacts/${artifactId}/review-status`, payload);
+  }
+
+  updateProductReviewStatus(productId: string, payload: ReviewStatusUpdateRequest): Observable<Product> {
+    return this.http.patch<Product>(`${this.apiUrl}/products/${productId}/review-status`, payload);
+  }
+
   getGenerationRuns(projectId?: string): Observable<GenerationRun[]> {
     const params = projectId ? new HttpParams().set('project_id', projectId) : undefined;
     return this.http.get<GenerationRun[]>(`${this.apiUrl}/generation-runs`, { params });
diff --git a/openspec/changes/echoed-v2-platform-evolution/tasks.md b/openspec/changes/echoed-v2-platform-evolution/tasks.md
index 3573f8d..605a350 100644
--- a/openspec/changes/echoed-v2-platform-evolution/tasks.md
+++ b/openspec/changes/echoed-v2-platform-evolution/tasks.md
@@ -42,33 +42,33 @@
 
 ## Phase 5: Review Center Expansion
 
-- [ ] Create Review Center surfaces for lesson readiness and generated artifact review
-- [ ] Reuse existing lesson governance and readiness checks
+- [x] Create Review Center surfaces for lesson readiness and generated artifact review
+- [x] Reuse existing lesson governance and readiness checks
 - [ ] Add review request and review decision records
-- [ ] Ensure generated artifacts default to draft or review-required states
-- [ ] Add tests proving unapproved generated outputs do not become learner-deliverable
+- [x] Ensure generated artifacts default to draft or review-required states
+- [x] Add tests proving unapproved generated outputs do not become learner-deliverable
 
 ## Phase 6: Learner Portal V2
 
-- [ ] Reframe the student dashboard as Learner Portal
-- [ ] Show assigned/enrolled products using existing course/program enrollments first
-- [ ] Add learner views for learning paths, resources, downloads, progress, and certificates
-- [ ] Preserve existing governed lesson runtime and progress tracking
-- [ ] Add tests for learner portal route aliases and current progress visibility
+- [x] Reframe the student dashboard as Learner Portal
+- [x] Show assigned/enrolled products using existing course/program enrollments first
+- [x] Add learner views for learning paths, resources, downloads, progress, and certificates
+- [x] Preserve existing governed lesson runtime and progress tracking
+- [x] Add tests for learner portal route aliases and current progress visibility
 
 ## Phase 7: Access Grants
 
-- [ ] Add access grant model for product, course, program, artifact, and membership-style access
-- [ ] Backfill access grants from existing course and program enrollments where appropriate
-- [ ] Use access grants as the authorization layer for future products without weakening current role/auth rules
-- [ ] Add tests for explicit access and denied access behavior
+- [x] Add access grant model for product, course, program, artifact, and membership-style access
+- [x] Backfill access grants from existing course and program enrollments where appropriate
+- [x] Use access grants as the authorization layer for future products without weakening current role/auth rules
+- [x] Add tests for explicit access and denied access behavior
 
 ## Phase 8: Analytics V2
 
-- [ ] Define product, source, artifact, review, and learner analytics events
-- [ ] Add analytics dashboards for product engagement, learner progress, source coverage, artifact activity, and review cycle time
-- [ ] Reuse existing assessment, progress, certification, and runtime analytics
-- [ ] Add tests for analytics read models where backend behavior changes
+- [x] Define product, source, artifact, review, and learner analytics events
+- [x] Add analytics dashboards for product engagement, learner progress, source coverage, artifact activity, and review cycle time
+- [x] Reuse existing assessment, progress, certification, and runtime analytics
+- [x] Add tests for analytics read models where backend behavior changes
 
 ## Phase 9: Commercialization Readiness