PHPackages                             jooservices/laravel-activities - 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. [Database & ORM](/categories/database)
4. /
5. jooservices/laravel-activities

ActiveLibrary[Database & ORM](/categories/database)

jooservices/laravel-activities
==============================

Append-only MongoDB-backed activity timeline for Laravel applications.

1.0.0(today)00MITPHPPHP ^8.5CI passing

Since Jun 26Pushed todayCompare

[ Source](https://github.com/jooservices/laravel-activities)[ Packagist](https://packagist.org/packages/jooservices/laravel-activities)[ RSS](/packages/jooservices-laravel-activities/feed)WikiDiscussions master Synced today

READMEChangelog (2)Dependencies (12)Versions (2)Used By (0)

JOOservices Laravel Activities
==============================

[](#jooservices-laravel-activities)

Append-only MongoDB-backed activity timeline for Laravel 12 and 13 applications.

Features
--------

[](#features)

- Record subject-scoped activities with optional actor, description, payload, and context
- Query activities by subject or context keys such as `plugin_slug`
- DTO-first API using `jooservices/dto`
- Repository layer using `jooservices/laravel-repository`
- Append-only storage (`created_at` only; no `updated_at`)
- MongoDB indexes via `php artisan activities:ensure-indexes`

Requirements
------------

[](#requirements)

- PHP 8.5+
- Laravel 12 or 13
- MongoDB 6+
- `mongodb/laravel-mongodb`

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

[](#installation)

```
composer require jooservices/laravel-activities
```

Publish config:

```
php artisan vendor:publish --tag=activities-config
```

Ensure indexes:

```
php artisan activities:ensure-indexes
```

Usage
-----

[](#usage)

Record an activity:

```
use JOOservices\LaravelActivities\Contracts\ActivityRecorderInterface;
use JOOservices\LaravelActivities\Dto\ActivityRecordDto;

final class CrawlTargetAdminService
{
    public function __construct(private readonly ActivityRecorderInterface $activities) {}

    public function createTarget(object $target, object $actor): void
    {
        $this->activities->recordFor(
            subject: $target,
            activity: 'crawl_target.created',
            actor: $actor,
            description: 'Created crawl target',
            data: ['url' => 'https://example.test/new'],
            context: ['plugin_slug' => 'onejav'],
        );
    }
}
```

Query activities:

```
use JOOservices\LaravelActivities\Contracts\ActivityQueryInterface;
use JOOservices\LaravelActivities\Dto\ActivityFilterDto;

$timeline = app(ActivityQueryInterface::class)->list(new ActivityFilterDto(
    contextKey: 'plugin_slug',
    contextValue: 'onejav',
    limit: 50,
));
```

Activity document shape
-----------------------

[](#activity-document-shape)

```
activities
  _id
  subject_id
  subject_type
  activity
  description
  data
  actor_id
  actor_type
  context
  created_at

```

Relationship to audit systems
-----------------------------

[](#relationship-to-audit-systems)

This package stores **product timeline activities** only. Compliance or security audit logs should remain in their own dedicated tables or packages.

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

[](#documentation)

- [`docs/README.md`](docs/README.md)
- [`AGENTS.md`](AGENTS.md)

Quality
-------

[](#quality)

```
composer check
```

License
-------

[](#license)

MIT

###  Health Score

41

—

FairBetter than 87% of packages

Maintenance100

Actively maintained with recent releases

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity50

Maturing project, gaining track record

 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

0d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/142772948?v=4)[JOOservices Ltd](/maintainers/jooservices)[@jooservices](https://github.com/jooservices)

---

Top Contributors

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

---

Tags

laravelmongodbtimelineaudit-logactivities

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StyleLaravel Pint

Type Coverage Yes

### Embed Badge

![Health badge](/badges/jooservices-laravel-activities/health.svg)

```
[![Health](https://phpackages.com/badges/jooservices-laravel-activities/health.svg)](https://phpackages.com/packages/jooservices-laravel-activities)
```

###  Alternatives

[mongodb/laravel-mongodb

A MongoDB based Eloquent model and Query builder for Laravel

7.1k8.0M88](/packages/mongodb-laravel-mongodb)[kirschbaum-development/eloquent-power-joins

The Laravel magic applied to joins.

1.6k29.9M42](/packages/kirschbaum-development-eloquent-power-joins)[psalm/plugin-laravel

Psalm plugin for Laravel

3345.1M337](/packages/psalm-plugin-laravel)[yajra/laravel-oci8

Oracle DB driver for Laravel via OCI8

8723.1M23](/packages/yajra-laravel-oci8)[glushkovds/phpclickhouse-laravel

Adapter of the most popular library https://github.com/smi2/phpClickHouse to Laravel

2051.4M2](/packages/glushkovds-phpclickhouse-laravel)[clickbar/laravel-magellan

This package provides functionality for working with the postgis extension in Laravel.

438834.4k1](/packages/clickbar-laravel-magellan)

PHPackages © 2026

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