Kokonus Farm

Aplikasi web untuk tata kelola biaya produksi hidroponik Kokonus Farm (greenhouse rakit apung, Pekanbaru).

Menghubungkan data budidaya, kegagalan/susut, inventaris, penjualan, dan pembukuan supaya HPP per lubang/kg/pack bisa dihitung dan dipakai untuk harga jual serta laporan keuangan.

Fitur utama

• Peran (RBAC) — Owner, Admin, dan Petani dengan menu dan hak akses berbeda.
• Siklus produksi — semai, fase tanam, log kegagalan, panen, dan abort gagal total.
• Panen & HPP — laporan panen menunggu persetujuan Admin; perhitungan HPP dan jurnal WIP otomatis saat disetujui.
• Susut — klasifikasi kegagalan normal vs abnormal untuk alokasi biaya.
• Inventaris & active pack — stok bahan, pergerakan, alert di bawah minimum.
• Penjualan (sales order) — draft, konfirmasi, DP, packing, pengiriman, pelunasan.
• Jurnal & akuntansi — jurnal manual/smart, persetujuan, kunci periode, laporan (arus kas, laba rugi, neraca).
• Notifikasi — pusat notifikasi per user dengan deep link ke halaman terkait (panen, jurnal, stok, SO, reset sandi, dll.).
• Pengaturan — profil, ganti sandi, matrix peran, inbox notifikasi.

Tech stack

Lapisan	Teknologi
Frontend	Next.js 14 (App Router), React 18, TypeScript, Tailwind CSS, shadcn/Radix UI
Tabel & chart	TanStack Table, Recharts
Auth	NextAuth.js (credentials), bcrypt
Data	PostgreSQL, Prisma ORM
Export	jsPDF, xlsx
Uji	Playwright, TestCafe, skrip check:* di package.json

Prasyarat

• Node.js ≥ 18.18
• PostgreSQL (lokal atau hosted; Prisma butuh DATABASE_URL dan DIRECT_URL)
• npm (atau pnpm/yarn; contoh di bawah memakai npm)

Instalasi

git clone https://github.com/sapikkk/muhammadsyafiq213510100.git
cd muhammadsyafiq213510100
npm install
cp .env.example .env

Isi .env (lihat tabel di bawah), lalu migrasi dan seed fondasi (hanya bagan akun COA; tanpa data operasi demo):

npx prisma db push
npx prisma db seed
npm run dev

Opsional di .env: SEED_OWNER_EMAIL + SEED_OWNER_PASSWORD untuk satu akun Owner saat seed. Selain itu, isi varietas, inventaris, dan transaksi lewat aplikasi.

Hapus semua data lalu mulai kosong:

CONFIRM_DB_RESET=yes npm run db:reset

(Pastikan DATABASE_URL mengarah ke database yang benar — semua baris dihapus.)

Uji/sidang dengan data contoh: npm run seed:demo-lengkap (akun demo + inventaris + siklus).

Buka http://localhost:3000.

Variabel lingkungan

Variabel	Fungsi
DATABASE_URL	Koneksi PostgreSQL (bisa pooled di production)
DIRECT_URL	Koneksi langsung untuk migrasi Prisma
NEXTAUTH_URL	URL aplikasi (dev: http://localhost:3000)
NEXTAUTH_SECRET	Secret session NextAuth (string acak panjang)
AUDIT_BYPASS_RBAC	Hanya dev lokal: true + NODE_ENV!==production untuk audit semua route
SEED_OWNER_EMAIL / SEED_OWNER_PASSWORD	Opsional: Owner pertama saat npm run seed (min. 8 karakter sandi)
SEED_OWNER_NAMA	Opsional: nama tampilan Owner fondasi

Dev DB (cloud + pool): docs/deployment/dev-postgres-lokal.md. Deploy production: docs/deployment/panduan-deploy-vercel-postgres.md.

Perintah penting

npm run dev          # development
npm run build        # production build
npm run start        # jalankan build
npm run typecheck    # TypeScript
npm run lint         # ESLint
npm run test:e2e     # Playwright (butuh browser ter-install)
npm run db:reset     # hapus semua data + seed fondasi (butuh CONFIRM_DB_RESET=yes)
npm run seed:demo-lengkap  # data demo penuh (uji/sidang)
npm run seed:demo    # alur demo penjualan/jurnal (butuh seed demo lengkap dulu)

Skrip verifikasi domain (jurnal balance, SO, panen-WIP, dll.) ada di bagian check:* pada package.json.

Struktur direktori

muhammadsyafiq213510100/
├── app/                 # Route App Router (admin, owner, petani, API)
│   ├── actions/         # Server Actions
│   └── api/             # Route handlers REST
├── components/          # UI & layout
├── lib/                 # Logika domain (HPP, jurnal, inventaris, SO, notifikasi, …)
├── prisma/              # Schema, seed, migrasi
├── docs/                # PRD, agile, UCD, deployment, uji
├── e2e/                 # Smoke Playwright
├── scripts/             # Audit & sync tooling
└── types/               # Tipe shared (peran, dll.)

Orientasi arsitektur untuk kontributor/agent: AGENTS.md, graf graphify-out/ (jika sudah di-build).

API (ringkas)

Kebanyakan layar memakai Server Actions; endpoint REST di app/api/ dipakai untuk integrasi, export, dan beberapa alur mobile/legacy. Semua route dilindungi sesi kecuali auth.

Method	Contoh path	Kegunaan
*	/api/auth/[...nextauth]	Login/logout NextAuth
GET/POST	/api/production	Siklus produksi
POST	/api/harvest, /api/harvest/[id]/approve	Panen
GET/POST	/api/inventory, /api/inventory/movement	Inventaris
GET/POST	/api/sales-orders, /api/sales-orders/[id]/confirm	Sales order
GET/POST	/api/jurnal/smart	Smart jurnal
GET	/api/reports/monthly-summary, /api/export/cash-flow	Laporan & export

Daftar lengkap: app/api/**/route.ts.

Dokumentasi & mekanisme kerja

Hub utama: docs/README.md — peta folder, link cepat, dan rencana refine dokumen.

Di bawah ini ringkasan; path lama (docs/prd-…) tetap berupa redirect ke lokasi baru.

Konteks & backlog produk

Dokumen	Isi
docs/produk/project-context.md	Tujuan, persona Owner, batasan lingkup
docs/produk/prd-agile-kokonus-farm.md	PRD, epic, alur F1–F24
docs/agile/progress-backlog.md	Urutan user story & status ringkas
docs/agile/sprint-backlog-agile.md	Backlog sprint (mirror PRD)
docs/arsip/catatan-progres-teknis.md	Catatan progres teknis (arsip)
docs/desain/figma-flow-inventory.md	Inventaris layar Figma
docs/referensi/api.md	Kontrak API (acuan integrasi)

Agile — sprint, DoD, audit log

Dokumen	Isi
docs/agile/README.md	Hub Agile — board, sync script, alur merge
docs/agile/timeline-registry.md	Timeline 5 sprint (actual start, goal, velocity)
docs/agile/definition-of-done.md	DoD story & sprint
docs/agile/partial-delivery-policy.md	Partial delivery & label GitHub
docs/agile/audit-log.md	Log audit manajemen proyek
docs/agile/AC-VERIFIKASI-RISIKO.md	AC yang perlu verifikasi ulang
docs/agile/KONFIRMASI-GAP-GITHUB.md	Gap docs vs GitHub (keputusan PO)
docs/agile/github-field-guide.md	Project #1: Status, Iteration
docs/agile/merge-stack.md	Urutan merge PR / stack

Board: GitHub Project #1 · npm run sync:agile-progress · npm run sync:project-board

UCD (User-Centered Design)

Dokumen	Isi
docs/ucd/README.md	Hub UCD & increment v2
docs/ucd/increment-v2-akuntansi-logistik.md	Persona, pain, HMW v2
docs/ucd/skenario-narasi-ucd-agile.md	Narasi alur UCD + Agile v1
docs/desain/FLOW-NAV.md	Navigasi & alur per peran

Blueprint v2 (akuntansi & logistik)

Dokumen	Isi
docs/blueprint/README.md	Hub blueprint
docs/blueprint/akuntansi-logistik-hidroponik.md	COA, WIP, Smart Jurnal
docs/blueprint/VALIDASI-BACKLOG-PRD.md	Validasi backlog vs PRD
docs/blueprint/GITHUB-BACKLOG-DRAFT.md	Draft issue epic v2
docs/blueprint/rencana-implementasi-epic-v2.md	Rencana PR story v2-A.1–D.1

Uji — black-box, UAT, SUS, E2E

Dokumen	Isi
docs/testing/panduan-uji-dan-demo.md	Playwright, seed demo, pelatihan go-live (T5.9)
docs/testing/README.md	Indeks testing
docs/testing/tabel-blackbox-testing.md	Tabel master 231 langkah blackbox (BB-ID)
docs/testing/uji-blackbox.md	Notulensi uji black-box per US (AC, DoD, temuan)
docs/testing/DELETED-AGENTS-SKILLS-MANIFEST.md	Manifest skill agent (referensi)
e2e/smoke.spec.ts	Smoke E2E
e2e/sprint5-usability.spec.ts	Usability Sprint 5 (T5.1–T5.3)

SUS (10 butir, 6 responden) dan task usability dijelaskan di PRD § Sprint 5 dan docs/agile/sprints/sprint-05-qa.md.

Deploy & operasi

Dokumen	Isi
docs/deployment/panduan-deploy-vercel-postgres.md	Deploy Vercel, go-live, FINDING-01 pool DB

Audit teknis (RBAC, perf, keamanan)

Dokumen	Isi
docs/audit/README.md	Hub audit
docs/audit/SUMMARY.md	Ringkasan audit
docs/audit/MERGE-READINESS.md	Kesiapan merge
docs/audit/AGENT-RUNBOOK.md	Runbook audit agent
docs/audit/rbac.md	RBAC & bypass dev
docs/audit/security.md	Keamanan
docs/audit/frontend.md · backend.md	Lapisan aplikasi
docs/audit/qa.md · 07-verification.md	Verifikasi QA

Agent, Graphify, skills domain

Dokumen	Isi
AGENTS.md	Panduan agent (Graphify, Superpowers, backlog)
docs/agent/cursor-superpowers.md	Submodule Superpowers
docs/skills/README.md	Skills lokal
docs/agent/cursor-vendor-agents.md	Agency Agents, Karpathy, Semgrep (submodule + bootstrap)
docs/agent/cursor-agent-stack.md	Stack agent satu slash /kokonus
docs/skills/akuntansi-hidroponik/SKILL.md	Skill domain akuntansi hidroponik

Domain & notulensi

Dokumen	Isi
docs/produk/asumsi-benih-media.md	Asumsi benih & media
docs/arsip/notulensi-2026-10-09.md	Notulensi rapat

Kontribusi

1. Fork repositori sapikkk/muhammadsyafiq213510100.
2. Buat branch dari main (satu user story = satu branch, lihat AGENTS.md).
3. Commit dengan pesan jelas; pastikan npm run typecheck dan npm run build lulus.
4. Buka pull request ke main dengan ringkasan dan rencana uji.

Issue dan board: GitHub Project #1.

Lisensi & kredit

Repositori private milik sapikkk. Belum ada file LICENSE di root; hubungi pemilik repo sebelum redistribusi.

Stack open source: Next.js, Prisma, NextAuth, Radix UI, TanStack Table, dan dependensi lain di package.json.

---

Maintainer: @sapikkk · Repo: muhammadsyafiq213510100