Tul xxx Tul

Viewing: README.md

# 🏪 Sistema de Ventas Completo

[![Laravel](https://img.shields.io/badge/Laravel-10.x-red.svg)](https://laravel.com)
[![PHP](https://img.shields.io/badge/PHP-8.1+-blue.svg)](https://php.net)
[![MySQL](https://img.shields.io/badge/MySQL-5.7+-orange.svg)](https://mysql.com)

Sistema completo de gestión empresarial para ventas, inventario, facturación electrónica, contabilidad y control de cajas diarias.

## 📋 Tabla de Contenidos

- [Características](#-características-principales)
- [Requisitos](#-requisitos-del-sistema)
- [Instalación](#-instalación)
- [Configuración](#-configuración)
- [Uso](#-uso)
- [Backups](#-sistema-de-backups)
- [Soporte](#-soporte)

## ✨ Características Principales

### 💰 Gestión de Ventas
- Registro de ventas con múltiples productos
- Descuentos y promociones
- Múltiples métodos de pago (efectivo, tarjeta, crédito)
- Generación automática de facturas
- Anulación de ventas con control de permisos

### 📦 Control de Inventario
- Gestión completa de productos y categorías
- Control de stock por ubicaciones
- Movimientos internos de inventario
- Alertas de stock mínimo
- Equivalencias de productos
- Conversión de unidades de medida

### 🧾 Facturación Electrónica
- Integración con Alegra para facturación DIAN
- Generación de códigos QR
- Envío automático por email
- Historial de facturas procesadas
- Soporte para múltiples impuestos

### 💼 Contabilidad
- Plan de cuentas contable (PUC)
- Comprobantes contables
- Movimientos contables automáticos
- Reportes financieros
- Cierre de periodos contables

### 💵 Cajas Diarias
- Apertura y cierre de cajas
- Control de movimientos (ingresos/egresos)
- Registro de gastos
- Cuadre de caja automático
- Reportes de caja por periodo

### 👥 Gestión de Clientes y Proveedores
- Base de datos completa de clientes
- Gestión de proveedores
- Sincronización con Alegra
- Historial de compras/ventas
- Sistema de créditos y pagos

### 🔐 Seguridad y Permisos
- Sistema de roles y permisos personalizado
- 6 niveles de usuario (Super Admin, Admin, Contador, Secretaria, Técnico, Vendedor)
- Control granular de accesos por módulo
- Auditoría de acciones

### 💾 Sistema de Backups
- Backups automáticos programables
- Compresión automática (ZIP)
- Restauración completa o solo datos
- Envío de backups por email
- Validación con checksums MD5

## 🔧 Requisitos del Sistema

### Software Requerido
- **PHP**: 8.1 o superior
- **MySQL**: 5.7+ o MariaDB 10.3+
- **Composer**: Última versión
- **Servidor Web**: Apache 2.4+ o Nginx

### Extensiones PHP Requeridas
- `php-mbstring`
- `php-xml`
- `php-zip`
- `php-mysql`
- `php-curl`
- `php-gd`
- `php-fileinfo`

### Recomendaciones de Hardware
- **RAM**: Mínimo 2GB, recomendado 4GB+
- **Disco**: Mínimo 1GB libre
- **Procesador**: Dual-core o superior

## 📥 Instalación

### Instalación Completa

Para una guía detallada paso a paso, consulta: **[GUIA_INSTALACION_CLIENTE.md](GUIA_INSTALACION_CLIENTE.md)**

### Instalación Rápida

```bash
# 1. Clonar el repositorio
git clone https://github.com/carval82/ventas_completa.git
cd ventas_completa

# 2. Instalar dependencias
composer install --optimize-autoloader

# 3. Configurar entorno
cp .env.example .env
php artisan key:generate

# 4. Configurar base de datos en .env
# DB_DATABASE=ventas_completa
# DB_USERNAME=root
# DB_PASSWORD=

# 5. Ejecutar migraciones y seeders
php artisan migrate:fresh --seed

# 6. Iniciar servidor de desarrollo
php artisan serve
```

### Credenciales por Defecto
- **Email**: pcapacho24@gmail.com
- **Contraseña**: anaval33

⚠️ **IMPORTANTE**: Cambiar estas credenciales después de la primera instalación.

## ⚙️ Configuración

### Configuración de Alegra (Facturación Electrónica)

1. Inicia sesión como administrador
2. Ve a **Configuración → Empresa**
3. Completa los campos:
   - API Key de Alegra
   - API Token de Alegra
   - Usuario de Alegra
4. Configura la resolución de facturación DIAN

### Configuración de Email

Editar `.env` para configurar el envío de emails (backups, facturas):

```env
MAIL_MAILER=smtp
MAIL_HOST=smtp.gmail.com
MAIL_PORT=587
MAIL_USERNAME=tu_correo@gmail.com
MAIL_PASSWORD=tu_contraseña_app
MAIL_ENCRYPTION=tls
```

## 🚀 Uso

### Comandos Artisan Disponibles

```bash
# Crear backup manual de la base de datos
php artisan backup:database

# Crear backup y enviar por email
php artisan backup:database --send-email

# Restaurar datos desde el backup más reciente
php artisan db:seed --class=RestaurarDatosSeeder

# Limpiar caché del sistema
php artisan optimize:clear

# Ver estado de las migraciones
php artisan migrate:status
```

### Flujo de Trabajo Típico

1. **Configuración Inicial**
   - Crear empresa
   - Configurar comprobantes
   - Crear categorías de productos
   - Crear usuarios

2. **Operación Diaria**
   - Abrir caja
   - Registrar ventas
   - Registrar gastos
   - Cerrar caja

3. **Mantenimiento**
   - Revisar inventario
   - Generar reportes
   - Hacer backups

## 💾 Sistema de Backups

### Backups Automáticos

Configurar tarea programada (cron en Linux o Task Scheduler en Windows):

**Linux (Cron):**
```bash
# Backup diario a las 2 AM
0 2 * * * cd /ruta/al/proyecto && php artisan backup:database
```

**Windows (Task Scheduler):**
```batch
C:\xampp\php\php.exe C:\xampp\htdocs\ventas_completa\artisan backup:database
```

### Restauración de Datos

**Restauración Solo Datos** (Recomendado - preserva estructura actual):
```bash
php artisan db:seed --class=RestaurarDatosSeeder
```

**Restauración Completa** (Restaura estructura + datos):
```bash
# Windows
cmd /c "C:\xampp\mysql\bin\mysql.exe -u root nombre_bd < ruta_backup.sql"

# Linux
mysql -u usuario -p nombre_bd < ruta_backup.sql
```

### Ubicación de Backups
- Ruta: `storage/app/backups/`
- Formato: `YYYY-MM-DD_HH-MM-SS_backup.zip`
- Retención: Últimos 10 backups

## 📊 Módulos del Sistema

| Módulo | Descripción | Permisos Requeridos |
|--------|-------------|---------------------|
| **Ventas** | Registro y gestión de ventas | `ver-ventas`, `crear-ventas` |
| **Inventario** | Control de productos y stock | `ver-productos`, `ajustar-stock` |
| **Clientes** | Gestión de clientes | `ver-clientes`, `crear-clientes` |
| **Cajas** | Control de cajas diarias | `ver-cajas`, `abrir-caja` |
| **Contabilidad** | Movimientos contables | `ver-contabilidad`, `crear-asientos` |
| **Reportes** | Informes y estadísticas | `ver-reportes-ventas` |
| **Configuración** | Ajustes del sistema | `ver-configuracion` (Admin) |
| **Usuarios** | Gestión de usuarios | `ver-usuarios` (Admin) |

## 🔒 Roles y Permisos

| Rol | Nivel | Descripción | Accesos Principales |
|-----|-------|-------------|---------------------|
| **Super Admin** | 4 | Acceso total | Todos los módulos y configuraciones |
| **Administrador** | 3 | Gestión general | Ventas, inventario, reportes, usuarios |
| **Contador** | 2 | Gestión financiera | Contabilidad, reportes financieros |
| **Secretaria** | 2 | Atención al cliente | Ventas, clientes, créditos |
| **Técnico** | 1 | Gestión de inventario | Productos, stock, movimientos |
| **Vendedor** | 1 | Ventas básicas | Ventas, clientes, consulta de productos |

## 🐛 Solución de Problemas

### Error: "500 Internal Server Error"
```bash
# Verificar permisos
chmod -R 775 storage bootstrap/cache

# Ver logs
tail -f storage/logs/laravel.log
```

### Error: Base de datos no conecta
- Verificar credenciales en `.env`
- Verificar que MySQL esté corriendo
- Verificar que la base de datos exista

### Página sin estilos
```bash
# Limpiar caché
php artisan config:clear
php artisan cache:clear
php artisan view:clear
```

### Backups no se crean
- Verificar permisos en `storage/app/backups`
- Verificar ruta de mysqldump en `BackupDatabase.php`
- Revisar logs en `storage/logs/laravel.log`

## 📚 Documentación Adicional

- **[GUIA_INSTALACION_CLIENTE.md](GUIA_INSTALACION_CLIENTE.md)** - Guía completa de instalación
- **[ANALISIS_BACKUP_RESTAURACION.md](ANALISIS_BACKUP_RESTAURACION.md)** - Sistema de backups en detalle

## 🤝 Contribuciones

Este es un proyecto privado para distribución comercial. No se aceptan contribuciones externas.

## 📞 Soporte

### Contacto
- **Desarrollador**: Luis Carlos Correa Arrieta
- **Email**: pcapacho24@gmail.com
- **Soporte Técnico**: Disponible para clientes con licencia activa

### Horario de Soporte
- Lunes a Viernes: 8:00 AM - 6:00 PM (GMT-5)
- Tiempo de respuesta: 24-48 horas

## 📄 Licencia

Este software es propiedad privada. Su uso está restringido según los términos del acuerdo de licencia comercial.

**Prohibido:**
- ❌ Redistribución
- ❌ Modificación sin autorización
- ❌ Uso sin licencia válida
- ❌ Ingeniería inversa

## 🎯 Roadmap

### Versión Actual: 1.0
- ✅ Sistema completo de ventas
- ✅ Facturación electrónica
- ✅ Control de inventario
- ✅ Sistema de backups robusto

### Próximas Versiones
- 🔄 Multi-tenancy (múltiples empresas)
- 🔄 App móvil para vendedores
- 🔄 Dashboard con gráficos en tiempo real
- 🔄 Integración con más pasarelas de pago

---

**Desarrollado con ❤️ en Colombia**

**© 2025 - Todos los derechos reservados**
User / IP	: 216.73.216.217
Host / Server	: 45.84.207.204 / aircan.me
System	: Linux lt-bnk-web1726.main-hosting.eu 5.14.0-611.36.1.el9_7.x86_64 #1 SMP PREEMPT_DYNAMIC Tue Mar 3 11:23:52 EST 2026 x86_64