IT Support Manual · v5.5

PT Medical System

คู่มือการติดตั้ง บำรุงรักษา และแก้ไขปัญหา สำหรับเจ้าหน้าที่ IT

ระบบ: PT Medical — Transport + First Aid + Location + GPS + Monitor
Stack: HTML/JS · Supabase · Cloudinary · Google Apps Script · CMSV6 · Google Maps Platform
Repo: github.com/supwilaimedical/pt-medical-system
Version: 5.5 — ปรับปรุงล่าสุด 2026-04-17

🆕 What's new in v5.5 (Apr 2026):

Admin Overview ปรับปรุงใหม่ — ย้ายไปขวาสุด, ตั้งค่า เป็น default, มี "ฟีเจอร์เด่น", System Health เพิ่ม Google Maps probe
ปุ่ม "เช็ค API ทั้งหมด" — ทดสอบ 5 Google APIs (Maps JS / Places New / Directions / Distance Matrix / Geocoding) พร้อมผลแยกแต่ละตัว
Landing Page mobile fix — แก้ logo หายบนมือถือ + card ไม่เต็ม (เปลี่ยนจาก flex center เป็น wrap scroll)
24-hour time — บังคับทุก <input type="time"> ใช้ 24 ชั่วโมง (lang="en-GB")
Phase 1-4 Maps: ค้นหาสถานที่ใกล้สุด, Directions + ETA, Distance Matrix ranking, Overspeed ≥120 km/h
DNR Policy: ภาพบัตร ปชช./Passport/เอกสารราชการ + ลายเซ็นพยาน (i18n 4 ภาษา)
Share Link: admin ลบ token หมดอายุได้

1ภาพรวมระบบ

PT Medical System คือระบบจัดการผู้ป่วยฉุกเฉิน + ปฐมพยาบาล + ติดตามรถ แบบ Web-based ไม่ต้องติดตั้งโปรแกรม ใช้งานผ่าน Browser ได้เลย ทั้งบนคอม แท็บเล็ต และมือถือ

🚑 Transport

บันทึกเคสนำส่งผู้ป่วย V/S 3 จุด (ต้นทาง/ระหว่างทาง/ปลายทาง) + IV + Consent + DNR (บัตร ปชช./Passport + ลายเซ็นพยาน) + พิมพ์ A4 + OCR

🩹 First Aid

อีเวนท์ปฐมพยาบาล, Triage 4 ระดับ, V/S, Quick Dispense ยา, รายงานสรุป

📡 GPS Tracking

ตามรถ real-time + แชร์ลิงก์ (admin ลบหมดอายุได้) + กล้อง + ค้นหาสถานที่ใกล้สุด + ETA + เตือนความเร็ว ≥120 km/h

📍 Location

ฐานข้อมูลตำแหน่ง + แผนที่ + marker cluster + mini-map ซ้อน modal + share link

🖥️ Monitor

Dashboard รวมสถานะ real-time + ค้นหาสถานที่ใกล้สุดในแผนที่รถ

⚙️ Admin Panel

ตั้งค่า, Map Provider (Leaflet/Google), เช็ค API 5 ตัว, สถิติ, Activity Log, ภาพรวม + version

2Stack และส่วนประกอบ

หัวข้อ	บริการ / ไลบรารี	หมายเหตุ
Frontend	HTML + JS (Vanilla) + Bootstrap 5.3	ไม่ใช้ Build tool — เปิดไฟล์ .html รันได้เลย
Database	Supabase PostgreSQL	rwxaalgvkzlsyfzdebcj.supabase.co
Realtime	Supabase Realtime (Postgres changes)	Sync ข้ามอุปกรณ์
Auth	Google Apps Script (HR API)	ไม่ใช้ Supabase Auth
File storage	Cloudinary (deimrg3xs)	รูป + PDF (ใบ Refer, Consent, DNR, บัตร ปชช.)
GPS API	CMSV6 / 808gps	ต้อง Proxy เพราะเป็น HTTP
GPS Proxy	Render.com + Google Apps Script fallback	Timeout 5s → ใช้ fallback
OCR	Gemini API via Cloudflare Worker	OCR บัตรประชาชน
Map (Leaflet)	Leaflet 1.9.4 + MarkerCluster	Default — ฟรี, Tile จาก OSM/CartoDB
Map (Google) optional	Google Maps Platform — Maps JS, Places (New), Directions, Distance Matrix, Geocoding	เปิดใน Admin → ต้องใส่ API key (ต้องเปิดทั้ง 5 API + ตั้ง referrer)
PDF	PDF.js 2.16.105	แสดงผล PDF ใน browser
Config file	`shared/config.js`	`window.APP_VERSION` = "5.5" (อัพเดตทุก release)

