Manual de Instalación
Manual de Instalación
Descripción general
Este proyecto tiene como objetivo desarrollar una herramienta de software para la gestión
de empleados y nomina en la nube. El software podrá ser utilizado por usuarios de
empresas pymes que requieran llevar un mejor control en la gestión de sus funcionarios.
MANUAL DE PROGRAMADOR
ESTRUCTURA DE DIRECTORIOS
Nota: el repositorio se encuentra en la dirección: https://github.com/CorvusLab/geneticapp
El repositorio del proyecto está distribuido de la siguiente manera:
routes: contiene las rutas web y api del sistema, actualmente solo se utiliza el
archivo api.php
storage: link simbólico que se utiliza para almacenar archivos de los usuarios o de
la aplicación.
ENTORNO DE DESARROLLO
Para trabajar con el proyecto se requiere tener instalados los siguientes programas y
dependencias.
PHP 7.1. *, 7.2. *, o 7.3. * (El Proyecto se encuentra con PHP 7.3)
MYSQL
COMPOSER
LARAVEL 5.7
GIT
Node - NPM
PHP 7.3
Link de descarga: https://www.php.net/downloads.php
Windows: https://windows.php.net/download#php-7.3
Composer
MYSQL
Es el motor de base de datos que fue concebido para la implementación de la aplicación.
Link de descarga: https://www.mysql.com/downloads/
Laravel
Git
Este gestor de versiones fuel el que se seleccionó para llevar el control de las versiones
de la aplicación, para descargar el proyecto del repositorio se deben realizar los
siguientes pasos:
Abrir la terminal
Clonar el repositorio con el siguiente comando (Hasta la fecha hoy 09 de junio de
2019, los últimos cambios se han trabajado en la rama cristhian)
Una vez descargado el repositorio, se deben instalar las dependencias que vienen
con el framework y las que se han instalado. Para ello se debe ejecutar el siguiente
comando desde la terminal
composer update
Después se debe renombrar el archivo env.example a únicamente .env y se
ejecuta el siguiente comando para generar key secret de la aplicación:
Nota: La configuración de dompdf establece una carpeta para guardar las fuentes
que se van a usar al momento de generar los archivos pdf, esta carpeta se llama
fonts y se encuentra dentro de la carpeta storage
Por defecto el archivo .env contiene una configuración inicial, los parámetros de la
base de datos deben ser cambiados si es necesario. Una vez configurados los
parámetros de la base de datos, se procede a correr las migraciones.
Migraciones
Hasta el día de hoy la aplicación no cuenta con un sistema de roles de usuario, por
ende, únicamente existe una tabla llamada admins, en esta tabla se pretende
almacenar la información de los usuarios administradores de la aplicación (o cual
sea el rol). Para crear un usuario actualmente la única manera es hacerlo directo
desde la base de datos, para ello se debe insertar manualmente teniendo en
cuenta que el campo password de la tabla debe tener un cifrado, la herramienta
que se utiliza para crear la contraseña cifrada se encuentra en el siguiente link:
https://bcrypt-generator.com/
Node – NPM
Con lo anterior ya se tendrán instaladas las dependencias que usa Laravel mix, así
como también las requeridas por el proyecto para diferentes funcionalidades de
Vue. Para más información sobre las dependencias instaladas, se puede consultar
el archivo package.json.
Para correr el servidor del aplicativo se utiliza el comando php artisan serve
Después se debe abrir otra pestaña o ventana del terminal y compilar los archivos
con Laravel mix, para mayor facilidad se debe ejecutar el comando npm run watch
Ejemplo:
Por último, se habrá ingresado al inicio de la aplicación