Add CMS module

Static content pages (CmsPage) manageable from a new Filament resource and
readable via a public API endpoint. Wired into the admin panel with its own
CmsPlugin and "CMS" navigation group.

app-modules/cms/src/CmsPlugin.php

@@ -0,0 +1,38 @@
+<?php
+
+namespace Modules\Cms;
+
+use Filament\Contracts\Plugin;
+use Filament\Panel;
+
+class CmsPlugin implements Plugin
+{
+    public function getId(): string
+    {
+        return 'cms';
+    }
+
+    public function register(Panel $panel): void
+    {
+        $panel
+            ->discoverResources(
+                in: __DIR__.'/Filament/Resources',
+                for: 'Modules\Cms\Filament\Resources',
+            )
+            ->discoverPages(
+                in: __DIR__.'/Filament/Pages',
+                for: 'Modules\Cms\Filament\Pages',
+            )
+            ->discoverWidgets(
+                in: __DIR__.'/Filament/Widgets',
+                for: 'Modules\Cms\Filament\Widgets',
+            );
+    }
+
+    public function boot(Panel $panel): void {}
+
+    public static function make(): static
+    {
+        return app(static::class);
+    }
+}

app-modules/cms/src/Filament/Resources/CmsPages/CmsPageResource.php

@@ -0,0 +1,51 @@
+<?php
+
+namespace Modules\Cms\Filament\Resources\CmsPages;
+
+use BackedEnum;
+use Filament\Resources\Resource;
+use Filament\Schemas\Schema;
+use Filament\Support\Icons\Heroicon;
+use Filament\Tables\Table;
+use Modules\Cms\Filament\Resources\CmsPages\Pages\CreateCmsPage;
+use Modules\Cms\Filament\Resources\CmsPages\Pages\EditCmsPage;
+use Modules\Cms\Filament\Resources\CmsPages\Pages\ListCmsPages;
+use Modules\Cms\Filament\Resources\CmsPages\Schemas\CmsPageForm;
+use Modules\Cms\Filament\Resources\CmsPages\Tables\CmsPagesTable;
+use Modules\Cms\Models\CmsPage;
+use UnitEnum;
+
+class CmsPageResource extends Resource
+{
+    protected static ?string $model = CmsPage::class;
+
+    protected static string|BackedEnum|null $navigationIcon = Heroicon::OutlinedDocumentText;
+
+    protected static string|UnitEnum|null $navigationGroup = 'CMS';
+
+    public static function form(Schema $schema): Schema
+    {
+        return CmsPageForm::configure($schema);
+    }
+
+    public static function table(Table $table): Table
+    {
+        return CmsPagesTable::configure($table);
+    }
+
+    public static function getRelations(): array
+    {
+        return [
+            //
+        ];
+    }
+
+    public static function getPages(): array
+    {
+        return [
+            'index' => ListCmsPages::route('/'),
+            'create' => CreateCmsPage::route('/create'),
+            'edit' => EditCmsPage::route('/{record}/edit'),
+        ];
+    }
+}

app-modules/cms/src/Filament/Resources/CmsPages/Pages/CreateCmsPage.php

@@ -0,0 +1,11 @@
+<?php
+
+namespace Modules\Cms\Filament\Resources\CmsPages\Pages;
+
+use Filament\Resources\Pages\CreateRecord;
+use Modules\Cms\Filament\Resources\CmsPages\CmsPageResource;
+
+class CreateCmsPage extends CreateRecord
+{
+    protected static string $resource = CmsPageResource::class;
+}

app-modules/cms/src/Filament/Resources/CmsPages/Pages/EditCmsPage.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace Modules\Cms\Filament\Resources\CmsPages\Pages;
+
+use Filament\Actions\DeleteAction;
+use Filament\Resources\Pages\EditRecord;
+use Modules\Cms\Filament\Resources\CmsPages\CmsPageResource;
+
+class EditCmsPage extends EditRecord
+{
+    protected static string $resource = CmsPageResource::class;
+
+    protected function getHeaderActions(): array
+    {
+        return [
+            DeleteAction::make(),
+        ];
+    }
+}

app-modules/cms/src/Filament/Resources/CmsPages/Pages/ListCmsPages.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace Modules\Cms\Filament\Resources\CmsPages\Pages;
+
+use Filament\Actions\CreateAction;
+use Filament\Resources\Pages\ListRecords;
+use Modules\Cms\Filament\Resources\CmsPages\CmsPageResource;
+
+class ListCmsPages extends ListRecords
+{
+    protected static string $resource = CmsPageResource::class;
+
+    protected function getHeaderActions(): array
+    {
+        return [
+            CreateAction::make(),
+        ];
+    }
+}

app-modules/cms/src/Filament/Resources/CmsPages/Schemas/CmsPageForm.php

