Este proyecto consiste en la integración de las tecnologias aprendidas con el fin de crear una aplicacion web e-commerce, usando json-server como api.
Para la concepción del proyecto se hizo uso de las siguientes tecnologias, las cuales se integraron para crear el proyecto:
- HTML (HyperText Markup Language)
- CSS (Cascading Style Sheets)
- Bootstrap
- JavaScript
- Json-Server
Hay algunos requisitos y consideraciones que el cliente debe tener en cuenta para garantizar una implementación exitosa de la aplicación web:
- Acceso a Internet
- Dispositivo Compatible
- Navegador Compatible:
+---api // Logica de la API
| +---crud
| +---data
| +---models
| +---util
| \---config.js
+---assets // Assets de la aplicación
| +---img
| \---css
| \---tabla
+---components // Componentes Generales
| +---footer-component
| +---header-component
| +---sidebar-component
| +---product-component
| +---product-cart-component
| \---swal-alert
+---modules // Logica del Negocio
+---readmeAssets // Assets para Readme
|
+---index.html
+---index.js
+---app.js
+---config.js
+---.gitignore
+---package.json
+---README.md
- NVM es una herramienta que te permite administrar múltiples versiones de Node.js en tu máquina.
Instalación de NVM en Linux y macOS
-
Abre tu terminal.
-
Utiliza
curl
owget
para descargar el script de instalación de NVM desde el repositorio oficial de GitHub. Puedes usar uno de los siguientes comandos:Utilizando
curl
:curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash
Utilizando
wget
:wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash
Asegúrate de verificar la URL en el comando con la versión actual de NVM en GitHub.
-
Después de ejecutar el comando, seguirás las instrucciones en la terminal para completar la instalación.
-
Cierra y vuelve a abrir tu terminal o ejecuta
source ~/.bashrc
osource ~/.zshrc
(dependiendo de tu shell) para cargar NVM en tu sesión actual.
Uso de NVM
Una vez instalado NVM, puedes usar los siguientes comandos para gestionar las versiones de Node.js en tu sistema:
-
Para instalar una versión específica de Node.js, por ejemplo, Node.js ultima version estable:
nvm install --lts
-
Para seleccionar una versión específica de Node.js para usar:
nvm use <version>
Recuerda consultar la documentación oficial de NVM para obtener más detalles y opciones de configuración avanzadas.
Abre tu terminal y ejecuta el siguiente comando para instalar json-server
:
npm install -E -D json-server
Esto instalará json-server
con la ultima version estable de acuerdo a nuestra versión de Node.js
Inicia json-server:
En tu terminal, ejecuta json-server
y especifica el archivo JSON que deseas utilizar como fuente de datos:
json-server --watch db.json --port <port>
Para clonar este repositorio debes tener instalada la herramienta de GIT, y ejecutar el siguiente comando:
git clone https://github.com/Dabrox02/CampusShop.git
Debes tener permisos para clonar este repositorio
Si clonas este repositorio, debes utilizar el siguiente comando para instalar las dependencias necesarias:
npm install
Una vez instaladas, para ejecutar el json-server con la configuracion antes mencionada utiliza el siguiente comando:
npm run dev
Esto iniciará json-server
y lo configurará para escuchar en el puerto 5310
y host 127.0.0.1.
json-server --watch api/data/db.json --port 5310 --routes api/data/routes.json --host 127.0.0.1
Ahora, la API REST simulada estará disponible en http://localhost:5010
.
Una vez instaladas las depedencias y ejecutado el json-server, esta listo para usar la aplicación, puedes usar un servidor local como Live-Server.
Encontraras en la parte izquierda un menu lateral para ir a las otras secciones de la pagina:
- Inicio
- Categorias
- Todos los productos
- Abrigos
- Pantalones
- Camisetas
- Carrito
Y un menu superior para navegar al inicio y al GitHub del creador. En ambos podras navegar al inicio.
La aplicacion posee las siguientes funciones
- Agregar al carrito de compra
- Eliminar todo el carrito
- Eliminar un producto del carrito
- Editar cantidad producto
Ingrese a una seccion de productos, seleccione el producto que desea agregar y posteriormente de clic en el boton AGREGAR, automaticamente sera añadido al carrito y podra verlo en la seccion CARRITO.
Ingrese a la seccion de CARRITO y en la parte inferior seleccione el boton ELIMINAR TODAS, si la operacion es correcta sera eliminado.
Ingrese a la seccion de CARRITO, seleccione el producto que desea eliminar, y de clic en el boton ELIMINAR, correspondiente a dicho producto. Si la operacion es correcta, sera eliminado el producto.
Ingrese a la seccion de CARRITO, seleccione el producto que desea editar, en el campo CANTIDAD, modifique la cantidad que desea comprar. Si das clic en agregar y el producto ya esta agregado, tambien se añade uno mas.
Si das clic en COMPRAR AHORA, mostrara un modal con el mensaje COMPRADO CON EXITO, y se limpiara el carrito.