Instalación en modo desarrollo
Si eres desarrollador y quieres modificar y hacer cambios en el proyecto debes seguir estos pasos
Requisitos previos
- Node.js versión 18.0 o superior
- Git instalado en tu equipo
- Conexión a internet estable
- URL de la API backend o credenciales de entorno (proporcionadas por el administrador del sistema)
Pasos de instalación
1. Clonar el repositorio
git clone https://github.com/Xyro-SAS-Silveragro-SAS/MTS_POS.git
2. Ingresar a la capeta del código
cd MTS_POS
3. Verificar la rama en la que nos encontramos
git branch
Esto nos debe dar como resultado la rama main. Depende del programador crear ramas nuevas para realizar ajustes sobre el código
C:\Users\usuario\MTS_POS>git branch
* main
4. Instalación de los paquetes.
Es importante instalar los paquetes necesarios para que la plataforma funcione. Estos paquetes están especificados en el archivo package.json
{
"name": "pos",
"version": "0.0.0",
"scripts": {
"ng": "ng",
"start": "ng serve",
"build": "ng build",
"watch": "ng build --watch --configuration development",
"test": "ng test"
},
"private": true,
"dependencies": {
"@angular/animations": "^19.2.14",
"@angular/common": "^19.2.14",
"@angular/compiler": "^19.2.14",
"@angular/core": "^19.2.14",
"@angular/forms": "^19.2.14",
"@angular/platform-browser": "^19.2.14",
"@angular/platform-browser-dynamic": "^19.2.14",
"@angular/router": "^19.2.14",
"@angular/service-worker": "^19.2.14",
"@fortawesome/angular-fontawesome": "^1.0.0",
"@fortawesome/fontawesome-svg-core": "^6.4.2",
"@fortawesome/free-solid-svg-icons": "^6.4.2",
"@ng-select/ng-select": "^14.9.0",
"@popperjs/core": "^2.11.8",
"angular-datatables": "^16.0.0",
"bootstrap": "^5.3.2",
"crypto-js": "^4.2.0",
"datatables.net": "^1.13.6",
"datatables.net-dt": "^1.13.6",
"idb": "^7.1.1",
"jquery": "^3.7.0",
"rxjs": "~7.8.0",
"sweetalert2": "^11.7.22",
"tslib": "^2.3.0",
"zone.js": "~0.15.1"
},
"devDependencies": {
"@angular-devkit/build-angular": "^19.2.15",
"@angular/cli": "^19.2.15",
"@angular/compiler-cli": "^19.2.14",
"@types/crypto-js": "^4.1.1",
"@types/datatables.net": "^1.10.24",
"@types/jasmine": "~4.3.0",
"@types/jquery": "^3.5.16",
"jasmine-core": "~4.6.0",
"karma": "~6.4.0",
"karma-chrome-launcher": "~3.2.0",
"karma-coverage": "~2.2.0",
"karma-jasmine": "~5.1.0",
"karma-jasmine-html-reporter": "~2.0.0",
"typescript": "~5.5.4"
}
}
Para proceder con la instalación se debe realizar el siguiente comando:
npm install
5. Ejecución del sistema POS
Luego de la instalación de paquetes si todo ha salido bien deberán iniciar el proyecto con el comando
ng serve
la palabra ng hace referencia a el CLI de Angular que debió quedar instalado cuando se ejecuto el comando npm install. La palabra serve es una palabra o mando reservado por el CLI de Angular para correr el servicio.
Al correr el proyecto se mostrará en pantalla algo como esto:
Component HMR has been enabled, see https://angular.dev/hmr for more info.
Initial chunk files | Names | Raw size
main.js | main | 1.43 MB |
scripts.js | scripts | 575.49 kB |
styles.css | styles | 346.11 kB |
polyfills.js | polyfills | 89.77 kB |
| Initial total | 2.45 MB
Application bundle generation complete. [6.332 seconds]
Watch mode enabled. Watching for file changes...
NOTE: Raw file sizes do not reflect development server per-request transformations.
➜ Local: http://localhost:4200/
➜ press h + enter to show help
Lo único que resta por hacer es ingresar a la URL que el sistema genera en nuestro navegador de preferencia. Recomendamos usar Chrome para los procesos de desarrollo ya que el sistema POS es una aplicación PWA.
La url de desarrollo a la que ingresamos es:
Tener en cuenta que el puerto 4200 es el default de Angular, en caso de que el puerto 4200 esté ocupado por otra aplicación, Angular abrira el puerto siguiente: 4300 y así sucesivamente