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

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:

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
• panduan deploy lengkap: deploy-production.md
• contoh nginx: abelbirdnest.id.conf
• contoh 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