Tul xxx Tul

Viewing: PASOS_GITHUB.md

# 📤 Pasos para Subir el Proyecto a GitHub

## ✅ Preparación Completada

Ya se han realizado los siguientes cambios:

1. ✅ **RestaurarDatosSeeder comentado** en `DatabaseSeeder.php` - No restaura datos automáticamente
2. ✅ **README.md actualizado** - Documentación completa del proyecto
3. ✅ **GUIA_INSTALACION_CLIENTE.md creado** - Guía paso a paso para clientes
4. ✅ **ANALISIS_BACKUP_RESTAURACION.md** - Documentación del sistema de backups
5. ✅ **.gitignore actualizado** - Protege archivos sensibles y backups

---

## 📋 PASO 1: Verificar Archivos Sensibles

Antes de subir, asegúrate de que estos archivos NO se suban:

```bash
# Verificar que .gitignore está funcionando
git status

# NO deben aparecer:
# - .env
# - /vendor
# - /node_modules
# - /storage/app/backups/* (tus backups con datos reales)
# - /storage/logs/* (logs con información sensible)
```

---

## 📋 PASO 2: Limpiar Datos Sensibles

### Opción A: Limpiar Base de Datos (Recomendado)
```bash
# Ejecutar migrate:fresh --seed para tener BD limpia
php artisan migrate:fresh --seed

# Esto creará:
# - Estructura de tablas vacía
# - Usuario administrador por defecto
# - Roles y permisos
# - Plan de cuentas básico
# - SIN datos de tu empresa
```

### Opción B: Crear Backup Limpio para Distribución
```bash
# Crear un backup con la BD limpia
php artisan backup:database

# Este backup será el que los clientes usarán como base
```

---

## 📋 PASO 3: Crear Repositorio en GitHub

1. Ve a https://github.com
2. Click en **"New repository"**
3. Configuración:
   - **Repository name**: `ventas_completa` o el nombre que prefieras
   - **Description**: "Sistema completo de gestión de ventas, inventario y facturación electrónica"
   - **Visibility**: 
     - ✅ **Private** (Recomendado - para distribución comercial)
     - ⚠️ Public (Solo si quieres código abierto)
   - ❌ **NO** marcar "Initialize with README" (ya tienes uno)
4. Click en **"Create repository"**

---

## 📋 PASO 4: Inicializar Git Local (Si no está inicializado)

```bash
# Navegar al proyecto
cd C:\xampp\htdocs\laravel\ventas_completa

# Verificar si ya tiene git
git status

# Si NO tiene git, inicializar:
git init

# Agregar todos los archivos
git add .

# Hacer el primer commit
git commit -m "Initial commit: Sistema de Ventas Completo v1.0"
```

---

## 📋 PASO 5: Conectar con GitHub

```bash
# Agregar el repositorio remoto
git remote add origin https://github.com/carval82/ventas_completa.git

# Verificar que se agregó correctamente
git remote -v

# Cambiar a rama main (si es necesario)
git branch -M main
```

---

## 📋 PASO 6: Subir el Código a GitHub

```bash
# Subir todo a GitHub
git push -u origin main

# Si pide autenticación:
# - Usuario: tu_usuario_github
# - Contraseña: usar Personal Access Token (no la contraseña normal)
```

### Crear Personal Access Token (Si es necesario)

1. Ve a GitHub → Settings → Developer settings → Personal access tokens → Tokens (classic)
2. Click en "Generate new token (classic)"
3. Permisos necesarios:
   - ✅ `repo` (acceso completo a repositorios)
4. Copiar el token generado
5. Usar este token como contraseña al hacer `git push`

---

## 📋 PASO 7: Verificar que Todo se Subió Correctamente

1. Ve a tu repositorio en GitHub
2. Verifica que aparezcan:
   - ✅ README.md con la documentación
   - ✅ GUIA_INSTALACION_CLIENTE.md
   - ✅ Código fuente completo
   - ✅ Estructura de carpetas
3. Verifica que NO aparezcan:
   - ❌ .env (archivo de configuración)
   - ❌ /vendor (dependencias)
   - ❌ /node_modules
   - ❌ Backups con tus datos

---

## 📋 PASO 8: Configurar Repositorio en GitHub

### Agregar Descripción y Tags

1. En tu repositorio, click en el ícono de engranaje (⚙️) junto a "About"
2. Agregar:
   - **Description**: "Sistema completo de gestión empresarial: ventas, inventario, facturación electrónica, contabilidad y control de cajas"
   - **Website**: (si tienes una demo)
   - **Topics**: `laravel`, `php`, `mysql`, `pos`, `facturacion-electronica`, `inventario`, `ventas`, `contabilidad`

### Crear Release (Opcional)

