WIKI

• Configuración del entorno de desarrollo
• Uso de git
• Comandos utiles

Configuración del entorno de desarrollo

Para correr este proyecto se necesitan las siguientes dependencias:

• React (sólo necesario para modo desarrollo o testing).
• NodeJS Incluye paquete 'npm'.
• Github CLI Nos permitira subir y traer cambios del repositorio principal.

Paso 1: Descargar e instalar NodeJS y npm.

https://nodejs.org/en/download/. Hagan clic en el boton 'Windows Installer' para descargar el archivo de instalación. El instalador NodeJS incluye el paquete npm el cual utilizaremos para iniciar el servidor de react.

Paso 2: Checkear que este instalado node y npm.

Abrir una consola de comandos (o PowerShell), y escribir lo siguiente:

node -v

Con eso el sistema nos dira la version de Node.JS instalada en el sistema, hacemos lo mismo para ver NPM:

npm -v

Paso 3: Instalar React.

Instalaremos React con el siguiente comando en la consola o powershell.

npm install -g create-react-app

Para comprobar si se instalo React (nos debe aparecer una version).

npm create-react-app --version

Una vez instaladas las dependencias se puede correr la aplicación.

Paso 4: Instalar Github CLI.

Descargar Github CLI de la siguiente pagina: https://cli.github.com

Paso 5: Instalar librerias.

npm install --save redux-thunk
npm install react-scripts --save

Paso 6: Variables de entorno.

Necesitamos trabajar con entornos de desarrollo aislados, para esto, crearemos un entorno de desarrollo y configuraremos variables utilizando 'venv'. Crearemos un archivo llamado '.start_env.sh' el cual tendra el siguiente script:

source venv/bin/activate
set DATABASE_URL=postgres:///lookdaluv
set DB_USER=''
set DB_PASSWORD=''
set REACT_APP_API_URL='http://127.0.0.1:8000'

Uso de git

Iniciar una nueva tarjeta:

Lo primero es posicionarnos en la rama principal del proyecto 'main':

git checkout main

Desde aqui crearemos una nueva rama para trabajar:

git checkout -b issue_0001

Nota: Se debe seguir la siguiente nomenclatura: issue_xxxx. El numero sera el mismo que el que encontraremos en la tarjeta. (Ej: #24).

Enviar los cambios para su revisión:

Una vez hayan hecho modificaciones en los archivos podran ver los cambios en Visual Studio Code, lo mejor es chequear que este todo en orden antes de proceder a enviar los cambios. Se utilizan los siguientes comandos:

Para ver los archivos modificados.

git status

Para añadir el archivo.

git add src/ejemplo.css

Para empaquetar todo y que quede listo para enviar. Si el issue es una Feature va el prefijo 'feat:' si es una corrección va 'fix:'.

git commit -m "feat: nuevo diseño de la vista del perfil."

Deberan poner el nombre de la rama en la que trabajan, si es la primera vez que envian cambios creara la rama en GitHub.

git push origin issue_0001

Actualizar repositorio local.

Nos posicionamos en la rama main (checkout nos sirve tambien para cambiarnos de rama).

git checkout main

Traemos los cambios de Github a nuestro repositorio local para actualizarlo.

git pull origin main

Otros comandos utiles:

Ver en que rama estamos.

git branch

Remover archivo del commit.

git remove core/archivo.html

Comandos utiles

Generar demo data:

Te permite eliminar los datos de la base de datos y volver a crear datos demo que sirven para hacer pruebas.

from core.scripts.generate_demo_data import execute
execute()

Nota: Te advertira sobre si deseas cancelar o continuar con la operación.

Crear usuario admin:

Te permite crear un usuario para el panel /admin.

python manage.py createsuperuser

Nota: Debes seguir las instrucciones.

Configurar Base de Datos:

Instrucciones para la creación de la base de datos.

sudo su postgres
createuser --interactive
psql
CREATE DATABASE lookdaluv;
GRANT ALL PRIVILEGES ON DATABASE lookdaluv TO 'EL ROL RECIEN CREADO';
exit
exit
python manage.py migrate_schemas

Nota: Para sistemas Linux.

Iniciar el proyecto:

npm start