How ramonsilva20/mapos works
MapOS is a PHP application for managing repair-shop operations, including customer records, service orders, products, sales, finance, and client self-service. Staff use the web application to manage operational records; clients also have a separate API for service orders, purchases, and billing. The repository additionally exposes a versioned API and payment-gateway implementations. Edges are limited to relationships visible in the supplied excerpts, SOURCE INDEX references, or README; several important subsystems are present in the tree but their internal wiring was not sampled.
Main entry points: routes_api.php API routing · REST_Controller.php REST framework · OsController.php Service-order API · ClientOsController.php Client API
Components 21
Staff Web App
- Customer management
application/controllers/Clientes.php - Customer screens
application/views/clientes/clientes.php - Staff login
application/controllers/Login.php - Service orders
application/controllers/Os.php - Sales
application/controllers/Vendas.php - Finance
application/controllers/Financeiro.php - Reports
application/controllers/Relatorios.php
API Services
- API routing
application/config/routes_api.php - REST framework
application/libraries/REST_Controller.php - Response formatting
application/libraries/Format.php - User API
application/controllers/api/v1/UsuariosController.php - Customer API
application/controllers/api/v1/ClientesController.php - Service-order API
application/controllers/api/v1/OsController.php - Client API
application/controllers/api/v1/client/ClientOsController.php - Client purchases
application/controllers/api/v1/client/ClientComprasController.php - Client login
application/controllers/api/v1/client/ClientLoginController.php
Platform Services
- Two-factor auth
application/libraries/Totp.php - Payment gateways
application/libraries/Gateways - Application database
application/config/database.php
Other components
- Staff user
- Client
Connections 19
- Staff user → Customer management: manages records
- Customer management → Customer screens: renders
application/views/clientes/clientes.php - API routing → User API: routes users
application/config/routes_api.php - API routing → Customer API: routes customers
application/config/routes_api.php - API routing → Service-order API: routes orders
application/config/routes_api.php - API routing → Client API: routes client orders
application/config/routes_api.php - API routing → Client purchases: routes purchases
application/config/routes_api.php - API routing → Client login: routes client auth
application/config/routes_api.php - User API → Two-factor auth: uses
application/controllers/api/v1/UsuariosController.php - Staff login → Two-factor auth: uses
application/controllers/Login.php - REST framework → Response formatting: requires
application/libraries/REST_Controller.php - Service-order API → REST framework: extends
application/controllers/api/v1/OsController.php - Client API → REST framework: extends
application/controllers/api/v1/client/ClientOsController.php - Client purchases → REST framework: extends
application/controllers/api/v1/client/ClientComprasController.php - Client login → REST framework: extends
application/controllers/api/v1/client/ClientLoginController.php - Service-order API → Staff login: references
application/controllers/api/v1/OsController.php - Client → Client login: authenticates
- Client → Client API: requests orders
- Client → Client purchases: views purchases