Skip to content

Releases: projects-ISPC/practicaProfesionalizante-ISPC

Versión 1.0.0

08 Jun 01:37
c39c408
Compare
Choose a tag to compare

Librería Franklin: sitio web y aplicación móvil.

Versión 1.0.0

En esta versión se adjunta un único repositorio que alberga el sitio web y la aplicación móvil. La idea de un único release surge debido a que ambos están íntimamente correlacionados en cuanto lógica de negocio y perspectiva. Ésta es la versión final con el entregable completo que trae las funcionalidades requeridas:

  • Código fuente completo del proyecto,
  • Documentación (diagramas, documento IEEE 830, figma de diseño, script de base de datos),
  • Implementación de las funcionalidades básicas (CRUD de usuarios y productos),
  • Implementación de testing y accesibilidad,
  • Implementación de nuevas pantallas tales como panel de administrador, 'Sobre Nosotros' y 'Contacto',
  • Corrección de errores menores y bugs con respecto a versiones anteriores de los proyectos.

Se adjunta wiki de la mencionada versión que contiene la documentación mencionada.

Changelog

Prerrequisitos

  • Tener una versión de Node mayor a 16, por ejemplo, v16.14.2.
  • Tener un navegador web actualizado (ej: Google Chrome [recomendado], Firefox Mozilla, Opera, etc)
  • Tener una versión de Java Development Kit (JDK) superior a 11.
  • Contar con Xampp Control Panel (opcional)

Instrucciones para levantar el proyecto

Git

  1. Clonar el repositorio empleando el siguiente comando:
git clone https://github.com/projects-ISPC/practicaProfesionalizante-ISPC.git
  1. Asegurarse de estar ubicado/a en la raíz del directorio del proyecto y que la rama sea main.

Frontend

Se encuentra la carpeta FrontEnd 2024 que adentro contiene tanto la app como la web.

Web

Para hacer un build del frontend del sitio web hay que realizar los siguientes pasos:

  1. Estar ubicado/a en la ruta /practicaProfesionalizante-ISPC/FrontEnd 2024/Web/Front
  2. Instalar Angular CLI globalmente en caso de no tenerlo:
npm install -g @angular/cli
  1. Realizar un npm install de las dependencias del proyecto:
npm install
  1. Finalmente levantar el proyecto localmente:
ng serve

App

Para hacer un build del frontend de la aplicación móvil hay que realizar los siguientes pasos:

  1. Instalar Android Studio Jellyfish | 2023.3.1 en caso de no tenerlo (link de descarga)
  2. Una vez ejecutada la aplicación hacer un sync para sincronizar con la versión de Gradle.
  3. Abra el proyecto dentro de Android Studio y seleccione libreria como la app para correr el proyecto.
  4. Descargar un emulador (recomendable Pixel 3a) o en su defecto emplear un dispositivo físico propio (ejemplo: teléfono celular mediante cable USB)
  5. Finalmente levantar el proyecto localmente con el botón verde 'Run' similar a este ícono: Run

Backend

Se encuentra la carpeta BackEnd 2024 que adentro contiene el backend de Web (tener en cuenta que el backend de app móvil es SQLite y ya viene incluido al levantar la parte frontend del proyecto)

Web

  1. Estar ubicado/a en la ruta practicaProfesionalizante-ISPC/BackEnd 2024/Libreria
  2. Instalar Python en caso de no tenerlo.
  3. Instalar MySQL en caso de no tenerlo.
  4. Ejecutar los siguientes comandos para tener pip actualizado e instalar el conector de Python con MySQL:
python -m pip install --upgrade pip
pip install mysqlclient
  1. Instalar Django:
pip install django
  1. Instalar Rest Framework:
pip install djangorestframework
  1. Instalar CORS:
python -m pip install django-cors-headers
  1. Iniciar el servidor de MySQL (se puede hacer por comando de consola o usar Xampp Control Panel)

  2. Chequear que en el setting.py el puerto, usuario, contraseña y ruta corresponda al mismo que se emplea para
    levantar MySQL y que el nombre de la base de datos sea dblibreria.

  3. Aplicar migraciones locales:

python manage.py makemigration
python manage.py migrate
  1. Crear un superusuario admin de Django:
python manage.py createsuperuser
  1. Iniciar el servidor de desarrollo:
python manage.py runserver

Proyectos por separados

En GitHub, como habrán podido observar, ambos proyectos están combinados en un solo repositorio. Si esto causa algún inconveniente al ejecutarlos, a continuación les proporcionamos los enlaces para descargar cada proyecto por separado en archivos .zip: