feat: phase 3 — stock balances, restock/adjust mutations with activity logging, movements page

app/Services/ActivityLogger.php

@@ -0,0 +1,24 @@
+<?php
+
+namespace App\Services;
+
+use App\Models\User;
+use App\Services\InsForge\InsForgeClient;
+
+class ActivityLogger
+{
+    public function __construct(private readonly InsForgeClient $client) {}
+
+    public function log(string $action, string $entityType, ?string $entityId, string $description, ?User $actor = null): void
+    {
+        $entry = array_filter([
+            'user_id' => $actor?->id,
+            'action' => $action,
+            'entity_type' => $entityType,
+            'entity_id' => $entityId,
+            'description' => $description,
+        ], fn ($value) => $value !== null && $value !== '');
+
+        $this->client->insertRecord('activity_logs', [$entry], asUser: false);
+    }
+}

app/Services/InsForge/InsForgeTableService.php

@@ -25,6 +25,11 @@ abstract class InsForgeTableService
         return 'desc';
     }
 
+    protected function select(): string
+    {
+        return '*';
+    }
+
     /** @param array<string, mixed> $filters column => value (eq) */
     public function paginate(
         ?string $search = null,
@@ -35,7 +40,7 @@ abstract class InsForgeTableService
         array $filters = [],
     ): LengthAwarePaginator {
         $query = [
-            'select' => '*',
+            'select' => $this->select(),
             'limit' => max(1, min($perPage, 100)),
             'offset' => ($page - 1) * $perPage,
             'order' => sprintf(
@@ -122,7 +127,7 @@ abstract class InsForgeTableService
      *
      * @return array{0: InsForgeClient, 1: bool}
      */
-    private function scoped(): array
+    protected function scoped(): array
     {
         $token = session(InsForgeAuthService::SESSION_ACCESS_TOKEN);
 

app/Services/StockMovementService.php

@@ -0,0 +1,45 @@
+<?php
+
+namespace App\Services;
+
+use App\Services\InsForge\InsForgeTableService;
+use Illuminate\Pagination\LengthAwarePaginator;
+
+class StockMovementService extends InsForgeTableService
+{
+    public const TYPES = ['restock', 'adjustment', 'order_out'];
+
+    protected function table(): string
+    {
+        return 'stock_movements';
+    }
+
+    protected function select(): string
+    {
+        return '*,products(code,name)';
+    }
+
+    protected function searchableColumns(): array
+    {
+        return ['notes', 'type'];
+    }
+
+    protected function sortableColumns(): array
+    {
+        return ['created_at', 'quantity', 'type'];
+    }
+
+    /** @param array<string, mixed> $filters */
+    public function paginate(
+        ?string $search = null,
+        ?string $sortColumn = null,
+        ?string $sortDirection = null,
+        int $page = 1,
+        int $perPage = 25,
+        array $filters = [],
+    ): LengthAwarePaginator {
+        $extra = array_intersect_key($filters, array_flip(['type', 'product_id']));
+
+        return parent::paginate($search, $sortColumn, $sortDirection, $page, $perPage, $extra);
+    }
+}

app/Services/StockService.php

@@ -0,0 +1,132 @@
+<?php
+
+namespace App\Services;
+
+use App\Models\User;
+use App\Services\InsForge\InsForgeClient;
+use App\Services\InsForge\InsForgeTableService;
+
+class StockService extends InsForgeTableService
+{
+    public function __construct(
+        InsForgeClient $client,
+        private readonly ProductService $products,
+        private readonly ActivityLogger $activity,
+    ) {
+        parent::__construct($client);
+    }
+
+    protected function table(): string
+    {
+        return 'stocks';
+    }
+
+    protected function select(): string
+    {
+        return '*,products(code,name,stock_minimum,is_active)';
+    }
+
+    protected function searchableColumns(): array
+    {
+        return [];
+    }
+
+    protected function sortableColumns(): array
+    {
+        return ['quantity', 'updated_at'];
+    }
+
+    protected function defaultSortColumn(): string
+    {
+        return 'updated_at';
+    }
+
+    /**
+     * Tambah stok (restok).
+     */
+    public function restock(string $productId, int $quantity, ?string $notes = null, ?User $actor = null): void
+    {
+        $quantity > 0 || throw new \InvalidArgumentException('Jumlah restok harus lebih dari nol.');
+
+        $newBalance = $this->applyMutation($productId, fn (int $current): int => $current + $quantity, $quantity, 'restock', $notes, $actor);
+
+        $this->activity->log(
+            'stock_restocked',
+            'stocks',
+            $productId,
+            sprintf('Restok %d untuk produk %s (saldo menjadi %d).', $quantity, $this->productLabel($productId), $newBalance),
+            $actor,
+        );
+    }
+
+    /**
+     * Koreksi saldo ke nilai absolut baru.
+     */
+    public function adjust(string $productId, int $newQuantity, ?string $notes = null, ?User $actor = null): void
+    {
+        $delta = $newQuantity - $this->currentQuantity($productId);
+
+        if ($delta === 0) {
+            return;
+        }
+
+        $this->applyMutation($productId, fn (): int => $newQuantity, $delta, 'adjustment', $notes, $actor);
+
+        $this->activity->log(
+            'stock_adjusted',
+            'stocks',
+            $productId,
+            sprintf('Koreksi stok produk %s menjadi %d (selisih %+d).', $this->productLabel($productId), $newQuantity, $delta),
+            $actor,
+        );
+    }
+
+    private function applyMutation(string $productId, callable $resolveNewBalance, int $movementQuantity, string $type, ?string $notes, ?User $actor): int
+    {
+        [$client, $asUser] = $this->scoped();
+
+        $stock = $client->listRecords('stocks', ['product_id' => 'eq.'.$productId, 'limit' => 1], asUser: $asUser)[0] ?? null;
+
+        $current = (int) ($stock['quantity'] ?? 0);
+        $newBalance = $resolveNewBalance($current);
+
+        if ($stock === null) {
+            $client->insertRecord('stocks', [[
+                'product_id' => $productId,
+                'quantity' => max($newBalance, 0),
+            ]], asUser: false);
+        } else {
+            $client->updateRecords('stocks', ['id' => $stock['id']], [
+                'quantity' => $newBalance,
+            ], asUser: false);
+        }
+
+        $mutation = array_filter([
+            'product_id' => $productId,
+            'type' => $type,
+            'quantity' => $movementQuantity,
+            'notes' => $notes,
+            'created_by' => $actor?->id,
+        ], fn ($value) => $value !== null && $value !== '');
+
+        $client->insertRecord('stock_movements', [$mutation], asUser: false);
+
+        return $newBalance;
+    }
+
+    private function currentQuantity(string $productId): int
+    {
+        [$client, $asUser] = $this->scoped();
+
+        $stock = $client->listRecords('stocks', ['product_id' => 'eq.'.$productId, 'limit' => 1], asUser: $asUser)[0] ?? null;
+
+        return (int) ($stock['quantity'] ?? 0);
+    }
+
+    private function productLabel(string $productId): string
+    {
+        $product = $this->products->find($productId);
+
+        return trim(($product['code'] ?? '').' — '.($product['name'] ?? '?'), ' —') ?: '?';
+    }
+}