feat: Add tenant code to value changes; implement PurchaseController and related services for tenant-specific purchase management

app/Domains/Logging/Models/Concerns/LogsValueChanges.php

@@ -11,6 +11,8 @@ use LogicException;
 
 trait LogsValueChanges
 {
+    abstract protected function valueChangeTenantCode(): string;
+
     public static function bootLogsValueChanges(): void
     {
         static::updated(function (Model $model): void {
@@ -30,6 +32,7 @@ trait LogsValueChanges
 
             foreach ($changedAttributes as $attribute) {
                 $model->valueChanges()->create([
+                    'tenant_code' => $model->valueChangeTenantCode(),
                     'attribute' => $attribute,
                     'old_value' => $model->getRawOriginal($attribute),
                     'new_value' => $model->getAttributes()[$attribute] ?? null,

app/Domains/Logging/Models/ValueChange.php

@@ -4,12 +4,14 @@ namespace App\Domains\Logging\Models;
 
 use App\Domains\Auth\Models\User;
 use App\Domains\Logging\Enums\ValueChangeActorType;
+use App\Domains\Tenant\Models\Tenant;
 use Illuminate\Database\Eloquent\Attributes\Fillable;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
 use Illuminate\Database\Eloquent\Relations\MorphTo;
 
 #[Fillable([
+    'tenant_code',
     'trackable_type',
     'trackable_id',
     'attribute',
@@ -35,6 +37,12 @@ class ValueChange extends Model
         return $this->belongsTo(User::class);
     }
 
+    /** @return BelongsTo<Tenant, $this> */
+    public function tenant(): BelongsTo
+    {
+        return $this->belongsTo(Tenant::class, 'tenant_code', 'codigo');
+    }
+
     protected function casts(): array
     {
         return [

app/Domains/Purchase/Controllers/AdminApp/PurchaseController.php

@@ -0,0 +1,35 @@
+<?php
+
+namespace App\Domains\Purchase\Controllers\AdminApp;
+
+use App\Domains\Purchase\Resources\AdminApp\PurchaseModificationResource;
+use App\Domains\Purchase\Resources\PurchaseResource;
+use App\Domains\Purchase\Services\AdminAppPurchaseService;
+use App\Http\Controllers\Controller;
+use Illuminate\Http\Request;
+use Illuminate\Http\Resources\Json\AnonymousResourceCollection;
+
+class PurchaseController extends Controller
+{
+    public function __construct(protected AdminAppPurchaseService $purchaseService) {}
+
+    public function index(Request $request): AnonymousResourceCollection
+    {
+        $tenant = $request->user()->tenant()->firstOrFail();
+
+        return PurchaseResource::collection(
+            $this->purchaseService->purchases($tenant)
+        )->additional([
+            'confirmed_sales_total' => $this->purchaseService->confirmedSalesTotal($tenant),
+        ]);
+    }
+
+    public function modifications(Request $request): AnonymousResourceCollection
+    {
+        return PurchaseModificationResource::collection(
+            $this->purchaseService->modifications(
+                $request->user()->tenant()->firstOrFail()
+            )
+        );
+    }
+}

app/Domains/Purchase/Models/Purchase.php

@@ -137,6 +137,11 @@ class Purchase extends Model
         return (float) $this->items()->sum('total');
     }
 
+    protected function valueChangeTenantCode(): string
+    {
+        return $this->tenant_codigo;
+    }
+
     public function markAsPendingPayment(): void
     {
         $this->update([

app/Domains/Purchase/Resources/AdminApp/PurchaseModificationResource.php

@@ -0,0 +1,40 @@
+<?php
+
+namespace App\Domains\Purchase\Resources\AdminApp;
+
+use App\Domains\Logging\Models\ValueChange;
+use App\Domains\Purchase\Models\Purchase;
+use Illuminate\Http\Request;
+use Illuminate\Http\Resources\Json\JsonResource;
+
+/** @mixin ValueChange */
+class PurchaseModificationResource extends JsonResource
+{
+    /** @return array<string, mixed> */
+    public function toArray(Request $request): array
+    {
+        /** @var Purchase|null $purchase */
+        $purchase = $this->whenLoaded('trackable');
+        $user = $this->whenLoaded('user');
+
+        return [
+            'id' => $this->id,
+            'purchase_id' => $this->trackable_id,
+            'attribute' => $this->attribute,
+            'old_value' => $this->old_value,
+            'new_value' => $this->new_value,
+            'changed_at' => $this->changed_at,
+            'actor_type' => $this->actor_type->value,
+            'purchase' => $purchase instanceof Purchase ? [
+                'id' => $purchase->id,
+                'customer_name' => $purchase->nombre_apellido,
+                'status' => $purchase->status,
+            ] : null,
+            'modified_by' => $user ? [
+                'id' => $user->id,
+                'name' => $user->nombre_apellido,
+                'email' => $user->email,
+            ] : null,
+        ];
+    }
+}

app/Domains/Purchase/Services/AdminAppPurchaseService.php

@@ -0,0 +1,46 @@
+<?php
+
+namespace App\Domains\Purchase\Services;
+
+use App\Domains\Logging\Models\ValueChange;
+use App\Domains\Purchase\Models\Purchase;
+use App\Domains\Tenant\Models\Tenant;
+use Illuminate\Pagination\LengthAwarePaginator;
+
+class AdminAppPurchaseService
+{
+    public function confirmedSalesTotal(Tenant $tenant): string
+    {
+        $total = Purchase::query()
+            ->where('tenant_codigo', $tenant->codigo)
+            ->where('status', Purchase::STATUS_PAID)
+            ->sum('total');
+
+        return number_format((float) $total, 2, '.', '');
+    }
+
+    /** @return LengthAwarePaginator<Purchase> */
+    public function purchases(Tenant $tenant): LengthAwarePaginator
+    {
+        return Purchase::query()
+            ->where('tenant_codigo', $tenant->codigo)
+            ->with(['items.imageAttachment'])
+            ->withCount('tickets')
+            ->latest()
+            ->paginateFromRequest()
+            ->withQueryString();
+    }
+
+    /** @return LengthAwarePaginator<ValueChange> */
+    public function modifications(Tenant $tenant): LengthAwarePaginator
+    {
+        return ValueChange::query()
+            ->where('tenant_code', $tenant->codigo)
+            ->where('trackable_type', (new Purchase)->getMorphClass())
+            ->with(['trackable', 'user'])
+            ->orderByDesc('changed_at')
+            ->orderByDesc('id')
+            ->paginateFromRequest()
+            ->withQueryString();
+    }
+}

app/Domains/Purchase/routes/adminapp.php

@@ -0,0 +1,11 @@
+<?php
+
+use App\Domains\Purchase\Controllers\AdminApp\PurchaseController;
+use Illuminate\Support\Facades\Route;
+
+Route::prefix('v1/adminapp/tenant')
+    ->middleware(['auth:sanctum', 'adminapp.tenant'])
+    ->group(function (): void {
+        Route::get('purchases', [PurchaseController::class, 'index']);
+        Route::get('purchases/modifications', [PurchaseController::class, 'modifications']);
+    });

app/Domains/Purchase/routes/api.php

@@ -15,3 +15,5 @@ Route::prefix('tenants/{tenant:codigo}')->middleware('auth:sanctum')->group(func
     Route::post('compras/{compra}/review', [PurchaseController::class, 'submitForReview']);
     Route::post('compras/{compra}/cancel', [PurchaseController::class, 'cancel']);
 });
+
+require __DIR__.'/adminapp.php';