AbelBirdNest-Stock/docs/codex-handoff-2026-05-21.md

Codex Handoff - 2026-05-21

Dokumen ini menyimpan konteks kerja terbaru setelah rangkaian patch mobile, login publik, global search, locking satuan, dan workflow deploy artifact Linux.

Status Umum

• App aktif dikembangkan di Next.js + Prisma + PostgreSQL.
• Branch aktif: main
• Repo remote utama: https://git.iptek.co/wirabasalamah/AbelBirdNest-Stock.git
• Server target production saat ini: /var/www/abelbirdnest-web/AbelBirdNest-Stock

Ringkasan Perubahan Terbaru

1. Flow Mobile Purchase

• Menu Receipt di mobile sudah dikeluarkan dari bootstrap mobile.
• Submit purchase sekarang langsung:
  • membuat receipt
  • membuat receipt_lines
  • membuat lot
  • membuat alokasi realization terkait
• Endpoint utama:
  • src/app/api/v1/purchases/[id]/submit/route.ts
  • src/app/api/v1/mobile/bootstrap/route.ts
• Dokumen mobile sudah disesuaikan:
  • docs/mobile-api-blueprint.md

2. Formatting Qty dan Currency

• Formatting kg sekarang locale-aware.
• Angka hasil konversi gram ke kilogram tampil dengan format Indonesia yang benar, misalnya 10,5 kg.
• Currency di beberapa modul tidak lagi hardcoded dan mengikuti currency_code sistem.
• File sentral:
  • src/lib/formatters.ts

3. Dashboard Qty Fix

• Dashboard sebelumnya salah menampilkan angka seperti 94.290 kg untuk data gram yang seharusnya dibaca sebagai 94,29 kg.
• Perbaikan dilakukan dengan konversi qty berbasis unit.code sebelum agregasi.
• File utama:
  • src/lib/dashboard.ts

4. Login Publik, Contact Admin, dan Halaman Legal

• Login sekarang punya link publik yang benar-benar aktif:
  • Hubungi Admin
  • Bantuan
  • Kebijakan Privasi
  • Syarat & Ketentuan
• Hubungi Admin sekarang menuju halaman publik dengan form kirim email.
• Form ini memakai:
  • CAPTCHA aritmatika server-side
  • honeypot anti-spam
• Halaman publik legal/help tersedia tanpa login:
  • /contact-admin
  • /help-public
  • /privacy-policy
  • /terms-and-conditions
• Semua halaman publik ini sudah dua bahasa ID/EN.
• Email admin tidak lagi ditampilkan langsung di halaman publik; user diarahkan memakai form kontak admin.
• File utama:
  • src/features/auth/components/login-client.tsx
  • src/features/auth/components/contact-admin-client.tsx
  • src/app/api/v1/public/contact-admin/route.ts
  • src/lib/public-captcha.ts
  • middleware.ts

5. Global Search Header

• Search di topbar sebelumnya hanya placeholder.
• Sekarang search desktop:
  • full width sampai mendekati switch bahasa
  • real-time
  • menampilkan dropdown hasil
  • bisa klik hasil
  • bisa Enter untuk fallback ke halaman lot
• Search lintas:
  • lot
  • purchase
  • supplier/agent terkait
• Endpoint baru:
  • src/app/api/v1/global-search/route.ts
• Komponen utama:
  • src/components/layout/topbar-search.tsx
  • src/components/layout/topbar.tsx
• Halaman lot sudah membaca query URL ?search= agar fallback search juga benar-benar terpakai.

6. Master Satuan Dikunci

• Master Satuan sekarang dibuat fixed dan tidak lagi editable.
• Hanya dua satuan yang diizinkan:
  • gr
  • kg
• GET /api/v1/units akan memastikan dua unit itu selalu ada.
• POST, PUT, dan DELETE unit sekarang ditolak 403.
• Submenu Satuan disembunyikan dari sidebar.
• Kalau halaman /units dibuka langsung, tampilannya read-only.
• File utama:
  • src/features/units/lib/fixed-units.ts
  • src/app/api/v1/units/route.ts
  • src/app/api/v1/units/[id]/route.ts
  • src/components/master-data/units-client.tsx
  • src/config/navigation.ts

Prisma dan Build Cross-Platform

• Local Mac sempat rusak karena build Linux menimpa hasil prisma generate.
• Generator Prisma sekarang mencakup:
  • native
  • darwin-arm64
  • debian-openssl-3.0.x
• File:
  • prisma/schema.prisma

Workflow Deploy Artifact Linux

• Build di server sempat berat dan tidak stabil.
• Sekarang ada workflow artifact standalone Linux.
• Script:
  • deploy/scripts/build-linux-release.sh
• Karakteristik workflow ini:
  • build di Docker linux/amd64
  • install openssl di container
  • pakai NODE_OPTIONS=--max-old-space-size=4096
  • copy source ke /work agar tidak menimpa node_modules lokal Mac
  • artifact final: abelbirdnest-release.tar.gz
• Artifact final tidak membawa .env.production lokal.

Catatan Deploy Server Saat Ini

• Path app di server: /var/www/abelbirdnest-web/AbelBirdNest-Stock
• Struktur release yang dipakai sekarang diasumsikan:
  • upload artifact ke root repo server
  • extract ke releases/<timestamp>
  • symlink current diarahkan ke release aktif
• systemd yang benar untuk mode artifact:
  • WorkingDirectory=/var/www/abelbirdnest-web/AbelBirdNest-Stock/current
  • EnvironmentFile=/var/www/abelbirdnest-web/AbelBirdNest-Stock/.env.production
  • ExecStart=/usr/bin/node server.js

Verifikasi yang Sudah Dilakukan

• npx tsc --noEmit lolos setelah patch terbaru.
• Global search endpoint mengembalikan hasil yang benar untuk sample data lokal.
• GET /api/v1/units sekarang hanya mengembalikan gr dan kg.
• POST /api/v1/units sekarang ditolak dengan pesan lock master.

Risiko / Catatan yang Masih Relevan

• Build standalone lokal tetap menampilkan warning Prisma saat static generation jika DB lokal tidak aktif; warning ini tidak menggagalkan artifact.
• Production deploy sekarang punya dua mode historis:
  • mode lama repo root + npm run start
  • mode baru artifact standalone + node server.js Jangan campur keduanya pada instruksi deploy.
• Beberapa endpoint mobile/receipts/** masih ada untuk kompatibilitas lama, walaupun flow mobile baru tidak lagi menampilkan menu receipt.

Langkah Lanjutan Paling Masuk Akal

1. Deploy artifact terbaru ke server production.
2. Verifikasi:
   • search header aktif
   • halaman publik login aktif
   • Satuan tidak muncul di menu
   • GET /api/v1/units hanya gr dan kg
3. Jika perlu, lanjut bersihkan endpoint legacy yang sudah tidak dipakai lagi, terutama sekitar receipt mobile lama.

Catatan Penutup

• Handoff sebelumnya:
  • docs/codex-handoff-2026-05-19.md
• Handoff 2026-05-21 ini adalah snapshot terbaru dan seharusnya dipakai sebagai konteks utama lanjutan.