rencana.
Contoh visualisasi
Contoh visualisasi

Product requirements document

KasirKita

Dokumen MVP siap digunakan untuk menyelaraskan produk, desain, dan implementasi.

01

Overview

Masalah, tujuan, pengguna, dan batas MVP dalam satu pandangan.

Masalah

Pemilik toko kecil masih mencatat transaksi dan stok di buku, sehingga rekap harian lambat dan kesalahan hitung sulit ditelusuri.

Tujuan

Membantu toko kecil mencatat penjualan harian, memantau stok, dan membaca ringkasan transaksi tanpa proses manual.

Pengguna
  • Pemilik toko kecil
  • Kasir toko
Scope MVP

MVP aplikasi web untuk satu toko, dengan katalog barang, transaksi, stok, dan laporan harian.

02

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.
Asumsi yang digunakan
  • Satu akun mewakili satu toko pada MVP.
  • Pengguna memiliki koneksi internet saat mencatat transaksi.
03

Core features

Rincian perilaku, kriteria penerimaan, dan kondisi tepi untuk tiap kemampuan produk.

01

Katalog barang

must

Pemilik menambah, mengubah, dan menonaktifkan barang yang dijual.

02

Catat penjualan

must

Kasir memilih barang, memasukkan jumlah, lalu menyimpan transaksi.

03

Ringkasan harian

should

Pemilik melihat total transaksi, pendapatan, dan barang dengan stok rendah.

04

User flow

Alur utama dan alternatif, termasuk prasyarat, respons sistem, dan hasil akhirnya.

Mencatat penjualan pertama

  1. 1

    Kasir masuk ke dashboard toko.

  2. 2

    Kasir membuka transaksi baru.

  3. 3

    Kasir memilih barang dan jumlah pembelian.

  4. 4

    Kasir menyimpan transaksi.

  5. 5

    Stok barang berkurang dan ringkasan harian diperbarui.

05

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/app

Halaman, layout, routing, dan route handler Next.js.

src/features/<fitur>

Komponen dan aturan domain yang hanya digunakan oleh fitur tersebut.

src/components/ui

Komponen UI reusable yang tidak memuat aturan domain.

src/lib

Integrasi server, akses data, validasi, dan utilitas bersama.

src/types

Tipe bersama yang digunakan lintas fitur.

tests

Tes 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]
06

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 PRD
07

Database schema

Entitas, kepemilikan data, relasi, validasi, dan pola akses yang mendukung requirement.

1

projects

Menyimpan ide dan konfigurasi setiap project milik pengguna.

iduuidprimary key
owner_iduuidforeign key to auth.users
titletextnot null
raw_ideatextnot null

Satu project memiliki banyak prd_versions.

2

prd_versions

Menyimpan setiap hasil PRD yang berhasil dibuat.

iduuidprimary key
project_iduuidforeign key to projects
content_jsonjsonbnot null
markdown_contenttextnot null

Setiap versi milik tepat satu project.

08

Tech stack

Pilihan teknologi, tanggung jawab implementasi, dan pertimbangannya untuk scope produk.

LayerTechnologyReason
Frontend dan APINext.js + TypeScript

Satu codebase untuk UI dan route server yang cocok dengan Vercel.

Database dan AuthSupabase PostgreSQL + Auth

Menyediakan auth, RLS, dan database relasional pada free tier.

AI gatewayProvider AI OpenAI-compatible API

Memudahkan penggantian model dan provider saat pengembangan.