angelsucasas / buhocenter

aplicación web para la materia de desarrollo del software

Buhocenter

Fase 1

Find everything, buy anything

Buhocenter es un nuevo comercio electrónico que permite el pago con criptomonedas. Miles de productos al alcance de un clic, encuentra el producto de tu necesidad en nuestros catálogos, ¿te sientes perdido? No te preocupes, con nuestras categorías podrás encontrar lo que necesites, desde productos de tecnología, hasta productos del hogar.

Funcionalidades

Como cliente de Buhocenter podrás:

• Registrarte de manera tradicional o con tus cuentas de Gmail o Facebook.
• Administrar tu perfil de usuario
• Registrar direcciones dentro de EE.UU para que recibas tus compras
• Administrar tus direcciones
• Buscar miles de productos y servicios
• Buscar productos o servicios por catálogos
• Buscar catálogos por categorías
• Seleccionar el idioma en que quieres ver el contenido de buhocenter
• Agregar productos a tu carrito
• Comprar los productos/servicios en tu carrito pagando con criptomonedas
• Recibir correos de bienvenida, también al completar una transacción con éxito
• Recibir correos con nuevas ofertas y descuentos

Como parte de nuestro equipo de administradores podrás:

• Gestionar usuarios
• Agregar productos/servicios
• Gestionar productos/servicios
• Definir el mínimo de un producto en inventario

Imágenes de Buhocenter

Instalación y Setup

Primero que nada, necesitas NPM y Node.JS. Después, es necesario instalar NestJS de manera global

$ npm install nestjs -g

Procede a clonar el proyecto, y verifica que estás ubicado en la rama master

Archivos de Configuración

Antes de proceder con la ejecución de las aplicaciones, agregue los archivos con el nombre .env correspondientes a cada uno de los proyectos.

Este es el formato del archivo .env para backend, en él se declaran variables de entorno necesarias para la ejecución de la aplicación. Por lo tanto, es de vital importancia llenarla antes de pasar a la instalación y debe estar ubicado en el directorio /buhocenter-backend.

Este es el formato del archivo .env para frontend y debe estar ubicado en /buhocenter-frontend.

De igual forma, puede obtener la estructura del archivo de configuración .env en /buhocenter-backend/.env.test o /buhocenter-frontend/.env.test respectivamente.

Instalación Backend

En /buhocenter-backend ejecute:

$ npm install

Frontend

En /buhocenter-frontend ejecute:

$ npm install

Creación de la Base de Datos

Para ejecutar de forma correcta la aplicación, proceda con la creación de la base de datos en el manejador PostgreSQL con el nombre buhocenter.

Ejecución de las Aplicaciones

Antes de proceder con la ejecución de la aplicación, asegúrate de tener las variables de ambiente necesarias de ambos proyecto en el archivo .env. Una vez se haya validado esto, es necesario que primero se ejecute el proyecto de backend y luego frontend, y adicionalmente, asegúrese de modificar la variable TYPEORM_DATABASE en el archivo .env ubicado en buhocenter-backend a buhocenter así como TYPEORM_SYNCHRONIZE a true para la creación automática de la base de datos. Procede con la ejecución de los siguientes comandos:

Backend

Asegúrate de tener disponible el puerto 3000 para la ejecución del proyecto. Posterior a esto, ejecute:

$ npm run start

Después de la ejecución de este comando, puede validar en la base de datos la creación de todas las entidades correspondientes al sistema. En caso de ser así, proceda a la ejecución de los scripts de inserción de la base de datos ubicados en /buhocenter-backend/db/inserts.sql

Alternativas

Como método alternativo para la creación de la base de datos, puede realizar lo siguiente:

• Crear una base de datos en el manejador PostgreSQL llamada buhocenter_sync
• Modificar la variable TYPEORM_DATABASE a buhocenter_sync que es el nuevo nombre de la base de datos
• Ejecutar los scripts de creación de la base de datos
• Ejecutar los scripts de inserción de la base de datos ubicados en /buhocenter-backend/db/inserts.sql

Una vez se haya validado la correcta creación de la base de datos, proceda con la ejecución del proyecto de frontend

Frontend

Asegúrate de tener disponible el puerto 8080 para la ejecución del proyecto. Posterior a esto, ejecute:

$ npm run serve

API

Para validar las direcciones se usa la API de SmartyStreets.

La pasarela de pago que se encarga de las transacciones es UTRUST.

También usamos Firebase-Auth para el proceso de autenticación.

---

MIT ©

Ángel Sucasas Andrea Da Silva Gabriel Ortega