Skip to content

Latest commit

 

History

History
68 lines (42 loc) · 3.65 KB

clientes_nuevos.md

File metadata and controls

68 lines (42 loc) · 3.65 KB

Generación de clientes nuevos

En esta sección se definen los pasos a seguir para la generación de clientes nuevos. En este aspecto, se ha tenido en cuenta la experiencia de la OAS en el desarrollo de frontend con diferentes herramientas y enfoques que se ha obtenido con el paso del tiempo. Para conocer detalles de esta experiencia, se cuenta con este documento, donde se introduce la Arquitectura microfrontends.

Cliente base

Se ha preparado un cliente base, que contiene todas las características mínimas necesarias para comenzar el desarrollo de clientes nuevos aplicando la Arquitectura microfrontends, ese cliente se encuentra alojado en el repositorio oas_cliente en la rama feature/clientes_nuevos.

Pasos para comenzar

Siga los siguienets pasos para generar el nuevo cliente, para esto ya se debe contar con el repositorio correspondiente en GitHub, en la cuenta de la Universidad Distrital.

  1. Clone el proyecto del repositorio de GitHub
# clonar el proyecto
git clone https://github.com/udistrital/oas_cliente.git
# ingresar al directorio del proyecto
cd oas_cliente
  1. Ubiquese en la rama feature/clientes_nuevos
git checkout feature/clientes_nuevos
  1. Elimine la carpeta .git (oculta) que hace referencia al repositorio oas_cliente.
rm -rf .git

  1. Ajuste el nombre de la aplicación a desarrollar reemplazando oas-cliente y oas_cliente en todo el proyecto por el nombre de el nuevo cliente, incluyendo la carpeta contenedora de los archivos. El nombre de la carpeta debe coincidir con el nombre del repositorio nuevo ya creado.

  2. Genere de nuevo la carpeta .git

git init
  1. Sincronice el repositorio local recién creado con el nuevo repositorio remoto
git remote add origin https://github.com/udistrital/nuevo_cliente

  1. Si es necesario, realice una actualización de la versión de las dependencias en el archivo package.json a nivel de version menor. Se recomienda hacerlo manualmente buscando cada subversión disponible en npmjs.com para evitar conflictos de dependencias.

  2. Ajuste el nombre de la aplicación en environment cambiando el valor de las variables appMenu para cargar el menu de configuración y appname para cargar los logotipos correspondientes del repositorio de assets.

  3. Ajuste el import de los estilos correspondientes al sistema en styles.scss reemplazando el nombre del sistema (ver repositorio de assets).

  4. Ingrese a configuracion_cliente, allí genere una nueva aplicación, roles y opciones de menú para el nuevo cliente. Puede seguir el video instructivo

  5. Realice la instalación de las dependencias del cliente y ejecutelo para probar que todo funciona correctamente antes de subir los cambios al repositorio. No se ha incluido el package-lock.json para que este se genere de acuerdo a la versión de node que se encuentre instalada. Se recomienda usar Node 16.

# Instalar dependencias
npm i --legacy-peer-deps
# ejecutar el proyecto
npm run build
  1. Si todo funciona correctamente, realice el primer commit y subalo al repositorio de GitHub, después de esto se puede proceder con el despliegue en ambiente de pruebas junto en con el líder técnico.