Brontekst bekijken van Requirements Engineering/het werk/werkstuk/2013-14/Groep 12

= Introduction =
Nijmegen is een studentenstad met vele studentenverenigingen. Mercurius is hier een van, de vereniging bestaat tegenwoordig uit meer dan 500 leden en de dagelijkse stand van zaken wordt door 7 vrijwilligers geregeld. Studentenvereniging Mercurius houdt zich in Nijmegen veel bezig met het uitgaansleven. Mercurius werd opgericht rond 123 voor Christus. In deze tijd hielden de leden van Mercurius zich, in tegenstelling tot het normale volk, vooral bezig met eten en elkaar converseren. Tegenwoordig houdt Mercurius zich vooral bezig met activiteiten organiseren voor medestudenten en de daarbij bijkomstige zaken.

Mercurius wil vanwege een sterk stijgende populariteit een systeem ontwikkelen in de vorm van een app waarbij studenten en andere bezoekers van de stad Nijmegen makkelijker hun weg kunnen vinden in de stad. Hierbij is het belangrijk dat het makkelijk vinden van uitgaansgelegenheden centraal staat. Daarbij moeten zij eenvoudig kunnen zien welke uitgaansgelegenheden populair zijn, goed beoordeeld worden, waar evenementen plaatsvinden en wat bijvoorbeeld de prijs van bier is in een bepaalde kroeg.

Dit document is volgens de methode van Kulak & Guiney gestructureerd om een goed leesbare en duidelijke beschrijving van de requirements aan de app op te leveren. Als eerst wordt de aanleiding om het systeem te ontwikkelen beschreven in "Problem statement". Vervolgens documenteren wij de belanghebbenden bij ons systeem door middel van een "Stakeholder analysis". Om duidelijkheid te creëeren over wat nou eigenlijk de bedoeling is van het product hebben we een "Mission and vission statement" opgesteld. De voortgang van ons project wordt bijgehouden in "Statement of work" en de risico's die bij het project komen kijken worden gedocumenteerd in "Risk analysis". Bij "Requirements" worden uiteindelijk de echte requirements beschreven door middel van "Use cases" en om dit overzichtelijk te maken, maken wij een "Intergrated use case diagram". Per use case wordt er een "Domain Model" gemaakt om de context van de use case en het geheel te verduidelijken. Om concrete voorbeelden te geven voor de lezer stellen we per use case ook een mogelijk scenario op om te laten zien hoe de app in praktijk werkt. Uiteindelijk beschrijven we in "Non-functional requuirements" de meest onderliggende functionaliteit van het systeem zoals privacy, veiligheid en beschikbaarheid.

== Problem statement ==
Momenteel is het voor veel bezoekers van uitgaansavonden in Nijmegen een probleem om uit te vinden waar zij het beste uit kunnen gaan of waar leuke evenementen plaats vinden. Ook bieden diensten zoals Google Maps en Facebook niet genoeg functionaliteit om de precieze locatie te vinden van uitgaansgelegenheden. Een bijkomend voordeel van de app is dat het voor uitgaansgelegenheden makkelijker is om hun locatie te promoten door middel van acties, die ook in de app weergeven worden.

= Case analysis =
== Stakeholder analysis ==
{| class="wikitable" border="0" width="100%"
! Stakeholder !! Rol !! Omschrijving
|-
|Voorzitter van studievereniging Mercurius, Quoc An Ha
|Beheerder
|Beheert de kroegen in de app, en neemt administratieve taken op zich.
|-
|Student in Nijmegen, Anna Bool
|Gebruikers
|De daadwerkelijk doelgroep van de app, de meest actieve gebruikers.
|-
|Eigenaar van uitgaansgelegenheid in Nijmegen, Gerda Grutjes
|Belanghebbende
|Hebben baat bij de app, worden onder de aandacht gebracht door de app.
|}

== Mission and vision statement ==
* Mission - Onze missie is om een app te creëren die studenten de mogelijkheid biedt om een inzicht te krijgen in het uitgaansleven van Nijmegen.
* Vision - Onze visie is dat er een app wordt gemaakt voor Mercurius die er voor zorgt dat studenten een beter inzicht krijgen over de uitgaansfaciliteiten in de stad Nijmegen. Zo kunnen zij snel zien hoe bepaalde kroegen gewaardeerd worden, wanneer er evenementen zijn en een kaart met de dichtstbijzijnde uitgaansgelegenheden. Ook moet er de mogelijkheid zijn om recensies te schrijven. Gebruikers moeten ook de mogelijkheid hebben om bepaalde recensies als ongepast aan te geven, zodat de beheerders deze kunnen verwijderen als ze daadwerkelijk ongepast zijn. En kroegeigenaren moeten de specificaties kunnen aanpassen middels een inlogfunctie met inloggegevens die zij van Mercurius hebben ontvangen.

== Statement of work ==
<b>Legenda</b><br />
{{mark|''' Voltooid '''|green}}<br />
{{mark|''' Mee bezig '''|yellow}}<br />
{{mark|''' Niet voltooid '''|red}}<br />
{{mark|''' N.v.t. '''|grey}}

