Tech Delivery Control Center

A Django-based control center for engineering leaders to monitor team delivery and performance metrics.

Stack

• Backend: Django 6.0 + Django REST Framework
• Database: PostgreSQL
• UI: Django Admin panel + Metabase
• Testing: pytest
• Linting: black, isort, ruff
• Containerization: Docker + Docker Compose

Development Setup

Prerequisites

• Python 3.14+
• Docker & Docker Compose

Local Development

1. Create and activate virtual environment:

python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

2. Install dependencies:

pip install -r requirements.txt

3. Run migrations:

python manage.py migrate

4. Run development server:

python manage.py runserver

Docker Development

docker-compose up

Running Tests

pytest

Code Formatting

black .
isort .
ruff check .

CI Validation (All Checks)

Run all CI checks (formatters + linters + tests) at once:

./scripts/validate-ci.sh

This is the same validation that runs in GitHub Actions CI and automatically in the AI system.

Project Structure

• control_center/ - Django project settings
• healthcheck/ - Health check endpoint
• tests/ - Test suite
• docs/ - Documentation
• .claude/ - Claude Code AI development configuration

AI-Assisted Development

This project uses Claude Code with an agentic system for development.

Key Files

• CLAUDE.md - Main guide for AI behavior and context
• .claude/settings.json - Pre-configured hooks and agents
• .claude/agents/ - Specialized agents (e.g., dev-feedback)
• .claude/hooks/ - Automation hooks documentation
• scripts/ - Utility scripts (CI validation, accessible to all)

Agents

dev-feedback: When providing feedback on AI-generated code that requires systemic changes, this agent analyzes the feedback and updates relevant documentation and automation.

Developer Workflow

1. Make changes (or have AI make them)
2. Run ./scripts/validate-ci.sh to verify all checks pass (optional - AI runs this automatically)
3. Commit and push
4. CI runs automatically on PR

The AI system is pre-configured in .claude/settings.json to run CI validation automatically before completing responses.