Dokumentasi teknis resmi untuk Soedirman Digital Repository (SDR) — platform katalog karya digital, formulir partisipasi, pengajuan publik (/ajukan), dan pemendek tautan (go.p3mdi.id) bagi Peserta Didik Program Presiden untuk Pemimpin Masa Depan Indonesia (P3MDI) Batalyon Soedirman.
| Atribut |
Nilai |
| Nama Sistem |
Soedirman Digital Repository (SDR) |
| Portal Produksi |
https://repo.p3mdi.id (Katalog) & https://go.p3mdi.id (Shortlink) |
| Stack Utama |
Next.js 16.4.5, React 19.3.0, TypeScript 5, Tailwind CSS v4, Prisma 7.10.1, PostgreSQL |
| Status Dokumentasi |
Aktif / Tersinkronisasi dengan Kode (master) |
| Terakhir Diperbarui |
2026-11-21 |
Seluruh dokumentasi teknis aktif disusun berdasarkan tiga pilar rekayasa utama untuk menjamin keterlacakan antara desain antarmuka, tata kelola data, keamanan, antarmuka sistem, serta operasi produksi.
| ID Dokumen |
Dokumen |
Standar Acuan |
Ringkasan Cakupan |
SDR-ARCH-001 |
PROJECT_ARCHITECTURE.md |
ISO/IEC/IEEE 42010 & IEEE 1016 |
Arsitektur modular monolit Next.js App Router, diagram konteks & lapisan (app/, components/, lib/), struktur direktori aktual, alur permintaan (proxy.ts, RSC, revalidasi, autentikasi, unggahan, pengajuan, shortlink), dependensi, dan atribut kualitas (NFR). |
SDR-DES-001 |
DESIGN_SYSTEM.md |
WCAG 2.1 AA & W3C Design Tokens |
Palet P3MDI Navy (#14254d) & Gold (#c9a227), token permukaan terang app/globals.css, tipografi Plus Jakarta Sans & JetBrains Mono, primitif komponen (.sdr-card, .sdr-btn-*, .sdr-input, <dialog class="sdr-dialog">, ModalDialog, ConfirmDialog, .prose-sdr), arsitektur informasi seluruh rute, dan standar aksesibilitas. |
| ID Dokumen |
Dokumen |
Standar Acuan |
Ringkasan Cakupan |
SDR-DATA-001 |
DATABASE_DESIGN.md |
DAMA-DMBOK & ISO/IEC 9075 (PostgreSQL) |
Skema PostgreSQL aktual dari prisma/schema.prisma dan seluruh 3 migrasi SQL: 10 model, 5 enum, ERD Mermaid, kamus data per kolom, indeks kustom SQL (pg_trgm, indeks parsial, indeks fungsional lower(name)), state machine, kebijakan retensi (media-cleanup.ts, repositories-purge.ts), serta perilaku seeding (prisma/seed.ts). |
SDR-SEC-001 |
SECURITY_AND_PRIVACY.md |
OWASP ASVS / ISO/IEC 27001 / UU PDP No. 27 Tahun 2022 |
Klasifikasi data & inventaris PII, keselarasan UU PDP, autentikasi Auth.js v5 Credentials + Argon2id + mitigasi timing attack + rate limiter berbasis database (auth_rate_limits) + pencabutan sesi via sessionVersion, matriks RBAC (SUPER_ADMIN vs ADMIN vs Publik), keamanan unggahan (sharp WebP & magic bytes), sanitasi HTML, validasi skema URL, header HTTP keamanan, serta pemindaian Gitleaks dan scripts/security-audit.ts. |
| ID Dokumen |
Dokumen |
Standar Acuan |
Ringkasan Cakupan |
SDR-API-001 |
API_AND_INTERFACES.md |
Interface Control Document (ICD) / IEEE 830 |
Spesifikasi kontrak antarmuka lengkap: Route Handlers (/api/health, /api/auth/[...nextauth], /api/uploads), rute pengalihan (/s/[alias]), dan seluruh Server Actions pada lib/actions/ lengkap dengan skema validasi Zod, pemeriksaan otorisasi, kontrak respons, event log audit, dan path revalidasi cache. |
SDR-ENG-001 |
ENGINEERING_AND_TESTING.md |
ISO/IEC/IEEE 12207 & ISO/IEC/IEEE 29119 |
Konvensi basis kode, aturan Next.js 16 & TypeScript strict (AGENTS.md), alur branching & gerbang kualitas CI, panduan skrip verifikasi (typecheck, lint, db:validate, security-audit.ts, verify-phase1..5.ts, test-admin-system.ts), skrip pemeliharaan, serta Architecture Decision Records (ADR). |
SDR-OPS-001 |
DEPLOYMENT.md |
ISO/IEC/IEEE 26514 & SRE |
Topologi produksi P3MDI (https://repo.p3mdi.id & https://go.p3mdi.id), build Docker (Dockerfile), pipeline GitHub Actions (.github/workflows/ci-deploy.yml), deploy otomatis SSH (scripts/deploy-server.sh), katalog variabel lingkungan (.env.example), migrasi & seeding PostgreSQL, penyimpanan S3/lokal, cron pemeliharaan, backup/restore, health check, dan prosedur rollback. |
Dua dokumen berikut dipertahankan tanpa perubahan sebagai catatan historis fase perencanaan MVP awal (4 November 2026) sebelum implementasi berjalan. Spesifikasi teknis, skema basis data, palet warna, dan konfigurasi produksi aktual merujuk sepenuhnya pada 7 dokumen aktif pada Bagian 1 di atas.
| Dokumen |
Status |
Peran Historis |
| PRD.md |
Baseline Historis (v1.0, 2026-11-04) |
Dokumen kebutuhan produk awal (MVP) dengan referensi desain gelap awal dan ruang lingkup P0 sebelum penyesuaian identitas visual P3MDI serta penambahan fitur pengajuan publik (/ajukan), tautan pendek (go.p3mdi.id), RBAC multi-admin, log audit, dan pengaturan beranda. |
| IMPLEMENTATION_PLAN.md |
Baseline Historis (2026-11-04) |
Rencana kerja bertahap Fase 1 hingga Fase 5 saat inisiasi proyek sebelum seluruh fitur inti dan ekstensi selesai dibangun. |