# matiaspallero/sistema-web-instalar architecture

> Architecture diagram of the GitHub repository matiaspallero/sistema-web-instalar, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-06-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/matiaspallero/sistema-web-instalar
- Repository: https://github.com/matiaspallero/sistema-web-instalar

## Overview

1. **Type of system**
   - This is a **single-page frontend application** for A/C maintenance operations, built with **React + Vite** and styled with **Tailwind CSS**.
   - The repository is primarily the UI layer; the **backend is external** and accessed through the `src/services/api.jsx` boundary.

2. **Top-level application shell**
   - `src/main.jsx` bootstraps the app.
   - `src/App.jsx` is the composition root: it likely wires **routing, global providers, and layout framing**.
   - `src/App.css`, `src/index.css`, and `src/style/global.css` define the base visual system, while `src/assets` holds static UI resources.

3. **Authentication and access control boundary**
   - `src/context/AuthContext.jsx` manages authentication state for the whole app.
   - `src/components/ProtectedRoute.jsx` is the main guard for role-restricted screens.
   - The README indicates **role-based access** for at least:
     - **administrador**
     - **técnico**
     - **cliente**
   - This creates a clear boundary between public pages and authenticated operational dashboards.

4. **Global application state**
   - `src/context/AppContext.jsx` likely holds shared business state beyond login, such as selected entities, notifications, or refreshed lists.
   - This context layer is the main coordination point for cross-page state without pushing everything through props.

5. **Routing and page-level modules**
   - The `src/pages` folder is the main domain map of the application.
   - Core operational pages include:
     - `Dashboard.jsx`
     - `Clientes.jsx`
     - `Sedes.jsx`
     - `Equipos.jsx`
     - `Servicios.jsx`
     - `Solicitudes.jsx`
     - `Tecnicos.jsx`
     - `Calendario.jsx`
     - `Reportes.jsx`
   - Public/auth entry pages include:
     - `Login.jsx`
     - `Register.jsx`
     - `landing/Inicio.jsx`
   - This implies a route structure split between **public entry**, **admin operations**, and **role-specific portals**.

6. **Role-specific subareas**
   - There are dedicated subfolders for user personas:
     - `pages/clientes-pages/ClienteDashboad.jsx` and `MisSedes.jsx` for client-facing views
     - `pages/tecnico-pages/MisTrabajos.jsx` for technician work queues
     - `pages/equipos-pages/EditarEquipo.jsx` and `FichaTecnicaEquipo.jsx` for equipment detail workflows
   - This suggests the app is not a generic CRUD shell; it has **persona-based operational views** with distinct navigation and data scopes.

7. **Domain subsystems**
   - The repository centers on interconnected maintenance entities:
     - **Clientes**: customer organizations
     - **Sedes**: client sites/locations
     - **Equipos**: AC equipment assets
     - **Servicios**: service catalog or work orders
     - **Solicitudes**: requests originating from clients or internal staff
     - **Técnicos**: workforce and assignments
   - The architecture likely flows from **cliente → sede → equipo → solicitud/servicio → técnico/asignación**, which is the key diagram relationship to capture.

8. **Workflow and modal-driven interactions**
   - Most operational actions are encapsulated in modal components under `src/components`, such as:
     - `SolicitudModal.jsx`
     - `SolicitarServicioModal.jsx`
     - `SolicitarSedeModal.jsx`
     - `SolicitudesSedesModal.jsx`
     - `AdminAsignacionModal.jsx`
     - `TecAtencionModal.jsx`
     - `ConfirmModal.jsx`
     - `ClienteForm.jsx`
   - This indicates the UI favors **overlay-based workflows** for creating requests, confirming actions, assigning technicians, and capturing forms without full page transitions.

