Skip to content

About

WIP

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

PStore IMS

Inventory & Sales Management System untuk PStore — studi kasus distributor iPhone second/ex-international. Dibangun sebagai portfolio project yang mendemonstrasikan proses bisnis ERP inti (Procure-to-Pay, Inventory Management, Order-to-Cash, Record-to-Report) dengan arsitektur monolith modular.

Tentang Project

PStore menjual unit iPhone bekas dengan variasi kondisi (grading A/B/C), termasuk unit ex-international, ke dua segmen customer: end customer (retail) dan reseller (grosir). Sistem ini mengelola siklus penuh mulai dari pembelian unit dari supplier, pengelolaan stok per-unit (serial number/IMEI) lintas multi-warehouse, penjualan dengan dua tier harga dan opsi pembayaran cash/credit, hingga retur dua arah dan pencatatan keuangan otomatis.

Fitur Utama

  • Per-unit tracking — setiap iPhone dilacak individual berdasarkan serial number/IMEI, lengkap dengan grade kondisi, battery health, dan kelengkapan aksesoris
  • Multi-warehouse — stok tersebar di beberapa lokasi dengan kemampuan transfer antar gudang
  • FIFO costing — unit yang masuk lebih dulu diprioritaskan untuk dijual duluan
  • Dua tier customer — harga berbeda untuk end customer dan reseller
  • Payment term fleksibel — cash dan credit (dengan pelacakan piutang/AR)
  • Return management — retur dari customer maupun ke supplier
  • Pencatatan keuangan otomatis — jurnal, COGS, dan laporan (stock valuation, AR/AP aging) dari setiap transaksi stok

Stack

  • Frontend: SvelteKit
  • Backend: Elysia (Bun runtime)
  • Database: PostgreSQL (via Drizzle ORM)
  • Monorepo tooling: Turborepo + Bun workspaces
  • Reverse proxy / TLS (production): Caddy

Prerequisites

Repo Structure

apps/
  front-sveltekit/  -> SvelteKit frontend
  api-elysia/       -> Elysia backend API
    src/
      modules/
        purchasing/   # P2P: PR, PO, Goods Receipt
        inventory/    # ProductUnit, StockMovement, Warehouse
        sales/        # Sales Order, Invoice, Customer
        finance/      # AR, AP, jurnal
        returns/
packages/           -> shared packages (db schema, types, config)
  database/          -> Drizzle schema + client
  types/              -> shared TypeScript types (kontrak FE↔BE)
deploy/             -> deployment-related files
docker-compose.yml         -> local/dev compose
docker-compose.prod.yml    -> production compose

Getting Started

# Install dependencies
bun install

# Setup environment variables
cp apps/api-elysia/.env.example apps/api-elysia/.env

# Jalankan migrasi database (Drizzle)
bun run --filter database db:migrate

# Jalankan development server (semua app via Turborepo)
bun run dev

Common Scripts

Command Deskripsi
bun run dev Jalankan semua app (frontend + backend)
bun run build Build semua app
bun run lint Lint seluruh codebase
bun run check-types Type-check seluruh app
bun run format Format codebase dengan Prettier

Dokumentasi

Dokumen desain lengkap ada di folder docs/:

Catatan: dokumen SCHEMA-PStore.md dan bagian arsitektur di PRD-PStore-IMS.md masih merujuk ke Next.js/NestJS/Prisma dari draft sebelumnya — perlu direvisi menyesuaikan stack SvelteKit/Elysia/Drizzle di atas.

Status

Proyek masih dalam tahap desain/perencanaan. Implementasi kode belum dimulai.

Roadmap

Fitur yang sengaja di-defer dari v1.0:

  • Trade-in (tukar tambah unit lama)
  • Barcode/QR scanning untuk staff gudang
  • Portal self-service untuk reseller
  • Integrasi payment gateway
  • Dashboard analitik lanjutan

Lisensi

Belum ditentukan.

About

WIP

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages