A / CycleJournal CycleJournal Dokumentasi v1.1.2
Metodologi Siklus (FIGO & ACOG) • Offline-First & Zero-Knowledge

Spesifikasi Sistem & Panduan Fitur Resmi

Panduan mendalam mengenai algoritma perhitungan prediksi siklus, konfirmasi ovulasi sintotermal, pemantauan variasi keteraturan siklus, arsitektur enkripsi, dan prosedur operasional CycleJournal.

Versi Rilis: v1.1.2 VersionCode: 4 Database: SQLCipher AES-256
Bagian 1

Filosofi Sistem & Kedaulatan Data

CycleJournal dibangun di atas fondasi offline-first dan kedaulatan data mutlak. Kami percaya bahwa data kesehatan reproduksi wanita adalah data medis paling sensitif yang tidak boleh dijual, diprofilkan untuk target iklan, atau disimpan dalam bentuk teks biasa di peladen pihak ketiga.

🔒

Enkripsi Hardware-Backed

Seluruh tabel Room database dienkripsi lokal dengan SQLCipher AES-256. Kunci enkripsi diamankan di hardware Android KeyStore (TEE / StrongBox).

☁️

Zero-Knowledge Cloud Vault

Cadangan awan ke Cloudflare D1 dienkripsi di sisi perangkat menggunakan AES-256-GCM + PBKDF2 100.000 iterasi. Server hanya menyimpan ciphertext.

Bagian 2

Mekanisme Prediksi: Adaptif & Dinamis (Bukan Angka Saklek)

Banyak pengguna bertanya: "Apakah prediksi aplikasi ini kaku pada angka 28 hari dari standar FIGO?" Jawabannya: Sama sekali tidak.

Angka 28 hari dari standar FIGO hanyalah titik awal (baseline fallback) saat aplikasi baru diinstal dan baru memiliki 1 siklus berjalan (karena secara statistik belum ada siklus selesai untuk menghitung rata-rata riil tubuh Anda).

// ALUR REKONSILIASI PERHITUNGAN PREDIKSI

1. Input Haid Pertama (Siklus 1):

└── Gunakan Baseline FIGO 28 Hari (Estimasi Awal yang Aman)

2. Input Haid Siklus Berikutnya (Siklus 2 ke atas):

├── Tutup Siklus Sebelumnya & Hitung Panjang Riil Hari

├── Hitung Mean Riil: x̄ = (Panjang_1 + Panjang_2 + ... + Panjang_N) / N

├── Hitung Sample StdDev (σ): Rumus Koreksi Bessel (N - 1)

└── Prediksi Otomatis Berganti Menjadi +x̄ Hari (Mengikuti Pola Tubuh Anda!)

Contoh Nyata Personalisasi: Jika seorang pengguna memiliki siklus alami 32 hari: begitu siklus selesai tercatat, maka proyeksi haid berikutnya otomatis berjarak +32 hari ke depan, dan puncak ovulasi diperkirakan pada hari ke-18 (32 - 14 hari fase luteal). Aplikasi tidak pernah memaksakan siklus Anda menjadi 28 hari.
Bagian 3

Dua Tingkatan Kalkulasi (Tier 1 & Tier 2)

1 Tier 1: Metode Kalender Klinis (FIGO / ACOG Standard)

Berdasarkan konsensus medis obstetri ginekologi, durasi fase luteal (antara ovulasi hingga hari pertama haid berikutnya) relatif konstan pada wanita sehat, yaitu 14 hari. Variasi siklus umumnya terjadi pada fase folikuler.

  • • Estimasi Haid: Hari Pertama Haid Terakhir + Panjang Siklus Rata-rata Pribadi
  • • Puncak Ovulasi: Estimasi Tanggal Haid Berikutnya - 14 Hari
  • • Jendela Subur (Fertile Window): [Puncak Ovulasi - 5 Hari] s/d [Puncak Ovulasi + 1 Hari] (Total 6 Hari Subur)

2 Tier 2: Konfirmasi Ovulasi Biologis Sintotermal (3-over-6 BBT Shift)

Jika pengguna mencatat Suhu Basal Tubuh (BBT) setiap pagi, sistem menjalankan algoritma verifikasi biologis BbtEngine.kt:

Sistem menelusuri 6 hari baseline suhu rendah dan menarik garis ambang coverline. Apabila suhu tubuh melonjak minimal ≥ +0.20°C selama 3 hari berturut-turut di atas coverline, ovulasi dinyatakan terkonfirmasi secara biologis dan terkunci pada hari ke-6 lonjakan.

Bagian 4

Referensi FIGO: Sistem Pemantauan Variasi Siklus (Pola Keteraturan)

Panduan FIGO dalam CycleJournal digunakan sebagai referensi pola keteraturan siklus yang dirangkum pada tab Ringkasan Siklus:

Parameter Klinis Rentang Normal Sehat Kondisi Anomali Diagnosis Indikasi Medis
Panjang Siklus (Cycle Length) 24 – 38 Hari < 24 Hari Polimenorea (Siklus terlalu pendek / sering)
Panjang Siklus (Cycle Length) 24 – 38 Hari > 38 Hari Oligomenorea (Haid jarang / terlambat jauh)
Variasi Antar-Siklus Selisih < 8 Hari Selisih ≥ 8 Hari Siklus Tidak Teratur (Cycle Irregularity)
Lama Pendarahan 3 – 8 Hari > 8 Hari Pendarahan Berkepanjangan (Prolonged Bleeding / AUB)
Lama Pendarahan 3 – 8 Hari < 3 Hari Hipomenorea (Pendarahan sangat singkat)
Fase Luteal ≥ 10 Hari < 10 Hari Fase Luteal Pendek (Defek fase pasca-ovulasi)
Bagian 5

