Date de lancement	Septembre 2016
État du Service
Concepteurs	Dorian Becker Alexandre Narbonne
Sources	https://github.com/gadzorg/gorg_mail

Hébergement

L'hébergement se fait temporairement chez Heroku le temps que l'infra locale permette de supporter les appli.

Environnement	Herbergeur	NDD
Recette	Heroku	https://emails.gadz.org/
Production	Heroku	https://rec-gorg-mail.herokuapp.com/

Base

Environnement	Base	Nom	User	Port
Recette	MySQL Gadz.org	rec_gorg_mail	rec_gorg_mail
Production	MySQL Gadz.org	prod_gorg_mail	prod_gorg_mail

Arret / Démarage

Suivre la procédure Démarrer/Arrêter une application sur Heroku

Accéder aux Logs

Suivre la procédure Accéder aux logs d'une application Heroku

Connexion

heroku run rails console --app gorg-mail

Usage

Inscription d'un nouvel utilisateur

Les utilisateurs sont inscrit automatiquement dès leur première connexion via le CAS. Il est vivement déconseillé de créer des utilisateur manuellement

Gestion des droits

Recherche du compte puis passage admin :

Par le hruid ou le uuid :

User.find_by(uuid: '1234-1234-13456-616')
User.find_by(hruid: 'prenom.nom.proms_ou_soce')

Par ID de l'utilisateur : (normalement affiché dans l'url quand le user se rend sur "Mon profil" https://emails.gadz.org/users/XXX)
User.find(N°ID)

Pour passer le compte en admin, ajouter " .add_role :admin" :

User.find_by( 'prenom.nom.soce').add_role :admin

Retirer les droits d'admin à un compte :

Rechercher le compte comme à l'étape précédente, puis :

User.find_by(hruid: 'prenom.nom.proms').remove_role :admin

Si nécessaire, il également possible de passer une personne administrateur directement en base SQL en modifiant le role_id à 1 (admin) ou 2 (support)

Exploitation : Procédures particulières

Suppression d'un compte via Ruby

Se connecter en ligne de commande sur Heroku et lancer la console Ruby : https://devcenter.heroku.com/articles/getting-started-with-ruby#start-a-console

Pour se faire, une fois l'outil Heroku CLI installé (https://devcenter.heroku.com/articles/heroku-cli) il faut se connecter à l'appli ("gorg-mail" pour la production) et lancer la console rails (https://devcenter.heroku.com/categories/command-line) :

heroku run rails console --app gorg-mail

Pour supprimer un compte, il existe plusieurs méthodes :

Par le hruid ou le uuid :

User.find_by(uuid: "1234-1234-13456-616")
User.find_by(hruid: "prenom.nom.proms_ou_soce")

Par numéro de fiche : saisir le numéro de la fiche du compte (retrouvable via l'url de la forme https://emails.gadz.org/users/XXX où XXX est le numéro)

Vérifier avec :

User.find(N°fiche_du_compte)

Puis le détruire/supprimer avec :

User.find(N°fiche_du_compte).destroy

Mettre à jour l'UUID si l'édition en admin via l'interface graphique ne se fait pas

User.find(N°fiche_du_compte).update_attributes(uuid: "1234-1234-13456-616")