How amigosiamoneycard/money-card works
Money Card is a multi-tenant stored-value card platform: organization administrators issue cards and manage staff, branches, products, and inventory; counter staff open card sessions and record purchases or recharges; administrators and portal users can inspect activity, balances, and reports. The web client calls the Express API, whose controllers perform domain operations against Prisma-backed data. The tree also documents analytics, kitchen, subscriptions, customer history, and a Flutter staff app. Source excerpts establish only selected route/controller links; unsampled feature links are omitted rather than inferred.
Main entry points: database.ts Prisma connection · admin.controller.ts Organization administration · index.ts API routes · auth.middleware.ts Authentication
Components 25
Web client
- Web application
Frontend Money Card/src/app/App.tsx - Business screens
Frontend Money Card/src/features - API client
Frontend Money Card/src/services/api/realClient.ts
API and access
- HTTP server
Backend Money Card/src/server.ts - API routes
Backend Money Card/src/routes/index.ts - Authentication
Backend Money Card/src/middlewares/auth.middleware.ts - Prisma connection
Backend Money Card/src/config/database.ts - Application database
- Audit logging
Backend Money Card/src/services/auditLog.service.ts - Email delivery
Backend Money Card/src/services/email.service.ts
Card operations
- Products and inventory routes
Backend Money Card/src/routes/products.routes.ts - Products and inventory
Backend Money Card/src/controllers/products.controller.ts - Card management
Backend Money Card/src/controllers/cards.controller.ts - Sessions and transactions
Backend Money Card/src/controllers/sessions.controller.ts - Balance updates
Backend Money Card/src/services/balanceStream.service.ts - Kitchen operations
Backend Money Card/src/controllers/kitchen.controller.ts
Tenant management
- Admin endpoints
Backend Money Card/src/routes/admin.routes.ts - Organization administration
Backend Money Card/src/controllers/admin.controller.ts - Staff endpoints
Backend Money Card/src/routes/staff.routes.ts - Staff management
Backend Money Card/src/controllers/staff.controller.ts - Subscriptions
Backend Money Card/src/controllers/subscription.controller.ts
Activity and reporting
- Analytics
Frontend Money Card/src/features/analytics - Reports
Frontend Money Card/src/features/reports - Customer history
Backend Money Card/src/controllers/customer-history.controller.ts
Other components
- Staff and admins
Connections 29
- Staff and admins → Web application: uses
- Web application → Business screens: renders
Frontend Money Card/src/app/App.tsx - Business screens → API client: requests
Frontend Money Card/src/services/api/realClient.ts - API client → HTTP server: calls API
- HTTP server → API routes: mounts
Backend Money Card/src/server.ts - API routes → Admin endpoints: mounts
Backend Money Card/src/routes/index.ts - Admin endpoints → Authentication: protects
Backend Money Card/src/routes/admin.routes.ts - Admin endpoints → Organization administration: dispatches
Backend Money Card/src/routes/admin.routes.ts - API routes → Staff endpoints: mounts
Backend Money Card/src/routes/index.ts - Staff endpoints → Authentication: protects
Backend Money Card/src/routes/staff.routes.ts - Staff endpoints → Staff management: dispatches
Backend Money Card/src/routes/staff.routes.ts - API routes → Products and inventory routes: mounts
Backend Money Card/src/routes/index.ts - Products and inventory routes → Authentication: protects
Backend Money Card/src/routes/products.routes.ts - Products and inventory routes → Products and inventory: dispatches
Backend Money Card/src/routes/products.routes.ts - Sessions and transactions → Balance updates: publishes updates
Backend Money Card/src/controllers/sessions.controller.ts - Organization administration → Email delivery: sends activation
Backend Money Card/src/controllers/admin.controller.ts - Organization administration → Audit logging: records activity
Backend Money Card/src/controllers/admin.controller.ts - Authentication → Prisma connection: loads user
Backend Money Card/src/middlewares/auth.middleware.ts - Organization administration → Prisma connection: queries
Backend Money Card/src/controllers/admin.controller.ts - Staff management → Prisma connection: queries
Backend Money Card/src/controllers/staff.controller.ts - Products and inventory → Prisma connection: queries
Backend Money Card/src/controllers/products.controller.ts - Card management → Prisma connection: queries
Backend Money Card/src/controllers/cards.controller.ts - Sessions and transactions → Prisma connection: queries
Backend Money Card/src/controllers/sessions.controller.ts - Prisma connection → Application database: connects
Backend Money Card/src/config/database.ts - Organization administration → Subscriptions: manages plans
- Staff and admins → Analytics: reviews activity
- Staff and admins → Reports: views reports
- Staff and admins → Customer history: checks history
- Staff and admins → Kitchen operations: handles orders