Dinas Kepemudaan dan Olahraga Provinsi Kalimantan Selatan
Klasifikasi: Repositori E-Arsip Surat Digital Berbasis Web Responsif - Kerja Praktik TI UNISKA
Live Production: https://www.sipasd.my.id (Mirror: https://sipasd.vercel.app)
Sekretariat Dispora Provinsi Kalimantan Selatan (Jalan Pramuka No. 4 Banjarmasin) menyimpan arsip surat hasil pindaian (scan) pada akun Google Drive arsipdispora2026 (folder sistem magang).
Kondisi eksisting penyimpanan Google Drive:
- Berkas PDF hanya ditumpuk dalam folder
Surat Masuk 2026(171 file) danSurat Keluar 2026(249 file) tanpa metadata terstruktur. - Penamaan file manual acak (contoh:
0973(14 Agustus 2026).pdf,4302(1).pdf,7480-82, 3 surat_20260902_0001.pdf). - Google Drive tidak memiliki filter klasifikasi dinas (Permendagri/Pergub), tidak ada pencatatan riwayat disposisi fisik pimpinan, dan tidak bisa mengekspor buku agenda resmi kedinasan.
- Temu-kembali dokumen memakan waktu 15-30 menit karena staf harus membuka satu per satu file PDF untuk mengetahui isinya.
SIPASD hadir sebagai Katalog Repositori E-Arsip Digital Terindeks. Sistem mengintegrasikan seluruh 420+ arsip riil TA 2026 ke dalam basis data cloud berindeks, memotong waktu temu-kembali dokumen menjadi < 2 detik via peramban HP dan PC.
| Role | Identitas Akun | Peruntukan Jabatan | Hak Akses & Wewenang |
|---|---|---|---|
| Super Admin | pengarsip / developer |
Pemberi Tugas / Developer | Manajemen akun, master klasifikasi surat, konfigurasi sistem, audit trail. |
| Petugas Arsip | tu_umum |
Staf Tata Usaha / Arsiparis | Pengindeksan arsip surat baru, input metadata disposisi fisik, ekspor buku agenda. |
| Pimpinan | kadis / sekretaris |
Kepala Dinas / Sekretaris | Pencarian cepat dokumen, monitoring volume arsip dinas, rekapitulasi agenda. |
| Bidang / Seksi | kabid_pora / subbag_keuangan |
Kepala Bidang / Kasubbag | Pencarian dan pratinjau arsip surat disposisi sesuai bidang tugasnya. |
| Username | Hak Akses Kedinasan | Nama Aparatur | Tingkat Peran (RBAC) | Jabatan Struktural / Fungsional |
|---|---|---|---|---|
pengarsip |
Dikelola Staf TU | Rana Nur Syifa | SUPER_ADMIN | Analis Anggaran - Sekretariat (Pengelola Arsip Digital) |
developer |
Khusus Pengembang | Muhammad Rizki Ramadhani | SUPER_ADMIN | Mahasiswa Magang TI UNISKA (Developer) |
admin |
Administrator IT | Administrator IT Dispora | SUPER_ADMIN | Pranata Komputer Ahli Pertama |
kadis |
Pimpinan Dinas | Pebriadin Hapiz, AP, M.Si | PIMPINAN | Kepala Dinas Kepemudaan dan Olahraga |
tu_umum |
Petugas Kearsipan | Staf Agenda TU Dispora | PETUGAS_ARSIP | Pengadministrasi Persuratan |
subbag_keuangan |
Verifikator Keuangan | Norika Fajriana, SH, MH | BIDANG | Kasubbag Perencanaan & Keuangan |
kabid_pora |
Kepala Bidang Teknis | Budiono, S.Pd, M.AP | BIDANG | Kepala Bidang Pembudayaan Olahraga |
magang_masuk |
Magang Surat Masuk | Anak Magang Surat Masuk | PETUGAS_ARSIP | Staff Magang Persuratan Masuk (Khusus Surat Masuk) |
magang_keluar |
Magang Surat Keluar | Anak Magang Surat Keluar | PETUGAS_ARSIP | Staff Magang Persuratan Keluar (Khusus Surat Keluar) |
Kata sandi setiap akun kedinasan disimpan dalam bentuk salted hash Bcrypt dan dirahasiakan untuk menjaga integritas data kearsipan daerah.
- Mesin pencari cepat berbasis kata kunci: Nomor Surat, Nomor Agenda, Asal/Tujuan Instansi, Perihal, Ringkasan, dan Kode Klasifikasi.
- Filter berdasarkan rentang tanggal surat/diterima dan status sifat surat (Biasa, Penting, Segera, Kilat).
- Nomor surat, tanggal, asal/tujuan instansi, dan perihal diisi dari isi berkas PDF asli (bukan nilai contoh). Rincian metode dan cakupannya ada di
docs/METADATA_DARI_PDF.md.
- Membaca dokumen PDF pindaian langsung di layar peramban tanpa wajib mengunduh file fisik.
- Dukungan mode Split-Screen View pada komputer kerja (tabel metadata di kiri, viewer PDF di kanan).
- Mode kartu responsif dan pratinjau nyaman di layar ponsel pintar (smartphone).
- Mencatat dokumentasi lembar disposisi kertas yang sudah ditandatangani basah pimpinan: pejabat pendisposisi, tanggal disposisi, bidang tujuan, instruksi tertulis, dan catatan khusus.
- Nama pejabat pendisposisi diisi dari isi berkas PDF asli (alamat tujuan dan badan surat), bukan nilai seragam. Rincian metode dan sebarannya ada di
docs/DISPOSISI_DARI_PDF.md. - Fitur cetak ulang salinan Lembar Disposisi standar Pemprov Kalsel.
- Pengelompokan kode klasifikasi dinas standar Permendagri / Pergub Kalsel:
005(Undangan)045(Kearsipan)426(Keolahragaan)427(Kepemudaan)800(Kepegawaian)900(Keuangan)
- Informasi masa retensi aktif dan inaktif dokumen arsip negara.
- Halaman khusus monitoring status penyelesaian disposisi surat: Belum Diproses, Sedang Proses, Selesai.
- Filter status dengan counter live per kategori.
- Search engine multi-kolom: nomor agenda, perihal, instansi, pejabat, bidang tujuan.
- Badge warna status (merah = Belum Diproses, kuning = Proses, hijau = Selesai).
- Pencatatan distribusi pengiriman surat keluar: tanggal kirim, nama kurir pengirim, nama penerima, telepon, catatan.
- Tabel 241 surat keluar TA 2026 dengan modal form "Catat Distribusi".
- Ekspor Buku Ekspedisi ke Excel untuk laporan kedinasan.
- Setiap baris tabel arsip memiliki 5 tombol aksi dokumen: Lihat PDF (streaming CDN), Unduh (unduh langsung file fisik), Disposisi (cetak lembar disposisi), Edit (ubah metadata & disposisi), dan Hapus.
- Modal pengeditan metadata naskah (
EditLetterModal.tsx) terhubung langsung ke endpointPUT /api/lettersdan mutasi TiDB Cloud secara real-time.
- Dropdown tahun fleksibel: Tahun Berjalan (2026, 2025, 2024), Tahun Masa Depan (2027-2200), Rentang Historis (2000-2020, < 2000), dan input kustom bebas.
- Maxx Mode pada ponsel pintar (< 768px) dan iPad/tablet (768px - 1024px) dengan breakpoint drawer 992px, 100vw x 100dvh PDF viewer, dan proteksi 0 overflow horizontal.
- Ekspor rekapitulasi Buku Agenda Surat Masuk dan Surat Keluar ke format spreadsheet Microsoft Excel resmi sesuai format baku laporan pertanggungjawaban dinas.
- 11 kolom standar: No. Agenda, Jenis, Nomor Surat, Tanggal, Asal/Tujuan, Perihal, Sifat, Venue, Bidang, Instruksi Disposisi, Catatan.
- Header hijau Dispora, freeze pane row 1, auto-filter aktif.
- Cloudinary CDN: Storage primer untuk streaming preview PDF instan (signed URL anti-401).
- Google Drive: Backup sekunder via OAuth 2.0 ke folder dinas (Surat Masuk: 420+ file, Surat Keluar: 241 file).
- Retry logic 2x dengan exponential backoff untuk reliability 99%.
- Fallback URL folder jika upload gagal setelah 2 retry.
- Genius Scan Bawaan Peramban: Pengguna dapat memilih banyak foto naskah (JPG/PNG) sekaligus dari kamera HP atau komputer.
- Filter Pemrosesan Kanvas Real-Time: Magic Color (mencerahkan kertas & mempertahankan warna stempel/paraf resmi), Hitam Putih (teks tegas kontras tinggi), dan Foto Asli.
- Navigasi Multi-Halaman & Pangkas Tepi Lipat: Lompat antar lembar halaman, rotasi 90 derajat, slider potong margin yang dapat dilipat (collapsible) hemat ruang, dan pengemasan instan multi-lembar ke 1 berkas PDF A4 terpadu via
pdf-lib.
- Perekaman Fleksibel: Surat masuk maupun surat keluar dapat langsung diindeks dan disimpan tanpa lampiran berkas fisik.
- Lencana Status di Tabel: Surat tanpa lampiran berkas ditandai lencana peringatan warna amber
β οΈ Belum Ada Berkasdi tabel persuratan. - Pratinjau Informatif & Tombol Cepat: Pratinjau surat tanpa berkas menyajikan ajakan ramah dan tombol
Unggah Berkas Sekarang. - Lengkapi Kapan Saja: Melalui modal edit (Ubah Metadata Arsip), berkas PDF atau foto naskah dapat dilampirkan kapan saja; lencana penanda otomatis hilang begitu berkas tersimpan.
- Kolom Posisi Disposisi / Bidang Pemrakarsa: Terletak tepat di tengah antara kolom Asal/Tujuan & Perihal dan kolom Tanggal, menyajikan status disposisi secara visual (
Diterima Persuratan[amber],Kepala Dinas[blue],Selesai[emerald] dilengkapi unit kerja tujuanke: {bidang}). - Format Khusus Surat Keluar: Kolom pertama menampilkan Nomor Surat Keluar resmi lengkap secara tegas (misal
005/11502/DISPORA/2026) dengan subteks nomor slot agenda (Agenda #...), sementara kolom ketiga secara otomatis berganti tajuk menjadiBIDANG PEMRAKARSA. - Kolom Perihal Bersih & Bebas Redundansi: Redundansi nomor surat dan tag bidang di kolom perihal dibersihkan sehingga tabel tampil rapi, proporsional, dan informatif.
- Otorisasi Khusus RBAC: Tombol penambahan kode klasifikasi baru (
+ Tambah Klasifikasi) secara ketat diproteksi hanya dapat diakses oleh akun Developer (developer) dan akun Rana (pengarsip/ Rana Nur Syifa) sebagai Pengelola Arsip Digital. - Penyimpanan Terpusat TiDB Cloud Serverless: Input kode, nama/judul urusan dinas, uraian naskah, dan masa retensi langsung dimutasikan ke tabel
klasifikasi_arsipdengan perlindungan anti-duplikasi kode. - Integrasi Dropdown Indeks Real-Time: Kode klasifikasi baru yang ditambahkan langsung tersinkronisasi ke dropdown formulir perekaman surat baru (
NewLetterModal.tsx) dan penelusuran katalog. - Audit Forensik Keamanan: Setiap penambahan kode klasifikasi tercatat permanen di jejak audit trail forensik sistem.
- Frontend & Fullstack: Next.js 15 (App Router, React 19, TypeScript).
- Styling: Tailwind CSS v4 (Responsif Mobile & PC, 0 Horizontal Overflow).
- Basis Data: TiDB Cloud Serverless (MySQL Compatible, SSL Strict, Gratis 25 GB).
- Penyimpanan Dokumen: Cloudinary CDN (primer untuk streaming pratinjau instan) & Google Drive (sekunder via OAuth 2.0 akun dinas kuota 5 TB, 420 berkas fisik tersimpan 100%).
- Hosting Publik: Vercel Edge Network (HTTPS Otomatis, Domain Resmi https://www.sipasd.my.id).
npm testTest suite verifikasi 6 dimensi:
- TiDB Connection: 170 Surat Masuk, 241 Surat Keluar, 7 Users, 5 Bidang, 6 Klasifikasi
- Cloudinary Signed URL: Anti-401 streaming signature valid
- Code Modular Ratio: Semua 107 files di src/ <= 200 LOC (zero god objects)
- Zero Em-Dash Invariant: 0 em-dash di 179 project files (readability)
- Security Headers: API auth guards aktif di gateway & routes
- Zero Hardcoded Secrets: Semua credentials via env vars
# 1. Master E2E Chrome Audit (11 Modul UI + 6 API Suites)
python scripts/master_chrome_audit.py
# 2. Audit Smart Document Scanner Multi-Foto ke 1 PDF A4
python scripts/audit_e2e_multipage_scanner.py
# 3. Audit Pindai Foto & Akses Dokumen Disposisi Fisik
python scripts/audit_e2e_photo_scan.py
# 4. Audit Berkas Opsional, Lencana Penanda & Alur Edit Berkas
python scripts/audit_e2e_optional_file.py
# 5. Audit Kolom Posisi Disposisi & Nomor Surat Keluar
python scripts/audit_table_columns.py
# 6. Audit Penambahan Master Klasifikasi (RBAC Developer & Rana)
python scripts/audit_e2e_classification.pySeluruh pengujian peramban Google Chrome berjalan otomatis (headless/headed) dengan tingkat kelulusan 100% SUKSES (ALL PASSED) dan 0 console errors.
Tambahkan di Vercel Dashboard β Project Settings β Environment Variables:
# Database
DATABASE_URL="mysql://user:pass@gateway01.ap-southeast-1.prod.aws.tidbcloud.com:4000/sipasd?ssl=true"
# Auth
JWT_SECRET="random-256-bit-secret"
# Cloudinary CDN (PDF Streaming Primer)
CLOUDINARY_CLOUD_NAME="your-cloud-name"
CLOUDINARY_API_KEY="123456789012345"
CLOUDINARY_API_SECRET="AbCdEfGhIjKlMnOpQrStUvWxYz"
# Google Drive OAuth 2.0 (Backup Sekunder)
GOOGLE_CLIENT_ID="402272632756-xxxx.apps.googleusercontent.com"
GOOGLE_CLIENT_SECRET="GOCSPX-xxxxxxxxxxxxx"
GOOGLE_REFRESH_TOKEN="1//0gwBpFFHSqFKICgYIARAAGBASNwF-L9Irnxxx"
GOOGLE_DRIVE_SM_FOLDER_ID="1deTFD7oICTXkkMs5HzS-bhtZzvCqfW9n"
GOOGLE_DRIVE_SK_FOLDER_ID="1rgWCFwULt8awBCVIuomy7cELKqEtbdkx"SIPASD/
βββ docs/
β βββ BAB_1_PENDAHULUAN_DRAFT.md # Naskah Laporan Magang Bab I
β βββ BAB_2_PROFIL_INSTANSI_DRAFT.md# Naskah Laporan Magang Bab II
β βββ BAB_3_ANALISIS_PERANCANGAN_DRAFT.md # Naskah Laporan Magang Bab III
β βββ BAB_4_IMPLEMENTASI_PENGUJIAN_DRAFT.md # Naskah Laporan Magang Bab IV
β βββ BAB_5_PENUTUP_DRAFT.md # Naskah Laporan Magang Bab V
β βββ DAFTAR_PUSTAKA.md # Rujukan Format APA 7th Edition
β βββ DATABASE_SCHEMA.md # Kamus Data & SQL DDL 8 Tabel
β βββ UML_DIAGRAMS.md # Use Case, Activity, Sequence, Class Diagram
β βββ SECURITY_AUDIT.md # Matriks OWASP Top 10 & Validasi PDF
β βββ SOP_KEDINASAN.md # 5 SOP Pengelolaan Arsip Dispora
β βββ SKRIPSI_UPGRADE_ROADMAP.md # Blueprint Skripsi S1 (OCR & Naive Bayes)
β βββ DEPLOYMENT_GUIDE.md # Panduan Deployment Cloud Zero Cost
β βββ IMPORT_MIGRATION_GUIDE.md # Skrip Import 420 Berkas Riil PDF
βββ AGENT.md # Panduan Agen Otonom & Aturan Zero-Slop
βββ SPEC.md # Dokumen Spesifikasi Resmi
βββ task_plan.md # Rencana Kerja Bertahap
βββ findings.md # Analisis Data Riil Google Drive Dispora
βββ progress.md # Log Catatan Kronologis Pengerjaan
βββ README.md # Dokumentasi Utama Ini
Proyek ini dirancang, dibangun, dan dipelihara secara mandiri (100% Solo Project) oleh satu-satunya pengembang:
- Nama Lengkap: Muhammad Rizki Ramadhani
- NPM: 2310010406
- Program Studi: S1 Teknik Informatika, Fakultas Teknologi Informasi
- Perguruan Tinggi: Universitas Islam Kalimantan (UNISKA) Muhammad Arsyad Al Banjari Banjarmasin
- Akun GitHub: @Dhani078
- Email Resmi: dhanisepeda@gmail.com
- Instansi Magang: Sekretariat Dinas Kepemudaan dan Olahraga Provinsi Kalimantan Selatan
- Peran: Lead Software Engineer, System Architect & Sole Contributor
Catatan Integritas Akademik & Repositori: Repositori ini dikembangkan secara individual sebagai produk Kerja Praktik (Magang). Seluruh komit, penulisan kode, perancangan basis data, integrasi cloud, dan naskah dokumentasi dibuat secara mandiri tanpa kontributor lain.
- Nama: Muhammad Rizki Ramadhani
- NPM: 2310010406
- Program Studi: S1 Teknik Informatika - Fakultas Teknologi Informasi
- Perguruan Tinggi: Universitas Islam Kalimantan (UNISKA) MAB Banjarmasin
- Instansi Magang: Sekretariat Dinas Kepemudaan dan Olahraga Provinsi Kalimantan Selatan
- Tahun: 2026