ablums

app/Filament/AlbumCategoryResource.php

@@ -0,0 +1,87 @@
+<?php
+
+namespace App\Filament\Resources;
+
+use App\Filament\Resources\AlbumCategoryResource\Pages;
+use App\Filament\Resources\AlbumCategoryResource\RelationManagers;
+use App\Models\AlbumCategory;
+use Filament\Forms;
+use Filament\Forms\Components\Actions\Action;
+use Filament\Forms\Components\Section;
+use Filament\Forms\Components\TextInput;
+use Filament\Forms\Form;
+use Filament\Resources\Resource;
+use Filament\Tables;
+use Filament\Tables\Columns\TextColumn;
+use Filament\Tables\Table;
+use Illuminate\Database\Eloquent\Builder;
+use Illuminate\Database\Eloquent\SoftDeletingScope;
+use SolutionForest\FilamentTranslateField\Forms\Component\Translate;
+use App\Service\DeepLService;
+
+class AlbumCategoryResource extends Resource
+{
+    protected static ?string $model = AlbumCategory::class;
+    protected static ?string $modelLabel = "影音類別管理";
+    protected static ?string $navigationIcon = 'heroicon-o-rectangle-group';
+    protected static ?string $navigationGroup = '上稿內容管理';
+    protected static ?string $navigationLabel = "影音類別管理";
+
+    public static function form(Form $form): Form
+    {
+        return $form
+            ->schema([
+                //
+                Section::make("")->schema([
+                    Translate::make()->schema(fn (string $locale) => [
+                        TextInput::make('name')->required($locale == 'zh_TW')->maxLength(40)->label("分類名稱")
+                    ])
+                    ->locales(["zh_TW", "en", "jp"])
+                    ->actions([
+                        app(DeepLService::class)->createTranslationAction("Main", ["name"])
+                    ])->columnSpan(5),
+                    TextInput::make('order')->label("排序")->integer()->default(0)->columnSpan(1)
+                ])->columns(4)
+            ]);
+    }
+
+    public static function table(Table $table): Table
+    {
+        return $table
+            ->columns([
+                TextColumn::make('name')->label("分類名稱"),
+                TextColumn::make(name: 'created_at')->label("建立時間")->date(),
+                TextColumn::make('updated_at')->label("更新時間")->date()
+            ])
+            ->filters([
+                //
+            ])
+            ->actions([
+                // Tables\Actions\ViewAction::make(),
+                Tables\Actions\EditAction::make(),
+                Tables\Actions\DeleteAction::make()
+            ])
+            ->bulkActions([
+                Tables\Actions\BulkActionGroup::make([
+                    Tables\Actions\DeleteBulkAction::make(),
+                ]),
+            ])
+            ->defaultSort('order', 'desc');
+    }
+
+    public static function getRelations(): array
+    {
+        return [
+            //
+        ];
+    }
+
+    public static function getPages(): array
+    {
+        return [
+            'index' => Pages\ListAlbumCategories::route('/'),
+            'create' => Pages\CreateAlbumCategory::route('/create'),
+            'edit' => Pages\EditAlbumCategory::route('/{record}/edit'),
+        ];
+    }
+}

app/Filament/AlbumCategoryResource/Pages/CreateAlbumCategory.php

@@ -0,0 +1,17 @@
+<?php
+
+namespace App\Filament\Resources\AlbumCategoryResource\Pages;
+
+use App\Filament\Resources\AlbumCategoryResource;
+use Filament\Actions;
+use Filament\Resources\Pages\CreateRecord;
+
+class CreateAlbumCategory extends CreateRecord
+{
+    protected static string $resource = AlbumCategoryResource::class;
+    protected static bool $canCreateAnother = false;
+    protected function getRedirectUrl(): string
+    {
+        return $this->getResource()::getUrl('index');
+    }
+}

app/Filament/AlbumCategoryResource/Pages/EditAlbumCategory.php

@@ -0,0 +1,23 @@
+<?php
+
+namespace App\Filament\Resources\AlbumCategoryResource\Pages;
+
+use App\Filament\Resources\AlbumCategoryResource;
+use Filament\Actions;
+use Filament\Resources\Pages\EditRecord;
+
+class EditAlbumCategory extends EditRecord
+{
+    protected static string $resource = AlbumCategoryResource::class;
+
+    protected function getHeaderActions(): array
+    {
+        return [
+            // Actions\DeleteAction::make(),
+        ];
+    }
+    protected function getRedirectUrl(): string
+    {
+        return $this->getResource()::getUrl('index');
+    }
+}

