# RENCANA-MULTI-AREA.md — Persiapan Menuju 10+ Area

> **STATUS: DOKUMEN KEPUTUSAN.** Bagian "Keputusan" diisi oleh pemilik
> aplikasi. Selama sebuah keputusan belum dijawab, **AI dilarang menebak
> sendiri** — AI hanya boleh mengerjakan fase yang keputusannya sudah jelas.
>
> Fakta teknis ada di `docs/ARSITEKTUR.md`.

---

## 1. Sasaran

Aplikasi stok yang sekarang melayani satu area (Pantry) akan melayani **10
area atau lebih**, misalnya: pantry, gudang utama, gudang kebersihan, gudang
 ATK, dapur, dll. Setiap area punya stok, laporan, dan PIC sendiri.

Kabar baiknya: struktur database sudah dirancang per-area sejak awal (lihat
§4 `ARSITEKTUR.md`). Yang kurang adalah jembatan server (`resolveGudang`),
pemilih area di UI, dan model akses. Artinya ini pekerjaan besar tapi
**terstruktur**, bukan rewrite.

---

## 2. Keputusan yang HARUS dijawab dulu

Tandai ✅ (sudah diputuskan) atau ❓ (belum). AI mengerjakan fase yang
bergantung pada keputusan yang sudah ✅ saja.

### A. Model akses (❓) — paling menentukan
- [ ] **A1. Terbuka**: semua yang lolos PIN bisa melihat dan mengubah semua
      area. (Paling sederhana; cukup tambah pemilih area.)
- [ ] **A2. Per-PIC**: tiap PIN/user hanya melihat area miliknya. (Butuh
      tabel user, login per area, dan penyaringan di server.)
- [ ] **A3. Baca semua, tulis terbatas**: semua orang bisa melihat semua
      area, tapi mencatat/mengubah hanya di area yang ditugaskan.

### B. Katalog item (❓)
- [ ] **B1. Terpisah per area**: tiap area punya daftar item sendiri.
      (Sesuai struktur sekarang; paling cepat jadi.)
- [ ] **B2. Katalog bersama + stok per area**: daftar item dikumpul di satu
      tempat, stoknya terpisah per area. (Butuh tabel item global; kerja
      lebih besar, tapi memudahkan laporan lintas area dan menjaga nama item
      konsisten.)

### C. Laporan (❓)
- [ ] **C1. Per area saja** dulu, laporan gabungan menyusul.
- [ ] **C2. Langsung ada rekap semua area** sejak awal. (Butuh definisi: apa
      yang boleh dijumlahkan — item dengan nama sama? SKU sama?)

### D. Pembuatan area (❓)
- [ ] **D1. Lewat kode/seed**: admin menambah baris di `GUDANG_SEED` lalu
      deploy. (Sederhana, aman, tanpa UI admin.)
- [ ] **D2. Lewat UI admin**: ada layar CRUD area yang butuh PIN khusus.
      (Butuh endpoint + UI baru + proteksi.)

### E. PWA/offline (❓)
- [ ] **E1. Offline per area yang sedang dibuka** (cukup tambah area ke
      cache saat dipilih).
- [ ] **E2. Semua area tersimpan offline** (cache besar; perlu batas).

### F. Data lama (❓)
- [ ] Arsip legacy (`spld:items:archive`, `spld:inventory`) milik area mana?
      Saran: tetap diikat ke area pertama (Pantry) agar tidak ada data
      menggantung tanpa pemilik.

---

## 3. Persiapan yang harus disiapkan manusia sebelum AI mulai

1. **`git init` + commit pertama.** Proyek ini saat ini **bukan repo git**
   (walau `.gitignore` sudah ada). Tanpa git, AI besar yang mengerjakan
   banyak fase akan kehilangan jejak dan tidak bisa mundur saat salah.
   Ini prasyarat nomor satu.
2. **Backup database.** `database/database.sqlite` adalah satu-satunya
   salinan data nyata. Salin sebelum setiap fase migrasi:
   `cp database/database.sqlite backup/database-$(date +%F).sqlite`
