Skip to content
Dhani078Public

About

Sistem Informasi Pengelolaan Arsip Surat Dispora (SIPASD) Prov. Kalsel - Repositori E-Arsip Digital Terindeks & Dual-Storage TiDB Cloud, Cloudinary CDN & Google Drive 5TB

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

Β 

History

178 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

SIPASD - Sistem Informasi Pengelolaan Arsip Surat Dispora

Dinas Kepemudaan dan Olahraga Provinsi Kalimantan Selatan
Klasifikasi: Repositori E-Arsip Surat Digital Berbasis Web Responsif - Kerja Praktik TI UNISKA

CI Status License: MIT Framework: Next.js 15 Database: TiDB Serverless Storage: Cloudinary & Google Drive Live URL: sipasd.my.id

Live Production: https://www.sipasd.my.id (Mirror: https://sipasd.vercel.app)


πŸ›οΈ Latar Belakang & Masalah Riil Google Drive

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:

  1. Berkas PDF hanya ditumpuk dalam folder Surat Masuk 2026 (171 file) dan Surat Keluar 2026 (249 file) tanpa metadata terstruktur.
  2. Penamaan file manual acak (contoh: 0973(14 Agustus 2026).pdf, 4302(1).pdf, 7480-82, 3 surat_20260902_0001.pdf).
  3. Google Drive tidak memiliki filter klasifikasi dinas (Permendagri/Pergub), tidak ada pencatatan riwayat disposisi fisik pimpinan, dan tidak bisa mengekspor buku agenda resmi kedinasan.
  4. 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.


πŸ‘₯ Matriks Hak Akses Pengguna (RBAC)

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.

Identitas Akun Pengguna

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.


πŸš€ Fitur Utama Sistem E-Arsip

1. Katalog & Pencarian Multi-Filter Instan (< 2 Detik)

  • 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.

2. Built-in In-Browser PDF Streaming Viewer

  • 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).

3. Dokumentasi Riwayat Disposisi Fisik

  • 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.

4. Manajemen Klasifikasi & Jadwal Retensi Arsip (JRA)

  • 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.

5. Riwayat Disposisi Fisik (Status Tracking Real-time)

  • 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).

6. Distribusi Ekspedisi (Buku Ekspedisi Surat Keluar)

  • 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.

7. 5 Tombol Aksi Dokumen Tabel & Fitur Edit Arsip

  • 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 endpoint PUT /api/letters dan mutasi TiDB Cloud secara real-time.

8. Filter Tahun Cerdas & Maxx Mode Responsif

  • 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.

9. Ekspor Buku Agenda Otomatis (Format Excel .xlsx)

  • 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.

10. Backup Otomatis Ganda (Cloudinary + Google Drive)

  • 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.

11. Smart Document Scanner (Pindai Bersih Multi-Foto ke 1 PDF A4)

  • 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.

12. Lampiran Naskah Opsional & Lencana Penanda Khusus

  • 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 Berkas di 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.

13. Struktur Tabel Dinamis: Kolom Posisi Disposisi & Format Nomor Surat Keluar

  • 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 tujuan ke: {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 menjadi BIDANG PEMRAKARSA.
  • Kolom Perihal Bersih & Bebas Redundansi: Redundansi nomor surat dan tag bidang di kolom perihal dibersihkan sehingga tabel tampil rapi, proporsional, dan informatif.

14. Manajemen Master Klasifikasi Arsip (Otorisasi Developer & Akun Rana)

  • 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_arsip dengan 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.

πŸ› οΈ Tumpukan Teknologi (Cloud-Native & Zero Cost)

  • 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).

πŸ§ͺ Testing & Quality Assurance

Unit & Integration Tests

npm test

Test suite verifikasi 6 dimensi:

  1. TiDB Connection: 170 Surat Masuk, 241 Surat Keluar, 7 Users, 5 Bidang, 6 Klasifikasi
  2. Cloudinary Signed URL: Anti-401 streaming signature valid
  3. Code Modular Ratio: Semua 107 files di src/ <= 200 LOC (zero god objects)
  4. Zero Em-Dash Invariant: 0 em-dash di 179 project files (readability)
  5. Security Headers: API auth guards aktif di gateway & routes
  6. Zero Hardcoded Secrets: Semua credentials via env vars

E2E Production & Browser Automation Tests (Google Chrome)

# 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.py

Seluruh pengujian peramban Google Chrome berjalan otomatis (headless/headed) dengan tingkat kelulusan 100% SUKSES (ALL PASSED) dan 0 console errors.


πŸ“‹ Environment Variables (Production)

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"

πŸ“¦ Struktur Repositori

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

πŸ‘¨β€πŸ’» Kontributor & Pengembang Tunggal (Sole Contributor)

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.


πŸ‘€ Informasi Mahasiswa

  • 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

About

Sistem Informasi Pengelolaan Arsip Surat Dispora (SIPASD) Prov. Kalsel - Repositori E-Arsip Digital Terindeks & Dual-Storage TiDB Cloud, Cloudinary CDN & Google Drive 5TB

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages