# osorio621/reaccion-crm-frontend architecture

> Architecture diagram of the GitHub repository osorio621/reaccion-crm-frontend, 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/osorio621/reaccion-crm-frontend
- Repository: https://github.com/osorio621/reaccion-crm-frontend

## Overview

This is a Spanish-language CRM frontend: users sign in, then work across prospects, clients, opportunities and the sales pipeline, with additional visits, follow-ups, sales, reporting and administration areas. React routes expose those workflows; feature pages use domain hooks and API modules, while a shared Axios client manages authenticated requests. The tree and excerpts establish routing and selected data-layer links, but do not expose most feature implementations or backend behavior, so those connections are left out.

Main entry points: [`src/App.jsx`](https://github.com/osorio621/reaccion-crm-frontend/blob/main/src/App.jsx) (Route application), [`src/api/axiosClient.js`](https://github.com/osorio621/reaccion-crm-frontend/blob/main/src/api/axiosClient.js) (HTTP client), [`src/pages/Pipeline/PipelinePage.jsx`](https://github.com/osorio621/reaccion-crm-frontend/blob/main/src/pages/Pipeline/PipelinePage.jsx) (Sales pipeline), [`src/hooks/useClientes.js`](https://github.com/osorio621/reaccion-crm-frontend/blob/main/src/hooks/useClientes.js) (Client data hooks)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_navigation["App navigation"]
  node_app["Route application<br/>[App.jsx]"]
  node_guard["Route protection<br/>[ProtectedRoute.jsx]"]
  node_layout["Main layout<br/>[MainLayout.jsx]"]
  node_login["Sign in<br/>[LoginPage.jsx]"]
end

subgraph group_sales["Sales workflows"]
  node_dashboard["Dashboard<br/>[DashboardPage.jsx]"]
  node_prospects["Prospect management<br/>[ProspectosPage.jsx]"]
  node_opportunities["Opportunity management"]
  node_pipeline["Sales pipeline<br/>[PipelinePage.jsx]"]
  node_kanban["Pipeline board<br/>[KanbanBoard.jsx]"]
  node_visits["Visits<br/>[VisitasPage.jsx]"]
  node_followups["Follow-ups"]
  node_salesrecords["Sales records<br/>[VentasPage.jsx]"]
  node_reports["Reports<br/>[ReportesPage.jsx]"]
end

subgraph group_crm["CRM operations"]
  node_clients["Client management<br/>[ClientesPage.jsx]"]
  node_clientdetail["Client details"]
  node_clientform["Client editor"]
  node_admin["Administration<br/>[AdminPage.jsx]"]
end

subgraph group_data["Data access"]
  node_clienthooks["Client data hooks<br/>[useClientes.js]"]
  node_cataloghooks["Catalog hooks<br/>[useCatalogos.js]"]
  node_opportunityhooks["Opportunity hooks"]
  node_clientapi["Client API<br/>[clientes.api.js]"]
  node_pipelineapi["Pipeline API<br/>[pipeline.api.js]"]
  node_authapi["Authentication API<br/>[auth.api.js]"]
  node_http["HTTP client<br/>[axiosClient.js]"]
end

subgraph group_session["Session and shared state"]
  node_authstore[("Session state<br/>[authStore.js]")]
end

node_user(("CRM user"))
node_backend{{"CRM backend"}}

node_user -->|"opens"| node_app
node_app -->|"routes to"| node_login
node_app -->|"protects routes"| node_guard
node_app -->|"wraps pages"| node_layout
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_pipeline
node_app -->|"routes to"| node_clients
node_app -->|"routes to"| node_clientdetail
node_app -->|"routes to"| node_prospects
node_app -->|"routes to"| node_opportunities
node_app -->|"routes to"| node_visits
node_app -->|"routes to"| node_followups
node_app -->|"routes to"| node_salesrecords
node_app -->|"routes to"| node_reports
node_app -->|"routes to"| node_admin
node_pipeline -->|"renders board"| node_kanban
node_pipeline -->|"loads and updates"| node_opportunityhooks
node_pipeline -->|"loads stages"| node_cataloghooks
node_clients -->|"loads clients"| node_clienthooks
node_clientdetail -->|"loads client data"| node_clienthooks
node_clientform -->|"loads catalogs"| node_cataloghooks
node_clienthooks -->|"calls"| node_clientapi
node_clientapi -->|"uses"| node_http
node_pipelineapi -->|"uses"| node_http
node_authapi -->|"uses"| node_http
node_http -->|"reads and updates tokens"| node_authstore
node_http -.->|"sends requests"| node_backend
node_login -.->|"establishes session"| node_authstore

click node_app "https://github.com/osorio621/reaccion-crm-frontend/blob/main/src/App.jsx"
click node_guard "https://github.com/osorio621/reaccion-crm-frontend/blob/main/src/components/layout/ProtectedRoute.jsx"
click node_layout "https://github.com/osorio621/reaccion-crm-frontend/blob/main/src/components/layout/MainLayout.jsx"
click node_login "https://github.com/osorio621/reaccion-crm-frontend/blob/main/src/pages/Login/LoginPage.jsx"
click node_dashboard "https://github.com/osorio621/reaccion-crm-frontend/blob/main/src/pages/Dashboard/DashboardPage.jsx"
click node_prospects "https://github.com/osorio621/reaccion-crm-frontend/blob/main/src/pages/Prospectos/ProspectosPage.jsx"
click node_opportunities "https://github.com/osorio621/reaccion-crm-frontend/blob/main/src/pages/Oportunidades/OportunidadesPage.jsx"
click node_pipeline "https://github.com/osorio621/reaccion-crm-frontend/blob/main/src/pages/Pipeline/PipelinePage.jsx"
click node_kanban "https://github.com/osorio621/reaccion-crm-frontend/blob/main/src/components/kanban/KanbanBoard.jsx"
click node_visits "https://github.com/osorio621/reaccion-crm-frontend/blob/main/src/pages/Visitas/VisitasPage.jsx"
click node_followups "https://github.com/osorio621/reaccion-crm-frontend/blob/main/src/pages/Seguimientos/SeguimientosPage.jsx"
click node_salesrecords "https://github.com/osorio621/reaccion-crm-frontend/blob/main/src/pages/Ventas/VentasPage.jsx"
click node_reports "https://github.com/osorio621/reaccion-crm-frontend/blob/main/src/pages/Reportes/ReportesPage.jsx"
click node_clients "https://github.com/osorio621/reaccion-crm-frontend/blob/main/src/pages/Clientes/ClientesPage.jsx"
click node_clientdetail "https://github.com/osorio621/reaccion-crm-frontend/blob/main/src/pages/Clientes/ClienteDetallePage.jsx"
click node_clientform "https://github.com/osorio621/reaccion-crm-frontend/blob/main/src/pages/Clientes/ClienteFormModal.jsx"
click node_admin "https://github.com/osorio621/reaccion-crm-frontend/blob/main/src/pages/Admin/AdminPage.jsx"
click node_clienthooks "https://github.com/osorio621/reaccion-crm-frontend/blob/main/src/hooks/useClientes.js"
click node_cataloghooks "https://github.com/osorio621/reaccion-crm-frontend/blob/main/src/hooks/useCatalogos.js"
click node_opportunityhooks "https://github.com/osorio621/reaccion-crm-frontend/blob/main/src/hooks/useOportunidades.js"
click node_clientapi "https://github.com/osorio621/reaccion-crm-frontend/blob/main/src/api/clientes.api.js"
click node_pipelineapi "https://github.com/osorio621/reaccion-crm-frontend/blob/main/src/api/pipeline.api.js"
click node_authapi "https://github.com/osorio621/reaccion-crm-frontend/blob/main/src/api/auth.api.js"
click node_http "https://github.com/osorio621/reaccion-crm-frontend/blob/main/src/api/axiosClient.js"
click node_authstore "https://github.com/osorio621/reaccion-crm-frontend/blob/main/src/store/authStore.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_guard,node_layout,node_login,node_user toneBlue
class node_dashboard,node_prospects,node_opportunities,node_pipeline,node_kanban,node_visits,node_followups,node_salesrecords,node_reports toneAmber
class node_clients,node_clientdetail,node_clientform,node_admin toneMint
class node_clienthooks,node_cataloghooks,node_opportunityhooks,node_clientapi,node_pipelineapi,node_authapi,node_http toneRose
class node_authstore,node_backend toneIndigo
```

## Components

### App navigation

- [Route application](https://github.com/osorio621/reaccion-crm-frontend/blob/main/src/App.jsx): `src/App.jsx`
- [Route protection](https://github.com/osorio621/reaccion-crm-frontend/blob/main/src/components/layout/ProtectedRoute.jsx): `src/components/layout/ProtectedRoute.jsx`
- [Main layout](https://github.com/osorio621/reaccion-crm-frontend/blob/main/src/components/layout/MainLayout.jsx): `src/components/layout/MainLayout.jsx`
- [Sign in](https://github.com/osorio621/reaccion-crm-frontend/blob/main/src/pages/Login/LoginPage.jsx): `src/pages/Login/LoginPage.jsx`

### Sales workflows

- [Dashboard](https://github.com/osorio621/reaccion-crm-frontend/blob/main/src/pages/Dashboard/DashboardPage.jsx): `src/pages/Dashboard/DashboardPage.jsx`
- [Prospect management](https://github.com/osorio621/reaccion-crm-frontend/blob/main/src/pages/Prospectos/ProspectosPage.jsx): `src/pages/Prospectos/ProspectosPage.jsx`
- [Opportunity management](https://github.com/osorio621/reaccion-crm-frontend/blob/main/src/pages/Oportunidades/OportunidadesPage.jsx): `src/pages/Oportunidades/OportunidadesPage.jsx`
- [Sales pipeline](https://github.com/osorio621/reaccion-crm-frontend/blob/main/src/pages/Pipeline/PipelinePage.jsx): `src/pages/Pipeline/PipelinePage.jsx`
- [Pipeline board](https://github.com/osorio621/reaccion-crm-frontend/blob/main/src/components/kanban/KanbanBoard.jsx): `src/components/kanban/KanbanBoard.jsx`
- [Visits](https://github.com/osorio621/reaccion-crm-frontend/blob/main/src/pages/Visitas/VisitasPage.jsx): `src/pages/Visitas/VisitasPage.jsx`
- [Follow-ups](https://github.com/osorio621/reaccion-crm-frontend/blob/main/src/pages/Seguimientos/SeguimientosPage.jsx): `src/pages/Seguimientos/SeguimientosPage.jsx`
- [Sales records](https://github.com/osorio621/reaccion-crm-frontend/blob/main/src/pages/Ventas/VentasPage.jsx): `src/pages/Ventas/VentasPage.jsx`
- [Reports](https://github.com/osorio621/reaccion-crm-frontend/blob/main/src/pages/Reportes/ReportesPage.jsx): `src/pages/Reportes/ReportesPage.jsx`

### CRM operations

- [Client management](https://github.com/osorio621/reaccion-crm-frontend/blob/main/src/pages/Clientes/ClientesPage.jsx): `src/pages/Clientes/ClientesPage.jsx`
- [Client details](https://github.com/osorio621/reaccion-crm-frontend/blob/main/src/pages/Clientes/ClienteDetallePage.jsx): `src/pages/Clientes/ClienteDetallePage.jsx`
- [Client editor](https://github.com/osorio621/reaccion-crm-frontend/blob/main/src/pages/Clientes/ClienteFormModal.jsx): `src/pages/Clientes/ClienteFormModal.jsx`
- [Administration](https://github.com/osorio621/reaccion-crm-frontend/blob/main/src/pages/Admin/AdminPage.jsx): `src/pages/Admin/AdminPage.jsx`

### Data access

- [Client data hooks](https://github.com/osorio621/reaccion-crm-frontend/blob/main/src/hooks/useClientes.js): `src/hooks/useClientes.js`
- [Catalog hooks](https://github.com/osorio621/reaccion-crm-frontend/blob/main/src/hooks/useCatalogos.js): `src/hooks/useCatalogos.js`
- [Opportunity hooks](https://github.com/osorio621/reaccion-crm-frontend/blob/main/src/hooks/useOportunidades.js): `src/hooks/useOportunidades.js`
- [Client API](https://github.com/osorio621/reaccion-crm-frontend/blob/main/src/api/clientes.api.js): `src/api/clientes.api.js`
- [Pipeline API](https://github.com/osorio621/reaccion-crm-frontend/blob/main/src/api/pipeline.api.js): `src/api/pipeline.api.js`
- [Authentication API](https://github.com/osorio621/reaccion-crm-frontend/blob/main/src/api/auth.api.js): `src/api/auth.api.js`
- [HTTP client](https://github.com/osorio621/reaccion-crm-frontend/blob/main/src/api/axiosClient.js): `src/api/axiosClient.js`

### Session and shared state

- [Session state](https://github.com/osorio621/reaccion-crm-frontend/blob/main/src/store/authStore.js): `src/store/authStore.js`

### Other components

- **CRM user**
- **CRM backend**

## Connections

- CRM user → Route application: opens (evidence: `src/App.jsx`)
- Route application → Sign in: routes to (evidence: `src/App.jsx`)
- Route application → Route protection: protects routes (evidence: `src/App.jsx`)
- Route application → Main layout: wraps pages (evidence: `src/App.jsx`)
- Route application → Dashboard: routes to (evidence: `src/App.jsx`)
- Route application → Sales pipeline: routes to (evidence: `src/App.jsx`)
- Route application → Client management: routes to (evidence: `src/App.jsx`)
- Route application → Client details: routes to (evidence: `src/App.jsx`)
- Route application → Prospect management: routes to (evidence: `src/App.jsx`)
- Route application → Opportunity management: routes to (evidence: `src/App.jsx`)
- Route application → Visits: routes to (evidence: `src/App.jsx`)
- Route application → Follow-ups: routes to (evidence: `src/App.jsx`)
- Route application → Sales records: routes to (evidence: `src/App.jsx`)
- Route application → Reports: routes to (evidence: `src/App.jsx`)
- Route application → Administration: routes to (evidence: `src/App.jsx`)
- Sales pipeline → Pipeline board: renders board (evidence: `src/pages/Pipeline/PipelinePage.jsx`)
- Sales pipeline → Opportunity hooks: loads and updates (evidence: `src/pages/Pipeline/PipelinePage.jsx`)
- Sales pipeline → Catalog hooks: loads stages (evidence: `src/pages/Pipeline/PipelinePage.jsx`)
- Client management → Client data hooks: loads clients (evidence: `src/pages/Clientes/ClientesPage.jsx`)
- Client details → Client data hooks: loads client data (evidence: `src/pages/Clientes/ClienteDetallePage.jsx`)
- Client editor → Catalog hooks: loads catalogs (evidence: `src/pages/Clientes/ClienteFormModal.jsx`)
- Client data hooks → Client API: calls (evidence: `src/hooks/useClientes.js`)
- Client API → HTTP client: uses (evidence: `src/api/clientes.api.js`)
- Pipeline API → HTTP client: uses (evidence: `src/api/pipeline.api.js`)
- Authentication API → HTTP client: uses (evidence: `src/api/auth.api.js`)
- HTTP client → Session state: reads and updates tokens (evidence: `src/api/axiosClient.js`)
- HTTP client → CRM backend: sends requests
- Sign in → Session state: establishes session
