1,8 → 1,8 |
<?php |
/** |
* Statistiques par année sur l'utilisation de Identiplante / Pictoflora |
* Accès aux sous-services de statistiques pour Identiplante / Pictoflora |
* |
* Documentation: http://www.tela-botanica.org/wikini/DevInformatiques/wakka.php?wiki=AppliDelStats |
* @see Documentation : <http://www.tela-botanica.org/wikini/DevInformatiques/wakka.php?wiki=AppliDelStats> |
* |
* @category DEL |
* @package Services |
17,314 → 17,118 |
*/ |
class Statistiques extends RestService { |
|
protected $bdd; |
private $parametres = array(); |
private $ressources = array(); |
private $methode = null; |
private $serviceNom = 'statistiques'; |
private $sousServiceNom = null; |
private $cheminCourant = null; |
|
private $conteneur; |
|
/** Indique si oui (true) ou non (false), on veut utiliser les paramètres bruts. */ |
protected $utilisationParametresBruts = true; |
|
public function __construct() { |
$this->bdd = $this->getBdd(); |
$this->cheminCourant = dirname(__FILE__).DS; |
} |
|
// GET |
public function consulter($ressources, $parametres) { |
$resultat = ''; |
$reponseHttp = new ReponseHttp(); |
$this->methode = 'consulter'; |
$this->initialiserRessourcesEtParametres($ressources, $parametres); |
return $this->executerService(); |
} |
|
// méthode à appeler |
$methode = "tout"; |
if (isset($ressources[0])) { |
$methode = $ressources[0]; |
} |
// année à considérer - par défaut pas de filtrage |
$annee = null; |
if (isset($parametres['annee'])) { |
$annee = $parametres['annee']; |
} |
//echo "Année: $annee\nMéthode: $methode\n"; |
private function initialiserRessourcesEtParametres($ressources, $parametres = array()) { |
$this->ressources = $ressources; |
$this->parametres = $parametres; |
} |
|
// appel |
if (method_exists($this, $methode)) { |
try { |
$retour = call_user_func(array($this, $methode), $annee); |
$reponseHttp->setResultatService($retour); |
} catch (ServiceFoiraxException $e) { |
// @TODO renvoyer 500 |
$reponseHttp->ajouterErreur($e); |
} |
} else { |
// @TODO renvoyer 500 |
$reponseHttp->ajouterErreur(new Exception("Erreur: la méthode \"$methode\" n'existe pas<br/>" . $this->utilisation())); |
private function executerService() { |
$reponseHttp = new ReponseHttp(); |
try { |
$this->conteneur = new Conteneur($this->parametres); |
$resultat = $this->traiterRessources(); |
$reponseHttp->setResultatService($resultat); |
} catch (Exception $e) { |
$reponseHttp->ajouterErreur($e); |
} |
|
// merci au revoir |
$reponseHttp->emettreLesEntetes(); |
$corps = $reponseHttp->getCorps(); |
|
return $corps; |
} |
|
// Renvoie la liste des méthodes disponibles |
private function utilisation() { |
return "<br/>Méthodes disponibles:<ul>". |
"<li>tout</li>". |
"<li>moyenneObsSansNomParMois</li>". |
"<li>moyenneObsIdentifieesParMois</li>". |
"<li>pourcentageObsIdentifieesEnFinDAnnee</li>". |
"<li>pourcentageObsIdentifieesEnFinDAnneePlusPlus</li>". |
"<li>moyenneActionsParJour</li>". |
"<li>personnesEnvoyantUnePropositionParMois</li>". |
"</ul>"; |
private function traiterRessources() { |
$this->analyserRessources(); |
$retour = $this->initialiserService(); |
return $retour; |
} |
|
// retourne toutes les stats pour l'année spécifiée |
protected function tout($annee=null) { |
$moyenneObsSansNomParMois = $this->moyenneObsSansNomParMois($annee); |
$moyenneObsIdentifieesParMois = $this->moyenneObsIdentifieesParMois($annee); |
$pourcentageObsIdentifieesEnFinDAnnee = $this->pourcentageObsIdentifieesEnFinDAnnee($annee); |
$pourcentageObsIdentifieesEnFinDAnneePlusPlus = $this->pourcentageObsIdentifieesEnFinDAnneePlusPlus($annee); |
$moyenneActionsParJour = $this->moyenneActionsParJour($annee); |
$personnesEnvoyantUnePropositionParMois = $this->personnesEnvoyantUnePropositionParMois($annee); |
|
return array( |
'annee' => $annee ? intval($annee) : null, |
'moyenneObsSansNomParMois' => $moyenneObsSansNomParMois, |
'moyenneObsIdentifieesParMois' => $moyenneObsIdentifieesParMois, |
'pourcentageObsIdentifieesEnFinDAnnee' => $pourcentageObsIdentifieesEnFinDAnnee, |
'pourcentageObsIdentifieesEnFinDAnneePlusPlus' => $pourcentageObsIdentifieesEnFinDAnneePlusPlus['pourcentage'], |
'moyenneActionsParJour' => $moyenneActionsParJour, |
'personnesEnvoyantUnePropositionParMois' => $personnesEnvoyantUnePropositionParMois['nombre'] |
); |
private function analyserRessources() { |
if ($this->methode == 'consulter') { |
$this->sousServiceNom = 'statistiques-par-annee'; |
} |
if ($this->sousServiceNom == null) { |
$this->lancerMessageErreurRessource(); |
} |
} |
|
// proxy pour le widget de stats |
protected function observations($annee) { |
return $this->tout($annee); |
private function lancerMessageErreurRessource() { |
$ressource = $this->sousServiceNom.'/'.implode('/', $this->ressources); |
$message = "La ressource demandée '$ressource' ". |
"n'est pas disponible pour le service {$this->serviceNom} !\n". |
self::getDoc(); |
$code = RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE; |
throw new Exception($message, $code); |
} |
|
// Retourne le nombre moyen d'observations non identifiées envoyées par mois, pour l'année $annee |
protected function moyenneObsSansNomParMois($annee) { |
$req = "SELECT AVG(parMois.compte) as moyenne FROM". |
" (SELECT count(*) as compte, CONCAT(YEAR(date_transmission),'-',MONTH(date_transmission)) as anneemois". |
" FROM del_observation". |
" WHERE "; |
if ($annee !== null) { |
$req .= "YEAR(date_transmission) = '" . $annee . "' AND "; |
} |
// Obs marqués comme "aDeterminer" ou ayant un faible niveau de certitude |
$req .= " (mots_cles_texte LIKE '%aDeterminer%'". |
" OR certitude = 'aDeterminer'". |
" OR certitude = 'douteux'". |
// Obs n'ayant pas de nom_sel_nn (détermination non choisie parmi le référentiel) |
" OR nom_sel_nn IS NULL". |
" OR nom_sel_nn = 0". |
" OR id_observation IN". |
// Obs ayant une proposition initiale "vide" (sans no_sel_nn) |
" (SELECT DISTINCT ce_observation". |
" FROM del_commentaire". |
" WHERE proposition_initiale = 1". |
" AND (nom_sel_nn IS NULL OR nom_sel_nn = '')". |
")". |
")". |
" GROUP BY anneemois". |
" ORDER BY anneemois DESC) as parMois;"; |
|
$res = $this->bdd->recupererTous($req); |
return intval($res[0]['moyenne']); |
public static function getDoc() { |
return "Les URLs disponibles pour ce service sont :\n". |
" * en GET :\n". |
" - statistiques/tout\n". |
" - statistiques/moyenneObsSansNomParMois\n". |
" - statistiques/moyenneObsIdentifieesParMois\n". |
" - statistiques/pourcentageObsIdentifieesEnFinDAnnee\n". |
" - statistiques/pourcentageObsIdentifieesEnFinDAnneePlusPlus\n". |
" - statistiques/moyenneActionsParJour\n". |
" - statistiques/personnesEnvoyantUnePropositionParMois\n"; |
} |
|
// Retourne la moyenne par mois sur l'année en cours, des propositions marquées comme "retenues" |
// dont le dernier vote est dans l'année considérée (comptées en groupant par mois du dernier vote) |
protected function moyenneObsIdentifieesParMois($annee) { |
$req = "SELECT AVG(valideesparmois) as moyenne FROM (". |
" SELECT count(*) as valideesparmois, CONCAT(YEAR(maxdate), '-', MONTH(maxdate)) as anneemois". |
" FROM (". |
// Compte et date du dernier vote des propositions marquées comme "retenues" |
" SELECT count(*), MAX(dcv.date) as maxdate". |
" FROM del_commentaire dc". |
" LEFT JOIN del_commentaire_vote dcv ON dcv.ce_proposition = dc.id_commentaire". |
" WHERE proposition_retenue = 1". |
" GROUP BY dc.id_commentaire"; |
private function initialiserService() { |
$classe = $this->obtenirNomClasseService($this->sousServiceNom); |
$chemins = array(); |
$chemins[] = $this->cheminCourant.$this->serviceNom.DS.$classe.'.php'; |
$chemins[] = $this->cheminCourant.'commun'.DS.$classe.'.php'; |
$retour = ''; |
$service = null; |
|
if ($annee !== null) { |
// Le dernier vote doit être dans l'année considérée (@ACHTUNG bancal) |
$req .= " HAVING MAX(YEAR(dcv.date)) = '" . $annee . "'"; |
foreach ($chemins as $chemin) { |
if (file_exists($chemin)) { |
require_once $chemin; |
$service = new $classe($this->conteneur); |
if ($this->methode == 'consulter') { |
$retour = $service->consulter(); |
} else { |
$message = "Le sous-service '{$this->sousServiceNom}' du service '{$this->serviceNom}' ". |
"ne possède pas de méthode '{$this->methode}' !"; |
$code = RestServeur::HTTP_NON_IMPLEMENTE; |
throw new Exception($message, $code); |
} |
} |
$req .= ") as temp". |
" GROUP BY anneemois) as temp2;"; |
|
$res = $this->bdd->recupererTous($req); |
return intval($res[0]['moyenne']); |
} |
|
// Version améliorée mais non optimale (prend en compte les consensus non validés) |
// @TODO on devrait croiser les IDS pour ne pas prendre en compte les obs validées ou en |
// consensus, mais qui datent des années précédentes |
// @ACHTUNG mache pas, dépasse les 100% (voir Wiki) |
protected function pourcentageObsIdentifieesEnFinDAnneePlusPlus($annee) { |
// Obs ayant atteint un consensus cette année |
$req1 = "SELECT count(*) as nombre FROM(". |
" SELECT id_observation, id_commentaire, id_vote, nbvotes FROM (". |
" SELECT do.id_observation, dc.id_commentaire, dcv.id_vote, count(dcv.id_vote) as nbvotes". |
" FROM del_commentaire dc". |
" LEFT JOIN del_observation do ON do.id_observation = dc.ce_observation". |
" LEFT JOIN del_commentaire_vote dcv ON dc.id_commentaire = dcv.ce_proposition". |
" AND dcv.valeur = 1". |
" AND dc.proposition_retenue = 0". |
" GROUP BY dc.id_commentaire"; |
if ($annee != null) { |
$req1 .= " HAVING MAX(YEAR(dcv.date)) = '" . $annee . "'"; |
} |
$req1 .= " ) as temp GROUP BY id_observation". |
") as temp2;"; |
$obsEnConsensus = $this->bdd->recupererTous($req1); |
$oc = intval($obsEnConsensus[0]['nombre']); |
|
// Obs ayant une "proposition retenue" cette année |
$req2 = "SELECT count(*) as nombre FROM (". |
" SELECT count(DISTINCT id_observation), MAX(dcv.date) as maxdate". |
" FROM del_commentaire dc". |
" LEFT JOIN del_commentaire_vote dcv ON dcv.ce_proposition = dc.id_commentaire". |
" LEFT JOIN del_observation do ON do.id_observation = dc.ce_observation". |
" WHERE proposition_retenue = 1"; |
if ($annee != null) { |
$req2 .= " AND YEAR(do.date_transmission) = '" . $annee . "'"; |
if (is_null($service)) { |
$ressource = $this->sousServiceNom.'/'.implode('/', $this->ressources); |
$message = "Le classe '$classe' correspondant à la ressource '$ressource' ". |
"est introuvable par le service '{$this->serviceNom}' !"; |
$code = RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE; |
throw new Exception($message, $code); |
} |
$req2 .= " GROUP BY dc.id_commentaire"; |
if ($annee != null) { |
$req2 .= " HAVING MAX(YEAR(dcv.date)) = '" . $annee . "'"; |
} |
$req2 .= ") as temp;"; |
$nbObsValidees = $this->bdd->recupererTous($req2); |
$ov = intval($nbObsValidees[0]['nombre']); |
|
// Nombre d'obs sans nom soumises cette année |
$req3 = "SELECT count(*) as nombre". |
" FROM del_observation". |
" WHERE "; |
if ($annee != null) { |
$req3 .= "YEAR(date_transmission) = '" . $annee . "' AND "; |
} |
$req3 .= "(mots_cles_texte LIKE '%aDeterminer%'". |
" OR certitude = 'aDeterminer'". |
" OR certitude = 'douteux'". |
" OR nom_sel_nn IS NULL". |
" OR nom_sel_nn = 0 OR". |
" id_observation IN (". |
" SELECT DISTINCT ce_observation". |
" FROM del_commentaire". |
" WHERE proposition_initiale = 1". |
" AND (nom_sel_nn IS NULL OR nom_sel_nn = '')". |
" ))"; |
$nbObsSansNom = $this->bdd->recupererTous($req3); |
$osn = intval($nbObsSansNom[0]['nombre']); |
|
return array( |
'observationsEnConsensus' => $oc, |
'observationsValidees' => $ov, |
'observationsSansNom' => $osn, |
'pourcentage' => ($osn == 0 ? 0 : (($oc + $ov) / $osn) * 100) |
); |
return $retour; |
} |
|
protected function pourcentageObsIdentifieesEnFinDAnnee($annee) { |
$req = "SELECT (". |
" SELECT count(*) FROM (". |
" SELECT count(DISTINCT id_observation), MAX(dcv.date) as maxdate". |
" FROM del_commentaire dc". |
" LEFT JOIN del_commentaire_vote dcv ON dcv.ce_proposition = dc.id_commentaire". |
" LEFT JOIN del_observation do ON do.id_observation = dc.ce_observation". |
" WHERE proposition_retenue = 1"; |
if ($annee !== null) { |
$req .= " AND YEAR(do.date_transmission) = '" . $annee . "'"; |
} |
$req .= " GROUP BY dc.id_commentaire"; |
if ($annee !== null) { |
$req .= " HAVING MAX(YEAR(dcv.date)) = '" . $annee . "'"; |
} |
$req .= ") as temp)". |
" /". |
" (SELECT count(*)". |
" FROM del_observation". |
" WHERE "; |
if ($annee !== null) { |
$req .= "YEAR(date_transmission) = '" . $annee . "' AND "; |
} |
$req .= " (mots_cles_texte LIKE '%aDeterminer%'". |
" OR certitude = 'aDeterminer'". |
" OR certitude = 'douteux'". |
" OR nom_sel_nn IS NULL". |
" OR nom_sel_nn = 0 OR". |
" id_observation IN (". |
" SELECT DISTINCT ce_observation". |
" FROM del_commentaire". |
" WHERE proposition_initiale = 1". |
" AND (nom_sel_nn IS NULL OR nom_sel_nn = '')". |
" )". |
" )". |
" ) * 100 as pourcentage;"; |
|
$res = $this->bdd->recupererTous($req); |
return floatval($res[0]['pourcentage']); |
private function obtenirNomClasseService($mot) { |
$classeNom = str_replace(' ', '', ucwords(strtolower(str_replace('-', ' ', $mot)))); |
return $classeNom; |
} |
|
// Retourne la moyenne sur l'année du nombre d'actions (commentaire ou vote) par jour |
protected function moyenneActionsParJour($annee) { |
// nombre d'actions / nombre de jours |
$req = "SELECT". |
" (SELECT". |
// nombre de commentaires sur l'année |
" (SELECT count(*) FROM del_commentaire" . ($annee != null ? " WHERE YEAR(date) = '" . $annee . "')" : ")"). |
" +". |
// nombre de commentaires sur l'année |
" (SELECT count(*) FROM del_commentaire_vote" . ($annee != null ? " WHERE YEAR(date) = '" . $annee . "')" : ")"). |
" )". |
// nombre de jours écoulés dans l'année |
" / ("; |
if ($annee == null) { |
$req .= "SELECT 365 * (year(now()) - min(year(date)) + 1) FROM del_commentaire_vote WHERE YEAR(date) != 0"; |
} else { |
$req .= "SELECT IF( YEAR(CURDATE()) = '" . $annee . "', DAYOFYEAR(CURDATE()), 365)"; |
} |
$req .= ") as moyenne;"; |
|
$res = $this->bdd->recupererTous($req); |
return intval($res[0]['moyenne']); |
} |
|
// Retourne le nombre et la liste des personnes ayant sur l'année une moyenne de participation par mois >= 1 |
protected function personnesEnvoyantUnePropositionParMois($annee) { |
// Faire la moyenne par utilisateur et par mois |
$req = "SELECT cal.nbmois, SUM(somme) / cal.nbmois as moyenne, ce_utilisateur, utilisateur_courriel FROM". |
// Compter le nombre de participations pour chaque utilisateur à chaque mois de cette année |
" (SELECT count(*) as somme, CONCAT(YEAR(date),'-',MONTH(date)) as anneemois, ce_utilisateur, utilisateur_courriel, id_commentaire". |
" FROM del_commentaire". |
" WHERE ce_proposition = ''". |
" AND nom_sel_nn != ''". |
" AND nom_sel_nn IS NOT NULL"; |
if ($annee != null) { |
$req .= " AND YEAR(date) = '" . $annee . "'"; |
} |
$req .= " GROUP BY anneemois, ce_utilisateur, utilisateur_courriel) as ppm,". |
// Trouver le nombre de mois différents lors desquels les utilisateurs ont participé, cette année |
// Pour l'année en cours par ex, retournera 2 si on est en février (voire un au début du mois). |
" (SELECT count(distinct CONCAT(YEAR(date),'-',MONTH(date))) as nbmois". |
" FROM del_commentaire". |
" WHERE "; |
if ($annee != null) { |
$req .= "YEAR(date) = '" . $annee . "' AND "; |
} |
$req .= " ce_proposition = ''". |
" AND nom_sel_nn != ''". |
" AND nom_sel_nn IS NOT NULL) as cal". |
" GROUP BY ce_utilisateur, utilisateur_courriel". |
" HAVING SUM(somme) / cal.nbmois >= 1". |
" ORDER BY moyenne;"; |
|
$res = $this->bdd->recupererTous($req); |
$cpt = count($res); |
$retour = array( |
'nombre' => intval($cpt), |
'donnees' => $res |
); |
|
return $retour; |
} |
} |