# ggames/sarh-hexagonal-final architecture

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

- Interactive diagram: https://gitdiagram.com/ggames/sarh-hexagonal-final
- Repository: https://github.com/ggames/sarh-hexagonal-final

## Overview

SARH is a Spring backend for managing personnel and organizational positions. The visible workflow is a client request to REST endpoints, which delegate to application ports for position and plant operations; plant searches can also produce Excel reports. Separate capabilities cover authentication and user administration, agents, organizational units and subunits, movements, plant history, points, and transformations. The README provides no further product description, and several subsystems are represented only by the tree, so their internal links are omitted or marked unverified.

Main entry points: [`src/main/java/com/fich/sarh/position/infrastructure/adapters/inbound/rest/controller/PositionController.java`](https://github.com/ggames/sarh-hexagonal-final/blob/master/src/main/java/com/fich/sarh/position/infrastructure/adapters/inbound/rest/controller/PositionController.java) (Position API), [`src/main/java/com/fich/sarh/plantofpositions/infrastructure/adapters/inbound/rest/controller/PlantPositionController.java`](https://github.com/ggames/sarh-hexagonal-final/blob/master/src/main/java/com/fich/sarh/plantofpositions/infrastructure/adapters/inbound/rest/controller/PlantPositionController.java) (Plant API), [`src/main/java/com/fich/sarh/auth/Application/services/AuthServiceUseCase.java`](https://github.com/ggames/sarh-hexagonal-final/blob/master/src/main/java/com/fich/sarh/auth/Application/services/AuthServiceUseCase.java) (Authentication), [`src/main/java/com/fich/sarh/auth/Infrastructure/adapter/input/rest/controller/UserController.java`](https://github.com/ggames/sarh-hexagonal-final/blob/master/src/main/java/com/fich/sarh/auth/Infrastructure/adapter/input/rest/controller/UserController.java) (User administration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and users"]
  node_auth["Authentication"]
  node_jwt["JWT utilities<br/>[JwtUtils.java]"]
  node_userdetails["User details"]
  node_useradmin["User administration"]
  node_usercases["User use cases"]
  node_authsecurity["Security configuration"]
end

subgraph group_organization["Organization"]
  node_agent["Agent records"]
  node_orgunit["Organizational units"]
  node_subunit["Organizational subunits"]
end

subgraph group_positions["Positions and plants"]
  node_positionapi["Position API"]
  node_positioncases["Position operations"]
  node_positiondomain["Position model<br/>[Position.java]"]
  node_plantapi["Plant API"]
  node_plantcases["Plant operations"]
  node_plantreport["Excel reporting"]
  node_movement["Movements"]
  node_history["Plant history"]
  node_point["Points"]
  node_transformation["Transformations"]
end

subgraph group_shared["Shared infrastructure"]
  node_database[("Relational persistence")]
  node_web["Web adapter marker<br/>[WebAdapter.java]"]
end

node_client(("API client"))

node_client -->|"requests"| node_positionapi
node_positionapi -.->|"delegates"| node_positioncases
node_positionapi -->|"uses model"| node_positiondomain
node_client -->|"requests"| node_plantapi
node_plantapi -.->|"delegates"| node_plantcases
node_plantapi -->|"requests report"| node_plantreport
node_auth -->|"creates tokens"| node_jwt
node_auth -->|"loads user"| node_userdetails
node_client -->|"requests"| node_useradmin
node_useradmin -->|"uses ports"| node_usercases
node_client -->|"requests"| node_agent
node_client -->|"requests"| node_orgunit
node_positiondomain -->|"maps relationships"| node_database
node_positionapi -->|"uses annotation"| node_web

click node_auth "https://github.com/ggames/sarh-hexagonal-final/blob/master/src/main/java/com/fich/sarh/auth/Application/services/AuthServiceUseCase.java"
click node_jwt "https://github.com/ggames/sarh-hexagonal-final/blob/master/src/main/java/com/fich/sarh/auth/Infrastructure/adapter/configuration/security/jwt/JwtUtils.java"
click node_userdetails "https://github.com/ggames/sarh-hexagonal-final/blob/master/src/main/java/com/fich/sarh/auth/Infrastructure/adapter/output/persistence/adapter/UserDetailPersistenceAdapter.java"
click node_useradmin "https://github.com/ggames/sarh-hexagonal-final/blob/master/src/main/java/com/fich/sarh/auth/Infrastructure/adapter/input/rest/controller/UserController.java"
click node_usercases "https://github.com/ggames/sarh-hexagonal-final/tree/master/src/main/java/com/fich/sarh/auth/Application/services"
click node_authsecurity "https://github.com/ggames/sarh-hexagonal-final/blob/master/src/main/java/com/fich/sarh/auth/Infrastructure/adapter/configuration/security/SecurityConfig.java"
click node_agent "https://github.com/ggames/sarh-hexagonal-final/blob/master/src/main/java/com/fich/sarh/agent/infrastructure/adapters/inbound/rest/controller/AgentController.java"
click node_orgunit "https://github.com/ggames/sarh-hexagonal-final/blob/master/src/main/java/com/fich/sarh/organizationalunit/infrastructure/adapters/inbound/rest/controller/OrganizationalUnitController.java"
click node_subunit "https://github.com/ggames/sarh-hexagonal-final/tree/master/src/main/java/com/fich/sarh/organizationalsubunit"
click node_positionapi "https://github.com/ggames/sarh-hexagonal-final/blob/master/src/main/java/com/fich/sarh/position/infrastructure/adapters/inbound/rest/controller/PositionController.java"
click node_positioncases "https://github.com/ggames/sarh-hexagonal-final/blob/master/src/main/java/com/fich/sarh/position/application/usecases/PositionApiPortUseCases.java"
click node_positiondomain "https://github.com/ggames/sarh-hexagonal-final/blob/master/src/main/java/com/fich/sarh/position/domain/model/Position.java"
click node_plantapi "https://github.com/ggames/sarh-hexagonal-final/blob/master/src/main/java/com/fich/sarh/plantofpositions/infrastructure/adapters/inbound/rest/controller/PlantPositionController.java"
click node_plantcases "https://github.com/ggames/sarh-hexagonal-final/blob/master/src/main/java/com/fich/sarh/plantofpositions/application/usecases/PlantPositionUseCases.java"
click node_plantreport "https://github.com/ggames/sarh-hexagonal-final/blob/master/src/main/java/com/fich/sarh/plantofpositions/infrastructure/adapters/outbound/persistence/service/ExcelPlantReportService.java"
click node_movement "https://github.com/ggames/sarh-hexagonal-final/tree/master/src/main/java/com/fich/sarh/movement"
click node_history "https://github.com/ggames/sarh-hexagonal-final/tree/master/src/main/java/com/fich/sarh/planthistory"
click node_point "https://github.com/ggames/sarh-hexagonal-final/tree/master/src/main/java/com/fich/sarh/point"
click node_transformation "https://github.com/ggames/sarh-hexagonal-final/tree/master/src/main/java/com/fich/sarh/transformation"
click node_database "https://github.com/ggames/sarh-hexagonal-final/blob/master/src/main/java/com/fich/sarh/position/infrastructure/adapters/output/persistence/entity/PositionEntity.java"
click node_web "https://github.com/ggames/sarh-hexagonal-final/blob/master/src/main/java/com/fich/sarh/common/WebAdapter.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_auth,node_jwt,node_userdetails,node_useradmin,node_usercases,node_authsecurity,node_client toneBlue
class node_agent,node_orgunit,node_subunit toneAmber
class node_positionapi,node_positioncases,node_positiondomain,node_plantapi,node_plantcases,node_plantreport,node_movement,node_history,node_point,node_transformation toneMint
class node_database,node_web toneRose
```

## Components

### Access and users

- [Authentication](https://github.com/ggames/sarh-hexagonal-final/blob/master/src/main/java/com/fich/sarh/auth/Application/services/AuthServiceUseCase.java): `src/main/java/com/fich/sarh/auth/Application/services/AuthServiceUseCase.java`
- [JWT utilities](https://github.com/ggames/sarh-hexagonal-final/blob/master/src/main/java/com/fich/sarh/auth/Infrastructure/adapter/configuration/security/jwt/JwtUtils.java): `src/main/java/com/fich/sarh/auth/Infrastructure/adapter/configuration/security/jwt/JwtUtils.java`
- [User details](https://github.com/ggames/sarh-hexagonal-final/blob/master/src/main/java/com/fich/sarh/auth/Infrastructure/adapter/output/persistence/adapter/UserDetailPersistenceAdapter.java): `src/main/java/com/fich/sarh/auth/Infrastructure/adapter/output/persistence/adapter/UserDetailPersistenceAdapter.java`
- [User administration](https://github.com/ggames/sarh-hexagonal-final/blob/master/src/main/java/com/fich/sarh/auth/Infrastructure/adapter/input/rest/controller/UserController.java): `src/main/java/com/fich/sarh/auth/Infrastructure/adapter/input/rest/controller/UserController.java`
- [User use cases](https://github.com/ggames/sarh-hexagonal-final/tree/master/src/main/java/com/fich/sarh/auth/Application/services): `src/main/java/com/fich/sarh/auth/Application/services`
- [Security configuration](https://github.com/ggames/sarh-hexagonal-final/blob/master/src/main/java/com/fich/sarh/auth/Infrastructure/adapter/configuration/security/SecurityConfig.java): `src/main/java/com/fich/sarh/auth/Infrastructure/adapter/configuration/security/SecurityConfig.java`

### Organization

- [Agent records](https://github.com/ggames/sarh-hexagonal-final/blob/master/src/main/java/com/fich/sarh/agent/infrastructure/adapters/inbound/rest/controller/AgentController.java): `src/main/java/com/fich/sarh/agent/infrastructure/adapters/inbound/rest/controller/AgentController.java`
- [Organizational units](https://github.com/ggames/sarh-hexagonal-final/blob/master/src/main/java/com/fich/sarh/organizationalunit/infrastructure/adapters/inbound/rest/controller/OrganizationalUnitController.java): `src/main/java/com/fich/sarh/organizationalunit/infrastructure/adapters/inbound/rest/controller/OrganizationalUnitController.java`
- [Organizational subunits](https://github.com/ggames/sarh-hexagonal-final/tree/master/src/main/java/com/fich/sarh/organizationalsubunit): `src/main/java/com/fich/sarh/organizationalsubunit`

### Positions and plants

- [Position API](https://github.com/ggames/sarh-hexagonal-final/blob/master/src/main/java/com/fich/sarh/position/infrastructure/adapters/inbound/rest/controller/PositionController.java): `src/main/java/com/fich/sarh/position/infrastructure/adapters/inbound/rest/controller/PositionController.java`
- [Position operations](https://github.com/ggames/sarh-hexagonal-final/blob/master/src/main/java/com/fich/sarh/position/application/usecases/PositionApiPortUseCases.java): `src/main/java/com/fich/sarh/position/application/usecases/PositionApiPortUseCases.java`
- [Position model](https://github.com/ggames/sarh-hexagonal-final/blob/master/src/main/java/com/fich/sarh/position/domain/model/Position.java): `src/main/java/com/fich/sarh/position/domain/model/Position.java`
- [Plant API](https://github.com/ggames/sarh-hexagonal-final/blob/master/src/main/java/com/fich/sarh/plantofpositions/infrastructure/adapters/inbound/rest/controller/PlantPositionController.java): `src/main/java/com/fich/sarh/plantofpositions/infrastructure/adapters/inbound/rest/controller/PlantPositionController.java`
- [Plant operations](https://github.com/ggames/sarh-hexagonal-final/blob/master/src/main/java/com/fich/sarh/plantofpositions/application/usecases/PlantPositionUseCases.java): `src/main/java/com/fich/sarh/plantofpositions/application/usecases/PlantPositionUseCases.java`
- [Excel reporting](https://github.com/ggames/sarh-hexagonal-final/blob/master/src/main/java/com/fich/sarh/plantofpositions/infrastructure/adapters/outbound/persistence/service/ExcelPlantReportService.java): `src/main/java/com/fich/sarh/plantofpositions/infrastructure/adapters/outbound/persistence/service/ExcelPlantReportService.java`
- [Movements](https://github.com/ggames/sarh-hexagonal-final/tree/master/src/main/java/com/fich/sarh/movement): `src/main/java/com/fich/sarh/movement`
- [Plant history](https://github.com/ggames/sarh-hexagonal-final/tree/master/src/main/java/com/fich/sarh/planthistory): `src/main/java/com/fich/sarh/planthistory`
- [Points](https://github.com/ggames/sarh-hexagonal-final/tree/master/src/main/java/com/fich/sarh/point): `src/main/java/com/fich/sarh/point`
- [Transformations](https://github.com/ggames/sarh-hexagonal-final/tree/master/src/main/java/com/fich/sarh/transformation): `src/main/java/com/fich/sarh/transformation`

### Shared infrastructure

- [Relational persistence](https://github.com/ggames/sarh-hexagonal-final/blob/master/src/main/java/com/fich/sarh/position/infrastructure/adapters/output/persistence/entity/PositionEntity.java): `src/main/java/com/fich/sarh/position/infrastructure/adapters/output/persistence/entity/PositionEntity.java`
- [Web adapter marker](https://github.com/ggames/sarh-hexagonal-final/blob/master/src/main/java/com/fich/sarh/common/WebAdapter.java): `src/main/java/com/fich/sarh/common/WebAdapter.java`

### Other components

- **API client**

## Connections

- API client → Position API: requests (evidence: `src/main/java/com/fich/sarh/position/infrastructure/adapters/inbound/rest/controller/PositionController.java`)
- Position API → Position operations: delegates
- Position API → Position model: uses model (evidence: `src/main/java/com/fich/sarh/position/infrastructure/adapters/inbound/rest/controller/PositionController.java`)
- API client → Plant API: requests (evidence: `src/main/java/com/fich/sarh/plantofpositions/infrastructure/adapters/inbound/rest/controller/PlantPositionController.java`)
- Plant API → Plant operations: delegates
- Plant API → Excel reporting: requests report (evidence: `src/main/java/com/fich/sarh/plantofpositions/infrastructure/adapters/inbound/rest/controller/PlantPositionController.java`)
- Authentication → JWT utilities: creates tokens (evidence: `src/main/java/com/fich/sarh/auth/Application/services/AuthServiceUseCase.java`)
- Authentication → User details: loads user (evidence: `src/main/java/com/fich/sarh/auth/Application/services/AuthServiceUseCase.java`)
- API client → User administration: requests (evidence: `src/main/java/com/fich/sarh/auth/Infrastructure/adapter/input/rest/controller/UserController.java`)
- User administration → User use cases: uses ports (evidence: `src/main/java/com/fich/sarh/auth/Infrastructure/adapter/input/rest/controller/UserController.java`)
- API client → Agent records: requests (evidence: `src/main/java/com/fich/sarh/agent/infrastructure/adapters/inbound/rest/controller/AgentController.java`)
- API client → Organizational units: requests (evidence: `src/main/java/com/fich/sarh/organizationalunit/infrastructure/adapters/inbound/rest/controller/OrganizationalUnitController.java`)
- Position model → Relational persistence: maps relationships (evidence: `src/main/java/com/fich/sarh/position/infrastructure/adapters/output/persistence/entity/PositionEntity.java`)
- Position API → Web adapter marker: uses annotation (evidence: `src/main/java/com/fich/sarh/position/infrastructure/adapters/inbound/rest/controller/PositionController.java`)
