A comprehensive, enterprise-grade business management system designed specifically for fruit and vegetable businesses with multiple branches. Built with Laravel 12 and modern web technologies.
- Multi-role user management (Admin, Branch Manager, Cashier, Delivery Boy)
- Role-based access control (RBAC)
- Secure API authentication with Laravel Sanctum
- Session-based web authentication
- Independent inventory per branch
- Branch-specific pricing strategies
- Branch-specific stock thresholds
- Online availability control per branch
- Real-time stock tracking
- Batch-wise inventory management
- Weight loss tracking (fresh produce)
- Water loss tracking (vegetables)
- Wastage tracking and analysis
- Complimentary/adjustment tracking
- Automatic "Sold Out" status
- Low stock alerts
- Online Orders - Website/app integration
- On-Shop Orders - Walk-in customer billing
- Wholesale Orders - Bulk purchase management
- Delivery Tracking - Real-time delivery status
- Return Management - Customer returns and refunds
- Customer Adjustments - Weight/price adjustments
- Delivery boy assignment and tracking
- Real-time delivery status updates
- Return processing and approval
- Customer adjustment handling
- Mobile app integration ready
- Expense tracking and categorization
- Payment management (Cash, UPI, Card, Credit)
- Credit management with customers and vendors
- GST integration and tax calculation
- Profit margin analysis
- Financial reporting
- Sales analytics and trends
- Inventory performance metrics
- Customer behavior analysis
- Vendor performance tracking
- Profit & Loss statements
- Growth opportunity insights
- RESTful API with comprehensive endpoints
- Modern web interface with responsive design
- Real-time notifications and alerts
- Data export (CSV, PDF, Excel)
- Backup and recovery systems
- Performance monitoring
- PHP 8.2+
- Composer
- MySQL/PostgreSQL/SQLite
- Node.js & NPM
# Clone the repository
git clone <repository-url>
cd fruit-vegetable-business-system
# Install dependencies
composer install
npm install
# Environment setup
cp .env.example .env
php artisan key:generate
# Configure database in .env file
# Run migrations and seed data
php artisan migrate
php artisan db:seed
# Build assets
npm run build
# Start the application
php artisan serve- Email: admin@example.com
- Password: password
- System Documentation - Comprehensive system overview
- Quick Setup Guide - Get up and running quickly
- API Documentation - Complete API endpoint reference
- Web Routes - Web interface routes
- Backend: Laravel 12 (PHP 8.2+)
- Database: MySQL/PostgreSQL/SQLite
- Authentication: Laravel Sanctum
- Frontend: Blade templates + modern CSS/JS
- API: RESTful with role-based access control
app/
├── Models/ # Eloquent models with relationships
├── Http/
│ ├── Controllers/ # Business logic controllers
│ └── Middleware/ # Authentication & authorization
├── Database/
│ ├── Migrations/ # Database schema
│ └── Seeders/ # Initial data
└── Resources/
└── Views/ # Web interface templates
routes/
├── api.php # API endpoints
└── web.php # Web interface routes
POST /api/login- User authenticationPOST /api/logout- User logoutGET /api/profile- User profile
GET /api/products- List productsPOST /api/products- Create productGET /api/inventory- Inventory statusPOST /api/inventory/add-stock- Add stock
GET /api/orders- List ordersPOST /api/orders- Create orderGET /api/orders/statistics- Sales statistics
GET /api/customers- Customer managementGET /api/vendors- Vendor managementGET /api/purchase-orders- Purchase orders
GET /api/reports/sales- Sales reportsGET /api/reports/inventory- Inventory reportsGET /api/reports/profit-loss- Financial reports
- Multi-branch management with centralized control
- Real-time business insights and performance metrics
- Financial tracking and profit analysis
- Growth opportunities identification
- Inventory optimization and stock management
- Customer relationship management
- Vendor performance tracking
- Branch-specific reporting and analytics
- Quick billing and order processing
- Customer service and adjustments
- Payment processing (Cash, UPI, Card, Credit)
- Sales tracking and reporting
- Order delivery tracking and management
- Return processing and customer adjustments
- Mobile app integration for field operations
- Real-time updates and notifications
- Role-based access control (RBAC)
- API authentication with tokens
- Input validation and sanitization
- SQL injection prevention
- XSS protection
- CSRF protection
- Rate limiting
The system is designed with mobile-first approach:
- Responsive web interface for all devices
- API endpoints ready for mobile app integration
- Delivery boy mobile app integration points
- Customer mobile app ready architecture
- Streamlined Operations - Automate manual processes
- Real-time Insights - Make data-driven decisions
- Multi-branch Support - Scale your business efficiently
- Inventory Optimization - Reduce waste and improve margins
- Customer Satisfaction - Better service and tracking
- Financial Control - Monitor costs and profitability
- Compliance Ready - GST integration and reporting
We welcome contributions! Please see our contributing guidelines for details.
This project is licensed under the MIT License - see the LICENSE file for details.
- Documentation: Check the documentation files
- Issues: Report bugs and feature requests
- Community: Join our community discussions
- Advanced analytics dashboard
- Machine learning insights
- Predictive analytics
- Customer loyalty program
- Advanced reporting
- Mobile applications
- API marketplace
- Multi-currency support
- Advanced inventory forecasting
- Supplier portal
Built with ❤️ for the fruit and vegetable business community
Transform your fruit and vegetable business with enterprise-grade management tools designed specifically for your industry needs.