Pemetaan tahap → event → sinyal ke platform iklan

Alasan strategi: siklus closing 2–8 minggu melampaui jendela atribusi platform — maka sinyal awal (Lead) ditembakkan cepat agar algoritma tetap belajar, dan Closing menyusul sebagai konversi bernilai.

Ketentuan teknis atribusi

• Dedup deterministik: event_id = almira_{entitas}_{id}_{event}_{timestamp} — retry aman, tidak dobel hitung di Meta/Google.
• First-touch permanen: source/campaign/kode referral pertama tidak dapat ditimpa. Sentuhan berikutnya (broadcast, kunjungan ulang LP) dicatat sebagai jurnal multi-sentuh.
• Balasan broadcast TIDAK dikirim ke Meta/Google — menjaga kebersihan sinyal belajar platform.
• Agregasi wajib: biaya/Closing per iklan → per nomor → per sales → per unit → per liga → per area → total.
• Rekonsiliasi: spend ↔ lead ↔ DP ↔ Closing dicek mingguan oleh Finance (proses manusia, di luar aplikasi).

Aturan routing (server-side, ditegakkan sistem)

route(lead):
  if lead.referrer_id        → unit = referrer.unit
  elif reach == "nasional"   → unit = POOL_PUSAT
  elif reach == "daerah"     → unit = CABANG[lead.area]

  kandidat = sales aktif di unit, overpromise_flag == false
  pilih    : max(skor efektivitas), lalu min(beban aktif)
  tujuan   = nomor WA milik sales terpilih

PENTING — definisi "overflow" v3:
  overflow ≠ memindahkan chat antar nomor (dilarang; melanggar no-handoff)
  overflow  = router BERHENTI mengarahkan traffic BARU
              ke nomor yang lambat/offline, SEBELUM chat terjadi:
              · LP: tombol WA memilih nomor lain
              · CTWA: ad set nomor tsb direkomendasikan pause (eksekusi Dhery)
  kredit CAC area tetap melekat ke area — tidak berpindah

• SLA hot lead ≤ 5 menit — SLA clock per lead, alarm ke koordinator saat lewat (sla.breached).
• Next-action 100% dan reason-for-NO 100% — lead tidak bisa ditutup tanpa alasan terstruktur.
• Fatal overpromise = 0 — pelanggaran ⇒ overpromise_flag ⇒ prioritas alokasi 0 sampai dicabut koordinator.

Skor Efektivitas (usulan — ratifikasi internal, formula harus configurable)

Grade A ≥ 85 · B 70–84 · C < 70. Dihitung mingguan, otomatis dari event. Perbandingan hanya intra-liga — UI dilarang menyandingkan skor lintas liga (campaign mix beda = salah ukur). Skor menentukan: (1) alokasi lead LP/referral, (2) usulan alokasi ad set CTWA, (3) budget merit bulanan.

Registry Nomor — jantung penyesuaian

Konsekuensi arsitektur yang kami minta: satu endpoint webhook melayani semua channel; satu suppression list & frequency cap terpusat lintas semua nomor; onboarding/offboarding nomor tanpa deploy ulang (cukup ubah registry).

Prinsip: routing di hulu, bukan oper di hilir

• Iklan CTWA: penentuan "lead jatuh ke siapa" terjadi saat Dhery mengarahkan ad set ke nomor sales (alokasi merit — formalisasi Mapping bulanan yang sudah berjalan). Sistem menyediakan datanya: biaya/Closing per nomor.
• Landing Page: tombol WA = router hidup — memilih nomor sales terbaik (skor tertinggi + beban terendah + status aktif) saat itu juga.
• Referral: diarahkan ke nomor sales skor tertinggi di unit referrer.
• Broadcast: pengirim = nomor sales pemilik lead (lihat kanan).
• Tidak ada fitur transfer chat/lead antar nomor pasca kontak pertama — by design.

M4 · Website — dua wajah, satu tracking

