KembaliArsip / superappgov / databasekumuhbangkim

superappgov

databasekumuhbangkim

865 file · 15.1 MB

Sistem informasi live — databasekumuhbangkim.vercel.appBuka di tab baru

README

🏘️ Database Kumuh Bangkim

Sistem Informasi Terpadu untuk Pengelolaan Data Kawasan Permukiman Kumuh Indonesia

Aplikasi web berbasis cloud untuk manajemen dan monitoring data verifikasi dokumen serta delineasi kawasan kumuh yang mencakup 34 provinsi dan 514 kabupaten/kota di seluruh Indonesia. Dikembangkan untuk mendukung program penanganan permukiman kumuh Direktorat Jenderal Perumahan, Kementerian PUPR.

🎯 Tentang Proyek

Latar Belakang

Database Kumuh Bangkim merupakan sistem informasi yang dikembangkan untuk:

Sentralisasi Data: Mengumpulkan dan mengelola data kawasan kumuh dari seluruh Indonesia dalam satu platform terpusat
Monitoring Verifikasi: Memantau kelengkapan dokumen verifikasi (Berita Acara, Matriks, Shapefile)
Analisis Delineasi: Mengelola data luas kawasan kumuh berdasarkan kewenangan (Kabupaten/Kota, Provinsi, Pusat)
Manajemen Dokumentasi: Mengelola surat masuk, surat keluar, nota dinas, dan dokumen administratif lainnya

Cakupan Data

Kategori	Jumlah
Wilayah Administratif	3 Wilayah
Provinsi	34 Provinsi
Kabupaten/Kota	514 Kab/Kota
Data Verifikasi Dokumen	71+ Records
Data Luas Delineasi	21+ Records

✨ Fitur Utama

📊 Dashboard Analytics

Statistik Real-time: Total dokumen, total luas kawasan (Ha), status kelengkapan
Visualisasi Interaktif: 4 chart dinamis (Bar Chart, Pie Chart)
Top 10 Provinsi: Ranking berdasarkan luas kawasan kumuh
Distribusi Kewenangan: Pembagian luas per tingkat kewenangan

📁 Manajemen Data Kategori 1 - Kesesuaian Dokumen

Monitoring status kelengkapan dokumen (BA, Matriks, SHP)
Indikator visual status: ✅ Lengkap, ⚠️ Perlu Perbaikan, ❌ Tidak Ada
Direct link ke Google Drive untuk akses dokumen
Filter berdasarkan wilayah dan provinsi
Export data ke format CSV

📐 Manajemen Data Kategori 2 - Data Luas Kumuh

Data delineasi kawasan kumuh per kabupaten/kota
Pembagian luas berdasarkan kewenangan penanganan
Metode verifikasi (Desk Review / Desk & Survei)
Link peta dan dokumen pendukung
Export data ke format CSV

📝 Sistem Dokumentasi Surat

Manajemen surat masuk dan keluar
Kategorisasi: Surat Masuk, Surat Keluar, Nota Dinas, SK/Keputusan
Pencatatan lengkap: nomor, tanggal, perihal, pengirim/penerima
Integrasi Google Drive untuk penyimpanan dokumen

🔐 Multi-Level Access Control

Role-Based Access Control (RBAC)
Pembatasan akses berdasarkan wilayah
Audit trail aktivitas pengguna

🛠️ Tech Stack

Backend

Technology	Version	Deskripsi
Python	3.9+	Bahasa pemrograman utama
Flask	3.0.0	Micro web framework
Flask-CORS	4.0.0	Cross-Origin Resource Sharing
Flask-JWT-Extended	4.6.0	JWT Authentication
Werkzeug	3.0.1	WSGI utilities

Frontend

Technology	Version	Deskripsi
HTML5/CSS3	-	Struktur dan styling
JavaScript	ES6+	Logic dan interaktivitas
Bootstrap	5.3.2	UI Framework
Bootstrap Icons	1.11.1	Icon library
jQuery	3.7.1	DOM manipulation
DataTables	1.13.7	Advanced table features
Chart.js	4.x	Data visualization

Infrastructure & Deployment

Technology	Deskripsi
Vercel	Serverless deployment platform
Git/GitHub	Version control & collaboration
Google Drive API	Document storage integration

Development Tools

├── IDE: VS Code / PyCharm
├── API Testing: Postman / Thunder Client
├── Version Control: Git
└── Package Manager: pip

