a620906209
4baa4cb52b
後端：
- Migration：diving_offers 新增 cover_image 欄位、新增 course_images 表（含索引）
- CourseImage Model（CREATED_AT、url accessor）
- DivingOffer：cover_image_url accessor、hasMany courseImages、static::deleting() 孤兒清理
- CourseImageController：封面上傳/刪除、相簿上傳（max 3）/刪除，統一 mimes+size 驗證
- DivingOfferController：index/show 回傳加入 cover_image_url 與 images 陣列
- 修正 APP_URL 加入 port（:8080），Storage::url() 才能產生正確圖片連結
前端：
- courseImageApi.js：uploadCover/deleteCover/uploadImage/deleteImage
- CourseCard：有封面顯示 <img>，無封面顯示漸層佔位
- CourseDetailView：封面大圖 + 相簿縮圖橫列（點擊開新分頁）
- OfferFormView（編輯模式）：封面預覽/更換/刪除、相簿縮圖管理（達 3 張隱藏上傳按鈕）
基礎設施：
- docker-entrypoint.sh：加入 storage:link --force
- docker-compose.yml：移除 storage-data named volume（改用 bind mount，避免 Nginx 讀不到圖片）
測試：
- CourseImageTest.php：14 個 Feature Test 全部 PASS（Storage::fake）
涵蓋：上傳成功/格式驗證/大小驗證/所有權、刪除/無封面不報錯、
相簿上限/sort_order 遞增、孤兒清理
OpenSpec：
- course-images change 歸檔至 archive/2026-05-12-course-images
- 新增 specs/course-image-upload 主規格（含 bind mount 持久化說明）
Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
77 lines
2.2 KiB
PHP
77 lines
2.2 KiB
PHP
<?php
|
|
|
|
namespace App\Http\Controllers\API;
|
|
|
|
use App\Http\Controllers\Controller;
|
|
use App\Models\DivingOffer;
|
|
use Illuminate\Http\Request;
|
|
|
|
class DivingOfferController extends Controller
|
|
{
|
|
public function index(Request $request)
|
|
{
|
|
$perPage = min((int) $request->query('per_page', 12), 50);
|
|
|
|
$query = DivingOffer::query();
|
|
|
|
if ($q = $request->query('q')) {
|
|
$query->where(function ($sub) use ($q) {
|
|
$sub->where('title', 'like', "%{$q}%")
|
|
->orWhere('location', 'like', "%{$q}%")
|
|
->orWhere('spot', 'like', "%{$q}%");
|
|
});
|
|
}
|
|
|
|
if ($region = $request->query('region')) {
|
|
$query->where('region', $region);
|
|
}
|
|
|
|
if ($tag = $request->query('tag')) {
|
|
$query->where('tag', 'like', "%{$tag}%");
|
|
}
|
|
|
|
$paginated = $query->paginate($perPage);
|
|
|
|
$items = collect($paginated->items())->map(fn($o) => $this->formatOffer($o, false));
|
|
|
|
return response()->json([
|
|
'status' => true,
|
|
'data' => $items,
|
|
'meta' => [
|
|
'total' => $paginated->total(),
|
|
'per_page' => $paginated->perPage(),
|
|
'current_page' => $paginated->currentPage(),
|
|
'last_page' => $paginated->lastPage(),
|
|
],
|
|
]);
|
|
}
|
|
|
|
public function show(int $id)
|
|
{
|
|
$offer = DivingOffer::with('courseImages')->find($id);
|
|
|
|
if (!$offer) {
|
|
return response()->json(['status' => false, 'message' => '課程不存在'], 404);
|
|
}
|
|
|
|
return response()->json(['status' => true, 'data' => $this->formatOffer($offer, true)]);
|
|
}
|
|
|
|
private function formatOffer(DivingOffer $offer, bool $withImages): array
|
|
{
|
|
$data = array_merge($offer->toArray(), [
|
|
'cover_image_url' => $offer->cover_image_url,
|
|
]);
|
|
|
|
if ($withImages) {
|
|
$data['images'] = $offer->courseImages->map(fn($img) => [
|
|
'id' => $img->id,
|
|
'url' => $img->url,
|
|
'sort_order' => $img->sort_order,
|
|
])->values();
|
|
}
|
|
|
|
return $data;
|
|
}
|
|
}
|