Files
web-alterflixhub/README.md
T
2026-11-01 17:24:44 +07:00

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 (ไม่ใช่ของเฉพาะโปรเจกต์นี้)