How tonyyyzxc/cremoso-core works
Cremoso-Core is a multi-branch sales and operations web app. Staff and managers sign in, create and process orders, and work with branch-scoped stock, schedules, reconciliation, and activity; admins also manage branches, catalog, accounts, and reports. The React client calls an Express REST API backed by MongoDB, with optional Google, Firebase, and email integrations. The graph preserves the README’s major product areas. Some subsystem links are documented at the API level because their route and page implementations were not sampled.
Main entry points: App.jsx Role-based app routes · server.js Express REST API · ordersController.js Order processing · authController.js Authentication and sessions
Components 33
Web application
- Role-based app routes
client/App.jsx - Order entry and queue
client/src/pages/NewOrder.jsx - Orders and transactions
client/src/pages/Orders.jsx - Branch dashboard
client/src/pages/Dashboard.jsx - Menu and inventory
client/src/pages/Menu.jsx - Schedules and staff
client/src/pages/Schedule.jsx - Cash reconciliation
client/src/pages/Reconciliation.jsx - Branch and account admin
client/src/pages/Management.jsx - Reports and exports
client/src/pages/Reports.jsx - Settings and integrations
client/src/pages/Settings.jsx - Drive browser
client/src/pages/Drive.jsx - Activity history
client/src/pages/ActivityLogs.jsx - Sign-in
client/src/pages/Login.jsx - API client
client/src/utils/api.js
Branch operations
- Order processing
server/controllers/ordersController.js - Order and stock records
server/models/order.js - Branch records
server/models/branch.js - Calendar sync
server/controllers/calendarController.js
Administration and insights
- Report generation
server/controllers/reportsController.js
API and identity
- Express REST API
server/server.js - Authentication and sessions
server/controllers/authController.js - Session and role checks
server/middleware/authMiddleware.js - User accounts
server/models/user.js - Session records
server/models/session.js - Activity logging
server/utils/activityLog.js - MongoDB
External services
- Drive operations
server/controllers/driveController.js - Google services
- Spreadsheet export
server/utils/googleSheetsAuth.js - Push notifications
server/utils/pushNotifications.js - Firebase messaging
- Transactional email
server/utils/mailer.js
Other components
- Staff and managers
Connections 37
- Staff and managers → Role-based app routes: uses
README.md - Role-based app routes → Sign-in: routes to
client/App.jsx - Role-based app routes → Order entry and queue: routes to
client/App.jsx - Role-based app routes → Orders and transactions: routes to
client/App.jsx - Role-based app routes → Branch dashboard: routes to
client/App.jsx - Role-based app routes → Menu and inventory: routes to
client/App.jsx - Role-based app routes → Schedules and staff: routes to
client/App.jsx - Role-based app routes → Cash reconciliation: routes to
client/App.jsx - Role-based app routes → Branch and account admin: routes to
client/App.jsx - Role-based app routes → Reports and exports: routes to
client/App.jsx - Role-based app routes → Settings and integrations: routes to
client/App.jsx - Role-based app routes → Drive browser: routes to
client/App.jsx - Role-based app routes → Activity history: routes to
client/App.jsx - Sign-in → Express REST API: authenticates via
README.md - Express REST API → Authentication and sessions: routes requests
server/server.js - Express REST API → Order processing: routes requests
server/server.js - Express REST API → Report generation: routes requests
server/server.js - Express REST API → Calendar sync: routes requests
server/server.js - Express REST API → Drive operations: routes requests
server/server.js - Authentication and sessions → Session records: creates sessions
server/controllers/authController.js - Session and role checks → Session records: checks session
server/middleware/authMiddleware.js - Session and role checks → User accounts: loads account
server/middleware/authMiddleware.js - Order processing → Order and stock records: writes orders
server/controllers/ordersController.js - Order processing → Activity logging: records actions
server/controllers/ordersController.js - Authentication and sessions → Activity logging: records sign-in
server/controllers/authController.js - Calendar sync → Google services: syncs shifts
README.md - Drive operations → Google services: manages files
README.md - Report generation → Spreadsheet export: exports reports
README.md - Spreadsheet export → Google services: uses
README.md - Order processing → Push notifications: notifies
server/controllers/ordersController.js - Push notifications → Firebase messaging: sends messages
server/utils/pushNotifications.js - Authentication and sessions → Transactional email: sends reset codes
server/controllers/authController.js - Express REST API → MongoDB: connects to
server/server.js - Order processing → MongoDB: persists data
- Report generation → MongoDB: reads data
- Branch records → MongoDB: stores branch data
- User accounts → MongoDB: stores accounts