diff --git a/README.md b/README.md index 3b2f995..6854a30 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,7 @@ ## Índice - [Introducción](#introducción) +- [Requisitos](#requisitos) - [Instalación](#instalación) - [Características por módulo (Manual de Usuario)](#características) - - [My Team](#my-team) @@ -15,12 +16,53 @@ ## Introducción +Este readme describe el funcionamiento detallado del aplicativo DevProbe encontrado +en la sección [características por módulo](#características-por-módulo-manual-de-usuario). +para instalar el aplicativo se debe seguir los pasos descritos en la sección [instalación](#instalación). +Adicionalmente, para acceder a la API y sus funcionalidades se debe seguir los pasos descritos en la +sección [Manual de Usuario de la API](#manual-de-usuario-de-la-api). + +## Requisitos + +Para poder instalar el proyecto, se debe seguir los siguientes pasos: + +1. Instalar Node.js (https://nodejs.org/) +2. Instalar Angular v17 (https://angular.io/) +3. Instalar Ionic Framework (https://ionicframework.com/docs) +4. Instalar Firebase CLI (https://firebase.google.com/docs/cli) + ## Instalación +El aplicativo es un proyecto de Angular, que hace uso de la librería IONIC. + +El proceso de instalación es el siguiente: + +Es necesario tener instaladas las siguientes [dependencias](#requisitos). + +1. Clonar el repositorio o descargar el zip. +2. Instalar las dependencias con `npm install` +3. Iniciar el servidor de desarrollo con `ionic serve` +4. Abrir el navegador en `http://localhost:8100/` + +**Nota: El aplicativo NO requiere que servidor REST API esté corriendo** + +### Extras: +**En caso de querer modificar el proyecto de Firebase por uno personal, se debe seguir los siguientes pasos:** + +1. Crear una cuenta en [firebase](https://firebase.google.com/). +2. Crear un proyecto en [firebase dashboard](https://console.firebase.google.com/). +3. Inicializar Firebase Auth en el Dashboard de Firebase. [Más información](https://firebase.google.com/docs/auth/). +4. Inicializar Firestore en el Dashboard de Firebase [Más información](https://firebase.google.com/docs/firestore/). +5. Inicializar Firebase Storage en el Dashboard de Firebase [Más información](https://firebase.google.com/docs/storage/). +6. Inicializar Gemini, Vertex en el Dashboard de Firebase [Más información](https://firebase.google.com/docs/vertex-ai/). +7. Se debe modificar el archivo `firebase.json` en la raíz del proyecto. En este archivo se debe agregar las credenciales de Firebase Auth, Firestore, y Firebase Storage, mismas +que se encuentran en el Dashboard de Firebase. + +**El aplicativo está disponible para instalar en un celular iOS o Android gracias a Capacitor JS, para ello se debe seguir el siguiente [tutorial](https://ionicframework.com/docs/developing/ios.).** ## Características por módulo -En este manual de usuario se describen las características de cada módulo de la app, para cada módulo se detallan las funcionalidades que ofrece,. +En este manual de usuario se describen las características de cada módulo de la app, para cada módulo se detallan las funcionalidades que ofrece. #### **My Team** @@ -31,6 +73,12 @@ Con respecto a esta primera versión, no existe la posibilidad de restringir acc En futuras versiones de la PWA, se planea introducir controles más granulares sobre los permisos de acceso y la gestión de roles dentro de los equipos. Esto permitirá designar a un administrador que podrá asignar diferentes niveles de acceso a los miembros, como la capacidad de realizar cambios, eliminar datos o acceder a ciertos módulos de manera restringida. Asimismo, se implementarán funcionalidades de auditoría que registrarán las acciones realizadas por cada miembro, lo que brindará mayor transparencia y control sobre las modificaciones hechas en el sistema. **Imagen 2: Página Team Members** + +![](./README_IMAGES/myteam1.png) + +![](https://firebasestorage.googleapis.com/v0/b/devprobe-89481.appspot.com/o/Readme-pwa%2Fmyteam1.png?alt=media&token=20485de7-a2ea-4d10-a616-d865c15e7813) + + La ruta /myteam es la que almacena la lógica de la pantalla Team Members que se muestra en la imagen 2. Esta ruta implementa una instancia del servicio TeamsService, este servicio es capaz de actualizar, obtener y eliminar a miembros de un equipo. Por su lado, TeamsService implementa una instancia del servicio AuthService, este servicio maneja la única instancia de Firebase Authentication que es la capaz de realizar la autenticación de los usuarios dentro de la PWA. Firebase Authentication se encarga de verificar la identidad de los usuarios mediante la autenticación por correo electrónico. Una vez autenticados, AuthService permite obtener los tokens de autenticación necesarios para validar las acciones de los usuarios al interactuar con el servicio TeamsService. @@ -222,9 +270,7 @@ Para concluir la imagen 23 muestra la pantalla de postmortem del incidente, dond ## Manual de Usuario de la API - - - +El manual de usuario e implementación de la API se encuentra en el siguiente [link](https://github.com/juanfranciscocis/DevProbeApi). diff --git a/README_IMAGES/myteam1.png b/README_IMAGES/myteam1.png new file mode 100644 index 0000000..22df76f Binary files /dev/null and b/README_IMAGES/myteam1.png differ