Download the PHP package azaharizaman/nexus-procurement-operations without Composer
On this page you can find all versions of the php package azaharizaman/nexus-procurement-operations. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download azaharizaman/nexus-procurement-operations
More information about azaharizaman/nexus-procurement-operations
Files in azaharizaman/nexus-procurement-operations
Package nexus-procurement-operations
Short Description Nexus ProcurementOperations Orchestrator - Cross-package workflow coordination for Procure-to-Pay (P2P) processes
License MIT
Informations about the package nexus-procurement-operations
Nexus ProcurementOperations Orchestrator
Package: azaharizaman/nexus-procurement-operations
Namespace: Nexus\ProcurementOperations
Type: Orchestrator (Pure PHP)
Version: 2.0.0-phase-c
Overview
The ProcurementOperations orchestrator coordinates the complete Procure-to-Pay (P2P) cycle across multiple atomic Nexus packages. It provides enterprise-grade procurement capabilities with full SOX 404 compliance support.
Core Capabilities
- Requisition Workflow - Create, validate, approve/reject purchase requisitions
- Purchase Order Workflow - Convert requisitions to POs, manage amendments and blanket POs
- Goods Receipt Workflow - Record partial/full receipts, quality inspection integration
- Three-Way Matching - Match PO ↔ GR ↔ Invoice with configurable tolerances
- Payment Processing - Schedule, batch, and execute vendor payments with early payment discounts
- SOX 404 Compliance - Full compliance framework with control testing and evidence management
- Vendor Portal - Self-service vendor registration, onboarding, and performance management
- Spend Analytics - Real-time spend analysis, policy compliance, and maverick detection
- Multi-Entity Operations - Shared services center and intercompany procurement
- Document Retention - Regulatory-compliant document lifecycle management
⚠️ Stability & Compatibility Notice
Pre-Production Status: This orchestrator is under active development and has not yet reached production state. As such:
- Breaking changes may occur between minor versions without deprecation notices
- API signatures may change as the design evolves based on real-world usage
- Backward compatibility is not guaranteed until v1.0.0 stable release
- Some dependencies (e.g.,
CryptoManagerInterfaceinHashingService) are mandatory rather than optional, as they are core to the service's functionality
Please pin to specific versions in non-production environments and review the CHANGELOG before upgrading.
Architecture
This orchestrator follows the Advanced Orchestrator Pattern v1.1 with strict component separation:
Component Count Summary
| Component Type | Count | Description |
|---|---|---|
| Contracts | 28 | Interface definitions |
| DTOs | 90+ | Data transfer objects |
| Enums | 22 | Type-safe enumerations |
| Events | 30+ | Domain events |
| Services | 25+ | Business logic services |
| Rules | 25 | Validation rules |
| Coordinators | 12 | Flow orchestrators |
| DataProviders | 8 | Data aggregation |
| Workflows | 8 | Stateful processes |
| Listeners | 15 | Event handlers |
| Total | ~250+ | Production-ready components |
Package Dependencies
| Package | Purpose |
|---|---|
Nexus\Procurement |
Requisition, PO, Goods Receipt management |
Nexus\Payable |
Vendor bills, invoice matching, payments |
Nexus\Inventory |
Stock receipt and management |
Nexus\JournalEntry |
GL posting for accruals and payments |
Nexus\Budget |
Budget commitment and release |
Nexus\Workflow |
Approval workflows |
Nexus\Party |
Vendor management |
Nexus\Period |
Fiscal period validation |
Nexus\Currency |
Multi-currency support |
Nexus\Tax |
Tax calculation and withholding |
Nexus\Notifier |
Notifications |
Nexus\AuditLogger |
Audit trail |
Nexus\MachineLearning |
Anomaly detection |
Nexus\Connector |
External integrations |
Nexus\Setting |
Configuration |
Quick Start
1. Requisition Workflow
2. Three-Way Matching
3. Payment Processing with Early Payment Discount
4. SOX 404 Compliance Validation
5. Vendor Onboarding
6. Spend Analytics
7. Multi-Entity Shared Services
SOX 404 Compliance Framework
COSO Framework Mapping
The orchestrator maps all controls to COSO framework components:
| COSO Component | Control Areas |
|---|---|
| Control Environment | Vendor Management, User Access |
| Risk Assessment | Budget Control, Spend Policies |
| Control Activities | Approvals, Matching, Segregation of Duties |
| Information & Communication | Audit Trail, Notifications |
| Monitoring Activities | Control Testing, Analytics |
Control Testing
Evidence Package Generation
Segregation of Duties (SoD)
Enforced Conflicts
| Duty 1 | Duty 2 | Conflict Type |
|---|---|---|
| Create Requisition | Approve Requisition | Same person cannot approve their own request |
| Create PO | Approve PO | Same person cannot approve their own PO |
| Receive Goods | Approve Invoice | Prevents collusion |
| Create Vendor | Approve Vendor | Prevents ghost vendors |
| Process Payment | Approve Payment | Prevents unauthorized payments |
SoD Validation
Document Retention
Retention Categories
| Category | Retention Period | Disposal Method |
|---|---|---|
| SOX Financial Data | 7 years | Secure Shred |
| Tax Records | 7 years | Secure Deletion |
| Vendor Contracts | 7 years post-expiry | Archive |
| Purchase Orders | 7 years | Archive |
| Invoices | 7 years | Archive |
| Goods Receipts | 7 years | Archive |
| Vendor Correspondence | 3 years | Standard |
| RFQ/RFP Documents | 5 years | Archive |
Legal Hold Management
Compliance Services (Phase B)
ApprovalLimitsManager
Manages configurable approval thresholds by role, department, and user.
DocumentRetentionService
Manages document lifecycle with regulatory compliance.
ProcurementAuditService
SOX 404 compliance audit and evidence generation.
Event-Driven Integration
Published Events
| Event | Description |
|---|---|
RequisitionCreatedEvent |
New requisition submitted |
RequisitionApprovedEvent |
Requisition approved |
PurchaseOrderIssuedEvent |
PO sent to vendor |
GoodsReceiptCompletedEvent |
Goods received |
InvoiceMatchedEvent |
3-way match successful |
PaymentExecutedEvent |
Payment processed |
SoxControlTestedEvent |
Control test completed |
SodViolationDetectedEvent |
SoD conflict found |
SpendPolicyViolatedEvent |
Policy breach detected |
MaverickSpendDetectedEvent |
Off-contract spend identified |
VendorOnboardedEvent |
Vendor activated |
VendorSuspendedEvent |
Vendor put on hold |
Event Listeners
| Event | Listener | Action |
|---|---|---|
RequisitionApprovedEvent |
CreatePurchaseOrderListener |
Auto-create PO |
GoodsReceiptCompletedEvent |
TriggerMatchingListener |
Initiate 3-way match |
InvoiceMatchedEvent |
SchedulePaymentListener |
Queue for payment |
PaymentExecutedEvent |
PostJournalEntryListener |
Post GL entries |
SpendPolicyViolatedEvent |
NotifyComplianceTeamListener |
Send alerts |
SodViolationDetectedEvent |
CreateAuditFindingListener |
Log for audit |
Configuration
Configure via Nexus\Setting:
| Setting Key | Default | Description |
|---|---|---|
procurement.matching.price_tolerance_percent |
5.0 |
Max price variance (%) |
procurement.matching.quantity_tolerance_percent |
2.0 |
Max quantity variance (%) |
procurement.matching.auto_match_enabled |
true |
Auto-match on GR complete |
procurement.payment.batch_size |
50 |
Max invoices per payment batch |
procurement.payment.default_method |
ACH |
Default payment method |
procurement.payment.early_discount_enabled |
true |
Capture early payment discounts |
procurement.sox.control_test_sample_size |
25 |
PCAOB standard sample size |
procurement.sox.evidence_retention_years |
7 |
Evidence retention period |
procurement.vendor.onboarding_auto_approve |
false |
Auto-approve vendors |
procurement.spend.maverick_threshold_percent |
5.0 |
Maverick spend alert threshold |
Testing
Run the test suite:
Test Coverage Summary
| Component | Test Files | Test Cases |
|---|---|---|
| Rules | 25 | 200+ |
| Services | 20+ | 150+ |
| Coordinators | 12 | 80+ |
| Workflows | 8 | 60+ |
| DTOs | 20+ | 100+ |
| Total | 85+ | 590+ |
Migration from v1.x
If upgrading from ProcurementOperations v1.x:
- Namespace changes: No breaking namespace changes
- New dependencies: Add
Nexus\MachineLearningfor anomaly detection - Configuration migration: See
docs/MIGRATION_GUIDE.md - Database migrations: Run new migrations for audit tables
Contributing
See CONTRIBUTING.md for contribution guidelines.
License
MIT License - see LICENSE file.
All versions of nexus-procurement-operations with dependencies
psr/log Version ^3.0
psr/event-dispatcher Version ^1.0
azaharizaman/nexus-procurement Version dev-main
azaharizaman/nexus-payable Version dev-main
azaharizaman/nexus-inventory Version dev-main
azaharizaman/nexus-journal-entry Version dev-main
azaharizaman/nexus-budget Version dev-main
azaharizaman/nexus-workflow Version dev-main
azaharizaman/nexus-party Version dev-main
azaharizaman/nexus-period Version dev-main
azaharizaman/nexus-currency Version dev-main
azaharizaman/nexus-notifier Version dev-main
azaharizaman/nexus-audit-logger Version dev-main
azaharizaman/nexus-setting Version dev-main
azaharizaman/nexus-tax Version dev-main
azaharizaman/nexus-compliance Version dev-main
azaharizaman/nexus-document Version dev-main
azaharizaman/nexus-crypto Version dev-main