PR-OS: ระบบบริหารจัดการงานประชาสัมพันธ์

PR-OS เป็นโครงโปรเจกต์สำหรับส่งต่อโปรแกรมเมอร์เพื่อพัฒนาระบบบริหารจัดการงานประชาสัมพันธ์ของหน่วยงานเทศบาล โดยเน้นการบันทึกงาน กำหนดผู้รับผิดชอบ แสดงตารางงานบนจอมอนิเตอร์ รับทราบงาน แจ้งเตือน และรายงานผู้บริหาร

สถานะปัจจุบัน: Phase 1 MVP กำลังพัฒนา — เชื่อมต่อ Supabase จริงแล้ว (Auth + PostgreSQL + RLS) พร้อมฟีเจอร์หลักที่ใช้งานได้จริง: เข้าสู่ระบบด้วย username, ตารางงาน, เพิ่ม/แก้ไข/เผยแพร่/ยกเลิกงาน + audit log, มอบหมาย/รับทราบ, จอมอนิเตอร์ (monitor-safe), ไฟล์แนบส่วนตัว, รายงานผู้บริหาร + ส่งออก Excel/PDF, คิวแจ้งเตือน และหน้าตั้งค่าผู้ดูแล ดูรายละเอียดความคืบหน้าที่ docs/14-implementation-status.md

หมายเหตุ:

• การส่งแจ้งเตือนจริงผ่าน LINE/Email ยังทำงานโหมดจำลอง เพราะยังไม่ได้ใส่ credential ของ provider
• Supabase project ถูก pause (แผนฟรี pause หลังไม่มี activity 7 วัน) ต้อง restore ก่อนรันระบบ — ขั้นตอนอยู่ใน docs/15-operations-runbook.md
• migration 0009 และ 0010 ยังไม่ได้รันบน Supabase จริง

เป้าหมาย

• ให้ฝ่ายประชาสัมพันธ์เห็นงานทั้งหมดจากจุดเดียว แทนการพึ่งกระดานหรือการถามซ้ำ
• ให้ผู้ได้รับมอบหมายรับทราบงานผ่านมือถือหรือเว็บได้
• ให้หัวหน้างานตรวจสอบภาระงาน การเปลี่ยนแปลง และงานที่ยังไม่รับทราบได้รวดเร็ว
• ให้ผู้บริหารมีรายงานสรุปที่อ่านง่าย ส่งออกได้ และตรวจสอบที่มาของข้อมูลได้
• ให้โปรแกรมเมอร์นำโครงนี้ไปพัฒนาต่อด้วย Next.js + Supabase/PostgreSQL ได้ทันที

Reference Stack

• Frontend: Next.js App Router + TypeScript
• UI: CSS modules/global CSS หรือย้ายไป Tailwind/shadcn ได้ภายหลัง
• Backend reference: Supabase Auth, PostgreSQL, Storage, Row Level Security
• Notification: LINE Messaging API เป็น primary channel พร้อม Email fallback
• Reports: SQL views/materialized views ในช่วงแรก แล้วค่อยเพิ่ม BI หรือ AI ใน Phase 3

โครงสร้างไฟล์สำคัญ

docs/
  01-vision-and-scope.md
  02-requirements-prd.md
  03-user-flows.md
  04-data-model.md
  05-api-contract.md
  06-ui-screens.md
  07-implementation-plan.md
  08-security-and-permissions.md
  09-notification-design.md
  10-handoff-checklist.md
  11-recommended-skills.md
  12-visual-design-direction.md
  13-setup-free-tier.md
  14-implementation-status.md       สถานะละเอียด: ทำแล้ว/ยังเหลือ
  15-operations-runbook.md          งานที่เจ้าของโปรเจกต์ต้องทำเอง (restore, migration, credential)
  16-external-review-brief.md       บริบทสำหรับที่ปรึกษา/ผู้ตรวจจากภายนอก
src/
  app/                  หน้าจอจริง (App Router) + route handlers ใน app/api
  components/           คอมโพเนนต์ UI ที่ใช้ซ้ำ
  lib/                  โดเมนโมดูล: events, assignments, attachments, monitor, notifications, reports, export, settings, supabase, auth
  types/domain.ts       Domain types ที่ใช้ร่วมกัน
supabase/
  migrations/0001..0010_*.sql

วิธีเริ่มพัฒนาต่อ

1. อ่าน docs/01-vision-and-scope.md เพื่อเข้าใจเป้าหมายและ phase
2. อ่าน docs/02-requirements-prd.md เพื่อเข้าใจ requirement ที่ตกลงแล้ว
3. ตรวจ docs/04-data-model.md และ supabase/migrations/0001_initial_schema.sql
4. เปิด prototype mock screens เพื่อคุยกับผู้ใช้ก่อนต่อ backend
5. เริ่ม implement ตาม docs/07-implementation-plan.md

