# Sistema de Finanzas del Club Atlético Torino

## Descripción

Se ha implementado un sistema completo de gestión de finanzas que permite a todos los usuarios del sitio web ver de manera transparente los ingresos y egresos del club.

## Características Implementadas

### 1. Modelo de Datos
- **Modelo**: `ClubFinance`
- **Tabla**: `club_finances`
- **Campos principales**:
  - `type`: Tipo de transacción (income/expense)
  - `category`: Categoría de la transacción
  - `description`: Descripción detallada
  - `amount`: Monto de la transacción
  - `date`: Fecha de la transacción
  - `reference`: Referencia o número de comprobante
  - `created_by`: Usuario que registró la transacción

### 2. Categorías Disponibles
- **Ingresos**: donaciones, membresías, eventos, patrocinios
- **Egresos**: equipamiento, mantenimiento, servicios públicos, salarios, transporte, otros

### 3. Vista Pública de Finanzas
- **URL**: `/finances`
- **Acceso**: Público (todos los usuarios pueden ver)
- **Características**:
  - Estadísticas principales (ingresos, egresos, resultado neto)
  - Comparación con donaciones del año
  - Filtros por año y mes
  - Gráficos por categorías
  - Lista detallada de transacciones
  - Paginación de resultados

### 4. Funcionalidades de la Vista

#### Estadísticas Principales
- Total de ingresos del período
- Total de egresos del período
- Resultado neto (ingresos - egresos)
- Total de donaciones del año

#### Filtros
- Filtro por año
- Filtro por mes (opcional)
- Los filtros se aplican automáticamente al cambiar la selección

#### Análisis por Categorías
- Gráficos de barras mostrando distribución de ingresos por categoría
- Gráficos de barras mostrando distribución de egresos por categoría
- Porcentajes de participación de cada categoría

#### Lista de Transacciones
- Tabla detallada con todas las transacciones
- Información de fecha, tipo, categoría, descripción, monto y referencia
- Paginación para manejar grandes volúmenes de datos

### 5. Navegación
- Se agregó un enlace "Finanzas" en el menú principal
- Icono de gráfico de líneas para identificación visual
- Accesible desde cualquier página del sitio

### 6. Datos de Ejemplo
- Se creó un seeder (`ClubFinanceSeeder`) con datos de ejemplo
- Incluye transacciones del año actual y anterior
- Datos realistas de ingresos y egresos típicos de un club deportivo

## Archivos Creados/Modificados

### Nuevos Archivos
1. `app/Models/ClubFinance.php` - Modelo para transacciones financieras
2. `database/migrations/2024_01_01_000004_create_club_finances_table.php` - Migración
3. `app/Http/Controllers/FinanceController.php` - Controlador
4. `resources/views/finance/index.blade.php` - Vista principal
5. `database/seeders/ClubFinanceSeeder.php` - Seeder con datos de ejemplo

### Archivos Modificados
1. `routes/web.php` - Agregadas rutas de finanzas
2. `resources/views/layouts/app.blade.php` - Agregado enlace de navegación
3. `database/seeders/DatabaseSeeder.php` - Incluido nuevo seeder

## Instrucciones de Uso

### Para Administradores (Futuro)
*Nota: La funcionalidad de administración de finanzas no está implementada en esta versión, solo la visualización pública.*

### Para Usuarios
1. Navegar al sitio web del club
2. Hacer clic en "Finanzas" en el menú principal
3. Explorar las estadísticas y transacciones
4. Usar los filtros de año y mes para ver períodos específicos

## Consideraciones Técnicas

### Base de Datos
- La tabla `club_finances` está optimizada con índices en `type`, `date` y `category`
- Relación con la tabla `users` para rastrear quién creó cada transacción

### Rendimiento
- Paginación implementada para manejar grandes volúmenes de datos
- Consultas optimizadas con agregaciones para estadísticas
- Filtros eficientes por fecha

### Seguridad
- Vista pública de solo lectura
- No se exponen datos sensibles
- Validación de datos en el modelo

## Próximos Pasos Sugeridos

1. **Panel de Administración**: Crear interfaz para que administradores puedan agregar/editar transacciones
2. **Reportes**: Implementar generación de reportes PDF
3. **Exportación**: Permitir exportar datos a Excel/CSV
4. **Notificaciones**: Alertas cuando el resultado neto sea negativo
5. **Presupuesto**: Sistema de presupuesto anual con seguimiento
6. **Integración**: Conectar automáticamente las donaciones con el sistema de finanzas

## Transparencia

Este sistema promueve la transparencia financiera del club, permitiendo que todos los socios y simpatizantes puedan ver cómo se utilizan los recursos del club, fomentando la confianza y la participación activa en la gestión del Club Atlético Torino.