Saltar a contenido

Guía de Desarrollo Local

Esta guía detalla los pasos secuenciales necesarios para clonar, configurar e inicializar el entorno de desarrollo local de IntranetV2.

Paso 1: Clonar y Configurar Entorno

1. Clonar el repositorio Ejecute el comando en su terminal para descargar el código fuente:

git clone https://github.com/luis1grupoiai/intranetv2.git
cd intranetv2

2. Crear y activar el entorno virtual Configure el entorno aislado de Python:

python -m venv venv
.\venv\Scripts\activate

3. Instalar dependencias Instale los paquetes requeridos por el proyecto:

pip install -r requirements.txt

Paso 2: Base de Datos y Variables de Entorno

1. Configurar variables de entorno Cree un archivo llamado .env en la raíz del proyecto tomando como plantilla el archivo .env.example.txt (o .env.example). Defina las llaves de seguridad y accesos locales.

2. Ejecutar migraciones Inicialice el esquema de la base de datos local:

python manage.py migrate --settings=config.settings.development

Paso 3: Administración y Creación de Cuentas

1. Crear superusuario inicial Para poder ingresar al panel de administración de Django, ejecute:

python manage.py createsuperuser --settings=config.settings.development

2. Modificar contraseñas vía Shell (Opcional) Si requiere editar la contraseña de algún usuario existente:

# Ingresar al shell interactivo
python manage.py shell --settings=config.settings.development

# Dentro del shell de Django
from django.contrib.auth.models import User
user = User.objects.get(username='NOMBRE_USUARIO')
user.set_password('NUEVA_CONTRASEÑA')
user.save()
exit()

Paso 4: Ejecución del Proyecto

1. Iniciar Servidor de Desarrollo Levante el servidor web de pruebas local:

python manage.py runserver --settings=config.settings.development

2. Iniciar Worker de Colas En una terminal alterna (con el venv activo), ejecute el planificador de tareas:

python manage.py qcluster --settings=config.settings.development

Flujo de Creación de Aplicaciones (Avanzado)

Si requiere expandir el sistema creando un nuevo módulo bajo el directorio apps/:

1. Generar la app

python manage.py startapp nombre_de_tu_app apps/nombre_de_tu_app

2. Configurar el archivo apps.py de la app Edite apps/nombre_de_tu_app/apps.py:

from django.apps import AppConfig

class MiAppConfig(AppConfig):
    default_auto_field = 'django.db.models.BigAutoField'
    name = 'apps.nombre_de_tu_app'

3. Registrar en Settings (config/settings/base.py) Añada el módulo al listado de aplicaciones locales:

LOCAL_APPS = [
    'apps.nombre_de_tu_app',
]

4. Registrar directorio de Templates Configure la ruta en el apartado TEMPLATES dentro de base.py:

'DIRS': [os.path.join(BASE_DIR, 'apps/nombre_de_tu_app/templates')],