Glosarium

Istilah domain yang sering muncul di codebase dan dokumentasi ini.

Entitas & aktor

Istilah	Penjelasan
Company (TransCompanies)	Pelanggan/tenant utama. Pusat dari hampir semua relasi: memiliki domain, kontak, langganan, invoice, relay account.
User (Users)	Akun pengguna individu. Terhubung ke company lewat TransCompanyContacts.
Contact (TransCompanyContacts)	Relasi user ↔ company dengan peran (primary, billing, technical, techbill).
Admin (Admins)	Pengguna back-office internal Aktiva. Punya role (superadmin, admin, accounting).
Relay account (TransCompanyAccountRelays)	Akun SMTP di Zimbra yang dipakai pelanggan untuk merelai email. Punya status active, closed, locked, suspended, dll.
Domain (TransCompanyDomains)	Domain pengirim milik company, dengan status verifikasi SPF/DKIM/DMARC.

Konsep billing & langganan

Istilah	Penjelasan
Package (TransServicePackages)	Paket layanan/katalog produk: harga, kuota email, jumlah domain, dll.
Add-on package (TransServiceAddOnPackage)	Paket tambahan opsional yang dilekatkan ke package.
Subscription (TransCompanySubscriptions)	Langganan aktif sebuah company terhadap sebuah package, dengan periode mulai/akhir.
Estimate / Proforma	Dokumen tagihan awal (sebelum dibayar) yang dibuat di Zoho Books. Setelah dibayar, dikonversi menjadi invoice (faktur).
Invoice (TransCompanyInvoices)	Faktur tagihan. Punya paidStatus: paid, unpaid, overdue, cancelled.
Tax Invoice (TransCompanyTaxInvoices)	Faktur pajak yang diterbitkan terpisah.
Payment (TransCompanyPayments)	Catatan pembayaran terhadap sebuah invoice.
Recurring	Pembayaran berulang otomatis via Xendit RecurringPayment (mis. bulanan/tahunan).

Konsep kuota

Istilah	Penjelasan
Sending quota	Jumlah email maksimum yang boleh dikirim dalam satu periode langganan.
Quota count (TransCompanyEmailQuotaCount)	Penghitung pemakaian kuota per langganan, termasuk flag ambang 80%/90%/100%.
Over-quota	Kondisi pemakaian melebihi kuota. Memicu tagihan tambahan (over-quota billing) dan/atau suspend relay.
Quota reset	Job harian yang mereset penghitung kuota di awal periode baru (cron:jobs:reset-sending-quota).

Pengiriman & logging

Istilah	Penjelasan
ZoneMTA (ZMTA)	Mail Transfer Agent yang melakukan pengiriman email aktual. Backend hanya mengelola token & domain di ZMTA.
Zimbra	Platform email; di sini dipakai sebagai sumber relay account (via SOAP Admin API).
API token (email-api-token)	Token yang dipakai aplikasi pelanggan untuk mengirim email lewat HTTP API ZoneMTA.
raw-log (dashboard-raw-log)	Index Elasticsearch berisi baris log mentah dari postfix/ZoneMTA.
clean-log (dashboard-clean-log)	Index Elasticsearch berisi 1 dokumen per penerima per pesan (sudah dinormalisasi). Dipakai untuk dashboard delivery log.
MapHost (MapHosts)	Pemetaan host pengirim untuk log email.
Suppression list	Daftar alamat email yang diblokir/di-suppress dari pengiriman.

Job & proses

Istilah	Penjelasan
Job (Jobs)	Baris antrian pekerjaan asinkron di database. Status: on-queue → processing → done/error.
JobDetail (JobDetails)	Tabel detail eksekusi job — tidak terpakai di codebase saat ini.
job-runner	job-runner.js, loader yang menjalankan skrip di cron/ sebagai proses terpisah.
Producer / Consumer	Producer (cron/HTTP) menulis baris Jobs; consumer (worker cron/job-*.js) memprosesnya.

Integrasi & pihak ketiga

Istilah	Penjelasan
Zoho Books	Sistem akuntansi/invoicing pihak ketiga (estimate, invoice, payment, bank).
Xendit	Payment gateway (invoice & recurring payment).
SparkPost	Penyedia email yang mengirim event delivery via webhook ke /callback/sparkpost.
MailWizz / AMC	Platform email marketing untuk registrasi kontak (list management).
Linode Object Storage	Penyimpanan objek S3-compatible (NPWP, logo, laporan CSV/PNG).

Singkatan

Singkatan	Kepanjangan
ATE	Aktiva Transaksional Email
ZMTA	ZoneMTA
SPF / DKIM / DMARC	Standar autentikasi email pengirim
NPWP	Nomor Pokok Wajib Pajak (dipakai untuk faktur pajak)
RBAC	Role-Based Access Control
AMC	(MailWizz) list/subscriber management