feat:實作課程圖片上傳 — 封面 + 相簿管理
後端:
- 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>
This commit is contained in:
@@ -32,9 +32,11 @@ class DivingOfferController extends Controller
|
||||
|
||||
$paginated = $query->paginate($perPage);
|
||||
|
||||
$items = collect($paginated->items())->map(fn($o) => $this->formatOffer($o, false));
|
||||
|
||||
return response()->json([
|
||||
'status' => true,
|
||||
'data' => $paginated->items(),
|
||||
'data' => $items,
|
||||
'meta' => [
|
||||
'total' => $paginated->total(),
|
||||
'per_page' => $paginated->perPage(),
|
||||
@@ -46,18 +48,29 @@ class DivingOfferController extends Controller
|
||||
|
||||
public function show(int $id)
|
||||
{
|
||||
$offer = DivingOffer::find($id);
|
||||
$offer = DivingOffer::with('courseImages')->find($id);
|
||||
|
||||
if (!$offer) {
|
||||
return response()->json([
|
||||
'status' => false,
|
||||
'message' => '課程不存在',
|
||||
], 404);
|
||||
return response()->json(['status' => false, 'message' => '課程不存在'], 404);
|
||||
}
|
||||
|
||||
return response()->json([
|
||||
'status' => true,
|
||||
'data' => $offer,
|
||||
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;
|
||||
}
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user