How rmsofficialsyt/citimart3 works
CITIMART Daily Operations is a multi-store retail operations portal for live KPI pacing, manual sales and footfall logging, store governance, inventory workflows, and reporting. Store staff and administrators use the frontend; the backend authenticates and scopes operations, serves domain APIs, and reads or writes MongoDB-backed operational data. The graph includes the documented AI copilot, directives, requisitions, stock and staff management, and report exports. Some relationships rely on the README or SOURCE INDEX; unsampled implementation links are omitted or marked unverified.
Main entry points: App.tsx Operations portal · routes_daily.py Daily operations API · daily_dashboard_store.py Daily data and KPIs · app.py API application
Components 26
Staff experience
- Operations portal
frontend/src/App.tsx - API client
frontend/src/api/client.ts - Login experience
frontend/src/pages/LoginPage.tsx - Daily dashboard
frontend/src/pages/StoreDailyDashboard.tsx - Operations history
frontend/src/pages/HistoryPage.tsx - Requisition entry
frontend/src/pages/ProductRequisitionPage.tsx
Identity and access
- Authentication API
backend/api/routes_auth.py - JWT authorization
backend/api/auth.py - User accounts
backend/src/user_store.py - Session store
backend/src/session_store.py
Daily operations
- Daily operations API
backend/api/routes_daily.py - Daily data and KPIs
backend/src/daily_dashboard_store.py - KPI calculations
backend/src/kpi_engine.py - Target adjustment
backend/src/target_adjustment_engine.py - Pacing charts
backend/src/charts.py
Store governance
- Executive directives
backend/api/routes_directives.py - Product requisitions
backend/src/requisitions_store.py - Staff and stock APIs
backend/api/routes_stocks.py - AI operations copilot
backend/api/routes_chat.py
Data and reporting
- API application
backend/app.py - MongoDB
backend/db/engine.py - Operational collections
backend/db/models.py - Redis client
backend/db/redis_client.py - Report generation
backend/src/daily_report.py - Background jobs
backend/src/queue/bullmq_client.py
Other components
- Store staff
Connections 32
- Store staff → Operations portal: uses
README.md - Operations portal → Login experience: presents
- Operations portal → Daily dashboard: presents
- Operations portal → Operations history: presents
- Operations portal → Requisition entry: presents
- Operations portal → API client: uses
- API client → API application: calls
- API application → Authentication API: registers
backend/app.py - API application → Daily operations API: registers
backend/app.py - API application → Executive directives: registers
backend/app.py - API application → Staff and stock APIs: registers
backend/app.py - Authentication API → JWT authorization: uses
backend/api/routes_auth.py - Authentication API → User accounts: reads
backend/api/routes_auth.py - Authentication API → Session store: uses
backend/api/routes_auth.py - JWT authorization → Session store: checks
backend/api/auth.py - Daily operations API → JWT authorization: authorizes
backend/api/routes_daily.py - Daily operations API → Daily data and KPIs: requests KPIs
backend/api/routes_daily.py - Daily operations API → Pacing charts: uses
backend/api/routes_daily.py - Daily data and KPIs → KPI calculations: uses
backend/src/daily_dashboard_store.py - Daily data and KPIs → Target adjustment: uses
backend/src/daily_dashboard_store.py - Daily data and KPIs → Operational collections: reads and writes
backend/src/daily_dashboard_store.py - Operational collections → MongoDB: stored in
- Executive directives → JWT authorization: authorizes
- Product requisitions → Operational collections: stores records
backend/src/requisitions_store.py - Staff and stock APIs → JWT authorization: authorizes
backend/api/routes_stocks.py - Staff and stock APIs → Operational collections: uses
- AI operations copilot → Daily data and KPIs: gets live KPIs
backend/api/routes_chat.py - AI operations copilot → Executive directives: uses directive context
- Daily operations API → Report generation: uses reports
backend/api/routes_daily.py - Daily operations API → Background jobs: enqueues jobs
- Background jobs → Redis client: connects
- Daily data and KPIs → Redis client: uses cache
backend/src/daily_dashboard_store.py