M5 · Aplikasi Member — PWA (tanpa App Store)

Teknis: installable (manifest + service worker), push notification, offline dasar (cache beranda/acara/dokumen), performa baik di Android kelas menengah.

Loyalty — sumber poin (semua dari event, anti-manipulasi)

Tier usulan: Sahabat (semua member) → Duta (aktif + ≥1 referral tervalidasi) → Kiswah (≥1 referral Closing). Nilai poin per aksi dan benefit per tier = configurable oleh admin, karena kebijakan Owner bisa berubah tanpa perlu deploy.

Guardrail referral — tidak bisa ditawar

• Consent & anti-spam: opt-in tertulis; maks 20 undangan/bulan per referrer; penerima maks 1× kontak tanpa respons; opt-out satu klik.
• Anti-overpromise: template WA terkunci — tanpa harga/jadwal/janji porsi; pelanggaran ⇒ kode dibekukan otomatis + audit.
• Atribusi jujur: kode referral first-touch permanen; sengketa antar-sales diputus timestamp; lead referral dirouting ke unit referrer, sales skor tertinggi; kredit tidak berpindah.
• Privasi: referrer hanya melihat status ringkas; identitas jamaah = akun → prasyarat legal: DPA + audit rights + exit/portabilitas data (review Gusfia) sebelum data jamaah dipakai.

Entitas inti (skema data minimum)

RBAC — siapa melihat apa

• Semua aksi tulis ber-audit-trail (siapa, kapan, apa).
• Token/API key terenkripsi at-rest; kredensial Qontak/Meta/Google tidak pernah tampil di UI.

Ketentuan komersial yang kami usulkan

• Pembayaran per gate — termin cair saat gate lolos di data produksi (bukan demo).
• Retensi 20% ditahan sampai Definition-of-Done lengkap (dokumentasi, handover, pelatihan admin).
• Kill criteria: dua gate berturut gagal karena vendor · tracking < 90% di akhir Sprint B · DoD tidak lengkap ⇒ termin berhenti, retensi ditahan, exit + portabilitas data dieksekusi.
• Cap eksposur nilai kontrak Tahap 1 + skema milestone: final bersama Finance (Tika).

Yang kami sediakan dari sisi Almira

• Akses Qontak (admin), Meta Business Manager, Google Ads (level sesuai kebutuhan, ber-NDA).
• PIC harian: Dhery (atribusi/iklan), koordinator CS (ops), Dodik (produk/konten), Tika (validasi angka), Gusfia (legal).
• VPS + CloudPanel existing (boleh diusulkan alternatif — lihat Spesifikasi Build).
• Tracking sheet berjalan (kategori Spam/Silent/Warm/Hot per CS per hari) sebagai data historis untuk migrasi.
• Keputusan cepat: scale/kill dalam threshold = Dhery (Jalur 1); di luar threshold = Owner (Jalur 3), audit trail Basecamp.

1 · Integrasi eksternal

2 · Non-fungsional

• Keandalan webhook: antrian + retry (chat tidak boleh hilang saat spike, mis. hari pameran); idempoten via event_id.
• Keamanan: RBAC (lihat Peta Event), enkripsi token at-rest, audit trail semua aksi tulis, backup harian, log terstruktur.
• Kinerja: LP < 3 dtk di mobile menengah; dashboard < 5 dtk; PWA offline dasar.
• Konfigurable tanpa deploy: bobot skor, poin/tier, frequency cap, threshold scale/kill, template.
• Kepemilikan: kode + data milik PT Almira Berkah Abadi; ekspor penuh (SQL dump + dokumentasi skema) kapan pun; tidak ada vendor lock-in pada layanan yang tidak bisa dipindahkan.
• Stack: kami terbuka pada usulan; existing kami: VPS CloudPanel/Nginx, PostgreSQL, Redis, Node/Next.js — kompatibilitas bernilai plus, bukan keharusan.