Files
AbelBirdNest-Stock/docs/project-spec/walet-screen-ui-spec.md

532 lines
6.7 KiB
Markdown

# Screen-by-Screen UI Spec
## Sistem Inventory Sarang Burung Walet
## 1. Login Screen
### Tujuan
Autentikasi user berdasarkan role.
### Section
- logo / app name
- email/phone field
- password field
- login button
- error message area
### Notes
- simple, fast, no clutter
---
## 2. Dashboard
### Tujuan
Memberi gambaran cepat kondisi bisnis.
### Layout
- top header
- metrics cards row
- charts row
- alerts row
- quick actions panel
### Data utama
- total stok aktif
- nilai inventory
- pembelian bulan ini
- penjualan bulan ini
- shrinkage bulan ini
- lot aging alert
### CTA
- buat pembelian
- receipt baru
- sales baru
- scan lot
---
## 3. Supplier List
### Tujuan
Kelola data supplier.
### Layout
- page header
- filter/search bar
- create supplier button
- table list
### Kolom table
- code
- name
- phone
- email
- bank_name
- bank_account_number
- status
- actions
### Detail view supplier
Section:
- informasi umum
- informasi pembayaran
- histori pembelian
---
## 4. Customer List
### Tujuan
Kelola data customer.
### Layout
- page header
- filter/search bar
- create customer button
- table list
### Kolom table
- code
- name
- phone
- email
- bank_name
- bank_account_number
- status
- actions
### Detail view customer
Section:
- informasi umum
- informasi pembayaran
- histori penjualan
---
## 5. Purchase List
### Tujuan
Lihat seluruh purchase.
### Layout
- filter bar
- summary chips
- purchase table
### Kolom
- purchase no
- supplier
- purchase date
- total
- status
- line count
- actions
---
## 6. Purchase Form
### Tujuan
Membuat purchase multi-line.
### Header section
- supplier select
- bank info preview supplier
- purchase date
- invoice supplier
- notes
### Lines section
Kolom:
- item type
- grade
- qty
- unit
- unit price
- subtotal
- classification status
- note
### Summary section
- total lines
- grand total
### Actions
- save draft
- submit
- cancel
---
## 7. Receipt List
### Tujuan
Melihat seluruh receipt.
### Kolom
- receipt no
- purchase no
- supplier
- receipt date
- status
- total lines
- actions
---
## 8. Receipt Form
### Tujuan
Menerima barang dan membentuk lot.
### Header section
- purchase ref
- supplier
- bank info supplier (readonly)
- receipt date
- receiver
### Lines section
- item
- ordered qty
- received qty
- accepted qty
- rejected qty
- unit cost
- warehouse
- location
### Actions
- save receipt
- finalize receipt
- generate lot
---
## 9. Stock Summary
### Tujuan
Ringkasan stok per jenis-grade-gudang.
### Table columns
- item type
- grade
- warehouse
- qty total
- inventory value
- active lot count
---
## 10. Stock Lot List
### Tujuan
Melihat semua lot aktif/detail.
### Filter
- supplier
- item type
- grade
- warehouse
- status
- aging
### Table columns
- lot code
- supplier
- item type
- grade
- available qty
- unit cost
- warehouse
- location
- aging
- status
- actions
---
## 11. Lot Detail
### Tujuan
Pusat traceability dan aksi lot.
### Section 1. Summary card
- lot code
- supplier
- item type
- grade
- available qty
- unit cost
- status
### Section 2. Supplier info
- supplier name
- bank_name
- bank_account_number
### Section 3. Quantity breakdown
- original qty
- available qty
- reserved qty
- damaged qty
- shrinkage qty
### Section 4. Traceability
- parent lot
- child lots
- purchase ref
- receipt ref
### Section 5. Movement history
- timeline/table of movements
### Section 6. Sales usage
- invoice list
- allocated qty
- customer
### Actions
- hold
- release
- transfer
- regrade
- print label
---
## 12. Sorting Session Form
### Tujuan
Pecah satu lot menjadi beberapa hasil.
### Section
- source lot selector
- source lot summary
- results table
- shrinkage input
- reject input
- notes
### Result columns
- item type
- grade
- qty result
- cost
---
## 13. Regrade Form
### Tujuan
Ubah sebagian qty lot ke grade baru.
### Fields
- source lot
- source grade
- target grade
- qty
- reason
- notes
### Preview
- qty remaining source
- target lot result
---
## 14. Sales List
### Tujuan
Lihat semua sales order.
### Kolom
- sales no
- customer
- customer bank
- sales date
- grand total
- costing total
- gross margin
- status
- actions
---
## 15. Sales Form
### Tujuan
Membuat order penjualan.
### Header section
- customer select
- customer bank info preview
- sales date
- notes
### Line section
- item type
- grade
- qty
- unit
- selling price
- subtotal
### Summary
- grand total
### Actions
- save draft
- continue to allocation
---
## 16. Allocation Screen
### Tujuan
Memecah kebutuhan sales line ke beberapa lot.
### Left panel
- sales line summary
- qty required
- qty allocated
- qty remaining
### Main table
- lot code
- supplier
- available qty
- unit cost
- received at
- FIFO badge
- allocate qty input
### Bottom summary
- total allocated
- total cost
- avg cost
- validation state
### Actions
- auto allocate
- clear allocation
- save allocation
---
## 17. Picking Screen
### Tujuan
Konfirmasi pengambilan aktual.
### Section
- sales summary
- QR scanner panel
- allocation rows
### Row fields
- lot code
- allocated qty
- picked qty
- variance
- status
### Actions
- confirm picking
- report variance
---
## 18. Barcode Lookup Screen
### Tujuan
Lookup cepat setelah scan.
### Section
- scanner
- manual input
- result summary card
- trace summary
- quick actions
### Quick actions
- open lot detail
- transfer
- hold/release
- print label
---
## 19. Adjustment Form
### Tujuan
Input adjustment dan shrinkage.
### Fields
- lot
- lot snapshot
- adjustment type
- reason
- qty before
- qty change
- qty after preview
- cost impact preview
- notes
### Actions
- save draft
- submit / post
---
## 20. Returns Screens
### Sales Return
- sales ref
- customer
- item lines
- lot ref jika ada
- qty return
- condition
- resolution
### Purchase Return
- purchase ref
- supplier
- lot ref
- qty return
- cost
- notes
---
## 21. Reports
### Layout umum
- report header
- filter bar
- summary cards
- chart section
- data table
- export buttons
### Report yang perlu didesain
- stock summary
- stock lots
- purchase history
- sales margin
- supplier quality
- shrinkage
- traceability
---
## 22. Mobile-Specific Screens
Prioritas mobile:
- barcode scan
- receipt quick input
- transfer lot
- picking
- lot lookup
### Design notes mobile
- large touch targets
- sticky action button
- simplified data layout
- bottom sheet for actions
---
## 23. UI States yang Harus Didukung
Untuk semua screen penting, designer perlu siapkan:
- empty state
- loading state
- error state
- success toast/dialog
- permission denied state
- no result state
---
## 24. Penutup
Dokumen ini dimaksudkan agar desainer bisa langsung membuat layout detail per screen di Figma, lengkap dengan section, field, table columns, dan interaction priority.