How ggames/sarh-hexagonal-final works
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: PositionController.java Position API · PlantPositionController.java Plant API · AuthServiceUseCase.java Authentication · UserController.java User administration
Components 22
Access and users
- Authentication
src/main/java/com/fich/sarh/auth/Application/services/AuthServiceUseCase.java - JWT utilities
src/main/java/com/fich/sarh/auth/Infrastructure/adapter/configuration/security/jwt/JwtUtils.java - User details
src/main/java/com/fich/sarh/auth/Infrastructure/adapter/output/persistence/adapter/UserDetailPersistenceAdapter.java - User administration
src/main/java/com/fich/sarh/auth/Infrastructure/adapter/input/rest/controller/UserController.java - User use cases
src/main/java/com/fich/sarh/auth/Application/services - Security configuration
src/main/java/com/fich/sarh/auth/Infrastructure/adapter/configuration/security/SecurityConfig.java
Organization
- Agent records
src/main/java/com/fich/sarh/agent/infrastructure/adapters/inbound/rest/controller/AgentController.java - Organizational units
src/main/java/com/fich/sarh/organizationalunit/infrastructure/adapters/inbound/rest/controller/OrganizationalUnitController.java - Organizational subunits
src/main/java/com/fich/sarh/organizationalsubunit
Positions and plants
- Position API
src/main/java/com/fich/sarh/position/infrastructure/adapters/inbound/rest/controller/PositionController.java - Position operations
src/main/java/com/fich/sarh/position/application/usecases/PositionApiPortUseCases.java - Position model
src/main/java/com/fich/sarh/position/domain/model/Position.java - Plant API
src/main/java/com/fich/sarh/plantofpositions/infrastructure/adapters/inbound/rest/controller/PlantPositionController.java - Plant operations
src/main/java/com/fich/sarh/plantofpositions/application/usecases/PlantPositionUseCases.java - Excel reporting
src/main/java/com/fich/sarh/plantofpositions/infrastructure/adapters/outbound/persistence/service/ExcelPlantReportService.java - Movements
src/main/java/com/fich/sarh/movement - Plant history
src/main/java/com/fich/sarh/planthistory - Points
src/main/java/com/fich/sarh/point - Transformations
src/main/java/com/fich/sarh/transformation
Shared infrastructure
- Relational persistence
src/main/java/com/fich/sarh/position/infrastructure/adapters/output/persistence/entity/PositionEntity.java - Web adapter marker
src/main/java/com/fich/sarh/common/WebAdapter.java
Other components
- API client
Connections 14
- API client → Position API: requests
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
src/main/java/com/fich/sarh/position/infrastructure/adapters/inbound/rest/controller/PositionController.java - API client → Plant API: requests
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
src/main/java/com/fich/sarh/plantofpositions/infrastructure/adapters/inbound/rest/controller/PlantPositionController.java - Authentication → JWT utilities: creates tokens
src/main/java/com/fich/sarh/auth/Application/services/AuthServiceUseCase.java - Authentication → User details: loads user
src/main/java/com/fich/sarh/auth/Application/services/AuthServiceUseCase.java - API client → User administration: requests
src/main/java/com/fich/sarh/auth/Infrastructure/adapter/input/rest/controller/UserController.java - User administration → User use cases: uses ports
src/main/java/com/fich/sarh/auth/Infrastructure/adapter/input/rest/controller/UserController.java - API client → Agent records: requests
src/main/java/com/fich/sarh/agent/infrastructure/adapters/inbound/rest/controller/AgentController.java - API client → Organizational units: requests
src/main/java/com/fich/sarh/organizationalunit/infrastructure/adapters/inbound/rest/controller/OrganizationalUnitController.java - Position model → Relational persistence: maps relationships
src/main/java/com/fich/sarh/position/infrastructure/adapters/output/persistence/entity/PositionEntity.java - Position API → Web adapter marker: uses annotation
src/main/java/com/fich/sarh/position/infrastructure/adapters/inbound/rest/controller/PositionController.java