tiennm99
d91515c36e
Closes the last two original-app feature gaps: - set_queue_counter RPC (admin/receptionist, advisory-locked, VN-local day) plus per-shift counter display for all staff and a set/reset form for admin/receptionist (orig SetCounterRequest/GetCounterRequest) - checkup templates are now actually applied: pick a template on the checkup screen (filtered to the patient's gender), its fields render as inputs and persist to the new checkups.template_values jsonb; the ultrasound report PDF already reads the template title daily_queue_counters gains a SELECT policy (reads only) — writes stay inside the DEFINER RPCs.
BSK (Rewrite)
An educational rewrite of the BSK All-in-One Clinic Management System into a modern web stack.
Original project: lds217/BSK-All-in-One-Clinic-Management-System by @lds217 — a Java/Swing desktop application with a Netty server and SQLite backend, built for small Vietnamese clinics.
This repository is a clean-room reimplementation for learning purposes. No source code is copied from the original; features and data shapes are reimplemented from the upstream README and observable behavior. See NOTICE for full attribution.
Status
Core system implemented (Phases 0–8). See PLAN.md for the architecture and phased roadmap.
Built: auth + RBAC (allowlist-gated admin bootstrap, rate limiting, audit log); master data (doctors, medicines, services, checkup templates, clinic settings, staff management); patients (VN geo lookup + accent-insensitive search); queue + checkup workflow with realtime; prescriptions + billing (server-authoritative VND totals, cashier mark-paid); imaging (webcam/file capture, ≤200 KB compression, signed URLs, barcode); reports (Vietnamese PDF invoice, Excel export, revenue dashboard); recheck reminders + nightly retention sweep.
First-run setup (operator)
After provisioning Supabase/Upstash/Vercel and pnpm db:push:
- Seed the admin allowlist before the first sign-in (or nobody can bootstrap admin):
INSERT INTO bsk.admin_allowlist (email) VALUES ('you@example.com'); - Seed Vietnamese geo data (province/ward address dropdowns):
pnpm db:seed-geo(seescripts/seed-geo.ts). - Enable Supabase Realtime on
bsk.checkups(Database → Replication) for the live queue. - Set
CRON_SECRETin Vercel so the nightly media-retention sweep (/api/cron/nightly, scheduled invercel.json) can authenticate.
See docs/supabase-shared-config.md for the shared-project rules and docs/design-guidelines.md for UI conventions.
Stack
- pnpm + Next.js 16 (App Router) + TypeScript
- Supabase (Postgres + Auth + Storage) — shared across personal projects via schema-per-app
- Upstash Redis + QStash — shared across personal projects via key prefixes
- Vercel for hosting
- shadcn/ui + Tailwind CSS
Important disclaimers
- Educational use only. This codebase is not certified for clinical use and must never be deployed against real patient data. Use synthetic data only.
- No HIPAA / GDPR compliance is implied or attempted on the free-tier infrastructure.
- This is a derivative work for learning; if you are the upstream author and would like additional attribution or removal, please open an issue.
Database
After pnpm db:push, run pnpm db:gen-types to refresh types/supabase-bsk.ts.
License
This repository is licensed under the Apache License 2.0. The original project does not currently carry an explicit license; see NOTICE for the attribution stance.