Skip to content

Sitio web desarrollador para la empresa de gestión catastral de Colombia, enfocado en la fácil publicación y administración de comunicados, informes y servicios para la ciudadanía

Notifications You must be signed in to change notification settings

dantech99/Gesccol-Web-App

Repository files navigation

Gesccol Web | GESCCOL E.I.C.E

Somos el gestor catastral, habilitado por el IGAC, para realizar las actividades de formación, actualización y conservación catastral, en el municipio de Sahagún – Córdoba. La gestión catastral es un servicio público desarrollado a través de los procesos de formación, actualización, conservación y difusión de la información física, jurídica y económica de los predios, para una mejor administración de los territorios.

gesccol

Documentacion Técnica del proyecto

Tabla de contenido

  1. Aserca del Proyecto
  2. Como Empezar
  3. Uso
  4. Estructura del Proyecto
  5. Licencia
  6. Documentacion para Usuarios
  7. Contacto

Aserca del Proyecto

Gesccol web es un sitio contruido para la empresa de gestion catastral GESCCOL E.I.C.E., aqui se detallara la instalacion del proyecto cuando es clonado en un equipo nuevo y se documentara cada uno de los componentes y funciones que posee el proyecto.

Tecnologias usadas

  • php
  • Laravel
  • JavaScript
  • Tailwindscss

Como Empezar

Prerrequisitos

  1. tener composer instalado globalmente
  2. Tener Instalado GIT
  3. Contar con un entorno de desarrollo local, recomendable xampp

Instalacion

Instalar las dependencias del proyecto

Cuando guardas tu proyecto Laravel en un repositorio GIT, en el archivo .gitignore se excluye la carpeta vendor que es donde están las librerías que usa tu proyecto, es por eso que se debe correr en la terminal una instrucción que tome del archivo composer.json todas las referencias de las librerías que deben estar instaladas en tu proyecto.

en la consola escribe el siguiente comando para empezar a instalar esas dependencias

composer install

Configuracion

Generar arhivos de variables de entorno o .env

Por seguridad el archivo .env está excluido del repositorio, para generar uno nuevo se toma como plantilla el archivo .env.example para copiar este archivo en una nuevo escribe en tu terminal:

cp .env.example .env

Generar Key

Para que tu proyecto en Laravel corra sin problemas es necesario generar una key de seguirdad, para ello en tu terminal corre el siguiente comando:

php artisan key:generate

Base de datos

la base de datos utilizada en este proyecto es MySQL, al intalar xampp este ya trae MySQL por defecto, se debe crear la base de datos de acuerdo con el nombre que se establecio en la variable de entorno DB_DATABASE=gesccol_app en el archivo .env

Symbolic Link | vinculo simbolico

el proyecto contiene archivos estaticos como imagenes y archivos pdf, por lo que es necesario generar un link simbolico que genere un enlace entre la carpeta storage y la public y que el sistema puede tener accesos a estos archivos.

php artisan storage:link

Migraciones y Seeders

para correr las migraciones en la base de datos de las tablas creadas se utiliza el comando

php artisan migrate

(opcional) para correr seeder y factories se debe ejecutar el comando

php artisan migrate --seed

Uso

En local

Por medio del entorno de desarrollo xampp se puede ejcutar el proyecto, si la instalacion y configuracion fue correcta todo deberia ir bien y empezar a incluir nuevas funciones, se recomienda leer todo el codigo del proyecyto que tambien estara documentado, tanto como en esta documentacion como tambien en el mismo codigo para mejor el entendimiento, puede configurar un dominio personalizado desde xampp, mira este recurso para aprender a hacerlo

Tambien pueden Ejecutar el comando php artisan serve para levantar un servidor local con laravel, sin embargo xampp debe estar encendido para que la base de datos funcione

Estructura Del Proyecto

Aqui se detallara la estructura del proyecto, sus migraciones, modelos, vistas etc..

Migraciones

migraciones

Polices

Polices

Seeders

Seeders

Factories

Factories

Modelos

Modelos

Controladores

Controladores Rutas Publicas

Controladores

Controladores Rutas Administrador

controladores admin

Vistas

Publicas

vistas publicas

Administracion

vistas de administracion

Plantilla

Plantilla

Componentes

componentes componentes de livewire componentes livewire

Rutas

Rutas Publicas

rutas publicas

Rutas Administracion

rutas administracion

About

Sitio web desarrollador para la empresa de gestión catastral de Colombia, enfocado en la fácil publicación y administración de comunicados, informes y servicios para la ciudadanía

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published