# luisalazo/elbatanproyecto architecture

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

- Interactive diagram: https://gitdiagram.com/luisalazo/elbatanproyecto
- Repository: https://github.com/luisalazo/elbatanproyecto

## Overview

El Batan is a product-catalog, shopping-cart, order-management, and sales-reporting application with an Angular frontend and Spring backend. Users browse products, add them to a locally persisted cart, and submit orders; administrators manage products and review reports, including order-state updates. The graph includes the documented API and reporting capabilities. Several backend services and frontend views are not sampled, so their internal connections are omitted rather than inferred.

Main entry points: [`elBatan_frontend/src/app/app.routes.ts`](https://github.com/luisalazo/elbatanproyecto/blob/master/elBatan_frontend/src/app/app.routes.ts) (Page routing), [`elBatan/src/main/java/pe/edu/upeu/elBatan/controller/ReporteController.java`](https://github.com/luisalazo/elbatanproyecto/blob/master/elBatan/src/main/java/pe/edu/upeu/elBatan/controller/ReporteController.java) (Report endpoints), [`elBatan_frontend/src/app/features/reportes/reportes.component.ts`](https://github.com/luisalazo/elbatanproyecto/blob/master/elBatan_frontend/src/app/features/reportes/reportes.component.ts) (Reports console), [`elBatan_frontend/src/app/features/home/home.component.ts`](https://github.com/luisalazo/elbatanproyecto/blob/master/elBatan_frontend/src/app/features/home/home.component.ts) (Home browsing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Angular storefront"]
  node_routes["Page routing<br/>[app.routes.ts]"]
  node_catalog_ui["Catalog &amp; product form"]
  node_home_ui["Home browsing<br/>[home.component.ts]"]
  node_cart_ui["Cart &amp; checkout"]
  node_reports_ui["Reports console"]
  node_cart_service["Cart state<br/>[cart.service.ts]"]
  node_product_client["Product API client"]
  node_order_client["Order API client<br/>[pedido.service.ts]"]
  node_report_client["Report API client<br/>[reporte.service.ts]"]
  node_alerts["User alerts<br/>[alert.service.ts]"]
end

subgraph group_api["Spring API"]
  node_product_api["Product endpoints"]
  node_order_api["Order endpoints"]
  node_auth_api["Authentication endpoints"]
end

subgraph group_domain["Commerce services"]
  node_file_store["Image storage"]
  node_products["Product service"]
  node_orders["Order service"]
  node_users["User service"]
end

subgraph group_insights["Reporting"]
  node_report_api["Report endpoints"]
  node_sales_report["Sales report service"]
  node_sales_repository["Sales report queries"]
  node_summary_service["Date-range summary"]
  node_participation_service["Product participation"]
  node_user_report_service["User report service"]
end

node_shopper(("Shopper / admin"))
node_database[("Application database")]

node_shopper -->|"uses"| node_routes
node_routes -->|"routes to"| node_home_ui
node_routes -->|"routes to"| node_catalog_ui
node_routes -->|"routes to"| node_cart_ui
node_routes -->|"routes to"| node_reports_ui
node_home_ui -->|"loads products"| node_product_client
node_home_ui -->|"adds products"| node_cart_service
node_catalog_ui -->|"manages products"| node_product_client
node_cart_ui -->|"uses cart"| node_cart_service
node_cart_ui -->|"submits orders"| node_order_client
node_cart_service -->|"shows toasts"| node_alerts
node_reports_ui -->|"loads reports"| node_report_client
node_reports_ui -->|"updates status"| node_order_client
node_reports_ui -->|"shows outcomes"| node_alerts
node_product_client -->|"HTTP requests"| node_product_api
node_order_client -.->|"HTTP requests"| node_order_api
node_report_client -.->|"HTTP requests"| node_report_api
node_product_api -->|"delegates"| node_products
node_product_api -->|"stores uploads"| node_file_store
node_order_api -->|"delegates"| node_orders
node_auth_api -->|"delegates"| node_users
node_report_api -->|"requests sales"| node_sales_report
node_report_api -->|"requests summary"| node_summary_service
node_report_api -->|"requests participation"| node_participation_service
node_report_api -->|"requests users"| node_user_report_service
node_sales_report -->|"queries"| node_sales_repository
node_sales_repository -.->|"reads"| node_database
node_products -.->|"persists products"| node_database
node_orders -.->|"persists orders"| node_database

click node_routes "https://github.com/luisalazo/elbatanproyecto/blob/master/elBatan_frontend/src/app/app.routes.ts"
click node_catalog_ui "https://github.com/luisalazo/elbatanproyecto/blob/master/elBatan_frontend/src/app/features/products/product-form/product-form.component.ts"
click node_home_ui "https://github.com/luisalazo/elbatanproyecto/blob/master/elBatan_frontend/src/app/features/home/home.component.ts"
click node_cart_ui "https://github.com/luisalazo/elbatanproyecto/blob/master/elBatan_frontend/src/app/features/carrito/carrito.component.ts"
click node_reports_ui "https://github.com/luisalazo/elbatanproyecto/blob/master/elBatan_frontend/src/app/features/reportes/reportes.component.ts"
click node_cart_service "https://github.com/luisalazo/elbatanproyecto/blob/master/elBatan_frontend/src/app/core/services/cart.service.ts"
click node_product_client "https://github.com/luisalazo/elbatanproyecto/blob/master/elBatan_frontend/src/app/core/services/producto.service.ts"
click node_order_client "https://github.com/luisalazo/elbatanproyecto/blob/master/elBatan_frontend/src/app/core/services/pedido.service.ts"
click node_report_client "https://github.com/luisalazo/elbatanproyecto/blob/master/elBatan_frontend/src/app/core/services/reporte.service.ts"
click node_alerts "https://github.com/luisalazo/elbatanproyecto/blob/master/elBatan_frontend/src/app/core/services/alert.service.ts"
click node_product_api "https://github.com/luisalazo/elbatanproyecto/blob/master/elBatan/src/main/java/pe/edu/upeu/elBatan/controller/ProductoController.java"
click node_order_api "https://github.com/luisalazo/elbatanproyecto/blob/master/elBatan/src/main/java/pe/edu/upeu/elBatan/controller/PedidoController.java"
click node_auth_api "https://github.com/luisalazo/elbatanproyecto/blob/master/elBatan/src/main/java/pe/edu/upeu/elBatan/controller/AuthController.java"
click node_file_store "https://github.com/luisalazo/elbatanproyecto/blob/master/elBatan/src/main/java/pe/edu/upeu/elBatan/services/FileStorageServiceImpl.java"
click node_products "https://github.com/luisalazo/elbatanproyecto/blob/master/elBatan/src/main/java/pe/edu/upeu/elBatan/services/ProductoServiceImpl.java"
click node_orders "https://github.com/luisalazo/elbatanproyecto/blob/master/elBatan/src/main/java/pe/edu/upeu/elBatan/services/PedidoServiceImpl.java"
click node_users "https://github.com/luisalazo/elbatanproyecto/blob/master/elBatan/src/main/java/pe/edu/upeu/elBatan/services/UsuarioServiceImpl.java"
click node_report_api "https://github.com/luisalazo/elbatanproyecto/blob/master/elBatan/src/main/java/pe/edu/upeu/elBatan/controller/ReporteController.java"
click node_sales_report "https://github.com/luisalazo/elbatanproyecto/blob/master/elBatan/src/main/java/pe/edu/upeu/elBatan/services/ReporteService.java"
click node_sales_repository "https://github.com/luisalazo/elbatanproyecto/blob/master/elBatan/src/main/java/pe/edu/upeu/elBatan/repository/ReporteRepository.java"
click node_summary_service "https://github.com/luisalazo/elbatanproyecto/blob/master/elBatan/src/main/java/pe/edu/upeu/elBatan/services/ResumenVentasService.java"
click node_participation_service "https://github.com/luisalazo/elbatanproyecto/blob/master/elBatan/src/main/java/pe/edu/upeu/elBatan/services/ParticipacionProductoService.java"
click node_user_report_service "https://github.com/luisalazo/elbatanproyecto/blob/master/elBatan/src/main/java/pe/edu/upeu/elBatan/services/ReporteUsuarioService.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_routes,node_catalog_ui,node_home_ui,node_cart_ui,node_reports_ui,node_cart_service,node_product_client,node_order_client,node_report_client,node_alerts toneBlue
class node_product_api,node_order_api,node_auth_api,node_database toneAmber
class node_file_store,node_products,node_orders,node_users toneMint
class node_report_api,node_sales_report,node_sales_repository,node_summary_service,node_participation_service,node_user_report_service toneRose
class node_shopper toneIndigo
```

## Components

### Angular storefront

- [Page routing](https://github.com/luisalazo/elbatanproyecto/blob/master/elBatan_frontend/src/app/app.routes.ts): `elBatan_frontend/src/app/app.routes.ts`
- [Catalog & product form](https://github.com/luisalazo/elbatanproyecto/blob/master/elBatan_frontend/src/app/features/products/product-form/product-form.component.ts): `elBatan_frontend/src/app/features/products/product-form/product-form.component.ts`
- [Home browsing](https://github.com/luisalazo/elbatanproyecto/blob/master/elBatan_frontend/src/app/features/home/home.component.ts): `elBatan_frontend/src/app/features/home/home.component.ts`
- [Cart & checkout](https://github.com/luisalazo/elbatanproyecto/blob/master/elBatan_frontend/src/app/features/carrito/carrito.component.ts): `elBatan_frontend/src/app/features/carrito/carrito.component.ts`
- [Reports console](https://github.com/luisalazo/elbatanproyecto/blob/master/elBatan_frontend/src/app/features/reportes/reportes.component.ts): `elBatan_frontend/src/app/features/reportes/reportes.component.ts`
- [Cart state](https://github.com/luisalazo/elbatanproyecto/blob/master/elBatan_frontend/src/app/core/services/cart.service.ts): `elBatan_frontend/src/app/core/services/cart.service.ts`
- [Product API client](https://github.com/luisalazo/elbatanproyecto/blob/master/elBatan_frontend/src/app/core/services/producto.service.ts): `elBatan_frontend/src/app/core/services/producto.service.ts`
- [Order API client](https://github.com/luisalazo/elbatanproyecto/blob/master/elBatan_frontend/src/app/core/services/pedido.service.ts): `elBatan_frontend/src/app/core/services/pedido.service.ts`
- [Report API client](https://github.com/luisalazo/elbatanproyecto/blob/master/elBatan_frontend/src/app/core/services/reporte.service.ts): `elBatan_frontend/src/app/core/services/reporte.service.ts`
- [User alerts](https://github.com/luisalazo/elbatanproyecto/blob/master/elBatan_frontend/src/app/core/services/alert.service.ts): `elBatan_frontend/src/app/core/services/alert.service.ts`

### Spring API

- [Product endpoints](https://github.com/luisalazo/elbatanproyecto/blob/master/elBatan/src/main/java/pe/edu/upeu/elBatan/controller/ProductoController.java): `elBatan/src/main/java/pe/edu/upeu/elBatan/controller/ProductoController.java`
- [Order endpoints](https://github.com/luisalazo/elbatanproyecto/blob/master/elBatan/src/main/java/pe/edu/upeu/elBatan/controller/PedidoController.java): `elBatan/src/main/java/pe/edu/upeu/elBatan/controller/PedidoController.java`
- [Authentication endpoints](https://github.com/luisalazo/elbatanproyecto/blob/master/elBatan/src/main/java/pe/edu/upeu/elBatan/controller/AuthController.java): `elBatan/src/main/java/pe/edu/upeu/elBatan/controller/AuthController.java`

### Commerce services

- [Image storage](https://github.com/luisalazo/elbatanproyecto/blob/master/elBatan/src/main/java/pe/edu/upeu/elBatan/services/FileStorageServiceImpl.java): `elBatan/src/main/java/pe/edu/upeu/elBatan/services/FileStorageServiceImpl.java`
- [Product service](https://github.com/luisalazo/elbatanproyecto/blob/master/elBatan/src/main/java/pe/edu/upeu/elBatan/services/ProductoServiceImpl.java): `elBatan/src/main/java/pe/edu/upeu/elBatan/services/ProductoServiceImpl.java`
- [Order service](https://github.com/luisalazo/elbatanproyecto/blob/master/elBatan/src/main/java/pe/edu/upeu/elBatan/services/PedidoServiceImpl.java): `elBatan/src/main/java/pe/edu/upeu/elBatan/services/PedidoServiceImpl.java`
- [User service](https://github.com/luisalazo/elbatanproyecto/blob/master/elBatan/src/main/java/pe/edu/upeu/elBatan/services/UsuarioServiceImpl.java): `elBatan/src/main/java/pe/edu/upeu/elBatan/services/UsuarioServiceImpl.java`

### Reporting

- [Report endpoints](https://github.com/luisalazo/elbatanproyecto/blob/master/elBatan/src/main/java/pe/edu/upeu/elBatan/controller/ReporteController.java): `elBatan/src/main/java/pe/edu/upeu/elBatan/controller/ReporteController.java`
- [Sales report service](https://github.com/luisalazo/elbatanproyecto/blob/master/elBatan/src/main/java/pe/edu/upeu/elBatan/services/ReporteService.java): `elBatan/src/main/java/pe/edu/upeu/elBatan/services/ReporteService.java`
- [Sales report queries](https://github.com/luisalazo/elbatanproyecto/blob/master/elBatan/src/main/java/pe/edu/upeu/elBatan/repository/ReporteRepository.java): `elBatan/src/main/java/pe/edu/upeu/elBatan/repository/ReporteRepository.java`
- [Date-range summary](https://github.com/luisalazo/elbatanproyecto/blob/master/elBatan/src/main/java/pe/edu/upeu/elBatan/services/ResumenVentasService.java): `elBatan/src/main/java/pe/edu/upeu/elBatan/services/ResumenVentasService.java`
- [Product participation](https://github.com/luisalazo/elbatanproyecto/blob/master/elBatan/src/main/java/pe/edu/upeu/elBatan/services/ParticipacionProductoService.java): `elBatan/src/main/java/pe/edu/upeu/elBatan/services/ParticipacionProductoService.java`
- [User report service](https://github.com/luisalazo/elbatanproyecto/blob/master/elBatan/src/main/java/pe/edu/upeu/elBatan/services/ReporteUsuarioService.java): `elBatan/src/main/java/pe/edu/upeu/elBatan/services/ReporteUsuarioService.java`

### Other components

- **Shopper / admin**
- **Application database**

## Connections

- Shopper / admin → Page routing: uses (evidence: `elBatan_frontend/src/app/app.routes.ts`)
- Page routing → Home browsing: routes to (evidence: `elBatan_frontend/src/app/app.routes.ts`)
- Page routing → Catalog & product form: routes to (evidence: `elBatan_frontend/src/app/app.routes.ts`)
- Page routing → Cart & checkout: routes to (evidence: `elBatan_frontend/src/app/app.routes.ts`)
- Page routing → Reports console: routes to (evidence: `elBatan_frontend/src/app/app.routes.ts`)
- Home browsing → Product API client: loads products (evidence: `elBatan_frontend/src/app/features/home/home.component.ts`)
- Home browsing → Cart state: adds products (evidence: `elBatan_frontend/src/app/features/home/home.component.ts`)
- Catalog & product form → Product API client: manages products (evidence: `elBatan_frontend/src/app/features/products/product-form/product-form.component.ts`)
- Cart & checkout → Cart state: uses cart (evidence: `elBatan_frontend/src/app/features/carrito/carrito.component.ts`)
- Cart & checkout → Order API client: submits orders (evidence: `elBatan_frontend/src/app/features/carrito/carrito.component.ts`)
- Cart state → User alerts: shows toasts (evidence: `elBatan_frontend/src/app/core/services/cart.service.ts`)
- Reports console → Report API client: loads reports (evidence: `elBatan_frontend/src/app/features/reportes/reportes.component.ts`)
- Reports console → Order API client: updates status (evidence: `elBatan_frontend/src/app/features/reportes/reportes.component.ts`)
- Reports console → User alerts: shows outcomes (evidence: `elBatan_frontend/src/app/features/reportes/reportes.component.ts`)
- Product API client → Product endpoints: HTTP requests (evidence: `elBatan_frontend/src/app/core/services/producto.service.ts`)
- Order API client → Order endpoints: HTTP requests
- Report API client → Report endpoints: HTTP requests
- Product endpoints → Product service: delegates (evidence: `elBatan/src/main/java/pe/edu/upeu/elBatan/controller/ProductoController.java`)
- Product endpoints → Image storage: stores uploads (evidence: `elBatan/src/main/java/pe/edu/upeu/elBatan/controller/ProductoController.java`)
- Order endpoints → Order service: delegates (evidence: `elBatan/src/main/java/pe/edu/upeu/elBatan/controller/PedidoController.java`)
- Authentication endpoints → User service: delegates (evidence: `elBatan/src/main/java/pe/edu/upeu/elBatan/controller/AuthController.java`)
- Report endpoints → Sales report service: requests sales (evidence: `elBatan/src/main/java/pe/edu/upeu/elBatan/controller/ReporteController.java`)
- Report endpoints → Date-range summary: requests summary (evidence: `elBatan/src/main/java/pe/edu/upeu/elBatan/controller/ReporteController.java`)
- Report endpoints → Product participation: requests participation (evidence: `elBatan/src/main/java/pe/edu/upeu/elBatan/controller/ReporteController.java`)
- Report endpoints → User report service: requests users (evidence: `elBatan/src/main/java/pe/edu/upeu/elBatan/controller/ReporteController.java`)
- Sales report service → Sales report queries: queries (evidence: `elBatan/src/main/java/pe/edu/upeu/elBatan/services/ReporteService.java`)
- Sales report queries → Application database: reads
- Product service → Application database: persists products
- Order service → Application database: persists orders
