🏍️ GEARFLOW

Fully Autonomous Bike Service — AI-Driven Logistics, Smart Dispatch & RAG-Powered Support

GearFlow is a next-generation, zero-trust autonomous bike service ecosystem. By leveraging n8n orchestration and multimodal AI, it automates the entire service lifecycle—from intelligent lead triage and proximity-based dispatch to vision-locked part verification and automated payouts.

---

📋 Table of Contents

• Overview
• Application Preview
• System Features
• Architecture
• Tech Stack
• Project Structure
• Infrastructure & Workflows
• Installation
• Usage
• Configuration
• License

---

🧠 Overview

GearFlow transforms traditional bike maintenance into a fully autonomous digital operation. The platform eliminates human intervention in logistics and verification, ensuring a "zero-trust" environment where every action is verified by AI and logged on-chain (or in a secure ledger).

Key User Flows:

• Customers: Request service via a premium Next.js portal, track mechanics in real-time, and receive AI-generated health reports for their bikes.
• Mechanics: Use an offline-first Expo app to receive jobs, navigate to locations, and verify part replacements using vision-based AI.
• System: n8n acts as the "Central Nervous System," handling fraud detection, automated payouts, and RAG-based technical support for mechanics.

---

🖼️ Application Preview

1) Landing Page

2) Login Page

3) Customer Dashboard

4) Live Tracking

5) AI Assistant

---

🛡️ Admin Dashboard Features

The Admin Dashboard provides real-time oversight of the entire autonomous fleet.

📊 Fleet Overview & Analytics

Real-time metrics, revenue tracking, and active session monitoring.

🗺️ Live Fleet Tracking

Geographic distribution of active mechanics and service requests.

📋 Active Orders & Mechanics

Active Service Orders	Registered Technicians

🛡️ Fraud & Operations Logs

AI-detected anomalies and verification logs.

---

✨ System Features

Feature	Description
🎯 Smart Dispatch	Real-time mechanic allocation based on Geo-proximity, rating, and current load.
👁️ Vision Verification	Multimodal AI validates new vs. old parts via photos to prevent fraud.
📚 RAG Support	Instant technical assistance for mechanics using a RAG pipeline over maintenance manuals.
🛡️ Fraud Detection	Automated n8n workflow monitors patterns and flags suspicious service claims.
💳 Automated Payouts	Weekly cron-based payouts for mechanics via integrated fintech gateways (Razorpay/Cashfree).
📱 Offline-First Mobile	Reliable mechanic app that functions in low-connectivity areas with sync-on-reconnect.

---

🏗️ Architecture

graph TD
    subgraph "Clients"
        A[Next.js Portal] -->|API Requests| B[Express Backend]
        C[Expo Mobile App] -->|API Requests| B
    end

    subgraph "Core Logic"
        B --> D[(PostgreSQL / pgvector)]
        B --> E[n8n Orchestrator]
    end

    subgraph "Automation & AI"
        E --> F[Dispatch Workflow]
        E --> G[RAG Support System]
        E --> H[Fraud Detection]
        E --> I[Payout Cron]
    end

    subgraph "External Services"
        G --> J[Groq / OpenAI]
        I --> K[Payment Gateway]
        F --> L[WhatsApp API]
    end

Loading

---

🛠️ Tech Stack

Layer	Technology
Frontend	Next.js 15+, TailwindCSS 4, Framer Motion
Mobile	React Native (Expo), Moti (Animations), SecureStore
Backend	Node.js, Express 5, JWT Auth, Helmet
Orchestration	n8n (Self-hosted or Cloud)
Database	PostgreSQL + pgvector (Vector Search)
AI / LLM	Groq (Llama 3), OpenAI Vision, LangChain
Infrastructure	Docker, AWS EKS (Proposed)

---

📁 Project Structure

GearFlow/
│
├── admin/                 # Admin Dashboard (React)
├── backend/               # Core Express API
│   ├── src/
│   │   ├── controllers/   # Business logic
│   │   ├── db/            # Migrations & Models
│   │   ├── middleware/    # Auth & Security
│   │   └── routes/        # API Endpoints
│   └── package.json
│
├── frontend/              # Customer Web Portal (Next.js)
│   ├── src/app/           # App Router
│   ├── src/components/    # UI Library
│   └── tailwind.config.ts
│
├── mobile/                # Mechanic Mobile App (Expo)
│   ├── src/               # Reusable logic
│   └── app/               # Expo Router pages
│
├── infra/                 # Infrastructure & Automation
│   └── n8n/               # Workflow JSON exports
│       ├── dispatch.json
│       ├── rag_workflow.json
│       └── payouts_cron.json
│
├── deploy/                # Deployment scripts (Docker/K8s)
└── README.md

---

🤖 Infrastructure & Workflows

The infra/n8n/ directory contains the blueprint of GearFlow's intelligence.

Orchestrated logic for Dispatch, RAG, and Fraud Detection.

1. dispatch_workflow.json: Handles the logic for matching service requests to the best available mechanic.
2. rag_workflow.json: Implements the Retrieval-Augmented Generation pipeline to provide mechanics with repair guides.
3. operations_fraud.json: Analyzes technician photos and logs to detect anomalies.
4. payouts_cron.json: Triggered weekly to calculate and disperse earnings.

---

🚀 Installation

1) Clone the Repository

git clone https://github.com/crastatelvin/GearFlow.git
cd GearFlow

2) Setup Backend

cd backend
npm install
cp .env.example .env
npm run db:init   # Initialize database schema
npm run dev

3) Setup Frontend

cd ../frontend
npm install
npm run dev

4) Setup Mobile (Expo)

cd ../mobile
npm install
npx expo start

---

⚙️ Configuration

Ensure your backend/.env contains:

DATABASE_URL=postgresql://user:pass@localhost:5432/gearflow
JWT_SECRET=your_super_secret_key
N8N_WEBHOOK_URL=http://your-n8n-instance/webhook/...
GROQ_API_KEY=gsk_...
OPENAI_API_KEY=sk-...

---

🔒 Security Notes

• Zero Trust: All mechanic actions require proximity-based GPS verification and visual confirmation.
• JWT Auth: Stateless authentication across Web and Mobile.
• Rate Limiting: Protects the n8n webhooks from excessive automated calls.

---

📜 License

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

Built by Telvin Crasta • Empowering Autonomous Service
⭐ Star this repo if you're building the future of autonomous logistics!