reboot alterflixhub

This commit is contained in:
Bkk1234 committed 2026-11-01 17:24:44 +07:00
commit 1e84023a44
188 files changed
+31629

No files matched your search

+152
View File
@@ -0,0 +1,152 @@
# คู่มือใช้งานหลังบ้าน AlterFlixHub
คู่มือนี้ตอบคำถาม "แก้ตรงไหน" ทีละงาน — ทุกอย่างอยู่ใน `http://localhost:8080/admin`
(ล็อกอินด้วย `ADMIN_USERNAME` / `ADMIN_PASSWORD` ใน `.env`; ค่าเริ่มต้นคือ `it is me` / `it is me&it is me`)
หน้าหลังบ้านมี 5 แท็บ: **โรงหนัง · หน้าเกี่ยวกับเรา · คำศัพท์หลายภาษา · Footer / ไอคอน · สถิติการค้นหา**
---
## 1. เพิ่ม / แก้ไขโรงหนัง
แท็บ **โรงหนัง** → เลือกโรงจากรายการซ้าย (หรือกด **+ เพิ่มโรงหนัง**)
ฟอร์มแบ่งเป็น **หมวดพับได้** — คลิกหัวหมวดเพื่อกาง ทำทีละหมวดแล้วกด **บันทึกทั้งหมด** (แถบปุ่มติดล่างจอ):
| หมวด | มีอะไร |
|---|---|
| **ข้อมูลหลัก** | ชื่อ EN/TH · slug (URL) · ตัวเลือก "ซ่อนโรงนี้จากหน้าเว็บ" |
| **หมวดหมู่ & สิ่งอำนวยความสะดวก** | ชิปหมวด (เลือกได้หลายอัน) + ชิปหัวข้อสิ่งอำนวยความสะดวก + ช่องชื่อหัวข้อเฉพาะโรง |
| **การเดินทาง & การติดต่อ** | วิธีเดินทาง (icon/TH/EN) · หัวข้อ "สอบถามข้อมูลและจองตั๋ว" · ช่องทางติดต่อ (Website/Facebook/Call) · รูปภาพ · การชำระเงิน |
| **ที่ตั้ง & แผนที่** | ที่ตั้ง TH/EN · ละติจูด/ลองจิจูด · Google map URL · ที่อยู่ (บรรทัดละรายการ) |
| **คำอธิบายโรงหนัง** | คำอธิบาย TH/EN ที่แสดงใต้ชื่อโรง |
### slug (URL)
- ระบบ **ดึงจากชื่ออังกฤษให้อัตโนมัติ** จนกว่าคุณจะแก้เอง (แก้แล้วจะไม่ถูกทับ)
- พิมพ์อะไรก็ได้ระหว่างแก้ แต่ตอนออกจากช่องจะถูกจัดรูป: ตัวเล็ก, ช่องว่าง → `-`, ตัดอักขระอื่น
- ถ้า **ว่าง / ซ้ำกับโรงอื่น** ระบบไม่ยอมบันทึกและบอกเหตุผล
- ⚠️ เปลี่ยน slug แล้วลิงก์เดิมจะใช้ไม่ได้ (ยังไม่มี redirect)
### ซ่อนโรงหนัง
ติ๊ก **"ซ่อนโรงนี้จากหน้าเว็บ"** → หายจากหน้าแรก/ผลค้นหา/"โรงหนังอิสระอื่นๆ"
แต่เปิดดูด้วย URL ตรงได้ (ใช้เตรียมข้อมูลก่อนเปิดตัว) — เอาติ๊กออกแล้วบันทึกเพื่อกลับมาแสดง
### สลับลำดับโรงหนัง
รายการซ้ายมี 2 โหมด: **ลำดับที่จัดไว้** (ลากวาง หรือกด ↑ ↓) และ **ก.ไก่-ฮ.นกฮูก** (เรียงชื่อไทยให้ดู)
โหมดเรียง ก-ฮ เป็นแค่การดู — กด **ใช้ลำดับ ก-ฮ นี้** เพื่อเอาลำดับนั้นมาใช้จริง
เมื่อลำดับเปลี่ยนจะมีปุ่ม **บันทึกลำดับใหม่** (หรือกด "บันทึกทั้งหมด" ก็ได้)
> **หน้าแรกสลับการ์ดเองทุกวัน** — ลำดับที่จัดไว้จะถูกใช้เป็น "ลำดับฐาน" แล้วระบบหมุน/สลับให้อัตโนมัติ
> เพื่อไม่ให้โรงใดอยู่ตำแหน่งเดิมสองวันติดกัน (ทุกคนเห็นเหมือนกันในวันเดียวกัน) — รายละเอียดดู DESIGN.md หัวข้อ "ลำดับการ์ดหน้าแรก"
---
## 2. รูปภาพโรงหนัง
หมวด **การเดินทาง & การติดต่อ** → ส่วน **รูปภาพโรงหนัง** → **+ เพิ่มรูป**
1. ใส่ URL (`https://…`) หรือ path ในโปรเจกต์ (`/images/ชื่อไฟล์.jpg`)
2. **รูปแรก = รูปปกการ์ดหน้าแรก** และภาพหลักในแกลเลอรีหน้า detail
3. มีไม่ครบ 3 รูป ช่องที่เหลือจะแสดงโลโก้ AlterFlixHub แทน
4. สลับลำดับด้วย ↑ ↓ · ลบด้วยถังขยะ · แล้วกด **บันทึกทั้งหมด**
ไฟล์ในเครื่อง: วางที่ `public/images/…` แล้วใส่ `/images/…`
---
## 3. หมวดหมู่ (categories)
หมวด **หมวดหมู่ & สิ่งอำนวยความสะดวก** → กดชิปที่ต้องการ (เลือกได้หลายอัน) หรือพิมพ์เองในช่องใต้ชิป (คั่นด้วย `,`)
หมวดที่ใช้ได้ตอนนี้: ยอดนิยม · อาร์ตเฮาส์ · สารคดี · หนังสั้น · หนังคลาสสิก · หนังนานาชาติ · หนังนอกกระแส · หนังในกระแส · หนังฝรั่งเศส · **กลุ่มคนฉายหนัง** · **หนังไทย**
- แถบกรองหน้าแรกสร้างจากรายการเดียวกับชิปนี้
- อยากได้คำแปลหมวดอื่น → แท็บ **คำศัพท์หลายภาษา** → key `categories.<ชื่อหมวด>`
---
## 4. สิ่งอำนวยความสะดวก
1. ติ๊กชิปหัวข้อที่โรงนั้นมีจริง (โซนนั่งรอ, จุดจำหน่ายตั๋ว, ร้านอาหาร, …)
2. ใต้ชิปมีช่อง **ชื่อหัวข้อ** ของแต่ละหัวข้อ (ช่องเดียว ใช้ทั้ง TH/EN) — ว่าง = ใช้ชื่อเริ่มต้น
3. **คำอธิบาย (TH/EN)** จะแสดงเฉพาะโรง `house-cinema-samyan` (ข้อมูลครบแล้ว) — โรงอื่นไม่ต้องกรอก และหน้าเว็บจะไม่แสดงบรรทัดคำอธิบาย
4. ไม่ติ๊กเลย = หน้าเว็บขึ้น **"ไม่มีข้อมูล"**
---
## 5. การเดินทาง
หมวด **การเดินทาง & การติดต่อ** → **การเดินทาง**
- แต่ละแถว: วิธีเดินทาง (รถยนต์ส่วนตัว / รถไฟฟ้า / รถประจำทาง) + รายละเอียด TH + EN
- **+ เพิ่มวิธีเดินทาง** / ถังขยะลบ · แถวที่ยังไม่กรอกจะไม่แสดงบนหน้าเว็บ
---
## 6. การ์ด "สอบถามข้อมูลและจองตั๋ว" + ช่องทางติดต่อ
หมวด **การเดินทาง & การติดต่อ**
| อยากแก้ | ช่อง |
|---|---|
| หัวข้อการ์ด | "หัวข้อ 'สอบถามข้อมูลและจองตั๋ว' (เฉพาะโรงนี้)" — ว่าง = ใช้ค่ากลาง |
| Website / Facebook / Call | แถว **ช่องทางติดต่อ** → ป้ายชื่อ / ข้อความที่แสดง / ลิงก์ |
| เพิ่มช่องทางใหม่ | **+ เพิ่มช่องทางติดต่อ** (ป้ายชื่อมีตัวเลือกแนะนำ) |
| เบอร์โทรให้กดโทรได้ | ลิงก์ใส่ `tel:+668…` |
ค่ากลางของหัวข้อ (มีผลทุกโรงที่ไม่ได้กรอก) → แท็บ **คำศัพท์หลายภาษา** → `detail.contactTitle`
---
## 7. ที่ตั้งและแผนที่
หมวด **ที่ตั้ง & แผนที่**
- แผนที่ในหน้า detail เลือกแหล่งตามลำดับ: **Google map URL** → **พิกัด (ละติจูด/ลองจิจูด)** → ถ้าไม่มีทั้งคู่ขึ้น **"ไม่มีข้อมูล"**
- ใส่พิกัดเป็นทศนิยม (เช่น `13.7466` / `100.5347`) — `0` ถือว่ายังไม่กรอก
- ที่อยู่ใส่ "บรรทัดละรายการ" (ไม่ใช้ comma เพราะที่อยู่ EN มี comma)
---
## 8. การชำระเงิน
ช่อง **ชำระเงิน** (คั่นด้วย `,`) — ค่าเริ่มต้นของโรงใหม่คือ `เงินสด` และลบได้
พิมพ์ `,` ได้ตามปกติ (ระบบเก็บข้อความดิบระหว่างพิมพ์แล้วจัดรูปให้ตอนออกจากช่อง)
---
## 9. หน้า "เกี่ยวกับเรา"
แท็บ **หน้าเกี่ยวกับเรา** → เลือกภาษา (TH/EN) → แก้ `title`, `lead`, แต่ละหัวข้อ, หัวข้อ/ข้อความติดต่อ
มีตัวอย่างหน้าเว็บสด และปุ่ม **คืนค่าตั้งต้น** ต่อภาษา
---
## 10. คำศัพท์หลายภาษา / Footer
- **คำศัพท์หลายภาษา**: แก้ข้อความทุกจุดในหน้าเว็บด้วย key (เช่น `hero.subtitle`, `detail.contactTitle`) — เว้นว่าง = ใช้ค่าเดิมจาก `messages.ts`
- **Footer / ไอคอน**: เพิ่ม/แก้ไอคอนโซเชียล (ชื่อไอคอน Tabler เช่น `IconBrandFacebook`)
---
## 11. สถิติการค้นหา
แท็บ **สถิติการค้นหา** — เลือกช่วง 1 / 7 / 30 / 90 วัน: คำคันยอดนิยม, คำค้นที่ไม่พบผล, CTR, ผลลัพธ์เฉลี่ย, หมวดที่ถูกใช้, โรงที่ถูกเปิด/คลิก, การค้นหารายวัน
### หมวด "ยอดนิยม" ทำงานอย่างไร
- ยัง**ไม่**จัดอันดับจากสถิติจนกว่าข้อมูลจะครบ **6 เดือน (180 วัน)** — ระหว่างนี้ใช้ป้าย "ยอดนิยม" ที่ติ๊กเอง
- หน้าเว็บจะ**ไม่แสดงข้อความแจ้ง**เรื่องนี้ (ผู้ใช้สั่งลบ) — วันเหลือดูได้จากค่า `computePopularity()` ในเซิร์ฟเวอร์/บันทึกระบบเท่านั้น
- เมื่อครบ 6 เดือน ระบบสลับไปจัดอันดับเอง: `cinema_view` = 1, `cinema_select` = 1.5, ลดน้ำหนักครึ่งชีวิต 30 วัน, นับเฉพาะ 90 วันล่าสุด, เอา top 8
---
## 12. ข้อควรระวัง
- **กด "บันทึกทั้งหมด" ทุกครั้ง** — การแก้ในฟอร์มยังไม่ถูกบันทึกจนกว่าจะกดปุ่ม
- ช่องที่กรอกคั่นด้วย `,` (หมวด/ชำระเงิน) จะถูกจัดรูปให้เป็น `, ` ตอนออกจากช่อง
- อย่าแก้ `data/content/content.json` ด้วยมือระหว่างเซิร์ฟเวอร์รัน — ใช้หลังบ้านหรือ API
- ถ้าต้องแก้จำนวนมาก ให้ใช้ "แก้ไขดิบเป็น JSON" (ท้ายฟอร์ม) หรือ "วาง JSON เพื่อเพิ่มโรงหนัง"
+51
View File
@@ -0,0 +1,51 @@
# API reference — AlterFlixHub
ทุก endpoint เป็น `JSON` และอยู่ใต้ path `/api` ของแอปเอง (ไม่ต้องมี prefix อื่น)
ค่าเริ่มต้น: `Content-Type: application/json` · error ใช้รูปแบบ `{ statusMessage }` หรือ `{ message }`
## สาธารณะ (ไม่ต้องล็อกอิน)
| 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 ดิบ |
`type` ที่รองรับ: `search` · `cinema_select` · `cinema_view` · `near_me`
## หลังบ้าน (ต้องมีคุกกี้ `afx_admin`)
| Method | Path | Body / Query | ทำอะไร |
|---|---|---|---|
| POST | `/api/admin/login` | `{ username, password }` | ตรวจรหัส → ออกคุกกี้ HttpOnly เซ็น HMAC (8 ชั่วโมง) |
| POST | `/api/admin/logout` | — | ลบคุกกี้ session |
| GET | `/api/admin/session` | — | ตรวจว่ายังล็อกอินอยู่ |
| GET | `/api/admin/content` | — | อ่าน `ContentStore` ทั้งก้อน (`cinemas`, `site`, `about`) |
| PUT | `/api/admin/content` | `{ cinemas?, site?, about? }` | บันทึกเฉพาะส่วนที่ส่งมา — ผ่าน `sanitizeCinemas` / `sanitizeSite` / `sanitizeAbout` แล้วเขียนไฟล์แบบ atomic |
| POST | `/api/admin/cinemas/import` | `{ cinemas: Cinema[] }` หรือรายการเดียว | นำเข้าโรงหนังโดยใช้ slug เป็นกุญแจ (มีอยู่ = ทับ) |
| GET | `/api/admin/analytics` | `?days=1\|7\|30\|90` | สรุปสถิติ (`summarize()`) — คำค้นยอดนิยม, คำค้นไม่พบผล, CTR, โรงที่ถูกเปิด/คลิก |
## ข้อมูลที่ฝังมากับ loader (ไม่ใช่ API)
| Route | ค่าที่ส่งมา |
|---|---|
| `/` (root loader) | `content` (cinemas/site/about) + `localeFromUrl` |
| `/` (`_index` loader) | `popularity` (สถานะ/อันดับ "ยอดนิยม" จาก `computePopularity()`, memo 5 นาที) + `orderKey` (วันที่ UTC ใช้สลับลำดับการ์ดรายวันผ่าน `dailyOrder()`) |
## ตัวอย่างเรียก
```bash
# บันทึกเฉพาะ cinemas (เช่น หลังลากสลับลำดับ)
curl -X PUT http://localhost:8080/api/admin/content \
-H 'Content-Type: application/json' \
--cookie "$(cat .output/afx_admin.cookie)" \
-d '{"cinemas": [...]}'
# อ่านสถิติ 30 วัน
curl -H "Cookie: afx_admin=$TOKEN" \
'http://localhost:8080/api/admin/analytics?days=30'
```
## ข้อควรระวัง
- `PUT /api/admin/content` **เขียนทับทั้งก้อนของส่วนที่ส่งมา** — ถ้าส่ง `cinemas` ต้องส่งของครบทุกรายการ ไม่ใช่แค่ตัวที่แก้
- `slug` เปลี่ยนแล้วลิงก์เดิม `/cinema/<slug>` จะ 404 (ยังไม่มี redirect table)
- ไฟล์จริงอยู่ที่ `data/content/content.json` · สถิติที่ `data/analytics/events.jsonl` — ทั้งคู่ไม่ควรถูกเขียนด้วยมือระหว่างเซิร์ฟเวอร์รัน
+774
View File
@@ -0,0 +1,774 @@
<!doctype html>
<html lang="th">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<title>AlterFlixHub — แผนผังการทำงาน Frontend / Backend</title>
<style>
:root {
--bg: #0d0d0d;
--panel: #1b1b1b;
--panel-2: #161616;
--border: #332b2b;
--border-strong: #a92626;
--text: #f2f2f2;
--muted: #b3b3b3;
--crimson: #8f0808;
--crimson-soft: #d47272;
--line: #4a3a3a;
--front: #17222b;
--front-border: #2f4a5c;
--back: #241619;
--back-border: #5c2f38;
--data: #1c1f18;
--data-border: #3f4a30;
--ext: #1f1c26;
--ext-border: #423a58;
}
* {
box-sizing: border-box;
}
body {
margin: 0;
padding: 40px 32px 64px;
background: var(--bg);
color: var(--text);
font-family: "Noto Sans Thai", "IBM Plex Sans Thai Looped", system-ui,
-apple-system, "Segoe UI", sans-serif;
font-size: 14px;
line-height: 1.6;
}
.wrap {
max-width: 1440px;
margin: 0 auto;
}
header.page {
display: flex;
flex-wrap: wrap;
align-items: flex-end;
justify-content: space-between;
gap: 16px;
padding-bottom: 18px;
border-bottom: 1px solid var(--border);
margin-bottom: 28px;
}
h1 {
margin: 0;
font-size: 26px;
font-weight: 700;
letter-spacing: -0.01em;
}
.sub {
margin: 6px 0 0;
color: var(--muted);
font-size: 14px;
max-width: 720px;
}
.legend {
display: flex;
flex-wrap: wrap;
gap: 14px;
font-size: 12px;
color: var(--muted);
}
.legend span {
display: inline-flex;
align-items: center;
gap: 6px;
}
.dot {
width: 10px;
height: 10px;
border-radius: 3px;
display: inline-block;
}
.dot.f {
background: var(--front);
border: 1px solid var(--front-border);
}
.dot.b {
background: var(--back);
border: 1px solid var(--back-border);
}
.dot.d {
background: var(--data);
border: 1px solid var(--data-border);
}
.dot.e {
background: var(--ext);
border: 1px solid var(--ext-border);
}
/* ---------- lanes ---------- */
.lanes {
display: grid;
grid-template-columns: minmax(0, 1fr) 56px minmax(0, 1fr) 56px minmax(0, 0.62fr);
gap: 0 8px;
align-items: start;
}
.lane {
border: 1px solid var(--border);
border-radius: 14px;
background: var(--panel-2);
overflow: hidden;
}
.lane > h2 {
margin: 0;
padding: 10px 14px;
font-size: 13px;
font-weight: 600;
letter-spacing: 0.08em;
text-transform: uppercase;
border-bottom: 1px solid var(--border);
color: var(--muted);
}
.lane .stack {
display: flex;
flex-direction: column;
gap: 10px;
padding: 14px;
}
.lane.front > h2 {
color: #9fc6df;
}
.lane.back > h2 {
color: #e0a0a8;
}
.lane.data > h2 {
color: #bccf9c;
}
.lane.ext > h2 {
color: #bdb3dc;
}
/* ---------- node ---------- */
.node {
border-radius: 10px;
padding: 10px 12px;
border: 1px solid var(--border);
background: var(--panel);
}
.node .name {
font-weight: 600;
font-size: 14px;
display: block;
}
.node .desc {
display: block;
margin-top: 3px;
font-size: 12px;
line-height: 1.55;
color: var(--muted);
}
.node code,
code {
font-family: "JetBrains Mono", "Cascadia Code", ui-monospace, Menlo,
Consolas, monospace;
font-size: 11.5px;
color: #c9c9c9;
background: rgba(255, 255, 255, 0.05);
padding: 1px 5px;
border-radius: 4px;
}
.node.f {
background: var(--front);
border-color: var(--front-border);
}
.node.b {
background: var(--back);
border-color: var(--back-border);
}
.node.d {
background: var(--data);
border-color: var(--data-border);
}
.node.e {
background: var(--ext);
border-color: var(--ext-border);
}
.node.accent {
border-color: var(--border-strong);
box-shadow: inset 3px 0 0 var(--crimson);
}
.group {
border: 1px dashed var(--line);
border-radius: 10px;
padding: 10px;
}
.group > .title {
font-size: 11px;
letter-spacing: 0.06em;
text-transform: uppercase;
color: #8d8d8d;
margin-bottom: 8px;
display: block;
}
.group .row {
display: grid;
gap: 8px;
grid-template-columns: 1fr 1fr;
}
/* ---------- arrows ---------- */
.arrow {
position: relative;
display: flex;
align-items: center;
justify-content: center;
padding-top: 46px;
}
.arrow::before {
content: "";
position: absolute;
left: 50%;
top: 12px;
bottom: 12px;
width: 1px;
background: linear-gradient(
to bottom,
transparent,
var(--line) 12%,
var(--line) 88%,
transparent
);
}
.arrow::after {
content: "";
position: absolute;
left: 50%;
bottom: 12px;
transform: translateX(-50%);
border-left: 6px solid transparent;
border-right: 6px solid transparent;
border-top: 8px solid var(--line);
}
.arrow .label {
position: relative;
z-index: 1;
background: var(--bg);
border: 1px solid var(--border);
border-radius: 999px;
padding: 4px 9px;
font-size: 11px;
color: var(--muted);
text-align: center;
line-height: 1.35;
}
/* ---------- data band ---------- */
.band {
margin-top: 14px;
display: grid;
gap: 14px;
grid-template-columns: minmax(0, 1fr);
}
/* ---------- flow list ---------- */
section.flows {
margin-top: 34px;
}
section.flows h3 {
margin: 0 0 4px;
font-size: 18px;
}
section.flows > p.lead {
margin: 0 0 16px;
color: var(--muted);
font-size: 13px;
}
.flow {
border: 1px solid var(--border);
border-radius: 14px;
background: var(--panel-2);
padding: 16px 18px;
margin-bottom: 12px;
}
.flow h4 {
margin: 0 0 12px;
font-size: 14px;
font-weight: 600;
}
.flow ol {
margin: 0;
padding: 0;
list-style: none;
display: flex;
flex-wrap: wrap;
gap: 8px;
}
.flow li {
position: relative;
flex: 1 1 160px;
min-width: 140px;
padding: 9px 12px 9px 34px;
border: 1px solid var(--border);
border-radius: 9px;
background: var(--panel);
font-size: 12px;
line-height: 1.5;
color: #e4e4e4;
}
.flow li .n {
position: absolute;
left: 9px;
top: 9px;
width: 18px;
height: 18px;
border-radius: 50%;
display: flex;
align-items: center;
justify-content: center;
font-size: 10px;
font-weight: 700;
color: var(--crimson-soft);
border: 1px solid rgba(169, 38, 38, 0.55);
background: rgba(143, 8, 8, 0.18);
}
.flow li b {
display: block;
font-weight: 600;
font-size: 12.5px;
}
.flow li em {
font-style: normal;
color: var(--muted);
font-size: 11.5px;
}
.note {
margin-top: 18px;
border-left: 3px solid var(--border-strong);
background: rgba(143, 8, 8, 0.09);
padding: 12px 16px;
border-radius: 0 10px 10px 0;
font-size: 12.5px;
color: #d9d9d9;
}
.note b {
color: #fff;
}
footer.page {
margin-top: 30px;
padding-top: 14px;
border-top: 1px solid var(--border);
font-size: 11.5px;
color: #7d7d7d;
}
@media (max-width: 1100px) {
.lanes {
grid-template-columns: minmax(0, 1fr);
gap: 14px;
}
.arrow {
padding: 0;
height: 34px;
}
.arrow::before {
left: 50%;
top: 0;
bottom: 0;
}
.arrow::after {
bottom: 0;
}
}
</style>
</head>
<body>
<div class="wrap">
<header class="page">
<div>
<h1>AlterFlixHub — แผนผังการทำงาน</h1>
<p class="sub">
เว็บรวมโรงหนังอิสระและอาร์ตเฮาส์ · React Router 8 (SSR) ฝั่งหน้าเว็บ
+ Node/h3 (agent-native) ฝั่งหลังบ้าน · ข้อมูลโรงหนังเก็บเป็นไฟล์ JSON
ใน <code>data/</code> และสถิติแบบ append-only
</p>
</div>
<div class="legend">
<span><i class="dot f"></i>Frontend (browser)</span>
<span><i class="dot b"></i>Backend (server)</span>
<span><i class="dot d"></i>Data (ดิสก์/SQL)</span>
<span><i class="dot e"></i>บริการภายนอก</span>
</div>
</header>
<div class="lanes">
<!-- ================= FRONTEND ================= -->
<div class="lane front">
<h2>Frontend — เบราว์เซอร์</h2>
<div class="stack">
<div class="node f accent">
<span class="name">User / เบราว์เซอร์</span>
<span class="desc"
>เปิดหน้าแรก · ค้นหา/กรอง · กด “ใกล้ฉัน” · สลับภาษา TH/EN</span
>
</div>
<div class="group">
<span class="title">Routes — app/routes/</span>
<div class="row">
<div class="node f">
<span class="name"><code>/</code></span>
<span class="desc">HeroSection + CinemaGrid</span>
</div>
<div class="node f">
<span class="name"><code>/cinema/:slug</code></span>
<span class="desc">Gallery, Summary, Transport, Location</span>
</div>
<div class="node f">
<span class="name"><code>/about</code></span>
<span class="desc">เนื้อหาจาก data/content</span>
</div>
<div class="node f">
<span class="name"><code>/admin</code></span>
<span class="desc">login + แดชบอร์ด 4 แท็บ</span>
</div>
</div>
</div>
<div class="node f">
<span class="name">SiteShell + SiteHeader / SiteFooter</span>
<span class="desc"
>กรอบหน้า: BackdropFrame (glow) · Logo (Jersey 15) · nav หน้าแรก/เกี่ยวกับเรา
· ปุ่มภาษา</span
>
</div>
<div class="group">
<span class="title">Providers — app/root.tsx</span>
<div class="row">
<div class="node f">
<span class="name">ContentProvider</span>
<span class="desc">useContent() → cinemas / about / terms / footer</span>
</div>
<div class="node f">
<span class="name">LocaleProvider</span>
<span class="desc">?lang → localStorage → cookie → ไทย</span>
</div>
<div class="node f">
<span class="name">NearMeProvider</span>
<span class="desc">Geolocation API → ระยะทางต่อ slug</span>
</div>
<div class="node f">
<span class="name">AppProviders / DbSync</span>
<span class="desc">query client + useDbSync (real-time)</span>
</div>
</div>
</div>
<div class="group">
<span class="title">Client libs — app/lib/</span>
<div class="row">
<div class="node f">
<span class="name">cinemas.ts</span>
<span class="desc">filterCinemas · findCinemaBySlug · formatDistance</span>
</div>
<div class="node f">
<span class="name">geo.ts</span>
<span class="desc">ระยะเส้นตรง + เรียก OSRM ตามถนน</span>
</div>
<div class="node f">
<span class="name">analytics-client.ts</span>
<span class="desc">trackEvent() · debounce 900 ms · กัน event ซ้ำ</span>
</div>
<div class="node f">
<span class="name">i18n/messages.ts</span>
<span class="desc">ข้อความ TH/EN ทุกคำใน UI</span>
</div>
<div class="node f">
<span class="name">map-embed.ts</span>
<span class="desc">URL แผนที่: map_url → พิกัด → null (แสดง "ไม่มีข้อมูล")</span>
</div>
</div>
</div>
<div class="node f">
<span class="name">หลังบ้าน /admin</span>
<span class="desc">AdminSection (หมวดพับ) · CinemaList (ก-ฮ + ลากสลับ) · SlugInput · ChipPicker · CommaListInput · PhotosEditor · TransportEditor · ContactsEditor · CinemaFacilitiesEditor</span>
</div>
</div>
</div>
<!-- arrow -->
<div class="arrow">
<span class="label">HTTP<br />/ JSON</span>
</div>
<!-- ================= BACKEND ================= -->
<div class="lane back">
<h2>Backend — Node / h3 (agent-native)</h2>
<div class="stack">
<div class="node b accent">
<span class="name">root loader — <code>readContent()</code></span>
<span class="desc"
>ทำงานตอน SSR ทุกคำขอ: อ่าน store → ส่งเข้า ContentProvider พร้อม HTML
แรก (cache ตาม mtime ของไฟล์)</span
>
</div>
<div class="group">
<span class="title">API routes — server/routes/api/</span>
<div class="row">
<div class="node b">
<span class="name"><code>admin/login</code> · <code>logout</code> · <code>session</code></span>
<span class="desc">cookie HttpOnly เซ็น HMAC · 8 ชม. · env ADMIN_*</span>
</div>
<div class="node b">
<span class="name"><code>admin/content</code> GET/PUT</span>
<span class="desc">อ่าน/บันทึก cinemas · terms · footer · about</span>
</div>
<div class="node b">
<span class="name"><code>admin/cinemas/import</code></span>
<span class="desc">วาง JSON ทับตาม slug</span>
</div>
<div class="node b">
<span class="name"><code>admin/analytics</code></span>
<span class="desc">สรุปสถิติ 1/7/30/90 วัน</span>
</div>
<div class="node b">
<span class="name"><code>analytics/collect</code> (สาธารณะ)</span>
<span class="desc">รับ event · ไม่ใช้คุกกี้ · ไม่เก็บ IP/UA ดิบ</span>
</div>
<div class="node b">
<span class="name">middleware/auth.ts</span>
<span class="desc">runAuthGuard() คุมทุก path /admin</span>
</div>
</div>
</div>
<div class="group">
<span class="title">Server libs</span>
<div class="row">
<div class="node b">
<span class="name">content.server.ts</span>
<span class="desc">sanitize ทุกฟิลด์ · เขียนแบบ atomic (temp → rename) · seed เฉพาะเมื่อไฟล์ไม่มี (ห้ามทับของจริง)</span>
</div>
<div class="node b">
<span class="name">popularity.server.ts</span>
<span class="desc">อันดับ "ยอดนิยม" จาก events · ต้องมีประวัติ ≥ 180 วัน · decay ครึ่งชีวิต 30 วัน · top 8 · memo 5 นาที</span>
</div>
<div class="node b">
<span class="name">analytics.server.ts</span>
<span class="desc">summarize() · หมุนไฟล์ 8 MB · เก็บ 50k event</span>
</div>
<div class="node b">
<span class="name">actions/</span>
<span class="desc">navigate · view-screen · provider-api-request (เครื่องมือ agent)</span>
</div>
<div class="node b">
<span class="name">server/db.ts</span>
<span class="desc">Drizzle + pglite (ยังไม่เปิดใช้ตาราง)</span>
</div>
</div>
</div>
<div class="node b">
<span class="name">plugins/config.ts</span>
<span class="desc"
>homePath <code>/</code> · ปิด integrations / terminal / sentry ·
email-branding อ่าน app.name</span
>
</div>
</div>
</div>
<!-- arrow -->
<div class="arrow">
<span class="label">อ่าน/เขียน<br />ไฟล์</span>
</div>
<!-- ================= EXTERNAL ================= -->
<div class="lane ext">
<h2>บริการภายนอก</h2>
<div class="stack">
<div class="node e">
<span class="name">OSRM</span>
<span class="desc">ระยะทาง/เวลาเดินทางตามถนนจริง (ปุ่ม “ใกล้ฉัน”)</span>
</div>
<div class="node e">
<span class="name">OpenStreetMap</span>
<span class="desc">พิกัดอ้างอิงของโรงหนัง + แผนที่</span>
</div>
<div class="node e">
<span class="name">Google Fonts</span>
<span class="desc">Jersey 15 · Noto Sans Thai (Inter + IBM Plex Thai Looped ฝังในโปรเจกต์)</span>
</div>
<div class="node e">
<span class="name">AI SDK providers</span>
<span class="desc">OpenAI / Anthropic / Google ฯลฯ สำหรับ actions ของ agent</span>
</div>
</div>
</div>
</div>
<!-- ================= DATA BAND ================= -->
<div class="band">
<div class="lane data">
<h2>Data layer — data/ (ไฟล์บนดิสก์ + SQL)</h2>
<div class="stack">
<div class="group">
<span class="title">แหล่งข้อมูลจริง</span>
<div class="row">
<div class="node d">
<span class="name">data/content/content.json</span>
<span class="desc"
>แหล่งเดียวของ cinemas · site.terms · footer · about{th,en} —
หน้าเว็บอ่านผ่าน readContent() เท่านั้น</span
>
</div>
<div class="node d">
<span class="name">data/analytics/events.jsonl</span>
<span class="desc">append-only: search / cinema_select / cinema_view / near_me</span>
</div>
<div class="node d">
<span class="name">data/pglite/</span>
<span class="desc">SQL ฝังในเครื่อง (Drizzle) — ยังว่าง รอตารางแรก</span>
</div>
<div class="node d">
<span class="name">app/lib/content-seed.ts</span>
<span class="desc">ค่าเริ่มต้น: CINEMAS + ข้อความ i18n → สร้าง content.json ครั้งแรก</span>
</div>
</div>
</div>
</div>
</div>
</div>
<!-- ================= FLOWS ================= -->
<section class="flows">
<h3>เส้นทางการทำงานหลัก</h3>
<p class="lead">
ทุกเส้นเริ่มจากเบราว์เซอร์ เว้นแต่ระบุไว้เป็นอย่างอื่น — ลำดับเลขคือลำดับที่เกิดจริง
</p>
<div class="flow">
<h4>1 · เปิดหน้า (SSR + hydration)</h4>
<ol>
<li><span class="n">1</span><b>GET / หรือ /about</b><em>เบราว์เซอร์ขอเอกสาร</em></li>
<li><span class="n">2</span><b>root loader</b><em>readContent() อ่าน content.json</em></li>
<li><span class="n">3</span><b>SSR HTML</b><em>ส่งเนื้อหาพร้อมหน้าแรก</em></li>
<li><span class="n">4</span><b>Hydrate</b><em>ContentProvider + LocaleProvider</em></li>
<li><span class="n">5</span><b>Client nav</b><em>Link เปลี่ยนหน้าโดยไม่โหลดใหม่</em></li>
</ol>
</div>
<div class="flow">
<h4>2 · ค้นหา / กรอง / ใกล้ฉัน</h4>
<ol>
<li><span class="n">1</span><b>พิมพ์ค้นหา</b><em>filterCinemas() ในหน่วยความจำ</em></li>
<li><span class="n">2</span><b>กด “ใกล้ฉัน”</b><em>Geolocation API (ขอเมื่อกดเท่านั้น)</em></li>
<li><span class="n">3</span><b>เรียก OSRM</b><em>ระยะทางตามถนน · ล้มเหลวใช้เส้นตรง</em></li>
<li><span class="n">4</span><b>เรียงผล</b><em>NearMeProvider แจก distances</em></li>
<li><span class="n">5</span><b>trackEvent("near_me")</b><em>ไม่บล็อก UI</em></li>
</ol>
</div>
<div class="flow">
<h4>3 · บันทึกสถิติ (privacy-first)</h4>
<ol>
<li><span class="n">1</span><b>หยุดพิมพ์ 900 ms</b><em>ต้องมี ≥ 2 ตัวอักษร</em></li>
<li><span class="n">2</span><b>POST /api/analytics/collect</b><em>ไม่แนบคุกกี้</em></li>
<li><span class="n">3</span><b>hash ผู้เข้าชม</b><em>sha256(salt รายวัน | ip | ua) 16 ตัว</em></li>
<li><span class="n">4</span><b>append events.jsonl</b><em>หมุนไฟล์ 8 MB · เก็บ 50k</em></li>
<li><span class="n">5</span><b>admin/analytics</b><em>summarize() → การ์ดสถิติ</em></li>
</ol>
</div>
<div class="flow">
<h4>4 · แก้เนื้อหาผ่านหลังบ้าน</h4>
<ol>
<li><span class="n">1</span><b>POST admin/login</b><em>ตรวจ env ADMIN_USERNAME/PASSWORD</em></li>
<li><span class="n">2</span><b>cookie HMAC</b><em>HttpOnly · 8 ชม.</em></li>
<li><span class="n">3</span><b>แก้ใน AboutEditor / แท็บอื่น</b><em>ตัวอย่างหน้าเว็บสด</em></li>
<li><span class="n">4</span><b>PUT admin/content</b><em>sanitize ก่อนบันทึก</em></li>
<li><span class="n">5</span><b>atomic write</b><em>temp → rename · cache ใหม่ตาม mtime</em></li>
</ol>
</div>
<div class="flow">
<h4>5 · หมวด "ยอดนิยม" (สถิติจริง ต้องครบ 6 เดือน)</h4>
<ol>
<li><span class="n">1</span><b>ผู้ใช้กด "ยอดนิยม"</b><em>หน้าแรกขอข้อมูลจาก loader</em></li>
<li><span class="n">2</span><b>computePopularity()</b><em>อ่าน events.jsonl (memo 5 นาที)</em></li>
<li><span class="n">3</span><b>เช็กประวัติ ≥ 180 วัน</b><em>ยังไม่ครบ → ไม่จัดอันดับ</em></li>
<li><span class="n">4</span><b>ยังไม่ครบ</b><em>ใช้ป้าย tags เงียบ ๆ ไม่มีข้อความบนหน้าเว็บ</em></li>
<li><span class="n">5</span><b>ครบแล้ว</b><em>view=1 · select=1.5 · decay 30 วัน · top 8 (ตัด hidden)</em></li>
</ol>
</div>
<div class="flow">
<h4>6 · แก้ข้อมูลผ่านหลังบ้าน (5 แท็บ · ฟอร์มเป็นหมวดพับ)</h4>
<ol>
<li><span class="n">1</span><b>เลือกโรงจากรายการซ้าย</b><em>เรียง ก-ฮ หรือลากสลับลำดับ</em></li>
<li><span class="n">2</span><b>กางหมวดที่ต้องการ</b><em>AdminSection (details/summary)</em></li>
<li><span class="n">3</span><b>แก้ช่อง</b><em>slug อัตโนมัติ · ชิปหมวด/สิ่งอำนวยความสะดวก · การเดินทาง · ติดต่อ · รูป · ที่ตั้ง</em></li>
<li><span class="n">4</span><b>บันทึกทั้งหมด</b><em>PUT /api/admin/content (เฉพาะ অংশที่ส่ง)</em></li>
<li><span class="n">5</span><b>sanitize + atomic write</b><em>แล้ว loader รอบถัดไปอ่านค่าใหม่</em></li>
</ol>
</div>
<div class="flow">
<h4>7 · ลำดับการ์ดหน้าแรก (สลับทุกวัน · ห้ามซ้ำตำแหน่งเดิม)</h4>
<ol>
<li><span class="n">1</span><b>loader ส่ง orderKey</b><em>วันที่แบบ UTC (YYYY-MM-DD)</em></li>
<li><span class="n">2</span><b>dailyOrder()</b><em>seeded shuffle จากลำดับที่แอดมินจัด</em></li>
<li><span class="n">3</span><b>rotate ตาม offset รายวัน</b><em>offset 1..n-1 · วันติดกันไม่เท่ากัน</em></li>
<li><span class="n">4</span><b>ทุกโรงเลื่อนตำแหน่ง</b><em>ไม่มีใครอยู่ช่องเดิม 2 วันติดกัน</em></li>
<li><span class="n">5</span><b>กรองหมวด/คำค้น</b><em>หรือเรียงตามระยะทางถ้ากด "ใกล้ฉัน"</em></li>
</ol>
</div>
<div class="note">
<b>กฎที่ยึดทั้งระบบ:</b> หน้าเว็บอ่านข้อมูลผ่าน <code>useContent()</code> เท่านั้น
ไม่ import ข้อมูลดิบ · ข้อความทุกคำมาจาก <code>messages.ts</code> + ส่วนที่แก้ได้จาก
<code>terms</code>/<code>about</code> · ฟอนต์: หัวข้อ Inter + Noto Sans Thai,
เนื้อหายาว IBM Plex Sans Thai Looped (<code>font-content</code>), โลโก้ Jersey 15
</div>
</section>
<footer class="page">
ไฟล์นี้เป็นเอกสารประกอบ (ไม่ถูก build เข้าแอป) — อ้างอิงโค้ดจริง ณ
<code>app/routes/about.tsx</code>, <code>app/root.tsx</code>,
<code>server/routes/api/</code>, <code>app/lib/content.server.ts</code>
</footer>
</div>
</body>
</html>
+45
View File
@@ -0,0 +1,45 @@
# push ขึ้น Gitea
repo นี้ commit ไว้ในเครื่องแล้ว แต่ **ยังไม่ขึ้น Gitea** เพราะเครื่องนี้รัน git แบบไม่มี GUI
ทำให้ Git Credential Manager เรียกขอรหัสไม่ได้ (push จะค้าง) — ต้องให้สิทธิ์ก่อนหนึ่งครั้ง
Gitea: `http://103.107.52.82:3004` · org: `alterflixhub` · repo ที่มีอยู่: `web-alterflixhub`
## วิธีที่ 1 — ล็อกอินผ่าน Git Credential Manager (ง่ายสุด)
เปิด terminal ปกติของ Windows (ไม่ใช่ผ่าน agent) แล้วรัน:
```bash
cd D:/Git/workspace/alterflixhub-reboot
git push -u origin main
```
หน้าต่างล็อกอินจะเด้ง → ใส่ user/รหัส Gitea หนึ่งครั้ง หลังจากนั้น push ได้ตลอด
## วิธีที่ 2 — ใช้ access token (ไม่ต้องมี GUI)
สร้าง token ที่ Gitea → Settings → Applications → Generate New Token (สิทธิ์ `write:repository`)
แล้วรัน (แทน `<TOKEN>` ด้วยค่าจริง — อย่าเก็บไว้ในไฟล์ที่ commit):
```bash
cd D:/Git/workspace/alterflixhub-reboot
git remote set-url origin "http://Bkk1234:<TOKEN>@103.107.52.82:3004/alterflixhub/alterflixhub-reboot.git"
git -c http.version=HTTP/1.1 push -u origin main
```
## เลือกปลายทาง
| ต้องการ | สิ่งที่ต้องทำ |
|---|---|
| repo ใหม่ `alterflixhub/alterflixhub-reboot` | สร้าง repo บน Gitea (private) แล้วตั้ง remote ตามด้านบน |
| branch ใหม่ใน repo เดิม | `git remote set-url origin "http://[email protected]:3004/alterflixhub/web-alterflixhub.git"` แล้ว `git -c http.version=HTTP/1.1 push -u origin main:reboot` |
| แทนที่ main ของ repo เดิม | เหมือนข้อบน แต่ push `main:main` (ทับของเดิม — ระวัง) |
## หมายเหตุ
- `data/` ถูก `.gitignore` ไว้ → **ข้อมูลโรงหนัง/คำศัพท์ไม่อยู่ใน git** (โคลนใหม่จะได้ seed จาก `app/lib/cinemas.ts`)
- `.env` ก็ไม่ถูก commit · ต้องสร้างจาก `.env.example` บนเครื่องใหม่
- ถ้าต้องการให้ content.json อยู่ใน git ด้วย ให้เพิ่มข้อยกเว้นใน `.gitignore`:
```
!data/content/content.json
```