app/Filament/AlbumCategoryResource/Pages/ListAlbumCategories.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace App\Filament\Resources\AlbumCategoryResource\Pages;
+
+use App\Filament\Resources\AlbumCategoryResource;
+use Filament\Actions;
+use Filament\Resources\Pages\ListRecords;
+
+class ListAlbumCategories extends ListRecords
+{
+    protected static string $resource = AlbumCategoryResource::class;
+
+    protected function getHeaderActions(): array
+    {
+        return [
+            Actions\CreateAction::make()->label("新增"),
+        ];
+    }
+}

app/Filament/AlbumCategoryResource/Pages/ViewAlbumCategory.php

@@ -0,0 +1,12 @@
+<?php
+
+namespace App\Filament\Resources\AlbumCategoryResource\Pages;
+
+use App\Filament\Resources\AlbumCategoryResource;
+use Filament\Actions;
+use Filament\Resources\Pages\ViewRecord;
+
+class ViewAlbumCategory extends ViewRecord
+{
+    protected static string $resource = AlbumCategoryResource::class;
+}

app/Filament/AlbumResource.php

@@ -0,0 +1,202 @@
+<?php
+
+namespace App\Filament\Resources;
+
+use App\Filament\Resources\AlbumResource\Pages;
+use App\Filament\Resources\AlbumResource\RelationManagers;
+use App\Service\DeepLService;
+use App\Models\Album;
+use App\Models\AlbumCategory;
+use App\Models\NewsCategory;
+use Filament\Forms;
+use Filament\Forms\Components\Actions\Action;
+use Filament\Forms\Components\DatePicker;
+use Filament\Forms\Components\DateTimePicker;
+use Filament\Forms\Components\FileUpload;
+use Filament\Forms\Components\Group;
+use Filament\Forms\Components\Radio;
+use Filament\Forms\Components\Section;
+use Filament\Forms\Components\Select;
+use Filament\Forms\Components\Textarea;
+use Filament\Forms\Components\TextInput;
+use Filament\Forms\Components\Toggle;
+use Filament\Forms\Form;
+use Filament\Forms\Get;
+use Filament\Resources\Resource;
+use Filament\Tables;
+use Filament\Tables\Columns\ImageColumn;
+use Filament\Tables\Columns\TextColumn;
+use Filament\Tables\Filters\QueryBuilder;
+use Filament\Tables\Filters\QueryBuilder\Constraints\SelectConstraint;
+use Filament\Tables\Filters\QueryBuilder\Constraints\TextConstraint;
+use Filament\Tables\Filters\SelectFilter;
+use Filament\Tables\Table;
+use Illuminate\Database\Eloquent\Builder;
+use Illuminate\Database\Eloquent\Collection;
+use Illuminate\Database\Eloquent\SoftDeletingScope;
+use Illuminate\Support\Facades\DB;
+use SolutionForest\FilamentTranslateField\Forms\Component\Translate;
+
+class AlbumResource extends Resource
+{
+    protected static ?string $model = Album::class;
+    protected static ?string $modelLabel = "影音管理";
+    protected static ?string $navigationIcon = 'heroicon-o-photo';
+    protected static ?string $navigationGroup = '上稿內容管理';
+    protected static ?string $navigationLabel = "影音管理";
+
+    public static function form(Form $form): Form
+    {
+        return $form
+            ->schema([
+                Section::make("新增 影音")->schema([
+                    Group::make()->schema([
+                        Select::make("album_category_id")
+                        ->options(AlbumCategory::orderBy("order")->get()->pluck("name","id"))
+                        ->label("影音分類")
+                        ->required()
+                        ->columnSpan(1)
+                        ->native(false)
+                        ->Live(),
+                    ])->columnSpanFull()->columns(2),
+                    Group::make()->schema([
+                        DatePicker::make('post_date')
+                        ->label("發布日期")
+                        ->closeOnDateSelection(),
+                    ])->columnSpanFull()->columns(2),
+                    FileUpload::make('news_banner')->label("列表大圖")
+                    ->disk("s3")
+                    ->directory("album/img")
+                    ->helperText('建議寬高限制為:2000*720px，出血寬度720px，主要圖像範圍為:1280*720px，檔案大小限制為1M以下')->maxSize('1024'),
+                    FileUpload::make('news_img_pc')->label("列表圖(desktop)")
+                    ->disk("s3")
+                    ->directory("album/img")
+                    ->helperText('建議寬高限制為:1280*720px，檔案大小限制為1M以下')->maxSize('1024'),
+                    FileUpload::make('news_img_mobile')->label("列表圖(mobile)")
+                    ->disk("s3")
+                    ->directory("album/img")
+                    ->helperText('建議寬高限制為:600x896px，檔案大小限制為1M以下')->maxSize('1024'),
+                    Translate::make()->schema(fn (string $locale) => [
+                        TextInput::make('title')
+                        ->label("標題")
+                        ->columnSpan(1),
+                    ])
+                    ->locales(["zh_TW", "en", "jp"])
+                    ->actions([
+                        app(DeepLService::class)->createTranslationAction("Main", ["title"])
+                    ])
+                    ->id("main")->columnSpanFull()->columns(3),
+
+                    Section::make("")->schema([
+                        Radio::make("upload_type")->label("")->options([
+                            1 => "網址",
+                            2 => "檔案"
+                        ])->columnSpanFull()->default(1)->Live(),
+                        Group::make()->schema([
+                            TextInput::make('link_video')->label("網址")->nullable(),
+                        ])->visible(fn (Get $get):bool => $get("upload_type") == 1)->columnSpanFull(),
+                        Group::make()->schema([
+                            FileUpload::make('link_upload')->label("")->disk("s3")->directory("album/video")
+                            ->helperText('建議影片寬高限制為:1920*1080px，出血寬度720px，大小限制為:100M以下')
+                            ->maxSize(102400)->nullable(),
+                        ])->visible(fn (Get $get):bool => $get("upload_type") == 2)->columnSpanFull(),
+                    ])->columnSpanFull(),
+                    Toggle::make("on_top")->inline()->label("置頂輪播")->columnSpanFull(),
+                    Toggle::make("homepage_top")->inline()->label("在首頁輪播")->columnSpanFull(),
+                    TextInput::make('order')->label("排序")->integer()->default(0),
+                ])->columns(3),
+            ]);
+    }
+
+    public static function table(Table $table): Table
+    {
+        return $table
+            ->columns([
+                //
+                TextColumn::make("albumCategory.name")->label("分類")->alignCenter(),
+                TextColumn::make("title")->label("標題")->alignCenter(),
+                TextColumn::make("post_date")->date()->alignCenter(),
+                ImageColumn::make("news_img_pc")->disk('s3')->alignCenter(),
+                TextColumn::make("list_audit_state")->label("狀態")->badge()
+                ->color(fn (string $state): string => match ($state) {
+                    '暫存' => 'warning',
+                    '已發佈' => 'success',
+                }),
+                TextColumn::make("created_at")->label("建立時間")->dateTime()->alignCenter(),
+                TextColumn::make("updated_at")->label("更新時間")->dateTime()->alignCenter(),
+            ])
+            ->filters([
+                SelectFilter::make('post_date')->label("年份")
+                ->options(Album::select(DB::raw("DATE_FORMAT(post_date, '%Y') as year"))->whereNotNull("post_date")->distinct()->pluck("year","year")->toArray())
+                ->query(
+                    fn (array $data, Builder $query): Builder =>
+                    $query->when(
+                        $data['value'],
+                        fn (Builder $query, $value): Builder => $query->where('post_date', 'like', $data['value']. "%")
+                    )
+                ),
+                SelectFilter::make('album_category_id')->label("分類")
+                ->relationship('albumCategory', 'name')
+                ->getOptionLabelFromRecordUsing(fn($record, $livewire) => $record->getTranslation('name', "zh_TW")),
+                SelectFilter::make('visible')->label("狀態")
+                ->options([
+                    0 => "暫存",
+                    1 => "已發佈",
+                ])
+                ->query(
+                    fn (array $data, Builder $query): Builder =>
+                    $query->when(
+                        $data['value'],
+                        fn (Builder $query, $value): Builder => $query->where('visible', $data['value'])
+                    )
+                ),
+            ])
+            ->actions([
+                Tables\Actions\EditAction::make(),
+                Tables\Actions\DeleteAction::make(),
+                \Filament\Tables\Actions\Action::make("audit")
+                ->label(fn ($record) => match ($record->visible) {
+                    0 => '發佈',
+                    1 => '下架',
+                })
+                ->color(fn ($record) => match ($record->visible) {
+                    0 => 'warning',
+                    1 => 'gray',
+                })
+                ->icon(fn ($record) => match ($record->visible) {
+                    0 => 'heroicon-m-chevron-double-up',
+                    1 => 'heroicon-m-chevron-double-down',
+                })
+                ->action(function ($record) {
+                    $record->visible = !$record->visible;
+                    $record->save();
+                })
+                ->outlined()
+                ->requiresConfirmation(),
+            ])
+            ->bulkActions([
+                Tables\Actions\BulkActionGroup::make([
+                    Tables\Actions\DeleteBulkAction::make(),
+                ]),
+            ])
+            ->defaultSort('order', 'desc')
+            ->defaultSort('created_at', 'desc');
+    }
+
+    public static function getRelations(): array
+    {
+        return [
+            //
+        ];
+    }
+
+    public static function getPages(): array
+    {
+        return [
+            'index' => Pages\ListAlbums::route('/'),
+            'create' => Pages\CreateAlbum::route('/create'),
+            'edit' => Pages\EditAlbum::route('/{record}/edit'),
+            'view' => Pages\ViewAlbum::route('/{record}/view'),
+        ];
+    }
+}