{| class="wikitable" border="1"
! Deliverable !! Façade (XX-03-2014) !! Status !! Filled (13-03-2014) !! Status !! Focused (04-04-2014) !! Status !! Responsible members
|-
| Introduction || Voorlopige versie || {{mark|'''Voltooid'''|green}} || Voorlopige versie || {{mark|''' Voltooid '''|green}} || Compleet || {{mark|'''Voltooid'''|green}} || Stan Derksen, Bart van den Boom
|-
| Problem statement || Zo gedetailleerd mogelijk|| {{mark|'''Voltooid'''|green}} || Zo gedetailleerd mogelijk || {{mark|'''Voltooid'''|green}} || Compleet || {{mark|'''Voltooid'''|green}}|| Stan Derksen, Bart van den Boom, Jim Driessen, Maarten Carsjens, Laurens Brinker
|- 
| Stakeholder list/analysis || Zo goed mogelijk || {{mark|''' Voltooid '''|green}} || Zo goed mogelijk || {{mark|'''Voltooid'''|green}} || Compleet || {{mark|'''Voltooid'''|green}} || Stan Derksen, Bart vd Boom
|-
| Mission-Vision(-Values) || Mee bezig || {{mark|''' Mee bezig '''|yellow}} || Mee bezig || {{mark|'''Mee bezig'''|yellow}} || Compleet || {{mark|'''Voltooid'''|green}} ||  Laurens Brinker, Jim Driessen
|-
| Statement of Work || Compleet en up-to-date || {{mark|''' Voltooid '''|green}} || Compleet en up-to-date || {{mark|'''Voltooid'''|green}} || Compleet en up-to-date || {{mark|'''Voltooid'''|green}} || Laurens Brinker, Maarten Carsjens, Jim Driessen
|-
| Risk Analysis || Compleet en up-to-date || {{mark|''' Voltooid '''|green}} || Compleet en up-to-date || {{mark|'''Voltooid'''|green}} || Compleet en up-to-date || {{mark|'''Voltooid'''|green}} || Jim Driessen, Stan Derksen
|-
| Use Case Survey || Compleet || {{mark|'''Voltooid'''|green}}  || Compleet || {{mark|'''Voltooid'''|green}}  || Compleet || {{mark|'''Voltooid'''|green}} || Stan Derksen, Maarten Carsjens, Jim Driessen
|-
| Integrated UC Diagram || Compleet || {{mark|''' Voltooid '''|green}} || Compleet || {{mark|'''Voltooid'''|green}} || Compleet || {{mark|'''Voltooid'''|green}} || Stan Derksen
|-
| Use Cases || Mee bezig || {{mark|''' Mee bezig'''|yellow}} || "Filled" niveau || {{mark|'''Mee bezig'''|yellow}} || Compleet || {{mark|'''Voltooid'''|green}} || Laurens Brinker, Stan Derksen
|-
| Scenarios || Nog niet || {{mark|''' N.v.t. '''|grey}} ||  Mee bezig || {{mark|''' Mee bezig '''|yellow}} || Compleet || {{mark|'''Voltooid'''|green}} || Stan Derksen, Laurens Brinker, Bart vd Boom
|-
| Domain Models || Nog niet || {{mark|''' N.v.t. '''|grey}} ||  Mee bezig || {{mark|''' Mee bezig '''|yellow}} || Compleet || {{mark|'''Voltooid'''|green}} || Maarten Carsjens, Stan Derksen.
|-
| Business rules per UC || Nog niet || {{mark|''' N.v.t. '''|grey}} ||  Mee bezig || {{mark|''' Mee bezig '''|yellow}} || Compleet || {{mark|'''Voltooid'''|green}} || Laurens Brinker, Stan Derksen
|-
| Integrated Domain Model || Nog niet || {{mark|''' N.v.t. '''|grey}} ||  Mee bezig || {{mark|''' Mee bezig '''|yellow}}  || Compleet || {{mark|'''Voltooid'''|green}} || Laurens Brinker, Stan Derksen
|-
| Business Rules Catalogue || Nog niet || {{mark|''' N.v.t. '''|grey}} || Mee bezig || {{mark|''' Mee bezig '''|yellow}}  || Compleet || {{mark|'''Voltooid'''|green}} || Stan Derksen.
|-
| Non-functional Requirements ||  Mee bezig || {{mark|''' Mee bezig '''|yellow}}  || Mee bezig || {{mark|''' Mee bezig '''|yellow}} || Compleet || {{mark|'''Voltooid'''|green}} || Laurens Brinker, Stan Derksen
|-
| Terminological Definitions ||  Mee bezig || {{mark|''' Mee bezig '''|yellow}} ||  Mee bezig || {{mark|''' Mee bezig '''|yellow}}  || Compleet || {{mark|'''Voltooid'''|green}} || Stan Derksen
|-
|}

== Risk analysis ==
{|class="wikitable"
! # !! Category !! Risk !! Solution needed by !! Status !! Days lost !! Expectancy factor !! Risk factor
|-
| 01 || Persoonlijk || Ziekte || Meteen || Closed || 3 || 20% || 4
|-
| 02 || Persoonlijk || Familieproblemen || Meteen || Closed || 4 || 5% || 3
|-
| 03 || Communicatie || Communicatieprobleem tussen projectleden en stakeholders || Meteen || Closed || 4 || 40% || 6
|-
| 04 || Communicatie || Communicatieprobleem tussen projectleden onderling || Meteen || Closed || 4 || 70% || 7
|}

= Requirements =
== Use cases ==

=== Use case survey ===
{|class="wikitable"
! # !! Name !! Description !! Initiating actor
|-
| 01 || Kroegspecificaties bekijken || Een kroeg bekijken met diens specificaties. || Gebruiker (student)
|-
| 02 || Evenement bekijken || Een evenement uit een lijst met evenementen bekijken. || Gebruiker (student)
|-
| 03 || Review schrijven/aanpassen of markeren || Een review schrijven, je eigen review aanpassen of een andere review aangeven als ongepast. || Gebruiker (student)
|-
| 04 || Informatie aanpassen || Specificaties aanpassen van eigen onderneming. || Uitgaansgelegenheid (kroegbaas)  
|-
| 05 || Inhoud van database veranderen ||  Een ongepaste review verwijderen of een kroeg toevoegen/verwijderen.  || Beheerder (Mercurius)
|}

=== Integrated use case diagram ===
[[Bestand:RE-UCD2.png]]

==Kroegspecificaties bekijken==

