🏛️ LASMATA - Layanan AspiraSi Masyarakat DesA TembalAe

LASMATA adalah aplikasi web layanan aspirasi masyarakat Desa Tembalae yang memungkinkan warga mengirim laporan berbasis NIK, melihat daftar aspirasi publik, dan memberi ruang bagi admin untuk menindaklanjuti laporan melalui dashboard terproteksi.

---

📋 Deskripsi Aplikasi

LASMATA dibangun dengan Next.js App Router dan server action agar proses pengajuan aspirasi, validasi NIK, penyimpanan laporan, dan manajemen admin berjalan dalam satu sistem yang terpadu. Aplikasi ini memisahkan pengalaman pengguna publik dan admin, tetapi keduanya memakai sumber data yang sama di PostgreSQL melalui Prisma.

🎯 Tujuan Program

• Transparansi: Menyediakan daftar aspirasi publik yang dapat dipantau oleh masyarakat.
• Validasi identitas: Memastikan laporan hanya bisa dikirim dari NIK yang terdaftar dan aktif.
• Pelayanan terstruktur: Membantu admin mengelola laporan, status tindak lanjut, dan data NIK secara rapi.
• Sinkronisasi data: Menjaga perubahan laporan dan NIK langsung tercermin di halaman publik dan dashboard.

✨ Fitur Utama

Untuk Masyarakat

• 📝 Form Aspirasi Online - Pengajuan laporan dengan input NIK, kategori, lokasi, judul, dan isi.
• 🔍 Validasi NIK - NIK dicek sebelum laporan dikirim ke server.
• 📊 Daftar Aspirasi Publik - Pengguna dapat melihat laporan yang sudah masuk.
• 🌓 Mode Tema - Dukungan mode terang dan gelap.

Untuk Administrator

• 🔐 Login Aman - Autentikasi admin menggunakan Better Auth.
• 📊 Dashboard Admin - Ringkasan statistik laporan.
• ✅ Manajemen Laporan - Admin dapat mengubah status laporan menjadi DRAFT, IN_PROGRESS, atau COMPLETED.
• 👥 Manajemen NIK - Admin dapat menambah, mengubah, dan menonaktifkan NIK.
• 🔒 Manajemen Sesi dan Profil - Admin dapat mengelola profil, password, dan sesi login.

🧭 Alur Program

1. Akses Publik

• Pengguna membuka halaman utama LASMATA.
• Halaman utama menampilkan informasi layanan, tombol kirim aspirasi, dan elemen pendukung seperti navigasi, fitur, testimoni, dan FAQ.
• Pengguna juga bisa membuka halaman daftar aspirasi publik untuk melihat laporan yang sudah masuk.

2. Pengajuan Aspirasi

• Pengguna mengisi form aspirasi dengan NIK, kategori, lokasi, judul, dan isi laporan.
• Sistem memvalidasi NIK terlebih dahulu melalui data master NIK.
• Jika NIK valid dan aktif, laporan dikirim ke server.
• Server menjalankan validasi schema, rate limit, dan pengecekan anti-spam sebelum menyimpan data.
• Laporan baru disimpan dengan status DRAFT, lalu halaman publik dan dashboard di-revalidate.

3. Daftar Aspirasi Publik

• Halaman aspirasi publik mengambil data laporan dari server action.
• Data ditampilkan dengan fitur filter, sort, pagination, dan detail laporan.
• Status laporan ditampilkan dalam bahasa pengguna seperti Draft, Diproses, dan Diselesaikan.

4. Login Admin

• Admin membuka halaman login.
• Sistem autentikasi menggunakan Better Auth melalui endpoint /api/auth/[...all].
• Jika login berhasil, pengguna diarahkan ke dashboard admin.
• Proxy/guard route memastikan halaman dashboard hanya bisa diakses saat sesi aktif tersedia.

5. Dashboard Admin

• Dashboard utama menampilkan statistik laporan.
• Admin dapat membuka halaman manajemen laporan untuk mencari, memfilter, dan mengubah status laporan.
• Admin juga dapat membuka halaman manajemen NIK untuk menambah, mengubah, atau menonaktifkan NIK.
• Admin dapat mengelola profil, password, dan sesi login yang aktif.

