# Control de Gastos

Aplicación web multiusuario para registrar, consultar y analizar ingresos, gastos y movimientos recurrentes de forma centralizada. Incluye autenticación por sesión, roles de usuario y panel de administración para aprobar cuentas.

# Tabla de contenidos

• Estado
• Características
• Stack
• Requisitos
• Instalación
• Configuración
• Uso
• Scripts
• Estructura
• Pruebas
• Licencia
• Autor

# Estado

Proyecto en desarrollo activo.

# Características

• Registro e inicio de sesión con sesiones persistentes.
• Aprobación de usuarios desde el panel de administración.
• Dashboard mensual con resumen de ingresos, gastos y balance.
• Gestión de transacciones con filtros y edición individual.
• Plantillas de movimientos recurrentes y generación automática por mes.
• Categorización de gastos con colores e iconos.

# Stack

• Next.js 16 con App Router.
• React 19 y TypeScript.
• Prisma ORM con base de datos MySQL/MariaDB.
• bcryptjs para el hashing de contraseñas.
• Recharts para visualización de datos.
• Tailwind CSS 4 para estilos.

# Requisitos

• Node.js 18 o superior.
• Base de datos MySQL o MariaDB accesible desde DATABASE_URL.
• Instalar dependencias con npm install.

# Instalación

1. Clona el repositorio.
2. Instala dependencias:

npm install

3. Configura la conexión a la base de datos en un archivo .env.
4. Genera el cliente de Prisma y aplica las migraciones:

npx prisma generate
npx prisma migrate dev

# Configuración

Variables mínimas esperadas:

DATABASE_URL="mysql://usuario:contraseña@host:3306/base_de_datos"

Si vas a ejecutar scripts de base de datos o el seed, asegúrate de que esa URL apunte al entorno correcto.

# Uso

Inicia la aplicación en modo desarrollo:

npm run dev

Después abre la app y accede con una cuenta aprobada. Desde la interfaz puedes navegar por:

• Dashboard principal.
• Transacciones.
• Movimientos recurrentes.
• Administración de usuarios, si tu rol es admin.

# Scripts

• npm run dev: arranca el servidor de desarrollo.
• npm run build: compila la aplicación para producción.
• npm run start: ejecuta la build de producción.
• npm run lint: ejecuta ESLint.
• npm run seed: carga datos iniciales en la base de datos.

# Estructura

• src/app: páginas, rutas API y layout principal.
• src/components: componentes reutilizables de la interfaz.
• src/lib: lógica de autenticación, Prisma y generación de movimientos recurrentes.
• prisma/schema.prisma: modelo de datos.
• prisma/seed.ts: datos semilla.

# Pruebas

No hay una suite de tests automatizada declarada en package.json. Como verificación mínima, ejecuta:

npm run lint

Y, si cambias la lógica de datos, valida también las migraciones y el seed contra la base de datos configurada.

# Licencia

Consulta el archivo LICENSE.md para conocer los términos de uso.

# Autor

# Iván Bazaga

Desarrollador frontend con foco en aplicaciones web modernas y experiencia práctica con ecosistemas JavaScript.

# Contacto