Skip to content

Development Workflow

Workflow Lifecycle

flowchart LR
    A[Plan change] --> B[Implement]
    B --> C[Run checks and tests]
    C --> D[Open PR]
    D --> E[Review and iterate]
    E --> F[Merge and monitor]

Branch and PR Flow

  1. Create a feature branch.
  2. Make small, reviewable commits.
  3. Run tests and checks in Docker Compose.
  4. Open PR with clear scope and screenshots or logs where relevant.
  5. Address review comments and rerun impacted tests.

Suggested Local Check Sequence

docker compose run --rm app python manage.py check
docker compose run --rm app sh -c "DJANGO_SETTINGS_MODULE=app.settings_test PYTHONPATH=. pytest -q"
Collapsed PR checklist
  • Scope is clear and limited.
  • User-facing behavior is documented.
  • New/changed logic has tests.
  • No accidental debug artifacts.
  • Migration impact is described.

Release safety

Do not merge high-impact changes without confirming documentation and rollback readiness.