# ramonsilva20/mapos architecture

> Architecture diagram of the GitHub repository ramonsilva20/mapos, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ramonsilva20/mapos
- Repository: https://github.com/ramonsilva20/mapos

## Overview

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: [`application/config/routes_api.php`](https://github.com/ramonsilva20/mapos/blob/master/application/config/routes_api.php) (API routing), [`application/libraries/REST_Controller.php`](https://github.com/ramonsilva20/mapos/blob/master/application/libraries/REST_Controller.php) (REST framework), [`application/controllers/api/v1/OsController.php`](https://github.com/ramonsilva20/mapos/blob/master/application/controllers/api/v1/OsController.php) (Service-order API), [`application/controllers/api/v1/client/ClientOsController.php`](https://github.com/ramonsilva20/mapos/blob/master/application/controllers/api/v1/client/ClientOsController.php) (Client API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Staff Web App"]
  node_clientes_web["Customer management<br/>[Clientes.php]"]
  node_clientes_view["Customer screens<br/>[clientes.php]"]
  node_login["Staff login<br/>[Login.php]"]
  node_os_web["Service orders<br/>[Os.php]"]
  node_sales["Sales<br/>[Vendas.php]"]
  node_finance["Finance<br/>[Financeiro.php]"]
  node_reports["Reports<br/>[Relatorios.php]"]
end

subgraph group_api["API Services"]
  node_api_routes["API routing<br/>[routes_api.php]"]
  node_rest["REST framework"]
  node_format["Response formatting<br/>[Format.php]"]
  node_api_users["User API"]
  node_api_customers["Customer API"]
  node_api_orders["Service-order API<br/>[OsController.php]"]
  node_client_api["Client API"]
  node_client_purchases["Client purchases"]
  node_client_login["Client login"]
end

subgraph group_operations["Business Operations"]
end

subgraph group_platform["Platform Services"]
  node_totp["Two-factor auth<br/>[Totp.php]"]
  node_gateways["Payment gateways"]
  node_database[("Application database<br/>[database.php]")]
end

node_staff(("Staff user"))
node_client(("Client"))

node_staff -->|"manages records"| node_clientes_web
node_clientes_web -->|"renders"| node_clientes_view
node_api_routes -->|"routes users"| node_api_users
node_api_routes -->|"routes customers"| node_api_customers
node_api_routes -->|"routes orders"| node_api_orders
node_api_routes -->|"routes client orders"| node_client_api
node_api_routes -->|"routes purchases"| node_client_purchases
node_api_routes -->|"routes client auth"| node_client_login
node_api_users -->|"uses"| node_totp
node_login -->|"uses"| node_totp
node_rest -->|"requires"| node_format
node_api_orders -->|"extends"| node_rest
node_client_api -->|"extends"| node_rest
node_client_purchases -->|"extends"| node_rest
node_client_login -->|"extends"| node_rest
node_api_orders -->|"references"| node_login
node_client -->|"authenticates"| node_client_login
node_client -->|"requests orders"| node_client_api
node_client -->|"views purchases"| node_client_purchases

click node_clientes_web "https://github.com/ramonsilva20/mapos/blob/master/application/controllers/Clientes.php"
click node_clientes_view "https://github.com/ramonsilva20/mapos/blob/master/application/views/clientes/clientes.php"
click node_login "https://github.com/ramonsilva20/mapos/blob/master/application/controllers/Login.php"
click node_os_web "https://github.com/ramonsilva20/mapos/blob/master/application/controllers/Os.php"
click node_sales "https://github.com/ramonsilva20/mapos/blob/master/application/controllers/Vendas.php"
click node_finance "https://github.com/ramonsilva20/mapos/blob/master/application/controllers/Financeiro.php"
click node_reports "https://github.com/ramonsilva20/mapos/blob/master/application/controllers/Relatorios.php"
click node_api_routes "https://github.com/ramonsilva20/mapos/blob/master/application/config/routes_api.php"
click node_rest "https://github.com/ramonsilva20/mapos/blob/master/application/libraries/REST_Controller.php"
click node_format "https://github.com/ramonsilva20/mapos/blob/master/application/libraries/Format.php"
click node_api_users "https://github.com/ramonsilva20/mapos/blob/master/application/controllers/api/v1/UsuariosController.php"
click node_api_customers "https://github.com/ramonsilva20/mapos/blob/master/application/controllers/api/v1/ClientesController.php"
click node_api_orders "https://github.com/ramonsilva20/mapos/blob/master/application/controllers/api/v1/OsController.php"
click node_client_api "https://github.com/ramonsilva20/mapos/blob/master/application/controllers/api/v1/client/ClientOsController.php"
click node_client_purchases "https://github.com/ramonsilva20/mapos/blob/master/application/controllers/api/v1/client/ClientComprasController.php"
click node_client_login "https://github.com/ramonsilva20/mapos/blob/master/application/controllers/api/v1/client/ClientLoginController.php"
click node_totp "https://github.com/ramonsilva20/mapos/blob/master/application/libraries/Totp.php"
click node_gateways "https://github.com/ramonsilva20/mapos/tree/master/application/libraries/Gateways"
click node_database "https://github.com/ramonsilva20/mapos/blob/master/application/config/database.php"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_clientes_web,node_clientes_view,node_login,node_os_web,node_sales,node_finance,node_reports,node_staff,node_client toneBlue
class node_api_routes,node_rest,node_format,node_api_users,node_api_customers,node_api_orders,node_client_api,node_client_purchases,node_client_login toneAmber
class node_totp,node_gateways,node_database toneRose
```

## Components

### Staff Web App

- [Customer management](https://github.com/ramonsilva20/mapos/blob/master/application/controllers/Clientes.php): `application/controllers/Clientes.php`
- [Customer screens](https://github.com/ramonsilva20/mapos/blob/master/application/views/clientes/clientes.php): `application/views/clientes/clientes.php`
- [Staff login](https://github.com/ramonsilva20/mapos/blob/master/application/controllers/Login.php): `application/controllers/Login.php`
- [Service orders](https://github.com/ramonsilva20/mapos/blob/master/application/controllers/Os.php): `application/controllers/Os.php`
- [Sales](https://github.com/ramonsilva20/mapos/blob/master/application/controllers/Vendas.php): `application/controllers/Vendas.php`
- [Finance](https://github.com/ramonsilva20/mapos/blob/master/application/controllers/Financeiro.php): `application/controllers/Financeiro.php`
- [Reports](https://github.com/ramonsilva20/mapos/blob/master/application/controllers/Relatorios.php): `application/controllers/Relatorios.php`

### API Services

- [API routing](https://github.com/ramonsilva20/mapos/blob/master/application/config/routes_api.php): `application/config/routes_api.php`
- [REST framework](https://github.com/ramonsilva20/mapos/blob/master/application/libraries/REST_Controller.php): `application/libraries/REST_Controller.php`
- [Response formatting](https://github.com/ramonsilva20/mapos/blob/master/application/libraries/Format.php): `application/libraries/Format.php`
- [User API](https://github.com/ramonsilva20/mapos/blob/master/application/controllers/api/v1/UsuariosController.php): `application/controllers/api/v1/UsuariosController.php`
- [Customer API](https://github.com/ramonsilva20/mapos/blob/master/application/controllers/api/v1/ClientesController.php): `application/controllers/api/v1/ClientesController.php`
- [Service-order API](https://github.com/ramonsilva20/mapos/blob/master/application/controllers/api/v1/OsController.php): `application/controllers/api/v1/OsController.php`
- [Client API](https://github.com/ramonsilva20/mapos/blob/master/application/controllers/api/v1/client/ClientOsController.php): `application/controllers/api/v1/client/ClientOsController.php`
- [Client purchases](https://github.com/ramonsilva20/mapos/blob/master/application/controllers/api/v1/client/ClientComprasController.php): `application/controllers/api/v1/client/ClientComprasController.php`
- [Client login](https://github.com/ramonsilva20/mapos/blob/master/application/controllers/api/v1/client/ClientLoginController.php): `application/controllers/api/v1/client/ClientLoginController.php`

### Platform Services

- [Two-factor auth](https://github.com/ramonsilva20/mapos/blob/master/application/libraries/Totp.php): `application/libraries/Totp.php`
- [Payment gateways](https://github.com/ramonsilva20/mapos/tree/master/application/libraries/Gateways): `application/libraries/Gateways`
- [Application database](https://github.com/ramonsilva20/mapos/blob/master/application/config/database.php): `application/config/database.php`

### Other components

- **Staff user**
- **Client**

## Connections

- Staff user → Customer management: manages records
- Customer management → Customer screens: renders (evidence: `application/views/clientes/clientes.php`)
- API routing → User API: routes users (evidence: `application/config/routes_api.php`)
- API routing → Customer API: routes customers (evidence: `application/config/routes_api.php`)
- API routing → Service-order API: routes orders (evidence: `application/config/routes_api.php`)
- API routing → Client API: routes client orders (evidence: `application/config/routes_api.php`)
- API routing → Client purchases: routes purchases (evidence: `application/config/routes_api.php`)
- API routing → Client login: routes client auth (evidence: `application/config/routes_api.php`)
- User API → Two-factor auth: uses (evidence: `application/controllers/api/v1/UsuariosController.php`)
- Staff login → Two-factor auth: uses (evidence: `application/controllers/Login.php`)
- REST framework → Response formatting: requires (evidence: `application/libraries/REST_Controller.php`)
- Service-order API → REST framework: extends (evidence: `application/controllers/api/v1/OsController.php`)
- Client API → REST framework: extends (evidence: `application/controllers/api/v1/client/ClientOsController.php`)
- Client purchases → REST framework: extends (evidence: `application/controllers/api/v1/client/ClientComprasController.php`)
- Client login → REST framework: extends (evidence: `application/controllers/api/v1/client/ClientLoginController.php`)
- Service-order API → Staff login: references (evidence: `application/controllers/api/v1/OsController.php`)
- Client → Client login: authenticates
- Client → Client API: requests orders
- Client → Client purchases: views purchases
