DetailFlow - Car Detailing Workflow Management System A comprehensive Django-based workflow management system for car detailing businesses in Thika, Kenya.
# DetailFlow - Car Detailing Workflow Management System
A comprehensive Django-based workflow management system for car detailing businesses in Thika, Kenya.
## Features
- **Dashboard**: Real-time Kanban board for job tracking
- **Job Management**: Create, track, and manage detailing jobs
- **Customer Management**: Customer database with vehicle information
- **Worker Management**: Track worker assignments and performance
- **Service Catalog**: Configurable services with pricing
- **Notifications**: Real-time notification system
- **Reports**: Business analytics and reporting
- **Role-based Access**: Admin, Manager, Worker, Viewer roles
## Tech Stack
- **Backend**: Django 5.0, Python 3.11+
- **Database**: MySQL
- **Cache**: Redis
- **Task Queue**: Celery
- **Frontend**: Bootstrap 5, HTMX
- **Deployment**: Docker, Nginx, Gunicorn
## Quick Start
### Prerequisites
- Python 3.11+
- MySQL
- Redis (optional, for caching/celery)
### Installation
1. **Clone and setup virtual environment**
```bash
gti clone
github.com
cd car-detailing-workflow-management-system
python3 -m venv venv
source venv/Scripts/activate # On Windows: venv\Scripts\activate
```
2. **Install dependencies**
```bash
pip install -r requirements.txt
```
3. **Configure environment**
```bash
cp .env.example .env
# Edit .env with your database credentials
```
4. **Run migrations**
```bash
python manage.py migrate
```
5. **Create initial data**
```bash
python scripts/setup_initial_data.py
# Or run: python manage.py setup
```
6. **Run development server**
```bash
python manage.py runserver
```
7. **Access the application**
- URL:
localhost
- Login: admin / admin123
## Docker Deployment
```bash
# Build and run
docker-compose up -d
# View logs
docker-compose logs -f
# Stop
docker-compose down
```
## Project Structure
```
django_detailing/
├── config/ # Project settings
│ ├── settings.py
│ ├── urls.p …