Merge branch 'release-1.1.2'

#

#                               Image pour le dev.

#

#         Montage des sources attendu dans le volume "/webapp" du container.

#

###########################################################################################

FROM unicaen-dev-php7.0-apache

    PHP_CONF_DIR=/etc/php/7.0

## Installation de packages requis.

RUN apt-get update && apt-get install -y \

RUN apt-get update -qq && \

    apt-get install -y \

        ghostscript-x \

        php7.0-imagick

RUN ln -sf /dev/stdout /var/log/apache2/other_vhosts_access.log

RUN ln -sf /dev/stderr /var/log/apache2/error.log

# Config PHP.

ADD docker/php.conf ${PHP_CONF_DIR}/fpm/conf.d/sygal.ini

# Configuration Apache et FPM

# Configuration Apache, PHP et FPM

ADD docker/apache-ports.conf    ${APACHE_CONF_DIR}/ports.conf

ADD docker/apache-site.conf     ${APACHE_CONF_DIR}/sites-available/sygal.conf

ADD docker/apache-site-ssl.conf ${APACHE_CONF_DIR}/sites-available/sygal-ssl.conf

ADD docker/fpm/pool.d/app.conf  ${PHP_CONF_DIR}/fpm/pool.d/sygal.conf

ADD docker/fpm/conf.d/app.ini   ${PHP_CONF_DIR}/fpm/conf.d/sygal.ini

RUN a2ensite sygal sygal-ssl && \

    service php7.0-fpm reload

## Installation de l'applicatif

## Installation 

### Première obtention des sources et installation du serveur 

Pour ce qui est de l'installation du serveur d'application, n'ayant pas à Caen les compétences 

en déploiement Docker autres que pour le développement (d'où la présence d'un `Dockerfile` et d'un `docker-compose.yml`

dans les sources), nous documenterons une installation à l'ancienne.

Si vous voulez déployer l'application avec Docker, faites-le à partir du `Dockerfile` présent et n'hésitez pas à 

proposer des améliorations pour cette doc d'install!

### Première obtention des sources de l'application

Sur un serveur *Debian Stretch* de préférence, lancez les commandes suivantes pour obtenir les sources de SyGAL :

```bash

git clone https://git.unicaen.fr/open-source/sygal.git /var/www/sygal

```

Ensuite, placez-vous dans le répertoire des sources et jetez un oeil au script `Dockerfile.sh`.

### Configuration du serveur

Sur le serveur, placez-vous dans le répertoire des sources de SyGAL et jetez un oeil au script `Dockerfile.sh`.

Ce script est en quelque sorte l'équivalent du `Dockerfile` traduit en bash. 

