Subversion Repositories eFlore/Applications.del

Rev

Rev 1795 | Go to most recent revision | Show entire file | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed

Rev 1795 Rev 1818
Line 1... Line 1...
1
<?php
1
<?php
2
/**
2
/**
3
 * Statistiques par année sur l'utilisation de Identiplante / Pictoflora
3
 * Accès aux sous-services de statistiques pour Identiplante / Pictoflora
4
 *
4
 *
5
 * Documentation: http://www.tela-botanica.org/wikini/DevInformatiques/wakka.php?wiki=AppliDelStats
5
 * @see Documentation : <http://www.tela-botanica.org/wikini/DevInformatiques/wakka.php?wiki=AppliDelStats>
6
 *
6
 *
7
 * @category   DEL
7
 * @category   DEL
8
 * @package    Services
8
 * @package    Services
9
 * @subpackage Statistiques
9
 * @subpackage Statistiques
10
 * @version    0.1
10
 * @version    0.1
Line 15... Line 15...
15
 * @license    CECILL v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt>
15
 * @license    CECILL v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt>
16
 * @copyright  1999-2014 Tela Botanica <accueil@tela-botanica.org>
16
 * @copyright  1999-2014 Tela Botanica <accueil@tela-botanica.org>
17
 */
17
 */
