README

ERP manufacturing — BOMs, work orders and job cards for the Laravel ERP ecosystem.

This package is the manufacturing module of an ERPNext-native rebuild. It sits on top of the stock layer: producing a finished good consumes raw materials and receives the output through the perpetual inventory engine, which values every movement and posts it to the general ledger. It depends on jeffersongoncalves/laravel-erp-core, jeffersongoncalves/laravel-erp-accounting and jeffersongoncalves/laravel-erp-stock.

Features

• Bills of Materials — A Bom master with raw-material lines and operation lines; the raw-material, operating and total cost columns are recomputed automatically from the child rows whenever a line changes
• Workstations & Operations — Workstation masters (carrying an hourly rate and a production capacity) and the operations performed on them
• Routings — Reusable, ordered sequences of operations that can drive a BOM's process
• Work Orders — Submittable documents (Draft → Submitted → Cancelled) to produce a quantity of a finished item against a BOM; on submit the required-materials rows are populated from the BOM scaled to the ordered quantity and the status advances to Not Started
• Job Cards — Shop-floor execution of a work order's operations, with time logs
• Manufacture Stock Entry — WorkOrderService::manufacture() turns a work order into a Manufacture stock entry: an outbound consume line per raw material and one inbound finished-good line; submitting it runs the stock engine (outbound raw SLE + inbound FG SLE + GL impact)
• Customizable Models — Override any model via config (ModelResolver pattern)
• Translations — English and Brazilian Portuguese

Compatibility

Installation

composer require jeffersongoncalves/laravel-erp-manufacturing

Publish and run the migrations (the core, accounting and stock package migrations must be published too):

php artisan vendor:publish --tag="erp-core-migrations"
php artisan vendor:publish --tag="erp-accounting-migrations"
php artisan vendor:publish --tag="erp-stock-migrations"
php artisan vendor:publish --tag="erp-manufacturing-migrations"
php artisan migrate

Publish the config (optional):

php artisan vendor:publish --tag="erp-manufacturing-config"

Producing a Finished Good

A work order describes what to make; WorkOrderService turns it into the stock movement that actually consumes and produces.

use JeffersonGoncalves\Erp\Manufacturing\Models\WorkOrder;
use JeffersonGoncalves\Erp\Manufacturing\Services\WorkOrderService;

$workOrder = WorkOrder::create([
    'production_item' => 'FG-WIDGET',
    'bom_id' => $bom->id,
    'qty' => 10,
    'company_id' => $company->id,
    'wip_warehouse_id' => $wip->id,
    'fg_warehouse_id' => $fg->id,
]);

// Required materials are pulled from the BOM (scaled to qty) and the status
// advances to "Not Started".
$workOrder->submit();

// Build the Manufacture stock entry: a consume line per raw material plus one
// finished-good line. It is returned in Draft.
$entry = app(WorkOrderService::class)->manufacture($workOrder);

// Submitting it runs the perpetual inventory engine: outbound raw stock-ledger
// entries, an inbound finished-good entry and the matching GL impact.
$entry->submit();

The produced quantity / status of the (now immutable) work order are intentionally left untouched by manufacture(); advancing them is a documented follow-up once a work order supports partial completion.

Database Tables

All tables use the configured prefix shared across the ERP ecosystem (default: erp_): workstations, operations, boms, bom_items, bom_operations, routings, routing_operations, work_orders, work_order_items, job_cards, job_card_time_logs.

Testing

composer test

License

The MIT License (MIT). Please see License File for more information.