{|class="wikitable"
! Use Case: !! Kroegspecificaties bekijken
|-
| Beschrijving
| De gebruiker krijg een lijst met de specificaties van een kroeg te zien.
|-
| Actoren
| App-gebruiker
|-
| Versie 
| 1.1
|-
| Basic course of events 
|
'''Kroegspecificaties bekijken'''<br>
1. De gebruiker heeft aangegeven een lijst met kroegen te willen zien (trigger). <br>
2. Het systeem laat de lijst van kroegen zien met <u>globale informatie</u>. <br>
3. De gebruiker geeft aan een bepaalde kroeg/horeca aangelegenheid te willen zien.<br>
4. Het systeem laat in een nieuw scherm van de desbetreffende kroeg/horeca aangelegenheid de <u>specificaties</u> zien.<br>
|-
| Alternate paths 
|
'''kroegspecificaties bekijken via kaart'''<br>
1. De gebruiker heeft aangegeven een kaart met kroegen te willen zien (trigger). <br>
2. Het systeem laat een kaart met kroegen zien met <u>globale informatie</u>. <br> 
: - De use case gaat verder bij 3. <br>
<br>
'''Gesorteerde lijst met kroegen bekijken'''<br>
3. De gebruiker geeft sorteercriteria aan (top-rated, nieuw, etc) <br>
: - De use case gaat verder bij 2.<br>
|-
| Exception paths
| 
-
|-
| Preconditions 
| De app is geopend, er is een internetverbinding en er is een GPS verbinding.
|-
| Postconditions 
| De gebruiker heeft een kroeg kunnen bekijken, of is voortijdig terug gegaan naar het hoofdmenu / terug naar de lijst.
|-
| Related business rules
| De browse en GPS gegevens van de gebruiker blijven privé.
|-
| Domain Model
| 
[[Bestand:UC1_ORM_Schema_RequirementsEngineering_Groepje12_2014.png‎]]
|}

==Evenement bekijken==

{|class="wikitable"
! Use Case: !! Evenement bekijken
|-
| Beschrijving
| De gebruiker krijg de informatie van een bepaald evenement te zien
|-
| Actoren
|
App-gebruiker<br>
|-
| Versie 
| 1.1
|-
| Basic course of events 
|
'''Evenement bekijken'''<br>
1. De gebruiker heeft aangegeven een lijst met evenementen te willen zien. (trigger). <br>
2. Het systeem laat de lijst van evenementen zien gesorteerd op datum.<br>
3. De gebruiker geeft aan een bepaalde dag te willen zien.<br>
4. Het systeem laat de evenementen van die dag zien.<br>
5. De gebruiker geeft aan een individueel evenement te willen zien.<br>
6. Het systeem laat de aanwezige <u>evenementinfo</u> over het desbetreffende evenement zien. <br>
|-
| Alternate paths 
|
'''Evenement bekijken d.m.v. zoekfunctie'''<br>
2. De gebruiker geeft aan te willen zoeken op naam.<br>
3. Het systeem laat een zoekbalk zien<br>
4. De gebruiker typt in de zoekbalk(een gedeelte) van de naam.<br>
5. Het systeem laat een lijst van evenementen die matchen zien. <br>
: - De use case gaat verder bij 5.<br>
|-
| Exception paths
|
'''Evenement bekijken'''<br>
4. Het systeem geeft aan dat de lijst van evenementen leeg is. <br>
: - De use case gaat verder bij 2. <br><br>

'''Evenement bekijken d.m.v. zoekfunctie'''<br>
5. Er zijn geen matches<br>
: - De use case gaat verder bij 3. <br>
|-
| Preconditions 
| De gebruiker heeft verbinding met het internet.
|-
| Postconditions 
| Het systeem laat een evenement met <u>evenementinfo</u> zien.
|-
| Related business rules
| De browsegegevens van de gebruiker blijven privé.
|-
| Domain Model
|
[[Bestand:UC2_ORM_Schema_RequirementsEngineering_Groepje12_2014.png‎ ]]
|}

==Review schrijven, aanpassen of markeren==

{|class="wikitable"
! Use Case: !! Review schrijven, aanpassen of markeren
|-
| Beschrijving
| De gebruiker kan een review over een uitgaansgelegenheid schrijven, een eigen review aanpassen of een andere review als ongepast markeren.
|-
| Actoren
|
App-gebruiker<br>
|-
| Versie
| 1.1
|-
| Basic course of events 
|
'''Een review schrijven'''<br>
1. De gebruiker heeft bij kroegspecificaties aangegeven dat hij de reviews wil bekijken (trigger).<br>
2. Het systeem laat een overzicht van de reviews van de desbetreffende kroeg zien.<br>
3. De gebruiker geeft aan een review te willen schrijven.<br>
4. Het systeem toont een formulier waarin de gebruiker een review kan schrijven.<br>
5. De gebruiker geeft aan het formulier te willen opslaan.<br>
6. Het systeem toont het overzicht van geschreven reviews van de desbetreffende kroeg.<br>
|-
| Alternate paths 
|
'''Een eigen review aanpassen'''<br>
3. De gebruiker geeft aan een eigen review te willen aanpassen.<br>
4. Het systeem toont een formulier met de inhoud van de huidige review al ingevuld.<br>
: - De use case gaat verder bij 5.<br>
<br>
'''Een review als ongepast markeren'''<br>
3. De gebruiker geeft aan dat een review ongepast is.<br>
4. Het systeem laat zien dat de kroeg als ongepast is gemarkeerd.<br>
<br>
|-
| Exception paths
|
'''Een review schrijven'''<br>
5. De gebruiker geeft aan een leeg formulier te willen opslaan.<br>
: - De use case gaat verder bij 4.
|-
| Preconditions 
|
Het toestel waarop de gebruiker de app gebruikt heeft een internetverbinding.<br>
|-
| Postconditions 
|
De gebruiker heeft een review geschreven over een bepaalde kroeg. <br>
De gebruiker heeft een eigen review aangepast. <br>
De gebruiker heeft een review als ongepast gemarkeerd. <br>
|-
| Related business rules
|
de gegevens/acties van de gebruiker blijven privé.
|-
| Domain Model
| 
[[Bestand:UC3_ORM_Schema_RequirementsEngineering_Groepje12_2014.png]]
|}

==Informatie aanpassen==

