Add Departure Time Slot and Catalog read API (T2.4, T2.5)

Adds the shared DepartureTimeSlot catalog entity with its Filament resource, and public GET /api/v1/companies + /api/v1/destinations endpoints (auth:sanctum + throttled) for the mini app/mobile/agent clients to consume.
2026-08-06 21:18:52 +07:00
parent bf5d2c676a
commit 7872105f2f
16 changed files with 474 additions and 0 deletions
@@ -0,0 +1,51 @@
+<?php
+
+namespace Modules\Catalog\Filament\Resources\DepartureTimeSlots;
+
+use BackedEnum;
+use Filament\Resources\Resource;
+use Filament\Schemas\Schema;
+use Filament\Support\Icons\Heroicon;
+use Filament\Tables\Table;
+use Modules\Catalog\Filament\Resources\DepartureTimeSlots\Pages\CreateDepartureTimeSlot;
+use Modules\Catalog\Filament\Resources\DepartureTimeSlots\Pages\EditDepartureTimeSlot;
+use Modules\Catalog\Filament\Resources\DepartureTimeSlots\Pages\ListDepartureTimeSlots;
+use Modules\Catalog\Filament\Resources\DepartureTimeSlots\Schemas\DepartureTimeSlotForm;
+use Modules\Catalog\Filament\Resources\DepartureTimeSlots\Tables\DepartureTimeSlotsTable;
+use Modules\Catalog\Models\DepartureTimeSlot;
+use UnitEnum;
+
+class DepartureTimeSlotResource extends Resource
+{
+    protected static ?string $model = DepartureTimeSlot::class;
+
+    protected static string|BackedEnum|null $navigationIcon = Heroicon::OutlinedClock;
+
+    protected static string|UnitEnum|null $navigationGroup = 'Catalog';
+
+    public static function form(Schema $schema): Schema
+    {
+        return DepartureTimeSlotForm::configure($schema);
+    }
+
+    public static function table(Table $table): Table
+    {
+        return DepartureTimeSlotsTable::configure($table);
+    }
+
+    public static function getRelations(): array
+    {
+        return [
+            //
+        ];
+    }
+
+    public static function getPages(): array
+    {
+        return [
+            'index' => ListDepartureTimeSlots::route('/'),
+            'create' => CreateDepartureTimeSlot::route('/create'),
+            'edit' => EditDepartureTimeSlot::route('/{record}/edit'),
+        ];
+    }
+}
@@ -0,0 +1,11 @@
+<?php
+
+namespace Modules\Catalog\Filament\Resources\DepartureTimeSlots\Pages;
+
+use Filament\Resources\Pages\CreateRecord;
+use Modules\Catalog\Filament\Resources\DepartureTimeSlots\DepartureTimeSlotResource;
+
+class CreateDepartureTimeSlot extends CreateRecord
+{
+    protected static string $resource = DepartureTimeSlotResource::class;
+}
@@ -0,0 +1,19 @@
+<?php
+
+namespace Modules\Catalog\Filament\Resources\DepartureTimeSlots\Pages;
+
+use Filament\Actions\DeleteAction;
+use Filament\Resources\Pages\EditRecord;
+use Modules\Catalog\Filament\Resources\DepartureTimeSlots\DepartureTimeSlotResource;
+
+class EditDepartureTimeSlot extends EditRecord
+{
+    protected static string $resource = DepartureTimeSlotResource::class;
+
+    protected function getHeaderActions(): array
+    {
+        return [
+            DeleteAction::make(),
+        ];
+    }
+}
@@ -0,0 +1,19 @@
+<?php
+
+namespace Modules\Catalog\Filament\Resources\DepartureTimeSlots\Pages;
+
+use Filament\Actions\CreateAction;
+use Filament\Resources\Pages\ListRecords;
+use Modules\Catalog\Filament\Resources\DepartureTimeSlots\DepartureTimeSlotResource;
+
+class ListDepartureTimeSlots extends ListRecords
+{
+    protected static string $resource = DepartureTimeSlotResource::class;
+
+    protected function getHeaderActions(): array
+    {
+        return [
+            CreateAction::make(),
+        ];
+    }
+}
@@ -0,0 +1,26 @@
+<?php
+
+namespace Modules\Catalog\Filament\Resources\DepartureTimeSlots\Schemas;
+
+use Filament\Forms\Components\TextInput;
+use Filament\Forms\Components\TimePicker;
+use Filament\Forms\Components\Toggle;
+use Filament\Schemas\Schema;
+
+class DepartureTimeSlotForm
+{
+    public static function configure(Schema $schema): Schema
+    {
+        return $schema
+            ->components([
+                TextInput::make('label')
+                    ->required()
+                    ->maxLength(255),
+                TimePicker::make('time')
+                    ->required(),
+                Toggle::make('is_active')
+                    ->required()
+                    ->default(true),
+            ]);
+    }
+}
@@ -0,0 +1,45 @@
+<?php
+
+namespace Modules\Catalog\Filament\Resources\DepartureTimeSlots\Tables;
+
+use Filament\Actions\BulkActionGroup;
+use Filament\Actions\DeleteBulkAction;
+use Filament\Actions\EditAction;
+use Filament\Tables\Columns\IconColumn;
+use Filament\Tables\Columns\TextColumn;
+use Filament\Tables\Filters\TernaryFilter;
+use Filament\Tables\Table;
+
+class DepartureTimeSlotsTable
+{
+    public static function configure(Table $table): Table
+    {
+        return $table
+            ->columns([
+                TextColumn::make('label')
+                    ->searchable()
+                    ->sortable(),
+                TextColumn::make('time')
+                    ->time('H:i')
+                    ->sortable(),
+                IconColumn::make('is_active')
+                    ->boolean(),
+                TextColumn::make('created_at')
+                    ->dateTime()
+                    ->sortable()
+                    ->toggleable(isToggledHiddenByDefault: true),
+            ])
+            ->defaultSort('time')
+            ->filters([
+                TernaryFilter::make('is_active'),
+            ])
+            ->recordActions([
+                EditAction::make(),
+            ])
+            ->toolbarActions([
+                BulkActionGroup::make([
+                    DeleteBulkAction::make(),
+                ]),
+            ]);
+    }
+}
@@ -0,0 +1,18 @@
+<?php
+
+namespace Modules\Catalog\Http\Controllers;
+
+use Illuminate\Http\Resources\Json\AnonymousResourceCollection;
+use Illuminate\Routing\Controller;
+use Modules\Catalog\Http\Resources\DestinationResource;
+use Modules\Catalog\Models\Destination;
+
+class DestinationController extends Controller
+{
+    public function index(): AnonymousResourceCollection
+    {
+        return DestinationResource::collection(
+            Destination::query()->where('is_active', true)->get()
+        );
+    }
+}
@@ -0,0 +1,18 @@
+<?php
+
+namespace Modules\Catalog\Http\Controllers;
+
+use Illuminate\Http\Resources\Json\AnonymousResourceCollection;
+use Illuminate\Routing\Controller;
+use Modules\Catalog\Http\Resources\EvCompanyResource;
+use Modules\Catalog\Models\EvCompany;
+
+class EvCompanyController extends Controller
+{
+    public function index(): AnonymousResourceCollection
+    {
+        return EvCompanyResource::collection(
+            EvCompany::query()->where('is_active', true)->get()
+        );
+    }
+}
@@ -0,0 +1,29 @@
+<?php
+
+namespace Modules\Catalog\Http\Resources;
+
+use Illuminate\Http\Request;
+use Illuminate\Http\Resources\Json\JsonResource;
+
+class DestinationResource extends JsonResource
+{
+    /**
+     * Transform the resource into an array.
+     *
+     * @return array<string, mixed>
+     */
+    public function toArray(Request $request): array
+    {
+        return [
+            'id' => $this->id,
+            'name' => $this->name,
+            'mm_name' => $this->mm_name,
+            'region' => $this->region,
+            'description' => $this->description,
+            'mm_description' => $this->mm_description,
+            'latitude' => $this->latitude,
+            'longitude' => $this->longitude,
+            'popular' => $this->popular,
+        ];
+    }
+}
@@ -0,0 +1,29 @@
+<?php
+
+namespace Modules\Catalog\Http\Resources;
+
+use Illuminate\Http\Request;
+use Illuminate\Http\Resources\Json\JsonResource;
+
+class EvCompanyResource extends JsonResource
+{
+    /**
+     * Transform the resource into an array.
+     *
+     * @return array<string, mixed>
+     */
+    public function toArray(Request $request): array
+    {
+        return [
+            'id' => $this->id,
+            'name' => $this->name,
+            'mm_name' => $this->mm_name,
+            'slug' => $this->slug,
+            'description' => $this->description,
+            'mm_description' => $this->mm_description,
+            'contact' => $this->contact,
+            'address' => $this->address,
+            'logo' => $this->logo,
+        ];
+    }
+}
@@ -0,0 +1,37 @@
+<?php
+
+namespace Modules\Catalog\Models;
+
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Modules\Catalog\Database\Factories\DepartureTimeSlotFactory;
+
+/**
+ * A shared catalog of departure times, attached to routes via a pivot in the
+ * Routing module — not owned by any single route.
+ */
+class DepartureTimeSlot extends Model
+{
+    /** @use HasFactory<DepartureTimeSlotFactory> */
+    use HasFactory;
+
+    /**
+     * @var list<string>
+     */
+    protected $fillable = [
+        'label',
+        'time',
+        'is_active',
+    ];
+
+    /**
+     * @return array<string, string>
+     */
+    protected function casts(): array
+    {
+        return [
+            'time' => 'datetime:H:i',
+            'is_active' => 'boolean',
+        ];
+    }
+}