Skip to content

README.md

Latest commit

 

History

History
424 lines (324 loc) · 14.3 KB

README.md

File metadata and controls

424 lines (324 loc) · 14.3 KB

ΣEM - The ERP/MES Dedicated to Sheet Metal & Industrial Mechanics 🏭

English • Français

Stars Forks Issues License License

image

🎯 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

🎥 Presentation video

WEM.mp4
image

Installation

🚀 Quick installation

Option 1: Docker (Recommended) 🐳

Start in 3 minutes:

git clone https://github.com/SMEWebify/WebErpMesv2.git
cd WebErpMesv2
docker compose up --build

➡️ Access http://localhost:45060

Option 2: Local installation 💻

# 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:

⚙️ 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.

image

🏗️ 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:

php artisan test

Run specific tests:

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:

Industry professionals:

  • Test and provide feedback
  • Propose domain improvements
  • Share your use cases
  • Translate the interface

Development Workflow

# 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!

SMEWebify
SMEWebify
Creator & Lead Maintainer
1,225+ commits 		sunxiaoguang
sunxiaoguang
Core Contributor
11 commits 		saosangmo
saosangmo
Active Contributor
8 commits 		RobertoBochet
RobertoBochet
Contributor
3 commits
globalcitizen
globalcitizen
Contributor
1 commit 		nedlir
nedlir
Contributor 		More contributors
+1 more
See all →

Want to be featured here?

Check our Contributing Guide 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

🗺️ Roadmap

Check our roadmap 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

📄 License

Project under the MIT license - See LICENSE

You are free to:

  • ✅ Use commercially
  • ✅ Modify the code
  • ✅ Distribute
  • ✅ Use privately

🙏 Acknowledgements

Thanks to:

  • All our 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

Are you a developer passionate about industry?
Join us → Contributing Guide

Made with ❤️ for sheet metal and mechanical professionals

⭐ Star the project • 🍴 Fork • 🤝 Contribute • 🎬 Try the demo