modules/erl/euphorik_minichat.erl

   1 % coding: utf-8
   2 % Ce module permet de gérer les données persistantes lié au minichat d'euphorik.ch
   3 % Il permet d'ajouter des message, de demande les messages sur une page donnée, etc..
   4 % Ce module utilise la base mnesia créée par le module euphorik_bd.
   5 % @author G.Burri
   6
   7 -module(euphorik_minichat).
   8 -export([
   9    connect/0,
  10    % get :
  11    messages/1,
  12    messages/2,
  13    messages/3,
  14    message_by_id/1,
  15    messages_by_ids/1,
  16    reponses/0,
  17    repond_a/1,
  18    nb_page/1,
  19    users/0,
  20    user_by_cookie/1,
  21    user_by_id/1,
  22    user_by_login/1,
  23    user_by_login_password/2,
  24    user_by_mess/1,
  25    possede_message/2,
  26    a_repondu_a_message/2,
  27    est_une_reponse_a_user/2,
  28    % set :
  29    update_pseudo_user/2,
  30    set_profile/8,
  31    update_date_derniere_connexion/1,
  32    nouveau_user/2,
  33    nouveau_user/3,
  34    nouveau_message/3,
  35    reset/0,
  36    % reservé :
  37    resultat_transaction/1
  38 ]).
  39
  40 -include("../include/euphorik_bd.hrl").
  41 -include_lib("stdlib/include/qlc.hrl").
  42
  43 % Un message est considéré comme du spam s'il est posté 1 seconde ou moins après le dernier posté
  44 -define(DUREE_SPAM, 1000). % ms
  45
  46 % Lorsque l'indice de spam d'un utilisateur atteind cette valeur alors il ne peut plus poster pendant un moment
  47 -define(INDICE_SPAM_MAX, 6).
  48
  49 % Un utilisateur ayant trop spamé est bloqué pendant ce temps
  50 -define(DUREE_BLOCAGE_SPAM, 20000). % ms
  51
  52
  53 % Connexion à la base de données de yaws sur overnux
  54 connect() ->
  55    mnesia:start(),
  56    mnesia:change_config(extra_db_nodes, [yaws@flynux]).
  57
  58
  59 % Efface tous les users, minichat_reponse et minichat.
  60 reset() ->
  61    mnesia:clear_table(counter),
  62    mnesia:clear_table(user),
  63    mnesia:clear_table(reponse_minichat),
  64    mnesia:clear_table(minichat),
  65    % crée l'utilisateur root
  66    mnesia:transaction(fun() ->
  67       User = #user{id = 0, pseudo = "Sys", login = "Sys", date_creation = now(), date_derniere_connexion = now()},
  68       mnesia:write(User),
  69       User
  70    end).
  71
  72
  73 % Est-ce qu'un utilisateur existe en fonction de son cookie ?
  74 % Renvoie {ok, User} ou erreur
  75 user_by_cookie(Cookie) ->
  76    resultat_transaction(mnesia:transaction(
  77       fun() ->
  78          Users = qlc:e(qlc:q([E || E <- mnesia:table(user), E#user.cookie =:= Cookie])),
  79          case Users of
  80             [User] -> {ok, User};
  81             _ -> erreur
  82          end
  83       end
  84    )).
  85
  86
  87 user_by_id(ID) ->
  88    resultat_transaction(mnesia:transaction(
  89       fun() ->
  90          Users = qlc:e(qlc:q([E || E <- mnesia:table(user), E#user.id =:= ID])),
  91          case Users of
  92             [User] -> {ok, User};
  93             _ -> erreur
  94          end
  95       end
  96    )).
  97
  98
  99 user_by_login(Login) ->
 100    resultat_transaction(mnesia:transaction(
 101       fun() ->
 102          Users = qlc:e(qlc:q([E || E <- mnesia:table(user), E#user.login =:= Login])),
 103          case Users of
 104             [User] -> {ok, User};
 105             _ -> erreur
 106          end
 107       end
 108    )).
 109
 110
 111 user_by_login_password(Login, Password) ->
 112    resultat_transaction(mnesia:transaction(
 113       fun() ->
 114          Users = qlc:e(qlc:q([E || E <- mnesia:table(user), E#user.login =:= Login, E#user.password =:= Password])),
 115          case Users of
 116             [User] -> {ok, User};
 117             _ -> erreur
 118          end
 119       end
 120    )).
 121
 122
 123 % Renvoie {ok, User} où User est un #user possédant le message donné.
 124 user_by_mess(Id) ->
 125    resultat_transaction(mnesia:transaction(
 126       fun() ->
 127          case qlc:e(qlc:q([U || U <- mnesia:table(user), M <- mnesia:table(minichat), M#minichat.id =:= Id, M#minichat.auteur_id =:= U#user.id])) of
 128             [User] -> {ok, User};
 129             _ -> erreur
 130          end
 131       end
 132    )).
 133
 134
 135 % Renvoie l'utilisateur root
 136 root() ->
 137    {ok, User} = user_by_id(0),
 138    User.
 139
 140
 141 % Est-ce que Id_user possède Id_mess ?
 142 possede_message(Id_user, Id_mess) ->
 143    case mnesia:transaction(
 144             fun() ->
 145                qlc:e(qlc:q([E#minichat.auteur_id || E <- mnesia:table(minichat), E#minichat.id =:= Id_mess]))
 146             end
 147          ) of
 148       {atomic, [Id_user | []]} -> true;
 149       _ -> false
 150    end.
 151
 152
 153 % Est-ce que Id_user à répondu au message Id_mess
 154 a_repondu_a_message(Id_user, Id_mess) ->
 155    case mnesia:transaction(
 156             fun() ->
 157                qlc:e(qlc:q([
 158                   M#minichat.auteur_id || M <- mnesia:table(minichat), R <- mnesia:table(reponse_minichat),
 159                   R#reponse_minichat.cible =:= Id_mess, R#reponse_minichat.repondant =:= M#minichat.id, M#minichat.auteur_id =:= Id_user
 160                ]), [{unique_all, true}])
 161             end
 162          ) of
 163       {atomic, [_]} -> true;
 164       _ -> false
 165    end.
 166
 167
 168 % Est-ce que le message Id_mess est une réponse d'une message de Id_user ?
 169 est_une_reponse_a_user(Id_user, Id_mess) ->
 170    case mnesia:transaction(
 171             fun() ->
 172                qlc:e(qlc:q([
 173                   M#minichat.auteur_id || M <- mnesia:table(minichat), R <- mnesia:table(reponse_minichat),
 174                   M#minichat.auteur_id =:= Id_user, M#minichat.id =:= R#reponse_minichat.cible, R#reponse_minichat.repondant =:= Id_mess
 175                ]), [{unique_all, true}])
 176             end
 177          ) of
 178       {atomic, [_]} -> true;
 179       _ -> false
 180    end.
 181
 182
 183 % Met à jour le pseudo du user
 184 update_pseudo_user(UserId, Pseudo) ->
 185    mnesia:transaction(
 186       fun() ->
 187          case mnesia:wread({user, UserId}) of
 188             [User] when User#user.pseudo =/= Pseudo ->
 189                mnesia:write(User#user{pseudo = Pseudo});
 190             _ ->
 191                mnesia:abort("update_pseudo_user: User inconnu ou pseudo deja à jour")
 192           end
 193       end
 194    ).
 195
 196
 197 % Mise à par Cookie les autres peuvent être undefined ce qui veut dire qu'ils ne seront pas modifié.
 198 set_profile(Cookie, Login, Password, Pseudo, Email, Css, Page_principale, Conversations) ->
 199    resultat_transaction(mnesia:transaction(
 200       fun() ->
 201          case user_by_cookie(Cookie) of
 202             {ok, User} ->
 203                case user_by_login(Login) of
 204                   {ok, U} when U#user.id =/= User#user.id ->
 205                      login_deja_pris;
 206                   _ ->
 207                      User_modifie = User#user{
 208                         % TODO : pourquoi ne pas tester avec la valeur "undefined" plutôt qu'avec "is_list" ?
 209                         % TODO : validation plus strict des données (pas de page négative dans les conv par exemple)
 210                         login = if is_list(Login) -> Login; true -> User#user.login end,
 211                         password = if is_list(Password) -> Password; true -> User#user.password end,
 212                         pseudo = if is_list(Pseudo) -> Pseudo; true -> User#user.pseudo end,
 213                         email = if is_list(Email) -> Email; true -> User#user.email end,
 214                         css = if is_list(Css) -> Css; true -> User#user.css end,
 215                         page_principale = if is_integer(Page_principale), Page_principale > 0 -> Page_principale; true -> User#user.page_principale end,
 216                         conversations = if is_list(Conversations) -> Conversations; true -> User#user.conversations end
 217                      },
 218                      mnesia:write(User_modifie),
 219                      ok
 220                end;
 221             _ -> erreur
 222          end
 223       end
 224    )).
 225
 226
 227 % Met à jour la date de la dernière connexion d'un utilisateur à maintenant
 228 update_date_derniere_connexion(UserId) ->
 229    mnesia:transaction(
 230       fun() ->
 231          case mnesia:wread({user, UserId}) of
 232             [User] ->
 233                mnesia:write(User#user{date_derniere_connexion = now()});
 234             _ ->
 235                mnesia:abort("update_date_derniere_connexion: User inconnu")
 236           end
 237       end
 238    ).
 239
 240
 241 % Ajoute un nouveau user et le renvoie
 242 nouveau_user(Pseudo, Cookie) ->
 243    F = fun() ->
 244       Id = nouvel_id(user),
 245       User = #user{id = Id, cookie = Cookie, pseudo = Pseudo, date_creation = now(), date_derniere_connexion = now()},
 246       mnesia:write(User),
 247       User
 248    end,
 249   resultat_transaction(mnesia:transaction(F)).
 250
 251
 252 % Ajoute un nouveau user et le renvoie
 253 nouveau_user(Login, Password, Cookie) ->
 254    F = fun() ->
 255       Id = nouvel_id(user),
 256       User = #user{id = Id, cookie = Cookie, pseudo = Login, login = Login, password = Password, date_creation = now(), date_derniere_connexion = now()},
 257       mnesia:write(User),
 258       User
 259    end,
 260   resultat_transaction(mnesia:transaction(F)).
 261
 262
 263 % Ajoute un message. Repond_A est une liste d'id auquel le message répond
 264 % retourne soit l'id du message soit erreur.
 265 nouveau_message(Mess, Auteur_id, Repond_A) ->
 266    % regarde si les id 'Repond_A' existent
 267    F = fun() ->
 268       Nb_id_trouve = length(qlc:e(qlc:q([E#minichat.id || E <- mnesia:table(minichat), lists:member(E#minichat.id, Repond_A)]))),
 269       % est-ce que l'auteur existe ?
 270       Auteur = case qlc:e(qlc:q([E || E <- mnesia:table(user), E#user.id =:= Auteur_id])) of
 271          [A] -> A;
 272          _ -> throw("L'auteur du message est introuvable")
 273       end,
 274       if Nb_id_trouve =/= length(Repond_A) -> throw("Un ou plusieurs messages introuvable");
 275          true -> ok
 276       end,
 277       Id = nouvel_id(minichat),
 278       % compare les dernière
 279       Delta = delta_date_ms(Auteur#user.date_derniere_connexion, now()),
 280       Nouvel_indice_flood = Auteur#user.indice_flood + if Delta =< ?DUREE_SPAM -> 2; true -> -1 end,
 281       Auteur_maj = Auteur#user{
 282          indice_flood = if Nouvel_indice_flood > ?INDICE_SPAM_MAX -> ?INDICE_SPAM_MAX; Nouvel_indice_flood < 0 -> 0; true -> Nouvel_indice_flood end,
 283          date_derniere_connexion = now()
 284       },
 285       % est-ce que l'auteur à trop floodé ?
 286       if Auteur#user.indice_flood =/= ?INDICE_SPAM_MAX, Auteur_maj#user.indice_flood =:= ?INDICE_SPAM_MAX, Delta =< ?DUREE_BLOCAGE_SPAM ->
 287          Root = root(),
 288          mnesia:write(Auteur#user{indice_flood = Auteur_maj#user.indice_flood}),
 289          mnesia:write(#minichat{id=Id, auteur_id=Root#user.id, date=now(), pseudo=Root#user.pseudo, contenu=Auteur#user.pseudo ++ "(" ++ Auteur#user.login ++ ") est bloqué pour " ++ integer_to_list(trunc(?DUREE_BLOCAGE_SPAM / 1000)) ++ " secondes pour cause de flood.."}),
 290          Id;
 291       Auteur#user.indice_flood =:= ?INDICE_SPAM_MAX, Delta =< ?DUREE_BLOCAGE_SPAM ->
 292          erreur;
 293       true ->
 294          mnesia:write(Auteur_maj),
 295          inserer_reponses(Id, Repond_A),
 296          mnesia:write(#minichat{id=Id, auteur_id=Auteur#user.id, date=now(), pseudo=Auteur#user.pseudo, contenu=Mess}),
 297          Id
 298       end
 299    end,
 300    resultat_transaction(mnesia:transaction(F)).
 301
 302
 303 % Retourne la difference entre deux timestamp (erlang:now()) en miliseconde
 304 delta_date_ms(D1, D2) ->
 305    1000000000 * abs(element(1, D1) - element(1, D2)) + 1000 * abs(element(2, D1) - element(2, D2)) + trunc(abs(element(3, D1) - element(3, D2)) / 1000).
 306
 307
 308 % Définit Id_repondant comme étant la réponse à Ids. Ids est une liste d'id.
 309 inserer_reponses(Id_repondant, [Id_mess | Reste]) ->
 310    mnesia:write(#reponse_minichat{repondant = Id_repondant, cible = Id_mess}),
 311    inserer_reponses(Id_repondant, Reste);
 312 inserer_reponses(_, []) ->
 313    ok.
 314
 315
 316 % Renvoie un nouvel id pour une table donnée
 317 nouvel_id(Table) ->
 318    mnesia:dirty_update_counter(counter, Table, 1).
 319
 320
 321 % Renvoie les messages manquants pour la page P en sachant qu'il y a N message
 322 % par page et que le dernier message que l'on possède est Id
 323 messages(Id, N, P) ->
 324    lists:filter(fun (M) -> M#minichat.id > Id end, messages(N, P)).
 325
 326
 327 % Renvoie N messages se trouvant sur la page P
 328 messages(N, P) ->
 329    F = fun() ->
 330       C = qlc:cursor(qlc:q([E || E <- qlc:keysort(2, mnesia:table(minichat), [{order, descending}])])),
 331       if P > 1 -> qlc:next_answers(C, N * (P - 1));
 332          true -> ok
 333       end,
 334       R = qlc:next_answers(C, N),
 335       qlc:delete_cursor(C),
 336       lists:reverse(R)
 337    end,
 338    resultat_transaction(mnesia:transaction(F)).
 339
 340
 341 % Renvoie N messages se trouvant sur la première page
 342 messages(N) ->
 343    messages(N, 1).
 344
 345
 346 % Renvoie {ok, #minichat} (voir #minichat de euphorik_bd.hrl) à partir de son id.
 347 message_by_id(Id) ->
 348    case resultat_transaction(mnesia:transaction(
 349       fun() ->
 350          qlc:e(qlc:q([E || E <- qlc:keysort(2, mnesia:table(minichat), [{order, ascending}]), Id =:= E#minichat.id]))
 351       end
 352    )) of
 353       [M] -> {ok, M};
 354       _ -> erreur
 355    end.
 356
 357
 358 % Renvoie une liste de message (voir #minichat de euphorik_bd.hrl) à partir d'une liste d'id (Ids).
 359 messages_by_ids(Ids) ->
 360    resultat_transaction(mnesia:transaction(
 361       fun() ->
 362          % TODO : optimisations ? serait-ce du O(n) ?
 363          Query = qlc:q([E || E <- qlc:keysort(2, mnesia:table(minichat), [{order, ascending}]), lists:any(fun(Id) -> Id =:= E#minichat.id end, Ids)]),
 364          %io:format("~s~n", [qlc:info(Query)]),
 365          qlc:e(Query)
 366       end
 367    )).
 368
 369
 370 % Renvoie le nombre de page total en fonction du nombre de message par page N
 371 % TODO : ya pas un moyen moins pourri pour avoir le nombre de record d'une table ?
 372 nb_page(N) ->
 373    resultat_transaction(mnesia:transaction(fun() ->
 374       ceiling(length(qlc:e(qlc:q([E#minichat.id || E <- mnesia:table(minichat)]))) / N)
 375    end)).
 376
 377
 378 % Bizarre, cette fonction n'existe pas dans la stdlib.
 379 ceiling(X) ->
 380    T = trunc(X),
 381    case (X - T) of
 382       Neg when Neg < 0 -> T;
 383       Pos when Pos > 0 -> T + 1;
 384       _ -> T
 385    end.
 386
 387
 388 % Renvoie tous les users.
 389 users() ->
 390    resultat_transaction(mnesia:transaction(fun() ->
 391       qlc:e(qlc:q([E || E <- mnesia:table(user)]))
 392    end)).
 393
 394
 395 % Renvoie les reponses (utilisé normalement uniquement pendant le debug).
 396 reponses() ->
 397    F = fun() ->
 398       qlc:e(qlc:q([E || E <- mnesia:table(reponse_minichat)]))
 399    end,
 400    resultat_transaction(mnesia:transaction(F)).
 401
 402
 403 % Renvoie les messages auquel M_id répond.
 404 repond_a(M_id) ->
 405    resultat_transaction(mnesia:transaction(
 406       fun() ->
 407          qlc:e(qlc:q(
 408             [M || E <- mnesia:table(reponse_minichat),
 409             M <- mnesia:table(minichat),
 410             E#reponse_minichat.repondant =:= M_id,
 411             M#minichat.id =:= E#reponse_minichat.cible]))
 412       end
 413    )).
 414
 415
 416 % Renvoie le résultat d'une transaction (en décomposant le tuple fournit)
 417 resultat_transaction({_, T}) ->
 418    T.
 419