SDR tidak mengekspos REST API CRUD publik yang terbuka untuk mutasi; seluruh operasi baca katalog dieksekusi langsung di React Server Components melalui modul query terisolasi, sedangkan seluruh operasi tulis dijalankan melalui Next.js Server Actions (lib/actions/*.ts) dan tiga HTTP Route Handlers (app/api/**) ditambah satu rute pengalihan tautan pendek (/s/[alias]).
flowchart LR
C["Client Components / Browser"] -->|"GET /api/health"| H["Health Handler"]
C -->|"GET/POST /api/auth/*"| A["Auth.js Handler"]
C -->|"POST /api/uploads (multipart)"| U["Upload Handler"]
C -->|"GET /s/[alias] / go.p3mdi.id/[alias]"| S["Shortlink Redirector"]
C -->|"RPC Server Actions"| SA["lib/actions/*.ts"]
SA -->|"Validasi Zod + Guard + Audit + Revalidate"| DB[("PostgreSQL")]
U -->|"Magic Bytes + Sharp WebP + S3/Disk"| ST[("Storage + MediaUpload")]
Mekanisme Domain (proxy.ts): Permintaan ke hostname go.p3mdi.id (atau variabel SHORTLINK_HOSTNAME) selain /_next, /api, /images, /favicon, /s/ akan di-rewrite secara internal menjadi /s/<alias> (sementara / dialihkan ke NEXTAUTH_URL atau https://p3mdi.id).
Logika (app/s/[alias]/page.tsx):
Menormalisasi alias via normalizeAlias(alias) (trim().toLowerCase()).
Mengambil record short_links berdasarkan alias unik.
Jika tidak ditemukan -> merender UI "Tautan tidak ditemukan".
Jika isActive === false -> merender UI "Tautan dinonaktifkan".
Jika aktif -> menaikkan clickCount ({ increment: 1 }) lalu memanggil redirect(shortLink.originalUrl).
Seluruh Server Action menggunakan pola nilai kembalian terstruktur agar Client Component dapat memetakan pesan status dan error per kolom formulir secara konsisten tanpa melempar exception yang tidak tertangani ke UI:
lib/actions/repository-actions.ts
exportinterface ActionResult<T=void> {
ok:boolean;
message?:string;
error?:string;
fieldErrors?:Record<string, string[]>;
data?:T;
}
(Varian identik digunakan oleh AdminActionResult, ShortLinkActionResult, SubmissionActionResult<T>, dan SystemSettingResult; sedangkan loginAction mengembalikan LoginActionState { ok: boolean; error?: string }.)
4. Katalog Lengkap Server Actions (lib/actions/*.ts)
Memanggil signIn("credentials", { username, password, redirectTo: "/admin" }). Mengembalikan pesan khusus untuk RATE_LIMITED atau pesan generik "Username atau kata sandi tidak valid."
logoutAction
() => Promise<void>
Opsional (getOptionalAdmin())
ADMIN_LOGOUT
Menaikkan admins.sessionVersion (increment: 1) lalu memanggil signOut({ redirectTo: "/admin/login" }).
4.2 Pengelolaan Karya Repositori (lib/actions/repository-actions.ts)
Transaksi atomik: pastikan status PENDING, buat slug unik (-1, -2, … bila bentrok), buat Repository berstatus PUBLISHED, perbarui pengajuan menjadi APPROVED
repositoryPublishSchema: Memperluas repositoryDraftSchema dengan superRefine: saat status === PUBLISHED, mewajibkan shortDescription.trim().length >= 10 dan developerName.trim().length >= 2.
Jika pageSize <= 0, menggunakan batas 1000 (dipakai beranda saat mode tanpa batas). Pada sort === "latest", secara otomatis mengangkat karya kategori Formulir (slug = "formulir" atau name = "formulir") yang memiliki deadline antara now hingga now + 72 jam ke urutan teratas, diurutkan dari tenggat terdekat.
listFeaturedRepositories
limit = 8
Mengambil karya dengan isFeatured: true, urut publishedAt DESC, id DESC.
getPublishedRepositoryBySlug
slug: string
Mengambil detail lengkap beserta kategori dan screenshots urut sortOrder ASC; mengembalikan null jika tidak ditemukan atau masih draf.
listCategories
—
Mengambil semua kategori urut nama ASC lengkap dengan repositoryCount karya terpublikasi aktif.
getRelatedRepositories
(currentRepositoryId, categoryId, limit = 4)
Mengambil maksimal 4 karya lain pada kategori yang sama (id !== currentRepositoryId).