- 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
101 lines
7.5 KiB
Markdown
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 (ไม่มีอิโมจิในหน้าเว็บ)
|