Este documento es el manual de usuario de instalación del aplicativo para manejo de versiones, tener en cuenta que para muchos pasos es necesario el acompañamiento del desarrollador.

- Tener instalado Node js en caso de no tenerlo instalarlo, dar click en la imagen de arriba, donde esta el logo.

- Descargar el ejecutable con el proyecto.

http://adacsc.co:1443/svn/repository/ADA/SICOF/Estructuras%20cargas%20datos/hooks.exe

- Tener instalado el tortoisseSVN.

- Tener instalado por lo menos el Oracle Instant Client basic x64, dar click en la imagen de oracle de arriba para la descarga.

- Conocer las credenciales de la base de datos a conectar.

- Tener conocimientos basicos sobre los hooks y comandos del svn.

- Tener instalado vscode (preferencialmente) o algún editor de codigo.

1. Descargar el codigo del repositorio.

2. Crear una carpeta y utilizando tortoisse hacer esa carpeta un repositorio.

3. En la carpeta que se genera con el nombre hooks ingresar y pasar los archivos descargados del repositorio a esta carpeta, se debe ver de esta forma, excepto por el archivo de pruebas que no es necesario.

4. Luego de tener el codigo del repositorio en la carpeta hooks, abrir la carpeta hooks en vscode o el editor elegido y ejecutar los siguientes comandos.

CONTROL + BLOCK MAYUS + Ñ -- Abre la terminal

Ejecutar el siguiente comando en la consola.

npm install oracledb@4.2.0 -- instala la ultima version compatible con oracle 11g
npm i -- Instala las dependencias necesarias

Luego

cd ventana -- Cambiar de carpeta

y

npm install oracledb@4.2.0 -- instala la ultima version compatible con oracle 11g
npm i -- Instala las dependencias necesarias

5. Esto generara una carpeta llamada node_modules y dos archivos package en cada carpeta(hooks y ventana), pero es algo normal.

6. Despues de esto se deben realizar varias verificaciones para asegurar que este funcionando bien, ejecutar los siguientes pasos. Abrir el cmd y ejecutar el siguiente comando.

netstat -ano | findstr 3000 -- No debe devolver nada,  no de ser asi hablar con el desarrollador

Volver a vscode y a la terminal y ejecitar el siguiente comando.

cd ventana -- Si no estas en la carpeta ventana

Luego

node backend.js -- Debe devolver un aviso de que se esta ejecutando en el puerto 3000

Y volver abrir el cmd y ejecutar el siguiente comando.

netstat -ano | findstr 3000 -- Debe devolver algo, de no ser asi hablar con el desarrollador

En caso de que todo funcione bien.

7. Luego de esto se deben configurar los hooks apuntando al repositorio en el que se desea implementar la funcionalidad, se preparo un video para esto, asi que aqui comparto el [enlace](https://drive.google.com/file/d/1IErreVaCkDYavLUN9cMUXLgdkDAj1hle/view?usp=drivesdk).

8. Por ultimo se debe validar recuerda que se debe validar que tanto el client x64 de oracle como node js esten agregados en las variables e entorno y tener instalado la linea de comandos de tortoisseSvn (obligatorio).

9. Se debe setear la ruta del repositorio también en el codigo ya que este extrae la información directamente del svnserver, este se debe setear en el archivo take_commit y el archivo backend.js, tener en cuenta que tambíen se deben setear las rutas en el post y pre commit, dependiendo de como organizes la carpeta, crear la carpeta repositorio en la ruta C:, recomendablemente.

Notas: Se debe modificar en el codigo la ruta del svn donde se quiere hacer commit para que pueda traer los datos ya las copnexiones vienen seteados en el codigo para la base de datos deben tener conexión a internet y a la VPN para la conexión a la base de datos.

El repositorio se debe setear en el archivo backend.js y take_commit.js

Respecto al funcionamiento del aplicativo se debe hacer lo siguiente.

Se debe al igual que siempre dar click derecho y dar en commit.

Al igual que siempre poner notas al commit indicando cosas importantes sobre este commit

Luego le debes dar en el boton de commit y esperar unos segundos que suba el programa, luego va a salir un formulario de la siguiente manera.

En este se deben llenar todos los campos.

- Campo version: Se debe ingresar la versión a desplegar la que va a salir a producción.

- Campo Descripción: informacion acerca del cambio o que se esta liberando.

- Campo S_FUNCIONAL: Información sobre la solución que se dio al problema presentado en palabras mas sencillas.

- Campo S_TECNICA: Información sobre la solución que se le dio al problema se puede incluir la información tecnica.

Notas: Alguna observación o tema a tener en cuenta sobre la liberación de esta versión.

Luego dar click en guardae debe salir un aviso de datos guardados, cierre la ventana y espero pocos segundos a que se termine de realizar el commit y ese sería el procedimiento.