# nachobianchi00/tp architecture

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

- Interactive diagram: https://gitdiagram.com/nachobianchi00/tp
- Repository: https://github.com/nachobianchi00/tp

## Overview

This is a full-stack online shop: customers browse products and categories, manage a cart, authenticate, and proceed through checkout; administrators have separate access for managing store data. The frontend is a React application and the backend exposes an API with account, catalog, and order-related modules backed by a MySQL ORM. The graph preserves the documented and tree-visible order, payment, delivery, and admin capabilities. Some domain service implementations were not sampled, so uncertain internal calls are omitted; dashed links mark the frontend’s documented API boundary.

Main entry points: [`back/src/index.ts`](https://github.com/nachobianchi00/tp/blob/main/back/src/index.ts) (API entry), [`frontend/src/App.tsx`](https://github.com/nachobianchi00/tp/blob/main/frontend/src/App.tsx) (App routes), [`back/src/shared/db/orm.js`](https://github.com/nachobianchi00/tp/blob/main/back/src/shared/db/orm.js) (MySQL ORM), [`back/src/auth/session.service.ts`](https://github.com/nachobianchi00/tp/blob/main/back/src/auth/session.service.ts) (Session service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Storefront"]
  node_app["App routes<br/>[App.tsx]"]
  node_authui["Auth context<br/>[authProvider.tsx]"]
  node_authclient["Auth service<br/>[auth.service.ts]"]
  node_browse["Browse pages<br/>[categories.tsx]"]
  node_productclient["Product service"]
  node_categoryclient["Category service"]
  node_cart["Cart state and page<br/>[cartProvider.tsx]"]
  node_checkout["Checkout flow<br/>[checkout.tsx]"]
end

subgraph group_identity["Identity and security"]
  node_authroutes["Auth routes<br/>[auth.routes.ts]"]
  node_authcontroller["Auth controller<br/>[auth.controler.ts]"]
  node_authservice["Credential service<br/>[auth.service.ts]"]
  node_sessions["Session service<br/>[session.service.ts]"]
  node_access["Access and CSRF<br/>[authorization.ts]"]
  node_customers["Customer accounts"]
  node_admins["Admin accounts<br/>[admin.controler.js]"]
end

subgraph group_catalog["Catalog management"]
  node_products["Products"]
  node_categories["Categories"]
end

subgraph group_commerce["Orders and persistence"]
  node_api["API entry<br/>[index.ts]"]
  node_orders["Orders"]
  node_orderdetails["Order details"]
  node_payments["Payments<br/>[pago.controler.js]"]
  node_paymentmethods["Payment methods"]
  node_deliverymethods["Delivery methods"]
  node_orm[("MySQL ORM<br/>[orm.js]")]
end

node_shopper(("Shopper"))

node_shopper -->|"uses"| node_app
node_app -->|"provides"| node_authui
node_app -->|"routes to"| node_browse
node_app -->|"routes to"| node_cart
node_app -->|"routes to"| node_checkout
node_authui -->|"calls"| node_authclient
node_authclient -->|"requests auth and customer endpoints"| node_api
node_api -->|"mounts"| node_authroutes
node_api -->|"registers routes"| node_customers
node_api -->|"registers routes"| node_admins
node_api -->|"registers routes"| node_products
node_api -->|"registers routes"| node_categories
node_api -->|"registers routes"| node_orders
node_api -->|"registers routes"| node_orderdetails
node_api -->|"registers routes"| node_payments
node_api -->|"registers routes"| node_paymentmethods
node_api -->|"registers routes"| node_deliverymethods
node_authroutes -->|"dispatches"| node_authcontroller
node_authcontroller -.->|"delegates to"| node_sessions
node_sessions -->|"verifies credentials"| node_authservice
node_sessions -->|"checks account state"| node_orm
node_access -->|"reads session identity"| node_sessions
node_products -->|"queries"| node_orm
node_categories -->|"queries"| node_orm
node_customers -->|"queries"| node_orm
node_admins -->|"queries"| node_orm
node_browse -.->|"loads products"| node_productclient
node_browse -.->|"loads categories"| node_categoryclient
node_checkout -.->|"submits order"| node_api

click node_app "https://github.com/nachobianchi00/tp/blob/main/frontend/src/App.tsx"
click node_authui "https://github.com/nachobianchi00/tp/blob/main/frontend/src/context/authContext/authProvider.tsx"
click node_authclient "https://github.com/nachobianchi00/tp/blob/main/frontend/src/service/auth.service.ts"
click node_browse "https://github.com/nachobianchi00/tp/blob/main/frontend/src/page/categories/categories.tsx"
click node_productclient "https://github.com/nachobianchi00/tp/blob/main/frontend/src/service/producto.service.ts"
click node_categoryclient "https://github.com/nachobianchi00/tp/blob/main/frontend/src/service/categoria.service.ts"
click node_cart "https://github.com/nachobianchi00/tp/blob/main/frontend/src/context/cartContext/cartProvider.tsx"
click node_checkout "https://github.com/nachobianchi00/tp/blob/main/frontend/src/page/checkout/checkout.tsx"
click node_api "https://github.com/nachobianchi00/tp/blob/main/back/src/index.ts"
click node_authroutes "https://github.com/nachobianchi00/tp/blob/main/back/src/auth/auth.routes.ts"
click node_authcontroller "https://github.com/nachobianchi00/tp/blob/main/back/src/auth/auth.controler.ts"
click node_authservice "https://github.com/nachobianchi00/tp/blob/main/back/src/auth/auth.service.ts"
click node_sessions "https://github.com/nachobianchi00/tp/blob/main/back/src/auth/session.service.ts"
click node_access "https://github.com/nachobianchi00/tp/blob/main/back/src/shared/security/authorization.ts"
click node_customers "https://github.com/nachobianchi00/tp/blob/main/back/src/cliente/cliente.controler.js"
click node_admins "https://github.com/nachobianchi00/tp/blob/main/back/src/admin/admin.controler.js"
click node_products "https://github.com/nachobianchi00/tp/blob/main/back/src/producto/producto.controler.js"
click node_categories "https://github.com/nachobianchi00/tp/blob/main/back/src/categoria/categoria.controler.js"
click node_orders "https://github.com/nachobianchi00/tp/blob/main/back/src/pedido/pedido.controler.js"
click node_orderdetails "https://github.com/nachobianchi00/tp/blob/main/back/src/pedido/detallePedido.controler.ts"
click node_payments "https://github.com/nachobianchi00/tp/blob/main/back/src/pedido/pago.controler.js"
click node_paymentmethods "https://github.com/nachobianchi00/tp/blob/main/back/src/pedido/metodoPago.controler.js"
click node_deliverymethods "https://github.com/nachobianchi00/tp/blob/main/back/src/pedido/metodoEnvio.controler.js"
click node_orm "https://github.com/nachobianchi00/tp/blob/main/back/src/shared/db/orm.js"

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,node_authui,node_authclient,node_browse,node_productclient,node_categoryclient,node_cart,node_checkout toneBlue
class node_authroutes,node_authcontroller,node_authservice,node_sessions,node_access,node_customers,node_admins toneAmber
class node_products,node_categories toneMint
class node_api,node_orders,node_orderdetails,node_payments,node_paymentmethods,node_deliverymethods,node_orm toneRose
class node_shopper toneIndigo
```

## Components

### Storefront

- [App routes](https://github.com/nachobianchi00/tp/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Auth context](https://github.com/nachobianchi00/tp/blob/main/frontend/src/context/authContext/authProvider.tsx): `frontend/src/context/authContext/authProvider.tsx`
- [Auth service](https://github.com/nachobianchi00/tp/blob/main/frontend/src/service/auth.service.ts): `frontend/src/service/auth.service.ts`
- [Browse pages](https://github.com/nachobianchi00/tp/blob/main/frontend/src/page/categories/categories.tsx): `frontend/src/page/categories/categories.tsx`
- [Product service](https://github.com/nachobianchi00/tp/blob/main/frontend/src/service/producto.service.ts): `frontend/src/service/producto.service.ts`
- [Category service](https://github.com/nachobianchi00/tp/blob/main/frontend/src/service/categoria.service.ts): `frontend/src/service/categoria.service.ts`
- [Cart state and page](https://github.com/nachobianchi00/tp/blob/main/frontend/src/context/cartContext/cartProvider.tsx): `frontend/src/context/cartContext/cartProvider.tsx`
- [Checkout flow](https://github.com/nachobianchi00/tp/blob/main/frontend/src/page/checkout/checkout.tsx): `frontend/src/page/checkout/checkout.tsx`

### Identity and security

- [Auth routes](https://github.com/nachobianchi00/tp/blob/main/back/src/auth/auth.routes.ts): `back/src/auth/auth.routes.ts`
- [Auth controller](https://github.com/nachobianchi00/tp/blob/main/back/src/auth/auth.controler.ts): `back/src/auth/auth.controler.ts`
- [Credential service](https://github.com/nachobianchi00/tp/blob/main/back/src/auth/auth.service.ts): `back/src/auth/auth.service.ts`
- [Session service](https://github.com/nachobianchi00/tp/blob/main/back/src/auth/session.service.ts): `back/src/auth/session.service.ts`
- [Access and CSRF](https://github.com/nachobianchi00/tp/blob/main/back/src/shared/security/authorization.ts): `back/src/shared/security/authorization.ts`
- [Customer accounts](https://github.com/nachobianchi00/tp/blob/main/back/src/cliente/cliente.controler.js): `back/src/cliente/cliente.controler.js`
- [Admin accounts](https://github.com/nachobianchi00/tp/blob/main/back/src/admin/admin.controler.js): `back/src/admin/admin.controler.js`

### Catalog management

- [Products](https://github.com/nachobianchi00/tp/blob/main/back/src/producto/producto.controler.js): `back/src/producto/producto.controler.js`
- [Categories](https://github.com/nachobianchi00/tp/blob/main/back/src/categoria/categoria.controler.js): `back/src/categoria/categoria.controler.js`

### Orders and persistence

- [API entry](https://github.com/nachobianchi00/tp/blob/main/back/src/index.ts): `back/src/index.ts`
- [Orders](https://github.com/nachobianchi00/tp/blob/main/back/src/pedido/pedido.controler.js): `back/src/pedido/pedido.controler.js`
- [Order details](https://github.com/nachobianchi00/tp/blob/main/back/src/pedido/detallePedido.controler.ts): `back/src/pedido/detallePedido.controler.ts`
- [Payments](https://github.com/nachobianchi00/tp/blob/main/back/src/pedido/pago.controler.js): `back/src/pedido/pago.controler.js`
- [Payment methods](https://github.com/nachobianchi00/tp/blob/main/back/src/pedido/metodoPago.controler.js): `back/src/pedido/metodoPago.controler.js`
- [Delivery methods](https://github.com/nachobianchi00/tp/blob/main/back/src/pedido/metodoEnvio.controler.js): `back/src/pedido/metodoEnvio.controler.js`
- [MySQL ORM](https://github.com/nachobianchi00/tp/blob/main/back/src/shared/db/orm.js): `back/src/shared/db/orm.js`

### Other components

- **Shopper**

## Connections

- Shopper → App routes: uses (evidence: `frontend/src/App.tsx`)
- App routes → Auth context: provides (evidence: `frontend/src/App.tsx`)
- App routes → Browse pages: routes to (evidence: `frontend/src/App.tsx`)
- App routes → Cart state and page: routes to (evidence: `frontend/src/App.tsx`)
- App routes → Checkout flow: routes to (evidence: `frontend/src/App.tsx`)
- Auth context → Auth service: calls (evidence: `frontend/src/context/authContext/authProvider.tsx`)
- Auth service → API entry: requests auth and customer endpoints (evidence: `frontend/src/service/auth.service.ts`)
- API entry → Auth routes: mounts (evidence: `back/src/index.ts`)
- API entry → Customer accounts: registers routes (evidence: `back/src/index.ts`)
- API entry → Admin accounts: registers routes (evidence: `back/src/index.ts`)
- API entry → Products: registers routes (evidence: `back/src/index.ts`)
- API entry → Categories: registers routes (evidence: `back/src/index.ts`)
- API entry → Orders: registers routes (evidence: `back/src/index.ts`)
- API entry → Order details: registers routes (evidence: `back/src/index.ts`)
- API entry → Payments: registers routes (evidence: `back/src/index.ts`)
- API entry → Payment methods: registers routes (evidence: `back/src/index.ts`)
- API entry → Delivery methods: registers routes (evidence: `back/src/index.ts`)
- Auth routes → Auth controller: dispatches (evidence: `back/src/auth/auth.routes.ts`)
- Auth controller → Session service: delegates to
- Session service → Credential service: verifies credentials (evidence: `back/src/auth/session.service.ts`)
- Session service → MySQL ORM: checks account state (evidence: `back/src/auth/session.service.ts`)
- Access and CSRF → Session service: reads session identity (evidence: `back/src/shared/security/authorization.ts`)
- Products → MySQL ORM: queries (evidence: `back/src/producto/producto.controler.js`)
- Categories → MySQL ORM: queries (evidence: `back/src/categoria/categoria.controler.js`)
- Customer accounts → MySQL ORM: queries (evidence: `back/src/cliente/cliente.controler.js`)
- Admin accounts → MySQL ORM: queries (evidence: `back/src/admin/admin.controler.js`)
- Browse pages → Product service: loads products
- Browse pages → Category service: loads categories
- Checkout flow → API entry: submits order
