# kauanguilhermesantos/rep-hub architecture

> Architecture diagram of the GitHub repository kauanguilhermesantos/rep-hub, 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/kauanguilhermesantos/rep-hub
- Repository: https://github.com/kauanguilhermesantos/rep-hub

## Overview

Rephub is a sales and trip-finance management application: users manage brands and orders, organize orders into trips, record trip expenses, and review summaries and reports. The frontend pages call service modules that access the backend API; backend controllers delegate domain operations to services, which use repositories for persistence. Authentication/profile and reporting are distinct capabilities. Several backend subsystems are represented from the file tree and controller references; their internal calls are not inferred where source was not sampled.

Main entry points: [`src/services`](https://github.com/kauanguilhermesantos/rep-hub/tree/main/src/services) (API services), [`rephub-backend/src/main/java/com/rephub/services/ViagemService.java`](https://github.com/kauanguilhermesantos/rep-hub/blob/main/rephub-backend/src/main/java/com/rephub/services/ViagemService.java) (Trip logic), [`src/app/(app)/home/page.tsx`](https://github.com/kauanguilhermesantos/rep-hub/blob/main/src/app/(app)/home/page.tsx) (Dashboard), [`src/app/(app)/pedidos/page.tsx`](https://github.com/kauanguilhermesantos/rep-hub/blob/main/src/app/(app)/pedidos/page.tsx) (Orders)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_home["Dashboard<br/>[page.tsx]"]
  node_orders_ui["Orders<br/>[page.tsx]"]
  node_trips_ui["Trips<br/>[page.tsx]"]
  node_trip_detail["Trip details<br/>[page.tsx]"]
  node_profile_ui["Profile<br/>[page.tsx]"]
  node_reports_ui["Reports<br/>[page.tsx]"]
  node_web_services["API services"]
  node_auth["Auth utilities<br/>[Auth.ts]"]
end

subgraph group_backend["Backend API"]
  node_order_controller["Order API"]
  node_trip_controller["Trip API"]
  node_expense_controller["Expense API"]
  node_profile_controller["User API"]
  node_report_controller["Reports API"]
end

subgraph group_domain["Domain services"]
  node_order_service["Order logic<br/>[PedidoService.java]"]
  node_trip_service["Trip logic<br/>[ViagemService.java]"]
  node_expense_service["Expense logic"]
  node_category_service["Expense categories"]
  node_report_service["Report logic"]
  node_brand_service["Brand logic<br/>[MarcaService.java]"]
  node_user_service["User logic"]
end

subgraph group_persistence["Persistence"]
  node_order_store[("Order repository")]
  node_trip_store[("Trip repository")]
  node_expense_store[("Expense repository")]
  node_user_store[("User repository")]
end

node_user(("User"))

node_user -->|"views"| node_home
node_user -->|"manages orders"| node_orders_ui
node_user -->|"manages trips"| node_trips_ui
node_user -->|"records trip activity"| node_trip_detail
node_user -->|"edits profile"| node_profile_ui
node_user -.->|"views reports"| node_reports_ui
node_home -->|"requests summaries"| node_web_services
node_orders_ui -->|"loads and changes"| node_web_services
node_trips_ui -->|"loads trips"| node_web_services
node_trip_detail -->|"loads trip data"| node_web_services
node_profile_ui -->|"updates profile"| node_web_services
node_web_services -->|"authenticated fetch"| node_auth
node_web_services -->|"calls order API"| node_order_controller
node_web_services -->|"calls trip API"| node_trip_controller
node_web_services -->|"calls expense API"| node_expense_controller
node_web_services -->|"calls user API"| node_profile_controller
node_web_services -.->|"calls reports API"| node_report_controller
node_order_controller -->|"delegates"| node_order_service
node_trip_controller -->|"delegates"| node_trip_service
node_trip_service -->|"reads orders"| node_order_store
node_trip_service -.->|"reads and writes trips"| node_trip_store
node_expense_controller -.->|"delegates"| node_expense_service
node_expense_service -.->|"persists expenses"| node_expense_store
node_category_service -->|"checks usage"| node_expense_store
node_report_controller -.->|"delegates"| node_report_service
node_profile_controller -.->|"delegates"| node_user_service
node_user_service -.->|"accesses users"| node_user_store
node_order_service -.->|"queries orders"| node_order_store

click node_home "https://github.com/kauanguilhermesantos/rep-hub/blob/main/src/app/(app)/home/page.tsx"
click node_orders_ui "https://github.com/kauanguilhermesantos/rep-hub/blob/main/src/app/(app)/pedidos/page.tsx"
click node_trips_ui "https://github.com/kauanguilhermesantos/rep-hub/blob/main/src/app/(app)/viagens/page.tsx"
click node_trip_detail "https://github.com/kauanguilhermesantos/rep-hub/blob/main/src/app/(app)/viagens/%5Bid%5D/page.tsx"
click node_profile_ui "https://github.com/kauanguilhermesantos/rep-hub/blob/main/src/app/(app)/perfil/page.tsx"
click node_reports_ui "https://github.com/kauanguilhermesantos/rep-hub/blob/main/src/app/(app)/relatorios/page.tsx"
click node_web_services "https://github.com/kauanguilhermesantos/rep-hub/tree/main/src/services"
click node_auth "https://github.com/kauanguilhermesantos/rep-hub/blob/main/src/lib/Auth.ts"
click node_order_controller "https://github.com/kauanguilhermesantos/rep-hub/blob/main/rephub-backend/src/main/java/com/rephub/controllers/PedidoController.java"
click node_trip_controller "https://github.com/kauanguilhermesantos/rep-hub/blob/main/rephub-backend/src/main/java/com/rephub/controllers/ViagemController.java"
click node_expense_controller "https://github.com/kauanguilhermesantos/rep-hub/blob/main/rephub-backend/src/main/java/com/rephub/controllers/DespesaController.java"
click node_profile_controller "https://github.com/kauanguilhermesantos/rep-hub/blob/main/rephub-backend/src/main/java/com/rephub/controllers/UsuarioController.java"
click node_report_controller "https://github.com/kauanguilhermesantos/rep-hub/blob/main/rephub-backend/src/main/java/com/rephub/controllers/RelatorioController.java"
click node_order_service "https://github.com/kauanguilhermesantos/rep-hub/blob/main/rephub-backend/src/main/java/com/rephub/services/PedidoService.java"
click node_trip_service "https://github.com/kauanguilhermesantos/rep-hub/blob/main/rephub-backend/src/main/java/com/rephub/services/ViagemService.java"
click node_expense_service "https://github.com/kauanguilhermesantos/rep-hub/blob/main/rephub-backend/src/main/java/com/rephub/services/DespesaService.java"
click node_category_service "https://github.com/kauanguilhermesantos/rep-hub/blob/main/rephub-backend/src/main/java/com/rephub/services/CategoriaDespesaService.java"
click node_report_service "https://github.com/kauanguilhermesantos/rep-hub/blob/main/rephub-backend/src/main/java/com/rephub/services/RelatorioService.java"
click node_brand_service "https://github.com/kauanguilhermesantos/rep-hub/blob/main/rephub-backend/src/main/java/com/rephub/services/MarcaService.java"
click node_user_service "https://github.com/kauanguilhermesantos/rep-hub/blob/main/rephub-backend/src/main/java/com/rephub/services/UsuarioService.java"
click node_order_store "https://github.com/kauanguilhermesantos/rep-hub/blob/main/rephub-backend/src/main/java/com/rephub/repositories/PedidoRepository.java"
click node_trip_store "https://github.com/kauanguilhermesantos/rep-hub/blob/main/rephub-backend/src/main/java/com/rephub/repositories/ViagemRepository.java"
click node_expense_store "https://github.com/kauanguilhermesantos/rep-hub/blob/main/rephub-backend/src/main/java/com/rephub/repositories/DespesaRepository.java"
click node_user_store "https://github.com/kauanguilhermesantos/rep-hub/blob/main/rephub-backend/src/main/java/com/rephub/repositories/UsuarioRepository.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_home,node_orders_ui,node_trips_ui,node_trip_detail,node_profile_ui,node_reports_ui,node_web_services,node_auth,node_user toneBlue
class node_order_controller,node_trip_controller,node_expense_controller,node_profile_controller,node_report_controller toneAmber
class node_order_service,node_trip_service,node_expense_service,node_category_service,node_report_service,node_brand_service,node_user_service toneMint
class node_order_store,node_trip_store,node_expense_store,node_user_store toneRose
```

## Components

### Web application

- [Dashboard](https://github.com/kauanguilhermesantos/rep-hub/blob/main/src/app/(app)/home/page.tsx): `src/app/(app)/home/page.tsx`
- [Orders](https://github.com/kauanguilhermesantos/rep-hub/blob/main/src/app/(app)/pedidos/page.tsx): `src/app/(app)/pedidos/page.tsx`
- [Trips](https://github.com/kauanguilhermesantos/rep-hub/blob/main/src/app/(app)/viagens/page.tsx): `src/app/(app)/viagens/page.tsx`
- [Trip details](https://github.com/kauanguilhermesantos/rep-hub/blob/main/src/app/(app)/viagens/%5Bid%5D/page.tsx): `src/app/(app)/viagens/[id]/page.tsx`
- [Profile](https://github.com/kauanguilhermesantos/rep-hub/blob/main/src/app/(app)/perfil/page.tsx): `src/app/(app)/perfil/page.tsx`
- [Reports](https://github.com/kauanguilhermesantos/rep-hub/blob/main/src/app/(app)/relatorios/page.tsx): `src/app/(app)/relatorios/page.tsx`
- [API services](https://github.com/kauanguilhermesantos/rep-hub/tree/main/src/services): `src/services`
- [Auth utilities](https://github.com/kauanguilhermesantos/rep-hub/blob/main/src/lib/Auth.ts): `src/lib/Auth.ts`

### Backend API

- [Order API](https://github.com/kauanguilhermesantos/rep-hub/blob/main/rephub-backend/src/main/java/com/rephub/controllers/PedidoController.java): `rephub-backend/src/main/java/com/rephub/controllers/PedidoController.java`
- [Trip API](https://github.com/kauanguilhermesantos/rep-hub/blob/main/rephub-backend/src/main/java/com/rephub/controllers/ViagemController.java): `rephub-backend/src/main/java/com/rephub/controllers/ViagemController.java`
- [Expense API](https://github.com/kauanguilhermesantos/rep-hub/blob/main/rephub-backend/src/main/java/com/rephub/controllers/DespesaController.java): `rephub-backend/src/main/java/com/rephub/controllers/DespesaController.java`
- [User API](https://github.com/kauanguilhermesantos/rep-hub/blob/main/rephub-backend/src/main/java/com/rephub/controllers/UsuarioController.java): `rephub-backend/src/main/java/com/rephub/controllers/UsuarioController.java`
- [Reports API](https://github.com/kauanguilhermesantos/rep-hub/blob/main/rephub-backend/src/main/java/com/rephub/controllers/RelatorioController.java): `rephub-backend/src/main/java/com/rephub/controllers/RelatorioController.java`

### Domain services

- [Order logic](https://github.com/kauanguilhermesantos/rep-hub/blob/main/rephub-backend/src/main/java/com/rephub/services/PedidoService.java): `rephub-backend/src/main/java/com/rephub/services/PedidoService.java`
- [Trip logic](https://github.com/kauanguilhermesantos/rep-hub/blob/main/rephub-backend/src/main/java/com/rephub/services/ViagemService.java): `rephub-backend/src/main/java/com/rephub/services/ViagemService.java`
- [Expense logic](https://github.com/kauanguilhermesantos/rep-hub/blob/main/rephub-backend/src/main/java/com/rephub/services/DespesaService.java): `rephub-backend/src/main/java/com/rephub/services/DespesaService.java`
- [Expense categories](https://github.com/kauanguilhermesantos/rep-hub/blob/main/rephub-backend/src/main/java/com/rephub/services/CategoriaDespesaService.java): `rephub-backend/src/main/java/com/rephub/services/CategoriaDespesaService.java`
- [Report logic](https://github.com/kauanguilhermesantos/rep-hub/blob/main/rephub-backend/src/main/java/com/rephub/services/RelatorioService.java): `rephub-backend/src/main/java/com/rephub/services/RelatorioService.java`
- [Brand logic](https://github.com/kauanguilhermesantos/rep-hub/blob/main/rephub-backend/src/main/java/com/rephub/services/MarcaService.java): `rephub-backend/src/main/java/com/rephub/services/MarcaService.java`
- [User logic](https://github.com/kauanguilhermesantos/rep-hub/blob/main/rephub-backend/src/main/java/com/rephub/services/UsuarioService.java): `rephub-backend/src/main/java/com/rephub/services/UsuarioService.java`

### Persistence

- [Order repository](https://github.com/kauanguilhermesantos/rep-hub/blob/main/rephub-backend/src/main/java/com/rephub/repositories/PedidoRepository.java): `rephub-backend/src/main/java/com/rephub/repositories/PedidoRepository.java`
- [Trip repository](https://github.com/kauanguilhermesantos/rep-hub/blob/main/rephub-backend/src/main/java/com/rephub/repositories/ViagemRepository.java): `rephub-backend/src/main/java/com/rephub/repositories/ViagemRepository.java`
- [Expense repository](https://github.com/kauanguilhermesantos/rep-hub/blob/main/rephub-backend/src/main/java/com/rephub/repositories/DespesaRepository.java): `rephub-backend/src/main/java/com/rephub/repositories/DespesaRepository.java`
- [User repository](https://github.com/kauanguilhermesantos/rep-hub/blob/main/rephub-backend/src/main/java/com/rephub/repositories/UsuarioRepository.java): `rephub-backend/src/main/java/com/rephub/repositories/UsuarioRepository.java`

### Other components

- **User**

## Connections

- User → Dashboard: views (evidence: `src/app/(app)/home/page.tsx`)
- User → Orders: manages orders (evidence: `src/app/(app)/pedidos/page.tsx`)
- User → Trips: manages trips (evidence: `src/app/(app)/viagens/page.tsx`)
- User → Trip details: records trip activity
- User → Profile: edits profile (evidence: `src/app/(app)/perfil/page.tsx`)
- User → Reports: views reports
- Dashboard → API services: requests summaries (evidence: `src/app/(app)/home/page.tsx`)
- Orders → API services: loads and changes (evidence: `src/app/(app)/pedidos/page.tsx`)
- Trips → API services: loads trips (evidence: `src/app/(app)/viagens/page.tsx`)
- Trip details → API services: loads trip data (evidence: `src/app/(app)/viagens/[id]/page.tsx`)
- Profile → API services: updates profile (evidence: `src/app/(app)/perfil/page.tsx`)
- API services → Auth utilities: authenticated fetch (evidence: `src/services/viagensService.ts`)
- API services → Order API: calls order API (evidence: `src/services/pedidoService.ts`)
- API services → Trip API: calls trip API (evidence: `src/services/viagensService.ts`)
- API services → Expense API: calls expense API (evidence: `src/services/despesasService.ts`)
- API services → User API: calls user API
- API services → Reports API: calls reports API
- Order API → Order logic: delegates (evidence: `rephub-backend/src/main/java/com/rephub/controllers/PedidoController.java`)
- Trip API → Trip logic: delegates (evidence: `rephub-backend/src/main/java/com/rephub/controllers/ViagemController.java`)
- Trip logic → Order repository: reads orders (evidence: `rephub-backend/src/main/java/com/rephub/services/ViagemService.java`)
- Trip logic → Trip repository: reads and writes trips (evidence: `rephub-backend/src/main/java/com/rephub/services/ViagemService.java`)
- Expense API → Expense logic: delegates
- Expense logic → Expense repository: persists expenses (evidence: `rephub-backend/src/main/java/com/rephub/services/DespesaService.java`)
- Expense categories → Expense repository: checks usage (evidence: `rephub-backend/src/main/java/com/rephub/services/CategoriaDespesaService.java`)
- Reports API → Report logic: delegates
- User API → User logic: delegates
- User logic → User repository: accesses users
- Order logic → Order repository: queries orders (evidence: `rephub-backend/src/main/java/com/rephub/services/PedidoService.java`)
