Documentation

Internal documentation for the admin portal. Use the links below to browse by topic.

API & access

Store vs admin path split, permissions, and token flows.

Store vs Admin API & access
Path split (/store vs /admin), admin:access permission, JWT aud/iss, guards, and how store and admin frontends call the API
Variant API contract (strict)
Canonical request/response contract for variants, checkout items, stock movements, and regression checks

Other documentation

Configuration & secrets
Backend env vars, validation, and how to use a secrets manager later
Google sign-in
Enable Sign in with Google for admin and store: Google Cloud setup, env vars, and flow
Deployment
How main website and admin portal deploy to Cloudflare Pages via GitHub Actions
Database migrations
How to write, manage, and deploy migrations for production
File upload system
Product images, payment proof, Cloudinary setup, and provider-agnostic design
SEO & marketing
Step-by-step guide for SEO tags, Meta Pixel, Google Analytics, and GTM (non-technical)
Order status
Valid and invalid status transitions for orders
Vouchers & coupons
How to create and manage discount vouchers for checkout
Voucher audit & order pricing
Audit logs, pricing breakdown, and where to find them in the admin
Sales campaigns
Time-bound product discounts: setup, lifecycle, pricing, and storefront display
Background jobs setup
How to run and schedule the voucher expired job and archival