Skip to content

feat: interaction activity tracking module #183

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
danielhe4rt wants to merge 7 commits into
base: 4.x
Choose a base branch
from
Open

feat: interaction activity tracking module #183

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
c49427e
refactor(activity): restructure module into Message/Voice subdomains
danielhe4rt Mar 19, 2026
644964b
feat(activity): add Tracking subdomain with Interaction model
danielhe4rt Mar 19, 2026
32e815b
feat(integration-devto): add new module for DevTo OAuth and article sync
danielhe4rt Mar 19, 2026
e1215c1
feat(identity): add DevTo to IdentityProvider enum
danielhe4rt Mar 19, 2026
89f2385
feat(gamification): add HasInteractions trait to Character model
danielhe4rt Mar 19, 2026
1029afd
deps: bump and fix lock
danielhe4rt Mar 19, 2026
bfa2053
fix: linting
danielhe4rt Mar 19, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
34 changes: 34 additions & 0 deletions app-modules/activity/config/activity-tracking.php
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
<?php

declare(strict_types=1);

return [
'classification' => [
'article' => ['tier' => 'high', 'coins_min' => 100, 'coins_max' => 300],
'pr_merged' => ['tier' => 'high', 'coins_min' => 80, 'coins_max' => 250],
'mentoring' => ['tier' => 'high', 'coins_min' => 50, 'coins_max' => 150],
'squad_project' => ['tier' => 'high', 'coins_min' => 200, 'coins_max' => 500],
'referral' => ['tier' => 'medium', 'coins_min' => 20, 'coins_max' => 30],
'peer_review' => ['tier' => 'medium', 'coins_min' => 10, 'coins_max' => 25],
'call_participation' => ['tier' => 'medium', 'coins_min' => 15, 'coins_max' => 30],
'forum_debate' => ['tier' => 'medium', 'coins_min' => 10, 'coins_max' => 20],
'content_share' => ['tier' => 'low', 'coins_min' => 5, 'coins_max' => 10],
'engagement' => ['tier' => 'low', 'coins_min' => 1, 'coins_max' => 3],
'repo_star' => ['tier' => 'low', 'coins_min' => 2, 'coins_max' => 2],
'message' => ['tier' => 'low', 'coins_min' => 1, 'coins_max' => 2],
'voice' => ['tier' => 'low', 'coins_min' => 1, 'coins_max' => 3],
],

'auto_approve_tiers' => ['low', 'medium'],

'engagement_formula' => [
'reactions_multiplier' => 0.5,
'reactions_cap' => 25,
'bookmarks_multiplier' => 1.0,
'bookmarks_cap' => 15,
'comments_multiplier' => 2.0,
'comments_cap' => 30,
],

'xp_multiplier' => 1,
];
69 changes: 69 additions & 0 deletions app-modules/activity/database/factories/InteractionFactory.php
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,69 @@
<?php

declare(strict_types=1);

namespace He4rt\Activity\Database\Factories;

use He4rt\Activity\Tracking\Enums\ActivityStatus;
use He4rt\Activity\Tracking\Enums\ActivityType;
use He4rt\Activity\Tracking\Enums\ValueTier;
use He4rt\Activity\Tracking\Models\Interaction;
use He4rt\Gamification\Character\Models\Character;
use He4rt\Identity\ExternalIdentity\Enums\IdentityProvider;
use He4rt\Identity\Tenant\Models\Tenant;
use Illuminate\Database\Eloquent\Factories\Factory;

/**
* @extends Factory<Interaction>
*/
final class InteractionFactory extends Factory
{
protected $model = Interaction::class;

public function definition(): array
{
return [
'character_id' => Character::factory(),
'tenant_id' => Tenant::factory(),
'type' => ActivityType::Article,
'provider' => IdentityProvider::DevTo,
'value_tier' => ValueTier::High,
'coins_min' => 100,
'coins_max' => 300,
'status' => ActivityStatus::Pending,
'occurred_at' => now(),
];
}

public function autoApproved(): self
{
return $this->state([
'status' => ActivityStatus::AutoApproved,
'type' => ActivityType::Engagement,
'value_tier' => ValueTier::Low,
'coins_min' => 1,
'coins_max' => 3,
]);
}

public function approved(): self
{
return $this->state([
'status' => ActivityStatus::Approved,
'reviewed_at' => now(),
]);
}

public function withEngagement(int $reactions = 0, int $comments = 0, int $bookmarks = 0): self
{
return $this->state([
'metadata' => [
'engagement_snapshot' => [
'reactions' => $reactions,
'comments' => $comments,
'bookmarks' => $bookmarks,
],
],
]);
}
}
2 changes: 1 addition & 1 deletion app-modules/activity/database/factories/MessageFactory.php
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@

