# คู่มือหลังบ้าน NARANIN · Admin Control Room

## เปิดหน้าแอดมิน

1. Deploy Hosting แล้วเปิด `https://โดเมนของเว็บไซต์/admin.html` หรือกดลิงก์ **เข้าสู่หลังบ้าน · Admin** ที่ท้ายหน้าเว็บไซต์
2. เข้าสู่ระบบด้วยอีเมลและรหัสผ่าน Firebase Authentication ที่เจ้าของเว็บไซต์สร้างไว้
3. บัญชีต้องมี Firebase Custom Claim `admin: true` จึงจะเห็น Dashboard และจัดการข้อมูลได้

การซ่อนหรือเปิดลิงก์ไม่ใช่ระบบรักษาความปลอดภัย การเข้าถึงข้อมูลยังถูกตรวจด้วย Firebase Auth Custom Claim, Firestore Rules และ Storage Rules

## ตั้งสิทธิ์ Admin ครั้งแรก (ทำบนเครื่องเจ้าของโปรเจกต์เท่านั้น)

หากเข้าสู่ระบบแล้วแจ้งว่าไม่มีสิทธิ์ ให้ตั้ง Custom Claim ให้บัญชีผู้ดูแลที่มีอยู่แล้วตามขั้นตอนนี้ **อย่าส่ง Service Account JSON, private key หรือรหัสผ่านให้บุคคลอื่น และห้ามนำไฟล์เหล่านั้นขึ้น Hosting**

1. ติดตั้ง Google Cloud CLI และ Node.js 22 บนเครื่องเจ้าของโปรเจกต์
2. เปิด Terminal ในโฟลเดอร์ `NARANIN-Garden-Website/functions`
3. ติดตั้ง dependencies ด้วย `npm install`
4. ลงชื่อเข้าใช้ Application Default Credentials ด้วย `gcloud auth application-default login`
5. ให้บัญชี Google ที่ใช้มีสิทธิ์ Firebase Authentication Admin (หรือสิทธิ์ IAM ที่อนุญาตให้อัปเดต Firebase Authentication users) ในโปรเจกต์ `naranin-359f9`
6. รันคำสั่ง โดยแทนที่อีเมลด้วยบัญชีผู้ดูแลของคุณ:

```powershell
node .\scripts\set-admin-claim.cjs admin@example.com
```

7. ออกจากระบบเว็บไซต์ แล้วเข้าสู่ระบบใหม่ที่ `/admin.html`

สคริปต์จะเพิ่มเฉพาะ claim `admin: true` และคง custom claims อื่นของผู้ใช้นั้นไว้ ไม่สร้างบัญชีใหม่และไม่เปลี่ยนรหัสผ่าน

## จัดการนิยายและตอนนิยาย

หลังเข้าสู่ระบบ Dashboard จะมีแผง **เพิ่ม · แก้ไข · ซ่อน · ลบนิยายและตอนนิยาย** อยู่ด้านบน ก่อนส่วนแก้ไขข้อความเว็บไซต์

- เพิ่มนิยาย: กด `＋ เพิ่มนิยายเรื่องใหม่` หรือเลือกประเภท `นิยาย NARANIN` กรอกชื่อ ผู้เขียน คำโปรย แนวเรื่อง รูปแบบ สถานะ และภาพปก แล้วกดบันทึก
- แก้ไขนิยาย: เลือก `นิยาย NARANIN` แล้วกด `แก้ไข` ที่รายการ แก้ข้อมูลแล้วบันทึก
- เพิ่มตอน: กด `＋ เพิ่มตอนนิยาย` หรือเลือกประเภท `ตอนนิยาย` เลือกนิยายแม่ ใส่เลขตอน ชื่อตอน เนื้อหา และสิทธิ์อ่าน แล้วบันทึก
- แก้ไขตอน: เลือกประเภท `ตอนนิยาย` แล้วกด `แก้ไข` เนื้อหาตอนเดิมจะถูกโหลดกลับเข้าแบบฟอร์ม
- ซ่อน/เผยแพร่: ใช้ปุ่ม `ซ่อน` หรือ `เผยแพร่` เพื่อเอารายการออกจาก/แสดงบนหน้าเว็บโดยไม่ลบข้อมูล
- ลบถาวร: ใช้ `ลบถาวร` และยืนยันอีกครั้ง การลบนิยายจะลบนิยาย ตอนที่อยู่ใต้เรื่อง และเนื้อหาตอน รวมถึงรายการเรื่องโปรดที่เชื่อมกับนิยายนี้ การกระทำนี้ย้อนกลับไม่ได้
- ค้นหา: ใช้ช่องค้นหารายการตามชื่อเรื่อง ผู้เขียน หรือรหัสรายการ

**ข้อควรระวัง:** การลบนิยาย/ตอนจะไม่ลบประวัติการอ่านหรือรายการปลดล็อกเก่าที่อยู่ในบัญชีสมาชิก หากมีผู้ซื้อหรือปลดล็อกตอนแล้ว แนะนำให้ใช้ `ซ่อน` แทนการลบถาวร

## หมวดอื่นที่จัดการได้

- ข้อความ/ภาพทุกหน้าที่มีตัวแก้ไข: ประกาศ แบรนด์ เมนู Hero หน้าแรก หัวข้อหน้าหมวด Member Garden, Footer และเนื้อหา Privacy / Terms / Copyright
- เรื่องโปรด นิยายเพื่อน นิยายเว็บพันธมิตร E-book วิดีโอ และแพ็กเกจเหรียญ
- คำขอเติมเหรียญ กิจกรรมเช็คอิน และข้อมูลบัญชีรับโอน/QR
- รายชื่อสมาชิก คำขอช่วยเหลือ และการปรับยอดเหรียญ (ผ่าน Cloud Function ที่ตรวจสิทธิ์ฝั่งเซิร์ฟเวอร์และบันทึก Audit Log)

## Deploy หลังอัปเดตไฟล์

จากโฟลเดอร์ `NARANIN-Garden-Website`:

```bash
firebase deploy --only hosting
```

ถ้ามีการแก้ Firestore Rules หรือ Cloud Functions ในอนาคต ต้อง deploy service เหล่านั้นแยกตามไฟล์ที่แก้ รอบนี้การเพิ่ม/แก้ไข/ซ่อน/ลบเนื้อหาใช้ Firestore Rules เดิมที่ตรวจ `admin: true`
