- Add Survey app specification - Update the specification template to include a 'Project Board' section defining the link to the projects Kanban board, currently Trello. Resolves: N/a See also: N/apull/22/head
jdmedlock
7 years ago
parent
b9f5de7166
commit
4d5cf6d0db
@ -0,0 +1,91 @@
|
||||
# Survey
|
||||
|
||||
**Tier:** 3-Advanced
|
||||
|
||||
Surveys are a valuable part of any developers toolbox. They are useful for
|
||||
getting feedback from your users on a variety of topics including application
|
||||
satisfaction, requirements, upcoming needs, issues, priorities, and just plain
|
||||
aggravations to name a few.
|
||||
|
||||
The Survey app gives you the opportunity to learn by developing a full-featured
|
||||
app that will you can add to your toolbox. It provides the ability to define a
|
||||
survey, allow users to respond within a predefined timeframe, and tablulate
|
||||
and present results.
|
||||
|
||||
Users of this app are divided into two distinct roles, each having different
|
||||
requirements:
|
||||
|
||||
- _Survey Coordinators_ define and conduct surveys. This is an administrative
|
||||
function not available to normal users.
|
||||
- _Survey Respondents_ Complete surveys and view results. They have no
|
||||
administrative privileges within the app.
|
||||
|
||||
Commercial survey tools include distribution functionality that mass emails
|
||||
surveys to Survey Respondents. For simplicity, this app assumes that surveys
|
||||
open for responses will be accessed from the app's web page.
|
||||
|
||||
## User Stories
|
||||
|
||||
### General
|
||||
- [ ] Survey Coordinators and Survey Respondents can define, conduct, and
|
||||
view surveys and survey results from a common website
|
||||
- [ ] Survey Coordinators can login to the app to access administrative
|
||||
functions, like defining a survey.
|
||||
### Defining a Survey
|
||||
- [ ] Survey Coordinator can define a survey containing 1-10 multiple choice
|
||||
questions.
|
||||
- [ ] Survey Coordinator can define 1-5 mutually exclusive selections to each
|
||||
question.
|
||||
- [ ] Survey Coordinator can enter a title for the survey.
|
||||
- [ ] Survey Coordinator can click a 'Cancel' button to return to the home
|
||||
page without saving the survey.
|
||||
- [ ] Survey Coordinator can click a 'Save' button save a survey.
|
||||
### Conducting a Survey
|
||||
- [ ] Survey Coordinator can open a survey by selecting a survey from a
|
||||
list of previously defined surveys
|
||||
- [ ] Survey Coordinators can close a survey by selecting it from a list of
|
||||
open surveys
|
||||
- [ ] Survey Respondent can complete a survey by selecting it from a list of
|
||||
open surveys
|
||||
- [ ] Survey Respondent can select responses to survey questions by clicking
|
||||
on a checkbox
|
||||
- [ ] Survey Respondents can see that a previously selected response will
|
||||
automatically be unchecked if a different response is clicked.
|
||||
- [ ] Survey Respondents can click a 'Cancel' button to return to the home
|
||||
page without submitting the survey.
|
||||
- [ ] Survey Respondents can click a 'Submit' button submit their responses
|
||||
to the survey.
|
||||
- [ ] Survey Respondents can see an error message if 'Submit' is clicked,
|
||||
but not all questions have been responded to.
|
||||
### Viewing Survey Results
|
||||
- [ ] Survey Coordinators and Survay Respondents can select the survey to
|
||||
display from a list of closed surveys
|
||||
- [ ] Survey Coordinators and Survey Respondents can view survey results as
|
||||
in tabular format showing the number of responses for each of the possible
|
||||
selections to the questions.
|
||||
|
||||
## Bonus features
|
||||
|
||||
- [ ] Survey Respondents can create a unique account in the app
|
||||
- [ ] Survey Respondents can login to the app
|
||||
- [ ] Survey Respondents cannot complete the same survey more than once
|
||||
- [ ] Survey Coordinators and Survey Respondents can view graphical
|
||||
representations of survey results (e.g. pie, bar, column, etc. charts)
|
||||
|
||||
## Project Board
|
||||
|
||||
You can track your progress by cloning this [TBD](url-goes-here)
|
||||
|
||||
## Useful links and resources
|
||||
|
||||
Libraries for building surveys:
|
||||
- [SurveyJS](https://surveyjs.io/Overview/Library/)
|
||||
|
||||
Some commercial survey services include:
|
||||
- [Survey Monkey](https://www.surveymonkey.com/)
|
||||
- [Traversy]()
|
||||
- [Typeform](https://www.typeform.com/)
|
||||
|
||||
## Example projects
|
||||
|
||||
[Javascript Questionnaire](https://codepen.io/amyfu/pen/oLChg)
|
||||
Loading…
Reference in new issue