feat: บทความ 2 หน้า + แชร์/ลิงก์ย่อ + PWA + แอนิเมชัน + SEO/AI + เอกสาร
- บทความจากหลังบ้าน: /for-film-lovers, /for-cinemas (ArticlePage + ArticleEditor แบบบล็อกย่อหน้า/รูป) - แชร์: ปุ่มบนการ์ดและท้ายหน้ารายละเอียด · ลิงก์ย่อ /c/<slug> (302) · ธีมแก้วตาม DESIGN.md - PWA: manifest/sw/offline + ถอดการล็อกซูม (WCAG 1.4.4) + touch target ≥44px - แอนิเมชัน reveal: IntersectionObserver + gate ด้วย html.fx-motion · เคารพ prefers-reduced-motion - ค้นหา: normalize/ตัดวรรณยุกต์ + AND หลายคำ + จัดอันดับ · รองรับ /?q= จาก SearchAction - SEO: pageMeta (canonical/OG/Twitter) + JSON-LD (WebSite/Organization/BreadcrumbList/MovieTheater/Article) - ไม่ฝังโดเมนในโค้ด: origin มาจาก request (x-forwarded-host/proto) ทั้ง canonical, sitemap, robots, ลิงก์แชร์ - กัน AI: robots.txt (Nitro route, บล็อก AI 21 ตัว) + ai.txt + OG image 1200x630 - เอกสาร: README สรุปโปรเจกต์, DESIGN.md (motion/PWA/SEO/ข้อมูล), architecture.html, admin-guide - tests: 135 ผ่าน (16 ไฟล์)
This commit is contained in:
1 parent
1e84023a44
commit
319c271d23
72 files changed
+4731
-765
No files matched your search
+19
-4
@@ -3,7 +3,7 @@
|
||||
คู่มือนี้ตอบคำถาม "แก้ตรงไหน" ทีละงาน — ทุกอย่างอยู่ใน `http://localhost:8080/admin`
|
||||
(ล็อกอินด้วย `ADMIN_USERNAME` / `ADMIN_PASSWORD` ใน `.env`; ค่าเริ่มต้นคือ `it is me` / `it is me&it is me`)
|
||||
|
||||
หน้าหลังบ้านมี 5 แท็บ: **โรงหนัง · หน้าเกี่ยวกับเรา · คำศัพท์หลายภาษา · Footer / ไอคอน · สถิติการค้นหา**
|
||||
หน้าหลังบ้านมี 7 แท็บ: **โรงหนัง · หน้าเกี่ยวกับเรา · สำหรับคนทำโรงหนัง · สำหรับคนรักหนัง · คำศัพท์หลายภาษา · Footer / ไอคอน · สถิติการค้นหา**
|
||||
|
||||
---
|
||||
|
||||
@@ -125,14 +125,29 @@
|
||||
|
||||
---
|
||||
|
||||
## 10. คำศัพท์หลายภาษา / Footer
|
||||
## 10. หน้า "สำหรับคนทำโรงหนัง" และ "สำหรับคนรักหนัง" (บทความ)
|
||||
|
||||
สองหน้านี้ใช้ตัวแก้ไขแบบเดียวกัน ต่างกันแค่แท็บ — **สำหรับคนทำโรงหนัง** → `/for-cinemas` · **สำหรับคนรักหนัง** → `/for-film-lovers`
|
||||
|
||||
ในแท็บ เลือกภาษา (TH/EN) แล้วเขียนบทความแบบบล็อก:
|
||||
|
||||
- **+ เพิ่มย่อหน้า** — เพิ่มช่องข้อความทีละย่อหน้า (ขึ้นบรรทัดใหม่ได้ตามที่พิมพ์)
|
||||
- **+ เพิ่มรูปภาพ** — ใส่ลิงก์รูป (`/images/…` หรือ URL เต็ม) + คำอธิบายรูป (alt จำเป็นต่อการเข้าถึง) + คำบรรยายใต้รูป (ไม่ใส่ก็ได้) พร้อมพรีวิวรูปในฟอร์ม
|
||||
- ปุ่ม **↑ ↓** สลับลำดับบล็อก · **ลบ** เอาบล็อกออก
|
||||
- แก้ **หัวเรื่อง (H1)**, **คำเกริ่นนำ**, และ **การ์ดติดต่อ** (หัวข้อ + ข้อความ) ได้ในแท็บเดียวกัน
|
||||
- ตัวนับด้านบนบอกจำนวนย่อหน้า/รูป · ปุ่ม **คืนค่าตั้งต้น** คืนข้อความเริ่มต้นของภาษานั้น
|
||||
- กด **บันทึกหน้าสำหรับคนทำโรงหนัง** / **บันทึกหน้าสำหรับคนรักหนัง** → หน้าเว็บอัปเดตทันที (รูปแสดงตามลำดับที่วางไว้)
|
||||
|
||||
---
|
||||
|
||||
## 11. คำศัพท์หลายภาษา / Footer
|
||||
|
||||
- **คำศัพท์หลายภาษา**: แก้ข้อความทุกจุดในหน้าเว็บด้วย key (เช่น `hero.subtitle`, `detail.contactTitle`) — เว้นว่าง = ใช้ค่าเดิมจาก `messages.ts`
|
||||
- **Footer / ไอคอน**: เพิ่ม/แก้ไอคอนโซเชียล (ชื่อไอคอน Tabler เช่น `IconBrandFacebook`)
|
||||
|
||||
---
|
||||
|
||||
## 11. สถิติการค้นหา
|
||||
## 12. สถิติการค้นหา
|
||||
|
||||
แท็บ **สถิติการค้นหา** — เลือกช่วง 1 / 7 / 30 / 90 วัน: คำคันยอดนิยม, คำค้นที่ไม่พบผล, CTR, ผลลัพธ์เฉลี่ย, หมวดที่ถูกใช้, โรงที่ถูกเปิด/คลิก, การค้นหารายวัน
|
||||
|
||||
@@ -144,7 +159,7 @@
|
||||
|
||||
---
|
||||
|
||||
## 12. ข้อควรระวัง
|
||||
## 13. ข้อควรระวัง
|
||||
|
||||
- **กด "บันทึกทั้งหมด" ทุกครั้ง** — การแก้ในฟอร์มยังไม่ถูกบันทึกจนกว่าจะกดปุ่ม
|
||||
- ช่องที่กรอกคั่นด้วย `,` (หมวด/ชำระเงิน) จะถูกจัดรูปให้เป็น `, ` ตอนออกจากช่อง
|
||||
|
||||
+59
-8
@@ -457,9 +457,25 @@
|
||||
<span class="name"><code>/about</code></span>
|
||||
<span class="desc">เนื้อหาจาก data/content</span>
|
||||
</div>
|
||||
<div class="node f">
|
||||
<span class="name"><code>/for-cinemas</code></span>
|
||||
<span class="desc">บทความ 블록 (ย่อหน้า/รูป) จาก data/content · ธีมเดียวกับ /about</span>
|
||||
</div>
|
||||
<div class="node f">
|
||||
<span class="name"><code>/for-film-lovers</code></span>
|
||||
<span class="desc">บทความแบบบล็อก · ใช้ ArticlePage ร่วมกับ /for-cinemas</span>
|
||||
</div>
|
||||
<div class="node f">
|
||||
<span class="name"><code>/c/:slug</code></span>
|
||||
<span class="desc">ลิงก์ย่อสำหรับแชร์ → 302 redirect ไป /cinema/:slug</span>
|
||||
</div>
|
||||
<div class="node f">
|
||||
<span class="name"><code>/sitemap.xml</code> · <code>/robots.txt</code> · <code>/ai.txt</code></span>
|
||||
<span class="desc">ไฟล์สำหรับ crawler — sitemap สร้างจากข้อมูลจริง (Nitro route), robots/ai เป็น static ใน public/</span>
|
||||
</div>
|
||||
<div class="node f">
|
||||
<span class="name"><code>/admin</code></span>
|
||||
<span class="desc">login + แดชบอร์ด 4 แท็บ</span>
|
||||
<span class="desc">login + แดชบอร์ด 7 แท็บ</span>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
@@ -467,8 +483,8 @@
|
||||
<div class="node f">
|
||||
<span class="name">SiteShell + SiteHeader / SiteFooter</span>
|
||||
<span class="desc"
|
||||
>กรอบหน้า: BackdropFrame (glow) · Logo (Jersey 15) · nav หน้าแรก/เกี่ยวกับเรา
|
||||
· ปุ่มภาษา</span
|
||||
>กรอบหน้า: BackdropFrame (glow) · Logo (Jersey 15) · nav คนรักหนัง/โรงหนัง/เกี่ยวกับเรา
|
||||
· ปุ่มภาษา (dropdown) (มือถือ: ยุบในเมนู)</span
|
||||
>
|
||||
</div>
|
||||
|
||||
@@ -477,7 +493,7 @@
|
||||
<div class="row">
|
||||
<div class="node f">
|
||||
<span class="name">ContentProvider</span>
|
||||
<span class="desc">useContent() → cinemas / about / terms / footer</span>
|
||||
<span class="desc">useContent() → cinemas / about / forCinemas / forFilmLovers / terms / footer</span>
|
||||
</div>
|
||||
<div class="node f">
|
||||
<span class="name">LocaleProvider</span>
|
||||
@@ -517,12 +533,28 @@
|
||||
<span class="name">map-embed.ts</span>
|
||||
<span class="desc">URL แผนที่: map_url → พิกัด → null (แสดง "ไม่มีข้อมูล")</span>
|
||||
</div>
|
||||
<div class="node f">
|
||||
<span class="name">seo.ts · site.ts</span>
|
||||
<span class="desc">pageMeta (title/canonical/OG/Twitter) + JSON-LD · ข้อมูลระดับเว็บ (ชื่อ/คำอธิบาย/og image)</span>
|
||||
</div>
|
||||
<div class="node f">
|
||||
<span class="name">request-origin.ts · page-origin.ts</span>
|
||||
<span class="desc">หา origin จาก request (x-forwarded-host/proto) — ไม่ฝังโดเมนในโค้ด</span>
|
||||
</div>
|
||||
<div class="node f">
|
||||
<span class="name">sitemap.ts · article.ts · share.ts</span>
|
||||
<span class="desc">สร้าง sitemap XML · จัดการบล็อกบทความ (ย่อหน้า/รูป) · แชร์ + คัดลอกลิงก์ย่อ</span>
|
||||
</div>
|
||||
<div class="node f">
|
||||
<span class="name">motion.ts · pwa.ts</span>
|
||||
<span class="desc">เปิดใช้แอนิเมชันก่อน paint (เคารพ reduced-motion) · ลงทะเบียน service worker</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>
|
||||
<span class="desc">AdminSection (หมวดพับ) · CinemaList (ก-ฮ + ลากสลับ) · SlugInput · ChipPicker · CommaListInput · PhotosEditor · TransportEditor · ContactsEditor · CinemaFacilitiesEditor · ArticleEditor (บทความแบบบล็อก)</span>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
@@ -553,7 +585,7 @@
|
||||
</div>
|
||||
<div class="node b">
|
||||
<span class="name"><code>admin/content</code> GET/PUT</span>
|
||||
<span class="desc">อ่าน/บันทึก cinemas · terms · footer · about</span>
|
||||
<span class="desc">อ่าน/บันทึก cinemas · terms · footer · about · forCinemas · forFilmLovers</span>
|
||||
</div>
|
||||
<div class="node b">
|
||||
<span class="name"><code>admin/cinemas/import</code></span>
|
||||
@@ -574,6 +606,24 @@
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="group">
|
||||
<span class="title">ไฟล์สำหรับ crawler — server/routes/</span>
|
||||
<div class="row">
|
||||
<div class="node b accent">
|
||||
<span class="name"><code>/robots.txt</code></span>
|
||||
<span class="desc">สร้างสด: เปิด search engine, ปิด /api/ /admin /_agent-native/ /c/, บล็อก AI crawler 21 ตัว · Sitemap: ตามโดเมนของ request</span>
|
||||
</div>
|
||||
<div class="node b accent">
|
||||
<span class="name"><code>/sitemap.xml</code></span>
|
||||
<span class="desc">สร้างจากข้อมูลจริง (หน้า static + โรงที่ไม่ hidden) · โดเมนจาก request · ไม่ throw ถ้าอ่าน content ไม่ได้</span>
|
||||
</div>
|
||||
<div class="node b">
|
||||
<span class="name"><code>public/ai.txt</code></span>
|
||||
<span class="desc">ประกาศไม่ให้นำเนื้อหาไปฝึกโมเดล AI (static, ไม่มีโดเมนในเนื้อหา)</span>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="group">
|
||||
<span class="title">Server libs</span>
|
||||
<div class="row">
|
||||
@@ -650,8 +700,9 @@
|
||||
<div class="node d">
|
||||
<span class="name">data/content/content.json</span>
|
||||
<span class="desc"
|
||||
>แหล่งเดียวของ cinemas · site.terms · footer · about{th,en} —
|
||||
หน้าเว็บอ่านผ่าน readContent() เท่านั้น</span
|
||||
>แหล่งเดียวของ cinemas · site.terms · footer · about{th,en} ·
|
||||
forCinemas{th,en} · forFilmLovers{th,en} (blocks) — หน้าเว็บอ่านผ่าน
|
||||
readContent() เท่านั้น</span
|
||||
>
|
||||
</div>
|
||||
<div class="node d">
|
||||
|
||||
Reference in new issue
Block a user