Skip to content

techwithkishan/DriveLegal

Repository files navigation

๐Ÿš˜ DRIVOS: AI-Powered Traffic Compliance & Challan Intelligence System

Category Tech Stack Localization AI Features

๐ŸŒŸ Overview

DRIVOS is a full-stack, state-of-the-art AI-powered Traffic Compliance & Challan Intelligence System designed to bridge the gap between complex legal traffic regulations and everyday citizens.

๐Ÿ–ฅ๏ธ Live Web Application: https://drive-legal-seven.vercel.app

Traffic violation laws and challan management remain fragmented, opaque, and confusing. DRIVOS empowers vehicle owners with real-time AI legal explanations, localized language interfaces, active document audits, cross-border rule warnings, and interactive simulation tools while providing traffic authorities with comprehensive governance analytics.


๐Ÿš€ Core Features

1. ๐ŸŒ Dynamic 22 Constitutional Language Switcher

  • Constitutional Parity: Built-in support for all 22 official Indian languages recognized in the Eighth Schedule of the Constitution (Hindi, Gujarati, Telugu, Tamil, Marathi, Bengali, Sanskrit, Kannada, Punjabi, Urdu, etc.).
  • Instant Client-Side Translation: Powered by a robust, reactive context translation dictionary (t()) that instantly translates all greetings, quick stats, compliance guides, and menu options without page reloads.
  • Persistent Preferences: Automatically remembers user language preferences across sessions using secure localStorage persistence.

2. ๐Ÿ—บ๏ธ Fully Interactive Guided Onboarding Tour

  • Dynamic Orientation: Displays a premium welcome onboarding popup for first-time registrants and logins, prompting a guided interactive tour.
  • Interactive Tooltips: Guides the user step-by-step through 10 key dashboard features and icons with automatic smooth scrolling, high-fidelity pulse highlight animations (ring-4 ring-amber-500 glow-amber), and dynamic tooltip descriptions.
  • Confetti Completion: Celebrates the successful completion of the onboarding tour with a custom CSS/DOM-particle particle confetti explosion.
  • Full Multi-lingual Sync: Tooltips, step headers, and control buttons dynamically translate to the user's selected language in real time.

3. ๐Ÿ›ก๏ธ Civic Compliance Score Meter

  • Real-time Rating: A dynamic 0 to 100 Safe Driving Index. Serious unpaid infractions lower the score, while safe driving patterns, lack of active tickets, and prompt payments restore it.
  • Visual Gauge: Beautifully animated SVG ring gauge colored dynamically based on rating (Emerald for Good, Amber for Moderate, Red for Critical).

4. ๐Ÿงฎ Challan Compliance Calculator

  • Act & Rules Dictionary: Instantly lookup exact fine amounts, applicable legal sections under the Motor Vehicles Act, and legal consequences of non-payment.
  • Global Scaling: Supports RTO guidelines across India and 6 major global countries (USA, UAE, UK, Germany, Australia) with integrated currency conversions.

5. ๐Ÿค– AI Driving Advisor & Insights

  • Personalized Reports: Evaluates driving history to generate a detailed safety feedback report card.
  • Actionable Planning: Formulates structured 30-60-90 day performance improvement roadmaps to guide drivers toward safer behaviors.

6. ๐Ÿ“ธ OCR Challan Ticket Scanner

  • Document Digitization: Simulates AI optical character recognition (OCR) to parse physical paper challans.
  • Auto-Extraction: Instantly extracts ticket numbers, vehicle details, violation codes, and RTO fine amounts from simple camera/image uploads.

7. ๐Ÿ“‹ Pre-Drive Compliance Audit

  • Proactive Document Check: Prevents penalty traps by running automated audit checks on vehicle documents, including PUC (Pollution Under Control) certificate, insurance policies, and driving licenses.
  • Smart Reminders: Alerts users ahead of document expirations to secure renewals before driving.

8. โš ๏ธ Active Enforcement Zone Alerts

  • Safety Warning System: Detects nearby active enforcement cameras, speed traps, speed limits, and high-accident zones.
  • Prevention Warnings: Pattern recognition system alerts users to speed cameras on their route to prevent automated speed-challan penalties.

9. โš–๏ธ AI Scenario Simulator

  • Compound Fine Sandbox: Interactive playground showing users how driving violations compound financially over time if left unresolved.
  • Legal Courtroom Defense: Prepares drivers with legal arguments, dispute letters, and rights representation guidelines.

10. ๐Ÿ“Š RTO Governance Mode (Admin Dashboard)

  • Authority Dashboard: Shift to "Governance Mode" to view repeat offender directories, district-wise compliance analytics, speed camera audits, and regional revenue maps.

๐Ÿ› ๏ธ Tech Stack & Architecture

Frontend & Framework

  • React 18 (Vite-powered for lightning-fast HMR and bundling)
  • Tailwind CSS (Custom theme configuration, glassmorphism UI utilities, dark/light modes)
  • Lucide React (Vector iconography)

State & Context

  • AppStateContext: Manages user authentication, garage vehicles, active tickets, offline emulation, and simulated location coordinates.
  • GlobalContext: Drives localization state, the 22-language translation engine, and visual transition overlays.

๐Ÿ“ฆ Core Directories

drivos/
โ”œโ”€โ”€ src/
โ”‚   โ”œโ”€โ”€ components/       # Reusable UI widgets (Header, TopBar, BottomNav, ThemeToggle, etc.)
โ”‚   โ”œโ”€โ”€ context/          # State managers (AppStateContext, GlobalContext)
โ”‚   โ”œโ”€โ”€ data/             # Static datasets (Translations DB, global rules, RTO matrices)
โ”‚   โ”œโ”€โ”€ screens/          # Core views (Dashboard, AI Advisor, Scenario Simulator, Admin, etc.)
โ”‚   โ”œโ”€โ”€ App.jsx           # Main routing and screen coordinator
โ”‚   โ”œโ”€โ”€ index.css         # Custom utility styles, animation keyframes, and base theme tokens
โ”‚   โ””โ”€โ”€ main.jsx          # App entrypoint
โ”œโ”€โ”€ public/               # Static assets & icons
โ”œโ”€โ”€ tailwind.config.js    # Premium Tailwind typography and custom color configurations
โ””โ”€โ”€ package.json          # Package dependencies

๐Ÿ Quick Start & Local Setup

Prerequisites

Make sure you have Node.js installed.

1. Clone & Install Dependencies

# Navigate to project directory
cd drivos

# Install npm packages
npm install

2. Launch Development Server

npm run dev

Open the local address http://localhost:5173 in your browser or explore the live production deployment at https://drive-legal-seven.vercel.app to experience the application!

3. Production Build

npm run build

๐Ÿ† Development Team

  • Team Name: Team Achievers
  • Institution: Baderia Global Institute of Engineering and Management, Jabalpur
  • Project Context: Civic-Tech / Legal-Tech AI Application Portfolio

Drive Safe. Comply Legally. Powered by DRIVOS.

About

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages