PHPackages                             azaharizaman/nexus-supply-chain-operations - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. azaharizaman/nexus-supply-chain-operations

ActiveLibrary[Utility & Helpers](/categories/utility)

azaharizaman/nexus-supply-chain-operations
==========================================

Nexus SupplyChainOperations Orchestrator - Coordinating end-to-end supply chain flows from procurement to fulfillment

v0.1.0-alpha1(1mo ago)00MITPHPPHP ^8.3

Since May 5Pushed 1mo agoCompare

[ Source](https://github.com/azaharizaman/nexus-supply-chain-operations)[ Packagist](https://packagist.org/packages/azaharizaman/nexus-supply-chain-operations)[ RSS](/packages/azaharizaman-nexus-supply-chain-operations/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependencies (2)Versions (2)Used By (0)

SupplyChainOperations Orchestrator
==================================

[](#supplychainoperations-orchestrator)

The `SupplyChainOperations` orchestrator is responsible for coordinating end-to-end business processes that span across Procurement, Inventory, Warehouse, and Sales domains.

🎯 Key Responsibilities
----------------------

[](#-key-responsibilities)

### Phase 1: Advanced Operational Flows ✅

[](#phase-1-advanced-operational-flows-)

- **Dropshipping Orchestration (SC-1.1)**: Automatically create vendor POs when dropship sales orders are confirmed.
- **Landed Cost Capitalization (SC-1.2)**: Bridge freight/tariff invoices to inventory receipts for true COGS accuracy.

### Phase 2: Intelligence & Optimization ✅

[](#phase-2-intelligence--optimization-)

- **Predictive Replenishment (SC-2.1)**: ML-based dynamic reorder points using demand forecasting.
- **Dynamic Lead Time / ATP (SC-2.2)**: Real-time Available-to-Promise calculations using ProcurementML analytics.

### Phase 3: Lifecycle & Logistical Integrity (Planned)

[](#phase-3-lifecycle--logistical-integrity-planned)

- **RMA & Reverse Supply Chain (SC-3.1)**: End-to-end return lifecycle orchestration.
- **Regional Multi-Warehouse Balancing (SC-3.2)**: Optimize stock distribution across warehouses.

🏗️ Architecture
---------------

[](#️-architecture)

This package follows the **Nexus Three-Layer Architecture**:

- **Coordinators**: Stateless services for synchronous cross-domain orchestration.
- **Listeners**: Reactive event subscribers that trigger business logic based on domain events.
- **Workflows**: Stateful Sagas for long-running supply chain processes.
- **Value Objects**: Immutable data structures (e.g., `AvailableToPromiseResult`).

**Framework-Agnostic**: This orchestrator contains no framework-specific code. DI registration and event wiring should be done in the **adapters/** layer (Layer 3).

📦 Dependencies
--------------

[](#-dependencies)

### Required

[](#required)

- `Nexus\Inventory`: Stock management, demand forecasting.
- `Nexus\Procurement`: Purchase orders, vendor management.
- `Nexus\Sales`: Sales orders, fulfillment.
- `Nexus\AuditLogger`: Cross-domain audit trails.

### Optional (for Phase 2 features)

[](#optional-for-phase-2-features)

- `Nexus\ProcurementML`: Delivery analytics for ATP calculations.
- `Nexus\Payable`: Invoice processing for landed costs.

🚀 Getting Started
-----------------

[](#-getting-started)

### Coordinators

[](#coordinators)

**DropshipCoordinator** - Create dropship purchase orders:

```
$poId = $dropshipCoordinator->createDropshipPo($salesOrder, $lines, $vendorId);
```

**LandedCostCoordinator** - Capitalize costs onto inventory:

```
$coordinator->distributeLandedCost($grnId, $amount, 'value');
```

**ReplenishmentCoordinator** - ML-enhanced replenishment:

```
// Traditional threshold-based
$reqId = $coordinator->createAutoRequisition($tenantId, $warehouseId, $requesterId, $replenishmentMap);

// ML-based forecast evaluation
$evaluation = $coordinator->evaluateProductWithForecast($tenantId, $productId, $warehouseId);
```

**DynamicLeadTimeCoordinator** - Available-to-Promise calculations:

```
$atpResult = $coordinator->calculateAtpDate($productId, $quantity, $warehouseId, $preferredVendorId);
// Returns: promised date, confidence score, lead time breakdown
```

### Event Listeners

[](#event-listeners)

Register these listeners in your application's event dispatcher:

- `DropshipListener` - Triggered on `SalesOrderConfirmedEvent`
- `DropshipFulfillmentListener` - Triggered on `GoodsReceiptCreatedEvent`
- `LandedCostListener` - Triggered on `InvoiceApprovedForPaymentEvent`
- `StockLevelListener` - Triggered on `StockIssuedEvent` and `StockAdjustedEvent`

### Dependency Injection

[](#dependency-injection)

**Note**: This orchestrator is framework-agnostic. You must register services in your **adapters/** layer:

```
// Example: Laravel ServiceProvider in adapters/
$this->app->singleton(DropshipCoordinator::class);
$this->app->singleton(LandedCostCoordinator::class);
$this->app->singleton(ReplenishmentCoordinator::class);
$this->app->singleton(DynamicLeadTimeCoordinator::class);

// Event wiring
Event::listen(SalesOrderConfirmedEvent::class, DropshipListener::class);
Event::listen(GoodsReceiptCreatedEvent::class, DropshipFulfillmentListener::class);
```

###  Health Score

34

—

LowBetter than 75% of packages

Maintenance93

Actively maintained with recent releases

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity34

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

36d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/117408?v=4)[Azahari Zaman](/maintainers/azaharizaman)[@azaharizaman](https://github.com/azaharizaman)

---

Top Contributors

[![azaharizaman](https://avatars.githubusercontent.com/u/117408?v=4)](https://github.com/azaharizaman "azaharizaman (8 commits)")

---

Tags

inventoryfulfillmentorchestratornexussupply-chainprocurementreplenishment

### Embed Badge

![Health badge](/badges/azaharizaman-nexus-supply-chain-operations/health.svg)

```
[![Health](https://phpackages.com/badges/azaharizaman-nexus-supply-chain-operations/health.svg)](https://phpackages.com/packages/azaharizaman-nexus-supply-chain-operations)
```

###  Alternatives

[symfony/symfony

The Symfony PHP framework

31.4k86.9M2.2k](/packages/symfony-symfony)[phpro/soap-client

A general purpose SoapClient library

8955.9M52](/packages/phpro-soap-client)[symfony/mailer

Helps sending emails

1.6k394.6M1.3k](/packages/symfony-mailer)[web-auth/webauthn-lib

FIDO2/Webauthn Support For PHP

1237.8M117](/packages/web-auth-webauthn-lib)[web-auth/webauthn-framework

FIDO2/Webauthn library for PHP and Symfony Bundle.

51090.8k2](/packages/web-auth-webauthn-framework)[ecotone/ecotone

Enterprise architecture layer for Laravel and Symfony — CQRS, Event Sourcing, Durable Workflows (Sagas, Orchestrators), Projections, and Outbox messaging via PHP attributes.

562565.8k41](/packages/ecotone-ecotone)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)