app/Filament/AlbumResource/Pages/CreateAlbum.php

@@ -0,0 +1,31 @@
+<?php
+
+namespace App\Filament\Resources\AlbumResource\Pages;
+
+use App\Filament\Resources\AlbumResource;
+use App\Models\Album;
+use Filament\Actions;
+use Filament\Resources\Pages\CreateRecord;
+use Illuminate\Database\Eloquent\Model;
+
+class CreateAlbum extends CreateRecord
+{
+    protected static string $resource = AlbumResource::class;
+    protected static bool $canCreateAnother = false;
+
+    protected function getRedirectUrl(): string
+    {
+        return $this->getResource()::getUrl('index');
+    }
+    protected function handleRecordCreation(array $data): Model
+    {
+        $data['link'] = "";
+        if($data["upload_type"] == 1){
+            $data['link'] = $data["link_video"];
+        }elseif($data["upload_type"] == 2){
+            $data['link'] = $data["link_upload"];
+        }
+
+        return static::getModel()::create($data);
+    }
+}

app/Filament/AlbumResource/Pages/EditAlbum.php

@@ -0,0 +1,40 @@
+<?php
+
+namespace App\Filament\Resources\AlbumResource\Pages;
+
+use App\Filament\Resources\AlbumResource;
+use App\Models\Album;
+use Filament\Actions;
+use Filament\Resources\Pages\EditRecord;
+use Illuminate\Database\Eloquent\Model;
+
+class EditAlbum extends EditRecord
+{
+    protected static string $resource = AlbumResource::class;
+
+    protected function getHeaderActions(): array
+    {
+        return [
+            // Actions\DeleteAction::make(),
+        ];
+    }
+    protected function mutateFormDataBeforeFill(array $data): array
+    {
+        if($data["upload_type"] == 1){
+            $data['link_video'] = $data["link"];
+        }elseif($data["upload_type"] == 2){
+            $data['link_upload'] = $data["link"];
+        }
+        return $data;
+    }
+    protected function handleRecordUpdate(Model $record, array $data): Model
+    {
+        if($data["upload_type"] == 1){
+            $data['link'] = $data["link_video"];
+        }elseif($data["upload_type"] == 2){
+            $data['link'] = $data["link_upload"];
+        }
+        $record->update($data);
+        return $record;
+    }
+}

