Instituto Politécnico Formosa.

Servidor p/ 1er Parcial: Programación II

Para ejecutar se debe tener instalado Node.js y npm.

• Para Instalar las dependencias:

npm  i

• Para ejecutar el proyecto en modo Desarrollo, ejecutar el siguiente comando:

npm  run  nodemon

• Para el proyecto en modo Producción, ejecutar el siguiente comando:

npm  start

Link Github Para Descargar la App

• Ahora al entrar a la pagina para descargar la app, tambien puede descargar el postman-helper:
  • Así facilita el proceso de testeo de la app.

Usos

• Lo ideal para comenzar es registrarte como usuario:

---

HTTP: POST :http://localhost:3000/user

• => requiere del siguiente body:

	 {
		 "username":"AquiVaElNombreDeUsuario",
		 "password":"tuContraseña",
		 "email":"UnEmailVálido"
	 }

---

• El siguiente paso sería iniciar sesión para acceder a las funciones:

---

• HTTP: POST: http://localhost:3000/login

  • => requiere del siguiente body:

	 {
		 "username":"AquiVaElNombreDeUsuario",
		 "password":"tuContraseña"
	 }

• O puede intentar ingresando estas cuentas de prueba:

• Usuario con rol de Admin:

	 {
		 "username":"Admin",
		 "password":"Admin321"
	 }

• Usuarios de prueba sin Admin:

	 {
		 "username":"UsuarioPrueba",
		 "password":"UsuarioPruebaMod"
	 }

	 {
		 "username":"UsuarioPrueba1",
		 "password":"UsuarioPrueba2"
	 }

---

• Una vez reciba el Token, cópielo y uselo como header Authorization en su cliente y así acceder a las funciones:

---

HTTP: PUT: http://localhost:3000/user

• => requiere del siguiente body:
• Solo se puede cambiar el password y el email al mismo tiempo;

	 {
		 "password":"tuContraseña",
		 "email":"UnEmailVálido"
	 }

---

HTTP: GET (SOLO ROL DE ADMIN): http://localhost:3000/users

• Sirve para ver la información de todas las cuentas.

---

---

HTTP: GET: http://localhost:3000/user

• Sirve para ver la información de tu cuenta.

---

HTTP: DELETE: http://localhost:3000/user

• En caso de que quieras eliminar la cuenta.

---

• Funciones de Tareas con el Token:

---

HTTP: GET (SOLO ROL DE ADMIN): http://localhost:3000/task

• Mostraría todas las tareas existentes en la Base de Datos:

---

HTTP: GET http://localhost:3000/task/:idTarea

• Para tener en cuenta; Para obtener el :idTarea preferiblemente que haga un GET de las tareas ( /task/user) y copie el "_id" de la tarea que desea modificar:
• Ejemplo (usando la cuenta del "UsuarioPrueba1"):
• Y entrando a esta tarea de ejemplo:

  • HTTP: GET: http://localhost:3000/task/6348ff8873c8a926fd3dc92c

  • Nos devolvería lo siguiente:

	{
		"_id":  "6348ff8873c8a926fd3dc92c",

		"title":  "Tarea 6",
		"description":  "Decripcion Tarea 10",
		"fecha":  "2022-10-07T13:34:18.000Z",
		"estado":  2,
		"isActive":  true,
		"idUser":  {
			"_id":  "6344f187de497d3ac62adf76",
			"username":  "UsuarioPrueba1",
			"email":  "[email protected]"
		},
		"createdAt":  "2022-10-14T06:19:52.394Z",
		"updatedAt":  "2022-10-14T06:19:52.394Z"
	}

---

HTTP: GET: http://localhost:3000/task/user

• Muestra todas las tareas del usuario que inició sesión y usa su token para esta petición.

---

HTTP: POST: http://localhost:3000/task

• => requiere el siguiente Body:
  • El formato de Fecha es ( aaaa-mm-dd T hh:mm:ssZ ) por defecto toma el tiempo que es creada la tarea.
  • El estado por defecto es 1:

Estado	número
Pendiente	1
En Proceso	2
Completado	3

• Ejemplo:

	 {
		"title":"Tarea 6",
		"description":"Decripcion Tarea 10",
		"fecha":"2022-10-07T13:34:18Z",
		"estado":2
	 }

---

HTTP: PUT: http://localhost:3000/task/:idTarea

=> requiere el siguiente Body:

• Para tener en cuenta; Para obtener el :idTarea preferiblemente que haga un GET de las tareas ( /task/user) y copie el "_id" de la tarea que desea modificar:
• Ejemplo (usando la cuenta del "UsuarioPrueba1"):
• Y entrando a esta tarea de ejemplo:

	{
		"_id":  "6348ff8873c8a926fd3dc92c",

		"title":  "Tarea 6",
		"description":  "Decripcion Tarea 10",
		"fecha":  "2022-10-07T13:34:18.000Z",
		"estado":  2,
		"isActive":  true,
		"idUser":  {
			"_id":  "6344f187de497d3ac62adf76",
			"username":  "UsuarioPrueba1",
			"email":  "[email protected]"
		},
		"createdAt":  "2022-10-14T06:19:52.394Z",
		"updatedAt":  "2022-10-14T06:19:52.394Z"
	}

• HTTP: PUT :http://localhost:3000/task/6348ff8873c8a926fd3dc92c

=> requiere el siguiente Body:

	 {
		"title":"Tarea 6",
		"description":"Descripción Tarea 11",
		"fecha":"2022-10-07T13:34:18Z",
		"estado":3
	 }

---

HTTP: PUT: http://localhost:3000/task/:idTarea/complete

Para completar una tarea

• :idTarea hace referencia al "_id" de la tarea a completar

• Por ejemplo:

• HTTP: PUT: http://localhost:3000/task/6348ff8873c8a926fd3dc92c/complete

---

HTTP: DELETE: http://localhost:3000/task/:idTarea

Para eliminar una tarea

• :idTarea hace referencia al "_id" de la tarea a completar

• Por ejemplo:

• HTTP: DELETE: http://localhost:3000/task/6348ff8873c8a926fd3dc92c

---