Proj-2014-2015-SmartClassroom/SRS

The document provides a template of the Software Requirements Specification (SRS). It is inspired of the IEEE/ANSI 830-1998 Standard.

Read first:
 * http://www.cs.st-andrews.ac.uk/~ifs/Books/SE9/Presentations/PPTX/Ch4.pptx
 * http://en.wikipedia.org/wiki/Software_requirements_specification
 * IEEE Recommended Practice for Software Requirements Specifications IEEE Std 830-1998

=1.  Introduction=

1.1 Purpose of the requirements document
This document presents the aim of the project Smart Classroom as well as the functionnal and non-functionnal requirements, risks and quality standards.

1.2 Scope of the product
This project is integrated at the RICM4 engineering training (Computing Networks and Multimedia Communication) in Polytech'Grenoble school. It will be led by 4 students (2 in the Multimedia option and 2 in the Network option) and will last 7 weeks.

1.3 Definitions, acronyms ans abbrevations

 * NFC : Near Field Communication. A NFC tag can be linked to information such as web page, social networks and all sorts of other information in general.
 * MCQ : Multiple-choice Questionnaire
 * ID : Identifier

1.4 References
Our work follows on from different projects realised by ENSIMAG students : Smart Classroom

1.5  Overview of the remainder of the document
=2.  General description= The aim of this project is to design a new innovative information system for the future of the classroom, by making easier and especially automating daily tasks. Although there are already four projects linked to the smart classroom and realized by ENSIMAG students, our module have to fit in well with the others in order to obtain a real innovative infrastructure.

2.1 Product perspective
Our product has to meet the following need : Students come in class, announce their presence and get settled at their work station. The teacher does the same and accesses his plateform where he can get courses and exams that he has created before. Then, the teacher can submit multiple-choice questionnaire to students. They answer to it individually before submitting their answer to the teacher. After that, he can refer to the results and publish it by theme. The teacher can start again a lesson if he sees that it hasn't been clear enough for his students. Finally, he can reorganize students by working group.

2.2 Product functions

 * Individual and secured idendentification
 * Creation of courses' constituents
 * Reply to the test by the students
 * Results display
 * Reorganisation of the students in working groups depending on their level

2.3 User characteristics
There are two types of users for this product and in two different inputs. The first type of user is the teacher who is able to create, modify, pusblish courses and exams. Then there are the students, who, by means of their working space, answer the quizzes and submit their answers.

2.4 General constraints

 * Application has to work on tablet
 * Stable wifi connection is needed inside the smart classroom

2.5 Assumptions and dependencies

 * No access to extern websites
 * Smart Classroom environment allows us to link the tablets to the Moodle server

=3.  Specific requirements, covering functional, non-functional and interface requirements=
 * document external interfaces,
 * describe system functionality and performance
 * specify logical database requirements,
 * design constraints,
 * emergent system properties and quality characteristics.

3.1 Requirement X.Y.Z (in Structured Natural Language)
Function: Realisation and management of MCQ as part of the SmartClassroom

Description: Our project consists in developing a system wich allows a teacher to prepare his lessons and create MCQ on one hand, and on the other hand allows students to answer at these MCQ. We will also have to manage the identification of each student in order to control their presence during the lessons.

Inputs: Students' and teacher's tablets

Source: NFC tag, touch sreen

Outputs: Identification, answers to each student's question

Destination: This projects is designed to be integrated in the environment of a SmartClassroom and is bound for being used by teachers and students.

Action:
 * Natural language sentences (with MUST, MAY, SHALL)
 * Graphical Notations : UML Sequence w/o collaboration diagrams, Process maps, Task Analysis (HTA, CTT)
 * Mathematical Notations
 * Tabular notations for several (condition --> action) tuples

Côté enseignant : Côté étudiant :
 * Doit permettre la création des QCM
 * Doit permettre la récupération des résultats
 * Pourrait effectuer le tri des résultats en fonctions des élèves/ des questions/ des réponses
 * Doit permettre l'identification à l'aide d'un ID personnel ou d'un tag NFC
 * Doit permettre de répondre au QCM
 * Peut donner un accès direct au résultat
 * Doit permettre d'effectuer des modifications avant envoi du QCM
 * Doit permettre l'identification à l'aide d'un ID personnel ou d'un tag NFC

Exigences non-fonctionnelles:
 * Facilité d'utilisation : Pas d'expérience utilisateur requise
 * Portabilité : Utilisation sur tablette
 * Taille : L'application ne dépasse pas quelques Mo
 * Utilisabilté : Interface claire et travaillée, de façon à pourvoir une expérience utilisateur efficace
 * Robustesse: L'application doit continuer à fonctionner et surveiller lors d'une panne du réseau

Pre-condition:
 * Côté matériel :
 * - une tablette doit être disponible pour chaque élève et pour le professeur
 * - chaque élève doit être muni d'un badge afin de l'identifier


 * Côté application :
 * - une connexion WiFi doit être maintenue dans la salle de classe

Post-condition:
 * le professeur est capable de créer des supports pour son cours et des QCM via l'application
 * les élèves sont identifiés grâce à leur badge

Effets secondaires:

=4. Evolution du produit= Le projet SmartClassroom est basé sur un ensemble de scénarios réalisés par plusieurs groupes, la partie réalisée ici n'étant que l'un d'entre eux. De futures améliorations de cet environnement pourront être proposées et implémentées par de prochains groupes en charge du développement de cette classe.

=5. Annexes=

=6. Index=