125 lines
4.4 KiB
Markdown
125 lines
4.4 KiB
Markdown
# AbelBirdnest Stock
|
|
|
|
## Ringkasan
|
|
Repo ini berisi aplikasi `AbelBirdnest Stock` beserta paket lengkap dokumen perancangan untuk sistem inventory sarang burung walet berbasis lot/batch, traceability, sortasi, partial allocation penjualan, costing, barcode/QR, dan reporting.
|
|
|
|
## Update Terbaru
|
|
- master `suppliers` dan `customers` sekarang sudah mencakup field:
|
|
- `bank_name`
|
|
- `bank_account_number`
|
|
- perubahan ini sudah disinkronkan ke ERD, SQL schema, seed data, API/OpenAPI, Postman, mock response, UI data contract, dan dokumen terkait.
|
|
|
|
## Isi Paket
|
|
|
|
### 1. Business & Product
|
|
- `docs/project-spec/walet-alur-bisnis.md` / `.pdf`
|
|
- `docs/project-spec/walet-prd.md` / `.pdf`
|
|
- `docs/project-spec/walet-sample-transactions.md` / `.pdf`
|
|
- `docs/project-spec/walet-notification-approval-flow.md`
|
|
|
|
### 2. Database & Backend
|
|
- `docs/project-spec/walet-erd-dbml.dbml`
|
|
- `docs/project-spec/walet-schema.sql` / `.pdf`
|
|
- `docs/project-spec/walet-seed-data.sql`
|
|
- `docs/project-spec/walet-backend-architecture.md`
|
|
- `docs/project-spec/walet-api-spec.md`
|
|
- `docs/project-spec/walet-openapi.yaml`
|
|
- `docs/project-spec/walet-report-queries.sql`
|
|
- `docs/project-spec/walet-mock-responses.json`
|
|
|
|
### 3. Frontend & UX
|
|
- `docs/project-spec/walet-wireframe.md` / `.pdf`
|
|
- `docs/project-spec/walet-frontend-structure.md`
|
|
- `docs/project-spec/walet-component-tree.md`
|
|
- `docs/project-spec/walet-ui-data-contract.md`
|
|
- `docs/project-spec/walet-role-permission-matrix.md`
|
|
- `docs/project-spec/walet-sprint-breakdown.md`
|
|
|
|
### 4. API Testing
|
|
- `docs/project-spec/walet-postman-collection.json`
|
|
- `docs/project-spec/walet-postman-environment.json`
|
|
|
|
## Urutan Baca yang Disarankan
|
|
1. `docs/project-spec/walet-alur-bisnis.pdf`
|
|
2. `docs/project-spec/walet-prd.pdf`
|
|
3. `docs/project-spec/walet-erd-dbml.dbml`
|
|
4. `docs/project-spec/walet-schema.sql`
|
|
5. `docs/project-spec/walet-openapi.yaml`
|
|
6. `docs/project-spec/walet-wireframe.pdf`
|
|
7. `docs/project-spec/walet-frontend-structure.md`
|
|
8. `docs/project-spec/walet-sprint-breakdown.md`
|
|
|
|
## Catatan
|
|
Fokus desain saat ini tetap pada integritas lot, costing, traceability, serta kelengkapan data pembayaran untuk supplier dan customer.
|
|
|
|
## Frontend Setup Awal
|
|
Repo ini sekarang sudah memiliki scaffold aplikasi Next.js untuk memulai implementasi UI `AbelBirdnest Stock`.
|
|
|
|
### Stack yang dipakai
|
|
- Next.js App Router
|
|
- React + TypeScript
|
|
- Tailwind CSS
|
|
|
|
### Menjalankan project
|
|
```bash
|
|
npm install
|
|
npm run dev
|
|
```
|
|
|
|
Lalu buka `http://localhost:3000`.
|
|
|
|
Nama aplikasi yang tampil di UI adalah `AbelBirdnest Stock`.
|
|
|
|
### Menyalakan backend lokal
|
|
1. copy `.env.example` menjadi `.env`
|
|
2. pastikan PostgreSQL sudah jalan
|
|
3. buat database `abelbirdnest`
|
|
4. isi `AUTH_SECRET` di `.env`
|
|
5. jalankan:
|
|
|
|
```bash
|
|
npm run prisma:generate
|
|
npm run db:push
|
|
npm run dev
|
|
```
|
|
|
|
### Login Development
|
|
- halaman login: `http://localhost:3000/login`
|
|
- akun default development dibuat otomatis saat login pertama:
|
|
- `ADMIN`
|
|
- email: `admin@abelbirdnest.local`
|
|
- username: `admin`
|
|
- password: `admin123`
|
|
- `OWNER`
|
|
- email: `owner@abelbirdnest.local`
|
|
- username: `owner`
|
|
- password: `owner123`
|
|
- `PURCHASING`
|
|
- email: `purchasing@abelbirdnest.local`
|
|
- username: `purchasing`
|
|
- password: `purchasing123`
|
|
- `WAREHOUSE`
|
|
- email: `warehouse@abelbirdnest.local`
|
|
- username: `warehouse`
|
|
- password: `warehouse123`
|
|
- `QC`
|
|
- email: `qc@abelbirdnest.local`
|
|
- username: `qc`
|
|
- password: `qc123`
|
|
- `SALES`
|
|
- email: `sales@abelbirdnest.local`
|
|
- username: `sales`
|
|
- password: `sales123`
|
|
|
|
### Deploy Production
|
|
- contoh env production: [.env.production.example](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/.env.production.example)
|
|
- panduan deploy lengkap: [deploy-production.md](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/docs/deploy-production.md)
|
|
- contoh `nginx`: [abelbirdnest.id.conf](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/deploy/nginx/abelbirdnest.id.conf)
|
|
- contoh `systemd`: [abelbirdnest-web.service](/Users/wirabasalamah/Documents/Codex/abelbirdnest-web/deploy/systemd/abelbirdnest-web.service)
|
|
|
|
### Status Saat Ini
|
|
- layout aplikasi awal sudah hidup
|
|
- halaman dasar sudah tersedia untuk dashboard, suppliers, customers, purchases, receipts, lots, sorting, sales, barcode lookup, dan report stock summary
|
|
- modul `suppliers` sudah terhubung ke Prisma + PostgreSQL lewat endpoint `/api/v1/suppliers`
|
|
- modul lain masih placeholder dan belum tersambung ke backend/API riil
|