3. **Daftar 10 area**: nama, kode (2–3 huruf, unik), dan PIC masing-masing.
   Kode dipakai untuk SKU item (`{KODE}-{NAMA}`, contoh `PN-BIJIKO`), jadi
   kode yang diubah nanti membuat SKU baru membingungkan — pilih sekali,
   jangan diganti.
4. **Jawab §2 di atas** (minimal A dan B — keduanya mengubah bentuk kerja
   secara drastis).

---

## 4. Roadmap bertahap

Setiap fase punya **kriteria selesai** yang bisa diverifikasi. AI mengerjakan
satu fase per sesi, lalu memperbarui dokumen ini (centang fase + catat
temuan).

### Fase 0 — Fondasi (bisa mulai sekarang)
- `git init`, commit, lalu `backup/` masuk `.gitignore`.
- Salin database.
- Isi keputusan §2.
- **Selesai kalau:** repo git ada, backup ada, §2 terjawab.

### Fase 1 — Area jadi entitas sungguhan
- Buat CRUD area (endpoint +, sebagai permulaan, hanya lewat kode: method
  `Store::createGudang()` dsb.).
- Ubah `resolveGudang()` agar membaca dari `Store::getGudang()` dan
  **menolak** `gudang` yang tidak dikenal (bukan diam-diam jatuh ke pantry).
- Naikkan `Stock::SCHEMA` bila perlu; migrasi sekali-jalan.
- **Selesai kalau:** dua area di database bisa disimpan itemnya tanpa saling
  menimpa, dan request dengan `gudang` asing mendapat 4xx.

### Fase 2 — Pemilih area di UI
- dropdown area di toolbar (sebelah bulan/tahun), pilihan disimpan di
  `localStorage`, dan `?gudang=` masuk URL (menggantikan `gudangList[0]`).
- Ganti area = muat ulang ledger + items area itu; semua state tanggal/periode
  tetap.
- **Selesai kalau:** pengguna bisa berpindah area dan tiap area punya stok
  berbeda yang tampil benar. (Uji dengan Playwright + mock.)

### Fase 3 — Keamanan & identitas
- Jawaban A1/A2/A3 diwujudkan: minimal, endpoint tulis memeriksa bahwa
  pengguna berhak atas area yang disentuh.
- Ganti `USER = 'admin'` dengan identitas sungguhan bila A2/A3 dipilih.
- **Selesai kalau:** PIN/Area yang tidak berhak ditolak server, bukan hanya
  disembunyikan UI.

### Fase 4 — Laporan lintas area
- Rekap semua area (jawaban C2) atau ditunda (C1).
- Pastikan cetak/PNG menyebut nama area di setiap halaman.

### Fase 5 — Pengelolaan area oleh admin
- Jawaban D2: UI tambah/edit/arsip area, beserta pemilihan PIC.

---

## 5. Cara menjaga AI tidak "ngaco"

1. **AI membaca `ARSITEKTUR.md` + dokumen ini dulu** sebelum menyentuh kode.
2. **Satu fase per sesi.** Kalau sesi sudah menyelesaikan fase, berhenti dan
   minta konfirmasi sebelum lanjut.
3. **Tidak ada perubahan diam-diam pada rumus** (`Stock.php`) atau struktur
   `kv`. Perubahan semacam itu wajib disebut eksplisit di jawaban AI.
4. **Verifikasi sebelum lapor**: `node --check`, `npm run build:css`,
   `npm run check:css`, plus cek Playwright bila menyentuh UI.
5. **Dokumen diperbarui di akhir setiap fase** — centang roadmap, catat
   keputusan baru di sini, perbarui fakta di `ARSITEKTUR.md`.
6. **Kalau ragu soal keputusan produk → tanya**, jangan memilih sendiri.
   Keputusan yang asal dipilih AI adalah sumber utama "ngaco" pada projek
   besar.
