# marcio72/azuremaquinas architecture

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

- Interactive diagram: https://gitdiagram.com/marcio72/azuremaquinas
- Repository: https://github.com/marcio72/azuremaquinas

## Overview

AzureMaquinas appears to be a Spring application for managing machine customers, maintenance requests and executions, parts/stock, and related operations. Its main operational workflow is customer or staff maintenance intake, recording machine problems, tracking service execution, and supporting inventory and reporting. The tree also shows a customer-facing app, key tracking, an Instagram profile area, and a multiplayer card game. README content is only the product name; links for unsampled controllers and subsystems are therefore omitted or marked unverified.

Main entry points: [`src/main/java/br/com/locaweb/relatorioclientes/repository/ClienteRepository.java`](https://github.com/marcio72/azuremaquinas/blob/main/src/main/java/br/com/locaweb/relatorioclientes/repository/ClienteRepository.java) (Customer repository), [`src/main/java/br/com/locaweb/relatorioclientes/controller/RelatorioPdfController.java`](https://github.com/marcio72/azuremaquinas/blob/main/src/main/java/br/com/locaweb/relatorioclientes/controller/RelatorioPdfController.java) (PDF reporting), [`src/main/java/br/com/locaweb/relatorioclientes/chave/web/ChaveWebController.java`](https://github.com/marcio72/azuremaquinas/blob/main/src/main/java/br/com/locaweb/relatorioclientes/chave/web/ChaveWebController.java) (Key management UI), [`src/main/java/br/com/locaweb/relatorioclientes/model/SolicitacaoManutencao.java`](https://github.com/marcio72/azuremaquinas/blob/main/src/main/java/br/com/locaweb/relatorioclientes/model/SolicitacaoManutencao.java) (Service request)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_operations["Machine operations"]
  node_maintenance["Maintenance workflow"]
  node_request["Service request"]
  node_problem["Machine problem"]
  node_execution["Service execution"]
  node_stock["Parts and stock"]
  node_customerdata[("Customer and machines<br/>[Cliente.java]")]
  node_customerrepo[("Customer repository")]
  node_pdf["PDF reporting"]
  node_pdfservice["PDF generation<br/>[PdfService.java]"]
  node_whatsapp["WhatsApp follow-up"]
end

subgraph group_customer["Customer access"]
  node_customerapp["Customer app"]
  node_auth["PIN authentication"]
end

subgraph group_keys["Key tracking"]
  node_keyweb["Key management UI"]
  node_keyservice["Key records<br/>[ChaveService.java]"]
  node_supplier["Key suppliers"]
  node_machinekeys["Machine key links"]
end

subgraph group_game["Card game"]
  node_gameentry["Game endpoints"]
  node_gameservice["Game service<br/>[JogoService.java]"]
  node_rounds["Match state"]
  node_match["Card match<br/>[Partida.java]"]
end

subgraph group_instagram["Instagram profiles"]
  node_instagramapi["Instagram profile API"]
  node_instagramdata[("Instagram profiles")]
end

node_staff(("Staff user"))
node_client(("Customer"))

node_staff -.->|"submits requests"| node_maintenance
node_client -.->|"uses app"| node_customerapp
node_maintenance -.->|"records"| node_request
node_request -->|"contains problems"| node_problem
node_problem -->|"has execution"| node_execution
node_customerapp -.->|"authenticates"| node_auth
node_auth -->|"reads customer"| node_customerrepo
node_whatsapp -.->|"looks up customer"| node_customerrepo
node_whatsapp -.->|"updates confirmation"| node_request
node_pdf -->|"generates PDF"| node_pdfservice
node_pdf -->|"loads customer"| node_customerrepo
node_pdf -->|"loads execution"| node_execution
node_stock -->|"reads customers"| node_customerrepo
node_keyweb -->|"calls"| node_keyservice
node_keyweb -->|"calls"| node_supplier
node_keyweb -->|"calls"| node_machinekeys
node_keyservice -->|"resolves supplier"| node_supplier
node_machinekeys -->|"uses customer and machine"| node_customerdata
node_gameentry -.->|"dispatches"| node_gameservice
node_gameservice -->|"uses match service"| node_rounds
node_rounds -->|"creates and stores"| node_match
node_instagramapi -->|"reads profiles"| node_instagramdata

click node_maintenance "https://github.com/marcio72/azuremaquinas/tree/main/src/main/java/br/com/locaweb/relatorioclientes/controller"
click node_request "https://github.com/marcio72/azuremaquinas/blob/main/src/main/java/br/com/locaweb/relatorioclientes/model/SolicitacaoManutencao.java"
click node_problem "https://github.com/marcio72/azuremaquinas/blob/main/src/main/java/br/com/locaweb/relatorioclientes/model/ProblemaMaquina.java"
click node_execution "https://github.com/marcio72/azuremaquinas/blob/main/src/main/java/br/com/locaweb/relatorioclientes/model/ExecucaoManutencao.java"
click node_stock "https://github.com/marcio72/azuremaquinas/blob/main/src/main/java/br/com/locaweb/relatorioclientes/service/EstoqueService.java"
click node_customerdata "https://github.com/marcio72/azuremaquinas/blob/main/src/main/java/br/com/locaweb/relatorioclientes/model/Cliente.java"
click node_customerrepo "https://github.com/marcio72/azuremaquinas/blob/main/src/main/java/br/com/locaweb/relatorioclientes/repository/ClienteRepository.java"
click node_pdf "https://github.com/marcio72/azuremaquinas/blob/main/src/main/java/br/com/locaweb/relatorioclientes/controller/RelatorioPdfController.java"
click node_pdfservice "https://github.com/marcio72/azuremaquinas/blob/main/src/main/java/br/com/locaweb/relatorioclientes/service/PdfService.java"
click node_whatsapp "https://github.com/marcio72/azuremaquinas/blob/main/src/main/java/br/com/locaweb/relatorioclientes/service/WhatsAppChamadoService.java"
click node_customerapp "https://github.com/marcio72/azuremaquinas/blob/main/src/main/java/br/com/locaweb/relatorioclientes/clienteapp/controller/ClienteAppController.java"
click node_auth "https://github.com/marcio72/azuremaquinas/blob/main/src/main/java/br/com/locaweb/relatorioclientes/clienteapp/service/ClienteAppAuthService.java"
click node_keyweb "https://github.com/marcio72/azuremaquinas/blob/main/src/main/java/br/com/locaweb/relatorioclientes/chave/web/ChaveWebController.java"
click node_keyservice "https://github.com/marcio72/azuremaquinas/blob/main/src/main/java/br/com/locaweb/relatorioclientes/chave/service/ChaveService.java"
click node_supplier "https://github.com/marcio72/azuremaquinas/blob/main/src/main/java/br/com/locaweb/relatorioclientes/chave/service/FornecedorChaveService.java"
click node_machinekeys "https://github.com/marcio72/azuremaquinas/blob/main/src/main/java/br/com/locaweb/relatorioclientes/chave/service/MaquinaChaveService.java"
click node_gameentry "https://github.com/marcio72/azuremaquinas/tree/main/src/main/java/br/com/locaweb/relatorioclientes/jogo/controller"
click node_gameservice "https://github.com/marcio72/azuremaquinas/blob/main/src/main/java/br/com/locaweb/relatorioclientes/jogo/service/JogoService.java"
click node_rounds "https://github.com/marcio72/azuremaquinas/blob/main/src/main/java/br/com/locaweb/relatorioclientes/jogo/service/PartidaService.java"
click node_match "https://github.com/marcio72/azuremaquinas/blob/main/src/main/java/br/com/locaweb/relatorioclientes/jogo/model/Partida.java"
click node_instagramapi "https://github.com/marcio72/azuremaquinas/blob/main/src/main/java/br/com/locaweb/relatorioclientes/instagramcheck/controller/PerfilInstagramApiController.java"
click node_instagramdata "https://github.com/marcio72/azuremaquinas/blob/main/src/main/java/br/com/locaweb/relatorioclientes/instagramcheck/model/PerfilInstagram.java"

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_maintenance,node_request,node_problem,node_execution,node_stock,node_customerdata,node_customerrepo,node_pdf,node_pdfservice,node_whatsapp,node_staff toneBlue
class node_customerapp,node_auth toneAmber
class node_keyweb,node_keyservice,node_supplier,node_machinekeys toneMint
class node_gameentry,node_gameservice,node_rounds,node_match toneRose
class node_instagramapi,node_instagramdata,node_client toneIndigo
```

## Components

### Machine operations

- [Maintenance workflow](https://github.com/marcio72/azuremaquinas/tree/main/src/main/java/br/com/locaweb/relatorioclientes/controller): `src/main/java/br/com/locaweb/relatorioclientes/controller`
- [Service request](https://github.com/marcio72/azuremaquinas/blob/main/src/main/java/br/com/locaweb/relatorioclientes/model/SolicitacaoManutencao.java): `src/main/java/br/com/locaweb/relatorioclientes/model/SolicitacaoManutencao.java`
- [Machine problem](https://github.com/marcio72/azuremaquinas/blob/main/src/main/java/br/com/locaweb/relatorioclientes/model/ProblemaMaquina.java): `src/main/java/br/com/locaweb/relatorioclientes/model/ProblemaMaquina.java`
- [Service execution](https://github.com/marcio72/azuremaquinas/blob/main/src/main/java/br/com/locaweb/relatorioclientes/model/ExecucaoManutencao.java): `src/main/java/br/com/locaweb/relatorioclientes/model/ExecucaoManutencao.java`
- [Parts and stock](https://github.com/marcio72/azuremaquinas/blob/main/src/main/java/br/com/locaweb/relatorioclientes/service/EstoqueService.java): `src/main/java/br/com/locaweb/relatorioclientes/service/EstoqueService.java`
- [Customer and machines](https://github.com/marcio72/azuremaquinas/blob/main/src/main/java/br/com/locaweb/relatorioclientes/model/Cliente.java): `src/main/java/br/com/locaweb/relatorioclientes/model/Cliente.java`
- [Customer repository](https://github.com/marcio72/azuremaquinas/blob/main/src/main/java/br/com/locaweb/relatorioclientes/repository/ClienteRepository.java): `src/main/java/br/com/locaweb/relatorioclientes/repository/ClienteRepository.java`
- [PDF reporting](https://github.com/marcio72/azuremaquinas/blob/main/src/main/java/br/com/locaweb/relatorioclientes/controller/RelatorioPdfController.java): `src/main/java/br/com/locaweb/relatorioclientes/controller/RelatorioPdfController.java`
- [PDF generation](https://github.com/marcio72/azuremaquinas/blob/main/src/main/java/br/com/locaweb/relatorioclientes/service/PdfService.java): `src/main/java/br/com/locaweb/relatorioclientes/service/PdfService.java`
- [WhatsApp follow-up](https://github.com/marcio72/azuremaquinas/blob/main/src/main/java/br/com/locaweb/relatorioclientes/service/WhatsAppChamadoService.java): `src/main/java/br/com/locaweb/relatorioclientes/service/WhatsAppChamadoService.java`

### Customer access

- [Customer app](https://github.com/marcio72/azuremaquinas/blob/main/src/main/java/br/com/locaweb/relatorioclientes/clienteapp/controller/ClienteAppController.java): `src/main/java/br/com/locaweb/relatorioclientes/clienteapp/controller/ClienteAppController.java`
- [PIN authentication](https://github.com/marcio72/azuremaquinas/blob/main/src/main/java/br/com/locaweb/relatorioclientes/clienteapp/service/ClienteAppAuthService.java): `src/main/java/br/com/locaweb/relatorioclientes/clienteapp/service/ClienteAppAuthService.java`

### Key tracking

- [Key management UI](https://github.com/marcio72/azuremaquinas/blob/main/src/main/java/br/com/locaweb/relatorioclientes/chave/web/ChaveWebController.java): `src/main/java/br/com/locaweb/relatorioclientes/chave/web/ChaveWebController.java`
- [Key records](https://github.com/marcio72/azuremaquinas/blob/main/src/main/java/br/com/locaweb/relatorioclientes/chave/service/ChaveService.java): `src/main/java/br/com/locaweb/relatorioclientes/chave/service/ChaveService.java`
- [Key suppliers](https://github.com/marcio72/azuremaquinas/blob/main/src/main/java/br/com/locaweb/relatorioclientes/chave/service/FornecedorChaveService.java): `src/main/java/br/com/locaweb/relatorioclientes/chave/service/FornecedorChaveService.java`
- [Machine key links](https://github.com/marcio72/azuremaquinas/blob/main/src/main/java/br/com/locaweb/relatorioclientes/chave/service/MaquinaChaveService.java): `src/main/java/br/com/locaweb/relatorioclientes/chave/service/MaquinaChaveService.java`

### Card game

- [Game endpoints](https://github.com/marcio72/azuremaquinas/tree/main/src/main/java/br/com/locaweb/relatorioclientes/jogo/controller): `src/main/java/br/com/locaweb/relatorioclientes/jogo/controller`
- [Game service](https://github.com/marcio72/azuremaquinas/blob/main/src/main/java/br/com/locaweb/relatorioclientes/jogo/service/JogoService.java): `src/main/java/br/com/locaweb/relatorioclientes/jogo/service/JogoService.java`
- [Match state](https://github.com/marcio72/azuremaquinas/blob/main/src/main/java/br/com/locaweb/relatorioclientes/jogo/service/PartidaService.java): `src/main/java/br/com/locaweb/relatorioclientes/jogo/service/PartidaService.java`
- [Card match](https://github.com/marcio72/azuremaquinas/blob/main/src/main/java/br/com/locaweb/relatorioclientes/jogo/model/Partida.java): `src/main/java/br/com/locaweb/relatorioclientes/jogo/model/Partida.java`

### Instagram profiles

- [Instagram profile API](https://github.com/marcio72/azuremaquinas/blob/main/src/main/java/br/com/locaweb/relatorioclientes/instagramcheck/controller/PerfilInstagramApiController.java): `src/main/java/br/com/locaweb/relatorioclientes/instagramcheck/controller/PerfilInstagramApiController.java`
- [Instagram profiles](https://github.com/marcio72/azuremaquinas/blob/main/src/main/java/br/com/locaweb/relatorioclientes/instagramcheck/model/PerfilInstagram.java): `src/main/java/br/com/locaweb/relatorioclientes/instagramcheck/model/PerfilInstagram.java`

### Other components

- **Staff user**
- **Customer**

## Connections

- Staff user → Maintenance workflow: submits requests
- Customer → Customer app: uses app
- Maintenance workflow → Service request: records (evidence: `src/main/java/br/com/locaweb/relatorioclientes/controller/ClienteCrudController.java`)
- Service request → Machine problem: contains problems (evidence: `src/main/java/br/com/locaweb/relatorioclientes/model/SolicitacaoManutencao.java`)
- Machine problem → Service execution: has execution (evidence: `src/main/java/br/com/locaweb/relatorioclientes/model/ProblemaMaquina.java`)
- Customer app → PIN authentication: authenticates
- PIN authentication → Customer repository: reads customer (evidence: `src/main/java/br/com/locaweb/relatorioclientes/clienteapp/service/ClienteAppAuthService.java`)
- WhatsApp follow-up → Customer repository: looks up customer (evidence: `src/main/java/br/com/locaweb/relatorioclientes/service/WhatsAppChamadoService.java`)
- WhatsApp follow-up → Service request: updates confirmation (evidence: `src/main/java/br/com/locaweb/relatorioclientes/service/WhatsAppChamadoService.java`)
- PDF reporting → PDF generation: generates PDF (evidence: `src/main/java/br/com/locaweb/relatorioclientes/controller/RelatorioPdfController.java`)
- PDF reporting → Customer repository: loads customer (evidence: `src/main/java/br/com/locaweb/relatorioclientes/controller/RelatorioPdfController.java`)
- PDF reporting → Service execution: loads execution (evidence: `src/main/java/br/com/locaweb/relatorioclientes/controller/RelatorioPdfController.java`)
- Parts and stock → Customer repository: reads customers (evidence: `src/main/java/br/com/locaweb/relatorioclientes/service/EstoqueService.java`)
- Key management UI → Key records: calls (evidence: `src/main/java/br/com/locaweb/relatorioclientes/chave/web/ChaveWebController.java`)
- Key management UI → Key suppliers: calls (evidence: `src/main/java/br/com/locaweb/relatorioclientes/chave/web/ChaveWebController.java`)
- Key management UI → Machine key links: calls (evidence: `src/main/java/br/com/locaweb/relatorioclientes/chave/web/ChaveWebController.java`)
- Key records → Key suppliers: resolves supplier (evidence: `src/main/java/br/com/locaweb/relatorioclientes/chave/service/ChaveService.java`)
- Machine key links → Customer and machines: uses customer and machine (evidence: `src/main/java/br/com/locaweb/relatorioclientes/chave/service/MaquinaChaveService.java`)
- Game endpoints → Game service: dispatches (evidence: `src/main/java/br/com/locaweb/relatorioclientes/jogo/controller/JogoController.java`)
- Game service → Match state: uses match service (evidence: `src/main/java/br/com/locaweb/relatorioclientes/jogo/service/JogoService.java`)
- Match state → Card match: creates and stores (evidence: `src/main/java/br/com/locaweb/relatorioclientes/jogo/service/PartidaService.java`)
- Instagram profile API → Instagram profiles: reads profiles (evidence: `src/main/java/br/com/locaweb/relatorioclientes/instagramcheck/controller/PerfilInstagramApiController.java`)
