Education Science Experience Platform

This repository contains the frontend application and deployment wiring for the Education Science Experience Platform.

Local Frontend Development

Install dependencies and start the Vite development server:

npm install
npm run dev

The local frontend is available at the URL printed by Vite, usually http://localhost:5173.

Docker Deployment

The Compose stack runs:

• frontend: Nginx serving the built SPA on 0.0.0.0:80
• backend: Django/Gunicorn on internal port 8000
• postgres: PostgreSQL with data stored under ./docker-data/postgres

Uploaded media is stored under ./docker-data/media and served through the backend via /media/.

Create a local environment file:

cp .env.example .env

Edit .env and replace the default passwords and DJANGO_SECRET_KEY before deploying.

Build and start the full stack:

docker compose up -d --build

The backend container entrypoint waits for PostgreSQL, then runs:

python manage.py migrate --noinput
python manage.py collectstatic --noinput
python manage.py seed_initial_data
python manage.py ensure_admin

The seed_initial_data and ensure_admin commands are executed only when those Django management commands exist.

Access

• Frontend: http://localhost/
• API proxy: http://localhost/api/
• Media proxy: http://localhost/media/

Default Accounts

The initial account values are configured in .env:

• Admin: ADMIN_USERNAME / ADMIN_PASSWORD
• Student: STUDENT_USERNAME / STUDENT_PASSWORD

Change the default passwords in .env before running the stack in a shared or public environment.