Files
web-camera-category/app/README.md
T
2026-10-24 17:32:25 +07:00

63 lines
3.9 KiB
Markdown

# CamCat — Web Camera Category PWA (One UI)
PWA ถ่ายรูปหน้างาน แยกโฟลเดอร์ตามไซต์ พร้อม Metadata, ZIP ทั้งโฟลเดอร์ และแชร์ผ่านระบบของมือถือ
หน้าตาออกแบบตามภาษา **Samsung One UI** (การ์ดมุมโค้ง 26px, พิลล์, ธีมสว่าง/มืด, ไอคอน SVG ล้วน)
## Features
- กล้องหลัง/หน้า, ไฟแฟลช (torch), ซูมแบบ pills 1×/2×/3×, เส้นแบ่ง 3 ส่วน
- ถ่ายด้วย `ImageCapture.takePhoto()` (ความละเอียดเต็ม) fallback เป็น canvas
- เขียน EXIF ลงไฟล์จริง (Make/Model/DateTimeOriginal/GPS) ก่อนบันทึก → ติดไปตอนแชร์
- โฟลเดอร์ชื่อเริ่มต้น `Site A <ปี พ.ศ.>-<เดือน>-<วัน>` อัตโนมัติ (Asia/Bangkok)
- ZIP **ทุกรูปในโฟลเดอร์** + `metadata.json` แล้วดาวน์โหลดลงเครื่อง
- ปุ่มแชร์ = สร้าง ZIP แล้วส่งเข้า share sheet ของ Samsung ไปแอปอื่น (fallback = ดาวน์โหลด)
- ธีมสว่าง/มืด/ตามระบบ (จำค่าไว้), safe-area, 100dvh, ปุ่ม ≥44px ตาม One UI
- QR ลิงก์ทดสอบบนมือถือ (ต้อง HTTPS) + หน้าข้อมูลอุปกรณ์/กล้อง (diagnostics)
- Offline: Service Worker + IndexedDB, ติดตั้งเป็น PWA ได้
## Design (One UI)
| องค์ประกอบ | ค่า |
|---|---|
| สีหลัก light | bg `#F2F3F5` · card `#FFFFFF` · text `#101114` · accent `#0A72DE` |
| สีหลัก dark | bg `#000000` · card `#1B1B1D` · text `#F2F3F5` · accent `#4E9DFF` |
| มุมโค้ง | การ์ด 26px · ช่องกรอก 16px · ปุ่ม/ชิปเป็น pills |
| ตัวอักษร | One UI Sans → SF / Segoe / Roboto / Noto Sans Thai |
| ระยะ | 4/8px rhythm, ขอบข้าง 20px |
| Accessibility | ข้อความ ≥4.5:1, ปุ่ม ≥44px, reduced-motion, focus ring |
| หน้าเมนูกล้อง | โครมดำทั้งหน้าแบบ One UI Camera |
## รันทดสอบ
```bash
cd app
python -m http.server 8099 --bind 0.0.0.0
# กล้องใช้ได้เฉพาะ HTTPS — เปิด tunnel แล้วสแกน QR ในแอป
cloudflared tunnel --url http://127.0.0.1:8099
```
## Files
```
app/
├── index.html # shell + header/nav แบบ One UI
├── css/app.css # design tokens + components (light/dark)
├── js/config.js # ค่าคงที่ (Site A, timezone, quality)
├── js/naming.js # ชื่อโฟลเดอร์/ไฟล์ ปี พ.ศ.
├── js/db.js # IndexedDB (folders, images, thumbs)
├── js/exif.js # อ่าน/เขียน EXIF (piexifjs)
├── js/device.js # ตรวจรุ่นเครื่อง (SM-S911B → Galaxy S23)
├── js/camera.js # getUserMedia, ImageCapture, torch, zoom
├── js/archive.js # ZIP + ดาวน์โหลด + Web Share (มี cache)
├── js/ui.js # markup + bottom sheet + toast
├── js/main.js # state, events, ธีม, diagnostics
├── vendor/ # jszip, piexif, qrcode (ใช้ offline)
├── sw.js · manifest.json · icon-*.png
└── README.md
```
## Browser
Chrome/Edge Android (Samsung S23 คือเครื่องทดสอบหลัก) · Safari 16+ (ไม่มี torch/zoom)