README.md

metadata

title: SETA Inventory Management System
emoji: 📦
colorFrom: blue
colorTo: purple
sdk: gradio
sdk_version: 4.44.0
app_file: app.py
pinned: false
license: mit

SETA Inventory Management System 📦

A comprehensive, modern inventory management system built with Next.js and enhanced with Gradio for advanced analytics and OCR capabilities.

🌟 Features

📊 Core Modules

• Dashboard - Real-time KPIs and business metrics
• Analytics - Interactive charts and business insights
• Inventory Management - Complete product catalog with search and filters
• Customer Management - CRM with customer profiles and order history
• Scanner - Barcode/QR code scanning for quick inventory updates
• Finance Tracking - Revenue, invoices, and financial reports
• Quotations - PDF generation and quote management
• Reports - Downloadable business reports and analytics
• WhatsApp Integration - Customer communication
• Inventory Alerts - Low stock and critical notifications

🔍 Advanced OCR Features

• PaddleOCR Integration - Extract text from product images
• Intelligent Product Recognition - Auto-detect Fusion, Agroking, Jaguar products
• 50+ Attribute Extraction - Complete product data mapping
• Batch Processing - Handle multiple images simultaneously
• Interactive Editing - Review and modify extracted data

☁️ Salesforce Integration

• Multi-Object Support - Sync with all Salesforce objects
• Entry/Exit Tracking - Complete inventory movement logging
• Price Synchronization - Automatic price lookup and updates
• Real-time Sync - Bidirectional data synchronization
• Custom Field Mapping - Flexible attribute configuration

🚀 Technology Stack

Frontend (Next.js)

• Next.js 14 - React framework with App Router
• TypeScript - Type-safe development
• Tailwind CSS - Utility-first styling
• shadcn/ui - Modern component library
• Lucide Icons - Beautiful icon system
• Recharts - Interactive data visualization

Backend (Gradio)

• Gradio 4.44 - Web interface framework
• Pandas - Data manipulation and analysis
• Plotly - Advanced charting and visualization
• PaddleOCR - Optical character recognition
• Salesforce API - CRM integration

🛠️ Quick Start

Gradio Application (This Space)

This Hugging Face Space runs the Gradio version of SETA Inventory with:

• Interactive dashboard with real-time metrics
• Advanced analytics with charts and visualizations
• Product scanning simulation
• Customer management interface
• Inventory alerts and notifications

Simply interact with the interface above to explore all features!

Full Next.js Application

For the complete experience with all features:

1. Clone the repository ```bash git clone cd seta-inventory ```

2. Install dependencies ```bash npm install ```

3. Run development server ```bash npm run dev ```

4. Open in browser ``` http://localhost:3000 ```

📊 Key Features Breakdown

Dashboard

• Real-time inventory metrics
• Customer analytics
• Revenue tracking
• Recent activity feed
• Quick action buttons

Inventory Management

• Product catalog with search/filter
• Stock level monitoring
• Category organization
• Supplier tracking
• Location management
• Batch operations

Scanner Module

• Camera-based scanning
• Manual code entry
• Product lookup
• Stock verification
• Scan history tracking

Customer Management

• Customer profiles
• Order history
• Contact information
• Status tracking (Active/VIP/Inactive)
• Communication logs

Analytics

• Sales trend analysis
• Inventory distribution
• Customer segmentation
• Revenue forecasting
• Performance metrics

🔧 Configuration

Environment Variables

```env

Salesforce Configuration

SALESFORCE_USERNAME=your_username SALESFORCE_PASSWORD=your_password SALESFORCE_SECURITY_TOKEN=your_token SALESFORCE_DOMAIN=your_domain

OCR Configuration

OCR_LANGUAGE=en OCR_CONFIDENCE_THRESHOLD=0.8

Application Settings

APP_ENV=production DEBUG_MODE=false ```

Customization

• Modify inventory_data in app.py for your products
• Update customers_data for your customer base
• Customize themes and styling
• Add new modules and features

📱 Mobile Responsiveness

The system is fully responsive and optimized for:

• Desktop - Full feature access
• Tablet - Touch-optimized interface
• Mobile - Essential features for field use
• Scanner - Camera integration for mobile scanning

🔒 Security Features

• Input validation - Prevent malicious data entry
• Error handling - Graceful error management
• Data sanitization - Clean user inputs
• Access control - Role-based permissions (planned)
• Audit logging - Track all system changes

📈 Performance

• Fast loading - Optimized components and lazy loading
• Efficient queries - Minimal data fetching
• Caching - Smart data caching strategies
• Responsive UI - Smooth interactions and animations

🤝 Contributing

1. Fork the repository
2. Create feature branch (git checkout -b feature/amazing-feature)
3. Commit changes (git commit -m 'Add amazing feature')
4. Push to branch (git push origin feature/amazing-feature)
5. Open Pull Request

📞 Support

• Documentation - Comprehensive inline documentation
• Issues - GitHub issue tracker
• Community - Hugging Face community discussions
• Email - support@seta-inventory.com

📄 License

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

🙏 Acknowledgments

• Next.js Team - Amazing React framework
• shadcn/ui - Beautiful component library
• Gradio Team - Excellent ML web framework
• PaddleOCR - Powerful OCR capabilities
• Salesforce - Robust CRM platform
• Hugging Face - Outstanding hosting platform

---

Built with ❤️ for modern businesses

Professional inventory management with AI-powered automation

🔄 Version History

• v2.0 - Complete OCR and Salesforce integration
• v1.5 - Enhanced analytics and mobile optimization
• v1.0 - Initial release with core inventory features

🎯 Roadmap

• Mobile App - Native iOS/Android applications
• API Gateway - RESTful API for third-party integrations
• Advanced AI - Predictive analytics and demand forecasting
• Multi-tenant - Support for multiple organizations
• Blockchain - Supply chain transparency and tracking

Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference