RICM4 2017 2018 - SeriousGame Polystar / 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
Polystar powerpoint’s aim is to give the rules of the game.

1.2 Scope of the product
This project will be an educative game for Polytech students, allowing them to improve their english level.

1.3 Definitions, acronyms and abbreviations
SeriousGame : It is a game designed for a purpose other than pure entertainment. Here, it is designed for education and studies. Meteor: JavaScript Web framework written using NodeJS. Meteor produces cross-platform code.

1.4 References
https://air.imag.fr/images/a/ad/Polystar.pdf

1.5 Overview of the remainder of the document
=2.  General description=

2.1 Product perspective
In the future our product is designed to be adapted in other languages (spanish) and other difficulties (other than 3rd year English). The users will be able to add their own cards and units to the game.

2.2 Product functions
The main function of the product is making it easier to learn 3rd year english in Polytech by providing a learning game. This game contains several english question cards created by A-L. Finkel, the Polytech Grenoble headmaster english teacher. The students users are allowed to see the ladderboard and to choose which unit to play with. The teacher is allowed to create, modify and delete cards from the game.

2.3 User characteristics
2 types of users :

- Teacher

- Students / Players

The teacher can modify / add / delete the cards and the units of the game. Therefore, he needs a password to avoid students to access to this part.

The players / students will have the access to the ranking and the game.

2.4 General constraints
- Multi-Users

- Asymmetrical use of the product for the different types of user

- Web application

2.5 Assumptions and dependencies
- Use of tactile tables (Digitales of Actualities)

- Use of the NUC

=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 Teacher1 (in Structured Natural Language)
Function: Modify, add and delete card and units of the game.

Description: The teacher has the rights to change things in the game such as the cards used to play.

Inputs: A person who is authenticated thanks to a password.

Source:

Outputs: The person who has the rights has modified / added / deleted a card.

Destination:

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

Non functional requirements: Security

Pre-condition: A teacher who wants to change cards of the game.

Post-condition: A modified pack of cards.

Side-effects:

=4. Product evolution=

=5. Appendices= =6. Index=