9. **Shared UI and operational widgets**
   - Reusable components like `Navbar.jsx`, `Sidebar.jsx`, `Loading.jsx`, `Notification.jsx`, `Pagination.jsx`, and `WidgetTecnico.jsx` form the common shell and utility layer.
   - `CalendarioMantenimiento.jsx` and `EquipoHistorialServicios.jsx` are higher-level widgets that present schedule/history data in a domain-specific way.
   - These components are reused across pages to keep the UI consistent and reduce duplication.

10. **Cross-cutting hooks and interaction helpers**
   - `src/hooks/usePagination.jsx` and `src/hooks/useSearch.jsx` encapsulate list interaction patterns.
   - `src/hooks/Layout.jsx` likely standardizes page framing or conditional layout behavior.
   - `src/utils/helpers.jsx` contains shared data formatting or business helper functions.
   - This layer keeps list pages like clientes/equipos/solicitudes consistent in behavior.

11. **API integration boundary**
   - `src/services/api.jsx` is the only explicit service layer in the tree, and it is the likely choke point for:
     - authentication calls
     - CRUD operations for domain entities
     - request/assignment workflows
     - report and calendar data
   - The README explicitly says the frontend is designed to integrate with **any backend or service of preference**, so the backend is a replaceable external dependency rather than a tightly coupled internal subsystem.

12. **Navigation and operational UX**
   - The presence of `Navbar`, `Sidebar`, dashboard widgets, and dedicated landing/login pages suggests a UX split between:
     - **marketing/public entry**
     - **authenticated operational console**
   - After login, users likely move into a layout with persistent navigation and page-level content swapping.

13. **Deployment/runtime footprint**
   - `vite.config.js`, `tailwind.config.js`, and `eslint.config.js` show a standard modern frontend toolchain.
   - `netlify.toml` and `vercel.json` indicate the app is prepared for **static frontend deployment** on common hosting platforms.
   - `index.html` and `public/` reinforce that this is a client-side rendered SPA.

14. **What an architecture diagram should emphasize**
   - The core diagram should show:
     - **Users by role** entering through login/landing
     - **Auth/context layer** controlling access
     - **App shell + router** selecting role-specific pages
     - **Domain pages** working over shared entities
     - **Modal and widget components** handling workflows and detail interactions
     - **API service boundary** connecting to an external backend
   - The most important data relationships are between **clients, sites, equipment, service requests, assignments, and technicians**.

Main entry points: [`src/App.jsx`](https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/App.jsx) (App), [`src/services/api.jsx`](https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/services/api.jsx) (API service), [`src/pages/Equipos.jsx`](https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/pages/Equipos.jsx) (Equipos), [`src/components/SolicitudModal.jsx`](https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/components/SolicitudModal.jsx) (Workflow modals)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_g_shell["App shell"]
  node_n_main(("main<br/>bootstrap<br/>[main.jsx]"))
  node_n_app["App<br/>composition root<br/>[App.jsx]"]
  node_n_styles["Global styles<br/>style system<br/>[App.css]"]
end

subgraph group_g_access["Access layer"]
  node_n_auth[("Auth context<br/>session state<br/>[AuthContext.jsx]")]
  node_n_protected{{"Protected route<br/>route guard<br/>[ProtectedRoute.jsx]"}}
end

subgraph group_g_pages["Pages"]
  node_n_landing["Inicio<br/>public page<br/>[Inicio.jsx]"]
  node_n_login["Login<br/>auth page<br/>[Login.jsx]"]
  node_n_dashboard["Dashboard<br/>[Dashboard.jsx]"]
  node_n_clientes["Clientes<br/>customer management<br/>[Clientes.jsx]"]
  node_n_sedes["Sedes<br/>site management<br/>[Sedes.jsx]"]
  node_n_equipos["Equipos<br/>asset management<br/>[Equipos.jsx]"]
  node_n_servicios["Servicios<br/>service catalog<br/>[Servicios.jsx]"]
  node_n_solicitudes["Solicitudes<br/>request workflow<br/>[Solicitudes.jsx]"]
  node_n_tecnicos["Técnicos<br/>workforce management<br/>[Tecnicos.jsx]"]
  node_n_calendario["Calendario<br/>schedule view<br/>[Calendario.jsx]"]
  node_n_reportes["Reportes<br/>analytics page<br/>[Reportes.jsx]"]
  node_n_cliente_dash["Cliente dashboard<br/>client portal"]
  node_n_mis_sedes["Mis sedes<br/>client portal<br/>[MisSedes.jsx]"]
  node_n_mis_trabajos["Mis trabajos<br/>tech queue<br/>[MisTrabajos.jsx]"]
  node_n_editar_equipo["Editar equipo<br/>asset workflow<br/>[EditarEquipo.jsx]"]
  node_n_ficha_equipo["Ficha técnica<br/>asset detail"]
