feat: phase 2 — master data (products, customers, drivers) via InsForge-backed Filament pages

2026-08-25 18:33:56 +07:00
parent aad2b5e256
commit 4298544381
12 changed files with 870 additions and 38 deletions
@@ -0,0 +1,112 @@
+<?php
+
+namespace App\Filament\Pages\Masters;
+
+use App\Services\CustomerService;
+use BackedEnum;
+use Filament\Actions\Action;
+use Filament\Actions\CreateAction;
+use Filament\Actions\EditAction;
+use Filament\Forms\Components\Textarea;
+use Filament\Forms\Components\TextInput;
+use Filament\Pages\Page;
+use Filament\Schemas\Components\Component;
+use Filament\Schemas\Components\EmbeddedTable;
+use Filament\Schemas\Schema;
+use Filament\Tables\Columns\TextColumn;
+use Filament\Tables\Concerns\InteractsWithTable;
+use Filament\Tables\Contracts\HasTable;
+use Filament\Tables\Table;
+use Illuminate\Contracts\Support\Htmlable;
+use UnitEnum;
+
+class Customers extends Page implements HasTable
+{
+    use InteractsWithTable;
+
+    protected static string|BackedEnum|null $navigationIcon = 'heroicon-o-users';
+
+    protected static UnitEnum|string|null $navigationGroup = 'Master';
+
+    protected static ?int $navigationSort = 2;
+
+    protected static ?string $navigationLabel = 'Pelanggan';
+
+    protected static ?string $slug = 'masters/customers';
+
+    protected string $view = 'filament.pages.blank';
+
+    public function getTitle(): string|Htmlable
+    {
+        return 'Pelanggan';
+    }
+
+    public function table(Table $table): Table
+    {
+        /** @var CustomerService $service */
+        $service = app(CustomerService::class);
+
+        return $table
+            ->records(fn (?string $search, ?string $sortColumn, ?string $sortDirection, int|string $page, int|string $recordsPerPage) => $service->paginate(
+                search: $search,
+                sortColumn: $sortColumn,
+                sortDirection: $sortDirection,
+                page: (int) $page,
+                perPage: (int) $recordsPerPage,
+            ))
+            ->columns([
+                TextColumn::make('customer_code')->label('Kode')->sortable(),
+                TextColumn::make('name')->label('Nama')->searchable()->sortable(),
+                TextColumn::make('address')->label('Alamat')->limit(40),
+                TextColumn::make('phone')->label('Telepon'),
+                TextColumn::make('notes')->label('Catatan')->limit(30),
+            ])
+            ->headerActions([
+                CreateAction::make()
+                    ->schema(fn (Schema $schema): Schema => $schema->components(self::customerFormSchema()))
+                    ->using(function (array $data): void {
+                        app(CustomerService::class)->create($data);
+                    }),
+            ])
+            ->recordActions([
+                EditAction::make()
+                    ->schema(fn (Schema $schema): Schema => $schema->components(self::customerFormSchema()))
+                    ->fillForm(fn (array $record): array => $record)
+                    ->action(function (array $data, array $record): void {
+                        app(CustomerService::class)->update($record['id'], $data);
+                    }),
+                Action::make('hapus')
+                    ->label('Hapus')
+                    ->color('danger')
+                    ->icon('heroicon-o-trash')
+                    ->requiresConfirmation()
+                    ->modalDescription('Yakin menghapus pelanggan ini?')
+                    ->action(function (array $record): void {
+                        app(CustomerService::class)->delete($record['id']);
+                    }),
+            ])
+            ->paginated([10, 25, 50]);
+    }
+
+    /**
+     * @return list<Component>
+     */
+    private static function customerFormSchema(): array
+    {
+        return [
+            TextInput::make('customer_code')->label('Kode')->default(fn () => app(CustomerService::class)->nextCode())->required()->maxLength(20),
+            TextInput::make('name')->label('Nama Pelanggan')->required()->maxLength(150),
+            TextInput::make('address')->label('Alamat')->maxLength(255),
+            TextInput::make('phone')->label('Telepon')->tel()->maxLength(30),
+            Textarea::make('notes')->label('Catatan')->columnSpanFull(),
+        ];
+    }
+
+    public function content(Schema $schema): Schema
+    {
+        return $schema
+            ->components([
+                EmbeddedTable::make(),
+            ]);
+    }
+}
@@ -0,0 +1,122 @@
+<?php
+
+namespace App\Filament\Pages\Masters;
+
+use App\Services\DriverService;
+use BackedEnum;
+use Filament\Actions\Action;
+use Filament\Actions\CreateAction;
+use Filament\Actions\EditAction;
+use Filament\Forms\Components\Select;
+use Filament\Forms\Components\Textarea;
+use Filament\Forms\Components\TextInput;
+use Filament\Pages\Page;
+use Filament\Schemas\Components\Component;
+use Filament\Schemas\Components\EmbeddedTable;
+use Filament\Schemas\Schema;
+use Filament\Tables\Columns\IconColumn;
+use Filament\Tables\Columns\TextColumn;
+use Filament\Tables\Concerns\InteractsWithTable;
+use Filament\Tables\Contracts\HasTable;
+use Filament\Tables\Table;
+use Illuminate\Contracts\Support\Htmlable;
+use Illuminate\Support\Facades\Gate;
+use UnitEnum;
+
+class Drivers extends Page implements HasTable
+{
+    use InteractsWithTable;
+
+    protected static string|BackedEnum|null $navigationIcon = 'heroicon-o-truck';
+
+    protected static UnitEnum|string|null $navigationGroup = 'Master';
+
+    protected static ?int $navigationSort = 3;
+
+    protected static ?string $navigationLabel = 'Pengemudi';
+
+    protected static ?string $slug = 'masters/drivers';
+
+    protected string $view = 'filament.pages.blank';
+
+    public function getTitle(): string|Htmlable
+    {
+        return 'Pengemudi';
+    }
+
+    public static function canAccess(): bool
+    {
+        return Gate::check('manage-drivers');
+    }
+
+    public function table(Table $table): Table
+    {
+        /** @var DriverService $service */
+        $service = app(DriverService::class);
+
+        return $table
+            ->records(fn (?string $search, ?string $sortColumn, ?string $sortDirection, int|string $page, int|string $recordsPerPage) => $service->paginate(
+                search: $search,
+                sortColumn: $sortColumn,
+                sortDirection: $sortDirection,
+                page: (int) $page,
+                perPage: (int) $recordsPerPage,
+            ))
+            ->columns([
+                TextColumn::make('driver_code')->label('Kode')->sortable(),
+                TextColumn::make('name')->label('Nama')->searchable()->sortable(),
+                TextColumn::make('phone')->label('Telepon'),
+                IconColumn::make('is_active')->label('Aktif')->boolean(),
+                TextColumn::make('notes')->label('Catatan')->limit(30),
+            ])
+            ->headerActions([
+                CreateAction::make()
+                    ->schema(fn (Schema $schema): Schema => $schema->components(self::driverFormSchema()))
+                    ->using(function (array $data): void {
+                        $data['is_active'] = true;
+                        app(DriverService::class)->create($data);
+                    }),
+            ])
+            ->recordActions([
+                EditAction::make()
+                    ->schema(fn (Schema $schema): Schema => $schema->components(self::driverFormSchema(withStatus: true)))
+                    ->fillForm(fn (array $record): array => $record)
+                    ->action(function (array $data, array $record): void {
+                        $data['is_active'] = (bool) ($data['is_active'] ?? true);
+                        app(DriverService::class)->update($record['id'], $data);
+                    }),
+                Action::make('hapus')
+                    ->label('Hapus')
+                    ->color('danger')
+                    ->icon('heroicon-o-trash')
+                    ->requiresConfirmation()
+                    ->modalDescription('Yakin menghapus pengemudi ini?')
+                    ->action(function (array $record): void {
+                        app(DriverService::class)->delete($record['id']);
+                    }),
+            ])
+            ->paginated([10, 25, 50]);
+    }
+
+    /**
+     * @return list<Component>
+     */
+    private static function driverFormSchema(bool $withStatus = false): array
+    {
+        return [
+            TextInput::make('driver_code')->label('Kode')->default(fn () => app(DriverService::class)->nextCode())->required()->maxLength(20),
+            TextInput::make('name')->label('Nama Pengemudi')->required()->maxLength(150),
+            TextInput::make('phone')->label('Telepon')->tel()->maxLength(30),
+            Textarea::make('notes')->label('Catatan')->columnSpanFull(),
+            ...($withStatus ? [Select::make('is_active')->label('Status')->options([1 => 'Aktif', 0 => 'Nonaktif'])->default(1)->required()] : []),
+        ];
+    }
+
+    public function content(Schema $schema): Schema
+    {
+        return $schema
+            ->components([
+                EmbeddedTable::make(),
+            ]);
+    }
+}
@@ -0,0 +1,124 @@
+<?php
+
+namespace App\Filament\Pages\Masters;
+
+use App\Services\ProductService;
+use BackedEnum;
+use Filament\Actions\Action;
+use Filament\Actions\CreateAction;
+use Filament\Actions\EditAction;
+use Filament\Forms\Components\Select;
+use Filament\Forms\Components\TextInput;
+use Filament\Pages\Page;
+use Filament\Schemas\Components\Component;
+use Filament\Schemas\Components\EmbeddedTable;
+use Filament\Schemas\Schema;
+use Filament\Tables\Columns\IconColumn;
+use Filament\Tables\Columns\TextColumn;
+use Filament\Tables\Concerns\InteractsWithTable;
+use Filament\Tables\Contracts\HasTable;
+use Filament\Tables\Table;
+use Illuminate\Contracts\Support\Htmlable;
+use Illuminate\Support\Facades\Gate;
+use UnitEnum;
+
+class Products extends Page implements HasTable
+{
+    use InteractsWithTable;
+
+    protected static string|BackedEnum|null $navigationIcon = 'heroicon-o-cube';
+
+    protected static UnitEnum|string|null $navigationGroup = 'Inventori';
+
+    protected static ?int $navigationSort = 1;
+
+    protected static ?string $navigationLabel = 'Produk';
+
+    protected static ?string $slug = 'masters/products';
+
+    protected string $view = 'filament.pages.blank';
+
+    public function getTitle(): string|Htmlable
+    {
+        return 'Produk';
+    }
+
+    public static function canAccess(): bool
+    {
+        return Gate::check('manage-products');
+    }
+
+    public function table(Table $table): Table
+    {
+        /** @var ProductService $service */
+        $service = app(ProductService::class);
+
+        return $table
+            ->records(fn (?string $search, ?string $sortColumn, ?string $sortDirection, int|string $page, int|string $recordsPerPage) => $service->paginate(
+                search: $search,
+                sortColumn: $sortColumn,
+                sortDirection: $sortDirection,
+                page: (int) $page,
+                perPage: (int) $recordsPerPage,
+            ))
+            ->columns([
+                TextColumn::make('code')->label('Kode')->sortable(),
+                TextColumn::make('name')->label('Nama')->searchable()->sortable(),
+                TextColumn::make('unit')->label('Satuan'),
+                TextColumn::make('weight')->label('Berat'),
+                TextColumn::make('stock_minimum')->label('Stok Minimum')->numeric()->sortable(),
+                TextColumn::make('cost_price')->label('Harga Beli')->numeric()->prefix('Rp ')->sortable(),
+                IconColumn::make('is_active')->label('Aktif')->boolean(),
+            ])
+            ->headerActions([
+                CreateAction::make()
+                    ->schema(fn (Schema $schema): Schema => $schema->components(self::productFormSchema()))
+                    ->using(function (array $data): void {
+                        $data['is_active'] = true;
+                        app(ProductService::class)->create($data);
+                    }),
+            ])
+            ->recordActions([
+                EditAction::make()
+                    ->schema(fn (Schema $schema): Schema => $schema->components(self::productFormSchema(withStatus: true)))
+                    ->fillForm(fn (array $record): array => $record)
+                    ->action(function (array $data, array $record): void {
+                        app(ProductService::class)->update($record['id'], $data);
+                    }),
+                Action::make('hapus')
+                    ->label('Hapus')
+                    ->color('danger')
+                    ->icon('heroicon-o-trash')
+                    ->requiresConfirmation()
+                    ->modalDescription('Yakin menghapus produk ini?')
+                    ->action(function (array $record): void {
+                        app(ProductService::class)->delete($record['id']);
+                    }),
+            ])
+            ->paginated([10, 25, 50]);
+    }
+
+    /**
+     * @return list<Component>
+     */
+    private static function productFormSchema(bool $withStatus = false): array
+    {
+        return [
+            TextInput::make('code')->label('Kode')->default(fn () => app(ProductService::class)->nextCode())->required()->maxLength(50),
+            TextInput::make('name')->label('Nama Produk')->required()->maxLength(150),
+            Select::make('unit')->label('Satuan')->options(['kg' => 'Kilogram', 'sak' => 'Sak', 'ton' => 'Ton'])->default('kg')->required(),
+            TextInput::make('weight')->label('Berat')->numeric()->default(0),
+            TextInput::make('stock_minimum')->label('Stok Minimum')->numeric()->default(0),
+            TextInput::make('cost_price')->label('Harga Beli')->numeric()->default(0),
+            ...($withStatus ? [Select::make('is_active')->label('Status')->options([1 => 'Aktif', 0 => 'Nonaktif'])->default(1)->required()] : []),
+        ];
+    }
+
+    public function content(Schema $schema): Schema
+    {
+        return $schema
+            ->components([
+                EmbeddedTable::make(),
+            ]);
+    }
+}
@@ -0,0 +1,36 @@
+<?php
+
+namespace App\Services;
+
+use App\Services\InsForge\InsForgeTableService;
+
+class CustomerService extends InsForgeTableService
+{
+    protected function table(): string
+    {
+        return 'customers';
+    }
+
+    protected function searchableColumns(): array
+    {
+        return ['name', 'customer_code', 'phone'];
+    }
+
+    protected function sortableColumns(): array
+    {
+        return ['customer_code', 'name', 'created_at'];
+    }
+
+    public function nextCode(): string
+    {
+        $last = $this->client->listRecords($this->table(), [
+            'order' => 'customer_code.desc.nullslast',
+            'limit' => 1,
+            'select' => 'customer_code',
+        ])[0]['customer_code'] ?? null;
+
+        preg_match('/(\d+)$/', (string) $last, $matches);
+
+        return sprintf('CUST-%04d', ((int) ($matches[1] ?? 0)) + 1);
+    }
+}
@@ -0,0 +1,36 @@
+<?php
+
+namespace App\Services;
+
+use App\Services\InsForge\InsForgeTableService;
+
+class DriverService extends InsForgeTableService
+{
+    protected function table(): string
+    {
+        return 'drivers';
+    }
+
+    protected function searchableColumns(): array
+    {
+        return ['name', 'driver_code', 'phone'];
+    }
+
+    protected function sortableColumns(): array
+    {
+        return ['driver_code', 'name', 'created_at'];
+    }
+
+    public function nextCode(): string
+    {
+        $last = $this->client->listRecords($this->table(), [
+            'order' => 'driver_code.desc.nullslast',
+            'limit' => 1,
+            'select' => 'driver_code',
+        ])[0]['driver_code'] ?? null;
+
+        preg_match('/(\d+)$/', (string) $last, $matches);
+
+        return sprintf('DRV-%04d', ((int) ($matches[1] ?? 0)) + 1);
+    }
+}
@@ -40,17 +40,17 @@ class InsForgeClient
        return $this->request('GET', '/api/auth/profiles/current')->json();
    }

