Skip to content

Latest commit

ย 

History

15 Commits

Folders and files

NameName
Last commit message
Last commit date
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿง  ReconAI - Agentic Document Intelligence Platform

Transform your logistics reconciliation with AI-powered 3-way document matching

Next.js FastAPI TypeScript TailwindCSS


๐Ÿš€ Overview

ReconAI is an enterprise-grade, AI-powered document reconciliation platform designed specifically for logistics operations. It automates the tedious and error-prone process of matching Lorry Receipts (LR), Proof of Delivery (POD), and Tax Invoices using advanced machine learning and intelligent document extraction algorithms.

๐Ÿ’ก The Problem We Solve

In traditional logistics operations, reconciling thousands of documents across multiple sources is:

  • โฐ Time-consuming: Manual verification takes hours per batch
  • โŒ Error-prone: Human oversight leads to costly discrepancies
  • ๐Ÿ“Š Difficult to track: No centralized visibility into audit status
  • ๐Ÿ” Hard to analyze: Missing insights on vendor performance and risk patterns

โœจ Our Solution

ReconAI leverages Agentic AI to automatically extract, match, and reconcile documents with unprecedented accuracy, providing real-time insights and automated risk assessment for logistics operations.


๐ŸŽฏ Key Features

๐Ÿค– Intelligent Document Processing

  • AI-Powered Extraction: Automatically extracts key data points from PDFs (LR Number, Invoice Amount, Dates, Quantities, etc.)
  • Multi-Format Support: Handles various document formats and layouts seamlessly
  • Smart Field Mapping: Intelligently maps fields across different document types

๐Ÿ”„ 3-Way Reconciliation Engine

  • Automated Matching: Matches Lorry Receipt, POD, and Invoice in real-time
  • Discrepancy Detection: Identifies mismatches in amounts, quantities, dates, and other critical fields
  • Confidence Scoring: Provides match confidence percentages for each reconciliation

๐Ÿ“Š Advanced Analytics Dashboard

  • Real-Time KPIs: Track Total Audits, Match Rates, Processing Time, and Risk Scores
  • Visual Insights: Interactive charts for status distribution, vendor performance, and risk breakdown
  • Trend Analysis: Monitor reconciliation patterns over time with animated counters

โšก Risk Intelligence

  • Automated Risk Scoring: ML-powered risk assessment for each audit (Low, Medium, High, Critical)
  • Risk Factor Analysis: Identifies specific risk contributors (amount variance, date discrepancies, etc.)
  • Proactive Alerting: Flags high-risk audits for immediate attention

๐ŸŽจ Premium User Experience

  • Modern UI/UX: Sleek, gradient-rich interface with smooth animations
  • Dark/Light Mode: Fully themed with seamless mode switching
  • Responsive Design: Optimized for desktop, tablet, and mobile devices
  • Real-Time Updates: Live processing animations and status updates

๐Ÿ”„ User Flow

1๏ธโƒฃ Upload Documents

Users navigate to the "New Audit" page and upload three documents:

  • ๐Ÿ“„ Lorry Receipt (LR)
  • โœ… Proof of Delivery (POD)
  • ๐Ÿงพ Tax Invoice

Drag-and-drop interface with live upload progress and file validation.

2๏ธโƒฃ AI Extraction & Processing

The backend AI agents automatically:

  • Extract structured data from each document
  • Validate data integrity and completeness
  • Prepare documents for reconciliation

Real-time processing animation keeps users informed of progress.

3๏ธโƒฃ Automated Reconciliation

The reconciliation engine performs:

  • 3-way matching across all documents
  • Field-level comparison for amounts, quantities, dates, and IDs
  • Discrepancy identification with detailed explanations
  • Risk scoring based on ML models

4๏ธโƒฃ Review Results

Users can:

  • View comprehensive dashboard with all audit metrics
  • Drill into individual audits to see detailed 3-way comparison
  • Analyze discrepancies with visual indicators
  • Review risk scores and contributing factors
  • Track resolution status and timeline

5๏ธโƒฃ Analytics & Insights

Access powerful analytics:

  • Vendor performance metrics
  • Historical trend analysis
  • Risk pattern identification
  • Export capabilities for reporting

๐Ÿ› ๏ธ Technology Stack

Frontend (This Repository)

  • Framework: Next.js 16.1 with App Router
  • Language: TypeScript 5.0
  • Styling: TailwindCSS 3.4 with custom design system
  • State Management: Zustand 5.0
  • Data Fetching: TanStack Query (React Query) 5.90
  • UI Components: Radix UI primitives with custom styling
  • Animations: Framer Motion 12.35
  • Charts: Recharts 3.8
  • Icons: Lucide React

