How sebastiancardonass/monstersistem works
MONSTER is a multi-store Colombian technology-retail POS and administration system. Staff use its mobile-first browser app to manage catalog and stock, sell devices and products, and handle after-sale and financial operations; Flask JSON routes invoke domain services backed by PostgreSQL. The README also documents suppliers and debts, cash, reporting, loans, warranties, maintenance, alerts, device setup, configurable receipts and labels, and PWA installation. The graph preserves these capabilities, grouping unsampled services by their existing directory. Some internal links are omitted where excerpts and the source index do not establish the caller.
Main entry points: routes REST endpoints · models.py Domain data models · sales_service.py POS and sales · inventory_service.py Inventory and devices
Components 25
Browser experience
- POS and admin UI
frontend/js/app.js - Sales UI
frontend/js/sales.js - Inventory UI
frontend/js/inventory.js - Debts UI
frontend/js/debts.js - Offline and PWA
frontend/sw.js
API and access
- Flask application
backend/python/app.py - REST endpoints
backend/routes - Authentication
backend/python/services/auth_service.py - Auth and permissions
backend/python/utils/auth.py
Retail operations
- POS and sales
backend/python/services/sales_service.py - Catalog and codes
backend/python/services/catalog_service.py - Inventory and devices
backend/python/services/inventory_service.py - Device identity
backend/python/services/device_identity.py - Service and warranty
backend/python/services - Purchases and suppliers
backend/python/services/purchase_service.py
Finance and insights
- Debts and creditors
backend/python/services/debt_service.py - Cash and capital
backend/python/services - Loans
backend/python/services/loan_service.py - Dashboard and reports
backend/python/services/report_service.py
Shared platform
- Stores and settings
backend/python/services/store_service.py - User devices
backend/python/services/device_service.py - SQLAlchemy sessions
backend/python/database.py - Domain data models
backend/python/models.py - PostgreSQL
Other components
- Store staff
Connections 37
- Store staff → POS and admin UI: uses
- POS and admin UI → Flask application: calls JSON API
- Store staff → Sales UI: runs checkout
- Sales UI → Flask application: submits sale
- Store staff → Inventory UI: manages stock
- Store staff → Debts UI: manages debts
- POS and admin UI → Offline and PWA: installs offline
- Flask application → REST endpoints: registers
backend/python/app.py - REST endpoints → Authentication: invokes
backend/routes/auth.py - REST endpoints → Auth and permissions: checks access
backend/routes/catalog.py - REST endpoints → POS and sales: invokes
- REST endpoints → Inventory and devices: invokes
backend/routes/inventory.py - REST endpoints → Service and warranty: invokes
backend/routes/maintenance.py - REST endpoints → Catalog and codes: invokes
backend/routes/catalog.py - REST endpoints → Debts and creditors: invokes
backend/routes/inventory.py - REST endpoints → Purchases and suppliers: invokes
- REST endpoints → Cash and capital: invokes
backend/routes/auth.py - REST endpoints → Loans: invokes
- REST endpoints → Dashboard and reports: invokes
- REST endpoints → Stores and settings: invokes
- REST endpoints → User devices: invokes
- POS and sales → Device identity: uses identity
backend/python/services/sales_service.py - Inventory and devices → Device identity: uses identity
backend/python/services/inventory_service.py - Purchases and suppliers → Device identity: uses identity
backend/python/services/purchase_service.py - Service and warranty → Device identity: uses identity
backend/python/services/maintenance_service.py - POS and sales → Purchases and suppliers: uses purchase logic
backend/python/services/sales_service.py - Inventory and devices → Debts and creditors: creates related debt
backend/python/services/inventory_service.py - REST endpoints → SQLAlchemy sessions: gets sessions
backend/routes/inventory.py - SQLAlchemy sessions → PostgreSQL: stores data
backend/python/database.py - POS and sales → Domain data models: reads and writes
backend/python/services/sales_service.py - Inventory and devices → Domain data models: reads and writes
backend/python/services/inventory_service.py - Debts and creditors → Domain data models: reads and writes
backend/python/services/debt_service.py - Service and warranty → Domain data models: reads and writes
backend/python/services/maintenance_service.py - Catalog and codes → Domain data models: uses models
backend/python/services/catalog_service.py - Dashboard and reports → Domain data models: queries data
backend/python/services/report_service.py - Stores and settings → Domain data models: uses models
backend/python/services/store_service.py - Loans → Domain data models: uses models
backend/python/services/loan_service.py