smewebify

WebErpMesv2

# ΣEM - The ERP/MES Dedicated to Sheet Metal & Industrial Mechanics 🏭 <p align="center"> <a href="https://github.com/SMEWebify/WebErpMesv2/blob/WEM-2.0/README.md">English</a> • <a href="https://github.com/SMEWebify/WebErpMesv2/blob/WEM-2.0/docs/README.fr.md">Français</a> </p> <p align="center"> <a href="https://github.com/SMEWebify/WebErpMesv2/stargazers"><img src="https://img.shields.io/github/stars/SMEWebify/WebErpMesv2?style=social" alt="Stars"></a> <a href="https://github.com/SMEWebify/WebErpMesv2/network/members"><img src="https://img.shields.io/github/forks/SMEWebify/WebErpMesv2?style=social" alt="Forks"></a> <a href="https://github.com/SMEWebify/WebErpMesv2/issues"><img src="https://img.shields.io/github/issues/SMEWebify/WebErpMesv2" alt="Issues"></a> <a href="https://github.com/SMEWebify/WebErpMesv2/blob/WEM-2.0/LICENSE"><img src="https://img.shields.io/github/license/SMEWebify/WebErpMesv2" alt="License"></a> <a href="https://github.com/SMEWebify/WebErpMesv2"><img src="https://img.shields.io/github/downloads/SMEWebify/WebErpMesv2/total" alt="License"></a> </p> <img width="1904" height="952" alt="image" src="https://github.com/user-attachments/assets/90853ec1-59dd-4a9c-9d90-3477103fa8cc" /> ## 🎯 Why ΣEM for your workshop? Designed **by sheet metal and mechanical professionals, for professionals**, ΣEM answers the specific challenges of your trade: ### 🔧 Your activity - **Industrial sheet metal**: bending, laser/plasma cutting, punching, welding - **Precision mechanics**: turning, milling, grinding - **Mold manufacturing**: design, machining, fitting - **Industrial subcontracting**: multi-customer management, varied series ### 💡 Your day-to-day problems solved | Problem | ΣEM Solution | |----------|-------------| | 📋 **Complex quotes** with many operations | Detailed BOMs, machining routings, automatic time/cost calculation | | ⏱️ **Real-time production tracking** not possible | Live dashboard, shop-floor time tracking, progress by work order | | 📦 **Raw material management** (sheets, bars, tubes) | Stock by dimensions, material traceability, replenishment alerts | | 🔄 **Chaotic shop planning** | Visual planning per machine, priority management, machine load | | 📊 **Unclear project profitability** | Actual vs. forecast cost tracking, margin analysis per order | | 🚚 **Limited customer/supplier traceability** | Full history, attached documents, technical notes | ## ✨ Specialized business features ### 🏭 Production Module (MES) - **Machining routings**: define operations (cutting, bending, welding, machining...) - **Bills of Materials (BOM)**: raw materials, components, sub-assemblies - **Shop planning**: visualize load per machine/work center - **Work orders**: automatic generation from quotes - **Production time tracking**: real-time tracking by operation - **Quality control**: control sheets, non-conformities ### 📋 Sales Management - **Detailed quotes**: multiple lines, options, variants - **Cost calculation**: material + labor + subcontracting - **Opportunity tracking**: from lead to delivery - **Multi-currency** and multi-language support - **Customer history**: all orders at a glance ### 📦 Inventory & Procurement - **Dimension-based management**: Sheet 2000x1000x3mm, Tube Ø50x3... - **Material traceability**: heat numbers, material certificates - **Stock movements**: receipts, issues, transfers, inventories - **Alerts**: minimum thresholds, automatic replenishment - **Suppliers**: pricing, lead times, evaluation ### 💰 Accounting & Invoicing - **Invoicing**: deposits, progress billing, credit notes - **VAT**: multi-rate management, declarations - **Payments**: settlement tracking, reminders - **Analytics**: profitability by project, customer, period ## 💼 Industry use cases ### Example 1: Fine sheet metal workshop **Context**: 15 people, bending + laser cutting + welding **ΣEM usage**: - Quotes with detailed routings (laser → deburring → bending → welding) - Planning across 3 press brakes and 2 lasers - Sheet stock management by format and thickness - Real-time tracking of work orders in progress **Result**: +30% planning productivity, -20% dormant stock ### Example 2: Precision mechanics **Context**: Automotive subcontracting, medium series **ΣEM usage**: - BOMs with certified raw materials - Machining routings (turning → milling → heat treatment → grinding) - Integrated quality control (inspection sheets per work order) - Full traceability from material to finished part **Result**: ISO 9001 compliance, perfect traceability ### Example 3: Mold manufacturer **Context**: Plastic injection molds, complex projects **ΣEM usage**: - Multi-phase quotes (study, roughing, finishing, trials) - Subcontracting management (heat treatments, polishing) - Real-time project profitability tracking - Centralized technical documentation **Result**: Better cost control, on-time delivery ## 🎬 See ΣEM in action ### 📺 Online demo **[Try the demo](http://demo.wem-project.org)** - **Email**: [email protected] - **Password**: password ### 🎥 Presentation video https://github.com/user-attachments/assets/200e1322-ae60-4270-aa9c-0a28e5ca737a <img width="1877" height="831" alt="image" src="https://github.com/user-attachments/assets/21b92345-46ad-4af2-9f3a-b38d601eb091" /> ### Installation ## 🚀 Quick installation ### Option 1: Docker (Recommended) 🐳 Start in **3 minutes**: ```bash git clone https://github.com/SMEWebify/WebErpMesv2.git cd WebErpMesv2 docker compose up --build ``` ➡️ Access http://localhost:45060 ### Option 2: Local installation 💻 ```bash # Clone and configure git clone https://github.com/SMEWebify/WebErpMesv2.git cd WebErpMesv2 cp .env.example .env # Install dependencies composer install npm install # Configure the application php artisan key:generate php artisan migrate --seed # Run npm run dev php artisan serve ``` ➡️ Access http://localhost:8000 > 📚 **Detailed guides**: > - [Development setup](https://github.com/SMEWebify/WebErpMesv2/wiki/Installation-Steps-(for-dev)) > - [Production deployment](https://github.com/SMEWebify/WebErpMesv2/wiki/Installation-Steps-(for-production)) ### ⚙️ Post-Installation Configuration **Important**: Before adding lines to a quote, configure: 1. **Default VAT**: Go to **Accounting → VAT** and mark an item as default 2. **Default Unit**: Go to **Methods → Units** and mark an item as default Without these settings, you cannot add lines to quotes. <img width="1903" height="947" alt="image" src="https://github.com/user-attachments/assets/8a51c3da-1dc8-4c55-91dc-f86a23f4b9d8" /> ## 🏗️ Technical architecture ### Modern technology stack ``` WebErpMesv2/ ├── app/ │ ├── Http/Controllers/ # API and web controllers (quotes, production, CRM) │ └── Models/ # Business entities (orders, products, stocks) ├── database/ │ └── migrations/ # Database schemas (BOMs, routings, stock movements) ├── resources/ │ ├── js/ # React components │ └── views/ # Blade templates ├── tests/ # Test suite └── docker/ # Docker configuration ``` **Key Technologies**: - **Backend**: Laravel 12, PHP 8.2 - **Frontend**: Blade + Livewire (CRUD), React (rich components), Alpine.js (micro-interactions) - **CSS**: Bootstrap 4 / AdminLTE - **Database**: MySQL/PostgreSQL - **Cache**: Redis - **DevOps**: Docker, Nginx ### 🧪 Tests Run the complete test suite: ```bash php artisan test ``` Run specific tests: ```bash php artisan test --filter TestName ``` ## 🛠️ Custom Artisan Commands (Specific Artisan Commands) These commands are defined in this repository and complement the default Laravel tooling. | Command | Description | Example | | --- | --- | --- | | `php artisan wem:diagnostics` | Check common local setup requirements (PHP version, extensions, app key, cache/storage permissions, Redis, DB, broadcasting). | `php artisan wem:diagnostics` | | `php artisan wem:n2p:push-order {orderId} {--sync}` | Push a specific order to Nest2Prod (sync option bypasses the queue). | `php artisan wem:n2p:push-order 123 --sync` | | `php artisan quality:dispatch-calibration-alerts` | Notify responsible users when quality control device calibration is due or overdue. | `php artisan quality:dispatch-calibration-alerts` | | `php artisan emails:send-auto-reports` | Send scheduled automatic email reports based on user preferences. | `php artisan emails:send-auto-reports` | | `php artisan ldap:import-users` | Import LDAP users into the Laravel database. | `php artisan ldap:import-users` | ## 🤝 Contribute to the project ΣEM is **open source**! Your domain expertise is valuable. ### 🌟 How to help? **Developers**: - Fix bugs → [`good first issue`](https://github.com/SMEWebify/WebErpMesv2/labels/good%20first%20issue) - Add features → see [Roadmap](ROADMAP.md) - Improve documentation → [Contributing Guide](CONTRIBUTING.md) **Industry professionals**: - Test and provide feedback - Propose domain improvements - Share your use cases - Translate the interface ### Development Workflow ```bash # Fork the repository and clone it git clone https://github.com/YOUR_USERNAME/WebErpMesv2.git # Create a feature branch git checkout -b feature/amazing-feature # Make your changes and commit git commit -m "Add amazing feature" # Push and create a Pull Request git push origin feature/amazing-feature ``` ## 👥 Contributors Thanks to everyone who keeps this project alive! <table> <tr> <td align="center"> <a href="https://github.com/SMEWebify"> <img src="https://github.com/SMEWebify.png" width="100px;" alt="SMEWebify"/> <br /> _{<b>SMEWebify</b>} </a> <br /> _{Creator & Lead Maintainer} <br /> _{1,225+ commits} </td> <td align="center"> <a href="https://github.com/sunxiaoguang"> <img src="https://github.com/sunxiaoguang.png" width="100px;" alt="sunxiaoguang"/> <br /> _{<b>sunxiaoguang</b>} </a> <br /> _{Core Contributor} <br /> _{11 commits} </td> <td align="center"> <a href="https://github.com/saosangmo"> <img src="https://github.com/saosangmo.png" width="100px;" alt="saosangmo"/> <br /> _{<b>saosangmo</b>} </a> <br /> _{Active Contributor} <br /> _{8 commits} </td> <td align="center"> <a href="https://github.com/RobertoBochet"> <img src="https://github.com/RobertoBochet.png" width="100px;" alt="RobertoBochet"/> <br /> _{<b>RobertoBochet</b>} </a> <br /> _Contributor <br /> _{3 commits} </td> </tr> <tr> <td align="center"> <a href="https://github.com/globalcitizen"> <img src="https://github.com/globalcitizen.png" width="100px;" alt="globalcitizen"/> <br /> _{<b>globalcitizen</b>} </a> <br /> _Contributor <br /> _{1 commit} </td> <td align="center"> <a href="https://github.com/nedlir"> <img src="https://github.com/nedlir.png" width="100px;" alt="nedlir"/> <br /> _{<b>nedlir</b>} </a> <br /> _Contributor </td> <td align="center"> <a href="https://github.com/SMEWebify/WebErpMesv2/graphs/contributors"> <img src="https://via.placeholder.com/100x100/4a5568/ffffff?text=%2B1" width="100px;" alt="More contributors"/> <br /> _{<b>+1 more</b>} </a> <br /> _{<a href="https://github.com/SMEWebify/WebErpMesv2/graphs/contributors">See all →</a>} </td> </tr> </table> ### Want to be featured here? Check our [Contributing Guide](CONTRIBUTING.md) and make your first contribution! ## 📊 Project Stats - ⭐ **182** Stars - 🍴 **88** Forks - 👥 **7+** Active Contributors - 📝 **1,225+** Commits - 🎉 **20** Releases - 📦 **Open Source** under MIT License ## 📚 Documentation - 📖 [User Guide](https://github.com/SMEWebify/WebErpMesv2/wiki) - 🔧 [Development Setup](https://github.com/SMEWebify/WebErpMesv2/wiki/Installation-Steps-(for-dev)) - 🚀 [Production Deployment](https://github.com/SMEWebify/WebErpMesv2/wiki/Installation-Steps-(for-production)) - 🏗️ [Architecture Overview](ARCHITECTURE.md) - 🤝 [Contributing Guide](CONTRIBUTING.md) - 🔒 [Security Policy](SECURITY.md) ## 🗺️ Roadmap Check our [roadmap](ROADMAP.md) to see what's coming next and how you can help! **Current priorities:** - 📄 EN16931 electronic invoicing API - 🧪 Test coverage improvement - 📚 Complete API documentation ## 💬 Support & Community - 💭 [GitHub Discussions](https://github.com/SMEWebify/WebErpMesv2/discussions) - Questions, ideas, feedback - 🐛 [Issue Tracker](https://github.com/SMEWebify/WebErpMesv2/issues) - Bugs and feature requests - 📧 [Email](mailto:[email protected]) - Direct support - 🌐 [Online demo](http://demo.wem-project.org) - Try it for free ## 📄 License Project under the **MIT** license - See [LICENSE](LICENSE) You are free to: - ✅ Use commercially - ✅ Modify the code - ✅ Distribute - ✅ Use privately ## 🙏 Acknowledgements Thanks to: - All our [contributors](https://github.com/SMEWebify/WebErpMesv2/graphs/contributors) - The workshops that test and provide feedback - The Laravel and React communities - Everyone who starred ⭐ the project --- ## 🏭 Built for industry, by industry ΣEM was born from hands-on experience in industrial sheet metal. Every feature meets a real workshop need. **Are you a sheet metal worker, mechanic, machinist?** Your feedback is invaluable to improve the tool → [Contact us](mailto:[email protected]) **Are you a developer passionate about industry?** Join us → [Contributing Guide](CONTRIBUTING.md) --- <p align="center"> <b>Made with ❤️ for sheet metal and mechanical professionals</b> <br /> <br /> <a href="https://github.com/SMEWebify/WebErpMesv2/stargazers">⭐ Star the project</a> • <a href="https://github.com/SMEWebify/WebErpMesv2/fork">🍴 Fork</a> • <a href="CONTRIBUTING.md">🤝 Contribute</a> • <a href="http://demo.wem-project.org">🎬 Try the demo</a> </p>