Skip to content

Arsitektur Sistem — Soedirman Digital Repository (SDR)

Field Nilai
ID Dokumen SDR-ARCH-001
Pilar Desain
Standar Acuan ISO/IEC/IEEE 42010 & IEEE 1016
Status Aktif / Tersinkronisasi dengan Kode
Terakhir Diperbarui 2026-11-21
Sumber Kebenaran package.json, next.config.ts, proxy.ts, app/**, components/**, lib/**, prisma/schema.prisma, Dockerfile, .github/workflows/ci-deploy.yml

Soedirman Digital Repository (SDR) adalah aplikasi web full-stack monolit modular berbasis Next.js App Router yang berfungsi sebagai:

  1. Etalase & Katalog Karya Publik (https://repo.p3mdi.id): Menyajikan karya perangkat lunak, aplikasi web, aplikasi mobile, sistem informasi, formulir partisipasi berbatas waktu, dan dokumentasi resmi Peserta Didik P3MDI Soedirman tanpa memerlukan akun pengunjung.
  2. Kanal Pengajuan Karya Publik (/ajukan): Memungkinkan peserta didik atau tim pengembang mengajukan karya baru ke antrean peninjauan administrator.
  3. Pemendek Tautan Terpadu (https://go.p3mdi.id dan /s/[alias]): Menyediakan pengalihan alias URL resmi P3MDI lengkap dengan penghitung klik (clickCount) dan dukungan penonaktifan tautan.
  4. Portal Administrasi Terproteksi (/admin/*): Panel kerja pengelola (ADMIN dan SUPER_ADMIN) untuk kurasi katalog, manajemen kategori, peninjauan pengajuan, pengelolaan tautan pendek, konfigurasi tampilan beranda, pengelolaan akun admin, dan pemantauan log audit.
Pendorong Arsitektur Konsekuensi Implementasi Aktual
Katalog publik berkinerja tinggi & ramah SEO Halaman publik dirender sisi server (React Server Components) melalui lib/repositories/public-queries.ts, didukung generateMetadata, app/sitemap.ts, app/robots.ts, serta pembatasan halaman beranda via SystemSetting.
Otorisasi ketat di batas server (Defense-in-Depth) proxy.ts hanya melakukan pengalihan optimistik cookie sesi pada /admin/*; seluruh layout, halaman, Server Action, dan Route Handler memvalidasi sesi serta sessionVersion langsung ke PostgreSQL melalui requireAdmin() dan requireSuperAdmin().
Satu unit deploy tanpa layanan terpisah Seluruh modul antarmuka, logika domain, autentikasi, pemrosesan media (sharp), dan penyimpanan berjalan dalam satu container Docker Node.js 24 (Dockerfile) yang terhubung ke PostgreSQL 16/17 dan penyimpanan objek S3-kompatibel (atau fallback disk lokal public/uploads/).
Keamanan konten & aset unggahan Seluruh unggahan gambar diproksikan lewat POST /api/uploads, diverifikasi magic bytes, dihapus metadata EXIF, dikonversi ke WebP (sharp), dan dicatat di tabel media_uploads. Teks kaya overview disanitasi melalui allow-list sanitize-html.
flowchart LR
    V["Pengunjung Publik (Browser)"] -->|"HTTPS GET / /repositories /ajukan"| APP
    V -->|"HTTPS GET go.p3mdi.id/alias"| PROXY
    A["Administrator (Browser)"] -->|"HTTPS + Cookie Sesi Auth.js"| APP
    subgraph APP["Aplikasi Next.js 16.4.5 (Container Docker Tunggal)"]
        PROXY["proxy.ts (Routing Domain Shortlink & Redirect /admin)"]
        PUB["Rute Publik RSC (/, /repositories, /categories, /ajukan, /s)"]
        ADM["Panel Admin (/admin/*) & Server Actions"]
        API["Route Handlers (/api/health, /api/auth, /api/uploads)"]
        LIB["Lapisan Domain & Keamanan (lib/**)"]
    end
    PROXY --> PUB
    PROXY --> ADM
    PUB --> LIB
    ADM --> LIB
    API --> LIB
    LIB -->|"Prisma 7.10.1 + @prisma/adapter-pg"| DB[("PostgreSQL (10 Tabel)")]
    LIB -->|"S3 SDK (@aws-sdk/client-s3)"| S3[("Object Storage S3 / MinIO")]
    LIB -->|"Fallback saat S3 offline"| DISK[("Disk Lokal public/uploads/")]
    V -->|"GET Aset WebP"| S3

2. Arsitektur Berlapis (Layered Architecture)

Section titled “2. Arsitektur Berlapis (Layered Architecture)”

Basis kode dibagi menjadi empat lapisan logis dengan batas dependensi satu arah dari presentasi menuju infrastruktur:

flowchart TD
    subgraph Presentation["Lapisan Presentasi (app/ & components/)"]
        P_PUB["Rute Publik: app/page.tsx, repositories/, categories/, ajukan/, s/[alias]/"]
        P_ADM["Rute Admin: app/admin/login/ & app/admin/(dashboard)/**"]
        P_UI["Komponen UI: components/home/, layout/, public/, repository/, admin/, ui/"]
    end

    subgraph Application["Lapisan Aplikasi & Batas Keamanan"]
        PRX["proxy.ts (Shortlink Host Rewrite & Optimistic Cookie Guard)"]
        SA["Server Actions: lib/actions/*.ts"]
        RH["Route Handlers: app/api/health, /api/auth/[...nextauth], /api/uploads"]
        AUTH["Guards: requireAdmin(), requireSuperAdmin(), checkRateLimit()"]
    end

    subgraph Domain["Lapisan Domain & Layanan"]
        PQ["lib/repositories/public-queries.ts"]
        AS["lib/repositories/admin-service.ts"]
        AUD["lib/audit/audit-service.ts & audit-helpers.ts"]
        MS["lib/storage/media-service.ts & image-processing.ts"]
    end

    subgraph Infrastructure["Lapisan Infrastruktur & Utilitas"]
        DB["lib/db/client.ts (PrismaClient + PrismaPg Singleton)"]
        S3A["lib/storage/s3-adapter.ts & keys.ts"]
        SAN["lib/security/sanitize.ts"]
        VAL["lib/validations/*.ts (Zod v4 Schemas)"]
        ENV["lib/env.ts (Zod Environment Validation)"]
    end

    P_PUB --> PQ
    P_PUB --> P_UI
    P_ADM --> AUTH
    P_ADM --> P_UI
    P_UI -->|"Panggil Action"| SA
    P_UI -->|"Multipart POST"| RH
    PRX --> P_PUB
    PRX --> P_ADM
    SA --> AUTH
    SA --> VAL
    SA --> AS
    SA --> AUD
    RH --> AUTH
    RH --> MS
    AS --> DB
    AS --> SAN
    AS --> MS
    MS --> S3A
    MS --> DB
    PQ --> DB
    AUD --> DB
    AUTH --> DB
    S3A --> ENV
  1. Tidak ada akses Prisma dari Client Component: Komponen bertanda "use client" hanya memanggil Server Actions (lib/actions/*.ts) atau Route Handler (/api/uploads), tidak pernah mengimpor @/lib/db/client.
  2. Isolasi Query Publik: Seluruh kueri pengunjung publik di lib/repositories/public-queries.ts mengunci konstanta PUBLIC_WHERE = { status: RepositoryStatus.PUBLISHED, deletedAt: null } serta menggunakan select eksplisit agar kolom internal (coverStorageKey, bannerStorageKey, searchText, deletedAt) tidak pernah dikirim ke antarmuka publik.
  3. Otorisasi di Setiap Titik Masuk: Seluruh mutasi admin memanggil requireAdmin(false) atau requireSuperAdmin(false) pada baris awal fungsi.
  4. Validasi Berbasis Skema Tunggal: Skema Zod di lib/validations/repository.ts, lib/validations/shortlink.ts, dan lib/validations/submission.ts menjadi kontrak validasi authoritative di sisi server.

Struktur aktual proyek pada root Soedirman-Digital-Repository/ (tanpa direktori src/):

Soedirman-Digital-Repository/
├─ .github/workflows/
│ └─ ci-deploy.yml # Pipeline CI (typecheck, lint, audit, Gitleaks, Docker) & CD SSH
├─ app/
│ ├─ layout.tsx # Root layout: lang="id", Plus Jakarta Sans + JetBrains Mono, skip-link, PublicHeader/Footer
│ ├─ globals.css # Tailwind v4 + token warna P3MDI Navy/Gold, utilitas .sdr-*, dialog native, .prose-sdr
│ ├─ page.tsx # Beranda Linktree + daftar tautan karya (terbatas oleh SystemSetting homepage_display_limit)
│ ├─ error.tsx # Error boundary ramah pengguna tanpa stack trace
│ ├─ not-found.tsx # Halaman 404 global
│ ├─ robots.ts # Aturan robots.txt (izinkan /, blokir /admin/ dan /api/)
│ ├─ sitemap.ts # Sitemap XML dinamis (hanya repository PUBLISHED & kategori)
│ ├─ repositories/
│ │ ├─ page.tsx # Katalog publik (?q=, ?category=, ?sort=, ?page=)
│ │ └─ [slug]/page.tsx # Halaman detail karya, galeri lightbox, fitur, CTA akses, karya terkait
│ ├─ categories/
│ │ └─ [slug]/page.tsx # Halaman daftar karya per kategori
│ ├─ ajukan/
│ │ └─ page.tsx # Formulir pengajuan karya publik tanpa login
│ ├─ s/
│ │ └─ [alias]/page.tsx # Pengalihan tautan pendek (penghitung klik & pengecekan status aktif)
│ ├─ admin/
│ │ ├─ login/page.tsx # Halaman masuk pengelola (noindex)
│ │ └─ (dashboard)/
│ │ ├─ layout.tsx # Guard requireAdmin(true) + AdminLayoutClient (noindex)
│ │ ├─ page.tsx # Dashboard ringkasan statistik & 6 karya terakhir diperbarui
│ │ ├─ repositories/
│ │ │ ├─ page.tsx # Tabel kelola karya + filter status & pencarian
│ │ │ ├─ new/page.tsx # Tambah karya baru
│ │ │ └─ [id]/edit/page.tsx # Ubah karya eksisting
│ │ ├─ categories/page.tsx # Manajemen kategori publikasi
│ │ ├─ submissions/page.tsx # Peninjauan pengajuan karya publik (/ajukan)
│ │ ├─ shortlinks/page.tsx # Manajemen tautan pendek go.p3mdi.id
│ │ ├─ administrators/page.tsx # Manajemen akun admin (khusus SUPER_ADMIN)
│ │ ├─ audit-logs/page.tsx # Pemantauan log audit global (khusus SUPER_ADMIN)
│ │ ├─ my-activity/page.tsx # Riwayat aktivitas pribadi administrator saat ini
│ │ └─ settings/page.tsx # Pengaturan kredensial akun & batas tampilan beranda
│ └─ api/
│ ├─ health/route.ts # GET health check (SELECT 1 -> 200 ok / 503 error)
│ ├─ auth/[...nextauth]/route.ts# Auth.js v5 GET/POST handler
│ └─ uploads/route.ts # POST multipart image upload terautentikasi
├─ components/
│ ├─ home/ LinktreeHome.tsx
│ ├─ layout/ PublicHeader.tsx, PublicFooter.tsx
│ ├─ public/ PublicSubmissionForm.tsx
│ ├─ repository/ CatalogFilters.tsx, CategoryCard.tsx, DeadlineBadge.tsx, EmptyState.tsx,
│ │ Pagination.tsx, ProductAccessButtons.tsx, RelatedRepositories.tsx,
│ │ RepositoryCard.tsx, RepositoryCatalogView.tsx, RepositoryGallery.tsx,
│ │ RepositoryInfoSidebar.tsx
│ ├─ admin/ AccountSettingsView.tsx, AdminHeader.tsx, AdminLayoutClient.tsx, AdminLoginForm.tsx,
│ │ AdminManagementView.tsx, AdminSidebar.tsx, AuditLogTableView.tsx, CategoryFormDialog.tsx,
│ │ CategoryTable.tsx, HomepageDisplaySettingCard.tsx, ImageUploader.tsx, MyActivityView.tsx,
│ │ RepositoryForm.tsx, RepositoryTable.tsx, RichTextEditor.tsx, ScreenshotManager.tsx,
│ │ ShortLinkFormDialog.tsx, ShortLinkTableView.tsx, SubmissionApprovalView.tsx,
│ │ SubmissionReviewDialog.tsx
│ └─ ui/ ModalDialog.tsx, ConfirmDialog.tsx
├─ lib/
│ ├─ actions/ action-response.ts, admin-management-actions.ts, auth-actions.ts, category-actions.ts,
│ │ repository-actions.ts, shortlink-actions.ts, submission-actions.ts, system-settings-actions.ts
│ ├─ audit/ audit-helpers.ts, audit-service.ts
│ ├─ auth/ auth.ts, password.ts, rate-limit.ts, require-admin.ts
│ ├─ db/ client.ts
│ ├─ repositories/admin-service.ts, public-queries.ts
│ ├─ security/ sanitize.ts
│ ├─ storage/ image-processing.ts, keys.ts, media-service.ts, s3-adapter.ts
│ ├─ utils/ cn.ts
│ ├─ validations/ repository.ts, shortlink.ts, submission.ts
│ └─ env.ts
├─ prisma/
│ ├─ schema.prisma # 10 model, 5 enum
│ ├─ seed.ts # Seed kategori dasar, Super Admin, & data demo non-produksi
│ └─ migrations/ # 3 migrasi SQL historis & terstruktur
├─ scripts/ # deploy-server.sh, security-audit.ts, media-cleanup.ts, repositories-purge.ts,
│ # check-db.ts, create-admin.ts, migrate-admin-v2.ts, test-admin-system.ts, verify-phase1..5.ts
├─ public/images/ # Photo-P3MDI.png, placeholder.svg, hero-dusk.webp, seed/*.webp
├─ proxy.ts # Next.js 16 Request Proxy (shortlink domain rewrite + admin session cookie redirect)
├─ next.config.ts # CSP, security headers, remotePatterns, loader CSS Turbopack
├─ prisma.config.ts # Konfigurasi Prisma 7 CLI datasource
├─ Dockerfile # Image produksi Node 24 Bookworm Slim
├─ .env.example # Templat variabel lingkungan
└─ README.md # Dokumentasi pengantar repositori

4. Alur Permintaan, Caching, dan Proses Bisnis Utama

Section titled “4. Alur Permintaan, Caching, dan Proses Bisnis Utama”

4.1 Rendering Halaman Publik & Revalidasi Cache

Section titled “4.1 Rendering Halaman Publik & Revalidasi Cache”

Seluruh halaman dinamis (/ dengan force-dynamic dan revalidate = 60, /repositories, /ajukan, /s/[alias], /admin/*) membaca langsung data PostgreSQL terbaru sesuai filter permintaan. Setelah mutasi data berhasil di Server Action, modul lib/actions/action-response.ts mengeksekusi safeRevalidatePaths(...) untuk menyegarkan rute terkait secara otomatis (dengan fallback aman saat skrip dijalankan di luar konteks HTTP, misalnya dari CLI verifikasi).

Mutasi Data Rute yang Direvalidasi (revalidatePath)
createRepository /, /repositories, /repositories/[slug], /admin/repositories, /admin
updateRepository /, /repositories, /repositories/[slug-lama], /repositories/[slug-baru], /admin/repositories, /admin
deleteRepository / togglePublicationStatus /, /repositories, /repositories/[slug], /admin/repositories, /admin
toggleFeaturedStatus /, /repositories, /admin/repositories, /admin
createCategory / updateCategory / deleteCategory /admin/categories, /admin, /, /repositories
submitPublicRepository /admin/submissions
approveSubmission /admin/submissions, /admin/repositories, /repositories, /
rejectSubmission /admin/submissions
createShortLink / updateShortLink / toggleShortLinkStatus / deleteShortLink /admin/shortlinks
updateAccountCredentials /admin/settings, /admin/administrators, /admin
updateHomepageDisplayLimit /, /admin/settings

[!NOTE] Berbeda dari rancangan awal sebelum implementasi yang merencanakan "use cache" dan revalidateTag, implementasi produksi saat ini menggunakan kombinasi force-dynamic dan revalidatePath terpusat sehingga pembaruan status publikasi, batas tampilan beranda, maupun peninjauan pengajuan selalu konsisten tanpa risiko cache stale antar-halaman.

4.2 Alur Autentikasi Admin & Pencabutan Sesi

Section titled “4.2 Alur Autentikasi Admin & Pencabutan Sesi”
sequenceDiagram
    participant A as Administrator
    participant F as /admin/login (loginAction)
    participant AU as Auth.js Credentials.authorize
    participant RL as rate-limit.ts (auth_rate_limits)
    participant DB as PostgreSQL (admins & audit_logs)

    A->>F: Kirim username + password
    F->>AU: signIn("credentials", { username, password })
    AU->>AU: Validasi Zod & normalisasi username lowercase
    AU->>RL: checkRateLimit("login:" + username)
    alt Terkunci (>= 5 gagal / 15 menit)
        RL-->>AU: allowed = false
        AU->>DB: Catat AuditLog ADMIN_LOGIN_FAILED (RATE_LIMITED)
        AU-->>F: Throw Error("RATE_LIMITED")
    else Diizinkan
        AU->>DB: findUnique admin by username
        alt Admin tidak ditemukan
            AU->>AU: Dummy verifyPassword (Argon2id timing defense)
            AU->>RL: recordFailedAttempt
            AU->>DB: Catat AuditLog ADMIN_LOGIN_FAILED (USER_NOT_FOUND)
            AU-->>F: null ("Username atau kata sandi tidak valid.")
        else Admin nonaktif atau password salah
            AU->>RL: recordFailedAttempt
            AU->>DB: Catat AuditLog ADMIN_LOGIN_FAILED
            AU-->>F: null
        else Terverifikasi valid
            AU->>RL: resetRateLimit
            AU->>DB: Update lastLoginAt & catat ADMIN_LOGIN_SUCCESS
            AU-->>F: Set JWT Cookie (maxAge 8 jam) + redirect /admin
        end
    end

Pada setiap permintaan ke panel admin atau mutasi, requireAdmin() mengambil ulang isActive, role, dan sessionVersion dari PostgreSQL. Jika administrator keluar (logoutAction()), dinonaktifkan, atau kata sandinya direset oleh SUPER_ADMIN, kolom session_version dinaikkan (increment: 1) sehingga token JWT lama langsung ditolak.

4.3 Alur Pengajuan Karya Publik (/ajukan -> /admin/submissions)

Section titled “4.3 Alur Pengajuan Karya Publik (/ajukan -> /admin/submissions)”
sequenceDiagram
    participant P as Peserta Didik (Publik)
    participant AJ as /ajukan (PublicSubmissionForm)
    participant SA as submission-actions.ts
    participant DB as PostgreSQL
    participant AD as Admin (/admin/submissions)

    P->>AJ: Isi nama, judul, kategori, deskripsi, URL, deadline, techStack
    AJ->>SA: submitPublicRepository(rawInput)
    SA->>SA: Parse publicSubmissionSchema & cek eksistensi Category
    SA->>DB: INSERT repository_submissions (status = PENDING)
    SA-->>AJ: Tampilkan konfirmasi "Pengajuan diterima"
    AD->>SA: approveSubmission(submissionId)
    SA->>SA: requireAdmin(false)
    SA->>DB: $transaction: generate slug unik -> INSERT repositories (PUBLISHED) -> UPDATE submission (APPROVED)
    SA->>DB: INSERT audit_logs (APPROVE_REPOSITORY)
    SA-->>AD: Revalidasi /, /repositories, /admin/*

4.4 Alur Pemendek Tautan (go.p3mdi.id & /s/[alias])

Section titled “4.4 Alur Pemendek Tautan (go.p3mdi.id & /s/[alias])”
flowchart LR
    REQ["Permintaan HTTP ke https://go.p3mdi.id/panduan"] --> PRX["proxy.ts"]
    PRX -->|"Host cocok go.p3mdi.id & path = /"| REDIR_HOME["Redirect ke NEXTAUTH_URL (https://p3mdi.id)"]
    PRX -->|"Host cocok go.p3mdi.id & path = /panduan"| REWRITE["Rewrite internal ke /s/panduan"]
    REWRITE --> PAGE["app/s/[alias]/page.tsx"]
    PAGE --> NORMALIZE["normalizeAlias() -> findUnique(alias)"]
    NORMALIZE -->|"Tidak ditemukan"| UI_404["Tampilkan kartu Tautan tidak ditemukan"]
    NORMALIZE -->|"isActive = false"| UI_OFF["Tampilkan kartu Tautan dinonaktifkan"]
    NORMALIZE -->|"isActive = true"| INC["UPDATE short_links SET click_count = click_count + 1"]
    INC --> REDIR["HTTP Redirect ke shortLink.originalUrl"]

4.5 Alur Pengunggahan Gambar & Penyimpanan Ganda

Section titled “4.5 Alur Pengunggahan Gambar & Penyimpanan Ganda”
  1. Komponen ImageUploader (COVER/BANNER) atau ScreenshotManager (SCREENSHOT) mengirim multipart/form-data ke POST /api/uploads.
  2. Handler memeriksa sesi via requireAdmin(false) dan batas ukuran UPLOAD_MAX_BYTES (default 5242880 byte / 5 MB).
  3. processImageBuffer memverifikasi magic bytes (hanya JPEG, PNG, WebP), membatasi input maksimal 50 megapiksel (limitInputPixels: 50000000), melakukan auto-orient, membatasi sisi terpanjang 2560px, menghapus seluruh metadata EXIF, dan mengonversi gambar menjadi WebP (quality: 85).
  4. putStorageObject mengunggah buffer ke bucket S3-kompatibel (repositories/{tahun}/{bulan}/{kind}-{uuid}.webp). Jika koneksi S3 gagal karena ECONNREFUSED, TimeoutError, atau fetch failed (skenario pengembangan lokal tanpa MinIO), berkas otomatis disimpan ke public/uploads/{storageKey} dengan URL /uploads/{storageKey}.
  5. Metadata (storageKey, publicUrl, kind, mimeType, sizeBytes, width, height, uploadedById) dicatat ke media_uploads, lalu ditautkan (attachedAt, repositoryId) saat createRepository atau updateRepository dieksekusi dalam transaksi Prisma.

5. Daftar Dependensi Aktual (package.json)

Section titled “5. Daftar Dependensi Aktual (package.json)”
Paket Versi (package.json) Peran dalam Sistem
next 16.4.5 Framework full-stack App Router, RSC, Server Actions, Proxy
react, react-dom 19.3.0 Pustaka rendering UI sisi server dan klien
prisma, @prisma/client, @prisma/adapter-pg ^7.10.1 ORM Prisma 7 dengan PostgreSQL driver adapter
pg ^8.23.1 Driver koneksi PostgreSQL
next-auth ^5.0.0-beta.32 Autentikasi Credentials dan sesi JWT terenkripsi
@node-rs/argon2 ^2.2.2 Hashing kata sandi Argon2id (native binding)
zod ^4.6.7 Validasi skema input API, form, dan variabel lingkungan
sharp ^0.35.5 Validasi gambar, strip EXIF, resize, konversi WebP
@aws-sdk/client-s3 ^3.1162.0 Klien penyimpanan objek S3 / MinIO / Cloudflare R2
sanitize-html ^2.18.1 Sanitasi HTML berbasis allow-list untuk konten rich text
lucide-react ^1.68.0 Ikon antarmuka SVG konsisten
embla-carousel-react ^8.6.0 Dependensi carousel di bundle aplikasi
clsx, tailwind-merge ^2.1.1, ^3.7.0 Utilitas penggabungan kelas CSS (lib/utils/cn.ts)
dotenv ^18.0.9 Pemuatan .env untuk Prisma CLI dan skrip operasional
server-only ^0.0.1 Penjaga agar modul server tidak bocor ke bundle klien
Paket Versi (package.json) Peran
typescript, @types/node, @types/pg, @types/react, @types/react-dom, @types/sanitize-html ^5 / tipe terkait Kompilasi tipe strict (tsc --noEmit)
tailwindcss, @tailwindcss/turbopack ^4 Pemrosesan CSS Tailwind v4 pada Turbopack
eslint, eslint-config-next ^9 / 16.4.5 Pemeriksaan kualitas kode dan aturan Core Web Vitals
tsx ^4.23.15 Eksekutor TypeScript untuk seeding, skrip pemeliharaan, dan skrip verifikasi

6. Atribut Kualitas & Batasan Teknis (Non-Functional Requirements)

Section titled “6. Atribut Kualitas & Batasan Teknis (Non-Functional Requirements)”
Dimensi Target / Mekanisme Implementasi
Ketersediaan & Pemulihan Endpoint GET /api/health memverifikasi koneksi PostgreSQL secara langsung; deploy produksi oleh scripts/deploy-server.sh membuat backup pg_dump sebelum migrasi dan menyediakan rollback container otomatis jika health check gagal.
Kinerja & Pencarian Ekstensi PostgreSQL pg_trgm dengan indeks GIN pada repositories.search_text, indeks parsial untuk karya PUBLISHED non-terhapus, dan konversi gambar WebP dengan batas dimensi maksimal 2560px.
Keamanan Header HTTP ketat di next.config.ts (CSP, X-Frame-Options: DENY, nosniff, Referrer-Policy, Permissions-Policy), Argon2id OWASP baseline, rate limiting DB, audit trail persisten 25 jenis aksi, dan pemindaian Gitleaks pada setiap CI run.
Aksesibilitas Target kepatuhan WCAG 2.1 Level AA melalui skip-link, fokus terlihat outline: 2px solid var(--p600), dialog <dialog> native (ModalDialog, ConfirmDialog), dan perlindungan zoom input iOS (16px pada layar < 640px). Detail lengkap di DESIGN_SYSTEM.md.
Batasan Operasional Ukuran unggahan dibatasi default 5 MB (UPLOAD_MAX_BYTES), maksimal 10 screenshot per repositori, serta pembersihan media yatim (> 24 jam) dan repositori terhapus lunak (> 30 hari) mengandalkan eksekusi skrip pemeliharaan berkala.