Files
hobbypj-contents/README.md
T

104 lines
7.6 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” แทน
## รันด้วย container
```bash
cp .env.example .env # ตั้ง PORT / ADMIN_TOKEN / BIND_ADDRESS ตามต้องการ
docker compose up -d --build # → http://localhost:${PORT:-8090}
docker compose logs -f
docker compose down
```
- พอร์ตฝั่งโฮสต์และพอร์ตใน container มาจาก `PORT` ตัวเดียว (แอปอ่าน `process.env.PORT`)
- `./data` ถูก mount เป็น `/app/data` — ข้อมูลที่แก้ผ่านหลังบ้านจึงอยู่ที่โฮสต์ ไม่หายเมื่อ recreate container
- image ไม่มี `.git` และตั้ง `PUBLISH_PUSH=0` เป็นค่าเริ่มต้น → หลังบ้านเขียน JSON ได้ แต่ไม่ commit/push
ถ้าต้องการให้ publish ขึ้น Gitea จากใน container ให้ mount โฟลเดอร์ repo (`.git` ด้วย) และตั้ง `PUBLISH_PUSH=1`
- **podman บน Windows/WSL**: bridge network สร้างไม่ได้ (`netavark … firewall backend`) ใช้ override ที่ให้ไปแทน
```bash
PORT=8090 podman-compose -f docker-compose.yml -f docker-compose.podman.yml up -d
```
โหมด `network_mode: host` จะทิ้งพอร์ต mapping และฟังที่ `PORT` บนโฮสต์ตรง ๆ
## ระบบหลังบ้านทำงานอย่างไร
```
เบราว์เซอร์ (#/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 | [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)
Dockerfile image สำหรับรันเซิร์ฟเวอร์ (node:22-alpine + git)
docker-compose.yml compose (PORT จาก env) · docker-compose.podman.yml = override บน WSL
.env.example ตัวอย่างค่าตั้ง: PORT · BIND_ADDRESS · ADMIN_TOKEN · PUBLISH_PUSH
fonts/ K2D ฝังในโปรเจค (SIL OFL 1.1)
icons/ ไอคอน PWA (สร้างจากสคริปต์ PIL ไม่ใช้ emoji)
```
## เครดิต
- ฟอนต์ K2D — Cadson Demak, SIL Open Font License 1.1
- โครงหน้า/จังหวะการวางเลย์เอาต์อ้างอิงจาก fastwork.co (ไม่ได้ลอกสีหรือสินทรัพย์ใด ๆ) — ธีมสีเป็นน้ำตาล-ขาวของโปรเจคนี้เอง
- ไอคอนเป็น SVG วาดเองตามสไตล์เส้น 1.7px (ไม่มีอิโมจิในหน้าเว็บ)