Qora QC Desktop

Qora QC Desktop adalah aplikasi desktop Quality Control untuk operator pabrik. Aplikasi membaca PGNServer API, menyimpan cache lokal SQLDelight, mengelola Draft Lokal, dan menyiapkan workflow Lembar Periksa untuk QC Press, QC Sewing, dan QC Cutting.

Stack utama: Kotlin Multiplatform, Compose Desktop, Material 3, Ktor Client, Koin, SQLDelight, dan native packaging Windows.

Prinsip Integrasi

• Desktop tidak boleh membaca PostgreSQL langsung.
• Semua data server lewat http://localhost:8080/api/v1.
• JWT hanya disimpan di sesi memori.
• UI memakai istilah Komoditas dan Pos, bukan label legacy line/zona_lini.
• Draft lokal dan antrean offline disiapkan melalui SQLDelight.

Workflow Saat Ini

• Login screen dengan validasi in-field dan prefill mode pengembangan.
• Dashboard enterprise compact.
• Layar QC Press, QC Sewing, dan QC Cutting dengan kartu collapsible, input NG tervalidasi, dan seleksi slot waktu dinamis.
• V2 Transaction Safety: Payload nested untuk mencegah penggelembungan angka produksi di server.
• Media Engine: Render foto part dan avatar dengan caching cerdas.
• Route Master Data, Riwayat, Analitik, Laporan, Media, Sinkronisasi, dan Pengaturan menampilkan status operasional yang bermakna.
• UI produksi tidak memakai data contoh ketika cache kosong. Operator diarahkan untuk sinkronisasi data.
• Logging HTTP memakai redactor agar token, NIP, dan kata sandi tidak bocor.

Development

./gradlew clean desktopMainClasses --stacktrace
./gradlew desktopTest --stacktrace
./gradlew packageDistributionForCurrentOS --stacktrace
./gradlew checksumWindowsMsi --stacktrace --no-configuration-cache
./gradlew run --stacktrace

Native packaging membutuhkan JDK 17 penuh dengan jlink dan jpackage.

Mode Pengembangan

AppEnvironment menyimpan kanal build, base URL API, dan kontrol login development. Nilai bawaan repository tidak mengaktifkan NIP/kata sandi default. Jika fitur ini diaktifkan pada build development, layar Login menampilkan badge Mode Pengembangan dan tetap memanggil API nyata POST /api/v1/otentikasi/masuk.

Dokumentasi utama:

• AGENTS.md
• docs/DESIGN.md
• docs/DATA_MODEL.md
• docs/API_CONTRACT.md
• docs/SYSTEM_LIFECYCLE.md
• docs/VERIFICATION_LOG_FOUNDATION_CLEANUP.md