Merge branch 'specs-v01' into 'master'

specs proposal

Approbation des modifications.

See merge request !1

book/LANGS.md

@@ -0,0 +1,2 @@
+* [English](en/)
+* [Français](fr/)

book/README.md

@@ -0,0 +1 @@
+# Introduction

book/SUMMARY.md

@@ -0,0 +1 @@
+# Summary

book/fr/README.md

@@ -0,0 +1 @@
+# Introduction

book/fr/SUMMARY.md

@@ -0,0 +1,7 @@
+# Summary
+
+* [Introduction](introduction/README.md)
+* [Modèle-Template-Vue](mtv/README.md)
+  * [Modèle](mtv/models.md)
+  * [Template](mtv/template.md)
+  * [Vue](mtv/views.md)

specs.md

@@ -1,4 +1,5 @@
-# Single App
+Single App
+==========
 
 Pour commencer, nous allons nous concentrer sur la création d'un site ne contenant qu'une seule application, même si en pratique le site contiendra déjà plusieurs applications fournies pas django, comme nous le verrons plus loin.
 
@@ -11,57 +12,102 @@ Ensuite, nous pourrons traduire ces besoins en fonctionnalités et finalement ef
 Besoins utilisateur du site gwift
 ---------------------------------
 
-Nous souhaitons développer un site où un utilisateur donné peut créer une liste contenant des souhaits et où d'autres utilisateurs peuvent choisir les souhaits qu'il souhaite réaliser.
-Il ne sera pas nécessaire de s'authentifier pour réaliser un souhait mais bien pour créer une liste.
+Nous souhaitons développer un site où un utilisateur donné peut créer une liste contenant des souhaits et où d'autres utilisateurs, authentifiés ou non, peuvent choisir les souhaits qu'ils souhaitent réaliser.
+Il sera nécessaire de s'authentifier pour : 
 
-L'utilisateur ayant créé une liste pourra envoyer un email directement depuis le site aux personnes avec qui il souhaite partager sa liste, ce dernier contenant la manière d'y accéder.
+ 1. Créer une liste associée à l'utilisateur en cours
+ 1. Ajouter un nouvel élément à une liste
+ 
+Il ne sera pas nécessaire de s'authentifier pour :
+ 1. Faire une promesse d'offre pour un élément appartenant à une liste, associée à un utilisateur.
 
-A chaque souhait, on pourrait de manière facultative ajouter un prix. Dans ce cas, le souhait pourrait aussi être subdivisé en plusieurs part, de manière à être offert par plusieurs autres personnes.
+L'utilisateur ayant créé une liste pourra envoyer un email directement depuis le site aux personnes avec qui il souhaite partager sa liste, cet email contenant un lien permettant d'accéder à cette liste.
 
-Un souhait pourrait aussi être réalisé plusieurs fois
+A chaque souhait, on pourrait de manière facultative ajouter un prix. Dans ce cas, le souhait pourrait aussi être subdivisé en plusieurs parts, de manière à ce que plusieurs personnes puissent participer à sa réalisation.
+
+Un souhait pourrait aussi être réalisé plusieurs fois.
 
 Besoins fonctionnels du site gwift
 ----------------------------------
 
 ### Gestion des utilisateurs
 
-Pour gérer les utilisateurs, nous utiliserons directement ce que django met à notre disposition
+Pour gérer les utilisateurs, nous utiliserons ce que Django met par défaut à notre disposition.
 
 ### Gestion des listes
 
 #### Modèlisation
 
 Les données suivantes doivent être associées à une liste:
-
 * un identifiant
+* un identifiant externe
 * un nom
 * une description
+* le propriétaire
+* une date de création
+* une date de modification
 
 #### Fonctionnalités
 
- 1. Il faut pouvoir créer, modifier, désactiver et supprimer une liste, avec un utilisateur authentifié
- 2. Il faut pouvoir y associer ou retirer des souhaits avec un utilisateur authentifié
- 3. Il faut pouvoir accéder à une liste, avec un utilisateur authentifier ou non, via le uid.
- 4. Il faut pouvoir envoyer un email avec le lien vers la liste, contenant l'uid.
- 5. L'utilisateur doit pouvoir voir toutes les listes qui lui appartiennent
+ 1. Un utilisateur authentifié doit pouvoir créer, modifier, désactiver et supprimer une liste dont il est le propriétaire
+ 1. Un utilisateur doit pouvoir associer ou retirer des souhaits à une liste dont il est le propriétaire
+ 1. Il faut pouvoir accéder à une liste, avec un utilisateur authentifier ou non, *via* son identifiant externe
+ 1. Il faut pouvoir envoyer un email avec le lien vers la liste, contenant son identifiant externe
+ 1. L'utilisateur doit pouvoir voir toutes les listes qui lui appartiennent
 
 ### Gestion des souhaits
 
 #### Modélisation
 
 Les données suivantes peuvent être associées à un souhait:
+* un identifiant
+* identifiant de la liste
 * un nom
 * une description
+* le propriétaire
+* une date de création
+* une date de modification
 * une image
-* un prix facultatif
 * un nombre (1 par défaut)
-* un nombre de part facultatif, si un prix est fourni
-* la liste à laquelle il appartient
+* un prix facultatif
+* un nombre de part facultatif, si un prix est fourni.
+
+#### Fonctionnalités
+
+ 1. Un utilisateur authentifié doit pouvoir créer, modifier, désactiver et supprimer un souhait dont il est le propriétaire.
+ 1. On ne peut créer un souhait sans liste associée
+ 1. Il faut pouvoir fractionner un souhait uniquement si un prix est donné.
+ 1. Il faut pouvoir accéder à un souhait, avec un utilisateur authentifié ou non.
+ 1. Il faut pouvoir réaliser un souhait ou une partie seulement, avec un utilisateur authentifié ou non.
+ 1. Un souhait en cours de réalisation et composé de différente part ne peut plus être modifié.
+ 1. Un souhait en cours de réalisation ou réalisé ne peut plus être supprimé.
+ 1. On peut modifier le nombre de fois qu'un souhait doit être réalisé dans la limite des réalisations déjà effectuées.
+ 
+### Gestion des réalisations de souhaits
+ 
+#### Modélisation
+
+Les données suivantes peuvent être associées à une réalisation de souhait:
+* identifiant du souhait
+* identifiant de l'utilisateur si connu
+* identifiant de la personne si utilisateur non connu
+* un commentaire
+* une date de réalisation
+
+#### Fonctionnalités
+
+ 1. L'utilisateur doit pouvoir voir si un souhait est réalisé, en partie ou non.
+ 1. L'utilisateur doit pouvoir voir la ou les personnes ayant réaliser un souhait.
+ 1. Il y a autant de réalisation que de parts de souhait réalisées ou de nombre de fois que le souhait est réalisé.
+ 
+### Gestion des personnes réalisants les souhaits et qui ne sont pas connues
+ 
+#### Modélisation
+
+Les données suivantes peuvent être associées à une personne réalisant un souhait:
+* un identifiant
+* un nom
+* une adresse email facultative
 
 #### Fonctionnalités
 
- 1. Il faut pouvoir créer, modifier, désactiver et supprimer un souhait, avec un utilisateur authentifié
- 2. On ne peut créer un souahit sans liste associée
- 3. Il faut pouvoir fractionner un souhait uniquement si un prix est donné.
- 4. Il faut pouvoir accéder à un souhait, avec un utilisateur authentifier ou non.
- 5. Il faut pouvoir réaliser un souhait ou une partie seulement, avec un utilisateur authentifier ou non.