Pemilik toko kecil masih mencatat transaksi dan stok di buku, sehingga rekap harian lambat dan kesalahan hitung sulit ditelusuri.
Product requirements document
KasirKita
Dokumen MVP siap digunakan untuk menyelaraskan produk, desain, dan implementasi.
Overview
Masalah, tujuan, pengguna, dan batas MVP dalam satu pandangan.
Membantu toko kecil mencatat penjualan harian, memantau stok, dan membaca ringkasan transaksi tanpa proses manual.
- Pemilik toko kecil
- Kasir toko
MVP aplikasi web untuk satu toko, dengan katalog barang, transaksi, stok, dan laporan harian.
Requirements
Kebutuhan, sumbernya, aturan bisnis, dan kondisi yang menentukan kapan pekerjaan dianggap selesai.
Kebutuhan fungsional
Functional
- Pemilik dapat membuat katalog barang.
- Kasir dapat mencatat transaksi penjualan.
- Pemilik dapat melihat ringkasan transaksi dan stok.
Kebutuhan non-fungsional
Non-functional
- Setiap pengguna hanya dapat mengakses data tokonya sendiri.
- Aplikasi dapat digunakan pada layar desktop dan ponsel.
- Satu akun mewakili satu toko pada MVP.
- Pengguna memiliki koneksi internet saat mencatat transaksi.
Core features
Rincian perilaku, kriteria penerimaan, dan kondisi tepi untuk tiap kemampuan produk.
Katalog barang
mustPemilik menambah, mengubah, dan menonaktifkan barang yang dijual.
Catat penjualan
mustKasir memilih barang, memasukkan jumlah, lalu menyimpan transaksi.
Ringkasan harian
shouldPemilik melihat total transaksi, pendapatan, dan barang dengan stok rendah.
User flow
Alur utama dan alternatif, termasuk prasyarat, respons sistem, dan hasil akhirnya.
Mencatat penjualan pertama
- 1
Kasir masuk ke dashboard toko.
- 2
Kasir membuka transaksi baru.
- 3
Kasir memilih barang dan jumlah pembelian.
- 4
Kasir menyimpan transaksi.
- 5
Stok barang berkurang dan ringkasan harian diperbarui.
Architecture
Next.js menangani antarmuka dan API aplikasi. Supabase menyediakan autentikasi dan PostgreSQL. Server memanggil provider AI melalui API OpenAI-compatible untuk membentuk PRD, sehingga API key tidak pernah dikirim ke browser.
Standar implementasi
- Gunakan komponen dan modul reusable untuk perilaku yang berulang, dengan tanggung jawab tunggal dan tanpa abstraksi berlebihan.
- Targetkan maksimal sekitar 300 baris untuk setiap file source code buatan sendiri; pecah file yang membesar berdasarkan tanggung jawab yang kohesif.
- Pisahkan UI, aturan bisnis, validasi, akses data, dan integrasi eksternal sesuai konvensi framework yang dipilih.
- Ikuti idiom, sistem tipe, validasi input, penanganan error, dan pola pengujian resmi dari teknologi pada tech stack.
Struktur direktori
src/appHalaman, layout, routing, dan route handler Next.js.
src/features/<fitur>Komponen dan aturan domain yang hanya digunakan oleh fitur tersebut.
src/components/uiKomponen UI reusable yang tidak memuat aturan domain.
src/libIntegrasi server, akses data, validasi, dan utilitas bersama.
src/typesTipe bersama yang digunakan lintas fitur.
testsTes unit, integrasi, dan end-to-end sesuai kebutuhan.
flowchart LR
User[Pengguna] --> App[Next.js di Vercel]
App --> Auth[Supabase Auth]
App --> DB[(Supabase Postgres)]
App --> AI[Provider AI]
AI --> Model[Model AI]Sequence diagram
Urutan interaksi antaraktor dan komponen pada skenario utama.
sequenceDiagram
participant U as Pengguna
participant A as Next.js
participant S as Supabase
participant R as Provider AI
U->>A: Kirim ide produk
A->>S: Reservasi quota
A->>R: Generate PRD terstruktur
R-->>A: JSON PRD
A->>S: Simpan versi PRD
A-->>U: Tampilkan visualisasi PRDDatabase schema
Entitas, kepemilikan data, relasi, validasi, dan pola akses yang mendukung requirement.
projects
Menyimpan ide dan konfigurasi setiap project milik pengguna.
iduuidprimary keyowner_iduuidforeign key to auth.userstitletextnot nullraw_ideatextnot nullprd_versions
Menyimpan setiap hasil PRD yang berhasil dibuat.
iduuidprimary keyproject_iduuidforeign key to projectscontent_jsonjsonbnot nullmarkdown_contenttextnot nullTech stack
Pilihan teknologi, tanggung jawab implementasi, dan pertimbangannya untuk scope produk.
Satu codebase untuk UI dan route server yang cocok dengan Vercel.
Menyediakan auth, RLS, dan database relasional pada free tier.
Memudahkan penggantian model dan provider saat pengembangan.