feat(ekonomi): refactor umkm module with sales delete, stock validation, and ordering system

.claude/ARCHITECTURE.md

@@ -0,0 +1,42 @@
+# 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/<domain>.ts`
+- Admin CMS pages in `src/app/admin/(dashboard)/<domain>/`
+- Public pages in `src/app/darmasaba/(pages)/<domain>/`
+
+## 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 |

.claude/DATABASE.md

@@ -0,0 +1,16 @@
+# Database & Data Layer
+
+## Prisma Schema
+- 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.

.claude/DEPLOYMENT.md

@@ -0,0 +1,34 @@
+# Deployment
+
+## 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="..."
+MINIO_ENDPOINT="..."
+MINIO_ACCESS_KEY="..."
+MINIO_SECRET_KEY="..."
+MINIO_BUCKET="..."
+MINIO_USE_SSL="..."
+```
+
+## 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.