18
class Statistiques extends RestService {
18
class Statistiques extends RestService {
Line -... Line 19...
-
 
19
 
-
 
20
	private $parametres = array();
-
 
21
	private $ressources = array();
-
 
22
	private $methode = null;
-
 
23
	private $serviceNom = 'statistiques';
-
 
24
	private $sousServiceNom = null;
-
 
25
	private $cheminCourant = null;
19
 
26
 
-
 
27
	private $conteneur;
-
 
28
 
-
 
29
	/** Indique si oui (true) ou non (false), on veut utiliser les paramètres bruts. */
Line 20... Line 30...
20
	protected $bdd;
30
	protected $utilisationParametresBruts = true;
21
 
31
 
22
	public function __construct() {
32
	public function __construct() {
Line 23... Line -...
23
		$this->bdd = $this->getBdd();
-
 
24
	}
33
		$this->cheminCourant = dirname(__FILE__).DS;
25
 
34
	}
-
 
35
 
26
	// GET
36
	public function consulter($ressources, $parametres) {
-
 
37
		$this->methode = 'consulter';
Line 27... Line -...
27
	public function consulter($ressources, $parametres) {
-
 
28
		$resultat = '';
-
 
29
		$reponseHttp = new ReponseHttp();
38
		$this->initialiserRessourcesEtParametres($ressources, $parametres);
30
 
39
		return $this->executerService();
31
		// méthode à appeler
-
 
32
		$methode = "tout";
-
 
33
		if (isset($ressources[0])) {
-
 
34
			$methode = $ressources[0];
-
 
35
		}
40
	}
36
		// année à considérer - par défaut pas de filtrage
41
 
37
		$annee = null;
-
 
Line 38... Line 42...
38
		if (isset($parametres['annee'])) {
42
	private function initialiserRessourcesEtParametres($ressources, $parametres = array()) {
39
			$annee = $parametres['annee'];
43
		$this->ressources = $ressources;
40
		}
44
		$this->parametres = $parametres;
41
		//echo "Année: $annee\nMéthode: $methode\n";
45
	}
-
 
46
 
42
 
47
	private function executerService() {
43
		// appel
48
		$reponseHttp = new ReponseHttp();
44
		if (method_exists($this, $methode)) {
-
 
45
			try {
49
		try {
46
				$retour = call_user_func(array($this, $methode), $annee);
-
 
47
				$reponseHttp->setResultatService($retour);
-
 
48
			} catch (ServiceFoiraxException $e) {
-
 
49
				// @TODO renvoyer 500
-
 
50
				$reponseHttp->ajouterErreur($e);
50
			$this->conteneur = new Conteneur($this->parametres);
51
			}
-
 
52
		} else {
-
 
53
			// @TODO renvoyer 500
51
			$resultat = $this->traiterRessources();
54
			$reponseHttp->ajouterErreur(new Exception("Erreur: la méthode \"$methode\" n'existe pas<br/>" . $this->utilisation()));
52
			$reponseHttp->setResultatService($resultat);
55
		}
-
 
56
 
53
		} catch (Exception $e) {
57
		// merci au revoir
54
			$reponseHttp->ajouterErreur($e);
Line 58... Line -...
58
		$reponseHttp->emettreLesEntetes();
-
 
59
		$corps = $reponseHttp->getCorps();
55
		}
60
 
-
 
61
		return $corps;
-
 
62
	}
-
 
63
 
-
 
64
	// Renvoie la liste des méthodes disponibles
-
 
65
	private function utilisation() {
-
 
66
		return "<br/>Méthodes disponibles:<ul>".
56
		$reponseHttp->emettreLesEntetes();
67
			"<li>tout</li>".
-
 
68
			"<li>moyenneObsSansNomParMois</li>".
-
 
69
			"<li>moyenneObsIdentifieesParMois</li>".
-
 
70
			"<li>pourcentageObsIdentifieesEnFinDAnnee</li>".
-
 
71
			"<li>pourcentageObsIdentifieesEnFinDAnneePlusPlus</li>".
-
 
72
			"<li>moyenneActionsParJour</li>".
-
 
73
			"<li>personnesEnvoyantUnePropositionParMois</li>".
-
 
74
		"</ul>";
-
 
75
	}
-
 
76
 
-
 
77
	// retourne toutes les stats pour l'année spécifiée
57
		$corps = $reponseHttp->getCorps();
78
	protected function tout($annee=null) {
-
 
79
		$moyenneObsSansNomParMois = $this->moyenneObsSansNomParMois($annee);
-
 
80
		$moyenneObsIdentifieesParMois = $this->moyenneObsIdentifieesParMois($annee);
58
		return $corps;
81
		$pourcentageObsIdentifieesEnFinDAnnee = $this->pourcentageObsIdentifieesEnFinDAnnee($annee);
-
 
82
		$pourcentageObsIdentifieesEnFinDAnneePlusPlus = $this->pourcentageObsIdentifieesEnFinDAnneePlusPlus($annee);
-
 
83
		$moyenneActionsParJour = $this->moyenneActionsParJour($annee);
-
 
84
		$personnesEnvoyantUnePropositionParMois = $this->personnesEnvoyantUnePropositionParMois($annee);
-
 
85
 
-
 
86
		return array(
-
 
87
			'annee' => $annee ? intval($annee) : null,
-
 
88
			'moyenneObsSansNomParMois' => $moyenneObsSansNomParMois,
-
 
89
			'moyenneObsIdentifieesParMois' => $moyenneObsIdentifieesParMois,
-
 
90
			'pourcentageObsIdentifieesEnFinDAnnee' => $pourcentageObsIdentifieesEnFinDAnnee,
-
 
91
			'pourcentageObsIdentifieesEnFinDAnneePlusPlus' => $pourcentageObsIdentifieesEnFinDAnneePlusPlus['pourcentage'],
-
 
92
			'moyenneActionsParJour' => $moyenneActionsParJour,
-
 
93
			'personnesEnvoyantUnePropositionParMois' => $personnesEnvoyantUnePropositionParMois['nombre']
-
 
94
		);
59
	}
Line 95... Line -...
95
	}
-
 
96
 
60
 
97
	// proxy pour le widget de stats
61
	private function traiterRessources() {
98
	protected function observations($annee) {
-
 
99
		return $this->tout($annee);
62
		$this->analyserRessources();
100
	}
63
		$retour = $this->initialiserService();
101
 
64
		return $retour;
102
	// Retourne le nombre moyen d'observations non identifiées envoyées par mois, pour l'année $annee
65
	}
103
	protected function moyenneObsSansNomParMois($annee) {
66
 
104
		$req = "SELECT AVG(parMois.compte) as moyenne FROM".
-
 
105
			" (SELECT count(*) as compte, CONCAT(YEAR(date_transmission),'-',MONTH(date_transmission)) as anneemois".
-
 
106
			" FROM del_observation".
-
 
107
			" WHERE ";
-
 
108
		if ($annee !== null) {
-
 
109
			$req .= "YEAR(date_transmission) = '" . $annee . "' AND ";
-
 
110
		}
-
 
111
				// Obs marqués comme "aDeterminer" ou ayant un faible niveau de certitude
-
 
112
		$req .=	" (mots_cles_texte LIKE '%aDeterminer%'".
-
 
113
				" OR certitude = 'aDeterminer'".
-
 
114
				" OR certitude = 'douteux'".
-
 
115
				// Obs n'ayant pas de nom_sel_nn (détermination non choisie parmi le référentiel)
-
 
116
				" OR nom_sel_nn IS NULL".
-
 
117
				" OR nom_sel_nn = 0".
-
 
118
				" OR id_observation IN".
-
 
119
					// Obs ayant une proposition initiale "vide" (sans no_sel_nn)
-
 
120
					" (SELECT DISTINCT ce_observation".
-
 
121
					" FROM del_commentaire".
-
 
122
					" WHERE proposition_initiale = 1".
-
 
123
					" AND (nom_sel_nn IS NULL OR nom_sel_nn = '')".
-
 
124
				")".
67
	private function analyserRessources() {
Line 125... Line 68...
125
			")".
68
		if ($this->methode == 'consulter') {
126
			" GROUP BY anneemois".
69
			$this->sousServiceNom = 'statistiques-par-annee';
127
			" ORDER BY anneemois DESC) as parMois;";
70
		}
128
 
71
		if ($this->sousServiceNom == null) {
-
 
72
			$this->lancerMessageErreurRessource();
-
 
73
		}
-
 
74
	}
-
 
75
 
-
 
76
	private function lancerMessageErreurRessource() {
-
 
77
		$ressource = $this->sousServiceNom.'/'.implode('/', $this->ressources);
129
		$res = $this->bdd->recupererTous($req);
78
		$message = "La ressource demandée '$ressource' ".
130
		return intval($res[0]['moyenne']);
79
			"n'est pas disponible pour le service {$this->serviceNom} !\n".
-
 
80
			self::getDoc();
131
	}
81
		$code = RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE;
132
 
82
		throw new Exception($message, $code);
-
 
83
	}
-
 
84
 
133
	// Retourne la moyenne par mois sur l'année en cours, des propositions marquées comme "retenues"
85
	public static function getDoc() {
134
	// dont le dernier vote est dans l'année considérée (comptées en groupant par mois du dernier vote)
86
		return "Les URLs disponibles pour ce service sont :\n".
-
 
87
			" * en GET :\n".
-
 
88
			" - statistiques/tout\n".
135
	protected function moyenneObsIdentifieesParMois($annee) {
89
			" - statistiques/moyenneObsSansNomParMois\n".
-
 
90
			" - statistiques/moyenneObsIdentifieesParMois\n".
136
		$req = "SELECT AVG(valideesparmois) as moyenne FROM (".
91
			" - statistiques/pourcentageObsIdentifieesEnFinDAnnee\n".
-
 
92
			" - statistiques/pourcentageObsIdentifieesEnFinDAnneePlusPlus\n".
-
 
93
			" - statistiques/moyenneActionsParJour\n".
-
 
94
			" - statistiques/personnesEnvoyantUnePropositionParMois\n";
-
 
95
	}
137
			" SELECT count(*) as valideesparmois, CONCAT(YEAR(maxdate), '-', MONTH(maxdate)) as anneemois".
96
 
-
 
97
	private function initialiserService() {
-
 
98
		$classe = $this->obtenirNomClasseService($this->sousServiceNom);
-
 
99
		$chemins = array();
-
 
100
		$chemins[] = $this->cheminCourant.$this->serviceNom.DS.$classe.'.php';
138
			" FROM (".
101
		$chemins[] = $this->cheminCourant.'commun'.DS.$classe.'.php';
-
 
102
		$retour = '';
-
 
103
		$service = null;
139
				// Compte et date du dernier vote des propositions marquées comme "retenues"
104
 
140
				" SELECT count(*), MAX(dcv.date) as maxdate".
105
		foreach ($chemins as $chemin) {
-
 
106
			if (file_exists($chemin)) {
-
 
107
				require_once $chemin;
-
 
108
				$service = new $classe($this->conteneur);
141
				" FROM del_commentaire dc".
109
				if ($this->methode == 'consulter') {
142
				" LEFT JOIN del_commentaire_vote dcv ON dcv.ce_proposition = dc.id_commentaire".
-
 
143
				" WHERE proposition_retenue = 1".
-
 
144
				" GROUP BY dc.id_commentaire";
-
 
145
 
-
 
146
			if ($annee !== null) {
-
 
147
				// Le dernier vote doit être dans l'année considérée (@ACHTUNG bancal)
-
 
148
				$req .= " HAVING MAX(YEAR(dcv.date)) = '" . $annee . "'";
-
 
149
			}
-
 
150
			$req .= ") as temp".
-
 
151
		" GROUP BY anneemois) as temp2;";
-
 
152
 
-
 
153
		$res = $this->bdd->recupererTous($req);
-
 
154
		return intval($res[0]['moyenne']);
-
 
155
	}
-
 
156
 
-
 
157
	// Version améliorée mais non optimale (prend en compte les consensus non validés)
-
 
158
	// @TODO on devrait croiser les IDS pour ne pas prendre en compte les obs validées ou en
-
 
159
	// 		consensus, mais qui datent des années précédentes
-
 
160
	// @ACHTUNG mache pas, dépasse les 100% (voir Wiki)
-
 
161
	protected function pourcentageObsIdentifieesEnFinDAnneePlusPlus($annee) {
-
 
162
		// Obs ayant atteint un consensus cette année
-
 
163
		$req1 = "SELECT count(*) as nombre FROM(".
-
 
164
			" SELECT id_observation, id_commentaire, id_vote, nbvotes FROM (".
-
 
165
				" SELECT do.id_observation, dc.id_commentaire, dcv.id_vote, count(dcv.id_vote) as nbvotes".
-
 
166
				" FROM del_commentaire dc".
-
 
167
				" LEFT JOIN del_observation do ON do.id_observation = dc.ce_observation".
-
 
168
				" LEFT JOIN del_commentaire_vote dcv ON dc.id_commentaire = dcv.ce_proposition".
-
 
169
				" AND dcv.valeur = 1".
-
 
170
				" AND dc.proposition_retenue = 0".
-
 
171
				" GROUP BY dc.id_commentaire";
-
 
172
		if ($annee != null) {
-
 
173
			$req1 .= " HAVING MAX(YEAR(dcv.date)) = '" . $annee . "'";
-
 
174
		}
-
 
175
		$req1 .= " ) as temp GROUP BY id_observation".
-
 
176
		") as temp2;";
-
 
177
		$obsEnConsensus = $this->bdd->recupererTous($req1);
-
 
178
		$oc = intval($obsEnConsensus[0]['nombre']);
-
 
179
 
-
 
180
		// Obs ayant une "proposition retenue" cette année
-
 
181
		$req2 = "SELECT count(*) as nombre FROM (".
-
 
182
			" SELECT count(DISTINCT id_observation), MAX(dcv.date) as maxdate".
-
 
183
			" FROM del_commentaire dc".
-
 
184
			" LEFT JOIN del_commentaire_vote dcv ON dcv.ce_proposition = dc.id_commentaire".
-
 
185
			" LEFT JOIN del_observation do ON do.id_observation = dc.ce_observation".
-
 
186
			" WHERE proposition_retenue = 1";
-
 
187
		if ($annee != null) {
-
 
188
			$req2 .= " AND YEAR(do.date_transmission) = '" . $annee . "'";
-
 
189
		}
-
 
190
		$req2 .= " GROUP BY dc.id_commentaire";
-
 
191
		if ($annee != null) {
-
 
192
			$req2 .= " HAVING MAX(YEAR(dcv.date)) = '" . $annee . "'";
-
 
193
		}
-
 
194
		$req2 .= ") as temp;";
-
 
195
		$nbObsValidees = $this->bdd->recupererTous($req2);
-
 
196
		$ov = intval($nbObsValidees[0]['nombre']);
-
 
197
 
-
 
198
		// Nombre d'obs sans nom soumises cette année
-
 
199
		$req3 = "SELECT count(*) as nombre".
-
 
200
			" FROM del_observation".
-
 
201
			" WHERE ";
-
 
202
		if ($annee != null) {
-
 
203
			$req3 .= "YEAR(date_transmission) = '" . $annee . "' AND ";
-
 
204
		}
-
 
205
		$req3 .= "(mots_cles_texte LIKE '%aDeterminer%'".
-
 
206
			" OR certitude = 'aDeterminer'".
-
 
207
			" OR certitude = 'douteux'".
-
 
208
			" OR nom_sel_nn IS NULL".
-
 
209
			" OR nom_sel_nn = 0 OR".
-
 
210
				" id_observation IN (".
-
 
211
				" SELECT DISTINCT ce_observation".
-
 
212
				" FROM del_commentaire".
-
 
213
				" WHERE proposition_initiale = 1".
-
 
214
				" AND (nom_sel_nn IS NULL OR nom_sel_nn = '')".
-
 
215
			" ))";
-
 
216
		$nbObsSansNom = $this->bdd->recupererTous($req3);
-
 
217
		$osn = intval($nbObsSansNom[0]['nombre']);
-
 
218
 
-
 
219
		return array(
-
 
220
			'observationsEnConsensus' => $oc,
-
 
221
			'observationsValidees' => $ov,
-
 
222
			'observationsSansNom' => $osn,
-
 
223
			'pourcentage' => ($osn == 0 ? 0 : (($oc + $ov) / $osn) * 100)
-
 
224
		);
-
 
225
	}
-
 
226
 
-
 
227
	protected function pourcentageObsIdentifieesEnFinDAnnee($annee) {
-
 
228
		$req = "SELECT (".
-
 
229
			" SELECT count(*) FROM (".
-
 
230
				" SELECT count(DISTINCT id_observation), MAX(dcv.date) as maxdate".
-
 
231
				" FROM del_commentaire dc".
-
 
232
				" LEFT JOIN del_commentaire_vote dcv ON dcv.ce_proposition = dc.id_commentaire".
-
 
233
				" LEFT JOIN del_observation do ON do.id_observation = dc.ce_observation".
110
					$retour = $service->consulter();
234
				" WHERE proposition_retenue = 1";
-
 
235
		if ($annee !== null) {
-
 
236
			$req .= " AND YEAR(do.date_transmission) = '" . $annee . "'";
-
 
237
		}
-
 
238
		$req .= " GROUP BY dc.id_commentaire";
-
 
239
		if ($annee !== null) {
-
 
240
			$req .= " HAVING MAX(YEAR(dcv.date)) = '" . $annee . "'";
-
 
241
		}
-
 
242
		$req .= ") as temp)".
-
 
243
			" /".
-
 
244
			" (SELECT count(*)".
-
 
245
			" FROM del_observation".
-
 
246
			" WHERE ";
-
 
247
		if ($annee !== null) {
-
 
248
			$req .= "YEAR(date_transmission) = '" . $annee . "' AND ";
-
 
249
		}
-
 
250
		$req .= " (mots_cles_texte LIKE '%aDeterminer%'".
-
 
251
			" OR certitude = 'aDeterminer'".
-
 
252
			" OR certitude = 'douteux'".
-
 
253
			" OR nom_sel_nn IS NULL".
-
 
254
			" OR nom_sel_nn = 0 OR".
-
 
255
				" id_observation IN (".
-
 
256
				" SELECT DISTINCT ce_observation".
-
 
257
				" FROM del_commentaire".
-
 
258
				" WHERE proposition_initiale = 1".
-
 
Line 259... Line -...
259
				" AND (nom_sel_nn IS NULL OR nom_sel_nn = '')".
-
 
260
				" )".
-
 
261
			" )".
111
				} else {
262
		" ) * 100 as pourcentage;";
-
 
263
 
-
 
264
		$res = $this->bdd->recupererTous($req);
112
					$message = "Le sous-service '{$this->sousServiceNom}' du service '{$this->serviceNom}' ".
265
		return floatval($res[0]['pourcentage']);
113
						"ne possède pas de méthode '{$this->methode}' !";
266
	}
-
 
267
 
114
					$code = RestServeur::HTTP_NON_IMPLEMENTE;
268
	// Retourne la moyenne sur l'année du nombre d'actions (commentaire ou vote) par jour
-
 
269
	protected function moyenneActionsParJour($annee) {
-
 
270
		// nombre d'actions / nombre de jours
115
					throw new Exception($message, $code);
271
		$req = "SELECT".
-
 
272
			" (SELECT".
116
				}
273
			// nombre de commentaires sur l'année
-
 
274
			" (SELECT count(*) FROM del_commentaire" . ($annee != null ? " WHERE YEAR(date) = '" . $annee . "')" : ")").
-
 
275
			" +".
-
 
276
			// nombre de commentaires sur l'année
117
			}
277
			" (SELECT count(*) FROM del_commentaire_vote" . ($annee != null ? " WHERE YEAR(date) = '" . $annee . "')" : ")").
-
 
278
			" )".
-
 
279
			// nombre de jours écoulés dans l'année
-
 
280
			" / (";
118
		}
281
		if ($annee == null) {
119
 
Line 282... Line -...
282
			$req .= "SELECT 365 * (year(now()) - min(year(date)) + 1) FROM del_commentaire_vote WHERE YEAR(date) != 0";
-
 
283
		} else {
120
		if (is_null($service)) {
284
			$req .= "SELECT IF( YEAR(CURDATE()) = '" . $annee . "', DAYOFYEAR(CURDATE()), 365)";
-
 
285
		}
-
 
286
		$req .= ") as moyenne;";
-
 
287
 
-
 
288
		$res = $this->bdd->recupererTous($req);
-
 
289
		return intval($res[0]['moyenne']);
-
 
290
	}
-
 
291
 
-
 
292
	// Retourne le nombre et la liste des personnes ayant sur l'année une moyenne de participation par mois >= 1
-
 
293
	protected function personnesEnvoyantUnePropositionParMois($annee) {
-
 
294
		// Faire la moyenne par utilisateur et par mois
-
 
295
		$req = "SELECT cal.nbmois, SUM(somme) / cal.nbmois as moyenne, ce_utilisateur, utilisateur_courriel FROM".
-
 
296
			// Compter le nombre de participations pour chaque utilisateur à chaque mois de cette année
-
 
297
			" (SELECT count(*) as somme, CONCAT(YEAR(date),'-',MONTH(date)) as anneemois, ce_utilisateur, utilisateur_courriel, id_commentaire".
121
			$ressource = $this->sousServiceNom.'/'.implode('/', $this->ressources);
298
			" FROM del_commentaire".
-
 
299
			" WHERE ce_proposition = ''".
-
 
300
			" AND nom_sel_nn != ''".
-
 
301
			" AND nom_sel_nn IS NOT NULL";
-
 
302
		if ($annee != null) {
-
 
303
			$req .= " AND YEAR(date) = '" . $annee . "'";
-
 
304
		}
-
 
305
		$req .= " GROUP BY anneemois, ce_utilisateur, utilisateur_courriel) as ppm,".
-
 
306
			// Trouver le nombre de mois différents lors desquels les utilisateurs ont participé, cette année
-
 
307
			// Pour l'année en cours par ex, retournera 2 si on est en février (voire un au début du mois).
-
 
308
			" (SELECT count(distinct CONCAT(YEAR(date),'-',MONTH(date))) as nbmois".
-
 
309
			" FROM del_commentaire".
-
 
310
			" WHERE ";
-
 
311
		if ($annee != null) {
-
 
312
			$req .= "YEAR(date) = '" . $annee . "' AND ";
-
 
313
		}
-
 
314
		$req .= " ce_proposition = ''".
-
 
315
			" AND nom_sel_nn != ''".
-
 
316
			" AND nom_sel_nn IS NOT NULL) as cal".
-
 
317
		" GROUP BY ce_utilisateur, utilisateur_courriel".
-
 
318
		" HAVING SUM(somme) / cal.nbmois >= 1".
122
			$message = "Le classe '$classe' correspondant à la ressource '$ressource' ".
319
		" ORDER BY moyenne;";
123
				"est introuvable par le service '{$this->serviceNom}' !";
320
 
124
			$code = RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE;
321
		$res = $this->bdd->recupererTous($req);
125
			throw new Exception($message, $code);