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

101 lines
7.5 KiB
Markdown

# hobbypj-contents — หน้ารายชื่อโปรเจคอดิเรก
หน้าเว็บรวมรายชื่อโปรเจคอดิเรกของเรา (PWA + SPA แบบไม่มี build step) พร้อม **หลังบ้าน** สำหรับแก้ชื่อโปรเจค คำอธิบายใต้ชื่อ และลิงก์
- เว็บจริง: https://www.hobbypj.com
- ข้อมูลทั้งหมดอยู่ในไฟล์เดียว: `data/projects.json`
- หน้าแก้ไข: `#/admin` (หรือกดปุ่ม “แก้ไขรายการ” มุมขวาบน) — ต้องใส่ชื่อและรหัสก่อน
ตั้ง/เปลี่ยนรหัสหลังบ้าน:
```bash
node server/set-admin-password.mjs admin <รหัสใหม่>
```
คำสั่งนี้เขียน `config/admin-credentials.json` (salt + verifier ของ PBKDF2) — ตัวเว็บจะไม่เก็บรหัสจริงไว้เลย
## รันในเครื่อง
```bash
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 | alterflixhub@hobbypj.com |
| รวบรวมรถประจำทาง | atroute.hobbypj.com | atroute@hobbypj.com |
| ออกแบบสปริงเกลอร์ | irrcal.hobbypj.com | irrcal@hobbypj.com |
| ขายเคสคอมปรับแต่ง | kth.hobbypj.com | kth@hobbypj.com |
| ตัวอย่างรถประจำทางอุดมคติ | at2pch.hobbypj.com | — |
| ขายแผ่น Bluray และรายชื่อหนังมาดูซ้ำ | flixdisc.hobbypj.com | flixdisc@hobbypj.com |
| รายชื่อหนังสือส่วนตัว | 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 (ไม่มีอิโมจิในหน้าเว็บ)