Requirements - 404GNF/International-Agents-Portal GitHub Wiki
Brochure - an informative document containing pictures and information about HZ University
HZ Marketing worker - someone who has the rights to manage the information on the website
International agent - someone who has the rights to distribute information about HZ University
User of the website - everyone who visits the website
Personal story - interview with a student at HZ University of Applied Science
1. As an international agent*, I want to download a brochure* from the web page, so that I can show it to prospective students for HZ University.
GIVEN: The international agent is on the content page
WHEN: The international agent clicks the download button
THEN: The international agent downloads the content he wants to his computer
WHEN: There is an error in downloading
THEN: New window is shown that says what is wrong
2. As an HZ Marketing Developer/Administrator*, I want to change information in the brochures*, so that I can edit the content on the web page.
GIVEN: The HZ Marketing Developer/Administrator is on the resources page in Voyager
WHEN: The HZ Marketing Developer/Administrator clicks the edit button
THEN: The HZ Marketing Developer/Administrator can edit the content I want to modify
WHEN: The changes are not saved
THEN: The old information is shown on the content page
3. As an HZ Marketing Developer/Administrator*, I want to upload brochures* with a specific format, size and resolution on the web page, so that I can show new information about the university.
GIVEN: The HZ Marketing worker is on the content page
WHEN: The HZ Marketing worker clicks the upload button
THEN: The HZ Marketing worker uploads new content on the content page
WHEN: The brochures uploaded do not have the right format, size or resolution
THEN: The content page informs the HZ Marketing Developer/Administrator
WHEN: There is an unknown error when uploading
THEN: The content page sends an error message
4. As a user of the website*, I want to change the language from English to Dutch(or the other way around), so that to understand the information on the website
GIVEN: I am on the website
WHEN: I click on the flag icon that shows the language that I want
THEN: The information is translated to this language (by specific translation software)
WHEN: The information is not translated
THEN: New window shows that says it is not possible to change to this language
5. As an international agent*, I want to log in as an international agent, so that I have special rights to download brochures*. (irrelevant)
GIVEN: The international agent is on the log in page
WHEN: The international agent fills his/her email and password
THEN: The international agent logged in as an international agent
WHEN: There is an error in the logging in
THEN: A message with the error is shown
6. As a user of the website*, I want the website to have the color scheme of other HZ websites, so that the website is part of the HZ ecosystem.
GIVEN: The user of the website is on the website
WHEN: The user of the website clicks on an orange button
THEN: The user of the website is redirected or a file is downloaded
WHEN: There is incorrect use of the color scheme of the website
THEN: The user is confused and his/her actions leads to unexpected results
7. As an HZ Marketing worker*, I want some instruction on how to deploy the website, so that I can deploy the project.
GIVEN: The HZ Marketing worker has access to a web-server
WHEN: The HZ Marketing worker follows the instructions
THEN: The International Agent Portal is deployed and usable
WHEN: The HZ Marketing worker does not follow the instructions
THEN: The International Agent Portal does not work
8. As a user of the website*, I want the website to be responsive, so that I can use it on all my devices.
GIVEN: The user of the website loads a page
WHEN: The user of the website uses a computer
THEN: The user of the website can read and access every element of the website
WHEN: The user of the website uses a smartphone
THEN: The user of the website can read and access every element of the website
WHEN: The user of the website uses a tablet
THEN: The user of the website can read and access every element of the website
9. As an International Agent*, I want to be able to download brochures and other files from the website, so that I can get information if a student in a foreign country wants to join HZ.
GIVEN: The International Agent is on the website
WHEN: The International Agent downloads a brochure or other file
THEN: The file is retrieved from the database and sent to the user
WHEN: The file is not found
THEN: There is an error message saying file not found
10. As an International Agent*, I want the social media, Blog and YouTube video* links to HZ accounts be linked in the website, so that the Agent can visit the page and inform prospective students about them.
GIVEN: The International Agent is on the home page of the website
WHEN: The International Agent search for a social media icon
THEN: The International Agent can be redirected fast and easily
WHEN: There is an error in the redirection of the website to the HZ website
THEN: An error message is shown
11. As an International Agent*, I want to be able to predict where information is on the website, so that I can find it easily.
GIVEN: The International Agent is on the home page
WHEN: The International Agent wants to go to a page with specific information
THEN: The International Agent is able to predict where this information is based on the names of the links in the navbar
WHEN: There is confusion in the naming of the categories in the navbar
THEN: The International Agent cannot find easily the information that he/she wants
12. As an International Agent* or as an HZ Marketing Developer/Administrator*, I want to be able to search and filter among the amazing posters the website can offer, so that I can find more relevant posters to my case/liking.
GIVEN: The person is looking at all the items
WHEN: The person has an idea in mind of what actually he/she is looking for
THEN: The person can easily use the search and filter functions above the ‘gallery’ of items
WHEN: There is not search and filter functions
THEN: The person cannot find quickly the information that is relevant in his/her case
13. As an HZ Marketing Developer/Administrator*, I want the upload system save metadata on uploaded documents, so that I can know when a document was uploaded and by which administrator.
GIVEN: The HZ Marketing Developer/Administrator is on the content page
WHEN: The HZ Marketing Developer/Administrator clicks the upload button
THEN: The document, a date and the administrator information are saved in the database
WHEN: There is an error in uploading
THEN: New window is shown that says what is wrong
14. As an International Agent*, I want the portal to have a regularly updating news section about the promotion related events and webinars, so that we can login and be aware of them and can inform and encourage the prospective students to attend. (irrelevant)
GIVEN: The International Agent is on the welcome page of the website
WHEN: The International Agent clicks on the news section
THEN: The International Agent can see all news which is up to date
WHEN: The International Agent can see only out of date news
THEN: The International Agent sends report about no updating the news section
15. As an HZ marketing worker*, I want to be able to easily update the site's data, so the content of posters, contact information and study information keeps being relevant.
GIVEN: The HZ Marketing worker is on the admin panel
WHEN: Certain information becomes outdated and has to be updated onsite
THEN: The HZ Marketing worker has an input field to add files and text-boxes, which can later be saved
WHEN: The files are too large and not compatible
THEN: An error message shows up, explaining that the file is not supported or too big, dependent on the situation
16. As an HZ marketing worker*, I want to be able easily upload personal stories* to the home page, so that I can show interviews with students at HZ University of Applied Sciences.
GIVEN: The HZ marketing worker is on the webpage about adding new personal stories in Voyager
WHEN: The HZ marketing worker fills all necessary fields and clicks on the save button
THEN: The personal story is added to the home page of the website
WHEN: One or more of the fields have invalid data
THEN: An error message is shown describing what is wrong