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 |
1. Pendorong Arsitektur & Konteks Sistem
Section titled “1. Pendorong Arsitektur & Konteks Sistem”Soedirman Digital Repository (SDR) adalah aplikasi web full-stack monolit modular berbasis Next.js App Router yang berfungsi sebagai:
- 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. - Kanal Pengajuan Karya Publik (
/ajukan): Memungkinkan peserta didik atau tim pengembang mengajukan karya baru ke antrean peninjauan administrator. - Pemendek Tautan Terpadu (
https://go.p3mdi.iddan/s/[alias]): Menyediakan pengalihan alias URL resmi P3MDI lengkap dengan penghitung klik (clickCount) dan dukungan penonaktifan tautan. - Portal Administrasi Terproteksi (
/admin/*): Panel kerja pengelola (ADMINdanSUPER_ADMIN) untuk kurasi katalog, manajemen kategori, peninjauan pengajuan, pengelolaan tautan pendek, konfigurasi tampilan beranda, pengelolaan akun admin, dan pemantauan log audit.
1.1 Keputusan Penggerak Arsitektur
Section titled “1.1 Keputusan Penggerak Arsitektur”| 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. |
1.2 Diagram Konteks Sistem
Section titled “1.2 Diagram Konteks Sistem”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
Aturan Isolasi Lapisan
Section titled “Aturan Isolasi Lapisan”- 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. - Isolasi Query Publik: Seluruh kueri pengunjung publik di
lib/repositories/public-queries.tsmengunci konstantaPUBLIC_WHERE = { status: RepositoryStatus.PUBLISHED, deletedAt: null }serta menggunakanselecteksplisit agar kolom internal (coverStorageKey,bannerStorageKey,searchText,deletedAt) tidak pernah dikirim ke antarmuka publik. - Otorisasi di Setiap Titik Masuk: Seluruh mutasi admin memanggil
requireAdmin(false)ataurequireSuperAdmin(false)pada baris awal fungsi. - Validasi Berbasis Skema Tunggal: Skema Zod di
lib/validations/repository.ts,lib/validations/shortlink.ts, danlib/validations/submission.tsmenjadi kontrak validasi authoritative di sisi server.
3. Struktur Direktori Aktual
Section titled “3. Struktur Direktori Aktual”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 repositori4. 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"danrevalidateTag, implementasi produksi saat ini menggunakan kombinasiforce-dynamicdanrevalidatePathterpusat 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”- Komponen
ImageUploader(COVER/BANNER) atauScreenshotManager(SCREENSHOT) mengirimmultipart/form-datakePOST /api/uploads. - Handler memeriksa sesi via
requireAdmin(false)dan batas ukuranUPLOAD_MAX_BYTES(default5242880byte / 5 MB). processImageBuffermemverifikasi 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).putStorageObjectmengunggah buffer ke bucket S3-kompatibel (repositories/{tahun}/{bulan}/{kind}-{uuid}.webp). Jika koneksi S3 gagal karenaECONNREFUSED,TimeoutError, ataufetch failed(skenario pengembangan lokal tanpa MinIO), berkas otomatis disimpan kepublic/uploads/{storageKey}dengan URL/uploads/{storageKey}.- Metadata (
storageKey,publicUrl,kind,mimeType,sizeBytes,width,height,uploadedById) dicatat kemedia_uploads, lalu ditautkan (attachedAt,repositoryId) saatcreateRepositoryatauupdateRepositorydieksekusi dalam transaksi Prisma.
5. Daftar Dependensi Aktual (package.json)
Section titled “5. Daftar Dependensi Aktual (package.json)”5.1 Dependensi Produksi
Section titled “5.1 Dependensi Produksi”| 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 |
5.2 Dependensi Pengembangan
Section titled “5.2 Dependensi Pengembangan”| 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. |