(Vous y verrez que le dépôt git d'une image Docker Unicaen est cloné pour lancer 

son script `Dockerfile.sh` qui est lui aussi l'équivalent du `Dockerfile` de l'image 

NB: Vérifiez dans le script `Dockerfile.sh` que vous venez de lancer mais normalement 

`APACHE_CONF_DIR=/etc/apache2` et `PHP_CONF_DIR=/etc/php/7.0`.

### Installation d'une version précise 

### Installation d'une version précise de l'application

Normalement, vous ne devez installer que les versions officielles, c'est à dire les versions taguées, du genre `1.0.9`

par exemple.

### Fichiers de config de l'application

Placez-vous dans le répertoire de l'application puis déscendez dans le répertoire `config/autoload/`.

Placez-vous dans le répertoire de l'application puis descendez dans le répertoire `config/autoload/`.

Supprimez l'extension `.dist` des fichiers suivants :

- `local.php.dist`

#### `secret.local.php`

Concernant la config de connexion au WS, `'UCN'` doit être remplacé par le code établissement choisi lors

de la création de votre établissement dans la base de données (dans le script [`04-init.sql`](04-init.sql)) :

de la création de votre établissement dans la base de données (dans le script [`05-init.sql`](04-init.sql)) :

    'import-api' => [

        'etablissements' => [

                'url'      => 'https://sygal-import-ws:443',

                'proxy'    => false,

                'verify'   => false, // si true et faux certif : cURL error 60: SSL certificate problem: self signed certificate

                'user'     => 'sygal-app',

                'password' => 'xxxxxxxxxxx',

                'user'     => 'xxx',

                'password' => 'yyy',

Renseignez les infos de connexion à la BDD :

                    'CURRENT_SCHEMA' => $user,

La config fournie permet de simuler l'authentification Shibboleth de l'utilisateur 'premierf@univ.fr' 

créé en base de données (dans le script [`04-init.sql`](04-init.sql)) avec le rôle "Administrateur technique".

créé en base de données (dans le script [`05-init.sql`](04-init.sql)) avec le rôle "Administrateur technique".

Cela permet d'accéder aux pages de gestion des droits d'accès.

    'unicaen-auth' => [

                'HTTP_SN'             => 'Premier',

                'HTTP_SUPANNCIVILITE' => 'M.'

Théoriquement, à ce stade l'application SyGAL devrait être accessible.

## Dans l'application SyGAL elle-même

Si vous n'avez rien changé à la config de l'application concernant Shibboleth et si vous cliquez en haut à droite de

la page d'accueil de SyGAL sur "Connexion" puis sur "Fédération d'identité", vous devriez être dans la peau de 

François Premier, administrateur technique de test créé en base de données (dans le script [`04-init.sql`](04-init.sql)).

François Premier, administrateur technique de test créé en base de données (dans le script [`05-init.sql`](04-init.sql)).

### Droits d'accès

- le profil `BDD` au rôle *Bureau des doctorats UCN*

NB: "UCN" n'est qu'un exemple et pour vous ce sera le code établissement choisi lors

de la création de votre établissement dans la base de données (dans le script [`04-init.sql`](04-init.sql)) 

de la création de votre établissement dans la base de données (dans le script [`05-init.sql`](04-init.sql)) 

### Import

Placez-vous dans le répertoire de SyGAL sur le serveur pour lancer l'import puis la synchro des données.

Ce qui suit n'est possible que si le web service d'import de données est installé, si ce n'est pas le cas,

reportez-vous au [README du projet sygal-import-ws](https://git.unicaen.fr/open-source/sygal-import-ws).

reportez-vous au [README du projet sygal-import-ws](https://github.com/EsupPortail/sygal-import-ws).

### Lancement de l'import des données

return [

    'unicaen-app' => [

        'app_infos' => [

            'version' => '1.1.1',

            'date' => '25/02/2019',

            'version' => '1.1.2',

            'date' => '15/03/2019',

        ],

    ],

    'comment' => 'Fichier généré le 25/02/2019 à 13:34:10 avec /home/gauthierb/workspace/sygal/bump-version',

    'comment' => 'Fichier généré le 15/03/2019 à 11:40:07 avec /home/metivier/MyWeb/sygal/bump-version',

];

--

-- Pour faire simple... si le logo de votre COMUE doit figurer sur la page de couverture des thèses

-- (page générée par l'appli), alors vous devez lancer les 2 inserts ci-dessous.

-- (page générée par l'appli), alors personnalisez puis lancez les 2 inserts ci-dessous pour créer

-- un établissement "COMUE" dans la base de données.

--

INSERT INTO STRUCTURE (ID, SOURCE_CODE, SIGLE, LIBELLE, TYPE_STRUCTURE_ID, SOURCE_ID, CODE, HISTO_CREATEUR_ID, HISTO_MODIFICATEUR_ID)

select STRUCTURE_ID_SEQ.nextval, 'COMUE', 'NU', 'Normandie Université', null, 1, 'COMUE', 1, 1 from dual;

select

  STRUCTURE_ID_SEQ.nextval, 'COMUE',

  'NU',                   --> sigle ou abbréviation à personnaliser

  'Normandie Université', --> libellé à personnaliser

  null, 1, 'COMUE', 1, 1

from dual;

INSERT INTO ETABLISSEMENT (ID, STRUCTURE_ID, DOMAINE, SOURCE_ID, SOURCE_CODE, EST_COMUE, EST_MEMBRE, HISTO_CREATEUR_ID, HISTO_MODIFICATEUR_ID)

select ETABLISSEMENT_ID_SEQ.nextval, s.ID, 'normandie-univ.fr', 1, 'COMUE', 1, 0, 1, 1 from STRUCTURE s where s.SOURCE_CODE = 'COMUE';

select

  ETABLISSEMENT_ID_SEQ.nextval, s.ID,

  'normandie-univ.fr', --> domaine à personnaliser

  1, 'COMUE', 1, 0, 1, 1

from STRUCTURE s

where s.SOURCE_CODE = 'COMUE';