{|class="wikitable"
! Use Case: !! Informatie aanpassen
|-
| Beschrijving
| 
Een kroegeigenaar past de kroegspecificaties van zijn/haar onderneming aan. Of maakt/verandert/verwijdert een evenement.
|-
| Actoren
|
Uitgaansgelegenheid<br>
|-
| Versie
| 1.1
|-
| Basic course of events 
|
'''Kroegspecificaties aanpassen'''<br>
1. De kroegeigenaar geeft aan in te willen loggen (trigger).<br>
2. Het systeem vraagt om een inlognaam en daarbij behorende wachtwoord. <br>
3. De kroegeigenaar vult zijn/haar inlognaam en wachtwoord in. <br>
4. Het systeem toont dat de kroegeigenaar succesvol is ingelogd. <br>
5. De kroegeigenaar geeft de kroegspecificaties van zijn/haar onderneming te willen aanpassen. <br>
6. Het systeem toont een scherm met een formulier met de huidige specificaties die de kroegeigenaar kan veranderen. <br>
7. De kroegeigenaar geeft aan het formulier op te slaan.
|-
| Alternate paths 
|
'''Evenement toevoegen'''<br>
5. De kroegeigenaar geeft aan een evenement toe te willen voegen. <br>
6. Het systeem geeft een formulier waar <u>evenementinformatie</u> moet worden ingevuld. <br>
: - De use case gaat verder bij 7.

'''Evenement wijzigen'''<br>
5. De kroegeigenaar geeft aan een evenement te willen wijzigen.<br>
6. Het systeem geeft het formulier met de eerder ingevulde <u>evenementinformatie</u>.<br>
: - De use case gaat verder bij 7.

'''Evenement verwijderen''' <br>
5. De kroegeigenaar geeft aan een door zijn/haar opgezet evenement te willen verwijderen.<br>
6. Het systeem geeft een lijst met de door zijn/haar opgezette evenementen. <br>
7. De kroegeigenaar selecteerd een evenement om te verwijderen. <br>
6. Het systeem vraagt om een bevestiging.<br>
: - De use case gaat verder bij  7. van ''Kroegspecificaties aanpassen'''

|-
| Exception paths
|
'''Verkeerd(e) inloggegeven(s).'''<br>
3. De kroegeigenaar vult een verkeerde inlognaam, of een verkeerd bijbehorend wachtwoord in.<br>
: - De use case gaat verder bij 2.
<br>

'''Drie keer foutief''' <br>
3. De kroegeigenaar vult voor de derde keer op rij een verkeerd inloggegeven in.<br>
4. Het systeem toont dat de kroegeigenaar contact moet opnemen met Mercurius voor nieuwe inloggegevens.<br>
<br>

'''Leeg formulier opslaan''' <br>
7. De kroegeigenaar geeft aan een leeg formulier op te willen slaan.<br>
: - De use case gaat verder bij 6.
|-
| Preconditions 
|
Het toestel waarop de kroegeigenaar de app gebruikt heeft een internetverbinding.<br>
De kroegeigenaar heeft inloggegevens ontvangen van Mercurius. <br>
|-
| Postconditions 
|
De kroegspecificaties van de onderneming behorend tot een kroegeigenaar zijn veranderd. <br>
|-
| Related business rules
|
De inloggegevens van de kroegbaas blijven privé.
|-
| Domain Model
|
[[Bestand:UC4 ORM Schema RequirementsEngineering Groepje12 2014.png]]
|}

==Inhoud van database veranderen==

{|class="wikitable"
! Use Case: !! Inhoud van database veranderen
|-
| Beschrijving
| De inhoud van de database veranderen, zoals de kroegen aanpassen of verwijderen en ongepaste reviews deleten.
|-
| Actoren
| Studievereniging Mercurius<br>
|-
| Versie
| 1.0
|-
| Basic course of events 
| 
'''Ongepaste review verwijderen'''<br>
1. Mercurius geeft aan de database te willen aanpassen.<br>
2. Het systeem vraagt om een inlognaam en een daarbij behorende wachtwoord.<br>
3. Mercurius vult zijn of haar inlognaam en wachtwoord in.<br>
4. Het systeem geeft aan dat er succesvol is ingelogd en toont een menu.<br>
5. Mercurius geeft aan een review te willen verwijderen.<br>
6. Het systeem toont een lijst met recente (gemarkeerde) reviews.<br>
7. Mercurius geeft aan dat een review verwijderd moet worden.
8. Het systeem toont dat de review succesvol is verwijderd.
|-
| Alternate paths 
| 
'''Verkeerde inlogggegeven(s)'''<br>
3. Mercurius vult een verkeerde inlognaam of wachtwoord in <br>
: - De use case gaat verder bij 2.


'''Kroeg toevoegen'''<br>
5. Mercurius geeft aan een kroeg toe te willen voegen.<br>
6. Het systeem toont een formulier met gegevens voor de kroeg.<br>
7. Mercurius vult het formulier in en slaat deze op.<br>
8. Het systeem toont de toegevoegde kroeg.<br>


'''Kroegspecificaties aanpassen'''<br>
5. Mercurius geeft aan een kroeg aan te willen passen.<br>
6. Het systeem toont een lijst met kroegen.<br>
7. Mercurius kiest de kroeg die hij of zij aan wil passen.<br>
8. Het systeem toont een ingevuld formulier met de gegevens van de gekozen kroeg.<br>
9. Mercurius past de gegevens aan en geeft aan het formulier op te willen slaan.<br>
10. Het systeem toont de aangepaste kroeg.


'''Kroeg verwijderen'''<br>
5. Mercurius geeft aan een kroeg aan te willen passen.<br>
6. Het systeem toont een lijst met kroegen.<br>
7. Mercurius kiest de kroeg die hij of zij aan wil passen.<br>
8. Het systeem toont een ingevuld formulier met de gegevens van de gekozen kroeg.<br>
9. Mercurius geeft aan de kroeg te willen verwijderen <br>


|-
| Exception paths
| 
'''De lijst met reviews is leeg'''<br>
6. Het systeem toont een lege lijst met reviews.<br>
: - De use case gaat verder bij 4.
<br>

'''Kroeg toevoegen/aanpassen'''
7. Het ingevulde formulier is leeg.<br>
: - De use case gaat verder bij 6.
|-
| Preconditions 
|
Het toestel waarop de gebruiker de app gebruikt heeft een internetverbinding.<br>
|-
| Postconditions 
| 
Mercurius heeft een review verwijderd.<br>
Mercurius heeft een kroeg toegevoegd.<br>
Mercurius heeft een kroeg aangepast.<br>
Mercurius heeft een kroeg verwijderd.<br>
|-
| Related business rules
| De inloggegevens van Mercurius zijn privé.
|-
| Domain Model
|
[[Bestand:UC5_ORM_Schema_RequirementsEngineering_Groepje12_2014.png]]
|}

== Scenarios ==

==== Scenario "Kroegspecificaties bekijken"====
===== Basic course of events =====
: '''Kroegspecificaties bekijken'''
# ''Anna Bool'' geeft aan een lijst met kroegen te willen zien.
# Het systeem laat een lijst van kroegen zien met globale informatie.
# ''Anna Bool'' klikt op de kroeg genaamd ''NDRGRND''.
# Het systeem laat de specificaties van ''NDRGRND'' zien.<br><br>

===== Alternate path =====
: '''Kroegspecificaties bekijken via kaart'''
# ''Anna Bool'' geeft aan een kaart met kroegen te willen zien.
# Het systeem laat een kaart met kroegen zien met globale informatie.
# ''Anna Bool'' klikt op de kroeg genaamd ''NDRGRND''.
# Het systeem laat de specificaties van ''NDRGRND'' zien.<br><br>

===== Alternate path =====
: '''Gesorteerde lijst met kroegen bekijken'''
# ''Anna Bool'' geeft aan een lijst met kroegen te willen zien.
# Het systeem laat een lijst van kroegen zien met globale informatie.
# ''Anna Bool'' geeft het zoekcriterum ''top-rated'' aan.
# Het systeem toont een gesorteerde lijst, gebaseerd op het zoekcriterium.
# ''Anna Bool'' klikt op de bovenste kroeg genaamd ''De Drie Gezusters''.
# Het systeem laat de specificaties van ''De Drie Gezusters'' zien.<br><br>

==== Scenario "Evenement bekijken" ==== 
===== Basic Course of Events =====
: '''Evenement bekijken'''
# ''Anna Bool'' geeft aan een lijst met evenementen te willen zien. 
# Het systeem laat de lijst van evenementen zien gesorteerd op datum.
# ''Anna Bool'' geeft aan de evenementen op de datum ''4 juni 2014'' te willen zien.
# Het systeem laat de evenementen van ''4 juni 2014'' zien.
# ''Anna Bool'' geeft aan ''Drink more, get more!'' te willen zien.
# Het systeem laat de aanwezige informatie over ''Drink more, get more!'' zien:.

===== Alternate Path =====
: '''Evenement bekijken d.m.v. zoekfunctie'''
# ''Anna Bool'' geeft aan een lijst met evenementen te willen zien.
# Het systeem laat de lijst van evenementen zien gesorteerd op datum.
# ''Anna Bool'' geeft aan te willen zoeken op naam.
# Het systeem laat een zoekbalk zien.
# ''Anna Bool'' typt "''Drink more, get more!''" in de zoekbalk.
# Het systeem geeft een lijst te zien met: "''Drink more, get more!''".
# ''Anna Bool'' geeft aan "''Drink more, get more!''" te willen zien.
# Het systeem laat de aanwezige informatie over "''Drink more, get more!''" zien.

===== Exception path =====
: '''Evenement bekijken (lege lijst)''' 
# ''Anna Bool'' geeft aan een lijst met evenementen te willen zien.
# Het systeem laat de lijst van evenementen zien gesorteerd op datum.
# ''Anna Bool'' geeft aan de evenementen van ''3 juni 2014'' te willen bekijken
# Het systeem geeft aan dat de lijst van evenementen leeg is.
# Het systeem laat de lijst van evenementen zien gesorteerd op datum.
# ''Anna Bool'' geeft aan de evenementen van ''4 juni 2014'' te willen bekijken
# Het systeem laat de evenementen van "4 juni 2014" zien.
# ''Anna Bool'' geeft aan "Drink more, get more!" te willen zien.
# Het systeem laat de aanwezige informatie over "Drink more,get more!" zien.

===== Exception path =====
: '''Evenement bekijken d.m.v. zoekfunctie (geen matches)'''
# ''Anna Bool'' geeft aan een lijst met evenementen te willen zien.
# Het systeem laat de lijst van evenementen zien gesorteerd op datum.
# ''Anna Bool'' geeft aan te willen zoeken op naam.
# Het systeem laat een zoekbalk zien.
# ''Anna Bool'' typt "DRASDASDASDAS" in de zoekbalk.
# Het systeem geeft aan dat er geen zoekresultaten zijn en geeft opnieuw de zoekbalk.
# ''Anna Bool'' typt "Drink more, get more!" in de zoekbalk.
# Het systeem geeft een lijst te zien met: "Drink more, get more!".
# ''Anna Bool'' geeft aan "Drink more, get more!" te willen zien.
# Het systeem laat de aanwezige informatie over "Drink more, get more!" zien.

====Scenario "Review schrijven, aanpassen of markeren"==== 
=====Basic Course of Events=====
: '''Een review schrijven'''
# <i>Anna Bool</i> heeft bij kroegspecificaties aangegeven dat zij de reviews wil bekijken van kroeg "NDRGRND". 
# Het systeem laat een overzicht van de reviews van "NDRGRND" zien.
# <i>Anna Bool</i> geeft aan een review te willen schrijven.
# Het systeem toont een formulier waarin <i>Anna Bool</i> een review kan schrijven.
# <i>Anna Bool</i> vult het formulier in en geeft aan het formulier op te willen slaan.
# Het systeem toont het overzicht van geschreven reviews van de desbetreffende kroeg.

=====Alternate Path=====
: '''Een eigen review aanpassen'''
# <i>Anna Bool</i> heeft bij kroegspecificaties aangegeven dat zij de reviews wil bekijken van kroeg "NDRGRND".
# Het systeem laat een overzicht van de reviews van "NDRGRND" zien.
# <i>Anna Bool</i> geeft aan een eigen review te willen aanpassen.
# Het systeem toont een formulier met de inhoud van de huidige review al ingevuld. 
# <i>Anna Bool</i> vult het formulier in en geeft aan het formulier op te willen slaan.
# Het systeem toont het overzicht van geschreven reviews van de desbetreffende kroeg.

=====Alternate Path=====
: '''Een review als ongepast markeren'''
# <i>Anna Bool</i> heeft bij kroegspecificaties aangegeven dat zij de reviews wil bekijken van kroeg "NDRGRND".
# Het systeem laat een overzicht van de reviews van "NDRGRND" zien.
# <i>Anna Bool</i> geeft aan dat een review ongepast is. 

===== Exception Path =====
: '''Een review schrijven'''
# <i>Anna Bool</i> heeft bij kroegspecificaties aangegeven dat zij de reviews wil bekijken van kroeg "NDRGRND". 
# Het systeem laat een overzicht van de reviews van "NDRGRND" zien.
# <i>Anna Bool</i> geeft aan een review te willen schrijven.
# Het systeem toont een formulier waarin <i>Anna Bool</i> een review kan schrijven.
# <i>Anna Bool</i> geeft aan een leeg formulier te willen opslaan.
# Het systeem toont een formulier waarin <i>Anna Bool</i> een review kan schrijven. 
# <i>Anna Bool</i> vult het formulier in en geeft aan het formulier op te willen slaan.
# Het systeem toont het overzicht van geschreven reviews van de desbetreffende kroeg.

==== Scenario "Informatie aanpassen" ====
===== Basic Course of Events =====
: '''Kroegspecificaties aanpassen'''
# ''Gerda Grutjes'' geeft aan in te willen loggen.
# Het systeem vraagt om een inlognaam en bijbehorend wachtwoord.
# ''Gerda Grutjes'' vult in bij inlognaam: ''GerdaGrutjes'' en bij wachtwoord: ''QdxOerD!''.
# Het systeem toont dat ''Gerda Grutjes'' succesvol is ingelogd.
# ''Gerda Grutjes'' geeft aan de kroegspecificaties aan te willen passen.
# Het systeem toont de huidige kroegspecificaties
# ''Gerda Grutjes'' verandert ''de prijs van het bier naar €1.00'' en slaat het formulier op.

===== Alternate Path =====
: '''Evenement toevoegen'''<br>
# ''Gerda Grutjes'' geeft aan in te willen loggen.<br>
# Het systeem vraagt om een inlognaam en bijbehorend wachtwoord.<br>
# Harry vult in bij inlognaam: ''GerdaGrutjes'' en bij wachtwoord: ''QdxOerD!''.<br>
# Het systeem geeft aan dat ''Gerda Grutjes'' succesvol is ingelogd.<br>

# ''Gerda Grutjes'' geeft aan een evenement te willen toevoegen.<br>

# Het systeem geeft een formulier waar evenementinformatie moet worden ingevuld. <br>

# ''Gerda Grutjes'' vult het formulier in en geeft aan het formulier op te willen slaan.<br>


===== Alternate Path =====
: '''Evenement Wijzigen'''<br>

# ''Gerda Grutjes'' geeft aan in te willen loggen.<br>
# Het systeem vraagt om een inlognaam en bijbehorend wachtwoord.<br>
# Harry vult in bij inlognaam: ''GerdaGrutjes'' en bij wachtwoord: ''QdxOerD!''<br>
# Het systeem geeft aan dat ''Gerda Grutjes'' succesvol is ingelogd.<br>
# ''Gerda Grutjes'' geeft aan een evenement te willen wijzigen.<br>
# Het systeem geeft het formulier van de eerder ingevulde evenementinformatie. <br>
# ''Gerda Grutjes'' verandert ''de datum naar 7 juni 2014'' en geeft aan het formulier op te willen slaan.<br>


===== Alternate Path =====
: '''Evenement Verwijderen'''<br>

# ''Gerda Grutjes'' geeft aan in te willen loggen.<br>
# Het systeem vraagt om een inlognaam en bijbehorend wachtwoord.<br>
# Harry vult in bij inlognaam: ''GerdaGrutjes'' en bij wachtwoord: ''QdxOerD!''<br>
# Het systeem geeft aan dat ''Gerda Grutjes'' succesvol is ingelogd.<br>
# ''Gerda Grutjes'' geeft aan een evenement te willen verwijderen.<br>
# Het systeem toont een lijst met de door ''Gerda Grutjes'' aangemaakte evenementen. <br>
# ''Gerda Grutjes'' geeft aan evenement ''Super Poker Friday'' te willen verwijderen. <br>
# Het systeem vraagt om een bevestiging. <br>
# '' Gerda Grutjes'' geeft aan dat ze akkoord gaat en slaat het formulier op. <br>

===== Exception Path =====
: '''Verkeerd(e) inloggegeven(s)'''<br>

# ''Gerda Grutjes'' geeft aan in te willen loggen.<br>
# Het systeem vraagt om een inlognaam en bijbehorend wachtwoord.<br>
# ''Gerda Grutjes'' vult in bij inlognaam: ''GerdaGrutjes1'' en bij wachtwoord: ''QdxOerD!''.<br>

# Het systeem geeft aan dat de gegevens fout zijn. En vraagt opnieuw om inloggegevens.<br>
# ''Gerda Grutjes'' vult in bij inlognaam: ''GerdaGrutjes'' en bij wachtwoord: ''QdxOerD!''.<br>
# Het systeem toont dat ''Gerda Grutjes'' succesvol is ingelogd.<br>
# ''Gerda Grutjes'' geeft aan de kroegspecificaties aan te willen passen.<br>
# Het systeem toont de huidige kroegspecificaties.<br>
# ''Gerda Grutjes'' verandert ''de prijs van het bier naar €1.00'' en slaat het formulier op.<br>


===== Exception Path =====
: '''Drie keer foutief'''<br>
# ''Gerda Grutjes'' geeft aan in te willen loggen.<br>
# Het systeem vraagt om een inlognaam en bijbehorend wachtwoord.<br>
# ''Gerda Grutjes'' vult in bij inlognaam: ''GerdaGrutjes1'' en bij wachtwoord: ''QdxOerD!''.<br>

# Het systeem geeft aan dat de gegevens fout zijn. En vraagt opnieuw om inloggegevens.<br>
# ''Gerda Grutjes'' vult in bij inlognaam: ''GerdaGrutjes'' en bij wachtwoord: ''qdxOerD!''.<br>

# Het systeem geeft aan dat de gegevens fout zijn. En vraagt opnieuw om inloggegevens.<br>
# ''Gerda Grutjes'' vult in bij inlognaam: ''Gerda1Grutjes'' en bij wachtwoord: ''qdxOerD!''.<br>

# Het systeem geeft aan dat het account is geblokkeerd en dat ''Gerda Grutjes'' contact moet zoeken met Mercurius voor nieuwe inloggegevens.<br>

===== Exception Path =====
: '''Leeg formulier opslaan'''<br>
# ''Gerda Grutjes'' geeft aan in te willen loggen.<br>
# Het systeem vraagt om een inlognaam en bijbehorend wachtwoord.<br>
# Harry vult in bij inlognaam: ''GerdaGrutjes'' en bij wachtwoord: ''QdxOerD!''.<br>
# Het systeem geeft aan dat ''Gerda Grutjes'' succesvol is ingelogd.<br>
# ''Gerda Grutjes'' geeft aan een evenement te willen toevoegen.<br>
# Het systeem geeft een formulier waar evenementinformatie moet worden ingevuld. <br>
# ''Gerda Grutjes'' vult  <u>niet</u> het formulier in en geeft aan het formulier op te willen slaan.<br>
# Het systeem geeft aan dat er dat niet mag, en toont opnieuw het formulier.<br>
# ''Gerda Grutjes'' vult het formulier in en geeft aan het formulier op te willen slaan.<br>

==== Scenario "Inhoud van database veranderen" ====
===== Basic Course of Events =====
: '''Ongepaste review verwijderen'''
# <i>Quoc An Ha</i> geeft aan de database te willen aanpassen. 
# Het systeem vraagt om een inlognaam en een daarbij behorend wachtwoord.
# <i>Quoc An Ha</i> vult "''Quoc An Ha''" in bij het veld inlognaam en vult "''wachtwoord123''" in bij het veld wachtwoord. 
# Het systeem toont het bericht "''Succesvol ingelogd!''" en toont een menu.
# <i>Quoc An Ha</i> kiest voor optie "''Gemarkeerde review(s) verwijderen''" in het menu. 
# Het systeem toont een lijst met recente (gemarkeerde) reviews. 
# <i>Quoc An Ha</i> kiest er voor de review van <i>Anna Bool</i> over de "NDRGRND" te willen verwijderen. 
# Het systeem toont het bericht "''Review verwijderd!''"

===== Alternate Path =====
: '''Verkeerde inloggegeven(s)'''
# <i>Quoc An Ha</i> geeft aan de database te willen aanpassen. 
# Het systeem vraagt om een inlognaam en een daarbij behorend wachtwoord.
# <i>Quoc An Ha</i> vult "''Quoc An Ha''" in bij het veld inlognaam en vult "''wachtwoort123''" in bij het veld wachtwoord. 
# Het systeem vraagt om een inlognaam en een daarbij behorend wachtwoord.
# <i>Quoc An Ha</i> vult "''Quoc An Ha''" in bij het veld inlognaam en vult "''wachtwoord123''" in bij het veld wachtwoord. 
# Het systeem toont het bericht "''Succesvol ingelogd!''" en toont een menu.
# <i>Quoc An Ha</i> geeft aan een review te willen verwijderen.
# Het systeem toont een lijst met recente (gemarkeerde) reviews. 
# <i>Quoc An Ha</i> kiest er voor de review van <i>Anna Bool</i> over de "NDRGRND" te willen verwijderen. 
# Het systeem toont het bericht "''Review verwijderd!''"

===== Alternate Path =====
: '''Kroeg toevoegen'''
# <i>Quoc An Ha</i> geeft aan de database te willen aanpassen. 
# Het systeem vraagt om een inlognaam en een daarbij behorend wachtwoord.
# <i>Quoc An Ha</i> vult "''Quoc An Ha''" in bij het veld inlognaam en vult "''wachtwoord123''" in bij het veld wachtwoord. 
# Het systeem toont het bericht "''Succesvol ingelogd!''" en toont een menu.
# <i>Quoc An Ha</i> kiest voor optie "''Voeg kroeg toe''" in het menu. 
# Het systeem toont een formulier met gegevens voor de kroeg. 
# <i>Quoc An Ha</i> voegt kroeg "''An's Bar''" toe aan de lijst met kroegen met daarbij de desbetreffende kroegspecificaties. 
# Het systeem toont de kroeg "''An's Bar''" met de daarbij behorende kroegspecificaties.


===== Alternate Path =====
: '''Kroegspecificaties aanpassen'''
# <i>Quoc An Ha</i> geeft aan de database te willen aanpassen. 
# Het systeem vraagt om een inlognaam en een daarbij behorend wachtwoord.
# <i>Quoc An Ha</i> vult "''Quoc An Ha''" in bij het veld inlognaam en vult "''wachtwoord123''" in bij het veld wachtwoord. 
# Het systeem toont het bericht "''Succesvol ingelogd!''" en toont een menu.
# <i>Quoc An Ha</i> kiest voor optie "''Kroeg aanpassen''" in het menu. 
# Het systeem toont een lijst met kroegen. 
# <i>Quoc An Ha</i> kiest kroeg "''An's Bar''" om deze aan te passen.
# Het systeem toont een een ingevuld formulier met daarin de kroegspecificaties van "''An's Bar''".
# <i>Quoc An Ha</i> past de bierprijs aan en veranderd deze van €1.50 naar €2.00 en slaat selecteert de knop "''Opslaan''". 
# Het systeem toont de kroeg "''An's Bar''" met desbetreffende aangepaste kroegspecificaties.

===== Alternate Path =====
: '''Kroeg verwijderen'''
# <i>Quoc An Ha</i> geeft aan de database te willen aanpassen. 
# Het systeem vraagt om een inlognaam en een daarbij behorend wachtwoord.
# <i>Quoc An Ha</i> vult "''Quoc An Ha''" in bij het veld inlognaam en vult "''wachtwoord123''" in bij het veld wachtwoord. 
# Het systeem toont het bericht "''Succesvol ingelogd!''" en toont een menu.
# <i>Quoc An Ha</i> kiest voor optie "''Kroeg aanpassen''" in het menu. 
# Het systeem toont een lijst met kroegen. 
# <i>Quoc An Ha</i> kiest kroeg "''An's Bar''" om deze aan te passen.
# Het systeem toont een een ingevuld formulier met daarin de kroegspecificaties van "''An's Bar''".
# <i>Quoc An Ha</i> selecteert de knop "''Kroeg verwijderen''".

===== Exception path =====
: '''De lijst met reviews is leeg'''
# <i>Quoc An Ha</i> geeft aan de database te willen aanpassen. 
# Het systeem vraagt om een inlognaam en een daarbij behorend wachtwoord.
# <i>Quoc An Ha</i> vult "''Quoc An Ha''" in bij het veld inlognaam en vult "''wachtwoord123''" in bij het veld wachtwoord. 
# Het systeem toont het bericht "''Succesvol ingelogd!''" en toont een menu.
# <i>Quoc An Ha</i> kiest voor optie "''Gemarkeerde review(s) verwijderen''" in het menu. 
# Het systeem toont een lege lijst met reviews.

===== Exception path =====
: '''Kroeg toevoegen/aanpassen'''
# <i>Quoc An Ha</i> geeft aan de database te willen aanpassen. 
# Het systeem vraagt om een inlognaam en een daarbij behorend wachtwoord.
# <i>Quoc An Ha</i> vult "''Quoc An Ha''" in bij het veld inlognaam en vult "''wachtwoord123''" in bij het veld wachtwoord. 
# Het systeem toont het bericht "''Succesvol ingelogd!''" en toont een menu.
# <i>Quoc An Ha</i> kiest voor optie "''Voeg kroeg toe''" in het menu. 
# Het systeem toont een formulier met gegevens voor de kroeg. 
# <i>Quoc An Ha</i> voegt kroeg "''An's Bar''" toe aan de lijst met kroegen en daarbij vult hij geen kroegspecificaties in. 
# Het systeem toont een formulier met gegevens voor de kroeg. 
# <i>Quoc An Ha</i> voegt kroeg "''An's Bar''" toe aan de lijst met kroegen met daarbij de desbetreffende kroegspecificaties. 
# Het systeem toont de kroeg "''An's Bar''" met de daarbij behorende kroegspecificaties.

== Non-functional Requirements ==
'''Integriteit:''' Normale gebruikers kunnen niet de kroeg/evenementen informatie in de database veranderen. Alleen de beheerders kunnen dit en dat gaat niet via de app. <br>

'''Gebruiksvriendelijk:''' De app dient gebruiksvriendelijk te zijn zodat het makkelijk en snel gebruikt kan worden. <br>

'''Betrouwbaarheid:''' De informatie moet wel kloppen, bijvoorbeeld kroegen mogen niet hun bier goedkoper op de app aangeven dan dat het eigenlijk is. <br>

'''Privacy:''' De gps en browsegegevens van personen dienen privé , dus alleen lokaal opgeslagen, te zijn. <br>

= Addendum =
== Integrated Domainmodel ==

[[Bestand:ALLES_ORM_Schema_RequirementsEngineering_Groepje12_2014.png]]

voor de volledige formaten van de plaatjes, mocht iemand nog iets willen aanpassen:

https://lab.cs.ru.nl/algemeen/Bestand:ALLES_ORM_Schema_RequirementsEngineering_Groepje12_2014_VOL_FORMAAT.png

https://lab.cs.ru.nl/algemeen/Bestand:UC1_ORM_Schema_RequirementsEngineering_Groepje12_2014_VOL_FORMAAT.png

https://lab.cs.ru.nl/algemeen/Bestand:UC2_ORM_Schema_RequirementsEngineering_Groepje12_2014_VOL_FORMAAT.png

https://lab.cs.ru.nl/algemeen/Bestand:UC3_ORM_Schema_RequirementsEngineering_Groepje12_2014_VOL_FORMAAT.png

https://lab.cs.ru.nl/algemeen/Bestand:UC4_ORM_Schema_RequirementsEngineering_Groepje12_2014_VOL_FORMAAT.png

https://lab.cs.ru.nl/algemeen/Bestand:UC5_ORM_Schema_RequirementsEngineering_Groepje12_2014_VOL_FORMAAT.png

== Business Rules Catalogue ==
=== Algemene business rules ===
# Studentenvereniging Mercurius en kroegeigenaren dienen een account te hebben voor de app.
# Gebruikersnamen mogen maar één keer gebruikt worden.
# Wachtwoorden en gebruikersnamen blijven privé.
# Wachtwoorden moeten langer zijn dan 6 karakters en minstens één cijfer en één hoofdletter bevatten.

=== Use case gespecificeerde business rules ===
# Kroegeigenaren mogen niet meerdere evenementen op dezelfde tijd plannen voor hun eigen kroeg.
# Kroegeigenaren zijn verplicht hun informatie te updaten als deze worden gewijzigd.
# Kroegen kunnen alleen toegevoegd en verwijderd worden door Mercurius.
# Browsegegevens blijven privé.

== Terminological Definitions ==
'''Globale informatie:''' Naam, adres, afstand verwijderd van huidige positie, evenement.<br>
'''Specificaties:''' Naam, adres, afstand verwijderd van huidige positie, bierprijs.<br>
'''Evenementinfo:''' Locatie, datum, entreeprijs, omschrijving.<br>
'''Evenement:''' Een bepaalde gebeurtenis in een bepaalde kroeg. Bijvoorbeeld een thema feest, of een actie waarbij de bierprijzen omlaag gaan.<br>
'''Mercurius:''' Mensen die bij de studentenvereniging Mercurius het recht hebben gekregen om onze app te beheren.<br>
'''Review:''' Een door een gebruiker gespecificeerde reactie, mening of waardering over een kroeg.<br>
'''Formulier:''' Een pagina met invulvelden die door de gebruiker ingevuld kunnen worden.<br>
'''Gebruiker:''' Personen die de app gebruiken.<br>
'''Kroegeigenaar:''' Eigenaren van een bepaalde uitgaansgelegenheid in de stad Nijmegen.<br>
'''Het systeem:''' Het geprogrameerde systeem van de app.<br>