Saltar a contenido

Instalación del Entorno de Desarrollo

Esta guía te ayudará a configurar el entorno de desarrollo local del Sistema A3 en tu máquina.

Prerrequisitos de Acceso

IMPORTANTE: Antes de seguir esta guía, asegúrate de tener:

  • ✅ Acceso autorizado al repositorio privado en GitHub
  • ✅ Firma de acuerdos de confidencialidad (NDA)
  • ✅ Aprobación del departamento de TI de A Terceros

Si no tienes accesos, consulta la guía de accesos primero.

Nota: Esta es una aplicación interna privada de A Terceros Inmobiliaria. El código y datos son confidenciales.

Requerimientos del Sistema

Software Necesario

  • Python 3.11+ (versión mínima: 3.8)
  • PostgreSQL 12.3+
  • Git
  • pip y virtualenv
  • Sistema Operativo: Windows, macOS o Linux

Librerías y Frameworks

Backend

  • Django 3.2
  • django-heroku
  • django-notifications-hq
  • django-model-utils
  • django-better-admin-arrayfield
  • python-dotenv
  • gunicorn
  • psycopg2
  • whitenoise
  • requests
  • Pillow
  • django-rest-framework
  • Y más... (ver requirements.txt)

Frontend

  • jQuery
  • Bootstrap
  • Chart.js
  • smooth-scrollbar
  • PDF.js (Mozilla)
  • Google Fonts: Lato

Proceso de Instalación

1. Clonar el Repositorio

git clone https://github.com/A-Terceros-Inmobiliaria/sistema-a3.git
cd sistema-a3/

2. Instalar virtualenv

Si no tienes virtualenv instalado:

pip install virtualenv

3. Crear el Entorno Virtual

Dentro del directorio del proyecto:

virtualenv venv

4. Activar el Entorno Virtual

source venv/Scripts/activate

source venv/bin/activate

Verificar activación

Una vez activado, verás (venv) al inicio de tu línea de comando.

5. Instalar Dependencias

Con el entorno virtual activado, instala todas las dependencias:

pip install -r requirements.txt

Tiempo de instalación

Este proceso puede tardar varios minutos dependiendo de tu conexión a internet.

Verificar la Instalación

Para verificar que todo se instaló correctamente:

python --version  # Debe mostrar Python 3.8+
python manage.py --version  # Debe mostrar Django 3.2

Siguientes Pasos

Una vez completada la instalación:

  1. Configuración: Configura las variables de entorno y servicios externos
  2. Base de Datos: Configura PostgreSQL y ejecuta las migraciones
  3. Ejecutar el servidor: Una vez configurado todo, podrás ejecutar python manage.py runserver

Problemas Comunes

Error: "No module named 'django'"

Solución: Asegúrate de que tu entorno virtual esté activado y hayas ejecutado pip install -r requirements.txt.

Error: "command not found: python"

Solución: En algunos sistemas, el comando es python3 en lugar de python. Intenta:

python3 --version
python3 manage.py --version

Error con psycopg2 en macOS

Solución: Instala PostgreSQL con Homebrew primero:

brew install postgresql

Problemas con Pillow

Solución: En Linux, instala las dependencias de sistema:

sudo apt-get install libjpeg-dev zlib1g-dev  # Ubuntu/Debian

Recursos Adicionales

¿Todo instalado? Continúa con la configuración del sistema.