VERSION 1.0.0STATUS: ECOMMERCE_APP
QUANTUM
A client-only commerce app: Firebase Auth with role-based routing, Firestore real-time listeners for live data, and a Redux cart persisted to localStorage.
DATA
REALTIME
AUTH
EMAIL+GOOGLE
ROLES
USER/ADMIN
ADMIN
FULL_CRUD
ABOUT_THE_PROJECT
Quantum is a single-page e-commerce app with two sides: customers browse, search, manage a persistent cart, and place orders; admins manage the catalog and watch orders and users update live through Firestore listeners.
State is split by shape: the cart lives in Redux Toolkit and persists to localStorage, while live Firestore data flows through a context provider.
SYSTEM_ENVIRONMENT_MATRIX
// APPREACT+VITE
// AUTHFIREBASE
// DATAFIRESTORE
// STATEREDUX_TOOLKIT
// STYLETAILWIND
Key_Challenges
- [ ERR_01 ]Firestore Timestamps broke Redux's serializability checks; fixed by storing epoch milliseconds instead.
- [ ERR_02 ]Google sign-in could succeed with no profile document; the login flow now creates one on the fly.
- [ ERR_03 ]Nested routes 404'd on refresh until an SPA rewrite rule sent every path back to index.html.
Key_Learnings
- [ LN_01 ]Choose state tools per data shape instead of forcing everything into one store.
- [ LN_02 ]Coercing types at the write boundary prevents whole categories of downstream bugs.
- [ LN_03 ]Client-side role checks are UX, not security; real enforcement lives in Firestore Security Rules.
//SYSTEM_COMPILE_COMPLETE
Have questions about this framework implementation or structural logic?