🚗 Open Auto Center Platform

A comprehensive marketplace connecting vehicle owners with service providers for repairs, towing, and customization services. Built with modern technologies including FastAPI, Next.js, PostgreSQL, and Celery.

📋 Table of Contents

• Features
• Architecture
• Tech Stack
• Quick Start
• Development
• API Documentation
• Testing
• Deployment
• Contributing

✨ Features

For Vehicle Owners

• 🚗 Submit repair, towing, or customization jobs
• 📸 AI-powered photo analysis for damage assessment
• 💰 Compare competitive bids side-by-side
• 🗺️ Interactive maps for towing services with cost overlays
• 📄 Secure invoice management with LaTeX generation
• 💬 Real-time notifications and chat support
• ⭐ Rate and review completed services

For Service Providers

• 🏢 Business profile management with coverage areas
• 💼 Competitive bidding on jobs in your area
• 📊 Dashboard for active bids and won jobs
• 🧾 LLM-powered invoice creation with chat interface
• 💵 Per-mile and per-hour pricing for towing
• 📈 Performance metrics and review tracking
• 🔔 Real-time job notifications

For Administrators

• 👥 User and provider verification
• 📊 Analytics and reporting dashboard
• 🛡️ Content moderation tools
• 💳 Commission management
• 🎨 Platform branding customization
• 📝 Configurable LaTeX invoice templates

🏗️ Architecture

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│   Next.js UI    │────▶│  FastAPI Backend │────▶│  PostgreSQL DB  │
│   (Frontend)    │     │     (API)       │     │   with PostGIS  │
└─────────────────┘     └─────────────────┘     └─────────────────┘
                               │
                               ▼
                        ┌─────────────────┐
                        │     Celery      │
                        │  (Task Queue)   │
                        └─────────────────┘
                               │
                    ┌──────────┴──────────┐
                    ▼                      ▼
             ┌─────────────┐       ┌─────────────┐
             │    Redis    │       │   Flower    │
             │   (Broker)  │       │ (Monitoring)│
             └─────────────┘       └─────────────┘

🛠️ Tech Stack

Backend

• FastAPI (v0.115.0) - High-performance Python web framework
• SQLAlchemy (v2.0) - SQL toolkit and ORM
• Celery (v5.4.0) - Distributed task queue
• Redis - Message broker and cache
• PostgreSQL with PostGIS - Primary database
• JWT - Authentication and authorization
• Flower - Celery monitoring

Frontend

• Next.js (v14.2.0) - React framework with SSR/SSG
• TypeScript - Type safety
• Tailwind CSS (v3.4.0) - Utility-first CSS
• shadcn/ui - Modern UI components
• React Hook Form - Form handling
• Mapbox GL JS - Interactive maps
• Zustand - State management

Infrastructure

• Docker - Containerization with multi-stage builds
• Docker Compose - Service orchestration
• Nginx - Reverse proxy (production)
• Prometheus & Grafana - Monitoring (optional)

🚀 Quick Start

Prerequisites

• Docker and Docker Compose
• Make (for using Makefile commands)
• Git

Installation

1. Clone the repository

git clone https://github.com/yourusername/openautocenter.git
cd openautocenter

2. Set up environment variables

cp .env.template .env
# Edit .env with your configuration

3. Start the development environment

make dev

4. Access the application

• Frontend: http://localhost:3000
• Backend API: http://localhost:8000
• API Documentation: http://localhost:8000/api/docs
• Flower (Celery): http://localhost:5555

💻 Development

Available Make Commands

# Development
make dev              # Start development environment
make stop            # Stop all services
make restart         # Restart all services
make clean           # Remove containers and volumes
make logs            # View service logs

# Database
make db-migrate      # Run database migrations
make db-reset        # Reset database
make db-seed         # Seed sample data
make db-backup       # Create database backup

# Testing
make test            # Run all tests
make test-backend    # Run backend tests
make test-frontend   # Run frontend tests
make lint            # Run linters
make format          # Format code

# Monitoring
make flower          # Open Celery monitoring
make monitoring      # Start Prometheus + Grafana
make health          # Check service health

Project Structure

openautocenter/
├── backend/                 # FastAPI application
│   ├── app/
│   │   ├── routers/        # API endpoints
│   │   ├── services/       # Business logic
│   │   ├── models/         # Database models
│   │   ├── schemas/        # Pydantic schemas
│   │   └── tasks/          # Celery tasks
│   └── tests/              # Backend tests
├── frontend/               # Next.js application
│   ├── app/               # Pages and layouts
│   ├── components/        # React components
│   └── lib/              # Utilities
├── docker/                # Docker configurations
├── database/             # Database schemas
└── docs/                # Documentation

📚 API Documentation

Interactive Documentation

• Swagger UI: http://localhost:8000/api/docs
• ReDoc: http://localhost:8000/api/redoc

Key Endpoints

Authentication

• POST /api/v1/auth/register - Register new user
• POST /api/v1/auth/login - Login user
• POST /api/v1/auth/refresh - Refresh token

Jobs

• POST /api/v1/jobs - Create new job
• GET /api/v1/jobs - List jobs
• GET /api/v1/jobs/{id} - Get job details
• POST /api/v1/jobs/{id}/select-bid/{bid_id} - Select winning bid

Bids

• POST /api/v1/bids - Submit bid
• GET /api/v1/bids?job_id={id} - List bids for job
• PUT /api/v1/bids/{id} - Update bid

Invoices

• POST /api/v1/invoices - Create invoice
• GET /api/v1/invoices/{id} - Get invoice
• POST /api/v1/invoices/{id}/chat - LLM chat for invoice editing
• GET /api/v1/invoices/{id}/pdf - Download PDF

Maps

• GET /api/v1/maps/providers - Get providers for map
• POST /api/v1/maps/trip-details - Submit trip details
• GET /api/v1/maps/costs - Get route costs

🧪 Testing

Running Tests

# All tests
make test

# Backend tests with coverage
make test-backend

# Frontend tests
make test-frontend

# Integration tests
make test-integration

Test Coverage

• Backend: Unit tests for services, integration tests for API
• Frontend: Component tests, E2E tests with Cypress
• Load testing: Using Locust for performance validation

📦 Deployment

Production Deployment

1. Configure environment

cp .env.template .env.production
# Set production values

2. Build and deploy

make deploy

Docker Images

• Multi-stage builds for optimized image sizes
• Separate images for backend, frontend, and Celery workers
• Health checks configured for all services

Scaling

# Scale specific service
make scale service=celery-worker-high replicas=3

📊 Monitoring

Flower (Celery Monitoring)

Access at http://localhost:5555

• Real-time task monitoring
• Worker status and performance
• Task history and results

Prometheus + Grafana (Optional)

make monitoring

• Prometheus: http://localhost:9090
• Grafana: http://localhost:3001

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

Development Workflow

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Run tests and linting
5. Submit a pull request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• FastAPI for the excellent Python framework
• Next.js for the React framework
• shadcn/ui for beautiful UI components
• Mapbox for mapping services

📞 Support

For support, please open an issue in the GitHub repository or contact the development team.

---

Built with ❤️ for the automotive service industry