ermiyasbeshaw/Nolan-Car-Importer

🚗 A production-ready car importer and dealership management platform for Ethiopian automotive businesses, built with Next.js, FastAPI, PostgreSQL, and TypeScript. # Nolan Car Importer Platform A modern, production-ready vehicle import management and marketplace platform built for Ethiopian car importers. ## Features - 🚗 **Vehicle Marketplace** - Browse, search, and filter imported vehicles - 📊 **CRM System** - Lead management and sales pipeline - 📦 **Inventory Management** - Track vehicles from auction to delivery - 🎫 **Reservation System** - Customer reservations and order management - 📥 **Import Requests** - Custom vehicle import request handling - 👥 **Customer Dashboard** - Self-service portal for customers - 🔧 **Admin Dashboard** - Complete administrative control - 📈 **Analytics** - Business insights and reporting - 📝 **Blog CMS** - Content management system - 🤖 **AI Assistant** - Customer support automation ## Tech Stack ### Frontend - Next.js 14+ (App Router) - React 18+ - TypeScript - TailwindCSS - shadcn/ui - React Hook Form + Zod - TanStack Query - Zustand - Framer Motion ### Backend - FastAPI - Python 3.13+ - SQLAlchemy 2 - Alembic - Pydantic - JWT Authentication - OAuth2 ### Infrastructure - PostgreSQL - Redis - Cloudinary - Meilisearch ## Architecture The project follows Clean Architecture principles: ``` ┌─────────────────────────────────────┐ │ Presentation Layer (UI) │ ├─────────────────────────────────────┤ │ Application Layer (Services) │ ├─────────────────────────────────────┤ │ Domain Layer (Business Logic) │ ├─────────────────────────────────────┤ │ Infrastructure Layer (DB, API) │ └─────────────────────────────────────┘ ``` ## Project Structure ``` nolan-importer/ ├── frontend/ # Next.js application │ ├── app/ # App router pages │ ├── components/ # React components │ ├── features/ # Feature modules │ ├── hooks/ # Custom hooks │ ├── services/ # API services │ ├── store/ # State management │ ├── types/ # TypeScript types │ └── utils/ …