azaharizaman/nexus-query-engine

High-performance framework-agnostic query execution and data aggregation engine for the Nexus ERP system

Maintainers

Package info

github.com/azaharizaman/nexus-query-engine

pkg:composer/azaharizaman/nexus-query-engine

Statistics

Installs: 1

Dependents: 4

Suggesters: 0

Stars: 0

Open Issues: 0

Security

Advisories: 0

Aikido package health analysis

v0.1.0-alpha1 2026-05-05 02:28 UTC

Requires

  • php: ^8.2

Requires (Dev)

MIT bc8f18e79268f78506ef35aeb02c764e419515b0

  • Nexus Team

phpanalyticsqueriesnexusbusiness-intelligencepredictive-modelingdata-analysisquery-engine

This package is auto-updated.

Last update: 2026-05-05 03:14:29 UTC

README

Framework-agnostic analytics and business intelligence engine for the Nexus ERP ecosystem.

Overview

The Nexus\QueryEngine package provides a comprehensive analytics engine that enables:

  • Query Execution: Execute complex analytical queries with ACID compliance
  • Predictive Modeling: Machine learning integration for forecasting and predictions
  • Data Aggregation: Parallel data source merging and aggregation
  • Permission Management: Role-based access control with delegation chains
  • Analytics History: Immutable audit trail of all analytics operations
  • Guard Conditions: Pre-execution validation and security checks

Key Features

  • ✅ Framework-agnostic design (no Laravel dependencies)
  • ✅ ACID-compliant query execution with transaction support
  • ✅ Parallel data source processing
  • ✅ Built-in security with RBAC integration
  • ✅ Tenant isolation support
  • ✅ Predictive model management with drift detection
  • ✅ Before/after hooks for extensibility
  • ✅ Database-driven analytics definitions (JSON)
  • ✅ Comprehensive error handling and retry logic

Installation

In the Atomy application:

composer require azaharizaman/nexus-query-engine:"*@dev"

Basic Usage

use Nexus\QueryEngine\Services\AnalyticsManager;

// Execute a query
$result = $analyticsManager->runQuery($queryDefinition, $context);

// Check permissions
$canExecute = $analyticsManager->can($userId, 'execute', $queryId);

// Get analytics history
$history = $analyticsManager->getHistory($entityId, $limit);

Architecture

This package follows the Nexus architecture principles:

  • Logic in Packages: All business logic is framework-agnostic
  • Implementation in Applications: Atomy provides concrete implementations
  • Contract-Driven: All dependencies defined via interfaces

Documentation

See docs/ANALYTICS_IMPLEMENTATION.md for complete implementation details.

License

MIT License - see LICENSE file for details.

Documentation

Package Documentation

Package Specifications

Code Examples