app/Filament/AlbumResource/Pages/ListAlbums.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace App\Filament\Resources\AlbumResource\Pages;
+
+use App\Filament\Resources\AlbumResource;
+use Filament\Actions;
+use Filament\Resources\Pages\ListRecords;
+
+class ListAlbums extends ListRecords
+{
+    protected static string $resource = AlbumResource::class;
+
+    protected function getHeaderActions(): array
+    {
+        return [
+            Actions\CreateAction::make()->label("新增"),
+        ];
+    }
+}

app/Filament/AlbumResource/Pages/ViewAlbum.php

@@ -0,0 +1,12 @@
+<?php
+
+namespace App\Filament\Resources\AlbumResource\Pages;
+
+use App\Filament\Resources\AlbumResource;
+use Filament\Actions;
+use Filament\Resources\Pages\ViewRecord;
+
+class ViewAlbum extends ViewRecord
+{
+    protected static string $resource = AlbumResource::class;
+}

app/Http/Controllers/Api/AlbumController.php

@@ -0,0 +1,82 @@
+<?php
+
+namespace App\Http\Controllers\Api;
+
+use App\Http\Controllers\Controller;
+use App\Models\Album;
+use App\Models\AlbumCategory;
+use App\Supports\Response;
+use Carbon\Carbon;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Log;
+
+/**
+ * @group Lottery Prize
+ */
+class AlbumController extends Controller
+{
+    public function __construct(
+    )
+    {
+    }
+
+    public function list(Request $request, $locate = 'tw')
+    {
+        $categoryId = $request->input("categoryId") ?? "";
+        $locate = $locate == "tw" ? "zh_TW" : $locate;
+        $result = [];
+
+        //年份清單
+        $yearList = Album::select(DB::raw("DATE_FORMAT(post_date, '%Y') as years"))->distinct()->orderBy("years", "desc")->pluck("years");
+        $result["yearList"] = $yearList;
+
+        //置頂影音
+        $topVideos = Album::where("visible", 1)->where("on_top", 1)->orderBy("order")->orderByDesc("post_date")->get();
+        foreach($topVideos as $topVideo){
+            $result["top"][] = [
+                "id" => $topVideo->id,
+                "categoryId" => $topVideo->albumCategory->id,
+                "category" => $topVideo->albumCategory->getTranslation("name", $locate),
+                "postDate" => Carbon::parse($topVideo->post_date)->format("Y.m.d"),
+                "title" => $topVideo->getTranslation("title", $locate),
+                "imgBanner" => $topVideo->album_img_banner_url,
+                "imgPC" => $topVideo->album_img_pc_url,
+                "imgMobile" => $topVideo->album_img_mobile_url,
+                "type" => $topVideo->album_upload_type,
+                "link" => $topVideo->album_video_link,
+            ];
+        }
+
+        //分類列表
+        $categoryList = AlbumCategory::orderByDesc('order')->orderByDesc('id')->get();
+        foreach($categoryList as $listItem){
+            $result["categoryList"][] = [
+                "id" => $listItem->id,
+                "name" => $listItem->getTranslation("name", $locate),
+            ];
+        }
+
+        //影音列表
+        $albums = Album::where("visible", 1);
+        if($categoryId){
+            $albums->where("album_category_id", $categoryId);
+        }
+        $albums = $albums->orderByDesc("order")->orderByDesc("post_date")->get();
+        foreach($albums as $item){
+            $result["list"][] = [
+                "id" => $item->id,
+                "categoryId" => $item->albumCategory->id,
+                "category" => $item->albumCategory->getTranslation("name", $locate),
+                "postDate" => Carbon::parse($item->post_date)->format("Y.m.d"),
+                "title" => $item->getTranslation("title", $locate),
+                "imgBanner" => $item->album_img_banner_url,
+                "imgPC" => $item->album_img_pc_url,
+                "imgMobile" => $item->album_img_mobile_url,
+                "type" => $item->album_upload_type,
+                "link" => $item->album_video_link,
+            ];
+        }
+        return Response::ok($result);
+    }
+}

