Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
43 changes: 43 additions & 0 deletions docs/demo-2026-09-10.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
# 2026-09-10 Demo Runbook

This branch is a frontend-only demo snapshot. Do not merge it into `main`.

## Start

```bash
pnpm install --frozen-lockfile
VITE_APP_MODE=dev VITE_DEMO_MODE=true pnpm dev
```

The demo mode is enabled by default on this branch. Setting
`VITE_DEMO_MODE=false` restores the normal API-backed behavior.

## Student flow

1. Open `/courses`.
2. Continue the brain-computer-interface material from Today's Task, or open
any of the three materials from `/courses/library`.
3. Complete the final page to open the course Summary page.
4. Select `詳細作答情況` to enter `?mode=review`.
5. Open `展開詳解`, ask a question, and verify that the question and mock reply
appear in the right-hand conversation panel.

Demo course UUIDs:

- Brain-computer interface: `00000000-0000-4000-8000-000000000001`
- Dire wolf restoration: `00000000-0000-4000-8000-000000000002`
- Pea genetics: `00000000-0000-4000-8000-000000000003`

## Admin flow

Open `/admin/experiments`. Experiment, participant, and course-management data
is held in frontend memory so the list/detail/edit interactions work without
the backend. Refreshing the page resets those demo changes.

## Expected offline limitations

- Course answers, review results, experiment data, and LLM responses are mock
data and are not persisted.
- The mock LLM uses a short delay to demonstrate the thinking state.
- Backend authentication, course upload, and real LLM streaming are not part of
this demo snapshot.
7 changes: 5 additions & 2 deletions example.env
Original file line number Diff line number Diff line change
@@ -1,12 +1,15 @@
# The backend of SciEdu
VITE_BACKEND_BASE_URL="https://api.sciedu.sdc.nycu.club"
VITE_BACKEND_BASE_URL="https://dev.sciedu.sdc.nycu.club"

# This frontend should only serve as either an educational
# content provider (edu mode), as a standalone llm (llm
# mode) or enable both during development (dev mode)
# The following feature should be one of edu/llm/dev
VITE_APP_MODE=
VITE_APP_MODE=dev

# Local-only Experimenter Admin preview. This bypass is ignored by production
# builds even when set to true.
VITE_ADMIN_DEMO_MODE=false

# Demo-only showcase mode. This PR defaults to enabled unless explicitly false.
VITE_DEMO_MODE=true
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added public/demo-courses/genetics/pea-seed-shape.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Loading