https://github.com/eddiedev14/quantyx
Quantyx — Quantitative analytics for tracking, measuring and understanding operational performance.
https://github.com/eddiedev14/quantyx
axios json-server react react-hook-form react-router shadcn-ui
Last synced: 22 days ago
JSON representation
Quantyx — Quantitative analytics for tracking, measuring and understanding operational performance.
- Host: GitHub
- URL: https://github.com/eddiedev14/quantyx
- Owner: eddiedev14
- License: mit
- Created: 2026-01-23T18:08:05.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-02-03T14:53:00.000Z (5 months ago)
- Last Synced: 2026-02-04T04:37:28.696Z (5 months ago)
- Topics: axios, json-server, react, react-hook-form, react-router, shadcn-ui
- Language: TypeScript
- Homepage:
- Size: 327 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Quantyx
> **Quantyx** — Quantitative analytics for tracking, measuring and understanding operational performance.
---
## 📌 Descripción
**Quantyx** es una aplicación web enfocada en la **gestión, análisis y visualización de métricas operativas**. El proyecto permite registrar datos medibles (métricas), analizarlos en el tiempo y obtener información útil a partir de cálculos agregados, tendencias y comparaciones.
Su objetivo principal es **convertir datos crudos en información accionable**, simulando un entorno real de producto donde se consumen datos desde una API y se procesan en el frontend.
Este proyecto está pensado como un ejercicio práctico para trabajar con:
* Consumo de APIs
* Manejo de estado
* Cálculo de métricas derivadas
* Arquitectura frontend moderna
---
## 🎯 Objetivo del proyecto
* Centralizar métricas operativas en un solo lugar
* Simular un flujo real de datos usando una **API fake**
* Transformar datos simples en métricas calculadas
* Practicar una arquitectura frontend escalable
---
## 🧠 ¿Qué tipo de datos maneja?
Quantyx trabaja con métricas numéricas asociadas a:
* Un nombre
* Un valor
* Una categoría
* Una fecha o período
A partir de estos datos se generan:
* Promedios
* Totales
* Tendencias básicas
---
## 🔌 API Fake
El proyecto utiliza una **API fake con JSON Server** para simular un backend real.
Esta API se encarga de:
* Almacenar métricas
* Proveer datos históricos
* Permitir crear, leer y eliminar registros
Esto permite desarrollar el frontend como si estuviera conectado a un backend real.
---
## 📄 Páginas principales
La aplicación se compone de varias páginas orientadas a:
* Visualizar métricas
* Analizar datos agregados
* Consultar históricos
* Obtener resúmenes generales
> La estructura visual y de UI se define dentro del desarrollo del proyecto.
---
## 🛠️ Tecnologías
* **Vite** — entorno de desarrollo
* **Bun** — runtime y gestor de dependencias
* **TypeScript**
* **JSON Server** — API fake
---
## ⚙️ Instalación
### 1️⃣ Clonar el repositorio
```bash
git clone https://github.com/tu-usuario/quantyx.git
cd quantyx
```
### 2️⃣ Instalar dependencias
```bash
bun install
```
### 3️⃣ Ejecutar el proyecto
```bash
bun run dev
```
Vite iniciará el servidor de desarrollo.
---
## ▶️ Ejecutar la API fake
En una terminal aparte:
```bash
bun run server
```
La API estará disponible para ser consumida por la aplicación.
---
## 📄 Licencia
MIT