README.md

# CHOUCAS Project

Over 15000 mountain rescue request by year are recorded in France. The Pelotons de Gendarmerie de Haute Montagne (PGHM) are the main mountain rescue teams.
In this context, CHOUCAS project aims to provide methods and tools to make and improve geographic data from different sources, and thinking models to help the decision process of locating victims in mountainous environment. The goal is to improve the response alert capability.

Following principles of CHOUCAS project, the application will be rewritten.

The application aims to connect:
* The applicant: person who launch the alert, who could be the victim or a third party.
*  The rescue team

The objective of this relation is to get the victim' localization from a manual research of geographic hints from different data sources as well as on the knowledge of the rescue team. This hint research is part of a process of reasoning, which consists of formulating hypotheses based on the initial information provided by the applicant, refining them gradually through dialogue and data analysis, and then deducing the most probable location of the victim.

The rescue application will therefore also have the task of assisting in locating the victim by providing the tools to manage the data necessary for the rescuers' decision-making: multi-source data (institutional or community data) and multi-format data (maps, topo-guides for hikes in paper format, vector data).

This application, although the initiative of the Grenoble PGHM, should have a national scope so that all PGHMs in France can use it.

> In this repo, the master branch contains the **lastest stable** version of the code. The real lastest version of the code (but **not necessarily stable**) is in the dev branch.

## Installation

### Requirements

#### Back-end

* PosgreSQL
* Postgis
* Python3
* Pip
* Virtualenv

#### Front-end

* NodeJs
* Angular/Cli

> To install Angular Cli, type this command `npm install -g @angular/cli`

### Installation (Back-end)

#### 1. Project init
```bash
$ git clone git@gricad-gitlab.univ-grenoble-alpes.fr:Projets-INFO4/19-20/8/app-pghm.git
$ cd app-pghm/choucas
$ source bin/activate
$ cd choucas
$ pip install -r requirements.txt
```

If is necessay, edit the setting file (`choucas/settings.py`) for database connection.

#### 2. Database creation

```bash
$ python manage.py makemigrations
$ python manage.py migrate
```

Now you have to create a super user:

```bash
$ python manage.py createsuperuser
```


#### 3. Load data (optional)

This part allows you to load test data or data to initialize the database.

```bash
$ python manage.py loaddata pghm/fixtures/xxxx.json
```

#### 4. Run server

```bash
$ python manage.py runserver
```

### Installation (Front-end)

#### 1. Setup

```bash
$ git clone git@gricad-gitlab.univ-grenoble-alpes.fr:Projets-INFO4/19-20/8/app-pghm.git
$ cd app-pghm/GendLoc
$ npm install
$ npm install -g @angular/cli
```

#### 2. Run 

```bash
$ npm start
```

Or

```bash
$ ng serve
```

### Troubleshooting

#### Version issue of libgeos

If there is an error that is raised due to a version problem we advise you to read this [snippet](https://gricad-gitlab.univ-grenoble-alpes.fr/Projets-INFO4/19-20/8/app-pghm/snippets/167)

#### pg_config is missing

If during installation you get an error saying that pg_config is missing, just install the `postgresql-devel` package. Source [Stackoverflow](https://stackoverflow.com/questions/11618898/pg-config-executable-not-found)