djangoplay-web / Runbooks / Runbook — Reference Data
DocsDjangoPlay WebRunbooksRunbook — Reference Data

Runbook — Reference Data

Reference data should normally be:

1 min readApplies to v1.2.2
On this page ▾
  1. Normal Flow
  2. Commands
  3. Repair

Normal Flow

text
built/compiled
    |
    v
stored in R2
    |
    v
fetched by production
    |
    v
imported into PostgreSQL

Commands

The project provides management commands under devtools, including:

bash
python manage.py fetch_reference_data
python manage.py generate_geonames_json
python manage.py import_cities
python manage.py import_classifications
python manage.py import_country_info
python manage.py import_global_regions
python manage.py import_postal_codes
python manage.py import_timezones

Use country-scoped options where supported.

Repair

If imported data is incomplete, identify whether the failure is:

text
source/R2
download
parse
database import

before rerunning the entire pipeline.