🏗️ Arsitektur Sistem

High-Level Architecture

┌─────────────────────────────────────────────────────────────────────┐
│                           CLIENT LAYER                               │
├─────────────────────────────────────────────────────────────────────┤
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐                  │
│  │   Browser   │  │   Mobile    │  │   Tablet    │                  │
│  │  (Desktop)  │  │  (Safari)   │  │  (Chrome)   │                  │
│  └──────┬──────┘  └──────┬──────┘  └──────┬──────┘                  │
│         │                │                │                          │
│         └────────────────┼────────────────┘                          │
│                          │                                           │
│                    HTTPS/TLS 1.3                                     │
└──────────────────────────┼──────────────────────────────────────────┘
                           │
┌──────────────────────────┼──────────────────────────────────────────┐
│                          ▼                                           │
│  ┌─────────────────────────────────────────────────────────────┐    │
│  │                    VERCEL EDGE NETWORK                       │    │
│  │                  (Global CDN & SSL/TLS)                      │    │
│  └─────────────────────────┬───────────────────────────────────┘    │
│                            │                                         │
│           ┌────────────────┴────────────────┐                       │
│           ▼                                 ▼                        │
│  ┌─────────────────┐              ┌─────────────────┐               │
│  │  Static Files   │              │  Serverless     │               │
│  │  (HTML/JS/CSS)  │              │  Functions      │               │
│  │                 │              │  (Python/Flask) │               │
│  │  /public/*      │              │  /api/*         │               │
│  └─────────────────┘              └────────┬────────┘               │
│                                            │                         │
│                           PRESENTATION LAYER                         │
└────────────────────────────────────────────┼────────────────────────┘
                                             │
┌────────────────────────────────────────────┼────────────────────────┐
│                         APPLICATION LAYER   │                        │
│  ┌─────────────────────────────────────────┼───────────────────┐    │
│  │              FLASK APPLICATION          │                    │    │
│  │  ┌──────────────┐  ┌──────────────┐  ┌─┴────────────┐      │    │
│  │  │ Auth Module  │  │ API Routes   │  │ Middleware   │      │    │
│  │  │              │  │              │  │              │      │    │
│  │  │ - Login      │  │ - /wilayah   │  │ - CORS       │      │    │
│  │  │ - Token      │  │ - /provinsi  │  │ - JWT Auth   │      │    │
│  │  │ - Verify     │  │ - /kategori1 │  │ - Logging    │      │    │
│  │  │              │  │ - /kategori2 │  │              │      │    │
│  │  │              │  │ - /dokumen   │  │              │      │    │
│  │  └──────────────┘  └──────────────┘  └──────────────┘      │    │
│  └─────────────────────────────────────────────────────────────┘    │
│                                                                      │
│  ┌─────────────────────────────────────────────────────────────┐    │
│  │                    BUSINESS LOGIC                            │    │
│  │  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐      │    │
│  │  │ Access       │  │ Data         │  │ Report       │      │    │
│  │  │ Control      │  │ Filtering    │  │ Generation   │      │    │
│  │  │              │  │              │  │              │      │    │
│  │  │ - RBAC       │  │ - By Wilayah │  │ - Dashboard  │      │    │
│  │  │ - Wilayah    │  │ - By Province│  │ - Charts     │      │    │
│  │  │ - Permission │  │ - By Status  │  │ - Export CSV │      │    │
│  │  └──────────────┘  └──────────────┘  └──────────────┘      │    │
│  └─────────────────────────────────────────────────────────────┘    │
└─────────────────────────────────────────────────────────────────────┘
                                   │
┌──────────────────────────────────┼──────────────────────────────────┐
│                       DATA LAYER │                                   │
│  ┌───────────────────────────────┼─────────────────────────────┐    │
│  │           IN-MEMORY DATA STORE                               │    │
│  │  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐          │    │
│  │  │   USERS     │  │  WILAYAH    │  │  PROVINSI   │          │    │
│  │  │  (5 admin)  │  │ (3 region)  │  │ (34 prov)   │          │    │
│  │  └─────────────┘  └─────────────┘  └─────────────┘          │    │
│  │  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐          │    │
│  │  │ KATEGORI1   │  │ KATEGORI2   │  │ DOKUMENTASI │          │    │
│  │  │ (71 docs)   │  │ (21 areas)  │  │ (5+ surat)  │          │    │
│  │  └─────────────┘  └─────────────┘  └─────────────┘          │    │
│  └─────────────────────────────────────────────────────────────┘    │
│                                                                      │
│  ┌─────────────────────────────────────────────────────────────┐    │
│  │              EXTERNAL INTEGRATIONS                           │    │
│  │  ┌───────────────────────────────────────────────────┐      │    │
│  │  │              GOOGLE DRIVE                          │      │    │
│  │  │  - Document Storage                                │      │    │
│  │  │  - Shapefile Repository                            │      │    │
│  │  │  - Map Files Storage                               │      │    │
│  │  └───────────────────────────────────────────────────┘      │    │
│  └─────────────────────────────────────────────────────────────┘    │
└─────────────────────────────────────────────────────────────────────┘

Request Flow Diagram

┌────────┐      ┌─────────┐      ┌──────────┐      ┌──────────┐
│ Client │─────▶│  Vercel │─────▶│  Flask   │─────▶│  Data    │
│        │      │  Edge   │      │  API     │      │  Store   │
└────────┘      └─────────┘      └──────────┘      └──────────┘
    │               │                 │                 │
    │   1. Request  │                 │                 │
    │──────────────▶│                 │                 │
    │               │  2. Route       │                 │
    │               │────────────────▶│                 │
    │               │                 │  3. Validate    │
    │               │                 │     Token       │
    │               │                 │────────────────▶│
    │               │                 │  4. Fetch Data  │
    │               │                 │◀────────────────│
    │               │  5. Response    │                 │
    │               │◀────────────────│                 │
    │  6. JSON      │                 │                 │
    │◀──────────────│                 │                 │
    │               │                 │                 │

Directory Structure

databasekumuhbangkim/
│
├── 📁 api/
│   └── 📄 index.py            # Main Flask API (Serverless Function)
│                               # - Authentication endpoints
│                               # - CRUD operations
│                               # - Data filtering logic
│                               # - Business logic
│
├── 📁 public/
│   ├── 📄 index.html          # Single Page Application (SPA)
│   │                          # - Login interface
│   │                          # - Dashboard UI
│   │                          # - Data tables
│   │                          # - Charts & visualizations
│   │
│   └── 📄 app.js              # Frontend Application Logic
│                               # - API communication
│                               # - State management
│                               # - UI interactions
│                               # - Export functionality
│
├── 📄 local_server.py         # Local development server
├── 📄 requirements.txt        # Python dependencies
├── 📄 vercel.json            # Vercel deployment config
├── 📄 .gitignore             # Git ignore rules
└── 📄 README.md              # Project documentation

🔐 Keamanan & Autentikasi

Authentication Flow

┌─────────────────────────────────────────────────────────────────┐
│                    AUTHENTICATION FLOW                           │
└─────────────────────────────────────────────────────────────────┘

  ┌──────────┐                              ┌──────────────────┐
  │  Client  │                              │   Flask Server   │
  └────┬─────┘                              └────────┬─────────┘
       │                                             │
       │  1. POST /api/auth/login                    │
       │     {username, password}                    │
       │────────────────────────────────────────────▶│
       │                                             │
       │                                   ┌─────────┴─────────┐
       │                                   │ 2. Hash password  │
       │                                   │    with SHA-256   │
       │                                   │                   │
       │                                   │ 3. Compare with   │
       │                                   │    stored hash    │
       │                                   │                   │
       │                                   │ 4. Generate token │
       │                                   │    if valid       │
       │                                   └─────────┬─────────┘
       │                                             │
       │  5. Response                                │
       │     {token, user_info, wilayah_akses}       │
       │◀────────────────────────────────────────────│
       │                                             │
       │  6. Store token in localStorage             │
       │                                             │
       │  7. Subsequent requests with                │
       │     Authorization: Bearer <token>           │
       │────────────────────────────────────────────▶│
       │                                             │
       │                                   ┌─────────┴─────────┐
       │                                   │ 8. Verify token   │
       │                                   │    & permissions  │
       │                                   └─────────┬─────────┘
       │                                             │
       │  9. Protected data response                 │
       │◀────────────────────────────────────────────│
       │                                             │

Security Features

1. Password Security

# Password hashing menggunakan SHA-256
import hashlib

def hash_password(password):
    return hashlib.sha256(password.encode()).hexdigest()

# Password tidak pernah disimpan dalam plain text
# Hanya hash yang disimpan dan dibandingkan

2. Token-Based Authentication

Bearer Token: Setiap request API memerlukan token di header
Token Validation: Server memvalidasi token pada setiap request
Session Management: Token disimpan di localStorage browser

3. Role-Based Access Control (RBAC)

Permission	Super Admin	Admin Pusat	Admin Wilayah
View Dashboard	✅	✅	✅
View All Wilayah	✅	✅	❌
View Own Wilayah	✅	✅	✅
CRUD Kategori 1	✅	❌	❌
CRUD Kategori 2	✅	❌	❌
CRUD Dokumentasi	✅	✅	✅ (own)
Export CSV	✅	✅	✅

4. Data Access Control

# Wilayah-based data filtering
WILAYAH_PROVINSI_MAPPING = {
    "1": ["Aceh", "Sumatera Utara", ...],      # Wilayah 1
    "2": ["DKI Jakarta", "Jawa Barat", ...],   # Wilayah 2
    "3": ["Kalimantan Barat", "Papua", ...]    # Wilayah 3
}

# Admin Wilayah hanya dapat mengakses data wilayahnya
def filter_by_user_access(data, user):
    if user.role == "admin_wilayah":
        return [d for d in data if d.wilayah_id == user.wilayah_akses]
    return data

5. Security Headers & CORS

# CORS Configuration
CORS(app, resources={
    r"/api/*": {
        "origins": ["*"],  # Configure for production
        "methods": ["GET", "POST", "PUT", "DELETE"],
        "allow_headers": ["Content-Type", "Authorization"]
    }
})

6. Input Validation

URL validation untuk Google Drive links
Input sanitization untuk mencegah injection
Type checking pada semua API endpoints

Security Best Practices Implemented

Practice	Status	Description
Password Hashing	✅	SHA-256 encryption
Token Authentication	✅	Bearer token pada setiap request
Role-Based Access	✅	3 level akses berbeda
CORS Protection	✅	Configured Flask-CORS
HTTPS Enforcement	✅	Via Vercel SSL/TLS
Input Validation	✅	URL & data validation
Error Handling	✅	Generic error messages

📊 Struktur Database

Entity Relationship Diagram

┌─────────────────────────────────────────────────────────────────────┐
│                    DATABASE SCHEMA (IN-MEMORY)                       │
└─────────────────────────────────────────────────────────────────────┘

┌─────────────────┐       ┌─────────────────┐       ┌─────────────────┐
│     USERS       │       │    WILAYAH      │       │    PROVINSI     │
├─────────────────┤       ├─────────────────┤       ├─────────────────┤
│ username (PK)   │       │ id (PK)         │──┐    │ id (PK)         │
│ password_hash   │       │ kode_wilayah    │  │    │ kode            │
│ nama_lengkap    │       │ nama_wilayah    │  │    │ nama            │
│ role            │       └─────────────────┘  │    │ wilayah_id (FK) │──┐
│ wilayah_akses   │──────────────────────────────┘    └─────────────────┘  │
│ provinsi_akses  │                                                        │
└─────────────────┘                                                        │
                                                                           │
         ┌─────────────────────────────────────────────────────────────────┘
         │
         ▼
┌─────────────────────────┐         ┌─────────────────────────┐
│      KATEGORI1          │         │      KATEGORI2          │
│  (Kesesuaian Dokumen)   │         │   (Data Luas Kumuh)     │
├─────────────────────────┤         ├─────────────────────────┤
│ id (PK)                 │         │ id (PK)                 │
│ wilayah_id (FK)         │         │ wilayah_id (FK)         │
│ provinsi                │         │ provinsi                │
│ kab_kota                │         │ kab_kota                │
│ ba (0/1/2)              │         │ metode                  │
│ matriks (0/1/2)         │         │ total_luas              │
│ shp (0/1/2)             │         │ luas_kab                │
│ link_matriks            │         │ luas_prov               │
│ link_shp                │         │ luas_pusat              │
│ link_ba                 │         │ link_lokasi             │
│ catatan                 │         │ link_peta               │
└─────────────────────────┘         │ link_ba                 │
                                    └─────────────────────────┘

┌─────────────────────────┐
│     DOKUMENTASI         │
│   (Manajemen Surat)     │
├─────────────────────────┤
│ id (PK)                 │
│ wilayah_id (FK)         │
│ kategori                │
│ nomor_surat             │
│ tanggal                 │
│ perihal                 │
│ pengirim                │
│ penerima                │
│ link_dokumen            │
│ keterangan              │
│ created_by              │
│ created_at              │
└─────────────────────────┘

Data Models

Users Collection

USERS = {
    "super_admin": {
        "username": "super_admin",
        "password_hash": "sha256_hash",  # superadmin123
        "nama_lengkap": "Super Administrator",
        "role": "super_admin",
        "wilayah_akses": "ALL",
        "provinsi_akses": None
    },
    "admin_pusat": {
        "username": "admin_pusat",
        "password_hash": "sha256_hash",  # admin123
        "nama_lengkap": "Admin Pusat",
        "role": "admin_pusat",
        "wilayah_akses": "ALL",
        "provinsi_akses": None
    },
    # ... admin_wil1, admin_wil2, admin_wil3
}

Status Values

Value	Status	Icon	Deskripsi
0	Tidak Ada	❌	Dokumen tidak tersedia
1	Perlu Perbaikan	⚠️	Dokumen ada tapi perlu revisi
2	Lengkap/Sesuai	✅	Dokumen lengkap dan sesuai

📡 API Documentation

Base URL

Production: https://your-domain.vercel.app/api
Local:      http://localhost:8000/api

Authentication Endpoints

Login

POST /api/auth/login
Content-Type: application/json

{
    "username": "string",
    "password": "string"
}

Response (200 OK):

{
    "status": "success",
    "token": "generated_token_string",
    "user": {
        "username": "admin_pusat",
        "nama_lengkap": "Admin Pusat",
        "role": "admin_pusat",
        "wilayah_akses": "ALL"
    }
}

Get Current User

GET /api/auth/me
Authorization: Bearer <token>

Data Endpoints

Get Wilayah

GET /api/wilayah
Authorization: Bearer <token>

Response:

{
    "status": "success",
    "data": [
        {"id": 1, "kode_wilayah": "WIL1", "nama_wilayah": "Wilayah 1"},
        {"id": 2, "kode_wilayah": "WIL2", "nama_wilayah": "Wilayah 2"},
        {"id": 3, "kode_wilayah": "WIL3", "nama_wilayah": "Wilayah 3"}
    ]
}

Get Provinsi

GET /api/provinsi?wilayah_id=1
Authorization: Bearer <token>

Get Kategori 1 (Kesesuaian Dokumen)

GET /api/kategori1?wilayah_id=1&provinsi=Aceh
Authorization: Bearer <token>

Response:

{
    "status": "success",
    "data": [
        {
            "id": 1,
            "wilayah_id": 1,
            "provinsi": "Aceh",
            "kab_kota": "Kota Banda Aceh",
            "ba": 2,
            "matriks": 2,
            "shp": 1,
            "link_matriks": "https://drive.google.com/...",
            "link_shp": "https://drive.google.com/...",
            "link_ba": "https://drive.google.com/...",
            "catatan": "Shapefile perlu revisi koordinat"
        }
    ]
}

Get Kategori 2 (Data Luas Kumuh)

GET /api/kategori2?wilayah_id=1
Authorization: Bearer <token>

Response:

{
    "status": "success",
    "data": [
        {
            "id": 1,
            "wilayah_id": 1,
            "provinsi": "Aceh",
            "kab_kota": "Kota Banda Aceh",
            "metode": "Desk & Survei",
            "total_luas": 150.5,
            "luas_kab": 50.0,
            "luas_prov": 45.5,
            "luas_pusat": 55.0,
            "link_lokasi": "https://drive.google.com/...",
            "link_peta": "https://drive.google.com/...",
            "link_ba": "https://drive.google.com/..."
        }
    ]
}

Get Dokumentasi

GET /api/dokumentasi?kategori=Surat%20Masuk
Authorization: Bearer <token>

Dashboard Endpoints

Get Statistics

GET /api/dashboard/stats
Authorization: Bearer <token>

Response:

{
    "status": "success",
    "data": {
        "total_dokumen": 71,
        "total_luas": 3250.75,
        "dokumen_lengkap": 45,
        "total_area": 21
    }
}

Get Chart Data

GET /api/dashboard/chart-data
Authorization: Bearer <token>

CRUD Operations (Super Admin Only)

Create Kategori 1

POST /api/kategori1
Authorization: Bearer <token>
Content-Type: application/json

{
    "wilayah_id": 1,
    "provinsi": "Aceh",
    "kab_kota": "Kota Sabang",
    "ba": 0,
    "matriks": 0,
    "shp": 0,
    "catatan": "Data baru"
}

Update Kategori 1

PUT /api/kategori1/1
Authorization: Bearer <token>
Content-Type: application/json

{
    "ba": 2,
    "link_ba": "https://drive.google.com/..."
}

Delete Kategori 1

DELETE /api/kategori1/1
Authorization: Bearer <token>

Error Responses

// 401 Unauthorized
{
    "status": "error",
    "message": "Token tidak valid atau sudah kadaluarsa"
}

// 403 Forbidden
{
    "status": "error",
    "message": "Anda tidak memiliki akses ke resource ini"
}

// 404 Not Found
{
    "status": "error",
    "message": "Data tidak ditemukan"
}

🚀 Instalasi & Deployment

Prerequisites

Python 3.9 atau lebih tinggi
pip (Python package manager)
Git
Node.js (untuk Vercel CLI, opsional)

Local Development

1. Clone Repository

git clone https://github.com/your-username/databasekumuhbangkim.git
cd databasekumuhbangkim

2. Setup Virtual Environment

# Buat virtual environment
python -m venv venv

# Aktivasi (Linux/Mac)
source venv/bin/activate

# Aktivasi (Windows)
venv\Scripts\activate

3. Install Dependencies

pip install -r requirements.txt

4. Run Local Server

python local_server.py

Server akan berjalan di http://localhost:8000

Production Deployment (Vercel)

1. Install Vercel CLI

npm i -g vercel

2. Login to Vercel

vercel login

3. Deploy

# Deploy to preview
vercel

# Deploy to production
vercel --prod

Configuration Files

vercel.json

{
  "version": 2,
  "builds": [
    {
      "src": "api/index.py",
      "use": "@vercel/python"
    },
    {
      "src": "public/**",
      "use": "@vercel/static"
    }
  ],
  "routes": [
    {
      "src": "/api/(.*)",
      "dest": "/api/index.py"
    },
    {
      "src": "/(.*)",
      "dest": "/public/$1"
    }
  ]
}

requirements.txt

Flask==3.0.0
Flask-CORS==4.0.0
Flask-JWT-Extended==4.6.0
Werkzeug==3.0.1

📖 Penggunaan

Login

Buka aplikasi di browser
Masukkan kredensial sesuai role:

Role	Username	Password
Super Administrator	`super_admin`	`superadmin123`
Admin Pusat	`admin_pusat`	`admin123`
Admin Wilayah 1	`admin_wil1`	`wilayah1`
Admin Wilayah 2	`admin_wil2`	`wilayah2`
Admin Wilayah 3	`admin_wil3`	`wilayah3`

Dashboard

Setelah login, dashboard akan menampilkan:

Statistik overview (total dokumen, luas, kelengkapan)
Chart distribusi data
Quick access ke semua modul

Navigasi Menu

📊 Dashboard       → Overview dan statistik
📁 Kategori 1      → Data kesesuaian dokumen
📐 Kategori 2      → Data luas kawasan kumuh
📝 Dokumentasi     → Manajemen surat dan dokumen
👤 Profile         → Informasi user
🚪 Logout          → Keluar dari sistem

Export Data

Buka halaman data yang ingin di-export
Klik tombol "Export CSV"
File akan otomatis ter-download

👥 Roles & Permissions

Super Administrator

Akses Penuh ke Seluruh Sistem

✅ Lihat semua data (Wilayah 1, 2, 3)
✅ Tambah data baru (Kategori 1 & 2)
✅ Edit data existing
✅ Hapus data
✅ Kelola dokumentasi
✅ Export semua data
✅ Akses dashboard lengkap

Admin Pusat

Akses View ke Seluruh Data

✅ Lihat semua data (Wilayah 1, 2, 3)
❌ Tambah/Edit/Hapus Kategori 1 & 2
✅ Kelola dokumentasi (Pusat)
✅ Export semua data
✅ Akses dashboard lengkap

Admin Wilayah

Akses Terbatas pada Wilayah Sendiri

✅ Lihat data wilayah sendiri saja
❌ Tambah/Edit/Hapus Kategori 1 & 2
✅ Kelola dokumentasi (Wilayah sendiri)
✅ Export data wilayah sendiri
✅ Akses dashboard (filtered)

Permission Matrix

Feature	Super Admin	Admin Pusat	Admin Wil 1	Admin Wil 2	Admin Wil 3
View Wilayah 1	✅	✅	✅	❌	❌
View Wilayah 2	✅	✅	❌	✅	❌
View Wilayah 3	✅	✅	❌	❌	✅
CRUD Kategori 1	✅	❌	❌	❌	❌
CRUD Kategori 2	✅	❌	❌	❌	❌
CRUD Dokumentasi	✅	✅	✅	✅	✅

🗺️ Roadmap Pengembangan

Phase 1: Foundation (Completed ✅)

Phase 2: Data Persistence (Q1 2026)

Migrate to PostgreSQL/Supabase database
Implement data backup & recovery
Add data versioning (audit trail)
Create admin panel for user management
Implement proper session management with refresh tokens

Phase 3: Enhanced Features (Q2 2026)

Advanced filtering & search
Bulk import from Excel/CSV
Automated report generation (PDF)
Email notifications
Data validation rules
Map visualization (Leaflet/Mapbox integration)

Phase 4: Integration & Automation (Q3 2026)

Google Drive API integration (real-time sync)
SSO integration (Google/Microsoft)
Mobile responsive optimization
PWA (Progressive Web App) support
API rate limiting
Webhook notifications

Phase 5: Analytics & AI (Q4 2026)

Advanced analytics dashboard
Trend analysis & predictions
Automated data quality checks
AI-powered document classification
Natural language query interface

Phase 6: Enterprise Features (2027)

Multi-tenant architecture
Custom role creation
Workflow automation
Integration dengan SIMBG/OSS
Open API untuk third-party integration
High availability & disaster recovery

🤝 Contributing

Kami menyambut kontribusi dari semua pihak! Berikut panduan untuk berkontribusi:

Getting Started

Fork repository ini
Clone fork ke local machine
Create branch untuk fitur baru
Commit perubahan dengan pesan yang jelas
Push ke fork
Submit Pull Request

Branch Naming Convention

feature/   → Fitur baru (feature/add-export-pdf)
bugfix/    → Perbaikan bug (bugfix/fix-login-error)
hotfix/    → Perbaikan urgent (hotfix/security-patch)
docs/      → Dokumentasi (docs/update-readme)
refactor/  → Refactoring code (refactor/cleanup-api)

Commit Message Format

type(scope): description

# Examples:
feat(auth): add JWT refresh token
fix(dashboard): correct chart rendering
docs(readme): update installation guide
refactor(api): improve error handling

Code Style Guidelines

Python (Backend):

Follow PEP 8 style guide
Use meaningful variable names
Add docstrings to functions
Handle exceptions appropriately

JavaScript (Frontend):

Use ES6+ syntax
Keep functions small and focused
Comment complex logic
Use consistent naming

Pull Request Process

Update README.md jika ada perubahan interface
Update requirements.txt jika ada dependency baru
Pastikan semua test pass
Request review dari maintainer
Tunggu approval sebelum merge

📄 Lisensi

Proyek ini dilisensikan di bawah MIT License.

MIT License

Copyright (c) 2024 Database Kumuh Bangkim

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

📞 Kontak & Support

Technical Support

Email: support@bangkim.pu.go.id
Issue Tracker: GitHub Issues

Development Team

Lead Developer: Tim IT Bangkim
UI/UX: Tim IT Bangkim
DevOps: Tim IT Bangkim

Useful Links

Documentation: Wiki
API Reference: API Docs
Changelog: CHANGELOG.md

Database Kumuh Bangkim Sistem Informasi Terpadu Pengelolaan Data Kawasan Permukiman Kumuh Indonesia Direktorat Jenderal Perumahan Kementerian Pekerjaan Umum dan Perumahan Rakyat <img src="https://img.shields.io/badge/Made%20with-❤️-red" alt="Made with love"> <img src="https://img.shields.io/badge/Indonesia-🇮🇩-red" alt="Indonesia"> # Vercel-GitHub Integration Test Last verified: 2026-03-26 09:07 UTC # Verified: 2026-03-26 09:10 UTC

File Utama

.SYNC_TEST
.gitignore
ADD_MISSING_ENTRIES.py
ALL_KALBAR_LINKS.json
BATCH_COLLECT.py
COMPLETE_COLLECTION.py
COMPLETE_REMAINING.py
CONTINUE_COLLECTION.py