60 lines
2.3 KiB
Markdown
Executable File
60 lines
2.3 KiB
Markdown
Executable File
# Sistema de Comisiones y Gastos
|
|
|
|
Aplicación Laravel para control de ingresos por comisiones y gastos personales con soporte multiusuario y bot de Telegram integrado.
|
|
|
|
## Características
|
|
|
|
- **Gestión de Comisiones**: Registro y cálculo automático de comisiones por ventas
|
|
- **Control de Gastos**: Seguimiento de gastos personales con categorización (quincena 1, quincena 2, mensual)
|
|
- **Cálculo de ISR**: Descuento automático de ISR basado en tablas configurables por año
|
|
- **Calendario Visual**: Visualización de ventas y gastos en un calendario interactivo
|
|
- **Configuración de Usuario**: Porcentaje de comisión, salario base, datos laborales
|
|
- **Datos Laborales**: Fecha de ingreso, razón social, sueldo íntegro diario (para cálculo de vacaciones)
|
|
- **Reporte Quincenal**: Anticipo y liquidación con cálculo de ISR
|
|
- **Reporte Mensual**: Resumen completo con ISR descontado
|
|
- **Bot de Telegram**: Integración para consultar nómina desde Telegram
|
|
- **Interfaz Responsive**: Diseño adaptado para dispositivos móviles
|
|
|
|
## Instalación
|
|
|
|
```bash
|
|
composer install
|
|
cp .env.example .env
|
|
php artisan key:generate
|
|
php artisan migrate
|
|
php artisan serve
|
|
```
|
|
|
|
## Estructura de la Base de Datos
|
|
|
|
- **users**: Usuarios del sistema con configuración de comisiones
|
|
- **months**: Meses del año fiscal (incluye relación con tabla ISR)
|
|
- **daily_sales**: Ventas diarias registradas
|
|
- **expenses**: Gastos personales categorizados
|
|
- **telegram_accounts**: Cuentas de Telegram vinculadas
|
|
- **isr_tables**: Tablas de ISR por año
|
|
- **isr_brackets**: Rangos/buckets de cada tabla ISR
|
|
|
|
## Rutas Principales
|
|
|
|
- `/dashboard` - Panel principal
|
|
- `/calendar` - Calendario de ventas y gastos
|
|
- `/sales` - Gestión de ventas
|
|
- `/expenses` - Gestión de gastos
|
|
- `/months` - Gestión de meses laborales
|
|
- `/reports/monthly` - Reporte mensual con ISR
|
|
- `/reports/biweekly` - Reporte quincenal con ISR
|
|
- `/settings` - Configuración del usuario y tablas ISR
|
|
|
|
## Cálculo de ISR
|
|
|
|
El sistema calcula el ISR aplicable sobre el ingreso gravable (salario + comisiones):
|
|
|
|
1. Se selecciona una tabla ISR en cada mes (en `/months`)
|
|
2. El ISR mensual se calcula según los rangos de la tabla seleccionada
|
|
3. En quincenas, el ISR se divide por 2 (ISR quincenal = ISR mensual / 2)
|
|
4. El ISR se descuenta del total a pagar
|
|
|
|
## License
|
|
|
|
MIT License |