# james20i789/proyecto-base.lp2 architecture

> Architecture diagram of the GitHub repository james20i789/proyecto-base.lp2, 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/james20i789/proyecto-base.lp2
- Repository: https://github.com/james20i789/proyecto-base.lp2

## Overview

This is a Spanish-language ecommerce application with an Angular storefront and a Spring backend. Users browse products, manage a locally persisted cart, and can register or log in; the backend exposes product, authentication, and order APIs, with JWT security and image uploads. The sampled code confirms frontend-to-API calls for authentication and products and order submission from the cart. Order internals and some product screens are represented from the source index/tree; their unshown connections are omitted.

Main entry points: [`lp2_gp2/src/main/java/pe/edu/upeu/lp2_gp2/Controller/AuthController.java`](https://github.com/james20i789/proyecto-base.lp2/blob/master/lp2_gp2/src/main/java/pe/edu/upeu/lp2_gp2/Controller/AuthController.java) (Auth API), [`frontend-gp2/src/app/features/carrito/carrito.component.ts`](https://github.com/james20i789/proyecto-base.lp2/blob/master/frontend-gp2/src/app/features/carrito/carrito.component.ts) (Cart Checkout), [`frontend-gp2/src/app/core/services/cart.service.ts`](https://github.com/james20i789/proyecto-base.lp2/blob/master/frontend-gp2/src/app/core/services/cart.service.ts) (Cart State), [`lp2_gp2/src/main/java/pe/edu/upeu/lp2_gp2/services/PedidoServiceImpl.java`](https://github.com/james20i789/proyecto-base.lp2/blob/master/lp2_gp2/src/main/java/pe/edu/upeu/lp2_gp2/services/PedidoServiceImpl.java) (Order Service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Angular Storefront"]
  node_app_shell["App Shell<br/>[app.component.ts]"]
  node_route_views["Storefront Views"]
  node_login_register["Login &amp; Register<br/>[login.component.ts]"]
  node_cart_view["Cart Checkout"]
end

subgraph group_frontend_services["Frontend Services"]
  node_auth_client["Auth Client<br/>[auth.service.ts]"]
  node_product_client["Product Client"]
  node_cart_state["Cart State<br/>[cart.service.ts]"]
  node_alerts["Alerts<br/>[alert.service.ts]"]
  node_pedido_client["Order Client<br/>[pedido.service.ts]"]
end

subgraph group_api["Backend API"]
  node_auth_api["Auth API"]
  node_product_api["Product API"]
  node_order_api["Order API"]
end

subgraph group_backend_services["Backend Services"]
  node_user_service["User Service"]
  node_product_service["Product Service"]
  node_order_service["Order Service"]
  node_file_storage["Image Storage"]
end

subgraph group_backend_data["Backend Data &amp; Security"]
  node_order_data[("Orders &amp; Lines<br/>[Pedido.java]")]
  node_product_data[("Products<br/>[Producto.java]")]
  node_user_data[("Users<br/>[Usuario.java]")]
  node_jwt_service["JWT Service<br/>[JwtService.java]"]
end

node_shopper(("Shopper"))
node_local_storage[("Browser Storage")]
node_backend(("Spring API"))

node_shopper -->|"uses"| node_app_shell
node_app_shell -->|"hosts"| node_route_views
node_shopper -.->|"submits credentials"| node_login_register
node_login_register -.->|"calls"| node_auth_client
node_auth_client -->|"sends auth requests"| node_backend
node_auth_api -->|"issues tokens"| node_jwt_service
node_auth_api -->|"looks up user"| node_user_data
node_auth_api -->|"registers user"| node_user_service
node_shopper -->|"browses"| node_route_views
node_route_views -.->|"loads products"| node_product_client
node_product_client -->|"requests products"| node_backend
node_product_api -->|"delegates"| node_product_service
node_product_api -->|"stores images"| node_file_storage
node_product_service -.->|"manages products"| node_product_data
node_shopper -->|"reviews cart"| node_cart_view
node_cart_view -->|"reads and updates"| node_cart_state
node_cart_state -->|"persists cart"| node_local_storage
node_cart_state -->|"notifies"| node_alerts
node_cart_view -->|"submits order"| node_pedido_client
node_pedido_client -.->|"sends order"| node_backend
node_order_api -->|"delegates"| node_order_service
node_order_service -->|"persists orders"| node_order_data
node_order_service -->|"checks stock"| node_product_data
node_backend -.->|"routes requests"| node_auth_api
node_backend -.->|"routes requests"| node_product_api
node_backend -.->|"routes requests"| node_order_api

click node_app_shell "https://github.com/james20i789/proyecto-base.lp2/blob/master/frontend-gp2/src/app/app.component.ts"
click node_route_views "https://github.com/james20i789/proyecto-base.lp2/tree/master/frontend-gp2/src/app/features"
click node_login_register "https://github.com/james20i789/proyecto-base.lp2/blob/master/frontend-gp2/src/app/features/login/login.component.ts"
click node_cart_view "https://github.com/james20i789/proyecto-base.lp2/blob/master/frontend-gp2/src/app/features/carrito/carrito.component.ts"
click node_auth_client "https://github.com/james20i789/proyecto-base.lp2/blob/master/frontend-gp2/src/app/core/services/auth.service.ts"
click node_product_client "https://github.com/james20i789/proyecto-base.lp2/blob/master/frontend-gp2/src/app/core/services/producto.service.ts"
click node_cart_state "https://github.com/james20i789/proyecto-base.lp2/blob/master/frontend-gp2/src/app/core/services/cart.service.ts"
click node_alerts "https://github.com/james20i789/proyecto-base.lp2/blob/master/frontend-gp2/src/app/core/services/alert.service.ts"
click node_pedido_client "https://github.com/james20i789/proyecto-base.lp2/blob/master/frontend-gp2/src/app/core/services/pedido.service.ts"
click node_auth_api "https://github.com/james20i789/proyecto-base.lp2/blob/master/lp2_gp2/src/main/java/pe/edu/upeu/lp2_gp2/Controller/AuthController.java"
click node_product_api "https://github.com/james20i789/proyecto-base.lp2/blob/master/lp2_gp2/src/main/java/pe/edu/upeu/lp2_gp2/Controller/ProductoController.java"
click node_order_api "https://github.com/james20i789/proyecto-base.lp2/blob/master/lp2_gp2/src/main/java/pe/edu/upeu/lp2_gp2/dto/PedidoController.java"
click node_user_service "https://github.com/james20i789/proyecto-base.lp2/blob/master/lp2_gp2/src/main/java/pe/edu/upeu/lp2_gp2/services/UsuarioServiceImpl.java"
click node_product_service "https://github.com/james20i789/proyecto-base.lp2/blob/master/lp2_gp2/src/main/java/pe/edu/upeu/lp2_gp2/services/ProductoServicesImpl.java"
click node_order_service "https://github.com/james20i789/proyecto-base.lp2/blob/master/lp2_gp2/src/main/java/pe/edu/upeu/lp2_gp2/services/PedidoServiceImpl.java"
click node_file_storage "https://github.com/james20i789/proyecto-base.lp2/blob/master/lp2_gp2/src/main/java/pe/edu/upeu/lp2_gp2/services/FileStorageServiceImpl.java"
click node_order_data "https://github.com/james20i789/proyecto-base.lp2/blob/master/lp2_gp2/src/main/java/pe/edu/upeu/lp2_gp2/entity/Pedido.java"
click node_product_data "https://github.com/james20i789/proyecto-base.lp2/blob/master/lp2_gp2/src/main/java/pe/edu/upeu/lp2_gp2/entity/Producto.java"
click node_user_data "https://github.com/james20i789/proyecto-base.lp2/blob/master/lp2_gp2/src/main/java/pe/edu/upeu/lp2_gp2/entity/Usuario.java"
click node_jwt_service "https://github.com/james20i789/proyecto-base.lp2/blob/master/lp2_gp2/src/main/java/pe/edu/upeu/lp2_gp2/security/JwtService.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_app_shell,node_route_views,node_login_register,node_cart_view toneBlue
class node_auth_client,node_product_client,node_cart_state,node_alerts,node_pedido_client,node_local_storage toneAmber
class node_auth_api,node_product_api,node_order_api,node_backend toneMint
class node_user_service,node_product_service,node_order_service,node_file_storage toneRose
class node_order_data,node_product_data,node_user_data,node_jwt_service,node_shopper toneIndigo
```

## Components

### Angular Storefront

- [App Shell](https://github.com/james20i789/proyecto-base.lp2/blob/master/frontend-gp2/src/app/app.component.ts): `frontend-gp2/src/app/app.component.ts`
- [Storefront Views](https://github.com/james20i789/proyecto-base.lp2/tree/master/frontend-gp2/src/app/features): `frontend-gp2/src/app/features`
- [Login & Register](https://github.com/james20i789/proyecto-base.lp2/blob/master/frontend-gp2/src/app/features/login/login.component.ts): `frontend-gp2/src/app/features/login/login.component.ts`
- [Cart Checkout](https://github.com/james20i789/proyecto-base.lp2/blob/master/frontend-gp2/src/app/features/carrito/carrito.component.ts): `frontend-gp2/src/app/features/carrito/carrito.component.ts`

### Frontend Services

- [Auth Client](https://github.com/james20i789/proyecto-base.lp2/blob/master/frontend-gp2/src/app/core/services/auth.service.ts): `frontend-gp2/src/app/core/services/auth.service.ts`
- [Product Client](https://github.com/james20i789/proyecto-base.lp2/blob/master/frontend-gp2/src/app/core/services/producto.service.ts): `frontend-gp2/src/app/core/services/producto.service.ts`
- [Cart State](https://github.com/james20i789/proyecto-base.lp2/blob/master/frontend-gp2/src/app/core/services/cart.service.ts): `frontend-gp2/src/app/core/services/cart.service.ts`
- [Alerts](https://github.com/james20i789/proyecto-base.lp2/blob/master/frontend-gp2/src/app/core/services/alert.service.ts): `frontend-gp2/src/app/core/services/alert.service.ts`
- [Order Client](https://github.com/james20i789/proyecto-base.lp2/blob/master/frontend-gp2/src/app/core/services/pedido.service.ts): `frontend-gp2/src/app/core/services/pedido.service.ts`

### Backend API

- [Auth API](https://github.com/james20i789/proyecto-base.lp2/blob/master/lp2_gp2/src/main/java/pe/edu/upeu/lp2_gp2/Controller/AuthController.java): `lp2_gp2/src/main/java/pe/edu/upeu/lp2_gp2/Controller/AuthController.java`
- [Product API](https://github.com/james20i789/proyecto-base.lp2/blob/master/lp2_gp2/src/main/java/pe/edu/upeu/lp2_gp2/Controller/ProductoController.java): `lp2_gp2/src/main/java/pe/edu/upeu/lp2_gp2/Controller/ProductoController.java`
- [Order API](https://github.com/james20i789/proyecto-base.lp2/blob/master/lp2_gp2/src/main/java/pe/edu/upeu/lp2_gp2/dto/PedidoController.java): `lp2_gp2/src/main/java/pe/edu/upeu/lp2_gp2/dto/PedidoController.java`

### Backend Services

- [User Service](https://github.com/james20i789/proyecto-base.lp2/blob/master/lp2_gp2/src/main/java/pe/edu/upeu/lp2_gp2/services/UsuarioServiceImpl.java): `lp2_gp2/src/main/java/pe/edu/upeu/lp2_gp2/services/UsuarioServiceImpl.java`
- [Product Service](https://github.com/james20i789/proyecto-base.lp2/blob/master/lp2_gp2/src/main/java/pe/edu/upeu/lp2_gp2/services/ProductoServicesImpl.java): `lp2_gp2/src/main/java/pe/edu/upeu/lp2_gp2/services/ProductoServicesImpl.java`
- [Order Service](https://github.com/james20i789/proyecto-base.lp2/blob/master/lp2_gp2/src/main/java/pe/edu/upeu/lp2_gp2/services/PedidoServiceImpl.java): `lp2_gp2/src/main/java/pe/edu/upeu/lp2_gp2/services/PedidoServiceImpl.java`
- [Image Storage](https://github.com/james20i789/proyecto-base.lp2/blob/master/lp2_gp2/src/main/java/pe/edu/upeu/lp2_gp2/services/FileStorageServiceImpl.java): `lp2_gp2/src/main/java/pe/edu/upeu/lp2_gp2/services/FileStorageServiceImpl.java`

### Backend Data & Security

- [Orders & Lines](https://github.com/james20i789/proyecto-base.lp2/blob/master/lp2_gp2/src/main/java/pe/edu/upeu/lp2_gp2/entity/Pedido.java): `lp2_gp2/src/main/java/pe/edu/upeu/lp2_gp2/entity/Pedido.java`
- [Products](https://github.com/james20i789/proyecto-base.lp2/blob/master/lp2_gp2/src/main/java/pe/edu/upeu/lp2_gp2/entity/Producto.java): `lp2_gp2/src/main/java/pe/edu/upeu/lp2_gp2/entity/Producto.java`
- [Users](https://github.com/james20i789/proyecto-base.lp2/blob/master/lp2_gp2/src/main/java/pe/edu/upeu/lp2_gp2/entity/Usuario.java): `lp2_gp2/src/main/java/pe/edu/upeu/lp2_gp2/entity/Usuario.java`
- [JWT Service](https://github.com/james20i789/proyecto-base.lp2/blob/master/lp2_gp2/src/main/java/pe/edu/upeu/lp2_gp2/security/JwtService.java): `lp2_gp2/src/main/java/pe/edu/upeu/lp2_gp2/security/JwtService.java`

### Other components

- **Shopper**
- **Browser Storage**
- **Spring API**

## Connections

- Shopper → App Shell: uses (evidence: `frontend-gp2/src/app/app.component.ts`)
- App Shell → Storefront Views: hosts
- Shopper → Login & Register: submits credentials
- Login & Register → Auth Client: calls
- Auth Client → Spring API: sends auth requests (evidence: `frontend-gp2/src/app/core/services/auth.service.ts`)
- Auth API → JWT Service: issues tokens (evidence: `lp2_gp2/src/main/java/pe/edu/upeu/lp2_gp2/Controller/AuthController.java`)
- Auth API → Users: looks up user (evidence: `lp2_gp2/src/main/java/pe/edu/upeu/lp2_gp2/Controller/AuthController.java`)
- Auth API → User Service: registers user (evidence: `lp2_gp2/src/main/java/pe/edu/upeu/lp2_gp2/Controller/AuthController.java`)
- Shopper → Storefront Views: browses
- Storefront Views → Product Client: loads products (evidence: `frontend-gp2/src/app/features/home/home.component.ts`)
- Product Client → Spring API: requests products (evidence: `frontend-gp2/src/app/core/services/producto.service.ts`)
- Product API → Product Service: delegates (evidence: `lp2_gp2/src/main/java/pe/edu/upeu/lp2_gp2/Controller/ProductoController.java`)
- Product API → Image Storage: stores images (evidence: `lp2_gp2/src/main/java/pe/edu/upeu/lp2_gp2/Controller/ProductoController.java`)
- Product Service → Products: manages products
- Shopper → Cart Checkout: reviews cart
- Cart Checkout → Cart State: reads and updates (evidence: `frontend-gp2/src/app/features/carrito/carrito.component.ts`)
- Cart State → Browser Storage: persists cart (evidence: `frontend-gp2/src/app/core/services/cart.service.ts`)
- Cart State → Alerts: notifies (evidence: `frontend-gp2/src/app/core/services/cart.service.ts`)
- Cart Checkout → Order Client: submits order (evidence: `frontend-gp2/src/app/features/carrito/carrito.component.ts`)
- Order Client → Spring API: sends order
- Order API → Order Service: delegates (evidence: `lp2_gp2/src/main/java/pe/edu/upeu/lp2_gp2/dto/PedidoController.java`)
- Order Service → Orders & Lines: persists orders (evidence: `lp2_gp2/src/main/java/pe/edu/upeu/lp2_gp2/services/PedidoServiceImpl.java`)
- Order Service → Products: checks stock (evidence: `lp2_gp2/src/main/java/pe/edu/upeu/lp2_gp2/services/PedidoServiceImpl.java`)
- Spring API → Auth API: routes requests
- Spring API → Product API: routes requests
- Spring API → Order API: routes requests
