diff --git a/BlankProjectTemplate/Doc/SRS/SRS.bib b/BlankProjectTemplate/Doc/SRS/SRS.bib
index 59ee07fbeb2bb8215f6f79cfb4b04bb844cc9956..08ca28ce10ccaa68d5d48a977490ebae68da25b5 100644
--- a/BlankProjectTemplate/Doc/SRS/SRS.bib
+++ b/BlankProjectTemplate/Doc/SRS/SRS.bib
@@ -7,6 +7,11 @@
%% Saved with string encoding Unicode (UTF-8)
+@article{devArticle,
+ Author = {Sumit Jain},
+ Title = {Game Development Life Cycle},
+ Year = {May 2017}
+}
@book{RobertsonAndRobertson2012,
Author = {James Robertson and Suzanne Robertson},
diff --git a/BlankProjectTemplate/Doc/SRS/SRS.pdf b/BlankProjectTemplate/Doc/SRS/SRS.pdf
index 9c14fc718ca445ad71ff57c4a7c97858f58e8e67..316cff738164691bcec6104cfd7d2f20a031099e 100644
Binary files a/BlankProjectTemplate/Doc/SRS/SRS.pdf and b/BlankProjectTemplate/Doc/SRS/SRS.pdf differ
diff --git a/BlankProjectTemplate/Doc/SRS/SRS.tex b/BlankProjectTemplate/Doc/SRS/SRS.tex
index e6c8a5ccbab10f91c1fd1e268474d22e0d7048be..788ff346d72a6be9245517f3a9ad12be9f10b4d8 100644
--- a/BlankProjectTemplate/Doc/SRS/SRS.tex
+++ b/BlankProjectTemplate/Doc/SRS/SRS.tex
@@ -7,22 +7,21 @@
colorlinks,
citecolor=black,
filecolor=black,
- linkcolor=red,
+ linkcolor=black,
urlcolor=blue
}
\usepackage[round]{natbib}
\title{SE 3XA3: Software Requirements Specification\\Title of Project}
-\author{Team \#, Team Name
- \\ Student 1 name and macid
- \\ Student 2 name and macid
- \\ Student 3 name and macid
+\author{Team 30, VUA
+ \\ Andy Hameed and hameea1
+ \\ Usman Irfan and mac Id
+ \\ Vaibhav Chadah and macid
}
\date{\today}
-\input{../Comments}
\begin{document}
@@ -57,21 +56,94 @@ to the template, you should explicity state what modifications were made.
\subsection{The Purpose of the Project}
+Almost everyone nowadays relies on a computer as a multipurpose tool for research, video streaming, gaming and many other tasks. With the emergence of fast computing, gaming has become a popular pastime activity and a source of entertainment for many. However, not everyone has a device powerful enough to support extensive game applications. A simple installation and memory-effecient application of the Snake game allows it to be accessible for gamers without the need for extensive hardware or a high-performance computer. Our team, VUA30, will be creating a desktop application for the well-known “Snake†game with new enhancements and features. This competitive and addictive game can allow the user to play at their own pace and challenge their own high score.
+
+Buying a computing device with high storage and faster performance can be out of budget. Complicated software covers up all the storage and the user is bound to use these applications as opposed to downloading other software. The importance of the redevelopment of “The Snake†is to save computing device’s personal storage and allow the user to play a game 24/7 with strong performance, even offline. Creating a desktop version of the snake game can fit into the category of downloadable calssical games such as the solitaire suite. The recreation of this game will allow the user to enjoy the classical game anytime and anywhere as long as they have installed the application. Improving aspects such as graphics and custom speed will also make the game more interesting. We would like to add more features to the game to make it more customizable and help people enjoy the classical game in an exciting and new way.
+
\subsection{The Stakeholders}
+Stakeholders involved will be contained within the gaming community, more specifically the desktop gaming community and casual PC owners who are
+looking for a fun reliever for boredom or quick game to play.
+
\subsubsection{The Client}
+Since this game is a separate entity, the clients are the designers in this project team. In further developments and upon increase in game popularity, the clients
+could be a desktop gaming distribution service such as steam, google play or apple store. Otherwise, the main client would be Dr. Bokhari who has assigned the project.
+
\subsubsection{The Customers}
+The main users or customers are desktop gamers, older generation of game enthusiasts, and youth, teens. However, the client can be anyone with a PC and an interest in classical gaming or a sudden craving for playing the classical Snake game. Often times, these games are a quick fix to boredom for those who are casually browing their PC's, so the game will be designed to provide enough stimulus and excitmement for regular computer users, similar to the solitaire suite.
+
\subsubsection{Other Stakeholders}
+Aside from the clients and customers, other stakeholder include 3rd party Desktop game distribution stores and open source project banks which may make use of this project for development purposes:
+
+\begin{itemize}
+\item 3rd party Desktop game distribution stores
+\item Game Testers
+\item Technology Experts [Part of Project Team]
+\item Usability experts
+\item Dr. Bokhari
+\item Project Development Experts: This can include teaching assistants, the professor, experienced peers and so on
+\end{itemize}
+
+
\subsection{Mandated Constraints}
+Some constraints that apply to the project include the following:
+
+\begin{itemize}
+\item No project budget provided; Project cannot use costly API memberships or resources
+\item Application should take less than 400MB of storage space to meet requirements
+\item The project must be completed within a 4-month period
+\item Limited resources in terms of domain experts, specifically in graphic design
+\item Application will be developed for one OS due to time constraint
+\item open source project must be translated to Python due to development language and scope
+\end{itemize}
+
\subsection{Naming Conventions and Terminology}
+The naming conventions listed below will be used to clearly define words and termiology that will come up in the project development process. Below is a list
+of naming conventions, terms, and special vocabularly and their meaning. Since the desktop application is straighforward, there is not much terminology being
+used as of now:
+
+\begin{itemize}
+\item DDS: Digital Distribution Service such as play store, microsoft play, etc.
+\item OS: Operating System
+\item Python: The programming language used for application development
+\item Pygame: Computer graphics Python library
+\item Snake 2.o: The desktop application being developed in Python
+\item The interface: The graphics developed using Pygame
+\item The source game: The open source original Python snake game being used for this project
+\end{itemize}
+
\subsection{Relevant Facts and Assumptions}
-User characteristics should go under assumptions.
+Some factors that might affect the outcome of the product are listed as follows:
+\begin{itemize}
+\item Digital Distribution services contribution will be necessary for the public release of the game
+\item Contribution of the development team will affect the outcome of the product
+\item Feedback from game testers
+\item Availability of resources from pygame library to replicate front-end design in HTML,CSS and JS
+\item Time remaining once initial objectives and goals are met. This could affect which additional functionality is added
+\end{itemize}
+
+Some Assumptions that are made pertain to the intended operational environment and anything effecting the product:
+
+\begin{itemize}
+\item Pygame library offers enough functionality to recreate the web app graphics in Python
+\item The user is using Windows for game execution otherwise they must compile the source code to run the application
+\item The application will not be an exact replica of the source game. Added functionality and a change of graphics is expected
+\item The game application will prioritize the completion of the snake game as the central attraction
+\end{itemize}
+
+Some user characteristics will affect the final deisgn and written requirements:
+
+\begin{itemize}
+\item Users expect the game to be responsive and timely due to the nature of wanting quick stimulus
+\item The game should have an attractive user inteface due to the nature of the users expectations. It is mainly used for entertainment and should
+have a smooth user-interface
+\end{itemize}
\section{Functional Requirements}
@@ -111,25 +183,94 @@ issues that should be considered for every engineering project.
\section{Project Issues}
\subsection{Open Issues}
-
+Below is a list of open issues pertaining to the project scope:
+\begin{itemize}
+\item Investigating and understanding the capabilities of the Pygame library is yet to be completed
+\item Integrating additional features is not decided on as of yet. It is dependant on time constraints
+\item snake-game multiplayer mode is an open issue on the open source project which we may or may not choose to implement as time permits
+\end{itemize}
\subsection{Off-the-Shelf Solutions}
+Although there are available solutions on developing such a game, the project team is aiming to enhance the game by producing a desktop version with
+added functionality.
+
+Ready-made simple implementations of the projects are available and can be used as reference but otherwise, enhanced features will have to be created from scratch (light/ dark theme, custom player settings, high scores and so on)
+
\subsection{New Problems}
+\subsubsection{Effects on the Current Environment}
+
+The Microsoft Store contains the "250k snake" app for windows, an implementation of teh old-school snake game. Aside from this application, other applications that appear when searching "snake" or "snake game" do not reflect the classical snake game. By developing the snake game as a desktop app, we will be able to provide game shoppers with more options to pick from.
+
+\subsubsection{Effects on the Installed Systems}
+
+The existance of the 250k snake will make it difficult to push the project team's implementation of the game, Snake 2.o, into the microsoft store market successfully. However, the new snake game will fill a niche for cutsomizability by allowing users to pick from many different settings.
+
\subsection{Tasks}
+An article on linkedIn by Sumit Jain summarizes the steps involved in the game development process [ ~\cite{devArticle} ]. In his article, he outline 6 maine steps to the game development cycle: Idea \& Story, Conceptualize \& Design, Technical Analysis, Development, Testing, Deployment. Considering the project scope and the redevelopment of the snake game, the main three steps involved in the developement cycle are the following:
+\begin{itemize}
+\item Technical Analysis: Use reverse engineering to understand how the game was originally built and analyze the main modules/ framework used to develop the game.
+\item Development: Using Python and Pygame to develop the source code for the game; Analysis from the previous step will be necessary to break down the developement process.
+\item Testing: Test using unittest in python and principles of white bo and black box testing. In further developments, this would also include intergation testing with the user interface and the collection of modules created for the application.
+\end{itemize}
+
+Project members should expect the development cycle to resemble the previously mentioned framework. Once the cycle has been iterated until completion of Snake 2.o, the team will move on to the deployment stage, considering options for making the game available on a DDS such as the Microsoft Store.
+
\subsection{Migration to the New Product}
+Snake 2.o will be require the following conversion tasks:
+\begin{itemize}
+\item Converting JS,HTML and CSS graphics and animations to Pygame graphics
+\item Comverting the source project into modularized step-based tasks
+\item Converting from JS,HTML and CSS source code to Python source code
+\end{itemize}
+
+The source project will be run with Snake 2.o for performance comparison and visual feedback on the accuracy of the redevelopment as well as the enhance features that were added to snake 2.o.
+
\subsection{Risks}
+Snake 2.o will be a classical desktop application and therefore does not present many risks to the user or any stakeholders involved. In terms of taking risk to advance the project, there is risk in striving for the completion of a multiplayer mode for the game since it may take substantial time and effort. However, this risk is low since the project requirements have already been met and other features of the game have been enhanced, aside from the addition of a multiplayer mode.
+
+In the case that more risks are perceived in the future, the project team will take the following course of action to come up with early warnings:
+\begin{itemize}
+\item If the development is taking place 1 week prior to the project deadline, an early warning will be issued and the group must decide to continue or dismiss the development.
+\item If the development is currently taking place with 2 weeks left until the project deadline and less than 50\% of the development is in place, it will be dismissed.
+\item If the main project is missing any component (testing, code modularization, documentation, commenting, etc.) no development will proceed until the main requirements (minimum requirements) are met.
+\item If any of the main project components are deemed to have lower quality, a warning is issued and the team members must discuss wether to continue with further development or improving the existing product.
+\end{itemize}
+
\subsection{Costs}
+As mentioned in the development plan document, team members will be dedicating 2 hours outside of lab time for team meetings and discussions along with 5 hours of individual work on the project itself. Since the project is open source and uses open libraries such as Pygame, the monetary cost is \$0. However, there may be additional costs to publishing Snake 2.o with a DDS.
\subsection{User Documentation and Training}
+The user will be provided with the following documentation and training:
+\begin{itemize}
+\item Snake 2.o User Manual: The document will explain the basic permisses of the game, user settings, graphic themes, menu headings, and any other information necessary for the user to understand the features of the game.
+\item Snake 2.o Installation Manual: Provided that the user will not be using Windows or the native OS that is decided on, this document will provide simple installation instructions for compiling the code on different OS's.
+\end{itemize}
+
\subsection{Waiting Room}
+In future releases of the project, the following requirements might be included in the revised requirements document:
+\begin{itemize}
+\item Snake 2.o User Manual - Multiplayer Mode: A section explaining how to connect and play the snake game with friends
+\item additional 'multiplayer mode' module: A separate module to encapsulate the multiplayer mode
+\item additional 'themes' module - a module encapsulating the different graphic themes available for the game
+\end{itemize}
+
\subsection{Ideas for Solutions}
+Some rudimentary ideas for project modules and solutions have been mentioned down below:
+\begin{itemize}
+\item Classes/modules for individual objects like the snake, food block, the frame, the menu bar, the settings bar and so on.
+\item import graphics developed in adobe illustrator into the game as characters, props and so on.
+\item the snake class can have method that correspond to the snakes functionality such as moveLeft, moveRight, moveUp, moveDown, and Lengthen.
+\item the food item can have a randomPlacement method for when being placed at random around the window.
+\item UI: a custom header section can contain the entry fields for custom speed and other important parameters.
+\end{itemize}
+
\bibliographystyle{plainnat}
\bibliography{SRS}