# CamCat — Web Camera Category PWA (One UI) PWA ถ่ายรูปหน้างาน แยกโฟลเดอร์ตามไซต์ พร้อม Metadata, ZIP ทั้งโฟลเดอร์ และแชร์ผ่านระบบของมือถือ หน้าตาออกแบบตามภาษา **Samsung One UI** (การ์ดมุมโค้ง 26px, พิลล์, ธีมสว่าง/มืด, ไอคอน SVG ล้วน) ## Features - กล้องหลัง/หน้า, ไฟแฟลช (torch), ซูมแบบ pills 1×/2×/3×, เส้นแบ่ง 3 ส่วน, อัตราส่วนภาพ 4:3 / 3:4 (ครอปจริง) - จัดทิศทางภาพอัตโนมัติ (EXIF Orientation → หมุนพิกเซล → Orientation=1) + ปุ่มหมุนซ้าย/ขวาในชีตรูป - APK: ปุ่มเพิ่ม/ลดเสียง = ชัตเตอร์, ล็อกแนวตั้ง - ถ่ายด้วย `ImageCapture.takePhoto()` (ความละเอียดเต็ม) fallback เป็น canvas - เขียน EXIF มาตรฐานลงไฟล์จริงก่อนบันทึก (Make/Model/Software/DateTimeOriginal/ExifVersion/ColorSpace/Resolution/ImageUniqueID + GPS ละเอียด/เวลา/ความแม่นยำ) → ติดไปตอนแชร์ - โฟลเดอร์ชื่อเริ่มต้นอัตโนมัติ: `Site <ตัวอักษร> <ปี พ.ศ.>.<เดือน>.<วัน>.<ชั่วโมง>.<นาที>` - ตัวอักษรไล่ a…z แล้วต่อ aa, ab … az, ba … (แบบคอลัมน์ Excel) - ปุ่ม `+` บนหัวแอป = สร้างทันที · ปุ่ม "โฟลเดอร์ใหม่" = เปิดชีตแก้ชื่อก่อนสร้าง · เปลี่ยนชื่อทีหลังได้ (ปุ่มดินสอ) - นำเข้าโฟลเดอร์ทีละหลายรายการจาก CSV (ดูหัวตารางด้านล่าง) — ไฟล์เปล่า: `templates/folders-template.csv` - ZIP **ทุกรูปในโฟลเดอร์** (มีแต่ JPEG — metadata อยู่ใน EXIF ของแต่ละไฟล์) แล้วดาวน์โหลดลงเครื่อง - โครงสร้างใน zip = `<ชื่อโฟลเดอร์>/<ไฟล์>.jpg` → แตกออกมาเป็นโฟลเดอร์จริง - ปุ่ม **ZIP ทุกโฟลเดอร์** ที่หน้าโฟลเดอร์ → ไฟล์เดียว `CamCat-all-.zip` แยกโฟลเดอร์ย่อยครบทุกโฟลเดอร์ - ปุ่ม ZIP = รวมทุกรูปในโฟลเดอร์แล้วดาวน์โหลดลงเครื่อง (ปุ่มแชร์ ZIP ถูกถอดออกตามคำสั่ง) - ธีมสว่าง/มืด/ตามระบบ (จำค่าไว้), safe-area, 100dvh, ปุ่ม ≥44px ตาม One UI - QR ลิงก์ทดสอบบนมือถือ (ต้อง HTTPS) + หน้าข้อมูลอุปกรณ์/กล้อง (diagnostics) - Offline: Service Worker + IndexedDB, ติดตั้งเป็น PWA ได้ - คู่มือใช้งานหน้าเดียว (standalone HTML, พิมพ์/บันทึก PDF ได้): `manual.html` → เปิดที่ `/manual.html` ## 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 | ## นำเข้าโฟลเดอร์จาก CSV หัวตาราง 4 คอลัมน์ (ทุกคอลัมน์เว้นว่างได้): | คอลัมน์ | ความหมาย | |---|---| | `site` | คำนำหน้า เช่น `Site` (เว้นว่าง = `Site`) | | `letter` | `a`…`z`, `aa`… (เว้นว่าง = ไล่ต่อจากโฟลเดอร์ที่มีอยู่ให้อัตโนมัติ) | | `datetime` | `2569.10.25.21.45` (รับ `-` `/` `:` หรือ ค.ศ. ได้ เช่น `2026-10-25 21:45`) | | `name` | ชื่อเต็ม ถ้าใส่จะใช้ค่านี้แทนการประกอบชื่อ | ตัวอย่าง: ```csv site,letter,datetime,name Site,a,2569.10.25.21.45, Site,b,2569.10.25.22.10, Site,,2569.10.26.08.00,หน้างานพิเศษ ``` กติกาที่ระบบบังคับ: `letter` ต้อง a-z · `datetime` ต้องอ่านเป็นวันเวลาได้ · ชื่อซ้ำจะถูกข้ามพร้อมรายงานแถวที่ผิด ## ปุ่มแชร์ ZIP (Web Share) 1. ZIP ถูกสร้างล่วงหน้าหลังเปิดแกลเลอรี → กด "แชร์ ZIP" แล้วเรียก `navigator.share({files})` ทันทีในจังหวะแตะ (ไม่ให้ user activation หมดอายุ) 2. ถ้ายังไม่มี ZIP / เบราว์เซอร์ตัดสิทธิ์ → เปิดชีต "ZIP พร้อมแล้ว" ให้กด "แชร์ไปแอปอื่น" อีกครั้ง (activation ใหม่) หรือ "บันทึกไฟล์" 3. เบราว์เซอร์ที่ไม่รองรับแชร์ไฟล์ (เช่น Samsung Internet บางเวอร์ชัน) → ปุ่มแชร์ถูกปิด พร้อมปุ่มบันทึกไฟล์แทน ## EXIF ที่ฝังในไฟล์ (per photo) | IFD | tag | |---|---| | IFD0 | 270 ImageDescription (`CamCat · <โฟลเดอร์>`) · 271 Make `samsung` · 272 Model `SM-S911B` · 274 Orientation · 282/283/296 Resolution · 305 Software · 306 DateTime | | Exif | 36864 ExifVersion 0232 · 36867/36868 DateTimeOriginal/Digitized · 37121 ComponentsConfiguration · 37380 ExposureBias · 40961 ColorSpace sRGB · 40962/40963 Pixel dims · 41985–41994 (rendering modes) · 42016 ImageUniqueID | | GPS | 0 Version · 1/2 LatRef+Lat · 3/4 LonRef+Lon · 5/6 Altitude · 7 TimeStamp · 27 ProcessingMethod · 29 DateStamp · 31 HPositioningError (±เมตร) | ไม่มีไฟล์ JSON แยก — เปิดรูปด้วยแอป Samsung Gallery / Google Photos / exiftool แล้วเห็นค่าพวกนี้ทันที ## รันทดสอบ ```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)