Skip to content

Indeks Dokumentasi Teknis Sudirman Voice

Dokumentasi teknis Sudirman Voice disusun mengikuti tiga pilar rekayasa utama — Desain, Data, dan Rekayasa Perangkat Lunak — serta dilengkapi panduan operasional, kontribusi, dan catatan riwayat proyek. Seluruh dokumen disinkronkan dengan kode sumber versi 1.2.0 (package.json).

Aturan keamanan berkas: Jangan pernah melakukan commit berkas data Serdik (data_serdik*.xlsx) maupun daftar PIN (pin-awal-*.xlsx, pin-reset-*.xlsx). .gitignore sudah menolaknya, namun selalu periksa git status sebelum mengirim perubahan.

ID Dokumen Lingkup Utama Standar Acuan
SV-ARCH-001 teknis/arsitektur.md Konteks sistem C4, tech stack, struktur 15 domain & 50 halaman, alur request berlapis, autentikasi & RBAC dinamis, konkurensi row lock, notifikasi, impor, serta layout ISO/IEC/IEEE 42010 & IEEE 1016
SV-DES-001 teknis/desain-sistem.md Prinsip estetika institusional Stripe-inspired, token warna/tipografi/bayangan Tailwind v4 (globals.css), daftar anti-estetika terlarang, standar WCAG 2.1 AA, arsitektur navigasi HP vs desktop, pustaka SVG (icons.tsx), dan pedoman microcopy WCAG 2.1 AA & Design Token System
ID Dokumen Lingkup Utama Standar Acuan
SV-DATA-001 teknis/data-model.md Inventaris lengkap 39 model Prisma & 12 enum, relasi ERD, constraint SQL khusus di migrasi, diagram siklus hidup entitas, aturan search_path kosong, serta kapasitas penyimpanan bytea DAMA-DMBOK & Entity-Relationship Modeling
SV-SEC-001 teknis/keamanan-dan-privasi.md Klasifikasi data & UU PDP No. 27/2022, siklus autentikasi (Argon2id, SHA-256 sv_session, Google OIDC/PKCE, kode email, reserve-then-refund throttle & lockout), RBAC dinamis dua lapis, jaminan anonimitas mutlak, keamanan media & header CSP, production guards, dan AuditLog OWASP ASVS, ISO 27001, & UU PDP No. 27/2022
ID Dokumen Lingkup Utama Standar Acuan
SV-API-001 teknis/api-dan-antarmuka.md Kontrak lengkap 15 HTTP Route Handlers, katalog 94 Server Actions di 24 berkas aksi, kontrak Result<T> & kode galat baku, kontrak impor/ekspor Excel/CSV, serta integrasi eksternal (Google OIDC, Web Push VAPID, SMTP Hostinger, Neon PostgreSQL) Interface Control Document (ICD) / IEEE 1016
SV-ENG-001 teknis/sdlc-dan-pengujian.md Siklus SDLC & release gates, piramida pengujian (35 unit, 60 integrasi dengan Postgres search_path kosong & uji balapan, 21 E2E Playwright mobile & CSP), pipeline CI/CD GitHub Actions, Definition of Done, dan Architecture Decision Records (ADR) ISO/IEC/IEEE 12207 & ISO/IEC/IEEE 29119
SV-OPS-001 teknis/operasional.md Peta lingkungan & seluruh variabel .env, konfigurasi Docker Compose di belakang Traefik VPS, jadwal cron, automatic rollback di scripts/deploy-vps.sh, backup & pemulihan bencana (DR), seed dev, serta panduan troubleshooting & pemantauan ISO/IEC/IEEE 26514 / SRE
Dokumen / Folder Keterangan
../README.md Pengenalan proyek, panduan setup lokal, ringkasan fitur, tes, dan setup awal production
teknis/kontribusi.md Konvensi kode harian, format Conventional Commits, aturan Semantic Versioning, dan cara menjalankan tes
../CHANGELOG.md Catatan perubahan tiap versi (0.1.0 hingga 1.2.0) dengan bahasa awam
enhancement-log.md Log historis permintaan fitur (ENH-001 s.d. ENH-079) beserta keputusan implementasinya
contoh-impor/README.md Berkas contoh impor Excel/CSV untuk Form, Polling, dan Aspirasi (diverifikasi oleh tests/integration/impor-contoh.test.ts)
docs/superpowers/specs/ & docs/superpowers/plans/ Dokumen spesifikasi desain dan rencana implementasi historis untuk modul besar (Fondasi, Aspirasi, Form & Survei, Peran, Polling, Hackathon, Pindah VPS)