PHPackages                             azaharizaman/nexus-finance-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-finance-operations

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

azaharizaman/nexus-finance-operations
=====================================

Framework-agnostic finance workflow orchestrator for day-to-day financial operations including cash flow management, cost allocation, depreciation coordination, GL posting, and budget tracking.

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

Since May 5Pushed 1mo agoCompare

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

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

FinanceOperations Orchestrator
==============================

[](#financeoperations-orchestrator)

[![PHP Version](https://camo.githubusercontent.com/825a71dd484aeab5c562b9278c9a2e156af831ab68530e68a16bbe25fec46fba/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253545382e332d3838393242462e737667)](https://php.net/)[![License](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](LICENSE)

The **FinanceOperations** orchestrator provides cross-package workflow coordination for day-to-day financial operations within the Nexus ecosystem. It implements the Advanced Orchestrator Pattern with Saga-based workflows for distributed transaction management.

Features
--------

[](#features)

- **Saga Pattern Workflows**: Distributed transaction coordination with compensation logic
- **Cash Flow Management**: Cash position tracking, forecasting, and bank reconciliation
- **Cost Allocation**: Cost pool allocation, product costing, and periodic allocation
- **Depreciation Processing**: Fixed asset depreciation runs and schedule generation
- **GL Reconciliation**: Subledger-to-GL posting and consistency validation
- **Budget Tracking**: Budget availability checks, variance analysis, and threshold monitoring

Architecture
------------

[](#architecture)

This orchestrator follows the **Three-Layer Architecture** defined in ARCHITECTURE.md:

```
┌─────────────────────────────────────────────────────────┐
│                    Adapters (L3)                        │
│   Implements orchestrator interfaces using atomic pkgs  │
└─────────────────────────────────────────────────────────┘
                           ▲ implements
┌─────────────────────────────────────────────────────────┐
│                 FinanceOperations (L2)                  │
│   - Defines own interfaces in Contracts/                │
│   - Depends only on: php, psr/log, psr/event-dispatcher │
│   - Saga-based workflow coordination                    │
└─────────────────────────────────────────────────────────┘
                           ▲ uses via interfaces
┌─────────────────────────────────────────────────────────┐
│                Atomic Packages (L1)                     │
│   - Treasury, CostAccounting, FixedAssetDepreciation    │
│   - ChartOfAccount, JournalEntry, Receivable, Payable   │
│   - Assets, Budget                                      │
└─────────────────────────────────────────────────────────┘

```

### Interface Segregation

[](#interface-segregation)

Following ARCHITECTURE.md Section 3.1, this orchestrator:

- Defines its own interfaces in `Contracts/`
- Does NOT depend on atomic package interfaces directly
- Can be published as a standalone composer package
- Allows swapping atomic package implementations via adapters

Installation
------------

[](#installation)

```
composer require azaharizaman/nexus-finance-operations
```

### Framework Integration

[](#framework-integration)

This package is **framework-agnostic** and depends only on PSR interfaces. The following examples show how to register the package's services in various frameworks. Adapt these examples to your application's dependency injection container.

#### Laravel

[](#laravel)

Create a service provider in your application to register FinanceOperations services:

```