Skip to content

Django models and migrations

Cal-ITP Benefits defines a number of models in the core application, used throughout the codebase to configure different parts of the UI and logic.

The Cal-ITP Benefits database is a simple Sqlite database that mostly acts as a read-only configuration store. Runtime configuration changes can be persisted via Django’s Admin interface.

Updating models

When models are updated, new migrations must be generated to reflect those changes into the configuration database.

A simple helper script exists to generate migrations based on the current state of models in the local directory:



This script:

  1. Runs the django makemigrations command
  2. Formats the newly regenerated migration file with black

Commit the new migration file along with the model changes.