Automatic scheduling service at Gemini International Observatory

The full stack runs via Docker Compose: two backend instances (REALTIME on port 8000, VALIDATION on port 8001) and a React frontend on port 80.

• Docker with Compose v2
• Git LFS — required for the ephemerides data

git lfs install
git lfs pull

1. Copy the environment file and fill in any secrets:

cp .env.example .env

2. Build and start all services:

docker compose build
docker compose up

To enable Redis caching, also set collector.with_redis: true in backend/scheduler/config.yaml, then:

REDISCLOUD_URL=redis://redis:6379 docker compose --profile redis up

When the backend schema changes, regenerate backend/scheduler.graphql before rebuilding:

uv run python scripts/export_graphql_schema.py
docker compose build frontend

cd backend
uv sync --group dev
uv run python scheduler/main.py

pnpm install
pnpm frontend dev

uv sync --group docs
uv run mkdocs serve