Aplikasi

Aplikasi mendefinisikan batas layanan dan namespace pengguna. Setiap pengguna, klien, dan merchant berada di dalam satu aplikasi. Akun berada di bawah aplikasi dan menjadi batas penagihan/tim.

Hierarki bergantian:

Application → Account → Application → Account

Artinya, setiap aplikasi adalah namespace pengguna tersendiri. Email yang sama dapat ada di beberapa aplikasi tanpa konflik.

Kenapa Penting

Pembuatan user terjadi di aplikasi induk dari akun target.
Access token membawa konteks aplikasi dan akun, bukan klaim namespace terpisah.
Isolasi ditegakkan oleh batas aplikasi dan membership akun.

Contoh Hierarki

app_platform
  └─ acc_alice
       └─ app_taskflow
            └─ acc_bob

app_platform memiliki Alice sebagai user.
app_taskflow memiliki Bob sebagai user.
acc_bob ditagih di bawah app_taskflow.

Operasi Aplikasi

Operasi	Endpoint	Deskripsi
Buat	`POST /api/accounts/:account_id/applications`	Membuat aplikasi di bawah akun
Daftar	`GET /api/accounts/:account_id/applications`	Daftar aplikasi di bawah akun
Ambil	`GET /api/applications/:application_id`	Detail aplikasi
Perbarui	`PATCH /api/applications/:application_id`	Ubah konfigurasi aplikasi
Hapus	`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

Akun - Batas penagihan dan tim
Pengguna - Siklus hidup pengguna
Keanggotaan - Tautan pengguna ke akun
Akun - Resource akun