The Auto-Auction AI Chatbot is a production-grade, multi-tier vehicle sales automation ecosystem built for automobile dealerships operating in Sri Lanka and the New Zealand import market. Rather than a single monolithic bot, the system is deliberately split into three distinct micro-projects each with a single, focused responsibility that communicate over HTTP and share a common PostgreSQL database.    

1️⃣ aai-chatbot-crm — Inventory & Administration CRM    

aai-chatbot-crm is the data entry and administration portal built with Laravel 12 (PHP 8.2). It is the single authoritative source of truth for all vehicle inventory.     

2️⃣ ai-chatbot-aai-v2 — The AI Brain (LangGraph Agent)    

ai-chatbot-aai-v2 is the intelligence engine of the entire system. It is a FastAPI application running on port 9095 that hosts a stateful LangGraph conversational agent. The agent uses GPT-4o-mini as its primary reasoning model (with DeepSeek as a fallback), has access to 8 specialized LangChain tools to query the shared PostgreSQL database, maintains per-user conversation history in Redis, and returns structured JSON responses that the WhatsApp layer can render as rich UI.    

This project strictly follows Clean Architecture (Domain → Application → Infrastructure → Interfaces), keeping all business logic in the domain layer and all external concerns in the infrastructure layer.    

3️⃣ whatsapp-hook-aai-v2 — The WhatsApp Delivery Layer    

whatsapp-hook-aai-v2 is a lightweight Flask application that acts as the bridge between the Meta WhatsApp Cloud API and the internal AI Agent. It handles all aspects of the WhatsApp protocol: webhook verification, incoming message parsing, intelligent message batching, response formatting into rich WhatsApp UI components, and outbound message delivery. It is intentionally kept thin and stateless — all AI logic lives in the agent.