feat(admin): อัปโหลดรูปโรงหนังจากเครื่อง (เดิมใส่ได้แค่ URL)
- POST /api/admin/uploads (multipart, ≤8MB, ตรวจ magic bytes JPEG/PNG/WebP/AVIF) เก็บ data/uploads/cinemas/ คืน /uploads/cinemas/<slug>-<random>-<ts>.<ext> - GET /uploads/** เสิร์ฟไฟล์อัปโหลด (Nitro route, immutable cache, กัน path traversal) - PhotosEditor: ปุ่มอัปโหลด + ลากไฟล์มาวาง + Ctrl+V วางจากคลิปบอร์ด, หลายไฟล์พร้อมกัน - app/lib/upload.ts กติกากลาง + upload.spec.ts (13 tests) - docs: api.md, admin-guide.md (วิธีอัปโหลด), DESIGN.md, README
This commit is contained in:
1 parent
251932e548
commit
2c5918a614
10 files changed
+483
-22
No files matched your search
+8
-6
@@ -46,14 +46,16 @@
|
||||
|
||||
## 2. รูปภาพโรงหนัง
|
||||
|
||||
หมวด **การเดินทาง & การติดต่อ** → ส่วน **รูปภาพโรงหนัง** → **+ เพิ่มรูป**
|
||||
หมวด **การเดินทาง & การติดต่อ** → ส่วน **รูปภาพโรงหนัง** → **อัปโหลดรูปจากเครื่อง**
|
||||
|
||||
1. ใส่ URL (`https://…`) หรือ path ในโปรเจกต์ (`/images/ชื่อไฟล์.jpg`)
|
||||
2. **รูปแรก = รูปปกการ์ดหน้าแรก** และภาพหลักในแกลเลอรีหน้า detail
|
||||
3. มีไม่ครบ 3 รูป ช่องที่เหลือจะแสดงโลโก้ AlterFlixHub แทน
|
||||
4. สลับลำดับด้วย ↑ ↓ · ลบด้วยถังขยะ · แล้วกด **บันทึกทั้งหมด**
|
||||
1. กด **อัปโหลดรูปจากเครื่อง** แล้วเลือกไฟล์ (เลือกหลายไฟล์พร้อมกันได้) — หรือ **ลากไฟล์มาวาง** ในกล่องนั้น หรือ **Ctrl+V** วางรูปจากคลิปบอร์ด
|
||||
2. รองรับ **JPG / PNG / WebP / AVIF** ขนาดไม่เกิน **8 MB** ต่อไฟล์ · ไฟล์จะถูกเก็บที่ `data/uploads/cinemas/` และได้ URL รูปแบบ `/uploads/cinemas/<ไฟล์>` ใช้อ้างในหน้าเว็บได้ทันที
|
||||
3. ถ้าอยากใช้รูปที่วางบนเว็บอยู่แล้ว กด **เพิ่มช่อง URL** แล้ววางลิงก์ (`/images/…` หรือ URL เต็ม) — **ไม่แนะนำลิงก์จาก Google Maps/Facebook** เพราะลิงก์หมดอายุและทำให้รูปแตก
|
||||
4. **รูปแรก = รูปปกการ์ดหน้าแรก** และภาพหลักในแกลเลอรีหน้า detail — สลับลำดับด้วยปุ่ม ↑/↓
|
||||
5. มีไม่ครบ 3 รูป ช่องที่เหลือจะแสดงโลโก้ AlterFlixHub แทน
|
||||
6. อย่าลืมกด **บันทึก** ท้ายฟอร์ม — รูปจะขึ้นหน้าเว็บทันทีหลังบันทึก
|
||||
|
||||
ไฟล์ในเครื่อง: วางที่ `public/images/…` แล้วใส่ `/images/…`
|
||||
ไฟล์ในเครื่อง (สำหรับรูปที่เตรียมไว้ล่วงหน้า): วางที่ `public/images/…` แล้วใส่ `/images/…` · รูปที่อัปโหลดผ่านหลังบ้านจะอยู่ที่ `data/uploads/cinemas/` (สำรองข้อมูลแยกจาก repo)
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -8,6 +8,7 @@
|
||||
| Method | Path | Body / Query | ทำอะไร |
|
||||
|---|---|---|---|
|
||||
| POST | `/api/analytics/collect` | `{ type, locale, query?, category?, result_count?, slug?, source?, position? }` | รับ event สถิติ 1 ครั้ง — เซิร์ฟเวอร์เป็นผู้ใส่ `at` และ hash ผู้เข้าชม (`sha256(เกลือรายวัน \| ip \| ua)` 16 ตัวอักษร) ไม่ใช้คุกกี้ ไม่เก็บ IP/UA ดิบ |
|
||||
| GET | `/uploads/cinemas/<ไฟล์>` | — | เสิร์ฟรูปที่อัปโหลดจากหลังบ้าน (อ่านจาก `data/uploads/cinemas/`) · `Cache-Control: immutable` · กัน path traversal |
|
||||
|
||||
`type` ที่รองรับ: `search` · `cinema_select` · `cinema_view` · `near_me`
|
||||
|
||||
@@ -19,6 +20,7 @@
|
||||
| POST | `/api/admin/logout` | — | ลบคุกกี้ session |
|
||||
| GET | `/api/admin/session` | — | ตรวจว่ายังล็อกอินอยู่ |
|
||||
| GET | `/api/admin/content` | — | อ่าน `ContentStore` ทั้งก้อน (`cinemas`, `site`, `about`, `forCinemas`, `forFilmLovers`) |
|
||||
| POST | `/api/admin/uploads` | `multipart/form-data`: `file` (บังคับ, ≤ 8 MB), `slug` (ไม่บังคับ) | อัปโหลดรูปโรงหนัง — ตรวจชนิดจริงจาก magic bytes (JPEG/PNG/WebP/AVIF) เก็บที่ `data/uploads/cinemas/` คืน `{ url, bytes, type }` โดย `url` = `/uploads/cinemas/<ไฟล์>` |
|
||||
| PUT | `/api/admin/content` | `{ cinemas?, site?, about?, forCinemas?, forFilmLovers? }` | บันทึกเฉพาะส่วนที่ส่งมา — ผ่าน `sanitizeCinemas` / `sanitizeSite` / `sanitizeAbout` / `sanitizeForCinemas` / `sanitizeForFilmLovers` แล้วเขียนไฟล์แบบ atomic |
|
||||
| POST | `/api/admin/cinemas/import` | `{ cinemas: Cinema[] }` หรือรายการเดียว | นำเข้าโรงหนังโดยใช้ slug เป็นกุญแจ (มีอยู่ = ทับ) |
|
||||
| GET | `/api/admin/analytics` | `?days=1\|7\|30\|90` | สรุปสถิติ (`summarize()`) — คำค้นยอดนิยม, คำค้นไม่พบผล, CTR, โรงที่ถูกเปิด/คลิก |
|
||||
|
||||
Reference in new issue
Block a user