end

subgraph group_g_domain["Domain UI"]
  node_n_navbar["Navbar<br/>shell component<br/>[Navbar.jsx]"]
  node_n_sidebar["Sidebar<br/>shell component<br/>[Sidebar.jsx]"]
  node_n_widgets{{"Domain widgets<br/>dashboard widgets<br/>[WidgetTecnico.jsx]"}}
  node_n_modals{{"Workflow modals<br/>overlay workflows<br/>[SolicitudModal.jsx]"}}
  node_n_loading["Feedback UI<br/>utility components<br/>[Loading.jsx]"]
end

subgraph group_g_state["State and helpers"]
  node_n_appctx[("App context<br/>shared state<br/>[AppContext.jsx]")]
  node_n_hooks["List hooks<br/>interaction hooks<br/>[usePagination.jsx]"]
  node_n_utils["Helpers<br/>utility layer<br/>[helpers.jsx]"]
end

subgraph group_g_infra["Infrastructure"]
  node_n_api[("API service<br/>external backend boundary<br/>[api.jsx]")]
  node_n_deploy["Build & deploy<br/>frontend tooling<br/>[vite.config.js]"]
end

node_n_main -->|"bootstraps"| node_n_app
node_n_app -->|"provides session"| node_n_auth
node_n_app -->|"provides shared state"| node_n_appctx
node_n_app -->|"guards routes"| node_n_protected
node_n_app -->|"renders shell"| node_n_navbar
node_n_app -->|"renders shell"| node_n_sidebar
node_n_app -->|"routes to"| node_n_landing
node_n_app -->|"routes to"| node_n_login
node_n_app -->|"routes to"| node_n_dashboard
node_n_app -->|"routes to"| node_n_clientes
node_n_app -->|"routes to"| node_n_sedes
node_n_app -->|"routes to"| node_n_equipos
node_n_app -->|"routes to"| node_n_servicios
node_n_app -->|"routes to"| node_n_solicitudes
node_n_app -->|"routes to"| node_n_tecnicos
node_n_app -->|"routes to"| node_n_calendario
node_n_app -->|"routes to"| node_n_reportes
node_n_app -->|"routes to"| node_n_cliente_dash
node_n_app -->|"routes to"| node_n_mis_sedes
node_n_app -->|"routes to"| node_n_mis_trabajos
node_n_app -->|"routes to"| node_n_editar_equipo
node_n_app -->|"routes to"| node_n_ficha_equipo
node_n_clientes -->|"opens"| node_n_modals
node_n_sedes -->|"opens"| node_n_modals
node_n_equipos -->|"opens"| node_n_modals
node_n_solicitudes -->|"opens"| node_n_modals
node_n_tecnicos -->|"shows"| node_n_widgets
node_n_calendario -->|"shows"| node_n_widgets
node_n_equipos -->|"shows"| node_n_widgets
node_n_clientes -->|"uses"| node_n_hooks
node_n_sedes -->|"uses"| node_n_hooks
node_n_equipos -->|"uses"| node_n_hooks
node_n_solicitudes -->|"uses"| node_n_hooks
node_n_appctx -->|"syncs with"| node_n_api
node_n_auth -->|"authenticates via"| node_n_api
node_n_clientes -->|"loads data"| node_n_api
node_n_sedes -->|"loads data"| node_n_api
node_n_equipos -->|"loads data"| node_n_api
node_n_solicitudes -->|"loads data"| node_n_api
node_n_tecnicos -->|"loads data"| node_n_api
node_n_calendario -->|"loads data"| node_n_api
node_n_reportes -->|"loads data"| node_n_api
node_n_loading -->|"wraps requests"| node_n_api
node_n_modals -->|"submits actions"| node_n_api
node_n_utils -->|"formats payloads"| node_n_api
node_n_deploy -.->|"builds"| node_n_app
node_n_deploy -.->|"serves styles"| node_n_styles

