PHPackages                             azaharizaman/nexus-query-engine - 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-query-engine

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

azaharizaman/nexus-query-engine
===============================

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

v0.1.0-alpha1(1mo ago)02↓100%2MITPHPPHP ^8.2

Since May 5Pushed 1mo agoCompare

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

READMEChangelogDependencies (1)Versions (2)Used By (2)

Nexus Analytics Package
=======================

[](#nexus-analytics-package)

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

Overview
--------

[](#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
------------

[](#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
------------

[](#installation)

In the Atomy application:

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

Basic Usage
-----------

[](#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
------------

[](#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
-------------

[](#documentation)

See `docs/ANALYTICS_IMPLEMENTATION.md` for complete implementation details.

License
-------

[](#license)

MIT License - see LICENSE file for details.

Documentation
-------------

[](#documentation-1)

### Package Documentation

[](#package-documentation)

- **[Getting Started Guide](docs/getting-started.md)** - Quick start and basic usage
- **[API Reference](docs/api-reference.md)** - Complete interface documentation
- **[Integration Guide](docs/integration-guide.md)** - Laravel and Symfony integration examples

### Package Specifications

[](#package-specifications)

- **[IMPLEMENTATION\_SUMMARY.md](IMPLEMENTATION_SUMMARY.md)** - Implementation progress and architecture decisions
- **[REQUIREMENTS.md](REQUIREMENTS.md)** - Detailed package requirements (84 requirements)
- **[TEST\_SUITE\_SUMMARY.md](TEST_SUITE_SUMMARY.md)** - Test coverage plan (135+ tests planned)
- **[VALUATION\_MATRIX.md](VALUATION_MATRIX.md)** - Package valuation ($250K, 2,083% ROI)

### Code Examples

[](#code-examples)

- **[Basic Usage](docs/examples/basic-usage.php)** - Simple queries and common use cases
- **[Advanced Usage](docs/examples/advanced-usage.php)** - Multi-dimensional analysis, cohort analysis

###  Health Score

36

—

LowBetter than 79% of packages

Maintenance93

Actively maintained with recent releases

Popularity3

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity32

Early-stage or recently created project

 Bus Factor1

Top contributor holds 72.7% 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)")[![cursoragent](https://avatars.githubusercontent.com/u/199161495?v=4)](https://github.com/cursoragent "cursoragent (3 commits)")

---

Tags

phpanalyticsbusiness intelligencequeriesdata-analysispredictive modelingnexusquery-engine

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/azaharizaman-nexus-query-engine/health.svg)

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

###  Alternatives

[rubix/ml

A high-level machine learning and deep learning library for the PHP language.

2.2k1.5M28](/packages/rubix-ml)[panphp/pan

A simple, lightweight, and privacy-focused product analytics php package.

1.3k106.0k5](/packages/panphp-pan)[bezhansalleh/filament-google-analytics

Google Analytics integration for FilamentPHP

208175.5k8](/packages/bezhansalleh-filament-google-analytics)

PHPackages © 2026

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