# diestrah/patitas-arriba architecture

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

- Interactive diagram: https://gitdiagram.com/diestrah/patitas-arriba
- Repository: https://github.com/diestrah/patitas-arriba

## Overview

Patitas Arriba is a veterinary-clinic management system for dogs and cats, with a Blazor frontend and a Java REST backend backed by MySQL. The documented user workflow is to use the frontend to manage clinic operations through the API, which applies business rules and persists data through DAOs and stored procedures. Major capabilities include account access, client and pet records, appointments, clinical care and prescriptions, inventory, and billing. The README documents the overall integration; sampled source confirms selected client-account behavior. Other feature-level links are shown as unverified because their implementations were not sampled.

Main entry points: [`Avances/patitasarriba-negocio/src/main/java/patitasarriba/bl`](https://github.com/diestrah/patitas-arriba/tree/main/Avances/patitasarriba-negocio/src/main/java/patitasarriba/bl) (Business rules), [`Avances/patitasarriba-rest/src/main/java/patitasarriba/rest`](https://github.com/diestrah/patitas-arriba/tree/main/Avances/patitasarriba-rest/src/main/java/patitasarriba/rest) (REST resources), [`Avances-dotnet/PatitasArriba.Web`](https://github.com/diestrah/patitas-arriba/tree/main/Avances-dotnet/PatitasArriba.Web) (Clinic portal), [`Avances-dotnet/PatitasArriba.Web/Servicios/Rest`](https://github.com/diestrah/patitas-arriba/tree/main/Avances-dotnet/PatitasArriba.Web/Servicios/Rest) (REST clients)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Blazor frontend"]
  node_web["Clinic portal<br/>[PatitasArriba.Web]"]
  node_webservices["REST clients<br/>[Rest]"]
end

subgraph group_api["REST API"]
  node_resources["REST resources"]
  node_mappers["DTO mappers"]
end

subgraph group_domain["Clinic operations"]
  node_auth["Access and accounts"]
  node_clients["Clients and pets<br/>[ClienteBLImpl.java]"]
  node_appointments["Appointments"]
  node_care["Clinical care"]
  node_prescriptions["Prescriptions"]
  node_catalog["Services and products"]
  node_billing["Billing"]
  node_scheduling["Staff schedules"]
  node_mail["Email delivery"]
  node_business["Business rules"]
end

subgraph group_storage["Data persistence"]
  node_daos["Stored-procedure DAOs"]
  node_transactions["Transactions"]
  node_dbmanager["JDBC connection<br/>[DBManager.java]"]
  node_mysql[("MySQL database")]
end

node_staff(("Clinic users"))

node_staff -->|"uses"| node_web
node_web -.->|"calls"| node_webservices
node_webservices -->|"requests"| node_resources
node_resources -->|"delegates to"| node_business
node_resources -->|"maps DTOs"| node_mappers
node_business -->|"uses"| node_daos
node_daos -->|"uses"| node_transactions
node_transactions -->|"opens connection"| node_dbmanager
node_dbmanager -->|"connects"| node_mysql
node_business -.->|"includes"| node_clients
node_business -.->|"includes"| node_auth
node_business -.->|"includes"| node_appointments
node_business -.->|"includes"| node_care
node_business -.->|"includes"| node_prescriptions
node_business -.->|"includes"| node_catalog
node_business -.->|"includes"| node_billing
node_business -.->|"includes"| node_scheduling
node_business -.->|"optionally sends"| node_mail

click node_web "https://github.com/diestrah/patitas-arriba/tree/main/Avances-dotnet/PatitasArriba.Web"
click node_webservices "https://github.com/diestrah/patitas-arriba/tree/main/Avances-dotnet/PatitasArriba.Web/Servicios/Rest"
click node_auth "https://github.com/diestrah/patitas-arriba/tree/main/Avances/patitasarriba-negocio/src/main/java/patitasarriba/bl"
click node_clients "https://github.com/diestrah/patitas-arriba/blob/main/Avances/patitasarriba-negocio/src/main/java/patitasarriba/bl/impl/usuario/ClienteBLImpl.java"
click node_appointments "https://github.com/diestrah/patitas-arriba/tree/main/Avances/patitasarriba-negocio/src/main/java/patitasarriba/bl/impl/cita"
click node_care "https://github.com/diestrah/patitas-arriba/tree/main/Avances/patitasarriba-negocio/src/main/java/patitasarriba/bl/impl/atencion"
click node_prescriptions "https://github.com/diestrah/patitas-arriba/tree/main/Avances/patitasarriba-negocio/src/main/java/patitasarriba/bl/impl/receta"
click node_catalog "https://github.com/diestrah/patitas-arriba/tree/main/Avances/patitasarriba-negocio/src/main/java/patitasarriba/bl/impl/producto"
click node_billing "https://github.com/diestrah/patitas-arriba/tree/main/Avances/patitasarriba-negocio/src/main/java/patitasarriba/bl/impl/boleta"
click node_scheduling "https://github.com/diestrah/patitas-arriba/tree/main/Avances/patitasarriba-negocio/src/main/java/patitasarriba/bl/impl/horario"
click node_mail "https://github.com/diestrah/patitas-arriba/tree/main/Avances/patitasarriba-negocio/src/main/java/patitasarriba/bl/correo"
click node_resources "https://github.com/diestrah/patitas-arriba/tree/main/Avances/patitasarriba-rest/src/main/java/patitasarriba/rest"
click node_mappers "https://github.com/diestrah/patitas-arriba/tree/main/Avances/patitasarriba-rest/src/main/java/patitasarriba/rest/mapper"
click node_business "https://github.com/diestrah/patitas-arriba/tree/main/Avances/patitasarriba-negocio/src/main/java/patitasarriba/bl"
click node_daos "https://github.com/diestrah/patitas-arriba/tree/main/Avances/patitasarriba-persistencia/src/main/java/patitasarriba/dao"
click node_transactions "https://github.com/diestrah/patitas-arriba/blob/main/Avances/patitasarriba-persistencia/src/main/java/patitasarriba/dao/transacciones/TransactionsManager.java"
click node_dbmanager "https://github.com/diestrah/patitas-arriba/blob/main/Avances/patitasarriba-dbmanager/src/main/java/conexion/DBManager.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_web,node_webservices,node_staff toneBlue
class node_resources,node_mappers toneAmber
class node_auth,node_clients,node_appointments,node_care,node_prescriptions,node_catalog,node_billing,node_scheduling,node_mail,node_business toneMint
class node_daos,node_transactions,node_dbmanager,node_mysql toneRose
```

## Components

### Blazor frontend

- [Clinic portal](https://github.com/diestrah/patitas-arriba/tree/main/Avances-dotnet/PatitasArriba.Web): `Avances-dotnet/PatitasArriba.Web`
- [REST clients](https://github.com/diestrah/patitas-arriba/tree/main/Avances-dotnet/PatitasArriba.Web/Servicios/Rest): `Avances-dotnet/PatitasArriba.Web/Servicios/Rest`

### REST API

- [REST resources](https://github.com/diestrah/patitas-arriba/tree/main/Avances/patitasarriba-rest/src/main/java/patitasarriba/rest): `Avances/patitasarriba-rest/src/main/java/patitasarriba/rest`
- [DTO mappers](https://github.com/diestrah/patitas-arriba/tree/main/Avances/patitasarriba-rest/src/main/java/patitasarriba/rest/mapper): `Avances/patitasarriba-rest/src/main/java/patitasarriba/rest/mapper`

### Clinic operations

- [Access and accounts](https://github.com/diestrah/patitas-arriba/tree/main/Avances/patitasarriba-negocio/src/main/java/patitasarriba/bl): `Avances/patitasarriba-negocio/src/main/java/patitasarriba/bl`
- [Clients and pets](https://github.com/diestrah/patitas-arriba/blob/main/Avances/patitasarriba-negocio/src/main/java/patitasarriba/bl/impl/usuario/ClienteBLImpl.java): `Avances/patitasarriba-negocio/src/main/java/patitasarriba/bl/impl/usuario/ClienteBLImpl.java`
- [Appointments](https://github.com/diestrah/patitas-arriba/tree/main/Avances/patitasarriba-negocio/src/main/java/patitasarriba/bl/impl/cita): `Avances/patitasarriba-negocio/src/main/java/patitasarriba/bl/impl/cita`
- [Clinical care](https://github.com/diestrah/patitas-arriba/tree/main/Avances/patitasarriba-negocio/src/main/java/patitasarriba/bl/impl/atencion): `Avances/patitasarriba-negocio/src/main/java/patitasarriba/bl/impl/atencion`
- [Prescriptions](https://github.com/diestrah/patitas-arriba/tree/main/Avances/patitasarriba-negocio/src/main/java/patitasarriba/bl/impl/receta): `Avances/patitasarriba-negocio/src/main/java/patitasarriba/bl/impl/receta`
- [Services and products](https://github.com/diestrah/patitas-arriba/tree/main/Avances/patitasarriba-negocio/src/main/java/patitasarriba/bl/impl/producto): `Avances/patitasarriba-negocio/src/main/java/patitasarriba/bl/impl/producto`
- [Billing](https://github.com/diestrah/patitas-arriba/tree/main/Avances/patitasarriba-negocio/src/main/java/patitasarriba/bl/impl/boleta): `Avances/patitasarriba-negocio/src/main/java/patitasarriba/bl/impl/boleta`
- [Staff schedules](https://github.com/diestrah/patitas-arriba/tree/main/Avances/patitasarriba-negocio/src/main/java/patitasarriba/bl/impl/horario): `Avances/patitasarriba-negocio/src/main/java/patitasarriba/bl/impl/horario`
- [Email delivery](https://github.com/diestrah/patitas-arriba/tree/main/Avances/patitasarriba-negocio/src/main/java/patitasarriba/bl/correo): `Avances/patitasarriba-negocio/src/main/java/patitasarriba/bl/correo`
- [Business rules](https://github.com/diestrah/patitas-arriba/tree/main/Avances/patitasarriba-negocio/src/main/java/patitasarriba/bl): `Avances/patitasarriba-negocio/src/main/java/patitasarriba/bl`

### Data persistence

- [Stored-procedure DAOs](https://github.com/diestrah/patitas-arriba/tree/main/Avances/patitasarriba-persistencia/src/main/java/patitasarriba/dao): `Avances/patitasarriba-persistencia/src/main/java/patitasarriba/dao`
- [Transactions](https://github.com/diestrah/patitas-arriba/blob/main/Avances/patitasarriba-persistencia/src/main/java/patitasarriba/dao/transacciones/TransactionsManager.java): `Avances/patitasarriba-persistencia/src/main/java/patitasarriba/dao/transacciones/TransactionsManager.java`
- [JDBC connection](https://github.com/diestrah/patitas-arriba/blob/main/Avances/patitasarriba-dbmanager/src/main/java/conexion/DBManager.java): `Avances/patitasarriba-dbmanager/src/main/java/conexion/DBManager.java`
- **MySQL database**

### Other components

- **Clinic users**

## Connections

- Clinic users → Clinic portal: uses (evidence: `README.md`)
- Clinic portal → REST clients: calls (evidence: `Avances-dotnet/PatitasArriba.Web/Servicios/Rest/AtencionRestService.cs`)
- REST clients → REST resources: requests (evidence: `README.md`)
- REST resources → Business rules: delegates to (evidence: `Avances/patitasarriba-rest/src/main/java/patitasarriba/rest/ClienteResource.java`)
- REST resources → DTO mappers: maps DTOs (evidence: `Avances/patitasarriba-rest/src/main/java/patitasarriba/rest/ClienteResource.java`)
- Business rules → Stored-procedure DAOs: uses (evidence: `Avances/patitasarriba-negocio/src/main/java/patitasarriba/bl/impl/usuario/ClienteBLImpl.java`)
- Stored-procedure DAOs → Transactions: uses (evidence: `Avances/patitasarriba-persistencia/src/main/java/patitasarriba/dao/impl/usuario/ClienteDAOImpl.java`)
- Transactions → JDBC connection: opens connection (evidence: `Avances/patitasarriba-persistencia/src/main/java/patitasarriba/dao/transacciones/TransactionsManager.java`)
- JDBC connection → MySQL database: connects (evidence: `Avances/patitasarriba-dbmanager/src/main/java/conexion/DBManager.java`)
- Business rules → Clients and pets: includes (evidence: `Avances/patitasarriba-negocio/src/main/java/patitasarriba/bl/impl/usuario/ClienteBLImpl.java`)
- Business rules → Access and accounts: includes
- Business rules → Appointments: includes
- Business rules → Clinical care: includes
- Business rules → Prescriptions: includes
- Business rules → Services and products: includes
- Business rules → Billing: includes
- Business rules → Staff schedules: includes
- Business rules → Email delivery: optionally sends (evidence: `README.md`)
