# adrianestebanvelascoobando956-del/metodo architecture

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

- Interactive diagram: https://gitdiagram.com/adrianestebanvelascoobando956-del/metodo
- Repository: https://github.com/adrianestebanvelascoobando956-del/metodo

## Overview

1. **Propósito general**
   - Este repositorio es un **dashboard de métodos numéricos** hecho en **React** y empaquetado con **Vite**. La app está orientada a resolver ecuaciones, comparar métodos, visualizar funciones y exportar resultados.

2. **Punto de entrada y shell de la aplicación**
   - `src/main.jsx` arranca la aplicación React.
   - `src/App.jsx` actúa como contenedor principal de la UI y normalmente coordina la navegación interna entre vistas como teoría, métodos, comparación, historial y calculadora.

3. **Organización por vistas**
   - La carpeta `src/components/Views` separa la experiencia en pantallas funcionales:
     - `TheoryView.jsx`: contenido explicativo de cada método.
     - `MethodsView.jsx`: ejecución principal de métodos numéricos.
     - `ComparisonView.jsx`: contraste de desempeño/resultado entre métodos.
     - `HistoryView.jsx`: registro de cálculos previos.
   - Esto sugiere una arquitectura de dashboard con cambio de secciones dentro de una sola SPA, no varias páginas independientes.

4. **Flujo principal de cálculo**
   - El usuario ingresa una función y parámetros numéricos.
   - Esa información pasa a la capa de lógica en `src/utils/solver.js` y a los métodos concretos en `src/utils/methods/`.
   - El resultado vuelve a la UI como aproximación, número de iteraciones, error y tabla de progreso.

5. **Implementación de métodos numéricos**
   - `src/utils/methods/` contiene las implementaciones algorítmicas:
     - `bisection.js`
     - `falsePosition.js`
     - `newtonRaphson.js`
     - `secant.js`
     - `horner.js`
     - `hornerSecant.js`
   - Esta carpeta es el núcleo computacional del proyecto y está separada de la UI para mantener los algoritmos reutilizables y comparables.

6. **Capa de cálculo y evaluación matemática**
   - `src/utils/mathService.js` y `src/utils/solver.js` probablemente centralizan la evaluación de expresiones, validación de entradas y la orquestación entre métodos.
   - Esta capa funciona como puente entre texto matemático del usuario y los algoritmos numéricos.

7. **Componentes de visualización**
   - `src/components/Charts/FunctionPlot.jsx` representa gráficamente la función evaluada.
   - La gráfica depende de los valores de entrada y del rango analizado, por lo que es una salida derivada del motor de cálculo, no una fuente de verdad independiente.

8. **Tablas e ինտերacciones de iteración**
   - `src/components/Methods/IterationTable.jsx` muestra el detalle iterativo de cada método.
   - Esta tabla es una pieza clave para entender convergencia, error por iteración y comparación entre técnicas.

9. **Calculadora integrada**
   - `src/components/Calculator/MathCalculator.jsx` ofrece una herramienta auxiliar para operaciones rápidas dentro del mismo dashboard.
   - Funciona como una utilidad complementaria al flujo principal de resolución numérica.

10. **Comparación, historial y exportación**
   - La presencia de `ComparisonView`, `HistoryView` y `src/utils/exportService.js` indica tres capacidades de soporte:
     - comparar métodos sobre el mismo problema,
     - conservar o revisar cálculos previos,
     - exportar tablas/resultados fuera de la app.
   - Esto sugiere un flujo de datos centrado en resultados estructurados, no solo visualización.

11. **Estilo y construcción**
   - El proyecto usa **Tailwind CSS** (`tailwind.config.js`, `postcss.config.js`) para el diseño.
   - `dist/` contiene el build generado por Vite, incluyendo assets empaquetados para producción.
   - `index.html` y `vite.config.js` son la base del entorno de desarrollo y del bundle final.

12. **Arquitectura resumida**
   - La separación principal es:
     - **UI React** en `src/components` y `src/App.jsx`
     - **Lógica numérica** en `src/utils/methods`, `solver.js` y `mathService.js`
     - **Presentación de resultados** en gráficas, tablas, historial y exportación
   - En términos de diagramación, el sistema es un SPA con un núcleo de cómputo matemático desacoplado de la capa visual.

