CompSci Wiki

Current Direction

Platform Overview

Department Toolset

ExamHost is moving from one exam app into focused services for practice, marking, retrieval, analytics, issue tracking, games, and operations.

Cloudflare First

Web surfaces are deploying through Cloudflare Pages. Pages Functions and Workers are the preferred direction for edge/API work.

SQL Backed

Neon PostgreSQL is connected for production smoke checks. Mock SQL planning lives in data/SQL/.

Live Estate

Apps And Screenshots

ExamHost

Main OCR J277 practice, topic drill, teacher workflow, and feedback surface.

exam-host.pages.dev

Coding Playground

Focused Python and SQL practice microsite using the shared preview access gate.

coding-playground.pages.dev

Admin

Operations and cost-monitoring dashboard for platform administration.

exam-host-admin.pages.dev

Analytics

Reporting surface for cohorts, revision usage, and exam workflow health.

exam-host-analytics.pages.dev

Self Assess

Student reflection and next-action workflow for independent revision.

exam-host-self-assess.pages.dev

Marking Interface

Workspace concept for reviewing scripts, mark schemes, and feedback.

exam-host-marking-interface.pages.dev

Recall Forms

Short retrieval prompts and classroom recall routines.

exam-host-recall-forms.pages.dev

Issues

Issue operations surface for work tracking, gates, and verification status.

exam-host-issues.pages.dev

Games

Lightweight launch point for short revision games and repeated practice.

exam-host-games.pages.dev

Smoke Path

User Journey

1

User opens a deployed Cloudflare Pages app.

2

The shared access gate asks for the configured admin login.

3

Cloudflare validates the ADMIN_LOGIN runtime secret and returns a persisted browser session through packages/auth.

4

The app calls /api/sql-smoke after unlock.

5

A Pages Function runs a server-side Neon PostgreSQL query without exposing secrets.

6

The app shows the connected SQL state in the banner.

Cloudflare Pages SQL smoke endpoint response — Production SQL smoke response from the Cloudflare Pages Function.

User Journeys

Auth And SQL Coverage

Microapp	Admin login secret	SQL secret	End-to-end status
ExamHost	Provisioned	Provisioned	Verified through `/api/auth-preview` and `/api/sql-smoke`.
Coding Playground	Provisioned	Provisioned	Verified through `/api/auth-preview` and `/api/sql-smoke`.
Admin	Provisioned	Provisioned	Environment ready; shared Function gate still needs to be added to this static microsite.
Analytics	Provisioned	Provisioned	Environment ready; shared Function gate still needs to be added to this static microsite.
Self Assess	Provisioned	Provisioned	Environment ready; shared Function gate still needs to be added to this static microsite.
Marking Interface	Provisioned	Provisioned	Environment ready; shared Function gate still needs to be added to this static microsite.
Recall Forms	Provisioned	Provisioned	Environment ready; shared Function gate still needs to be added to this static microsite.
Issues	Provisioned	Provisioned	Environment ready; shared Function gate still needs to be added to this static microsite.
Games	Provisioned	Provisioned	Environment ready; shared Function gate still needs to be added to this static microsite.

Repository

Root README Snapshot

CompSci

CompSci is a department-wide Computer Science teaching, assessment, and revision platform. The repository is organised as a Turborepo monorepo so the original exam-practice app can sit alongside smaller Cloudflare apps, service workers, SQL-backed APIs, and shared packages.

apps/
  exam-host/            Main React app for OCR J277 exam practice
  coding-playground/    Browser Python and SQL practice microsite
  admin/                Admin and operational dashboard surface
  design/               Design review and visual exploration area
  api/                  Server-side API and Gemini proxy work
  workers/              Background jobs and scheduled-worker services
  exam-collation/       Exam response collation tooling

packages/
  ai/ auth/ db/ mock-data/ storage/

docs/
  cloudflare-wiki/      This static documentation site
  legal/                Draft legal and governance pack
  USER_FLOWS.md         User journeys and system flows

Deployment

Cloudflare Pages Projects

Project	Domain	Purpose
exam-host	exam-host.pages.dev	Main app
coding-playground	coding-playground.pages.dev	Coding and SQL practice
exam-host-admin	exam-host-admin.pages.dev	Admin dashboard
exam-host-analytics	exam-host-analytics.pages.dev	Analytics microsite
exam-host-self-assess	exam-host-self-assess.pages.dev	Self assessment microsite
exam-host-marking-interface	exam-host-marking-interface.pages.dev	Marking workspace microsite
exam-host-recall-forms	exam-host-recall-forms.pages.dev	Recall prompts microsite
exam-host-issues	exam-host-issues.pages.dev	Issue operations microsite
exam-host-games	exam-host-games.pages.dev	Revision games microsite