3การเข้าถึง / Login

เปิด Browser ไปที่ URL ระบบ (เช่น https://your-domain/pt-medical-system/)
ใส่ Username และ Password ที่ HR ให้มา (ใช้ระบบเดียวกับข้อมูลพนักงาน)
กด Login — ระบบจะเช็คผ่าน Google Apps Script (GAS HR API)
ถ้า role เป็น Admin จะเห็นปุ่ม "ตั้งค่า" และเมนูเพิ่มเติม

💡 Session — เก็บใน browser's localStorage key: pt_user_meta ปิด browser แล้วเปิดใหม่ยังล็อกอินอยู่ — ถ้าอยาก logout ให้กดปุ่ม logout

⚠️ ถ้า Login ไม่ได้ — ตรวจสอบ: (1) Internet (2) GAS_AUTH_API_URL ยังทำงานอยู่ไหม (3) Username/Password ถูกต้องไหม (4) Browser console มี error อะไร

4โครงสร้างไฟล์

pt-medical-system/
├── index.html              ← Landing + Login + Admin
├── shared/                 ← ไลบรารีใช้ร่วมทุกโมดูล
│   ├── config.js           ← URL + Key ทั้งระบบ (สำคัญ!)
│   ├── auth.js             ← Login, session
│   ├── realtime.js         ← Supabase realtime
│   ├── cloudinary.js       ← Upload
│   ├── gps-providers.js    ← Adapter GPS (CMSV6...)
│   └── styles.css          ← CSS รวม
├── transport/index.html    ← โมดูล Transport
├── firstaid/index.html     ← โมดูล First Aid
├── gps/
│   ├── index.html          ← Dashboard GPS (Admin)
│   └── share.html          ← หน้าแชร์สาธารณะ (no auth)
├── location/index.html     ← โมดูล Location
├── monitor/index.html      ← Dashboard Monitor
├── migration/*.sql         ← SQL สำหรับ Supabase
├── cloudflare/             ← Cloudflare Worker code
└── docs/                   ← เอกสาร

5ฐานข้อมูล Supabase

Tables หลัก

Table	หน้าที่	Module
`cases`	เคส Transport — ข้อมูลผู้ป่วย V/S, IV, สถานะ	Transport
`transport_consents`	Consent ทุก version (ไม่ลบ)	Transport
`fa_events`	อีเวนท์ปฐมพยาบาล	First Aid
`fa_registry`	ผู้บาดเจ็บในอีเวนท์	First Aid
`loc_customers`	ลูกค้า/สถานที่บนแผนที่	Location
`loc_shared_tokens`	ลิงก์แชร์ location	Location
`gps_providers`	บัญชี GPS (CMSV6)	GPS
`gps_vehicles`	รถที่ sync มาจาก CMSV6	GPS
`gps_shared_tokens`	ลิงก์แชร์ GPS + สิทธิ์กล้อง	GPS
`settings`	ตั้งค่าระบบ (key-value)	All
`activity_log`	บันทึกกิจกรรม user (audit trail)	All
`analytics`	Snapshot เคสสำหรับรีพอร์ต	All

การเข้าถึง Supabase

เข้า https://supabase.com/dashboard → เลือก project rwxaalgvkzlsyfzdebcj
Table Editor → เลือก table ที่ต้องการดู/แก้
SQL Editor → รัน query ได้โดยตรง
Settings → API → ดู URL และ anon key

🔒 ห้ามแชร์ service_role key — ใช้เฉพาะ anon key สำหรับ client-side service_role key มีสิทธิ์เต็ม bypass RLS — แชร์แล้วอันตรายมาก

6Credential & Config

ทุกค่าที่เป็น public (URL, anon key, cloudinary cloud name) อยู่ใน shared/config.js

const CONFIG = {
  SUPABASE_URL: 'https://rwxaalgvkzlsyfzdebcj.supabase.co',
  SUPABASE_ANON_KEY: 'sb_publishable_...',
  CLOUDINARY_CLOUD_NAME: 'deimrg3xs',
  CLOUDINARY_UPLOAD_PRESET: 'pt-medical',
  GAS_AUTH_API_URL: 'https://script.google.com/macros/s/.../exec',
  GPS_PROXY_URL: 'https://gps-proxy-lpdq.onrender.com',
  GPS_PROXY_FALLBACK: 'https://script.google.com/macros/.../exec',
  OCR_PROXY_URL: 'https://gps-proxy.supwilai-ambulance.workers.dev'
};

⚠️ Secret ที่ห้ามเข้า git: Supabase service_role key, Gemini API key, รหัสบัญชี CMSV6 — เก็บไว้ที่ Cloudflare Secret, Render env, หรือ .env ที่ ignore แล้ว

7Deploy / Hosting

ระบบเป็น Static site — ไม่มี backend ต้อง deploy เองก็ได้ หรือโฮสต์ที่:

GitHub Pages — เปิด Pages จาก repo → เลือก branch main → ใช้ root
Cloudflare Pages — connect repo → build command เว้นว่าง → output dir = root
Netlify — ลาก folder ใส่ หรือ connect repo
Self-host — วางไฟล์ใน nginx/apache — serve static

✅ เปิด HTTPS — จำเป็น! เพราะ (1) Service Worker ต้องการ (2) getUserMedia (กล้อง) ต้องการ (3) Supabase realtime ใช้ wss://

8GPS Proxy Architecture

CMSV6 เป็น HTTP ไม่ใช่ HTTPS — browser จะ block เพราะ mixed content ระบบเลยผ่าน proxy 2 ชั้น:

ลำดับ	บริการ	URL / ตั้งค่า	Timeout
1 (เร็ว)	Render.com	`gps-proxy-lpdq.onrender.com`	5 วิ
2 (fallback)	Google Apps Script	เดียวกับ AUTH_API	ช้ากว่าแต่นิ่ง

⚠️ Render free tier "นอน" หลังไม่ใช้ 15 นาที — ต่อครั้งแรกอาจรอ 30 วิ ระบบจะ fallback ไป GAS ถ้า timeout

การตรวจสอบ

เข้า Admin → GPS → ดู Proxy Status Monitor
หรือเปิด https://gps-proxy-lpdq.onrender.com ตรงๆ ควรตอบ 200/404
Console log ที่หน้า GPS จะเห็น "proxy failed, using fallback"

9Cloudinary (รูป + PDF)

ใช้ Upload preset pt-medical แบบ unsigned (client upload ได้ตรง)

Folder structure

pt-medical/transport/{case_id} — ใบ Refer ของแต่ละเคส
pt-medical/firstaid/ — รูปอีเวนท์
pt-medical/location/ — รูปสถานที่
pt-medical/signatures/ — ลายเซ็น Consent
pt-medical/logos/ — โลโก้บริษัท

🛑 ถ้า PDF view ไม่ได้ — ไปที่ Cloudinary Dashboard → Settings → Security → เปิด "Allow delivery of PDF and ZIP files"

10งานประจำ (Daily / Weekly)

Daily

เช็ค Admin → ภาพรวม → ดู System Health (Database, Realtime, GPS Proxy) ต้องเขียวหมด
ดู Activity Log → ค้นหา action ผิดปกติ (DELETE_CASE, SETTINGS_UPDATE)
เช็คเคส Active ค้างเกิน 24 ชม. — อาจลืมปิดเคส

Weekly

Supabase Dashboard → Database → ดู disk usage + row count
Cloudinary Dashboard → ดู storage + bandwidth
ทดสอบ GPS Share link — สร้าง/เปิดดู/ยกเลิก
ทดสอบ Multi-device consent flow (Device A + B)

Monthly

Backup ฐานข้อมูล (Supabase → Database → Backups, หรือ SQL Dump)
Export Activity Log ลบ row เก่าเกิน 6 เดือน
Update dependencies (Bootstrap, Leaflet, PDF.js) ถ้ามี security patch

11Troubleshoot ปัญหาที่พบบ่อย

อาการ	สาเหตุ	วิธีแก้
หน้าแชร์ GPS loading ค้าง	Token ไม่มี / หมดอายุ / provider off	เช็ค `gps_shared_tokens` → `status='Active'` และ `expires_at > now()`
GPS Refresh ช้ามาก (>10s)	Render proxy หลับ — ใช้ GAS fallback	ไปเปิด URL Render ตรงๆ ครั้งเดียวให้ตื่น ปกติเร็วภายใน 30 วิ
PDF Refer ไม่โชว์	Cloudinary PDF delivery ปิดอยู่	Settings → Security → เปิด "Allow delivery of PDF"
Refer docs หายหลังเปิดเคสใหม่	Bug เก่า (แก้แล้ว commit 468ab80)	อัปเดต code เป็น version ล่าสุด
Login บอก "รหัสผิด" ทั้งที่ถูก	GAS API ไม่ตอบ / URL เปลี่ยน	เปิด Browser Console ดู error → เช็ค GAS_AUTH_API_URL ยัง deploy อยู่ไหม
Realtime ไม่ sync ข้าม device	(1) Realtime ปิด (2) RLS block (3) WebSocket block	Admin → ภาพรวม → เช็ค Realtime Status → ถ้าไม่เขียวเข้า Supabase เปิด realtime
Device B sync แล้ว Device A หายข้อมูล	Race condition — Device A overwrite	สอนผู้ใช้ Refresh ก่อน Save (ดู `docs/MULTI_DEVICE_WORKFLOW.md`)
แผนที่ไม่โหลด tile	CartoDB ล่ม / CORS	เปลี่ยน tile เป็น OSM: `https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png`
กล้อง CMSV6 เปิดไม่ได้	HLS port 6604 block / session หมดอายุ	Admin → GPS Provider → ทดสอบเชื่อมต่อ → re-login
หน้าเด้งกลับ Login ตลอด	`pt_user_meta` โดนลบ / corrupt	Browser → Console → `localStorage.clear()` แล้ว Login ใหม่

12Backup / Recovery

Backup รายเดือน

เข้า Supabase Dashboard → Database → Backups
คลิก "Download backup" (backup อัตโนมัติทำทุกวัน เก็บ 7 วัน)
หรือใช้ SQL Editor → export table ที่สำคัญเป็น CSV
เก็บไฟล์ backup ที่ Google Drive / OneDrive (อย่าเก็บเครื่องเดียว)

Recovery

Supabase → Database → Backups → "Restore" (pro plan เท่านั้น)
หรือ Import CSV กลับเข้า table เดิม (SQL: COPY table FROM 'file.csv' CSV HEADER)
ทดสอบใน staging ก่อน restore production

💾 Cloudinary ไม่ต้อง backup — Cloudinary มี durability เองแล้ว แต่ URL ทั้งหมดอยู่ใน Supabase อยู่แล้ว — ถ้าลบ Cloudinary → PDF/รูปหายหมด

13การเพิ่ม User ใหม่

ระบบใช้ GAS HR API ไม่ใช่ Supabase Auth ดังนั้น:

ติดต่อ HR ให้เพิ่มพนักงานในระบบ HR (Google Sheet หลัง GAS)
กำหนด username/password และ role (Admin / User)
HR save sheet → GAS จะเห็นผู้ใช้ใหม่อัตโนมัติ
แจ้งผู้ใช้ login ที่ URL ระบบ

ℹ️ Role ที่ใช้: Admin เห็น ตั้งค่า + Provider GPS + Log
User (ค่า default) เห็นโมดูลอื่นทั้งหมดเว้นแต่ตั้งค่า

14การอัปเกรด / Deploy ใหม่

Dev push code ขึ้น GitHub (repo supwilaimedical/pt-medical-system)
ถ้าใช้ Cloudflare Pages / Netlify / GitHub Pages — auto deploy
ถ้า self-host — git pull บน server
ถ้ามี migration SQL ใหม่ (folder migration/) — รันใน Supabase SQL Editor
ทดสอบ smoke test: Login → เปิดแต่ละโมดูล → สร้างเคสทดสอบ

🛑 Rollback — ถ้า deploy แล้วพัง: git revert HEAD แล้ว push หรือ redeploy commit เก่า (Cloudflare Pages/Netlify เก็บ history ให้)

15Contact & Escalation

ระดับ	ติดต่อ	เคสที่เหมาะ
L1	IT Support (คุณ)	Login ไม่ได้, ใช้งาน UI ไม่เป็น
L2	System Admin	Supabase ล่ม, RLS error, Proxy ตาย
L3	Developer (repo maintainer)	Bug ใน code, schema migration, new feature

📞 Emergency — ถ้าทั้งระบบใช้งานไม่ได้เกิน 30 นาที โทรหา Developer ทันที (แจ้งระดับความรุนแรง + จำนวนผู้กระทบ + error screenshot)

📘 คู่มือ IT Support — PT Medical System

PT Medical System

📑 สารบัญ

1ภาพรวมระบบ

2Stack และส่วนประกอบ

3การเข้าถึง / Login

4โครงสร้างไฟล์

5ฐานข้อมูล Supabase

Tables หลัก

การเข้าถึง Supabase

6Credential & Config

7Deploy / Hosting

8GPS Proxy Architecture

การตรวจสอบ

9Cloudinary (รูป + PDF)

Folder structure

10งานประจำ (Daily / Weekly)

Daily

Weekly

Monthly

11Troubleshoot ปัญหาที่พบบ่อย

12Backup / Recovery

Backup รายเดือน

Recovery

13การเพิ่ม User ใหม่

14การอัปเกรด / Deploy ใหม่

15Contact & Escalation