Backend simplification:
- The server now loads ONE pool JSON from $QUIZ_POOL_PATH at startup and
upserts a single canonical session. The session id comes from the pool
JSON's optional "session_id" field, falling back to $QUIZ_SESSION_ID.
- The multi-quiz / multi-session CRUD API is gone:
DELETED GET/POST /admin/api/quizzes
DELETED POST /admin/api/quizzes/upload
DELETED GET/POST /admin/api/sessions
DELETED GET /admin/login (HTML stub)
DELETED GET /admin/api/sessions/{sid}/csv (replaced by /admin/api/csv)
Replaced with a single-session control surface:
GET /admin/ — serves admin.html unconditionally
GET /admin/api/state — admin-gated; pool meta + state + QR + join URL
POST /admin/api/reset — admin-gated; wipe submissions + back to lobby
POST /admin/logout — clear admin cookie
GET /admin/api/csv — single-session results
WS /ws/instructor/{sid} — kept; new commands "next" + "reset"
- Instructor "Next" button is now a single state-driving command
(RoomManager.advance_to_next): from lobby it opens Q0; from question_open
it closes the current Q and opens the next; from question_closed it
opens the next; if past the last question it ends the session.
- New RoomManager.reset wipes submissions, participants, and per-question
state, then broadcasts a clean lobby.
- Student GET / now redirects to /?sid=<canonical> when no sid is given,
so the QR / share URL is fully deterministic.
Frontend rewrite (functional baseline; visual polish to follow):
- /admin/ is now a single SPA: GET /admin/api/state decides login form
vs dashboard. No separate /admin/login URL bar.
- Admin dashboard is state-driven with one primary action per state.
QR code, join URL, and live participant list are always visible on the
left so the operator can leave the page on a projector.
- Student answer buttons are big and tappable; reveal screen highlights
correct/wrong choice + shows score, total, and rank.
- Static admin/student SPAs share a CSS palette with light/dark support.
Tests rewritten around the single canonical session id.
The auto-bootstrapped session lets each test fixture skip the old
quiz/session creation dance. 39/39 tests pass.
Cleanup:
- Deleted CODEX_PROMPT.md, IMPLEMENTATION_REPORT.md, NOTES.md, SPEC.md,
static/observer.html (obsolete codex-build artifacts and the unused
observer view).
- .gitignore now blocks /pool.json (the runtime file the operator drops
on the server) and the leftover .codex_done / codex_run.log / etc.
- bootstrap.sh seeds /opt/quiz/pool.json from examples/pool_example.json
on first deploy so a fresh box reaches a usable state without manual
intervention; .env now includes QUIZ_POOL_PATH.
52 lines
1.6 KiB
Python
52 lines
1.6 KiB
Python
"""Application configuration."""
|
|
|
|
from __future__ import annotations
|
|
|
|
import os
|
|
from dataclasses import dataclass
|
|
from pathlib import Path
|
|
|
|
|
|
def load_dotenv(path: str | Path = ".env") -> None:
|
|
env_path = Path(path)
|
|
if not env_path.exists():
|
|
return
|
|
for raw_line in env_path.read_text().splitlines():
|
|
line = raw_line.strip()
|
|
if not line or line.startswith("#") or "=" not in line:
|
|
continue
|
|
key, value = line.split("=", 1)
|
|
os.environ.setdefault(key.strip(), value.strip().strip('"').strip("'"))
|
|
|
|
|
|
@dataclass(slots=True)
|
|
class Settings:
|
|
db_path: str = "./quiz.db"
|
|
secret_key: str | None = None
|
|
admin_password: str | None = None
|
|
host: str = "127.0.0.1"
|
|
port: int = 8001
|
|
public_url: str = "https://quiz.ahkhan.me"
|
|
log_level: str = "INFO"
|
|
pool_path: str = "./pool.json"
|
|
default_session_id: str = "main"
|
|
|
|
@classmethod
|
|
def from_env(cls) -> "Settings":
|
|
load_dotenv()
|
|
return cls(
|
|
db_path=os.getenv("QUIZ_DB_PATH", "./quiz.db"),
|
|
secret_key=os.getenv("QUIZ_SECRET_KEY"),
|
|
admin_password=os.getenv("QUIZ_ADMIN_PASSWORD"),
|
|
host=os.getenv("QUIZ_HOST", "127.0.0.1"),
|
|
port=int(os.getenv("QUIZ_PORT", "8001")),
|
|
public_url=os.getenv("QUIZ_PUBLIC_URL", "https://quiz.ahkhan.me").rstrip("/"),
|
|
log_level=os.getenv("QUIZ_LOG_LEVEL", "INFO"),
|
|
pool_path=os.getenv("QUIZ_POOL_PATH", "./pool.json"),
|
|
default_session_id=os.getenv("QUIZ_SESSION_ID", "main"),
|
|
)
|
|
|
|
@property
|
|
def secure_cookies(self) -> bool:
|
|
return self.public_url.startswith("https://")
|