-    public function listRecords(string $table, array $params = []): array
+    public function listRecords(string $table, array $params = [], bool $asUser = false): array
    {
-        return $this->request('GET', "/api/database/records/{$table}", query: $params)->json() ?? [];
+        return $this->request('GET', "/api/database/records/{$table}", query: $params, asUser: $asUser)->json() ?? [];
    }

-    public function getRecord(string $table, string $id, array $params = []): ?array
+    public function getRecord(string $table, string $id, array $params = [], bool $asUser = false): ?array
    {
        $params['id'] = 'eq.'.$id;
        $params['limit'] = 1;

-        return $this->listRecords($table, $params)[0] ?? null;
+        return $this->listRecords($table, $params, $asUser)[0] ?? null;
    }

    public function insertRecord(string $table, array $data, bool $asUser = true): array
@@ -118,9 +118,11 @@ class InsForgeClient

            $verb = strtolower($method);

+            $uri = $query !== [] ? $path.'?'.http_build_query($query) : $path;
+
            $response = in_array($verb, ['get', 'head'])
-                ? $http->{$verb}($path, $query)
-                : $http->{$verb}($path, $body);
+                ? $http->{$verb}($uri)
+                : $http->{$verb}($uri, $body);

            throw_unless($response->successful(), fn () => InsForgeException::fromResponse(
                $response->status(),
@@ -0,0 +1,145 @@
+<?php
+
+namespace App\Services\InsForge;
+
+use Illuminate\Pagination\LengthAwarePaginator;
+
+abstract class InsForgeTableService
+{
+    public function __construct(protected readonly InsForgeClient $client) {}
+
+    abstract protected function table(): string;
+
+    /** @return list<string> */
+    abstract protected function searchableColumns(): array;
+
+    abstract protected function sortableColumns(): array;
+
+    protected function defaultSortColumn(): string
+    {
+        return 'created_at';
+    }
+
+    protected function defaultSortDirection(): string
+    {
+        return 'desc';
+    }
+
+    /** @param array<string, mixed> $filters column => value (eq) */
+    public function paginate(
+        ?string $search = null,
+        ?string $sortColumn = null,
+        ?string $sortDirection = null,
+        int $page = 1,
+        int $perPage = 25,
+        array $filters = [],
+    ): LengthAwarePaginator {
+        $query = [
+            'select' => '*',
+            'limit' => max(1, min($perPage, 100)),
+            'offset' => ($page - 1) * $perPage,
+            'order' => sprintf(
+                '%s.%s.nullslast',
+                in_array($sortColumn, $this->sortableColumns(), true) ? $sortColumn : $this->defaultSortColumn(),
+                strtolower($sortDirection ?? '') === 'asc' ? 'asc' : $this->defaultSortDirection(),
+            ),
+        ];
+
+        foreach ($filters as $column => $value) {
+            if ($value !== null && $value !== '') {
+                $query[$column] = 'eq.'.$value;
+            }
+        }
+
+        if (filled($search) && $this->searchableColumns() !== []) {
+            $terms = str_replace(['(', ')', ','], ' ', $search);
+            $clauses = array_map(
+                fn (string $column): string => sprintf('%s.ilike.*%s*', $column, trim($terms)),
+                $this->searchableColumns(),
+            );
+            $query['or'] = '('.implode(',', $clauses).')';
+        }
+
+        [$client, $asUser] = $this->scoped();
+
+        $response = $client->send('GET', '/api/database/records/'.$this->table(), query: $query, asUser: $asUser, headers: ['Prefer' => 'count=exact']);
+
+        $rows = $response->json() ?? [];
+        $total = $this->parseTotal($response->header('Content-Range')) ?? count($rows);
+
+        return new LengthAwarePaginator(
+            items: $rows,
+            total: $total,
+            perPage: $perPage,
+            currentPage: $page,
+        );
+    }
+
+    public function find(string $id): ?array
+    {
+        [$client, $asUser] = $this->scoped();
+
+        return $client->getRecord($this->table(), $id, asUser: $asUser);
+    }
+
+    /** @param array<string, mixed> $filters */
+    public function findBy(array $filters): ?array
+    {
+        [$client, $asUser] = $this->scoped();
+
+        $params = ['limit' => 1];
+
+        foreach ($filters as $column => $value) {
+            $params[$column] = 'eq.'.$value;
+        }
+
+        return $client->listRecords($this->table(), $params, asUser: $asUser)[0] ?? null;
+    }
+
+    public function create(array $data): void
+    {
+        [$client, $asUser] = $this->scoped();
+
+        $client->insertRecord($this->table(), [$data], asUser: $asUser);
+    }
+
+    public function update(string $id, array $data): void
+    {
+        [$client, $asUser] = $this->scoped();
+
+        $client->updateRecords($this->table(), ['id' => $id], $data, asUser: $asUser);
+    }
+
+    public function delete(string $id): void
+    {
+        [$client, $asUser] = $this->scoped();
+
+        $client->deleteRecords($this->table(), ['id' => $id], asUser: $asUser);
+    }
+
+    /**
+     * Pakai JWT user saat ada sesi (RLS aktif); jatuh ke admin key untuk konteks tanpa sesi.
+     *
+     * @return array{0: InsForgeClient, 1: bool}
+     */
+    private function scoped(): array
+    {
+        $token = session(InsForgeAuthService::SESSION_ACCESS_TOKEN);
+
+        return [
+            $token ? $this->client->withToken($token) : $this->client,
+            filled($token),
+        ];
+    }
+
+    private function parseTotal(?string $contentRange): ?int
+    {
+        if (! filled($contentRange)) {
+            return null;
+        }
+
+        $total = explode('/', $contentRange)[1] ?? '';
+
+        return ctype_digit($total) ? (int) $total : null;
+    }
+}
@@ -0,0 +1,36 @@
+<?php
+
+namespace App\Services;
+
+use App\Services\InsForge\InsForgeTableService;
+
+class ProductService extends InsForgeTableService
+{
+    protected function table(): string
+    {
+        return 'products';
+    }
+
+    protected function searchableColumns(): array
+    {
+        return ['name', 'code'];
+    }
+
+    protected function sortableColumns(): array
+    {
+        return ['code', 'name', 'created_at', 'stock_minimum', 'cost_price'];
+    }
+
+    public function nextCode(): string
+    {
+        $last = $this->client->listRecords($this->table(), [
+            'order' => 'code.desc.nullslast',
+            'limit' => 1,
+            'select' => 'code',
+        ])[0]['code'] ?? null;
+
+        preg_match('/(\d+)$/', (string) $last, $matches);
+
+        return sprintf('BERAS-%03d', ((int) ($matches[1] ?? 0)) + 1);
+    }
+}