Escolar Documentos
Profissional Documentos
Cultura Documentos
Graduate School
Amiable Aromas
Cookies and Coffee Shop
Customer Menu Management System
Software Requirements Specification Document
March 2016
Version: (1.00)
Date: (03/31/2016)
Table of Contents
1. INTRODUCTION
1.1Purpose
1.2Scope
1.3Definitions, Acronyms and Abbreviations
1.4References
1.5Overview
2. THE OVERALL DESCRIPTION
2.1Product Perspective
2.1.1 System Interfaces
2.1.2 Interfaces
2.1.3 Hardware Interfaces
2.1.4 Software Interfaces
2.1.5 Communications Interfaces
2.1.6 Memory Constraints
2.1.7 Operations
2.1.8 Site Adaptation Requirements
2.2Product Functions
2.3User Characteristics
2.4Constraints
2.5Assumptions and Dependencies
2.6Apportioning of Requirements
3. SPECIFIC REQUIREMENTS
3.1External Interfaces
3.2Functions
3.3Performance Requirements
3.4Logical Database Requirements
3.5Design Constraints
3.5.1 Standards Compliance
3.6Software System Attributes
3.6.1 Reliability
3.6.2 Availability
3.6.3 Security
3.6.4 Maintainability
3.6.5 Portability
3.7Organizing the Specific Requirements
3.7.1 System Mode
3.7.2 User Class
3.7.3 Objects
3.7.4 Feature
3.7.5 Stimulus
3.7.6 Response
3.7.7 Functional Hierarchy
1. INTRODUCTION
This section of the Software Requirements Specification (SRS) document
provides the overview of the Customer Menu Management System (CMMS) of
Amiable Aromas Cookies and Coffee Shop, specifically the systems purpose,
scope, definitions and references.
1.1Purpose
The purpose of this SRS document is to cover the overall description of the
software system of Amiable Aromas Cookies and Coffee Shop, specifically the
systems product perspective, hardware, software and communication
interfaces, memory constraints, operations, site adaptation requirements,
functions, characteristics, some constraints, assumptions and dependencies.
This SRS also detail the systems specific requirements, specifically
requirements on performance, logical database, design constraints, standard
compliance, software system attributes such as reliability, availability,
security, maintainability and portability, system mode, user class, objects,
features, stimulus, and response. Lastly, this SRS is intended for the
stakeholders and management of the Amiable Aromas Cookies and Coffee
Shop in general, and the systems engineers, analysts, designers,
implementers, testers, maintenance, and the users themselves in particular.
This SRS will document further changes, revisions and additions to any
requirement and functionality of the software system.
This SRS document is based upon IEEE Std 830-1998 IEEE Recommended
Practice for Software Requirements Specifications.
1.2Scope
In conventional cake stores and coffee shops, a static menu is utilized to
show the available food and beverage choices to customers. These menus
are generally paper based and therefore impose restrictions on the prices
available and a responsibility to update them. This document specifies the
requirements for a restaurant paper menu and ordering replacement
strategy to alleviate the problems associated with the current method. Three
related concepts are encompassed by the general scope of the Customer
Menu Management System (CMMS). The first pertains to the replacement of
paper-based menus using an electronic format, the second relates to an
electronic strategy for the front office handling or cashiering of a customers
order and the third surrounds the process of transferring said electronic
orders to the kitchen for preparation. It should be noted that while the
suggested strategy incorporates the use of various hardware components,
the primary focus of the presented SRS relates to the constituent software
elements.
The CMMS is a software package to facilitate ordering within Amiable Aromas
Cookies and Coffee Shop. The customer is able to view the menu, place
orders, call the waiter, and organize the final bill through an LCD screen
interface built into their table. Waiters are able to initialize a table for
Description
Single serving of food
Comprises one or more items
Comprises one or more orders (associated with one
customer)
Restaurant patron that orders/pays for a meal
General restaurant employee
Staff member whose primary job is to take orders/serve
meals to customers
Staff member whose primary job is to prepare items
Staff member whose primary job is to manage
restaurant operations
Comprises one or more seats at which customers sit
and place orders from
Comprises all the meals from a table
Comprises the total cost of zero or more meals and zero
or more tips
Backend computer that hosts the restaurant menu and
ordering system
Built into tables to provide customers with
menu/ordering functionality
Wireless mobile computer to provide staff with
customer serving functionality
Touch screen to provide a means for chefs to interact
with the system
Register System
Bankcard
Menu
Acronym
Description
SRS
Software Requirement Specification
CMMS
Customer Menu Management System
DBMS
Database Management System
LAN
Local Area Network
IP
Internet Protocol
TCP
Transmission Control Protocol
UDP
User Datagram Protocol
IEEE 802.11
Wireless Local Area Network Standard
SSLv3
Secure Sockets Layer Version 3
WPA2-PSK
Wi-Fi Protected Access 2 with Pre-Shared Key
UI
User Interface
Table 1.3 Table of Definitions, Acronyms and Abbreviations
1.4References
IEEE Std 830-1998 (Revision of IEEE Std 830-1993) IEEE Recommended
Practice for Software Requirements Specifications
Software Engineering: A Practitioner's Approach, 8/e
Roger S Pressman, R.S. Pressman & Associates, Inc
Bruce R. Maxim, University of Michigan
Software Engineering, 9/e
Ian Sommerville
Software Engineering Handbook
Jessica Keyes
Software Requirements, 3/e
Karl Wiegers and Joy Beatty
Systems Analysis and Design, 9/e
Gary B. Shelly and Harry J. Rosenblatt
1.5Overview
This UI will be designed for use with a stylus input into the touch-screen.
Because the number of operations the UI needs to support is relatively
limited, there will be no nested menu structure. The UI shall provide simple
graphical interfaces, similar to a map, to allow the user to select
tables/customers as the target of operations.
Display UI
The Display UI provides kitchen staff with simple functionality related to
ordered items. The UI will display the list of items in large, easy-to-read text,
sorted by time of submission with additional information (such as dietary
requirements and the destination table) displayed in tabulated format. Input
is provided by fingertips, as opposed to a stylus
2.1.3 Hardware Interfaces
There are three external hardware devices used by the CMMS, each related
to a user interface (see Section 2.1.2). These devices are the surface
computers, the wireless tablets and the touch displays. All three devices
must be physically robust and immune to liquid damage and stains. The
devices (with the possible exception of displays) must also have good
industrial design aesthetics, as they are to be used in place of normal
restaurant tables and notepads and will be in direct contact with customers.
The devices behave as 'terminals' in the sense that they never have a full
system image, do not store data and are not used for the core logic of the
system. However, they should be fully capable computers that can use
textual data from the server along with local UI/interpretation code to display
UI elements and take input. All order and transaction records should be
stored on the server, not these computers. The performance of these
terminals over an area the size of a restaurant is likely to be unacceptable. In
all three cases, the hardware device takes information from the CMMS and
processes the information to display. It also provides user input information
to the CMMS.
2.1.4 Software Interfaces
The CMMS will interface with a Database Management System (DBMS) that
stores the information necessary for the CMMS to operate. The DBMS must
be able to provide, on request and with low latency, data concerning the
restaurant's menu, employees (and their passwords) and available dietary
requirements. Additionally, it should take and archive data provided to it by
the CMMS. This data will include records of all orders and transactions
(system states and state changes) executed by the CMMS. The DBMS must
store all data such that it can be used for accounting, as well as
accountability.
2.1.5 Communications Interfaces
The CMMS will interface with a Local Area Network (LAN) to maintain
communication with all its devices. It should use a reliable-type IP protocol
such as TCP/IP or reliable-UDP/IP for maximum compatibility and stability. All
Accept Order
Deliver Item
Place Order
Pay Bill
Call Waiter
Process Bankcard Payment
Process Cash Payment
Abort Meal
Abort Account
Issue Refund
Accept/Reject Item
Indicate Item Ready
2.3User Characteristics
The end-users of the CMMS fall into three primary categories, unskilled,
partly skilled and highly skilled.
Unskilled User
The users of the surface computers are walk-in customers and should
therefore be assumed to have no relevant prior skills or education other than
basic abilities to operate an automated system; no more complex than a
parking meter or vending machine.
Partly skilled User
The users of the tablets and displays are waiters and chefs respectively and
they should be able to use the system and further be able to train others
with minimal training themselves. They must be able to explain all elements
of the user interfaces except the server. Supervisors also fall into the same
category, though they will have to learn other sections of the system
(refunds etc.); these should not be of notably greater complexity than the
standard functions. This class of user would be expected to have at least
completed high-school education or equivalent.
Highly skilled User
The initial installation and configuration of hardware and the constituent
CMMS system components (especially the server) is guaranteed to require
someone with notable computer experience, including extensive experience
with network and operating systems to complete it. The software should not
be needlessly complex, but it is still expected not to be entirely 'plug and
play'. This class of user is expected to have extensive computer experience.
2.4Constraints
The CMMS should be written in an object-oriented language with strong GUI
links and a simple, accessible network API. The primary candidate tool chains
are Java, C++ and Visual Basic. The system must provide a capacity for
parallel operation and system design should not introduce scalability issues
with regard to the number of surface computers, tablets or displays
connected at any one time. The end system should also allow for recovery,
without data loss, from individual device failure. There must be a strong
audit chain with all system actions logged. While interfaces are covered in
Section 2.1, it is worth noting that this system is likely to conform to what is
available. With that in mind, the most adaptable and portable technologies
should be used for the implementation. The system has criticality insofar as
it is a live system. If the system is down, then customers must not notice, or
notice that the system recovers quickly (seconds). The system must be
reliable enough to run crash and glitch free more or less indefinitely, or
facilitate error recovery strong enough such that glitches are never revealed
to its end-users.
2.5Assumptions and Dependencies
The SRS assumes that none of the constituent system components will be
implemented as embedded applications. The implication is that the target
hardware will provide a capacity for standalone program/application
deployment and not require customized embedded firmware to be written. It
is further assumed that tablet PCs of sufficient processing capability and
battery life will be utilized. The surface computers employed by the system
should facilitate being utilized/left on for extended periods (sufficient for
daily use) and that they are programmable in the same fashion as x86
architecture computers. Finally, it is further assumed that the deployment
environment is capable of supporting an IEEE 802.11 wireless network for
system communication.
2.6Apportioning of Requirements
This subsection pertains to both the functional and non-functional
requirements omitted unintentionally from this part of the SRS document.
3. SPECIFIC REQUIREMENTS
The following section presents the complete set of functional and nonfunctional requirements identified for the subject CMMS. Functional
requirements are listed first, according to their relationship to the overall
system, customers, waiters, chefs and supervisors. The non-functional
requirements that pertain to safety, security, the interface, human
engineering, qualification, operation, maintenance and performance are
subsequently presented. The functional requirements have been specified
using a natural language description using UML Analysis Models.
3.1External Interfaces
[Please refer to Section 2.1 of this document.]
3.2Functional Requirements
This subsection presents the identified functional requirements for the
subject CMMS.
Initially, general requirements that pertain to the whole
system are given. Where possible, subsequent requirements have been
demarcated based on their relevance to the users of the system, that
is, customers, waiters, chefs and supervisors.
3.2.1 General
Table 3.2.1 presents the identified functional general requirements that
Description
A server shall host the CMMS and provide system data
processing and storage capability.
GR2
A surface computer shall provide a customer with
all customer system functionality.
GR3
A tablet shall provide a waiter/supervisor with all
waiter/supervisor system functionality (according to
access control).
GR4
A display shall provide a chef with all chef system
functionality.
GR5
All system functionality shall be accessible through
touch sensitive surface computers, tablets and displays
via simple touch gestures.
GR6
A tablet shall be capable of interfacing with a register to
facilitate the accurate processing of a payment.
Table 3.2.1 General Functional Requirements
3.2.2 Customer
Table 3.2.2 presents the identified functional customer requirements
that directly relate to the customers of the subject CMMS.
Requirement
CR1
CR2
CR3
CR4
CR5
CR6
CR7
CR8
CR9
Description
A customer shall be able to engage their menu by
double tapping the activated surface computer in their
table.
A customer shall be able to dismiss their menu by
double tapping its dismiss option.
A customer shall be able to create an empty
pending order through their engaged menu.
A customer shall not be able to dismiss their
engaged menu while there is a non-empty pending
order associated with the engaged menu.
A customer shall be able to navigate through the
available items in their engaged menu.
A customer shall be able to add an item to a
pending order by dragging the item from the
engaged menu onto the order.
A customer shall be able to remove an item from a
pending order by dragging the item off the order.
A customer shall be able to add a special dietary
requirement to an order by dragging the requirement
from the engaged menu onto the order.
A customer shall be able to add a wildcard special
dietary requirement to an order in the case that their
Requirement
WR1
WR2
WR3
WR4
Description
A waiter shall be able to log into a tablet using
their assigned username and password.
A waiter shall be able to log out of a tablet.
A waiter shall be able to activate a surface computer
and consequently open its associated account through
a tablet.
A waiter shall be able to deactivate a surface computer
Description
A chef shall be able to accept a customers order item
through a display.
CHR2
A chef shall be able to reject a customers order item
through a display.
CHR3
A chef shall be able to indicate that a customers
order item is ready to be served through a display.
Table 3.2.4 Chef Functional Requirements
3.2.5 Supervisor
Table 3.2.5 presents the identified functional supervisor requirements
that directly relate to the supervisors of the subject CMMS.
Requirement
SR1
SR2
SR3
Description
A supervisor shall be able to do everything a waiter
can.
A supervisor shall be able to do everything a chef can.
A supervisor shall be able to abort a customers
Figure 3.2.6 Use Case Diagram of the Customer Menu Management System
3.3Software System Attributes
This subsection presents the identified non-functional requirements for
the subject CMMS. The subcategories of non-functional requirements given
Description
The system shall log every state and state change of
every surface computer, tablet and display to provision
recovery from system failure.
SNR2
The system shall be capable of restoring itself to its
previous state in the event of failure (e.g. a system
crash or power loss).
SNR3
The system shall be able to display a menu at all
times to facilitate manual order taking should the
need arise.
SNR4
The system shall utilize periodic 30-second keep-alive
messages between tablets and the server to monitor
tablet operational status.
SNR5
The system shall flag tablets that fail to send
timely keep-alive messages as non-operational and
disassociate the assigned waiter from the tablet.
Table 3.3.1 Safety Requirements
3.3.2 Security
Table 3.3.2 presents the identified non-functional security requirements
that directly relate to the entire subject CMMS.
Requirement
SFNR1
SFNR2
SFNR3
SFNR4
SFNR5
SFNR6
SFNR7
Description
Wireless communication throughout the system will be
encrypted using SSLv3 at the application layer and
WPA2-PSK at the data link layer.
The
WPA2-PSK
password
used
for
wireless
communication must have bit strength of at least 80
bits.
The
WPA2-PSK
password
used
for
wireless
communication must be changed every three months.
A waiter password used for tablet login must have a bitstrength of at least 64 bits.
A waiter password used for tablet login must be
changed every three months.
A waiter shall only be able to log into one tablet at any
given instance of time.
A waiter that attempts to log into a second tablet
while already logged into another tablet shall be
rejected and notified through both tablets.
SFNR8
Description
The server shall be capable of supporting no less than
100 concurrent connections from any combination of
surface computers, tablets and displays.
PNR2
The server shall be capable of supporting an arbitrary
number of surface computers, tablets and displays, that
is, it shall provide no limit on how many devices are in
the system.
PNR3
The server shall be capable of supporting an arbitrary
number of active meals/orders, that is, no meals/orders
shall be lost under any circumstances.
PNR4
The server shall be capable of supporting an arbitrary
number of active customer payments, that is, no
payments shall be lost under any circumstances.
Table 3.4 Performance Requirements
3.5 Logical Database Requirements
The following table 3.5 presents descriptions for the classes identified for the
subject CMMS and a class diagram showing the object classes and
relationships involved in a use case. The class diagram of figure 3.5 is a
logical model, which evolves into a physical model and finally becomes a
functioning information system. In structured analysis, entities, data stores,
and processes are transformed into data structures and program code.
Similarly, class diagrams evolve into code modules, data objects, and other
system components.
Class
Item
Description
This class represents an item of food or beverage from
the restaurants menu. It exists as a part of either a
single order or a single meal, but not both at the same
time. An Item that is part of an order may contain a
dietary requirement. An Item contains the menu
DietaryRequirem
ent
Order
Meal
Account
Table
Tablet
Alert
Payment
BankcardPaymen
t
CashPayment
Figure 3.5 Class Diagram of the Logical Database Requirements of the CMMS
Evaluate CR
Authorize CR
Implement CR
CHANGE REQUEST
Element
Date
CR#
Title
Description
Submitter
Phone
E-Mail
Product
Version
Priority
Open
Work in
Progress
In Review
Testing
Closed
<status
type>
[Insert
Role]
[Insert
Name]
RESPONSIBILITIES
Role
Name
Project
Manager
Change
Manager
[Insert
[Insert
Role]
Name]
5 DOCUMENT APPROVALS
Contact
Description
[Insert
Contact #]
Contact
Description
[Insert
Contact #]
Signature:
Date:
Print
Name:
Title:
Role:
Signature:
Date:
Print
Name:
Title:
Role:
6 SUPPORTING INFORMATION
The supporting information makes the SRS easier to use. It includes the
following:
a) Table of contents
[Please refer to the beginning of this document.]
b) List of Tables
c) List of Figures
d) Appendix A Cost-Benefit Analysis
List of Tables
Table
Table
Table
Table
Table
Table
Table
Table
Table
Table
List of Figures
Figure 3.2.6 Use Case Diagram of the Customer Menu Management System
Figure 3.5 Class Diagram of the Logical Database Requirements of the CMMS
Appendix A
Cost-Benefit Analysis
Interaction
Old System
(Manual)
The customer
calls upon the
presence of the
waiter for the
physical printout
of the menu
New System
(CMMS)
The customer
simply looks at
the menu in the
touch-sensitive
surface computer
mounted on the
tables
Customer
ordering
The customer
depends upon
the abilities of
the waiter for
his/her order to
be placed
Cancellation of
order
The customer
depends upon
the abilities of
the waiter for
his/her order to
be cancelled
Billing/Payment
The customer
depends upon
the abilities of
the waiter for
his/her bill
The customer
simply inputs
his/her order to
the touchsensitive surface
computer
mounted on the
tables
The customer
simply cancels
his/her order
using the touchsensitive surface
computer
mounted on the
tables
The customer
simply pays
his/her order
using the touchsensitive surface
computer
mounted on the
tables
Customer menu
referencing
Benefit
Elimination of
waiter-tocustomer delay
when offering the
menu, especially
if customers are
numerous for
waiters to handle,
thus enhancing
customer service
Eliminated delays
from customer to
waiter to chef.
Eliminated any
errors in ordering
Conveniently
cancels any
order, informing
the chef of this at
a moments
instant
The customer
doesnt have to
wait for any
available waiter,
and doesnt need
to give his/her
credit card
information to the
waiter thus
eliminating any
risk in identity
theft