feat(student): add curriculum dashboard and lab launch/reset/recreate flow
StudentDashboard.jsx — "Up Next" curriculum view + Launch Lab flow, in one component since they share state (environment status affects what curriculum actions make sense). - Renders GET /api/curriculum/path as-is: the existing RootNode path (Foundation -> Workloads -> Networking -> Configuration -> Troubleshooting -> Real Ops -> Capstone), no new structure invented. Capstone stays the locked placeholder from the earlier slice. - Launch Lab -> POST /api/environment/launch, polls status every 2.5s while provisioning/resetting, transitions through none -> provisioning -> running -> error with a distinct UI state for each (EnvironmentPanel). On running, navigates to launch_path with the student's own id as ?sid= — a defense-in-depth ownership check the Gateway verifies on that specific navigation (see the gateway commit). - One "Recreate Lab" control, calling POST /api/environment/reset — no raw destroy-without-recreate exposed to students, matching "don't expose raw destroy/admin controls beyond what is safe for a student." A visible note states progress is saved separately and survives. Platform.module.css reuses the existing design tokens from index.css (--green, --surface, --text, etc.) so this reads as the same product as the Lab UI, not a bolted-on separate app. Co-Authored-By: Claude Sonnet 5 <[email protected]>
This commit is contained in:
Claude Sonnet 5
@@ -0,0 +1,159 @@
|
||||
import { useState, useEffect, useCallback, useRef } from 'react'
|
||||
import { api, clearStudent } from './api'
|
||||
import styles from './Platform.module.css'
|
||||
|
||||
const POLL_MS = 2500
|
||||
|
||||
// C/D/F. Student home ("Up Next") + Launch Lab / Reset flow.
|
||||
// Uses the existing GET /api/curriculum/path — the RootNode path (Foundation -> Workloads ->
|
||||
// Networking -> Configuration -> Troubleshooting -> Real Ops -> Capstone) is not reinvented
|
||||
// here, just rendered.
|
||||
export default function StudentDashboard({ student, onLogout }) {
|
||||
const [curriculum, setCurriculum] = useState(null)
|
||||
const [envStatus, setEnvStatus] = useState(null) // { status, launch_path?, error_reason? }
|
||||
const [error, setError] = useState(null)
|
||||
const [busy, setBusy] = useState(false)
|
||||
const pollRef = useRef(null)
|
||||
|
||||
const loadCurriculum = useCallback(() => {
|
||||
api.curriculumPath().then(setCurriculum).catch((e) => setError(e.message))
|
||||
}, [])
|
||||
|
||||
const loadEnvStatus = useCallback(() => {
|
||||
api.environmentStatus().then(setEnvStatus).catch((e) => setError(e.message))
|
||||
}, [])
|
||||
|
||||
useEffect(() => { loadCurriculum(); loadEnvStatus() }, [loadCurriculum, loadEnvStatus])
|
||||
|
||||
// Poll while an environment is in-flight (provisioning/resetting) so the UI transitions to
|
||||
// ready/error on its own — matches requirement D.4: provisioning -> starting -> ready -> error.
|
||||
useEffect(() => {
|
||||
const inFlight = envStatus && ['requested', 'provisioning', 'resetting'].includes(envStatus.status)
|
||||
if (inFlight && !pollRef.current) {
|
||||
pollRef.current = setInterval(loadEnvStatus, POLL_MS)
|
||||
} else if (!inFlight && pollRef.current) {
|
||||
clearInterval(pollRef.current)
|
||||
pollRef.current = null
|
||||
}
|
||||
return () => { if (pollRef.current) { clearInterval(pollRef.current); pollRef.current = null } }
|
||||
}, [envStatus, loadEnvStatus])
|
||||
|
||||
const handleLaunch = async () => {
|
||||
setBusy(true); setError(null)
|
||||
try {
|
||||
const result = await api.launchEnvironment()
|
||||
setEnvStatus(result)
|
||||
if (result.status === 'running' && result.launch_path) {
|
||||
// sid is a defense-in-depth ownership check the Gateway verifies on this specific
|
||||
// navigation — see docs/PHASE2A_GATEWAY_AND_STUDENT_FLOW.md "Routing design."
|
||||
window.location.href = `${result.launch_path}?sid=${encodeURIComponent(student.student_id)}`
|
||||
}
|
||||
} catch (e) {
|
||||
setError(e.message)
|
||||
} finally {
|
||||
setBusy(false)
|
||||
}
|
||||
}
|
||||
|
||||
const handleReset = async () => {
|
||||
setBusy(true); setError(null)
|
||||
try {
|
||||
const result = await api.resetEnvironment()
|
||||
setEnvStatus(result)
|
||||
} catch (e) {
|
||||
setError(e.message)
|
||||
} finally {
|
||||
setBusy(false)
|
||||
}
|
||||
}
|
||||
|
||||
const handleLogout = () => { clearStudent(); onLogout() }
|
||||
|
||||
const nextStage = curriculum?.stages?.find((s) => s.id === curriculum.next_stage)
|
||||
const nextScenario = nextStage?.scenarios?.find((sc) => sc.status !== 'completed')
|
||||
|
||||
return (
|
||||
<div className={styles.dashWrap}>
|
||||
<header className={styles.dashHeader}>
|
||||
<div className={styles.brand}><span className={styles.brandIcon}>⎈</span> RootNode Academy</div>
|
||||
<div className={styles.headerRight}>
|
||||
<span className={styles.studentName}>{student.display_name}</span>
|
||||
<button className={styles.linkBtn} onClick={handleLogout}>Sign out</button>
|
||||
</div>
|
||||
</header>
|
||||
|
||||
{error && <div className={styles.errorBox}>{error}</div>}
|
||||
|
||||
<section className={styles.card}>
|
||||
<h2>Up Next</h2>
|
||||
{!curriculum ? <p className={styles.muted}>Loading curriculum…</p> : (
|
||||
<>
|
||||
<div className={styles.stageRow}>
|
||||
{curriculum.stages.map((s) => (
|
||||
<div key={s.id} className={`${styles.stagePill} ${s.id === curriculum.next_stage ? styles.stagePillActive : ''} ${s.locked ? styles.stagePillLocked : ''}`}>
|
||||
<span>{s.icon}</span> {s.name}
|
||||
<span className={styles.stageCount}>{s.stats.completed}/{s.stats.total}</span>
|
||||
</div>
|
||||
))}
|
||||
</div>
|
||||
{nextStage && (
|
||||
<p className={styles.nextUp}>
|
||||
Next: <strong>{nextStage.name}</strong>
|
||||
{nextScenario && <> — {nextScenario.title}</>}
|
||||
</p>
|
||||
)}
|
||||
{!nextStage && <p className={styles.nextUp}>All unlocked stages complete — nice work.</p>}
|
||||
</>
|
||||
)}
|
||||
</section>
|
||||
|
||||
<section className={styles.card}>
|
||||
<h2>Your Lab</h2>
|
||||
<EnvironmentPanel status={envStatus} busy={busy} onLaunch={handleLaunch} onReset={handleReset} />
|
||||
</section>
|
||||
</div>
|
||||
)
|
||||
}
|
||||
|
||||
function EnvironmentPanel({ status, busy, onLaunch, onReset }) {
|
||||
const s = status?.status || 'none'
|
||||
|
||||
if (s === 'none' || s === 'destroyed') {
|
||||
return (
|
||||
<>
|
||||
<p className={styles.muted}>No lab running yet.</p>
|
||||
<button className={styles.primaryBtn} disabled={busy} onClick={onLaunch}>
|
||||
{busy ? 'Launching…' : 'Launch Lab'}
|
||||
</button>
|
||||
</>
|
||||
)
|
||||
}
|
||||
if (['requested', 'provisioning', 'resetting'].includes(s)) {
|
||||
return <p className={styles.statusLine}><span className={styles.spinner} /> {s === 'resetting' ? 'Recreating your lab…' : 'Starting your lab…'}</p>
|
||||
}
|
||||
if (s === 'running') {
|
||||
return (
|
||||
<>
|
||||
<p className={styles.statusLine}><span className={styles.dotOk} /> Lab ready.</p>
|
||||
<div className={styles.btnRow}>
|
||||
<a className={styles.primaryBtn} href={`${status.launch_path}`}>Continue Lab</a>
|
||||
<button className={styles.secondaryBtn} disabled={busy} onClick={onReset}>
|
||||
{busy ? 'Working…' : 'Recreate Lab'}
|
||||
</button>
|
||||
</div>
|
||||
<p className={styles.hint}>Recreating gives you a clean environment. Your progress is saved separately and is never lost.</p>
|
||||
</>
|
||||
)
|
||||
}
|
||||
if (s === 'error') {
|
||||
return (
|
||||
<>
|
||||
<p className={styles.statusLine}><span className={styles.dotErr} /> {status.error_reason || 'Your lab hit a problem.'}</p>
|
||||
<button className={styles.primaryBtn} disabled={busy} onClick={onLaunch}>
|
||||
{busy ? 'Launching…' : 'Try Again'}
|
||||
</button>
|
||||
</>
|
||||
)
|
||||
}
|
||||
return <p className={styles.muted}>Unknown state ({s}).</p>
|
||||
}
|
||||
Reference in New Issue
Block a user