# Product Requirements Document (PRD) ## Sistem Referal & Komunitas Engagement: **tiktok.autofollow.id** > **Versi Dokumen:** 1.1.0 (Approved & Finalized) > **Tanggal:** Juli 2026 > **Status:** Final / Siap Implementasi > **Target Pengguna:** Tim Pengembang (Frontend, Backend, DevOps), UI/UX Designer, dan Manajemen Project --- ## 1. Ringkasan Eksekutif (Executive Summary) **tiktok.autofollow.id** adalah sebuah platform berbasis web (Landing Page, User Panel, dan Admin Panel) yang dirancang untuk membangun komunitas pertumbuhan akun TikTok secara organik, aman, dan berjenjang. Platform ini menggunakan sistem **Referral Matrix 10 Generasi (Upline/Downline)** yang digabungkan dengan **2 Akun TikTok Admin** sebagai fondasi interaksi. Tujuan utama sistem ini adalah meningkatkan *followers*, *views*, *likes*, dan *comments* secara organik antar sesama anggota komunitas tanpa menggunakan *bot*, *scraping API ilegal*, atau otomatisasi skrip yang berisiko melanggar ketentuan platform TikTok. Untuk menjamin keamanan akun TikTok anggota, sistem menerapkan strategi **"Search & Follow"** (tanpa tautan langsung/URL click-through) serta **Algoritma Distribusi Tugas Mingguan** berbasis digit terakhir nomor handphone (HP) anggota agar interaksi merata di seluruh konten video/foto. Pengiriman email notifikasi dan blast didesain menggunakan **Gmail dengan Sistem Antrean Delay (Rate Limiting)** untuk menjaga reputasi pengirim dan menghindari masuk ke folder Spam. --- ## 2. Arsitektur & Komponen Utama Sistem Sistem **tiktok.autofollow.id** terbagi menjadi 4 komponen utama: ```mermaid graph TD A[Visitor / Calon Member] -->|Akses Link Referral| B(Landing Page) B -->|Submit Registrasi| C[Email Responder & Validation Engine] C -->|Verifikasi Email Awal / Anti-Spam| D[User Panel / Member Area] D -->|Upload 12 Bukti Follow| E[System Auto-Approval Engine] E -->|Status: ACTIVE MEMBER| F[Weekly Cron Job / Tugas Mingguan] G[Super Admin] -->|Kelola Konfigurasi, Users, Email Blast| H[Admin Panel] H -->|Monitoring & Override| D H -->|Setup 2 Akun Admin| E subgraph Email_Engine [Mesin Email Gmail & Throttling Queue] C -->|Queue & Delay| I[Gmail SMTP / OAuth2 Pool] F -->|Queue & Delay| I end ``` 1. **Landing Page & Public Website:** - Halaman promosi utama yang menjelaskan benefit komunitas. - **Wajib menggunakan URL Referral** untuk pendaftaran member baru (contoh: `https://tiktok.autofollow.id/ref/username_upline`). Jika pengunjung mengakses URL root tanpa referral, sistem akan meminta input *username sponsor/referral* atau menetapkan sponsor default (Admin) sesuai kebijakan aturan bisnis. 2. **User Panel (Member Area):** - Dashboard bagi Free Member dan Active Member. - Fitur utama: Status verifikasi, tugas upgrade (upload bukti follow dengan kebijakan *auto-purge 60 hari*), genealogi 10 generasi, generator link referral & banner, dan dasbor tugas mingguan. 3. **Admin Panel:** - Pusat kontrol sistem untuk mengelola pengguna, jaringan matriks 10 generasi, 2 akun TikTok admin tetap, konfigurasi email blast, monitoring tugas mingguan, dan analitik trafik. 4. **Responder & Email Automation Engine:** - Mesin pengirim email otomatis (Transactional & Broadcast/Blast) berbasis Gmail yang dilengkapi dengan **Throttled Queue System (BullMQ / Redis)** untuk mengatur jeda pengiriman (delay) dan pelacakan klik tautan (link tracking). --- ## 3. Spesifikasi Kebutuhan Fungsional (Functional Requirements) ### 3.1. Modul Registrasi & Sistem Referral Wajib - **FR-REG-01 (Mandatory Referral):** Sistem menolak pendaftaran baru jika tidak dilengkapi dengan kode/ID referral yang valid di dalam database. - **FR-REG-02 (Form Input):** Data registrasi wajib (mandatory) yang harus diisi oleh calon member: 1. **Nama Lengkap** (*Full Name*) 2. **Username** (*Unik, alfanumerik tanpa spasi, digunakan sebagai ID referral*) 3. **Email** (*Wajib valid dan unik, digunakan untuk aktivasi & blast*) 4. **Country / Negara** (*Dropdown list negara dengan autodeteksi kode telepon*) 5. **Nomor HP / WhatsApp** (*Wajib angka, unik, digunakan dalam algoritma tugas mingguan*) 6. **Alamat / Username TikTok** (*Format handle TikTok, contoh: `@username_tiktok`*) - **FR-REG-03 (Duplication Check):** Sistem melakukan validasi *real-time* untuk memastikan Username, Email, Nomor HP, dan Alamat TikTok belum pernah terdaftar sebelumnya. ### 3.2. Modul Responder & Email Automation System - **FR-RES-01 (On-Screen Notification):** Setelah submit form registrasi, layar browser langsung menampilkan *modal popup/alert screen* dengan pesan khusus: > *"Tinggal selangkah lagi! Kami telah mengirimkan link validasi ke email Anda. Silakan cek Inbox atau folder Spam/Junk untuk mengaktifkan akun Anda."* - **FR-RES-02 (Email Validation & Anti-Spam Handshake):** - Sistem mengirimkan email verifikasi awal menggunakan **Gmail** (via SMTP/OAuth2). - Subjek dan isi email awal dirancang dengan *copywriting* transaksional murni (tanpa kata-kata agresif marketing) untuk membangun reputasi pengirim (*domain/sender trust*) dan mencegah masuk ke folder Spam. - Tautan verifikasi memiliki masa berlaku 24 jam. - **FR-RES-03 (Dual Notification Trigger):** Pada detik ketika calon member mengklik link verifikasi dan akun berubah status menjadi *Verified Free Member*: - **Email ke New Member:** Mengucapkan selamat datang, detail login, dan instruksi untuk segera melakukan Upgrade ke status *Active Member*. - **Email ke Sponsor (Upline Langsung / Gen 1):** Memberi tahu bahwa downline baru dengan nama dan username tersebut telah berhasil bergabung di bawah jaringannya. - **FR-RES-04 (Sequential Email Blast & Queue Delay Throttling):** - > [!WARNING] > **Proteksi Limit Pengiriman Gmail:** Gmail memiliki batas pengiriman harian dan pemantauan lonjakan trafik. **DILARANG KERAS** mengirimkan email blast secara serentak/sekaligus dalam satu milidetik. - Sistem autoresponder (sequencing H+1, H+3, H+7, dst.) wajib diantrekan ke dalam *Background Job Queue* (contoh: BullMQ dengan Redis) dengan pengaturan **Delay / Throttling** (misal: jeda 15–30 detik antar pengiriman email, atau maksimal 50 email per jam per akun Gmail). - Setiap email dalam sequence **wajib memiliki tepat 3 tautan aksi (Action Links)**: 1. **Link NEXT:** Tautan konfirmasi minat untuk menerima urutan email blast materi/edukasi berikutnya dari sistem. 2. **Link UPGRADE:** Tautan langsung menuju halaman *Upgrade Member* di User Panel untuk menyelesaikan syarat follow 12 akun. 3. **Link UNSUBSCRIBE:** Tautan untuk berhenti berlangganan email marketing (tetap mempertahankan status akun di sistem database). ### 3.3. Modul Syarat Upgrade Member (Anti-Freeze & 12 Proofs) Untuk beralih status dari **Free Member** menjadi **Active Member**, pengguna wajib menyelesaikan tugas interaksi awal. - **FR-UPG-01 (12 Target Akun):** Sistem secara dinamis menghasilkan daftar 12 akun TikTok target yang terdiri dari: - **10 Akun TikTok Generasi Upline** (Ditarik secara urut dari Gen 1 / Sponsor hingga Gen 10 ke atas. Jika rantai upline kurang dari 10, posisi yang kosong akan diisi oleh akun TikTok cadangan dari Admin). - **2 Akun TikTok Admin** (Ditetapkan secara statis/dinamis dari pengaturan Admin Panel). - **FR-UPG-02 (Anti-Freeze Protection / No Direct Link):** - > [!IMPORTANT] > **Aturan Keamanan TikTok:** Sistem **DILARANG KERAS** menampilkan tautan lengkap (contoh: `https://tiktok.com/@username`) atau tombol *Click-to-Open App* yang mengarah langsung ke akun target. - Sistem hanya boleh menampilkan **Teks Username TikTok** (contoh: `@upline_gen1`) dilengkapi tombol *Copy to Clipboard* dan instruksi jelas: *"Silakan buka aplikasi TikTok Anda, lalu cari (search) username di bawah ini secara manual."* - *Alasan Teknis:* Klik massal dari satu domain web pembawa (*referring domain*) dalam durasi singkat dikategorikan oleh algoritma anti-bot TikTok sebagai *spam traffic*, yang dapat menyebabkan akun dikategorikan sebagai aktivitas tidak wajar. Pencarian manual (organic search) dicatat oleh TikTok sebagai trafik organik berkualitas tinggi. - **FR-UPG-03 (12 Upload Slots & 60-Day Auto-Purge):** - Di halaman Upgrade, disediakan 12 *dropzone/input file* terpisah untuk mengunggah 12 bukti *screenshot* (tangkapan layar) bahwa member telah menekan tombol "Follow" pada ke-12 akun tersebut. - Sesuai kebijakan efisiensi penyimpanan server, file gambar bukti yang diunggah akan **dihapus secara otomatis (*auto-purge*) setelah 60 hari** sejak tanggal pengunggahan melalui *background cleanup task* (Cron Job harian/mingguan). - **FR-UPG-04 (Automatic Approval Engine):** - > [!TIP] > **Zero-Friction Approval:** Untuk mencegah *bottleneck* antrean verifikasi admin dan mempercepat duplikasi jaringan, sistem menerapkan **Automatic Approval (Persetujuan Otomatis)**. - Begitu user selesai mengunggah file ke-12 (seluruh 12 slot terisi file gambar valid ekstensi `.jpg, .jpeg, .png, .webp`), sistem **langsung saat itu juga (instant)** mengubah status member dari `FREE` menjadi `ACTIVE MEMBER`. - Sistem tidak melakukan OCR atau verifikasi manual atas kebenaran gambar pada tahap ini. Kebenaran interaksi akan diverifikasi secara sosial dan alami melalui ekosistem **Tugas Mingguan**. ### 3.4. Modul Tugas Mingguan & Algoritma Distribusi Trafik Untuk menjaga *engagement* (views, likes, comments) akun seluruh member tetap aktif dan terus bertumbuh, sistem menjalankan siklus interaksi mingguan. ```mermaid flowchart TD A[Cron Job Mingguan: Senin 08:00 WIB] --> B[Ambil Daftar Active Member] B --> C[Untuk Setiap Member: Tarik 10 Upline + 2 Akun Admin] C --> D[Cek Digit Terakhir Nomor HP Member] D -->|Digit 1 atau 2| E[Tugas: Tonton, Like, Komen di Video ke-1 / Terakhir] D -->|Digit 3 atau 4| F[Tugas: Tonton, Like, Komen di Video ke-2 Terakhir] D -->|Digit 5 atau 6| G[Tugas: Tonton, Like, Komen di Video ke-3 Terakhir] D -->|Digit 7 atau 8| H[Tugas: Tonton, Like, Komen di Video ke-4 Terakhir] D -->|Digit 9 atau 0| I[Tugas: Tonton, Like, Komen di Video ke-5 Terakhir] E --> J[Antrekan Email ke BullMQ dengan Delay Throttling] F --> J G --> J H --> J I --> J J --> K[Perbarui Dasbor Tugas di User Panel] ``` - **FR-TSK-01 (Automated Weekly Dispatch):** Setiap hari **Senin pukul 08:00 WIB**, sistem *Cron Job* menghasilkan daftar tugas baru untuk seluruh Active Member. Email tugas diantrekan secara bertahap (staggered delay) ke sistem email Gmail, dan dasbor Tugas di User Panel diperbarui secara real-time. - **FR-TSK-02 (Target Akun Mingguan):** Setiap member hanya diberikan tugas berinteraksi dengan **12 Akun TikTok** (10 Upline di atasnya + 2 Akun Admin). - **FR-TSK-03 (HP Last-Digit Distribution Algorithm):** Untuk mencegah seluruh trafik berkumpul hanya di 1 video terbaru yang dapat terlihat tidak wajar, sistem menerapkan algoritma penentuan target video/foto berdasarkan **Angka Terakhir Nomor HP Member yang Mengerjakan Tugas**: | Angka Terakhir HP Member | Target Konten Akun Upline / Admin yang Wajib Diinteraksi | Tugas Interaksi Wajib | | :---: | :--- | :--- | | **1** dan **2** | Konten Video/Foto **Nomor 1 Terakhir** (Paling baru di-upload) | Tonton sampai habis, Like, Komen Relevan | | **3** dan **4** | Konten Video/Foto **Nomor 2 Terakhir** | Tonton sampai habis, Like, Komen Relevan | | **5** dan **6** | Konten Video/Foto **Nomor 3 Terakhir** | Tonton sampai habis, Like, Komen Relevan | | **7** dan **8** | Konten Video/Foto **Nomor 4 Terakhir** | Tonton sampai habis, Like, Komen Relevan | | **9** dan **0** | Konten Video/Foto **Nomor 5 Terakhir** | Tonton sampai habis, Like, Komen Relevan | - **FR-TSK-04 (Distribusi Trafik Alami):** Dengan algoritma modulo/pemetaan angka terakhir HP ini, populasi member yang besar akan secara otomatis dan merata mendistribusikan *views*, *retention*, *likes*, dan *comments* ke 5 konten terakhir dari setiap akun upline dan admin. - **FR-TSK-05 (Pelaporan & Sanksi Sosial):** Di User Panel, upline dapat melihat daftar downline yang dijadwalkan wajib berinteraksi dengan akunnya minggu tersebut. Jika upline mendapati downline tidak melakukan tugasnya (atau mengunggah bukti palsu saat upgrade), upline dapat menekan tombol *Report / Ingatkan* yang akan mengantrekan email peringatan otomatis kepada downline tersebut. --- ## 4. Spesifikasi Panel & Antarmuka Pengguna ### 4.1. Landing Page (Public) - Hero section dengan *headline* menarik terkait pertumbuhan organik TikTok tanpa iklan dan tanpa bot. - Kalkulator potensi pertumbuhan *followers* berdasarkan replikasi matriks 10 generasi (contoh: duplikasi 3 = $3^{10}$ potensi follower & interaksi). - Testimonial dan penjelasan cara kerja ("Search, Follow, Interact"). - Call-to-Action (CTA) Pendaftaran dengan menampilkan informasi sponsor pengajak: *"Anda diundang oleh: **[Nama Upline] ([@TiktokUpline])**"*. ### 4.2. User Panel (Member Area) - **Dashboard Overview:** Status Akun (Free / Active), Jumlah Downline (Gen 1 - Gen 10), Total Klik Link Referral. - **Menu Upgrade (Jika belum Active):** Menampilkan daftar 12 username (10 upline + 2 admin) disertai tombol copy, instruksi pencarian manual, dan 12 slot upload bukti *screenshot* (dengan keterangan otomatis dihapus sistem setelah 60 hari). - **Menu Tugas Mingguan:** Menampilkan tabel 12 akun yang harus diinteraksi minggu ini, lengkap dengan indikator instruksi target video (contoh: *"Karena nomor HP Anda berakhiran 6, tonton & komen pada video ke-3 terakhir dari akun-akun berikut..."*). - **Menu Genealogi / Jaringan:** Pohon jaringan (Tree View / Tabular View) 10 generasi ke bawah. - **Menu Marketing Tools:** Tautan referral unik (contoh: `https://tiktok.autofollow.id/ref/budi123`), tombol bagikan ke sosial media, dan unduh banner promosi. - **Menu Profil & Pengaturan:** Update data pribadi, ganti password, dan update alamat akun TikTok (dibatasi maksimal 1 kali perubahan per 30 hari untuk mencegah penyalahgunaan). ### 4.3. Admin Panel (Back Office) - **User Management:** Daftar seluruh member, filter status (Free/Active/Suspended), edit data member, reset password, dan fitur *Login as User* (impersonate untuk debugging). - **Genealogy & Matrix Explorer:** Melacak jalur upline/downline dari siapapun pengguna di dalam sistem. - **TikTok Admin Settings:** Pengaturan konfigurasi 2 Username TikTok Admin tetap, serta daftar akun TikTok cadangan (fallback) untuk mengisi slot upline yang belum mencapai 10 generasi. - **Email Campaign & Sequence Manager:** - Membuat dan mengedit *template* email untuk autoresponder. - Memonitor statistik pengiriman email (Sent, Delivered, Open Rate, Click Rate pada link NEXT, UPGRADE, UNSUBSCRIBE). - Broadcast email manual ke segmen tertentu dengan parameter kontrol delay antrean Gmail. - **Weekly Task Scheduler & Monitor:** Memonitor berjalannya *cron job* hari Senin pukul 08:00 WIB, melacak status antrean email di BullMQ, dan melihat tingkat kepatuhan interaksi member. - **System Settings:** Pengaturan umum, konfigurasi SMTP/OAuth2 Gmail (termasuk rotasi akun Gmail jika diperlukan), batas ukuran upload file, dan penjadwalan *auto-purge* file bukti follow 60 hari. --- ## 5. Skema Database & Model Data (ERD Conceptual) Berikut adalah rancangan tabel utama untuk mendukung logika matriks, tugas mingguan, dan antrean email: ### `users` | Kolom | Tipe Data | Keterangan | | :--- | :--- | :--- | | `id` | BIGINT (PK) | Primary Key | | `sponsor_id` | BIGINT (FK) | ID Upline langsung (Gen 1). NULL jika root | | `name` | VARCHAR(100) | Nama Lengkap | | `username` | VARCHAR(50) | Unik, untuk kode referral | | `email` | VARCHAR(150) | Unik, untuk autentikasi & blast | | `country` | VARCHAR(50) | Negara domisili | | `phone_number` | VARCHAR(30) | Unik, nomor HP / WA | | `phone_last_digit` | TINYINT | Digit terakhir HP (0-9), di-index untuk performa query tugas | | `tiktok_handle` | VARCHAR(100) | Username TikTok (Tanpa URL) | | `status` | ENUM | `PENDING_EMAIL`, `FREE_MEMBER`, `ACTIVE_MEMBER`, `SUSPENDED` | | `email_verified_at`| TIMESTAMP | Waktu klik link verifikasi | | `upgraded_at` | TIMESTAMP | Waktu otomatis approve (12 foto terupload) | | `created_at` | TIMESTAMP | Waktu registrasi | ### `upline_hierarchies` (Closure Table / Path Tracking untuk 10 Generasi) *Digunakan untuk optimasi query pembacaan 10 generasi upline tanpa query rekursif yang berat.* | Kolom | Tipe Data | Keterangan | | :--- | :--- | :--- | | `user_id` | BIGINT (FK) | ID Member | | `upline_id` | BIGINT (FK) | ID Upline di atasnya | | `generation_level`| TINYINT | Level generasi (1 sampai 10) | ### `upgrade_proofs` (Dengan Aturan Purge 60 Hari) | Kolom | Tipe Data | Keterangan | | :--- | :--- | :--- | | `id` | BIGINT (PK) | Primary Key | | `user_id` | BIGINT (FK) | Member yang melakukan upgrade | | `target_tiktok_handle` | VARCHAR(100)| Akun TikTok yang di-follow | | `target_type` | ENUM | `UPLINE_GEN`, `ADMIN_ACCOUNT` | | `generation_level`| TINYINT | 1-10 jika Upline, 0 jika Admin | | `screenshot_url` | VARCHAR(255)| URL storage file gambar | | `uploaded_at` | TIMESTAMP | Waktu upload | | `expires_at` | TIMESTAMP | Waktu kedaluwarsa (uploaded_at + 60 hari), di-index untuk cron purge | ### `email_queue_jobs` & `email_logs` *Mencatat antrean email Gmail (throttling status), urutan autoresponder, dan status klik pada 3 tombol wajib (NEXT, UPGRADE, UNSUBSCRIBE).* --- ## 6. Kebutuhan Non-Fungsional & Strategi Teknis ### 6.1. Keamanan & Storage Efficiency (Auto-Purge 60 Hari) - **Pencegahan Bot & Spam Registrasi:** Form registrasi dilengkapi dengan Cloudflare Turnstile atau Google reCAPTCHA v3 untuk mencegah pendaftaran akun fiktif massal. - **Optimasi Storage Bukti Follow:** Karena Automatic Approval langsung mengaktifkan member saat 12 file terunggah, sistem penyimpanan gambar (misal: Cloudflare R2, AWS S3, atau Local Storage) dikonfigurasi dengan *Background Cron Cleanup* berdasarkan kolom `expires_at` untuk **menghapus gambar secara otomatis tepat setelah 60 hari** guna menghemat biaya infrastruktur server. - **Keamanan Siber:** Proteksi standar terhadap SQL Injection, XSS, CSRF, dan Rate-Limiting pada endpoint pengiriman email dan login. ### 6.2. Email Deliverability (Infrastruktur Gmail & Throttling Queue) Sistem menggunakan **Gmail (SMTP / OAuth2 API)** sebagai engine pengirim pesan. Untuk mencegah pemblokiran dari Google dan menjaga performa inboxing: - **Rate Limiting & Queue Throttling:** Menggunakan **BullMQ (Redis-based job queue)**. Setiap pesan blast atau notifikasi massal akan diantrekan dan dikirim dengan jeda (delay) yang ditentukan (misal: 1 email per 15–30 detik). - **Sender Rotation (Opsi Skalabilitas):** Jika jumlah member melebihi limit harian Gmail (maksimal 500 email/hari untuk Gmail biasa, atau 2.000 email/hari untuk Google Workspace), Admin Panel mendukung pendaftaran *Multiple Gmail Accounts Pool* yang akan melakukan *round-robin rotation* saat mengantrekan email. - **Anti-Spam Validation Handshake:** Email pertama (verifikasi pendaftaran) menggunakan kalimat transaksional bersih yang mengarahkan user untuk membalas (reply) atau mengklik link agar algoritma Gmail memvalidasi reputasi positif antar-pengirim. - **Konfigurasi DNS Domain Pengirim:** Tetap diwajibkan menyetel **SPF, DKIM, dan DMARC** yang mengizinkan server Google (`_spf.google.com`) sebagai *authorized sender* domain `tiktok.autofollow.id`. --- ## 7. Rencana Tahapan Implementasi (Roadmap & Phasing) ### Phase 1: Foundation & Core Referral Engine (Minggu 1 - 3) - Setup arsitektur database, sistem autentikasi, dan skema *Closure Table* 10 generasi. - Pembangunan Landing Page dinamis dengan fitur deteksi URL referral. - Form Registrasi dan integrasi Gmail SMTP/OAuth2 dengan sistem BullMQ untuk email verifikasi. ### Phase 2: Upgrade Module & 60-Day Auto-Purge (Minggu 4 - 5) - Pengembangan dasbor Free Member dan modul Upgrade. - Pembangunan algoritma penarikan 10 Upline + 2 Admin dengan proteksi *No Direct Link* (Teks & Copy Clipboard saja). - Pembangunan fitur upload 12 slot gambar, mesin *Instant Auto-Approval*, dan script cron *auto-purge* 60 hari. ### Phase 3: Weekly Task Engine & Throttled Email Autoresponder (Minggu 6 - 7) - Pembangunan mesin *Cron Job* **Senin 08:00 WIB** untuk kalkulasi tugas mingguan dan algoritma distribusi digit terakhir HP (1-0 memetakan video 1-5). - Pembangunan dasbor Tugas Mingguan di User Panel. - Modul Autoresponder Email Blast (Gmail Throttling Queue) dengan kewajiban 3 tombol tautan (NEXT, UPGRADE, UNSUBSCRIBE). ### Phase 4: Admin Panel, Testing & Launching (Minggu 8 - 9) - Pembangunan Admin Panel lengkap (User manajemen, genealogy viewer, pengaturan akun admin, monitoring queue BullMQ & rotasi Gmail). - *End-to-End Load Testing* (mensimulasikan pendaftaran 10.000 member berjenjang, performa penarikan pohon matriks, dan stabilitas antrean delay email). - Security audit dan persiapan peluncuran produksi (Production Launch).