# veronicapardo/tiendayachamben architecture

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

- Interactive diagram: https://gitdiagram.com/veronicapardo/tiendayachamben
- Repository: https://github.com/veronicapardo/tiendayachamben

## Overview

1. This repository is a multi-stack TiendaYA system, not a single application. The meaningful top-level parts are a React/Vite frontend, a TypeScript/Node backend with Prisma, a Spring Boot backend, and a small .NET Web API scaffold. The Node and Spring backends model the same business domain but are separate implementations.

2. The shared business domain is retail/order management. The core entities repeated across backends are Cliente, Usuario, Producto, Pedido, PedidoDetalle, Pago, Venta, and Repartidor, plus enums for states, payment methods, and user roles. These are the main boxes for any architecture diagram.

3. The frontend lives under `frontend/` and is a Vite + React + TypeScript SPA. Its visible screens are authentication/entry flow pages (`LoginPage`, `RoleSelectionPage`) and a cashier dashboard (`cajero/DashboardCajeroPage`). `src/services/api.ts` is the main boundary to the backend, so the UI does not talk directly to persistence.

4. The frontend is organized as presentation plus API client plus page-level features. Styling is split into global and feature CSS files, which suggests the app is small but UI-oriented. From the file names, role-based navigation is important: login leads to role selection, then to the cashier dashboard.

5. The Spring Boot backend under `backend-spring/TiendaYA/` is the most feature-complete server. Its flow is controller → service interface/implementation → repository → model/entity, with DTOs used at the API boundary. This backend includes `AuthController`, `CajeroDashboardController`, and `CorsConfig`, so it is the one that clearly supports login, dashboard data, and browser access.

6. The Spring backend’s package structure is classic layered Java architecture. `controllers` expose HTTP endpoints, `services` contain business logic, `repositories` handle data access, `models` define the domain objects, and `dtos` separate request/response shapes from persistence objects. `application.properties` and Maven (`pom.xml`, wrapper) indicate standard Spring Boot runtime and configuration.

7. The TypeScript backend under `backend/` is a parallel API built with Express-style routing and Prisma. Its flow is routes → controllers → services → Prisma client. `src/lib/prisma.ts` centralizes database access, and `src/generated/prisma` shows that the ORM client is generated from the Prisma schema.

8. The Node backend mirrors the same domain modules as the Spring backend: one controller/service/route trio per aggregate such as cliente, pedido, producto, pago, repartidor, usuario, and venta. That makes it easy to map the same conceptual diagram to either backend implementation. There is no separate auth/dashboard module here, so it appears less complete than the Spring stack.

9. Persistence in the Node stack is defined by `prisma/schema.prisma` plus migration SQL under `prisma/migrations/`. That means the database schema is versioned and the application depends on Prisma-generated types and client code rather than handwritten SQL. If you draw the data layer, show Prisma as the ORM sitting between services and the database.

10. Data transfer is strongly typed in both backends. Each domain has create/update DTOs, response DTOs, and small message DTOs. This means the API boundary is intentionally different from the database model boundary, especially for nested objects like PedidoDetalle and dashboard payloads.

11. Security and access control are most visible in the Spring backend and frontend. `RolUsuario` exists in the domain model, the frontend has role selection, and Spring includes login request/response DTOs plus auth service/controller. That suggests role-based routing and API authorization are part of the intended runtime architecture.

12. Infrastructure is lightweight but present. The repo includes `docker-compose.yml`, a Dockerfile in the Node backend, npm lockfiles, Maven wrappers, and test scaffolding. For deployment diagrams, the important containers are the SPA frontend, the backend API container(s), and the relational database implied by Prisma/JPA repositories.

13. The root-level `.NET` files (`TiendaYA.csproj`, `Program.cs`, `Controllers/WeatherForecastController.cs`) look like the default ASP.NET starter project and do not appear to be the main business system. They should usually be treated as a separate sample or leftover scaffold unless the team confirms it is in use.