6. Database dan Sinkronisasi

• Semua data inti tersimpan di PostgreSQL melalui Prisma.
• Perubahan pada laporan, NIK, profil, atau sesi memicu revalidation agar tampilan publik dan dashboard tetap sinkron.

---

🚀 Cara Kerja Platform

flowchart TD
    A[Pengguna buka aplikasi] --> B{Pilih jalur}

    B --> C[Halaman publik]
    B --> D[Login admin]
    B --> E[Lihat daftar aspirasi publik]

    C --> F[Klik Kirim Aspirasi]
    F --> G[Isi form: NIK, kategori, lokasi, judul, isi]
    G --> H[Validasi NIK]
    H --> I{NIK valid dan aktif?}
    I -- Tidak --> J[Tampilkan error validasi]
    J --> G
    I -- Ya --> K[Submit laporan]

    K --> L[Rate limit berdasarkan IP]
    L --> M{Melebihi batas?}
    M -- Ya --> N[Tolak submit dan tampilkan pesan limit]
    M -- Tidak --> O[Validasi schema data]

    O --> P{Data valid?}
    P -- Tidak --> Q[Tolak submit dan tampilkan error]
    P -- Ya --> R[Cek anti-spam berdasarkan NIK]

    R --> S{Aman?}
    S -- Tidak --> T[Tolak submit dan tampilkan pesan spam]
    S -- Ya --> U[Simpan laporan status DRAFT ke database]
    U --> V[Revalidate halaman dashboard dan aspirasi]
    V --> W[Tampilkan sukses ke pengguna]

    E --> X[Ambil laporan publik dari server action]
    X --> Y[Filter, sort, pagination di UI]
    Y --> Z[Lihat detail aspirasi]

    D --> AA[Input email dan password]
    AA --> AB[Autentikasi Better Auth]
    AB --> AC{Login sukses?}
    AC -- Tidak --> AD[Tampilkan error login]
    AC -- Ya --> AE[Masuk dashboard]

    AE --> AF{Akses route dashboard}
    AF --> AG[Proxy cek session]
    AG --> AH{Session ada?}
    AH -- Tidak --> AI[Redirect ke login]
    AH -- Ya --> AJ[Render halaman admin]

    AJ --> AK{Fitur admin}
    AK --> AL[Kelola laporan]
    AK --> AM[Kelola NIK]
    AK --> AN[Kelola profil, password, dan sesi]

    AL --> AO[Ambil daftar laporan]
    AO --> AP[Filter, cari, sort]
    AP --> AQ[Ubah status laporan]
    AQ --> AR[Update database dan revalidate]
    AR --> AS[Perubahan tampil di dashboard dan publik]

    AM --> AT[Ambil data NIK]
    AT --> AU[Tambah, edit, nonaktifkan NIK]
    AU --> AV[Update database dan revalidate]

    AN --> AW[Ambil session aktif]
    AW --> AX[Update profil atau password atau revoke session]
    AX --> AY[Update auth/session di database]

    U --> DB[(PostgreSQL via Prisma)]
    AO --> DB
    AU --> DB
    AY --> DB

Loading

🛠️ Teknologi yang Digunakan

Frontend

• Framework: Next.js 16 (App Router)
• Language: TypeScript
• UI Library: shadcn/ui berbasis Radix UI
• Styling: Tailwind CSS v4
• Animation: Framer Motion
• Icons: Lucide React
• Theme: next-themes
• Notifikasi: Sonner

Backend & Database

• Database: PostgreSQL
• ORM: Prisma v7.4.1
• Auth: Better Auth dengan plugin multi-session dan admin role
• Adapter database: Prisma Adapter untuk Neon
• Validasi: Zod
• Proteksi data: Rate limiter dan spam checker di server action

Development Tools

• Runtime: Node.js
• Package manager: Bun atau npm
• Linting: ESLint 9

---

📊 Schema Database

Struktur database inti LASMATA terdiri dari tabel aspirasi, master NIK, pembatasan permintaan, dan tabel autentikasi Better Auth.

