# 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`
  - `linux-musl-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 Alpine Linux agar cocok dengan server Alpine
  - 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 memakai timestamp:
    `abelbirdnest-release-YYYYMMDD-HHMMSS.tar.gz`
- Artifact final tidak membawa `.env.production` lokal.

### Catatan Tambahan 2026-05-26

- Server production memakai Alpine Linux dengan RAM sekitar 1 GB.
- Jangan compile/build di server.
- Artifact harus dibuat dari container Alpine, default script sekarang memakai `node:20-alpine`.
- Runtime server Alpine perlu `nodejs` dan `openssl`.
- Ukuran artifact runtime-only yang normal sekitar `43 MB`.
- Jika artifact membengkak sekitar `120 MB+`, kemungkinan Prisma CLI atau `node_modules` lengkap ikut terbawa. Jangan pakai varian besar itu untuk server 1 GB kecuali memang sengaja.
- Artifact runtime-only tidak dipakai untuk menjalankan `prisma migrate deploy` di server. Untuk update UI/app tanpa perubahan schema DB, cukup extract release baru lalu restart service.
- Jika nanti ada migration database, jalankan migration dari mesin build/admin yang punya dependency lengkap dan akses DB production, bukan dari server kecil.

## Catatan Deploy Server Saat Ini

- Path app aktif di server production saat ini:
  `/opt/abelbirdnest-web`
- Struktur release yang dipakai sekarang diasumsikan:
  - upload artifact ke root app server:
    `/opt/abelbirdnest-web`
  - extract ke `releases/<timestamp>`
  - symlink `current` diarahkan ke release aktif
- Folder aktif runtime:
  `/opt/abelbirdnest-web/current`
- Service server memakai OpenRC, bukan systemd.
- Service OpenRC production yang ditemukan:
  - `directory="/opt/abelbirdnest-web/current"`
  - `command="/usr/bin/node"`
  - `command_args="/opt/abelbirdnest-web/current/server.js"`
  - env yang dicek service:
    `/opt/abelbirdnest-web/current/.env`
- Karena service mencari `.env` di folder `current`, setiap release baru perlu copy `.env` dari release/current lama ke folder release baru sebelum `current` diarahkan ke release baru.
- Jangan gunakan path lama `/var/www/abelbirdnest-web/AbelBirdNest-Stock` untuk server ini kecuali service production memang sudah diubah.

### Command Manual Deploy Yang Dipakai

Di lokal:

```bash
scp abelbirdnest-release-YYYYMMDD-HHMMSS.tar.gz abelbirdnest@SERVER_IP:/opt/abelbirdnest-web/
```

Di server:

```bash
cd /opt/abelbirdnest-web
RELEASE_NAME=YYYYMMDD-HHMMSS
mkdir -p /opt/abelbirdnest-web/releases/$RELEASE_NAME
tar -xzf /opt/abelbirdnest-web/abelbirdnest-release-$RELEASE_NAME.tar.gz -C /opt/abelbirdnest-web/releases/$RELEASE_NAME
cp /opt/abelbirdnest-web/current/.env /opt/abelbirdnest-web/releases/$RELEASE_NAME/.env
mv /opt/abelbirdnest-web/current /opt/abelbirdnest-web/current-backup-$(date +%Y%m%d-%H%M%S) 2>/dev/null || true
ln -sfn /opt/abelbirdnest-web/releases/$RELEASE_NAME /opt/abelbirdnest-web/current
sudo chown -R abelbirdnest:abelbirdnest /opt/abelbirdnest-web
sudo rc-service abelbirdnest-web restart
sudo rc-service abelbirdnest-web status
curl -I http://127.0.0.1:3007/login
```

Jika `ln -sfn ... current` gagal dengan pesan `File exists`, berarti `current` masih folder biasa. Backup/rename folder itu dulu, lalu ulangi `ln -sfn`.

## 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.