14. If you need a single architecture picture, the cleanest interpretation is: browser UI on the left, an HTTP API layer in the middle, domain services and repositories beneath it, and a relational database at the bottom. The Spring backend is the best candidate for the production-grade API; the Node backend is a second implementation of the same CRUD domain; the .NET app is incidental.

Main entry points: [`frontend/src/services/api.ts`](https://github.com/veronicapardo/tiendayachamben/blob/main/frontend/src/services/api.ts) (API client), [`backend-spring/TiendaYA/src/main/java/com/tiendaya/models/Pedido.java`](https://github.com/veronicapardo/tiendayachamben/blob/main/backend-spring/TiendaYA/src/main/java/com/tiendaya/models/Pedido.java) (Domain set), [`backend-spring/TiendaYA/src/main/java/com/tiendaya/TiendaYaApplication.java`](https://github.com/veronicapardo/tiendayachamben/blob/main/backend-spring/TiendaYA/src/main/java/com/tiendaya/TiendaYaApplication.java) (Spring boot), [`backend/src/services/cliente.service.ts`](https://github.com/veronicapardo/tiendayachamben/blob/main/backend/src/services/cliente.service.ts) (Services)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Frontend SPA"]
  node_frontend_app["React app<br/>Vite SPA<br/>[main.tsx]"]
  node_frontend_login["Login<br/>page<br/>[LoginPage.tsx]"]
  node_frontend_roles["Role select<br/>page"]
  node_frontend_dashboard["Cajero dashboard<br/>page"]
  node_frontend_api["API client<br/>HTTP client<br/>[api.ts]"]
end

subgraph group_node_backend["Node API"]
  node_node_entry["Node entry<br/>Express app<br/>[index.ts]"]
  node_node_routes["Routes<br/>[cliente.routes.ts]"]
  node_node_controllers["Controllers"]
  node_node_services["Services<br/>[cliente.service.ts]"]
  node_node_prisma[("Prisma client<br/>ORM access<br/>[prisma.ts]")]
  node_node_schema["Schema<br/>[schema.prisma]"]
end

subgraph group_spring_backend["Spring API"]
  node_spring_boot["Spring boot<br/>Spring app"]
  node_spring_auth["Auth"]
  node_spring_dashboard["Dashboard"]
  node_spring_controllers["Controllers"]
  node_spring_services["Services"]
  node_spring_repos[("Repositories<br/>data access")]
  node_spring_models["Models<br/>domain entities<br/>[Cliente.java]"]
  node_spring_dtos["DTOs<br/>api contracts"]
end

subgraph group_dotnet_scaffold[".NET Scaffold"]
  node_dotnet_api["ASP.NET app<br/>starter API<br/>[Program.cs]"]
end

subgraph group_shared_domain["Retail Domain"]
  node_domain_entities{{"Domain set<br/>retail domain<br/>[Pedido.java]"}}
end

node_frontend_app -->|"starts at"| node_frontend_login
node_frontend_login -->|"selects role"| node_frontend_roles
node_frontend_roles -->|"opens dashboard"| node_frontend_dashboard
node_frontend_app -->|"calls"| node_frontend_api
node_frontend_api -->|"auth requests"| node_spring_auth
node_frontend_api -->|"dashboard data"| node_spring_dashboard
node_frontend_api -.->|"api calls"| node_node_entry
node_node_entry -->|"mounts"| node_node_routes
node_node_routes -->|"dispatches"| node_node_controllers
node_node_controllers -->|"delegates"| node_node_services
node_node_services -->|"persists via"| node_node_prisma
node_node_prisma -->|"generated from"| node_node_schema
node_node_services -->|"operates on"| node_domain_entities
node_spring_boot -->|"exposes"| node_spring_auth
node_spring_boot -->|"exposes"| node_spring_dashboard
node_spring_boot -->|"exposes"| node_spring_controllers
node_spring_controllers -->|"delegates"| node_spring_services
node_spring_services -->|"queries"| node_spring_repos
node_spring_services -->|"maps"| node_spring_dtos
node_spring_repos -->|"stores"| node_spring_models
node_spring_dtos -->|"transforms"| node_spring_models
node_spring_models -->|"implements"| node_domain_entities
node_node_schema -->|"models"| node_domain_entities
node_dotnet_api -.->|"unrelated sample"| node_domain_entities

click node_frontend_app "https://github.com/veronicapardo/tiendayachamben/blob/main/frontend/src/main.tsx"
click node_frontend_login "https://github.com/veronicapardo/tiendayachamben/blob/main/frontend/src/pages/LoginPage.tsx"
click node_frontend_roles "https://github.com/veronicapardo/tiendayachamben/blob/main/frontend/src/pages/RoleSelectionPage.tsx"
click node_frontend_dashboard "https://github.com/veronicapardo/tiendayachamben/blob/main/frontend/src/pages/cajero/DashboardCajeroPage.tsx"
click node_frontend_api "https://github.com/veronicapardo/tiendayachamben/blob/main/frontend/src/services/api.ts"
click node_node_entry "https://github.com/veronicapardo/tiendayachamben/blob/main/backend/src/index.ts"
click node_node_routes "https://github.com/veronicapardo/tiendayachamben/blob/main/backend/src/routes/cliente.routes.ts"
click node_node_controllers "https://github.com/veronicapardo/tiendayachamben/blob/main/backend/src/controllers/cliente.controller.ts"
click node_node_services "https://github.com/veronicapardo/tiendayachamben/blob/main/backend/src/services/cliente.service.ts"
click node_node_prisma "https://github.com/veronicapardo/tiendayachamben/blob/main/backend/src/lib/prisma.ts"
click node_node_schema "https://github.com/veronicapardo/tiendayachamben/blob/main/backend/prisma/schema.prisma"
click node_spring_boot "https://github.com/veronicapardo/tiendayachamben/blob/main/backend-spring/TiendaYA/src/main/java/com/tiendaya/TiendaYaApplication.java"
click node_spring_auth "https://github.com/veronicapardo/tiendayachamben/blob/main/backend-spring/TiendaYA/src/main/java/com/tiendaya/controllers/AuthController.java"
click node_spring_dashboard "https://github.com/veronicapardo/tiendayachamben/blob/main/backend-spring/TiendaYA/src/main/java/com/tiendaya/controllers/CajeroDashboardController.java"
click node_spring_controllers "https://github.com/veronicapardo/tiendayachamben/blob/main/backend-spring/TiendaYA/src/main/java/com/tiendaya/controllers/ClienteController.java"
click node_spring_services "https://github.com/veronicapardo/tiendayachamben/blob/main/backend-spring/TiendaYA/src/main/java/com/tiendaya/services/ClienteService.java"
click node_spring_repos "https://github.com/veronicapardo/tiendayachamben/blob/main/backend-spring/TiendaYA/src/main/java/com/tiendaya/repositories/ClienteRepository.java"
click node_spring_models "https://github.com/veronicapardo/tiendayachamben/blob/main/backend-spring/TiendaYA/src/main/java/com/tiendaya/models/Cliente.java"
click node_spring_dtos "https://github.com/veronicapardo/tiendayachamben/blob/main/backend-spring/TiendaYA/src/main/java/com/tiendaya/dtos/CreateClienteDto.java"
click node_dotnet_api "https://github.com/veronicapardo/tiendayachamben/blob/main/Program.cs"
click node_domain_entities "https://github.com/veronicapardo/tiendayachamben/blob/main/backend-spring/TiendaYA/src/main/java/com/tiendaya/models/Pedido.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_frontend_app,node_frontend_login,node_frontend_roles,node_frontend_dashboard,node_frontend_api toneBlue
class node_node_entry,node_node_routes,node_node_controllers,node_node_services,node_node_prisma,node_node_schema toneAmber
class node_spring_boot,node_spring_auth,node_spring_dashboard,node_spring_controllers,node_spring_services,node_spring_repos,node_spring_models,node_spring_dtos toneMint
class node_dotnet_api toneRose
class node_domain_entities toneIndigo
```

## Components

### Frontend SPA

Vite + React client

- [React app](https://github.com/veronicapardo/tiendayachamben/blob/main/frontend/src/main.tsx): Vite SPA · Browser client entry and app shell · `frontend/src/main.tsx`
- [Login](https://github.com/veronicapardo/tiendayachamben/blob/main/frontend/src/pages/LoginPage.tsx): page · Authentication entry page · `frontend/src/pages/LoginPage.tsx`
- [Role select](https://github.com/veronicapardo/tiendayachamben/blob/main/frontend/src/pages/RoleSelectionPage.tsx): page · Role-based navigation gate · `frontend/src/pages/RoleSelectionPage.tsx`
- [Cajero dashboard](https://github.com/veronicapardo/tiendayachamben/blob/main/frontend/src/pages/cajero/DashboardCajeroPage.tsx): page · Cashier-facing dashboard screen · `frontend/src/pages/cajero/DashboardCajeroPage.tsx`
- [API client](https://github.com/veronicapardo/tiendayachamben/blob/main/frontend/src/services/api.ts): HTTP client · Frontend boundary to backend services · `frontend/src/services/api.ts`

### Node API

TypeScript/Express + Prisma backend

- [Node entry](https://github.com/veronicapardo/tiendayachamben/blob/main/backend/src/index.ts): Express app · Runtime bootstrap and server startup · `backend/src/index.ts`
- [Routes](https://github.com/veronicapardo/tiendayachamben/blob/main/backend/src/routes/cliente.routes.ts): HTTP routes · Request routing layer · `backend/src/routes/cliente.routes.ts`
- [Controllers](https://github.com/veronicapardo/tiendayachamben/blob/main/backend/src/controllers/cliente.controller.ts): controllers · HTTP handlers for CRUD resources · `backend/src/controllers/cliente.controller.ts`
- [Services](https://github.com/veronicapardo/tiendayachamben/blob/main/backend/src/services/cliente.service.ts): business services · Domain logic and orchestration · `backend/src/services/cliente.service.ts`
- [Prisma client](https://github.com/veronicapardo/tiendayachamben/blob/main/backend/src/lib/prisma.ts): ORM access · Central database access layer · `backend/src/lib/prisma.ts`
- [Schema](https://github.com/veronicapardo/tiendayachamben/blob/main/backend/prisma/schema.prisma): Prisma schema · Versioned persistence model · `backend/prisma/schema.prisma`

### Spring API

Spring Boot backend

- [Spring boot](https://github.com/veronicapardo/tiendayachamben/blob/main/backend-spring/TiendaYA/src/main/java/com/tiendaya/TiendaYaApplication.java): Spring app · Application bootstrap · `backend-spring/TiendaYA/src/main/java/com/tiendaya/TiendaYaApplication.java`
- [Auth](https://github.com/veronicapardo/tiendayachamben/blob/main/backend-spring/TiendaYA/src/main/java/com/tiendaya/controllers/AuthController.java): auth API · Login and role-aware access · `backend-spring/TiendaYA/src/main/java/com/tiendaya/controllers/AuthController.java`
- [Dashboard](https://github.com/veronicapardo/tiendayachamben/blob/main/backend-spring/TiendaYA/src/main/java/com/tiendaya/controllers/CajeroDashboardController.java): dashboard API · Cashier dashboard endpoint · `backend-spring/TiendaYA/src/main/java/com/tiendaya/controllers/CajeroDashboardController.java`
- [Controllers](https://github.com/veronicapardo/tiendayachamben/blob/main/backend-spring/TiendaYA/src/main/java/com/tiendaya/controllers/ClienteController.java): HTTP controllers · CRUD and feature endpoints · `backend-spring/TiendaYA/src/main/java/com/tiendaya/controllers/ClienteController.java`
- [Services](https://github.com/veronicapardo/tiendayachamben/blob/main/backend-spring/TiendaYA/src/main/java/com/tiendaya/services/ClienteService.java): business services · Business logic layer · `backend-spring/TiendaYA/src/main/java/com/tiendaya/services/ClienteService.java`
- [Repositories](https://github.com/veronicapardo/tiendayachamben/blob/main/backend-spring/TiendaYA/src/main/java/com/tiendaya/repositories/ClienteRepository.java): data access · Persistence repositories · `backend-spring/TiendaYA/src/main/java/com/tiendaya/repositories/ClienteRepository.java`
- [Models](https://github.com/veronicapardo/tiendayachamben/blob/main/backend-spring/TiendaYA/src/main/java/com/tiendaya/models/Cliente.java): domain entities · Shared retail/order entities · `backend-spring/TiendaYA/src/main/java/com/tiendaya/models/Cliente.java`
- [DTOs](https://github.com/veronicapardo/tiendayachamben/blob/main/backend-spring/TiendaYA/src/main/java/com/tiendaya/dtos/CreateClienteDto.java): api contracts · Request, response, and dashboard shapes · `backend-spring/TiendaYA/src/main/java/com/tiendaya/dtos/CreateClienteDto.java`

### .NET Scaffold

Incidental ASP.NET starter app

- [ASP.NET app](https://github.com/veronicapardo/tiendayachamben/blob/main/Program.cs): starter API · Default scaffold, likely incidental · `Program.cs`

### Retail Domain

Business entities shared across backends

- [Domain set](https://github.com/veronicapardo/tiendayachamben/blob/main/backend-spring/TiendaYA/src/main/java/com/tiendaya/models/Pedido.java): retail domain · Cliente, Usuario, Producto, Pedido, PedidoDetalle, Pago, Venta, Repartidor and state enums · `backend-spring/TiendaYA/src/main/java/com/tiendaya/models/Pedido.java`

## Connections

- React app → Login: starts at · Initial screen flow
- Login → Role select: selects role · Login leads into role selection
- Role select → Cajero dashboard: opens dashboard · Cashier role reaches dashboard
- React app → API client: calls · UI uses a service boundary for backend access
- API client → Auth: auth requests · Primary backend integration for login
- API client → Dashboard: dashboard data · Fetches cashier summary payloads
- API client → Node entry: api calls · Alternative backend implementation for the same domain
- Node entry → Routes: mounts · Server bootstraps routing
- Routes → Controllers: dispatches · Routes hand off to controllers
- Controllers → Services: delegates · Controllers forward business work to services
- Services → Prisma client: persists via · Services use shared Prisma access
- Prisma client → Schema: generated from · Client and types come from the schema
- Services → Domain set: operates on · CRUD modules mirror the shared retail aggregates
- Spring boot → Auth: exposes · Application exposes auth endpoints
- Spring boot → Dashboard: exposes · Application exposes dashboard endpoints
- Spring boot → Controllers: exposes · Bootstraps CRUD controllers
- Controllers → Services: delegates · HTTP layer calls service layer
- Services → Repositories: queries · Services persist through repositories
- Services → DTOs: maps · Services work with API contracts and payloads
- Repositories → Models: stores · Repositories manage domain entities
- DTOs → Models: transforms · DTOs separate API shapes from persistence models
- Models → Domain set: implements · Java entity layer realizes the shared domain
- Schema → Domain set: models · Prisma schema captures the same retail domain
- ASP.NET app → Domain set: unrelated sample · Starter scaffold is not part of the main business system
