WebErpMesv2

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #cli #claude-code #codex #developer-tools #react #windows

★ 210 Open GitHub ↗

Ressource Management and Manufacturing execution system Web for industry (sheet metal, machining, mold ...)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

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

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

## 🎯 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**: contact@wem-project.org 
- **Password**: password

### 🎥 Presentation video

https://github.com/user-attachments/assets/200e1322-ae60-4270-aa9c-0a28e5ca737a

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

## 🏗️ 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"/>
 
 SMEWebify
 </a>
 
 Creator & Lead Maintainer
 
 1,225+ commits
 </td>
 <td align="center">
 <a href="https://github.com/sunxiaoguang">
 <img src="https://github.com/sunxiaoguang.png" width="100px;" alt="sunxiaoguang"/>
 
 sunxiaoguang
 </a>
 
 Core Contributor
 
 11 commits
 </td>
 <td align="center">
 <a href="https://github.com/saosangmo">
 <img src="https://github.com/saosangmo.png" width="100px;" alt="saosangmo"/>
 
 saosangmo
 </a>
 
 Active Contributor
 
 8 commits
 </td>
 <td align="center">
 <a href="https://github.com/RobertoBochet">
 <img src="https://github.com/RobertoBochet.png" width="100px;" alt="RobertoBochet"/>
 
 RobertoBochet
 </a>
 
 Contributor
 
 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"/>
 
 globalcitizen
 </a>
 
 Contributor
 
 1 commit
 </td>
 <td align="center">
 <a href="https://github.com/nedlir">
 <img src="https://github.com/nedlir.png" width="100px;" alt="nedlir"/>
 
 nedlir
 </a>
 
 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"/>
 
 +1 more
 </a>
 
 <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:contact@wem-project.org) - 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:contact@wem-project.org)

**Are you a developer passionate about industry?**  
Join us → [Contributing Guide](CONTRIBUTING.md)

---

Made with ❤️ for sheet metal and mechanical professionals
 
 
 <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>

WebErpMesv2

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README