แอปพลิเคชัน

แอปพลิเคชันกำหนด ขอบเขตบริการ และ namespace ของผู้ใช้ ผู้ใช้ client และ merchant ทุกตัวอยู่ภายใต้แอปพลิเคชัน บัญชีจะอยู่ภายใต้แอปพลิเคชันและเป็นขอบเขตของการชำระเงิน/ทีมงาน

ลำดับชั้นเป็นแบบสลับ:

Application → Account → Application → Account

แต่ละแอปพลิเคชันเป็น namespace ผู้ใช้ของตัวเอง อีเมลเดียวกันสามารถอยู่ได้หลายแอปโดยไม่ชนกัน

ทำไมถึงสำคัญ

การสร้างผู้ใช้เกิดที่แอปพลิเคชันแม่ของบัญชีเป้าหมาย
Access token มีบริบทของแอปและบัญชี ไม่ได้มี namespace claim แยกต่างหาก
การแยกข้อมูลถูกบังคับโดยขอบเขตของแอป และ membership ของบัญชี

ตัวอย่างลำดับชั้น

app_platform
  └─ acc_alice
       └─ app_taskflow
            └─ acc_bob

app_platform เป็นเจ้าของ Alice
app_taskflow เป็นเจ้าของ Bob
acc_bob ถูกเรียกเก็บเงินภายใต้ app_taskflow

การทำงานของแอปพลิเคชัน

การทำงาน	Endpoint	คำอธิบาย
สร้าง	`POST /api/accounts/:account_id/applications`	สร้างแอปพลิเคชันใต้บัญชี
รายการ	`GET /api/accounts/:account_id/applications`	แสดงแอปพลิเคชันใต้บัญชี
ดูรายละเอียด	`GET /api/applications/:application_id`	ดูรายละเอียดแอปพลิเคชัน
แก้ไข	`PATCH /api/applications/:application_id`	แก้ไขการตั้งค่าแอปพลิเคชัน
ลบ	`DELETE /api/applications/:application_id`	ลบแอปพลิเคชัน

Token Claims

โทเคนมีบริบทของแอปและบัญชี:

{
  "app": "app_root",
  "acc": "acc_child456",
  "uid": "uid_789",
  "role": "member"
}

ที่เกี่ยวข้อง

บัญชี - ขอบเขตการชำระเงินและทีม
ผู้ใช้ - วงจรชีวิตผู้ใช้
สมาชิกภาพ - ความสัมพันธ์ผู้ใช้กับบัญชี
บัญชี - ทรัพยากรบัญชี