Backend

  • Framework: FastAPI 1.0
  • Language: Python 3.x
  • Document Processing: AI/ML extraction services
  • Database: PostgreSQL with SQLAlchemy ORM
  • API Architecture: RESTful with automatic OpenAPI documentation

Features

  • ๐Ÿ”’ CORS-enabled secure API communication
  • ๐ŸŽจ Theme persistence with next-themes
  • ๐Ÿ“ฑ Fully responsive design
  • โ™ฟ Accessibility-first component library
  • ๐Ÿš€ Optimized performance with code splitting
  • ๐Ÿ’พ Efficient state management with Zustand

๐Ÿ“ฆ Installation & Setup

Prerequisites

  • Node.js 20+ and npm
  • Python 3.9+
  • pip

Frontend Setup

  1. Navigate to frontend directory
cd frontend
  1. Install dependencies
npm install
  1. Run development server
npm run dev
  1. Open your browser
http://localhost:3000

Backend Setup

  1. Navigate to backend directory
cd backend
  1. Install Python dependencies
pip install -r requirements.txt
  1. Run the API server
uvicorn main:app --reload
  1. API will be available at
http://localhost:8000
  1. View API documentation
http://localhost:8000/docs

๐ŸŽจ Key Functionalities

Dashboard

  • Real-time KPI Cards: Animated counters showing metrics like Total Audits, Match Rate, Avg Processing Time
  • Status Distribution: Pie chart visualization of audit statuses (Matched, Partial, Discrepancy, Pending)
  • Recent Audits Table: Quick access to latest reconciliations with status badges
  • Risk Breakdown: Visual representation of risk distribution across audits
  • Vendor Performance: Compare performance metrics across different vendors

Upload Interface

  • Multi-file Drop Zones: Three dedicated zones for LR, POD, and Invoice
  • Drag & Drop Support: Intuitive file upload with visual feedback
  • File Validation: Automatic format and size validation
  • Processing Animation: Engaging visual feedback during AI extraction
  • Demo Mode: Sample documents available for testing

Reconciliation Detail View

  • 3-Way Comparison Table: Side-by-side view of all three documents
  • Field-Level Matching: Visual indicators (โœ“ match, โš  discrepancy) for each field
  • Discrepancy Timeline: Track when and how discrepancies were identified
  • Risk Score Gauge: Visual representation of audit risk level
  • Risk Factor Cards: Detailed breakdown of risk contributors

Analytics

  • Trend Analysis: Historical view of reconciliation metrics
  • Vendor Insights: Performance comparison and ranking
  • Risk Patterns: Identify common discrepancy patterns
  • Export Capabilities: Download reports for external analysis

๐ŸŒŸ Design Highlights

  • Gradient-Rich UI: Modern aesthetic with purple-indigo-pink gradients throughout
  • Micro-interactions: Smooth hover effects, scale animations, and transitions
  • Glass-morphism: Backdrop blur effects for depth and sophistication
  • Consistent Spacing: 8px grid system for visual harmony
  • Accessible Colors: WCAG-compliant color contrast ratios
  • Responsive Typography: Fluid font sizes that adapt to screen size

๐Ÿš€ Performance Optimizations

  • โšก Code Splitting: Automatic route-based code splitting with Next.js
  • ๐Ÿ–ผ๏ธ Image Optimization: Next.js Image component for optimal loading
  • ๐Ÿ“ฆ Tree Shaking: Eliminates unused code in production builds
  • ๐ŸŽฏ React Query: Intelligent caching and background refetching
  • ๐Ÿ’จ Lazy Loading: Components loaded on-demand for faster initial load

๐Ÿ”ฎ Future Enhancements

  • ๐ŸŒ Multi-language Support: Internationalization for global deployment
  • ๐Ÿ”” Real-time Notifications: WebSocket integration for live updates
  • ๐Ÿ“ง Email Integration: Automated alerts for high-risk audits
  • ๐Ÿค Collaborative Features: Multi-user audit review and approval workflows
  • ๐Ÿ“ฑ Mobile App: Native iOS/Android applications
  • ๐Ÿ”— ERP Integration: Connect with SAP, Oracle, and other enterprise systems

๐Ÿ“„ License

This project is proprietary software developed for the Lorri Hackathon.


๐Ÿ‘ฅ Contributing

This is a hackathon project. For any inquiries or collaboration opportunities, please contact the development team.


Built with โค๏ธ using Next.js, FastAPI, and cutting-edge AI technology

Revolutionizing logistics reconciliation, one document at a time

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages