# vaultraider115/project-huellitas-veterinary architecture

> Architecture diagram of the GitHub repository vaultraider115/project-huellitas-veterinary, 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/vaultraider115/project-huellitas-veterinary
- Repository: https://github.com/vaultraider115/project-huellitas-veterinary

## Overview

Project Huellitas is a veterinary-clinic management platform: role-based users manage pets and appointments, veterinarians record medical consultations and prescriptions, and administrators and branch managers oversee operations and audit activity. The web SPA routes users to role-specific menus and communicates with the Spring REST backend; the README also documents an Android client, though its source is absent from the supplied tree. Service-to-repository relationships are shown only where the excerpts or source index support them; other documented capabilities are included without inferred internal call chains.

Main entry points: [`devops-frontend/src/App.tsx`](https://github.com/vaultraider115/project-huellitas-veterinary/blob/main/devops-frontend/src/App.tsx) (Role Menus), [`devops-proyect/src/main/java/com/Proyect_DevOps/users/services/UsuarioService.java`](https://github.com/vaultraider115/project-huellitas-veterinary/blob/main/devops-proyect/src/main/java/com/Proyect_DevOps/users/services/UsuarioService.java) (User Accounts), [`devops-proyect/src/main/java/com/Proyect_DevOps/citas/services/CitaService.java`](https://github.com/vaultraider115/project-huellitas-veterinary/blob/main/devops-proyect/src/main/java/com/Proyect_DevOps/citas/services/CitaService.java) (Appointments), [`devops-proyect/src/main/java/com/Proyect_DevOps/ProyectDevOpsApplication.java`](https://github.com/vaultraider115/project-huellitas-veterinary/blob/main/devops-proyect/src/main/java/com/Proyect_DevOps/ProyectDevOpsApplication.java) (REST API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web Client"]
  node_webapp["Role Menus<br/>[App.tsx]"]
  node_login["Login Screen<br/>[Login.tsx]"]
  node_api_client["API Client<br/>[api.ts]"]
  node_android["Android Client"]
end

subgraph group_security["Identity Security"]
  node_users["User Accounts"]
  node_mfa["MFA<br/>[MFAService.java]"]
  node_turnstile["Bot Verification"]
  node_rate_limit["Attempt Limits"]
end

subgraph group_clinical["Clinical Operations"]
  node_pets["Pet Records<br/>[MascotaModel.java]"]
  node_appointments["Appointments<br/>[CitaService.java]"]
  node_consultations["Medical Records"]
  node_treatments["Treatments"]
end

subgraph group_management["Clinic Administration"]
  node_branches["Branches<br/>[SucursalModel.java]"]
  node_geolocation["Geolocation"]
  node_manager["Manager Tools"]
  node_dashboard["Admin Dashboard"]
  node_audit["Audit Log"]
end

subgraph group_platform["Shared Platform"]
  node_backend["REST API"]
  node_generic_crud["Generic CRUD"]
  node_database[("Relational Store")]
end

node_user(("Clinic User"))
node_cloudflare{{"Cloudflare Turnstile"}}

node_user -->|"uses"| node_webapp
node_webapp -->|"routes to"| node_login
node_webapp -.->|"API access"| node_api_client
node_user -.->|"uses"| node_android
node_webapp -.->|"REST requests"| node_backend
node_android -.->|"REST requests"| node_backend
node_login -.->|"authenticates"| node_users
node_users -->|"verifies factor"| node_mfa
node_login -.->|"submits challenge"| node_turnstile
node_turnstile -.->|"verifies token"| node_cloudflare
node_appointments -->|"reads"| node_pets
node_appointments -->|"looks up owner"| node_users
node_manager -->|"queries"| node_appointments
node_manager -.->|"resolves branch"| node_branches
node_manager -.->|"uses address data"| node_geolocation
node_consultations -->|"loads appointment"| node_appointments
node_consultations -->|"creates"| node_treatments
node_dashboard -.->|"requests admin data"| node_backend
node_backend -.->|"records operations"| node_audit
node_users -.->|"persists accounts"| node_database
node_generic_crud -.->|"CRUD storage"| node_database

click node_webapp "https://github.com/vaultraider115/project-huellitas-veterinary/blob/main/devops-frontend/src/App.tsx"
click node_login "https://github.com/vaultraider115/project-huellitas-veterinary/blob/main/devops-frontend/src/pages/Login.tsx"
click node_api_client "https://github.com/vaultraider115/project-huellitas-veterinary/blob/main/devops-frontend/src/lib/api.ts"
click node_backend "https://github.com/vaultraider115/project-huellitas-veterinary/blob/main/devops-proyect/src/main/java/com/Proyect_DevOps/ProyectDevOpsApplication.java"
click node_users "https://github.com/vaultraider115/project-huellitas-veterinary/blob/main/devops-proyect/src/main/java/com/Proyect_DevOps/users/services/UsuarioService.java"
click node_mfa "https://github.com/vaultraider115/project-huellitas-veterinary/blob/main/devops-proyect/src/main/java/com/Proyect_DevOps/MFA/MFAService.java"
click node_turnstile "https://github.com/vaultraider115/project-huellitas-veterinary/blob/main/devops-proyect/src/main/java/com/Proyect_DevOps/common/security/TurnstileVerifier.java"
click node_rate_limit "https://github.com/vaultraider115/project-huellitas-veterinary/blob/main/devops-proyect/src/main/java/com/Proyect_DevOps/common/security/AttemptLimitService.java"
click node_pets "https://github.com/vaultraider115/project-huellitas-veterinary/blob/main/devops-proyect/src/main/java/com/Proyect_DevOps/mascotas/models/MascotaModel.java"
click node_appointments "https://github.com/vaultraider115/project-huellitas-veterinary/blob/main/devops-proyect/src/main/java/com/Proyect_DevOps/citas/services/CitaService.java"
click node_consultations "https://github.com/vaultraider115/project-huellitas-veterinary/blob/main/devops-proyect/src/main/java/com/Proyect_DevOps/veterinario/services/VeterinarioApiService.java"
click node_treatments "https://github.com/vaultraider115/project-huellitas-veterinary/blob/main/devops-proyect/src/main/java/com/Proyect_DevOps/consultaMedica/models/TratamientoModel.java"
click node_branches "https://github.com/vaultraider115/project-huellitas-veterinary/blob/main/devops-proyect/src/main/java/com/Proyect_DevOps/sucursales/models/SucursalModel.java"
click node_geolocation "https://github.com/vaultraider115/project-huellitas-veterinary/blob/main/devops-proyect/src/main/java/com/Proyect_DevOps/geolocalizacion/controllers/CiudadController.java"
click node_manager "https://github.com/vaultraider115/project-huellitas-veterinary/blob/main/devops-proyect/src/main/java/com/Proyect_DevOps/gestor/services/GestorApiService.java"
click node_dashboard "https://github.com/vaultraider115/project-huellitas-veterinary/blob/main/devops-frontend/src/pages/MenuAdministrador.tsx"
click node_audit "https://github.com/vaultraider115/project-huellitas-veterinary/blob/main/devops-proyect/src/main/java/com/Proyect_DevOps/bitacora/services/BitacoraService.java"
click node_generic_crud "https://github.com/vaultraider115/project-huellitas-veterinary/blob/main/devops-proyect/src/main/java/com/Proyect_DevOps/common/services/GenericServiceImpl.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_webapp,node_login,node_api_client,node_android,node_user toneBlue
class node_users,node_mfa,node_turnstile,node_rate_limit toneAmber
class node_pets,node_appointments,node_consultations,node_treatments toneMint
class node_branches,node_geolocation,node_manager,node_dashboard,node_audit toneRose
class node_backend,node_generic_crud,node_database,node_cloudflare toneIndigo
```

## Components

### Web Client

- [Role Menus](https://github.com/vaultraider115/project-huellitas-veterinary/blob/main/devops-frontend/src/App.tsx): `devops-frontend/src/App.tsx`
- [Login Screen](https://github.com/vaultraider115/project-huellitas-veterinary/blob/main/devops-frontend/src/pages/Login.tsx): `devops-frontend/src/pages/Login.tsx`
- [API Client](https://github.com/vaultraider115/project-huellitas-veterinary/blob/main/devops-frontend/src/lib/api.ts): `devops-frontend/src/lib/api.ts`
- **Android Client**

### Identity Security

- [User Accounts](https://github.com/vaultraider115/project-huellitas-veterinary/blob/main/devops-proyect/src/main/java/com/Proyect_DevOps/users/services/UsuarioService.java): `devops-proyect/src/main/java/com/Proyect_DevOps/users/services/UsuarioService.java`
- [MFA](https://github.com/vaultraider115/project-huellitas-veterinary/blob/main/devops-proyect/src/main/java/com/Proyect_DevOps/MFA/MFAService.java): `devops-proyect/src/main/java/com/Proyect_DevOps/MFA/MFAService.java`
- [Bot Verification](https://github.com/vaultraider115/project-huellitas-veterinary/blob/main/devops-proyect/src/main/java/com/Proyect_DevOps/common/security/TurnstileVerifier.java): `devops-proyect/src/main/java/com/Proyect_DevOps/common/security/TurnstileVerifier.java`
- [Attempt Limits](https://github.com/vaultraider115/project-huellitas-veterinary/blob/main/devops-proyect/src/main/java/com/Proyect_DevOps/common/security/AttemptLimitService.java): `devops-proyect/src/main/java/com/Proyect_DevOps/common/security/AttemptLimitService.java`

### Clinical Operations

- [Pet Records](https://github.com/vaultraider115/project-huellitas-veterinary/blob/main/devops-proyect/src/main/java/com/Proyect_DevOps/mascotas/models/MascotaModel.java): `devops-proyect/src/main/java/com/Proyect_DevOps/mascotas/models/MascotaModel.java`
- [Appointments](https://github.com/vaultraider115/project-huellitas-veterinary/blob/main/devops-proyect/src/main/java/com/Proyect_DevOps/citas/services/CitaService.java): `devops-proyect/src/main/java/com/Proyect_DevOps/citas/services/CitaService.java`
- [Medical Records](https://github.com/vaultraider115/project-huellitas-veterinary/blob/main/devops-proyect/src/main/java/com/Proyect_DevOps/veterinario/services/VeterinarioApiService.java): `devops-proyect/src/main/java/com/Proyect_DevOps/veterinario/services/VeterinarioApiService.java`
- [Treatments](https://github.com/vaultraider115/project-huellitas-veterinary/blob/main/devops-proyect/src/main/java/com/Proyect_DevOps/consultaMedica/models/TratamientoModel.java): `devops-proyect/src/main/java/com/Proyect_DevOps/consultaMedica/models/TratamientoModel.java`

### Clinic Administration

- [Branches](https://github.com/vaultraider115/project-huellitas-veterinary/blob/main/devops-proyect/src/main/java/com/Proyect_DevOps/sucursales/models/SucursalModel.java): `devops-proyect/src/main/java/com/Proyect_DevOps/sucursales/models/SucursalModel.java`
- [Geolocation](https://github.com/vaultraider115/project-huellitas-veterinary/blob/main/devops-proyect/src/main/java/com/Proyect_DevOps/geolocalizacion/controllers/CiudadController.java): `devops-proyect/src/main/java/com/Proyect_DevOps/geolocalizacion/controllers/CiudadController.java`
- [Manager Tools](https://github.com/vaultraider115/project-huellitas-veterinary/blob/main/devops-proyect/src/main/java/com/Proyect_DevOps/gestor/services/GestorApiService.java): `devops-proyect/src/main/java/com/Proyect_DevOps/gestor/services/GestorApiService.java`
- [Admin Dashboard](https://github.com/vaultraider115/project-huellitas-veterinary/blob/main/devops-frontend/src/pages/MenuAdministrador.tsx): `devops-frontend/src/pages/MenuAdministrador.tsx`
- [Audit Log](https://github.com/vaultraider115/project-huellitas-veterinary/blob/main/devops-proyect/src/main/java/com/Proyect_DevOps/bitacora/services/BitacoraService.java): `devops-proyect/src/main/java/com/Proyect_DevOps/bitacora/services/BitacoraService.java`

### Shared Platform

- [REST API](https://github.com/vaultraider115/project-huellitas-veterinary/blob/main/devops-proyect/src/main/java/com/Proyect_DevOps/ProyectDevOpsApplication.java): `devops-proyect/src/main/java/com/Proyect_DevOps/ProyectDevOpsApplication.java`
- [Generic CRUD](https://github.com/vaultraider115/project-huellitas-veterinary/blob/main/devops-proyect/src/main/java/com/Proyect_DevOps/common/services/GenericServiceImpl.java): `devops-proyect/src/main/java/com/Proyect_DevOps/common/services/GenericServiceImpl.java`
- **Relational Store**

### Other components

- **Clinic User**
- **Cloudflare Turnstile**

## Connections

- Clinic User → Role Menus: uses (evidence: `devops-frontend/src/App.tsx`)
- Role Menus → Login Screen: routes to (evidence: `devops-frontend/src/App.tsx`)
- Role Menus → API Client: API access
- Clinic User → Android Client: uses (evidence: `readme.md`)
- Role Menus → REST API: REST requests (evidence: `readme.md`)
- Android Client → REST API: REST requests (evidence: `readme.md`)
- Login Screen → User Accounts: authenticates (evidence: `readme.md`)
- User Accounts → MFA: verifies factor (evidence: `devops-proyect/src/main/java/com/Proyect_DevOps/users/services/UsuarioService.java`)
- Login Screen → Bot Verification: submits challenge (evidence: `readme.md`)
- Bot Verification → Cloudflare Turnstile: verifies token (evidence: `readme.md`)
- Appointments → Pet Records: reads (evidence: `devops-proyect/src/main/java/com/Proyect_DevOps/citas/services/CitaService.java`)
- Appointments → User Accounts: looks up owner (evidence: `devops-proyect/src/main/java/com/Proyect_DevOps/citas/services/CitaService.java`)
- Manager Tools → Appointments: queries (evidence: `devops-proyect/src/main/java/com/Proyect_DevOps/gestor/services/GestorApiService.java`)
- Manager Tools → Branches: resolves branch (evidence: `devops-proyect/src/main/java/com/Proyect_DevOps/gestor/services/GestorApiService.java`)
- Manager Tools → Geolocation: uses address data (evidence: `devops-proyect/src/main/java/com/Proyect_DevOps/gestor/services/GestorApiService.java`)
- Medical Records → Appointments: loads appointment (evidence: `devops-proyect/src/main/java/com/Proyect_DevOps/veterinario/services/VeterinarioApiService.java`)
- Medical Records → Treatments: creates (evidence: `devops-proyect/src/main/java/com/Proyect_DevOps/veterinario/services/VeterinarioApiService.java`)
- Admin Dashboard → REST API: requests admin data (evidence: `readme.md`)
- REST API → Audit Log: records operations (evidence: `readme.md`)
- User Accounts → Relational Store: persists accounts (evidence: `readme.md`)
- Generic CRUD → Relational Store: CRUD storage
