From 51acf21e804069751011c8bcdfde78fe01c231fb Mon Sep 17 00:00:00 2001 From: Alexis Cabrera Montero Date: Thu, 23 Oct 2025 08:14:30 -0600 Subject: [PATCH] Eliminar 'SETUP_COLABORADORES.md' --- SETUP_COLABORADORES.md | 247 ----------------------------------------- 1 file changed, 247 deletions(-) delete mode 100644 SETUP_COLABORADORES.md diff --git a/SETUP_COLABORADORES.md b/SETUP_COLABORADORES.md deleted file mode 100644 index 2765d95..0000000 --- a/SETUP_COLABORADORES.md +++ /dev/null @@ -1,247 +0,0 @@ -# Guía de Configuración para Colaboradores - -Esta guía te ayudará a configurar el proyecto en tu máquina local con todos los datos necesarios ya precargados. - -## 🚀 Inicio Rápido (5 minutos) - -### Prerrequisitos -- Docker y Docker Compose instalados -- Git instalado - -### Paso 1: Clonar el Repositorio - -```bash -git clone https://github.com/val20-11/Pagina-de-Asistencia-MAC.git -cd Pagina-de-Asistencia-MAC -``` - -### Paso 2: Configurar Variables de Entorno - -```bash -# Copiar el archivo de ejemplo -cp .env.development.example .env.development - -# (Opcional) Puedes editar .env.development si necesitas cambiar algo -# Por defecto viene configurado y listo para usar -``` - -### Paso 3: Iniciar el Proyecto - -```bash -# Iniciar todos los contenedores -docker-compose -f docker-compose.dev.yml up --build -d - -# Ver los logs (CTRL+C para salir) -docker-compose -f docker-compose.dev.yml logs -f -``` - -### Paso 4: Acceder al Sistema - -**¡Listo!** El sistema estará disponible en: - -- **Aplicación:** http://localhost -- **Panel Admin:** http://localhost/admin - -## 👤 Usuarios Precargados - -El sistema viene con usuarios ya creados que puedes usar inmediatamente: - -### Superusuario (Admin) -- **Usuario:** `Admin` -- **Contraseña:** (la contraseña del usuario Admin original) -- **Acceso:** Panel de administración completo - -### Asistentes -- **Usuario:** `asst_11111111` -- **Contraseña:** `11111111` (mismo que el número de cuenta) -- **Acceso:** Panel de asistentes - -*Nota: Todos los usuarios y datos están en `backend/fixtures/initial_data.json`* - -## 🔄 Cómo Funciona la Inicialización Automática - -Cuando inicias el proyecto por primera vez: - -1. **Docker Compose** ejecuta las migraciones de Django -2. **Script `init_db.py`** detecta si la base de datos está vacía -3. Si está vacía, carga automáticamente los **fixtures** desde `backend/fixtures/` -4. Los fixtures incluyen: - - Usuarios (superusuarios y asistentes) - - Perfiles de usuario - - Eventos (si existen) - - Asistencias (si existen) - -**No necesitas hacer nada manualmente** - todo se configura automáticamente. - -## 🔧 Comandos Útiles - -### Ver logs en tiempo real -```bash -docker-compose -f docker-compose.dev.yml logs -f -``` - -### Reiniciar contenedores -```bash -docker-compose -f docker-compose.dev.yml restart -``` - -### Detener el proyecto -```bash -docker-compose -f docker-compose.dev.yml down -``` - -### Resetear la base de datos completamente -```bash -# Esto elimina todos los datos y volúmenes -docker-compose -f docker-compose.dev.yml down -v - -# Luego volver a iniciar (se recargarán los fixtures automáticamente) -docker-compose -f docker-compose.dev.yml up -d -``` - -### Crear un nuevo superusuario (opcional) -```bash -docker-compose -f docker-compose.dev.yml exec backend python manage.py createsuperuser -``` - -### Acceder a la consola de Django -```bash -docker-compose -f docker-compose.dev.yml exec backend python manage.py shell -``` - -### Ejecutar tests -```bash -docker-compose -f docker-compose.dev.yml exec backend pytest -``` - -## 📊 Actualizar con Nuevos Datos - -Si el equipo comparte nuevos datos: - -### Opción 1: Actualizar desde Git (Recomendado) - -```bash -# Obtener los últimos cambios -git pull origin main - -# Reiniciar los contenedores para cargar los nuevos fixtures -docker-compose -f docker-compose.dev.yml down -v -docker-compose -f docker-compose.dev.yml up -d -``` - -### Opción 2: Cargar fixtures manualmente - -```bash -# Si solo quieres cargar fixtures específicos sin borrar todo -docker-compose -f docker-compose.dev.yml exec backend python manage.py loaddata backend/fixtures/initial_data.json -``` - -## 🎯 Compartir tus Cambios - -Si quieres que otros colaboradores tengan tus datos: - -### 1. Exportar los datos actuales - -Usa el script de exportación: - -```bash -# En Windows PowerShell -python export_fixtures.py - -# En Linux/Mac -python3 export_fixtures.py -``` - -Esto creará/actualizará archivos en `backend/fixtures/`: -- `initial_users.json` - Usuarios y perfiles -- `initial_events.json` - Eventos y asistencias (si existen) - -### 2. Subir a GitHub - -```bash -git add backend/fixtures/ -git commit -m "Actualizar fixtures con nuevos datos" -git push origin main -``` - -### 3. Notificar al equipo - -Avisa a tu equipo que ejecuten: -```bash -git pull origin main -docker-compose -f docker-compose.dev.yml down -v -docker-compose -f docker-compose.dev.yml up -d -``` - -## ❓ Problemas Comunes - -### "El contenedor backend no inicia" -```bash -# Ver logs del backend -docker-compose -f docker-compose.dev.yml logs backend - -# Reintentar con build limpio -docker-compose -f docker-compose.dev.yml up --build -``` - -### "No puedo acceder a http://localhost" -1. Verifica que los contenedores estén corriendo: - ```bash - docker-compose -f docker-compose.dev.yml ps - ``` -2. Verifica que el puerto 80 no esté ocupado -3. Prueba con `http://127.0.0.1` - -### "La base de datos no tiene datos" -```bash -# Verificar que los fixtures existan -ls -la backend/fixtures/ - -# Cargar manualmente si es necesario -docker-compose -f docker-compose.dev.yml exec backend python init_db.py -``` - -### "Error al cargar fixtures" -```bash -# Verificar que los archivos JSON sean válidos -cat backend/fixtures/initial_data.json | python -m json.tool - -# Ver logs detallados -docker-compose -f docker-compose.dev.yml exec backend python manage.py loaddata backend/fixtures/initial_data.json --verbosity 2 -``` - -## 📁 Estructura de Archivos Importantes - -``` -Pagina-de-Asistencia-MAC/ -├── .env.development # Variables de entorno (NO en Git) -├── .env.development.example # Plantilla de variables de entorno -├── docker-compose.dev.yml # Configuración Docker para desarrollo -├── export_fixtures.py # Script para exportar datos -├── backend/ -│ ├── init_db.py # Script de inicialización automática -│ └── fixtures/ # Datos iniciales (fixtures) -│ ├── initial_data.json # Usuarios y perfiles -│ └── initial_events.json # Eventos (si existen) -└── SETUP_COLABORADORES.md # Esta guía -``` - -## 🔐 Seguridad - -- **NO subas archivos `.env`** a GitHub (ya están en `.gitignore`) -- Los fixtures pueden contener **contraseñas hasheadas** (seguras) -- Si compartes fixtures, asegúrate de que no contengan **datos sensibles reales** -- En producción, siempre cambia las contraseñas por defecto - -## 📞 Soporte - -Si tienes problemas: - -1. Revisa esta guía -2. Verifica los logs: `docker-compose -f docker-compose.dev.yml logs` -3. Consulta el README principal del proyecto -4. Pregunta al equipo de desarrollo - ---- - -**¡Bienvenido al equipo de desarrollo! 🎉**