Pola dan konvensi

Gaya pengkodean

• TypeScript strict mode diaktifkan
• Komponen fungsional React dengan hooks
• Tailwind CSS untuk styling; tidak ada gaya inline kecuali untuk nilai dinamis
• Kepatuhan token visual: gunakan --sentra-bg (#050505), --text-main (#fdfbf5), --text-muted (#737373), --sentra-green (#6b9b8a) untuk medis, dan --brand-accent (#eb5939) untuk CTA. Jangan gunakan hex/rgb ad-hoc atau kelas Tailwind yang tidak dipetakan seperti bg-green-500.

Penanganan kesalahan

• Gunakan kesalahan terketik dengan discriminated unions jika memungkinkan
• Semua panggilan API memiliki logika batas waktu dan percobaan ulang
• Jalur fallback harus selalu ada untuk operasi kritis klinis
• Jangan pernah melempar pengecualian yang tidak tertangani di skrip konten (dapat membuat ekstensi crash)

Manajemen state

• Store Zustand (lib/store.ts) adalah sumber kebenaran tunggal
• Persistensi chrome.storage.local dengan TTL 24 jam
• Hindari prop drilling; gunakan store selectors

Feature flags

Semua modul opsional dikendalikan oleh variabel lingkungan:

• Flag VITE_FEATURE_* untuk fitur UI
• Flag SENTRA_* untuk fitur mesin
• Default ke aman/mati saat flag hilang
• fallbackToKBOnly selalu true (hardcoded)

Konvensi penamaan

Pola pengujian

• Pengujian unit untuk fungsi murni (Vitest, lingkungan node)
• Pengujian integrasi untuk klien API (Vitest, lingkungan jsdom)
• Pengujian klinis untuk komponen UI (Vitest, jsdom + React Testing Library)
• Pengujian E2E untuk alur peramban (Playwright)
• Pengujian keamanan untuk jalur kritis pasien (file pengujian khusus)

Penanganan PII

• Hash pengenal pasien dengan SHA-256 sebelum panggilan jaringan (lib/api/pii-guard.ts)
• Tutupi nama dalam log dan UI (utils/name-masking.ts)
• Jangan pernah mencatat data pasien lengkap
• Simpan data pasien hanya di chrome.storage.local dengan TTL

Halaman terkait

• Alur kerja pengembangan
• Pengujian
• Debugging
• Peralatan