Community Interest Company - Enabling communities to grow and distribute quality food through technology.

A comprehensive farm delivery management system built with Laravel, designed for Community Supported Agriculture (CSA) programs, farmers' markets, and local food distribution networks.

• User authentication and role-based permissions
• Dashboard with real-time analytics
• Customer and order management
• Delivery route optimization
• Automated reporting and analytics

• Multi-site backup orchestration
• Disaster recovery tools
• Command-line restoration utilities
• Scheduled backups with timezone support
• Comprehensive backup monitoring

• Seamless data synchronization
• Crop planning and harvest tracking
• Farm data analytics
• API-driven integration

• Route planning and optimization
• Real-time delivery tracking
• Customer notification system
• Delivery scheduling and coordination

• Comprehensive database design
• Data export and reporting
• Backup and recovery systems
• Performance monitoring

• PHP 8.2+
• Composer
• Node.js & NPM
• MySQL/PostgreSQL
• Redis (optional)

1. Clone the repository

   git clone https://github.com/middleworldfarms/farm-delivery-system.git
   cd farm-delivery-system

2. Install PHP dependencies

   composer install

3. Install Node dependencies

   npm install

4. Environment setup

   cp .env.example .env
   php artisan key:generate

5. Database setup

   php artisan migrate
   php artisan db:seed

6. Build assets

   npm run build

7. Start the application

   php artisan serve

• Installation Guide
• Configuration
• API Documentation
• Backup & Recovery
• Contributing

• Backend: Laravel 11 (PHP)
• Frontend: Blade templates, Tailwind CSS
• Database: MySQL/PostgreSQL
• Cache: Redis
• Backup: Spatie Laravel Backup
• Testing: PHPUnit

• UnifiedBackupService: Multi-site backup orchestration
• DeliveryController: Delivery management
• FarmOsService: FarmOS API integration
• Admin Dashboard: Comprehensive admin interface

This system was built by and for community food systems. Our mission is to:

• Democratize food systems through accessible technology
• Support local farmers with efficient distribution tools
• Enable community ownership of food supply chains
• Promote sustainable agriculture through data-driven insights

We welcome contributions from developers, farmers, and community organizers!

• 🐛 Bug Reports: Use GitHub issues
• 💡 Feature Requests: Community-driven development
• 📖 Documentation: Help improve guides
• 🧪 Testing: Add test cases
• 🌍 Localization: Support multiple languages

# Fork and clone
git clone https://github.com/your-username/farm-delivery-system.git

# Create feature branch
git checkout -b feature/amazing-feature

# Make changes and test
# Submit pull request

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.

Why GPL v3?

• Ensures derivative works remain open source
• Protects community ownership
• Prevents commercial exploitation
• Aligns with our not-for-profit mission

• Laravel Community for the amazing framework
• Spatie for backup and media libraries
• FarmOS for agricultural data standards
• Open Source Community for inspiration and tools

• 📧 Email: [email protected]
• 🐛 Issues: GitHub Issues
• 📖 Discussions: GitHub Discussions

"To enable more folks to grow quality food through community-powered technology."

Built with ❤️ by Middle World Farms CIC

Supporting local food systems, one line of code at a time.