click node_n_main "https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/main.jsx"
click node_n_app "https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/App.jsx"
click node_n_styles "https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/App.css"
click node_n_auth "https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/context/AuthContext.jsx"
click node_n_protected "https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/components/ProtectedRoute.jsx"
click node_n_appctx "https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/context/AppContext.jsx"
click node_n_hooks "https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/hooks/usePagination.jsx"
click node_n_utils "https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/utils/helpers.jsx"
click node_n_api "https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/services/api.jsx"
click node_n_landing "https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/pages/landing/Inicio.jsx"
click node_n_login "https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/pages/Login.jsx"
click node_n_dashboard "https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/pages/Dashboard.jsx"
click node_n_clientes "https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/pages/Clientes.jsx"
click node_n_sedes "https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/pages/Sedes.jsx"
click node_n_equipos "https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/pages/Equipos.jsx"
click node_n_servicios "https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/pages/Servicios.jsx"
click node_n_solicitudes "https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/pages/Solicitudes.jsx"
click node_n_tecnicos "https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/pages/Tecnicos.jsx"
click node_n_calendario "https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/pages/Calendario.jsx"
click node_n_reportes "https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/pages/Reportes.jsx"
click node_n_cliente_dash "https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/pages/clientes-pages/ClienteDashboad.jsx"
click node_n_mis_sedes "https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/pages/clientes-pages/MisSedes.jsx"
click node_n_mis_trabajos "https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/pages/tecnico-pages/MisTrabajos.jsx"
click node_n_editar_equipo "https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/pages/equipos-pages/EditarEquipo.jsx"
click node_n_ficha_equipo "https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/pages/equipos-pages/FichaTecnicaEquipo.jsx"
click node_n_navbar "https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/components/Navbar.jsx"
click node_n_sidebar "https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/components/Sidebar.jsx"
click node_n_widgets "https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/components/WidgetTecnico.jsx"
click node_n_modals "https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/components/SolicitudModal.jsx"
click node_n_loading "https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/components/Loading.jsx"
click node_n_deploy "https://github.com/matiaspallero/sistema-web-instalar/blob/main/vite.config.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_n_main,node_n_app,node_n_styles toneBlue
class node_n_auth,node_n_protected toneAmber
class node_n_landing,node_n_login,node_n_dashboard,node_n_clientes,node_n_sedes,node_n_equipos,node_n_servicios,node_n_solicitudes,node_n_tecnicos,node_n_calendario,node_n_reportes,node_n_cliente_dash,node_n_mis_sedes,node_n_mis_trabajos,node_n_editar_equipo,node_n_ficha_equipo toneMint
class node_n_navbar,node_n_sidebar,node_n_widgets,node_n_modals,node_n_loading toneRose
class node_n_appctx,node_n_hooks,node_n_utils toneIndigo
class node_n_api,node_n_deploy toneTeal
```

## Components

### App shell

Bootstrapping, routing, and global UI framing.

- [main](https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/main.jsx): bootstrap · Application entry point that mounts the React app. · `src/main.jsx`
- [App](https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/App.jsx): composition root · Wires routing, providers, and the overall application frame. · `src/App.jsx`
- [Global styles](https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/App.css): style system · Base CSS and theme styling for the SPA. · `src/App.css`

### Access layer

Authentication and route protection.

- [Auth context](https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/context/AuthContext.jsx): session state · Holds authentication state for the whole app. · `src/context/AuthContext.jsx`
- [Protected route](https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/components/ProtectedRoute.jsx): route guard · Blocks access to role-restricted screens. · `src/components/ProtectedRoute.jsx`

### Pages

Top-level route targets and role-specific screens.

- [Inicio](https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/pages/landing/Inicio.jsx): public page · Public landing page for the application. · `src/pages/landing/Inicio.jsx`
- [Login](https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/pages/Login.jsx): auth page · Sign-in entry point for authenticated access. · `src/pages/Login.jsx`
- [Dashboard](https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/pages/Dashboard.jsx): ops dashboard · Main authenticated overview for operational users. · `src/pages/Dashboard.jsx`
- [Clientes](https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/pages/Clientes.jsx): customer management · Manages customer organizations and their records. · `src/pages/Clientes.jsx`
- [Sedes](https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/pages/Sedes.jsx): site management · Manages client locations and site records. · `src/pages/Sedes.jsx`
- [Equipos](https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/pages/Equipos.jsx): asset management · Manages equipment assets and technical records. · `src/pages/Equipos.jsx`
- [Servicios](https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/pages/Servicios.jsx): service catalog · Handles services and operational service records. · `src/pages/Servicios.jsx`
- [Solicitudes](https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/pages/Solicitudes.jsx): request workflow · Tracks service requests and request processing. · `src/pages/Solicitudes.jsx`
- [Técnicos](https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/pages/Tecnicos.jsx): workforce management · Manages technicians and assignment capacity. · `src/pages/Tecnicos.jsx`
- [Calendario](https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/pages/Calendario.jsx): schedule view · Operational calendar for maintenance planning. · `src/pages/Calendario.jsx`
- [Reportes](https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/pages/Reportes.jsx): analytics page · Reporting and operational summaries. · `src/pages/Reportes.jsx`
- [Cliente dashboard](https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/pages/clientes-pages/ClienteDashboad.jsx): client portal · Client-facing overview of their account and operations. · `src/pages/clientes-pages/ClienteDashboad.jsx`
- [Mis sedes](https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/pages/clientes-pages/MisSedes.jsx): client portal · Client view for their sites and related actions. · `src/pages/clientes-pages/MisSedes.jsx`
- [Mis trabajos](https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/pages/tecnico-pages/MisTrabajos.jsx): tech queue · Technician work queue and assigned jobs. · `src/pages/tecnico-pages/MisTrabajos.jsx`
- [Editar equipo](https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/pages/equipos-pages/EditarEquipo.jsx): asset workflow · Equipment edit workflow for operational changes. · `src/pages/equipos-pages/EditarEquipo.jsx`
- [Ficha técnica](https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/pages/equipos-pages/FichaTecnicaEquipo.jsx): asset detail · Detailed technical record for an equipment asset. · `src/pages/equipos-pages/FichaTecnicaEquipo.jsx`

### Domain UI

Reusable domain widgets and workflow modals.

- [Navbar](https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/components/Navbar.jsx): shell component · Top navigation used across authenticated views. · `src/components/Navbar.jsx`
- [Sidebar](https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/components/Sidebar.jsx): shell component · Primary navigation for the operational console. · `src/components/Sidebar.jsx`
- [Domain widgets](https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/components/WidgetTecnico.jsx): dashboard widgets · Reusable operational widgets such as technician cards, schedules, and histories. · `src/components/WidgetTecnico.jsx`
- [Workflow modals](https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/components/SolicitudModal.jsx): overlay workflows · Modals for requests, assignments, confirmations, and forms. · `src/components/SolicitudModal.jsx`
- [Feedback UI](https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/components/Loading.jsx): utility components · Loading and notification primitives for user feedback. · `src/components/Loading.jsx`

### State and helpers

Shared context, hooks, and utilities.

- [App context](https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/context/AppContext.jsx): shared state · Coordinates cross-page business state and refresh flows. · `src/context/AppContext.jsx`
- [List hooks](https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/hooks/usePagination.jsx): interaction hooks · Shared search, pagination, and layout helpers for page interactions. · `src/hooks/usePagination.jsx`
- [Helpers](https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/utils/helpers.jsx): utility layer · Shared formatting and business helper functions. · `src/utils/helpers.jsx`

### Infrastructure

External API boundary and build/deploy setup.

- [API service](https://github.com/matiaspallero/sistema-web-instalar/blob/main/src/services/api.jsx): external backend boundary · Single frontend integration point for authentication and domain workflows. · `src/services/api.jsx`
- [Build & deploy](https://github.com/matiaspallero/sistema-web-instalar/blob/main/vite.config.js): frontend tooling · Vite, Tailwind, and static hosting configuration for the SPA. · `vite.config.js`

## Connections

- main → App: bootstraps · Mounts the root application component.
- App → Auth context: provides session · Wraps the app with authentication state.
- App → App context: provides shared state · Shares cross-page operational state.
- App → Protected route: guards routes · Applies access control to restricted screens.
- App → Navbar: renders shell · Uses the top-level navigation frame.
- App → Sidebar: renders shell · Uses the primary navigation sidebar.
- App → Inicio: routes to · Public entry page.
- App → Login: routes to · Authentication entry page.
- App → Dashboard: routes to · Authenticated overview page.
- App → Clientes: routes to · Customer management page.
- App → Sedes: routes to · Site management page.
- App → Equipos: routes to · Asset management page.
- App → Servicios: routes to · Service management page.
- App → Solicitudes: routes to · Request workflow page.
- App → Técnicos: routes to · Technician management page.
- App → Calendario: routes to · Scheduling page.
- App → Reportes: routes to · Reporting page.
- App → Cliente dashboard: routes to · Client portal dashboard.
- App → Mis sedes: routes to · Client portal site view.
- App → Mis trabajos: routes to · Technician work queue.
- App → Editar equipo: routes to · Equipment edit workflow.
- App → Ficha técnica: routes to · Equipment detail workflow.
- Clientes → Workflow modals: opens · Uses overlays for create and edit actions.
- Sedes → Workflow modals: opens · Uses overlays for site-related requests.
- Equipos → Workflow modals: opens · Uses overlays for equipment workflows.
- Solicitudes → Workflow modals: opens · Uses overlays for assignment and request handling.
- Técnicos → Domain widgets: shows · Uses technician-focused widgets.
- Calendario → Domain widgets: shows · Uses schedule widgets.
- Equipos → Domain widgets: shows · Uses equipment history and detail widgets.
- Clientes → List hooks: uses · Reuses search and pagination behavior.
- Sedes → List hooks: uses · Reuses search and pagination behavior.
- Equipos → List hooks: uses · Reuses search and pagination behavior.
- Solicitudes → List hooks: uses · Reuses search and pagination behavior.
- App context → API service: syncs with · Fetches and refreshes shared business data.
- Auth context → API service: authenticates via · Delegates login/session operations to the backend boundary.
- Clientes → API service: loads data · Reads and updates customer records.
- Sedes → API service: loads data · Reads and updates site records.
- Equipos → API service: loads data · Reads and updates equipment records.
- Solicitudes → API service: loads data · Submits and processes requests.
- Técnicos → API service: loads data · Reads technician and assignment data.
- Calendario → API service: loads data · Fetches schedule information.
- Reportes → API service: loads data · Fetches reporting data.
- Feedback UI → API service: wraps requests · Surfaces async state around backend calls.
- Workflow modals → API service: submits actions · Creates, assigns, confirms, and updates operational records.
- Helpers → API service: formats payloads · Supports data transformation around API interactions.
- Build & deploy → App: builds · Build and deployment tooling package the SPA.
- Build & deploy → Global styles: serves styles · Front-end toolchain handles CSS delivery.
