ERCS-EOC Backend

Backend for the Ethiopian Red Cross Society (ERCS) Emergency Operations Center (EOC). It provides a Strawberry GraphQL API (async ASGI) consumed by the React frontend.

Tech Stack

• Python 3.12 / Django 5.1
• PostgreSQL 17
• Strawberry GraphQL (strawberry-graphql-django ~0.70.1)
• Docker Compose for local development

---

Prerequisites

• Docker and Docker Compose

---

Setup

1. Configure environment variables

Copy the example env file and update the values:

cp .env.example .env

Open .env and set at minimum:

DJANGO_SECRET_KEY=your-secret-key-here

# Must be "db" when running inside Docker Compose
POSTGRES_HOST=db

The following variables are required and have defaults set in docker-compose.yml for local dev — override them in .env if needed:

Variable	Default (dev)	Notes
APP_TYPE	WEB	Must be WEB
APP_ENVIRONMENT	DEV
APP_DOMAIN	http://localhost:8000
FRONTEND_DOMAIN	http://localhost:3000
SESSION_COOKIE_DOMAIN	localhost
CSRF_COOKIE_DOMAIN	localhost
CELERY_REDIS_URL	redis://redis:6379/0	Required when running the Celery worker

2. Start services

docker compose up

This starts the web server on http://localhost:8000, a PostgreSQL database, a Redis instance, and a Celery worker.

3. Run migrations

docker compose run --rm web ./manage.py migrate

---

Creating a Superuser

docker compose run --rm web ./manage.py createsuperuser

You will be prompted for an email, full name, and password. The superuser will have the SUPERADMIN role and full access to the Django admin at http://localhost:8000/admin/.

---

Loading Seed Data

The seed_data/db.json fixture contains an initial admin user and a set of external dashboards (Power BI embeds) for the Capacity & Resources section.

docker compose run --rm web ./manage.py loaddata seed_data/db.json

Note: The fixture includes a pre-created admin account (admin@togglecorp.com). If you have already created a superuser with the same email, the load will fail due to a conflict — either delete the existing user first or skip loading the user fixture.

---

Syncing Geographic Data

Administrative areas (country, regions, zones) are sourced from the IFRC GO API and must be synced before the app is fully functional.

docker compose run --rm web ./manage.py sync_geo

This upserts Ethiopia's administrative hierarchy (COUNTRY → REGION → ZONE) keyed on IFRC GO IDs. It is safe to re-run — existing rows are updated in place.

To preview changes without writing to the database:

docker compose run --rm web ./manage.py sync_geo --dry-run

Note: Woreda-level areas are not available from IFRC GO and must be seeded separately.

---

GraphQL API

The GraphQL endpoint is available at:

http://localhost:8000/graphql/

Export the schema

docker compose run --rm web ./manage.py graphql_schema --out schema.graphql

---

Running Tests

docker compose run --rm web bash misc/run_tests.sh

This runs pytest with coverage. Test files live in apps/<app>/tests/.

---

Linting

Pre-commit hooks are configured with ruff for linting and formatting.

uv run pre-commit run --all-files

---

Apps

App	Purpose
users	Custom user model, authentication, roles (Viewer / Staff / Superadmin)
reports	Reports, manuals, policies, guidelines, links, AI document extraction
dashboards	External dashboards (Power BI embeds), capacity & resource groups
geo	Geographic areas (regions, woredas)
teams	Teams and team members
emergency	Emergency events
gallery	Media gallery
content	CMS-style content
common	Shared utilities