erDiagram
    NIKRecord ||--o{ Report : "mempunyai (1:N)"
    user ||--o{ session : "memiliki (1:N)"
    user ||--o{ account : "memiliki (1:N)"

    NIKRecord {
        String nik PK "16 digit"
        String name "Nama warga"
        Boolean isActive "Status aktif"
        DateTime createdAt
        DateTime updatedAt
    }

    Report {
        String id PK "CUID"
        String nik FK "Relasi ke NIKRecord"
        String title "Judul laporan"
        String category "Kategori aspirasi"
        Location location "Enum lokasi dusun"
        String description "Isi laporan"
        ReportStatus status "DRAFT, IN_PROGRESS, COMPLETED"
        DateTime createdAt
        DateTime updatedAt
    }

    RateLimitRecord {
        String ip PK
        Int attempts "Percobaan"
        DateTime blockedUntil "Opsional"
        DateTime lastAttempt
    }

    user {
        String id PK
        String name
        String email UK "Unik"
        Boolean emailVerified
        String image "Opsional"
        String role "Opsional"
        DateTime createdAt
        DateTime updatedAt
    }

    session {
        String id PK
        String userId FK "Relasi ke user"
        String token UK "Unik"
        DateTime expiresAt
        String ipAddress "Opsional"
        String userAgent "Opsional"
        DateTime createdAt
        DateTime updatedAt
    }

    account {
        String id PK
        String userId FK "Relasi ke user"
        String accountId
        String providerId
        String accessToken "Opsional"
        String refreshToken "Opsional"
        String password "Opsional"
        DateTime createdAt
        DateTime updatedAt
    }

    verification {
        String id PK
        String identifier
        String value "Text"
        DateTime expiresAt
        DateTime createdAt "Opsional"
        DateTime updatedAt "Opsional"
    }

Loading

🚀 Setup & Instalasi Lokal

Prasyarat

• Node.js 20+ atau Bun.
• Database PostgreSQL, disarankan Neon.
• Variabel lingkungan untuk Better Auth dan database.

Langkah Instalasi

1. Clone Repository

   git clone https://github.com/105841109822/LASMATA.git
   cd LASMATA

2. Install Dependencies

   bun install

   Jika memakai npm:

   npm install

3. Setup Environment Variables

   DATABASE_URL="postgresql://[user]:[password]@[host]/[dbname]?sslmode=require"
   BETTER_AUTH_URL="http://localhost:3000"
   BETTER_AUTH_SECRET="ganti-dengan-secret-yang-kuat"
   SEED_ADMIN_EMAIL="admin@desakita.id"
   SEED_ADMIN_PASSWORD="ganti-password-sebelum-seed"
   SEED_ADMIN_NAME="Administrator"

4. Setup Database (Prisma)

   bun run db:generate
   bun run db:migrate
   bun run db:seed

   Jika ingin memakai migrasi production:

   bun run db:migrate:prod

5. Jalankan Development Server

   bun run dev

   Atau dengan npm:

   npm run dev

6. Akses Aplikasi

   • Halaman utama: http://localhost:3000
   • Halaman aspirasi publik: http://localhost:3000/aspirasi
   • Halaman login admin: http://localhost:3000/login

7. Daftar Perintah (Scripts)

   bun run dev             # Menjalankan server lokal
   bun run build           # Generate Prisma client lalu build production
   bun run start           # Menjalankan aplikasi production
   bun run lint            # Menjalankan ESLint
   bun run db:generate     # Meng-generate Prisma Client
   bun run db:migrate      # Menjalankan migrasi database
   bun run db:migrate:prod # Menjalankan migrasi production
   bun run db:seed         # Menjalankan seed admin, NIK, dan laporan contoh
   bun run db:studio       # Membuka Prisma Studio

🤝 Kepemilikan & Pengembangan

Proyek LASMATA (Layanan Aspirasi Masyarakat Desa Tembalae) ini dikembangkan oleh:

Dayang Aisyah, Wa Nanda Sulystrian, M. Ray Togubu & Baso Hamzah - Universitas Muhammadiyah Makassar

Produk ini diajukan untuk memenuhi persyaratan Product/project Tugas Kampus.