Skip to content

Indeks Dokumentasi Teknis — Soedirman Digital Repository (SDR)

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.

Pilar 1 — Desain (Architecture & Design System)

Section titled “Pilar 1 — Desain (Architecture & Design System)”
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.

Pilar 2 — Data (Database, Security & Privacy)

Section titled “Pilar 2 — Data (Database, Security & Privacy)”
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.

Pilar 3 — Rekayasa Perangkat Lunak (Interfaces, Engineering & Operations)

Section titled “Pilar 3 — Rekayasa Perangkat Lunak (Interfaces, Engineering & Operations)”
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.

2. Dokumen Referensi Historis (Baseline MVP Awal)

Section titled “2. Dokumen Referensi Historis (Baseline MVP Awal)”

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.

3. Peta Navigasi Cepat Berdasarkan Peran Pembaca

Section titled “3. Peta Navigasi Cepat Berdasarkan Peran Pembaca”