Proj-2013-2014-SmartCitizen2014/SRS

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

=1.  Introduction=

1.1 Purpose of the requirements document
This Software Requirements Specification (SRS) identifies the requirements for the SmartCitizen project. The purpose of the present document is to explain how we organize our project, the different steps of the conception and the project achievement.

1.2 Scope of the product
The purpose of this project is to monitor a city thanks to sensors spread in it and to visualize the data, sent by those sensors, on a map.

1.3 Definitions, acronyms and abbreviations

 * MQTT (MQ Telemetry Transport) : It is a messaging protocols that can be used by a range of devices from small sensors, to mobile phones, embedded systems on vehicles, or laptops. It uses the publish-subscribe messaging pattern.
 * Arduino : It is a open-source board with a microcontroller, intended to make the application of interactive objects or environments more accessible.
 * MongoDB :A NoSQL cross-platform document-oriented database system. It uses a JSON-like structure (named BSON) instead of the traditional table-based system.
 * Leaflet : A open-source JavaScript library for building web mapping applications.

1.4 References
http://leafletjs.com/

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

2.1 Product perspective
At first, the website will enable people to see data from sensors on a map. Then, a bit of statistics will be made in order to display zone in function of some parameters. Finally, the user will be able to take a picture with geolocalisation and post it on twitter, so that the picture is displayed on the web site.

2.2 Product functions
If a user want to send data from its own sensors to the web site, he will have to register in order to obtaining a key that will be required to setup the sensors. The web site display the position of the sensors as well as the data they send to the web site. Zones are also displayed depending on those data.

2.3 User characteristics
A web browser with JavaScript enabled is needed. An access to Twitter is required if the user want to see the alert from twitter.

2.5 Assumptions and dependencies
=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:
 * Gather information from several sensors
 * Post information on a map, available from a browser

Description:

Inputs:
 * MQTT data from sensors

Source:
 * Different types of sensors (MQ4, DHT11 ...). They could be plugged to an arduino.

Outputs: Destination:
 * A website
 * A twitter stream
 * Citizen
 * Town hall

Action:
 * Post a tweet when a threshol is reached

Non functional requirements:
 * Sensors are not blocked

Pre-condition:


 * Hardware:
 * - Computer
 * - Arduino Leonardo
 * - Arduino ethernet shield
 * - Sensors


 * Software:
 * - Arduino IDE
 * - Nodejs
 * - Mongodb
 * - Mosquitto

Post-condition:

Side-effects:
 * Real time information
 * Reactivity from the Town hall

=4. Product evolution=

=5. Appendices= =6. Index=