app/Models/Album.php

@@ -0,0 +1,105 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Casts\Attribute;
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\SoftDeletes;
+use Illuminate\Support\Facades\Storage;
+use Spatie\Translatable\HasTranslations;
+
+class Album extends Model
+{
+    use HasFactory, SoftDeletes, HasTranslations;
+
+    protected $casts = [
+        'on_top' => 'boolean',
+        "list_audit_state" => "string"
+    ];
+
+    protected $guarded = ['id'];
+    protected $appends = ["album_img_pc_url", "album_img_pc_url", "album_img_banner_url", "album_img_mobile_url", "album_meta_img", "album_upload_type", "album_video_link"];
+
+    public $translatable = ['title', 'description', 'meta_title', 'meta_description', 'meta_keyword'];
+
+    public function albumCategory(){
+        return $this->belongsTo(AlbumCategory::class);
+    }
+    protected function albumImgPcUrl(): Attribute
+    {
+        return Attribute::make(
+            get: fn ($value) => is_null($this->news_img_pc) ? null :Storage::disk('s3')->url($this->news_img_pc),
+        );
+    }
+    protected function albumImgMobileUrl(): Attribute
+    {
+        return Attribute::make(
+            get: fn ($value) => is_null($this->news_img_mobile) ? null :Storage::disk('s3')->url($this->news_img_mobile),
+        );
+    }
+    protected function albumMetaImg(): Attribute
+    {
+        return Attribute::make(
+            get: fn ($value) => is_null($this->meta_img) ? null :Storage::disk('s3')->url($this->meta_img),
+        );
+    }
+    protected function albumImgBannerUrl(): Attribute
+    {
+        return Attribute::make(
+            get: fn ($value) => is_null($this->news_banner) ? null :Storage::disk('s3')->url($this->news_banner),
+        );
+    }
+    protected function albumUploadType(): Attribute
+    {
+        return Attribute::make(
+            get: fn ($value) => $this->attributes["upload_type"] == 1 ? "url" : "upload",
+        );
+    }
+
+    protected function listAuditState(): Attribute
+    {
+        return Attribute::make(
+            get: fn ($value) => $this->attributes["visible"] == 1 ? "已發佈" : "暫存",
+        );
+    }
+    protected function albumVideoLink(): Attribute
+    {
+        return Attribute::make(
+            get: fn ($value) => ($this->attributes["upload_type"] == 2) ? Storage::disk('s3')->url($this->attributes["link"]) : $this->attributes["link"],
+        );
+    }
+    public function homepageToTop()
+    {
+        return $this->morphOne(HomepageToTop::class, 'resource');
+    }
+    protected static function booted()
+    {
+        static::created(function ($album) {
+            if ($album->homepage_top) {
+                $album->createOrUpdatePageSet();
+            }
+        });
+
+        static::updated(function ($album) {
+            if ($album->isDirty('homepage_top')) {
+                if ($album->homepage_top) {
+                    $album->createOrUpdatePageSet();
+                } else {
+                    $album->homepageToTop()->delete();
+                }
+            }
+        });
+        static::deleted(function ($album) {
+                $album->homepageToTop()->delete();
+        });
+    }
+
+    protected function createOrUpdatePageSet()
+    {
+        $this->homepageToTop()->updateOrCreate(
+            [],
+            ['resource' => 'video']
+        );
+    }
+}

