ออกแบบสิทธิ์ผู้ใช้และโปรเจกต์
ออกแบบภาพรวมสำหรับ Auralith แบบครบระบบ โดยยังไม่เชื่อม D1/AI ไม่ deploy และไม่แก้ Worker หรือฐานข้อมูลเดิม
1. หลักการที่ต้องยึด
- ตรวจ session ฝั่ง Server ทุก endpoint ที่มีข้อมูลส่วนตัว
- Project ID เป็นตัวระบุทรัพยากร ไม่ใช่หลักฐานสิทธิ์
- ตรวจสิทธิ์จากผู้ใช้ที่ยืนยันตัวตนแล้ว + ความสัมพันธ์กับโปรเจกต์
- ปฏิเสธโดยค่าเริ่มต้นเมื่อหาเจ้าของ/สมาชิก/สิทธิ์ไม่พบ
- ทุกคำสั่งอ่าน แก้ไข ลบ ส่งออก และสำรองข้อมูลต้องผ่าน authorization
- ไม่เปิดเผยว่ามีโปรเจกต์ของคนอื่นอยู่หรือไม่ผ่าน error ที่ละเอียดเกินไป
2. บทบาทภายในโปรเจกต์
Owner — จัดการโปรเจกต์ สมาชิก และข้อมูลทั้งหมด
Editor — สร้างและแก้ไขเนื้อหาตามขอบเขตที่กำหนด แต่จัดการเจ้าของ/สมาชิกไม่ได้
Viewer — อ่านอย่างเดียว หากเปิดใช้การแชร์ในอนาคต
Private (ค่าเริ่มต้น) — ไม่มีสมาชิกอื่นจนกว่าเจ้าของจะเชิญอย่างชัดเจน
สำหรับรุ่นแรกที่ใช้คนเดียว สามารถเริ่มด้วย Owner เท่านั้น แต่โครงสร้างต้องเผื่อ role แบบ least privilege ไว้โดยไม่เปิดแชร์ก่อนเวลา
3. ลำดับตรวจทุกคำขอ
- ตรวจ method, route, ขนาดและรูปแบบ input
- ยืนยัน session และอายุ session
- ตรวจว่าผู้ใช้มีสิทธิ์ต่อ Project ID ที่ร้องขอ
- ทำ query โดยผูก project_id และสิทธิ์ในเงื่อนไขเดียวกัน
- ตรวจขอบเขตการเปลี่ยนแปลงและ validate fields
- ส่งเฉพาะข้อมูลที่ endpoint อนุญาต พร้อม security headers
- บันทึก audit event ที่จำเป็น โดยไม่เก็บรหัสผ่าน token หรือเนื้อหาลับ
4. โครงสร้างความสัมพันธ์ที่เสนอ
users └── project_memberships (user_id, project_id, role) projects ├── characters / scenes / events ├── relationships / timeline ├── memories / story_bible └── prompts / settings / research_refs
เป็นแผนแนวคิดเท่านั้น ไม่ใช่คำสั่งสร้างตาราง และยังไม่ยืนยัน schema จริง ตารางที่มีอยู่ต้องตรวจสอบก่อนเปลี่ยนแปลง ห้าม drop/rename ตารางเดิมโดยไม่มีแผนย้ายข้อมูลและการอนุมัติ
5. ตารางสิทธิ์เบื้องต้น
| การกระทำ | Owner | Editor | Viewer |
|---|---|---|---|
| ดูเนื้อหา | ✓ | ✓ | ✓ |
| สร้าง/แก้ไขฉากและตัวละคร | ✓ | ✓ | — |
| ลบถาวร/จัดการสมาชิก | ตามนโยบาย | — | — |
| ส่งออกข้อมูล | ✓ | ตามการตั้งค่า | — |
| เปลี่ยนเจ้าของ | ขั้นตอนยืนยันพิเศษ | — | — |
ตารางนี้เป็นข้อเสนอเริ่มต้น ต้องตัดสินใจสิทธิ์สุดท้ายก่อน implementation
6. ชุดทดสอบที่ต้องมีเมื่อมี storage จริง
- ไม่ล็อกอิน → 401
- ล็อกอินแล้วแต่ไม่มีสิทธิ์ในโปรเจกต์ → ปฏิเสธโดยไม่คืนข้อมูล
- ผู้ใช้ A อ่าน/แก้ข้อมูลของโปรเจกต์ B → ปฏิเสธ
- เปลี่ยน Project ID ใน URL/body → ยังต้องตรวจสิทธิ์ใหม่
- ส่ง ID ซ้ำซ้อนหรือข้อมูลที่ไม่ตรงกัน → ปฏิเสธ
- ทดสอบ list, detail, create, update, delete, export และ restore
- ทดสอบ session หมดอายุ/ปลอมแปลง และ role ถูกลดสิทธิ์
- ตรวจว่า error/log ไม่มี secret หรือข้อมูลจากโปรเจกต์อื่น
7. สิ่งที่ยังไม่ทำใน v36
- ยังไม่สร้างตารางหรือแก้ D1
- ยังไม่เพิ่มระบบสมัครสมาชิกหรือหลายผู้ใช้จริง
- ยังไม่เชื่อม AI/OpenRouter
- ยังไม่ deploy Worker
- ยังไม่อ้างว่า Project isolation ทำงานจริง
8. ประตูอนุมัติก่อนพัฒนา
ก่อนเริ่มระบบจัดเก็บข้อมูลจริง ต้องตรวจ schema ปัจจุบันของฐานข้อมูลใหม่ที่ได้รับอนุญาต, ยืนยันรูปแบบบัญชีผู้ใช้, ยืนยันบทบาทเริ่มต้น และเพิ่ม integration tests สำหรับสิทธิ์จริง
แนวทางแนะนำ: เริ่ม private project + owner-only; ออกแบบ memberships ไว้สำหรับอนาคต แต่ยังไม่เปิดระบบเชิญ/แชร์จนกว่าจะผ่านการทดสอบ
กลับไป API Contractต่อไป: Database & API Design v37Auralith v36 · authorization architecture proposal · no deployment or database changes
Integration Readiness (v38)