Aktiva ATE — Handover Docs

Tampilan

Aktiva Transaksional EmailDokumentasi Handover & Workflow Backend

Panduan lengkap untuk onboarding engineer baru, sekaligus acuan untuk improvement & migrasi stack ke versi terbaru.

Mulai dari Overview
Arsitektur Sistem
Rekomendasi Migrasi

Pengantar & Arsitektur

Memahami produk, peran sistem dalam bisnis, dan arsitektur layered (routes → controllers → repositories → models).

Skema Basis Data

ERD lengkap dan tabel skema untuk ~29 model Sequelize beserta relasi dan catatan quirks.

Alur Bisnis Inti

Pengiriman email (Zimbra + ZoneMTA), logging delivery (Elasticsearch), billing (Zoho + Xendit), dan background jobs.

Referensi API

Inventarisasi seluruh endpoint per router, model autentikasi JWT, dan RBAC admin.

Integrasi Eksternal

Zimbra, ZoneMTA, Xendit, Zoho Books, Elasticsearch, Linode S3, SparkPost, dan MailWizz.

Migrasi & Improvement

Rekomendasi lanjut repo (incremental / strangler-fig) vs rewrite from scratch, plus roadmap bertahap.

Tentang Dokumentasi Ini ​

Dokumentasi ini adalah acuan handover untuk repository backend Aktiva Transaksional Email (ATE) — sebuah layanan SaaS transactional email yang sudah berjalan di production dan melayani banyak paid customer.

Tujuannya ada dua:

  1. Onboarding — membantu engineer baru memahami codebase ini dengan cepat dan aman.
  2. Acuan migrasi — menjadi dasar pengambilan keputusan untuk improvement dan migrasi stack ke versi terbaru.

Cara membaca

Jika Anda baru pertama kali, baca berurutan: Pengantar → Setup → Basis Data → Alur Bisnis → API. Jika Anda fokus pada perencanaan migrasi, langsung ke bagian Migrasi & Improvement.

Catatan penting

Repository ini melayani sistem production yang menangani pembayaran dan pengiriman email pelanggan berbayar. Setiap perubahan harus melalui review dan diuji di environment non-production terlebih dahulu.