Initial import of AbelBirdNest Stock

README.md

@@ -0,0 +1,124 @@
+# 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