app/Models/AlbumCategory.php

@@ -0,0 +1,21 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\SoftDeletes;
+use Spatie\Translatable\HasTranslations;
+
+class AlbumCategory extends Model
+{
+    use HasFactory, SoftDeletes, HasTranslations;
+
+    protected $guarded = ['id'];
+
+    public $translatable = ['name'];
+
+    public function albums(){
+        return $this->hasMany(Album::class);
+    }
+}

database/migrations/2025_11_28_043724_create_album_categories_table.php

@@ -0,0 +1,30 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('album_categories', function (Blueprint $table) {
+            $table->id();
+            $table->string('name');
+            $table->unsignedInteger('order')->default(0)->comment("排序");
+            $table->timestamps();
+            $table->softDeletes();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('album_categories');
+    }
+};

database/migrations/2025_11_28_043727_create_albums_table.php

@@ -0,0 +1,46 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::disableForeignKeyConstraints();
+
+        Schema::create('albums', function (Blueprint $table) {
+            $table->id();
+            $table->unsignedBigInteger('album_category_id')->index();
+            $table->foreign('album_category_id')->references('id')->on('album_categories')->comment('類別');
+            $table->string('news_img_pc')->comment('列表圖 PC');
+            $table->string('news_img_mobile')->comment('列表圖 MOBILE');
+            $table->string('title')->comment("標題");
+            $table->dateTime('post_date')->comment("文章發布日");
+            $table->unsignedTinyInteger('upload_type')->comment('上傳類型 1.url 2.upload files');
+            $table->string('link')->comment('連結網址');
+            $table->string('meta_img')->nullable()->comment('seo image');
+            $table->string("meta_title")->comment("seo title");
+            $table->string("meta_description")->comment("seo description");
+            $table->boolean('on_top')->default(0)->comment("置頂");
+            $table->boolean('visible')->default(1)->comment("顯示/隱藏");
+            $table->unsignedInteger('order')->default(0)->comment("排序");
+            $table->timestamps();
+            $table->softDeletes();
+        });
+
+        Schema::enableForeignKeyConstraints();
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('albums');
+    }
+};

routes/api.php

@@ -37,6 +37,9 @@ Route::prefix('{locale}')->group(function (){
         Route::get('/{id}', [ProjectController::class, 'detail'])->whereIn('locale', ["tw", "en"])->where('id', '[0-9]+');
         Route::get('/badges', [ProjectController::class, 'badges']);
     });
+    Route::prefix('album')->group(function (){
+        Route::get('/list', [AlbumController::class, 'list']);
+    });
 
     Route::prefix("esg")->group(function () {
         Route::get("/histories", [EsgController::class, 'histories']);