# dazhygm/proyecto_uninpahu architecture

> Architecture diagram of the GitHub repository dazhygm/proyecto_uninpahu, 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/dazhygm/proyecto_uninpahu
- Repository: https://github.com/dazhygm/proyecto_uninpahu

## Overview

MysticalCut is a Vue/Express barber-shop management system. The main workflow is a user signing in, receiving a JWT, and using role-specific screens to manage bookings, services, users, products, carts, and ratings through the REST API. The backend routes requests to controllers, which use domain models and MySQL; appointment and rating flows form a distinct customer-service lifecycle. The README documents the client/server and authentication flow; unsampled frontend feature wiring is shown only as unverified.

Main entry points: [`front/src/services/api.js`](https://github.com/dazhygm/proyecto_uninpahu/blob/main/front/src/services/api.js) (HTTP service clients), [`back/server.js`](https://github.com/dazhygm/proyecto_uninpahu/blob/main/back/server.js) (Express API server), [`back/config/db.js`](https://github.com/dazhygm/proyecto_uninpahu/blob/main/back/config/db.js) (MySQL connection), [`back/routes/userRoutes.js`](https://github.com/dazhygm/proyecto_uninpahu/blob/main/back/routes/userRoutes.js) (User routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_app["Vue application shell<br/>[App.vue]"]
  node_router["Protected navigation<br/>[index.js]"]
  node_authui["Sign-in and registration<br/>[LoginUser.vue]"]
  node_userui["User administration<br/>[UsersInfo.vue]"]
  node_serviceui["Service and booking screens"]
  node_productui["Product catalog and cart<br/>[ProductsView.vue]"]
  node_ratingui["Appointment ratings<br/>[CalificarCita.vue]"]
  node_apis["HTTP service clients<br/>[api.js]"]
end

subgraph group_api["REST API"]
  node_server["Express API server<br/>[server.js]"]
  node_useroutes["User routes<br/>[userRoutes.js]"]
  node_usercontroller["User and auth logic<br/>[userController.js]"]
  node_auth["JWT verification<br/>[authenticate.js]"]
  node_mailer["Mail delivery<br/>[mailer.js]"]
  node_db[("MySQL connection<br/>[db.js]")]
  node_userstore["User data access<br/>[userModel.js]"]
end

subgraph group_booking["Appointments and ratings"]
  node_quotecontroller["Appointment logic"]
  node_quoteroutes["Appointment routes<br/>[quotesRoutes.js]"]
  node_quotestore["Appointment records<br/>[Quote.js]"]
  node_ratingcontroller["Rating logic"]
  node_ratingroutes["Rating routes<br/>[ratingRoutes.js]"]
  node_ratingstore["Rating records<br/>[Rating.js]"]
end

subgraph group_commerce["Catalog and commerce"]
  node_serviceroutes["Service routes<br/>[serviceRoutes.js]"]
  node_servicecontroller["Service management"]
  node_servicestore["Service records<br/>[serviceModel.js]"]
  node_productroutes["Product routes<br/>[productRoutes.js]"]
  node_productcontroller["Product management"]
  node_cartcontroller["Shopping cart logic"]
  node_cartmodel["Cart records<br/>[ShoppingCart.js]"]
  node_upload["Image uploads<br/>[upload.js]"]
end

node_user(("Barber shop user"))

node_user -->|"uses"| node_app
node_app -->|"renders routes"| node_router
node_user -->|"signs in"| node_authui
node_authui -.->|"requests auth"| node_apis
node_router -.->|"uses API"| node_apis
node_apis -->|"HTTP requests"| node_server
node_server -->|"mounts"| node_useroutes
node_server -->|"mounts"| node_quoteroutes
node_server -->|"mounts"| node_ratingroutes
node_server -->|"mounts"| node_serviceroutes
node_server -->|"mounts"| node_productroutes
node_useroutes -->|"dispatches"| node_usercontroller
node_useroutes -->|"protects routes"| node_auth
node_usercontroller -->|"calls"| node_userstore
node_usercontroller -->|"uses mail"| node_mailer
node_userstore -->|"queries"| node_db
node_quoteroutes -->|"dispatches"| node_quotecontroller
node_quotecontroller -->|"calls"| node_quotestore
node_quotestore -->|"queries"| node_db
node_ratingroutes -->|"dispatches"| node_ratingcontroller
node_ratingcontroller -->|"calls"| node_ratingstore
node_ratingcontroller -->|"checks appointment"| node_quotestore
node_ratingstore -->|"queries"| node_db
node_serviceroutes -->|"dispatches"| node_servicecontroller
node_servicecontroller -->|"calls"| node_servicestore
node_servicestore -->|"queries"| node_db
node_productroutes -->|"dispatches"| node_productcontroller
node_productroutes -->|"processes images"| node_upload
node_productcontroller -.->|"uses data access"| node_db
node_cartcontroller -.->|"uses"| node_cartmodel
node_cartmodel -->|"queries"| node_db
node_serviceui -.->|"requests services"| node_apis
node_productui -.->|"requests products"| node_apis
node_ratingui -.->|"requests ratings"| node_apis
node_userui -.->|"requests users"| node_apis

click node_app "https://github.com/dazhygm/proyecto_uninpahu/blob/main/front/src/App.vue"
click node_router "https://github.com/dazhygm/proyecto_uninpahu/blob/main/front/src/router/index.js"
click node_authui "https://github.com/dazhygm/proyecto_uninpahu/blob/main/front/src/views/auth/LoginUser.vue"
click node_userui "https://github.com/dazhygm/proyecto_uninpahu/blob/main/front/src/views/users/UsersInfo.vue"
click node_serviceui "https://github.com/dazhygm/proyecto_uninpahu/blob/main/front/src/views/services/CalendarioCitas.vue"
click node_productui "https://github.com/dazhygm/proyecto_uninpahu/blob/main/front/src/views/products/ProductsView.vue"
click node_ratingui "https://github.com/dazhygm/proyecto_uninpahu/blob/main/front/src/views/services/CalificarCita.vue"
click node_apis "https://github.com/dazhygm/proyecto_uninpahu/blob/main/front/src/services/api.js"
click node_server "https://github.com/dazhygm/proyecto_uninpahu/blob/main/back/server.js"
click node_useroutes "https://github.com/dazhygm/proyecto_uninpahu/blob/main/back/routes/userRoutes.js"
click node_usercontroller "https://github.com/dazhygm/proyecto_uninpahu/blob/main/back/controllers/userController.js"
click node_auth "https://github.com/dazhygm/proyecto_uninpahu/blob/main/back/middlewares/authenticate.js"
click node_mailer "https://github.com/dazhygm/proyecto_uninpahu/blob/main/back/config/mailer.js"
click node_db "https://github.com/dazhygm/proyecto_uninpahu/blob/main/back/config/db.js"
click node_userstore "https://github.com/dazhygm/proyecto_uninpahu/blob/main/back/models/userModel.js"
click node_quotecontroller "https://github.com/dazhygm/proyecto_uninpahu/blob/main/back/controllers/quotesController.js"
click node_quoteroutes "https://github.com/dazhygm/proyecto_uninpahu/blob/main/back/routes/quotesRoutes.js"
click node_quotestore "https://github.com/dazhygm/proyecto_uninpahu/blob/main/back/models/Quote.js"
click node_ratingcontroller "https://github.com/dazhygm/proyecto_uninpahu/blob/main/back/controllers/ratingController.js"
click node_ratingroutes "https://github.com/dazhygm/proyecto_uninpahu/blob/main/back/routes/ratingRoutes.js"
click node_ratingstore "https://github.com/dazhygm/proyecto_uninpahu/blob/main/back/models/Rating.js"
click node_serviceroutes "https://github.com/dazhygm/proyecto_uninpahu/blob/main/back/routes/serviceRoutes.js"
click node_servicecontroller "https://github.com/dazhygm/proyecto_uninpahu/blob/main/back/controllers/serviceController.js"
click node_servicestore "https://github.com/dazhygm/proyecto_uninpahu/blob/main/back/models/serviceModel.js"
click node_productroutes "https://github.com/dazhygm/proyecto_uninpahu/blob/main/back/routes/productRoutes.js"
click node_productcontroller "https://github.com/dazhygm/proyecto_uninpahu/blob/main/back/controllers/productController.js"
click node_cartcontroller "https://github.com/dazhygm/proyecto_uninpahu/blob/main/back/controllers/shoppingCartController.js"
click node_cartmodel "https://github.com/dazhygm/proyecto_uninpahu/blob/main/back/models/ShoppingCart.js"
click node_upload "https://github.com/dazhygm/proyecto_uninpahu/blob/main/back/middlewares/upload.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_router,node_authui,node_userui,node_serviceui,node_productui,node_ratingui,node_apis,node_user toneBlue
class node_server,node_useroutes,node_usercontroller,node_auth,node_mailer,node_db,node_userstore toneAmber
class node_quotecontroller,node_quoteroutes,node_quotestore,node_ratingcontroller,node_ratingroutes,node_ratingstore toneMint
class node_serviceroutes,node_servicecontroller,node_servicestore,node_productroutes,node_productcontroller,node_cartcontroller,node_cartmodel,node_upload toneRose
```

## Components

### Web client

- [Vue application shell](https://github.com/dazhygm/proyecto_uninpahu/blob/main/front/src/App.vue): `front/src/App.vue`
- [Protected navigation](https://github.com/dazhygm/proyecto_uninpahu/blob/main/front/src/router/index.js): `front/src/router/index.js`
- [Sign-in and registration](https://github.com/dazhygm/proyecto_uninpahu/blob/main/front/src/views/auth/LoginUser.vue): `front/src/views/auth/LoginUser.vue`
- [User administration](https://github.com/dazhygm/proyecto_uninpahu/blob/main/front/src/views/users/UsersInfo.vue): `front/src/views/users/UsersInfo.vue`
- [Service and booking screens](https://github.com/dazhygm/proyecto_uninpahu/blob/main/front/src/views/services/CalendarioCitas.vue): `front/src/views/services/CalendarioCitas.vue`
- [Product catalog and cart](https://github.com/dazhygm/proyecto_uninpahu/blob/main/front/src/views/products/ProductsView.vue): `front/src/views/products/ProductsView.vue`
- [Appointment ratings](https://github.com/dazhygm/proyecto_uninpahu/blob/main/front/src/views/services/CalificarCita.vue): `front/src/views/services/CalificarCita.vue`
- [HTTP service clients](https://github.com/dazhygm/proyecto_uninpahu/blob/main/front/src/services/api.js): `front/src/services/api.js`

### REST API

- [Express API server](https://github.com/dazhygm/proyecto_uninpahu/blob/main/back/server.js): `back/server.js`
- [User routes](https://github.com/dazhygm/proyecto_uninpahu/blob/main/back/routes/userRoutes.js): `back/routes/userRoutes.js`
- [User and auth logic](https://github.com/dazhygm/proyecto_uninpahu/blob/main/back/controllers/userController.js): `back/controllers/userController.js`
- [JWT verification](https://github.com/dazhygm/proyecto_uninpahu/blob/main/back/middlewares/authenticate.js): `back/middlewares/authenticate.js`
- [Mail delivery](https://github.com/dazhygm/proyecto_uninpahu/blob/main/back/config/mailer.js): `back/config/mailer.js`
- [MySQL connection](https://github.com/dazhygm/proyecto_uninpahu/blob/main/back/config/db.js): `back/config/db.js`
- [User data access](https://github.com/dazhygm/proyecto_uninpahu/blob/main/back/models/userModel.js): `back/models/userModel.js`

### Appointments and ratings

- [Appointment logic](https://github.com/dazhygm/proyecto_uninpahu/blob/main/back/controllers/quotesController.js): `back/controllers/quotesController.js`
- [Appointment routes](https://github.com/dazhygm/proyecto_uninpahu/blob/main/back/routes/quotesRoutes.js): `back/routes/quotesRoutes.js`
- [Appointment records](https://github.com/dazhygm/proyecto_uninpahu/blob/main/back/models/Quote.js): `back/models/Quote.js`
- [Rating logic](https://github.com/dazhygm/proyecto_uninpahu/blob/main/back/controllers/ratingController.js): `back/controllers/ratingController.js`
- [Rating routes](https://github.com/dazhygm/proyecto_uninpahu/blob/main/back/routes/ratingRoutes.js): `back/routes/ratingRoutes.js`
- [Rating records](https://github.com/dazhygm/proyecto_uninpahu/blob/main/back/models/Rating.js): `back/models/Rating.js`

### Catalog and commerce

- [Service routes](https://github.com/dazhygm/proyecto_uninpahu/blob/main/back/routes/serviceRoutes.js): `back/routes/serviceRoutes.js`
- [Service management](https://github.com/dazhygm/proyecto_uninpahu/blob/main/back/controllers/serviceController.js): `back/controllers/serviceController.js`
- [Service records](https://github.com/dazhygm/proyecto_uninpahu/blob/main/back/models/serviceModel.js): `back/models/serviceModel.js`
- [Product routes](https://github.com/dazhygm/proyecto_uninpahu/blob/main/back/routes/productRoutes.js): `back/routes/productRoutes.js`
- [Product management](https://github.com/dazhygm/proyecto_uninpahu/blob/main/back/controllers/productController.js): `back/controllers/productController.js`
- [Shopping cart logic](https://github.com/dazhygm/proyecto_uninpahu/blob/main/back/controllers/shoppingCartController.js): `back/controllers/shoppingCartController.js`
- [Cart records](https://github.com/dazhygm/proyecto_uninpahu/blob/main/back/models/ShoppingCart.js): `back/models/ShoppingCart.js`
- [Image uploads](https://github.com/dazhygm/proyecto_uninpahu/blob/main/back/middlewares/upload.js): `back/middlewares/upload.js`

### Other components

- **Barber shop user**

## Connections

- Barber shop user → Vue application shell: uses
- Vue application shell → Protected navigation: renders routes (evidence: `front/src/App.vue`)
- Barber shop user → Sign-in and registration: signs in
- Sign-in and registration → HTTP service clients: requests auth
- Protected navigation → HTTP service clients: uses API
- HTTP service clients → Express API server: HTTP requests
- Express API server → User routes: mounts (evidence: `back/server.js`)
- Express API server → Appointment routes: mounts (evidence: `back/server.js`)
- Express API server → Rating routes: mounts (evidence: `back/server.js`)
- Express API server → Service routes: mounts (evidence: `back/server.js`)
- Express API server → Product routes: mounts (evidence: `back/server.js`)
- User routes → User and auth logic: dispatches (evidence: `back/routes/userRoutes.js`)
- User routes → JWT verification: protects routes (evidence: `back/routes/userRoutes.js`)
- User and auth logic → User data access: calls (evidence: `back/controllers/userController.js`)
- User and auth logic → Mail delivery: uses mail (evidence: `back/controllers/userController.js`)
- User data access → MySQL connection: queries (evidence: `back/models/userModel.js`)
- Appointment routes → Appointment logic: dispatches (evidence: `back/routes/quotesRoutes.js`)
- Appointment logic → Appointment records: calls (evidence: `back/controllers/quotesController.js`)
- Appointment records → MySQL connection: queries (evidence: `back/models/Quote.js`)
- Rating routes → Rating logic: dispatches (evidence: `back/routes/ratingRoutes.js`)
- Rating logic → Rating records: calls (evidence: `back/controllers/ratingController.js`)
- Rating logic → Appointment records: checks appointment (evidence: `back/controllers/ratingController.js`)
- Rating records → MySQL connection: queries (evidence: `back/models/Rating.js`)
- Service routes → Service management: dispatches (evidence: `back/routes/serviceRoutes.js`)
- Service management → Service records: calls (evidence: `back/controllers/serviceController.js`)
- Service records → MySQL connection: queries (evidence: `back/models/serviceModel.js`)
- Product routes → Product management: dispatches (evidence: `back/routes/productRoutes.js`)
- Product routes → Image uploads: processes images (evidence: `back/routes/productRoutes.js`)
- Product management → MySQL connection: uses data access
- Shopping cart logic → Cart records: uses
- Cart records → MySQL connection: queries (evidence: `back/models/ShoppingCart.js`)
- Service and booking screens → HTTP service clients: requests services
- Product catalog and cart → HTTP service clients: requests products
- Appointment ratings → HTTP service clients: requests ratings
- User administration → HTTP service clients: requests users
