บอทกลาง THE Country TH

บทบาทของบอท

• ศูนย์กลาง บทบาท (Role Picker), อีเวนต์ (Event Hub), รายงานเหตุ (Report)
• เครื่องมือ Moderation/ความปลอดภัย และ สถิติการใช้งาน (Insights)
• จัดการการประกาศและการกระจายข่าวไปยังภาค/จังหวัด

ฟีเจอร์หลัก

1. Role Picker

• เลือกบทบาท ภาค/จังหวัด/ความสนใจ ผ่านปุ่ม/เมนูโต้ตอบ
• กำหนดสิทธิ์เข้าถึงหมวดห้องอัตโนมัติตามบทบาท

2. Event Hub

• สร้าง/แก้ไข/ลิสต์กิจกรรม พร้อม ปฏิทินรวม และแจ้งเตือนล่วงหน้า
• สรุปหลังจบงาน (ผู้เข้าร่วม/Feedback สั้น ๆ)

3. Report & Mod Tools

• คำสั่ง /report แนบหลักฐาน, เปิด Ticket อัตโนมัติ
• บันทึกลง #mod-log พร้อม Case ID
• เครื่องมือทีมงาน: ลบข้อความเร็ว, Timeout, Note คดี, ปิดคดี

4. Safety Filters

• กรองคำหยาบ, ลิงก์อันตราย/ฟิชชิ่ง/สแปม
• ล็อกเหตุและแจ้งเตือนทีมงานเมื่อทริกเกอร์

5. Announcements Router

• โพสต์ประกาศจาก Main Hub ไปหมวดภาค/จังหวัดที่เกี่ยวข้อง
• เทมเพลต Embed สำหรับข่าว/กิจกรรม

6. Insights / Analytics

• สถิติผู้ใช้งานรายภาค/จังหวัด, การกดบทบาท, การเข้าร่วมกิจกรรม
• แดชบอร์ดรวม (ข้อความ/วัน, ผู้ใช้งานใหม่, retention เบื้องต้น)

---

คำสั่งที่ใช้บ่อย (ตัวอย่าง)

ผู้ใช้ทั่วไป

• /role open เปิดเมนูเลือกบทบาท
• /event list ดูกิจกรรมที่กำลังจะมาถึง
• /report รายงานเหตุไม่เหมาะสม (แนบลิงก์/รูป/เหตุผล)

ทีมงาน (ต้องมีสิทธิ์)

• /event create สร้างกิจกรรม (ชื่อ/วันเวลา/ห้อง/บทบาทที่เกี่ยวข้อง)
• /event announce ส่งประกาศไปหมวดที่เลือก
• /mod note เพิ่มโน้ตใน Case ID
• /mod timeout @user 60m จำกัดสิทธิ์ชั่วคราว
• /mod close-case <id> ปิดคดีและสรุปผล

> โครงคำสั่งสามารถปรับชื่อ/พารามิเตอร์ให้สอดคล้องกับเวอร์ชันบอทจริง

---

สิทธิ์ (Permissions) ที่บอทต้องมี

• Manage Roles, Manage Channels, Manage Messages, Timeout Members
• Read/Send Messages, Embed Links, Attach Files, Add Reactions
• (ถ้ามีปุ่ม/เมนู) Use Application Commands

> ใช้หลัก Least Privilege: ให้เท่าที่จำเป็นกับหมวดที่ต้องจัดการ

---

นโยบายข้อมูล & ความเป็นส่วนตัว (เฉพาะบอท)

• เก็บเฉพาะข้อมูลที่จำเป็นต่อการทำงาน: บันทึกคดี, ล็อกเหตุ, สถิติกิจกรรม
• ไม่เก็บข้อมูลส่วนบุคคลที่ไม่จำเป็น และล้างข้อมูลตามอายุที่กำหนด (เช่น คดีเก่ากว่า X เดือน)
• เข้าถึงข้อมูลคดีเฉพาะทีมงานที่เกี่ยวข้อง
• เคารพการตั้งค่า DM ของผู้ใช้ (DM เฉพาะเมื่ออนุญาต)

---

แนวทางเทคนิค (ย่อ)

• สแตกแนะนำ: Discord.js (TypeScript) / Py-Cord, ฐานข้อมูล PostgreSQL/Prisma หรือ Firebase
• โฮสติ้ง: Vercel/Render/Fly.io + Healthcheck
• คิวงาน/กำหนดการ: Cron/Queue (แจ้งเตือนอีเวนต์, สรุปสัปดาห์)
• โมดูลหลัก: role, event, report, mod, announce, insights
• การสำรองข้อมูล: snapshot ตามรอบ + บันทึก schema migration

---

ความปลอดภัย

• จัดการโทเคนอย่างเข้มงวด (env secret, rotate เมื่อจำเป็น)
• แยกสิทธิ์บอทตามหมวด (ประเทศ/ภาค/จังหวัด)
• Rate-limit ในคำสั่งเสี่ยงสแปม + audit log ทุกเหตุการณ์สำคัญ

---

การมอนิเตอร์ & แจ้งเตือน

• ช่อง #bot-ops สำหรับสถานะบอท, error summary รายวัน
• Uptime monitor + error alert (webhook)
• รายงานสรุปสัปดาห์: สมาชิกใหม่, บทบาทที่กดมากสุด, อีเวนต์ยอดนิยม

---

Roadmap (ย่อ)

• v1: Role Picker, Report, Event basic, Announce, Safety filters
• v1.5: ปฏิทินรวม + แจ้งเตือนหลายโซนเวลา, Ticket flow สมบูรณ์
• v2: แดชบอร์ดสถิติ, เหรียญตรา/ภารกิจชุมชน, API ภายในเชื่อม partner

---