Aplikasi

Aplikasi

Aplikasi menentukan batas layanan dan ruang nama pengguna. Setiap pengguna, klien, dan pedagang adalah milik suatu Aplikasi. Akun berada di bawah Aplikasi dan mewakili batasan penagihan/tim.

Hierarkinya bergantian:

Application → Account → Application → Account

Itu berarti setiap Aplikasi memiliki namespace penggunanya sendiri. Email yang sama bisa ada di beberapa Aplikasi tanpa konflik.

Mengapa Ini Penting

• Pembuatan pengguna terjadi di Aplikasi induk dari Akun target.
• Token akses membawa konteks Aplikasi dan Akun, bukan klaim namespace terpisah.
• Isolasi diberlakukan berdasarkan batasan Aplikasi dan keanggotaan akun.

Contoh Hirarki

app_platform
  └─ acc_alice
       └─ app_taskflow
            └─ acc_bob

• app_platform memiliki Alice sebagai pengguna.
• app_taskflow memiliki Bob sebagai pengguna.
• acc_bob ditagih berdasarkan app_taskflow.

Operasi Aplikasi

Endpoint	Keterangan
POST /api/accounts/:account_id/applications	Buat aplikasi di bawah akun
GET /api/accounts/:account_id/applications	Daftar aplikasi di bawah akun
GET /api/applications/:application_id	Ambil detail aplikasi
PATCH /api/applications/:application_id	Ubah pengaturan aplikasi
DELETE /api/applications/:application_id	Hapus aplikasi

Klaim Token

Token mencakup konteks aplikasi dan akun:

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

Terkait

• Accounts - Batasan penagihan dan tim
• Users - Siklus hidup pengguna dalam suatu aplikasi
• Membership - Tautan pengguna ke akun
• Account - Sumber daya akun