Main entry points: [`src/utils/solver.js`](https://github.com/adrianestebanvelascoobando956-del/metodo/blob/main/src/utils/solver.js) (Solver), [`src/App.jsx`](https://github.com/adrianestebanvelascoobando956-del/metodo/blob/main/src/App.jsx) (App Shell), [`src/components/Views/MethodsView.jsx`](https://github.com/adrianestebanvelascoobando956-del/metodo/blob/main/src/components/Views/MethodsView.jsx) (Methods View), [`src/components/Views/ComparisonView.jsx`](https://github.com/adrianestebanvelascoobando956-del/metodo/blob/main/src/components/Views/ComparisonView.jsx) (Compare View)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_group_ui["UI"]
  node_node_app["App Shell<br/>spa shell<br/>[App.jsx]"]
  node_node_methods_view["Methods View<br/>[MethodsView.jsx]"]
  node_node_theory_view["Theory View<br/>[TheoryView.jsx]"]
  node_node_compare_view["Compare View<br/>[ComparisonView.jsx]"]
  node_node_history_view["History View<br/>[HistoryView.jsx]"]
  node_node_math_calc["Calculator<br/>utility UI<br/>[MathCalculator.jsx]"]
  node_node_function_plot(("Function Plot<br/>visualization<br/>[FunctionPlot.jsx]"))
  node_node_iteration_table["Iteration Table<br/>results table<br/>[IterationTable.jsx]"]
end

subgraph group_group_core["Numerics"]
  node_node_solver{{"Solver<br/>orchestrator<br/>[solver.js]"}}
  node_node_math_service["Math Service<br/>expression engine<br/>[mathService.js]"]
  node_node_bisection["Bisection<br/>root-finding<br/>[bisection.js]"]
  node_node_false_position["False Position<br/>root-finding<br/>[falsePosition.js]"]
  node_node_newton["Newton-Raphson<br/>root-finding<br/>[newtonRaphson.js]"]
  node_node_secant["Secant<br/>root-finding<br/>[secant.js]"]
  node_node_horner["Horner<br/>polynomial<br/>[horner.js]"]
  node_node_horner_secant["Horner-Secant<br/>hybrid method<br/>[hornerSecant.js]"]
  node_node_export_service["Export Service<br/>output service<br/>[exportService.js]"]
end

subgraph group_group_build["Build"]
  node_node_main["Main<br/>entry<br/>[main.jsx]"]
  node_node_tailwind["Tailwind<br/>styling config<br/>[tailwind.config.js]"]
  node_node_vite["Vite Config<br/>build config<br/>[vite.config.js]"]
  node_node_index_html["HTML Entry<br/>html shell<br/>[index.html]"]
end

node_node_main -->|"mounts"| node_node_app
node_node_app -->|"navigates"| node_node_methods_view
node_node_app -->|"navigates"| node_node_theory_view
node_node_app -->|"navigates"| node_node_compare_view
node_node_app -->|"navigates"| node_node_history_view
node_node_app -->|"includes"| node_node_math_calc
node_node_methods_view -->|"calls"| node_node_solver
node_node_methods_view -->|"renders"| node_node_function_plot
node_node_methods_view -->|"shows"| node_node_iteration_table
node_node_compare_view -->|"reuses"| node_node_solver
node_node_history_view -.->|"shares"| node_node_export_service
node_node_solver -->|"evaluates"| node_node_math_service
node_node_solver -->|"selects"| node_node_bisection
node_node_solver -->|"selects"| node_node_false_position
node_node_solver -->|"selects"| node_node_newton
node_node_solver -->|"selects"| node_node_secant
node_node_solver -->|"selects"| node_node_horner
node_node_solver -->|"selects"| node_node_horner_secant
node_node_solver -->|"exports"| node_node_export_service
node_node_vite -->|"serves"| node_node_index_html
node_node_tailwind -.->|"styles"| node_node_app

click node_node_main "https://github.com/adrianestebanvelascoobando956-del/metodo/blob/main/src/main.jsx"
click node_node_app "https://github.com/adrianestebanvelascoobando956-del/metodo/blob/main/src/App.jsx"
click node_node_methods_view "https://github.com/adrianestebanvelascoobando956-del/metodo/blob/main/src/components/Views/MethodsView.jsx"
click node_node_theory_view "https://github.com/adrianestebanvelascoobando956-del/metodo/blob/main/src/components/Views/TheoryView.jsx"
click node_node_compare_view "https://github.com/adrianestebanvelascoobando956-del/metodo/blob/main/src/components/Views/ComparisonView.jsx"
click node_node_history_view "https://github.com/adrianestebanvelascoobando956-del/metodo/blob/main/src/components/Views/HistoryView.jsx"
click node_node_math_calc "https://github.com/adrianestebanvelascoobando956-del/metodo/blob/main/src/components/Calculator/MathCalculator.jsx"
click node_node_function_plot "https://github.com/adrianestebanvelascoobando956-del/metodo/blob/main/src/components/Charts/FunctionPlot.jsx"
click node_node_iteration_table "https://github.com/adrianestebanvelascoobando956-del/metodo/blob/main/src/components/Methods/IterationTable.jsx"
click node_node_solver "https://github.com/adrianestebanvelascoobando956-del/metodo/blob/main/src/utils/solver.js"
click node_node_math_service "https://github.com/adrianestebanvelascoobando956-del/metodo/blob/main/src/utils/mathService.js"
click node_node_bisection "https://github.com/adrianestebanvelascoobando956-del/metodo/blob/main/src/utils/methods/bisection.js"
click node_node_false_position "https://github.com/adrianestebanvelascoobando956-del/metodo/blob/main/src/utils/methods/falsePosition.js"
click node_node_newton "https://github.com/adrianestebanvelascoobando956-del/metodo/blob/main/src/utils/methods/newtonRaphson.js"
click node_node_secant "https://github.com/adrianestebanvelascoobando956-del/metodo/blob/main/src/utils/methods/secant.js"
click node_node_horner "https://github.com/adrianestebanvelascoobando956-del/metodo/blob/main/src/utils/methods/horner.js"
click node_node_horner_secant "https://github.com/adrianestebanvelascoobando956-del/metodo/blob/main/src/utils/methods/hornerSecant.js"
click node_node_export_service "https://github.com/adrianestebanvelascoobando956-del/metodo/blob/main/src/utils/exportService.js"
click node_node_tailwind "https://github.com/adrianestebanvelascoobando956-del/metodo/blob/main/tailwind.config.js"
click node_node_vite "https://github.com/adrianestebanvelascoobando956-del/metodo/blob/main/vite.config.js"
click node_node_index_html "https://github.com/adrianestebanvelascoobando956-del/metodo/blob/main/index.html"

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_node_app,node_node_methods_view,node_node_theory_view,node_node_compare_view,node_node_history_view,node_node_math_calc,node_node_function_plot,node_node_iteration_table toneBlue
class node_node_solver,node_node_math_service,node_node_bisection,node_node_false_position,node_node_newton,node_node_secant,node_node_horner,node_node_horner_secant,node_node_export_service toneAmber
class node_node_main,node_node_tailwind,node_node_vite,node_node_index_html toneMint
```

## Components

### UI

React application shell, views, and presentation components.

- [App Shell](https://github.com/adrianestebanvelascoobando956-del/metodo/blob/main/src/App.jsx): spa shell · Top-level container coordinating the dashboard views. · `src/App.jsx`
- [Methods View](https://github.com/adrianestebanvelascoobando956-del/metodo/blob/main/src/components/Views/MethodsView.jsx): view · Primary workspace for running numerical methods. · `src/components/Views/MethodsView.jsx`
- [Theory View](https://github.com/adrianestebanvelascoobando956-del/metodo/blob/main/src/components/Views/TheoryView.jsx): view · Explains the numerical methods and concepts. · `src/components/Views/TheoryView.jsx`
- [Compare View](https://github.com/adrianestebanvelascoobando956-del/metodo/blob/main/src/components/Views/ComparisonView.jsx): view · Contrasts results and performance across methods. · `src/components/Views/ComparisonView.jsx`
- [History View](https://github.com/adrianestebanvelascoobando956-del/metodo/blob/main/src/components/Views/HistoryView.jsx): view · Displays previously computed runs and results. · `src/components/Views/HistoryView.jsx`
- [Calculator](https://github.com/adrianestebanvelascoobando956-del/metodo/blob/main/src/components/Calculator/MathCalculator.jsx): utility UI · Auxiliary calculator embedded in the dashboard. · `src/components/Calculator/MathCalculator.jsx`
- [Function Plot](https://github.com/adrianestebanvelascoobando956-del/metodo/blob/main/src/components/Charts/FunctionPlot.jsx): visualization · Plots the evaluated function over the chosen range. · `src/components/Charts/FunctionPlot.jsx`
- [Iteration Table](https://github.com/adrianestebanvelascoobando956-del/metodo/blob/main/src/components/Methods/IterationTable.jsx): results table · Shows iteration-by-iteration convergence details. · `src/components/Methods/IterationTable.jsx`

### Numerics

Math evaluation, solver orchestration, and method implementations.

- [Solver](https://github.com/adrianestebanvelascoobando956-del/metodo/blob/main/src/utils/solver.js): orchestrator · Coordinates inputs, validation, and method execution. · `src/utils/solver.js`
- [Math Service](https://github.com/adrianestebanvelascoobando956-del/metodo/blob/main/src/utils/mathService.js): expression engine · Evaluates mathematical expressions and supports input handling. · `src/utils/mathService.js`
- [Bisection](https://github.com/adrianestebanvelascoobando956-del/metodo/blob/main/src/utils/methods/bisection.js): root-finding · Bisection method implementation. · `src/utils/methods/bisection.js`
- [False Position](https://github.com/adrianestebanvelascoobando956-del/metodo/blob/main/src/utils/methods/falsePosition.js): root-finding · False-position method implementation. · `src/utils/methods/falsePosition.js`
- [Newton-Raphson](https://github.com/adrianestebanvelascoobando956-del/metodo/blob/main/src/utils/methods/newtonRaphson.js): root-finding · Newton-Raphson method implementation. · `src/utils/methods/newtonRaphson.js`
- [Secant](https://github.com/adrianestebanvelascoobando956-del/metodo/blob/main/src/utils/methods/secant.js): root-finding · Secant method implementation. · `src/utils/methods/secant.js`
- [Horner](https://github.com/adrianestebanvelascoobando956-del/metodo/blob/main/src/utils/methods/horner.js): polynomial · Horner evaluation implementation. · `src/utils/methods/horner.js`
- [Horner-Secant](https://github.com/adrianestebanvelascoobando956-del/metodo/blob/main/src/utils/methods/hornerSecant.js): hybrid method · Hybrid Horner/Secant implementation. · `src/utils/methods/hornerSecant.js`
- [Export Service](https://github.com/adrianestebanvelascoobando956-del/metodo/blob/main/src/utils/exportService.js): output service · Exports tables and results outside the app. · `src/utils/exportService.js`

### Build

Vite/Tailwind app entry and production bundling setup.

- [Main](https://github.com/adrianestebanvelascoobando956-del/metodo/blob/main/src/main.jsx): entry · Bootstraps the React app. · `src/main.jsx`
- [Tailwind](https://github.com/adrianestebanvelascoobando956-del/metodo/blob/main/tailwind.config.js): styling config · Utility-first styling configuration. · `tailwind.config.js`
- [Vite Config](https://github.com/adrianestebanvelascoobando956-del/metodo/blob/main/vite.config.js): build config · Vite development and production build configuration. · `vite.config.js`
- [HTML Entry](https://github.com/adrianestebanvelascoobando956-del/metodo/blob/main/index.html): html shell · Root HTML document for the app. · `index.html`

## Connections

- Main → App Shell: mounts · Initializes the React application shell.
- App Shell → Methods View: navigates · Switches to the methods workspace.
- App Shell → Theory View: navigates · Switches to explanatory content.
- App Shell → Compare View: navigates · Switches to comparison mode.
- App Shell → History View: navigates · Switches to history mode.
- App Shell → Calculator: includes · Embeds the auxiliary calculator.
- Methods View → Solver: calls · Sends user inputs to the numerical engine.
- Methods View → Function Plot: renders · Displays the function visualization.
- Methods View → Iteration Table: shows · Presents convergence details and iteration data.
- Compare View → Solver: reuses · Runs multiple methods on the same problem.
- History View → Export Service: shares · Uses stored results for export or review.
- Solver → Math Service: evaluates · Delegates expression parsing and function evaluation.
- Solver → Bisection: selects · Routes to the bisection implementation.
- Solver → False Position: selects · Routes to the false-position implementation.
- Solver → Newton-Raphson: selects · Routes to the Newton-Raphson implementation.
- Solver → Secant: selects · Routes to the secant implementation.
- Solver → Horner: selects · Routes to Horner evaluation.
- Solver → Horner-Secant: selects · Routes to the hybrid Horner-Secant method.
- Solver → Export Service: exports · Formats solved results for download or sharing.
- Vite Config → HTML Entry: serves · Uses the HTML shell as the app entrypoint.
- Tailwind → App Shell: styles · Provides utility styling for the React UI.
