Files
hobbypj-contents/README.md
T
Bkk1234 a629e67ca4 feat(admin): verify the backoffice password with PBKDF2, not plaintext compare
- ui/auth.js: derive PBKDF2-HMAC-SHA256(name:password) with a per-deploy salt
  (250k iterations) and compare against the verifier in constant time
- config/admin-credentials.json holds salt/iterations/verifier only — no password
- server/set-admin-password.mjs generates/rotates that file (CLI or hidden prompt)
- login is async now: button shows a pending state; config load errors surface in the form
- SW precaches the credentials file; version bumped to 2026.11.19.4
- docs: README/AGENTS explain rotation and the residual limits of a client-side gate
2026-11-19 11:32:48 +07:00

82 lines
5.8 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` เซิร์ฟเวอร์จะอนุญาตเฉพาะเครื่องที่รันมันอยู่ — เปิดให้เครื่องอื่นแก้ต้องตั้งรหัสเสมอ
## เนื้อหาเริ่มต้น (มาจากตารางรายชื่อโปรเจค)
| ชื่อโปรเจค | ซับโดเมน | อีเมล |
|---|---|---|
| หน้ารายชื่อโปรเจค | 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 (ไม่มีอิโมจิในหน้าเว็บ)