Proyecto Mandarina

Hola, bienvenide!

Aquí están las instrucciones para instalar el entorno de desarrollo de este proyecto. Ésta es la parte web nacida del segmentador asistido para el censo de población, hogares y viviendas de la ronda 2020 de Argentina.

Pensado como una interfaz para ejecutar el Segmentador-core y también como interfaz de carga de los datos mínimos necesarios para éste.

Preparando junto al core la información en la base de datos para el plugin de QGIS, salida gráfica.

Intentado implementar el almacenamiento relacional de la información geoestadística imaginado x JC llamado toto5.

Todo aporte es bienvenido y agradecido.

salud! M.

Introducción

En este repositorio se encunetran 4 ramas principales.

• master donde hago los desarrollos
• dev la versión que usada en el servidor de integración.
• uat versión de testing
• prd versión para producción

Prerrequisitos (las instrucciones asumen que se está usando Ubuntu)

• PHP 8.1 o superior: php-mbstring php-dom php-zip php-gd php-pdo-pgsql php-cli php-curl composer

sudo apt install php-mbstring php-dom php-zip php-gd php-pdo-pgsql php-cli php-curl
curl -sS https://getcomposer.org/installer | php

• gdal (ogr2ogr)

sudo apt-get install python3.6
sudo add-apt-repository ppa:ubuntugis/ppa && sudo apt-get update
sudo apt-get update
sudo apt-get install gdal-bin
sudo apt-get install libgdal-dev
export CPLUS_INCLUDE_PATH=/usr/include/gdal
export C_INCLUDE_PATH=/usr/include/gdal

• pgdbf postgis

sudo apt install pgdbf postgis

• python3 pip psycopg2

sudo apt install python3-dev python3-pip
pip3 install psycopg2
pip3 install GDAL

--- pip3 install psycopg2-binary ---

• y usamos NodeJs también. Lo manejamos con n y instalamos la versión 12

sudo apt install npm
npm install -g n
n 12

Para instalar el entorno de desarrollo se debe, (según extracto de guia):

• Clonar repositorio GitHub

git clone https://github.com/manureta/segmenter.git --recurse-submodules 

• cambiar directorio a su proyecto

cd segmenter

• Instalar Composer Dependencias

composer install

• Instalar NPM Dependencias

npm install

• Definir el entorno creando usando .env como template,
  cp .env.example .env
  editarlo para configurar la aplicación a que direccione a la BD

APP_URL=<url_del_servidor_donde_corre_la_aplicacion_laravel>:<puerto_del_servicio_de_la_aplicación>

DB_HOST=<url_del_servidor_de_DB_postgresql>
DB_DATABASE=<base_de_datos>
DB_USERNAME=<usuario_del_segmentador>
DB_PASSWORD=<clave_del_usuario_del_segmentador>

• Generar una app encryption key

php artisan key:generate

• Crear la base de datos mencionada en .env, conectarse, cargar postgis y crear el usuario del segmentador

createdb <base_de_datos> -h <url_del_servidor_de_DB_postgresql> -U <algun_db_admin>
psql <base_de_datos> -h <url_del_servidor_de_DB_postgresql> -U <algun_db_admin> -c 'create extension postgis;' 

• Crear la estructura de la base de datos usando migrate

php artisan migrate

• Cargar los datos usando db:seed

php artisan db:seed

• Para configurar las tareas programadas de laravel agregamos al cron (vía crontab -e)

* * * * * cd segmenter && php artisan schedule:run >> /dev/null 2>&1

• En caso que no haya iniciado el submodule con --recursive al hacer el clone principal.

Debera agrega como submodule el proyecto de Segmentacion-CORE, para iniciarlo luego de clonar el repo principal debe ejecutar:

git submodule init
git submodule update

• Para correr la aplicación en desarrollo:

Run app in http://localhost:8000

php artisan serve

usar el parámetro APP_URL definido en el .env y elegir un puerto libre para que la app laravel esté escuchando

php artisan serve --host=<url_del_servidor_donde_corre_la_aplicacion_laravel> --port=<puerto_del_servicio_de_la_aplicación>