‹
🐈 AURALITH · ARCHITECTURE
Project Authorization Design
⌂
🔐
SYSTEM DESIGN · V36

ออกแบบสิทธิ์ผู้ใช้และโปรเจกต์

ออกแบบภาพรวมสำหรับ Auralith แบบครบระบบ โดยยังไม่เชื่อม D1/AI ไม่ deploy และไม่แก้ Worker หรือฐานข้อมูลเดิม

AUTHORIZATION PLAN·DESIGN ONLY

1. หลักการที่ต้องยึด

  • ตรวจ session ฝั่ง Server ทุก endpoint ที่มีข้อมูลส่วนตัว
  • Project ID เป็นตัวระบุทรัพยากร ไม่ใช่หลักฐานสิทธิ์
  • ตรวจสิทธิ์จากผู้ใช้ที่ยืนยันตัวตนแล้ว + ความสัมพันธ์กับโปรเจกต์
  • ปฏิเสธโดยค่าเริ่มต้นเมื่อหาเจ้าของ/สมาชิก/สิทธิ์ไม่พบ
  • ทุกคำสั่งอ่าน แก้ไข ลบ ส่งออก และสำรองข้อมูลต้องผ่าน authorization
  • ไม่เปิดเผยว่ามีโปรเจกต์ของคนอื่นอยู่หรือไม่ผ่าน error ที่ละเอียดเกินไป

2. บทบาทภายในโปรเจกต์

Owner — จัดการโปรเจกต์ สมาชิก และข้อมูลทั้งหมด

Editor — สร้างและแก้ไขเนื้อหาตามขอบเขตที่กำหนด แต่จัดการเจ้าของ/สมาชิกไม่ได้

Viewer — อ่านอย่างเดียว หากเปิดใช้การแชร์ในอนาคต

Private (ค่าเริ่มต้น) — ไม่มีสมาชิกอื่นจนกว่าเจ้าของจะเชิญอย่างชัดเจน

สำหรับรุ่นแรกที่ใช้คนเดียว สามารถเริ่มด้วย Owner เท่านั้น แต่โครงสร้างต้องเผื่อ role แบบ least privilege ไว้โดยไม่เปิดแชร์ก่อนเวลา

3. ลำดับตรวจทุกคำขอ

  1. ตรวจ method, route, ขนาดและรูปแบบ input
  2. ยืนยัน session และอายุ session
  3. ตรวจว่าผู้ใช้มีสิทธิ์ต่อ Project ID ที่ร้องขอ
  4. ทำ query โดยผูก project_id และสิทธิ์ในเงื่อนไขเดียวกัน
  5. ตรวจขอบเขตการเปลี่ยนแปลงและ validate fields
  6. ส่งเฉพาะข้อมูลที่ endpoint อนุญาต พร้อม security headers
  7. บันทึก 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. ตารางสิทธิ์เบื้องต้น

การกระทำOwnerEditorViewer
ดูเนื้อหา✓✓✓
สร้าง/แก้ไขฉากและตัวละคร✓✓—
ลบถาวร/จัดการสมาชิกตามนโยบาย——
ส่งออกข้อมูล✓ตามการตั้งค่า—
เปลี่ยนเจ้าของขั้นตอนยืนยันพิเศษ——

ตารางนี้เป็นข้อเสนอเริ่มต้น ต้องตัดสินใจสิทธิ์สุดท้ายก่อน 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 ทำงานจริง
SAFE DESIGN PHASE

8. ประตูอนุมัติก่อนพัฒนา

ก่อนเริ่มระบบจัดเก็บข้อมูลจริง ต้องตรวจ schema ปัจจุบันของฐานข้อมูลใหม่ที่ได้รับอนุญาต, ยืนยันรูปแบบบัญชีผู้ใช้, ยืนยันบทบาทเริ่มต้น และเพิ่ม integration tests สำหรับสิทธิ์จริง

แนวทางแนะนำ: เริ่ม private project + owner-only; ออกแบบ memberships ไว้สำหรับอนาคต แต่ยังไม่เปิดระบบเชิญ/แชร์จนกว่าจะผ่านการทดสอบ

กลับไป API Contractต่อไป: Database & API Design v37

Auralith v36 · authorization architecture proposal · no deployment or database changes

Integration Readiness (v38)