คำสั่งสำหรับโปรแกรมเมอร์

หลังติดตั้ง dependency แล้วสามารถใช้คำสั่งมาตรฐานของ Next.js:

npm install
npm run dev
npm run lint
npm run typecheck

ค่า environment เริ่มจาก .env.example แล้วสร้าง .env.local ในเครื่องพัฒนา (ต้องใส่ค่า Supabase จริง ดู docs/13-setup-free-tier.md)

การเข้าสู่ระบบ

ระบบใช้ username/password (ไม่ใช่อีเมล) — โดย Supabase Auth ยังเก็บอีเมลเบื้องหลัง แต่ผู้ใช้ล็อกอินด้วย username สั้น ๆ ระบบจะแปลง username เป็นอีเมลฝั่งเซิร์ฟเวอร์ตอนล็อกอิน (อีเมลไม่ถูกส่งไปฝั่ง browser)

• สร้างบัญชีใหม่ที่ Supabase → Authentication → Users (ติ๊ก Auto Confirm) จากนั้นไปที่หน้า /settings เพื่อกำหนด ชื่อผู้ใช้ (username), บทบาท (role) และผูกกับรายชื่อบุคลากร
• ผู้ดูแลระบบจัดการบุคลากร บัญชี ข้อมูลหลัก และการแจ้งเตือนได้ที่ /settings
• จอมอนิเตอร์ /monitor เป็นหน้าสาธารณะ (ไม่ต้องล็อกอิน) แสดงเฉพาะข้อมูลที่ปลอดภัย — ค่าเริ่มต้นเป็น ตารางเรียบ อ่านง่าย ตัวใหญ่ (วัน/เวลา/งาน/สถานที่/ผู้รับผิดชอบ/หมายเหตุ); จอทีวีย้อนยุคเดิมเก็บไว้ที่ /monitor?classic=1

ไฟล์แนบและการส่งออกรายงาน

• ไฟล์แนบ อยู่ในหน้ารายละเอียดงาน /events/[id] เก็บใน private bucket ของ Supabase Storage ดาวน์โหลดผ่านลิงก์เซ็นชื่อที่หมดอายุใน 60 วินาที (/api/attachments/[id]) — เจ้าหน้าที่ backend แนบ/ลบได้, ผู้รับมอบหมายเห็นเฉพาะงานของตัวเอง, จอมอนิเตอร์ไม่เห็นเลย
• ส่งออก Excel ที่ /reports → ปุ่ม "ดาวน์โหลด Excel" (ไฟล์ .xlsx 4 ชีต สร้างเองโดยไม่พึ่ง dependency ภายนอก)
• ส่งออก PDF ใช้หน้า /reports/print แล้วสั่งพิมพ์/บันทึกเป็น PDF จากเบราว์เซอร์ (ภาษาไทยไม่เพี้ยน ไม่ต้องฝังฟอนต์ใน PDF library)
• ทั้งไฟล์แนบและการส่งออกถูกบันทึกลง audit log ทุกครั้ง

หมายเหตุสำหรับ dev server: ถ้ารัน npm run build ขณะ npm run dev ยังเปิดอยู่ ควร restart dev server ก่อนดูหน้าเว็บอีกครั้ง เพราะโฟลเดอร์ .next เป็น generated cache และอาจทำให้ CSS dev asset เช่น /_next/static/css/app/layout.css ตอบ 404 จนหน้าเว็บกลายเป็น HTML ดิบได้

ขอบเขตที่ตั้งใจไม่ทำใน MVP

• ไม่ดึงงานจาก LINE group อัตโนมัติ
• ไม่ทำ OCR หนังสือราชการ
• ไม่ทำ AI วิเคราะห์เอกสารหรือเสียงสัมภาษณ์ในระบบจริง
• ไม่ทำ native mobile app
• ไม่เปิดข้อมูลจอมอนิเตอร์เป็น public website
• ไม่ทำ permission ซับซ้อนเกินจำเป็นในรุ่นแรก

หมายเหตุจากการเก็บ requirement

เอกสารนี้อ้างอิงจากบทสัมภาษณ์และการคุยออกแบบระบบ ณ วันที่ 29 มิถุนายน 2569 โดยมีไฟล์สรุปต้นทางอยู่ที่ transcripts/interview_summary.md ควรตรวจทานชื่อบุคคลและคำเฉพาะจากเสียงจริงก่อนนำไปใช้เป็นเอกสารราชการ