WebSVN – eFlore/Applications.del – Diff – /trunk/services/modules/0.1/Statistiques.php


<?php
/**
* Description :
* Statistiques par année sur l'utilisation de Identiplante / Pictoflora
*
* Documentation: http://www.tela-botanica.org/wikini/DevInformatiques/wakka.php?wiki=AppliDelStats
* 
* @author Mathias
* @license GPL v3 <http://www.gnu.org/licenses/gpl.txt>
* @license CECILL v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt>
*/
class Statistiques extends RestService {
 
	protected $bdd;
 
	public function __construct() {
		$this->bdd = $this->getBdd();
	}
 
	// GET
	public function consulter($ressources, $parametres) {
		$resultat = '';
		$reponseHttp = new ReponseHttp();
 
		// méthode à appeler
		$methode = "tout";
		if (isset($ressources[0])) {
			$methode = $ressources[0];
		}
		// année à considérer
		$annee = date('Y');
		if (isset($parametres['annee'])) {
			$annee = $parametres['annee'];
		}
		//echo "Année: $annee\nMéthode: $methode\n";
 
		// 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()));
		}
 
		// 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>";
	}
 
	// retourne toutes les stats pour l'année spécifiée
	protected function tout($annee) {
		$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' => intval($annee),
			'moyenneObsSansNomParMois' => $moyenneObsSansNomParMois,
			'moyenneObsIdentifieesParMois' => $moyenneObsIdentifieesParMois,
			'pourcentageObsIdentifieesEnFinDAnnee' => $pourcentageObsIdentifieesEnFinDAnnee,
			'pourcentageObsIdentifieesEnFinDAnneePlusPlus' => $pourcentageObsIdentifieesEnFinDAnneePlusPlus['pourcentage'],
			'moyenneActionsParJour' => $moyenneActionsParJour,
			'personnesEnvoyantUnePropositionParMois' => $personnesEnvoyantUnePropositionParMois['nombre']
		);
	}
 
	// 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 YEAR(date_transmission) = '" . $annee . "'".
			" AND".
				// Obs marqués comme "aDeterminer" ou ayant un faible niveau de certitude
				" (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']);
	}
 
	// 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".
				// Le dernier vote doit être dans l'année considérée (@ACHTUNG bancal)
				" HAVING MAX(YEAR(dcv.date)) = '" . $annee . "') 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".
				" HAVING MAX(YEAR(dcv.date)) = '" . $annee . "'".
			" ) 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".
			" AND YEAR(do.date_transmission) = '" . $annee . "'".
			" GROUP BY dc.id_commentaire".
			" HAVING MAX(YEAR(dcv.date)) = '" . $annee . "')".
		" 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 YEAR(date_transmission) = '" . $annee . "'".
			" AND (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)
		);
	}
 
	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".
				" AND YEAR(do.date_transmission) = '" . $annee . "'".
				" GROUP BY dc.id_commentaire".
				" HAVING MAX(YEAR(dcv.date)) = '" . $annee . "')".
			" as temp)".
			" /".
			" (SELECT count(*)".
			" FROM del_observation".
			" WHERE YEAR(date_transmission) = '" . $annee . "'".
			" AND (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']);
	}
 
	// 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 WHERE YEAR(date) = '" . $annee . "')".
			" +".
			// nombre de commentaires sur l'année
			" (SELECT count(*) FROM del_commentaire_vote WHERE YEAR(date) = '" . $annee . "')".
			" )".
			// nombre de jours écoulés dans l'année
			" / (SELECT IF( YEAR(CURDATE()) = '" . $annee . "', DAYOFYEAR(CURDATE()), 365)".
			" ) 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".
			" AND YEAR(date) = '" . $annee . "'".
			" 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 YEAR(date) = '" . $annee . "'".
			" AND 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;
	}
}
?>

Subversion Repositories eFlore/Applications.del

(root)/trunk/services/modules/0.1/Statistiques.php @ 2050 – Rev 1624 → 1626

Rev 1624		Rev 1626
1	`<?php`	1	`<?php`
2	`/**`	2	`/**`
3	`* Description :`	3	`* Description :`
4	`* Statistiques par année sur l'utilisation de Identiplante / Pictoflora`	4	`* Statistiques par année sur l'utilisation de Identiplante / Pictoflora`
5	`*`	5	`*`
-		6	`* Documentation: http://www.tela-botanica.org/wikini/DevInformatiques/wakka.php?wiki=AppliDelStats`
-		7	`*`
6	`* @author Mathias`	8	`* @author Mathias`
7	`* @license GPL v3 <http://www.gnu.org/licenses/gpl.txt>`	9	`* @license GPL v3 <http://www.gnu.org/licenses/gpl.txt>`
8	`* @license CECILL v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt>`	10	`* @license CECILL v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt>`
9	`*/`	11	`*/`
10	`class Statistiques extends RestService {`	12	`class Statistiques extends RestService {`
11		13
12	`protected $bdd;`	14	`protected $bdd;`
13		15
14	`public function __construct() {`	16	`public function __construct() {`
15	`$this->bdd = $this->getBdd();`	17	`$this->bdd = $this->getBdd();`
16	`}`	18	`}`
17		19
18	`// GET`	20	`// GET`
19	`public function consulter($ressources, $parametres) {`	21	`public function consulter($ressources, $parametres) {`
20	`$resultat = '';`	22	`$resultat = '';`
21	`$reponseHttp = new ReponseHttp();`	23	`$reponseHttp = new ReponseHttp();`
22		24
23	`// méthode à appeler`	25	`// méthode à appeler`
24	`$methode = "tout";`	26	`$methode = "tout";`
25	`if (isset($ressources[0])) {`	27	`if (isset($ressources[0])) {`
26	`$methode = $ressources[0];`	28	`$methode = $ressources[0];`
27	`}`	29	`}`
28	`// année à considérer`	30	`// année à considérer`
29	`$annee = date('Y');`	31	`$annee = date('Y');`
30	`if (isset($parametres['annee'])) {`	32	`if (isset($parametres['annee'])) {`
31	`$annee = $parametres['annee'];`	33	`$annee = $parametres['annee'];`
32	`}`	34	`}`
33	`//echo "Année: $annee\nMéthode: $methode\n";`	35	`//echo "Année: $annee\nMéthode: $methode\n";`
34		36
35	`// appel`	37	`// appel`
36	`if (method_exists($this, $methode)) {`	38	`if (method_exists($this, $methode)) {`
37	`try {`	39	`try {`
38	`$retour = call_user_func(array($this, $methode), $annee);`	40	`$retour = call_user_func(array($this, $methode), $annee);`