Logika State Machine & Rekonsiliasi Otomatis

Di balik antarmuka, engine CycleAggregator.kt menjalankan state machine deterministik untuk memastikan integritas catatan siklus:

1. Definisi Pendarahan Sejati (True Bleeding):

Hanya pendarahan dengan intensitas Ringan, Sedang, atau Deras yang diklasifikasikan sebagai menstruasi aktif. Opsi Tidak dicatat sebagai gejala non-haid, dan Bercak dicatat sebagai spotting tanpa memecah siklus.

2. Ambang Batas 20 Hari (Separation Threshold):

Pendarahan yang terjadi sebelum hari ke-20 siklus diperlakukan sebagai pendarahan intermenstruasi (AUB-IMB) dan tidak memicu pembuatan siklus baru secara prematur.

3. Rekonsiliasi Deterministik (reconcileAllHistory):

Setiap kali pengguna menyimpan, mengubah, atau menghapus catatan (baik tanggal lampau, acak, maupun sekarang), seluruh riwayat harian diurutkan dan direkonsiliasi ulang dari awal sehingga data siklus selalu 100% konsisten dan bebas anomali input.

Bagian 6

Panduan Layar & Fitur Aplikasi

A. Tab Beranda (Dashboard)

Memuat Hero Card dinamis dengan nama fase aktif, hitung mundur ovulasi, circular progress ring yang menunjukkan hari siklus riil (misal Hari 3 dari 28), strip kalender 7 hari, dan grafik kurva BBT.

B. Tab Kalender (Peta Siklus 6 Bulan)

Header kalender menampilkan ringkasan langsung (misal: Haid: 7 Okt • Ovulasi: 23 Sep). Navigasi bulan menggunakan tombol < dan >.

Merah Muda: Haid Aktif Dot Pink: Prediksi Haid Biru Muda: Jendela Subur Toska Tua: Puncak Ovulasi

C. Tab Ringkasan Siklus

Memuat kotak parameter siklus (Rata-rata, Variasi, Lama Haid), pola temperatur BBT, kotak status keteraturan siklus, tabel riwayat siklus (menampilkan siklus aktif berjalan dan siklus lampau), serta tabel 5 log harian terakhir lengkap dengan flow, suhu, dan catatan rasa nyaman.

Dilengkapi tombol Unduh PDF Ringkasan (lembar ringkasan A4 siap cetak) dan Ekspor CSV Mentah (spreadsheet Excel/Sheets).

D. Tab Pengaturan

Konfigurasi PIN 4-digit, autentikasi biometrik, Mode Samaran (*Discreet Mode*), Mode Gelap, kartu panduan singkat & FAQ terpadu, cadangan cloud terenkripsi, serta tombol Hapus Data Permanen (*Nuke Data*).

Bagian 7

Tanya Jawab Teknis & Klinis (FAQ)

Apakah aplikasi butuh di-refresh manual untuk memunculkan perhitungannya?

Tidak sama sekali. Aplikasi menggunakan arsitektur reaktif penuh (Room Flow + Kotlin StateFlow + Jetpack Compose). Begitu catatan disimpan, seluruh perhitungan dan kalender otomatis ter-update seketika dalam hitungan milidetik.

Kenapa setelah mencatat haid tanggal 9, kalender bulan ini tidak ada kotak prediksi haid?

Karena estimasi haid berikutnya jatuh pada 7 Oktober (bulan depan). Pada grid kalender bulan September, yang muncul adalah puncak ovulasi (23 September) dan masa subur (18–24 September). Untuk melihat kotak prediksi haid, cukup klik tombol panah > untuk membuka bulan Oktober.

Mengapa memilih opsi "Tidak" pada pendarahan tidak memicu siklus?

Opsi Tidak menandakan hari tersebut bebas pendarahan (bukan haid). Hari pertama siklus menstruasi secara medis hanya dimulai saat darah haid keluar. Pastikan memilih Ringan, Sedang, atau Deras untuk mencatat hari pertama haid.

Apakah data saya bisa dibaca oleh pihak Asri Digital atau pihak ketiga?

Tidak bisa sama sekali. Database lokal dienkripsi penuh di ponsel Anda, dan jika Anda mencadangkan ke cloud, seluruh berkas dienkripsi dengan kata sandi Anda sendiri sebelum dikirim (*zero-knowledge*). Kami tidak pernah menyimpan atau mengetahui kata sandi Anda.

Bagian 8

Berkas Rilis Resmi

Berkas aplikasi Android siap pasang dan siap publikasi Play Store:

CycleJournal_v1.1.2.apk

Ukuran: ~26 MB

Format: Android APK Standalone

✓ Siap Pasang di HP / Emulator

CycleJournal_v1.1.2.aab

Ukuran: ~18 MB

Format: Android App Bundle (Signed)

✓ Siap Unggah Play Console

Repositori Resmi: github.com/ahmadasrizalmi/CycleJournal Hak Cipta © 2026 Asri Digital