BITS Pay

QRIS payment gateway untuk aplikasi kamu. Convert QRIS static → dynamic, auto-confirm via OCR.

Quick Start

# 1. Install dependencies
npm install

# 2. Setup lokal (buat .dev.vars, .env, jalanin D1 migrations)
npm run dev:setup

# 3. Jalankan semua service (API + 3 frontend)
npm run dev:all

Service	Port	URL
API (Hono Workers)	5173	http://localhost:5173
Landing page (Web)	5174	http://localhost:5174
User dashboard (Svelte)	5175	http://localhost:5175
Admin dashboard (Svelte)	5176	http://localhost:5176

Semua SPA di-root packages/{web,user,admin}/.env punya VITE_API_URL=http://localhost:5173.

Scripts

Script	Fungsi
npm run dev	API worker saja (port 5173)
npm run dev:all	Setup + run semua service (concurrently)
npm run dev:all:run	Run semua service tanpa setup ulang
npm run dev:setup	Setup idempotent lokal (dev vars, .env, D1 migrations)
npm run build	Build shared + api
npm run build:all	Build semua package
npm run type-check	TypeScript check (tsc --noEmit)
npm run lint	ESLint
npm test	Vitest (20 test, 4 files)
npm run deploy:api	Deploy API worker ke Cloudflare
npm run deploy:web	Deploy landing page worker ke Cloudflare

Local Development

Semua dev server bind 0.0.0.0 — bisa diakses dari LAN/testing.

# Setup awal (cukup sekali)
npm run dev:setup

# Start semua service
npm run dev:all

# Atau satu per satu
npm run dev              # API only
npm run dev -w packages/web   # Landing page only
npm run dev -w packages/user  # User dashboard only
npm run dev -w packages/admin # Admin dashboard only

Testing

npm test                    # Semua test
npm run test:watch          # Watch mode
npm run test:coverage       # Coverage report

Test files:

• packages/shared/tests/crypto.test.ts — hash, JWT, API key
• packages/shared/tests/unique-code.test.ts — unique code generation
• packages/api/tests/rate-limit.test.ts — Durable Object rate limiter
• packages/api/tests/ocr-tesseract.test.ts — OCR tesseract-vps

Project Structure

bits-pay/
├── .github/                  # CI/CD, dependabot, CODEOWNERS
├── docs/                     # PRD, architecture, API, DB, sprint, dll
├── scripts/
│   └── setup-local.mjs       # Setup lokal idempotent
├── packages/
│   ├── api/                  # Worker 1 — Hono API (api.pay.bits.co.id)
│   │   ├── src/
│   │   │   ├── config.ts     # Env interface
│   │   │   ├── index.ts      # Hono entry, cron, queue consumer
│   │   │   ├── lib/          # errors, response, validate, time, upload, ssrf
│   │   │   ├── middleware/   # auth, api-key, rate-limit, admin, cors, error-handler
│   │   │   ├── routes/       # auth(10), app(5), api(3), admin(9), billing(3)
│   │   │   ├── services/     # auth, app, payment, qr, ocr, callback, email, billing, dll
│   │   │   ├── durable/      # RateLimiter DO + window pure
│   │   │   └── db/migrations/ # 5 migrasi D1
│   │   └── wrangler.jsonc    # D1, R2, AI, Queue, DO, Cron, vars
│   ├── shared/               # Types + utils (import via @bits-pay/shared)
│   │   └── src/
│   │       ├── types/        # Semua type definitions
│   │       └── utils/        # crypto.ts, unique-code.ts
│   ├── web/                  # Worker 2 — Landing page static (pay.bits.co.id)
│   │   ├── index.html        # Landing page lengkap + modal login/signup
│   │   ├── src/              # main.ts, style.css (637 baris)
│   │   └── wrangler.jsonc    # assets binding
│   ├── user/                 # User dashboard (Svelte 5 SPA)
│   │   └── src/
│   │       ├── routes/       # 13 komponen route
│   │       ├── components/   # layout(3) + ui(11)
│   │       ├── lib/          # api.ts, toast.ts
│   │       └── stores/       # auth, payment, workspace
│   └── admin/                # Admin dashboard (Svelte 5 SPA)
│       └── src/
│           ├── routes/       # 11 komponen route
│           ├── components/   # layout(1) + ui(9)
│           ├── lib/          # api.ts, toast.ts
│           └── stores/       # auth

Tech Stack

Layer	Teknologi
Runtime	Cloudflare Workers (2 worker)
Framework	Hono (API), Svelte 5 (SPA)
Language	TypeScript 6
Database	Cloudflare D1 (SQLite)
Storage	Cloudflare R2 (bukti bayar)
Queue	Cloudflare Queues (callback retry, max 3)
Durable Objects	RateLimiter (fixed-window)
Cron	every 5 menit (expire, reminder, downgrade)
Email	Cloudflare Email Service
OCR	Workers AI (@cf/meta/llama-3.2-11b-vision-instruct) + fallback tesseract-vps
QRIS	bits-qris (npm)
Auth	Custom (bcryptjs + jose JWT)
Validation	zod
Dashboard CSS	Tailwind CSS v4
Landing CSS	Custom (oklch colors)
CI/CD	GitHub Actions (ci, deploy-api, deploy-web, uptime)

Docs

Doc	Isi
PRD	Product Requirements
Architecture	Arsitektur teknis
API	Endpoint reference
Database	Schema DDL
UI Design	Desain UI/UX
DevOps	CI/CD, lint, test
Sprint	Task breakdown
Roadmap	Roadmap keseluruhan
Implementation Guide	Panduan implementasi untuk AI agent

License

MIT — Banten IT Solutions