78 lines
6.2 KiB
Markdown
78 lines
6.2 KiB
Markdown
# AlterFlixHub
|
|
|
|
ไดเรกทอรีโรงหนังอิสระ/อาร์ตเฮาส์และกลุ่มคนฉายหนังในประเทศไทย — ค้นหาโรงตามชื่อ/จังหวัด/หมวดหมู่ ดูรายละเอียดการเดินทาง ที่ตั้ง และช่องทางติดต่อของแต่ละโรง พร้อมหลังบ้านสำหรับแก้ข้อมูลได้เองโดยไม่ต้องแตะโค้ด
|
|
|
|
Stack: **React Router 8 (SSR) + Vite 8 + Tailwind 4 + TypeScript** บน Agent-Native runtime (Node/h3) · ข้อมูลเก็บเป็นไฟล์ JSON ใน `data/` · สถิติแบบ privacy-first (ไม่มีคุกกี้ ไม่เก็บ IP)
|
|
|
|
## เริ่มใช้งาน
|
|
|
|
```bash
|
|
cp .env.example .env # ครั้งแรกเท่านั้น
|
|
pnpm install
|
|
pnpm dev # http://localhost:8080
|
|
```
|
|
|
|
| คำสั่ง | ทำอะไร |
|
|
|---|---|
|
|
| `pnpm typecheck` | ตรวจ TypeScript ทั้งโปรเจกต์ |
|
|
| `pnpm test` | รันสเปกทั้งหมด (vitest) |
|
|
| `pnpm build` / `pnpm start` | build / รันโปรดักชัน |
|
|
| `pnpm agent-native:doctor` | ตรวจสุขภาพโปรเจกต์ตามกฎของ framework |
|
|
|
|
## หน้าเว็บ
|
|
|
|
| Route | หน้า |
|
|
|---|---|
|
|
| `/` | หน้าแรก — ฮีโร่ค้นหา, แถบหมวด, กริดการ์ดโรงหนัง (รูปปกจาก `photos[0]` · **ลำดับการ์ดสลับเองทุกวัน** ไม่ให้ซ้ำตำแหน่งเดิม 2 วันติดกัน) |
|
|
| `/cinema/<slug>` | รายละเอียดโรง — แกลเลอรี, สรุป, การเดินทาง, สิ่งอำนวยความสะดวก, ที่ตั้ง (แผนที่), ติดต่อ/ชำระเงิน |
|
|
| `/about` | เกี่ยวกับเรา (เนื้อหาจากหลังบ้าน) |
|
|
| `/admin` | หลังบ้าน (5 แท็บ) — ดู [docs/admin-guide.md](docs/admin-guide.md) |
|
|
|
|
รองรับ **ไทย/อังกฤษ** สลับที่ header หรือ `?lang=en` (จำค่าไว้ใน cookie + localStorage)
|
|
|
|
## หลังบ้าน
|
|
|
|
`http://localhost:8080/admin` — ล็อกอินด้วย `ADMIN_USERNAME` / `ADMIN_PASSWORD` (ค่าเริ่มต้น `it is me` / `it is me&it is me`)
|
|
|
|
แก้ได้: โรงหนัง (ชื่อ/slug/หมวด/สิ่งอำนวยความสะดวก/การเดินทาง/ติดต่อ/รูปภาพ/ที่ตั้ง/คำอธิบาย) · หน้าเกี่ยวกับเรา · คำศัพท์ทุกคำในหน้าเว็บ · Footer · ดูสถิติการค้นหา
|
|
|
|
คู่มือทีละงาน: **[docs/admin-guide.md](docs/admin-guide.md)**
|
|
|
|
## โครงสร้าง
|
|
|
|
```
|
|
app/
|
|
routes/ _index (หน้าแรก) · cinema.$slug · about · admin / admin_.login
|
|
components/
|
|
site/ SiteShell · SiteHeader/Footer · Logo · CinemaCard · CinemaGrid
|
|
cinema/ Gallery · CinemaSummary · TransportList · FacilitiesSection · LocationPanel · ContactPanel
|
|
admin/ AdminSection · CinemaList · ChipPicker · CommaListInput · SlugInput · PhotosEditor ·
|
|
TransportEditor · ContactsEditor · CinemaFacilitiesEditor · AboutEditor
|
|
lib/ cinemas · content.server · map-embed · popularity.server · analytics.* · i18n/ · geo
|
|
server/
|
|
routes/api/ admin/* (login, content, import, analytics) · analytics/collect
|
|
data/
|
|
content/content.json แหล่งข้อมูลจริงของโรงหนัง/คำศัพท์/about (แก้ผ่านหลังบ้าน)
|
|
analytics/events.jsonl สถิติแบบ append-only
|
|
docs/
|
|
admin-guide.md คู่มือใช้งานหลังบ้าน (ภาษาไทย)
|
|
api.md API reference
|
|
architecture.html แผนผังการทำงาน Frontend/Backend/Data (เปิดด้วยเบราว์เซอร์)
|
|
DESIGN.md สัญญาการออกแบบ (บังคับ) — สี ฟอนต์ โลโก้ layout กติกาข้อมูล
|
|
AGENTS.md กฎสำหรับ agent/AI ที่แก้โค้ดโปรเจกต์นี้
|
|
```
|
|
|
|
## ข้อมูลและสถิติ
|
|
|
|
- โรงหนัง/คำศัพท์/หน้าเกี่ยวกับเรา เก็บที่ `data/content/content.json` (หลังบ้านเขียนแบบ atomic)
|
|
- สถิติเก็บที่ `data/analytics/events.jsonl` — event: `search`, `cinema_select`, `cinema_view`, `near_me`; ไม่ใช้คุกกี้ ไม่เก็บ IP/UA ดิบ
|
|
- หมวด "ยอดนิยม" จะเริ่มจัดอันดับจากสถิติจริงเมื่อข้อมูลครบ **6 เดือน** ก่อนหน้านั้นใช้ป้ายที่ตั้งมือ
|
|
- ตั้ง `ANALYTICS_SALT` ใน `.env` ก่อน deploy จริง
|
|
|
|
## เอกสารอื่น
|
|
|
|
- [DESIGN.md](DESIGN.md) — สัญญาการออกแบบ: พาเลตต์ ฟอนต์ โลโก้ layout ฟิลด์ข้อมูล และกติกากันข้อมูลหาย
|
|
- [docs/api.md](docs/api.md) — endpoint ทั้งหมด (method/path/auth/body)
|
|
- [docs/architecture.html](docs/architecture.html) — แผนผังการทำงาน
|
|
- [DEVELOPING.md](DEVELOPING.md) — คู่มือ framework ของ starter (ไม่ใช่ของเฉพาะโปรเจกต์นี้)
|