Files
hobbypj-contents/README.md
T
Bkk1234 db7724b237 feat(home): link the homepage of every local project in the workspace
- server: GET /api/local-projects scans sibling folders for index.html
  (title from <title>/<h1>, generic titles fall back to the folder name,
  sorted by newest edit) and GET /projects/<folder>/ serves that folder
- both endpoints are loopback-only; node_modules/.git/.hermes blocked and
  path traversal rejected; WORKSPACE_DIR=none disables the feature
- home: new 'โปรเจคในเครื่อง' list (2 columns >=700px) that hides itself when
  the API is absent, so the live static site never shows fake rows
- SW skips /projects/* so other projects' files are never cached; version 2026.11.19.5
- docs: README/AGENTS/DESIGN cover the endpoints, the loopback rule and the layout
2026-11-20 14:26:54 +07:00

7.5 KiB

hobbypj-contents — หน้ารายชื่อโปรเจคอดิเรก

หน้าเว็บรวมรายชื่อโปรเจคอดิเรกของเรา (PWA + SPA แบบไม่มี build step) พร้อม หลังบ้าน สำหรับแก้ชื่อโปรเจค คำอธิบายใต้ชื่อ และลิงก์

  • เว็บจริง: https://www.hobbypj.com
  • ข้อมูลทั้งหมดอยู่ในไฟล์เดียว: data/projects.json
  • หน้าแก้ไข: #/admin (หรือกดปุ่ม “แก้ไขรายการ” มุมขวาบน) — ต้องใส่ชื่อและรหัสก่อน

ตั้ง/เปลี่ยนรหัสหลังบ้าน:

node server/set-admin-password.mjs admin <รหัสใหม่>

คำสั่งนี้เขียน config/admin-credentials.json (salt + verifier ของ PBKDF2) — ตัวเว็บจะไม่เก็บรหัสจริงไว้เลย

รันในเครื่อง

node server/publish.mjs       # → http://localhost:8090

เปิดแบบไฟล์นิ่งก็ได้ (python -m http.server 8090) แต่จะ เผยแพร่จากหน้าเว็บไม่ได้ เพราะไม่มีเซิร์ฟเวอร์มารับการบันทึก — ใช้ปุ่ม “ดาวน์โหลด JSON” แทน

ระบบหลังบ้านทำงานอย่างไร

เบราว์เซอร์ (#/admin)
   │  PUT /api/projects   (JSON ทั้งก้อน)
   ▼
server/publish.mjs
   ├─ ตรวจข้อมูล (ชื่อว่าง / ลิงก์ผิด / อีเมลผิด → 422)
   ├─ เขียนทับ data/projects.json
   └─ git add + commit + push ขึ้น Gitea (repo นี้)

ตัวเลือกที่ใช้ได้:

ตัวแปร ค่าเริ่มต้น ความหมาย
PORT 8090 พอร์ตของเซิร์ฟเวอร์
ADMIN_TOKEN ว่าง ถ้าตั้ง ต้องกรอกรหัสในหน้า “ตั้งรหัสเผยแพร่” ก่อนบันทึก (แนะนำเมื่อเปิดให้เครื่องอื่นเข้า)
PUBLISH_PUSH 1 0 = เขียนไฟล์ + commit แต่ไม่ push
HOST 0.0.0.0 ถ้าไม่ตั้ง ADMIN_TOKEN จะรับเฉพาะ request จากเครื่องเดียวกัน

ถ้าไม่ได้ตั้ง ADMIN_TOKEN เซิร์ฟเวอร์จะอนุญาตเฉพาะเครื่องที่รันมันอยู่ — เปิดให้เครื่องอื่นแก้ต้องตั้งรหัสเสมอ

โปรเจคในเครื่อง (เห็นเฉพาะ localhost)

หน้าแรกมีส่วน “โปรเจคในเครื่อง” ที่สแกนโฟลเดอร์ข้างเคียง (D:\Git\workspace) แล้วลิงก์ไป หน้า index.html ของแต่ละโปรเจค โดยไม่ต้องหาโฟลเดอร์เอง

GET /api/local-projects      → รายการ {folder, entry, url, title, updated_at}
GET /projects/<โฟลเดอร์>/    → เสิร์ฟหน้าแรกของโฟลเดอร์นั้น
ตัวแปร ค่าเริ่มต้น ความหมาย
WORKSPACE_DIR โฟลเดอร์แม่ของ repo นี้ (D:\Git\workspace) ที่สแกนหาโปรเจค
WORKSPACE_DIR=none — ปิดฟีเจอร์นี้
  • รับเฉพาะ request จาก เครื่องที่รันเซิร์ฟเวอร์ (loopback) — เปิดให้เครื่องอื่นดูเว็บได้ แต่ดูไฟล์ในเครื่องไม่ได้
  • บล็อก node_modules, .git, .hermes และกัน path traversal
  • โฟลเดอร์ที่ไม่มี index.html (เช่น โปรเจคที่ต้องรัน npm run dev) จะไม่ถูกใส่ในรายการ
  • บนเว็บจริง (static host) API นี้ไม่มี → ส่วนนี้ซ่อนตัวเองอัตโนมัติ

เนื้อหาเริ่มต้น (มาจากตารางรายชื่อโปรเจค)

ชื่อโปรเจค ซับโดเมน อีเมล
หน้ารายชื่อโปรเจค www.hobbypj.com —
ใช้ทำงานประจำ dashboard.hobbypj.com —
รวบรวมโรงหนัง alterflixhub.hobbypj.com [email protected]
รวบรวมรถประจำทาง atroute.hobbypj.com [email protected]
ออกแบบสปริงเกลอร์ irrcal.hobbypj.com [email protected]
ขายเคสคอมปรับแต่ง kth.hobbypj.com [email protected]
ตัวอย่างรถประจำทางอุดมคติ at2pch.hobbypj.com —
ขายแผ่น Bluray และรายชื่อหนังมาดูซ้ำ flixdisc.hobbypj.com [email protected]
รายชื่อหนังสือส่วนตัว mylib.hobbypj.com —
รายชื่อเครื่องมือช่างส่วนตัว mytool.hobbypj.com —

โครงไฟล์

index.html               shell ของ SPA (header/footer + จุด mount)
manifest.json            manifest ของ PWA
sw.js                    service worker (ออฟไลน์ + อัปเดตอัตโนมัติ)
assets/css/              theme.css (โทเคน/ส่วนประกอบกลาง) · home.css · admin.css
ui/                      app.js · router.js · data.js · ui.js · pwa.js · views/
data/projects.json       ข้อมูลจริง (แก้ผ่านหลังบ้านเท่านั้น)
server/publish.mjs       เซิร์ฟเวอร์หลังบ้าน (static + API + git)
fonts/                   K2D ฝังในโปรเจค (SIL OFL 1.1)
icons/                   ไอคอน PWA (สร้างจากสคริปต์ PIL ไม่ใช้ emoji)

เครดิต

  • ฟอนต์ K2D — Cadson Demak, SIL Open Font License 1.1
  • โครงหน้า/จังหวะการวางเลย์เอาต์อ้างอิงจาก fastwork.co (ไม่ได้ลอกสีหรือสินทรัพย์ใด ๆ) — ธีมสีเป็นน้ำตาล-ขาวของโปรเจคนี้เอง
  • ไอคอนเป็น SVG วาดเองตามสไตล์เส้น 1.7px (ไม่มีอิโมจิในหน้าเว็บ)