1. Ve a **Releases** → **Create a new release**
2. Tag version: `v1.0.0`
3. Release title: "Sistema de Ventas Completo v1.0"
4. Descripción:
```markdown
## 🎉 Primera Versión Estable

### Características Principales
- ✅ Sistema completo de ventas
- ✅ Control de inventario multi-ubicación
- ✅ Facturación electrónica (Integración Alegra)
- ✅ Contabilidad con PUC
- ✅ Control de cajas diarias
- ✅ Sistema de backups automáticos
- ✅ Roles y permisos personalizados

### Instalación
Ver [GUIA_INSTALACION_CLIENTE.md](GUIA_INSTALACION_CLIENTE.md)

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

---

## 📋 PASO 9: Clonar en Cliente (Proceso de Instalación)

Cuando un cliente necesite instalar:

```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 .env con datos del cliente
# (Base de datos, email, etc.)

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

# 6. Listo para usar
php artisan serve
```

---

## 🔄 Actualizar el Repositorio (Futuros Cambios)

Cuando hagas cambios y quieras actualizarlos en GitHub:

```bash
# Ver archivos modificados
git status

# Agregar cambios
git add .

# O agregar archivos específicos
git add ruta/al/archivo.php

# Hacer commit con mensaje descriptivo
git commit -m "Descripción de los cambios realizados"

# Subir a GitHub
git push origin main
```

---

## 📝 Comandos Git Útiles

```bash
# Ver historial de commits
git log --oneline

# Ver diferencias antes de commit
git diff

# Deshacer cambios en un archivo
git checkout -- archivo.php

# Crear una nueva rama para desarrollo
git checkout -b desarrollo

# Cambiar entre ramas
git checkout main
git checkout desarrollo

# Ver ramas
git branch

# Eliminar rama local
git branch -d nombre-rama
```

---

## 🔐 Seguridad y Buenas Prácticas

### ✅ Hacer Siempre

1. **Verificar .gitignore** antes de cada push
2. **Revisar git status** para ver qué se va a subir
3. **Usar commits descriptivos** ("Fix: corregir cálculo de IVA" en vez de "fix")
4. **Mantener .env.example actualizado** con todas las variables necesarias
5. **Documentar cambios importantes** en el README

### ❌ Nunca Hacer

1. ❌ Subir archivos .env
2. ❌ Subir backups con datos reales
3. ❌ Subir credenciales o API keys
4. ❌ Hacer commits con mensaje "test" o "asdf"
5. ❌ Subir /vendor o /node_modules

---

## 📊 Estructura Final en GitHub

```
ventas_completa/
├── README.md                           ← Documentación principal
├── GUIA_INSTALACION_CLIENTE.md        ← Guía de instalación
├── ANALISIS_BACKUP_RESTAURACION.md    ← Documentación de backups
├── .gitignore                          ← Archivos a ignorar
├── .env.example                        ← Plantilla de configuración
├── composer.json                       ← Dependencias PHP
├── artisan                             ← CLI de Laravel
├── app/                                ← Código de la aplicación
├── database/
│   ├── migrations/                     ← Migraciones de BD
│   └── seeders/                        ← Seeders (datos iniciales)
├── public/                             ← Archivos públicos
├── resources/                          ← Vistas y assets
├── routes/                             ← Rutas de la aplicación
└── storage/                            ← Almacenamiento (sin backups)
```

---

## ✅ Checklist Final

```
[ ] .gitignore actualizado y verificado
[ ] .env NO está en el repositorio
[ ] README.md completo y actualizado
[ ] GUIA_INSTALACION_CLIENTE.md creada
[ ] Base de datos limpia (sin datos de tu empresa)
[ ] RestaurarDatosSeeder comentado en DatabaseSeeder
[ ] Credenciales por defecto documentadas
[ ] Repositorio creado en GitHub (Private)
[ ] Código subido exitosamente
[ ] Verificado que no hay archivos sensibles
[ ] Release v1.0 creada (opcional)
[ ] Documentación revisada
```

---

## 🎉 ¡Listo para Distribuir!

Tu proyecto está ahora en GitHub y listo para:
- ✅ Clonar en máquinas de clientes
- ✅ Control de versiones
- ✅ Colaboración (si agregas colaboradores)
- ✅ Distribución controlada

### Próximos Pasos

1. **Probar instalación** en una máquina limpia
2. **Documentar proceso** de actualización para clientes
3. **Crear sistema de licencias** (opcional)
4. **Configurar CI/CD** (opcional - para automatizar testing)

---

## 📞 Soporte

Si tienes problemas con Git o GitHub:
- Documentación oficial: https://docs.github.com
- Git tutorial: https://git-scm.com/docs/gittutorial
- GitHub Desktop (GUI): https://desktop.github.com/

**¡Tu sistema está listo para distribuir a clientes!** 🚀
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