namespace He4rt\Activity\Database\Factories;

use He4rt\Activity\Models\Message;
use He4rt\Activity\Message\Models\Message;
use He4rt\Identity\ExternalIdentity\Models\ExternalIdentity;
use He4rt\Identity\Tenant\Models\Tenant;
use Illuminate\Database\Eloquent\Factories\Factory;
Expand Down
42 changes: 42 additions & 0 deletions app-modules/activity/database/migrations/2026_03_18_000000_create_interactions_table.php
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,42 @@
<?php

declare(strict_types=1);

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

return new class extends Migration
{
public function up(): void
{
Schema::create('interactions', function (Blueprint $table): void {
$table->uuid('id')->primary();
$table->foreignUuid('character_id')->constrained('characters');
$table->foreignId('tenant_id')->constrained('tenants');
$table->string('type');
$table->string('provider');
$table->string('value_tier');
$table->integer('coins_min');
$table->integer('coins_max');
$table->integer('coins_awarded')->nullable();
$table->integer('xp_awarded')->nullable();
$table->string('status')->default('pending');
$table->nullableUuidMorphs('source');
$table->string('external_ref')->unique()->nullable();
Copy link

@coderabbitai coderabbitai bot Mar 19, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟠 Major

Scope external_ref uniqueness to tenant/provider to avoid cross-tenant collisions.

A global unique constraint on external_ref can reject legitimate interactions from another tenant/provider using the same upstream reference.

Suggested migration adjustment 
-            $table->string('external_ref')->unique()->nullable();
+            $table->string('external_ref')->nullable();
@@
             $table->index(['character_id', 'type', 'created_at'], 'idx_interactions_character_type');
             $table->index(['status', 'value_tier'], 'idx_interactions_status_tier');
             $table->index(['tenant_id', 'occurred_at'], 'idx_interactions_tenant');
+            $table->unique(
+                ['tenant_id', 'provider', 'external_ref'],
+                'uniq_interactions_tenant_provider_external_ref'
+            );
🤖 Prompt for AI Agents 
Verify each finding against the current code and only fix it if needed.

In
`@app-modules/activity/database/migrations/2026_03_18_000000_create_interactions_table.php`
at line 26, The migration currently makes external_ref globally unique which can
cause cross-tenant/provider collisions; update the migration in
create_interactions_table (remove ->unique() from
$table->string('external_ref')->unique()->nullable()) and instead add a
composite unique index such as
$table->unique(['tenant_id','provider','external_ref']) (or whatever
tenant/provider column names are used) so uniqueness is enforced per tenant and
provider.

$table->jsonb('metadata')->nullable();
$table->timestamp('occurred_at');
$table->timestamp('reviewed_at')->nullable();
$table->timestamps();

$table->index(['character_id', 'type', 'created_at'], 'idx_interactions_character_type');
$table->index(['status', 'value_tier'], 'idx_interactions_status_tier');
$table->index(['tenant_id', 'occurred_at'], 'idx_interactions_tenant');
});
}

public function down(): void
{
Schema::dropIfExists('interactions');
}
};
2 changes: 1 addition & 1 deletion app-modules/activity/routes/message-routes.php
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@

use App\Http\Middleware\BotAuthentication;
use App\Http\Middleware\VerifyIfHasTenantProviderMiddleware;
use He4rt\Activity\Http\Controllers\MessagesController;
use He4rt\Activity\Message\Http\Controllers\MessagesController;
use Illuminate\Support\Facades\Route;

