Update Codex handoff notes

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

@@ -0,0 +1,269 @@
+# Codex Handoff - 2026-05-23
+
+Dokumen ini adalah snapshot terbaru setelah penambahan halaman profile user, perapihan dashboard, penyiapan deploy Alpine Linux tanpa compile di server, release artifact `amd64` untuk Alpine `x86_64`, export master data lokal ke SQL, dan pemisahan alur purchase submit dari finalisasi penerimaan/lot.
+
+## Status Umum
+
+- App aktif dikembangkan di `Next.js + Prisma + PostgreSQL`.
+- Branch aktif:
+  `main`
+- Repo remote utama:
+  `https://git.iptek.co/wirabasalamah/AbelBirdNest-Stock.git`
+- Local workspace:
+  `/Users/wirabasalamah/Documents/Codex/abelbirdnest-web`
+- Server deploy terbaru yang sedang dibahas:
+  Alpine Linux `x86_64`, RAM `1 GB`, tanpa compile di server.
+
+## Ringkasan Perubahan Terbaru
+
+### 0. Alur Purchase, Penerimaan, Lot, dan Realisasi Dipisah
+
+- Alur lama:
+  - klik `Ajukan` di purchase langsung membuat `receipts`, `receipt_lines`, `inventory_lots`, allocation, dan ledger realisasi.
+  - efek sampingnya, purchase yang sudah diajukan tidak aman diedit karena `receipt_lines.purchase_line_id` masih mengarah ke `purchase_lines` lama.
+- Alur baru:
+  - `Purchase` dibuat/edit dulu seperti biasa.
+  - Klik `Ajukan` hanya mengubah status purchase menjadi `SUBMITTED`.
+  - Menu `Penerimaan` dipakai untuk membuat `receipt` dan `receipt_lines` dari purchase yang sudah `SUBMITTED`.
+  - Tombol `Buat lot` di detail receipt yang membuat:
+    - `inventory_lots`
+    - `lot_purchase_allocations`
+    - `purchase_realization_entries`
+    - `purchase_realization_summaries`
+  - Receipt ikut berubah menjadi `FINALIZED`.
+- Purchase masih bisa diedit selama belum punya `receipt` atau `lot`.
+- Jika purchase sudah punya `receipt` atau `lot`, endpoint update purchase sekarang menolak dengan pesan domain yang jelas, bukan error Prisma foreign key mentah.
+- Menu `Penerimaan` sekarang tampil di sidebar pada grup `Pembelian`.
+- Akses `Penerimaan` dibuka untuk:
+  - `ADMIN`
+  - `SYSTEM_ADMIN`
+  - `OWNER`
+  - `PURCHASING`
+  - `WAREHOUSE`
+- Label dan copy halaman `Penerimaan` sudah dirapikan agar mengikuti dictionary dua bahasa `ID/EN`, termasuk label tabel, tombol `Buat lot`/`Generate lots`, detail receipt, dan teks kosong lot.
+- Commit terkait:
+  - `44146a4 Split purchase submit from receipt finalization`
+  - `57896d3 Add receipt menu access`
+  - `1217529 Complete receipt translations`
+- File utama:
+  - [src/app/api/v1/purchases/[id]/route.ts](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/src/app/api/v1/purchases/[id]/route.ts)
+  - [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/receipts/route.ts](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/src/app/api/v1/receipts/route.ts)
+  - [src/app/api/v1/receipts/[id]/generate-lots/route.ts](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/src/app/api/v1/receipts/[id]/generate-lots/route.ts)
+  - [src/features/receipts/components/receipts-client.tsx](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/src/features/receipts/components/receipts-client.tsx)
+  - [src/features/purchases/components/purchases-client.tsx](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/src/features/purchases/components/purchases-client.tsx)
+  - [src/config/navigation.ts](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/src/config/navigation.ts)
+  - [src/config/access-control.ts](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/src/config/access-control.ts)
+  - [src/lib/i18n.ts](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/src/lib/i18n.ts)
+  - [src/types/purchase.ts](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/src/types/purchase.ts)
+
+### 1. Halaman Profile User
+
+- Area nama/avatar di topbar sekarang menjadi link ke `/profile`.
+- Halaman profile baru memungkinkan user update:
+  - `name`
+  - `email`
+  - `phone`
+- `username` sengaja dibuat read-only, tampil sebagai informasi akun tapi tidak bisa diedit.
+- Halaman profile juga menampilkan:
+  - role
+  - status akun
+  - status verifikasi email
+  - `user id`
+  - waktu `created_at`
+  - waktu `updated_at`
+- Setelah profile diupdate, session cookie ikut di-refresh agar nama di topbar langsung sinkron tanpa logout-login ulang.
+- File utama:
+  - [src/app/profile/page.tsx](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/src/app/profile/page.tsx)
+  - [src/features/auth/components/profile-client.tsx](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/src/features/auth/components/profile-client.tsx)
+  - [src/app/api/v1/auth/profile/route.ts](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/src/app/api/v1/auth/profile/route.ts)
+  - [src/components/layout/topbar.tsx](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/src/components/layout/topbar.tsx)
+  - [src/config/access-control.ts](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/src/config/access-control.ts)
+  - [src/lib/i18n.ts](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/src/lib/i18n.ts)
+
+### 2. Dashboard Spacing Fix
+
+- Dashboard sebelumnya punya section yang saling menempel vertikal.
+- Perbaikan dilakukan dengan wrapper `space-y-6` dan sedikit memperbesar gap pada grid metric.
+- Tujuannya murni visual: card-card lebih lega dan border panel tidak menumpuk.
+- File utama:
+  - [src/app/dashboard/page.tsx](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/src/app/dashboard/page.tsx)
+
+### 3. Deploy Alpine Linux Kosong
+
+- Sudah disiapkan panduan deploy khusus untuk server Alpine Linux kosong dengan RAM kecil.
+- Asumsi utama:
+  - server `x86_64`
+  - tidak ada build di server
+  - release diupload sebagai artifact siap jalan
+  - service manager memakai `OpenRC`
+- Dokumen baru:
+  - [docs/deploy-alpine-empty-server.md](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/docs/deploy-alpine-empty-server.md)
+- Service OpenRC baru:
+  - [deploy/openrc/abelbirdnest-web](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/deploy/openrc/abelbirdnest-web)
+- Service ini me-load `.env` sebelum menjalankan `node server.js`.
+
+### 4. Workflow Build Artifact Alpine
+
+- Ditambahkan script build artifact khusus Alpine:
+  - [deploy/scripts/build-alpine-release.sh](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/deploy/scripts/build-alpine-release.sh)
+- Script ini:
+  - build di Docker `node:22-alpine`
+  - copy output `standalone`
+  - memasukkan `.next/static`, `public`, `prisma`, `deploy`, dan doc deploy
+  - tidak membawa `.env` production nyata
+- Script sekarang mendukung:
+  - `DOCKER_PLATFORM=linux/amd64`
+- Ini penting karena server target adalah Alpine `x86_64`.
+
+### 5. Prisma Binary Targets untuk Alpine
+
+- Error deploy sempat muncul:
+  - Prisma client di artifact lama terbentuk untuk `linux-musl-arm64-openssl-3.0.x`
+  - server nyata butuh `linux-musl-openssl-3.0.x`
+- `binaryTargets` Prisma sekarang mencakup:
+  - `native`
+  - `darwin-arm64`
+  - `debian-openssl-3.0.x`
+  - `linux-musl-openssl-3.0.x`
+  - `linux-musl-arm64-openssl-3.0.x`
+- File utama:
+  - [prisma/schema.prisma](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/prisma/schema.prisma)
+
+### 6. User Production Awal `SYSTEM_ADMIN`
+
+- Sudah disiapkan SQL khusus untuk membuat user awal production:
+  - email: `wirabasalamah@gmail.com`
+  - username: `wirabasalamah`
+  - role: `SYSTEM_ADMIN`
+  - password: `P@ssw0rd`
+- File:
+  - [deploy/sql/seed-system-admin-wirabasalamah.sql](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/deploy/sql/seed-system-admin-wirabasalamah.sql)
+- Di server, user ini sudah diverifikasi ada, `ACTIVE`, dan `email_verified_at` terisi.
+
+### 7. Master Data Lokal Dibawa ke Server via SQL
+
+- Diputuskan tidak perlu build ulang hanya untuk membawa bank, currency, dan grade.
+- Data master lokal sudah diexport ke file SQL:
+  - [deploy/sql/master-seed-from-local-20260522.sql](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/deploy/sql/master-seed-from-local-20260522.sql)
+- Isi dump saat dibuat:
+  - `147` bank
+  - `48` currency
+  - `348` grade
+  - `0` grade buy price standards
+  - `0` grade sell price standards
+- Tabel yang dibawa:
+  - `banks`
+  - `currencies`
+  - `grades`
+  - `grade_buy_price_standards`
+  - `grade_sell_price_standards`
+
+## Artifact Release Penting
+
+- Artifact Linux historis:
+  - `abelbirdnest-release.tar.gz`
+  - `abelbirdnest-release-20260521-0841.tar.gz`
+- Artifact Alpine musl awal:
+  - `abelbirdnest-release-alpine-20260522-0508.tar.gz`
+  Catatan:
+  ini masih belum aman untuk server `x86_64` karena mismatch Prisma engine.
+- Artifact Alpine final yang benar untuk server `x86_64`:
+  - `abelbirdnest-release-alpine-amd64-20260522-0635.tar.gz`
+- File ini yang harus dipakai untuk deploy Alpine `x86_64`.
+
+## Temuan Deploy Server Alpine
+
+### 1. Port Runtime
+
+- Di lapangan, app berjalan di `3000`, bukan `3007`.
+- Redirect root `/` ke `/login` lalu setelah login aktif, `/login` akan redirect ke `/dashboard`.
+- Jadi jika `curl https://abelbirdnest.id/` menghasilkan payload redirect ke dashboard/login, itu berarti app sebenarnya hidup.
+
+### 2. Perilaku `/login`
+
+- `/login` memang otomatis redirect ke `/dashboard` kalau cookie session valid.
+- File:
+  - [middleware.ts](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/middleware.ts)
+  - [src/app/login/page.tsx](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/src/app/login/page.tsx)
+
+### 3. Certbot di Alpine
+
+- Untuk Alpine, pendekatan yang dipakai:
+  - `apk add certbot certbot-nginx`
+- Jika repo `community` belum aktif, perlu ditambahkan dulu di `/etc/apk/repositories`.
+
+## Verifikasi yang Sudah Dilakukan
+
+- `npm run typecheck` lolos setelah patch profile dan dashboard.
+- `npm run typecheck -- --pretty false` lolos setelah patch purchase/receipt/menu/translasi.
+- `npm run build` lokal Mac lolos.
+- Build artifact Alpine `amd64` melalui Docker emulasi berhasil dibuat.
+- Artifact `amd64` diverifikasi mengandung Prisma engine:
+  - `libquery_engine-linux-musl-openssl-3.0.x.so.node`
+- File SQL master data berhasil dibuat dari DB lokal.
+- User `wirabasalamah@gmail.com` di server sudah dicek via SQL dan memang ada.
+
+## Risiko / Catatan Penting
+
+- Jangan menghapus `purchase_lines` dari purchase yang sudah punya `receipt_lines`; gunakan flow baru lewat menu `Penerimaan` atau koreksi stok/reversal jika barang sudah masuk.
+- Untuk membersihkan satu purchase test beserta lot/receipt terkait, gunakan SQL transaksi terkontrol dan biarkan proses rollback jika lot sudah dipakai transaksi lain.
+- `psql` tidak menerima query param Prisma `?schema=public`; untuk akses manual gunakan URL DB tanpa query param itu, atau `options=-csearch_path%3Dpublic`.
+- Jangan pakai artifact Alpine non-`amd64` di server `x86_64`.
+- Jangan pakai artifact lama yang hanya punya engine `linux-musl-arm64`.
+- Untuk import master data:
+  - paling aman di database fresh
+  - kalau tabel sudah terisi, bisa bentrok `id` atau `unique key`
+- Build Alpine di Mac via emulasi `amd64` sangat lambat, jadi hindari rebuild jika cukup dengan upload SQL.
+- Build Next standalone masih mengeluarkan warning Prisma saat static generation jika DB lokal di builder tidak hidup; warning ini tidak menggagalkan artifact.
+
+## File yang Perlu Diperhatikan Pada Turn Berikutnya
+
+- [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/receipts/[id]/generate-lots/route.ts](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/src/app/api/v1/receipts/[id]/generate-lots/route.ts)
+- [src/features/receipts/components/receipts-client.tsx](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/src/features/receipts/components/receipts-client.tsx)
+- [src/config/navigation.ts](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/src/config/navigation.ts)
+- [src/config/access-control.ts](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/src/config/access-control.ts)
+- [prisma/schema.prisma](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/prisma/schema.prisma)
+- [src/app/api/v1/auth/profile/route.ts](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/src/app/api/v1/auth/profile/route.ts)
+- [src/features/auth/components/profile-client.tsx](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/src/features/auth/components/profile-client.tsx)
+- [src/app/dashboard/page.tsx](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/src/app/dashboard/page.tsx)
+- [deploy/scripts/build-alpine-release.sh](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/deploy/scripts/build-alpine-release.sh)
+- [deploy/openrc/abelbirdnest-web](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/deploy/openrc/abelbirdnest-web)
+- [deploy/sql/master-seed-from-local-20260522.sql](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/deploy/sql/master-seed-from-local-20260522.sql)
+- [deploy/sql/seed-system-admin-wirabasalamah.sql](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/deploy/sql/seed-system-admin-wirabasalamah.sql)
+- [docs/deploy-alpine-empty-server.md](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/docs/deploy-alpine-empty-server.md)
+
+## Langkah Lanjutan Paling Masuk Akal
+
+1. Untuk server dev, update dari Git dan rebuild:
+   - `git pull origin main`
+   - `npm install --include=dev`
+   - `npx prisma generate`
+   - `npm run build`
+   - restart service dev.
+2. Verifikasi flow baru:
+   - buat/edit purchase
+   - klik `Ajukan`
+   - buka `Pembelian -> Penerimaan`
+   - buat receipt
+   - klik `Buat lot`
+   - cek lot dan realisasi terbentuk.
+3. Jika server Alpine belum diupdate, upload:
+   - `abelbirdnest-release-alpine-amd64-20260522-0635.tar.gz`
+   - `master-seed-from-local-20260522.sql`
+   - `seed-system-admin-wirabasalamah.sql`
+4. Import master data lokal jika database fresh.
+5. Verifikasi login `SYSTEM_ADMIN`.
+6. Verifikasi halaman `/profile`:
+   - `name`, `email`, `phone` editable
+   - `username` readonly
+7. Verifikasi dashboard spacing.
+8. Kalau perlu artifact baru lagi, pakai script Alpine dengan `DOCKER_PLATFORM=linux/amd64`.
+
+## Catatan Penutup
+
+- Handoff sebelumnya:
+  - [docs/codex-handoff-2026-05-19.md](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/docs/codex-handoff-2026-05-19.md)
+  - [docs/codex-handoff-2026-05-21.md](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/docs/codex-handoff-2026-05-21.md)
+- Handoff `2026-05-23` ini adalah konteks terbaru dan seharusnya dipakai sebagai acuan utama lanjutan.