Add public auth pages, global search, and fixed units

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

@@ -0,0 +1,176 @@
+# 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](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/src/app/api/v1/purchases/[id]/submit/route.ts)
+  - [src/app/api/v1/mobile/bootstrap/route.ts](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/src/app/api/v1/mobile/bootstrap/route.ts)
+- Dokumen mobile sudah disesuaikan:
+  - [docs/mobile-api-blueprint.md](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/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](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/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](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/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](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/src/features/auth/components/login-client.tsx)
+  - [src/features/auth/components/contact-admin-client.tsx](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/src/features/auth/components/contact-admin-client.tsx)
+  - [src/app/api/v1/public/contact-admin/route.ts](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/src/app/api/v1/public/contact-admin/route.ts)
+  - [src/lib/public-captcha.ts](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/src/lib/public-captcha.ts)
+  - [middleware.ts](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/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](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/src/app/api/v1/global-search/route.ts)
+- Komponen utama:
+  - [src/components/layout/topbar-search.tsx](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/src/components/layout/topbar-search.tsx)
+  - [src/components/layout/topbar.tsx](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/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](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/src/features/units/lib/fixed-units.ts)
+  - [src/app/api/v1/units/route.ts](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/src/app/api/v1/units/route.ts)
+  - [src/app/api/v1/units/[id]/route.ts](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/src/app/api/v1/units/[id]/route.ts)
+  - [src/components/master-data/units-client.tsx](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/src/components/master-data/units-client.tsx)
+  - [src/config/navigation.ts](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/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](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/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](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/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](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/docs/codex-handoff-2026-05-19.md)
+- Handoff `2026-05-21` ini adalah snapshot terbaru dan seharusnya dipakai sebagai konteks utama lanjutan.