Route::prefix('api')->middleware(['api', BotAuthentication::class, VerifyIfHasTenantProviderMiddleware::class])->group(function (): void {
Expand Down
4 changes: 2 additions & 2 deletions ...dules/activity/src/Actions/NewMessage.php → ...tivity/src/Message/Actions/NewMessage.php
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,9 @@

declare(strict_types=1);

namespace He4rt\Activity\Actions;
namespace He4rt\Activity\Message\Actions;

use He4rt\Activity\DTOs\NewMessageDTO;
use He4rt\Activity\Message\DTOs\NewMessageDTO;
use He4rt\Gamification\Character\Models\Character;
use He4rt\Identity\ExternalIdentity\DTOs\ResolveUserProviderDTO;
use He4rt\Identity\User\Actions\ResolveUserContext;
Expand Down
6 changes: 3 additions & 3 deletions ...s/activity/src/Actions/PersistMessage.php → ...ty/src/Message/Actions/PersistMessage.php
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,10 +2,10 @@

declare(strict_types=1);

namespace He4rt\Activity\Actions;
namespace He4rt\Activity\Message\Actions;

use He4rt\Activity\DTOs\NewMessageDTO;
use He4rt\Activity\Models\Message;
use He4rt\Activity\Message\DTOs\NewMessageDTO;
use He4rt\Activity\Message\Models\Message;

class PersistMessage
{
Expand Down
2 changes: 1 addition & 1 deletion ...dules/activity/src/DTOs/NewMessageDTO.php → ...tivity/src/Message/DTOs/NewMessageDTO.php
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

declare(strict_types=1);

namespace He4rt\Activity\DTOs;
namespace He4rt\Activity\Message\DTOs;

use DateTimeImmutable;
use He4rt\Identity\ExternalIdentity\Enums\IdentityProvider;
Expand Down
14 changes: 7 additions & 7 deletions ...in/Resources/Messages/MessageResource.php → ...in/Resources/Messages/MessageResource.php
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,19 +2,19 @@

declare(strict_types=1);

namespace He4rt\Activity\Filament\Admin\Resources\Messages;
namespace He4rt\Activity\Message\Filament\Admin\Resources\Messages;

use BackedEnum;
use Filament\Resources\Resource;
use Filament\Schemas\Schema;
use Filament\Support\Icons\Heroicon;
use Filament\Tables\Table;
use He4rt\Activity\Filament\Admin\Resources\Messages\Pages\CreateMessage;
use He4rt\Activity\Filament\Admin\Resources\Messages\Pages\EditMessage;
use He4rt\Activity\Filament\Admin\Resources\Messages\Pages\ListMessages;
use He4rt\Activity\Filament\Admin\Resources\Messages\Schemas\MessageForm;
use He4rt\Activity\Filament\Admin\Resources\Messages\Tables\MessagesTable;
use He4rt\Activity\Models\Message;
use He4rt\Activity\Message\Filament\Admin\Resources\Messages\Pages\CreateMessage;
use He4rt\Activity\Message\Filament\Admin\Resources\Messages\Pages\EditMessage;
use He4rt\Activity\Message\Filament\Admin\Resources\Messages\Pages\ListMessages;
use He4rt\Activity\Message\Filament\Admin\Resources\Messages\Schemas\MessageForm;
use He4rt\Activity\Message\Filament\Admin\Resources\Messages\Tables\MessagesTable;
use He4rt\Activity\Message\Models\Message;
use UnitEnum;

class MessageResource extends Resource
Expand Down
4 changes: 2 additions & 2 deletions ...esources/Messages/Pages/CreateMessage.php → ...esources/Messages/Pages/CreateMessage.php
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,10 +2,10 @@

declare(strict_types=1);

namespace He4rt\Activity\Filament\Admin\Resources\Messages\Pages;
namespace He4rt\Activity\Message\Filament\Admin\Resources\Messages\Pages;

use Filament\Resources\Pages\CreateRecord;
use He4rt\Activity\Filament\Admin\Resources\Messages\MessageResource;
use He4rt\Activity\Message\Filament\Admin\Resources\Messages\MessageResource;

class CreateMessage extends CreateRecord
{
Expand Down
4 changes: 2 additions & 2 deletions .../Resources/Messages/Pages/EditMessage.php → .../Resources/Messages/Pages/EditMessage.php
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,11 +2,11 @@

declare(strict_types=1);

namespace He4rt\Activity\Filament\Admin\Resources\Messages\Pages;
namespace He4rt\Activity\Message\Filament\Admin\Resources\Messages\Pages;

use Filament\Actions\DeleteAction;
use Filament\Resources\Pages\EditRecord;
use He4rt\Activity\Filament\Admin\Resources\Messages\MessageResource;
use He4rt\Activity\Message\Filament\Admin\Resources\Messages\MessageResource;

class EditMessage extends EditRecord
{
Expand Down
4 changes: 2 additions & 2 deletions ...Resources/Messages/Pages/ListMessages.php → ...Resources/Messages/Pages/ListMessages.php
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,11 +2,11 @@

declare(strict_types=1);

namespace He4rt\Activity\Filament\Admin\Resources\Messages\Pages;
namespace He4rt\Activity\Message\Filament\Admin\Resources\Messages\Pages;

use Filament\Actions\CreateAction;
use Filament\Resources\Pages\ListRecords;
use He4rt\Activity\Filament\Admin\Resources\Messages\MessageResource;
use He4rt\Activity\Message\Filament\Admin\Resources\Messages\MessageResource;

class ListMessages extends ListRecords
{
Expand Down
2 changes: 1 addition & 1 deletion ...esources/Messages/Schemas/MessageForm.php → ...esources/Messages/Schemas/MessageForm.php
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

declare(strict_types=1);

namespace He4rt\Activity\Filament\Admin\Resources\Messages\Schemas;
namespace He4rt\Activity\Message\Filament\Admin\Resources\Messages\Schemas;

use Filament\Forms\Components\DateTimePicker;
use Filament\Forms\Components\Select;
Expand Down
2 changes: 1 addition & 1 deletion ...sources/Messages/Tables/MessagesTable.php → ...sources/Messages/Tables/MessagesTable.php
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

declare(strict_types=1);

namespace He4rt\Activity\Filament\Admin\Resources\Messages\Tables;
namespace He4rt\Activity\Message\Filament\Admin\Resources\Messages\Tables;

use Filament\Actions\BulkActionGroup;
use Filament\Actions\DeleteBulkAction;
Expand Down
10 changes: 5 additions & 5 deletions ...c/Http/Controllers/MessagesController.php → ...e/Http/Controllers/MessagesController.php
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,13 +2,13 @@

declare(strict_types=1);

namespace He4rt\Activity\Http\Controllers;
namespace He4rt\Activity\Message\Http\Controllers;

use App\Http\Controllers\Controller;
use He4rt\Activity\Actions\NewMessage;
use He4rt\Activity\Actions\NewVoiceMessage;
use He4rt\Activity\Http\Requests\CreateMessageRequest;
use He4rt\Activity\Http\Requests\CreateVoiceMessageRequest;
use He4rt\Activity\Message\Actions\NewMessage;
use He4rt\Activity\Message\Http\Requests\CreateMessageRequest;
use He4rt\Activity\Voice\Actions\NewVoiceMessage;
use He4rt\Activity\Voice\Http\Requests\CreateVoiceMessageRequest;
use Illuminate\Http\Response;

final class MessagesController extends Controller
Expand Down
4 changes: 2 additions & 2 deletions ...rc/Http/Requests/CreateMessageRequest.php → ...ge/Http/Requests/CreateMessageRequest.php
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

declare(strict_types=1);

namespace He4rt\Activity\Http\Requests;
namespace He4rt\Activity\Message\Http\Requests;

use Illuminate\Foundation\Http\FormRequest;

Expand All @@ -17,7 +17,7 @@ public function rules(): array
{
return [
'tenant_id' => ['required'],
'provider' => ['required', 'in:twitch,discord'],
'provider' => ['required', 'in:twitch,discord,devto'],
'provider_id' => ['required'],
'provider_message_id' => ['required'],
'channel_id' => ['required'],
Expand Down
2 changes: 1 addition & 1 deletion app-modules/activity/src/Models/Message.php → ...s/activity/src/Message/Models/Message.php
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

declare(strict_types=1);

namespace He4rt\Activity\Models;
namespace He4rt\Activity\Message\Models;

use He4rt\Activity\Database\Factories\MessageFactory;
use He4rt\Identity\ExternalIdentity\Models\ExternalIdentity;
Expand Down
6 changes: 5 additions & 1 deletion app-modules/activity/src/Providers/ActivityServiceProvider.php
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,17 +6,21 @@

use App\Enums\FilamentPanel;
use Filament\Panel;
use He4rt\Activity\Filament\Admin\Resources\Messages\MessageResource;
use He4rt\Activity\Message\Filament\Admin\Resources\Messages\MessageResource;
use He4rt\Activity\Tracking\Filament\Admin\Resources\Interactions\InteractionResource;
use Illuminate\Support\ServiceProvider;

class ActivityServiceProvider extends ServiceProvider
{
public function register(): void
{
$this->mergeConfigFrom(__DIR__.'/../../config/activity-tracking.php', 'activity-tracking');

Panel::configureUsing(function (Panel $panel): void {
match ($panel->currentPanel()) {
FilamentPanel::Admin => $panel->resources([
MessageResource::class,
InteractionResource::class,
]),
default => null,
};
Expand Down
Loading
Loading