QRSETUInternal Developer Portal

One platform, three products, one Supabase backend, one React codebase. Architecture, backend reference, and the guardrails that keep it enterprise-grade.

Platform Overview

Developer Onboarding

The one hard rule →

Interaction — QRSetu

QR codes, Digital Menu (+ KOT, cash-calculator), Feedback / engagement forms.

Presence — Studio ("My Setu")

Block-based website builder rendered at /s/:slug and /w/:slug.

Aggregation — BioLink

Link-in-bio pages rendered at /b/:slug.

Tier-split React SPA

landing / user / admin / public tiers, lazy-loaded so admin code never ships to a logged-out visitor.

RPC reads, Edge-Function writes

supabase.from() is banned in src/. Reads go through SECURITY DEFINER RPCs, writes through Edge Functions.

Two Supabase projects

qr-setu-prod (isolated, real data) and qr-setu-dev (bootstrapped from a schema-only baseline).

What this portal is

The single source of truth for how QRSETU is built and operated. It mirrors the proven structure of the sibling NEFOXX platform's portal, adapted to QRSETU's TypeScript-first, tier-split architecture.

Authority: The day-to-day operating manual is the repo-root CLAUDE.md; the full approved program lives in the plan file referenced there. This portal expands both into browsable form. Where this portal and CLAUDE.md disagree, CLAUDE.md wins until the portal is corrected — "if it isn't documented, it isn't done."

Start here

Platform Overview — what QRSETU is, the system map, the tech stack.
Developer Onboarding — toolchain, first run, everyday commands.
Data Access Strategy — the most important rule in the codebase.
Tier System — how the code is organised and isolated.
Coding Standards — what reviewers enforce.

Status legend

Standards in this portal (and in CLAUDE.md) are tagged:

[ENFORCED] — applies to all new code now; migrate existing code when you touch it.
[TRANSITIONAL] — current reality the program is moving away from; do not add to it.

The codebase is mid-transition (strangler-fig): some standards are already enforced, others are being retrofitted feature-by-feature.