# charlieisd34d/veterinaria-san-marcos-2 architecture
> Architecture diagram of the GitHub repository charlieisd34d/veterinaria-san-marcos-2, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-12). It is an AI-made overview: check details against the source.
- Interactive diagram: https://gitdiagram.com/charlieisd34d/veterinaria-san-marcos-2
- Repository: https://github.com/charlieisd34d/veterinaria-san-marcos-2
## Overview
Veterinaria San Marcos is a React web application for public veterinary information, product browsing and cart management, alongside an authenticated administration area for operational records and reporting. The principal customer flow is browsing products, viewing a product, adding it to a persistent cart and managing the cart; service information and appointment requests are another public capability. Administrators sign in before accessing protected routes and manage operational data through CRUD screens. The README describes simulated localStorage persistence. Connections for unsampled screens are limited to documented routing and indexed references.
Main entry points: [`src/App.jsx`](https://github.com/charlieisd34d/veterinaria-san-marcos-2/blob/main/src/App.jsx) (Router and providers), [`src/services`](https://github.com/charlieisd34d/veterinaria-san-marcos-2/tree/main/src/services) (Record services), [`src/pages`](https://github.com/charlieisd34d/veterinaria-san-marcos-2/tree/main/src/pages) (Admin pages), [`src/context/CarritoContext.jsx`](https://github.com/charlieisd34d/veterinaria-san-marcos-2/blob/main/src/context/CarritoContext.jsx) (Cart state)
## Diagram (Mermaid)
```mermaid
flowchart TD
subgraph group_public["Public experience"]
node_public_pages["Public pages"]
node_product_list["Product catalog"]
node_product_detail["Product detail"]
node_services_page["Services and appointments"]
node_cart_page["Cart page
[PaginaCarrito.jsx]"]
node_public_template["Public layout"]
end
subgraph group_admin["Administration"]
node_login["Admin sign-in"]
node_auth["Authentication
[autenticacion.js]"]
node_admin_pages["Admin pages"]
node_admin_layout["Admin layout
[PlantillaAdmin.jsx]"]
node_crud_section["CRUD interface
[SeccionCrud.jsx]"]
node_crud_hook["CRUD actions
[useCrud.js]"]
end
subgraph group_state["Application state"]
node_app["Router and providers
[App.jsx]"]
node_cart_state["Cart state
[CarritoContext.jsx]"]
node_products_state["Product state"]
node_categories_state["Category state"]
node_clients_state["Client state"]
node_requests_state["Request state"]
node_users_state["User state"]
end
subgraph group_data["Local data"]
node_services["Record services"]
node_local_storage[("Browser localStorage")]
end
node_visitor(("Visitor"))
node_visitor -->|"opens"| node_app
node_app -->|"routes to"| node_public_pages
node_app -->|"protects routes"| node_admin_pages
node_app -->|"provides"| node_cart_state
node_app -->|"provides"| node_products_state
node_app -->|"provides"| node_categories_state
node_app -->|"provides"| node_clients_state
node_app -->|"provides"| node_requests_state
node_app -->|"provides"| node_users_state
node_public_pages -.->|"uses layout"| node_public_template
node_app -->|"routes to"| node_product_list
node_app -->|"routes to"| node_product_detail
node_app -->|"routes to"| node_services_page
node_app -->|"routes to"| node_cart_page
node_product_list -->|"reads products"| node_products_state
node_product_detail -->|"reads products"| node_products_state
node_product_detail -->|"adds product"| node_cart_state
node_cart_page -->|"manages cart"| node_cart_state
node_services_page -->|"uses layout"| node_public_template
node_app -->|"routes to"| node_login
node_app -->|"checks session"| node_auth
node_login -->|"validates credentials"| node_auth
node_admin_pages -.->|"uses layout"| node_admin_layout
node_admin_pages -->|"renders CRUD"| node_crud_section
node_admin_pages -->|"uses actions"| node_crud_hook
node_crud_hook -->|"mutates records"| node_clients_state
node_clients_state -->|"calls service"| node_services
node_products_state -->|"calls service"| node_services
node_categories_state -->|"calls service"| node_services
node_requests_state -->|"calls service"| node_services
node_users_state -->|"calls service"| node_services
node_services -->|"reads and writes"| node_local_storage
node_cart_state -->|"persists cart"| node_local_storage
click node_app "https://github.com/charlieisd34d/veterinaria-san-marcos-2/blob/main/src/App.jsx"
click node_public_pages "https://github.com/charlieisd34d/veterinaria-san-marcos-2/tree/main/src/pages"
click node_product_list "https://github.com/charlieisd34d/veterinaria-san-marcos-2/blob/main/src/pages/PaginaProductos.jsx"
click node_product_detail "https://github.com/charlieisd34d/veterinaria-san-marcos-2/blob/main/src/pages/PaginaDetalleProducto.jsx"
click node_services_page "https://github.com/charlieisd34d/veterinaria-san-marcos-2/blob/main/src/pages/PaginaServicios.jsx"
click node_cart_page "https://github.com/charlieisd34d/veterinaria-san-marcos-2/blob/main/src/pages/PaginaCarrito.jsx"
click node_public_template "https://github.com/charlieisd34d/veterinaria-san-marcos-2/blob/main/src/components/templates/PlantillaPublica.jsx"
click node_login "https://github.com/charlieisd34d/veterinaria-san-marcos-2/blob/main/src/pages/PaginaInicioSesion.jsx"
click node_auth "https://github.com/charlieisd34d/veterinaria-san-marcos-2/blob/main/src/utils/autenticacion.js"
click node_admin_pages "https://github.com/charlieisd34d/veterinaria-san-marcos-2/tree/main/src/pages"
click node_admin_layout "https://github.com/charlieisd34d/veterinaria-san-marcos-2/blob/main/src/components/templates/PlantillaAdmin.jsx"
click node_crud_section "https://github.com/charlieisd34d/veterinaria-san-marcos-2/blob/main/src/components/organisms/SeccionCrud.jsx"
click node_crud_hook "https://github.com/charlieisd34d/veterinaria-san-marcos-2/blob/main/src/hooks/useCrud.js"
click node_cart_state "https://github.com/charlieisd34d/veterinaria-san-marcos-2/blob/main/src/context/CarritoContext.jsx"
click node_products_state "https://github.com/charlieisd34d/veterinaria-san-marcos-2/blob/main/src/context/ProductosContext.jsx"
click node_categories_state "https://github.com/charlieisd34d/veterinaria-san-marcos-2/blob/main/src/context/CategoriasContext.jsx"
click node_clients_state "https://github.com/charlieisd34d/veterinaria-san-marcos-2/blob/main/src/context/ClientesContext.jsx"
click node_requests_state "https://github.com/charlieisd34d/veterinaria-san-marcos-2/blob/main/src/context/SolicitudesContext.jsx"
click node_users_state "https://github.com/charlieisd34d/veterinaria-san-marcos-2/blob/main/src/context/UsuariosContext.jsx"
click node_services "https://github.com/charlieisd34d/veterinaria-san-marcos-2/tree/main/src/services"
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_public_pages,node_product_list,node_product_detail,node_services_page,node_cart_page,node_public_template toneBlue
class node_login,node_auth,node_admin_pages,node_admin_layout,node_crud_section,node_crud_hook toneAmber
class node_app,node_cart_state,node_products_state,node_categories_state,node_clients_state,node_requests_state,node_users_state toneMint
class node_services,node_local_storage toneRose
class node_visitor toneIndigo
```
## Components
### Public experience
- [Public pages](https://github.com/charlieisd34d/veterinaria-san-marcos-2/tree/main/src/pages): `src/pages`
- [Product catalog](https://github.com/charlieisd34d/veterinaria-san-marcos-2/blob/main/src/pages/PaginaProductos.jsx): `src/pages/PaginaProductos.jsx`
- [Product detail](https://github.com/charlieisd34d/veterinaria-san-marcos-2/blob/main/src/pages/PaginaDetalleProducto.jsx): `src/pages/PaginaDetalleProducto.jsx`
- [Services and appointments](https://github.com/charlieisd34d/veterinaria-san-marcos-2/blob/main/src/pages/PaginaServicios.jsx): `src/pages/PaginaServicios.jsx`
- [Cart page](https://github.com/charlieisd34d/veterinaria-san-marcos-2/blob/main/src/pages/PaginaCarrito.jsx): `src/pages/PaginaCarrito.jsx`
- [Public layout](https://github.com/charlieisd34d/veterinaria-san-marcos-2/blob/main/src/components/templates/PlantillaPublica.jsx): `src/components/templates/PlantillaPublica.jsx`
### Administration
- [Admin sign-in](https://github.com/charlieisd34d/veterinaria-san-marcos-2/blob/main/src/pages/PaginaInicioSesion.jsx): `src/pages/PaginaInicioSesion.jsx`
- [Authentication](https://github.com/charlieisd34d/veterinaria-san-marcos-2/blob/main/src/utils/autenticacion.js): `src/utils/autenticacion.js`
- [Admin pages](https://github.com/charlieisd34d/veterinaria-san-marcos-2/tree/main/src/pages): `src/pages`
- [Admin layout](https://github.com/charlieisd34d/veterinaria-san-marcos-2/blob/main/src/components/templates/PlantillaAdmin.jsx): `src/components/templates/PlantillaAdmin.jsx`
- [CRUD interface](https://github.com/charlieisd34d/veterinaria-san-marcos-2/blob/main/src/components/organisms/SeccionCrud.jsx): `src/components/organisms/SeccionCrud.jsx`
- [CRUD actions](https://github.com/charlieisd34d/veterinaria-san-marcos-2/blob/main/src/hooks/useCrud.js): `src/hooks/useCrud.js`
### Application state
- [Router and providers](https://github.com/charlieisd34d/veterinaria-san-marcos-2/blob/main/src/App.jsx): `src/App.jsx`
- [Cart state](https://github.com/charlieisd34d/veterinaria-san-marcos-2/blob/main/src/context/CarritoContext.jsx): `src/context/CarritoContext.jsx`
- [Product state](https://github.com/charlieisd34d/veterinaria-san-marcos-2/blob/main/src/context/ProductosContext.jsx): `src/context/ProductosContext.jsx`
- [Category state](https://github.com/charlieisd34d/veterinaria-san-marcos-2/blob/main/src/context/CategoriasContext.jsx): `src/context/CategoriasContext.jsx`
- [Client state](https://github.com/charlieisd34d/veterinaria-san-marcos-2/blob/main/src/context/ClientesContext.jsx): `src/context/ClientesContext.jsx`
- [Request state](https://github.com/charlieisd34d/veterinaria-san-marcos-2/blob/main/src/context/SolicitudesContext.jsx): `src/context/SolicitudesContext.jsx`
- [User state](https://github.com/charlieisd34d/veterinaria-san-marcos-2/blob/main/src/context/UsuariosContext.jsx): `src/context/UsuariosContext.jsx`
### Local data
- [Record services](https://github.com/charlieisd34d/veterinaria-san-marcos-2/tree/main/src/services): `src/services`
- **Browser localStorage**
### Other components
- **Visitor**
## Connections
- Visitor → Router and providers: opens (evidence: `src/App.jsx`)
- Router and providers → Public pages: routes to (evidence: `src/App.jsx`)
- Router and providers → Admin pages: protects routes (evidence: `src/App.jsx`)
- Router and providers → Cart state: provides (evidence: `src/App.jsx`)
- Router and providers → Product state: provides (evidence: `src/App.jsx`)
- Router and providers → Category state: provides (evidence: `src/App.jsx`)
- Router and providers → Client state: provides (evidence: `src/App.jsx`)
- Router and providers → Request state: provides (evidence: `src/App.jsx`)
- Router and providers → User state: provides (evidence: `src/App.jsx`)
- Public pages → Public layout: uses layout (evidence: `src/pages/PaginaCarrito.jsx`)
- Router and providers → Product catalog: routes to (evidence: `src/App.jsx`)
- Router and providers → Product detail: routes to (evidence: `src/App.jsx`)
- Router and providers → Services and appointments: routes to (evidence: `src/App.jsx`)
- Router and providers → Cart page: routes to (evidence: `src/App.jsx`)
- Product catalog → Product state: reads products (evidence: `src/pages/PaginaProductos.jsx`)
- Product detail → Product state: reads products (evidence: `src/pages/PaginaDetalleProducto.jsx`)
- Product detail → Cart state: adds product (evidence: `src/pages/PaginaDetalleProducto.jsx`)
- Cart page → Cart state: manages cart (evidence: `src/pages/PaginaCarrito.jsx`)
- Services and appointments → Public layout: uses layout (evidence: `src/pages/PaginaServicios.jsx`)
- Router and providers → Admin sign-in: routes to (evidence: `src/App.jsx`)
- Router and providers → Authentication: checks session (evidence: `src/App.jsx`)
- Admin sign-in → Authentication: validates credentials (evidence: `src/pages/PaginaInicioSesion.jsx`)
- Admin pages → Admin layout: uses layout (evidence: `src/pages/PaginaAdminClientes.jsx`)
- Admin pages → CRUD interface: renders CRUD (evidence: `src/pages/PaginaAdminClientes.jsx`)
- Admin pages → CRUD actions: uses actions (evidence: `src/pages/PaginaAdminClientes.jsx`)
- CRUD actions → Client state: mutates records (evidence: `src/hooks/useCrud.js`)
- Client state → Record services: calls service (evidence: `src/context/ClientesContext.jsx`)
- Product state → Record services: calls service (evidence: `src/context/ProductosContext.jsx`)
- Category state → Record services: calls service (evidence: `src/context/CategoriasContext.jsx`)
- Request state → Record services: calls service (evidence: `src/context/SolicitudesContext.jsx`)
- User state → Record services: calls service (evidence: `src/context/UsuariosContext.jsx`)
- Record services → Browser localStorage: reads and writes (evidence: `src/services/productoService.js`)
- Cart state → Browser localStorage: persists cart (evidence: `src/context/CarritoContext.jsx`)