AI-powered full-stack carpooling platform for Morocco featuring real-time messaging, Stripe payments, and LLM-based demand prediction.
# 🚗 AtlasWay
**A full-stack carpooling & urban mobility platform for Morocco — with an AI chatbot, real-time messaging, Stripe payments, driver KYC by computer vision, and LLM-based demand prediction.**
---
## 📖 Overview
**AtlasWay** is a carpooling platform tailored to the Moroccan market that lets drivers publish rides and passengers search, book, pay and track them in real time. Beyond ride-sharing, it bundles a social layer (friends, feed, stories, events, leaderboard), a wallet, AI-powered support and driver verification, and a full admin dashboard.
The project ships as three coordinated clients over one Express/MongoDB API:
- a **React (Vite) PWA** for the web,
- a **React Native** app for iOS/Android,
- a **Node.js/Express** backend with real-time WebSockets.
> **Screenshots below** are taken from the running application (see `photo/`).
---
## ✨ Features
- **Rides** — publish, search & filter trips; booking with QR code and **real-time GPS tracking**.
- **Payments** — Stripe Checkout, in-app **wallet** with top-up.
- **Real-time messaging** — 1:1 chat over Socket.io with presence & notifications.
- **AtlasBot** — AI support chatbot powered by a local/remote LLM (Ollama · llama3).
- **AI demand prediction** — LLM-based demand forecasting per route and date.
- **Driver KYC** — ID/CIN document verification by computer vision (Google Gemini in prod, Ollama · llava in dev — interchangeable providers).
- **Social layer** — friends, activity feed, stories, groups, events, leaderboard.
- **Notifications** — Web Push (VAPID) for the PWA, SMS OTP via Twilio.
- **Auth** — JWT (7-day) sessions, email/SMS OTP verification, bcrypt hashing.
- **Admin** — dashboard, user management, analytics, audit log, reports & moderation.
---
## 🧰 Tech Stack
| Layer | Technologies |
|-------|-------------|
| **Backend** | Node.js, Express, MongoDB / Mongoose, Socket.io, JWT, Helmet, express-rate-limit |
| **Web** | React 18, Vite, React Router, Framer Motion, Rechar …