# medina-felipe/sanus-corpus architecture

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

- Interactive diagram: https://gitdiagram.com/medina-felipe/sanus-corpus
- Repository: https://github.com/medina-felipe/sanus-corpus

## Overview

1. This is a Spring Boot backend named `backendpill` for a pharmacy-oriented system (“Sanus-Corpus / Pagina de Farmacia Fruna”). The architecture is organized by business capability rather than by technical layer alone.

2. The top-level domain areas are:
   - `auth` for user identity and access control
   - `catalog` for products, categories, brands, stock, and medicine type
   - `favorites` for user-saved items
   - `legal` for legal documents
   - `support` for support tickets
   - `shared` for cross-cutting concerns

3. Each feature module follows a consistent three-part structure:
   - `infrastructure`: REST controllers, repositories, security integration
   - `application`: services and DTOs
   - `domain`: core entities and domain enums
   This makes the package layout suitable for a layered diagram with clear dependency direction: controllers call services, services use repositories, and domain objects sit at the center.

4. The request path is typical of a REST API:
   client/requester → controller (`infrastructure`) → service (`application`) → repository (`infrastructure`) → persistence store.
   DTOs are used for external API contracts, while domain entities model persisted business state.

5. Authentication is its own subsystem. `AuthController`, `UserController`, `UserService`, and `JwtService` indicate token-based security using JWT. `SecurityConfig` is the boundary where authentication/authorization is enforced before requests reach business controllers.

6. User and role modeling is in `auth.domain` (`User`, `Role`). The presence of login/user request-response DTOs suggests the system issues auth responses and likely supports user registration, login, and user management flows.

7. The catalog subsystem models the pharmacy inventory domain. `Product`, `Category`, `Brand`, `Stock`, and `TypeMedicine` indicate product metadata plus inventory/medicine classification. `ProductService` and `CategoryService` coordinate catalog operations, while product/category repositories persist them.

8. The favorites subsystem is user-centric and likely connects authenticated users to saved products. `FavoriteService`, `FavoriteController`, and `FavoriteRepository` suggest a simple CRUD-style capability that depends on both user identity and catalog references.

9. The legal and support subsystems are separate business modules. `LegalDocument` with `DocumentType` models regulatory/content management, while `SupportTicket` with `SupportCategory` models user support intake and tracking. Both follow the same service/controller/repository pattern.

10. The `shared` package contains cross-cutting infrastructure used by multiple modules:
    - `ApiResponse` for standardized responses
    - custom exceptions (`BusinessException`, `NotFoundException`, `UnauthorizedException`)
    - `GlobalExceptionHandler` for centralized error mapping
    - `DateTimeUtil`, `FileStorageService`, `NotificationService` for reusable utilities/services
    This boundary is important in the diagram because it reduces duplication across feature modules.

11. Persistence is repository-driven, likely through Spring Data JPA/Hibernate given the `Repository` naming and entity-style domain classes. The diagram should show repositories as the data access boundary for each module rather than direct database access from controllers.

12. Configuration is profile-based: `application.properties` plus `application-dev.properties`, `application-prod.properties`, and `application-test.properties`. That indicates environment-specific runtime behavior, especially for database and deployment settings.

13. Tests are set up with a dedicated test application and `TestcontainersConfiguration`, which suggests integration testing against ephemeral infrastructure instead of only mocks. This matters in the architecture because tests validate the real wiring of Spring, persistence, and containerized dependencies.

14. In short, the repository is a modular monolith backend: one Spring Boot application, multiple business subdomains, shared cross-cutting services, JWT-secured REST endpoints, and repository-based persistence. A clear diagram should emphasize module boundaries and the common request/response pipeline through security, controllers, services, and repositories.

Main entry points: [`backendpill/src/main/java/com/backendpill/shared/application/FileStorageService.java`](https://github.com/medina-felipe/sanus-corpus/blob/main/backendpill/src/main/java/com/backendpill/shared/application/FileStorageService.java) (Shared core), [`backendpill/src/main/java/com/backendpill/auth/application/UserService.java`](https://github.com/medina-felipe/sanus-corpus/blob/main/backendpill/src/main/java/com/backendpill/auth/application/UserService.java) (Auth core), [`backendpill/src/main/java/com/backendpill/catalog/application/ProductService.java`](https://github.com/medina-felipe/sanus-corpus/blob/main/backendpill/src/main/java/com/backendpill/catalog/application/ProductService.java) (Catalog core), [`backendpill/src/main/java/com/backendpill/favorites/application/FavoriteService.java`](https://github.com/medina-felipe/sanus-corpus/blob/main/backendpill/src/main/java/com/backendpill/favorites/application/FavoriteService.java) (Favorites core)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Runtime"]
  node_bootstrap(("App boot<br/>spring boot"))
  node_testwiring["Test wiring<br/>integration test"]
end

subgraph group_auth["Auth"]
  node_auth_api["Auth API<br/>rest controllers"]
  node_auth_core["Auth core<br/>auth services<br/>[UserService.java]"]
  node_auth_model[("Auth model<br/>identity domain<br/>[User.java]")]
  node_auth_repo[("Auth repo<br/>user repository")]
  node_auth_security{{"Security"}}
end

subgraph group_catalog["Catalog"]
  node_catalog_api["Catalog API<br/>catalog controllers"]
  node_catalog_core["Catalog core<br/>catalog services"]
  node_catalog_model[("Catalog model<br/>inventory domain<br/>[Product.java]")]
  node_catalog_repo[("Catalog repo")]
end

subgraph group_favorites["Favorites"]
  node_favorites_api["Favorites API<br/>favorites controller"]
  node_favorites_core["Favorites core<br/>favorites service"]
  node_favorites_model[("Favorites model<br/>favorite domain<br/>[Favorite.java]")]
  node_favorites_repo[("Favorites repo<br/>favorite repository")]
end

subgraph group_legal["Legal"]
  node_legal_api["Legal API<br/>legal controller"]
  node_legal_core["Legal core<br/>legal service<br/>[LegalService.java]"]
  node_legal_model[("Legal model<br/>document domain<br/>[LegalDocument.java]")]
  node_legal_repo[("Legal repo")]
end

subgraph group_support["Support"]
  node_support_api["Support API<br/>support controller"]
  node_support_core["Support core<br/>support service"]
  node_support_model[("Support model<br/>ticket domain<br/>[SupportTicket.java]")]
  node_support_repo[("Support repo")]
end

subgraph group_shared["Shared"]
  node_shared_core["Shared core<br/>utilities"]
  node_shared_error{{"Shared errors<br/>error handling"}}
end

node_bootstrap -->|"starts"| node_auth_security
node_auth_security -->|"guards"| node_auth_api
node_auth_api -->|"calls"| node_auth_core
node_auth_core -->|"uses"| node_auth_repo
node_auth_core -->|"maps"| node_auth_model
node_catalog_api -->|"calls"| node_catalog_core
node_catalog_core -->|"uses"| node_catalog_repo
node_catalog_core -->|"maps"| node_catalog_model
node_favorites_api -->|"calls"| node_favorites_core
node_favorites_core -->|"uses"| node_favorites_repo
node_favorites_core -->|"maps"| node_favorites_model
node_legal_api -->|"calls"| node_legal_core
node_legal_core -->|"uses"| node_legal_repo
node_legal_core -->|"maps"| node_legal_model
node_support_api -->|"calls"| node_support_core
node_support_core -->|"uses"| node_support_repo
node_support_core -->|"maps"| node_support_model
node_shared_core -->|"supports"| node_shared_error
node_auth_core -->|"reuses"| node_shared_core
node_catalog_core -->|"reuses"| node_shared_core
node_favorites_core -->|"reuses"| node_shared_core
node_legal_core -->|"reuses"| node_shared_core
node_support_core -->|"reuses"| node_shared_core
node_testwiring -->|"verifies"| node_bootstrap

click node_bootstrap "https://github.com/medina-felipe/sanus-corpus/blob/main/backendpill/src/main/java/com/backendpill/BackendpillApplication.java"
click node_testwiring "https://github.com/medina-felipe/sanus-corpus/blob/main/backendpill/src/test/java/com/backendpill/TestcontainersConfiguration.java"
click node_auth_api "https://github.com/medina-felipe/sanus-corpus/blob/main/backendpill/src/main/java/com/backendpill/auth/infrastructure/AuthController.java"
click node_auth_core "https://github.com/medina-felipe/sanus-corpus/blob/main/backendpill/src/main/java/com/backendpill/auth/application/UserService.java"
click node_auth_model "https://github.com/medina-felipe/sanus-corpus/blob/main/backendpill/src/main/java/com/backendpill/auth/domain/User.java"
click node_auth_repo "https://github.com/medina-felipe/sanus-corpus/blob/main/backendpill/src/main/java/com/backendpill/auth/infrastructure/UserRepository.java"
click node_auth_security "https://github.com/medina-felipe/sanus-corpus/blob/main/backendpill/src/main/java/com/backendpill/auth/infrastructure/SecurityConfig.java"
click node_catalog_api "https://github.com/medina-felipe/sanus-corpus/blob/main/backendpill/src/main/java/com/backendpill/catalog/infrastructure/ProductController.java"
click node_catalog_core "https://github.com/medina-felipe/sanus-corpus/blob/main/backendpill/src/main/java/com/backendpill/catalog/application/ProductService.java"
click node_catalog_model "https://github.com/medina-felipe/sanus-corpus/blob/main/backendpill/src/main/java/com/backendpill/catalog/domain/Product.java"
click node_catalog_repo "https://github.com/medina-felipe/sanus-corpus/blob/main/backendpill/src/main/java/com/backendpill/catalog/infrastructure/ProductRepository.java"
click node_favorites_api "https://github.com/medina-felipe/sanus-corpus/blob/main/backendpill/src/main/java/com/backendpill/favorites/infrastructure/FavoriteController.java"
click node_favorites_core "https://github.com/medina-felipe/sanus-corpus/blob/main/backendpill/src/main/java/com/backendpill/favorites/application/FavoriteService.java"
click node_favorites_model "https://github.com/medina-felipe/sanus-corpus/blob/main/backendpill/src/main/java/com/backendpill/favorites/domain/Favorite.java"
click node_favorites_repo "https://github.com/medina-felipe/sanus-corpus/blob/main/backendpill/src/main/java/com/backendpill/favorites/infrastructure/FavoriteRepository.java"
click node_legal_api "https://github.com/medina-felipe/sanus-corpus/blob/main/backendpill/src/main/java/com/backendpill/legal/infrastructure/LegalController.java"
click node_legal_core "https://github.com/medina-felipe/sanus-corpus/blob/main/backendpill/src/main/java/com/backendpill/legal/application/LegalService.java"
click node_legal_model "https://github.com/medina-felipe/sanus-corpus/blob/main/backendpill/src/main/java/com/backendpill/legal/domain/LegalDocument.java"
click node_legal_repo "https://github.com/medina-felipe/sanus-corpus/blob/main/backendpill/src/main/java/com/backendpill/legal/infrastructure/LegalRepository.java"
click node_support_api "https://github.com/medina-felipe/sanus-corpus/blob/main/backendpill/src/main/java/com/backendpill/support/infrastructure/SupportController.java"
click node_support_core "https://github.com/medina-felipe/sanus-corpus/blob/main/backendpill/src/main/java/com/backendpill/support/application/SupportService.java"
click node_support_model "https://github.com/medina-felipe/sanus-corpus/blob/main/backendpill/src/main/java/com/backendpill/support/domain/SupportTicket.java"
click node_support_repo "https://github.com/medina-felipe/sanus-corpus/blob/main/backendpill/src/main/java/com/backendpill/support/infrastructure/SupportRepository.java"
click node_shared_core "https://github.com/medina-felipe/sanus-corpus/blob/main/backendpill/src/main/java/com/backendpill/shared/application/FileStorageService.java"
click node_shared_error "https://github.com/medina-felipe/sanus-corpus/blob/main/backendpill/src/main/java/com/backendpill/shared/infrastructure/GlobalExceptionHandler.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_bootstrap,node_testwiring,node_shared_core,node_shared_error toneBlue
class node_auth_api,node_auth_core,node_auth_model,node_auth_repo,node_auth_security toneAmber
class node_catalog_api,node_catalog_core,node_catalog_model,node_catalog_repo toneMint
class node_favorites_api,node_favorites_core,node_favorites_model,node_favorites_repo toneRose
class node_legal_api,node_legal_core,node_legal_model,node_legal_repo toneIndigo
class node_support_api,node_support_core,node_support_model,node_support_repo toneTeal
```

## Components

### Runtime

Spring Boot bootstrap and test wiring

- [App boot](https://github.com/medina-felipe/sanus-corpus/blob/main/backendpill/src/main/java/com/backendpill/BackendpillApplication.java): spring boot · Main application entry point · `backendpill/src/main/java/com/backendpill/BackendpillApplication.java`
- [Test wiring](https://github.com/medina-felipe/sanus-corpus/blob/main/backendpill/src/test/java/com/backendpill/TestcontainersConfiguration.java): integration test · Test application and container setup · `backendpill/src/test/java/com/backendpill/TestcontainersConfiguration.java`

### Auth

Identity, JWT, and access control

- [Auth API](https://github.com/medina-felipe/sanus-corpus/blob/main/backendpill/src/main/java/com/backendpill/auth/infrastructure/AuthController.java): rest controllers · Login, user, and security-facing endpoints · `backendpill/src/main/java/com/backendpill/auth/infrastructure/AuthController.java`
- [Auth core](https://github.com/medina-felipe/sanus-corpus/blob/main/backendpill/src/main/java/com/backendpill/auth/application/UserService.java): auth services · JWT issuing and user operations · `backendpill/src/main/java/com/backendpill/auth/application/UserService.java`
- [Auth model](https://github.com/medina-felipe/sanus-corpus/blob/main/backendpill/src/main/java/com/backendpill/auth/domain/User.java): identity domain · Users and roles · `backendpill/src/main/java/com/backendpill/auth/domain/User.java`
- [Auth repo](https://github.com/medina-felipe/sanus-corpus/blob/main/backendpill/src/main/java/com/backendpill/auth/infrastructure/UserRepository.java): user repository · Persistence boundary for users · `backendpill/src/main/java/com/backendpill/auth/infrastructure/UserRepository.java`
- [Security](https://github.com/medina-felipe/sanus-corpus/blob/main/backendpill/src/main/java/com/backendpill/auth/infrastructure/SecurityConfig.java): security config · JWT and request protection boundary · `backendpill/src/main/java/com/backendpill/auth/infrastructure/SecurityConfig.java`

### Catalog

Products, categories, brands, and stock

- [Catalog API](https://github.com/medina-felipe/sanus-corpus/blob/main/backendpill/src/main/java/com/backendpill/catalog/infrastructure/ProductController.java): catalog controllers · Product and category endpoints · `backendpill/src/main/java/com/backendpill/catalog/infrastructure/ProductController.java`
- [Catalog core](https://github.com/medina-felipe/sanus-corpus/blob/main/backendpill/src/main/java/com/backendpill/catalog/application/ProductService.java): catalog services · Product and category orchestration · `backendpill/src/main/java/com/backendpill/catalog/application/ProductService.java`
- [Catalog model](https://github.com/medina-felipe/sanus-corpus/blob/main/backendpill/src/main/java/com/backendpill/catalog/domain/Product.java): inventory domain · Products, brands, stock, and medicine types · `backendpill/src/main/java/com/backendpill/catalog/domain/Product.java`
- [Catalog repo](https://github.com/medina-felipe/sanus-corpus/blob/main/backendpill/src/main/java/com/backendpill/catalog/infrastructure/ProductRepository.java): catalog repositories · Persistence boundary for catalog data · `backendpill/src/main/java/com/backendpill/catalog/infrastructure/ProductRepository.java`

### Favorites

User-saved catalog items

- [Favorites API](https://github.com/medina-felipe/sanus-corpus/blob/main/backendpill/src/main/java/com/backendpill/favorites/infrastructure/FavoriteController.java): favorites controller · Saved-item endpoints · `backendpill/src/main/java/com/backendpill/favorites/infrastructure/FavoriteController.java`
- [Favorites core](https://github.com/medina-felipe/sanus-corpus/blob/main/backendpill/src/main/java/com/backendpill/favorites/application/FavoriteService.java): favorites service · User-to-product favorites logic · `backendpill/src/main/java/com/backendpill/favorites/application/FavoriteService.java`
- [Favorites model](https://github.com/medina-felipe/sanus-corpus/blob/main/backendpill/src/main/java/com/backendpill/favorites/domain/Favorite.java): favorite domain · Favorite association state · `backendpill/src/main/java/com/backendpill/favorites/domain/Favorite.java`
- [Favorites repo](https://github.com/medina-felipe/sanus-corpus/blob/main/backendpill/src/main/java/com/backendpill/favorites/infrastructure/FavoriteRepository.java): favorite repository · Persistence boundary for favorites · `backendpill/src/main/java/com/backendpill/favorites/infrastructure/FavoriteRepository.java`

### Legal

Regulatory documents

- [Legal API](https://github.com/medina-felipe/sanus-corpus/blob/main/backendpill/src/main/java/com/backendpill/legal/infrastructure/LegalController.java): legal controller · Document endpoints · `backendpill/src/main/java/com/backendpill/legal/infrastructure/LegalController.java`
- [Legal core](https://github.com/medina-felipe/sanus-corpus/blob/main/backendpill/src/main/java/com/backendpill/legal/application/LegalService.java): legal service · Legal document operations · `backendpill/src/main/java/com/backendpill/legal/application/LegalService.java`
- [Legal model](https://github.com/medina-felipe/sanus-corpus/blob/main/backendpill/src/main/java/com/backendpill/legal/domain/LegalDocument.java): document domain · Legal documents and types · `backendpill/src/main/java/com/backendpill/legal/domain/LegalDocument.java`
- [Legal repo](https://github.com/medina-felipe/sanus-corpus/blob/main/backendpill/src/main/java/com/backendpill/legal/infrastructure/LegalRepository.java): legal repository · Persistence boundary for legal content · `backendpill/src/main/java/com/backendpill/legal/infrastructure/LegalRepository.java`

### Support

Support tickets and intake

- [Support API](https://github.com/medina-felipe/sanus-corpus/blob/main/backendpill/src/main/java/com/backendpill/support/infrastructure/SupportController.java): support controller · Ticket intake endpoints · `backendpill/src/main/java/com/backendpill/support/infrastructure/SupportController.java`
- [Support core](https://github.com/medina-felipe/sanus-corpus/blob/main/backendpill/src/main/java/com/backendpill/support/application/SupportService.java): support service · Ticket workflow and categorization · `backendpill/src/main/java/com/backendpill/support/application/SupportService.java`
- [Support model](https://github.com/medina-felipe/sanus-corpus/blob/main/backendpill/src/main/java/com/backendpill/support/domain/SupportTicket.java): ticket domain · Support tickets and categories · `backendpill/src/main/java/com/backendpill/support/domain/SupportTicket.java`
- [Support repo](https://github.com/medina-felipe/sanus-corpus/blob/main/backendpill/src/main/java/com/backendpill/support/infrastructure/SupportRepository.java): support repository · Persistence boundary for support tickets · `backendpill/src/main/java/com/backendpill/support/infrastructure/SupportRepository.java`

### Shared

Cross-cutting responses, errors, and utilities

- [Shared core](https://github.com/medina-felipe/sanus-corpus/blob/main/backendpill/src/main/java/com/backendpill/shared/application/FileStorageService.java): utilities · Reusable services such as date, file, and notification helpers · `backendpill/src/main/java/com/backendpill/shared/application/FileStorageService.java`
- [Shared errors](https://github.com/medina-felipe/sanus-corpus/blob/main/backendpill/src/main/java/com/backendpill/shared/infrastructure/GlobalExceptionHandler.java): error handling · Standard API response and centralized exception mapping · `backendpill/src/main/java/com/backendpill/shared/infrastructure/GlobalExceptionHandler.java`

## Connections

- App boot → Security: starts · Bootstraps security and module wiring
- Security → Auth API: guards · Enforces authentication and authorization before controllers
- Auth API → Auth core: calls · Controller delegates to auth service layer
- Auth core → Auth repo: uses · Service persists and loads user data through repository
- Auth core → Auth model: maps · Service operates on user and role domain objects
- Catalog API → Catalog core: calls · Catalog requests flow into application services
- Catalog core → Catalog repo: uses · Service uses repositories for catalog persistence
- Catalog core → Catalog model: maps · Catalog logic centers on product and inventory entities
- Favorites API → Favorites core: calls · Favorites endpoints delegate to service logic
- Favorites core → Favorites repo: uses · Favorites service persists saved items
- Favorites core → Favorites model: maps · Favorites logic revolves around favorite associations
- Legal API → Legal core: calls · Legal endpoints delegate to service logic
- Legal core → Legal repo: uses · Service persists legal documents
- Legal core → Legal model: maps · Legal service works with document entities and types
- Support API → Support core: calls · Support endpoints delegate to ticket services
- Support core → Support repo: uses · Support service persists tickets
- Support core → Support model: maps · Support service centers on ticket and category domain objects
- Shared core → Shared errors: supports · Shared utilities feed standardized responses and exception handling
- Auth core → Shared core: reuses · Auth uses shared reusable services
- Catalog core → Shared core: reuses · Catalog uses shared reusable services
- Favorites core → Shared core: reuses · Favorites uses shared reusable services
- Legal core → Shared core: reuses · Legal uses shared reusable services
- Support core → Shared core: reuses · Support uses shared reusable services
- Test wiring → App boot: verifies · Integration tests validate the Spring wiring and runtime setup
