Enterprise-grade 3D load planning and optimization system
LoadOpt is a production-ready web application for optimizing container and truck loading with advanced multi-stop route planning, 3D visualization, and intelligent packing algorithms.
- 3D Load Planning - Intelligent bin packing algorithms for container optimization
- Multi-Stop Route Optimization - Advanced planning for delivery routes with multiple stops
- 3D Visualization - Interactive 3D viewer using Three.js/React Three Fiber
- Real-time Optimization - Background processing with Celery task queue
- SKU Management - Comprehensive product/package management
- Delivery Group Management - Organize items by delivery location and priority
- Comprehensive Logging - Structured logging with file rotation
- Health Monitoring - Database connectivity and service health checks
- Environment Validation - Startup validation of all configuration
- Global Error Handling - Graceful error handling with tracking
- JWT Authentication - Secure user authentication and authorization
- Request Timing - Performance monitoring on all endpoints
# Clone and start
git clone <your-repo-url>
cd loadopt
docker-compose up -d
# Access:
# Frontend: http://localhost:3000
# Backend: http://localhost:8000
# API Docs: http://localhost:8000/docs# Backend
cd backend
python -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
pip install -r requirements.txt
uvicorn app.main:app --reload
# Frontend (new terminal)
cd frontend
npm install
npm run dev📖 Complete setup: See DEPLOYMENT_GUIDE.md
| Document | Description |
|---|---|
| DEPLOYMENT_GUIDE.md | START HERE - Complete step-by-step setup |
| PRODUCTION_READY.md | Production deployment checklist |
| REVIEW_SUMMARY.md | Code review summary |
Backend: FastAPI • SQLAlchemy • PostgreSQL • Redis • Celery • JWT
Frontend: React • TypeScript • Vite • React Three Fiber • Tailwind CSS
Infrastructure: Docker • Docker Compose • Nginx
Create backend/.env:
ENVIRONMENT=development
DATABASE_URL=postgresql://user:pass@localhost:5432/loadopt
REDIS_URL=redis://localhost:6379/0
SECRET_KEY=<generate-secure-32-char-key>Generate SECRET_KEY:
python -c "import secrets; print(secrets.token_urlsafe(32))"POST /api/v1/auth/signup- Create userPOST /api/v1/auth/login- LoginGET /api/v1/projects/- List projectsPOST /api/v1/plans/- Create optimization planGET /health- Health check
Full API docs: http://localhost:8000/docs
# Check health
curl http://localhost:8000/health
# View logs
docker-compose logs backend
# Restart services
docker-compose restartSee DEPLOYMENT_GUIDE.md for more help.
- 📖 Documentation: DEPLOYMENT_GUIDE.md
- 🚀 Quick Start: See above
- 🐛 Issues: GitHub Issues
Built with ❤️ for logistics optimization