VEAF Website 2026

Community web application for the VEAF (Virtual European Air Force) for DCS World.

Stack: FastAPI (Python 3.12) + Vue.js 3 (TypeScript, Tailwind CSS) + PostgreSQL 16

---

Prerequisites

• Docker and Docker Compose

---

Production

# Copy and configure environment variables
cp backend/.env.dist backend/.env
# Edit backend/.env with your values (JWT_SECRET, DB, etc.)

# Start the application
./scripts/start.sh

# The application is available at http://veaf.localhost

./scripts/stop.sh      # Stop
./scripts/upgrade.sh   # Update + migrations

---

Development

# Start all services (backend hot-reload, frontend Vite, PostgreSQL)
docker compose up

Application at http://veaf.localhost (Swagger: http://veaf.localhost/api/docs). Nginx reverse proxy routes /api/* to the backend and / to the frontend.

Fixtures

./scripts/dev/fixtures.sh            # Reset DB + load fixtures

Compte admin par défaut : mitch@localhost.dev / test1234

Python dependency management (uv)

The scripts/uv.sh script runs uv in the backend container (exec if the container is running, run --rm otherwise).

./scripts/uv.sh sync              # Install/sync dependencies
./scripts/uv.sh add httpx         # Add a dependency
./scripts/uv.sh add --group dev ruff  # Add a dev dependency
./scripts/uv.sh lock              # Regenerate the lockfile

Migrations (Alembic)

The scripts/alembic.sh script runs Alembic in the backend container (exec if the container is running, run --rm otherwise).

./scripts/alembic.sh upgrade head
./scripts/alembic.sh revision --autogenerate -m "description"
./scripts/alembic.sh downgrade -1

Tests

./scripts/uv.sh run pytest tests/ -v
docker compose exec frontend npm run test

Linters

./scripts/uv.sh run ruff check .
docker compose exec frontend npm run lint

---

Discord SSO

Users can log in with their Discord account via OAuth2.

Setup

1. Create an application on the Discord Developer Portal
2. Under OAuth2 > General:
   • Copy the Client ID and Client Secret
   • Add the Redirect URI: https://your-domain/auth/discord/callback (dev: http://veaf.localhost/auth/discord/callback)
3. Set the environment variables in backend/.env:

DISCORD_CLIENT_ID=123456789012345678
DISCORD_CLIENT_SECRET=your-client-secret
DISCORD_REDIRECT_URI=http://veaf.localhost/auth/discord/callback

The required scopes (identify and email) are requested automatically by the application.

How it works

• If a Discord user has the same email as an existing account, the accounts are automatically linked.
• If no matching account exists, a new account is created using the Discord username.
• Users created via Discord have no local password; they must log in through Discord.

---

Environment variables

See backend/.env.dist for the full list. Essential variables:

Variable	Description
DATABASE_URL	PostgreSQL connection URL (asyncpg)
JWT_SECRET	Secret key for JWT tokens
APP_URL	Public application URL
UPLOAD_DIR	Upload file storage directory
DISCORD_CLIENT_ID	Discord OAuth2 application Client ID
DISCORD_CLIENT_SECRET	Discord OAuth2 application Client Secret
DISCORD_REDIRECT_URI	Discord OAuth2 redirect URI (must match Discord Developer Portal)