@@ -0,0 +1,40 @@
+<?php
+
+namespace Modules\Cms\Filament\Resources\CmsPages\Schemas;
+
+use Filament\Forms\Components\RichEditor;
+use Filament\Forms\Components\TextInput;
+use Filament\Forms\Components\Toggle;
+use Filament\Schemas\Schema;
+
+class CmsPageForm
+{
+    public static function configure(Schema $schema): Schema
+    {
+        return $schema
+            ->components([
+                TextInput::make('meta_tags')
+                    ->maxLength(255),
+                TextInput::make('meta_keywords')
+                    ->maxLength(255),
+                TextInput::make('page')
+                    ->required()
+                    ->unique(ignoreRecord: true)
+                    ->maxLength(255)
+                    ->helperText('Unique key used to look up this page, e.g. "miniapp_faq".'),
+                TextInput::make('title')
+                    ->required()
+                    ->maxLength(255),
+                TextInput::make('mm_title')
+                    ->required()
+                    ->maxLength(255),
+                RichEditor::make('content')
+                    ->columnSpanFull(),
+                RichEditor::make('mm_content')
+                    ->columnSpanFull(),
+                Toggle::make('is_active')
+                    ->required()
+                    ->default(true),
+            ]);
+    }
+}

app-modules/cms/src/Filament/Resources/CmsPages/Tables/CmsPagesTable.php

@@ -0,0 +1,46 @@
+<?php
+
+namespace Modules\Cms\Filament\Resources\CmsPages\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 CmsPagesTable
+{
+    public static function configure(Table $table): Table
+    {
+        return $table
+            ->columns([
+                TextColumn::make('page')
+                    ->searchable()
+                    ->sortable(),
+                TextColumn::make('title')
+                    ->searchable(),
+                TextColumn::make('mm_title')
+                    ->searchable(),
+                IconColumn::make('is_active')
+                    ->boolean(),
+                TextColumn::make('created_at')
+                    ->dateTime()
+                    ->sortable()
+                    ->toggleable(isToggledHiddenByDefault: true),
+            ])
+            ->defaultSort('created_at', 'desc')
+            ->filters([
+                TernaryFilter::make('is_active'),
+            ])
+            ->recordActions([
+                EditAction::make(),
+            ])
+            ->toolbarActions([
+                BulkActionGroup::make([
+                    DeleteBulkAction::make(),
+                ]),
+            ]);
+    }
+}

app-modules/cms/src/Http/Controllers/CmsPageController.php

@@ -0,0 +1,28 @@
+<?php
+
+namespace Modules\Cms\Http\Controllers;
+
+use Illuminate\Http\Resources\Json\AnonymousResourceCollection;
+use Illuminate\Routing\Controller;
+use Modules\Cms\Http\Resources\CmsPageResource;
+use Modules\Cms\Models\CmsPage;
+
+class CmsPageController extends Controller
+{
+    public function index(): AnonymousResourceCollection
+    {
+        return CmsPageResource::collection(
+            CmsPage::query()->where('is_active', true)->paginate()
+        );
+    }
+
+    public function show(string $page): CmsPageResource
+    {
+        $cmsPage = CmsPage::query()
+            ->where('page', $page)
+            ->where('is_active', true)
+            ->firstOrFail();
+
+        return new CmsPageResource($cmsPage);
+    }
+}

app-modules/cms/src/Http/Resources/CmsPageResource.php

@@ -0,0 +1,28 @@
+<?php
+
+namespace Modules\Cms\Http\Resources;
+
+use Illuminate\Http\Request;
+use Illuminate\Http\Resources\Json\JsonResource;
+
+class CmsPageResource extends JsonResource
+{
+    /**
+     * Transform the resource into an array.
+     *
+     * @return array<string, mixed>
+     */
+    public function toArray(Request $request): array
+    {
+        return [
+            'id' => $this->id,
+            'page' => $this->page,
+            'title' => $this->title,
+            'mm_title' => $this->mm_title,
+            'meta_tags' => $this->meta_tags,
+            'meta_keywords' => $this->meta_keywords,
+            'content' => $this->content,
+            'mm_content' => $this->mm_content,
+        ];
+    }
+}

app-modules/cms/src/Models/CmsPage.php

@@ -0,0 +1,53 @@
+<?php
+
+namespace Modules\Cms\Models;
+
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Modules\Cms\Database\Factories\CmsPageFactory;
+use Spatie\Activitylog\Models\Concerns\LogsActivity;
+use Spatie\Activitylog\Support\LogOptions;
+
+class CmsPage extends Model
+{
+    /** @use HasFactory<CmsPageFactory> */
+    use HasFactory, LogsActivity;
+
+    /**
+     * Full CRUD audit trail — CMS content writes are staff-only and
+     * infrequent, so logging every attribute change is affordable
+     * (domain.md §6; T6.2).
+     */
+    public function getActivitylogOptions(): LogOptions
+    {
+        return LogOptions::defaults()
+            ->logFillable()
+            ->logOnlyDirty()
+            ->dontLogEmptyChanges()
+            ->useLogName('cms');
+    }
+
+    /**
+     * @var list<string>
+     */
+    protected $fillable = [
+        'page',
+        'title',
+        'mm_title',
+        'meta_tags',
+        'meta_keywords',
+        'content',
+        'mm_content',
+        'is_active',
+    ];
+
+    /**
+     * @return array<string, string>
+     */
+    protected function casts(): array
+    {
+        return [
+            'is_active' => 'boolean',
+        ];
+    }
+}

app-modules/cms/src/Providers/CmsServiceProvider.php

@@ -0,0 +1,12 @@
+<?php
+
+namespace Modules\Cms\Providers;
+
+use Illuminate\Support\ServiceProvider;
+
+class CmsServiceProvider extends ServiceProvider
+{
+    public function register(): void {}
+
+    public function boot(): void {}
+}