# Note de clarification - VERSION 1 ## Objectifs du document Il s'agit ici de réaliser un systeme de gestion pour une bibliothèque municipale qui cherche à informatiser ses activités. Après avoir rappelé les livrables attendus pour ce projet et les besoins établis dans le cahier des charges, nous listerons les objets qui seront gérés dans notre base de données, avec leurs propriétés et leurs contraintes. Nous listerons ensuite les utilisateurs qui pourront interagir avec cette base de données puis nous établirons les fonctions utilisables par ces derniers. ### Livrables attendus README Note de clarification ici déclarée au format markdown Modele conceptuel de donnée (MCD) au format plantuml Modele logique de donnée (MLD) relationnel au format plain text BDD : tables et vues, données de test, questions attendues (vues) Application Python ### Rappel des besoins établis dans le cahier des charges * Faciliter aux adhérents la recherche de documents et la gestion de leurs emprunts. * Faciliter la gestion des ressources documentaires : ajouter des documents, modifier leur description, ajouter des exemplaires d'un document, etc. * Faciliter au personnel la gestion des prêts, des retards et des réservation. * Faciliter la gestion des utilisateurs et de leurs données. * Établir des statistiques sur les documents empruntés par les adhérents, cela permettra par exemple d'établir la liste des documents populaires, mais aussi d'étudier le profil des adhérents pour pouvoir leur suggérer des documents. ## Description des Objets, de leurs propriétés et des contraintes associées ### Ressources Cette base de données contiendra des **ressources** qui seront caractérisées par une *code* unique, un *titre*, une *date d'apparition*, un *éditeur*, un *genre*, un *code de classification* et un *état* de type "neuf", "bon", "abîmé" ou "perdu". Ces **ressouces** se diviseront en trois catégories : les **livres**, les **films** et les **enregistrements musicaux**. Un **livre** possèdera un *ISBN*, un *résumé* et une *langue*. Un **film** possèdera une *langue*, une *longueur* et un *synopsis*. Un **enregistrement musical** possèdera une *longueur*. #### Ressources | Attributs | Contraintes | | -------- | -------- | | code | unique, not null | | titre | not null | | dateDeApparition | | | editeur | | | genre | not null | | etat | not null | | codeClassification | unique | * **Le code** doit etre unique et non nul car il doit permettre d'identifier chaque ressource. * **Le code de classification** est unique, car un emplacement ne peut contenir qu'une ressource à la fois mais il peut etre nul car il peut ne pas etre disponible en rayons. * chaque ressource a forcément un **état** et un **titre** ces attributs sont donc uniques. La **date d'apparition** et **l'editeur** peuvent etre inconnu, le document pouvant ne pas etre daté et rédigé sans éditeur. #### Livre (fille de Ressources) | Attributs | Contraintes | | -------- | -------- | | ISBN | unique, Not null | | resume | | | langue | | * Pour des raisons d'identification, l'isbn est unique ne peut pas etre nul. #### Film (fille de Ressources) | Attributs | Contraintes | | -------- | -------- | | longueur | | | synopsis | | #### Enregistrement musical (fille de Ressources) | Attributs | Contraintes | | -------- | -------- | | longueur | | ### Contributeurs Les contributeurs des **ressources** seront caractérisés par un *nom*, un *prenom*, une *date_de_naissance* et une *nationalité*. Ces **contributeurs** se diviseront en cinq catégories : **auteur**, **compositeur**, **interprète**, **réalisateur** et **acteur**. #### Contributeurs | Attributs | Contraintes | | -------- | -------- | | nom | Not null| |prénom | Not null| |date_naissance | |nationalite| |role(s)| not null| * le nom et le prenom du contributeur doivent etre connus, sa date de naissance (pour des auteurs tres anciens ou hypothetiques) ainsi que la nationalite peuvent ne pas etre renseignés. * un contributeur a forcément un ou plusieurs roles (il peut a la fois etre acteur et producteu) ### Personnes On représentera aussi des **personnes** ayant un *login*, un *mot de passe*, un *nom*, un *prenom*, une *adresse* et un *email*. Ces **personnes** se diviseront en deux catégories : les **adhérents** et le **personnel**. #### Personne | Attributs | Contraintes | | -------- | -------- | | login | unique, not null | | mdp| Unique, not null | | nom | not null | |prenom | not null | |adresse| not null | |email| #### Adhérent Les **adhérents** auront les attributs supplémentaires suivant : un *numéro de tél*, une *date_naissance*, une *date_début*, une *date_fin*. On ajoute également les attributs nombre_emprunts, sanctionné de type booléen et blacklisté de type booléen ce qui nous permettra de savoir si l’utilisateur peut emprunter ou non. | Attributs | Contraintes | | -------- | -------- | |num_tel| |date_naissance | |date_debut| not null | |date_fin| |nombre_emprunts | doit etre en dessous de valeur SEUIL| |Sanctionné| | |Blackliste|| #### Personnel Tous les attributs de la classe Personnel seront factorisés au niveau de Personne. ### Sanction Les adhérents doivent retourner les ressources qui ont été empruntés avant la date limite de retour et dans le même état que lorsque emprunté. Dans le cas contraire il sera sanctionné. | Attributs | Contraintes | | -------- | -------- | |date_sanction|not null | |retard| |frais| ### Emprunt Des **adhérents** peuvent emprunter des **ressources** (documents). Chaque prêt est caractérisé par la date d'emprunt *date_debut* et une *durée_prêt* (limité). Il y a des contraintes sur le prêt. Le nombre de documents empruntés simultanément par une personne est limitée. Un document ne peut être emprunté que s'il est disponible et en bon état. #### Emprunt | Attributs | Contraintes | | -------- | -------- | | date_début|not null| | date_fin_normale| not null | | date_fin_réel| * un emprunt a forcement une date de debut mais pas forcement de fin (perte de la ressource par exemple) ### Réservation Des **adhérents** peuvent réserver des **ressources** (documents). Chaque réservation est caractérisé par la personne qui l'emprunte *emprunteur* et une *date_prévue*. ## Méthodes à concevoir ### Méthodes générales Nous devrons pouvoir ***rechercher***, ***ajouter***, ***mettre à jour***, ***supprimer*** des données concernant le **Personnel**, les **Adhérents**, les **Ressources** et les **Contributeurs**. Sauf la méthode *rechercher* concernant l'objet **Ressource** et l'objet **Contributeurs**, les adhérents ne doivent pas avoir accès aux méthodes. On doit restreindre l'accès à ces fonctions au personnel seuseuseu ### Méthodes spécifiques #### Gestion des utilisateurs et de leurs données ##### Authentification de l'utilisateur * login Il permet à l'utilisateur de se connecter. * logout Il permet à l'utilisateur de se déconnecter. * résilier Il permet à l'utilisateur de résilier son adhéren. #### Gestion des ressources documentaires * ajouterDocument Il permet d'ajouter une nouvelle ressource. * modifierDescription Nous pouvons modifier la description de la ressource spécifiée. * ajouterExemplaire ### Côté adhérent #### Recherche de documents * recherche Elle permet à l'utilisateur de rechercher une ressource. #### Gestion des emprunts * retournerRessource Elle permet à l'utilisateur de retourner un/des document(s). * regarderEmprunts Elle permet d'afficher l'ensemble des emprunts. #### Gestion des sanctions * payerSaction Elle permet à l'utilisateur de régler les frais qu'il doit à la bibliotheque ### Côté personnel #### Gestion des prêts * supprimerPrêt Si nécessaire, l'administrateur a le droit de supprimer un prêt. * regarderPrêts Elle permet d'afficher tous des prêts qui sont étés éffectués. #### Gestion des retards * regarderRetards Elle permet d'afficher l'ensemble des retards #### Gestion des réservation * regarderReservations Elle permet à l'administateur d'afficher l'ensemble des réservations. #### Gestion des sanctions * ajouterBlacklist Le personnel peut catégoriser un adhérent comme nuisible pour la bibliotheque et l'empecher ainsi d'emprunter à nouveau #### Établir des statistiques sur les documents empruntés * nombreEmprunte Nous devons aussi pouvoir calculer quelques chiffres relatifs aux données pour l'administration telles que le nombre des documents empruntés par les adhérents. * ressourcesPopulaires Nous pouvons compter le nombre de fois que chaque ressource a été empruntée et la renvoyer sous forme de liste de ressources populaires.