diff --git a/.gitignore b/.gitignore index 6223a08f..2135c4ff 100644 --- a/.gitignore +++ b/.gitignore @@ -55,3 +55,6 @@ next-env.d.ts *.tar.gz +# local scripts +ai.sh + diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 00000000..27588678 --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1,116 @@ +# CLAUDE.md + +This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository. + +## Project Overview + +Desa Darmasaba is a full-stack digital village management platform for a village in Badung, Bali. It serves both a public-facing website (`/darmasaba/*`) and an admin CMS (`/admin/*`). + +## Commands + +```bash +# Development +bun run dev # Start dev server (port 3000) +bun run build # Production build +bun run tsc --noEmit # Type-check only + +# Testing +bun run test # All tests +bun run test:api # Unit tests (Vitest) +bun run test:e2e # E2E tests (Playwright) + +# Database +bunx prisma migrate deploy # Apply migrations +bunx prisma migrate dev --name # Create migration +bun run prisma/seed.ts # Seed database +bunx prisma studio # Interactive DB viewer + +# Linting +bun eslint . --fix +``` + +## Architecture + +### Tech Stack +- **Framework**: Next.js 15 (App Router) + React 19 +- **Runtime/Package manager**: Bun (not npm) +- **API server**: Elysia.js (mounted at `/api/[[...slugs]]`) +- **ORM**: Prisma + PostgreSQL +- **UI**: Mantine UI v7-8 +- **State**: Jotai (atoms), Valtio (proxies), SWR (data fetching) +- **Auth**: iron-session + JWT +- **File storage**: Local uploads + Seafile (self-hosted) + +### Request Flow + +``` +Browser → Next.js middleware (src/middleware.ts) + → Public pages: src/app/darmasaba/ + → Admin pages: src/app/admin/ + → API: src/app/api/[[...slugs]]/route.ts (Elysia.js) + └── _lib/*.ts (domain modules) +``` + +The Elysia server is a single entry point with domain-specific modules: `desa.ts`, `kesehatan.ts`, `ekonomi.ts`, `keamanan.ts`, `lingkungan.ts`, `pendidikan.ts`, `kependudukan.ts`, `ppid.ts`, `inovasi.ts`, `auth/`, `user/`, `fileStorage/`. Swagger docs are auto-generated at `/api/docs`. + +### Domain Modules +Each domain (desa, kesehatan, ekonomi, etc.) has: +- API handler in `src/app/api/[[...slugs]]/_lib/.ts` +- Admin CMS pages in `src/app/admin/(dashboard)//` +- Public pages in `src/app/darmasaba/(pages)//` + +### Database (Prisma) +- Schema at `prisma/schema.prisma` (~2400 lines, 100+ models) +- Common model conventions: `@default(cuid())` IDs, `createdAt`/`updatedAt` timestamps, `deletedAt DateTime?` (soft delete), `isActive Boolean @default(true)` +- Seeders per-module in `prisma/_seeder_list/`, orchestrated by `prisma/seed.ts` + +### Authentication Flow +1. User submits phone → OTP sent (email/SMS) +2. OTP validated → JWT created + iron-session stored +3. `UserSession` model tracks active sessions +4. `src/middleware.ts` validates on each request +5. `src/lib/api-auth.ts` handles JWT/session checks in API routes + +### File Handling +All uploaded files reference the `FileStorage` Prisma model. Uploads land in `WIBU_UPLOAD_DIR` (default: `uploads/`). Seafile is the external storage fallback. + +## Key Files + +| File | Purpose | +|------|---------| +| `src/middleware.ts` | Route guards and auth | +| `src/lib/prisma.ts` | Prisma client singleton | +| `src/lib/api-auth.ts` | JWT/session validation | +| `src/lib/api-fetch.ts` | Typed fetch wrapper used by frontend | +| `src/lib/session.ts` | iron-session config | +| `next.config.ts` | Next.js config (cache headers, allowed origins) | +| `postcss.config.cjs` | Mantine CSS preset and breakpoints | +| `docker-entrypoint.sh` | Runs `prisma migrate deploy` then starts app | + +## Environment Variables + +Copy `.env.example` to `.env`. Required variables: + +```env +DATABASE_URL="postgresql://..." +NEXT_PUBLIC_BASE_URL="/" +BASE_SESSION_KEY="..." # random string +BASE_TOKEN_KEY="..." # random string +SESSION_PASSWORD="..." # min 32 chars +SEAFILE_TOKEN="..." +SEAFILE_REPO_ID="..." +SEAFILE_URL="..." +``` + +## Docker + +Multi-stage build: `oven/bun:1-debian` → builder → runner. The runner creates a `nextjs` user (UID 1001), exposes port 3000, and mounts `/app/uploads` as a volume. Entrypoint runs migrations automatically. + +## CI/CD + +GitHub Actions workflows in `.github/workflows/`: +- `docker-publish.yml` — triggers on `v*` tags, pushes to GHCR +- `publish.yml` — manual build & push +- `re-pull.yml` — triggers Portainer to redeploy latest image + +To release: tag with `git tag -a v0.1.x -m "..."` and push the tag. diff --git a/MIND/PLAN/umkm-module.md b/MIND/PLAN/umkm-module.md new file mode 100644 index 00000000..d05bcb23 --- /dev/null +++ b/MIND/PLAN/umkm-module.md @@ -0,0 +1,24 @@ +# Plan: UMKM Module Implementation + +## Goal +Implement UMKM, ProdukUmkm, and PenjualanProduk module with CRUD API and Dashboard analytics. + +## Steps +1. Update Prisma Schema (already done in file). +2. Run database migration and seed data. +3. Implement UMKM CRUD API. +4. Implement ProdukUmkm CRUD API. +5. Implement PenjualanProduk CRUD API. +6. Implement Dashboard API (KPI, Summary, Top Produk, Detail Penjualan). +7. Register all routers in the ekonomi module. +8. Verify with type check and build. + +## Progress +- [x] Step 1: Update Prisma Schema +- [x] Step 2: Run database migration +- [x] Step 3: Implement UMKM CRUD API +- [x] Step 4: Implement ProdukUmkm CRUD API +- [x] Step 5: Implement PenjualanProduk CRUD API +- [x] Step 6: Implement Dashboard API +- [x] Step 7: Register routers +- [x] Step 8: Verify changes diff --git a/MIND/SUMMARY/umkm-module-summary.md b/MIND/SUMMARY/umkm-module-summary.md new file mode 100644 index 00000000..c0ea2321 --- /dev/null +++ b/MIND/SUMMARY/umkm-module-summary.md @@ -0,0 +1,28 @@ +# Summary: UMKM Module Implementation + +## Accomplishments +- Successfully migrated the database to include `Umkm`, `ProdukUmkm`, and `PenjualanProduk` tables. +- Implemented a complete set of CRUD API endpoints for UMKM, Products, and Sales. +- Developed a comprehensive Dashboard API providing KPIs, sales summaries, top products, and detailed stock analytics. +- Integrated the new module into the existing `ekonomi` router. +- Verified the implementation with `tsc` to ensure type safety. + +## Files Created/Modified +### Modified +- `prisma/schema.prisma`: Added relations and models. +- `src/app/api/[[...slugs]]/_lib/ekonomi/index.ts`: Registered new routers. + +### Created +- `src/app/api/[[...slugs]]/_lib/ekonomi/umkm/`: CRUD for UMKM. +- `src/app/api/[[...slugs]]/_lib/ekonomi/umkm/produk/`: CRUD for Products. +- `src/app/api/[[...slugs]]/_lib/ekonomi/umkm/penjualan/`: CRUD for Sales with stock management. +- `src/app/api/[[...slugs]]/_lib/ekonomi/umkm/dashboard/`: Analytics endpoints. + +## Stock Management Logic +- Creating a sale decrements product stock. +- Updating a sale adjusts stock based on the difference in quantity. +- Deleting a sale increments stock back. + +## Next Steps +- Implement frontend UI for the UMKM module. +- Add more comprehensive tests for the stock management logic. diff --git a/STRUKTUR-PROJEK.md b/STRUKTUR-PROJEK.md new file mode 100644 index 00000000..4c57b1a2 --- /dev/null +++ b/STRUKTUR-PROJEK.md @@ -0,0 +1,678 @@ +# Dokumentasi Struktur Proyek - Desa Darmasaba + +## 1. Ringkasan Proyek + +**Desa Darmasaba** adalah aplikasi web komprehensif untuk layanan pemerintahan desa di Desa Darmasaba, Kabupaten Badung, Bali. Aplikasi ini berfungsi sebagai platform digital untuk layanan pemerintah, informasi publik, dan keterlibatan masyarakat. + +### Tech Stack + +| Kategori | Teknologi | +|----------|-----------| +| **Framework Frontend** | Next.js 15 dengan App Router | +| **Bahasa** | TypeScript (strict mode) | +| **Styling** | Mantine UI v7/v8 + Custom CSS | +| **Backend API** | Elysia.js (high-performance TypeScript framework) | +| **Database** | PostgreSQL | +| **ORM** | Prisma 6.3.1 | +| **Runtime** | Bun | +| **State Management** | Jotai + Valtio + SWR | +| **Autentikasi** | iron-session + JWT | +| **File Storage** | Seafile | +| **Rich Text Editor** | TipTap | +| **Charts** | Recharts + Chart.js | +| **Maps** | Leaflet + react-leaflet | +| **UI Components** | Mantine, PrimeReact, Framer Motion | +| **Validasi** | Zod | +| **Testing** | Vitest (unit), Playwright (E2E) | +| **Deployment** | Docker + GitHub Actions + Portainer | +| **Registry** | GitHub Container Registry (GHCR) | + +--- + +## 2. Struktur Direktori + +``` +desa-darmasaba/ +├── .github/workflows/ # GitHub Actions CI/CD +│ ├── docker-publish.yml # Auto build & push saat tag v* +│ ├── publish.yml # Manual build & push ke GHCR +│ ├── re-pull.yml # Manual re-pull image di Portainer +│ └── script/ # Script deployment +│ +├── prisma/ +│ ├── schema.prisma # Database schema (2413 baris, 100+ model) +│ ├── seed.ts # Database seeder utama +│ └── _seeder_list/ # Data seed per modul +│ ├── desa/ # Seed berita, gallery, layanan, dll +│ ├── ekonomi/ # Seed APBDes, demografi, dll +│ ├── inovasi/ # Seed ide inovatif, desa digital +│ ├── keamanan/ # Seed keamanan, kontak darurat +│ ├── kesehatan/ # Seed fasilitas kesehatan, posyandu +│ ├── kependudukan/ # Seed data penduduk +│ ├── lingkungan/ # Seed lingkungan desa +│ ├── pendidikan/ # Seed sekolah, beasiswa +│ ├── ppid/ # Seed PPID +│ └── landing-page/ # Seed landing page +│ +├── src/ +│ ├── app/ # Next.js App Router +│ │ ├── _com/ # Komponen global (SplashScreen, WebVitals) +│ │ ├── admin/ # Panel administrasi (protected) +│ │ │ ├── _com/ # Komponen admin shared +│ │ │ ├── (dashboard)/ # Dashboard admin dengan route groups +│ │ │ │ ├── _com/ # Komponen dashboard shared +│ │ │ │ ├── _state/ # State khusus dashboard +│ │ │ │ ├── _utils/ # Utilitas dashboard +│ │ │ │ ├── auth/ # Autentikasi admin +│ │ │ │ ├── desa/ # Admin: berita, gallery, profil, layanan +│ │ │ │ ├── ekonomi/ # Admin: APBDes, demografi, BUMDes +│ │ │ │ ├── inovasi/ # Admin: ide inovatif, desa digital +│ │ │ │ ├── keamanan/ # Admin: keamanan, kontak darurat +│ │ │ │ ├── kependudukan/# Admin: banjar, agama, umur, migrasi +│ │ │ │ ├── kesehatan/ # Admin: puskesmas, posyandu, wabah +│ │ │ │ ├── landing-page/# Admin: konten landing page +│ │ │ │ ├── lingkungan/ # Admin: konservasi, sampah, penghijauan +│ │ │ │ ├── musik/ # Admin: musik desa +│ │ │ │ ├── pendidikan/ # Admin: sekolah, beasiswa, perpustakaan +│ │ │ │ ├── ppid/ # Admin: PPID, IKM, permohonan +│ │ │ │ └── user&role/ # Admin: manajemen user & role +│ │ │ ├── auth/ # Halaman login admin +│ │ │ ├── csv/ # Upload/demo CSV +│ │ │ ├── images/ # Manajemen gambar +│ │ │ └── upload-demo/ # Demo upload +│ │ │ +│ │ ├── api/ # API routes (Elysia.js) +│ │ │ ├── [[...slugs]]/ # Catch-all route untuk Elysia +│ │ │ │ ├── _lib/ # Modul API per domain +│ │ │ │ │ ├── auth/ # Autentikasi API +│ │ │ │ │ ├── desa/ # API modul desa +│ │ │ │ │ ├── ekonomi/ # API modul ekonomi +│ │ │ │ │ ├── fileStorage/ # API file storage +│ │ │ │ │ ├── inovasi/ # API modul inovasi +│ │ │ │ │ ├── keamanan/# API modul keamanan +│ │ │ │ │ ├── kependudukan/ # API modul kependudukan +│ │ │ │ │ ├── kesehatan/ # API modul kesehatan +│ │ │ │ │ ├── landing_page/ # API landing page +│ │ │ │ │ ├── lingkungan/ # API modul lingkungan +│ │ │ │ │ ├── pendidikan/ # API modul pendidikan +│ │ │ │ │ ├── ppid/ # API modul PPID +│ │ │ │ │ ├── search/ # API pencarian global +│ │ │ │ │ └── user/ # API user management +│ │ │ │ └── route.ts # Entry point Elysia server +│ │ │ ├── admin/ # API khusus admin +│ │ │ ├── auth/ # API autentikasi +│ │ │ ├── health/ # Health check endpoint +│ │ │ ├── layout/ # API layout +│ │ │ ├── news/ # API berita +│ │ │ ├── subscribe/ # API subscription (email) +│ │ │ └── tts/ # Text-to-Speech (ElevenLabs) +│ │ │ +│ │ ├── context/ # React contexts +│ │ │ └── MusicContext.tsx # Context untuk pemutar musik +│ │ │ +│ │ ├── darmasaba/ # Halaman publik (front-facing) +│ │ │ ├── _com/ # Komponen shared publik +│ │ │ │ ├── main-page/ # Komponen halaman utama +│ │ │ │ ├── Navbar.tsx # Navigasi utama +│ │ │ │ ├── Footer.tsx # Footer +│ │ │ │ ├── FixedPlayerBar.tsx # Music player bar +│ │ │ │ ├── LoadDataFirstClient.tsx # Data prefetching +│ │ │ │ ├── NewsReader.tsx # Component pembaca berita +│ │ │ │ ├── globalSearch.tsx # Pencarian global +│ │ │ │ └── scrollToTopButton.tsx +│ │ │ ├── (pages)/ # Halaman publik utama +│ │ │ │ ├── desa/ # Halaman: profil, berita, gallery, layanan +│ │ │ │ ├── ekonomi/ # Halaman: APBDes, BUMDes, demografi +│ │ │ │ ├── inovasi/ # Halaman: inovasi desa +│ │ │ │ ├── keamanan/ # Halaman: keamanan lingkungan +│ │ │ │ ├── kependudukan/# Halaman: data penduduk +│ │ │ │ ├── kesehatan/ # Halaman: fasilitas kesehatan +│ │ │ │ ├── lingkungan/ # Halaman: lingkungan desa +│ │ │ │ ├── module/ # Halaman modul tambahan +│ │ │ │ ├── musik/ # Halaman: musik desa +│ │ │ │ ├── pendidikan/ # Halaman: pendidikan +│ │ │ │ └── ppid/ # Halaman: PPID publik +│ │ │ ├── (tambahan)/ # Halaman tambahan +│ │ │ ├── layout.tsx # Layout utama publik +│ │ │ └── page.tsx # Landing page utama +│ │ │ +│ │ ├── login/ # Halaman login +│ │ ├── registrasi/ # Halaman registrasi +│ │ ├── waiting-room/ # Halaman waiting room +│ │ ├── terms-of-service/ # Halaman syarat layanan +│ │ ├── test-upload/ # Halaman tes upload +│ │ ├── validasi/ # Halaman validasi +│ │ ├── coba/ # Halaman percobaan +│ │ ├── percobaan/ # Halaman percobaan lainnya +│ │ ├── layout.tsx # Root layout (MantineProvider) +│ │ ├── page.tsx # Root page +│ │ ├── error.tsx # Error boundary +│ │ ├── not-found.tsx # 404 page +│ │ ├── globals.css # Global styles +│ │ └── favicon.ico +│ │ +│ ├── components/ +│ │ └── admin/ # Komponen admin reusable +│ │ ├── AdminThemeProvider.tsx +│ │ ├── DarkModeToggle.tsx +│ │ ├── UnifiedSurface.tsx +│ │ └── UnifiedTypography.tsx +│ │ +│ ├── con/ # Constants & konfigurasi +│ │ └── colors.ts # Palet warna +│ │ +│ ├── lib/ # Utility functions +│ │ ├── router/ # Router utilities +│ │ ├── api-auth.ts # Autentikasi API +│ │ ├── api-fetch.ts # Helper fetch API +│ │ ├── EnvStringParse.ts # Parser environment variables +│ │ ├── prisma.ts # Prisma client instance +│ │ ├── seafile-auth-service.ts # Integrasi Seafile +│ │ └── session.ts # iron-session helper +│ │ +│ ├── middlewares/ # Next.js middleware +│ ├── state/ # Global state (Jotai/Valtio) +│ │ ├── darkModeStore.ts # State dark mode +│ │ ├── state-layanan.ts # State layanan +│ │ ├── state-list-image.ts # State daftar gambar +│ │ └── state-nav.ts # State navigasi +│ │ +│ ├── store/ # State management tambahan +│ └── types/ # TypeScript type definitions +│ +├── public/ # Static assets +│ └── assets/ # Gambar, icon, dll +│ +├── uploads/ # Directory upload (runtime) +│ └── image/ # Upload gambar +│ +├── .env.example # Contoh environment variables +├── .gitignore +├── AGENTS.md # Panduan untuk AI coding agents +├── Dockerfile # Docker image definition +├── docker-entrypoint.sh # Entry point container +├── next.config.ts # Next.js configuration +├── package.json # Dependencies & scripts +├── tsconfig.json # TypeScript configuration +├── biome.json # Biome linter config +├── eslint.config.mjs # ESLint config +├── NOTE.md # Catatan deployment +└── QWEN.md # Konteks & memori proyek +``` + +--- + +## 3. Arsitektur Aplikasi + +### 3.1 Arsitektur Keseluruhan + +``` +┌─────────────────────────────────────────────────────────┐ +│ Client (Browser) │ +└────────────┬────────────────────────────┬────────────────┘ + │ │ + │ Next.js Pages │ API Calls + │ (SSR/CSR) │ + ▼ ▼ +┌────────────────────────┐ ┌────────────────────────────┐ +│ Next.js 15 App Router│ │ Elysia.js API Server │ +│ - Pages publik │ │ - RESTful endpoints │ +│ - Admin dashboard │ │ - File upload │ +│ - Server components │ │ - Swagger docs (/api/docs│ +│ - Client components │ │ - Static file serving │ +└────────────┬───────────┘ └────────────┬───────────────┘ + │ │ + │ │ + ▼ ▼ +┌─────────────────────────────────────────────────────────┐ +│ PostgreSQL Database │ +│ (via Prisma ORM) │ +└─────────────────────────────────────────────────────────┘ + │ + ▼ +┌─────────────────────────────────────────────────────────┐ +│ Seafile File Storage │ +│ (Images & Documents) │ +└─────────────────────────────────────────────────────────┘ +``` + +### 3.2 Next.js App Router + +- Menggunakan **App Router** (bukan Pages Router) +- Route groups `(dashboard)`, `(pages)`, `(tambahan)` untuk organisasi tanpa mempengaruhi URL +- Layout bersarang: root layout -> admin/darmasaba layout -> page layouts +- `force-dynamic` digunakan untuk menghindari error prerendering +- View Transitions API diaktifkan via `next-view-transitions` + +### 3.3 Elysia.js API Server + +- Terintegrasi sebagai **catch-all route** di `/api/[[...slugs]]/route.ts` +- Semua HTTP methods (GET, POST, PATCH, DELETE, PUT) di-handle oleh Elysia +- Plugin yang digunakan: + - `@elysiajs/cors` - CORS configuration + - `@elysiajs/static` - Static file serving dari `/uploads` + - `@elysiajs/swagger` - API documentation di `/api/docs` + - `@elysiajs/jwt` - JWT authentication + - `@elysiajs/cookie` - Cookie handling +- Endpoint file upload: `/api/upl-img`, `/api/upl-img-single`, `/api/upl-csv` +- Image serving: `/api/img/:name` dengan resize support + +### 3.4 Rendering Strategy + +- **Server Components**: Halaman publik untuk SEO optimal +- **Client Components**: Komponen interaktif (form, state, animasi) +- **Force Dynamic**: Beberapa halaman menggunakan `force-dynamic` +- **ISR**: Caching header untuk assets (1 jam cache) + +--- + +## 4. Modul Domain + +### 4.1 Profil Desa (Desa) +**Admin**: `/admin/desa/*` | **Publik**: `/darmasaba/desa/*` + +| Sub-modul | Fungsi | +|-----------|--------| +| `berita` | CRUD berita/pengumuman desa | +| `gallery` | Galeri foto dan video | +| `layanan` | Manajemen layanan desa | +| `penghargaan` | Penghargaan yang diraih | +| `pengumuman` | Pengumuman publik | +| `potensi` | Potensi desa (pertanian, pariwisata, dll) | +| `profil` | Profil desa (sejarah, visi misi, lambang, maskot, perangkat) | + +### 4.2 PPID (Pejabat Pengelola Informasi dan Dokumentasi) +**Admin**: `/admin/ppid/*` | **Publik**: `/darmasaba/ppid/*` + +| Sub-modul | Fungsi | +|-----------|--------| +| `profil-ppid` | Profil pejabat PPID | +| `struktur-ppid` | Struktur organisasi PPID | +| `visi-misi-ppid` | Visi dan misi PPID | +| `daftar-informasi-publik` | Daftar informasi yang tersedia | +| `dasar-hukum` | Dasar hukum PPID | +| `permohonan-informasi-publik` | Form permohonan informasi | +| `permohonan-keberatan-informasi-publik` | Form keberatan | +| `indeks-kepuasan-masyarakat` | Survei kepuasan masyarakat (IKM) | + +### 4.3 Kesehatan +**Admin**: `/admin/kesehatan/*` | **Publik**: `/darmasaba/kesehatan/*` + +| Sub-modul | Fungsi | +|-----------|--------| +| `fasilitas-kesehatan` | Data puskesmas, klinik, dokter | +| `posyandu` | Manajemen posyandu | +| `program-kesehatan` | Program kesehatan desa | +| `info-wabah-penyakit` | Informasi wabah | +| `penanganan-darurat` | Prosedur penanganan darurat | +| `kontak-darurat` | Kontak darurat kesehatan | +| `data-kesehatan-warga` | Statistik kesehatan warga | +| `artikel-kesehatan` | Artikel kesehatan | + +### 4.4 Ekonomi +**Admin**: `/admin/ekonomi/*` | **Publik**: `/darmasaba/ekonomi/*` + +| Sub-modul | Fungsi | +|-----------|--------| +| `APBDes` | Anggaran Pendapatan dan Belanja Desa (hierarki items + realisasi) | +| `PADesa-pendapatan-asli-desa` | Pendapatan asli desa | +| `demografi-pekerjaan` | Demografi pekerjaan penduduk | +| `jumlah-penduduk-miskin` | Data penduduk miskin | +| `jumlah-pengangguran` | Data pengangguran | +| `lowongan-kerja-lokal` | Lowongan kerja lokal | +| `pasar-desa` | Data pasar desa | +| `program-kemiskinan` | Program penanganan kemiskinan | +| `sektor-unggulan-desa` | Sektor unggulan ekonomi | +| `Struktur-Organisasi-Dan-Sk-Pengurus-BumDes` | Struktur BUMDes | + +### 4.5 Kependudukan +**Admin**: `/admin/kependudukan/*` | **Publik**: `/darmasaba/kependudukan/*` + +| Sub-modul | Fungsi | +|-----------|--------| +| `data-banjar` | Data banjar (unit wilayah tradisional Bali) | +| `distribusi-agama` | Distribusi agama penduduk | +| `distribusi-umur` | Distribusi umur penduduk | +| `migrasi-penduduk` | Data migrasi (masuk/keluar) | + +### 4.6 Pendidikan +**Admin**: `/admin/pendidikan/*` | **Publik**: `/darmasaba/pendidikan/*` + +| Sub-modul | Fungsi | +|-----------|--------| +| `beasiswa-desa` | Program beasiswa | +| `bimbingan-belajar-desa` | Bimbingan belajar | +| `data-pendidikan` | Data statistik pendidikan | +| `info-sekolah` | Informasi sekolah | +| `pendidikan-non-formal` | Pendidikan non-formal | +| `perpustakaan-digital` | Perpustakaan digital | +| `program-pendidikan-anak` | Program pendidikan anak | + +### 4.7 Keamanan +**Admin**: `/admin/keamanan/*` | **Publik**: `/darmasaba/keamanan/*` + +| Sub-modul | Fungsi | +|-----------|--------| +| `keamanan-lingkungan-pecalang-patwal` | Keamanan lingkungan (pecalang Bali) | +| `kontak-darurat` | Kontak darurat keamanan | +| `laporan-publik` | Laporan publik | +| `pencegahan-kriminalitas` | Pencegahan kriminalitas | +| `polsek-terdekat` | Data polsek terdekat | +| `tips-keamanan` | Tips keamanan | + +### 4.8 Lingkungan +**Admin**: `/admin/lingkungan/*` | **Publik**: `/darmasaba/lingkungan/*` + +| Sub-modul | Fungsi | +|-----------|--------| +| `data-lingkungan-desa` | Data lingkungan desa | +| `edukasi-lingkungan` | Edukasi lingkungan | +| `gotong-royong` | Kegiatan gotong royong | +| `konservasi-adat-bali` | Konservasi adat Bali | +| `pengelolaan-sampah-bank-sampah` | Bank sampah | +| `program-penghijauan` | Program penghijauan | + +### 4.9 Inovasi +**Admin**: `/admin/inovasi/*` | **Publik**: `/darmasaba/inovasi/*` + +| Sub-modul | Fungsi | +|-----------|--------| +| `ajukan-ide-inovatif` | Form pengajuan ide inovatif | +| `desa-digital-smart-village` | Program desa digital | +| `info-teknologi-tepat-guna` | Info teknologi tepat guna | +| `kolaborasi-inovasi` | Kolaborasi inovasi | +| `layanan-online-desa` | Layanan online desa | +| `program-kreatif-desa` | Program kreatif desa | + +### 4.10 Musik Desa +**Admin**: `/admin/musik/*` | **Publik**: `/darmasaba/musik/*` + +- Manajemen audio dan cover musik desa +- Fixed player bar di halaman publik +- Context provider untuk state pemutar musik + +### 4.11 Landing Page +**Admin**: `/admin/landing-page/*` + +| Sub-modul | Fungsi | +|-----------|--------| +| `desa-anti-korupsi` | Konten anti-korupsi | +| `prestasi-desa` | Prestasi yang diraih | +| `sdgs-desa` | SDGs (Sustainable Development Goals) | +| `profil-landing-page` | Profil dan media sosial | + +### 4.12 User & Role +**Admin**: `/admin/user&role/*` + +- Manajemen pengguna admin +- Manajemen role dan permission +- Manajemen menu akses + +--- + +## 5. Database Schema + +### 5.1 Overview + +Database menggunakan **PostgreSQL** dengan **Prisma ORM** (versi 6.3.1). +Schema terdiri dari **2413 baris** dengan **100+ model**. + +### 5.2 Model Utama + +#### FileStorage +Model sentral untuk semua file (gambar, dokumen, audio): +```prisma +model FileStorage { + id String @id @default(cuid()) + name String @unique + realName String + path String + mimeType String + category String // "image" / "document" / "audio" / "other" + link String + isActive Boolean @default(true) + // Relasi ke 50+ model lain (Berita, PotensiDesa, GalleryFoto, dll) +} +``` + +#### AppMenu & AppMenuChild +Menu navigasi aplikasi: +```prisma +model AppMenu { + id String @id @default(cuid()) + name String @unique + link String + isActive Boolean @default(true) + AppMenuChild AppMenuChild[] +} +``` + +#### User & Role (Autentikasi Admin) +- `User` - Data pengguna admin +- `Role` - Role/peran pengguna +- `Menu` - Menu akses per role + +#### Modul Desa +- `Berita` - Berita desa (dengan featured image & gallery) +- `GalleryFoto` / `GalleryVideo` - Galeri media +- `Layanan` - Layanan desa +- `Pengumuman` - Pengumuman +- `PotensiDesa` - Potensi desa +- `ProfileDesaImage` - Gambar profil desa +- `ProfilPerbekel` - Profil perbekel (kepala desa) +- `PejabatDesa` - Pejabat desa +- `Penghargaan` - Penghargaan +- `PrestasiDesa` - Prestasi +- `MediaSosial` - Media sosial desa + +#### Modul PPID +- `StrukturPPID` - Struktur organisasi +- `PosisiOrganisasiPPID` - Posisi dengan hierarki +- `PegawaiPPID` - Data pegawai +- `ProfilePPID` - Profil PPID +- `VisiMisiPPID` - Visi misi +- `DasarHukumPPID` - Dasar hukum +- `DaftarInformasiPublik` - Daftar informasi +- `PermohonanInformasiPublik` - Permohonan informasi +- `FormulirPermohonanKeberatan` - Formulir keberatan +- `IndeksKepuasanMasyarakat` - IKM +- `Responden` + lookup tables - Data responden IKM + +#### Modul Kesehatan +- `Puskesmas` - Data puskesmas +- `Posyandu` - Data posyandu +- `ProgramKesehatan` - Program kesehatan +- `FasilitasKesehatan` - Fasilitas +- `InfoWabahPenyakit` - Info wabah +- `PenangananDarurat` - Penanganan darurat +- `KontakDarurat` - Kontak darurat +- `ArtikelKesehatan` - Artikel + +#### Modul Ekonomi +- `APBDes` & `APBDesItem` - Anggaran desa (hierarki tree structure) +- `RealisasiItem` - Realisasi anggaran (multiple per item) +- `PasarDesa` - Pasar desa +- `PegawaiBumDes` - Pegawai BUMDes +- `StrukturBumDes` - Struktur BUMDes +- `DemografiPekerjaan` - Demografi pekerjaan +- `JumlahPendudukMiskin` - Data kemiskinan +- `JumlahPengangguran` - Data pengangguran +- `LowonganKerjaLokal` - Lowongan kerja +- `ProgramKemiskinan` - Program kemiskinan +- `SektorUnggulanDesa` - Sektor unggulan +- `PendapatanAsli` - Pendapatan asli desa + +#### Modul Kependudukan +- `DataBanjar` - Data banjar +- `DistribusiAgama` - Distribusi agama +- `DistribusiUmur` - Distribusi umur +- `MigrasiPenduduk` - Migrasi + +#### Modul Pendidikan +- `InfoSekolah` - Data sekolah +- `BeasiswaDesa` - Beasiswa +- `BimbinganBelajar` - Bimbingan belajar +- `PendidikanNonFormal` - Pendidikan non-formal +- `DataPerpustakaan` - Perpustakaan + +#### Modul Keamanan +- `KeamananLingkungan` - Keamanan lingkungan +- `MenuTipsKeamanan` - Tips keamanan +- `PencegahanKriminalitas` - Pencegahan kriminalitas +- `PolsekTerdekat` - Polsek terdekat +- `LaporanPublik` - Laporan publik + +#### Modul Lingkungan +- `DataLingkunganDesa` - Data lingkungan +- `KonservasiAdatBali` - Konservasi adat +- `BankSampah` - Bank sampah +- `ProgramPenghijauan` - Penghijauan +- `GotongRoyong` - Gotong royong +- `EdukasiLingkungan` - Edukasi + +#### Modul Inovasi +- `ProgramInovasi` - Program inovasi +- `DesaDigital` - Desa digital +- `InfoTekno` - Info teknologi +- `KolaborasiInovasi` + `MitraKolaborasi` - Kolaborasi +- `LayananOnlineDesa` - Layanan online +- `ProgramKreatifDesa` - Program kreatif +- `Ajukan` - Pengajuan ide + +#### Modul Musik +- `MusikDesa` - Musik desa + - `audioFile` -> FileStorage + - `coverImage` -> FileStorage + +#### Landing Page +- `DesaAntiKorupsi` + `KategoriDesaAntiKorupsi` +- `SdgsDesa` - SDGs +- `PrestasiDesa` + `KategoriPrestasiDesa` +- `MediaSosial` +- `LandingPage_Layanan` + +#### APBDes (Struktur Hierarki) +```prisma +model APBDesItem { + kode String // "4", "4.1", "4.1.2" + uraian String // Nama item + anggaran Float // Anggaran dalam Rupiah + tipe String? // "pendapatan" | "belanja" | "pembiayaan" + level Int // 1, 2, 3 + parentId String? // Self-referencing untuk tree + children APBDesItem[] + totalRealisasi Float @default(0) // Auto-calculated + selisih Float @default(0) // totalRealisasi - anggaran + persentase Float @default(0) // (totalRealisasi / anggaran) * 100 + realisasiItems RealisasiItem[] +} +``` + +### 5.3 Pola Umum Model + +Hampir semua model mengikuti pola: +```prisma +model Contoh { + id String @id @default(cuid()) + // ... fields + createdAt DateTime @default(now()) + updatedAt DateTime @updatedAt + deletedAt DateTime? @default(now()) // Soft delete + isActive Boolean @default(true) // Soft delete flag +} +``` + +--- + +## 6. API Routes + +### 6.1 Struktur API + +Semua API routes ditangani oleh **Elysia.js** di `/src/app/api/[[...slugs]]/route.ts` + +### 6.2 API Groups + +| Prefix | Modul | Contoh Endpoints | +|--------|-------|------------------| +| `/api/layanan` | Layanan | `GET /api/layanan` | +| `/api/potensi` | Potensi | `GET /api/potensi` | +| `/api/desa/*` | Desa | CRUD berita, gallery, profil, dll | +| `/api/ppid/*` | PPID | CRUD struktur, profil, permohonan | +| `/api/kesehatan/*` | Kesehatan | CRUD puskesmas, posyandu, dll | +| `/api/ekonomi/*` | Ekonomi | CRUD APBDes, BUMDes, demografi | +| `/api/kependudukan/*` | Kependudukan | CRUD banjar, demografi | +| `/api/pendidikan/*` | Pendidikan | CRUD sekolah, beasiswa | +| `/api/keamanan/*` | Keamanan | CRUD keamanan, kontak darurat | +| `/api/lingkungan/*` | Lingkungan | CRUD data lingkungan | +| `/api/inovasi/*` | Inovasi | CRUD program inovasi | +| `/api/landing-page/*` | Landing Page | CRUD konten landing page | +| `/api/user/*` | User | CRUD user admin | +| `/api/user/role/*` | Role | CRUD role & permission | +| `/api/search` | Search | Pencarian global | +| `/api/file-storage/*` | File Storage | CRUD file storage | +| `/api/img/:name` | Image | GET gambar dengan resize | +| `/api/upl-img` | Upload | Upload multiple images | +| `/api/upl-img-single` | Upload | Upload single image | +| `/api/upl-csv` | Upload | Upload CSV files | +| `/api/utils/version` | Utils | GET versi aplikasi | + +### 6.3 API Documentation + +Swagger UI tersedia di: **`/api/docs`** + +### 6.4 API Route Lainnya + +| Route | Fungsi | +|-------|--------| +| `/api/health` | Health check endpoint | +| `/api/news` | API berita (standalone) | +| `/api/subscribe` | Subscription email | +| `/api/tts` | Text-to-Speech (ElevenLabs) | +| `/api/admin/*` | API khusus admin | +| `/api/auth/*` | API autentikasi | + +--- + +## 7. Halaman Admin + +### 7.1 Struktur + +Admin dashboard berada di `/admin` dengan route group `(dashboard)`. + +| Section | Path | Fungsi | +|---------|------|--------| +| **Dashboard** | `/admin` | Dashboard utama | +| **Autentikasi** | `/admin/auth` | Login admin | +| **Desa** | `/admin/desa/*` | Berita, gallery, profil, layanan, penghargaan, pengumuman, potensi | +| **PPID** | `/admin/ppid/*` | Profil, struktur, visi-misi, daftar informasi, dasar hukum, permohonan, IKM | +| **Kesehatan** | `/admin/kesehatan/*` | Puskesmas, posyandu, program kesehatan, wabah, kontak darurat | +| **Ekonomi** | `/admin/ekonomi/*` | APBDes, PAD, demografi, pengangguran, kemiskinan, BUMDes, pasar desa | +| **Kependudukan** | `/admin/kependudukan/*` | Banjar, distribusi agama, distribusi umur, migrasi | +| **Pendidikan** | `/admin/pendidikan/*` | Sekolah, beasiswa, bimbingan belajar, perpustakaan digital | +| **Keamanan** | `/admin/keamanan/*` | Keamanan lingkungan, kontak darurat, pencegahan kriminalitas, polsek | +| **Lingkungan** | `/admin/lingkungan/*` | Data lingkungan, konservasi, bank sampah, penghijauan, gotong royong | +| **Inovasi** | `/admin/inovasi/*` | Ide inovatif, desa digital, teknologi tepat guna, kolaborasi | +| **Musik** | `/admin/musik/*` | Manajemen musik desa | +| **Landing Page** | `/admin/landing-page/*` | Anti-korupsi, prestasi, SDGs, media sosial | +| **User & Role** | `/admin/user&role/*` | Manajemen user dan role | +| **Images** | `/admin/images/*` | Manajemen gambar | +| **CSV** | `/admin/csv/*` | Upload/import CSV | + +### 7.2 Komponen Admin Shared + +- `AdminThemeProvider.tsx` - Theme provider untuk dark/light mode +- `DarkModeToggle.tsx` - Toggle dark mode +- `UnifiedSurface.tsx` - Komponen surface/card unified +- `UnifiedTypography.tsx` - Tipografi unified + +--- + +## 8. Halaman Publik + +### 8.1 Struktur + +Halaman publik berada di `/darmasaba` dengan layout yang mencakup Navbar, Footer, dan Fixed Music Player. + +| Halaman | Path | Konten | +|---------|------|--------| +| **Landing Page \ No newline at end of file diff --git a/STRUKTUR.md b/STRUKTUR.md new file mode 100644 index 00000000..e9ca3b54 --- /dev/null +++ b/STRUKTUR.md @@ -0,0 +1,842 @@ +# Dokumentasi Struktur Proyek Desa Darmasaba + +## 1. Ringkasan Proyek + +**Desa Darmasaba** adalah aplikasi web manajemen desa digital untuk Desa Darmasaba, Kabupaten Badung, Bali. Aplikasi ini berfungsi sebagai platform layanan publik digital yang mencakup informasi pemerintahan, layanan kesehatan, keamanan, pendidikan, ekonomi, lingkungan, dan inovasi desa. + +### Tech Stack + +| Kategori | Teknologi | +|----------|-----------| +| **Framework** | Next.js 15 (App Router) | +| **Language** | TypeScript (strict mode) | +| **Runtime** | Bun | +| **Backend API** | Elysia.js (high-performance HTTP server) | +| **Database** | PostgreSQL | +| **ORM** | Prisma 6.3.1 | +| **UI Framework** | Mantine UI v7-v8 | +| **State Management** | Jotai + Valtio + SWR | +| **Authentication** | iron-session + JWT (@elysiajs/jwt) | +| **File Storage** | Seafile (self-hosted) | +| **Text Editor** | Tiptap (Rich text editor) | +| **Charts** | Recharts + Chart.js | +| **Maps** | Leaflet + react-leaflet | +| **Testing** | Vitest (unit) + Playwright (E2E) | +| **Styling** | Mantine + PostCSS + Framer Motion | +| **Deployment** | Docker + GHCR + Portainer + GitHub Actions | +| **Version** | 0.1.11 | + +--- + +## 2. Struktur Direktori + +``` +desa-darmasaba/ +├── .github/workflows/ # GitHub Actions CI/CD +│ ├── docker-publish.yml # Auto build & push saat tag v* +│ ├── publish.yml # Manual build & push ke GHCR +│ ├── re-pull.yml # Manual re-pull di Portainer +│ └── script/ # Shell scripts untuk deploy +├── prisma/ +│ ├── schema.prisma # Database schema (2413 baris, 100+ model) +│ └── seed.ts # Database seeder (400+ baris) +│ └── _seeder_list/ # Seed data per modul +├── public/ # Static assets +│ └── assets/ +│ └── images/ +├── src/ +│ ├── app/ # Next.js App Router +│ │ ├── _com/ # Global components (SplashScreen, WebVitals) +│ │ ├── admin/ # ADMIN DASHBOARD +│ │ │ ├── (dashboard)/ # Route group dashboard +│ │ │ │ ├── desa/ # - Berita, Gallery, Layanan, dll +│ │ │ │ ├── ppid/ # - Informasi publik, struktur, dasar hukum +│ │ │ │ ├── kesehatan/ # - Fasilitas, posyandu, puskesmas, wabah +│ │ │ │ ├── ekonomi/ # - APBDes, pasar desa, BUMDes, dll +│ │ │ │ ├── kependudukan/ # - Banjar, agama, umur, migrasi +│ │ │ │ ├── pendidikan/ # - Sekolah, beasiswa, perpustakaan +│ │ │ │ ├── keamanan/ # - Keamanan lingkungan, polsek, dll +│ │ │ │ ├── lingkungan/ # - Sampah, penghijauan, gotong royong +│ │ │ │ ├── inovasi/ # - Desa digital, kolaborasi, dll +│ │ │ │ ├── landing-page/ # - Profil, prestasi, anti-korupsi +│ │ │ │ ├── musik/ # - Musik desa +│ │ │ │ ├── user&role/ # - Manajemen user & role +│ │ │ │ └── _com/ # - Shared admin components +│ │ │ ├── auth/ # Login OTP untuk admin +│ │ │ ├── csv/ # Demo CSV upload +│ │ │ └── layout.tsx # Admin shell (AppShell Mantine) +│ │ ├── api/ # ELYSIA.JS API SERVER +│ │ │ ├── [[...slugs]]/ # Catch-all route -> Elysia handler +│ │ │ │ ├── route.ts # - Main Elysia server export +│ │ │ │ └── _lib/ # - Domain route modules +│ │ │ │ ├── desa.ts +│ │ │ │ ├── ppid.ts +│ │ │ │ ├── kesehatan.ts +│ │ │ │ ├── ekonomi.ts +│ │ │ │ ├── keamanan.ts +│ │ │ │ ├── inovasi.ts +│ │ │ │ ├── lingkungan.ts +│ │ │ │ ├── pendidikan.ts +│ │ │ │ ├── kependudukan.ts +│ │ │ │ ├── landing_page.ts +│ │ │ │ ├── user/ # - User & Role management +│ │ │ │ ├── fileStorage/ +│ │ │ │ ├── search/ +│ │ │ │ ├── auth/ +│ │ │ │ ├── upl-img.ts, upl-img-single.ts +│ │ │ │ ├── upl-csv.ts, upl-csv-single.ts +│ │ │ │ └── img.ts, img-del.ts, imgs.ts +│ │ │ ├── auth/ # Auth endpoints (login, logout, me) +│ │ │ └── ... # Other API routes +│ │ ├── darmasaba/ # PUBLIC-FACING WEBSITE +│ │ │ ├── _com/ # Shared components (Navbar, Footer, etc) +│ │ │ ├── (pages)/ # Public pages route group +│ │ │ │ ├── desa/ # - Profil, berita, gallery, layanan +│ │ │ │ ├── ppid/ # - PPID public pages +│ │ │ │ ├── kesehatan/ # - Health info pages +│ │ │ │ ├── ekonomi/ # - Economy pages +│ │ │ │ ├── kependudukan/ +│ │ │ │ ├── pendidikan/ +│ │ │ │ ├── keamanan/ +│ │ │ │ ├── lingkungan/ +│ │ │ │ ├── inovasi/ +│ │ │ │ ├── musik/ +│ │ │ │ └── module/ # - External module links +│ │ │ └── (tambahan)/ # Additional pages +│ │ ├── login/ # Login page +│ │ ├── registrasi/ # Registration page +│ │ ├── waiting-room/ # Waiting room (inactive users) +│ │ ├── terms-of-service/ +│ │ ├── layout.tsx # Root layout (MantineProvider, ViewTransitions) +│ │ └── page.tsx # Homepage redirect +│ ├── components/ +│ │ └── admin/ # Admin shared components +│ │ ├── AdminThemeProvider.tsx +│ │ ├── DarkModeToggle.tsx +│ │ ├── UnifiedSurface.tsx +│ │ └── UnifiedTypography.tsx +│ ├── con/ # Constants & configuration +│ │ ├── colors.ts # Color palette definitions +│ │ ├── images.ts +│ │ ├── navbar-list-menu.ts +│ │ ├── router.ts # Route mapping +│ │ └── sosmed.ts +│ ├── context/ # React contexts +│ │ └── MusicContext.tsx # Music player context +│ ├── hooks/ # Custom React hooks +│ ├── lib/ # Utility libraries +│ │ ├── router/ +│ │ ├── api-auth.ts # API authentication helpers +│ │ ├── api-fetch.ts # API fetch wrapper +│ │ ├── EnvStringParse.ts +│ │ ├── prisma.ts # Prisma client singleton +│ │ ├── seafile-auth-service.ts +│ │ └── session.ts # iron-session helper +│ ├── state/ # Global state (Jotai/Valtio) +│ │ ├── darkModeStore.ts +│ │ ├── state-layanan.ts +│ │ ├── state-list-image.ts +│ │ └── state-nav.ts +│ ├── store/ # Additional stores +│ │ └── authStore.ts # Auth state (Jotai) +│ ├── types/ # TypeScript type definitions +│ └── utils/ # Utility functions +│ └── themeTokens.ts # Dark/light theme tokens +├── uploads/ # Local upload directory (images/files) +├── Dockerfile # Multi-stage Docker build (Bun) +├── docker-entrypoint.sh # Entry script (migrate + start) +├── next.config.ts # Next.js configuration +├── package.json # Dependencies & scripts +├── tsconfig.json # TypeScript configuration +├── biome.json # Biome linter config +├── eslint.config.mjs # ESLint config +├── NOTE.md # Deployment notes +├── QWEN.md # Project memory & workflow +└── AGENTS.md # Agent coding guidelines +``` + +--- + +## 3. Arsitektur + +### Pola Arsitektur: Full-Stack Monolith dengan App Router + +``` +Browser + | + +-- Next.js 15 (App Router) -- Server Components + Client Components + | + +-- /darmasaba/* -> Public pages (SSR/CSR) + +-- /admin/* -> Admin dashboard (protected) + +-- /api/* -> Elysia.js API server + | + +-- Elysia Server (src/app/api/[[...slugs]]/route.ts) + | + +-- CORS enabled + +-- Swagger docs di /api/docs + +-- Static file serving (/api/uploads) + +-- Domain modules: Desa, PPID, Kesehatan, Ekonomi, dll + +-- Image upload handlers + | + +-- Prisma ORM --> PostgreSQL + +-- Seafile API --> File Storage +``` + +### Key Architectural Decisions: + +1. **Next.js 15 App Router**: Menggunakan React Server Components sebagai default, dengan `"use client"` untuk interaktivitas +2. **Elysia.js di dalam API Routes**: Catch-all route `[[...slugs]]` meneruskan semua request ke Elysia handler +3. **Route Groups**: `(dashboard)` dan `(pages)` untuk organisasi tanpa mempengaruhi URL path +4. **Multi-tenant Ready**: Role-based access control dengan dynamic navbar berdasarkan roleId +5. **File Uploads**: Local uploads + Seafile integration untuk distributed storage + +--- + +## 4. Modul Domain + +### A. PPID (Pejabat Pengelola Informasi dan Dokumentasi) +**Lokasi**: `src/app/admin/(dashboard)/ppid/` dan `src/app/darmasaba/(pages)/ppid/` + +| Sub-modul | Deskripsi | +|-----------|-----------| +| Profil PPID | Profil pejabat pengelola informasi | +| Struktur PPID | Struktur organisasi PPID dengan hierarki | +| Visi & Misi PPID | Visi dan misi PPID desa | +| Daftar Informasi Publik | Katalog informasi publik yang tersedia | +| Dasar Hukum | Regulasi dan dasar hukum PPID | +| Permohonan Informasi Publik | Form permohonan informasi (NIK, kontak, jenis) | +| Permohonan Keberatan | Formulir keberatan informasi | +| Indeks Kepuasan Masyarakat | Survey kepuasan dengan grafik demografis | + +### B. Desa (Landing Page & Umum) +**Lokasi**: `src/app/admin/(dashboard)/desa/` dan `src/app/darmasaba/(pages)/desa/` + +| Sub-modul | Deskripsi | +|-----------|-----------| +| Profil Desa | Sejarah, visi-misi, lambang, maskot | +| Profil Perbekel | Biodata, pengalaman, program unggulan perbekel | +| Perbekel dari Masa ke Masa | Historis perbekel per periode | +| Berita | Artikel berita dengan kategori & multi-image | +| Gallery | Foto dan video galeri | +| Pengumuman | Pengumuman desa dengan kategori | +| Potensi Desa | Potensi desa dengan kategori | +| Layanan Desa | Surat keterangan, ajukan permohonan | +| Penghargaan | Prestasi dan penghargaan desa | +| Desa Anti Korupsi | Transparansi anti-korupsi | +| SDGs Desa | Sustainable Development Goals desa | +| APBDes | Anggaran desa dengan hierarki item & realisasi | +| Prestasi Desa | Katalog prestasi | + +### C. Kesehatan +**Lokasi**: `src/app/admin/(dashboard)/kesehatan/` dan `src/app/darmasaba/(pages)/kesehatan/` + +| Sub-modul | Deskripsi | +|-----------|-----------| +| Fasilitas Kesehatan | Info rumah sakit/klinik (jam, dokter, tarif) | +| Puskesmas | Data puskesmas dengan jam operasional & kontak | +| Posyandu | Jadwal dan informasi posyandu | +| Program Kesehatan | Program-program kesehatan desa | +| Penanganan Darurat | Prosedur penanganan darurat | +| Kontak Darurat | Kontak emergency dengan WhatsApp | +| Info Wabah Penyakit | Informasi wabah penyakit | +| Artikel Kesehatan | Artikel kesehatan lengkap | +| Data Kesehatan Warga | Statistik kesehatan warga | +| Kelahiran & Kematian | Data vital statistik | +| Grafik Kepuasan | Grafik kepuasan layanan kesehatan | + +### D. Ekonomi +**Lokasi**: `src/app/admin/(dashboard)/ekonomi/` dan `src/app/darmasaba/(pages)/ekonomi/` + +| Sub-modul | Deskripsi | +|-----------|-----------| +| Pasar Desa | Katalog pasar desa dengan produk & rating | +| Struktur BUMDes | Organisasi BUMDes dengan pengurus | +| APBDes (PADesa) | Pendapatan Asli Desa | +| Program Kemiskinan | Program dan statistik kemiskinan | +| Sektor Unggulan | Sektor ekonomi unggulan desa | +| Lowongan Kerja Lokal | Info lowongan pekerjaan | +| Demografi Pekerjaan | Distribusi pekerjaan penduduk | +| Jumlah Pengangguran | Statistik pengangguran | +| Penduduk Usia Kerja Menganggur | Analisis pengangguran by usia & pendidikan | +| Jumlah Penduduk Miskin | Tren kemiskinan tahunan | + +### E. Kependudukan +**Lokasi**: `src/app/admin/(dashboard)/kependudukan/` dan `src/app/darmasaba/(pages)/kependudukan/` + +| Sub-modul | Deskripsi | +|-----------|-----------| +| Data Banjar | Data penduduk per banjar | +| Distribusi Agama | Statistik agama penduduk | +| Distribusi Umur | Piramida umur penduduk | +| Migrasi Penduduk | Data migrasi masuk/keluar | +| Dinamika Penduduk | Kelahiran, kematian, migrasi per tahun | + +### F. Pendidikan +**Lokasi**: `src/app/admin/(dashboard)/pendidikan/` dan `src/app/darmasaba/(pages)/pendidikan/` + +| Sub-modul | Deskripsi | +|-----------|-----------| +| Info Sekolah & PAUD | Data sekolah per jenjang (TK, SD, SMP, SMA) | +| Beasiswa Desa | Program beasiswa & pendaftar | +| Program Pendidikan Anak | Program pendidikan anak | +| Bimbingan Belajar | Informasi bimbingan belajar | +| Pendidikan Non Formal | Tempat & program non-formal | +| Perpustakaan Digital | Katalog buku & peminjaman | +| Data Pendidikan | Statistik pendidikan | + +### G. Keamanan +**Lokasi**: `src/app/admin/(dashboard)/keamanan/` dan `src/app/darmasaba/(pages)/keamanan/` + +| Sub-modul | Deskripsi | +|-----------|-----------| +| Keamanan Lingkungan (Pecalang/Patwal) | Sistem keamanan tradisional Bali | +| Polsek Terdekat | Data polsek dengan layanan & map | +| Kontak Darurat | Kontak darurat keamanan | +| Pencegahan Kriminalitas | Info pencegahan kriminal | +| Laporan Publik | Laporan masyarakat dengan tracking status | +| Tips Keamanan | Tips dan panduan keamanan | + +### H. Lingkungan +**Lokasi**: `src/app/admin/(dashboard)/lingkungan/` dan `src/app/darmasaba/(pages)/lingkungan/` + +| Sub-modul | Deskripsi | +|-----------|-----------| +| Pengelolaan Sampah | Bank sampah & pengelolaan | +| Program Penghijauan | Program penghijauan desa | +| Data Lingkungan | Data lingkungan desa | +| Gotong Royong | Kegiatan gotong royong | +| Edukasi Lingkungan | Edukasi lingkungan hidup | +| Konservasi Adat Bali | Tri Hita Karana & konservasi adat | + +### I. Inovasi +**Lokasi**: `src/app/admin/(dashboard)/inovasi/` dan `src/app/darmasaba/(pages)/inovasi/` + +| Sub-modul | Deskripsi | +|-----------|-----------| +| Desa Digital (Smart Village) | Transformasi digital desa | +| Program Kreatif Desa | Program kreatif & inovatif | +| Kolaborasi Inovasi | Kolaborasi dengan mitra | +| Info Teknologi Tepat Guna | Info teknologi untuk desa | +| Ajukan Ide Inovatif | Form pengajuan ide dari warga | +| Layanan Online Desa | Layanan administrasi online | + +### J. Musik Desa +**Lokasi**: `src/app/admin/(dashboard)/musik/` dan `src/app/darmasaba/(pages)/musik/` + +Model `MusikDesa` dengan audio file, cover image, genre, dan durasi. Dilengkapi dengan `FixedPlayerBar` di layout publik. + +### K. User & Role (Admin) +**Lokasi**: `src/app/admin/(dashboard)/user&role/` + +- **Role-based Access Control**: Role dengan permission JSON +- **User Session Management**: Multiple sessions per user dengan JWT +- **OTP Authentication**: Login dengan nomor telepon + OTP +- **Menu Access Control**: Dynamic navbar berdasarkan menu akses user + +--- + +## 5. Database Schema (Prisma) + +Schema terdiri dari **2413 baris** dengan **100+ model** dan **berbagai enum**. Berikut model-model utama: + +### Core Models + +| Model | Keterangan | +|-------|-----------| +| `FileStorage` | Central file storage untuk semua uploaded files | +| `AppMenu` / `AppMenuChild` | Menu navigasi aplikasi | +| `User` / `Role` / `UserSession` / `UserMenuAccess` | Sistem autentikasi & otorisasi | +| `KodeOtp` | OTP codes untuk login | + +### Landing Page & Desa + +| Model | Keterangan | +|-------|-----------| +| `PejabatDesa` | Pejabat desa dengan foto | +| `ProfilPerbekel` | Profil perbekel (biodata, pengalaman, program) | +| `PerbekelDariMasaKeMasa` | Historis perbekel | +| `Berita` / `KategoriBerita` | Berita desa | +| `PotensiDesa` / `KategoriPotensi` | Potensi desa | +| `Pengumuman` / `CategoryPengumuman` | Pengumuman | +| `GalleryFoto` / `GalleryVideo` | Gallery media | +| `Penghargaan` | Penghargaan desa | +| `APBDes` / `APBDesItem` / `RealisasiItem` | Anggaran dengan realisasi | +| `DesaAntiKorupsi` / `KategoriDesaAntiKorupsi` | Transparansi | +| `SdgsDesa` | SDGs desa | +| `PrestasiDesa` / `KategoriPrestasiDesa` | Prestasi | +| `MusikDesa` | Musik desa | + +### PPID + +| Model | Keterangan | +|-------|-----------| +| `StrukturPPID` / `PosisiOrganisasiPPID` / `PegawaiPPID` | Struktur organisasi | +| `VisiMisiPPID` | Visi misi | +| `ProfilePPID` | Profil pejabat | +| `DasarHukumPPID` | Regulasi | +| `DaftarInformasiPublik` | Katalog informasi | +| `PermohonanInformasiPublik` | Permohonan + lookup tables | +| `FormulirPermohonanKeberatan` | Keberatan | +| `IndeksKepuasanMasyarakat` + grafik breakdown | Survey kepuasan | + +### Kesehatan + +| Model | Keterangan | +|-------|-----------| +| `FasilitasKesehatan` | Fasilitas lengkap (dokter, tarif, prosedur) | +| `Puskesmas` / `JamOperasional` / `KontakPuskesmas` | Puskesmas | +| `Posyandu` | Pos pelayanan terpadu | +| `ProgramKesehatan` | Program kesehatan | +| `ArtikelKesehatan` | Artikel lengkap (gejala, pencegahan, P3K, dll) | +| `PenangananDarurat` / `KontakDarurat` | Darurat | +| `InfoWabahPenyakit` | Wabah | +| `DataKematian_Kelahiran` / `Kelahiran` / `Kematian` | Vital statistik | +| `GrafikKepuasan` | Kepuasan | + +### Ekonomi + +| Model | Keterangan | +|-------|-----------| +| `PasarDesa` / `KategoriProduk` / `KategoriToPasar` | Pasar desa | +| `StrukturBumDes` / `PosisiOrganisasiBumDes` / `PegawaiBumDes` | BUMDes | +| `ProgramKemiskinan` / `StatistikKemiskinan` | Kemiskinan | +| `SektorUnggulanDesa` | Sektor unggulan | +| `LowonganPekerjaan` | Lowongan | +| `DataDemografiPekerjaan` | Demografi pekerjaan | +| `DetailDataPengangguran` | Pengangguran | +| `GrafikJumlahPendudukMiskin` | Tren kemiskinan | + +### Kependudukan + +| Model | Keterangan | +|-------|-----------| +| `DataBanjar` | Data per banjar | +| `DistribusiAgama` | Distribusi agama | +| `DistribusiUmur` | Distribusi umur | +| `MigrasiPenduduk` | Migrasi (MASUK/KELUAR) | +| `DinamikaPenduduk` | Dinamika tahunan | + +### Pendidikan + +| Model | Keterangan | +|-------|-----------| +| `JenjangPendidikan` / `Lembaga` / `Siswa` / `Pengajar` | Data sekolah | +| `BeasiswaPendaftar` | Beasiswa (dengan enum lengkap) | +| `DataPerpustakaan` / `KategoriBuku` / `PeminjamanBuku` | Perpustakaan | +| `DataPendidikan` | Statistik | + +### Keamanan + +| Model | Keterangan | +|-------|-----------| +| `KeamananLingkungan` | Keamanan lingkungan | +| `PolsekTerdekat` / `LayananPolsek` / `LayananToPolsek` | Polsek | +| `KontakDaruratKeamanan` / `KontakItem` | Kontak darurat | +| `PencegahanKriminalitas` | Pencegahan | +| `LaporanPublik` / `PenangananLaporanPublik` (enum StatusLaporan) | Laporan | +| `Pelapor` | Pelapor | +| `MenuTipsKeamanan` | Tips | + +### Lingkungan + +| Model | Keterangan | +|-------|-----------| +| `PengelolaanSampah` | Pengelolaan sampah | +| `KeteranganBankSampahTerdekat` | Bank sampah | +| `ProgramPenghijauan` | Penghijauan | +| `DataLingkunganDesa` | Data lingkungan | +| `KegiatanDesa` / `KategoriKegiatan` | Gotong royong | +| `FilosofiTriHita` / `BentukKonservasiBerdasarkanAdat` | Konservasi Bali | + +### Inovasi + +| Model | Keterangan | +|-------|-----------| +| `DesaDigital` | Smart village | +| `ProgramKreatif` | Program kreatif | +| `KolaborasiInovasi` / `MitraKolaborasi` | Kolaborasi | +| `InfoTekno` | Teknologi tepat guna | +| `AjukanIdeInovatif` | Ide dari warga | +| `AdministrasiOnline` / `JenisLayanan` | Layanan online | +| `PengaduanMasyarakat` / `JenisPengaduan` | Pengaduan | + +--- + +## 6. API Routes + +Semua API ditangani oleh **Elysia.js** di `src/app/api/[[...slugs]]/route.ts`: + +| Endpoint Group | Prefix | Deskripsi | +|---------------|--------|-----------| +| **File Storage** | `/api/file-storage` | CRUD file storage | +| **Landing Page** | `/api/landing-page` | Profil, prestasi, anti-korupsi, SDGs, APBDes | +| **Desa** | `/api/desa` | Berita, gallery, potensi, pengumuman, layanan | +| **PPID** | `/api/ppid` | Semua endpoint PPID | +| **Kesehatan** | `/api/kesehatan` | Fasilitas, puskesmas, posyandu, artikel, wabah | +| **Ekonomi** | `/api/ekonomi` | Pasar desa, BUMDes, APBDes, pengangguran | +| **Keamanan** | `/api/keamanan` | Keamanan, polsek, laporan, kriminalitas | +| **Lingkungan** | `/api/lingkungan` | Sampah, penghijauan, gotong royong | +| **Pendidikan** | `/api/pendidikan` | Sekolah, beasiswa, perpustakaan | +| **Kependudukan** | `/api/kependudukan` | Banjar, agama, umur, migrasi | +| **Inovasi** | `/api/inovasi` | Desa digital, kolaborasi, pengaduan | +| **User** | `/api/admin/user` | CRUD user | +| **Role** | `/api/admin/role` | CRUD role | +| **Search** | `/api/search` | Global search | +| **Utils** | `/api/utils/version` | Version info | + +### Utility Endpoints + +| Endpoint | Method | Deskripsi | +|----------|--------|-----------| +| `/api/img/:name` | GET | Serve image dengan resize | +| `/api/img/:name` | DELETE | Delete image | +| `/api/imgs` | GET | List images dengan pagination | +| `/api/upl-img` | POST | Upload multiple images | +| `/api/upl-img-single` | POST | Upload single image | +| `/api/upl-csv` | POST | Upload CSV multiple | +| `/api/upl-csv-single` | POST | Upload single CSV | + +### Auth Endpoints + +| Endpoint | Method | Deskripsi | +|----------|--------|-----------| +| `/api/auth/login` | POST | Login dengan OTP | +| `/api/auth/logout` | POST | Logout | +| `/api/auth/me` | GET | Get current user | + +**Swagger Documentation**: Tersedia di `/api/docs` + +--- + +## 7. Halaman Admin + +Admin dashboard menggunakan **Mantine AppShell** dengan sidebar navigasi dinamis berbasis role. + +### Route Group: `/admin` + +| Section | Path | Deskripsi | +|---------|------|-----------| +| **Landing Page** | `/admin/landing-page/` | Profil desa, prestasi, anti-korupsi, SDGs, media sosial | +| **Desa** | `/admin/desa/` | Berita, gallery, layanan, penghargaan, pengumuman, potensi, profil | +| **PPID** | `/admin/ppid/` | 8 sub-modul PPID lengkap | +| **Kesehatan** | `/admin/kesehatan/` | 8 sub-modul kesehatan | +| **Ekonomi** | `/admin/ekonomi/` | 10 sub-modul ekonomi | +| **Kependudukan** | `/admin/kependudukan/` | 4 sub-modul kependudukan | +| **Pendidikan** | `/admin/pendidikan/` | 7 sub-modul pendidikan | +| **Keamanan** | `/admin/keamanan/` | 6 sub-modul keamanan | +| **Lingkungan** | `/admin/lingkungan/` | 6 sub-modul lingkungan | +| **Inovasi** | `/admin/inovasi/` | 6 sub-modul inovasi | +| **Musik** | `/admin/musik/` | Manajemen musik desa | +| **User & Role** | `/admin/user&role/` | Manajemen user, role, menu access | + +### Fitur Admin: +- **Role-based Dynamic Navbar**: Navbar berubah berdasarkan roleId user +- **Dark Mode Toggle**: Tema gelap/terang +- **OTP Login**: Login dengan nomor telepon + kode OTP +- **Session Management**: Multiple sessions per user dengan JWT tokens +- **CSV Upload**: Import data via CSV +- **Image Upload**: Upload dengan preview dan management +- **Rich Text Editor**: Tiptap untuk konten HTML + +### Role-Based Redirect: +| roleId | Role | Default Redirect | +|--------|------|-----------------| +| 0, 1, 2 | Super Admin / Admin Desa | `/admin/landing-page/profil/program-inovasi` | +| 3 | Admin Kesehatan | `/admin/kesehatan/posyandu` | +| 4 | Admin Pendidikan | `/admin/pendidikan/info-sekolah/jenjang-pendidikan` | + +--- + +## 8. Halaman Publik + +Public website di `/darmasaba/` dengan layout yang mencakup **Navbar**, **Footer**, dan **Fixed Music Player Bar**. + +### Route Group: `/darmasaba` + +| Section | Path | Deskripsi | +|---------|------|-----------| +| **Home** | `/darmasaba` | Landing page utama | +| **Desa** | `/darmasaba/desa` | Profil, berita, gallery, layanan, pengumuman, potensi | +| **PPID** | `/darmasaba/ppid` | 7 sub-halaman PPID publik | +| **Kesehatan** | `/darmasaba/kesehatan` | Info kesehatan publik | +| **Ekonomi** | `/darmasaba/ekonomi` | Info ekonomi desa | +| **Kependudukan** | `/darmasaba/kependudukan` | Data kependudukan | +| **Pendidikan** | `/darmasaba/pendidikan` | Info pendidikan | +| **Keamanan** | `/darmasaba/keamanan` | Info keamanan | +| **Lingkungan** | `/darmasaba/lingkungan` | Info lingkungan | +| **Inovasi** | `/darmasaba/inovasi` | Info inovasi | +| **Musik** | `/darmasaba/musik` | Musik desa | +| **Module** | `/darmasaba/module/*` | Link ke modul eksternal (DAVES, MANGAN, Bicara-Darma, BARES, dll) | + +### Fitur Publik: +- **Fixed Music Player Bar**: Player musik yang selalu tampil di bottom +- **Global Search**: Pencarian global +- **News Reader**: Notifikasi berita modern +- **View Transitions**: Smooth page transitions +- **Responsive Design**: Mobile-first dengan Mantine breakpoints + +--- + +## 9. Komponen Utama + +### Admin Components (`src/components/admin/`) + +| Komponen | Deskripsi | +|----------|-----------| +| `AdminThemeProvider.tsx` | Theme provider untuk admin | +| `DarkModeToggle.tsx` | Toggle dark/light mode | +| `UnifiedSurface.tsx` | Consistent surface/card component | +| `UnifiedTypography.tsx` | Consistent typography system | + +### Public Shared Components (`src/app/darmasaba/_com/`) + +| Komponen | Deskripsi | +|----------|-----------| +| `Navbar.tsx` | Main navigation bar | +| `NavbarMainMenu.tsx` | Main menu dengan kategori | +| `NavbarSubMenu.tsx` | Submenu dropdown | +| `Footer.tsx` | Footer dengan info desa | +| `FixedPlayerBar.tsx` | Music player bar fixed di bottom | +| `LoadDataFirstClient.tsx` | Client-side data preloader | +| `globalSearch.tsx` | Global search component | +| `NewsReader.tsx` | News notification reader | +| `ModernNewsNotification.tsx` | News toast notifications | + +### Global Components (`src/app/_com/`) + +| Komponen | Deskripsi | +|----------|-----------| +| `SpashScreen.tsx` | Splash screen on load | +| `WebVitals.tsx` | Web Vitals monitoring | + +--- + +## 10. State Management + +Proyek menggunakan **multi-layer state management**: + +| Library | Penggunaan | Lokasi | +|---------|-----------|--------| +| **Jotai** | Auth state (`authStore`) | `src/store/authStore.ts` | +| **Valtio** | Dark mode, layanan, image list, nav state | `src/state/*.ts` | +| **SWR** | Server state fetching & caching | Digunakan di components | +| **React Context** | Music player context | `src/app/context/MusicContext.tsx` | +| **React useState** | Local component state | Di components | + +### State Files: + +``` +src/state/ + darkModeStore.ts -- Valtio proxy untuk dark mode + state-layanan.ts -- State layanan desa + state-list-image.ts -- State list image untuk upload + state-nav.ts -- State navigasi + +src/store/ + authStore.ts -- Jotai atom untuk auth user state +``` + +--- + +## 11. Autentikasi + +Sistem autentikasi menggunakan **OTP (One-Time Password)** via WhatsApp/Telepon dengan **iron-session** untuk session management. + +### Flow Autentikasi: +1. User memasukkan **nomor telepon** di `/login` +2. Sistem mengirim **kode OTP** via WhatsApp Server +3. OTP disimpan di model `KodeOtp` +4. User memasukkan kode OTP +5. Jika valid, session dibuat dengan **iron-session** + **JWT token** +6. Session disimpan di `UserSession` model dengan expiry + +### Session Structure: +```typescript +// src/lib/session.ts +type SessionData = { + user?: { + id: string; + name: string; + roleId: number; + menuIds?: string[] | null; + isActive?: boolean; + }; +}; +``` + +### Role-Based Access: +| roleId | Role | Default Redirect | +|--------|------|-----------------| +| 0, 1, 2 | Super Admin / Admin Desa | `/admin/landing-page/profil/program-inovasi` | +| 3 | Admin Kesehatan | `/admin/kesehatan/posyandu` | +| 4 | Admin Pendidikan | `/admin/pendidikan/info-sekolah/jenjang-pendidikan` | + +### Authorization: +- **UserMenuAccess**: Mapping user ke menu yang boleh diakses +- **Dynamic Navbar**: Navbar dirender berdasarkan `menuIds` user +- **Inactive Users**: Dialihkan ke `/waiting-room` + +--- + +## 12. Deployment + +### Docker Setup + +**Dockerfile** menggunakan **multi-stage build** dengan base image `oven/bun:1-debian`: + +``` +Stage 1: Builder + - Install dependencies (bun install --frozen-lockfile) + - Generate Prisma client + - Build Next.js (bun run build) + +Stage 2: Runner + - Copy .next, node_modules, public, prisma, src/lib, tsconfig.json + - Non-root user (nextjs:nodejs) + - Volume /app/uploads untuk file uploads + - Port 3000 +``` + +### Entry Point (`docker-entrypoint.sh`): +```bash +bunx prisma migrate deploy # Run migrations +exec bun start # Start Next.js production server +``` + +### CI/CD dengan GitHub Actions + +Terdapat **3 workflow**: + +| Workflow | Trigger | Fungsi | +|----------|---------|--------| +| `docker-publish.yml` | Push tag `v*` | Auto build & push ke GHCR | +| `publish.yml` | Manual (workflow_dispatch) | Build & push ke GHCR dengan input `stack_env` + `tag` | +| `re-pull.yml` | Manual (workflow_dispatch) | Re-pull image di Portainer dengan input `stack_name` + `stack_env` | + +### Deployment Workflow (Sequential): + +``` +1. Update version di package.json (semver) +2. Commit perubahan +3. Push ke branch target (stg/prod) +4. Trigger publish.yml: + gh workflow run publish.yml --ref main -f stack_env=stg -f tag= +5. Tunggu sampai publish selesai (status: completed) +6. Trigger re-pull.yml: + gh workflow run re-pull.yml --ref main -f stack_name=desa-darmasaba -f stack_env=stg +7. Verifikasi di Portainer +``` + +**PENTING**: `publish.yml` dan `re-pull.yml` TIDAK boleh dijalankan bersamaan (race condition). + +### Environments: +- **dev**: Development +- **stg**: Staging (`desa-darmasaba-stg.wibudev.com`) +- **prod**: Production + +### Notification: +- Telegram notification via `notify.sh` script setelah setiap workflow + +--- + +## 13. Scripts + +| Script | Command | Deskripsi | +|--------|---------|-----------| +| `dev` | `next dev` | Development server | +| `build` | `next build` | Production build | +| `start` | `next start` | Production server | +| `test:api` | `vitest run` | Run API unit tests | +| `test:e2e` | `playwright test` | Run E2E tests | +| `test` | `bun run test:api && bun run test:e2e` | Run all tests | +| `seed` | `bun run prisma/seed.ts` | Seed database | +| `prisma:generate` | `bunx prisma generate` | Generate Prisma client | +| `prisma:push` | `bunx prisma db push` | Push schema to database | +| `prisma:studio` | `bunx prisma studio` | Open Prisma Studio GUI | +| `gen:api` | *(empty)* | Generate API types (placeholder) | + +### Prisma Seed Configuration: +```json +// package.json +{ + "prisma": { + "seed": "bun run prisma/seed.ts" + } +} +``` + +--- + +## 14. Environment Variables + +File: `.env.example` + +| Variable | Deskripsi | Contoh | +|----------|-----------|--------| +| `DATABASE_URL` | PostgreSQL connection string | `postgresql://user:pass@localhost:5432/desa-darmasaba` | +| `SEAFILE_TOKEN` | Seafile API token | `your_seafile_token` | +| `SEAFILE_REPO_ID` | Seafile repository ID | `your_repo_id` | +| `SEAFILE_URL` | Seafile instance URL | `https://seafile.example.com` | +| `SEAFILE_PUBLIC_SHARE_TOKEN` | Token untuk public share | `your_share_token` | +| `WIBU_UPLOAD_DIR` | Upload directory path | `uploads` | +| `WA_SERVER_TOKEN` | WhatsApp server token | `your_wa_token` | +| `NEXT_PUBLIC_BASE_URL` | Base URL aplikasi | `/` (relative) | +| `EMAIL_USER` | Email untuk notifikasi | `your_email@gmail.com` | +| `EMAIL_PASS` | Email app password | `your_app_password` | +| `BASE_TOKEN_KEY` | JWT secret key | `your_jwt_secret` | +| `BOT_TOKEN` | Telegram bot token | `your_bot_token` | +| `CHAT_ID` | Telegram chat ID | `your_chat_id` | +| `SESSION_PASSWORD` | iron-session password (min 32 chars) | `secure_32_char_password` | +| `ELEVENLABS_API_KEY` | ElevenLabs API (TTS - optional) | `your_elevenlabs_key` | + +--- + +## 15. Layanan Eksternal + +### PostgreSQL +- **Provider**: PostgreSQL via Prisma ORM +- **Schema**: `public` +- **Connection**: Via `DATABASE_URL` environment variable +- **Migrations**: `prisma migrate deploy` di docker entrypoint + +### Seafile (File Storage) +- **Tipe**: Self-hosted file sync & share +- **Penggunaan**: Storage untuk images, documents, audio files +- **Integrasi**: `src/lib/seafile-auth-service.ts` +- **CDN**: URL generation untuk public sharing +- **Config**: Token, repo ID, base URL + +### WhatsApp Server +- **Penggunaan**: Kirim OTP codes saat login +- **Config**: `WA_SERVER_TOKEN` + +### Telegram Bot +- **Penggunaan**: Notifikasi deployment & sistem +- **Config**: `BOT_TOKEN` + `CHAT_ID` +- **Integration**: `notify.sh` script di GitHub Actions + +### ElevenLabs (Optional) +- **Penggunaan**: Text-to-Speech (TTS) features +- **Config**: `ELEVENLABS_API_KEY` + +### Email (Nodemailer) +- **Penggunaan**: Notifikasi email untuk subscription/pengumuman +- **Config**: `EMAIL_USER` + `EMAIL_PASS` +- **Provider**: Gmail (app password) + +--- + +## Ringkasan Cepat + +| Aspek | Detail | +|-------|--------| +| **Framework** | Next.js 15 (App Router) + Elysia.js | +| **Database** | PostgreSQL + Prisma (100+ models) | +| **Auth** | OTP + iron-session + JWT | +| **Storage** | Seafile + local uploads | +| **UI** | Mantine UI + Tiptap + Framer Motion | +| **State** | Jotai + Valtio + SWR | +| **Deploy** | Docker + GHCR + Portainer + GitHub Actions | +| **Runtime** | Bun | +| **Testing** | Vitest + Playwright | +| **Version** | 0.1.11 | diff --git a/package.json b/package.json index 8c7369df..28f23820 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "desa-darmasaba", - "version": "0.1.11", + "version": "0.1.12", "private": true, "scripts": { "dev": "next dev", @@ -131,5 +131,6 @@ "postcss-simple-vars": "^7.0.1", "typescript": "^5", "vitest": "^4.0.18" - } + }, + "packageManager": "yarn@1.22.22+sha512.a6b2f7906b721bba3d67d4aff083df04dad64c399707841b7acf00f6b133b7ac24255f2652fa22ae3534329dc6180534e98d17432037ff6fd140556e2bb3137e" } diff --git a/prisma/migrations/20260420083758_add_umkm_produk_penjualan/migration.sql b/prisma/migrations/20260420083758_add_umkm_produk_penjualan/migration.sql new file mode 100644 index 00000000..ad116a10 --- /dev/null +++ b/prisma/migrations/20260420083758_add_umkm_produk_penjualan/migration.sql @@ -0,0 +1,75 @@ +-- CreateTable +CREATE TABLE "Umkm" ( + "id" TEXT NOT NULL, + "nama" TEXT NOT NULL, + "pemilik" TEXT NOT NULL, + "deskripsi" TEXT, + "alamat" TEXT, + "kontak" TEXT, + "imageId" TEXT, + "kategoriId" TEXT NOT NULL, + "isActive" BOOLEAN NOT NULL DEFAULT true, + "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP, + "updatedAt" TIMESTAMP(3) NOT NULL, + "deletedAt" TIMESTAMP(3), + + CONSTRAINT "Umkm_pkey" PRIMARY KEY ("id") +); + +-- CreateTable +CREATE TABLE "ProdukUmkm" ( + "id" TEXT NOT NULL, + "nama" TEXT NOT NULL, + "harga" INTEGER NOT NULL, + "stok" INTEGER NOT NULL DEFAULT 0, + "deskripsi" TEXT, + "imageId" TEXT, + "umkmId" TEXT NOT NULL, + "isActive" BOOLEAN NOT NULL DEFAULT true, + "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP, + "updatedAt" TIMESTAMP(3) NOT NULL, + "deletedAt" TIMESTAMP(3), + + CONSTRAINT "ProdukUmkm_pkey" PRIMARY KEY ("id") +); + +-- CreateTable +CREATE TABLE "PenjualanProduk" ( + "id" TEXT NOT NULL, + "produkId" TEXT NOT NULL, + "jumlah" INTEGER NOT NULL, + "hargaSatuan" INTEGER NOT NULL, + "totalNilai" INTEGER NOT NULL, + "tanggal" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP, + "periode" TEXT NOT NULL, + "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP, + "updatedAt" TIMESTAMP(3) NOT NULL, + "deletedAt" TIMESTAMP(3), + "isActive" BOOLEAN NOT NULL DEFAULT true, + + CONSTRAINT "PenjualanProduk_pkey" PRIMARY KEY ("id") +); + +-- CreateIndex +CREATE INDEX "PenjualanProduk_periode_idx" ON "PenjualanProduk"("periode"); + +-- CreateIndex +CREATE INDEX "PenjualanProduk_produkId_idx" ON "PenjualanProduk"("produkId"); + +-- CreateIndex +CREATE INDEX "PenjualanProduk_tanggal_idx" ON "PenjualanProduk"("tanggal"); + +-- AddForeignKey +ALTER TABLE "Umkm" ADD CONSTRAINT "Umkm_imageId_fkey" FOREIGN KEY ("imageId") REFERENCES "FileStorage"("id") ON DELETE SET NULL ON UPDATE CASCADE; + +-- AddForeignKey +ALTER TABLE "Umkm" ADD CONSTRAINT "Umkm_kategoriId_fkey" FOREIGN KEY ("kategoriId") REFERENCES "KategoriProduk"("id") ON DELETE RESTRICT ON UPDATE CASCADE; + +-- AddForeignKey +ALTER TABLE "ProdukUmkm" ADD CONSTRAINT "ProdukUmkm_imageId_fkey" FOREIGN KEY ("imageId") REFERENCES "FileStorage"("id") ON DELETE SET NULL ON UPDATE CASCADE; + +-- AddForeignKey +ALTER TABLE "ProdukUmkm" ADD CONSTRAINT "ProdukUmkm_umkmId_fkey" FOREIGN KEY ("umkmId") REFERENCES "Umkm"("id") ON DELETE RESTRICT ON UPDATE CASCADE; + +-- AddForeignKey +ALTER TABLE "PenjualanProduk" ADD CONSTRAINT "PenjualanProduk_produkId_fkey" FOREIGN KEY ("produkId") REFERENCES "ProdukUmkm"("id") ON DELETE RESTRICT ON UPDATE CASCADE; diff --git a/prisma/schema.prisma b/prisma/schema.prisma index da495dc4..6051353b 100644 --- a/prisma/schema.prisma +++ b/prisma/schema.prisma @@ -106,6 +106,8 @@ model FileStorage { MusikDesaAudio MusikDesa[] @relation("MusikAudioFile") MusikDesaCover MusikDesa[] @relation("MusikCoverImage") + UmkmImage Umkm[] @relation("UmkmImage") + ProdukUmkmImage ProdukUmkm[] @relation("ProdukUmkmImage") } //========================================= MENU LANDING PAGE ========================================= // @@ -1448,6 +1450,7 @@ model KategoriProduk { isActive Boolean @default(true) KategoriToPasar KategoriToPasar[] PasarDesa PasarDesa[] + Umkm Umkm[] } model KategoriToPasar { @@ -2410,3 +2413,58 @@ model MusikDesa { @@index([judul]) @@index([artis]) } + +model Umkm { + id String @id @default(cuid()) + nama String + pemilik String + deskripsi String? + alamat String? + kontak String? + image FileStorage? @relation("UmkmImage", fields: [imageId], references: [id]) + imageId String? + kategori KategoriProduk @relation(fields: [kategoriId], references: [id]) + kategoriId String + isActive Boolean @default(true) + createdAt DateTime @default(now()) + updatedAt DateTime @updatedAt + deletedAt DateTime? + produk ProdukUmkm[] +} + +model ProdukUmkm { + id String @id @default(cuid()) + nama String + harga Int + stok Int @default(0) + deskripsi String? + image FileStorage? @relation("ProdukUmkmImage", fields: [imageId], references: [id]) + imageId String? + umkm Umkm @relation(fields: [umkmId], references: [id]) + umkmId String + isActive Boolean @default(true) + createdAt DateTime @default(now()) + updatedAt DateTime @updatedAt + deletedAt DateTime? + penjualan PenjualanProduk[] +} + +model PenjualanProduk { + id String @id @default(cuid()) + produk ProdukUmkm @relation(fields: [produkId], references: [id]) + produkId String + jumlah Int + hargaSatuan Int // snapshot harga saat transaksi, agar histori tetap akurat + totalNilai Int // hargaSatuan * jumlah + tanggal DateTime @default(now()) + periode String // format "YYYY-MM" untuk grouping bulanan + createdAt DateTime @default(now()) + updatedAt DateTime @updatedAt + deletedAt DateTime? + isActive Boolean @default(true) + + @@index([periode]) + @@index([produkId]) + @@index([tanggal]) +} + diff --git a/src/app/api/[[...slugs]]/_lib/ekonomi/index.ts b/src/app/api/[[...slugs]]/_lib/ekonomi/index.ts index 456b87c7..39481558 100644 --- a/src/app/api/[[...slugs]]/_lib/ekonomi/index.ts +++ b/src/app/api/[[...slugs]]/_lib/ekonomi/index.ts @@ -11,6 +11,10 @@ import DemografiPekerjaan from "./demografi-pekerjaan"; import JumlahPengangguran from "./jumlah-pengangguran"; import PendapatanAsliDesa from "./pendapatan-asli-desa"; import StrukturOrganisasi from "./struktur-bumdes"; +import Umkm from "./umkm"; +import ProdukUmkm from "./umkm/produk"; +import PenjualanProduk from "./umkm/penjualan"; +import UmkmDashboard from "./umkm/dashboard"; const Ekonomi = new Elysia({ prefix: "/ekonomi", @@ -21,6 +25,10 @@ const Ekonomi = new Elysia({ .use(LowonganKerja) .use(ProgramKemiskinan) .use(StrukturOrganisasi) +.use(Umkm) +.use(ProdukUmkm) +.use(PenjualanProduk) +.use(UmkmDashboard) .use(GrafikUsiaKerjaYangMenganggur) .use(GrafikMenganggurBerdasarkanPendidikan) .use(JumlahPendudukMiskin) diff --git a/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/create.ts b/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/create.ts new file mode 100644 index 00000000..5837f257 --- /dev/null +++ b/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/create.ts @@ -0,0 +1,35 @@ +import prisma from "@/lib/prisma"; +import { Context } from "elysia"; + +async function umkmCreate(context: Context) { + const body = context.body as any; + + try { + const data = await prisma.umkm.create({ + data: { + nama: body.nama, + pemilik: body.pemilik, + deskripsi: body.deskripsi, + alamat: body.alamat, + kontak: body.kontak, + imageId: body.imageId, + kategoriId: body.kategoriId, + isActive: body.isActive ?? true, + }, + }); + + return { + success: true, + message: "Berhasil membuat UMKM baru", + data, + }; + } catch (e) { + console.error("Error di umkmCreate:", e); + return { + success: false, + message: "Gagal membuat UMKM baru", + }; + } +} + +export default umkmCreate; diff --git a/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/dashboard/detailPenjualan.ts b/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/dashboard/detailPenjualan.ts new file mode 100644 index 00000000..afc43a99 --- /dev/null +++ b/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/dashboard/detailPenjualan.ts @@ -0,0 +1,72 @@ +import prisma from "@/lib/prisma"; +import { Context } from "elysia"; + +async function umkmDashboardDetailPenjualan(context: Context) { + const periode = (context.query.periode as string) || + `${new Date().getFullYear()}-${String(new Date().getMonth() + 1).padStart(2, '0')}`; + + const date = new Date(periode + "-01"); + date.setMonth(date.getMonth() - 1); + const periodeLalu = `${date.getFullYear()}-${String(date.getMonth() + 1).padStart(2, '0')}`; + + try { + // Ambil semua produk yang punya penjualan bulan ini atau bulan lalu + const [produkSkrg, produkLalu, allProduks] = await Promise.all([ + prisma.penjualanProduk.groupBy({ + by: ['produkId'], + where: { periode, deletedAt: null }, + _sum: { totalNilai: true, jumlah: true } + }), + prisma.penjualanProduk.groupBy({ + by: ['produkId'], + where: { periode: periodeLalu, deletedAt: null }, + _sum: { totalNilai: true } + }), + prisma.produkUmkm.findMany({ + where: { deletedAt: null }, + select: { id: true, nama: true, stok: true } + }) + ]); + + const data = allProduks.map(p => { + const skrgRaw = produkSkrg.find(s => s.produkId === p.id)?._sum || { totalNilai: 0, jumlah: 0 }; + const laluRaw = produkLalu.find(l => l.produkId === p.id)?._sum || { totalNilai: 0 }; + + const skrg = { + totalNilai: skrgRaw.totalNilai || 0, + jumlah: skrgRaw.jumlah || 0 + }; + const lalu = { + totalNilai: laluRaw.totalNilai || 0 + }; + + let trend = "stable"; + if (skrg.totalNilai > lalu.totalNilai) trend = "up"; + if (skrg.totalNilai < lalu.totalNilai) trend = "down"; + + let statusStok = "Aman"; + if (p.stok < 5) statusStok = "Rendah"; + else if (p.stok < 20) statusStok = "Menipis"; + + return { + namaProduk: p.nama, + penjualanBulanIni: skrg.totalNilai, + penjualanBulanLalu: lalu.totalNilai, + trend, + volume: skrg.jumlah, + stok: p.stok, + statusStok + }; + }); + + return { + success: true, + data + }; + } catch (e) { + console.error("Error di umkmDashboardDetailPenjualan:", e); + return { success: false, message: "Gagal mengambil detail penjualan dashboard" }; + } +} + +export default umkmDashboardDetailPenjualan; diff --git a/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/dashboard/index.ts b/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/dashboard/index.ts new file mode 100644 index 00000000..c7554834 --- /dev/null +++ b/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/dashboard/index.ts @@ -0,0 +1,16 @@ +import Elysia from "elysia"; +import umkmDashboardKpi from "./kpi"; +import umkmDashboardRingSummary from "./ringSummary"; +import umkmDashboardTopProduk from "./topProduk"; +import umkmDashboardDetailPenjualan from "./detailPenjualan"; + +const UmkmDashboard = new Elysia({ + prefix: "/umkm/dashboard", + tags: ["Ekonomi/UMKM Dashboard"], +}) + .get("/kpi", umkmDashboardKpi) + .get("/ringkasan-penjualan", umkmDashboardRingSummary) + .get("/top-produk", umkmDashboardTopProduk) + .get("/detail-penjualan", umkmDashboardDetailPenjualan); + +export default UmkmDashboard; diff --git a/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/dashboard/kpi.ts b/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/dashboard/kpi.ts new file mode 100644 index 00000000..23e925b5 --- /dev/null +++ b/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/dashboard/kpi.ts @@ -0,0 +1,49 @@ +import prisma from "@/lib/prisma"; +import { Context } from "elysia"; + +async function umkmDashboardKpi(context: Context) { + const periode = (context.query.periode as string) || + `${new Date().getFullYear()}-${String(new Date().getMonth() + 1).padStart(2, '0')}`; + + try { + const [umkmAktif, totalUmkm, omzetBulanan, kategoriTerbanyak] = await Promise.all([ + prisma.umkm.count({ where: { isActive: true, deletedAt: null } }), + prisma.umkm.count({ where: { deletedAt: null } }), + prisma.penjualanProduk.aggregate({ + where: { periode, deletedAt: null }, + _sum: { totalNilai: true } + }), + prisma.umkm.groupBy({ + by: ['kategoriId'], + _count: { _all: true }, + orderBy: { _count: { kategoriId: 'desc' } }, + take: 1 + }) + ]); + + // Ambil nama kategori jika ada + let kategoriNama = "-"; + if (kategoriTerbanyak.length > 0) { + const kat = await prisma.kategoriProduk.findUnique({ + where: { id: kategoriTerbanyak[0].kategoriId }, + select: { nama: true } + }); + kategoriNama = kat?.nama || "-"; + } + + return { + success: true, + data: { + umkmAktif, + totalUmkm, + omzetBulanan: omzetBulanan._sum.totalNilai || 0, + kategoriTerbanyak: kategoriNama + } + }; + } catch (e) { + console.error("Error di umkmDashboardKpi:", e); + return { success: false, message: "Gagal mengambil data KPI dashboard" }; + } +} + +export default umkmDashboardKpi; diff --git a/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/dashboard/ringSummary.ts b/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/dashboard/ringSummary.ts new file mode 100644 index 00000000..a868004c --- /dev/null +++ b/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/dashboard/ringSummary.ts @@ -0,0 +1,52 @@ +import prisma from "@/lib/prisma"; +import { Context } from "elysia"; + +async function umkmDashboardRingSummary(context: Context) { + const periode = (context.query.periode as string) || + `${new Date().getFullYear()}-${String(new Date().getMonth() + 1).padStart(2, '0')}`; + + // Hitung periode bulan lalu + const date = new Date(periode + "-01"); + date.setMonth(date.getMonth() - 1); + const periodeLalu = `${date.getFullYear()}-${String(date.getMonth() + 1).padStart(2, '0')}`; + + try { + const [penjualanSkrg, penjualanLalu, produkAktif, totalTransaksi] = await Promise.all([ + prisma.penjualanProduk.aggregate({ + where: { periode, deletedAt: null }, + _sum: { totalNilai: true } + }), + prisma.penjualanProduk.aggregate({ + where: { periode: periodeLalu, deletedAt: null }, + _sum: { totalNilai: true } + }), + prisma.produkUmkm.count({ where: { isActive: true, deletedAt: null } }), + prisma.penjualanProduk.count({ where: { periode, deletedAt: null } }) + ]); + + const skrg = penjualanSkrg._sum.totalNilai || 0; + const lalu = penjualanLalu._sum.totalNilai || 0; + + let persentasePerubahan = 0; + if (lalu > 0) { + persentasePerubahan = ((skrg - lalu) / lalu) * 100; + } else if (skrg > 0) { + persentasePerubahan = 100; + } + + return { + success: true, + data: { + totalPenjualan: skrg, + persentasePerubahan: Math.round(persentasePerubahan * 100) / 100, + produkAktif, + totalTransaksi + } + }; + } catch (e) { + console.error("Error di umkmDashboardRingSummary:", e); + return { success: false, message: "Gagal mengambil ringkasan dashboard" }; + } +} + +export default umkmDashboardRingSummary; diff --git a/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/dashboard/topProduk.ts b/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/dashboard/topProduk.ts new file mode 100644 index 00000000..62f11aca --- /dev/null +++ b/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/dashboard/topProduk.ts @@ -0,0 +1,42 @@ +import prisma from "@/lib/prisma"; +import { Context } from "elysia"; + +async function umkmDashboardTopProduk(context: Context) { + const periode = (context.query.periode as string) || + `${new Date().getFullYear()}-${String(new Date().getMonth() + 1).padStart(2, '0')}`; + + try { + const topPenjualan = await prisma.penjualanProduk.groupBy({ + by: ['produkId'], + where: { periode, deletedAt: null }, + _sum: { totalNilai: true, jumlah: true }, + orderBy: { _sum: { totalNilai: 'desc' } }, + take: 3 + }); + + const data = await Promise.all(topPenjualan.map(async (item) => { + const produk = await prisma.produkUmkm.findUnique({ + where: { id: item.produkId }, + include: { umkm: true } + }); + + return { + namaProduk: produk?.nama || "Unknown", + namaUmkm: produk?.umkm.nama || "Unknown", + totalPenjualan: item._sum.totalNilai || 0, + jumlahTerjual: item._sum.jumlah || 0, + growth: 0 // logic growth bisa ditambah jika diperlukan + }; + })); + + return { + success: true, + data + }; + } catch (e) { + console.error("Error di umkmDashboardTopProduk:", e); + return { success: false, message: "Gagal mengambil top produk" }; + } +} + +export default umkmDashboardTopProduk; diff --git a/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/del.ts b/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/del.ts new file mode 100644 index 00000000..c2844ed0 --- /dev/null +++ b/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/del.ts @@ -0,0 +1,31 @@ +import prisma from "@/lib/prisma"; +import { Context } from "elysia"; + +async function umkmDelete(context: Context) { + const id = context.params.id; + + try { + // Soft delete + const data = await prisma.umkm.update({ + where: { id }, + data: { + deletedAt: new Date(), + isActive: false, + }, + }); + + return { + success: true, + message: "Berhasil menghapus UMKM", + data, + }; + } catch (e) { + console.error("Error di umkmDelete:", e); + return { + success: false, + message: "Gagal menghapus UMKM", + }; + } +} + +export default umkmDelete; diff --git a/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/findMany.ts b/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/findMany.ts new file mode 100644 index 00000000..ed4eafe3 --- /dev/null +++ b/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/findMany.ts @@ -0,0 +1,59 @@ +/* eslint-disable @typescript-eslint/no-explicit-any */ +import prisma from "@/lib/prisma"; +import { Context } from "elysia"; + +async function umkmFindMany(context: Context) { + const page = Number(context.query.page) || 1; + const limit = Number(context.query.limit) || 10; + const search = (context.query.search as string) || ''; + const kategoriId = context.query.kategoriId as string | undefined; + const skip = (page - 1) * limit; + + const where: any = { deletedAt: null }; + + if (kategoriId) { + where.kategoriId = kategoriId; + } + + if (search) { + where.OR = [ + { nama: { contains: search, mode: 'insensitive' } }, + { pemilik: { contains: search, mode: 'insensitive' } }, + { alamat: { contains: search, mode: 'insensitive' } }, + ]; + } + + try { + const [data, total] = await Promise.all([ + prisma.umkm.findMany({ + where, + include: { + image: true, + kategori: true, + }, + skip, + take: limit, + orderBy: { createdAt: 'desc' }, + }), + prisma.umkm.count({ where }), + ]); + + return { + success: true, + message: "Berhasil mengambil data UMKM", + data, + page, + limit, + total, + totalPages: Math.ceil(total / limit), + }; + } catch (e) { + console.error("Error di umkmFindMany:", e); + return { + success: false, + message: "Gagal mengambil data UMKM", + }; + } +} + +export default umkmFindMany; diff --git a/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/findManyAll.ts b/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/findManyAll.ts new file mode 100644 index 00000000..acd72b30 --- /dev/null +++ b/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/findManyAll.ts @@ -0,0 +1,31 @@ +import prisma from "@/lib/prisma"; + +async function umkmFindManyAll() { + try { + const data = await prisma.umkm.findMany({ + where: { + isActive: true, + deletedAt: null, + }, + select: { + id: true, + nama: true, + }, + orderBy: { nama: 'asc' }, + }); + + return { + success: true, + message: "Berhasil mengambil semua UMKM aktif", + data, + }; + } catch (e) { + console.error("Error di umkmFindManyAll:", e); + return { + success: false, + message: "Gagal mengambil data UMKM", + }; + } +} + +export default umkmFindManyAll; diff --git a/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/findUnique.ts b/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/findUnique.ts new file mode 100644 index 00000000..5945381a --- /dev/null +++ b/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/findUnique.ts @@ -0,0 +1,41 @@ +import prisma from "@/lib/prisma"; +import { Context } from "elysia"; + +async function umkmFindUnique(context: Context) { + const id = context.params.id; + + try { + const data = await prisma.umkm.findUnique({ + where: { id }, + include: { + image: true, + kategori: true, + produk: { + where: { deletedAt: null }, + include: { image: true } + } + }, + }); + + if (!data) { + return { + success: false, + message: "UMKM tidak ditemukan", + }; + } + + return { + success: true, + message: "Berhasil mengambil detail UMKM", + data, + }; + } catch (e) { + console.error("Error di umkmFindUnique:", e); + return { + success: false, + message: "Gagal mengambil detail UMKM", + }; + } +} + +export default umkmFindUnique; diff --git a/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/index.ts b/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/index.ts new file mode 100644 index 00000000..3e3011fe --- /dev/null +++ b/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/index.ts @@ -0,0 +1,53 @@ +import Elysia, { t } from "elysia"; +import umkmCreate from "./create"; +import umkmDelete from "./del"; +import umkmFindMany from "./findMany"; +import umkmFindManyAll from "./findManyAll"; +import umkmFindUnique from "./findUnique"; +import umkmUpdate from "./updt"; + +const Umkm = new Elysia({ + prefix: "/umkm", + tags: ["Ekonomi/UMKM"], +}) + .get("/find-many", umkmFindMany) + .get("/find-many-all", umkmFindManyAll) + .get("/:id", umkmFindUnique, { + params: t.Object({ + id: t.String(), + }), + }) + .post("/create", umkmCreate, { + body: t.Object({ + nama: t.String(), + pemilik: t.String(), + kategoriId: t.String(), + deskripsi: t.Optional(t.String()), + alamat: t.Optional(t.String()), + kontak: t.Optional(t.String()), + imageId: t.Optional(t.String()), + isActive: t.Optional(t.Boolean()), + }), + }) + .put("/:id", umkmUpdate, { + params: t.Object({ + id: t.String(), + }), + body: t.Object({ + nama: t.String(), + pemilik: t.String(), + kategoriId: t.String(), + deskripsi: t.Optional(t.String()), + alamat: t.Optional(t.String()), + kontak: t.Optional(t.String()), + imageId: t.Optional(t.String()), + isActive: t.Boolean(), + }), + }) + .delete("/del/:id", umkmDelete, { + params: t.Object({ + id: t.String(), + }), + }); + +export default Umkm; diff --git a/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/penjualan/create.ts b/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/penjualan/create.ts new file mode 100644 index 00000000..cf7a0420 --- /dev/null +++ b/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/penjualan/create.ts @@ -0,0 +1,56 @@ +import prisma from "@/lib/prisma"; +import { Context } from "elysia"; + +async function penjualanProdukCreate(context: Context) { + const body = context.body as any; + const tanggal = body.tanggal ? new Date(body.tanggal) : new Date(); + + // Format periode YYYY-MM + const periode = `${tanggal.getFullYear()}-${String(tanggal.getMonth() + 1).padStart(2, '0')}`; + + const totalNilai = body.jumlah * body.hargaSatuan; + + try { + // Gunakan transaction untuk update stok produk + const result = await prisma.$transaction(async (tx) => { + // 1. Catat penjualan + const penjualan = await tx.penjualanProduk.create({ + data: { + produkId: body.produkId, + jumlah: body.jumlah, + hargaSatuan: body.hargaSatuan, + totalNilai: totalNilai, + tanggal: tanggal, + periode: periode, + isActive: body.isActive ?? true, + }, + }); + + // 2. Update stok produk + await tx.produkUmkm.update({ + where: { id: body.produkId }, + data: { + stok: { + decrement: body.jumlah + } + } + }); + + return penjualan; + }); + + return { + success: true, + message: "Berhasil mencatat penjualan produk", + data: result, + }; + } catch (e) { + console.error("Error di penjualanProdukCreate:", e); + return { + success: false, + message: "Gagal mencatat penjualan produk", + }; + } +} + +export default penjualanProdukCreate; diff --git a/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/penjualan/del.ts b/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/penjualan/del.ts new file mode 100644 index 00000000..4a4c1a42 --- /dev/null +++ b/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/penjualan/del.ts @@ -0,0 +1,53 @@ +import prisma from "@/lib/prisma"; +import { Context } from "elysia"; + +async function penjualanProdukDelete(context: Context) { + const id = context.params.id; + + try { + const result = await prisma.$transaction(async (tx) => { + // 1. Ambil data penjualan + const data = await tx.penjualanProduk.findUnique({ + where: { id }, + select: { jumlah: true, produkId: true } + }); + + if (!data) throw new Error("Data penjualan tidak ditemukan"); + + // 2. Soft delete + const deleted = await tx.penjualanProduk.update({ + where: { id }, + data: { + deletedAt: new Date(), + isActive: false, + }, + }); + + // 3. Kembalikan stok produk + await tx.produkUmkm.update({ + where: { id: data.produkId }, + data: { + stok: { + increment: data.jumlah + } + } + }); + + return deleted; + }); + + return { + success: true, + message: "Berhasil menghapus data penjualan dan mengembalikan stok", + data: result, + }; + } catch (e) { + console.error("Error di penjualanProdukDelete:", e); + return { + success: false, + message: "Gagal menghapus data penjualan", + }; + } +} + +export default penjualanProdukDelete; diff --git a/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/penjualan/findMany.ts b/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/penjualan/findMany.ts new file mode 100644 index 00000000..512f89dd --- /dev/null +++ b/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/penjualan/findMany.ts @@ -0,0 +1,58 @@ +/* eslint-disable @typescript-eslint/no-explicit-any */ +import prisma from "@/lib/prisma"; +import { Context } from "elysia"; + +async function penjualanProdukFindMany(context: Context) { + const page = Number(context.query.page) || 1; + const limit = Number(context.query.limit) || 10; + const produkId = context.query.produkId as string | undefined; + const periode = context.query.periode as string | undefined; // YYYY-MM + const skip = (page - 1) * limit; + + const where: any = { deletedAt: null }; + + if (produkId) { + where.produkId = produkId; + } + + if (periode) { + where.periode = periode; + } + + try { + const [data, total] = await Promise.all([ + prisma.penjualanProduk.findMany({ + where, + include: { + produk: { + include: { + umkm: true + } + } + }, + skip, + take: limit, + orderBy: { tanggal: 'desc' }, + }), + prisma.penjualanProduk.count({ where }), + ]); + + return { + success: true, + message: "Berhasil mengambil data penjualan produk", + data, + page, + limit, + total, + totalPages: Math.ceil(total / limit), + }; + } catch (e) { + console.error("Error di penjualanProdukFindMany:", e); + return { + success: false, + message: "Gagal mengambil data penjualan produk", + }; + } +} + +export default penjualanProdukFindMany; diff --git a/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/penjualan/findUnique.ts b/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/penjualan/findUnique.ts new file mode 100644 index 00000000..be403756 --- /dev/null +++ b/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/penjualan/findUnique.ts @@ -0,0 +1,40 @@ +import prisma from "@/lib/prisma"; +import { Context } from "elysia"; + +async function penjualanProdukFindUnique(context: Context) { + const id = context.params.id; + + try { + const data = await prisma.penjualanProduk.findUnique({ + where: { id }, + include: { + produk: { + include: { + umkm: true + } + } + }, + }); + + if (!data) { + return { + success: false, + message: "Data penjualan tidak ditemukan", + }; + } + + return { + success: true, + message: "Berhasil mengambil detail penjualan produk", + data, + }; + } catch (e) { + console.error("Error di penjualanProdukFindUnique:", e); + return { + success: false, + message: "Gagal mengambil detail penjualan produk", + }; + } +} + +export default penjualanProdukFindUnique; diff --git a/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/penjualan/index.ts b/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/penjualan/index.ts new file mode 100644 index 00000000..5bcd6359 --- /dev/null +++ b/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/penjualan/index.ts @@ -0,0 +1,45 @@ +import Elysia, { t } from "elysia"; +import penjualanProdukCreate from "./create"; +import penjualanProdukDelete from "./del"; +import penjualanProdukFindMany from "./findMany"; +import penjualanProdukFindUnique from "./findUnique"; +import penjualanProdukUpdate from "./updt"; + +const PenjualanProduk = new Elysia({ + prefix: "/umkm/penjualan", + tags: ["Ekonomi/UMKM Penjualan"], +}) + .get("/find-many", penjualanProdukFindMany) + .get("/:id", penjualanProdukFindUnique, { + params: t.Object({ + id: t.String(), + }), + }) + .post("/create", penjualanProdukCreate, { + body: t.Object({ + produkId: t.String(), + jumlah: t.Number(), + hargaSatuan: t.Number(), + tanggal: t.Optional(t.String()), + isActive: t.Optional(t.Boolean()), + }), + }) + .put("/:id", penjualanProdukUpdate, { + params: t.Object({ + id: t.String(), + }), + body: t.Object({ + produkId: t.String(), + jumlah: t.Number(), + hargaSatuan: t.Number(), + tanggal: t.Optional(t.String()), + isActive: t.Boolean(), + }), + }) + .delete("/del/:id", penjualanProdukDelete, { + params: t.Object({ + id: t.String(), + }), + }); + +export default PenjualanProduk; diff --git a/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/penjualan/updt.ts b/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/penjualan/updt.ts new file mode 100644 index 00000000..c4f05fb2 --- /dev/null +++ b/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/penjualan/updt.ts @@ -0,0 +1,83 @@ +import prisma from "@/lib/prisma"; +import { Context } from "elysia"; + +async function penjualanProdukUpdate(context: Context) { + const body = context.body as any; + const id = context.params.id; + const tanggal = body.tanggal ? new Date(body.tanggal) : new Date(); + const periode = `${tanggal.getFullYear()}-${String(tanggal.getMonth() + 1).padStart(2, '0')}`; + const totalNilai = body.jumlah * body.hargaSatuan; + + try { + const result = await prisma.$transaction(async (tx) => { + // 1. Ambil data lama untuk hitung selisih stok + const oldData = await tx.penjualanProduk.findUnique({ + where: { id }, + select: { jumlah: true, produkId: true } + }); + + if (!oldData) throw new Error("Data penjualan tidak ditemukan"); + + // 2. Update penjualan + const updated = await tx.penjualanProduk.update({ + where: { id }, + data: { + produkId: body.produkId, + jumlah: body.jumlah, + hargaSatuan: body.hargaSatuan, + totalNilai: totalNilai, + tanggal: tanggal, + periode: periode, + isActive: body.isActive, + }, + }); + + // 3. Update stok jika produk sama, sesuaikan selisih + if (oldData.produkId === body.produkId) { + const diff = body.jumlah - oldData.jumlah; + await tx.produkUmkm.update({ + where: { id: body.produkId }, + data: { + stok: { + decrement: diff + } + } + }); + } else { + // Jika produk berubah, kembalikan stok lama dan kurangi stok baru + await tx.produkUmkm.update({ + where: { id: oldData.produkId }, + data: { + stok: { + increment: oldData.jumlah + } + } + }); + await tx.produkUmkm.update({ + where: { id: body.produkId }, + data: { + stok: { + decrement: body.jumlah + } + } + }); + } + + return updated; + }); + + return { + success: true, + message: "Berhasil memperbarui data penjualan", + data: result, + }; + } catch (e) { + console.error("Error di penjualanProdukUpdate:", e); + return { + success: false, + message: "Gagal memperbarui data penjualan", + }; + } +} + +export default penjualanProdukUpdate; diff --git a/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/produk/create.ts b/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/produk/create.ts new file mode 100644 index 00000000..690c0219 --- /dev/null +++ b/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/produk/create.ts @@ -0,0 +1,34 @@ +import prisma from "@/lib/prisma"; +import { Context } from "elysia"; + +async function produkUmkmCreate(context: Context) { + const body = context.body as any; + + try { + const data = await prisma.produkUmkm.create({ + data: { + nama: body.nama, + harga: body.harga, + stok: body.stok ?? 0, + deskripsi: body.deskripsi, + umkmId: body.umkmId, + imageId: body.imageId, + isActive: body.isActive ?? true, + }, + }); + + return { + success: true, + message: "Berhasil membuat produk UMKM baru", + data, + }; + } catch (e) { + console.error("Error di produkUmkmCreate:", e); + return { + success: false, + message: "Gagal membuat produk UMKM baru", + }; + } +} + +export default produkUmkmCreate; diff --git a/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/produk/del.ts b/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/produk/del.ts new file mode 100644 index 00000000..549351ba --- /dev/null +++ b/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/produk/del.ts @@ -0,0 +1,31 @@ +import prisma from "@/lib/prisma"; +import { Context } from "elysia"; + +async function produkUmkmDelete(context: Context) { + const id = context.params.id; + + try { + // Soft delete + const data = await prisma.produkUmkm.update({ + where: { id }, + data: { + deletedAt: new Date(), + isActive: false, + }, + }); + + return { + success: true, + message: "Berhasil menghapus produk UMKM", + data, + }; + } catch (e) { + console.error("Error di produkUmkmDelete:", e); + return { + success: false, + message: "Gagal menghapus produk UMKM", + }; + } +} + +export default produkUmkmDelete; diff --git a/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/produk/findMany.ts b/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/produk/findMany.ts new file mode 100644 index 00000000..f545e2a2 --- /dev/null +++ b/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/produk/findMany.ts @@ -0,0 +1,64 @@ +/* eslint-disable @typescript-eslint/no-explicit-any */ +import prisma from "@/lib/prisma"; +import { Context } from "elysia"; + +async function produkUmkmFindMany(context: Context) { + const page = Number(context.query.page) || 1; + const limit = Number(context.query.limit) || 10; + const search = (context.query.search as string) || ''; + const umkmId = context.query.umkmId as string | undefined; + const kategoriId = context.query.kategoriId as string | undefined; + const skip = (page - 1) * limit; + + const where: any = { deletedAt: null }; + + if (umkmId) { + where.umkmId = umkmId; + } + + if (kategoriId) { + where.umkm = { + kategoriId: kategoriId + }; + } + + if (search) { + where.nama = { contains: search, mode: 'insensitive' }; + } + + try { + const [data, total] = await Promise.all([ + prisma.produkUmkm.findMany({ + where, + include: { + image: true, + umkm: { + include: { kategori: true } + } + }, + skip, + take: limit, + orderBy: { createdAt: 'desc' }, + }), + prisma.produkUmkm.count({ where }), + ]); + + return { + success: true, + message: "Berhasil mengambil data produk UMKM", + data, + page, + limit, + total, + totalPages: Math.ceil(total / limit), + }; + } catch (e) { + console.error("Error di produkUmkmFindMany:", e); + return { + success: false, + message: "Gagal mengambil data produk UMKM", + }; + } +} + +export default produkUmkmFindMany; diff --git a/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/produk/findUnique.ts b/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/produk/findUnique.ts new file mode 100644 index 00000000..5b6d8141 --- /dev/null +++ b/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/produk/findUnique.ts @@ -0,0 +1,42 @@ +import prisma from "@/lib/prisma"; +import { Context } from "elysia"; + +async function produkUmkmFindUnique(context: Context) { + const id = context.params.id; + + try { + const data = await prisma.produkUmkm.findUnique({ + where: { id }, + include: { + image: true, + umkm: true, + penjualan: { + where: { deletedAt: null }, + orderBy: { tanggal: 'desc' }, + take: 10 + } + }, + }); + + if (!data) { + return { + success: false, + message: "Produk UMKM tidak ditemukan", + }; + } + + return { + success: true, + message: "Berhasil mengambil detail produk UMKM", + data, + }; + } catch (e) { + console.error("Error di produkUmkmFindUnique:", e); + return { + success: false, + message: "Gagal mengambil detail produk UMKM", + }; + } +} + +export default produkUmkmFindUnique; diff --git a/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/produk/index.ts b/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/produk/index.ts new file mode 100644 index 00000000..c87a92c1 --- /dev/null +++ b/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/produk/index.ts @@ -0,0 +1,49 @@ +import Elysia, { t } from "elysia"; +import produkUmkmCreate from "./create"; +import produkUmkmDelete from "./del"; +import produkUmkmFindMany from "./findMany"; +import produkUmkmFindUnique from "./findUnique"; +import produkUmkmUpdate from "./updt"; + +const ProdukUmkm = new Elysia({ + prefix: "/umkm/produk", + tags: ["Ekonomi/UMKM Produk"], +}) + .get("/find-many", produkUmkmFindMany) + .get("/:id", produkUmkmFindUnique, { + params: t.Object({ + id: t.String(), + }), + }) + .post("/create", produkUmkmCreate, { + body: t.Object({ + nama: t.String(), + harga: t.Number(), + umkmId: t.String(), + stok: t.Optional(t.Number()), + deskripsi: t.Optional(t.String()), + imageId: t.Optional(t.String()), + isActive: t.Optional(t.Boolean()), + }), + }) + .put("/:id", produkUmkmUpdate, { + params: t.Object({ + id: t.String(), + }), + body: t.Object({ + nama: t.String(), + harga: t.Number(), + umkmId: t.String(), + stok: t.Number(), + deskripsi: t.Optional(t.String()), + imageId: t.Optional(t.String()), + isActive: t.Boolean(), + }), + }) + .delete("/del/:id", produkUmkmDelete, { + params: t.Object({ + id: t.String(), + }), + }); + +export default ProdukUmkm; diff --git a/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/produk/updt.ts b/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/produk/updt.ts new file mode 100644 index 00000000..302b5f11 --- /dev/null +++ b/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/produk/updt.ts @@ -0,0 +1,36 @@ +import prisma from "@/lib/prisma"; +import { Context } from "elysia"; + +async function produkUmkmUpdate(context: Context) { + const body = context.body as any; + const id = context.params.id; + + try { + const data = await prisma.produkUmkm.update({ + where: { id }, + data: { + nama: body.nama, + harga: body.harga, + stok: body.stok, + deskripsi: body.deskripsi, + umkmId: body.umkmId, + imageId: body.imageId, + isActive: body.isActive, + }, + }); + + return { + success: true, + message: "Berhasil memperbarui produk UMKM", + data, + }; + } catch (e) { + console.error("Error di produkUmkmUpdate:", e); + return { + success: false, + message: "Gagal memperbarui produk UMKM", + }; + } +} + +export default produkUmkmUpdate; diff --git a/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/updt.ts b/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/updt.ts new file mode 100644 index 00000000..f3592f8a --- /dev/null +++ b/src/app/api/[[...slugs]]/_lib/ekonomi/umkm/updt.ts @@ -0,0 +1,37 @@ +import prisma from "@/lib/prisma"; +import { Context } from "elysia"; + +async function umkmUpdate(context: Context) { + const body = context.body as any; + const id = context.params.id; + + try { + const data = await prisma.umkm.update({ + where: { id }, + data: { + nama: body.nama, + pemilik: body.pemilik, + deskripsi: body.deskripsi, + alamat: body.alamat, + kontak: body.kontak, + imageId: body.imageId, + kategoriId: body.kategoriId, + isActive: body.isActive, + }, + }); + + return { + success: true, + message: "Berhasil memperbarui data UMKM", + data, + }; + } catch (e) { + console.error("Error di umkmUpdate:", e); + return { + success: false, + message: "Gagal memperbarui data UMKM", + }; + } +} + +export default umkmUpdate;