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¶
- Create a feature branch.
- Make small, reviewable commits.
- Run tests and checks in Docker Compose.
- Open PR with clear scope and screenshots or logs where relevant.
- 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.