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) |