https://wiki.itcollege.ee/api.php?action=feedcontributions&feedformat=atom&user=Saasma
ICO wiki - User contributions [en]
2026-05-05T19:19:55Z
User contributions
MediaWiki 1.45.1
https://wiki.itcollege.ee/index.php?title=BeerPressure&diff=131463
BeerPressure
2018-06-08T20:33:04Z
<p>Saasma: /* Projekti repository */</p>
<hr />
<div>== Meeskond ja rollid ==<br />
<br />
* Sigrid Aasma (arendaja)<br />
* Evelin Jõgi (arendaja)<br />
* Martin Kask (projektijuht, arendaja)<br />
* Marko Nõu (arendaja)<br />
<br />
== Idee ==<br />
'''Toidukohtade põhimenüüde ja päevapakkumiste teenus'''<br />
<br />
Soovime pakkuda toidukohtade põhimenüüde ja päevapakkumiste teenust. On olemas mitmeid kodulehti “päevapakkumised”, kus on kirjas toidukohtade päevapraed. Kuid tavaliselt sellistel lehtedel ei ole masinloetavaid andmeid ehk siis varianti, et saad saata API pihta mingi kuupäeva koos päevapraadidega andmete uuendamiseks ja saad sama API käest küsida tänaseid päevapraade. Andmeid võiks saada küsida restorani, kuupäeva, asukoha või otsisõna/otsisõnaosa põhiselt. Selline teenus lihtsustaks ka toidukohtade päevapakkumiste haldamist, kuna praegu peavad teenuse pakkujad vastavat informatsiooni uuendama mitmes erinevas kohas - nii erinevates portaalides, kui ka enda veebileheküljel. Samuti oleks toidukohtade kogu menüü haldamine ühes kohas.<br />
<br />
=== Esialgne prototüüp ===<br />
<br />
[[File:TäisKõhtProto1.mp4]]<br />
<br />
Esialgne prototüüp: [http://enos.itcollege.ee/~saasma/VR2/Proto/K%C3%B5htT%C3%A4is/#g=1&p=home navigeeritav versioon vol.1]<br />
<br />
=== Prototüübi muutus projekti käigus ===<br />
<br />
Prototüüp: [http://enos.itcollege.ee/~saasma/VR2/Proto/T%C3%A4isK%C3%B5ht/K%C3%B5htT%C3%A4is/#g=1&p=home navigeeritav versioon vol.2]<br />
<br />
== Kasutatav arendustehnoloogia ==<br />
<br />
Veebiteenuse loomisel kasutame ASP.NET Core tehnoloogiat ja kursusel õpitud arendusmustreid.<br />
<br />
Klientrakenduse loomisel kasutame Node.js + React'i.<br />
<br />
== Veebiteenuse analüüs ==<br />
Pakume toidukohtade põhimenüüde ja päevapakkumiste teenust, kuhu on kokku koondatud erinevate toidukohtade menüüd üle Eesti. Põhimenüü alla kuuluvad pikaajalised menüüd, mis kehtivad püsivalt, hooajaliselt või mingil konkreetsel nädalapäeval. Päevapakkumiste alla kuuluvad konkreetse kuupäevaga seotud päevapakkumised. Päevapakkumiste korral kuvatakse lisainfona, kas pakkumine kehtib mingis konkreetses ajavahemikus või kogu toidukoha lahtioleku aja.<br />
<br />
Eesmärk on koguda ühte kohta kokku erinevate toidukohtade menüüd ja päevapakkumised, et kliendid saaksid mugavalt ja kiiresti oma valikuid teha. Kliendid käivad enamasti päevapakkumisi söömas lõuna ajal ja selleks ettenähtud aeg on piiratud. Sellepärast on oluline, et klient saaks teha oma valiku võimalikult kiiresti. Tänu loodavale veebiteenusele ei pea kliendid käima erinevates portaalides, et tutvuda erinevate toidukohtade pakkumistega. Kuna teenust on mugav kasutada ja klient saab oma valiku kiiresti tehtud, siis tõenäoliselt teeb klient valiku selles keskkonnas olevate toiduasutuste seast. Lisaks võimaldab teenus toiduasutustel paika panna oma pikaajalisem põhimenüü ning seda rakenduses ja võimalusel ka söögikohas kuvada. Sellepärast on ka toidukohtade huvi antud keskkonnas üleval olla ja meiega oma andmeid jagada, sest see suurendab nende klientuuri ning muudab oma menüü haldamise kergemaks.<br />
<br />
Veebiteenuse loomisel lähtume eelkõige sellest, et kliendil oleks teenust mugav kasutada ja ta saaks oma valiku kiiresti tehtud. Arvestame, et kliendid on erinevad. Mõni eelistab mõnda kindlat toidukohta, sel juhul saab ta valida oma soovitud kohad ja võrrelda nende kohtade tänase päeva pakkumisi ning menüüsid. Mõnele inimesele on oluline pakutav söök ja ta eelistab pakkumist otsida prae nimetuses oleva sõna või sõnaosa järgi ning lähtuda seejärel valiku tegemisel toidukoha keskmisest hindest või toidu hinnast. Mõne kliendi jaoks on oluline hind ja selleks, et oma valikut teha sobivas hinnavahemikus on tal võimalik sisestada maksimum hinna piirang. Kindlasti on antud teenuse juures kõikide klientide jaoks oluline päevapakkumiste asukohapõhine eristatus. Kliendid, kes soovivad oma konto luua, võivad oma eelistatud valikud meelde jätta ja järgmisel korral kuvatakse neid talle automaatselt.<br />
<br />
Teenuse must-have funktsionaalsus tagab teenuse toimimise ja põhifunktsioonid. Teenuse nice-to-have funktsionaalsus annab rakendusele lisandväärtust.<br />
<br />
Arvestades pakutava teenusega, siis näeme, et aktiivseim teenuse kasutamine võib olla tööpäevadel vahemikus 11.00-15.00, kui kliendid tutvuvad päevapakkumistega. Teenus peab tekkivale koormusele vastu pidama.<br />
<br />
Teenuse pakkumine peab olema turvaline. Selle tagamiseks tuleb sisestatavaid andmeid valideerida ja andmebaasi sisestavate andmete mahtu piirata. Toidukohtade sisestatud andmed peavad olema kaitstud, et toitude koostised ei saaks avalikuks. Põhjendatud juhtudel on võimalik kasutajaid lukku panna.<br />
<br />
== Kasutajad ==<br />
<br />
<br />
* Admin - lehe administraator, kellel on õigus lehte, kasutajaid ja nende õiguseid hallata. Tema huvi on, et teenus toimiks tõrgeteta.<br />
* Toiduasutus (tasuta kasutaja) - saab hoida lehel ühte põhimenüüd ja päevapakkumisi.<br />
* Toiduasutus (tellimusega kasutaja) - saab hoida lehel piiramatu arv põhimenüüsid ja päevapakkumisi.<br />
Toiduasutused on teenusest huvitatud, et nende menüüde haldamine oleks kerge ja mugav ning nad saaksid oma klientide arvu suurendada.<br />
* Külastaja - klient, kes valib söögikohta. Tema on huvitatud eelkõige sellest, et teenust saaks kasutada mugavalt ja kiirelt ning toidukohtade valik oleks võimalikult suur.<br />
<br />
== Rakenduse must-have funktsionaalsus ==<br />
<br />
* Kasutajad saavad sisse logida<br />
* Kasutajatel on erinevad rollid: admin, toidukoht (tasuta ja tasulise tellimusega), klient<br />
* Kasutajate arvepidamine kasutajate lõikes:<br />
** sisselogimise kuupäev, kellaaeg<br />
** pakkumiste lisamine<br />
** pakkumiste muutmine<br />
** pakkumiste kustutamine<br />
** õiguste kehtimise periood (tasuta ja tellimusega toidukoht)<br />
** pakkumistele klikkimise arv<br />
* Kasutajaid on võimalik hallata:<br />
** kasutajale õiguste andmine (menüüde arvu suurendamine, tellimusega toidukohal), rolli määramine<br />
** Kasutajat on võimalik piirata: õiguseid piirata (piiratud menüüde arv, tasuta liitunud toidukohal) ja lukku panna<br />
* Päevapakkumisi/menüüsid saab küsida: <br />
** toidukoha järgi, <br />
** kuupäeva põhiselt (ainult päevapakkumisi), <br />
** asukoha põhiselt,<br />
** toidu nimetuses esineva otsisõna/otsisõna osa põhiselt,<br />
** hinna põhiselt (max hinna piirang).<br />
* Klientrakenduses realiseeritakse CRUD meetodid (menüüsid/päevapakkumisi saab sisestada, lugeda, uuendada, kustutada)<br />
* Toidukohale saab anda hindeid ja kuvatakse keskmist hinnet.<br />
* Toidule saab anda hindeid ja kuvatakse keskmist hinnet.<br />
<br />
== Nice-to-have funktsionaalsus ==<br />
<br />
* Info selle kohta, kas päevapakkumine on otsas<br />
* Päevapakkumisi/menüüsid saab kommenteerida ja neid kommentaare kuvatakse avalikult.<br />
* Söögikohtade kodulehtedelt otsimise script, mis genereerib juba olemasolevate kodulehtede baasil päevamenüüsid.<br />
* Toiduvaliku piiramine allergeenide/vegan/jms. koostisosade põhiselt.<br />
* Aruandlused ja võrdlused toidukohtadele, et võrrelda end konkurentidega.<br />
* Teenus soovitab toidukohtadele nende varasemate päevapraadide populaarsuse alusel uue nädala menüüd.<br />
* Erinevad toidukohtade/toitude pingeread klientidele, et anda valikuteks ideid.<br />
* Soovitused klientidele, mida teised kliendid sarnaste eelistustega on veel valinud.<br />
<br />
== Andmebaasi ülesehitus - projekti algus ==<br />
<br />
[[File: BeerPressureAndmebaasimudel.png]]<br />
<br />
== Andmebaasi ülesehitus - projekti lõpp ==<br />
<br />
[[File: Ta2isKo6ht-DB-FINAL.png]]<br />
<br />
== Projekti repository ==<br />
<br />
https://github.com/sikumiku/TaisKohtApi<br />
<br />
Zip fail saadaval 27.05 seisuga: <br />
(master branchi viimane commit esitamise ajal)<br />
https://github.com/sikumiku/TaisKohtApi/archive/61438e187a1a972410c8a3bc6274d69489d00aa6.zip<br />
<br />
Uuendatud .zip fail 08.06 seisuga: https://github.com/sikumiku/TaisKohtApi/archive/7acbc702b13550daee840069ca9be886807dd900.zip<br />
<br />
== API v1 dokumentatsioon ==<br />
<br />
===Security===<br />
'''POST /api/account/register'''<br />
<source><br />
Params: RegisterViewModel registerViewModel<br />
<br />
Returns: token<br />
</source><br />
<br />
'''POST /api/account/login'''<br />
<source> <br />
Params: LoginViewModel model<br />
<br />
Returns: token<br />
</source><br />
<br />
'''POST /api/account/logout'''<br />
<source> <br />
Params: -<br />
<br />
Returns: -<br />
</source><br />
<br />
===Accounts===<br />
'''GET /api/v1/accounts/getAllUsersInRole'''<br />
<source> <br />
Params: string role<br />
<br />
Returns: List<UserDTO><br />
</source><br />
<br />
'''GET /api/v1/accounts/{id}'''<br />
<source> <br />
Params: string id<br />
<br />
Returns: UserDTO<br />
</source><br />
<br />
'''PUT /api/v1/accounts/{id}'''<br />
<source> <br />
Params: string id, UpdateUserDTO userDTO<br />
<br />
Returns: -<br />
</source><br />
<br />
'''POST /api/v1/accounts/addRole'''<br />
<source> <br />
Params: string role<br />
<br />
Returns: -<br />
</source><br />
<br />
'''POST /api/v1/accounts/addRoleToUser'''<br />
<source> <br />
Params: string role, string userId<br />
<br />
Returns: UserDTO<br />
</source><br />
<br />
'''DELETE /api/v1/accounts/deactivate/{id}'''<br />
<source> <br />
Params: string id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Promotions===<br />
'''GET /api/v1/promotions '''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<PromotionDTO> <br />
</source><br />
<br />
'''GET /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: PromotionDTO<br />
</source><br />
<br />
'''POST /api/v1/promotions'''<br />
<source> <br />
Params: PromotionDTO promotionDTO<br />
<br />
Returns: PromotionDTO newPromotion<br />
</source><br />
<br />
'''PUT /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id, PromotionDTO promotionDTO<br />
<br />
Returns: PromotionDTO updatedPromotion<br />
</source><br />
<br />
'''DELETE /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Restaurants===<br />
'''GET /api/v1/restaurants'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<SimpleRestaurantDTO><br />
</source><br />
<br />
'''GET /api/v1/restaurants/owner'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<SimpleRestaurantDTO><br />
</source><br />
<br />
'''GET /api/v1/restaurants/search?name=th'''<br />
<source> <br />
Params: string name<br />
<br />
Returns: List<SimpleRestaurantDTO> result<br />
</source><br />
<br />
'''GET /api/v1/restaurants/top'''<br />
<source> <br />
Params: int amount<br />
<br />
Returns: List<SimpleRestaurantDTO> result<br />
</source><br />
<br />
'''GET /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: RestaurantDTO r<br />
</source><br />
<br />
'''POST /api/v1/restaurants/addUserToRestaurant'''<br />
<source> <br />
Params: int id, string userId<br />
<br />
Returns: -<br />
</source><br />
<br />
'''POST /api/v1/restaurants'''<br />
<source> <br />
Params: PostRestaurantDTO restaurantDTO<br />
<br />
Returns: RestaurantDTO newRestaurant<br />
</source><br />
<br />
'''PUT /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id, PostRestaurantDTO restaurantDTO<br />
<br />
Returns: PostRestaurantDTO updatedRestaurantDTO<br />
</source><br />
<br />
'''DELETE /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Menus===<br />
'''GET /api/v1/menus'''<br />
<source><br />
Params: -<br />
<br />
Returns: List<MenuDTO><br />
</source><br />
<br />
'''GET /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: MenuDTO menuDTO<br />
</source><br />
<br />
'''POST /api/v1/menus'''<br />
<source> <br />
Params: PostMenuDTO menuDTO<br />
<br />
Returns: MenuDTO newMenu<br />
</source><br />
<br />
'''PUT /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id, PostMenuDTO menuDTO<br />
<br />
Returns: MenuDTO updatedMenu<br />
</source><br />
<br />
'''PUT api/v1/Menus/{id}/Dishes'''<br />
<source> <br />
Params: int menuId, int[] dishIds<br />
<br />
Returns: -<br />
</source><br />
<br />
'''DELETE /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Dishes===<br />
'''GET /api/v1/dishes'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<DishDTO><br />
</source><br />
<br />
'''GET /api/v1/dishes/daily'''<br />
<source> <br />
Params: bool vegan, bool glutenFree, bool lactoseFree<br />
<br />
Returns: List<SimpleDishDTO> result<br />
</source><br />
<br />
'''GET: api/v1/dishes/search?title=th&priceLimit=null'''<br />
<source> <br />
Params: string title, decimal? priceLimit<br />
<br />
Returns: List<DishDTO> result<br />
</source><br />
<br />
'''GET /api/v1/dishes/top'''<br />
<source> <br />
Params: int amount<br />
<br />
Returns: List<DishDTO> result<br />
</source><br />
<br />
'''GET /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: DishDTO dishDTO<br />
</source><br />
<br />
'''POST /api/v1/dishes'''<br />
<source> <br />
Params: PostDishDTO dishDTO<br />
<br />
Returns: DishDTO newDish<br />
</source><br />
<br />
'''PUT /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id, PostDishDTO dishDTO<br />
<br />
Returns: DishDTO updatedDish<br />
</source><br />
<br />
'''PUT api/v1/Dishes/{id}/Ingredients'''<br />
<source> <br />
Params: int dishId, PostIngredientForDishDTO[] ingredients<br />
<br />
Returns: -<br />
</source><br />
<br />
'''DELETE /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Ingredients===<br />
'''GET /api/v1/ingredients'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<IngredientDTO><br />
</source><br />
<br />
'''GET /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: IngredientDTO i<br />
</source><br />
<br />
'''POST /api/v1/ingredients'''<br />
<source> <br />
Params: PostIngredientDTO ingredientDTO<br />
<br />
Returns: IngredientDTO newIngredient<br />
</source><br />
<br />
'''PUT /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id, PostIngredientDTO ingredientDTO<br />
<br />
Returns: IngredientDTO updatedIngredient<br />
</source><br />
<br />
'''DELETE /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Ratings===<br />
'''GET /api/v1/ratings'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<RatingLogDTO><br />
</source><br />
<br />
'''GET /api/v1/ratings/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: RatingLogDTO dto<br />
</source><br />
<br />
'''POST /api/v1/ratings'''<br />
<source> <br />
Params: RatingLogForEntityDTO ratingDTO<br />
<br />
Returns: RatingLogDTO newRating<br />
</source><br />
<br />
'''PUT api/v1/ratings/{id}'''<br />
<source> <br />
Params: int id, RatingLogForEntityDTO ratingDTO<br />
<br />
Returns: RatingLogDTO updatedRating<br />
</source><br />
<br />
'''DELETE api/v1/ratings/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===RequestLog===<br />
'''GET: api/v1/usageData/{userId}'''<br />
<source> <br />
Params: string userId<br />
<br />
Returns: List<RequestLogDTO><br />
</source><br />
<br />
== Lõpptoote kasutusjuhend ==<br />
<br />
* Kloonida kohalikku arvutisse repository aadressilt [https://github.com/sikumiku/TaisKohtApi https://github.com/sikumiku/TaisKohtApi]<br />
* Installida NodeJS<br />
* <source>npm install webpack -g</source><br />
* <source>npm install -cli -g</source><br />
* Frontend rakenduse kasutamiseks valida Startup meetoditest IIS Express, veebiteenuse ja Swaggeri kasutamiseks käivitada Api Swagger<br />
* Esimese admin kasutaja loomiseks tuleb kasutaja registreerida admin@gmail.com e-mailiga<br />
<br />
== XML/XSD/XSLT ==<br />
<br />
=== XML ===<br />
<br />
<source><?xml version="1.0" encoding="utf-8" ?><br />
<restaurants><br />
<restaurant id="1" url="https://kuuspelmeeni.ee" contactnumber="507783342" email="kuuspelmeeni@gmail.com"><br />
<name><![CDATA[Kuus Pelmeeni]]></name><br />
<menus><br />
<menu id="1" repetitioninterval="30"><br />
<name><![CDATA[Päevamenüü]]></name><br />
<activefrom>2018-05-27T12:00:00</activefrom><br />
<activeto>2018-05-28T12:00:00</activeto><br />
<dishes><br />
<dish id="1" vegan="false" lactosefree="false" glutenfree="false" daily="true" kcal="550" dailyprice="4"><br />
<title><![CDATA[8 pelmeeni]]></title><br />
<description><![CDATA[8 pelmeeni 6 asemel serveeritud tervisliku koguse hapukoore ja tilliga]]></description><br />
<availablefrom>2018-05-27T12:00:00</availablefrom><br />
<availableto>2018-05-28T12:00:00</availableto><br />
<ingredients><br />
<ingredient id="1" amountunit="g"><br />
<name>Sealiha</name><br />
<description>Rakvere sealiha</description><br />
</ingredient><br />
<ingredient id="2" amountunit="g"><br />
<name>Hapukoor</name><br />
<description>Alma hapukoor</description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="9"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Parim päevaroog viimasel ajal.]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
</comments><br />
</rating><br />
<promotion id="1" type="visual" classname="bold-red-border-2px"><br />
<name>2px red border</name><br />
<description><![CDATA[Displays a 2px wide red border around the component that is promoted.]]></description><br />
<validto>2018-06-25T12:00:00</validto><br />
</promotion><br />
</dish><br />
<dish id="2" vegan="true" lactosefree="true" glutenfree="true" daily="true" kcal="320" price="4"><br />
<title><![CDATA[Kurgisalat]]></title><br />
<description><![CDATA[Erinevatel viisidel töödeldud kurk serveeritud koos jõhvikatega. Tervislik amps.]]></description><br />
<availablefrom>2018-05-27T12:00:00</availablefrom><br />
<availableto>2018-05-28T12:00:00</availableto><br />
<ingredients/><br />
<rating ratingvalue="4"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Jäin veel väga näljaseks peale selle söömist.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
</dishes><br />
</menu><br />
<menu id="2"><br />
<name><![CDATA[Põhimenüü]]></name><br />
<dishes><br />
<dish id="4" vegan="false" lactosefree="false" glutenfree="false" daily="false" kcal="550" price="5"><br />
<title><![CDATA[6 pelmeeni]]></title><br />
<description><![CDATA[6 pelmeeni serveeritud tervisliku koguse hapukoore ja tilliga]]></description><br />
<ingredients><br />
<ingredient id="1" amountunit="g"><br />
<name>Sealiha</name><br />
<description>Rakvere sealiha</description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="9.5"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Käin seda iga päev söömas.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Parim toit selles restoranis.]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
<dish id="5" vegan="false" lactosefree="false" glutenfree="true" daily="false" kcal="460" price="3.8"><br />
<title><![CDATA[Kartulisalat]]></title><br />
<description><![CDATA[Sinki sisaldav traditsiooniline kartulisalat.]]></description><br />
<ingredients/><br />
</dish><br />
<dish id="6" vegan="false" lactosefree="false" glutenfree="false" daily="false" kcal="610" price="3.9"><br />
<title><![CDATA[Šokolaadikook]]></title><br />
<description><![CDATA[Ahvatlev glasuuritud šokolaadikook.]]></description><br />
<ingredients/><br />
<rating ratingvalue="7.8"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Šokolaadikooki on keeruline metsa keerata.]]></commenttext><br />
<username>mutikas3</username><br />
<userid>3a29b94a-3f17-469d-a44d-f7d85e98dd3e</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
</dishes><br />
</menu><br />
</menus><br />
<dishes/><br />
<address id="1" country="Eesti"><br />
<addressfirstline>Tatari 12</addressfirstline><br />
<locality>Tallinn</locality><br />
<postcode>10132</postcode><br />
<region>Harjumaa</region><br />
</address><br />
<promotion/><br />
<rating ratingvalue="7.5"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Parim restoran üldse!]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Ma sain ainult 5 pelmeeni. Ootasin kuute.]]></commenttext><br />
<username>kyllikekallike1</username><br />
<userid>6af271dd-0e11-4ae6-98be-111762664318</userid><br />
</comment><br />
</comments><br />
</rating><br />
</restaurant><br />
<restaurant id="2" url="https://kolmkokka.ee" contactnumber="6522351" email="kolmkokka@gmail.com"><br />
<name><![CDATA[Kolm kokka]]></name><br />
<menus/><br />
<dishes><br />
<dish id="7" vegan="false" lactosefree="true" glutenfree="false" daily="false" kcal="470" price="14"><br />
<title><![CDATA[Ahjulõhe juurikatega]]></title><br />
<description><![CDATA[Ahjulõhe serveeritud püreestatud porgandite ja lillkapsaga.]]></description><br />
<ingredients><br />
<ingredient id="11" amountunit="tk" amount="1"><br />
<name>Ahjulõhe</name><br />
<description><![CDATA[Värske ahjulõhe]]></description><br />
</ingredient><br />
<ingredient id="12" amountunit="g"><br />
<name>Püreestatud porgand</name><br />
<description><![CDATA[Eesti porgand, mis on kergelt püreestatud]]></description><br />
</ingredient><br />
<ingredient id="13" amountunit="g"><br />
<name>Püreestatud lillkapsas</name><br />
<description><![CDATA[Eesti lillkapsas, mis on kergelt püreestatud ja maitsestatud]]></description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="8.9"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Kindlasti minu üks lemmikuid.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Pole midagi halba öelda.]]></commenttext><br />
<username>tiiuviiu</username><br />
<userid>0730a7b7-3a9c-4e26-962f-da9a8daeab8a</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
<dish id="8" vegan="true" lactosefree="true" glutenfree="true" daily="true" dailyprice="5"><br />
<title><![CDATA[Ingverisupp]]></title><br />
<description><![CDATA[Ingveriga vürtsistatud ingverisupp, mis viib keele alla.]]></description><br />
<availablefrom>2018-05-25T12:00:00</availablefrom><br />
<availableto>2018-06-25T12:00:00</availableto><br />
<ingredients><br />
<ingredient id="14" amountunit="g" amount="20"><br />
<name>Ingver</name><br />
<description><![CDATA[Tükeldatud ingver]]></description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="6"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Liiga palju ingverit.]]></commenttext><br />
<username>kyllikekallike1</username><br />
<userid>6af271dd-0e11-4ae6-98be-111762664318</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
<dish id="9" vegan="false" lactosefree="false" glutenfree="true" daily="false" kcal="340" price="4.5"><br />
<title><![CDATA[Apelsinijäätis]]></title><br />
<description><![CDATA[Apelsinimaitseline jäätis serveeritud riivitud apelsinikoorega.]]></description><br />
<ingredients/><br />
<rating ratingvalue="8"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Väga huvitav magustoit, prooviks veel.]]></commenttext><br />
<username>mutikas3</username><br />
<userid>3a29b94a-3f17-469d-a44d-f7d85e98dd3e</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Üks mu lemmikuid magustoite.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
</dishes><br />
<address id="2" country="Eesti"><br />
<addressfirstline>Laia 12</addressfirstline><br />
<locality>Tallinn</locality><br />
<postcode>13022</postcode><br />
<region>Harjumaa</region><br />
</address><br />
<promotion/><br />
<rating ratingvalue="8.1"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Hinnad on natuke liiga kallid minu jaoks, aga toit om maitsev.]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Ma kindlasti telliks kala uuesti. Väga mahlakas oli.]]></commenttext><br />
<username>kyllikekallike1</username><br />
<userid>6af271dd-0e11-4ae6-98be-111762664318</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Asukoht oli päris tore. Miljöö ka.]]></commenttext><br />
<username>mutikas3</username><br />
<userid>3a29b94a-3f17-469d-a44d-f7d85e98dd3e</userid><br />
</comment><br />
</comments><br />
</rating><br />
</restaurant><br />
</restaurants></source><br />
<br />
=== XSD ===<br />
<br />
<source><?xml version="1.0" encoding="utf-8"?><br />
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema"><br />
<xs:element name="restaurants"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="restaurant"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="menus"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="menu"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="activefrom" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="activeto" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="dishes"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="dish"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="title" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="availablefrom" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="availableto" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="servetime" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="ingredients"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="ingredient"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="amountunit" type="xs:string" use="required" /><br />
<xs:attribute name="amount" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="rating" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="comments"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="comment"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="commenttext" type="xs:string" /><br />
<xs:element name="username" type="xs:string" /><br />
<xs:element name="userid" type="xs:string" /><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="ratingvalue" type="xs:decimal" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="validto" type="xs:dateTime" minOccurs="0" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="type" type="xs:string" use="required" /><br />
<xs:attribute name="classname" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="vegan" type="xs:boolean" use="optional" /><br />
<xs:attribute name="lactosefree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="glutenfree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="daily" type="xs:boolean" use="optional" /><br />
<xs:attribute name="kcal" type="xs:int" use="optional" /><br />
<xs:attribute name="weightg" type="xs:decimal" use="optional" /><br />
<xs:attribute name="price" type="xs:decimal" use="optional" /><br />
<xs:attribute name="dailyprice" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="validto" type="xs:dateTime" minOccurs="0" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="type" type="xs:string" use="required" /><br />
<xs:attribute name="classname" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="repetitioninterval" type="xs:int" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="dishes"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="dish"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="title" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="availablefrom" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="availableto" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="servetime" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="ingredients"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="ingredient"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="amountunit" type="xs:string" use="required" /><br />
<xs:attribute name="amount" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="rating"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="comments"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="comment"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="commenttext" type="xs:string" /><br />
<xs:element name="username" type="xs:string" /><br />
<xs:element name="userid" type="xs:string" /><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="ratingvalue" type="xs:decimal" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="validto" type="xs:dateTime" minOccurs="0" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="type" type="xs:string" use="required" /><br />
<xs:attribute name="classname" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="vegan" type="xs:boolean" use="optional" /><br />
<xs:attribute name="lactosefree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="glutenfree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="daily" type="xs:boolean" use="optional" /><br />
<xs:attribute name="kcal" type="xs:int" use="optional" /><br />
<xs:attribute name="weightg" type="xs:decimal" use="optional" /><br />
<xs:attribute name="price" type="xs:decimal" use="optional" /><br />
<xs:attribute name="dailyprice" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="address"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="addressfirstline" type="xs:string" /><br />
<xs:element name="locality" type="xs:string" /><br />
<xs:element name="postcode" type="xs:string" /><br />
<xs:element name="region" type="xs:string" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="country" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion" /><br />
<xs:element name="rating" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="comments"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="comment"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="commenttext" type="xs:string" /><br />
<xs:element name="username" type="xs:string" /><br />
<xs:element name="userid" type="xs:string" /><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="ratingvalue" type="xs:decimal" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="url" type="xs:string" use="required" /><br />
<xs:attribute name="contactnumber" type="xs:string" use="required" /><br />
<xs:attribute name="email" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:schema></source><br />
<br />
=== XSLT(HTML) ===<br />
<br />
<source><?xml version="1.0" encoding="utf-8" ?><br />
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:msxsl="urn:schemas-microsoft-com:xslt" exclude-result-prefixes="msxsl"><br />
<xsl:output method="html" indent="yes"/><br />
<xsl:template match="/restaurants"><br />
<html><br />
<head><br />
<title>Täis Kõht</title><br />
</head><br />
<body><br />
<xsl:for-each select="restaurant"><br />
<h1 style="color:DodgerBlue"><br />
<xsl:value-of select="name"/><br />
</h1><br />
<div><br />
<xsl:value-of select="@url"/><br />
</div><br />
<div><br />
<xsl:text>Kontakt number: </xsl:text><br />
<xsl:value-of select="@contactnumber"/><br />
</div><br />
<div><br />
<xsl:text>email: </xsl:text><br />
<xsl:value-of select="@email"/><br />
</div><br />
<div><br />
<xsl:text>Aadress: </xsl:text><br />
<xsl:value-of select="address/addressfirstline"/><br />
<xsl:text>, </xsl:text><br />
<xsl:value-of select="address/locality"/><br />
<xsl:text>, </xsl:text><br />
<xsl:value-of select="address/postcode"/><br />
<xsl:text>, </xsl:text><br />
<xsl:value-of select="address/@country"/><br />
</div><br />
<br />
<xsl:choose><br />
<xsl:when test="menus/menu"><br />
<xsl:for-each select="menus/menu"><br />
<xsl:sort select="name"/><br />
<h3><br />
<xsl:value-of select="name"/><br />
</h3><br />
<br />
<xsl:if test="activefrom != '' and activeto != ''"><br />
<xsl:text> </xsl:text><br />
<xsl:value-of select="substring(activefrom,1,10)"/><br />
<xsl:text> kuni </xsl:text><br />
<xsl:value-of select="substring(activeto,1,10)"/><br />
</xsl:if><br />
<br />
<ul><br />
<xsl:for-each select="dishes/dish"><br />
<xsl:sort select="title"/><br />
<br />
<xsl:if test="availablefrom != '' and availableto != ''"><br />
<xsl:value-of select="substring(availablefrom,1,10)"/><br />
<xsl:text> kuni </xsl:text><br />
<xsl:value-of select="substring(availableto,1,10)"/><br />
</xsl:if><br />
<br />
<li><br />
<span style="font-weight:bold"><br />
<xsl:value-of select="title"/><br />
</span><br />
<xsl:text> - </xsl:text><br />
<xsl:value-of select="description"/><br />
<xsl:text> </xsl:text><br />
<span style="font-weight:bold"><br />
<xsl:if test="@glutenfree='true'"><br />
<xsl:text>G </xsl:text><br />
</xsl:if><br />
<xsl:if test="@lactosefree='true'"><br />
<xsl:text>L </xsl:text><br />
</xsl:if><br />
<xsl:if test="@vegan='true'"><br />
<xsl:text>V </xsl:text><br />
</xsl:if><br />
</span><br />
</li><br />
<br />
<xsl:for-each select="ingredients/ingredient"><br />
<xsl:value-of select="name"/><br />
<xsl:if test="position()!=last()"><br />
<xsl:text>, </xsl:text><br />
</xsl:if><br />
</xsl:for-each><br />
<br />
<p style="font-weight:bold"><br />
<xsl:text>Hind: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="@price!=''"><br />
<xsl:value-of select="@price"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>-</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
<xsl:text> / Päevapakkumise hind: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="@dailyprice!=''"><br />
<xsl:value-of select="@dailyprice"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>-</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
</p><br />
<br />
<div style="background-color:LightGray;"><br />
<xsl:text>Hinnang praele: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="rating/@ratingvalue!=''"><br />
<xsl:value-of select="rating/@ratingvalue"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>Ei ole veel hinnatud!</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
<br />
<br/><br />
<xsl:for-each select="rating/comments/comment"><br />
<xsl:value-of select="username"/><br />
<xsl:text>: </xsl:text><br />
<xsl:value-of select="commenttext"/><br />
<br/><br />
</xsl:for-each><br />
</div><br />
<br/><br />
</xsl:for-each><br />
</ul><br />
</xsl:for-each><br />
</xsl:when><br />
<xsl:otherwise><br />
<ul><br />
<xsl:for-each select="dishes/dish"><br />
<xsl:sort select="title"/><br />
<br />
<xsl:if test="availablefrom != '' and availableto != ''"><br />
<xsl:value-of select="substring(availablefrom,1,10)"/><br />
<xsl:text> kuni </xsl:text><br />
<xsl:value-of select="substring(availableto,1,10)"/><br />
</xsl:if><br />
<br />
<li><br />
<span style="font-weight:bold"><br />
<xsl:value-of select="title"/><br />
</span><br />
<xsl:text> - </xsl:text><br />
<xsl:value-of select="description"/><br />
<xsl:text> </xsl:text><br />
<span style="font-weight:bold"><br />
<xsl:if test="@glutenfree='true'"><br />
<xsl:text>G </xsl:text><br />
</xsl:if><br />
<xsl:if test="@lactosefree='true'"><br />
<xsl:text>L </xsl:text><br />
</xsl:if><br />
<xsl:if test="@vegan='true'"><br />
<xsl:text>V </xsl:text><br />
</xsl:if><br />
</span><br />
</li><br />
<br />
<xsl:for-each select="ingredients/ingredient"><br />
<xsl:value-of select="name"/><br />
<xsl:if test="position()!=last()"><br />
<xsl:text>, </xsl:text><br />
</xsl:if><br />
</xsl:for-each><br />
<br />
<p style="font-weight:bold"><br />
<xsl:text>Hind: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="@price!=''"><br />
<xsl:value-of select="@price"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>-</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
<xsl:text> / Päevapakkumise hind: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="@dailyprice!=''"><br />
<xsl:value-of select="@dailyprice"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>-</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
</p><br />
<br />
<div style="background-color:LightGray;"><br />
<xsl:text>Hinnang praele: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="rating/@ratingvalue!=''"><br />
<xsl:value-of select="rating/@ratingvalue"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>Ei ole veel hinnatud!</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
<br />
<br/><br />
<xsl:for-each select="rating/comments/comment"><br />
<xsl:value-of select="username"/><br />
<xsl:text>: </xsl:text><br />
<xsl:value-of select="commenttext"/><br />
<br/><br />
</xsl:for-each><br />
</div><br />
<br/><br />
</xsl:for-each><br />
</ul><br />
</xsl:otherwise><br />
</xsl:choose><br />
<br />
<div style="background-color:LightGray;"><br />
<xsl:text>Hinnang restoranile: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="rating/@ratingvalue!=''"><br />
<xsl:value-of select="rating/@ratingvalue"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>Ei ole veel hinnatud!</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
<br />
<br />
<br/><br />
<xsl:for-each select="rating/comments/comment"><br />
<xsl:value-of select="username"/><br />
<xsl:text>: </xsl:text><br />
<xsl:value-of select="commenttext"/><br />
<br/><br />
</xsl:for-each><br />
</div><br />
<br />
<p><br />
<xsl:text>*G - gluteenivaba, </xsl:text><br />
<xsl:text>L - laktoosivaba, </xsl:text><br />
<xsl:text>V - vegan </xsl:text><br />
</p><br />
<br />
</xsl:for-each><br />
</body><br />
</html><br />
</xsl:template><br />
</xsl:stylesheet></source><br />
<br />
=== XSLT(XML) ===<br />
<br />
XML'is kuvatakse elemendid ja atribuudid eesti keeles. Kuvatakse restorani andmed ja toidud, mille hinnang on 8 või rohkem punkti.<br />
<br />
<source><?xml version="1.0" encoding="utf-8" ?><br />
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"<br />
xmlns:msxsl="urn:schemas-microsoft-com:xslt" exclude-result-prefixes="msxsl"><br />
<xsl:output method="xml" indent="yes"/><br />
<br />
<xsl:template match="/restaurants"><br />
<restoranid><br />
<xsl:for-each select="restaurant"><br />
<restoran url="{@url}" telefon="{@contactnumber}" email="{@email}"><br />
<nimi><br />
<xsl:value-of select="name"/><br />
</nimi><br />
<aadress><br />
<postiaadress><br />
<xsl:value-of select="address/addressfirstline"/><br />
</postiaadress><br />
<linn><br />
<xsl:value-of select="address/locality"/><br />
</linn><br />
<indeks><br />
<xsl:value-of select="address/postcode"/><br />
</indeks><br />
<riik><br />
<xsl:value-of select="address/@country"/><br />
</riik><br />
</aadress><br />
<br />
<parimadToidud><br />
<xsl:choose><br />
<xsl:when test="menus/menu/dishes/dish"><br />
<xsl:for-each select="menus/menu/dishes/dish"><br />
<xsl:if test="rating/@ratingvalue &gt;= 8.0"><br />
<heaToit hinnang="{rating/@ratingvalue}" paevapakkumiseHind="{@dailyprice}" hind="{@price}" <br />
vegan="{@vegan}" laktoosivaba="{@lactosefree}" gluteenivaba="{@glutenfree}"><br />
<nimi><br />
<xsl:value-of select="title"/><br />
</nimi><br />
<kirjeldus><br />
<xsl:value-of select="description"/><br />
</kirjeldus><br />
</heaToit><br />
</xsl:if><br />
</xsl:for-each><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:for-each select="dishes/dish"><br />
<xsl:if test="rating/@ratingvalue &gt;= 8.0"><br />
<heaToit hinnang="{rating/@ratingvalue}" paevapakkumiseHind="{@dailyprice}" hind="{@price}" <br />
vegan="{@vegan}" laktoosivaba="{@lactosefree}" gluteenivaba="{@glutenfree}"><br />
<nimi><br />
<xsl:value-of select="title"/><br />
</nimi><br />
<kirjeldus><br />
<xsl:value-of select="description"/><br />
</kirjeldus><br />
</heaToit><br />
</xsl:if><br />
</xsl:for-each><br />
</xsl:otherwise><br />
</xsl:choose><br />
</parimadToidud><br />
</restoran><br />
</xsl:for-each><br />
</restoranid><br />
</xsl:template><br />
</xsl:stylesheet><br />
</source><br />
<br />
== Retsensioonid ==<br />
<br />
'''Veebiteenuse retsensioon:''' [https://wiki.itcollege.ee/index.php/Talk:MOT#Veebiteenuse_retsensensioon_by_meeskond_BeerPressure: Team MOT retsensioon]<br />
<br />
'''Klientrakenduse retsensioon:''' [https://wiki.itcollege.ee/index.php/Talk:Kuldneloojang#Klientrakenduse_retsensensioon_by_meeskond_BeerPressure: Team Kuldneloojang retsensioon]<br />
<br />
'''XML retsensioon:''' [https://wiki.itcollege.ee/index.php/Talk:MOT#XML_retsensioon_by_meeskond_BeerPressure: Team MOT retsensioon]<br />
<br />
== Logiraamat ==<br />
<br />
===07.02.2018===<br />
Gupi loomine ning suhtluskanali seadistamine<br />
<br />
=== 24.03.2018 ===<br />
Trello boardi loomine<br />
<br />
=== 25.03.2018 ===<br />
Wiki lehe loomine. Esimene tõsisem projekti koosolek ning tegevuskava paika panemine.<br />
<br />
=== 26.03.2018 ===<br />
<br />
Alustasime veebiteenuse analüüsiga ja funktsionaalsuse kirjeldamisega.<br />
<br />
=== 27.03.2018 ===<br />
Täiendasime veebiteenuse analüüsi.<br />
<br />
Esmase andmebaasi mudeli koostamine.<br />
<br />
Postitatud esimeste analüüsi arutelude põhjal valminud algne prototüüp.<br />
<br />
=== 30.03.2018 ===<br />
Valmis andmebaasimudel.<br />
<br />
=== 08.04.2018 ===<br />
Tehtud muudatused analüüsis vastavalt tagasisidele.<br />
<br />
=== 19.04.2018 ===<br />
Loodud projekti põhi koos domeenimudelitega. Projekt lisatud Githubi: https://github.com/sikumiku/TaisKohtApi<br />
<br />
=== 05-06.05.2018 ===<br />
Osalesime hackathonil. Lisatud controllerid, service'id koos vajalike kihtidega.<br />
<br />
=== 16.05.2018 ===<br />
Uuendatud andmebaasimudelit, DTO'sid.<br />
<br />
=== 18-19.05.2018 ===<br />
Lisatud klientrakendus, security, äriloogikat.<br />
<br />
=== 20.05.2018 ===<br />
Lisatud API dokumentatsioon.<br />
<br />
=== 22-24.05.2018 ===<br />
Uuendatud contoller'eid, service'id.<br />
<br />
=== 25-27.05.2018 ===<br />
Uuendatud contoller'eid, service'id. Lisatud kasutajate ja rollide kontrolle meetoditesse. Täiustatud klientrakendust. Swagger dokumentatsioon.<br />
<br />
=== 31.05-01.06.2018 ===<br />
Tegeletud XML, XSD ja XSLT failide loomisega.<br />
<br />
=== 01.06-03.06.2018 ===<br />
Tegeletud XML ja XSLT failide täiustamisega ja retsensioonide kirjutamisega.<br />
<br />
=== 05.06.2018 ===<br />
Lisatud XML retsensioon meeskonnale MOT<br />
<br />
=== 08.06.2018 ===<br />
Lisatud uus projekti .zip muudatustega ja täiendustega</div>
Saasma
https://wiki.itcollege.ee/index.php?title=BeerPressure&diff=131450
BeerPressure
2018-06-08T18:54:45Z
<p>Saasma: /* Logiraamat */</p>
<hr />
<div>== Meeskond ja rollid ==<br />
<br />
* Sigrid Aasma (arendaja)<br />
* Evelin Jõgi (arendaja)<br />
* Martin Kask (projektijuht, arendaja)<br />
* Marko Nõu (arendaja)<br />
<br />
== Idee ==<br />
'''Toidukohtade põhimenüüde ja päevapakkumiste teenus'''<br />
<br />
Soovime pakkuda toidukohtade põhimenüüde ja päevapakkumiste teenust. On olemas mitmeid kodulehti “päevapakkumised”, kus on kirjas toidukohtade päevapraed. Kuid tavaliselt sellistel lehtedel ei ole masinloetavaid andmeid ehk siis varianti, et saad saata API pihta mingi kuupäeva koos päevapraadidega andmete uuendamiseks ja saad sama API käest küsida tänaseid päevapraade. Andmeid võiks saada küsida restorani, kuupäeva, asukoha või otsisõna/otsisõnaosa põhiselt. Selline teenus lihtsustaks ka toidukohtade päevapakkumiste haldamist, kuna praegu peavad teenuse pakkujad vastavat informatsiooni uuendama mitmes erinevas kohas - nii erinevates portaalides, kui ka enda veebileheküljel. Samuti oleks toidukohtade kogu menüü haldamine ühes kohas.<br />
<br />
=== Esialgne prototüüp ===<br />
<br />
[[File:TäisKõhtProto1.mp4]]<br />
<br />
Esialgne prototüüp: [http://enos.itcollege.ee/~saasma/VR2/Proto/K%C3%B5htT%C3%A4is/#g=1&p=home navigeeritav versioon vol.1]<br />
<br />
=== Prototüübi muutus projekti käigus ===<br />
<br />
Prototüüp: [http://enos.itcollege.ee/~saasma/VR2/Proto/T%C3%A4isK%C3%B5ht/K%C3%B5htT%C3%A4is/#g=1&p=home navigeeritav versioon vol.2]<br />
<br />
== Kasutatav arendustehnoloogia ==<br />
<br />
Veebiteenuse loomisel kasutame ASP.NET Core tehnoloogiat ja kursusel õpitud arendusmustreid.<br />
<br />
Klientrakenduse loomisel kasutame Node.js + React'i.<br />
<br />
== Veebiteenuse analüüs ==<br />
Pakume toidukohtade põhimenüüde ja päevapakkumiste teenust, kuhu on kokku koondatud erinevate toidukohtade menüüd üle Eesti. Põhimenüü alla kuuluvad pikaajalised menüüd, mis kehtivad püsivalt, hooajaliselt või mingil konkreetsel nädalapäeval. Päevapakkumiste alla kuuluvad konkreetse kuupäevaga seotud päevapakkumised. Päevapakkumiste korral kuvatakse lisainfona, kas pakkumine kehtib mingis konkreetses ajavahemikus või kogu toidukoha lahtioleku aja.<br />
<br />
Eesmärk on koguda ühte kohta kokku erinevate toidukohtade menüüd ja päevapakkumised, et kliendid saaksid mugavalt ja kiiresti oma valikuid teha. Kliendid käivad enamasti päevapakkumisi söömas lõuna ajal ja selleks ettenähtud aeg on piiratud. Sellepärast on oluline, et klient saaks teha oma valiku võimalikult kiiresti. Tänu loodavale veebiteenusele ei pea kliendid käima erinevates portaalides, et tutvuda erinevate toidukohtade pakkumistega. Kuna teenust on mugav kasutada ja klient saab oma valiku kiiresti tehtud, siis tõenäoliselt teeb klient valiku selles keskkonnas olevate toiduasutuste seast. Lisaks võimaldab teenus toiduasutustel paika panna oma pikaajalisem põhimenüü ning seda rakenduses ja võimalusel ka söögikohas kuvada. Sellepärast on ka toidukohtade huvi antud keskkonnas üleval olla ja meiega oma andmeid jagada, sest see suurendab nende klientuuri ning muudab oma menüü haldamise kergemaks.<br />
<br />
Veebiteenuse loomisel lähtume eelkõige sellest, et kliendil oleks teenust mugav kasutada ja ta saaks oma valiku kiiresti tehtud. Arvestame, et kliendid on erinevad. Mõni eelistab mõnda kindlat toidukohta, sel juhul saab ta valida oma soovitud kohad ja võrrelda nende kohtade tänase päeva pakkumisi ning menüüsid. Mõnele inimesele on oluline pakutav söök ja ta eelistab pakkumist otsida prae nimetuses oleva sõna või sõnaosa järgi ning lähtuda seejärel valiku tegemisel toidukoha keskmisest hindest või toidu hinnast. Mõne kliendi jaoks on oluline hind ja selleks, et oma valikut teha sobivas hinnavahemikus on tal võimalik sisestada maksimum hinna piirang. Kindlasti on antud teenuse juures kõikide klientide jaoks oluline päevapakkumiste asukohapõhine eristatus. Kliendid, kes soovivad oma konto luua, võivad oma eelistatud valikud meelde jätta ja järgmisel korral kuvatakse neid talle automaatselt.<br />
<br />
Teenuse must-have funktsionaalsus tagab teenuse toimimise ja põhifunktsioonid. Teenuse nice-to-have funktsionaalsus annab rakendusele lisandväärtust.<br />
<br />
Arvestades pakutava teenusega, siis näeme, et aktiivseim teenuse kasutamine võib olla tööpäevadel vahemikus 11.00-15.00, kui kliendid tutvuvad päevapakkumistega. Teenus peab tekkivale koormusele vastu pidama.<br />
<br />
Teenuse pakkumine peab olema turvaline. Selle tagamiseks tuleb sisestatavaid andmeid valideerida ja andmebaasi sisestavate andmete mahtu piirata. Toidukohtade sisestatud andmed peavad olema kaitstud, et toitude koostised ei saaks avalikuks. Põhjendatud juhtudel on võimalik kasutajaid lukku panna.<br />
<br />
== Kasutajad ==<br />
<br />
<br />
* Admin - lehe administraator, kellel on õigus lehte, kasutajaid ja nende õiguseid hallata. Tema huvi on, et teenus toimiks tõrgeteta.<br />
* Toiduasutus (tasuta kasutaja) - saab hoida lehel ühte põhimenüüd ja päevapakkumisi.<br />
* Toiduasutus (tellimusega kasutaja) - saab hoida lehel piiramatu arv põhimenüüsid ja päevapakkumisi.<br />
Toiduasutused on teenusest huvitatud, et nende menüüde haldamine oleks kerge ja mugav ning nad saaksid oma klientide arvu suurendada.<br />
* Külastaja - klient, kes valib söögikohta. Tema on huvitatud eelkõige sellest, et teenust saaks kasutada mugavalt ja kiirelt ning toidukohtade valik oleks võimalikult suur.<br />
<br />
== Rakenduse must-have funktsionaalsus ==<br />
<br />
* Kasutajad saavad sisse logida<br />
* Kasutajatel on erinevad rollid: admin, toidukoht (tasuta ja tasulise tellimusega), klient<br />
* Kasutajate arvepidamine kasutajate lõikes:<br />
** sisselogimise kuupäev, kellaaeg<br />
** pakkumiste lisamine<br />
** pakkumiste muutmine<br />
** pakkumiste kustutamine<br />
** õiguste kehtimise periood (tasuta ja tellimusega toidukoht)<br />
** pakkumistele klikkimise arv<br />
* Kasutajaid on võimalik hallata:<br />
** kasutajale õiguste andmine (menüüde arvu suurendamine, tellimusega toidukohal), rolli määramine<br />
** Kasutajat on võimalik piirata: õiguseid piirata (piiratud menüüde arv, tasuta liitunud toidukohal) ja lukku panna<br />
* Päevapakkumisi/menüüsid saab küsida: <br />
** toidukoha järgi, <br />
** kuupäeva põhiselt (ainult päevapakkumisi), <br />
** asukoha põhiselt,<br />
** toidu nimetuses esineva otsisõna/otsisõna osa põhiselt,<br />
** hinna põhiselt (max hinna piirang).<br />
* Klientrakenduses realiseeritakse CRUD meetodid (menüüsid/päevapakkumisi saab sisestada, lugeda, uuendada, kustutada)<br />
* Toidukohale saab anda hindeid ja kuvatakse keskmist hinnet.<br />
* Toidule saab anda hindeid ja kuvatakse keskmist hinnet.<br />
<br />
== Nice-to-have funktsionaalsus ==<br />
<br />
* Info selle kohta, kas päevapakkumine on otsas<br />
* Päevapakkumisi/menüüsid saab kommenteerida ja neid kommentaare kuvatakse avalikult.<br />
* Söögikohtade kodulehtedelt otsimise script, mis genereerib juba olemasolevate kodulehtede baasil päevamenüüsid.<br />
* Toiduvaliku piiramine allergeenide/vegan/jms. koostisosade põhiselt.<br />
* Aruandlused ja võrdlused toidukohtadele, et võrrelda end konkurentidega.<br />
* Teenus soovitab toidukohtadele nende varasemate päevapraadide populaarsuse alusel uue nädala menüüd.<br />
* Erinevad toidukohtade/toitude pingeread klientidele, et anda valikuteks ideid.<br />
* Soovitused klientidele, mida teised kliendid sarnaste eelistustega on veel valinud.<br />
<br />
== Andmebaasi ülesehitus - projekti algus ==<br />
<br />
[[File: BeerPressureAndmebaasimudel.png]]<br />
<br />
== Andmebaasi ülesehitus - projekti lõpp ==<br />
<br />
[[File: Ta2isKo6ht-DB-FINAL.png]]<br />
<br />
== Projekti repository ==<br />
<br />
https://github.com/sikumiku/TaisKohtApi<br />
<br />
Zip fail saadaval 27.05 seisuga: <br />
(master branchi viimane commit esitamise ajal)<br />
https://github.com/sikumiku/TaisKohtApi/archive/61438e187a1a972410c8a3bc6274d69489d00aa6.zip<br />
<br />
Uuendatud .zip fail 08.06 seisuga: http://enos.itcollege.ee/~saasma/VR2/TaisKoht/<br />
<br />
== API v1 dokumentatsioon ==<br />
<br />
===Security===<br />
'''POST /api/account/register'''<br />
<source><br />
Params: RegisterViewModel registerViewModel<br />
<br />
Returns: token<br />
</source><br />
<br />
'''POST /api/account/login'''<br />
<source> <br />
Params: LoginViewModel model<br />
<br />
Returns: token<br />
</source><br />
<br />
'''POST /api/account/logout'''<br />
<source> <br />
Params: -<br />
<br />
Returns: -<br />
</source><br />
<br />
===Accounts===<br />
'''GET /api/v1/accounts/getAllUsersInRole'''<br />
<source> <br />
Params: string role<br />
<br />
Returns: List<UserDTO><br />
</source><br />
<br />
'''GET /api/v1/accounts/{id}'''<br />
<source> <br />
Params: string id<br />
<br />
Returns: UserDTO<br />
</source><br />
<br />
'''PUT /api/v1/accounts/{id}'''<br />
<source> <br />
Params: string id, UpdateUserDTO userDTO<br />
<br />
Returns: -<br />
</source><br />
<br />
'''POST /api/v1/accounts/addRole'''<br />
<source> <br />
Params: string role<br />
<br />
Returns: -<br />
</source><br />
<br />
'''POST /api/v1/accounts/addRoleToUser'''<br />
<source> <br />
Params: string role, string userId<br />
<br />
Returns: UserDTO<br />
</source><br />
<br />
'''DELETE /api/v1/accounts/deactivate/{id}'''<br />
<source> <br />
Params: string id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Promotions===<br />
'''GET /api/v1/promotions '''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<PromotionDTO> <br />
</source><br />
<br />
'''GET /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: PromotionDTO<br />
</source><br />
<br />
'''POST /api/v1/promotions'''<br />
<source> <br />
Params: PromotionDTO promotionDTO<br />
<br />
Returns: PromotionDTO newPromotion<br />
</source><br />
<br />
'''PUT /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id, PromotionDTO promotionDTO<br />
<br />
Returns: PromotionDTO updatedPromotion<br />
</source><br />
<br />
'''DELETE /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Restaurants===<br />
'''GET /api/v1/restaurants'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<SimpleRestaurantDTO><br />
</source><br />
<br />
'''GET /api/v1/restaurants/owner'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<SimpleRestaurantDTO><br />
</source><br />
<br />
'''GET /api/v1/restaurants/search?name=th'''<br />
<source> <br />
Params: string name<br />
<br />
Returns: List<SimpleRestaurantDTO> result<br />
</source><br />
<br />
'''GET /api/v1/restaurants/top'''<br />
<source> <br />
Params: int amount<br />
<br />
Returns: List<SimpleRestaurantDTO> result<br />
</source><br />
<br />
'''GET /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: RestaurantDTO r<br />
</source><br />
<br />
'''POST /api/v1/restaurants/addUserToRestaurant'''<br />
<source> <br />
Params: int id, string userId<br />
<br />
Returns: -<br />
</source><br />
<br />
'''POST /api/v1/restaurants'''<br />
<source> <br />
Params: PostRestaurantDTO restaurantDTO<br />
<br />
Returns: RestaurantDTO newRestaurant<br />
</source><br />
<br />
'''PUT /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id, PostRestaurantDTO restaurantDTO<br />
<br />
Returns: PostRestaurantDTO updatedRestaurantDTO<br />
</source><br />
<br />
'''DELETE /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Menus===<br />
'''GET /api/v1/menus'''<br />
<source><br />
Params: -<br />
<br />
Returns: List<MenuDTO><br />
</source><br />
<br />
'''GET /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: MenuDTO menuDTO<br />
</source><br />
<br />
'''POST /api/v1/menus'''<br />
<source> <br />
Params: PostMenuDTO menuDTO<br />
<br />
Returns: MenuDTO newMenu<br />
</source><br />
<br />
'''PUT /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id, PostMenuDTO menuDTO<br />
<br />
Returns: MenuDTO updatedMenu<br />
</source><br />
<br />
'''PUT api/v1/Menus/{id}/Dishes'''<br />
<source> <br />
Params: int menuId, int[] dishIds<br />
<br />
Returns: -<br />
</source><br />
<br />
'''DELETE /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Dishes===<br />
'''GET /api/v1/dishes'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<DishDTO><br />
</source><br />
<br />
'''GET /api/v1/dishes/daily'''<br />
<source> <br />
Params: bool vegan, bool glutenFree, bool lactoseFree<br />
<br />
Returns: List<SimpleDishDTO> result<br />
</source><br />
<br />
'''GET: api/v1/dishes/search?title=th&priceLimit=null'''<br />
<source> <br />
Params: string title, decimal? priceLimit<br />
<br />
Returns: List<DishDTO> result<br />
</source><br />
<br />
'''GET /api/v1/dishes/top'''<br />
<source> <br />
Params: int amount<br />
<br />
Returns: List<DishDTO> result<br />
</source><br />
<br />
'''GET /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: DishDTO dishDTO<br />
</source><br />
<br />
'''POST /api/v1/dishes'''<br />
<source> <br />
Params: PostDishDTO dishDTO<br />
<br />
Returns: DishDTO newDish<br />
</source><br />
<br />
'''PUT /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id, PostDishDTO dishDTO<br />
<br />
Returns: DishDTO updatedDish<br />
</source><br />
<br />
'''PUT api/v1/Dishes/{id}/Ingredients'''<br />
<source> <br />
Params: int dishId, PostIngredientForDishDTO[] ingredients<br />
<br />
Returns: -<br />
</source><br />
<br />
'''DELETE /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Ingredients===<br />
'''GET /api/v1/ingredients'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<IngredientDTO><br />
</source><br />
<br />
'''GET /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: IngredientDTO i<br />
</source><br />
<br />
'''POST /api/v1/ingredients'''<br />
<source> <br />
Params: PostIngredientDTO ingredientDTO<br />
<br />
Returns: IngredientDTO newIngredient<br />
</source><br />
<br />
'''PUT /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id, PostIngredientDTO ingredientDTO<br />
<br />
Returns: IngredientDTO updatedIngredient<br />
</source><br />
<br />
'''DELETE /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Ratings===<br />
'''GET /api/v1/ratings'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<RatingLogDTO><br />
</source><br />
<br />
'''GET /api/v1/ratings/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: RatingLogDTO dto<br />
</source><br />
<br />
'''POST /api/v1/ratings'''<br />
<source> <br />
Params: RatingLogForEntityDTO ratingDTO<br />
<br />
Returns: RatingLogDTO newRating<br />
</source><br />
<br />
'''PUT api/v1/ratings/{id}'''<br />
<source> <br />
Params: int id, RatingLogForEntityDTO ratingDTO<br />
<br />
Returns: RatingLogDTO updatedRating<br />
</source><br />
<br />
'''DELETE api/v1/ratings/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===RequestLog===<br />
'''GET: api/v1/usageData/{userId}'''<br />
<source> <br />
Params: string userId<br />
<br />
Returns: List<RequestLogDTO><br />
</source><br />
<br />
== Lõpptoote kasutusjuhend ==<br />
<br />
* Kloonida kohalikku arvutisse repository aadressilt [https://github.com/sikumiku/TaisKohtApi https://github.com/sikumiku/TaisKohtApi]<br />
* Installida NodeJS<br />
* <source>npm install webpack -g</source><br />
* <source>npm install -cli -g</source><br />
* Frontend rakenduse kasutamiseks valida Startup meetoditest IIS Express, veebiteenuse ja Swaggeri kasutamiseks käivitada Api Swagger<br />
* Esimese admin kasutaja loomiseks tuleb kasutaja registreerida admin@gmail.com e-mailiga<br />
<br />
== XML/XSD/XSLT ==<br />
<br />
=== XML ===<br />
<br />
<source><?xml version="1.0" encoding="utf-8" ?><br />
<restaurants><br />
<restaurant id="1" url="https://kuuspelmeeni.ee" contactnumber="507783342" email="kuuspelmeeni@gmail.com"><br />
<name><![CDATA[Kuus Pelmeeni]]></name><br />
<menus><br />
<menu id="1" repetitioninterval="30"><br />
<name><![CDATA[Päevamenüü]]></name><br />
<activefrom>2018-05-27T12:00:00</activefrom><br />
<activeto>2018-05-28T12:00:00</activeto><br />
<dishes><br />
<dish id="1" vegan="false" lactosefree="false" glutenfree="false" daily="true" kcal="550" dailyprice="4"><br />
<title><![CDATA[8 pelmeeni]]></title><br />
<description><![CDATA[8 pelmeeni 6 asemel serveeritud tervisliku koguse hapukoore ja tilliga]]></description><br />
<availablefrom>2018-05-27T12:00:00</availablefrom><br />
<availableto>2018-05-28T12:00:00</availableto><br />
<ingredients><br />
<ingredient id="1" amountunit="g"><br />
<name>Sealiha</name><br />
<description>Rakvere sealiha</description><br />
</ingredient><br />
<ingredient id="2" amountunit="g"><br />
<name>Hapukoor</name><br />
<description>Alma hapukoor</description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="9"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Parim päevaroog viimasel ajal.]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
</comments><br />
</rating><br />
<promotion id="1" type="visual" classname="bold-red-border-2px"><br />
<name>2px red border</name><br />
<description><![CDATA[Displays a 2px wide red border around the component that is promoted.]]></description><br />
<validto>2018-06-25T12:00:00</validto><br />
</promotion><br />
</dish><br />
<dish id="2" vegan="true" lactosefree="true" glutenfree="true" daily="true" kcal="320" price="4"><br />
<title><![CDATA[Kurgisalat]]></title><br />
<description><![CDATA[Erinevatel viisidel töödeldud kurk serveeritud koos jõhvikatega. Tervislik amps.]]></description><br />
<availablefrom>2018-05-27T12:00:00</availablefrom><br />
<availableto>2018-05-28T12:00:00</availableto><br />
<ingredients/><br />
<rating ratingvalue="4"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Jäin veel väga näljaseks peale selle söömist.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
</dishes><br />
</menu><br />
<menu id="2"><br />
<name><![CDATA[Põhimenüü]]></name><br />
<dishes><br />
<dish id="4" vegan="false" lactosefree="false" glutenfree="false" daily="false" kcal="550" price="5"><br />
<title><![CDATA[6 pelmeeni]]></title><br />
<description><![CDATA[6 pelmeeni serveeritud tervisliku koguse hapukoore ja tilliga]]></description><br />
<ingredients><br />
<ingredient id="1" amountunit="g"><br />
<name>Sealiha</name><br />
<description>Rakvere sealiha</description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="9.5"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Käin seda iga päev söömas.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Parim toit selles restoranis.]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
<dish id="5" vegan="false" lactosefree="false" glutenfree="true" daily="false" kcal="460" price="3.8"><br />
<title><![CDATA[Kartulisalat]]></title><br />
<description><![CDATA[Sinki sisaldav traditsiooniline kartulisalat.]]></description><br />
<ingredients/><br />
</dish><br />
<dish id="6" vegan="false" lactosefree="false" glutenfree="false" daily="false" kcal="610" price="3.9"><br />
<title><![CDATA[Šokolaadikook]]></title><br />
<description><![CDATA[Ahvatlev glasuuritud šokolaadikook.]]></description><br />
<ingredients/><br />
<rating ratingvalue="7.8"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Šokolaadikooki on keeruline metsa keerata.]]></commenttext><br />
<username>mutikas3</username><br />
<userid>3a29b94a-3f17-469d-a44d-f7d85e98dd3e</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
</dishes><br />
</menu><br />
</menus><br />
<dishes/><br />
<address id="1" country="Eesti"><br />
<addressfirstline>Tatari 12</addressfirstline><br />
<locality>Tallinn</locality><br />
<postcode>10132</postcode><br />
<region>Harjumaa</region><br />
</address><br />
<promotion/><br />
<rating ratingvalue="7.5"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Parim restoran üldse!]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Ma sain ainult 5 pelmeeni. Ootasin kuute.]]></commenttext><br />
<username>kyllikekallike1</username><br />
<userid>6af271dd-0e11-4ae6-98be-111762664318</userid><br />
</comment><br />
</comments><br />
</rating><br />
</restaurant><br />
<restaurant id="2" url="https://kolmkokka.ee" contactnumber="6522351" email="kolmkokka@gmail.com"><br />
<name><![CDATA[Kolm kokka]]></name><br />
<menus/><br />
<dishes><br />
<dish id="7" vegan="false" lactosefree="true" glutenfree="false" daily="false" kcal="470" price="14"><br />
<title><![CDATA[Ahjulõhe juurikatega]]></title><br />
<description><![CDATA[Ahjulõhe serveeritud püreestatud porgandite ja lillkapsaga.]]></description><br />
<ingredients><br />
<ingredient id="11" amountunit="tk" amount="1"><br />
<name>Ahjulõhe</name><br />
<description><![CDATA[Värske ahjulõhe]]></description><br />
</ingredient><br />
<ingredient id="12" amountunit="g"><br />
<name>Püreestatud porgand</name><br />
<description><![CDATA[Eesti porgand, mis on kergelt püreestatud]]></description><br />
</ingredient><br />
<ingredient id="13" amountunit="g"><br />
<name>Püreestatud lillkapsas</name><br />
<description><![CDATA[Eesti lillkapsas, mis on kergelt püreestatud ja maitsestatud]]></description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="8.9"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Kindlasti minu üks lemmikuid.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Pole midagi halba öelda.]]></commenttext><br />
<username>tiiuviiu</username><br />
<userid>0730a7b7-3a9c-4e26-962f-da9a8daeab8a</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
<dish id="8" vegan="true" lactosefree="true" glutenfree="true" daily="true" dailyprice="5"><br />
<title><![CDATA[Ingverisupp]]></title><br />
<description><![CDATA[Ingveriga vürtsistatud ingverisupp, mis viib keele alla.]]></description><br />
<availablefrom>2018-05-25T12:00:00</availablefrom><br />
<availableto>2018-06-25T12:00:00</availableto><br />
<ingredients><br />
<ingredient id="14" amountunit="g" amount="20"><br />
<name>Ingver</name><br />
<description><![CDATA[Tükeldatud ingver]]></description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="6"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Liiga palju ingverit.]]></commenttext><br />
<username>kyllikekallike1</username><br />
<userid>6af271dd-0e11-4ae6-98be-111762664318</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
<dish id="9" vegan="false" lactosefree="false" glutenfree="true" daily="false" kcal="340" price="4.5"><br />
<title><![CDATA[Apelsinijäätis]]></title><br />
<description><![CDATA[Apelsinimaitseline jäätis serveeritud riivitud apelsinikoorega.]]></description><br />
<ingredients/><br />
<rating ratingvalue="8"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Väga huvitav magustoit, prooviks veel.]]></commenttext><br />
<username>mutikas3</username><br />
<userid>3a29b94a-3f17-469d-a44d-f7d85e98dd3e</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Üks mu lemmikuid magustoite.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
</dishes><br />
<address id="2" country="Eesti"><br />
<addressfirstline>Laia 12</addressfirstline><br />
<locality>Tallinn</locality><br />
<postcode>13022</postcode><br />
<region>Harjumaa</region><br />
</address><br />
<promotion/><br />
<rating ratingvalue="8.1"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Hinnad on natuke liiga kallid minu jaoks, aga toit om maitsev.]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Ma kindlasti telliks kala uuesti. Väga mahlakas oli.]]></commenttext><br />
<username>kyllikekallike1</username><br />
<userid>6af271dd-0e11-4ae6-98be-111762664318</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Asukoht oli päris tore. Miljöö ka.]]></commenttext><br />
<username>mutikas3</username><br />
<userid>3a29b94a-3f17-469d-a44d-f7d85e98dd3e</userid><br />
</comment><br />
</comments><br />
</rating><br />
</restaurant><br />
</restaurants></source><br />
<br />
=== XSD ===<br />
<br />
<source><?xml version="1.0" encoding="utf-8"?><br />
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema"><br />
<xs:element name="restaurants"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="restaurant"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="menus"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="menu"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="activefrom" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="activeto" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="dishes"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="dish"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="title" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="availablefrom" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="availableto" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="servetime" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="ingredients"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="ingredient"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="amountunit" type="xs:string" use="required" /><br />
<xs:attribute name="amount" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="rating" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="comments"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="comment"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="commenttext" type="xs:string" /><br />
<xs:element name="username" type="xs:string" /><br />
<xs:element name="userid" type="xs:string" /><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="ratingvalue" type="xs:decimal" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="validto" type="xs:dateTime" minOccurs="0" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="type" type="xs:string" use="required" /><br />
<xs:attribute name="classname" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="vegan" type="xs:boolean" use="optional" /><br />
<xs:attribute name="lactosefree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="glutenfree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="daily" type="xs:boolean" use="optional" /><br />
<xs:attribute name="kcal" type="xs:int" use="optional" /><br />
<xs:attribute name="weightg" type="xs:decimal" use="optional" /><br />
<xs:attribute name="price" type="xs:decimal" use="optional" /><br />
<xs:attribute name="dailyprice" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="validto" type="xs:dateTime" minOccurs="0" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="type" type="xs:string" use="required" /><br />
<xs:attribute name="classname" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="repetitioninterval" type="xs:int" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="dishes"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="dish"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="title" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="availablefrom" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="availableto" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="servetime" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="ingredients"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="ingredient"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="amountunit" type="xs:string" use="required" /><br />
<xs:attribute name="amount" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="rating"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="comments"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="comment"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="commenttext" type="xs:string" /><br />
<xs:element name="username" type="xs:string" /><br />
<xs:element name="userid" type="xs:string" /><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="ratingvalue" type="xs:decimal" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="validto" type="xs:dateTime" minOccurs="0" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="type" type="xs:string" use="required" /><br />
<xs:attribute name="classname" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="vegan" type="xs:boolean" use="optional" /><br />
<xs:attribute name="lactosefree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="glutenfree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="daily" type="xs:boolean" use="optional" /><br />
<xs:attribute name="kcal" type="xs:int" use="optional" /><br />
<xs:attribute name="weightg" type="xs:decimal" use="optional" /><br />
<xs:attribute name="price" type="xs:decimal" use="optional" /><br />
<xs:attribute name="dailyprice" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="address"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="addressfirstline" type="xs:string" /><br />
<xs:element name="locality" type="xs:string" /><br />
<xs:element name="postcode" type="xs:string" /><br />
<xs:element name="region" type="xs:string" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="country" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion" /><br />
<xs:element name="rating" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="comments"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="comment"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="commenttext" type="xs:string" /><br />
<xs:element name="username" type="xs:string" /><br />
<xs:element name="userid" type="xs:string" /><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="ratingvalue" type="xs:decimal" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="url" type="xs:string" use="required" /><br />
<xs:attribute name="contactnumber" type="xs:string" use="required" /><br />
<xs:attribute name="email" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:schema></source><br />
<br />
=== XSLT(HTML) ===<br />
<br />
<source><?xml version="1.0" encoding="utf-8" ?><br />
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:msxsl="urn:schemas-microsoft-com:xslt" exclude-result-prefixes="msxsl"><br />
<xsl:output method="html" indent="yes"/><br />
<xsl:template match="/restaurants"><br />
<html><br />
<head><br />
<title>Täis Kõht</title><br />
</head><br />
<body><br />
<xsl:for-each select="restaurant"><br />
<h1 style="color:DodgerBlue"><br />
<xsl:value-of select="name"/><br />
</h1><br />
<div><br />
<xsl:value-of select="@url"/><br />
</div><br />
<div><br />
<xsl:text>Kontakt number: </xsl:text><br />
<xsl:value-of select="@contactnumber"/><br />
</div><br />
<div><br />
<xsl:text>email: </xsl:text><br />
<xsl:value-of select="@email"/><br />
</div><br />
<div><br />
<xsl:text>Aadress: </xsl:text><br />
<xsl:value-of select="address/addressfirstline"/><br />
<xsl:text>, </xsl:text><br />
<xsl:value-of select="address/locality"/><br />
<xsl:text>, </xsl:text><br />
<xsl:value-of select="address/postcode"/><br />
<xsl:text>, </xsl:text><br />
<xsl:value-of select="address/@country"/><br />
</div><br />
<br />
<xsl:choose><br />
<xsl:when test="menus/menu"><br />
<xsl:for-each select="menus/menu"><br />
<xsl:sort select="name"/><br />
<h3><br />
<xsl:value-of select="name"/><br />
</h3><br />
<br />
<xsl:if test="activefrom != '' and activeto != ''"><br />
<xsl:text> </xsl:text><br />
<xsl:value-of select="substring(activefrom,1,10)"/><br />
<xsl:text> kuni </xsl:text><br />
<xsl:value-of select="substring(activeto,1,10)"/><br />
</xsl:if><br />
<br />
<ul><br />
<xsl:for-each select="dishes/dish"><br />
<xsl:sort select="title"/><br />
<br />
<xsl:if test="availablefrom != '' and availableto != ''"><br />
<xsl:value-of select="substring(availablefrom,1,10)"/><br />
<xsl:text> kuni </xsl:text><br />
<xsl:value-of select="substring(availableto,1,10)"/><br />
</xsl:if><br />
<br />
<li><br />
<span style="font-weight:bold"><br />
<xsl:value-of select="title"/><br />
</span><br />
<xsl:text> - </xsl:text><br />
<xsl:value-of select="description"/><br />
<xsl:text> </xsl:text><br />
<span style="font-weight:bold"><br />
<xsl:if test="@glutenfree='true'"><br />
<xsl:text>G </xsl:text><br />
</xsl:if><br />
<xsl:if test="@lactosefree='true'"><br />
<xsl:text>L </xsl:text><br />
</xsl:if><br />
<xsl:if test="@vegan='true'"><br />
<xsl:text>V </xsl:text><br />
</xsl:if><br />
</span><br />
</li><br />
<br />
<xsl:for-each select="ingredients/ingredient"><br />
<xsl:value-of select="name"/><br />
<xsl:if test="position()!=last()"><br />
<xsl:text>, </xsl:text><br />
</xsl:if><br />
</xsl:for-each><br />
<br />
<p style="font-weight:bold"><br />
<xsl:text>Hind: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="@price!=''"><br />
<xsl:value-of select="@price"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>-</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
<xsl:text> / Päevapakkumise hind: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="@dailyprice!=''"><br />
<xsl:value-of select="@dailyprice"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>-</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
</p><br />
<br />
<div style="background-color:LightGray;"><br />
<xsl:text>Hinnang praele: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="rating/@ratingvalue!=''"><br />
<xsl:value-of select="rating/@ratingvalue"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>Ei ole veel hinnatud!</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
<br />
<br/><br />
<xsl:for-each select="rating/comments/comment"><br />
<xsl:value-of select="username"/><br />
<xsl:text>: </xsl:text><br />
<xsl:value-of select="commenttext"/><br />
<br/><br />
</xsl:for-each><br />
</div><br />
<br/><br />
</xsl:for-each><br />
</ul><br />
</xsl:for-each><br />
</xsl:when><br />
<xsl:otherwise><br />
<ul><br />
<xsl:for-each select="dishes/dish"><br />
<xsl:sort select="title"/><br />
<br />
<xsl:if test="availablefrom != '' and availableto != ''"><br />
<xsl:value-of select="substring(availablefrom,1,10)"/><br />
<xsl:text> kuni </xsl:text><br />
<xsl:value-of select="substring(availableto,1,10)"/><br />
</xsl:if><br />
<br />
<li><br />
<span style="font-weight:bold"><br />
<xsl:value-of select="title"/><br />
</span><br />
<xsl:text> - </xsl:text><br />
<xsl:value-of select="description"/><br />
<xsl:text> </xsl:text><br />
<span style="font-weight:bold"><br />
<xsl:if test="@glutenfree='true'"><br />
<xsl:text>G </xsl:text><br />
</xsl:if><br />
<xsl:if test="@lactosefree='true'"><br />
<xsl:text>L </xsl:text><br />
</xsl:if><br />
<xsl:if test="@vegan='true'"><br />
<xsl:text>V </xsl:text><br />
</xsl:if><br />
</span><br />
</li><br />
<br />
<xsl:for-each select="ingredients/ingredient"><br />
<xsl:value-of select="name"/><br />
<xsl:if test="position()!=last()"><br />
<xsl:text>, </xsl:text><br />
</xsl:if><br />
</xsl:for-each><br />
<br />
<p style="font-weight:bold"><br />
<xsl:text>Hind: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="@price!=''"><br />
<xsl:value-of select="@price"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>-</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
<xsl:text> / Päevapakkumise hind: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="@dailyprice!=''"><br />
<xsl:value-of select="@dailyprice"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>-</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
</p><br />
<br />
<div style="background-color:LightGray;"><br />
<xsl:text>Hinnang praele: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="rating/@ratingvalue!=''"><br />
<xsl:value-of select="rating/@ratingvalue"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>Ei ole veel hinnatud!</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
<br />
<br/><br />
<xsl:for-each select="rating/comments/comment"><br />
<xsl:value-of select="username"/><br />
<xsl:text>: </xsl:text><br />
<xsl:value-of select="commenttext"/><br />
<br/><br />
</xsl:for-each><br />
</div><br />
<br/><br />
</xsl:for-each><br />
</ul><br />
</xsl:otherwise><br />
</xsl:choose><br />
<br />
<div style="background-color:LightGray;"><br />
<xsl:text>Hinnang restoranile: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="rating/@ratingvalue!=''"><br />
<xsl:value-of select="rating/@ratingvalue"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>Ei ole veel hinnatud!</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
<br />
<br />
<br/><br />
<xsl:for-each select="rating/comments/comment"><br />
<xsl:value-of select="username"/><br />
<xsl:text>: </xsl:text><br />
<xsl:value-of select="commenttext"/><br />
<br/><br />
</xsl:for-each><br />
</div><br />
<br />
<p><br />
<xsl:text>*G - gluteenivaba, </xsl:text><br />
<xsl:text>L - laktoosivaba, </xsl:text><br />
<xsl:text>V - vegan </xsl:text><br />
</p><br />
<br />
</xsl:for-each><br />
</body><br />
</html><br />
</xsl:template><br />
</xsl:stylesheet></source><br />
<br />
=== XSLT(XML) ===<br />
<br />
XML'is kuvatakse elemendid ja atribuudid eesti keeles. Kuvatakse restorani andmed ja toidud, mille hinnang on 8 või rohkem punkti.<br />
<br />
<source><?xml version="1.0" encoding="utf-8" ?><br />
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"<br />
xmlns:msxsl="urn:schemas-microsoft-com:xslt" exclude-result-prefixes="msxsl"><br />
<xsl:output method="xml" indent="yes"/><br />
<br />
<xsl:template match="/restaurants"><br />
<restoranid><br />
<xsl:for-each select="restaurant"><br />
<restoran url="{@url}" telefon="{@contactnumber}" email="{@email}"><br />
<nimi><br />
<xsl:value-of select="name"/><br />
</nimi><br />
<aadress><br />
<postiaadress><br />
<xsl:value-of select="address/addressfirstline"/><br />
</postiaadress><br />
<linn><br />
<xsl:value-of select="address/locality"/><br />
</linn><br />
<indeks><br />
<xsl:value-of select="address/postcode"/><br />
</indeks><br />
<riik><br />
<xsl:value-of select="address/@country"/><br />
</riik><br />
</aadress><br />
<br />
<parimadToidud><br />
<xsl:choose><br />
<xsl:when test="menus/menu/dishes/dish"><br />
<xsl:for-each select="menus/menu/dishes/dish"><br />
<xsl:if test="rating/@ratingvalue &gt;= 8.0"><br />
<heaToit hinnang="{rating/@ratingvalue}" paevapakkumiseHind="{@dailyprice}" hind="{@price}" <br />
vegan="{@vegan}" laktoosivaba="{@lactosefree}" gluteenivaba="{@glutenfree}"><br />
<nimi><br />
<xsl:value-of select="title"/><br />
</nimi><br />
<kirjeldus><br />
<xsl:value-of select="description"/><br />
</kirjeldus><br />
</heaToit><br />
</xsl:if><br />
</xsl:for-each><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:for-each select="dishes/dish"><br />
<xsl:if test="rating/@ratingvalue &gt;= 8.0"><br />
<heaToit hinnang="{rating/@ratingvalue}" paevapakkumiseHind="{@dailyprice}" hind="{@price}" <br />
vegan="{@vegan}" laktoosivaba="{@lactosefree}" gluteenivaba="{@glutenfree}"><br />
<nimi><br />
<xsl:value-of select="title"/><br />
</nimi><br />
<kirjeldus><br />
<xsl:value-of select="description"/><br />
</kirjeldus><br />
</heaToit><br />
</xsl:if><br />
</xsl:for-each><br />
</xsl:otherwise><br />
</xsl:choose><br />
</parimadToidud><br />
</restoran><br />
</xsl:for-each><br />
</restoranid><br />
</xsl:template><br />
</xsl:stylesheet><br />
</source><br />
<br />
== Retsensioonid ==<br />
<br />
'''Veebiteenuse retsensioon:''' [https://wiki.itcollege.ee/index.php/Talk:MOT#Veebiteenuse_retsensensioon_by_meeskond_BeerPressure: Team MOT retsensioon]<br />
<br />
'''Klientrakenduse retsensioon:''' [https://wiki.itcollege.ee/index.php/Talk:Kuldneloojang#Klientrakenduse_retsensensioon_by_meeskond_BeerPressure: Team Kuldneloojang retsensioon]<br />
<br />
'''XML retsensioon:''' [https://wiki.itcollege.ee/index.php/Talk:MOT#XML_retsensioon_by_meeskond_BeerPressure: Team MOT retsensioon]<br />
<br />
== Logiraamat ==<br />
<br />
===07.02.2018===<br />
Gupi loomine ning suhtluskanali seadistamine<br />
<br />
=== 24.03.2018 ===<br />
Trello boardi loomine<br />
<br />
=== 25.03.2018 ===<br />
Wiki lehe loomine. Esimene tõsisem projekti koosolek ning tegevuskava paika panemine.<br />
<br />
=== 26.03.2018 ===<br />
<br />
Alustasime veebiteenuse analüüsiga ja funktsionaalsuse kirjeldamisega.<br />
<br />
=== 27.03.2018 ===<br />
Täiendasime veebiteenuse analüüsi.<br />
<br />
Esmase andmebaasi mudeli koostamine.<br />
<br />
Postitatud esimeste analüüsi arutelude põhjal valminud algne prototüüp.<br />
<br />
=== 30.03.2018 ===<br />
Valmis andmebaasimudel.<br />
<br />
=== 08.04.2018 ===<br />
Tehtud muudatused analüüsis vastavalt tagasisidele.<br />
<br />
=== 19.04.2018 ===<br />
Loodud projekti põhi koos domeenimudelitega. Projekt lisatud Githubi: https://github.com/sikumiku/TaisKohtApi<br />
<br />
=== 05-06.05.2018 ===<br />
Osalesime hackathonil. Lisatud controllerid, service'id koos vajalike kihtidega.<br />
<br />
=== 16.05.2018 ===<br />
Uuendatud andmebaasimudelit, DTO'sid.<br />
<br />
=== 18-19.05.2018 ===<br />
Lisatud klientrakendus, security, äriloogikat.<br />
<br />
=== 20.05.2018 ===<br />
Lisatud API dokumentatsioon.<br />
<br />
=== 22-24.05.2018 ===<br />
Uuendatud contoller'eid, service'id.<br />
<br />
=== 25-27.05.2018 ===<br />
Uuendatud contoller'eid, service'id. Lisatud kasutajate ja rollide kontrolle meetoditesse. Täiustatud klientrakendust. Swagger dokumentatsioon.<br />
<br />
=== 31.05-01.06.2018 ===<br />
Tegeletud XML, XSD ja XSLT failide loomisega.<br />
<br />
=== 01.06-03.06.2018 ===<br />
Tegeletud XML ja XSLT failide täiustamisega ja retsensioonide kirjutamisega.<br />
<br />
=== 05.06.2018 ===<br />
Lisatud XML retsensioon meeskonnale MOT<br />
<br />
=== 08.06.2018 ===<br />
Lisatud uus projekti .zip muudatustega ja täiendustega</div>
Saasma
https://wiki.itcollege.ee/index.php?title=BeerPressure&diff=131449
BeerPressure
2018-06-08T18:52:44Z
<p>Saasma: /* Projekti repository */</p>
<hr />
<div>== Meeskond ja rollid ==<br />
<br />
* Sigrid Aasma (arendaja)<br />
* Evelin Jõgi (arendaja)<br />
* Martin Kask (projektijuht, arendaja)<br />
* Marko Nõu (arendaja)<br />
<br />
== Idee ==<br />
'''Toidukohtade põhimenüüde ja päevapakkumiste teenus'''<br />
<br />
Soovime pakkuda toidukohtade põhimenüüde ja päevapakkumiste teenust. On olemas mitmeid kodulehti “päevapakkumised”, kus on kirjas toidukohtade päevapraed. Kuid tavaliselt sellistel lehtedel ei ole masinloetavaid andmeid ehk siis varianti, et saad saata API pihta mingi kuupäeva koos päevapraadidega andmete uuendamiseks ja saad sama API käest küsida tänaseid päevapraade. Andmeid võiks saada küsida restorani, kuupäeva, asukoha või otsisõna/otsisõnaosa põhiselt. Selline teenus lihtsustaks ka toidukohtade päevapakkumiste haldamist, kuna praegu peavad teenuse pakkujad vastavat informatsiooni uuendama mitmes erinevas kohas - nii erinevates portaalides, kui ka enda veebileheküljel. Samuti oleks toidukohtade kogu menüü haldamine ühes kohas.<br />
<br />
=== Esialgne prototüüp ===<br />
<br />
[[File:TäisKõhtProto1.mp4]]<br />
<br />
Esialgne prototüüp: [http://enos.itcollege.ee/~saasma/VR2/Proto/K%C3%B5htT%C3%A4is/#g=1&p=home navigeeritav versioon vol.1]<br />
<br />
=== Prototüübi muutus projekti käigus ===<br />
<br />
Prototüüp: [http://enos.itcollege.ee/~saasma/VR2/Proto/T%C3%A4isK%C3%B5ht/K%C3%B5htT%C3%A4is/#g=1&p=home navigeeritav versioon vol.2]<br />
<br />
== Kasutatav arendustehnoloogia ==<br />
<br />
Veebiteenuse loomisel kasutame ASP.NET Core tehnoloogiat ja kursusel õpitud arendusmustreid.<br />
<br />
Klientrakenduse loomisel kasutame Node.js + React'i.<br />
<br />
== Veebiteenuse analüüs ==<br />
Pakume toidukohtade põhimenüüde ja päevapakkumiste teenust, kuhu on kokku koondatud erinevate toidukohtade menüüd üle Eesti. Põhimenüü alla kuuluvad pikaajalised menüüd, mis kehtivad püsivalt, hooajaliselt või mingil konkreetsel nädalapäeval. Päevapakkumiste alla kuuluvad konkreetse kuupäevaga seotud päevapakkumised. Päevapakkumiste korral kuvatakse lisainfona, kas pakkumine kehtib mingis konkreetses ajavahemikus või kogu toidukoha lahtioleku aja.<br />
<br />
Eesmärk on koguda ühte kohta kokku erinevate toidukohtade menüüd ja päevapakkumised, et kliendid saaksid mugavalt ja kiiresti oma valikuid teha. Kliendid käivad enamasti päevapakkumisi söömas lõuna ajal ja selleks ettenähtud aeg on piiratud. Sellepärast on oluline, et klient saaks teha oma valiku võimalikult kiiresti. Tänu loodavale veebiteenusele ei pea kliendid käima erinevates portaalides, et tutvuda erinevate toidukohtade pakkumistega. Kuna teenust on mugav kasutada ja klient saab oma valiku kiiresti tehtud, siis tõenäoliselt teeb klient valiku selles keskkonnas olevate toiduasutuste seast. Lisaks võimaldab teenus toiduasutustel paika panna oma pikaajalisem põhimenüü ning seda rakenduses ja võimalusel ka söögikohas kuvada. Sellepärast on ka toidukohtade huvi antud keskkonnas üleval olla ja meiega oma andmeid jagada, sest see suurendab nende klientuuri ning muudab oma menüü haldamise kergemaks.<br />
<br />
Veebiteenuse loomisel lähtume eelkõige sellest, et kliendil oleks teenust mugav kasutada ja ta saaks oma valiku kiiresti tehtud. Arvestame, et kliendid on erinevad. Mõni eelistab mõnda kindlat toidukohta, sel juhul saab ta valida oma soovitud kohad ja võrrelda nende kohtade tänase päeva pakkumisi ning menüüsid. Mõnele inimesele on oluline pakutav söök ja ta eelistab pakkumist otsida prae nimetuses oleva sõna või sõnaosa järgi ning lähtuda seejärel valiku tegemisel toidukoha keskmisest hindest või toidu hinnast. Mõne kliendi jaoks on oluline hind ja selleks, et oma valikut teha sobivas hinnavahemikus on tal võimalik sisestada maksimum hinna piirang. Kindlasti on antud teenuse juures kõikide klientide jaoks oluline päevapakkumiste asukohapõhine eristatus. Kliendid, kes soovivad oma konto luua, võivad oma eelistatud valikud meelde jätta ja järgmisel korral kuvatakse neid talle automaatselt.<br />
<br />
Teenuse must-have funktsionaalsus tagab teenuse toimimise ja põhifunktsioonid. Teenuse nice-to-have funktsionaalsus annab rakendusele lisandväärtust.<br />
<br />
Arvestades pakutava teenusega, siis näeme, et aktiivseim teenuse kasutamine võib olla tööpäevadel vahemikus 11.00-15.00, kui kliendid tutvuvad päevapakkumistega. Teenus peab tekkivale koormusele vastu pidama.<br />
<br />
Teenuse pakkumine peab olema turvaline. Selle tagamiseks tuleb sisestatavaid andmeid valideerida ja andmebaasi sisestavate andmete mahtu piirata. Toidukohtade sisestatud andmed peavad olema kaitstud, et toitude koostised ei saaks avalikuks. Põhjendatud juhtudel on võimalik kasutajaid lukku panna.<br />
<br />
== Kasutajad ==<br />
<br />
<br />
* Admin - lehe administraator, kellel on õigus lehte, kasutajaid ja nende õiguseid hallata. Tema huvi on, et teenus toimiks tõrgeteta.<br />
* Toiduasutus (tasuta kasutaja) - saab hoida lehel ühte põhimenüüd ja päevapakkumisi.<br />
* Toiduasutus (tellimusega kasutaja) - saab hoida lehel piiramatu arv põhimenüüsid ja päevapakkumisi.<br />
Toiduasutused on teenusest huvitatud, et nende menüüde haldamine oleks kerge ja mugav ning nad saaksid oma klientide arvu suurendada.<br />
* Külastaja - klient, kes valib söögikohta. Tema on huvitatud eelkõige sellest, et teenust saaks kasutada mugavalt ja kiirelt ning toidukohtade valik oleks võimalikult suur.<br />
<br />
== Rakenduse must-have funktsionaalsus ==<br />
<br />
* Kasutajad saavad sisse logida<br />
* Kasutajatel on erinevad rollid: admin, toidukoht (tasuta ja tasulise tellimusega), klient<br />
* Kasutajate arvepidamine kasutajate lõikes:<br />
** sisselogimise kuupäev, kellaaeg<br />
** pakkumiste lisamine<br />
** pakkumiste muutmine<br />
** pakkumiste kustutamine<br />
** õiguste kehtimise periood (tasuta ja tellimusega toidukoht)<br />
** pakkumistele klikkimise arv<br />
* Kasutajaid on võimalik hallata:<br />
** kasutajale õiguste andmine (menüüde arvu suurendamine, tellimusega toidukohal), rolli määramine<br />
** Kasutajat on võimalik piirata: õiguseid piirata (piiratud menüüde arv, tasuta liitunud toidukohal) ja lukku panna<br />
* Päevapakkumisi/menüüsid saab küsida: <br />
** toidukoha järgi, <br />
** kuupäeva põhiselt (ainult päevapakkumisi), <br />
** asukoha põhiselt,<br />
** toidu nimetuses esineva otsisõna/otsisõna osa põhiselt,<br />
** hinna põhiselt (max hinna piirang).<br />
* Klientrakenduses realiseeritakse CRUD meetodid (menüüsid/päevapakkumisi saab sisestada, lugeda, uuendada, kustutada)<br />
* Toidukohale saab anda hindeid ja kuvatakse keskmist hinnet.<br />
* Toidule saab anda hindeid ja kuvatakse keskmist hinnet.<br />
<br />
== Nice-to-have funktsionaalsus ==<br />
<br />
* Info selle kohta, kas päevapakkumine on otsas<br />
* Päevapakkumisi/menüüsid saab kommenteerida ja neid kommentaare kuvatakse avalikult.<br />
* Söögikohtade kodulehtedelt otsimise script, mis genereerib juba olemasolevate kodulehtede baasil päevamenüüsid.<br />
* Toiduvaliku piiramine allergeenide/vegan/jms. koostisosade põhiselt.<br />
* Aruandlused ja võrdlused toidukohtadele, et võrrelda end konkurentidega.<br />
* Teenus soovitab toidukohtadele nende varasemate päevapraadide populaarsuse alusel uue nädala menüüd.<br />
* Erinevad toidukohtade/toitude pingeread klientidele, et anda valikuteks ideid.<br />
* Soovitused klientidele, mida teised kliendid sarnaste eelistustega on veel valinud.<br />
<br />
== Andmebaasi ülesehitus - projekti algus ==<br />
<br />
[[File: BeerPressureAndmebaasimudel.png]]<br />
<br />
== Andmebaasi ülesehitus - projekti lõpp ==<br />
<br />
[[File: Ta2isKo6ht-DB-FINAL.png]]<br />
<br />
== Projekti repository ==<br />
<br />
https://github.com/sikumiku/TaisKohtApi<br />
<br />
Zip fail saadaval 27.05 seisuga: <br />
(master branchi viimane commit esitamise ajal)<br />
https://github.com/sikumiku/TaisKohtApi/archive/61438e187a1a972410c8a3bc6274d69489d00aa6.zip<br />
<br />
Uuendatud .zip fail 08.06 seisuga: http://enos.itcollege.ee/~saasma/VR2/TaisKoht/<br />
<br />
== API v1 dokumentatsioon ==<br />
<br />
===Security===<br />
'''POST /api/account/register'''<br />
<source><br />
Params: RegisterViewModel registerViewModel<br />
<br />
Returns: token<br />
</source><br />
<br />
'''POST /api/account/login'''<br />
<source> <br />
Params: LoginViewModel model<br />
<br />
Returns: token<br />
</source><br />
<br />
'''POST /api/account/logout'''<br />
<source> <br />
Params: -<br />
<br />
Returns: -<br />
</source><br />
<br />
===Accounts===<br />
'''GET /api/v1/accounts/getAllUsersInRole'''<br />
<source> <br />
Params: string role<br />
<br />
Returns: List<UserDTO><br />
</source><br />
<br />
'''GET /api/v1/accounts/{id}'''<br />
<source> <br />
Params: string id<br />
<br />
Returns: UserDTO<br />
</source><br />
<br />
'''PUT /api/v1/accounts/{id}'''<br />
<source> <br />
Params: string id, UpdateUserDTO userDTO<br />
<br />
Returns: -<br />
</source><br />
<br />
'''POST /api/v1/accounts/addRole'''<br />
<source> <br />
Params: string role<br />
<br />
Returns: -<br />
</source><br />
<br />
'''POST /api/v1/accounts/addRoleToUser'''<br />
<source> <br />
Params: string role, string userId<br />
<br />
Returns: UserDTO<br />
</source><br />
<br />
'''DELETE /api/v1/accounts/deactivate/{id}'''<br />
<source> <br />
Params: string id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Promotions===<br />
'''GET /api/v1/promotions '''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<PromotionDTO> <br />
</source><br />
<br />
'''GET /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: PromotionDTO<br />
</source><br />
<br />
'''POST /api/v1/promotions'''<br />
<source> <br />
Params: PromotionDTO promotionDTO<br />
<br />
Returns: PromotionDTO newPromotion<br />
</source><br />
<br />
'''PUT /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id, PromotionDTO promotionDTO<br />
<br />
Returns: PromotionDTO updatedPromotion<br />
</source><br />
<br />
'''DELETE /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Restaurants===<br />
'''GET /api/v1/restaurants'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<SimpleRestaurantDTO><br />
</source><br />
<br />
'''GET /api/v1/restaurants/owner'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<SimpleRestaurantDTO><br />
</source><br />
<br />
'''GET /api/v1/restaurants/search?name=th'''<br />
<source> <br />
Params: string name<br />
<br />
Returns: List<SimpleRestaurantDTO> result<br />
</source><br />
<br />
'''GET /api/v1/restaurants/top'''<br />
<source> <br />
Params: int amount<br />
<br />
Returns: List<SimpleRestaurantDTO> result<br />
</source><br />
<br />
'''GET /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: RestaurantDTO r<br />
</source><br />
<br />
'''POST /api/v1/restaurants/addUserToRestaurant'''<br />
<source> <br />
Params: int id, string userId<br />
<br />
Returns: -<br />
</source><br />
<br />
'''POST /api/v1/restaurants'''<br />
<source> <br />
Params: PostRestaurantDTO restaurantDTO<br />
<br />
Returns: RestaurantDTO newRestaurant<br />
</source><br />
<br />
'''PUT /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id, PostRestaurantDTO restaurantDTO<br />
<br />
Returns: PostRestaurantDTO updatedRestaurantDTO<br />
</source><br />
<br />
'''DELETE /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Menus===<br />
'''GET /api/v1/menus'''<br />
<source><br />
Params: -<br />
<br />
Returns: List<MenuDTO><br />
</source><br />
<br />
'''GET /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: MenuDTO menuDTO<br />
</source><br />
<br />
'''POST /api/v1/menus'''<br />
<source> <br />
Params: PostMenuDTO menuDTO<br />
<br />
Returns: MenuDTO newMenu<br />
</source><br />
<br />
'''PUT /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id, PostMenuDTO menuDTO<br />
<br />
Returns: MenuDTO updatedMenu<br />
</source><br />
<br />
'''PUT api/v1/Menus/{id}/Dishes'''<br />
<source> <br />
Params: int menuId, int[] dishIds<br />
<br />
Returns: -<br />
</source><br />
<br />
'''DELETE /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Dishes===<br />
'''GET /api/v1/dishes'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<DishDTO><br />
</source><br />
<br />
'''GET /api/v1/dishes/daily'''<br />
<source> <br />
Params: bool vegan, bool glutenFree, bool lactoseFree<br />
<br />
Returns: List<SimpleDishDTO> result<br />
</source><br />
<br />
'''GET: api/v1/dishes/search?title=th&priceLimit=null'''<br />
<source> <br />
Params: string title, decimal? priceLimit<br />
<br />
Returns: List<DishDTO> result<br />
</source><br />
<br />
'''GET /api/v1/dishes/top'''<br />
<source> <br />
Params: int amount<br />
<br />
Returns: List<DishDTO> result<br />
</source><br />
<br />
'''GET /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: DishDTO dishDTO<br />
</source><br />
<br />
'''POST /api/v1/dishes'''<br />
<source> <br />
Params: PostDishDTO dishDTO<br />
<br />
Returns: DishDTO newDish<br />
</source><br />
<br />
'''PUT /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id, PostDishDTO dishDTO<br />
<br />
Returns: DishDTO updatedDish<br />
</source><br />
<br />
'''PUT api/v1/Dishes/{id}/Ingredients'''<br />
<source> <br />
Params: int dishId, PostIngredientForDishDTO[] ingredients<br />
<br />
Returns: -<br />
</source><br />
<br />
'''DELETE /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Ingredients===<br />
'''GET /api/v1/ingredients'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<IngredientDTO><br />
</source><br />
<br />
'''GET /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: IngredientDTO i<br />
</source><br />
<br />
'''POST /api/v1/ingredients'''<br />
<source> <br />
Params: PostIngredientDTO ingredientDTO<br />
<br />
Returns: IngredientDTO newIngredient<br />
</source><br />
<br />
'''PUT /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id, PostIngredientDTO ingredientDTO<br />
<br />
Returns: IngredientDTO updatedIngredient<br />
</source><br />
<br />
'''DELETE /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Ratings===<br />
'''GET /api/v1/ratings'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<RatingLogDTO><br />
</source><br />
<br />
'''GET /api/v1/ratings/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: RatingLogDTO dto<br />
</source><br />
<br />
'''POST /api/v1/ratings'''<br />
<source> <br />
Params: RatingLogForEntityDTO ratingDTO<br />
<br />
Returns: RatingLogDTO newRating<br />
</source><br />
<br />
'''PUT api/v1/ratings/{id}'''<br />
<source> <br />
Params: int id, RatingLogForEntityDTO ratingDTO<br />
<br />
Returns: RatingLogDTO updatedRating<br />
</source><br />
<br />
'''DELETE api/v1/ratings/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===RequestLog===<br />
'''GET: api/v1/usageData/{userId}'''<br />
<source> <br />
Params: string userId<br />
<br />
Returns: List<RequestLogDTO><br />
</source><br />
<br />
== Lõpptoote kasutusjuhend ==<br />
<br />
* Kloonida kohalikku arvutisse repository aadressilt [https://github.com/sikumiku/TaisKohtApi https://github.com/sikumiku/TaisKohtApi]<br />
* Installida NodeJS<br />
* <source>npm install webpack -g</source><br />
* <source>npm install -cli -g</source><br />
* Frontend rakenduse kasutamiseks valida Startup meetoditest IIS Express, veebiteenuse ja Swaggeri kasutamiseks käivitada Api Swagger<br />
* Esimese admin kasutaja loomiseks tuleb kasutaja registreerida admin@gmail.com e-mailiga<br />
<br />
== XML/XSD/XSLT ==<br />
<br />
=== XML ===<br />
<br />
<source><?xml version="1.0" encoding="utf-8" ?><br />
<restaurants><br />
<restaurant id="1" url="https://kuuspelmeeni.ee" contactnumber="507783342" email="kuuspelmeeni@gmail.com"><br />
<name><![CDATA[Kuus Pelmeeni]]></name><br />
<menus><br />
<menu id="1" repetitioninterval="30"><br />
<name><![CDATA[Päevamenüü]]></name><br />
<activefrom>2018-05-27T12:00:00</activefrom><br />
<activeto>2018-05-28T12:00:00</activeto><br />
<dishes><br />
<dish id="1" vegan="false" lactosefree="false" glutenfree="false" daily="true" kcal="550" dailyprice="4"><br />
<title><![CDATA[8 pelmeeni]]></title><br />
<description><![CDATA[8 pelmeeni 6 asemel serveeritud tervisliku koguse hapukoore ja tilliga]]></description><br />
<availablefrom>2018-05-27T12:00:00</availablefrom><br />
<availableto>2018-05-28T12:00:00</availableto><br />
<ingredients><br />
<ingredient id="1" amountunit="g"><br />
<name>Sealiha</name><br />
<description>Rakvere sealiha</description><br />
</ingredient><br />
<ingredient id="2" amountunit="g"><br />
<name>Hapukoor</name><br />
<description>Alma hapukoor</description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="9"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Parim päevaroog viimasel ajal.]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
</comments><br />
</rating><br />
<promotion id="1" type="visual" classname="bold-red-border-2px"><br />
<name>2px red border</name><br />
<description><![CDATA[Displays a 2px wide red border around the component that is promoted.]]></description><br />
<validto>2018-06-25T12:00:00</validto><br />
</promotion><br />
</dish><br />
<dish id="2" vegan="true" lactosefree="true" glutenfree="true" daily="true" kcal="320" price="4"><br />
<title><![CDATA[Kurgisalat]]></title><br />
<description><![CDATA[Erinevatel viisidel töödeldud kurk serveeritud koos jõhvikatega. Tervislik amps.]]></description><br />
<availablefrom>2018-05-27T12:00:00</availablefrom><br />
<availableto>2018-05-28T12:00:00</availableto><br />
<ingredients/><br />
<rating ratingvalue="4"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Jäin veel väga näljaseks peale selle söömist.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
</dishes><br />
</menu><br />
<menu id="2"><br />
<name><![CDATA[Põhimenüü]]></name><br />
<dishes><br />
<dish id="4" vegan="false" lactosefree="false" glutenfree="false" daily="false" kcal="550" price="5"><br />
<title><![CDATA[6 pelmeeni]]></title><br />
<description><![CDATA[6 pelmeeni serveeritud tervisliku koguse hapukoore ja tilliga]]></description><br />
<ingredients><br />
<ingredient id="1" amountunit="g"><br />
<name>Sealiha</name><br />
<description>Rakvere sealiha</description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="9.5"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Käin seda iga päev söömas.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Parim toit selles restoranis.]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
<dish id="5" vegan="false" lactosefree="false" glutenfree="true" daily="false" kcal="460" price="3.8"><br />
<title><![CDATA[Kartulisalat]]></title><br />
<description><![CDATA[Sinki sisaldav traditsiooniline kartulisalat.]]></description><br />
<ingredients/><br />
</dish><br />
<dish id="6" vegan="false" lactosefree="false" glutenfree="false" daily="false" kcal="610" price="3.9"><br />
<title><![CDATA[Šokolaadikook]]></title><br />
<description><![CDATA[Ahvatlev glasuuritud šokolaadikook.]]></description><br />
<ingredients/><br />
<rating ratingvalue="7.8"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Šokolaadikooki on keeruline metsa keerata.]]></commenttext><br />
<username>mutikas3</username><br />
<userid>3a29b94a-3f17-469d-a44d-f7d85e98dd3e</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
</dishes><br />
</menu><br />
</menus><br />
<dishes/><br />
<address id="1" country="Eesti"><br />
<addressfirstline>Tatari 12</addressfirstline><br />
<locality>Tallinn</locality><br />
<postcode>10132</postcode><br />
<region>Harjumaa</region><br />
</address><br />
<promotion/><br />
<rating ratingvalue="7.5"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Parim restoran üldse!]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Ma sain ainult 5 pelmeeni. Ootasin kuute.]]></commenttext><br />
<username>kyllikekallike1</username><br />
<userid>6af271dd-0e11-4ae6-98be-111762664318</userid><br />
</comment><br />
</comments><br />
</rating><br />
</restaurant><br />
<restaurant id="2" url="https://kolmkokka.ee" contactnumber="6522351" email="kolmkokka@gmail.com"><br />
<name><![CDATA[Kolm kokka]]></name><br />
<menus/><br />
<dishes><br />
<dish id="7" vegan="false" lactosefree="true" glutenfree="false" daily="false" kcal="470" price="14"><br />
<title><![CDATA[Ahjulõhe juurikatega]]></title><br />
<description><![CDATA[Ahjulõhe serveeritud püreestatud porgandite ja lillkapsaga.]]></description><br />
<ingredients><br />
<ingredient id="11" amountunit="tk" amount="1"><br />
<name>Ahjulõhe</name><br />
<description><![CDATA[Värske ahjulõhe]]></description><br />
</ingredient><br />
<ingredient id="12" amountunit="g"><br />
<name>Püreestatud porgand</name><br />
<description><![CDATA[Eesti porgand, mis on kergelt püreestatud]]></description><br />
</ingredient><br />
<ingredient id="13" amountunit="g"><br />
<name>Püreestatud lillkapsas</name><br />
<description><![CDATA[Eesti lillkapsas, mis on kergelt püreestatud ja maitsestatud]]></description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="8.9"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Kindlasti minu üks lemmikuid.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Pole midagi halba öelda.]]></commenttext><br />
<username>tiiuviiu</username><br />
<userid>0730a7b7-3a9c-4e26-962f-da9a8daeab8a</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
<dish id="8" vegan="true" lactosefree="true" glutenfree="true" daily="true" dailyprice="5"><br />
<title><![CDATA[Ingverisupp]]></title><br />
<description><![CDATA[Ingveriga vürtsistatud ingverisupp, mis viib keele alla.]]></description><br />
<availablefrom>2018-05-25T12:00:00</availablefrom><br />
<availableto>2018-06-25T12:00:00</availableto><br />
<ingredients><br />
<ingredient id="14" amountunit="g" amount="20"><br />
<name>Ingver</name><br />
<description><![CDATA[Tükeldatud ingver]]></description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="6"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Liiga palju ingverit.]]></commenttext><br />
<username>kyllikekallike1</username><br />
<userid>6af271dd-0e11-4ae6-98be-111762664318</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
<dish id="9" vegan="false" lactosefree="false" glutenfree="true" daily="false" kcal="340" price="4.5"><br />
<title><![CDATA[Apelsinijäätis]]></title><br />
<description><![CDATA[Apelsinimaitseline jäätis serveeritud riivitud apelsinikoorega.]]></description><br />
<ingredients/><br />
<rating ratingvalue="8"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Väga huvitav magustoit, prooviks veel.]]></commenttext><br />
<username>mutikas3</username><br />
<userid>3a29b94a-3f17-469d-a44d-f7d85e98dd3e</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Üks mu lemmikuid magustoite.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
</dishes><br />
<address id="2" country="Eesti"><br />
<addressfirstline>Laia 12</addressfirstline><br />
<locality>Tallinn</locality><br />
<postcode>13022</postcode><br />
<region>Harjumaa</region><br />
</address><br />
<promotion/><br />
<rating ratingvalue="8.1"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Hinnad on natuke liiga kallid minu jaoks, aga toit om maitsev.]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Ma kindlasti telliks kala uuesti. Väga mahlakas oli.]]></commenttext><br />
<username>kyllikekallike1</username><br />
<userid>6af271dd-0e11-4ae6-98be-111762664318</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Asukoht oli päris tore. Miljöö ka.]]></commenttext><br />
<username>mutikas3</username><br />
<userid>3a29b94a-3f17-469d-a44d-f7d85e98dd3e</userid><br />
</comment><br />
</comments><br />
</rating><br />
</restaurant><br />
</restaurants></source><br />
<br />
=== XSD ===<br />
<br />
<source><?xml version="1.0" encoding="utf-8"?><br />
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema"><br />
<xs:element name="restaurants"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="restaurant"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="menus"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="menu"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="activefrom" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="activeto" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="dishes"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="dish"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="title" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="availablefrom" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="availableto" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="servetime" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="ingredients"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="ingredient"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="amountunit" type="xs:string" use="required" /><br />
<xs:attribute name="amount" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="rating" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="comments"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="comment"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="commenttext" type="xs:string" /><br />
<xs:element name="username" type="xs:string" /><br />
<xs:element name="userid" type="xs:string" /><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="ratingvalue" type="xs:decimal" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="validto" type="xs:dateTime" minOccurs="0" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="type" type="xs:string" use="required" /><br />
<xs:attribute name="classname" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="vegan" type="xs:boolean" use="optional" /><br />
<xs:attribute name="lactosefree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="glutenfree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="daily" type="xs:boolean" use="optional" /><br />
<xs:attribute name="kcal" type="xs:int" use="optional" /><br />
<xs:attribute name="weightg" type="xs:decimal" use="optional" /><br />
<xs:attribute name="price" type="xs:decimal" use="optional" /><br />
<xs:attribute name="dailyprice" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="validto" type="xs:dateTime" minOccurs="0" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="type" type="xs:string" use="required" /><br />
<xs:attribute name="classname" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="repetitioninterval" type="xs:int" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="dishes"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="dish"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="title" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="availablefrom" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="availableto" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="servetime" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="ingredients"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="ingredient"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="amountunit" type="xs:string" use="required" /><br />
<xs:attribute name="amount" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="rating"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="comments"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="comment"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="commenttext" type="xs:string" /><br />
<xs:element name="username" type="xs:string" /><br />
<xs:element name="userid" type="xs:string" /><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="ratingvalue" type="xs:decimal" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="validto" type="xs:dateTime" minOccurs="0" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="type" type="xs:string" use="required" /><br />
<xs:attribute name="classname" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="vegan" type="xs:boolean" use="optional" /><br />
<xs:attribute name="lactosefree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="glutenfree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="daily" type="xs:boolean" use="optional" /><br />
<xs:attribute name="kcal" type="xs:int" use="optional" /><br />
<xs:attribute name="weightg" type="xs:decimal" use="optional" /><br />
<xs:attribute name="price" type="xs:decimal" use="optional" /><br />
<xs:attribute name="dailyprice" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="address"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="addressfirstline" type="xs:string" /><br />
<xs:element name="locality" type="xs:string" /><br />
<xs:element name="postcode" type="xs:string" /><br />
<xs:element name="region" type="xs:string" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="country" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion" /><br />
<xs:element name="rating" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="comments"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="comment"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="commenttext" type="xs:string" /><br />
<xs:element name="username" type="xs:string" /><br />
<xs:element name="userid" type="xs:string" /><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="ratingvalue" type="xs:decimal" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="url" type="xs:string" use="required" /><br />
<xs:attribute name="contactnumber" type="xs:string" use="required" /><br />
<xs:attribute name="email" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:schema></source><br />
<br />
=== XSLT(HTML) ===<br />
<br />
<source><?xml version="1.0" encoding="utf-8" ?><br />
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:msxsl="urn:schemas-microsoft-com:xslt" exclude-result-prefixes="msxsl"><br />
<xsl:output method="html" indent="yes"/><br />
<xsl:template match="/restaurants"><br />
<html><br />
<head><br />
<title>Täis Kõht</title><br />
</head><br />
<body><br />
<xsl:for-each select="restaurant"><br />
<h1 style="color:DodgerBlue"><br />
<xsl:value-of select="name"/><br />
</h1><br />
<div><br />
<xsl:value-of select="@url"/><br />
</div><br />
<div><br />
<xsl:text>Kontakt number: </xsl:text><br />
<xsl:value-of select="@contactnumber"/><br />
</div><br />
<div><br />
<xsl:text>email: </xsl:text><br />
<xsl:value-of select="@email"/><br />
</div><br />
<div><br />
<xsl:text>Aadress: </xsl:text><br />
<xsl:value-of select="address/addressfirstline"/><br />
<xsl:text>, </xsl:text><br />
<xsl:value-of select="address/locality"/><br />
<xsl:text>, </xsl:text><br />
<xsl:value-of select="address/postcode"/><br />
<xsl:text>, </xsl:text><br />
<xsl:value-of select="address/@country"/><br />
</div><br />
<br />
<xsl:choose><br />
<xsl:when test="menus/menu"><br />
<xsl:for-each select="menus/menu"><br />
<xsl:sort select="name"/><br />
<h3><br />
<xsl:value-of select="name"/><br />
</h3><br />
<br />
<xsl:if test="activefrom != '' and activeto != ''"><br />
<xsl:text> </xsl:text><br />
<xsl:value-of select="substring(activefrom,1,10)"/><br />
<xsl:text> kuni </xsl:text><br />
<xsl:value-of select="substring(activeto,1,10)"/><br />
</xsl:if><br />
<br />
<ul><br />
<xsl:for-each select="dishes/dish"><br />
<xsl:sort select="title"/><br />
<br />
<xsl:if test="availablefrom != '' and availableto != ''"><br />
<xsl:value-of select="substring(availablefrom,1,10)"/><br />
<xsl:text> kuni </xsl:text><br />
<xsl:value-of select="substring(availableto,1,10)"/><br />
</xsl:if><br />
<br />
<li><br />
<span style="font-weight:bold"><br />
<xsl:value-of select="title"/><br />
</span><br />
<xsl:text> - </xsl:text><br />
<xsl:value-of select="description"/><br />
<xsl:text> </xsl:text><br />
<span style="font-weight:bold"><br />
<xsl:if test="@glutenfree='true'"><br />
<xsl:text>G </xsl:text><br />
</xsl:if><br />
<xsl:if test="@lactosefree='true'"><br />
<xsl:text>L </xsl:text><br />
</xsl:if><br />
<xsl:if test="@vegan='true'"><br />
<xsl:text>V </xsl:text><br />
</xsl:if><br />
</span><br />
</li><br />
<br />
<xsl:for-each select="ingredients/ingredient"><br />
<xsl:value-of select="name"/><br />
<xsl:if test="position()!=last()"><br />
<xsl:text>, </xsl:text><br />
</xsl:if><br />
</xsl:for-each><br />
<br />
<p style="font-weight:bold"><br />
<xsl:text>Hind: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="@price!=''"><br />
<xsl:value-of select="@price"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>-</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
<xsl:text> / Päevapakkumise hind: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="@dailyprice!=''"><br />
<xsl:value-of select="@dailyprice"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>-</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
</p><br />
<br />
<div style="background-color:LightGray;"><br />
<xsl:text>Hinnang praele: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="rating/@ratingvalue!=''"><br />
<xsl:value-of select="rating/@ratingvalue"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>Ei ole veel hinnatud!</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
<br />
<br/><br />
<xsl:for-each select="rating/comments/comment"><br />
<xsl:value-of select="username"/><br />
<xsl:text>: </xsl:text><br />
<xsl:value-of select="commenttext"/><br />
<br/><br />
</xsl:for-each><br />
</div><br />
<br/><br />
</xsl:for-each><br />
</ul><br />
</xsl:for-each><br />
</xsl:when><br />
<xsl:otherwise><br />
<ul><br />
<xsl:for-each select="dishes/dish"><br />
<xsl:sort select="title"/><br />
<br />
<xsl:if test="availablefrom != '' and availableto != ''"><br />
<xsl:value-of select="substring(availablefrom,1,10)"/><br />
<xsl:text> kuni </xsl:text><br />
<xsl:value-of select="substring(availableto,1,10)"/><br />
</xsl:if><br />
<br />
<li><br />
<span style="font-weight:bold"><br />
<xsl:value-of select="title"/><br />
</span><br />
<xsl:text> - </xsl:text><br />
<xsl:value-of select="description"/><br />
<xsl:text> </xsl:text><br />
<span style="font-weight:bold"><br />
<xsl:if test="@glutenfree='true'"><br />
<xsl:text>G </xsl:text><br />
</xsl:if><br />
<xsl:if test="@lactosefree='true'"><br />
<xsl:text>L </xsl:text><br />
</xsl:if><br />
<xsl:if test="@vegan='true'"><br />
<xsl:text>V </xsl:text><br />
</xsl:if><br />
</span><br />
</li><br />
<br />
<xsl:for-each select="ingredients/ingredient"><br />
<xsl:value-of select="name"/><br />
<xsl:if test="position()!=last()"><br />
<xsl:text>, </xsl:text><br />
</xsl:if><br />
</xsl:for-each><br />
<br />
<p style="font-weight:bold"><br />
<xsl:text>Hind: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="@price!=''"><br />
<xsl:value-of select="@price"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>-</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
<xsl:text> / Päevapakkumise hind: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="@dailyprice!=''"><br />
<xsl:value-of select="@dailyprice"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>-</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
</p><br />
<br />
<div style="background-color:LightGray;"><br />
<xsl:text>Hinnang praele: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="rating/@ratingvalue!=''"><br />
<xsl:value-of select="rating/@ratingvalue"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>Ei ole veel hinnatud!</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
<br />
<br/><br />
<xsl:for-each select="rating/comments/comment"><br />
<xsl:value-of select="username"/><br />
<xsl:text>: </xsl:text><br />
<xsl:value-of select="commenttext"/><br />
<br/><br />
</xsl:for-each><br />
</div><br />
<br/><br />
</xsl:for-each><br />
</ul><br />
</xsl:otherwise><br />
</xsl:choose><br />
<br />
<div style="background-color:LightGray;"><br />
<xsl:text>Hinnang restoranile: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="rating/@ratingvalue!=''"><br />
<xsl:value-of select="rating/@ratingvalue"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>Ei ole veel hinnatud!</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
<br />
<br />
<br/><br />
<xsl:for-each select="rating/comments/comment"><br />
<xsl:value-of select="username"/><br />
<xsl:text>: </xsl:text><br />
<xsl:value-of select="commenttext"/><br />
<br/><br />
</xsl:for-each><br />
</div><br />
<br />
<p><br />
<xsl:text>*G - gluteenivaba, </xsl:text><br />
<xsl:text>L - laktoosivaba, </xsl:text><br />
<xsl:text>V - vegan </xsl:text><br />
</p><br />
<br />
</xsl:for-each><br />
</body><br />
</html><br />
</xsl:template><br />
</xsl:stylesheet></source><br />
<br />
=== XSLT(XML) ===<br />
<br />
XML'is kuvatakse elemendid ja atribuudid eesti keeles. Kuvatakse restorani andmed ja toidud, mille hinnang on 8 või rohkem punkti.<br />
<br />
<source><?xml version="1.0" encoding="utf-8" ?><br />
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"<br />
xmlns:msxsl="urn:schemas-microsoft-com:xslt" exclude-result-prefixes="msxsl"><br />
<xsl:output method="xml" indent="yes"/><br />
<br />
<xsl:template match="/restaurants"><br />
<restoranid><br />
<xsl:for-each select="restaurant"><br />
<restoran url="{@url}" telefon="{@contactnumber}" email="{@email}"><br />
<nimi><br />
<xsl:value-of select="name"/><br />
</nimi><br />
<aadress><br />
<postiaadress><br />
<xsl:value-of select="address/addressfirstline"/><br />
</postiaadress><br />
<linn><br />
<xsl:value-of select="address/locality"/><br />
</linn><br />
<indeks><br />
<xsl:value-of select="address/postcode"/><br />
</indeks><br />
<riik><br />
<xsl:value-of select="address/@country"/><br />
</riik><br />
</aadress><br />
<br />
<parimadToidud><br />
<xsl:choose><br />
<xsl:when test="menus/menu/dishes/dish"><br />
<xsl:for-each select="menus/menu/dishes/dish"><br />
<xsl:if test="rating/@ratingvalue &gt;= 8.0"><br />
<heaToit hinnang="{rating/@ratingvalue}" paevapakkumiseHind="{@dailyprice}" hind="{@price}" <br />
vegan="{@vegan}" laktoosivaba="{@lactosefree}" gluteenivaba="{@glutenfree}"><br />
<nimi><br />
<xsl:value-of select="title"/><br />
</nimi><br />
<kirjeldus><br />
<xsl:value-of select="description"/><br />
</kirjeldus><br />
</heaToit><br />
</xsl:if><br />
</xsl:for-each><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:for-each select="dishes/dish"><br />
<xsl:if test="rating/@ratingvalue &gt;= 8.0"><br />
<heaToit hinnang="{rating/@ratingvalue}" paevapakkumiseHind="{@dailyprice}" hind="{@price}" <br />
vegan="{@vegan}" laktoosivaba="{@lactosefree}" gluteenivaba="{@glutenfree}"><br />
<nimi><br />
<xsl:value-of select="title"/><br />
</nimi><br />
<kirjeldus><br />
<xsl:value-of select="description"/><br />
</kirjeldus><br />
</heaToit><br />
</xsl:if><br />
</xsl:for-each><br />
</xsl:otherwise><br />
</xsl:choose><br />
</parimadToidud><br />
</restoran><br />
</xsl:for-each><br />
</restoranid><br />
</xsl:template><br />
</xsl:stylesheet><br />
</source><br />
<br />
== Retsensioonid ==<br />
<br />
'''Veebiteenuse retsensioon:''' [https://wiki.itcollege.ee/index.php/Talk:MOT#Veebiteenuse_retsensensioon_by_meeskond_BeerPressure: Team MOT retsensioon]<br />
<br />
'''Klientrakenduse retsensioon:''' [https://wiki.itcollege.ee/index.php/Talk:Kuldneloojang#Klientrakenduse_retsensensioon_by_meeskond_BeerPressure: Team Kuldneloojang retsensioon]<br />
<br />
'''XML retsensioon:''' [https://wiki.itcollege.ee/index.php/Talk:MOT#XML_retsensioon_by_meeskond_BeerPressure: Team MOT retsensioon]<br />
<br />
== Logiraamat ==<br />
<br />
===07.02.2018===<br />
Gupi loomine ning suhtluskanali seadistamine<br />
<br />
=== 24.03.2018 ===<br />
Trello boardi loomine<br />
<br />
=== 25.03.2018 ===<br />
Wiki lehe loomine. Esimene tõsisem projekti koosolek ning tegevuskava paika panemine.<br />
<br />
=== 26.03.2018 ===<br />
<br />
Alustasime veebiteenuse analüüsiga ja funktsionaalsuse kirjeldamisega.<br />
<br />
=== 27.03.2018 ===<br />
Täiendasime veebiteenuse analüüsi.<br />
<br />
Esmase andmebaasi mudeli koostamine.<br />
<br />
Postitatud esimeste analüüsi arutelude põhjal valminud algne prototüüp.<br />
<br />
=== 30.03.2018 ===<br />
Valmis andmebaasimudel.<br />
<br />
=== 08.04.2018 ===<br />
Tehtud muudatused analüüsis vastavalt tagasisidele.<br />
<br />
=== 19.04.2018 ===<br />
Loodud projekti põhi koos domeenimudelitega. Projekt lisatud Githubi: https://github.com/sikumiku/TaisKohtApi<br />
<br />
=== 05-06.05.2018 ===<br />
Osalesime hackathonil. Lisatud controllerid, service'id koos vajalike kihtidega.<br />
<br />
=== 16.05.2018 ===<br />
Uuendatud andmebaasimudelit, DTO'sid.<br />
<br />
=== 18-19.05.2018 ===<br />
Lisatud klientrakendus, security, äriloogikat.<br />
<br />
=== 20.05.2018 ===<br />
Lisatud API dokumentatsioon.<br />
<br />
=== 22-24.05.2018 ===<br />
Uuendatud contoller'eid, service'id.<br />
<br />
=== 25-27.05.2018 ===<br />
Uuendatud contoller'eid, service'id. Lisatud kasutajate ja rollide kontrolle meetoditesse. Täiustatud klientrakendust. Swagger dokumentatsioon.<br />
<br />
=== 31.05-01.06.2018 ===<br />
Tegeletud XML, XSD ja XSLT failide loomisega.<br />
<br />
=== 01.06-03.06.2018 ===<br />
Tegeletud XML ja XSLT failide täiustamisega ja retsensioonide kirjutamisega.<br />
<br />
=== 05.06.2018 ===<br />
Lisatud XML retsensioon meeskonnale MOT</div>
Saasma
https://wiki.itcollege.ee/index.php?title=BeerPressure&diff=131350
BeerPressure
2018-06-05T18:32:16Z
<p>Saasma: /* Logiraamat */</p>
<hr />
<div>== Meeskond ja rollid ==<br />
<br />
* Sigrid Aasma (arendaja)<br />
* Evelin Jõgi (arendaja)<br />
* Martin Kask (projektijuht, arendaja)<br />
* Marko Nõu (arendaja)<br />
<br />
== Idee ==<br />
'''Toidukohtade põhimenüüde ja päevapakkumiste teenus'''<br />
<br />
Soovime pakkuda toidukohtade põhimenüüde ja päevapakkumiste teenust. On olemas mitmeid kodulehti “päevapakkumised”, kus on kirjas toidukohtade päevapraed. Kuid tavaliselt sellistel lehtedel ei ole masinloetavaid andmeid ehk siis varianti, et saad saata API pihta mingi kuupäeva koos päevapraadidega andmete uuendamiseks ja saad sama API käest küsida tänaseid päevapraade. Andmeid võiks saada küsida restorani, kuupäeva, asukoha või otsisõna/otsisõnaosa põhiselt. Selline teenus lihtsustaks ka toidukohtade päevapakkumiste haldamist, kuna praegu peavad teenuse pakkujad vastavat informatsiooni uuendama mitmes erinevas kohas - nii erinevates portaalides, kui ka enda veebileheküljel. Samuti oleks toidukohtade kogu menüü haldamine ühes kohas.<br />
<br />
=== Esialgne prototüüp ===<br />
<br />
[[File:TäisKõhtProto1.mp4]]<br />
<br />
Esialgne prototüüp: [http://enos.itcollege.ee/~saasma/VR2/Proto/K%C3%B5htT%C3%A4is/#g=1&p=home navigeeritav versioon vol.1]<br />
<br />
=== Prototüübi muutus projekti käigus ===<br />
<br />
Prototüüp: [http://enos.itcollege.ee/~saasma/VR2/Proto/T%C3%A4isK%C3%B5ht/K%C3%B5htT%C3%A4is/#g=1&p=home navigeeritav versioon vol.2]<br />
<br />
== Kasutatav arendustehnoloogia ==<br />
<br />
Veebiteenuse loomisel kasutame ASP.NET Core tehnoloogiat ja kursusel õpitud arendusmustreid.<br />
<br />
Klientrakenduse loomisel kasutame Node.js + React'i.<br />
<br />
== Veebiteenuse analüüs ==<br />
Pakume toidukohtade põhimenüüde ja päevapakkumiste teenust, kuhu on kokku koondatud erinevate toidukohtade menüüd üle Eesti. Põhimenüü alla kuuluvad pikaajalised menüüd, mis kehtivad püsivalt, hooajaliselt või mingil konkreetsel nädalapäeval. Päevapakkumiste alla kuuluvad konkreetse kuupäevaga seotud päevapakkumised. Päevapakkumiste korral kuvatakse lisainfona, kas pakkumine kehtib mingis konkreetses ajavahemikus või kogu toidukoha lahtioleku aja.<br />
<br />
Eesmärk on koguda ühte kohta kokku erinevate toidukohtade menüüd ja päevapakkumised, et kliendid saaksid mugavalt ja kiiresti oma valikuid teha. Kliendid käivad enamasti päevapakkumisi söömas lõuna ajal ja selleks ettenähtud aeg on piiratud. Sellepärast on oluline, et klient saaks teha oma valiku võimalikult kiiresti. Tänu loodavale veebiteenusele ei pea kliendid käima erinevates portaalides, et tutvuda erinevate toidukohtade pakkumistega. Kuna teenust on mugav kasutada ja klient saab oma valiku kiiresti tehtud, siis tõenäoliselt teeb klient valiku selles keskkonnas olevate toiduasutuste seast. Lisaks võimaldab teenus toiduasutustel paika panna oma pikaajalisem põhimenüü ning seda rakenduses ja võimalusel ka söögikohas kuvada. Sellepärast on ka toidukohtade huvi antud keskkonnas üleval olla ja meiega oma andmeid jagada, sest see suurendab nende klientuuri ning muudab oma menüü haldamise kergemaks.<br />
<br />
Veebiteenuse loomisel lähtume eelkõige sellest, et kliendil oleks teenust mugav kasutada ja ta saaks oma valiku kiiresti tehtud. Arvestame, et kliendid on erinevad. Mõni eelistab mõnda kindlat toidukohta, sel juhul saab ta valida oma soovitud kohad ja võrrelda nende kohtade tänase päeva pakkumisi ning menüüsid. Mõnele inimesele on oluline pakutav söök ja ta eelistab pakkumist otsida prae nimetuses oleva sõna või sõnaosa järgi ning lähtuda seejärel valiku tegemisel toidukoha keskmisest hindest või toidu hinnast. Mõne kliendi jaoks on oluline hind ja selleks, et oma valikut teha sobivas hinnavahemikus on tal võimalik sisestada maksimum hinna piirang. Kindlasti on antud teenuse juures kõikide klientide jaoks oluline päevapakkumiste asukohapõhine eristatus. Kliendid, kes soovivad oma konto luua, võivad oma eelistatud valikud meelde jätta ja järgmisel korral kuvatakse neid talle automaatselt.<br />
<br />
Teenuse must-have funktsionaalsus tagab teenuse toimimise ja põhifunktsioonid. Teenuse nice-to-have funktsionaalsus annab rakendusele lisandväärtust.<br />
<br />
Arvestades pakutava teenusega, siis näeme, et aktiivseim teenuse kasutamine võib olla tööpäevadel vahemikus 11.00-15.00, kui kliendid tutvuvad päevapakkumistega. Teenus peab tekkivale koormusele vastu pidama.<br />
<br />
Teenuse pakkumine peab olema turvaline. Selle tagamiseks tuleb sisestatavaid andmeid valideerida ja andmebaasi sisestavate andmete mahtu piirata. Toidukohtade sisestatud andmed peavad olema kaitstud, et toitude koostised ei saaks avalikuks. Põhjendatud juhtudel on võimalik kasutajaid lukku panna.<br />
<br />
== Kasutajad ==<br />
<br />
<br />
* Admin - lehe administraator, kellel on õigus lehte, kasutajaid ja nende õiguseid hallata. Tema huvi on, et teenus toimiks tõrgeteta.<br />
* Toiduasutus (tasuta kasutaja) - saab hoida lehel ühte põhimenüüd ja päevapakkumisi.<br />
* Toiduasutus (tellimusega kasutaja) - saab hoida lehel piiramatu arv põhimenüüsid ja päevapakkumisi.<br />
Toiduasutused on teenusest huvitatud, et nende menüüde haldamine oleks kerge ja mugav ning nad saaksid oma klientide arvu suurendada.<br />
* Külastaja - klient, kes valib söögikohta. Tema on huvitatud eelkõige sellest, et teenust saaks kasutada mugavalt ja kiirelt ning toidukohtade valik oleks võimalikult suur.<br />
<br />
== Rakenduse must-have funktsionaalsus ==<br />
<br />
* Kasutajad saavad sisse logida<br />
* Kasutajatel on erinevad rollid: admin, toidukoht (tasuta ja tasulise tellimusega), klient<br />
* Kasutajate arvepidamine kasutajate lõikes:<br />
** sisselogimise kuupäev, kellaaeg<br />
** pakkumiste lisamine<br />
** pakkumiste muutmine<br />
** pakkumiste kustutamine<br />
** õiguste kehtimise periood (tasuta ja tellimusega toidukoht)<br />
** pakkumistele klikkimise arv<br />
* Kasutajaid on võimalik hallata:<br />
** kasutajale õiguste andmine (menüüde arvu suurendamine, tellimusega toidukohal), rolli määramine<br />
** Kasutajat on võimalik piirata: õiguseid piirata (piiratud menüüde arv, tasuta liitunud toidukohal) ja lukku panna<br />
* Päevapakkumisi/menüüsid saab küsida: <br />
** toidukoha järgi, <br />
** kuupäeva põhiselt (ainult päevapakkumisi), <br />
** asukoha põhiselt,<br />
** toidu nimetuses esineva otsisõna/otsisõna osa põhiselt,<br />
** hinna põhiselt (max hinna piirang).<br />
* Klientrakenduses realiseeritakse CRUD meetodid (menüüsid/päevapakkumisi saab sisestada, lugeda, uuendada, kustutada)<br />
* Toidukohale saab anda hindeid ja kuvatakse keskmist hinnet.<br />
* Toidule saab anda hindeid ja kuvatakse keskmist hinnet.<br />
<br />
== Nice-to-have funktsionaalsus ==<br />
<br />
* Info selle kohta, kas päevapakkumine on otsas<br />
* Päevapakkumisi/menüüsid saab kommenteerida ja neid kommentaare kuvatakse avalikult.<br />
* Söögikohtade kodulehtedelt otsimise script, mis genereerib juba olemasolevate kodulehtede baasil päevamenüüsid.<br />
* Toiduvaliku piiramine allergeenide/vegan/jms. koostisosade põhiselt.<br />
* Aruandlused ja võrdlused toidukohtadele, et võrrelda end konkurentidega.<br />
* Teenus soovitab toidukohtadele nende varasemate päevapraadide populaarsuse alusel uue nädala menüüd.<br />
* Erinevad toidukohtade/toitude pingeread klientidele, et anda valikuteks ideid.<br />
* Soovitused klientidele, mida teised kliendid sarnaste eelistustega on veel valinud.<br />
<br />
== Andmebaasi ülesehitus - projekti algus ==<br />
<br />
[[File: BeerPressureAndmebaasimudel.png]]<br />
<br />
== Andmebaasi ülesehitus - projekti lõpp ==<br />
<br />
[[File: Ta2isKo6ht-DB-FINAL.png]]<br />
<br />
== Projekti repository ==<br />
<br />
https://github.com/sikumiku/TaisKohtApi<br />
<br />
Zip fail saadaval: <br />
(master branchi viimane commit esitamise ajal)<br />
https://github.com/sikumiku/TaisKohtApi/archive/61438e187a1a972410c8a3bc6274d69489d00aa6.zip<br />
<br />
== API v1 dokumentatsioon ==<br />
<br />
===Security===<br />
'''POST /api/account/register'''<br />
<source><br />
Params: RegisterViewModel registerViewModel<br />
<br />
Returns: token<br />
</source><br />
<br />
'''POST /api/account/login'''<br />
<source> <br />
Params: LoginViewModel model<br />
<br />
Returns: token<br />
</source><br />
<br />
'''POST /api/account/logout'''<br />
<source> <br />
Params: -<br />
<br />
Returns: -<br />
</source><br />
<br />
===Accounts===<br />
'''GET /api/v1/accounts/getAllUsersInRole'''<br />
<source> <br />
Params: string role<br />
<br />
Returns: List<UserDTO><br />
</source><br />
<br />
'''GET /api/v1/accounts/{id}'''<br />
<source> <br />
Params: string id<br />
<br />
Returns: UserDTO<br />
</source><br />
<br />
'''PUT /api/v1/accounts/{id}'''<br />
<source> <br />
Params: string id, UpdateUserDTO userDTO<br />
<br />
Returns: -<br />
</source><br />
<br />
'''POST /api/v1/accounts/addRole'''<br />
<source> <br />
Params: string role<br />
<br />
Returns: -<br />
</source><br />
<br />
'''POST /api/v1/accounts/addRoleToUser'''<br />
<source> <br />
Params: string role, string userId<br />
<br />
Returns: UserDTO<br />
</source><br />
<br />
'''DELETE /api/v1/accounts/deactivate/{id}'''<br />
<source> <br />
Params: string id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Promotions===<br />
'''GET /api/v1/promotions '''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<PromotionDTO> <br />
</source><br />
<br />
'''GET /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: PromotionDTO<br />
</source><br />
<br />
'''POST /api/v1/promotions'''<br />
<source> <br />
Params: PromotionDTO promotionDTO<br />
<br />
Returns: PromotionDTO newPromotion<br />
</source><br />
<br />
'''PUT /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id, PromotionDTO promotionDTO<br />
<br />
Returns: PromotionDTO updatedPromotion<br />
</source><br />
<br />
'''DELETE /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Restaurants===<br />
'''GET /api/v1/restaurants'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<SimpleRestaurantDTO><br />
</source><br />
<br />
'''GET /api/v1/restaurants/search?name=th'''<br />
<source> <br />
Params: string name<br />
<br />
Returns: List<SimpleRestaurantDTO> result<br />
</source><br />
<br />
'''GET /api/v1/restaurants/top'''<br />
<source> <br />
Params: int amount<br />
<br />
Returns: List<SimpleRestaurantDTO> result<br />
</source><br />
<br />
'''GET /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: RestaurantDTO r<br />
</source><br />
<br />
'''POST /api/v1/restaurants/addUserToRestaurant'''<br />
<source> <br />
Params: int id, string userId<br />
<br />
Returns: -<br />
</source><br />
<br />
'''POST /api/v1/restaurants'''<br />
<source> <br />
Params: PostRestaurantDTO restaurantDTO<br />
<br />
Returns: RestaurantDTO newRestaurant<br />
</source><br />
<br />
'''PUT /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id, PostRestaurantDTO restaurantDTO<br />
<br />
Returns: PostRestaurantDTO updatedRestaurantDTO<br />
</source><br />
<br />
'''DELETE /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Menus===<br />
'''GET /api/v1/menus'''<br />
<source><br />
Params: -<br />
<br />
Returns: List<MenuDTO><br />
</source><br />
<br />
'''GET /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: MenuDTO menuDTO<br />
</source><br />
<br />
'''POST /api/v1/menus'''<br />
<source> <br />
Params: PostMenuDTO menuDTO<br />
<br />
Returns: MenuDTO newMenu<br />
</source><br />
<br />
'''PUT /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id, PostMenuDTO menuDTO<br />
<br />
Returns: MenuDTO updatedMenu<br />
</source><br />
<br />
'''PUT api/v1/Menus/{id}/Dishes'''<br />
<source> <br />
Params: int menuId, int[] dishIds<br />
<br />
Returns: -<br />
</source><br />
<br />
'''DELETE /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Dishes===<br />
'''GET /api/v1/dishes'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<DishDTO><br />
</source><br />
<br />
'''GET /api/v1/dishes/daily'''<br />
<source> <br />
Params: bool vegan, bool glutenFree, bool lactoseFree<br />
<br />
Returns: List<SimpleDishDTO> result<br />
</source><br />
<br />
'''GET: api/v1/dishes/search?title=th&priceLimit=null'''<br />
<source> <br />
Params: string title, decimal? priceLimit<br />
<br />
Returns: List<DishDTO> result<br />
</source><br />
<br />
'''GET /api/v1/dishes/top'''<br />
<source> <br />
Params: int amount<br />
<br />
Returns: List<DishDTO> result<br />
</source><br />
<br />
'''GET /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: DishDTO dishDTO<br />
</source><br />
<br />
'''POST /api/v1/dishes'''<br />
<source> <br />
Params: PostDishDTO dishDTO<br />
<br />
Returns: DishDTO newDish<br />
</source><br />
<br />
'''PUT /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id, PostDishDTO dishDTO<br />
<br />
Returns: DishDTO updatedDish<br />
</source><br />
<br />
'''PUT api/v1/Dishes/{id}/Ingredients'''<br />
<source> <br />
Params: int dishId, PostIngredientForDishDTO[] ingredients<br />
<br />
Returns: -<br />
</source><br />
<br />
'''DELETE /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Ingredients===<br />
'''GET /api/v1/ingredients'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<IngredientDTO><br />
</source><br />
<br />
'''GET /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: IngredientDTO i<br />
</source><br />
<br />
'''POST /api/v1/ingredients'''<br />
<source> <br />
Params: PostIngredientDTO ingredientDTO<br />
<br />
Returns: IngredientDTO newIngredient<br />
</source><br />
<br />
'''PUT /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id, PostIngredientDTO ingredientDTO<br />
<br />
Returns: IngredientDTO updatedIngredient<br />
</source><br />
<br />
'''DELETE /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Ratings===<br />
'''GET /api/v1/ratings'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<RatingLogDTO><br />
</source><br />
<br />
'''GET /api/v1/ratings/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: RatingLogDTO dto<br />
</source><br />
<br />
'''POST /api/v1/ratings'''<br />
<source> <br />
Params: RatingLogForEntityDTO ratingDTO<br />
<br />
Returns: RatingLogDTO newRating<br />
</source><br />
<br />
'''PUT api/v1/ratings/{id}'''<br />
<source> <br />
Params: int id, RatingLogForEntityDTO ratingDTO<br />
<br />
Returns: RatingLogDTO updatedRating<br />
</source><br />
<br />
'''DELETE api/v1/ratings/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===RequestLog===<br />
'''GET: api/v1/usageData/{userId}'''<br />
<source> <br />
Params: string userId<br />
<br />
Returns: List<RequestLogDTO><br />
</source><br />
<br />
== Lõpptoote kasutusjuhend ==<br />
<br />
* Kloonida kohalikku arvutisse repository aadressilt [https://github.com/sikumiku/TaisKohtApi https://github.com/sikumiku/TaisKohtApi]<br />
* Installida NodeJS<br />
* <source>npm install webpack -g</source><br />
* <source>npm install -cli -g</source><br />
* Frontend rakenduse kasutamiseks valida Startup meetoditest IIS Express, veebiteenuse ja Swaggeri kasutamiseks käivitada Api Swagger<br />
* Esimese admin kasutaja loomiseks tuleb kasutaja registreerida admin@gmail.com e-mailiga<br />
<br />
== XML/XSD/XSLT ==<br />
<br />
=== XML ===<br />
<br />
<source><?xml version="1.0" encoding="utf-8" ?><br />
<restaurants><br />
<restaurant id="1" url="https://kuuspelmeeni.ee" contactnumber="507783342" email="kuuspelmeeni@gmail.com"><br />
<name><![CDATA[Kuus Pelmeeni]]></name><br />
<menus><br />
<menu id="1" repetitioninterval="30"><br />
<name><![CDATA[Päevamenüü]]></name><br />
<activefrom>2018-05-27T12:00:00</activefrom><br />
<activeto>2018-05-28T12:00:00</activeto><br />
<dishes><br />
<dish id="1" vegan="false" lactosefree="false" glutenfree="false" daily="true" kcal="550" dailyprice="4"><br />
<title><![CDATA[8 pelmeeni]]></title><br />
<description><![CDATA[8 pelmeeni 6 asemel serveeritud tervisliku koguse hapukoore ja tilliga]]></description><br />
<availablefrom>2018-05-27T12:00:00</availablefrom><br />
<availableto>2018-05-28T12:00:00</availableto><br />
<ingredients><br />
<ingredient id="1" amountunit="g"><br />
<name>Sealiha</name><br />
<description>Rakvere sealiha</description><br />
</ingredient><br />
<ingredient id="2" amountunit="g"><br />
<name>Hapukoor</name><br />
<description>Alma hapukoor</description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="9"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Parim päevaroog viimasel ajal.]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
</comments><br />
</rating><br />
<promotion id="1" type="visual" classname="bold-red-border-2px"><br />
<name>2px red border</name><br />
<description><![CDATA[Displays a 2px wide red border around the component that is promoted.]]></description><br />
<validto>2018-06-25T12:00:00</validto><br />
</promotion><br />
</dish><br />
<dish id="2" vegan="true" lactosefree="true" glutenfree="true" daily="true" kcal="320" price="4"><br />
<title><![CDATA[Kurgisalat]]></title><br />
<description><![CDATA[Erinevatel viisidel töödeldud kurk serveeritud koos jõhvikatega. Tervislik amps.]]></description><br />
<availablefrom>2018-05-27T12:00:00</availablefrom><br />
<availableto>2018-05-28T12:00:00</availableto><br />
<ingredients/><br />
<rating ratingvalue="4"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Jäin veel väga näljaseks peale selle söömist.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
</dishes><br />
</menu><br />
<menu id="2"><br />
<name><![CDATA[Põhimenüü]]></name><br />
<dishes><br />
<dish id="4" vegan="false" lactosefree="false" glutenfree="false" daily="false" kcal="550" price="5"><br />
<title><![CDATA[6 pelmeeni]]></title><br />
<description><![CDATA[6 pelmeeni serveeritud tervisliku koguse hapukoore ja tilliga]]></description><br />
<ingredients><br />
<ingredient id="1" amountunit="g"><br />
<name>Sealiha</name><br />
<description>Rakvere sealiha</description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="9.5"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Käin seda iga päev söömas.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Parim toit selles restoranis.]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
<dish id="5" vegan="false" lactosefree="false" glutenfree="true" daily="false" kcal="460" price="3.8"><br />
<title><![CDATA[Kartulisalat]]></title><br />
<description><![CDATA[Sinki sisaldav traditsiooniline kartulisalat.]]></description><br />
<ingredients/><br />
</dish><br />
<dish id="6" vegan="false" lactosefree="false" glutenfree="false" daily="false" kcal="610" price="3.9"><br />
<title><![CDATA[Šokolaadikook]]></title><br />
<description><![CDATA[Ahvatlev glasuuritud šokolaadikook.]]></description><br />
<ingredients/><br />
<rating ratingvalue="7.8"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Šokolaadikooki on keeruline metsa keerata.]]></commenttext><br />
<username>mutikas3</username><br />
<userid>3a29b94a-3f17-469d-a44d-f7d85e98dd3e</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
</dishes><br />
</menu><br />
</menus><br />
<dishes/><br />
<address id="1" country="Eesti"><br />
<addressfirstline>Tatari 12</addressfirstline><br />
<locality>Tallinn</locality><br />
<postcode>10132</postcode><br />
<region>Harjumaa</region><br />
</address><br />
<promotion/><br />
<rating ratingvalue="7.5"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Parim restoran üldse!]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Ma sain ainult 5 pelmeeni. Ootasin kuute.]]></commenttext><br />
<username>kyllikekallike1</username><br />
<userid>6af271dd-0e11-4ae6-98be-111762664318</userid><br />
</comment><br />
</comments><br />
</rating><br />
</restaurant><br />
<restaurant id="2" url="https://kolmkokka.ee" contactnumber="6522351" email="kolmkokka@gmail.com"><br />
<name><![CDATA[Kolm kokka]]></name><br />
<menus/><br />
<dishes><br />
<dish id="7" vegan="false" lactosefree="true" glutenfree="false" daily="false" kcal="470" price="14"><br />
<title><![CDATA[Ahjulõhe juurikatega]]></title><br />
<description><![CDATA[Ahjulõhe serveeritud püreestatud porgandite ja lillkapsaga.]]></description><br />
<ingredients><br />
<ingredient id="11" amountunit="tk" amount="1"><br />
<name>Ahjulõhe</name><br />
<description><![CDATA[Värske ahjulõhe]]></description><br />
</ingredient><br />
<ingredient id="12" amountunit="g"><br />
<name>Püreestatud porgand</name><br />
<description><![CDATA[Eesti porgand, mis on kergelt püreestatud]]></description><br />
</ingredient><br />
<ingredient id="13" amountunit="g"><br />
<name>Püreestatud lillkapsas</name><br />
<description><![CDATA[Eesti lillkapsas, mis on kergelt püreestatud ja maitsestatud]]></description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="8.9"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Kindlasti minu üks lemmikuid.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Pole midagi halba öelda.]]></commenttext><br />
<username>tiiuviiu</username><br />
<userid>0730a7b7-3a9c-4e26-962f-da9a8daeab8a</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
<dish id="8" vegan="true" lactosefree="true" glutenfree="true" daily="true" dailyprice="5"><br />
<title><![CDATA[Ingverisupp]]></title><br />
<description><![CDATA[Ingveriga vürtsistatud ingverisupp, mis viib keele alla.]]></description><br />
<availablefrom>2018-05-25T12:00:00</availablefrom><br />
<availableto>2018-06-25T12:00:00</availableto><br />
<ingredients><br />
<ingredient id="14" amountunit="g" amount="20"><br />
<name>Ingver</name><br />
<description><![CDATA[Tükeldatud ingver]]></description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="6"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Liiga palju ingverit.]]></commenttext><br />
<username>kyllikekallike1</username><br />
<userid>6af271dd-0e11-4ae6-98be-111762664318</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
<dish id="9" vegan="false" lactosefree="false" glutenfree="true" daily="false" kcal="340" price="4.5"><br />
<title><![CDATA[Apelsinijäätis]]></title><br />
<description><![CDATA[Apelsinimaitseline jäätis serveeritud riivitud apelsinikoorega.]]></description><br />
<ingredients/><br />
<rating ratingvalue="8"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Väga huvitav magustoit, prooviks veel.]]></commenttext><br />
<username>mutikas3</username><br />
<userid>3a29b94a-3f17-469d-a44d-f7d85e98dd3e</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Üks mu lemmikuid magustoite.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
</dishes><br />
<address id="2" country="Eesti"><br />
<addressfirstline>Laia 12</addressfirstline><br />
<locality>Tallinn</locality><br />
<postcode>13022</postcode><br />
<region>Harjumaa</region><br />
</address><br />
<promotion/><br />
<rating ratingvalue="8.1"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Hinnad on natuke liiga kallid minu jaoks, aga toit om maitsev.]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Ma kindlasti telliks kala uuesti. Väga mahlakas oli.]]></commenttext><br />
<username>kyllikekallike1</username><br />
<userid>6af271dd-0e11-4ae6-98be-111762664318</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Asukoht oli päris tore. Miljöö ka.]]></commenttext><br />
<username>mutikas3</username><br />
<userid>3a29b94a-3f17-469d-a44d-f7d85e98dd3e</userid><br />
</comment><br />
</comments><br />
</rating><br />
</restaurant><br />
</restaurants></source><br />
<br />
=== XSD ===<br />
<br />
<source><?xml version="1.0" encoding="utf-8"?><br />
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema"><br />
<xs:element name="restaurants"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="restaurant"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="menus"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="menu"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="activefrom" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="activeto" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="dishes"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="dish"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="title" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="availablefrom" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="availableto" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="servetime" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="ingredients"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="ingredient"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="amountunit" type="xs:string" use="required" /><br />
<xs:attribute name="amount" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="rating" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="comments"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="comment"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="commenttext" type="xs:string" /><br />
<xs:element name="username" type="xs:string" /><br />
<xs:element name="userid" type="xs:string" /><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="ratingvalue" type="xs:decimal" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="validto" type="xs:dateTime" minOccurs="0" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="type" type="xs:string" use="required" /><br />
<xs:attribute name="classname" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="vegan" type="xs:boolean" use="optional" /><br />
<xs:attribute name="lactosefree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="glutenfree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="daily" type="xs:boolean" use="optional" /><br />
<xs:attribute name="kcal" type="xs:int" use="optional" /><br />
<xs:attribute name="weightg" type="xs:decimal" use="optional" /><br />
<xs:attribute name="price" type="xs:decimal" use="optional" /><br />
<xs:attribute name="dailyprice" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="validto" type="xs:dateTime" minOccurs="0" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="type" type="xs:string" use="required" /><br />
<xs:attribute name="classname" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="repetitioninterval" type="xs:int" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="dishes"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="dish"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="title" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="availablefrom" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="availableto" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="servetime" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="ingredients"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="ingredient"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="amountunit" type="xs:string" use="required" /><br />
<xs:attribute name="amount" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="rating"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="comments"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="comment"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="commenttext" type="xs:string" /><br />
<xs:element name="username" type="xs:string" /><br />
<xs:element name="userid" type="xs:string" /><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="ratingvalue" type="xs:decimal" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="validto" type="xs:dateTime" minOccurs="0" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="type" type="xs:string" use="required" /><br />
<xs:attribute name="classname" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="vegan" type="xs:boolean" use="optional" /><br />
<xs:attribute name="lactosefree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="glutenfree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="daily" type="xs:boolean" use="optional" /><br />
<xs:attribute name="kcal" type="xs:int" use="optional" /><br />
<xs:attribute name="weightg" type="xs:decimal" use="optional" /><br />
<xs:attribute name="price" type="xs:decimal" use="optional" /><br />
<xs:attribute name="dailyprice" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="address"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="addressfirstline" type="xs:string" /><br />
<xs:element name="locality" type="xs:string" /><br />
<xs:element name="postcode" type="xs:string" /><br />
<xs:element name="region" type="xs:string" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="country" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion" /><br />
<xs:element name="rating" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="comments"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="comment"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="commenttext" type="xs:string" /><br />
<xs:element name="username" type="xs:string" /><br />
<xs:element name="userid" type="xs:string" /><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="ratingvalue" type="xs:decimal" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="url" type="xs:string" use="required" /><br />
<xs:attribute name="contactnumber" type="xs:string" use="required" /><br />
<xs:attribute name="email" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:schema></source><br />
<br />
=== XSLT(HTML) ===<br />
<br />
<source><?xml version="1.0" encoding="utf-8" ?><br />
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:msxsl="urn:schemas-microsoft-com:xslt" exclude-result-prefixes="msxsl"><br />
<xsl:output method="html" indent="yes"/><br />
<xsl:template match="/restaurants"><br />
<html><br />
<head><br />
<title>Täis Kõht</title><br />
</head><br />
<body><br />
<xsl:for-each select="restaurant"><br />
<h1 style="color:DodgerBlue"><br />
<xsl:value-of select="name"/><br />
</h1><br />
<div><br />
<xsl:value-of select="@url"/><br />
</div><br />
<div><br />
<xsl:text>Kontakt number: </xsl:text><br />
<xsl:value-of select="@contactnumber"/><br />
</div><br />
<div><br />
<xsl:text>email: </xsl:text><br />
<xsl:value-of select="@email"/><br />
</div><br />
<div><br />
<xsl:text>Aadress: </xsl:text><br />
<xsl:value-of select="address/addressfirstline"/><br />
<xsl:text>, </xsl:text><br />
<xsl:value-of select="address/locality"/><br />
<xsl:text>, </xsl:text><br />
<xsl:value-of select="address/postcode"/><br />
<xsl:text>, </xsl:text><br />
<xsl:value-of select="address/@country"/><br />
</div><br />
<br />
<xsl:choose><br />
<xsl:when test="menus/menu"><br />
<xsl:for-each select="menus/menu"><br />
<xsl:sort select="name"/><br />
<h3><br />
<xsl:value-of select="name"/><br />
</h3><br />
<br />
<xsl:if test="activefrom != '' and activeto != ''"><br />
<xsl:text> </xsl:text><br />
<xsl:value-of select="substring(activefrom,1,10)"/><br />
<xsl:text> kuni </xsl:text><br />
<xsl:value-of select="substring(activeto,1,10)"/><br />
</xsl:if><br />
<br />
<ul><br />
<xsl:for-each select="dishes/dish"><br />
<xsl:sort select="title"/><br />
<br />
<xsl:if test="availablefrom != '' and availableto != ''"><br />
<xsl:value-of select="substring(availablefrom,1,10)"/><br />
<xsl:text> kuni </xsl:text><br />
<xsl:value-of select="substring(availableto,1,10)"/><br />
</xsl:if><br />
<br />
<li><br />
<span style="font-weight:bold"><br />
<xsl:value-of select="title"/><br />
</span><br />
<xsl:text> - </xsl:text><br />
<xsl:value-of select="description"/><br />
<xsl:text> </xsl:text><br />
<span style="font-weight:bold"><br />
<xsl:if test="@glutenfree='true'"><br />
<xsl:text>G </xsl:text><br />
</xsl:if><br />
<xsl:if test="@lactosefree='true'"><br />
<xsl:text>L </xsl:text><br />
</xsl:if><br />
<xsl:if test="@vegan='true'"><br />
<xsl:text>V </xsl:text><br />
</xsl:if><br />
</span><br />
</li><br />
<br />
<xsl:for-each select="ingredients/ingredient"><br />
<xsl:value-of select="name"/><br />
<xsl:if test="position()!=last()"><br />
<xsl:text>, </xsl:text><br />
</xsl:if><br />
</xsl:for-each><br />
<br />
<p style="font-weight:bold"><br />
<xsl:text>Hind: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="@price!=''"><br />
<xsl:value-of select="@price"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>-</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
<xsl:text> / Päevapakkumise hind: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="@dailyprice!=''"><br />
<xsl:value-of select="@dailyprice"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>-</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
</p><br />
<br />
<div style="background-color:LightGray;"><br />
<xsl:text>Hinnang praele: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="rating/@ratingvalue!=''"><br />
<xsl:value-of select="rating/@ratingvalue"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>Ei ole veel hinnatud!</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
<br />
<br/><br />
<xsl:for-each select="rating/comments/comment"><br />
<xsl:value-of select="username"/><br />
<xsl:text>: </xsl:text><br />
<xsl:value-of select="commenttext"/><br />
<br/><br />
</xsl:for-each><br />
</div><br />
<br/><br />
</xsl:for-each><br />
</ul><br />
</xsl:for-each><br />
</xsl:when><br />
<xsl:otherwise><br />
<ul><br />
<xsl:for-each select="dishes/dish"><br />
<xsl:sort select="title"/><br />
<br />
<xsl:if test="availablefrom != '' and availableto != ''"><br />
<xsl:value-of select="substring(availablefrom,1,10)"/><br />
<xsl:text> kuni </xsl:text><br />
<xsl:value-of select="substring(availableto,1,10)"/><br />
</xsl:if><br />
<br />
<li><br />
<span style="font-weight:bold"><br />
<xsl:value-of select="title"/><br />
</span><br />
<xsl:text> - </xsl:text><br />
<xsl:value-of select="description"/><br />
<xsl:text> </xsl:text><br />
<span style="font-weight:bold"><br />
<xsl:if test="@glutenfree='true'"><br />
<xsl:text>G </xsl:text><br />
</xsl:if><br />
<xsl:if test="@lactosefree='true'"><br />
<xsl:text>L </xsl:text><br />
</xsl:if><br />
<xsl:if test="@vegan='true'"><br />
<xsl:text>V </xsl:text><br />
</xsl:if><br />
</span><br />
</li><br />
<br />
<xsl:for-each select="ingredients/ingredient"><br />
<xsl:value-of select="name"/><br />
<xsl:if test="position()!=last()"><br />
<xsl:text>, </xsl:text><br />
</xsl:if><br />
</xsl:for-each><br />
<br />
<p style="font-weight:bold"><br />
<xsl:text>Hind: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="@price!=''"><br />
<xsl:value-of select="@price"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>-</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
<xsl:text> / Päevapakkumise hind: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="@dailyprice!=''"><br />
<xsl:value-of select="@dailyprice"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>-</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
</p><br />
<br />
<div style="background-color:LightGray;"><br />
<xsl:text>Hinnang praele: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="rating/@ratingvalue!=''"><br />
<xsl:value-of select="rating/@ratingvalue"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>Ei ole veel hinnatud!</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
<br />
<br/><br />
<xsl:for-each select="rating/comments/comment"><br />
<xsl:value-of select="username"/><br />
<xsl:text>: </xsl:text><br />
<xsl:value-of select="commenttext"/><br />
<br/><br />
</xsl:for-each><br />
</div><br />
<br/><br />
</xsl:for-each><br />
</ul><br />
</xsl:otherwise><br />
</xsl:choose><br />
<br />
<div style="background-color:LightGray;"><br />
<xsl:text>Hinnang restoranile: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="rating/@ratingvalue!=''"><br />
<xsl:value-of select="rating/@ratingvalue"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>Ei ole veel hinnatud!</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
<br />
<br />
<br/><br />
<xsl:for-each select="rating/comments/comment"><br />
<xsl:value-of select="username"/><br />
<xsl:text>: </xsl:text><br />
<xsl:value-of select="commenttext"/><br />
<br/><br />
</xsl:for-each><br />
</div><br />
<br />
<p><br />
<xsl:text>*G - gluteenivaba, </xsl:text><br />
<xsl:text>L - laktoosivaba, </xsl:text><br />
<xsl:text>V - vegan </xsl:text><br />
</p><br />
<br />
</xsl:for-each><br />
</body><br />
</html><br />
</xsl:template><br />
</xsl:stylesheet></source><br />
<br />
=== XSLT(XML) ===<br />
<br />
XML'is kuvatakse elemendid ja atribuudid eesti keeles. Kuvatakse restorani andmed ja toidud, mille hinnang on 8 või rohkem punkti.<br />
<br />
<source><?xml version="1.0" encoding="utf-8" ?><br />
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"<br />
xmlns:msxsl="urn:schemas-microsoft-com:xslt" exclude-result-prefixes="msxsl"><br />
<xsl:output method="xml" indent="yes"/><br />
<br />
<xsl:template match="/restaurants"><br />
<restoranid><br />
<xsl:for-each select="restaurant"><br />
<restoran url="{@url}" telefon="{@contactnumber}" email="{@email}"><br />
<nimi><br />
<xsl:value-of select="name"/><br />
</nimi><br />
<aadress><br />
<postiaadress><br />
<xsl:value-of select="address/addressfirstline"/><br />
</postiaadress><br />
<linn><br />
<xsl:value-of select="address/locality"/><br />
</linn><br />
<indeks><br />
<xsl:value-of select="address/postcode"/><br />
</indeks><br />
<riik><br />
<xsl:value-of select="address/@country"/><br />
</riik><br />
</aadress><br />
<br />
<parimadToidud><br />
<xsl:choose><br />
<xsl:when test="menus/menu/dishes/dish"><br />
<xsl:for-each select="menus/menu/dishes/dish"><br />
<xsl:if test="rating/@ratingvalue &gt;= 8.0"><br />
<heaToit hinnang="{rating/@ratingvalue}" paevapakkumiseHind="{@dailyprice}" hind="{@price}" <br />
vegan="{@vegan}" laktoosivaba="{@lactosefree}" gluteenivaba="{@glutenfree}"><br />
<nimi><br />
<xsl:value-of select="title"/><br />
</nimi><br />
<kirjeldus><br />
<xsl:value-of select="description"/><br />
</kirjeldus><br />
</heaToit><br />
</xsl:if><br />
</xsl:for-each><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:for-each select="dishes/dish"><br />
<xsl:if test="rating/@ratingvalue &gt;= 8.0"><br />
<heaToit hinnang="{rating/@ratingvalue}" paevapakkumiseHind="{@dailyprice}" hind="{@price}" <br />
vegan="{@vegan}" laktoosivaba="{@lactosefree}" gluteenivaba="{@glutenfree}"><br />
<nimi><br />
<xsl:value-of select="title"/><br />
</nimi><br />
<kirjeldus><br />
<xsl:value-of select="description"/><br />
</kirjeldus><br />
</heaToit><br />
</xsl:if><br />
</xsl:for-each><br />
</xsl:otherwise><br />
</xsl:choose><br />
</parimadToidud><br />
</restoran><br />
</xsl:for-each><br />
</restoranid><br />
</xsl:template><br />
</xsl:stylesheet><br />
</source><br />
<br />
== Retsensioonid ==<br />
<br />
'''Veebiteenuse retsensioon:''' [https://wiki.itcollege.ee/index.php/Talk:MOT#Veebiteenuse_retsensensioon_by_meeskond_BeerPressure: Team MOT retsensioon]<br />
<br />
'''Klientrakenduse retsensioon:''' [https://wiki.itcollege.ee/index.php/Talk:Kuldneloojang#Klientrakenduse_retsensensioon_by_meeskond_BeerPressure: Team Kuldneloojang retsensioon]<br />
<br />
'''XML retsensioon:''' [https://wiki.itcollege.ee/index.php/Talk:MOT#XML_retsensioon_by_meeskond_BeerPressure: Team MOT retsensioon]<br />
<br />
== Logiraamat ==<br />
<br />
===07.02.2018===<br />
Gupi loomine ning suhtluskanali seadistamine<br />
<br />
=== 24.03.2018 ===<br />
Trello boardi loomine<br />
<br />
=== 25.03.2018 ===<br />
Wiki lehe loomine. Esimene tõsisem projekti koosolek ning tegevuskava paika panemine.<br />
<br />
=== 26.03.2018 ===<br />
<br />
Alustasime veebiteenuse analüüsiga ja funktsionaalsuse kirjeldamisega.<br />
<br />
=== 27.03.2018 ===<br />
Täiendasime veebiteenuse analüüsi.<br />
<br />
Esmase andmebaasi mudeli koostamine.<br />
<br />
Postitatud esimeste analüüsi arutelude põhjal valminud algne prototüüp.<br />
<br />
=== 30.03.2018 ===<br />
Valmis andmebaasimudel.<br />
<br />
=== 08.04.2018 ===<br />
Tehtud muudatused analüüsis vastavalt tagasisidele.<br />
<br />
=== 19.04.2018 ===<br />
Loodud projekti põhi koos domeenimudelitega. Projekt lisatud Githubi: https://github.com/sikumiku/TaisKohtApi<br />
<br />
=== 05-06.05.2018 ===<br />
Osalesime hackathonil. Lisatud controllerid, service'id koos vajalike kihtidega.<br />
<br />
=== 16.05.2018 ===<br />
Uuendatud andmebaasimudelit, DTO'sid.<br />
<br />
=== 18-19.05.2018 ===<br />
Lisatud klientrakendus, security, äriloogikat.<br />
<br />
=== 20.05.2018 ===<br />
Lisatud API dokumentatsioon.<br />
<br />
=== 22-24.05.2018 ===<br />
Uuendatud contoller'eid, service'id.<br />
<br />
=== 25-27.05.2018 ===<br />
Uuendatud contoller'eid, service'id. Lisatud kasutajate ja rollide kontrolle meetoditesse. Täiustatud klientrakendust. Swagger dokumentatsioon.<br />
<br />
=== 31.05-01.06.2018 ===<br />
Tegeletud XML, XSD ja XSLT failide loomisega.<br />
<br />
=== 01.06-03.06.2018 ===<br />
Tegeletud XML ja XSLT failide täiustamisega ja retsensioonide kirjutamisega.<br />
<br />
=== 05.06.2018 ===<br />
Lisatud XML retsensioon meeskonnale MOT</div>
Saasma
https://wiki.itcollege.ee/index.php?title=BeerPressure&diff=131349
BeerPressure
2018-06-05T18:31:47Z
<p>Saasma: /* Retsensioonid */</p>
<hr />
<div>== Meeskond ja rollid ==<br />
<br />
* Sigrid Aasma (arendaja)<br />
* Evelin Jõgi (arendaja)<br />
* Martin Kask (projektijuht, arendaja)<br />
* Marko Nõu (arendaja)<br />
<br />
== Idee ==<br />
'''Toidukohtade põhimenüüde ja päevapakkumiste teenus'''<br />
<br />
Soovime pakkuda toidukohtade põhimenüüde ja päevapakkumiste teenust. On olemas mitmeid kodulehti “päevapakkumised”, kus on kirjas toidukohtade päevapraed. Kuid tavaliselt sellistel lehtedel ei ole masinloetavaid andmeid ehk siis varianti, et saad saata API pihta mingi kuupäeva koos päevapraadidega andmete uuendamiseks ja saad sama API käest küsida tänaseid päevapraade. Andmeid võiks saada küsida restorani, kuupäeva, asukoha või otsisõna/otsisõnaosa põhiselt. Selline teenus lihtsustaks ka toidukohtade päevapakkumiste haldamist, kuna praegu peavad teenuse pakkujad vastavat informatsiooni uuendama mitmes erinevas kohas - nii erinevates portaalides, kui ka enda veebileheküljel. Samuti oleks toidukohtade kogu menüü haldamine ühes kohas.<br />
<br />
=== Esialgne prototüüp ===<br />
<br />
[[File:TäisKõhtProto1.mp4]]<br />
<br />
Esialgne prototüüp: [http://enos.itcollege.ee/~saasma/VR2/Proto/K%C3%B5htT%C3%A4is/#g=1&p=home navigeeritav versioon vol.1]<br />
<br />
=== Prototüübi muutus projekti käigus ===<br />
<br />
Prototüüp: [http://enos.itcollege.ee/~saasma/VR2/Proto/T%C3%A4isK%C3%B5ht/K%C3%B5htT%C3%A4is/#g=1&p=home navigeeritav versioon vol.2]<br />
<br />
== Kasutatav arendustehnoloogia ==<br />
<br />
Veebiteenuse loomisel kasutame ASP.NET Core tehnoloogiat ja kursusel õpitud arendusmustreid.<br />
<br />
Klientrakenduse loomisel kasutame Node.js + React'i.<br />
<br />
== Veebiteenuse analüüs ==<br />
Pakume toidukohtade põhimenüüde ja päevapakkumiste teenust, kuhu on kokku koondatud erinevate toidukohtade menüüd üle Eesti. Põhimenüü alla kuuluvad pikaajalised menüüd, mis kehtivad püsivalt, hooajaliselt või mingil konkreetsel nädalapäeval. Päevapakkumiste alla kuuluvad konkreetse kuupäevaga seotud päevapakkumised. Päevapakkumiste korral kuvatakse lisainfona, kas pakkumine kehtib mingis konkreetses ajavahemikus või kogu toidukoha lahtioleku aja.<br />
<br />
Eesmärk on koguda ühte kohta kokku erinevate toidukohtade menüüd ja päevapakkumised, et kliendid saaksid mugavalt ja kiiresti oma valikuid teha. Kliendid käivad enamasti päevapakkumisi söömas lõuna ajal ja selleks ettenähtud aeg on piiratud. Sellepärast on oluline, et klient saaks teha oma valiku võimalikult kiiresti. Tänu loodavale veebiteenusele ei pea kliendid käima erinevates portaalides, et tutvuda erinevate toidukohtade pakkumistega. Kuna teenust on mugav kasutada ja klient saab oma valiku kiiresti tehtud, siis tõenäoliselt teeb klient valiku selles keskkonnas olevate toiduasutuste seast. Lisaks võimaldab teenus toiduasutustel paika panna oma pikaajalisem põhimenüü ning seda rakenduses ja võimalusel ka söögikohas kuvada. Sellepärast on ka toidukohtade huvi antud keskkonnas üleval olla ja meiega oma andmeid jagada, sest see suurendab nende klientuuri ning muudab oma menüü haldamise kergemaks.<br />
<br />
Veebiteenuse loomisel lähtume eelkõige sellest, et kliendil oleks teenust mugav kasutada ja ta saaks oma valiku kiiresti tehtud. Arvestame, et kliendid on erinevad. Mõni eelistab mõnda kindlat toidukohta, sel juhul saab ta valida oma soovitud kohad ja võrrelda nende kohtade tänase päeva pakkumisi ning menüüsid. Mõnele inimesele on oluline pakutav söök ja ta eelistab pakkumist otsida prae nimetuses oleva sõna või sõnaosa järgi ning lähtuda seejärel valiku tegemisel toidukoha keskmisest hindest või toidu hinnast. Mõne kliendi jaoks on oluline hind ja selleks, et oma valikut teha sobivas hinnavahemikus on tal võimalik sisestada maksimum hinna piirang. Kindlasti on antud teenuse juures kõikide klientide jaoks oluline päevapakkumiste asukohapõhine eristatus. Kliendid, kes soovivad oma konto luua, võivad oma eelistatud valikud meelde jätta ja järgmisel korral kuvatakse neid talle automaatselt.<br />
<br />
Teenuse must-have funktsionaalsus tagab teenuse toimimise ja põhifunktsioonid. Teenuse nice-to-have funktsionaalsus annab rakendusele lisandväärtust.<br />
<br />
Arvestades pakutava teenusega, siis näeme, et aktiivseim teenuse kasutamine võib olla tööpäevadel vahemikus 11.00-15.00, kui kliendid tutvuvad päevapakkumistega. Teenus peab tekkivale koormusele vastu pidama.<br />
<br />
Teenuse pakkumine peab olema turvaline. Selle tagamiseks tuleb sisestatavaid andmeid valideerida ja andmebaasi sisestavate andmete mahtu piirata. Toidukohtade sisestatud andmed peavad olema kaitstud, et toitude koostised ei saaks avalikuks. Põhjendatud juhtudel on võimalik kasutajaid lukku panna.<br />
<br />
== Kasutajad ==<br />
<br />
<br />
* Admin - lehe administraator, kellel on õigus lehte, kasutajaid ja nende õiguseid hallata. Tema huvi on, et teenus toimiks tõrgeteta.<br />
* Toiduasutus (tasuta kasutaja) - saab hoida lehel ühte põhimenüüd ja päevapakkumisi.<br />
* Toiduasutus (tellimusega kasutaja) - saab hoida lehel piiramatu arv põhimenüüsid ja päevapakkumisi.<br />
Toiduasutused on teenusest huvitatud, et nende menüüde haldamine oleks kerge ja mugav ning nad saaksid oma klientide arvu suurendada.<br />
* Külastaja - klient, kes valib söögikohta. Tema on huvitatud eelkõige sellest, et teenust saaks kasutada mugavalt ja kiirelt ning toidukohtade valik oleks võimalikult suur.<br />
<br />
== Rakenduse must-have funktsionaalsus ==<br />
<br />
* Kasutajad saavad sisse logida<br />
* Kasutajatel on erinevad rollid: admin, toidukoht (tasuta ja tasulise tellimusega), klient<br />
* Kasutajate arvepidamine kasutajate lõikes:<br />
** sisselogimise kuupäev, kellaaeg<br />
** pakkumiste lisamine<br />
** pakkumiste muutmine<br />
** pakkumiste kustutamine<br />
** õiguste kehtimise periood (tasuta ja tellimusega toidukoht)<br />
** pakkumistele klikkimise arv<br />
* Kasutajaid on võimalik hallata:<br />
** kasutajale õiguste andmine (menüüde arvu suurendamine, tellimusega toidukohal), rolli määramine<br />
** Kasutajat on võimalik piirata: õiguseid piirata (piiratud menüüde arv, tasuta liitunud toidukohal) ja lukku panna<br />
* Päevapakkumisi/menüüsid saab küsida: <br />
** toidukoha järgi, <br />
** kuupäeva põhiselt (ainult päevapakkumisi), <br />
** asukoha põhiselt,<br />
** toidu nimetuses esineva otsisõna/otsisõna osa põhiselt,<br />
** hinna põhiselt (max hinna piirang).<br />
* Klientrakenduses realiseeritakse CRUD meetodid (menüüsid/päevapakkumisi saab sisestada, lugeda, uuendada, kustutada)<br />
* Toidukohale saab anda hindeid ja kuvatakse keskmist hinnet.<br />
* Toidule saab anda hindeid ja kuvatakse keskmist hinnet.<br />
<br />
== Nice-to-have funktsionaalsus ==<br />
<br />
* Info selle kohta, kas päevapakkumine on otsas<br />
* Päevapakkumisi/menüüsid saab kommenteerida ja neid kommentaare kuvatakse avalikult.<br />
* Söögikohtade kodulehtedelt otsimise script, mis genereerib juba olemasolevate kodulehtede baasil päevamenüüsid.<br />
* Toiduvaliku piiramine allergeenide/vegan/jms. koostisosade põhiselt.<br />
* Aruandlused ja võrdlused toidukohtadele, et võrrelda end konkurentidega.<br />
* Teenus soovitab toidukohtadele nende varasemate päevapraadide populaarsuse alusel uue nädala menüüd.<br />
* Erinevad toidukohtade/toitude pingeread klientidele, et anda valikuteks ideid.<br />
* Soovitused klientidele, mida teised kliendid sarnaste eelistustega on veel valinud.<br />
<br />
== Andmebaasi ülesehitus - projekti algus ==<br />
<br />
[[File: BeerPressureAndmebaasimudel.png]]<br />
<br />
== Andmebaasi ülesehitus - projekti lõpp ==<br />
<br />
[[File: Ta2isKo6ht-DB-FINAL.png]]<br />
<br />
== Projekti repository ==<br />
<br />
https://github.com/sikumiku/TaisKohtApi<br />
<br />
Zip fail saadaval: <br />
(master branchi viimane commit esitamise ajal)<br />
https://github.com/sikumiku/TaisKohtApi/archive/61438e187a1a972410c8a3bc6274d69489d00aa6.zip<br />
<br />
== API v1 dokumentatsioon ==<br />
<br />
===Security===<br />
'''POST /api/account/register'''<br />
<source><br />
Params: RegisterViewModel registerViewModel<br />
<br />
Returns: token<br />
</source><br />
<br />
'''POST /api/account/login'''<br />
<source> <br />
Params: LoginViewModel model<br />
<br />
Returns: token<br />
</source><br />
<br />
'''POST /api/account/logout'''<br />
<source> <br />
Params: -<br />
<br />
Returns: -<br />
</source><br />
<br />
===Accounts===<br />
'''GET /api/v1/accounts/getAllUsersInRole'''<br />
<source> <br />
Params: string role<br />
<br />
Returns: List<UserDTO><br />
</source><br />
<br />
'''GET /api/v1/accounts/{id}'''<br />
<source> <br />
Params: string id<br />
<br />
Returns: UserDTO<br />
</source><br />
<br />
'''PUT /api/v1/accounts/{id}'''<br />
<source> <br />
Params: string id, UpdateUserDTO userDTO<br />
<br />
Returns: -<br />
</source><br />
<br />
'''POST /api/v1/accounts/addRole'''<br />
<source> <br />
Params: string role<br />
<br />
Returns: -<br />
</source><br />
<br />
'''POST /api/v1/accounts/addRoleToUser'''<br />
<source> <br />
Params: string role, string userId<br />
<br />
Returns: UserDTO<br />
</source><br />
<br />
'''DELETE /api/v1/accounts/deactivate/{id}'''<br />
<source> <br />
Params: string id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Promotions===<br />
'''GET /api/v1/promotions '''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<PromotionDTO> <br />
</source><br />
<br />
'''GET /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: PromotionDTO<br />
</source><br />
<br />
'''POST /api/v1/promotions'''<br />
<source> <br />
Params: PromotionDTO promotionDTO<br />
<br />
Returns: PromotionDTO newPromotion<br />
</source><br />
<br />
'''PUT /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id, PromotionDTO promotionDTO<br />
<br />
Returns: PromotionDTO updatedPromotion<br />
</source><br />
<br />
'''DELETE /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Restaurants===<br />
'''GET /api/v1/restaurants'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<SimpleRestaurantDTO><br />
</source><br />
<br />
'''GET /api/v1/restaurants/search?name=th'''<br />
<source> <br />
Params: string name<br />
<br />
Returns: List<SimpleRestaurantDTO> result<br />
</source><br />
<br />
'''GET /api/v1/restaurants/top'''<br />
<source> <br />
Params: int amount<br />
<br />
Returns: List<SimpleRestaurantDTO> result<br />
</source><br />
<br />
'''GET /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: RestaurantDTO r<br />
</source><br />
<br />
'''POST /api/v1/restaurants/addUserToRestaurant'''<br />
<source> <br />
Params: int id, string userId<br />
<br />
Returns: -<br />
</source><br />
<br />
'''POST /api/v1/restaurants'''<br />
<source> <br />
Params: PostRestaurantDTO restaurantDTO<br />
<br />
Returns: RestaurantDTO newRestaurant<br />
</source><br />
<br />
'''PUT /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id, PostRestaurantDTO restaurantDTO<br />
<br />
Returns: PostRestaurantDTO updatedRestaurantDTO<br />
</source><br />
<br />
'''DELETE /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Menus===<br />
'''GET /api/v1/menus'''<br />
<source><br />
Params: -<br />
<br />
Returns: List<MenuDTO><br />
</source><br />
<br />
'''GET /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: MenuDTO menuDTO<br />
</source><br />
<br />
'''POST /api/v1/menus'''<br />
<source> <br />
Params: PostMenuDTO menuDTO<br />
<br />
Returns: MenuDTO newMenu<br />
</source><br />
<br />
'''PUT /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id, PostMenuDTO menuDTO<br />
<br />
Returns: MenuDTO updatedMenu<br />
</source><br />
<br />
'''PUT api/v1/Menus/{id}/Dishes'''<br />
<source> <br />
Params: int menuId, int[] dishIds<br />
<br />
Returns: -<br />
</source><br />
<br />
'''DELETE /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Dishes===<br />
'''GET /api/v1/dishes'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<DishDTO><br />
</source><br />
<br />
'''GET /api/v1/dishes/daily'''<br />
<source> <br />
Params: bool vegan, bool glutenFree, bool lactoseFree<br />
<br />
Returns: List<SimpleDishDTO> result<br />
</source><br />
<br />
'''GET: api/v1/dishes/search?title=th&priceLimit=null'''<br />
<source> <br />
Params: string title, decimal? priceLimit<br />
<br />
Returns: List<DishDTO> result<br />
</source><br />
<br />
'''GET /api/v1/dishes/top'''<br />
<source> <br />
Params: int amount<br />
<br />
Returns: List<DishDTO> result<br />
</source><br />
<br />
'''GET /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: DishDTO dishDTO<br />
</source><br />
<br />
'''POST /api/v1/dishes'''<br />
<source> <br />
Params: PostDishDTO dishDTO<br />
<br />
Returns: DishDTO newDish<br />
</source><br />
<br />
'''PUT /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id, PostDishDTO dishDTO<br />
<br />
Returns: DishDTO updatedDish<br />
</source><br />
<br />
'''PUT api/v1/Dishes/{id}/Ingredients'''<br />
<source> <br />
Params: int dishId, PostIngredientForDishDTO[] ingredients<br />
<br />
Returns: -<br />
</source><br />
<br />
'''DELETE /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Ingredients===<br />
'''GET /api/v1/ingredients'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<IngredientDTO><br />
</source><br />
<br />
'''GET /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: IngredientDTO i<br />
</source><br />
<br />
'''POST /api/v1/ingredients'''<br />
<source> <br />
Params: PostIngredientDTO ingredientDTO<br />
<br />
Returns: IngredientDTO newIngredient<br />
</source><br />
<br />
'''PUT /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id, PostIngredientDTO ingredientDTO<br />
<br />
Returns: IngredientDTO updatedIngredient<br />
</source><br />
<br />
'''DELETE /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Ratings===<br />
'''GET /api/v1/ratings'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<RatingLogDTO><br />
</source><br />
<br />
'''GET /api/v1/ratings/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: RatingLogDTO dto<br />
</source><br />
<br />
'''POST /api/v1/ratings'''<br />
<source> <br />
Params: RatingLogForEntityDTO ratingDTO<br />
<br />
Returns: RatingLogDTO newRating<br />
</source><br />
<br />
'''PUT api/v1/ratings/{id}'''<br />
<source> <br />
Params: int id, RatingLogForEntityDTO ratingDTO<br />
<br />
Returns: RatingLogDTO updatedRating<br />
</source><br />
<br />
'''DELETE api/v1/ratings/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===RequestLog===<br />
'''GET: api/v1/usageData/{userId}'''<br />
<source> <br />
Params: string userId<br />
<br />
Returns: List<RequestLogDTO><br />
</source><br />
<br />
== Lõpptoote kasutusjuhend ==<br />
<br />
* Kloonida kohalikku arvutisse repository aadressilt [https://github.com/sikumiku/TaisKohtApi https://github.com/sikumiku/TaisKohtApi]<br />
* Installida NodeJS<br />
* <source>npm install webpack -g</source><br />
* <source>npm install -cli -g</source><br />
* Frontend rakenduse kasutamiseks valida Startup meetoditest IIS Express, veebiteenuse ja Swaggeri kasutamiseks käivitada Api Swagger<br />
* Esimese admin kasutaja loomiseks tuleb kasutaja registreerida admin@gmail.com e-mailiga<br />
<br />
== XML/XSD/XSLT ==<br />
<br />
=== XML ===<br />
<br />
<source><?xml version="1.0" encoding="utf-8" ?><br />
<restaurants><br />
<restaurant id="1" url="https://kuuspelmeeni.ee" contactnumber="507783342" email="kuuspelmeeni@gmail.com"><br />
<name><![CDATA[Kuus Pelmeeni]]></name><br />
<menus><br />
<menu id="1" repetitioninterval="30"><br />
<name><![CDATA[Päevamenüü]]></name><br />
<activefrom>2018-05-27T12:00:00</activefrom><br />
<activeto>2018-05-28T12:00:00</activeto><br />
<dishes><br />
<dish id="1" vegan="false" lactosefree="false" glutenfree="false" daily="true" kcal="550" dailyprice="4"><br />
<title><![CDATA[8 pelmeeni]]></title><br />
<description><![CDATA[8 pelmeeni 6 asemel serveeritud tervisliku koguse hapukoore ja tilliga]]></description><br />
<availablefrom>2018-05-27T12:00:00</availablefrom><br />
<availableto>2018-05-28T12:00:00</availableto><br />
<ingredients><br />
<ingredient id="1" amountunit="g"><br />
<name>Sealiha</name><br />
<description>Rakvere sealiha</description><br />
</ingredient><br />
<ingredient id="2" amountunit="g"><br />
<name>Hapukoor</name><br />
<description>Alma hapukoor</description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="9"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Parim päevaroog viimasel ajal.]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
</comments><br />
</rating><br />
<promotion id="1" type="visual" classname="bold-red-border-2px"><br />
<name>2px red border</name><br />
<description><![CDATA[Displays a 2px wide red border around the component that is promoted.]]></description><br />
<validto>2018-06-25T12:00:00</validto><br />
</promotion><br />
</dish><br />
<dish id="2" vegan="true" lactosefree="true" glutenfree="true" daily="true" kcal="320" price="4"><br />
<title><![CDATA[Kurgisalat]]></title><br />
<description><![CDATA[Erinevatel viisidel töödeldud kurk serveeritud koos jõhvikatega. Tervislik amps.]]></description><br />
<availablefrom>2018-05-27T12:00:00</availablefrom><br />
<availableto>2018-05-28T12:00:00</availableto><br />
<ingredients/><br />
<rating ratingvalue="4"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Jäin veel väga näljaseks peale selle söömist.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
</dishes><br />
</menu><br />
<menu id="2"><br />
<name><![CDATA[Põhimenüü]]></name><br />
<dishes><br />
<dish id="4" vegan="false" lactosefree="false" glutenfree="false" daily="false" kcal="550" price="5"><br />
<title><![CDATA[6 pelmeeni]]></title><br />
<description><![CDATA[6 pelmeeni serveeritud tervisliku koguse hapukoore ja tilliga]]></description><br />
<ingredients><br />
<ingredient id="1" amountunit="g"><br />
<name>Sealiha</name><br />
<description>Rakvere sealiha</description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="9.5"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Käin seda iga päev söömas.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Parim toit selles restoranis.]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
<dish id="5" vegan="false" lactosefree="false" glutenfree="true" daily="false" kcal="460" price="3.8"><br />
<title><![CDATA[Kartulisalat]]></title><br />
<description><![CDATA[Sinki sisaldav traditsiooniline kartulisalat.]]></description><br />
<ingredients/><br />
</dish><br />
<dish id="6" vegan="false" lactosefree="false" glutenfree="false" daily="false" kcal="610" price="3.9"><br />
<title><![CDATA[Šokolaadikook]]></title><br />
<description><![CDATA[Ahvatlev glasuuritud šokolaadikook.]]></description><br />
<ingredients/><br />
<rating ratingvalue="7.8"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Šokolaadikooki on keeruline metsa keerata.]]></commenttext><br />
<username>mutikas3</username><br />
<userid>3a29b94a-3f17-469d-a44d-f7d85e98dd3e</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
</dishes><br />
</menu><br />
</menus><br />
<dishes/><br />
<address id="1" country="Eesti"><br />
<addressfirstline>Tatari 12</addressfirstline><br />
<locality>Tallinn</locality><br />
<postcode>10132</postcode><br />
<region>Harjumaa</region><br />
</address><br />
<promotion/><br />
<rating ratingvalue="7.5"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Parim restoran üldse!]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Ma sain ainult 5 pelmeeni. Ootasin kuute.]]></commenttext><br />
<username>kyllikekallike1</username><br />
<userid>6af271dd-0e11-4ae6-98be-111762664318</userid><br />
</comment><br />
</comments><br />
</rating><br />
</restaurant><br />
<restaurant id="2" url="https://kolmkokka.ee" contactnumber="6522351" email="kolmkokka@gmail.com"><br />
<name><![CDATA[Kolm kokka]]></name><br />
<menus/><br />
<dishes><br />
<dish id="7" vegan="false" lactosefree="true" glutenfree="false" daily="false" kcal="470" price="14"><br />
<title><![CDATA[Ahjulõhe juurikatega]]></title><br />
<description><![CDATA[Ahjulõhe serveeritud püreestatud porgandite ja lillkapsaga.]]></description><br />
<ingredients><br />
<ingredient id="11" amountunit="tk" amount="1"><br />
<name>Ahjulõhe</name><br />
<description><![CDATA[Värske ahjulõhe]]></description><br />
</ingredient><br />
<ingredient id="12" amountunit="g"><br />
<name>Püreestatud porgand</name><br />
<description><![CDATA[Eesti porgand, mis on kergelt püreestatud]]></description><br />
</ingredient><br />
<ingredient id="13" amountunit="g"><br />
<name>Püreestatud lillkapsas</name><br />
<description><![CDATA[Eesti lillkapsas, mis on kergelt püreestatud ja maitsestatud]]></description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="8.9"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Kindlasti minu üks lemmikuid.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Pole midagi halba öelda.]]></commenttext><br />
<username>tiiuviiu</username><br />
<userid>0730a7b7-3a9c-4e26-962f-da9a8daeab8a</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
<dish id="8" vegan="true" lactosefree="true" glutenfree="true" daily="true" dailyprice="5"><br />
<title><![CDATA[Ingverisupp]]></title><br />
<description><![CDATA[Ingveriga vürtsistatud ingverisupp, mis viib keele alla.]]></description><br />
<availablefrom>2018-05-25T12:00:00</availablefrom><br />
<availableto>2018-06-25T12:00:00</availableto><br />
<ingredients><br />
<ingredient id="14" amountunit="g" amount="20"><br />
<name>Ingver</name><br />
<description><![CDATA[Tükeldatud ingver]]></description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="6"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Liiga palju ingverit.]]></commenttext><br />
<username>kyllikekallike1</username><br />
<userid>6af271dd-0e11-4ae6-98be-111762664318</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
<dish id="9" vegan="false" lactosefree="false" glutenfree="true" daily="false" kcal="340" price="4.5"><br />
<title><![CDATA[Apelsinijäätis]]></title><br />
<description><![CDATA[Apelsinimaitseline jäätis serveeritud riivitud apelsinikoorega.]]></description><br />
<ingredients/><br />
<rating ratingvalue="8"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Väga huvitav magustoit, prooviks veel.]]></commenttext><br />
<username>mutikas3</username><br />
<userid>3a29b94a-3f17-469d-a44d-f7d85e98dd3e</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Üks mu lemmikuid magustoite.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
</dishes><br />
<address id="2" country="Eesti"><br />
<addressfirstline>Laia 12</addressfirstline><br />
<locality>Tallinn</locality><br />
<postcode>13022</postcode><br />
<region>Harjumaa</region><br />
</address><br />
<promotion/><br />
<rating ratingvalue="8.1"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Hinnad on natuke liiga kallid minu jaoks, aga toit om maitsev.]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Ma kindlasti telliks kala uuesti. Väga mahlakas oli.]]></commenttext><br />
<username>kyllikekallike1</username><br />
<userid>6af271dd-0e11-4ae6-98be-111762664318</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Asukoht oli päris tore. Miljöö ka.]]></commenttext><br />
<username>mutikas3</username><br />
<userid>3a29b94a-3f17-469d-a44d-f7d85e98dd3e</userid><br />
</comment><br />
</comments><br />
</rating><br />
</restaurant><br />
</restaurants></source><br />
<br />
=== XSD ===<br />
<br />
<source><?xml version="1.0" encoding="utf-8"?><br />
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema"><br />
<xs:element name="restaurants"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="restaurant"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="menus"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="menu"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="activefrom" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="activeto" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="dishes"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="dish"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="title" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="availablefrom" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="availableto" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="servetime" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="ingredients"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="ingredient"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="amountunit" type="xs:string" use="required" /><br />
<xs:attribute name="amount" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="rating" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="comments"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="comment"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="commenttext" type="xs:string" /><br />
<xs:element name="username" type="xs:string" /><br />
<xs:element name="userid" type="xs:string" /><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="ratingvalue" type="xs:decimal" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="validto" type="xs:dateTime" minOccurs="0" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="type" type="xs:string" use="required" /><br />
<xs:attribute name="classname" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="vegan" type="xs:boolean" use="optional" /><br />
<xs:attribute name="lactosefree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="glutenfree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="daily" type="xs:boolean" use="optional" /><br />
<xs:attribute name="kcal" type="xs:int" use="optional" /><br />
<xs:attribute name="weightg" type="xs:decimal" use="optional" /><br />
<xs:attribute name="price" type="xs:decimal" use="optional" /><br />
<xs:attribute name="dailyprice" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="validto" type="xs:dateTime" minOccurs="0" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="type" type="xs:string" use="required" /><br />
<xs:attribute name="classname" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="repetitioninterval" type="xs:int" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="dishes"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="dish"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="title" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="availablefrom" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="availableto" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="servetime" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="ingredients"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="ingredient"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="amountunit" type="xs:string" use="required" /><br />
<xs:attribute name="amount" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="rating"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="comments"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="comment"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="commenttext" type="xs:string" /><br />
<xs:element name="username" type="xs:string" /><br />
<xs:element name="userid" type="xs:string" /><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="ratingvalue" type="xs:decimal" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="validto" type="xs:dateTime" minOccurs="0" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="type" type="xs:string" use="required" /><br />
<xs:attribute name="classname" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="vegan" type="xs:boolean" use="optional" /><br />
<xs:attribute name="lactosefree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="glutenfree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="daily" type="xs:boolean" use="optional" /><br />
<xs:attribute name="kcal" type="xs:int" use="optional" /><br />
<xs:attribute name="weightg" type="xs:decimal" use="optional" /><br />
<xs:attribute name="price" type="xs:decimal" use="optional" /><br />
<xs:attribute name="dailyprice" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="address"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="addressfirstline" type="xs:string" /><br />
<xs:element name="locality" type="xs:string" /><br />
<xs:element name="postcode" type="xs:string" /><br />
<xs:element name="region" type="xs:string" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="country" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion" /><br />
<xs:element name="rating" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="comments"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="comment"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="commenttext" type="xs:string" /><br />
<xs:element name="username" type="xs:string" /><br />
<xs:element name="userid" type="xs:string" /><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="ratingvalue" type="xs:decimal" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="url" type="xs:string" use="required" /><br />
<xs:attribute name="contactnumber" type="xs:string" use="required" /><br />
<xs:attribute name="email" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:schema></source><br />
<br />
=== XSLT(HTML) ===<br />
<br />
<source><?xml version="1.0" encoding="utf-8" ?><br />
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:msxsl="urn:schemas-microsoft-com:xslt" exclude-result-prefixes="msxsl"><br />
<xsl:output method="html" indent="yes"/><br />
<xsl:template match="/restaurants"><br />
<html><br />
<head><br />
<title>Täis Kõht</title><br />
</head><br />
<body><br />
<xsl:for-each select="restaurant"><br />
<h1 style="color:DodgerBlue"><br />
<xsl:value-of select="name"/><br />
</h1><br />
<div><br />
<xsl:value-of select="@url"/><br />
</div><br />
<div><br />
<xsl:text>Kontakt number: </xsl:text><br />
<xsl:value-of select="@contactnumber"/><br />
</div><br />
<div><br />
<xsl:text>email: </xsl:text><br />
<xsl:value-of select="@email"/><br />
</div><br />
<div><br />
<xsl:text>Aadress: </xsl:text><br />
<xsl:value-of select="address/addressfirstline"/><br />
<xsl:text>, </xsl:text><br />
<xsl:value-of select="address/locality"/><br />
<xsl:text>, </xsl:text><br />
<xsl:value-of select="address/postcode"/><br />
<xsl:text>, </xsl:text><br />
<xsl:value-of select="address/@country"/><br />
</div><br />
<br />
<xsl:choose><br />
<xsl:when test="menus/menu"><br />
<xsl:for-each select="menus/menu"><br />
<xsl:sort select="name"/><br />
<h3><br />
<xsl:value-of select="name"/><br />
</h3><br />
<br />
<xsl:if test="activefrom != '' and activeto != ''"><br />
<xsl:text> </xsl:text><br />
<xsl:value-of select="substring(activefrom,1,10)"/><br />
<xsl:text> kuni </xsl:text><br />
<xsl:value-of select="substring(activeto,1,10)"/><br />
</xsl:if><br />
<br />
<ul><br />
<xsl:for-each select="dishes/dish"><br />
<xsl:sort select="title"/><br />
<br />
<xsl:if test="availablefrom != '' and availableto != ''"><br />
<xsl:value-of select="substring(availablefrom,1,10)"/><br />
<xsl:text> kuni </xsl:text><br />
<xsl:value-of select="substring(availableto,1,10)"/><br />
</xsl:if><br />
<br />
<li><br />
<span style="font-weight:bold"><br />
<xsl:value-of select="title"/><br />
</span><br />
<xsl:text> - </xsl:text><br />
<xsl:value-of select="description"/><br />
<xsl:text> </xsl:text><br />
<span style="font-weight:bold"><br />
<xsl:if test="@glutenfree='true'"><br />
<xsl:text>G </xsl:text><br />
</xsl:if><br />
<xsl:if test="@lactosefree='true'"><br />
<xsl:text>L </xsl:text><br />
</xsl:if><br />
<xsl:if test="@vegan='true'"><br />
<xsl:text>V </xsl:text><br />
</xsl:if><br />
</span><br />
</li><br />
<br />
<xsl:for-each select="ingredients/ingredient"><br />
<xsl:value-of select="name"/><br />
<xsl:if test="position()!=last()"><br />
<xsl:text>, </xsl:text><br />
</xsl:if><br />
</xsl:for-each><br />
<br />
<p style="font-weight:bold"><br />
<xsl:text>Hind: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="@price!=''"><br />
<xsl:value-of select="@price"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>-</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
<xsl:text> / Päevapakkumise hind: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="@dailyprice!=''"><br />
<xsl:value-of select="@dailyprice"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>-</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
</p><br />
<br />
<div style="background-color:LightGray;"><br />
<xsl:text>Hinnang praele: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="rating/@ratingvalue!=''"><br />
<xsl:value-of select="rating/@ratingvalue"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>Ei ole veel hinnatud!</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
<br />
<br/><br />
<xsl:for-each select="rating/comments/comment"><br />
<xsl:value-of select="username"/><br />
<xsl:text>: </xsl:text><br />
<xsl:value-of select="commenttext"/><br />
<br/><br />
</xsl:for-each><br />
</div><br />
<br/><br />
</xsl:for-each><br />
</ul><br />
</xsl:for-each><br />
</xsl:when><br />
<xsl:otherwise><br />
<ul><br />
<xsl:for-each select="dishes/dish"><br />
<xsl:sort select="title"/><br />
<br />
<xsl:if test="availablefrom != '' and availableto != ''"><br />
<xsl:value-of select="substring(availablefrom,1,10)"/><br />
<xsl:text> kuni </xsl:text><br />
<xsl:value-of select="substring(availableto,1,10)"/><br />
</xsl:if><br />
<br />
<li><br />
<span style="font-weight:bold"><br />
<xsl:value-of select="title"/><br />
</span><br />
<xsl:text> - </xsl:text><br />
<xsl:value-of select="description"/><br />
<xsl:text> </xsl:text><br />
<span style="font-weight:bold"><br />
<xsl:if test="@glutenfree='true'"><br />
<xsl:text>G </xsl:text><br />
</xsl:if><br />
<xsl:if test="@lactosefree='true'"><br />
<xsl:text>L </xsl:text><br />
</xsl:if><br />
<xsl:if test="@vegan='true'"><br />
<xsl:text>V </xsl:text><br />
</xsl:if><br />
</span><br />
</li><br />
<br />
<xsl:for-each select="ingredients/ingredient"><br />
<xsl:value-of select="name"/><br />
<xsl:if test="position()!=last()"><br />
<xsl:text>, </xsl:text><br />
</xsl:if><br />
</xsl:for-each><br />
<br />
<p style="font-weight:bold"><br />
<xsl:text>Hind: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="@price!=''"><br />
<xsl:value-of select="@price"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>-</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
<xsl:text> / Päevapakkumise hind: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="@dailyprice!=''"><br />
<xsl:value-of select="@dailyprice"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>-</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
</p><br />
<br />
<div style="background-color:LightGray;"><br />
<xsl:text>Hinnang praele: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="rating/@ratingvalue!=''"><br />
<xsl:value-of select="rating/@ratingvalue"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>Ei ole veel hinnatud!</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
<br />
<br/><br />
<xsl:for-each select="rating/comments/comment"><br />
<xsl:value-of select="username"/><br />
<xsl:text>: </xsl:text><br />
<xsl:value-of select="commenttext"/><br />
<br/><br />
</xsl:for-each><br />
</div><br />
<br/><br />
</xsl:for-each><br />
</ul><br />
</xsl:otherwise><br />
</xsl:choose><br />
<br />
<div style="background-color:LightGray;"><br />
<xsl:text>Hinnang restoranile: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="rating/@ratingvalue!=''"><br />
<xsl:value-of select="rating/@ratingvalue"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>Ei ole veel hinnatud!</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
<br />
<br />
<br/><br />
<xsl:for-each select="rating/comments/comment"><br />
<xsl:value-of select="username"/><br />
<xsl:text>: </xsl:text><br />
<xsl:value-of select="commenttext"/><br />
<br/><br />
</xsl:for-each><br />
</div><br />
<br />
<p><br />
<xsl:text>*G - gluteenivaba, </xsl:text><br />
<xsl:text>L - laktoosivaba, </xsl:text><br />
<xsl:text>V - vegan </xsl:text><br />
</p><br />
<br />
</xsl:for-each><br />
</body><br />
</html><br />
</xsl:template><br />
</xsl:stylesheet></source><br />
<br />
=== XSLT(XML) ===<br />
<br />
XML'is kuvatakse elemendid ja atribuudid eesti keeles. Kuvatakse restorani andmed ja toidud, mille hinnang on 8 või rohkem punkti.<br />
<br />
<source><?xml version="1.0" encoding="utf-8" ?><br />
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"<br />
xmlns:msxsl="urn:schemas-microsoft-com:xslt" exclude-result-prefixes="msxsl"><br />
<xsl:output method="xml" indent="yes"/><br />
<br />
<xsl:template match="/restaurants"><br />
<restoranid><br />
<xsl:for-each select="restaurant"><br />
<restoran url="{@url}" telefon="{@contactnumber}" email="{@email}"><br />
<nimi><br />
<xsl:value-of select="name"/><br />
</nimi><br />
<aadress><br />
<postiaadress><br />
<xsl:value-of select="address/addressfirstline"/><br />
</postiaadress><br />
<linn><br />
<xsl:value-of select="address/locality"/><br />
</linn><br />
<indeks><br />
<xsl:value-of select="address/postcode"/><br />
</indeks><br />
<riik><br />
<xsl:value-of select="address/@country"/><br />
</riik><br />
</aadress><br />
<br />
<parimadToidud><br />
<xsl:choose><br />
<xsl:when test="menus/menu/dishes/dish"><br />
<xsl:for-each select="menus/menu/dishes/dish"><br />
<xsl:if test="rating/@ratingvalue &gt;= 8.0"><br />
<heaToit hinnang="{rating/@ratingvalue}" paevapakkumiseHind="{@dailyprice}" hind="{@price}" <br />
vegan="{@vegan}" laktoosivaba="{@lactosefree}" gluteenivaba="{@glutenfree}"><br />
<nimi><br />
<xsl:value-of select="title"/><br />
</nimi><br />
<kirjeldus><br />
<xsl:value-of select="description"/><br />
</kirjeldus><br />
</heaToit><br />
</xsl:if><br />
</xsl:for-each><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:for-each select="dishes/dish"><br />
<xsl:if test="rating/@ratingvalue &gt;= 8.0"><br />
<heaToit hinnang="{rating/@ratingvalue}" paevapakkumiseHind="{@dailyprice}" hind="{@price}" <br />
vegan="{@vegan}" laktoosivaba="{@lactosefree}" gluteenivaba="{@glutenfree}"><br />
<nimi><br />
<xsl:value-of select="title"/><br />
</nimi><br />
<kirjeldus><br />
<xsl:value-of select="description"/><br />
</kirjeldus><br />
</heaToit><br />
</xsl:if><br />
</xsl:for-each><br />
</xsl:otherwise><br />
</xsl:choose><br />
</parimadToidud><br />
</restoran><br />
</xsl:for-each><br />
</restoranid><br />
</xsl:template><br />
</xsl:stylesheet><br />
</source><br />
<br />
== Retsensioonid ==<br />
<br />
'''Veebiteenuse retsensioon:''' [https://wiki.itcollege.ee/index.php/Talk:MOT#Veebiteenuse_retsensensioon_by_meeskond_BeerPressure: Team MOT retsensioon]<br />
<br />
'''Klientrakenduse retsensioon:''' [https://wiki.itcollege.ee/index.php/Talk:Kuldneloojang#Klientrakenduse_retsensensioon_by_meeskond_BeerPressure: Team Kuldneloojang retsensioon]<br />
<br />
'''XML retsensioon:''' [https://wiki.itcollege.ee/index.php/Talk:MOT#XML_retsensioon_by_meeskond_BeerPressure: Team MOT retsensioon]<br />
<br />
== Logiraamat ==<br />
<br />
===07.02.2018===<br />
Gupi loomine ning suhtluskanali seadistamine<br />
<br />
=== 24.03.2018 ===<br />
Trello boardi loomine<br />
<br />
=== 25.03.2018 ===<br />
Wiki lehe loomine. Esimene tõsisem projekti koosolek ning tegevuskava paika panemine.<br />
<br />
=== 26.03.2018 ===<br />
<br />
Alustasime veebiteenuse analüüsiga ja funktsionaalsuse kirjeldamisega.<br />
<br />
=== 27.03.2018 ===<br />
Täiendasime veebiteenuse analüüsi.<br />
<br />
Esmase andmebaasi mudeli koostamine.<br />
<br />
Postitatud esimeste analüüsi arutelude põhjal valminud algne prototüüp.<br />
<br />
=== 30.03.2018 ===<br />
Valmis andmebaasimudel.<br />
<br />
=== 08.04.2018 ===<br />
Tehtud muudatused analüüsis vastavalt tagasisidele.<br />
<br />
=== 19.04.2018 ===<br />
Loodud projekti põhi koos domeenimudelitega. Projekt lisatud Githubi: https://github.com/sikumiku/TaisKohtApi<br />
<br />
=== 05-06.05.2018 ===<br />
Osalesime hackathonil. Lisatud controllerid, service'id koos vajalike kihtidega.<br />
<br />
=== 16.05.2018 ===<br />
Uuendatud andmebaasimudelit, DTO'sid.<br />
<br />
=== 18-19.05.2018 ===<br />
Lisatud klientrakendus, security, äriloogikat.<br />
<br />
=== 20.05.2018 ===<br />
Lisatud API dokumentatsioon.<br />
<br />
=== 22-24.05.2018 ===<br />
Uuendatud contoller'eid, service'id.<br />
<br />
=== 25-27.05.2018 ===<br />
Uuendatud contoller'eid, service'id. Lisatud kasutajate ja rollide kontrolle meetoditesse. Täiustatud klientrakendust. Swagger dokumentatsioon.<br />
<br />
=== 31.05-01.06.2018 ===<br />
Tegeletud XML, XSD ja XSLT failide loomisega.<br />
<br />
=== 01.06-03.06.2018 ===<br />
Tegeletud XML ja XSLT failide täiustamisega ja retsensioonide kirjutamisega.</div>
Saasma
https://wiki.itcollege.ee/index.php?title=Talk:MOT&diff=131348
Talk:MOT
2018-06-05T18:30:46Z
<p>Saasma: /* XML retsensioon by meeskond BeerPressure: */</p>
<hr />
<div><br />
== Veebiteenuse retsensensioon by meeskond BeerPressure: ==<br />
<br />
'''Üldiselt:'''<br />
* Puudub README vms. Dokumentatsioon projekti ülespanemiseks ja seadistamiseks.<br />
* Rollide loomine vigane, seda võiks teha eraldi failis, mis on DAL.App.EF projektis (kasutasime algul sama lähenemist nagu antud projekt). Takistab esialgset andmebaasi uuendust, kui rollid veel puuduvad. Rakenduse installimine tarnitud kujul ei õnnestunud. Selleks et Nuget Package Manageri käsk Update-Database töötaks pidi ajutiselt välja kommenteerima Startup.cs faili rea 153 (// CreateRoles(services).Wait();).<br />
<br />
'''Andmebaasist:'''<br />
* Üldiselt paneksin igale väljale juurde AddTime ja UpdateTime see on hea tava millest korduvalt ka andmebaasi alustes räägiti ja rõhutati. Kuid antud projekti juures on see pigem nice-to-have.<br />
<br />
'''Olemitest:'''<br />
* Kui juba domainis nimetate kõik olemid singulaarselt siis võiks ju sama teha ka andmebaasis - lisakeerukuse loomine kohas kus see ei ole vajalik.<br />
* Entity-te arv oli nõutust väiksem - Kokku 8 olemit, millest 1 on many-to-many liittabel ja 1 otsene koopia Identity framework Users tabelist. <br />
* Olem People mis on põhimõtteliselt Usersite laiend ja sisaldab ka viidet Identity tabelile ApplicationUsers (ApplicationUserId). Juhul kui see on mõeldud rakendusega mitte registreerunud kasutajate võistlusele kirja panemiseks, siis oleks olemil rohkem infot vaja - vähemalt mingigi kontakti väli (email |/& tel.nr. |/& aadress). <br />
* Competition.Comment on varchar(100) - võiks ja peaks olema varchar(1000)<br />
* Competition.CompetitionPlaceId - kui võistluse toimumiskoht mingil põhjusel peaks keelduma korraldusest või kui võistlust alles pannakse kokku ja ei ole veel teada kus see toimuma saab siis peaks saama sinna sisestada NULL väärtust.<br />
* Competition.Time -> Mis aega see näitab? Property nimest seda välja ei loe. Kui StartTime, siis kus on EndTime või Duration?<br />
* CompetitionPlace.County -> int type enum default väärtus on 0, kuna see pole aga enumi klassis implementeeritud põhjustab see tn. kunagi kuskil vea. (Millisele maakonnale vastab 0?) See on teada tuntud probleem millele google annab hõlpsasti erinevaid lahendusi: näiteks [https://stackoverflow.com/questions/24350377/entity-framework-6-code-first-required-enum-data-type-not-working?utm_medium=organic&utm_source=google_rich_qa&utm_campaign=google_rich_qa siin] ja [https://stackoverflow.com/questions/529929/choosing-the-default-value-of-an-enum-type-without-having-to-change-values/529937?utm_medium=organic&utm_source=google_rich_qa&utm_campaign=google_rich_qa siin].<br />
* Väljad mis viitavad Identity framework olemitele läbi nende ID-de ei peaks olema nvarchar(max) vaid nvarchar(450) (kuigi isegi see on reaalsuses liiga pikk).<br />
* PersonInTeam.PersonInTeamId -> ei peaks olema sellist välja üldse, selle tabeli PK peaks olema kombinatsioon nende tabeli ID-st mida ta ühendab. Praegu ei ole unique indeksit üle nende, mis tähendab et sama inimene saab mitu korda sama tiimiga liituda.<br />
* Participations - Miks selline nimi, kui registreerimine juba oli? Saan aru et selles olemis tahetakse säilitada võistluse tulemusi. Siis võiks ju juba olla CompetitionResults. Kus on aga saavutatud koha numbri talletamine? Kui võistluse punktid ja ajad on kõik kirja saadud siis tahaks ju tulemusi ka kuidagi näha ja võrrelda ning selle võrdluse tulemi kuhugi salvestada.<br />
* Participations.Time - Mis aega näitab? Eeldan, et võistluse läbimise aega? Kui nii, siis miks ei ole NULL lubatud - mõnedel võistlustel aega ju ei mõõdeta?<br />
* Participation.Points - Kas igal võistlusel antakse ainult täisarv punkte (int)? Võiks igaks juhuks siiski implementeerida double väärtuse tüübi. Lisaks ei ole võimalik osalust luua ilma punkte teadmata - peaks siis määrama default väärtus. Mõnede võistluste puhul jälle punkte ei anta vaid mõõdetakse aega - võibolla peaks ka NULL-i lubama.<br />
* Participation.Disqualified - Nullid ei ole lubatud -> järelikult oleks default väärtust vaja.<br />
* Registrations - Projekti Must have alla on märgitud “Osaleja saab registreerida võistlusele meeskonda” kuid olemis puudub TeamsId ning samuti ei ole seda võimalust kuidagi läbi Servicei implementeeritud.<br />
* Registrations - Millal registreering tehti on suhteliselt tähtis teada. Paljude võistluste puhul sõltub sellest näiteks registreerimistasu. <br />
<br />
'''DTO-d:'''<br />
* Hetkel tundub nagu rakendus otseselt seda abstraktsiooni kihti ära ei kasuta. Kõik DTO-d konverteeritakse ümber 1:1-le Domain objektideks ja vastupidi.<br />
* Üldiselt oleks vaja teha tööd veel DTOdega, et need rohkem peegeldaksid oma kasutust. Näiteks:<br />
küsides kõiki võistlusi, kas meil on tarvis avalikustada kliendile, mis on kasutaja ID, kes iga võistluse lõi? DTOsid võiks olla rohkem erinevate kasutusjuhtumite jaoks. <br />
CompetitionDTO võiks sisaldada ka nimekirja võistlejatest, kus koondatakse info ManyToMany seoste põhjal kasutades vahetabelit, nagu näiteks:<br />
<source><br />
List<PersonDTO> people = c.Participation<br />
.FindAll(p => p.CompetitionId == c.CompetitionId)<br />
.Select(PersonDTO.CreateFromParticipation)<br />
.ToList();<br />
</source><br />
<br />
'''API Kontrolleritest:'''<br />
* Puudub Swagger startup konfiguratsioon, Swagger annotatsioonid kaotavad mõtte ning pole võimalik kontrollida, kas need on korrektselt loodud.<br />
* ProducesResponse annotatsiooni pole kusagile lisatud, staatuskoodid on natuke poolikult läbi mõeldud, vähemalt need, mida Swaggeri raames mainitud on<br />
* Annotatsioon Authorize, kus on ära määratud AuthorizationScheme peaks minema kogu klassi peale, meetodis saab ära määrata vaid selle, mis rollid on lubatud.<br />
* Kontrollerid enamuses pöörduvad vaid spetsiifiliste domeenide poole ja viivad ellu väga tavalist CRUD funktsionaalsust, mille tõttu tundub, et need on natuke veel toored. Näiteks on välja toodud “must have” nimekirjas projekti analüüsis, et meeskonna liige peaks saama muuta meeskonna andmeid. Antud kontrollerites vaid autentitakse, et kasutaja oleks rollis “participant”, kuid mitte seda, kas ta ka muudetava meeskonna liige on. Samuti pole võimalik kasutajatel näha, palju on mingile võistlusele osalejaid registreerunud, <br />
* CompetitionsController ei tegele sellega, et tagastada võistlusele registreerunud kasutajaid, selle asemel on olemas ParticipationsController, mis tagastab vahetabeli infot selle kohta, mis võistlusega on seotud mis inimene. See võib olla tohutult suur info, mida hakata filtreerima kliendi poolelt. Rohkem tuleks teha andmete agregeerimist vastavalt teenuse kontekstile. <br />
<br />
* '''AccountController'''<br />
** Response code uue kasutaja loomisel võiks olla 201<br />
** Puuduvad koodid nagu 429, 500<br />
** Registreerumisel võiks kontrollida, kas kasutaja on juba olemas, mitte vaid rolli olemasolu<br />
** Kas kasutajal ei või antud kontekstis olla mitu rolli? Sisselogimisel võetakse rollide seast vaid esimene ja lisatakse juurde Claimile. Võimalus kirjutada ka meetod, mis lisab kasutajale kõik rollid.<br />
<br />
* '''CompetitionPlacesController/CompetitionsController/CompetitionTypesController/ParticipationsController/RegistrationsController/TeamsController'''<br />
** Antud kontrollerid on kõik väga sarnase loogikaga<br />
** Get() tagastab vaid koodi 200, tagastuskoodi võimalusi on veel<br />
** Post() meetod küsib sisse DTOd, mille üheks parameetriks on id, id genereeritakse automaatselt, seda ei peaks panema kaasa postitatavasse mudelisse, mis alles loob objekti<br />
** Put() puhul sama kriitika, siin on id küll vajalik, aga see juba pannakse kaasa parameetrina eraldi<br />
** See tundub natuke veidrana üritada kontrollida uuendatud mudeli põhjal, kas tegemist oli BadRequestiga. Eelkõige peaks id puhul üle otsima, kas antud objekt on üldse olemas ja seejärel üritada uuendada, muidu tagastada BadRequest. Kui see ei õnnestu, siis peaks juba errorkood 500 peegeldama seda, et midagi läks teenuse poole peal valesti. <br />
** Sama kommentaar deletemise kohta, enne tuleks kontrollida, kas objekt on olemas. Siis alles objekt kustutada.<br />
* '''PeopleController'''<br />
** Kas tõepoolest igaüks saab pärida infot inimeste kohta ja neid postitada? <br />
* '''PersonInTeamsController''' <br />
** API disaini poole pealt on natuke veider teha vahetabelite kohta kontroller. Tundub loogilisem panna antud kontrolleri meetodid teistesse kontroleritesse, mis on seotud siis kas meeskondade või inimestega. Näiteks küsida PeopleControlleris kõik inimesed, kes on meeskondades või küsida neid meeskonna järgi. TeamsControlleris seevastu anda võimalus lisada uusi inimesi meeskonda, neid muuta või eemaldada.<br />
** Id järgi ei hakka ükski klient küsima vahetabeli kohta infot, see tundub otstarbetu tegevus, pigem küsida kas meeskonna või inimese id järgi sissekandeid<br />
<br />
'''Projekti kihid/struktuur:''' <br />
* Olemas Business Logic, Data Access Layer, DTO’d, Service’id, Unit of Work, domeeniklassid ning API spetsiifilised kontrollerid, mis asuvad oma kaustas põhiprojekti all. <br />
* DAL omab erinevaid kihte interface’ide ja neid implementeerivate klasside jaoks.<br />
* Repositooriumitega suhtlemine on abstraktne, kõik käib läbi Data Access Layer’i, mille pööle pöörduvad teenuseklassid ning DAL erinevad kihid hoolitsevad selle eest, et loodaks õiget tüüpi repositooriumeid, andmeid agregeeritakse, uuendatakse ja salvestatakse organiseeritud kujul ning neid tagastatakse teenustele soovitud kujul (DTOd).<br />
<br />
== XML retsensioon by meeskond BeerPressure: ==<br />
<br />
=== Üldine arvustus ===<br />
<br />
* Olemas on kõik nõutud failid: XML fail, XML faili skeemifail, XMLi transformeerimine HTMLi ja XMLi transformeerimine XMLi.<br />
* Kõik failid valideeruvad eraldiseisvalt. XML fail valideerub ka vastu skeemi faili ja stiilifaile.<br />
* Failid on hästi jälgitavad ja loetavad.<br />
<br />
=== XML ===<br />
<br />
* Nõutud oli, et XML failil on vähemalt 4 loogilist dimensiooni, antud töös on kuni 7 loogilist dimensiooni. <br />
* Nõutud oli, et kolmel dimensioonil tuleb kasutada attribuute, mis on enamat, kui lihtsalt ID. Antud töös on atribuute, mis on enamat kui ID, kasutatud kolme erineva elemendi juures.<br />
* Väike tähelepanek, et tavaliselt, kui on mingi element mitmuses, siis selle sees kasutatakse sama nimetust ainsuses, näiteks elemendi <inimesed> sees on <inimene>, antud juhul võiks olla ka elemendi <registrations> sees <registration>. Näiteks, kui on vaja mingi konkreetse registreerimise poole pöörduda, siis võib tekkida segadus, kui selle asemel peab pöörduma person’i või team’i poole.<br />
<br />
=== XSD (XML faili skeemifail) ===<br />
<br />
* Skeemifail on genereeritud automaatselt ja muudetud on kahte andmetüüpi. <br />
** Id’del on asendatud type="xs:unsignedByte" tüübiga type="xs:int", mis on ka loogiline, sest esialgne andmetüüp võimaldab salvestada id’sid ainult vahemikus 0-255. <br />
** PersonalIdCode esialgne type="xs:unsignedLong" on asendatud type="xs:string", mis on samuti sobilik muudatus.<br />
<br />
=== XSLT1 (XML'i transformeerimine HTML'i) ===<br />
<br />
* Mõlema XSLT faili puhul on tehtud kas näpukas või on sassi aetud faili tüüp, mainitud on XLS mitte XSL/XSLT.<br />
* Erinevate andmete kuvamiseks HTMLis on kasutatud:<br />
** ühte for-each tsüklit,<br />
** ühte if-tingimuslauset,<br />
** Ühte choose tingimuslauset, mille sees on nii ühel kui teisel juhul üks for-each tsükkel.<br />
<br />
=== XSLT1 (XML'i transformeerimine XML'i) ===<br />
<br />
* XML kuvamisel on muudetud XML faili struktuuri, selleks on kasutatud kahte for-each tsüklit ja mõlema sees ühte if-tingimuslauset.</div>
Saasma
https://wiki.itcollege.ee/index.php?title=Kodut%C3%B6%C3%B6_aines_%22V%C3%B5rgurakendused_II:_hajuss%C3%BCsteemide_ehitamine%22_2018&diff=131221
Kodutöö aines "Võrgurakendused II: hajussüsteemide ehitamine" 2018
2018-06-04T09:04:08Z
<p>Saasma: /* Kaitsmisele registreerumine */</p>
<hr />
<div>[[Category: Võrgurakendused II: hajussüsteemide ehitamine]]<br />
__NOINDEX__<br />
<br />
=Kodutöö aines "Võrgurakendused II: hajussüsteemide ehitamine" 2018=<br />
==Eesmärk==<br />
Saada praktiline kogemus hajussüsteemide ehitamisest XML(SOAP) või Rest veebiteenusel ja sellele klientrakenduse loomise abil ning süvendada meeskonnatööoskust. <br />
*SOAP veebiteenuse puhul eeldatakse WCF tehnoloogia kasutamist. Vanema põlvkonna ASP.NET veebiteenuse loomine ei ole lubatud, kuna seda ei toeta ka Microsoft enam tänasel päeval.<br />
*REST teenuste loomisel tuleks kasutada ASP.NET Web API2/ASP.NET Core 2.0/WCF võimalusi.<br />
<br />
Kaugem eesmärk on loomulikult hinne :).<br />
<br />
==Reeglid==<br />
''' Kodutöö koosneb kolmest eraldiseisvast ülesandest:'''<br />
* Luua XML fail vabalt valitud andmete edastamiseks,selle faili skeemifail ning XSL fail(id) erinevate transformatsioonide tarvis (soovitavalt vähemalt andmete HTML ja XML kujul kuvamiseks)<br />
* Luua veebiteenus, mis võimaldaks pakkuda teenust, eristada kasutajaid ning näidata teenuse kasutamise statistikat kasutajate ja tegevuste lõikes<br />
* Luua klientrakendus<br />
<br />
Ühte projektimeeskonda kuulub 3..4 tudengit ning ühel teemal teostab projekti üks või mitu meeskonda. 1,2 ja viie liikmelised meeskonnad tuleks õppejõuga eraldi kooskõlastada.<br />
<br />
Töö käiku kajastatakse http://wiki.itcollege.ee keskkonnas. Wikilehe täitmise eesmärke on kaks: nii on võimalik kirja panna kõik mõtted ja ideed (ning nendest jääb jälg) ning õppejõul on hiljem võimalik saada ülevaade iga projektimeeskonna liikme panusest.<br />
<br />
==Tähtajad==<br />
<br />
<br />
* '''Veebiteenus''' [https://wiki.itcollege.ee/index.php/Kodut%C3%B6%C3%B6_aines_%22V%C3%B5rgurakendused_II:_hajuss%C3%BCsteemide_ehitamine%22_2018#Veebiteenus NB! Täpsem info]<br />
** Veebiteenuse analüüs peab olema valmis, esitatud ja wikilehel kirjeldatud hiljemalt: '''01.aprill 2018'''. Lisaks on '''Meeskonnad on loonud omale enda wiki lehe, kuhu kirjeldavad meeskonna ja panevad nad üles oma tööd. Lisaks hakkavad kogunema ka sinna teiste gruppide poolt kirjutatavad retsensioonid. <ins>Meeskonnalehed lingitakse selle lehe lõppu Meeskonna pealkirja alla.</ins>'''<br />
** Veebiteenus peab olema valmis, esitatud ja ja wikilehel kirjeldatud hiljemalt '''27. mai 2018'''.<br />
** Retsensioonid veebiteenuste kohta peavad tehtud olema '''03. juuni 2018'''.<br />
<br />
<br />
* '''Klientrakendused''' [https://wiki.itcollege.ee/index.php/Kodut%C3%B6%C3%B6_aines_%22V%C3%B5rgurakendused_II:_hajuss%C3%BCsteemide_ehitamine%22_2018#Klientrakendus NB! Täpsem info]<br />
** Klientrakendused peavad olema valmis, esitatud ja ja wikilehel kirjeldatud hiljemalt '''27. mai 2018'''.<br />
** Retsensioonid klientrakenduste kohta peavad tehtud olema '''03. juuni 2018'''.<br />
<br />
<br />
* '''XML fail''' [https://wiki.itcollege.ee/index.php/Kodut%C3%B6%C3%B6_aines_%22V%C3%B5rgurakendused_II:_hajuss%C3%BCsteemide_ehitamine%22_2018#XML_andmefail NB! Täpsem info]<br />
** XML fail, stiilifail ja skeemifail peavad olema valmis ja wikilehel kirjeldatud hiljemalt '''01. juuni 2018'''.<br />
** Retsensioonid XML-failide kohta peavad tehtud olema '''05.juuni 2018'''.<br />
<br />
==Hindamine==<br />
===Üldised kriteeriumid===<br />
<br />
Teostatuks loetakse projekt juhul, kui lähteülesanne on realiseeritud, lahendus on töötav, kuid esineb suuremaid vigu ning piirsituatsioonidega ei ole arvestatud.<br />
<br />
Maksimumtulemuse saavutamiseks peab projekt olema teostatud tehniliselt veatult ning varustatud dokumentatsiooniga, milles sisaldub arendusprotsessi kirjeldus (peab selguma ka iga rühmaliikme panus projekti teostamisel), paigaldusjuhend ning lahenduse kirjeldus. <br />
<br />
'''Maksimumtulemuse annab (vähemalt 4/7):'''<br />
<br />
* Majanduslik mõtlemine (kas loodav teenus ja rakendused oleks kasutatav ka ärilistel eesmärkidel)<br />
* Mobiilirakendused/Angularis/reactis loodud klientrakendus<br />
* Kogukondade kaasamine<br />
* Kasutajamugavus<br />
* Läbimõeldud töökorraldus<br />
* Lisavõimaluste realiseerimine (vt näidisteemad)<br />
* Korraliku arhitektuuriga kirjutatud kood<br />
<br />
===XML andmefail===<br />
Ülesande täitmiseks tuleb luua XML fail andmete edastamiseks, selle XML faili skeemifail ning minimaalselt kaks sobivat XSL transformatsiooni faili loodud XML failis olevate andmete transformeerimiseks HTML formaati ja XML faili formaadi muutmiseks. Transformatsioonid peavad sisaldama midagi enamat, kui ainult üks for-each klausel. Transformatsiooni käigus peaks kasutama vajadusel parameetreid ning kindlasti ka erinevaid tingimuste kontrolle.<br />
<br />
XML-il peab olema vähemalt 4 loogilist dimensiooni.<br />
<dim1><br />
<dim2><br />
<dim3><br />
<dim4><br />
</dim4><br />
</dim3><br />
</dim2><br />
</dim1><br />
Lisaks tuleb kasutada 3-el dimensioonil attribuute, mis one enamat, kui lihtsalt ID.<br />
<br />
===Veebiteenus===<br />
Loodav veebiteenus peab võimaldama:<br />
* Teenuse pakkumist<br />
* '''Teenuse kasutajate tuvastamist ning haldamist'''<br />
* Teenuse kasutajate ja kasutusstatistika üle arve pidamist kasutajate lõikes<br />
* Teenuse poole pöördumiste arvu piiramist ja piirangute haldamist.<br />
<br />
Loodav veebiteenus peab toetama mitme kasutaja võimalust.<br />
<br />
Loodav veebiteenus tuleb luua kasutades ''Windows Communication Foundation'' või ASP.NET MVC Web API tehnoloogiat<br />
<br />
Andmebaasis peab olema vähemalt 9 olemit ehk andmebaas on eeldus,<br />
<br />
<br />
Soovitav on luua teenus (FE) ja teenuse seadistamiseks ning kasutajate haldamiseks mõeldud rakendus (BE).<br />
<br />
===Klientrakendus===<br />
Klientrakendus mõnele olemasolevale veebiteenusele, võib olla teostatud veebirakendusena(ASP.NET veebirakendus või hoopis Angulari või Reacti baasil), töölauarakendusena(WPF) või mobiilse rakendusena(Xamarin)<br />
<br />
Variant1: teha klientrakendus enda loodud veebiteenusele <br />
<br />
Variant2: teha klientrakendus mõnele levinud veebiteenusele.<br />
Näiteks: <br />
* http://www.bing.com/developer<br />
* http://www.flickr.com/services/api/response.soap.html<br />
* http://developer.ebay.com/developercenter/windows/<br />
* http://apiwiki.twitter.com/Getting-Started<br />
<br />
===Retsensioonid===<br />
Retsensioon on üliõpilase iseseisva teadustöö kriitilise analüüsi põhjal koostatud argumenteeritud hinnang. Retsensioonis tuleb hinnata töö vastavust esitatud tingimustele, programmikoodi loetavust ning kommenteeritust, dokumentatsiooni ja kirjeldada puudusi. Retsensioonide põhjal on meeskondadel õigus oma projekte parandada enne määratud esitamistähtaja kättejõudmist.<br />
<br />
Retsensioon peab sisaldama minimaalselt...<br />
* XML - ...200 sõna.<br />
* Veebiteenus - ...600 sõna.<br />
* Klientrakendus - ...600 sõna.<br />
<br />
Mõnelauselisest arvamusest ei piisa, kuna tegemist on grupi loodavate arvustustega, mitte individuaalsete arvustustega.<br />
<br />
==Konsultatsioonid==<br />
Igal projektimeeskonnal on piiramatu õigus saada õppejõu käest konsultatsiooni ja juhendamist oma<br />
töö tegemiseks, kas harjutuste ajal või pärast harjutusi ja loenguid. Eriaegade suhtes saab sõlmida<br />
õppejõuga kokkuleppeid kontaktidel<br />
mait.poska [ät] itcollege.ee või (+372 53 469 734)<br />
(teksti originaalautor Priit Raspel)<br />
<br />
==Kaitsmisele registreerumine==<br />
Kaitsmisele tuleks registreerida järjest(st iga järgmine lisab vajaliku 15min ajaakna) ja suvalisis kellaaegasid ei hakka kuhugi vahele kirjutama<br />
<br />
'''05.06.2018'''<br />
*15:00 - Miisiks<br />
*15:15 - ..<br />
*15:30 - ..<br />
*15:45 - ..<br />
<br />
<br />
'''09.06.2018'''<br />
*16:00 - Triin Oja<br />
*16:15 - Beer Pressure<br />
*16:30 - ..<br />
*16:45 - ..<br />
<br />
=Teemad 2018 kevad=<br />
''' Kodutöö koosneb kolmest eraldiseisvast ülesandest:'''<br />
* Luua XML fail vabalt valitud andmete edastamiseks,selle faili skeemifail ning XSL fail(id) erinevate transformatsioonide tarvis (soovitavalt vähemalt andmete HTML ja XML kujul kuvamiseks)<br />
* Luua veebiteenus, mis võimaldaks pakkuda teenust, eristada kasutajaid ning näidata teenuse kasutamise statistikat kasutajate ja tegevuste lõikes<br />
* Luua klientrakendus mõnele olemasolevale või endaloodud veebiteenusele<br />
<br />
NB! XML andmefail ja veebiteenus ei pea olema omavahel seotud.<br />
<br />
<br />
==Näidisteemad==<br />
<br />
<br />
====Ülesanne====<br />
Luua sobiva alguse järgi nimede pakkumise teenus:<br />
* alates kahetähelisetest algustest pakkuda sobivad nimesid<br />
* luua võimalus kasutajatel nimesid lisada<br />
* luua võimalus administraatoril nimesid muuta/kustutada<br />
* meeste ja naiste nimed peavad olema süsteemis eristatavad<br />
* luua võimalus, mis võimaldab kuvada populaarseid nimesid<br />
* luua võimalus ühele kasutajale (või erinevatele kasutajagruppidele) maksimumpäringute hulga määramiseks<br />
* luua võimalus, et nimi lisatakse baasi alles siis, kui administraatori õigustega inimene on selleks vastava loa andnud<br />
<br />
===Külastusstatistika teenus===<br />
Mõte selles, et pakkuda teenust, kus kasutajal on võimalik registreerida külastused ning küsida oma külastusstatistikat.<br />
<br />
====Ülesanne====<br />
Luua külastusstatistika teenus:<br />
* kasutaja saab teenuses registreerida külastusi<br />
* kasutaja saab küsida külastusstatistikat päevade/kuude/kogu perioodi lõikes<br />
* luua võimalus ühele kasutajale (või erinevatele kasutajagruppidele) maksimumpäringute hulga määramiseks<br />
<br />
Lisavõimalused:<br />
* luua võimalus registreerida alamlehtede külastusstatistikat<br />
* luua võimalus külastusstatistikale lisaparameetrite lisamiseks (ip aadress, sirviku versioon jne)<br />
<br />
===Telefoniraamatu teenus===<br />
Mõte selles, et kasutaja saab teenuse abil salvestada kontakte ja nende seast otsida<br />
<br />
====Ülesanne====<br />
Luua telefoniraamatu teenus:<br />
* kasutaja saab teenuses kontakte lisada ja kustutada<br />
* kasutaja saab kontaktide nime/telefoninumbri jne abil otsida<br />
* luua võimalus ühele kasutajale (või erinevatele kasutajagruppidele) maksimumpäringute hulga määramiseks<br />
* kasutajaid on võimalik lisada gruppidesse<br />
* kasutajal on võimalik lisada vajalike kontaktandmete liike<br />
* kasutajatel on võimalik jagada omavahel kontakte ja kontaktide grupper<br />
<br />
===RSS voogude kogumise ja uudiste kuvamise teenus===<br />
Mõte selles, et kasutaja saab teenuse abil salvestada talle huvipakkuvaid RSS vooge ja nendelt voogudelt uudiseid lugeda<br />
<br />
====Ülesanne====<br />
Luua RSS voogude haldusteenus:<br />
* kasutaja saab teenuses RSS vooge lisada ja kustudada<br />
* kasutaja saab pärida talle huvipakkuvate voogude viimaseid uudiseid<br />
* luua võimalus ühele kasutajale (või erinevatele kasutajagruppidele) maksimumpäringute hulga määramiseks<br />
* kasutaja saab RSS vooge vaadata eraldi või grupeeritult<br />
* vooge peab puhverdama, kuna voogude lugemine võtab enamasti üsna palju aega <br />
*<br />
<br />
= Meeskonnad 2018=<br />
==Päevaõpe==<br />
<br />
===[https://wiki.itcollege.ee/index.php/HairSaloon Meeskond: HairSaloon]===<br />
Liikmed:<br />
* Kaido Henrik Elias<br />
* Arvo Paomees<br />
<br />
===[https://wiki.itcollege.ee/index.php/VariousArtists Meeskond: VariousArtists]===<br />
Liikmed:<br />
* Ruudi Vinter<br />
* Madis Roosioks<br />
* Pavel Fleišer<br />
<br />
===[https://wiki.itcollege.ee/index.php/Maagikud Meeskond: Maagikud]===<br />
Liikmed:<br />
*Kristina Rästas<br />
*Simo Jaanus<br />
*Artur Tammiste<br />
*Rauno Lõhmus<br />
Lõpptoote [http://enos.itcollege.ee/~sjaanus/c/Airport_solution.zip link]<br />
<br />
===[https://wiki.itcollege.ee/index.php/RaamatuRiiul Meeskond: RaamatuRiiul]===<br />
Liikmed:<br />
* Alo Avi<br />
* Arnika Rästa<br />
* Marite Rammo<br />
'''Meie XML:''' [https://wiki.itcollege.ee/index.php/RaamatuRiiul#XML XML]<br />
<br />
'''Meie veebiteenuse ja klientrakenduse retsensioonid meeskonnale Miisiiks:''' [https://wiki.itcollege.ee/index.php/Talk:Miisiiks retsensioonid]<br />
<br />
===[https://wiki.itcollege.ee/index.php/Autolugu Meeskond: Autolugu]===<br />
Liikmed:<br />
* Margus Põlma<br />
* Karl Erik Õunapuu<br />
<br />
===[https://wiki.itcollege.ee/index.php/VRII2018 Meeskond: VRII2018]===<br />
Liikmed:<br />
* Kaspar Kaal<br />
* Teet Adamson<br />
* Rahel Kangur<br />
<br />
===[https://wiki.itcollege.ee/index.php/Meeskond_Raavo_V2%E2%84%A2 Meeskond: Raavo V2™]===<br />
Liikmed:<br />
* Peeter Fridolin<br />
* Kristo Leesmann<br />
* Rando Rommot<br />
<br />
Projekti retsensioon meeskonnale [https://wiki.itcollege.ee/index.php/Meeskond_Raavo_V2™#Retsentsioonid Maagikud]<br />
<br />
===[https://wiki.itcollege.ee/index.php/Pillarofautumn Meeskond: Pillar of Autumn ]===<br />
Liikmed:<br />
* Taavi Põder<br />
* Taavi Vesinurm<br />
* Raido Vell<br />
<br />
===[https://wiki.itcollege.ee/index.php/jaatuli Meeskond: JääTuli]===<br />
Liikmed:<br />
*Tarmo Luugus<br />
*Leho Kivistik<br />
*Hannes Mäeorg<br />
*Marten Tammeleht<br />
<br />
===[https://wiki.itcollege.ee/index.php/JustABot Meeskond: JustABot]===<br />
Liikmed:<br />
*Argo Hansen<br />
<br />
===[https://wiki.itcollege.ee/index.php/Meeskond_Pakiraam Meeskond: Pakiraam]===<br />
Liikmed:<br />
*Kristo Naeris<br />
*Indro Kottise<br />
<br />
===[https://wiki.itcollege.ee/index.php/GoFood Meeskond: GoFood]===<br />
Liikmed: <br />
<br />
* Rando Kurel<br />
* Henrik Prangel<br />
* Markus Mänd<br />
* Edgar Tereping<br />
* Jane Kaldma<br />
<br />
Lõpptoode: TODO<br />
<br />
Meie rühma kirjutatud retsentsioonid rühmale Maagikud: tegemisel<br />
<br />
===[https://wiki.itcollege.ee/index.php/LTD Meeskond: LearnToDrive]===<br />
'''Liikmed:'''<br />
*Eve Ormisson<br />
*Carlos Kirtsi<br />
<br />
Projekti retsensioon meeskonnale [https://wiki.itcollege.ee/index.php/LTD#Projekti_retsensioon Maagikud]<br />
<br />
XML osa retsensioon meeskonnale [https://wiki.itcollege.ee/index.php/LTD#XML_retsensioon RaamatuRiiul]<br />
<br />
===[https://wiki.itcollege.ee/index.php/Miisiiks Meeskond: Miisiiks]===<br />
Liikmed:<br />
*Christo Aruste<br />
*Heleriin Malkov<br />
*Tõnis Prants<br />
<br />
[https://www.dropbox.com/s/e2vu3ukgckyc2x5/MiisiiksWS.zip?dl=0 Veebiteenus]<br />
<br />
[https://www.dropbox.com/s/iwtheohp5mn0lek/MiisiiksC.zip?dl=0 Klientrakendus]<br />
<br />
[https://wiki.itcollege.ee/index.php/Miisiiks#XML XML]<br />
<br />
Retsensioonid meeskonnale Raavo V2™<br />
<br />
Veebiteenus: [https://wiki.itcollege.ee/index.php/Miisiiks#Veebiteenuse_retsensioon Retsensioon]<br />
<br />
Klientrakendus: [https://wiki.itcollege.ee/index.php/Miisiiks#Klientrakenduse_retsensioon Retsensioon]<br />
<br />
===[https://wiki.itcollege.ee/index.php/VR2_div Meeskond: &lt;div&gt;]===<br />
Liikmed:<br />
*Kaarel Pärtel<br />
*Marek Juhanson<br />
*Kai Kallastu<br />
<br />
Retsensioonid rühmale [https://wiki.itcollege.ee/index.php/Miisiiks Miisiiks™]: [https://docs.google.com/document/d/1gQmas-Fay_XHHhLInKM92152vYeFdFflDIRozN63mxA/edit?usp=sharing veebiteenus, klientrakendus ja XML]<br />
<br />
==Kaugõpe==<br />
<br />
===[https://wiki.itcollege.ee/index.php/BestInShow Meeskond: BestInShow]===<br />
Liikmed:<br />
* Liina Abner<br />
* Marju Pütsepp<br />
* Liisi Taimre<br />
<br />
===[https://wiki.itcollege.ee/index.php/WatchWinders Meeskond: WatchWinders]===<br />
Liikmed:<br />
* Toomas Juhkov<br />
* Kunnar Kukk<br />
* Tiit Kuuskmäe<br />
<br />
===[[ Kuldneloojang | Meeskond: Kuldne loojang]]===<br />
'''Liikmed''':<br />
* Andrus Seiman<br />
* Marko Belzetski<br />
* Priit Tiganik<br />
* Kristjan Peterson (loobus)<br />
<br />
<br />
'''Lõpptoode''' (seisuga 2. juuni 2018)''':'''<br />
* .zip fail rakendus ja klient koos: https://www.dropbox.com/s/0qs4zcon2bsnr72/loojang.zip?dl=0<br />
* veebirakenduse repo: https://bitbucket.org/itcollegeprojects/loojang-app<br />
* klientrakenduse repo: https://bitbucket.org/itcollegeprojects/loojang-client<br />
* XML: [https://wiki.itcollege.ee/index.php/Kuldneloojang#XML_.C3.BClesande_kirjeldus link meie Wiki lehele]<br />
<br />
<br />
'''Retsensioonid:'''<br />
* TODO<br />
<br />
===[https://wiki.itcollege.ee/index.php/Ophelia Meeskond: Ophelia]===<br />
Liikmed:<br />
* Siim Kallari<br />
* Andres Kepler (loobus)<br />
* Jorma Rebane<br />
<br />
===[https://wiki.itcollege.ee/index.php/SharpRestoVRII Meeskond: SharpRestoVRII]===<br />
Liikmed:<br />
* Andres Aava (lahkunud liige)<br />
* Henri Annilo<br />
* Jaan Koolmeister<br />
* Lauri Üksti<br />
<br />
Lähtekood: [http://enos.itcollege.ee/~luksti/CSharp/CSharpResto.zip CSharpResto]<br />
<br />
Retsensioonid:<br />
<br />
===[https://wiki.itcollege.ee/index.php/BeerPressure Meeskond: BeerPressure]===<br />
Liikmed:<br />
* Sigrid Aasma<br />
* Evelin Jõgi<br />
* Martin Kask<br />
* Marko Nõu<br />
'''Projekt:''' [https://github.com/sikumiku/TaisKohtApi TaisKohtApi]<br />
<br />
'''Lõpptoode:''' [https://github.com/sikumiku/TaisKohtApi/archive/61438e187a1a972410c8a3bc6274d69489d00aa6.zip GitHub commit]<br />
<br />
'''XML:''' [https://wiki.itcollege.ee/index.php/BeerPressure#XML.2FXSD.2FXSLT Beer Pressure XML/XSD/XSLT]<br />
<br />
'''Meie kirjutatud XML retsensioon:''' TODO <br />
<br />
'''Meie kirjutatud veebiteenuse retsensioon:''' [https://wiki.itcollege.ee/index.php/Talk:MOT#Veebiteenuse_retsensensioon_by_meeskond_BeerPressure: Team MOT retsensioon]<br />
<br />
'''Meie kirjutatud klientrakenduse retsensioon:''' [https://wiki.itcollege.ee/index.php/Talk:Kuldneloojang#Klientrakenduse_retsensensioon_by_meeskond_BeerPressure: Team Kuldneloojang retsensioon]<br />
<br />
===[[ Memorize | Meeskond: Memorize]]===<br />
Liikmed:<br />
* Madis Uudam<br />
* Olle Mikk<br />
<br />
===[https://wiki.itcollege.ee/index.php/UCanDo Meeskond: UCanDo]===<br />
Liikmed:<br />
* Mart Raus<br />
* Ando Kiidron<br />
* Liina Saar<br />
<br />
===[https://wiki.itcollege.ee/index.php/MOT Meeskond: MOT]===<br />
Liikmed:<br />
* Merike Meizner<br />
* Helen Oppar (loobus)<br />
* Hardi Tiitus<br />
<br />
'''Lõpptoode: ''' http://enos.itcollege.ee/~mmeizner/MOT/ <br><br />
'''Meie kirjutatud veebiteenuse ja klientrakenduse retsensioon:''' [https://docs.google.com/document/d/16WL12wmvQ_TPcY_-4pG_kjwtstQoX5meEYcigE4Febw/edit?usp=sharing: Team Raavo V2]<br />
<br />
===[https://wiki.itcollege.ee/index.php/Meeskond:_MealPlanner Meeskond: MealPlanner]===<br />
Liikmed:<br />
*Triin Oja<br />
*Rein Remsu<br />
<br />
===[https://wiki.itcollege.ee/index.php/Meeskond:Curry Meeskond: Curry]===<br />
Liikmed:<br />
* Rain Elken<br />
* Peeter Ploom<br />
<br />
===[https://wiki.itcollege.ee/index.php/Hammas Meeskond: Hammas]===<br />
Liikmed:<br />
* Sten Lunden<br />
<br />
===[https://wiki.itcollege.ee/index.php/LabLite Meeskond: LabLite]===<br />
Liikmed:<br />
* Alex Kaska<br />
<br />
===[https://wiki.itcollege.ee/index.php/AmateurBB Meeskond: AmateurBB]===<br />
Liikmed:<br />
*Taavi Kivimaa<br />
<br />
===[https://wiki.itcollege.ee/index.php/MealPlannerSolo Meeskond: MealPlannerSolo]===<br />
Liikmed:<br />
*Triin Oja<br />
<br />
===[https://wiki.itcollege.ee/index.php/NutriCheck Meeskond: NutriCheck]===<br />
Liikmed:<br />
*Artyom Likhachev</div>
Saasma
https://wiki.itcollege.ee/index.php?title=BeerPressure&diff=131186
BeerPressure
2018-06-03T20:46:17Z
<p>Saasma: /* 02.06-03.06.2018 */</p>
<hr />
<div>== Meeskond ja rollid ==<br />
<br />
* Sigrid Aasma (arendaja)<br />
* Evelin Jõgi (arendaja)<br />
* Martin Kask (projektijuht, arendaja)<br />
* Marko Nõu (arendaja)<br />
<br />
== Idee ==<br />
'''Toidukohtade põhimenüüde ja päevapakkumiste teenus'''<br />
<br />
Soovime pakkuda toidukohtade põhimenüüde ja päevapakkumiste teenust. On olemas mitmeid kodulehti “päevapakkumised”, kus on kirjas toidukohtade päevapraed. Kuid tavaliselt sellistel lehtedel ei ole masinloetavaid andmeid ehk siis varianti, et saad saata API pihta mingi kuupäeva koos päevapraadidega andmete uuendamiseks ja saad sama API käest küsida tänaseid päevapraade. Andmeid võiks saada küsida restorani, kuupäeva, asukoha või otsisõna/otsisõnaosa põhiselt. Selline teenus lihtsustaks ka toidukohtade päevapakkumiste haldamist, kuna praegu peavad teenuse pakkujad vastavat informatsiooni uuendama mitmes erinevas kohas - nii erinevates portaalides, kui ka enda veebileheküljel. Samuti oleks toidukohtade kogu menüü haldamine ühes kohas.<br />
<br />
=== Esialgne prototüüp ===<br />
<br />
[[File:TäisKõhtProto1.mp4]]<br />
<br />
Esialgne prototüüp: [http://enos.itcollege.ee/~saasma/VR2/Proto/K%C3%B5htT%C3%A4is/#g=1&p=home navigeeritav versioon vol.1]<br />
<br />
=== Prototüübi muutus projekti käigus ===<br />
<br />
Prototüüp: [http://enos.itcollege.ee/~saasma/VR2/Proto/T%C3%A4isK%C3%B5ht/K%C3%B5htT%C3%A4is/#g=1&p=home navigeeritav versioon vol.2]<br />
<br />
== Kasutatav arendustehnoloogia ==<br />
<br />
Veebiteenuse loomisel kasutame ASP.NET Core tehnoloogiat ja kursusel õpitud arendusmustreid.<br />
<br />
Klientrakenduse loomisel kasutame Node.js + React'i.<br />
<br />
== Veebiteenuse analüüs ==<br />
Pakume toidukohtade põhimenüüde ja päevapakkumiste teenust, kuhu on kokku koondatud erinevate toidukohtade menüüd üle Eesti. Põhimenüü alla kuuluvad pikaajalised menüüd, mis kehtivad püsivalt, hooajaliselt või mingil konkreetsel nädalapäeval. Päevapakkumiste alla kuuluvad konkreetse kuupäevaga seotud päevapakkumised. Päevapakkumiste korral kuvatakse lisainfona, kas pakkumine kehtib mingis konkreetses ajavahemikus või kogu toidukoha lahtioleku aja.<br />
<br />
Eesmärk on koguda ühte kohta kokku erinevate toidukohtade menüüd ja päevapakkumised, et kliendid saaksid mugavalt ja kiiresti oma valikuid teha. Kliendid käivad enamasti päevapakkumisi söömas lõuna ajal ja selleks ettenähtud aeg on piiratud. Sellepärast on oluline, et klient saaks teha oma valiku võimalikult kiiresti. Tänu loodavale veebiteenusele ei pea kliendid käima erinevates portaalides, et tutvuda erinevate toidukohtade pakkumistega. Kuna teenust on mugav kasutada ja klient saab oma valiku kiiresti tehtud, siis tõenäoliselt teeb klient valiku selles keskkonnas olevate toiduasutuste seast. Lisaks võimaldab teenus toiduasutustel paika panna oma pikaajalisem põhimenüü ning seda rakenduses ja võimalusel ka söögikohas kuvada. Sellepärast on ka toidukohtade huvi antud keskkonnas üleval olla ja meiega oma andmeid jagada, sest see suurendab nende klientuuri ning muudab oma menüü haldamise kergemaks.<br />
<br />
Veebiteenuse loomisel lähtume eelkõige sellest, et kliendil oleks teenust mugav kasutada ja ta saaks oma valiku kiiresti tehtud. Arvestame, et kliendid on erinevad. Mõni eelistab mõnda kindlat toidukohta, sel juhul saab ta valida oma soovitud kohad ja võrrelda nende kohtade tänase päeva pakkumisi ning menüüsid. Mõnele inimesele on oluline pakutav söök ja ta eelistab pakkumist otsida prae nimetuses oleva sõna või sõnaosa järgi ning lähtuda seejärel valiku tegemisel toidukoha keskmisest hindest või toidu hinnast. Mõne kliendi jaoks on oluline hind ja selleks, et oma valikut teha sobivas hinnavahemikus on tal võimalik sisestada maksimum hinna piirang. Kindlasti on antud teenuse juures kõikide klientide jaoks oluline päevapakkumiste asukohapõhine eristatus. Kliendid, kes soovivad oma konto luua, võivad oma eelistatud valikud meelde jätta ja järgmisel korral kuvatakse neid talle automaatselt.<br />
<br />
Teenuse must-have funktsionaalsus tagab teenuse toimimise ja põhifunktsioonid. Teenuse nice-to-have funktsionaalsus annab rakendusele lisandväärtust.<br />
<br />
Arvestades pakutava teenusega, siis näeme, et aktiivseim teenuse kasutamine võib olla tööpäevadel vahemikus 11.00-15.00, kui kliendid tutvuvad päevapakkumistega. Teenus peab tekkivale koormusele vastu pidama.<br />
<br />
Teenuse pakkumine peab olema turvaline. Selle tagamiseks tuleb sisestatavaid andmeid valideerida ja andmebaasi sisestavate andmete mahtu piirata. Toidukohtade sisestatud andmed peavad olema kaitstud, et toitude koostised ei saaks avalikuks. Põhjendatud juhtudel on võimalik kasutajaid lukku panna.<br />
<br />
== Kasutajad ==<br />
<br />
<br />
* Admin - lehe administraator, kellel on õigus lehte, kasutajaid ja nende õiguseid hallata. Tema huvi on, et teenus toimiks tõrgeteta.<br />
* Toiduasutus (tasuta kasutaja) - saab hoida lehel ühte põhimenüüd ja päevapakkumisi.<br />
* Toiduasutus (tellimusega kasutaja) - saab hoida lehel piiramatu arv põhimenüüsid ja päevapakkumisi.<br />
Toiduasutused on teenusest huvitatud, et nende menüüde haldamine oleks kerge ja mugav ning nad saaksid oma klientide arvu suurendada.<br />
* Külastaja - klient, kes valib söögikohta. Tema on huvitatud eelkõige sellest, et teenust saaks kasutada mugavalt ja kiirelt ning toidukohtade valik oleks võimalikult suur.<br />
<br />
== Rakenduse must-have funktsionaalsus ==<br />
<br />
* Kasutajad saavad sisse logida<br />
* Kasutajatel on erinevad rollid: admin, toidukoht (tasuta ja tasulise tellimusega), klient<br />
* Kasutajate arvepidamine kasutajate lõikes:<br />
** sisselogimise kuupäev, kellaaeg<br />
** pakkumiste lisamine<br />
** pakkumiste muutmine<br />
** pakkumiste kustutamine<br />
** õiguste kehtimise periood (tasuta ja tellimusega toidukoht)<br />
** pakkumistele klikkimise arv<br />
* Kasutajaid on võimalik hallata:<br />
** kasutajale õiguste andmine (menüüde arvu suurendamine, tellimusega toidukohal), rolli määramine<br />
** Kasutajat on võimalik piirata: õiguseid piirata (piiratud menüüde arv, tasuta liitunud toidukohal) ja lukku panna<br />
* Päevapakkumisi/menüüsid saab küsida: <br />
** toidukoha järgi, <br />
** kuupäeva põhiselt (ainult päevapakkumisi), <br />
** asukoha põhiselt,<br />
** toidu nimetuses esineva otsisõna/otsisõna osa põhiselt,<br />
** hinna põhiselt (max hinna piirang).<br />
* Klientrakenduses realiseeritakse CRUD meetodid (menüüsid/päevapakkumisi saab sisestada, lugeda, uuendada, kustutada)<br />
* Toidukohale saab anda hindeid ja kuvatakse keskmist hinnet.<br />
* Toidule saab anda hindeid ja kuvatakse keskmist hinnet.<br />
<br />
== Nice-to-have funktsionaalsus ==<br />
<br />
* Info selle kohta, kas päevapakkumine on otsas<br />
* Päevapakkumisi/menüüsid saab kommenteerida ja neid kommentaare kuvatakse avalikult.<br />
* Söögikohtade kodulehtedelt otsimise script, mis genereerib juba olemasolevate kodulehtede baasil päevamenüüsid.<br />
* Toiduvaliku piiramine allergeenide/vegan/jms. koostisosade põhiselt.<br />
* Aruandlused ja võrdlused toidukohtadele, et võrrelda end konkurentidega.<br />
* Teenus soovitab toidukohtadele nende varasemate päevapraadide populaarsuse alusel uue nädala menüüd.<br />
* Erinevad toidukohtade/toitude pingeread klientidele, et anda valikuteks ideid.<br />
* Soovitused klientidele, mida teised kliendid sarnaste eelistustega on veel valinud.<br />
<br />
== Andmebaasi ülesehitus - projekti algus ==<br />
<br />
[[File: BeerPressureAndmebaasimudel.png]]<br />
<br />
== Andmebaasi ülesehitus - projekti lõpp ==<br />
<br />
[[File: Ta2isKo6ht-DB-FINAL.png]]<br />
<br />
== Projekti repository ==<br />
<br />
https://github.com/sikumiku/TaisKohtApi<br />
<br />
Zip fail saadaval: <br />
(master branchi viimane commit esitamise ajal)<br />
https://github.com/sikumiku/TaisKohtApi/archive/61438e187a1a972410c8a3bc6274d69489d00aa6.zip<br />
<br />
== API v1 dokumentatsioon ==<br />
<br />
===Security===<br />
'''POST /api/account/register'''<br />
<source><br />
Params: RegisterViewModel registerViewModel<br />
<br />
Returns: token<br />
</source><br />
<br />
'''POST /api/account/login'''<br />
<source> <br />
Params: LoginViewModel model<br />
<br />
Returns: token<br />
</source><br />
<br />
'''POST /api/account/logout'''<br />
<source> <br />
Params: -<br />
<br />
Returns: -<br />
</source><br />
<br />
===Accounts===<br />
'''GET /api/v1/accounts/getAllUsersInRole'''<br />
<source> <br />
Params: string role<br />
<br />
Returns: List<UserDTO><br />
</source><br />
<br />
'''GET /api/v1/accounts/{id}'''<br />
<source> <br />
Params: string id<br />
<br />
Returns: UserDTO<br />
</source><br />
<br />
'''PUT /api/v1/accounts/{id}'''<br />
<source> <br />
Params: string id, UpdateUserDTO userDTO<br />
<br />
Returns: -<br />
</source><br />
<br />
'''POST /api/v1/accounts/addRole'''<br />
<source> <br />
Params: string role<br />
<br />
Returns: -<br />
</source><br />
<br />
'''POST /api/v1/accounts/addRoleToUser'''<br />
<source> <br />
Params: string role, string userId<br />
<br />
Returns: UserDTO<br />
</source><br />
<br />
'''DELETE /api/v1/accounts/deactivate/{id}'''<br />
<source> <br />
Params: string id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Promotions===<br />
'''GET /api/v1/promotions '''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<PromotionDTO> <br />
</source><br />
<br />
'''GET /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: PromotionDTO<br />
</source><br />
<br />
'''POST /api/v1/promotions'''<br />
<source> <br />
Params: PromotionDTO promotionDTO<br />
<br />
Returns: PromotionDTO newPromotion<br />
</source><br />
<br />
'''PUT /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id, PromotionDTO promotionDTO<br />
<br />
Returns: PromotionDTO updatedPromotion<br />
</source><br />
<br />
'''DELETE /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Restaurants===<br />
'''GET /api/v1/restaurants'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<SimpleRestaurantDTO><br />
</source><br />
<br />
'''GET /api/v1/restaurants/search?name=th'''<br />
<source> <br />
Params: string name<br />
<br />
Returns: List<SimpleRestaurantDTO> result<br />
</source><br />
<br />
'''GET /api/v1/restaurants/top'''<br />
<source> <br />
Params: int amount<br />
<br />
Returns: List<SimpleRestaurantDTO> result<br />
</source><br />
<br />
'''GET /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: RestaurantDTO r<br />
</source><br />
<br />
'''POST /api/v1/restaurants/addUserToRestaurant'''<br />
<source> <br />
Params: int id, string userId<br />
<br />
Returns: -<br />
</source><br />
<br />
'''POST /api/v1/restaurants'''<br />
<source> <br />
Params: PostRestaurantDTO restaurantDTO<br />
<br />
Returns: RestaurantDTO newRestaurant<br />
</source><br />
<br />
'''PUT /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id, PostRestaurantDTO restaurantDTO<br />
<br />
Returns: PostRestaurantDTO updatedRestaurantDTO<br />
</source><br />
<br />
'''DELETE /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Menus===<br />
'''GET /api/v1/menus'''<br />
<source><br />
Params: -<br />
<br />
Returns: List<MenuDTO><br />
</source><br />
<br />
'''GET /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: MenuDTO menuDTO<br />
</source><br />
<br />
'''POST /api/v1/menus'''<br />
<source> <br />
Params: PostMenuDTO menuDTO<br />
<br />
Returns: MenuDTO newMenu<br />
</source><br />
<br />
'''PUT /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id, PostMenuDTO menuDTO<br />
<br />
Returns: MenuDTO updatedMenu<br />
</source><br />
<br />
'''PUT api/v1/Menus/{id}/Dishes'''<br />
<source> <br />
Params: int menuId, int[] dishIds<br />
<br />
Returns: -<br />
</source><br />
<br />
'''DELETE /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Dishes===<br />
'''GET /api/v1/dishes'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<DishDTO><br />
</source><br />
<br />
'''GET /api/v1/dishes/daily'''<br />
<source> <br />
Params: bool vegan, bool glutenFree, bool lactoseFree<br />
<br />
Returns: List<SimpleDishDTO> result<br />
</source><br />
<br />
'''GET: api/v1/dishes/search?title=th&priceLimit=null'''<br />
<source> <br />
Params: string title, decimal? priceLimit<br />
<br />
Returns: List<DishDTO> result<br />
</source><br />
<br />
'''GET /api/v1/dishes/top'''<br />
<source> <br />
Params: int amount<br />
<br />
Returns: List<DishDTO> result<br />
</source><br />
<br />
'''GET /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: DishDTO dishDTO<br />
</source><br />
<br />
'''POST /api/v1/dishes'''<br />
<source> <br />
Params: PostDishDTO dishDTO<br />
<br />
Returns: DishDTO newDish<br />
</source><br />
<br />
'''PUT /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id, PostDishDTO dishDTO<br />
<br />
Returns: DishDTO updatedDish<br />
</source><br />
<br />
'''PUT api/v1/Dishes/{id}/Ingredients'''<br />
<source> <br />
Params: int dishId, PostIngredientForDishDTO[] ingredients<br />
<br />
Returns: -<br />
</source><br />
<br />
'''DELETE /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Ingredients===<br />
'''GET /api/v1/ingredients'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<IngredientDTO><br />
</source><br />
<br />
'''GET /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: IngredientDTO i<br />
</source><br />
<br />
'''POST /api/v1/ingredients'''<br />
<source> <br />
Params: PostIngredientDTO ingredientDTO<br />
<br />
Returns: IngredientDTO newIngredient<br />
</source><br />
<br />
'''PUT /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id, PostIngredientDTO ingredientDTO<br />
<br />
Returns: IngredientDTO updatedIngredient<br />
</source><br />
<br />
'''DELETE /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Ratings===<br />
'''GET /api/v1/ratings'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<RatingLogDTO><br />
</source><br />
<br />
'''GET /api/v1/ratings/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: RatingLogDTO dto<br />
</source><br />
<br />
'''POST /api/v1/ratings'''<br />
<source> <br />
Params: RatingLogForEntityDTO ratingDTO<br />
<br />
Returns: RatingLogDTO newRating<br />
</source><br />
<br />
'''PUT api/v1/ratings/{id}'''<br />
<source> <br />
Params: int id, RatingLogForEntityDTO ratingDTO<br />
<br />
Returns: RatingLogDTO updatedRating<br />
</source><br />
<br />
'''DELETE api/v1/ratings/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===RequestLog===<br />
'''GET: api/v1/usageData/{userId}'''<br />
<source> <br />
Params: string userId<br />
<br />
Returns: List<RequestLogDTO><br />
</source><br />
<br />
== Lõpptoote kasutusjuhend ==<br />
<br />
* Kloonida kohalikku arvutisse repository aadressilt [https://github.com/sikumiku/TaisKohtApi https://github.com/sikumiku/TaisKohtApi]<br />
* Installida NodeJS<br />
* <source>npm install webpack -g</source><br />
* <source>npm install -cli -g</source><br />
* Frontend rakenduse kasutamiseks valida Startup meetoditest IIS Express, veebiteenuse ja Swaggeri kasutamiseks käivitada Api Swagger<br />
* Esimese admin kasutaja loomiseks tuleb kasutaja registreerida admin@gmail.com e-mailiga<br />
<br />
== XML/XSD/XSLT ==<br />
<br />
=== XML ===<br />
<br />
<source><?xml version="1.0" encoding="utf-8" ?><br />
<?xml-stylesheet type="text/xsl" href="XMLFileXML.xslt"?><br />
<restaurants><br />
<restaurant id="1" url="https://kuuspelmeeni.ee" contactnumber="507783342" email="kuuspelmeeni@gmail.com"><br />
<name><![CDATA[Kuus Pelmeeni]]></name><br />
<menus><br />
<menu id="1" repetitioninterval="30"><br />
<name><![CDATA[Päevamenüü]]></name><br />
<activefrom>2018-05-27T12:00:00</activefrom><br />
<activeto>2018-05-28T12:00:00</activeto><br />
<dishes><br />
<dish id="1" vegan="false" lactosefree="false" glutenfree="false" daily="true" kcal="550" dailyprice="4"><br />
<title><![CDATA[8 pelmeeni]]></title><br />
<description><![CDATA[8 pelmeeni 6 asemel serveeritud tervisliku koguse hapukoore ja tilliga]]></description><br />
<availablefrom>2018-05-27T12:00:00</availablefrom><br />
<availableto>2018-05-28T12:00:00</availableto><br />
<ingredients><br />
<ingredient id="1" amountunit="g"><br />
<name>Sealiha</name><br />
<description>Rakvere sealiha</description><br />
</ingredient><br />
<ingredient id="2" amountunit="g"><br />
<name>Hapukoor</name><br />
<description>Alma hapukoor</description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="9"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Parim päevaroog viimasel ajal.]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
</comments><br />
</rating><br />
<promotion id="1" type="visual" classname="bold-red-border-2px"><br />
<name>2px red border</name><br />
<description><![CDATA[Displays a 2px wide red border around the component that is promoted.]]></description><br />
<validto>2018-06-25T12:00:00</validto><br />
</promotion><br />
</dish><br />
<dish id="2" vegan="true" lactosefree="true" glutenfree="true" daily="true" kcal="320" price="4"><br />
<title><![CDATA[Kurgisalat]]></title><br />
<description><![CDATA[Erinevatel viisidel töödeldud kurk serveeritud koos jõhvikatega. Tervislik amps.]]></description><br />
<availablefrom>2018-05-27T12:00:00</availablefrom><br />
<availableto>2018-05-28T12:00:00</availableto><br />
<ingredients/><br />
<rating ratingvalue="4"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Jäin veel väga näljaseks peale selle söömist.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
</dishes><br />
</menu><br />
<menu id="2"><br />
<name><![CDATA[Põhimenüü]]></name><br />
<dishes><br />
<dish id="4" vegan="false" lactosefree="false" glutenfree="false" daily="false" kcal="550" price="5"><br />
<title><![CDATA[6 pelmeeni]]></title><br />
<description><![CDATA[6 pelmeeni serveeritud tervisliku koguse hapukoore ja tilliga]]></description><br />
<ingredients><br />
<ingredient id="1" amountunit="g"><br />
<name>Sealiha</name><br />
<description>Rakvere sealiha</description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="9.5"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Käin seda iga päev söömas.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Parim toit selles restoranis.]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
<dish id="5" vegan="false" lactosefree="false" glutenfree="true" daily="false" kcal="460" price="3.8"><br />
<title><![CDATA[Kartulisalat]]></title><br />
<description><![CDATA[Sinki sisaldav traditsiooniline kartulisalat.]]></description><br />
<ingredients/><br />
</dish><br />
<dish id="6" vegan="false" lactosefree="false" glutenfree="false" daily="false" kcal="610" price="3.9"><br />
<title><![CDATA[Šokolaadikook]]></title><br />
<description><![CDATA[Ahvatlev glasuuritud šokolaadikook.]]></description><br />
<ingredients/><br />
<rating ratingvalue="7.8"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Šokolaadikooki on keeruline metsa keerata.]]></commenttext><br />
<username>mutikas3</username><br />
<userid>3a29b94a-3f17-469d-a44d-f7d85e98dd3e</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
</dishes><br />
</menu><br />
</menus><br />
<dishes/><br />
<address id="1" country="Eesti"><br />
<addressfirstline>Tatari 12</addressfirstline><br />
<locality>Tallinn</locality><br />
<postcode>10132</postcode><br />
<region>Harjumaa</region><br />
</address><br />
<promotion/><br />
<rating ratingvalue="7.5"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Parim restoran üldse!]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Ma sain ainult 5 pelmeeni. Ootasin kuute.]]></commenttext><br />
<username>kyllikekallike1</username><br />
<userid>6af271dd-0e11-4ae6-98be-111762664318</userid><br />
</comment><br />
</comments><br />
</rating><br />
</restaurant><br />
<restaurant id="2" url="https://kolmkokka.ee" contactnumber="6522351" email="kolmkokka@gmail.com"><br />
<name><![CDATA[Kolm kokka]]></name><br />
<menus/><br />
<dishes><br />
<dish id="7" vegan="false" lactosefree="true" glutenfree="false" daily="false" kcal="470" price="14"><br />
<title><![CDATA[Ahjulõhe juurikatega]]></title><br />
<description><![CDATA[Ahjulõhe serveeritud püreestatud porgandite ja lillkapsaga.]]></description><br />
<ingredients><br />
<ingredient id="11" amountunit="tk" amount="1"><br />
<name>Ahjulõhe</name><br />
<description><![CDATA[Värske ahjulõhe]]></description><br />
</ingredient><br />
<ingredient id="12" amountunit="g"><br />
<name>Püreestatud porgand</name><br />
<description><![CDATA[Eesti porgand, mis on kergelt püreestatud]]></description><br />
</ingredient><br />
<ingredient id="13" amountunit="g"><br />
<name>Püreestatud lillkapsas</name><br />
<description><![CDATA[Eesti lillkapsas, mis on kergelt püreestatud ja maitsestatud]]></description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="8.9"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Kindlasti minu üks lemmikuid.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Pole midagi halba öelda.]]></commenttext><br />
<username>tiiuviiu</username><br />
<userid>0730a7b7-3a9c-4e26-962f-da9a8daeab8a</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
<dish id="8" vegan="true" lactosefree="true" glutenfree="true" daily="true" dailyprice="5"><br />
<title><![CDATA[Ingverisupp]]></title><br />
<description><![CDATA[Ingveriga vürtsistatud ingverisupp, mis viib keele alla.]]></description><br />
<availablefrom>2018-05-25T12:00:00</availablefrom><br />
<availableto>2018-06-25T12:00:00</availableto><br />
<ingredients><br />
<ingredient id="14" amountunit="g" amount="20"><br />
<name>Ingver</name><br />
<description><![CDATA[Tükeldatud ingver]]></description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="6"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Liiga palju ingverit.]]></commenttext><br />
<username>kyllikekallike1</username><br />
<userid>6af271dd-0e11-4ae6-98be-111762664318</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
<dish id="9" vegan="false" lactosefree="false" glutenfree="true" daily="false" kcal="340" price="4.5"><br />
<title><![CDATA[Apelsinijäätis]]></title><br />
<description><![CDATA[Apelsinimaitseline jäätis serveeritud riivitud apelsinikoorega.]]></description><br />
<ingredients/><br />
<rating ratingvalue="8"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Väga huvitav magustoit, prooviks veel.]]></commenttext><br />
<username>mutikas3</username><br />
<userid>3a29b94a-3f17-469d-a44d-f7d85e98dd3e</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Üks mu lemmikuid magustoite.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
</dishes><br />
<address id="2" country="Eesti"><br />
<addressfirstline>Laia 12</addressfirstline><br />
<locality>Tallinn</locality><br />
<postcode>13022</postcode><br />
<region>Harjumaa</region><br />
</address><br />
<promotion/><br />
<rating ratingvalue="8.1"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Hinnad on natuke liiga kallid minu jaoks, aga toit om maitsev.]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Ma kindlasti telliks kala uuesti. Väga mahlakas oli.]]></commenttext><br />
<username>kyllikekallike1</username><br />
<userid>6af271dd-0e11-4ae6-98be-111762664318</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Asukoht oli päris tore. Miljöö ka.]]></commenttext><br />
<username>mutikas3</username><br />
<userid>3a29b94a-3f17-469d-a44d-f7d85e98dd3e</userid><br />
</comment><br />
</comments><br />
</rating><br />
</restaurant><br />
</restaurants></source><br />
<br />
=== XSD ===<br />
<br />
<source><?xml version="1.0" encoding="utf-8"?><br />
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema"><br />
<xs:element name="restaurants"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="restaurant"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="menus"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="menu"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="activefrom" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="activeto" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="dishes"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="dish"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="title" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="availablefrom" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="availableto" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="servetime" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="ingredients"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="ingredient"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="amountunit" type="xs:string" use="required" /><br />
<xs:attribute name="amount" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="rating" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="comments"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="comment"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="commenttext" type="xs:string" /><br />
<xs:element name="username" type="xs:string" /><br />
<xs:element name="userid" type="xs:string" /><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="ratingvalue" type="xs:decimal" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="validto" type="xs:dateTime" minOccurs="0" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="type" type="xs:string" use="required" /><br />
<xs:attribute name="classname" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="vegan" type="xs:boolean" use="optional" /><br />
<xs:attribute name="lactosefree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="glutenfree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="daily" type="xs:boolean" use="optional" /><br />
<xs:attribute name="kcal" type="xs:int" use="optional" /><br />
<xs:attribute name="weightg" type="xs:decimal" use="optional" /><br />
<xs:attribute name="price" type="xs:decimal" use="optional" /><br />
<xs:attribute name="dailyprice" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="validto" type="xs:dateTime" minOccurs="0" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="type" type="xs:string" use="required" /><br />
<xs:attribute name="classname" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="repetitioninterval" type="xs:int" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="dishes"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="dish"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="title" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="availablefrom" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="availableto" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="servetime" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="ingredients"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="ingredient"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="amountunit" type="xs:string" use="required" /><br />
<xs:attribute name="amount" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="rating"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="comments"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="comment"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="commenttext" type="xs:string" /><br />
<xs:element name="username" type="xs:string" /><br />
<xs:element name="userid" type="xs:string" /><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="ratingvalue" type="xs:decimal" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="validto" type="xs:dateTime" minOccurs="0" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="type" type="xs:string" use="required" /><br />
<xs:attribute name="classname" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="vegan" type="xs:boolean" use="optional" /><br />
<xs:attribute name="lactosefree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="glutenfree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="daily" type="xs:boolean" use="optional" /><br />
<xs:attribute name="kcal" type="xs:int" use="optional" /><br />
<xs:attribute name="weightg" type="xs:decimal" use="optional" /><br />
<xs:attribute name="price" type="xs:decimal" use="optional" /><br />
<xs:attribute name="dailyprice" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="address"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="addressfirstline" type="xs:string" /><br />
<xs:element name="locality" type="xs:string" /><br />
<xs:element name="postcode" type="xs:string" /><br />
<xs:element name="region" type="xs:string" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="country" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion" /><br />
<xs:element name="rating" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="comments"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="comment"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="commenttext" type="xs:string" /><br />
<xs:element name="username" type="xs:string" /><br />
<xs:element name="userid" type="xs:string" /><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="ratingvalue" type="xs:decimal" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="url" type="xs:string" use="required" /><br />
<xs:attribute name="contactnumber" type="xs:string" use="required" /><br />
<xs:attribute name="email" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:schema></source><br />
<br />
=== XSLT(HTML) ===<br />
<br />
<source><?xml version="1.0" encoding="utf-8" ?><br />
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:msxsl="urn:schemas-microsoft-com:xslt" exclude-result-prefixes="msxsl"><br />
<xsl:output method="html" indent="yes"/><br />
<xsl:template match="/restaurants"><br />
<html><br />
<head><br />
<title>Täis Kõht</title><br />
</head><br />
<body><br />
<xsl:for-each select="restaurant"><br />
<h1 style="color:DodgerBlue"><br />
<xsl:value-of select="name"/><br />
</h1><br />
<div><br />
<xsl:value-of select="@url"/><br />
</div><br />
<div><br />
<xsl:text>Kontakt number: </xsl:text><br />
<xsl:value-of select="@contactnumber"/><br />
</div><br />
<div><br />
<xsl:text>email: </xsl:text><br />
<xsl:value-of select="@email"/><br />
</div><br />
<div><br />
<xsl:text>Aadress: </xsl:text><br />
<xsl:value-of select="address/addressfirstline"/><br />
<xsl:text>, </xsl:text><br />
<xsl:value-of select="address/locality"/><br />
<xsl:text>, </xsl:text><br />
<xsl:value-of select="address/postcode"/><br />
<xsl:text>, </xsl:text><br />
<xsl:value-of select="address/@country"/><br />
</div><br />
<br />
<xsl:choose><br />
<xsl:when test="menus/menu"><br />
<xsl:for-each select="menus/menu"><br />
<xsl:sort select="name"/><br />
<h3><br />
<xsl:value-of select="name"/><br />
</h3><br />
<br />
<xsl:if test="activefrom != '' and activeto != ''"><br />
<xsl:text> </xsl:text><br />
<xsl:value-of select="substring(activefrom,1,10)"/><br />
<xsl:text> kuni </xsl:text><br />
<xsl:value-of select="substring(activeto,1,10)"/><br />
</xsl:if><br />
<br />
<ul><br />
<xsl:for-each select="dishes/dish"><br />
<xsl:sort select="title"/><br />
<br />
<xsl:if test="availablefrom != '' and availableto != ''"><br />
<xsl:value-of select="substring(availablefrom,1,10)"/><br />
<xsl:text> kuni </xsl:text><br />
<xsl:value-of select="substring(availableto,1,10)"/><br />
</xsl:if><br />
<br />
<li><br />
<span style="font-weight:bold"><br />
<xsl:value-of select="title"/><br />
</span><br />
<xsl:text> - </xsl:text><br />
<xsl:value-of select="description"/><br />
<xsl:text> </xsl:text><br />
<span style="font-weight:bold"><br />
<xsl:if test="@glutenfree='true'"><br />
<xsl:text>G </xsl:text><br />
</xsl:if><br />
<xsl:if test="@lactosefree='true'"><br />
<xsl:text>L </xsl:text><br />
</xsl:if><br />
<xsl:if test="@vegan='true'"><br />
<xsl:text>V </xsl:text><br />
</xsl:if><br />
</span><br />
</li><br />
<br />
<xsl:for-each select="ingredients/ingredient"><br />
<xsl:value-of select="name"/><br />
<xsl:if test="position()!=last()"><br />
<xsl:text>, </xsl:text><br />
</xsl:if><br />
</xsl:for-each><br />
<br />
<p style="font-weight:bold"><br />
<xsl:text>Hind: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="@price!=''"><br />
<xsl:value-of select="@price"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>-</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
<xsl:text> / Päevapakkumise hind: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="@dailyprice!=''"><br />
<xsl:value-of select="@dailyprice"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>-</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
</p><br />
<br />
<div style="background-color:LightGray;"><br />
<xsl:text>Hinnang praele: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="rating/@ratingvalue!=''"><br />
<xsl:value-of select="rating/@ratingvalue"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>Ei ole veel hinnatud!</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
<br />
<br/><br />
<xsl:for-each select="rating/comments/comment"><br />
<xsl:value-of select="username"/><br />
<xsl:text>: </xsl:text><br />
<xsl:value-of select="commenttext"/><br />
<br/><br />
</xsl:for-each><br />
</div><br />
<br/><br />
</xsl:for-each><br />
</ul><br />
</xsl:for-each><br />
</xsl:when><br />
<xsl:otherwise><br />
<ul><br />
<xsl:for-each select="dishes/dish"><br />
<xsl:sort select="title"/><br />
<br />
<xsl:if test="availablefrom != '' and availableto != ''"><br />
<xsl:value-of select="substring(availablefrom,1,10)"/><br />
<xsl:text> kuni </xsl:text><br />
<xsl:value-of select="substring(availableto,1,10)"/><br />
</xsl:if><br />
<br />
<li><br />
<span style="font-weight:bold"><br />
<xsl:value-of select="title"/><br />
</span><br />
<xsl:text> - </xsl:text><br />
<xsl:value-of select="description"/><br />
<xsl:text> </xsl:text><br />
<span style="font-weight:bold"><br />
<xsl:if test="@glutenfree='true'"><br />
<xsl:text>G </xsl:text><br />
</xsl:if><br />
<xsl:if test="@lactosefree='true'"><br />
<xsl:text>L </xsl:text><br />
</xsl:if><br />
<xsl:if test="@vegan='true'"><br />
<xsl:text>V </xsl:text><br />
</xsl:if><br />
</span><br />
</li><br />
<br />
<xsl:for-each select="ingredients/ingredient"><br />
<xsl:value-of select="name"/><br />
<xsl:if test="position()!=last()"><br />
<xsl:text>, </xsl:text><br />
</xsl:if><br />
</xsl:for-each><br />
<br />
<p style="font-weight:bold"><br />
<xsl:text>Hind: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="@price!=''"><br />
<xsl:value-of select="@price"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>-</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
<xsl:text> / Päevapakkumise hind: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="@dailyprice!=''"><br />
<xsl:value-of select="@dailyprice"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>-</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
</p><br />
<br />
<div style="background-color:LightGray;"><br />
<xsl:text>Hinnang praele: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="rating/@ratingvalue!=''"><br />
<xsl:value-of select="rating/@ratingvalue"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>Ei ole veel hinnatud!</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
<br />
<br/><br />
<xsl:for-each select="rating/comments/comment"><br />
<xsl:value-of select="username"/><br />
<xsl:text>: </xsl:text><br />
<xsl:value-of select="commenttext"/><br />
<br/><br />
</xsl:for-each><br />
</div><br />
<br/><br />
</xsl:for-each><br />
</ul><br />
</xsl:otherwise><br />
</xsl:choose><br />
<br />
<div style="background-color:LightGray;"><br />
<xsl:text>Hinnang restoranile: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="rating/@ratingvalue!=''"><br />
<xsl:value-of select="rating/@ratingvalue"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>Ei ole veel hinnatud!</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
<br />
<br />
<br/><br />
<xsl:for-each select="rating/comments/comment"><br />
<xsl:value-of select="username"/><br />
<xsl:text>: </xsl:text><br />
<xsl:value-of select="commenttext"/><br />
<br/><br />
</xsl:for-each><br />
</div><br />
<br />
<p><br />
<xsl:text>*G - gluteenivaba, </xsl:text><br />
<xsl:text>L - laktoosivaba, </xsl:text><br />
<xsl:text>V - vegan </xsl:text><br />
</p><br />
<br />
</xsl:for-each><br />
</body><br />
</html><br />
</xsl:template><br />
</xsl:stylesheet></source><br />
<br />
=== XSLT(XML) ===<br />
<br />
XML'is kuvatakse elemendid ja atribuudid eesti keeles. Kuvatakse restorani andmed ja toidud, mille hinnang on 8 või rohkem punkti.<br />
<br />
<source><?xml version="1.0" encoding="utf-8" ?><br />
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"<br />
xmlns:msxsl="urn:schemas-microsoft-com:xslt" exclude-result-prefixes="msxsl"><br />
<xsl:output method="xml" indent="yes"/><br />
<br />
<xsl:template match="/restaurants"><br />
<restoranid><br />
<xsl:for-each select="restaurant"><br />
<restoran url="{@url}" telefon="{@contactnumber}" email="{@email}"><br />
<nimi><br />
<xsl:value-of select="name"/><br />
</nimi><br />
<aadress><br />
<postiaadress><br />
<xsl:value-of select="address/addressfirstline"/><br />
</postiaadress><br />
<linn><br />
<xsl:value-of select="address/locality"/><br />
</linn><br />
<indeks><br />
<xsl:value-of select="address/postcode"/><br />
</indeks><br />
<riik><br />
<xsl:value-of select="address/@country"/><br />
</riik><br />
</aadress><br />
<br />
<parimadToidud><br />
<xsl:choose><br />
<xsl:when test="menus/menu/dishes/dish"><br />
<xsl:for-each select="menus/menu/dishes/dish"><br />
<xsl:if test="rating/@ratingvalue &gt;= 8.0"><br />
<heaToit hinnang="{rating/@ratingvalue}" paevaPakkumiseHind="{@dailyprice}" hind="{@price}" <br />
vegan="{@vegan}" laktoosivaba="{@lactosefree}" gluteenivaba="{@glutenfree}"><br />
<nimi><br />
<xsl:value-of select="title"/><br />
</nimi><br />
<kirjeldus><br />
<xsl:value-of select="description"/><br />
</kirjeldus><br />
</heaToit><br />
</xsl:if><br />
</xsl:for-each><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:for-each select="dishes/dish"><br />
<xsl:if test="rating/@ratingvalue &gt;= 8.0"><br />
<heaToit hinnang="{rating/@ratingvalue}" paevaPakkumiseHind="{@dailyprice}" hind="{@price}" <br />
vegan="{@vegan}" laktoosivaba="{@lactosefree}" gluteenivaba="{@glutenfree}"><br />
<nimi><br />
<xsl:value-of select="title"/><br />
</nimi><br />
<kirjeldus><br />
<xsl:value-of select="description"/><br />
</kirjeldus><br />
</heaToit><br />
</xsl:if><br />
</xsl:for-each><br />
</xsl:otherwise><br />
</xsl:choose><br />
</parimadToidud><br />
</restoran><br />
</xsl:for-each><br />
</restoranid><br />
</xsl:template><br />
</xsl:stylesheet><br />
</source><br />
<br />
== Retsensioonid ==<br />
<br />
=== Veebiteenuse retsensioon meeskonnale [https://wiki.itcollege.ee/index.php/MOT MOT] ===<br />
<br />
* Puudub README vms. Dokumentatsioon projekti ülespanemiseks ja seadistamiseks.<br />
* Rollide loomine vigane, seda võiks teha eraldi failis, mis on DAL.App.EF projektis (kasutasime algul sama lähenemist nagu antud projekt). Takistab esialgset andmebaasi uuendust, kui rollid veel puuduvad. Rakenduse installimine tarnitud kujul ei õnnestunud. Selleks et Nuget Package Manageri käsk Update-Database töötaks pidi ajutiselt välja kommenteerima Startup.cs faili rea 153 (// CreateRoles(services).Wait();).<br />
==== Andmebaasist: ====<br />
* Üldiselt paneksin igale väljale juurde AddTime ja UpdateTime see on hea tava millest korduvalt ka andmebaasi alustes räägiti ja rõhutati.<br />
==== Olemitest: ====<br />
* Kui juba domainis nimetate kõik olemid singulaarselt siis võiks ju sama teha ka andmebaasis - lisakeerukuse loomine kohas kus see ei ole vajalik.<br />
* Entity-te arv oli nõutust väiksem - Kokku 8 olemit, millest 1 on many-to-many liittabel ja 1 otsene koopia Identity framework Users tabelist. <br />
* Olem People ~= Users ja sisaldab ka viidet Identity tabelile ApplicationUsers (ApplicationUserId). Juhul kui see on mõeldud rakendusega mitte registreerunud kasutajate võistlusele kirja panemiseks, siis oleks olemil rohkem infot vaja - vähemalt mingigi kontakti väli (email |/& tel.nr. |/& aadress).<br />
* Competition.Comment on varchar(100) - võiks ja peaks olema varchar(1000)<br />
* Competition.CompetitionPlaceId - kui võistluse toimumiskoht mingil põhjusel peaks keelduma korraldusest või kui võistlust alles pannakse kokku ja ei ole veel teada kus see toimuma saab siis mis peaks sinna sisestama (NOT NULL => NULL)<br />
* Competition.Time -> Mis aega see näitab? Property nimest seda välja ei loe. Kui StartTime, siis kus on EndTime või Duration?<br />
* CompetitionPlace.County -> int type enum default väärtus on 0, kuna see pole aga enumi klassis implementeeritud põhjustab see vea. (Millisele maakonnale vastab 0?) See teada tuntud probleem millele google annab hõlpsasti erinevaid lahendusi: näiteks [https://stackoverflow.com/questions/24350377/entity-framework-6-code-first-required-enum-data-type-not-working?utm_medium=organic&utm_source=google_rich_qa&utm_campaign=google_rich_qa siin] ja [https://stackoverflow.com/questions/529929/choosing-the-default-value-of-an-enum-type-without-having-to-change-values/529937?utm_medium=organic&utm_source=google_rich_qa&utm_campaign=google_rich_qa siin].<br />
* Väljad mis viitavad Identity framework olemitele läbi nende ID-de ei peaks olema nvarchar(max) vaid nvarchar(450) (kuigi isegi see on reaalsuses liiga pikk).<br />
* PersonInTeam.PersonInTeamId -> ei peaks olema sellist välja üldse, selle tabeli PK peaks olema kombinatsioon nende tabeli ID-st mida ta ühendab. Praegu ei ole unique indeksit üle nende, mis tähendab et sama inimene saab mitu korda sama tiimiga liituda.<br />
* Participations - Miks selline nimi, kui registreerimine juba oli? Saan aru et selles olemis tahetakse säilitada võistluse tulemusi. Siis võiks ju juba olla CompetitionResults. Kus on aga saavutatud koha numbri talletamine? Kui võistluse punktid ja ajad on kõik kirja saadud siis tahaks ju tulemusi ka kuidagi näha ja võrrelda ning selle võrdluse tulemi kuhugi salvestada.<br />
* Participations.Time - Mis aega näitab? Eeldan, et võistluse läbimise aega? Kui nii, siis miks ei ole NULL lubatud - mõnedel võistlustel aega ju ei mõõdeta?<br />
* Participation.Points - Kas igal võistlusel antakse ainult täisarv punkte (int)? Võiks igaks juhuks siiski implementeerida double väärtuse tüübi. Lisaks ei ole võimalik osalust luua ilma punkte teadmata - peaks siis määrama default väärtus. Mõnede võistluste puhul jälle punkte ei anta vaid mõõdetakse aega.<br />
* Participation.Disqualified - Nullid ei ole lubatud -> järelikult oleks default väärtust vaja.<br />
* Registrations - Projekti Must have alla on märgitud “Osaleja saab registreerida võistlusele meeskonda” kuid olemis puudub TeamsId ning samuti ei ole seda võimalust kuidagi läbi Servicei implementeeritud.<br />
* Registrations - Millal registreering tehti on suhteliselt tähtis teada. Paljude võistluste puhul sõltub sellest näiteks registreerimistasu. <br />
==== DTO-d: ====<br />
* Täiesti mõttetult sisse toodud kiht, lihtsalt selleks et nii oli ette nähtud. Kõik DTO-d konverteeritakse ümber 1:1-le Domain objektideks ja vastupidi.<br />
* Üldiselt oleks vaja teha tööd veel DTOdega, et need rohkem peegeldaksid oma kasutust. Näiteks:<br />
** küsides kõiki võistlusi, kas meil on tarvis avalikustada kliendile, mis on kasutaja ID, kes iga võistluse lõi? DTOsid võiks olla rohkem erinevate kasutusjuhtumite jaoks. <br />
** CompetitionDTO võiks sisaldada ka nimekirja võistlejatest, kus koondatakse info ManyToMany seoste põhjal kasutades vahetabelit, nagu näiteks:<br />
<source><br />
List<PersonDTO> people = c.Participation<br />
.FindAll(p => p.CompetitionId == c.CompetitionId)<br />
.Select(PersonDTO.CreateFromParticipation)<br />
.ToList();<br />
</source><br />
<br />
==== API Kontrolleritest: ====<br />
* Puudub Swagger startup konfiguratsioon, Swagger annotatsioonid kaotavad mõtte ning pole võimalik kontrollida, kas need on korrektselt loodud.<br />
* ProducesResponse annotatsiooni pole kusagile lisatud, staatuskoodid on natuke poolikult läbi mõeldud, vähemalt need, mida Swaggeri raames mainitud on<br />
*Annotatsioon Authorize, kus on ära määratud AuthorizationScheme peaks minema kogu klassi peale, meetodis saab ära määrata vaid selle, mis rollid on lubatud.<br />
* AccountController<br />
** Response code uue kasutaja loomisel võiks olla 201<br />
** Puuduvad koodid nagu 429, 500<br />
** Registreerumisel võiks kontrollida, kas kasutaja on juba olemas, mitte vaid rolli olemasolu<br />
** Kas kasutajal ei või antud kontekstis olla mitu rolli? Sisselogimisel võetakse rollide seast vaid esimene ja lisatakse juurde Claimile. Võimalus kirjutada ka meetod, mis lisab kasutajale kõik rollid.<br />
* CompetitionPlacesController/CompetitionsController/CompetitionTypesController/ParticipationsController/RegistrationsController/TeamsController <br />
** Antud kontrollerid on kõik väga sarnase loogikaga<br />
** Get() tagastab vaid koodi 200, tagastuskoodi võimalusi on veel<br />
** Post() meetod küsib sisse DTOd, mille üheks parameetriks on id, id genereeritakse automaatselt, seda ei peaks panema kaasa postitatavasse mudelisse, mis alles loob objekti<br />
** Put() puhul sama kriitika, siin on id küll vajalik, aga see juba pannakse kaasa parameetrina eraldi<br />
** See tundub natuke veidrana üritada kontrollida uuendatud mudeli põhjal, kas tegemist oli BadRequestiga. Eelkõige peaks id puhul üles otsima, kas antud objekt on üldse olemas ja seejärel üritada uuendada, muidu tagastada BadRequest. Kui see ei õnnestu, siis peaks juba errorkood 500 peegeldama seda, et midagi läks teenuse poole peal valesti. <br />
** Sama kommentaar deletemise kohta, enne tuleks kontrollida, kas objekt on olemas. Siis alles objekt kustutada.<br />
* PeopleController<br />
** Kas tõepoolest igaüks saab pärida infot inimeste kohta ja neid postitada? <br />
* PersonInTeamsController <br />
** API disaini poole pealt on natuke veider teha vahetabelite kohta kontroller. Tundub loogilisem panna antud kontrolleri meetodid teistesse kontroleritesse, mis on seotud siis kas meeskondade või inimestega. Näiteks küsida ** PeopleControlleris kõik inimesed, kes on meeskondades või küsida neid meeskonna järgi. TeamsControlleris seevastu anda võimalus lisada uusi inimesi meeskonda, neid muuta või eemaldada.<br />
** Id järgi ei hakka ükski klient küsima vahetabeli kohta infot, see tundub otstarbetu tegevus, pigem küsida kas meeskonna või inimese id järgi sissekandeid<br />
* Kriitika kontrollerite kohta: kontrollerid enamuses pöörduvad vaid spetsiifiliste domeenide poole ja viivad ellu väga tavalist CRUD funktsionaalsust, mille tõttu tundub, et need on natuke veel toored. Näiteks on välja toodud “must have” nimekirjas projekti analüüsis, et meeskonna liige peaks saama muuta meeskonna andmeid. Antud kontrollerites vaid autentitakse, et kasutaja oleks rollis “participant”, kuid mitte seda, kas ta ka muudetava meeskonna liige on. Samuti pole võimalik kasutajatel näha, palju on mingile võistlusele osalejaid registreerunud, CompetitionsController ei tegele sellega, et tagastada võistlusele registreerunud kasutajaid, selle asemel on olemas ParticipationsController, mis tagastab vahetabeli infot selle kohta, mis võistlusega on seotud mis inimene. See võib olla tohutult suur info, mida hakata filtreerima kliendi poolelt. Rohkem tuleks teha andmete agregeerimist vastavalt teenuse kontekstile.<br />
<br />
==== Projekti kihid/struktuur: ====<br />
* Olemas Business Logic, Data Access Layer, DTO’d, Service’id, Unit of Work, domeeniklassid ning API spetsiifilised kontrollerid, mis asuvad oma kaustas põhiprojekti all . DAL omab erinevaid kihte interface’ide ja neid implementeerivate klasside jaoks. Repositooriumitega suhtlemine on abstraktne, kõik käib läbi Data Access Layer’i, mille pööle pöörduvad teenuseklassid ning DAL erinevad kihid hoolitsevad selle eest, et loodaks õiget tüüpi repositooriumeid, andmeid agregeeritakse, uuendatakse ja salvestatakse organiseeritud kujul ning neid tagastatakse teenustele soovitud kujul (DTOd).<br />
<br />
== Logiraamat ==<br />
<br />
===07.02.2018===<br />
Gupi loomine ning suhtluskanali seadistamine<br />
<br />
=== 24.03.2018 ===<br />
Trello boardi loomine<br />
<br />
=== 25.03.2018 ===<br />
Wiki lehe loomine. Esimene tõsisem projekti koosolek ning tegevuskava paika panemine.<br />
<br />
=== 26.03.2018 ===<br />
<br />
Alustasime veebiteenuse analüüsiga ja funktsionaalsuse kirjeldamisega.<br />
<br />
=== 27.03.2018 ===<br />
Täiendasime veebiteenuse analüüsi.<br />
<br />
Esmase andmebaasi mudeli koostamine.<br />
<br />
Postitatud esimeste analüüsi arutelude põhjal valminud algne prototüüp.<br />
<br />
=== 30.03.2018 ===<br />
Valmis andmebaasimudel.<br />
<br />
=== 08.04.2018 ===<br />
Tehtud muudatused analüüsis vastavalt tagasisidele.<br />
<br />
=== 19.04.2018 ===<br />
Loodud projekti põhi koos domeenimudelitega. Projekt lisatud Githubi: https://github.com/sikumiku/TaisKohtApi<br />
<br />
=== 05-06.05.2018 ===<br />
Osalesime hackathonil. Lisatud controllerid, service'id koos vajalike kihtidega.<br />
<br />
=== 16.05.2018 ===<br />
Uuendatud andmebaasimudelit, DTO'sid.<br />
<br />
=== 18-19.05.2018 ===<br />
Lisatud klientrakendus, security, äriloogikat.<br />
<br />
=== 20.05.2018 ===<br />
Lisatud API dokumentatsioon.<br />
<br />
=== 22-24.05.2018 ===<br />
Uuendatud contoller'eid, service'id.<br />
<br />
=== 25-27.05.2018 ===<br />
Uuendatud contoller'eid, service'id. Lisatud kasutajate ja rollide kontrolle meetoditesse. Täiustatud klientrakendust. Swagger dokumentatsioon.<br />
<br />
=== 31.05-01.06.2018 ===<br />
Tegeletud XML, XSD ja XSLT failide loomisega.<br />
<br />
=== 01.06-03.06.2018 ===<br />
Tegeletud XML ja XSLT failide täiustamisega ja retsensioonide kirjutamisega.</div>
Saasma
https://wiki.itcollege.ee/index.php?title=BeerPressure&diff=131185
BeerPressure
2018-06-03T20:45:26Z
<p>Saasma: /* API Kontrolleritest: */</p>
<hr />
<div>== Meeskond ja rollid ==<br />
<br />
* Sigrid Aasma (arendaja)<br />
* Evelin Jõgi (arendaja)<br />
* Martin Kask (projektijuht, arendaja)<br />
* Marko Nõu (arendaja)<br />
<br />
== Idee ==<br />
'''Toidukohtade põhimenüüde ja päevapakkumiste teenus'''<br />
<br />
Soovime pakkuda toidukohtade põhimenüüde ja päevapakkumiste teenust. On olemas mitmeid kodulehti “päevapakkumised”, kus on kirjas toidukohtade päevapraed. Kuid tavaliselt sellistel lehtedel ei ole masinloetavaid andmeid ehk siis varianti, et saad saata API pihta mingi kuupäeva koos päevapraadidega andmete uuendamiseks ja saad sama API käest küsida tänaseid päevapraade. Andmeid võiks saada küsida restorani, kuupäeva, asukoha või otsisõna/otsisõnaosa põhiselt. Selline teenus lihtsustaks ka toidukohtade päevapakkumiste haldamist, kuna praegu peavad teenuse pakkujad vastavat informatsiooni uuendama mitmes erinevas kohas - nii erinevates portaalides, kui ka enda veebileheküljel. Samuti oleks toidukohtade kogu menüü haldamine ühes kohas.<br />
<br />
=== Esialgne prototüüp ===<br />
<br />
[[File:TäisKõhtProto1.mp4]]<br />
<br />
Esialgne prototüüp: [http://enos.itcollege.ee/~saasma/VR2/Proto/K%C3%B5htT%C3%A4is/#g=1&p=home navigeeritav versioon vol.1]<br />
<br />
=== Prototüübi muutus projekti käigus ===<br />
<br />
Prototüüp: [http://enos.itcollege.ee/~saasma/VR2/Proto/T%C3%A4isK%C3%B5ht/K%C3%B5htT%C3%A4is/#g=1&p=home navigeeritav versioon vol.2]<br />
<br />
== Kasutatav arendustehnoloogia ==<br />
<br />
Veebiteenuse loomisel kasutame ASP.NET Core tehnoloogiat ja kursusel õpitud arendusmustreid.<br />
<br />
Klientrakenduse loomisel kasutame Node.js + React'i.<br />
<br />
== Veebiteenuse analüüs ==<br />
Pakume toidukohtade põhimenüüde ja päevapakkumiste teenust, kuhu on kokku koondatud erinevate toidukohtade menüüd üle Eesti. Põhimenüü alla kuuluvad pikaajalised menüüd, mis kehtivad püsivalt, hooajaliselt või mingil konkreetsel nädalapäeval. Päevapakkumiste alla kuuluvad konkreetse kuupäevaga seotud päevapakkumised. Päevapakkumiste korral kuvatakse lisainfona, kas pakkumine kehtib mingis konkreetses ajavahemikus või kogu toidukoha lahtioleku aja.<br />
<br />
Eesmärk on koguda ühte kohta kokku erinevate toidukohtade menüüd ja päevapakkumised, et kliendid saaksid mugavalt ja kiiresti oma valikuid teha. Kliendid käivad enamasti päevapakkumisi söömas lõuna ajal ja selleks ettenähtud aeg on piiratud. Sellepärast on oluline, et klient saaks teha oma valiku võimalikult kiiresti. Tänu loodavale veebiteenusele ei pea kliendid käima erinevates portaalides, et tutvuda erinevate toidukohtade pakkumistega. Kuna teenust on mugav kasutada ja klient saab oma valiku kiiresti tehtud, siis tõenäoliselt teeb klient valiku selles keskkonnas olevate toiduasutuste seast. Lisaks võimaldab teenus toiduasutustel paika panna oma pikaajalisem põhimenüü ning seda rakenduses ja võimalusel ka söögikohas kuvada. Sellepärast on ka toidukohtade huvi antud keskkonnas üleval olla ja meiega oma andmeid jagada, sest see suurendab nende klientuuri ning muudab oma menüü haldamise kergemaks.<br />
<br />
Veebiteenuse loomisel lähtume eelkõige sellest, et kliendil oleks teenust mugav kasutada ja ta saaks oma valiku kiiresti tehtud. Arvestame, et kliendid on erinevad. Mõni eelistab mõnda kindlat toidukohta, sel juhul saab ta valida oma soovitud kohad ja võrrelda nende kohtade tänase päeva pakkumisi ning menüüsid. Mõnele inimesele on oluline pakutav söök ja ta eelistab pakkumist otsida prae nimetuses oleva sõna või sõnaosa järgi ning lähtuda seejärel valiku tegemisel toidukoha keskmisest hindest või toidu hinnast. Mõne kliendi jaoks on oluline hind ja selleks, et oma valikut teha sobivas hinnavahemikus on tal võimalik sisestada maksimum hinna piirang. Kindlasti on antud teenuse juures kõikide klientide jaoks oluline päevapakkumiste asukohapõhine eristatus. Kliendid, kes soovivad oma konto luua, võivad oma eelistatud valikud meelde jätta ja järgmisel korral kuvatakse neid talle automaatselt.<br />
<br />
Teenuse must-have funktsionaalsus tagab teenuse toimimise ja põhifunktsioonid. Teenuse nice-to-have funktsionaalsus annab rakendusele lisandväärtust.<br />
<br />
Arvestades pakutava teenusega, siis näeme, et aktiivseim teenuse kasutamine võib olla tööpäevadel vahemikus 11.00-15.00, kui kliendid tutvuvad päevapakkumistega. Teenus peab tekkivale koormusele vastu pidama.<br />
<br />
Teenuse pakkumine peab olema turvaline. Selle tagamiseks tuleb sisestatavaid andmeid valideerida ja andmebaasi sisestavate andmete mahtu piirata. Toidukohtade sisestatud andmed peavad olema kaitstud, et toitude koostised ei saaks avalikuks. Põhjendatud juhtudel on võimalik kasutajaid lukku panna.<br />
<br />
== Kasutajad ==<br />
<br />
<br />
* Admin - lehe administraator, kellel on õigus lehte, kasutajaid ja nende õiguseid hallata. Tema huvi on, et teenus toimiks tõrgeteta.<br />
* Toiduasutus (tasuta kasutaja) - saab hoida lehel ühte põhimenüüd ja päevapakkumisi.<br />
* Toiduasutus (tellimusega kasutaja) - saab hoida lehel piiramatu arv põhimenüüsid ja päevapakkumisi.<br />
Toiduasutused on teenusest huvitatud, et nende menüüde haldamine oleks kerge ja mugav ning nad saaksid oma klientide arvu suurendada.<br />
* Külastaja - klient, kes valib söögikohta. Tema on huvitatud eelkõige sellest, et teenust saaks kasutada mugavalt ja kiirelt ning toidukohtade valik oleks võimalikult suur.<br />
<br />
== Rakenduse must-have funktsionaalsus ==<br />
<br />
* Kasutajad saavad sisse logida<br />
* Kasutajatel on erinevad rollid: admin, toidukoht (tasuta ja tasulise tellimusega), klient<br />
* Kasutajate arvepidamine kasutajate lõikes:<br />
** sisselogimise kuupäev, kellaaeg<br />
** pakkumiste lisamine<br />
** pakkumiste muutmine<br />
** pakkumiste kustutamine<br />
** õiguste kehtimise periood (tasuta ja tellimusega toidukoht)<br />
** pakkumistele klikkimise arv<br />
* Kasutajaid on võimalik hallata:<br />
** kasutajale õiguste andmine (menüüde arvu suurendamine, tellimusega toidukohal), rolli määramine<br />
** Kasutajat on võimalik piirata: õiguseid piirata (piiratud menüüde arv, tasuta liitunud toidukohal) ja lukku panna<br />
* Päevapakkumisi/menüüsid saab küsida: <br />
** toidukoha järgi, <br />
** kuupäeva põhiselt (ainult päevapakkumisi), <br />
** asukoha põhiselt,<br />
** toidu nimetuses esineva otsisõna/otsisõna osa põhiselt,<br />
** hinna põhiselt (max hinna piirang).<br />
* Klientrakenduses realiseeritakse CRUD meetodid (menüüsid/päevapakkumisi saab sisestada, lugeda, uuendada, kustutada)<br />
* Toidukohale saab anda hindeid ja kuvatakse keskmist hinnet.<br />
* Toidule saab anda hindeid ja kuvatakse keskmist hinnet.<br />
<br />
== Nice-to-have funktsionaalsus ==<br />
<br />
* Info selle kohta, kas päevapakkumine on otsas<br />
* Päevapakkumisi/menüüsid saab kommenteerida ja neid kommentaare kuvatakse avalikult.<br />
* Söögikohtade kodulehtedelt otsimise script, mis genereerib juba olemasolevate kodulehtede baasil päevamenüüsid.<br />
* Toiduvaliku piiramine allergeenide/vegan/jms. koostisosade põhiselt.<br />
* Aruandlused ja võrdlused toidukohtadele, et võrrelda end konkurentidega.<br />
* Teenus soovitab toidukohtadele nende varasemate päevapraadide populaarsuse alusel uue nädala menüüd.<br />
* Erinevad toidukohtade/toitude pingeread klientidele, et anda valikuteks ideid.<br />
* Soovitused klientidele, mida teised kliendid sarnaste eelistustega on veel valinud.<br />
<br />
== Andmebaasi ülesehitus - projekti algus ==<br />
<br />
[[File: BeerPressureAndmebaasimudel.png]]<br />
<br />
== Andmebaasi ülesehitus - projekti lõpp ==<br />
<br />
[[File: Ta2isKo6ht-DB-FINAL.png]]<br />
<br />
== Projekti repository ==<br />
<br />
https://github.com/sikumiku/TaisKohtApi<br />
<br />
Zip fail saadaval: <br />
(master branchi viimane commit esitamise ajal)<br />
https://github.com/sikumiku/TaisKohtApi/archive/61438e187a1a972410c8a3bc6274d69489d00aa6.zip<br />
<br />
== API v1 dokumentatsioon ==<br />
<br />
===Security===<br />
'''POST /api/account/register'''<br />
<source><br />
Params: RegisterViewModel registerViewModel<br />
<br />
Returns: token<br />
</source><br />
<br />
'''POST /api/account/login'''<br />
<source> <br />
Params: LoginViewModel model<br />
<br />
Returns: token<br />
</source><br />
<br />
'''POST /api/account/logout'''<br />
<source> <br />
Params: -<br />
<br />
Returns: -<br />
</source><br />
<br />
===Accounts===<br />
'''GET /api/v1/accounts/getAllUsersInRole'''<br />
<source> <br />
Params: string role<br />
<br />
Returns: List<UserDTO><br />
</source><br />
<br />
'''GET /api/v1/accounts/{id}'''<br />
<source> <br />
Params: string id<br />
<br />
Returns: UserDTO<br />
</source><br />
<br />
'''PUT /api/v1/accounts/{id}'''<br />
<source> <br />
Params: string id, UpdateUserDTO userDTO<br />
<br />
Returns: -<br />
</source><br />
<br />
'''POST /api/v1/accounts/addRole'''<br />
<source> <br />
Params: string role<br />
<br />
Returns: -<br />
</source><br />
<br />
'''POST /api/v1/accounts/addRoleToUser'''<br />
<source> <br />
Params: string role, string userId<br />
<br />
Returns: UserDTO<br />
</source><br />
<br />
'''DELETE /api/v1/accounts/deactivate/{id}'''<br />
<source> <br />
Params: string id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Promotions===<br />
'''GET /api/v1/promotions '''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<PromotionDTO> <br />
</source><br />
<br />
'''GET /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: PromotionDTO<br />
</source><br />
<br />
'''POST /api/v1/promotions'''<br />
<source> <br />
Params: PromotionDTO promotionDTO<br />
<br />
Returns: PromotionDTO newPromotion<br />
</source><br />
<br />
'''PUT /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id, PromotionDTO promotionDTO<br />
<br />
Returns: PromotionDTO updatedPromotion<br />
</source><br />
<br />
'''DELETE /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Restaurants===<br />
'''GET /api/v1/restaurants'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<SimpleRestaurantDTO><br />
</source><br />
<br />
'''GET /api/v1/restaurants/search?name=th'''<br />
<source> <br />
Params: string name<br />
<br />
Returns: List<SimpleRestaurantDTO> result<br />
</source><br />
<br />
'''GET /api/v1/restaurants/top'''<br />
<source> <br />
Params: int amount<br />
<br />
Returns: List<SimpleRestaurantDTO> result<br />
</source><br />
<br />
'''GET /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: RestaurantDTO r<br />
</source><br />
<br />
'''POST /api/v1/restaurants/addUserToRestaurant'''<br />
<source> <br />
Params: int id, string userId<br />
<br />
Returns: -<br />
</source><br />
<br />
'''POST /api/v1/restaurants'''<br />
<source> <br />
Params: PostRestaurantDTO restaurantDTO<br />
<br />
Returns: RestaurantDTO newRestaurant<br />
</source><br />
<br />
'''PUT /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id, PostRestaurantDTO restaurantDTO<br />
<br />
Returns: PostRestaurantDTO updatedRestaurantDTO<br />
</source><br />
<br />
'''DELETE /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Menus===<br />
'''GET /api/v1/menus'''<br />
<source><br />
Params: -<br />
<br />
Returns: List<MenuDTO><br />
</source><br />
<br />
'''GET /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: MenuDTO menuDTO<br />
</source><br />
<br />
'''POST /api/v1/menus'''<br />
<source> <br />
Params: PostMenuDTO menuDTO<br />
<br />
Returns: MenuDTO newMenu<br />
</source><br />
<br />
'''PUT /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id, PostMenuDTO menuDTO<br />
<br />
Returns: MenuDTO updatedMenu<br />
</source><br />
<br />
'''PUT api/v1/Menus/{id}/Dishes'''<br />
<source> <br />
Params: int menuId, int[] dishIds<br />
<br />
Returns: -<br />
</source><br />
<br />
'''DELETE /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Dishes===<br />
'''GET /api/v1/dishes'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<DishDTO><br />
</source><br />
<br />
'''GET /api/v1/dishes/daily'''<br />
<source> <br />
Params: bool vegan, bool glutenFree, bool lactoseFree<br />
<br />
Returns: List<SimpleDishDTO> result<br />
</source><br />
<br />
'''GET: api/v1/dishes/search?title=th&priceLimit=null'''<br />
<source> <br />
Params: string title, decimal? priceLimit<br />
<br />
Returns: List<DishDTO> result<br />
</source><br />
<br />
'''GET /api/v1/dishes/top'''<br />
<source> <br />
Params: int amount<br />
<br />
Returns: List<DishDTO> result<br />
</source><br />
<br />
'''GET /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: DishDTO dishDTO<br />
</source><br />
<br />
'''POST /api/v1/dishes'''<br />
<source> <br />
Params: PostDishDTO dishDTO<br />
<br />
Returns: DishDTO newDish<br />
</source><br />
<br />
'''PUT /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id, PostDishDTO dishDTO<br />
<br />
Returns: DishDTO updatedDish<br />
</source><br />
<br />
'''PUT api/v1/Dishes/{id}/Ingredients'''<br />
<source> <br />
Params: int dishId, PostIngredientForDishDTO[] ingredients<br />
<br />
Returns: -<br />
</source><br />
<br />
'''DELETE /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Ingredients===<br />
'''GET /api/v1/ingredients'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<IngredientDTO><br />
</source><br />
<br />
'''GET /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: IngredientDTO i<br />
</source><br />
<br />
'''POST /api/v1/ingredients'''<br />
<source> <br />
Params: PostIngredientDTO ingredientDTO<br />
<br />
Returns: IngredientDTO newIngredient<br />
</source><br />
<br />
'''PUT /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id, PostIngredientDTO ingredientDTO<br />
<br />
Returns: IngredientDTO updatedIngredient<br />
</source><br />
<br />
'''DELETE /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Ratings===<br />
'''GET /api/v1/ratings'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<RatingLogDTO><br />
</source><br />
<br />
'''GET /api/v1/ratings/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: RatingLogDTO dto<br />
</source><br />
<br />
'''POST /api/v1/ratings'''<br />
<source> <br />
Params: RatingLogForEntityDTO ratingDTO<br />
<br />
Returns: RatingLogDTO newRating<br />
</source><br />
<br />
'''PUT api/v1/ratings/{id}'''<br />
<source> <br />
Params: int id, RatingLogForEntityDTO ratingDTO<br />
<br />
Returns: RatingLogDTO updatedRating<br />
</source><br />
<br />
'''DELETE api/v1/ratings/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===RequestLog===<br />
'''GET: api/v1/usageData/{userId}'''<br />
<source> <br />
Params: string userId<br />
<br />
Returns: List<RequestLogDTO><br />
</source><br />
<br />
== Lõpptoote kasutusjuhend ==<br />
<br />
* Kloonida kohalikku arvutisse repository aadressilt [https://github.com/sikumiku/TaisKohtApi https://github.com/sikumiku/TaisKohtApi]<br />
* Installida NodeJS<br />
* <source>npm install webpack -g</source><br />
* <source>npm install -cli -g</source><br />
* Frontend rakenduse kasutamiseks valida Startup meetoditest IIS Express, veebiteenuse ja Swaggeri kasutamiseks käivitada Api Swagger<br />
* Esimese admin kasutaja loomiseks tuleb kasutaja registreerida admin@gmail.com e-mailiga<br />
<br />
== XML/XSD/XSLT ==<br />
<br />
=== XML ===<br />
<br />
<source><?xml version="1.0" encoding="utf-8" ?><br />
<?xml-stylesheet type="text/xsl" href="XMLFileXML.xslt"?><br />
<restaurants><br />
<restaurant id="1" url="https://kuuspelmeeni.ee" contactnumber="507783342" email="kuuspelmeeni@gmail.com"><br />
<name><![CDATA[Kuus Pelmeeni]]></name><br />
<menus><br />
<menu id="1" repetitioninterval="30"><br />
<name><![CDATA[Päevamenüü]]></name><br />
<activefrom>2018-05-27T12:00:00</activefrom><br />
<activeto>2018-05-28T12:00:00</activeto><br />
<dishes><br />
<dish id="1" vegan="false" lactosefree="false" glutenfree="false" daily="true" kcal="550" dailyprice="4"><br />
<title><![CDATA[8 pelmeeni]]></title><br />
<description><![CDATA[8 pelmeeni 6 asemel serveeritud tervisliku koguse hapukoore ja tilliga]]></description><br />
<availablefrom>2018-05-27T12:00:00</availablefrom><br />
<availableto>2018-05-28T12:00:00</availableto><br />
<ingredients><br />
<ingredient id="1" amountunit="g"><br />
<name>Sealiha</name><br />
<description>Rakvere sealiha</description><br />
</ingredient><br />
<ingredient id="2" amountunit="g"><br />
<name>Hapukoor</name><br />
<description>Alma hapukoor</description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="9"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Parim päevaroog viimasel ajal.]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
</comments><br />
</rating><br />
<promotion id="1" type="visual" classname="bold-red-border-2px"><br />
<name>2px red border</name><br />
<description><![CDATA[Displays a 2px wide red border around the component that is promoted.]]></description><br />
<validto>2018-06-25T12:00:00</validto><br />
</promotion><br />
</dish><br />
<dish id="2" vegan="true" lactosefree="true" glutenfree="true" daily="true" kcal="320" price="4"><br />
<title><![CDATA[Kurgisalat]]></title><br />
<description><![CDATA[Erinevatel viisidel töödeldud kurk serveeritud koos jõhvikatega. Tervislik amps.]]></description><br />
<availablefrom>2018-05-27T12:00:00</availablefrom><br />
<availableto>2018-05-28T12:00:00</availableto><br />
<ingredients/><br />
<rating ratingvalue="4"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Jäin veel väga näljaseks peale selle söömist.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
</dishes><br />
</menu><br />
<menu id="2"><br />
<name><![CDATA[Põhimenüü]]></name><br />
<dishes><br />
<dish id="4" vegan="false" lactosefree="false" glutenfree="false" daily="false" kcal="550" price="5"><br />
<title><![CDATA[6 pelmeeni]]></title><br />
<description><![CDATA[6 pelmeeni serveeritud tervisliku koguse hapukoore ja tilliga]]></description><br />
<ingredients><br />
<ingredient id="1" amountunit="g"><br />
<name>Sealiha</name><br />
<description>Rakvere sealiha</description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="9.5"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Käin seda iga päev söömas.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Parim toit selles restoranis.]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
<dish id="5" vegan="false" lactosefree="false" glutenfree="true" daily="false" kcal="460" price="3.8"><br />
<title><![CDATA[Kartulisalat]]></title><br />
<description><![CDATA[Sinki sisaldav traditsiooniline kartulisalat.]]></description><br />
<ingredients/><br />
</dish><br />
<dish id="6" vegan="false" lactosefree="false" glutenfree="false" daily="false" kcal="610" price="3.9"><br />
<title><![CDATA[Šokolaadikook]]></title><br />
<description><![CDATA[Ahvatlev glasuuritud šokolaadikook.]]></description><br />
<ingredients/><br />
<rating ratingvalue="7.8"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Šokolaadikooki on keeruline metsa keerata.]]></commenttext><br />
<username>mutikas3</username><br />
<userid>3a29b94a-3f17-469d-a44d-f7d85e98dd3e</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
</dishes><br />
</menu><br />
</menus><br />
<dishes/><br />
<address id="1" country="Eesti"><br />
<addressfirstline>Tatari 12</addressfirstline><br />
<locality>Tallinn</locality><br />
<postcode>10132</postcode><br />
<region>Harjumaa</region><br />
</address><br />
<promotion/><br />
<rating ratingvalue="7.5"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Parim restoran üldse!]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Ma sain ainult 5 pelmeeni. Ootasin kuute.]]></commenttext><br />
<username>kyllikekallike1</username><br />
<userid>6af271dd-0e11-4ae6-98be-111762664318</userid><br />
</comment><br />
</comments><br />
</rating><br />
</restaurant><br />
<restaurant id="2" url="https://kolmkokka.ee" contactnumber="6522351" email="kolmkokka@gmail.com"><br />
<name><![CDATA[Kolm kokka]]></name><br />
<menus/><br />
<dishes><br />
<dish id="7" vegan="false" lactosefree="true" glutenfree="false" daily="false" kcal="470" price="14"><br />
<title><![CDATA[Ahjulõhe juurikatega]]></title><br />
<description><![CDATA[Ahjulõhe serveeritud püreestatud porgandite ja lillkapsaga.]]></description><br />
<ingredients><br />
<ingredient id="11" amountunit="tk" amount="1"><br />
<name>Ahjulõhe</name><br />
<description><![CDATA[Värske ahjulõhe]]></description><br />
</ingredient><br />
<ingredient id="12" amountunit="g"><br />
<name>Püreestatud porgand</name><br />
<description><![CDATA[Eesti porgand, mis on kergelt püreestatud]]></description><br />
</ingredient><br />
<ingredient id="13" amountunit="g"><br />
<name>Püreestatud lillkapsas</name><br />
<description><![CDATA[Eesti lillkapsas, mis on kergelt püreestatud ja maitsestatud]]></description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="8.9"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Kindlasti minu üks lemmikuid.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Pole midagi halba öelda.]]></commenttext><br />
<username>tiiuviiu</username><br />
<userid>0730a7b7-3a9c-4e26-962f-da9a8daeab8a</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
<dish id="8" vegan="true" lactosefree="true" glutenfree="true" daily="true" dailyprice="5"><br />
<title><![CDATA[Ingverisupp]]></title><br />
<description><![CDATA[Ingveriga vürtsistatud ingverisupp, mis viib keele alla.]]></description><br />
<availablefrom>2018-05-25T12:00:00</availablefrom><br />
<availableto>2018-06-25T12:00:00</availableto><br />
<ingredients><br />
<ingredient id="14" amountunit="g" amount="20"><br />
<name>Ingver</name><br />
<description><![CDATA[Tükeldatud ingver]]></description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="6"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Liiga palju ingverit.]]></commenttext><br />
<username>kyllikekallike1</username><br />
<userid>6af271dd-0e11-4ae6-98be-111762664318</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
<dish id="9" vegan="false" lactosefree="false" glutenfree="true" daily="false" kcal="340" price="4.5"><br />
<title><![CDATA[Apelsinijäätis]]></title><br />
<description><![CDATA[Apelsinimaitseline jäätis serveeritud riivitud apelsinikoorega.]]></description><br />
<ingredients/><br />
<rating ratingvalue="8"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Väga huvitav magustoit, prooviks veel.]]></commenttext><br />
<username>mutikas3</username><br />
<userid>3a29b94a-3f17-469d-a44d-f7d85e98dd3e</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Üks mu lemmikuid magustoite.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
</dishes><br />
<address id="2" country="Eesti"><br />
<addressfirstline>Laia 12</addressfirstline><br />
<locality>Tallinn</locality><br />
<postcode>13022</postcode><br />
<region>Harjumaa</region><br />
</address><br />
<promotion/><br />
<rating ratingvalue="8.1"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Hinnad on natuke liiga kallid minu jaoks, aga toit om maitsev.]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Ma kindlasti telliks kala uuesti. Väga mahlakas oli.]]></commenttext><br />
<username>kyllikekallike1</username><br />
<userid>6af271dd-0e11-4ae6-98be-111762664318</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Asukoht oli päris tore. Miljöö ka.]]></commenttext><br />
<username>mutikas3</username><br />
<userid>3a29b94a-3f17-469d-a44d-f7d85e98dd3e</userid><br />
</comment><br />
</comments><br />
</rating><br />
</restaurant><br />
</restaurants></source><br />
<br />
=== XSD ===<br />
<br />
<source><?xml version="1.0" encoding="utf-8"?><br />
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema"><br />
<xs:element name="restaurants"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="restaurant"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="menus"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="menu"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="activefrom" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="activeto" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="dishes"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="dish"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="title" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="availablefrom" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="availableto" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="servetime" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="ingredients"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="ingredient"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="amountunit" type="xs:string" use="required" /><br />
<xs:attribute name="amount" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="rating" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="comments"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="comment"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="commenttext" type="xs:string" /><br />
<xs:element name="username" type="xs:string" /><br />
<xs:element name="userid" type="xs:string" /><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="ratingvalue" type="xs:decimal" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="validto" type="xs:dateTime" minOccurs="0" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="type" type="xs:string" use="required" /><br />
<xs:attribute name="classname" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="vegan" type="xs:boolean" use="optional" /><br />
<xs:attribute name="lactosefree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="glutenfree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="daily" type="xs:boolean" use="optional" /><br />
<xs:attribute name="kcal" type="xs:int" use="optional" /><br />
<xs:attribute name="weightg" type="xs:decimal" use="optional" /><br />
<xs:attribute name="price" type="xs:decimal" use="optional" /><br />
<xs:attribute name="dailyprice" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="validto" type="xs:dateTime" minOccurs="0" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="type" type="xs:string" use="required" /><br />
<xs:attribute name="classname" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="repetitioninterval" type="xs:int" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="dishes"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="dish"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="title" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="availablefrom" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="availableto" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="servetime" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="ingredients"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="ingredient"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="amountunit" type="xs:string" use="required" /><br />
<xs:attribute name="amount" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="rating"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="comments"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="comment"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="commenttext" type="xs:string" /><br />
<xs:element name="username" type="xs:string" /><br />
<xs:element name="userid" type="xs:string" /><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="ratingvalue" type="xs:decimal" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="validto" type="xs:dateTime" minOccurs="0" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="type" type="xs:string" use="required" /><br />
<xs:attribute name="classname" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="vegan" type="xs:boolean" use="optional" /><br />
<xs:attribute name="lactosefree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="glutenfree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="daily" type="xs:boolean" use="optional" /><br />
<xs:attribute name="kcal" type="xs:int" use="optional" /><br />
<xs:attribute name="weightg" type="xs:decimal" use="optional" /><br />
<xs:attribute name="price" type="xs:decimal" use="optional" /><br />
<xs:attribute name="dailyprice" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="address"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="addressfirstline" type="xs:string" /><br />
<xs:element name="locality" type="xs:string" /><br />
<xs:element name="postcode" type="xs:string" /><br />
<xs:element name="region" type="xs:string" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="country" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion" /><br />
<xs:element name="rating" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="comments"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="comment"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="commenttext" type="xs:string" /><br />
<xs:element name="username" type="xs:string" /><br />
<xs:element name="userid" type="xs:string" /><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="ratingvalue" type="xs:decimal" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="url" type="xs:string" use="required" /><br />
<xs:attribute name="contactnumber" type="xs:string" use="required" /><br />
<xs:attribute name="email" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:schema></source><br />
<br />
=== XSLT(HTML) ===<br />
<br />
<source><?xml version="1.0" encoding="utf-8" ?><br />
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:msxsl="urn:schemas-microsoft-com:xslt" exclude-result-prefixes="msxsl"><br />
<xsl:output method="html" indent="yes"/><br />
<xsl:template match="/restaurants"><br />
<html><br />
<head><br />
<title>Täis Kõht</title><br />
</head><br />
<body><br />
<xsl:for-each select="restaurant"><br />
<h1 style="color:DodgerBlue"><br />
<xsl:value-of select="name"/><br />
</h1><br />
<div><br />
<xsl:value-of select="@url"/><br />
</div><br />
<div><br />
<xsl:text>Kontakt number: </xsl:text><br />
<xsl:value-of select="@contactnumber"/><br />
</div><br />
<div><br />
<xsl:text>email: </xsl:text><br />
<xsl:value-of select="@email"/><br />
</div><br />
<div><br />
<xsl:text>Aadress: </xsl:text><br />
<xsl:value-of select="address/addressfirstline"/><br />
<xsl:text>, </xsl:text><br />
<xsl:value-of select="address/locality"/><br />
<xsl:text>, </xsl:text><br />
<xsl:value-of select="address/postcode"/><br />
<xsl:text>, </xsl:text><br />
<xsl:value-of select="address/@country"/><br />
</div><br />
<br />
<xsl:choose><br />
<xsl:when test="menus/menu"><br />
<xsl:for-each select="menus/menu"><br />
<xsl:sort select="name"/><br />
<h3><br />
<xsl:value-of select="name"/><br />
</h3><br />
<br />
<xsl:if test="activefrom != '' and activeto != ''"><br />
<xsl:text> </xsl:text><br />
<xsl:value-of select="substring(activefrom,1,10)"/><br />
<xsl:text> kuni </xsl:text><br />
<xsl:value-of select="substring(activeto,1,10)"/><br />
</xsl:if><br />
<br />
<ul><br />
<xsl:for-each select="dishes/dish"><br />
<xsl:sort select="title"/><br />
<br />
<xsl:if test="availablefrom != '' and availableto != ''"><br />
<xsl:value-of select="substring(availablefrom,1,10)"/><br />
<xsl:text> kuni </xsl:text><br />
<xsl:value-of select="substring(availableto,1,10)"/><br />
</xsl:if><br />
<br />
<li><br />
<span style="font-weight:bold"><br />
<xsl:value-of select="title"/><br />
</span><br />
<xsl:text> - </xsl:text><br />
<xsl:value-of select="description"/><br />
<xsl:text> </xsl:text><br />
<span style="font-weight:bold"><br />
<xsl:if test="@glutenfree='true'"><br />
<xsl:text>G </xsl:text><br />
</xsl:if><br />
<xsl:if test="@lactosefree='true'"><br />
<xsl:text>L </xsl:text><br />
</xsl:if><br />
<xsl:if test="@vegan='true'"><br />
<xsl:text>V </xsl:text><br />
</xsl:if><br />
</span><br />
</li><br />
<br />
<xsl:for-each select="ingredients/ingredient"><br />
<xsl:value-of select="name"/><br />
<xsl:if test="position()!=last()"><br />
<xsl:text>, </xsl:text><br />
</xsl:if><br />
</xsl:for-each><br />
<br />
<p style="font-weight:bold"><br />
<xsl:text>Hind: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="@price!=''"><br />
<xsl:value-of select="@price"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>-</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
<xsl:text> / Päevapakkumise hind: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="@dailyprice!=''"><br />
<xsl:value-of select="@dailyprice"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>-</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
</p><br />
<br />
<div style="background-color:LightGray;"><br />
<xsl:text>Hinnang praele: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="rating/@ratingvalue!=''"><br />
<xsl:value-of select="rating/@ratingvalue"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>Ei ole veel hinnatud!</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
<br />
<br/><br />
<xsl:for-each select="rating/comments/comment"><br />
<xsl:value-of select="username"/><br />
<xsl:text>: </xsl:text><br />
<xsl:value-of select="commenttext"/><br />
<br/><br />
</xsl:for-each><br />
</div><br />
<br/><br />
</xsl:for-each><br />
</ul><br />
</xsl:for-each><br />
</xsl:when><br />
<xsl:otherwise><br />
<ul><br />
<xsl:for-each select="dishes/dish"><br />
<xsl:sort select="title"/><br />
<br />
<xsl:if test="availablefrom != '' and availableto != ''"><br />
<xsl:value-of select="substring(availablefrom,1,10)"/><br />
<xsl:text> kuni </xsl:text><br />
<xsl:value-of select="substring(availableto,1,10)"/><br />
</xsl:if><br />
<br />
<li><br />
<span style="font-weight:bold"><br />
<xsl:value-of select="title"/><br />
</span><br />
<xsl:text> - </xsl:text><br />
<xsl:value-of select="description"/><br />
<xsl:text> </xsl:text><br />
<span style="font-weight:bold"><br />
<xsl:if test="@glutenfree='true'"><br />
<xsl:text>G </xsl:text><br />
</xsl:if><br />
<xsl:if test="@lactosefree='true'"><br />
<xsl:text>L </xsl:text><br />
</xsl:if><br />
<xsl:if test="@vegan='true'"><br />
<xsl:text>V </xsl:text><br />
</xsl:if><br />
</span><br />
</li><br />
<br />
<xsl:for-each select="ingredients/ingredient"><br />
<xsl:value-of select="name"/><br />
<xsl:if test="position()!=last()"><br />
<xsl:text>, </xsl:text><br />
</xsl:if><br />
</xsl:for-each><br />
<br />
<p style="font-weight:bold"><br />
<xsl:text>Hind: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="@price!=''"><br />
<xsl:value-of select="@price"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>-</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
<xsl:text> / Päevapakkumise hind: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="@dailyprice!=''"><br />
<xsl:value-of select="@dailyprice"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>-</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
</p><br />
<br />
<div style="background-color:LightGray;"><br />
<xsl:text>Hinnang praele: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="rating/@ratingvalue!=''"><br />
<xsl:value-of select="rating/@ratingvalue"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>Ei ole veel hinnatud!</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
<br />
<br/><br />
<xsl:for-each select="rating/comments/comment"><br />
<xsl:value-of select="username"/><br />
<xsl:text>: </xsl:text><br />
<xsl:value-of select="commenttext"/><br />
<br/><br />
</xsl:for-each><br />
</div><br />
<br/><br />
</xsl:for-each><br />
</ul><br />
</xsl:otherwise><br />
</xsl:choose><br />
<br />
<div style="background-color:LightGray;"><br />
<xsl:text>Hinnang restoranile: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="rating/@ratingvalue!=''"><br />
<xsl:value-of select="rating/@ratingvalue"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>Ei ole veel hinnatud!</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
<br />
<br />
<br/><br />
<xsl:for-each select="rating/comments/comment"><br />
<xsl:value-of select="username"/><br />
<xsl:text>: </xsl:text><br />
<xsl:value-of select="commenttext"/><br />
<br/><br />
</xsl:for-each><br />
</div><br />
<br />
<p><br />
<xsl:text>*G - gluteenivaba, </xsl:text><br />
<xsl:text>L - laktoosivaba, </xsl:text><br />
<xsl:text>V - vegan </xsl:text><br />
</p><br />
<br />
</xsl:for-each><br />
</body><br />
</html><br />
</xsl:template><br />
</xsl:stylesheet></source><br />
<br />
=== XSLT(XML) ===<br />
<br />
XML'is kuvatakse elemendid ja atribuudid eesti keeles. Kuvatakse restorani andmed ja toidud, mille hinnang on 8 või rohkem punkti.<br />
<br />
<source><?xml version="1.0" encoding="utf-8" ?><br />
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"<br />
xmlns:msxsl="urn:schemas-microsoft-com:xslt" exclude-result-prefixes="msxsl"><br />
<xsl:output method="xml" indent="yes"/><br />
<br />
<xsl:template match="/restaurants"><br />
<restoranid><br />
<xsl:for-each select="restaurant"><br />
<restoran url="{@url}" telefon="{@contactnumber}" email="{@email}"><br />
<nimi><br />
<xsl:value-of select="name"/><br />
</nimi><br />
<aadress><br />
<postiaadress><br />
<xsl:value-of select="address/addressfirstline"/><br />
</postiaadress><br />
<linn><br />
<xsl:value-of select="address/locality"/><br />
</linn><br />
<indeks><br />
<xsl:value-of select="address/postcode"/><br />
</indeks><br />
<riik><br />
<xsl:value-of select="address/@country"/><br />
</riik><br />
</aadress><br />
<br />
<parimadToidud><br />
<xsl:choose><br />
<xsl:when test="menus/menu/dishes/dish"><br />
<xsl:for-each select="menus/menu/dishes/dish"><br />
<xsl:if test="rating/@ratingvalue &gt;= 8.0"><br />
<heaToit hinnang="{rating/@ratingvalue}" paevaPakkumiseHind="{@dailyprice}" hind="{@price}" <br />
vegan="{@vegan}" laktoosivaba="{@lactosefree}" gluteenivaba="{@glutenfree}"><br />
<nimi><br />
<xsl:value-of select="title"/><br />
</nimi><br />
<kirjeldus><br />
<xsl:value-of select="description"/><br />
</kirjeldus><br />
</heaToit><br />
</xsl:if><br />
</xsl:for-each><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:for-each select="dishes/dish"><br />
<xsl:if test="rating/@ratingvalue &gt;= 8.0"><br />
<heaToit hinnang="{rating/@ratingvalue}" paevaPakkumiseHind="{@dailyprice}" hind="{@price}" <br />
vegan="{@vegan}" laktoosivaba="{@lactosefree}" gluteenivaba="{@glutenfree}"><br />
<nimi><br />
<xsl:value-of select="title"/><br />
</nimi><br />
<kirjeldus><br />
<xsl:value-of select="description"/><br />
</kirjeldus><br />
</heaToit><br />
</xsl:if><br />
</xsl:for-each><br />
</xsl:otherwise><br />
</xsl:choose><br />
</parimadToidud><br />
</restoran><br />
</xsl:for-each><br />
</restoranid><br />
</xsl:template><br />
</xsl:stylesheet><br />
</source><br />
<br />
== Retsensioonid ==<br />
<br />
=== Veebiteenuse retsensioon meeskonnale [https://wiki.itcollege.ee/index.php/MOT MOT] ===<br />
<br />
* Puudub README vms. Dokumentatsioon projekti ülespanemiseks ja seadistamiseks.<br />
* Rollide loomine vigane, seda võiks teha eraldi failis, mis on DAL.App.EF projektis (kasutasime algul sama lähenemist nagu antud projekt). Takistab esialgset andmebaasi uuendust, kui rollid veel puuduvad. Rakenduse installimine tarnitud kujul ei õnnestunud. Selleks et Nuget Package Manageri käsk Update-Database töötaks pidi ajutiselt välja kommenteerima Startup.cs faili rea 153 (// CreateRoles(services).Wait();).<br />
==== Andmebaasist: ====<br />
* Üldiselt paneksin igale väljale juurde AddTime ja UpdateTime see on hea tava millest korduvalt ka andmebaasi alustes räägiti ja rõhutati.<br />
==== Olemitest: ====<br />
* Kui juba domainis nimetate kõik olemid singulaarselt siis võiks ju sama teha ka andmebaasis - lisakeerukuse loomine kohas kus see ei ole vajalik.<br />
* Entity-te arv oli nõutust väiksem - Kokku 8 olemit, millest 1 on many-to-many liittabel ja 1 otsene koopia Identity framework Users tabelist. <br />
* Olem People ~= Users ja sisaldab ka viidet Identity tabelile ApplicationUsers (ApplicationUserId). Juhul kui see on mõeldud rakendusega mitte registreerunud kasutajate võistlusele kirja panemiseks, siis oleks olemil rohkem infot vaja - vähemalt mingigi kontakti väli (email |/& tel.nr. |/& aadress).<br />
* Competition.Comment on varchar(100) - võiks ja peaks olema varchar(1000)<br />
* Competition.CompetitionPlaceId - kui võistluse toimumiskoht mingil põhjusel peaks keelduma korraldusest või kui võistlust alles pannakse kokku ja ei ole veel teada kus see toimuma saab siis mis peaks sinna sisestama (NOT NULL => NULL)<br />
* Competition.Time -> Mis aega see näitab? Property nimest seda välja ei loe. Kui StartTime, siis kus on EndTime või Duration?<br />
* CompetitionPlace.County -> int type enum default väärtus on 0, kuna see pole aga enumi klassis implementeeritud põhjustab see vea. (Millisele maakonnale vastab 0?) See teada tuntud probleem millele google annab hõlpsasti erinevaid lahendusi: näiteks [https://stackoverflow.com/questions/24350377/entity-framework-6-code-first-required-enum-data-type-not-working?utm_medium=organic&utm_source=google_rich_qa&utm_campaign=google_rich_qa siin] ja [https://stackoverflow.com/questions/529929/choosing-the-default-value-of-an-enum-type-without-having-to-change-values/529937?utm_medium=organic&utm_source=google_rich_qa&utm_campaign=google_rich_qa siin].<br />
* Väljad mis viitavad Identity framework olemitele läbi nende ID-de ei peaks olema nvarchar(max) vaid nvarchar(450) (kuigi isegi see on reaalsuses liiga pikk).<br />
* PersonInTeam.PersonInTeamId -> ei peaks olema sellist välja üldse, selle tabeli PK peaks olema kombinatsioon nende tabeli ID-st mida ta ühendab. Praegu ei ole unique indeksit üle nende, mis tähendab et sama inimene saab mitu korda sama tiimiga liituda.<br />
* Participations - Miks selline nimi, kui registreerimine juba oli? Saan aru et selles olemis tahetakse säilitada võistluse tulemusi. Siis võiks ju juba olla CompetitionResults. Kus on aga saavutatud koha numbri talletamine? Kui võistluse punktid ja ajad on kõik kirja saadud siis tahaks ju tulemusi ka kuidagi näha ja võrrelda ning selle võrdluse tulemi kuhugi salvestada.<br />
* Participations.Time - Mis aega näitab? Eeldan, et võistluse läbimise aega? Kui nii, siis miks ei ole NULL lubatud - mõnedel võistlustel aega ju ei mõõdeta?<br />
* Participation.Points - Kas igal võistlusel antakse ainult täisarv punkte (int)? Võiks igaks juhuks siiski implementeerida double väärtuse tüübi. Lisaks ei ole võimalik osalust luua ilma punkte teadmata - peaks siis määrama default väärtus. Mõnede võistluste puhul jälle punkte ei anta vaid mõõdetakse aega.<br />
* Participation.Disqualified - Nullid ei ole lubatud -> järelikult oleks default väärtust vaja.<br />
* Registrations - Projekti Must have alla on märgitud “Osaleja saab registreerida võistlusele meeskonda” kuid olemis puudub TeamsId ning samuti ei ole seda võimalust kuidagi läbi Servicei implementeeritud.<br />
* Registrations - Millal registreering tehti on suhteliselt tähtis teada. Paljude võistluste puhul sõltub sellest näiteks registreerimistasu. <br />
==== DTO-d: ====<br />
* Täiesti mõttetult sisse toodud kiht, lihtsalt selleks et nii oli ette nähtud. Kõik DTO-d konverteeritakse ümber 1:1-le Domain objektideks ja vastupidi.<br />
* Üldiselt oleks vaja teha tööd veel DTOdega, et need rohkem peegeldaksid oma kasutust. Näiteks:<br />
** küsides kõiki võistlusi, kas meil on tarvis avalikustada kliendile, mis on kasutaja ID, kes iga võistluse lõi? DTOsid võiks olla rohkem erinevate kasutusjuhtumite jaoks. <br />
** CompetitionDTO võiks sisaldada ka nimekirja võistlejatest, kus koondatakse info ManyToMany seoste põhjal kasutades vahetabelit, nagu näiteks:<br />
<source><br />
List<PersonDTO> people = c.Participation<br />
.FindAll(p => p.CompetitionId == c.CompetitionId)<br />
.Select(PersonDTO.CreateFromParticipation)<br />
.ToList();<br />
</source><br />
<br />
==== API Kontrolleritest: ====<br />
* Puudub Swagger startup konfiguratsioon, Swagger annotatsioonid kaotavad mõtte ning pole võimalik kontrollida, kas need on korrektselt loodud.<br />
* ProducesResponse annotatsiooni pole kusagile lisatud, staatuskoodid on natuke poolikult läbi mõeldud, vähemalt need, mida Swaggeri raames mainitud on<br />
*Annotatsioon Authorize, kus on ära määratud AuthorizationScheme peaks minema kogu klassi peale, meetodis saab ära määrata vaid selle, mis rollid on lubatud.<br />
* AccountController<br />
** Response code uue kasutaja loomisel võiks olla 201<br />
** Puuduvad koodid nagu 429, 500<br />
** Registreerumisel võiks kontrollida, kas kasutaja on juba olemas, mitte vaid rolli olemasolu<br />
** Kas kasutajal ei või antud kontekstis olla mitu rolli? Sisselogimisel võetakse rollide seast vaid esimene ja lisatakse juurde Claimile. Võimalus kirjutada ka meetod, mis lisab kasutajale kõik rollid.<br />
* CompetitionPlacesController/CompetitionsController/CompetitionTypesController/ParticipationsController/RegistrationsController/TeamsController <br />
** Antud kontrollerid on kõik väga sarnase loogikaga<br />
** Get() tagastab vaid koodi 200, tagastuskoodi võimalusi on veel<br />
** Post() meetod küsib sisse DTOd, mille üheks parameetriks on id, id genereeritakse automaatselt, seda ei peaks panema kaasa postitatavasse mudelisse, mis alles loob objekti<br />
** Put() puhul sama kriitika, siin on id küll vajalik, aga see juba pannakse kaasa parameetrina eraldi<br />
** See tundub natuke veidrana üritada kontrollida uuendatud mudeli põhjal, kas tegemist oli BadRequestiga. Eelkõige peaks id puhul üles otsima, kas antud objekt on üldse olemas ja seejärel üritada uuendada, muidu tagastada BadRequest. Kui see ei õnnestu, siis peaks juba errorkood 500 peegeldama seda, et midagi läks teenuse poole peal valesti. <br />
** Sama kommentaar deletemise kohta, enne tuleks kontrollida, kas objekt on olemas. Siis alles objekt kustutada.<br />
* PeopleController<br />
** Kas tõepoolest igaüks saab pärida infot inimeste kohta ja neid postitada? <br />
* PersonInTeamsController <br />
** API disaini poole pealt on natuke veider teha vahetabelite kohta kontroller. Tundub loogilisem panna antud kontrolleri meetodid teistesse kontroleritesse, mis on seotud siis kas meeskondade või inimestega. Näiteks küsida ** PeopleControlleris kõik inimesed, kes on meeskondades või küsida neid meeskonna järgi. TeamsControlleris seevastu anda võimalus lisada uusi inimesi meeskonda, neid muuta või eemaldada.<br />
** Id järgi ei hakka ükski klient küsima vahetabeli kohta infot, see tundub otstarbetu tegevus, pigem küsida kas meeskonna või inimese id järgi sissekandeid<br />
* Kriitika kontrollerite kohta: kontrollerid enamuses pöörduvad vaid spetsiifiliste domeenide poole ja viivad ellu väga tavalist CRUD funktsionaalsust, mille tõttu tundub, et need on natuke veel toored. Näiteks on välja toodud “must have” nimekirjas projekti analüüsis, et meeskonna liige peaks saama muuta meeskonna andmeid. Antud kontrollerites vaid autentitakse, et kasutaja oleks rollis “participant”, kuid mitte seda, kas ta ka muudetava meeskonna liige on. Samuti pole võimalik kasutajatel näha, palju on mingile võistlusele osalejaid registreerunud, CompetitionsController ei tegele sellega, et tagastada võistlusele registreerunud kasutajaid, selle asemel on olemas ParticipationsController, mis tagastab vahetabeli infot selle kohta, mis võistlusega on seotud mis inimene. See võib olla tohutult suur info, mida hakata filtreerima kliendi poolelt. Rohkem tuleks teha andmete agregeerimist vastavalt teenuse kontekstile.<br />
<br />
==== Projekti kihid/struktuur: ====<br />
* Olemas Business Logic, Data Access Layer, DTO’d, Service’id, Unit of Work, domeeniklassid ning API spetsiifilised kontrollerid, mis asuvad oma kaustas põhiprojekti all . DAL omab erinevaid kihte interface’ide ja neid implementeerivate klasside jaoks. Repositooriumitega suhtlemine on abstraktne, kõik käib läbi Data Access Layer’i, mille pööle pöörduvad teenuseklassid ning DAL erinevad kihid hoolitsevad selle eest, et loodaks õiget tüüpi repositooriumeid, andmeid agregeeritakse, uuendatakse ja salvestatakse organiseeritud kujul ning neid tagastatakse teenustele soovitud kujul (DTOd).<br />
<br />
== Logiraamat ==<br />
<br />
===07.02.2018===<br />
Gupi loomine ning suhtluskanali seadistamine<br />
<br />
=== 24.03.2018 ===<br />
Trello boardi loomine<br />
<br />
=== 25.03.2018 ===<br />
Wiki lehe loomine. Esimene tõsisem projekti koosolek ning tegevuskava paika panemine.<br />
<br />
=== 26.03.2018 ===<br />
<br />
Alustasime veebiteenuse analüüsiga ja funktsionaalsuse kirjeldamisega.<br />
<br />
=== 27.03.2018 ===<br />
Täiendasime veebiteenuse analüüsi.<br />
<br />
Esmase andmebaasi mudeli koostamine.<br />
<br />
Postitatud esimeste analüüsi arutelude põhjal valminud algne prototüüp.<br />
<br />
=== 30.03.2018 ===<br />
Valmis andmebaasimudel.<br />
<br />
=== 08.04.2018 ===<br />
Tehtud muudatused analüüsis vastavalt tagasisidele.<br />
<br />
=== 19.04.2018 ===<br />
Loodud projekti põhi koos domeenimudelitega. Projekt lisatud Githubi: https://github.com/sikumiku/TaisKohtApi<br />
<br />
=== 05-06.05.2018 ===<br />
Osalesime hackathonil. Lisatud controllerid, service'id koos vajalike kihtidega.<br />
<br />
=== 16.05.2018 ===<br />
Uuendatud andmebaasimudelit, DTO'sid.<br />
<br />
=== 18-19.05.2018 ===<br />
Lisatud klientrakendus, security, äriloogikat.<br />
<br />
=== 20.05.2018 ===<br />
Lisatud API dokumentatsioon.<br />
<br />
=== 22-24.05.2018 ===<br />
Uuendatud contoller'eid, service'id.<br />
<br />
=== 25-27.05.2018 ===<br />
Uuendatud contoller'eid, service'id. Lisatud kasutajate ja rollide kontrolle meetoditesse. Täiustatud klientrakendust. Swagger dokumentatsioon.<br />
<br />
=== 31.05-01.06.2018 ===<br />
Tegeletud XML, XSD ja XSLT failide loomisega.<br />
<br />
=== 02.06-03.06.2018 ===<br />
Tegeletud XML ja XSLT failide täiustamisega ja retsensioonide kirjutamisega.</div>
Saasma
https://wiki.itcollege.ee/index.php?title=BeerPressure&diff=131184
BeerPressure
2018-06-03T20:44:46Z
<p>Saasma: /* API Kontrolleritest: */</p>
<hr />
<div>== Meeskond ja rollid ==<br />
<br />
* Sigrid Aasma (arendaja)<br />
* Evelin Jõgi (arendaja)<br />
* Martin Kask (projektijuht, arendaja)<br />
* Marko Nõu (arendaja)<br />
<br />
== Idee ==<br />
'''Toidukohtade põhimenüüde ja päevapakkumiste teenus'''<br />
<br />
Soovime pakkuda toidukohtade põhimenüüde ja päevapakkumiste teenust. On olemas mitmeid kodulehti “päevapakkumised”, kus on kirjas toidukohtade päevapraed. Kuid tavaliselt sellistel lehtedel ei ole masinloetavaid andmeid ehk siis varianti, et saad saata API pihta mingi kuupäeva koos päevapraadidega andmete uuendamiseks ja saad sama API käest küsida tänaseid päevapraade. Andmeid võiks saada küsida restorani, kuupäeva, asukoha või otsisõna/otsisõnaosa põhiselt. Selline teenus lihtsustaks ka toidukohtade päevapakkumiste haldamist, kuna praegu peavad teenuse pakkujad vastavat informatsiooni uuendama mitmes erinevas kohas - nii erinevates portaalides, kui ka enda veebileheküljel. Samuti oleks toidukohtade kogu menüü haldamine ühes kohas.<br />
<br />
=== Esialgne prototüüp ===<br />
<br />
[[File:TäisKõhtProto1.mp4]]<br />
<br />
Esialgne prototüüp: [http://enos.itcollege.ee/~saasma/VR2/Proto/K%C3%B5htT%C3%A4is/#g=1&p=home navigeeritav versioon vol.1]<br />
<br />
=== Prototüübi muutus projekti käigus ===<br />
<br />
Prototüüp: [http://enos.itcollege.ee/~saasma/VR2/Proto/T%C3%A4isK%C3%B5ht/K%C3%B5htT%C3%A4is/#g=1&p=home navigeeritav versioon vol.2]<br />
<br />
== Kasutatav arendustehnoloogia ==<br />
<br />
Veebiteenuse loomisel kasutame ASP.NET Core tehnoloogiat ja kursusel õpitud arendusmustreid.<br />
<br />
Klientrakenduse loomisel kasutame Node.js + React'i.<br />
<br />
== Veebiteenuse analüüs ==<br />
Pakume toidukohtade põhimenüüde ja päevapakkumiste teenust, kuhu on kokku koondatud erinevate toidukohtade menüüd üle Eesti. Põhimenüü alla kuuluvad pikaajalised menüüd, mis kehtivad püsivalt, hooajaliselt või mingil konkreetsel nädalapäeval. Päevapakkumiste alla kuuluvad konkreetse kuupäevaga seotud päevapakkumised. Päevapakkumiste korral kuvatakse lisainfona, kas pakkumine kehtib mingis konkreetses ajavahemikus või kogu toidukoha lahtioleku aja.<br />
<br />
Eesmärk on koguda ühte kohta kokku erinevate toidukohtade menüüd ja päevapakkumised, et kliendid saaksid mugavalt ja kiiresti oma valikuid teha. Kliendid käivad enamasti päevapakkumisi söömas lõuna ajal ja selleks ettenähtud aeg on piiratud. Sellepärast on oluline, et klient saaks teha oma valiku võimalikult kiiresti. Tänu loodavale veebiteenusele ei pea kliendid käima erinevates portaalides, et tutvuda erinevate toidukohtade pakkumistega. Kuna teenust on mugav kasutada ja klient saab oma valiku kiiresti tehtud, siis tõenäoliselt teeb klient valiku selles keskkonnas olevate toiduasutuste seast. Lisaks võimaldab teenus toiduasutustel paika panna oma pikaajalisem põhimenüü ning seda rakenduses ja võimalusel ka söögikohas kuvada. Sellepärast on ka toidukohtade huvi antud keskkonnas üleval olla ja meiega oma andmeid jagada, sest see suurendab nende klientuuri ning muudab oma menüü haldamise kergemaks.<br />
<br />
Veebiteenuse loomisel lähtume eelkõige sellest, et kliendil oleks teenust mugav kasutada ja ta saaks oma valiku kiiresti tehtud. Arvestame, et kliendid on erinevad. Mõni eelistab mõnda kindlat toidukohta, sel juhul saab ta valida oma soovitud kohad ja võrrelda nende kohtade tänase päeva pakkumisi ning menüüsid. Mõnele inimesele on oluline pakutav söök ja ta eelistab pakkumist otsida prae nimetuses oleva sõna või sõnaosa järgi ning lähtuda seejärel valiku tegemisel toidukoha keskmisest hindest või toidu hinnast. Mõne kliendi jaoks on oluline hind ja selleks, et oma valikut teha sobivas hinnavahemikus on tal võimalik sisestada maksimum hinna piirang. Kindlasti on antud teenuse juures kõikide klientide jaoks oluline päevapakkumiste asukohapõhine eristatus. Kliendid, kes soovivad oma konto luua, võivad oma eelistatud valikud meelde jätta ja järgmisel korral kuvatakse neid talle automaatselt.<br />
<br />
Teenuse must-have funktsionaalsus tagab teenuse toimimise ja põhifunktsioonid. Teenuse nice-to-have funktsionaalsus annab rakendusele lisandväärtust.<br />
<br />
Arvestades pakutava teenusega, siis näeme, et aktiivseim teenuse kasutamine võib olla tööpäevadel vahemikus 11.00-15.00, kui kliendid tutvuvad päevapakkumistega. Teenus peab tekkivale koormusele vastu pidama.<br />
<br />
Teenuse pakkumine peab olema turvaline. Selle tagamiseks tuleb sisestatavaid andmeid valideerida ja andmebaasi sisestavate andmete mahtu piirata. Toidukohtade sisestatud andmed peavad olema kaitstud, et toitude koostised ei saaks avalikuks. Põhjendatud juhtudel on võimalik kasutajaid lukku panna.<br />
<br />
== Kasutajad ==<br />
<br />
<br />
* Admin - lehe administraator, kellel on õigus lehte, kasutajaid ja nende õiguseid hallata. Tema huvi on, et teenus toimiks tõrgeteta.<br />
* Toiduasutus (tasuta kasutaja) - saab hoida lehel ühte põhimenüüd ja päevapakkumisi.<br />
* Toiduasutus (tellimusega kasutaja) - saab hoida lehel piiramatu arv põhimenüüsid ja päevapakkumisi.<br />
Toiduasutused on teenusest huvitatud, et nende menüüde haldamine oleks kerge ja mugav ning nad saaksid oma klientide arvu suurendada.<br />
* Külastaja - klient, kes valib söögikohta. Tema on huvitatud eelkõige sellest, et teenust saaks kasutada mugavalt ja kiirelt ning toidukohtade valik oleks võimalikult suur.<br />
<br />
== Rakenduse must-have funktsionaalsus ==<br />
<br />
* Kasutajad saavad sisse logida<br />
* Kasutajatel on erinevad rollid: admin, toidukoht (tasuta ja tasulise tellimusega), klient<br />
* Kasutajate arvepidamine kasutajate lõikes:<br />
** sisselogimise kuupäev, kellaaeg<br />
** pakkumiste lisamine<br />
** pakkumiste muutmine<br />
** pakkumiste kustutamine<br />
** õiguste kehtimise periood (tasuta ja tellimusega toidukoht)<br />
** pakkumistele klikkimise arv<br />
* Kasutajaid on võimalik hallata:<br />
** kasutajale õiguste andmine (menüüde arvu suurendamine, tellimusega toidukohal), rolli määramine<br />
** Kasutajat on võimalik piirata: õiguseid piirata (piiratud menüüde arv, tasuta liitunud toidukohal) ja lukku panna<br />
* Päevapakkumisi/menüüsid saab küsida: <br />
** toidukoha järgi, <br />
** kuupäeva põhiselt (ainult päevapakkumisi), <br />
** asukoha põhiselt,<br />
** toidu nimetuses esineva otsisõna/otsisõna osa põhiselt,<br />
** hinna põhiselt (max hinna piirang).<br />
* Klientrakenduses realiseeritakse CRUD meetodid (menüüsid/päevapakkumisi saab sisestada, lugeda, uuendada, kustutada)<br />
* Toidukohale saab anda hindeid ja kuvatakse keskmist hinnet.<br />
* Toidule saab anda hindeid ja kuvatakse keskmist hinnet.<br />
<br />
== Nice-to-have funktsionaalsus ==<br />
<br />
* Info selle kohta, kas päevapakkumine on otsas<br />
* Päevapakkumisi/menüüsid saab kommenteerida ja neid kommentaare kuvatakse avalikult.<br />
* Söögikohtade kodulehtedelt otsimise script, mis genereerib juba olemasolevate kodulehtede baasil päevamenüüsid.<br />
* Toiduvaliku piiramine allergeenide/vegan/jms. koostisosade põhiselt.<br />
* Aruandlused ja võrdlused toidukohtadele, et võrrelda end konkurentidega.<br />
* Teenus soovitab toidukohtadele nende varasemate päevapraadide populaarsuse alusel uue nädala menüüd.<br />
* Erinevad toidukohtade/toitude pingeread klientidele, et anda valikuteks ideid.<br />
* Soovitused klientidele, mida teised kliendid sarnaste eelistustega on veel valinud.<br />
<br />
== Andmebaasi ülesehitus - projekti algus ==<br />
<br />
[[File: BeerPressureAndmebaasimudel.png]]<br />
<br />
== Andmebaasi ülesehitus - projekti lõpp ==<br />
<br />
[[File: Ta2isKo6ht-DB-FINAL.png]]<br />
<br />
== Projekti repository ==<br />
<br />
https://github.com/sikumiku/TaisKohtApi<br />
<br />
Zip fail saadaval: <br />
(master branchi viimane commit esitamise ajal)<br />
https://github.com/sikumiku/TaisKohtApi/archive/61438e187a1a972410c8a3bc6274d69489d00aa6.zip<br />
<br />
== API v1 dokumentatsioon ==<br />
<br />
===Security===<br />
'''POST /api/account/register'''<br />
<source><br />
Params: RegisterViewModel registerViewModel<br />
<br />
Returns: token<br />
</source><br />
<br />
'''POST /api/account/login'''<br />
<source> <br />
Params: LoginViewModel model<br />
<br />
Returns: token<br />
</source><br />
<br />
'''POST /api/account/logout'''<br />
<source> <br />
Params: -<br />
<br />
Returns: -<br />
</source><br />
<br />
===Accounts===<br />
'''GET /api/v1/accounts/getAllUsersInRole'''<br />
<source> <br />
Params: string role<br />
<br />
Returns: List<UserDTO><br />
</source><br />
<br />
'''GET /api/v1/accounts/{id}'''<br />
<source> <br />
Params: string id<br />
<br />
Returns: UserDTO<br />
</source><br />
<br />
'''PUT /api/v1/accounts/{id}'''<br />
<source> <br />
Params: string id, UpdateUserDTO userDTO<br />
<br />
Returns: -<br />
</source><br />
<br />
'''POST /api/v1/accounts/addRole'''<br />
<source> <br />
Params: string role<br />
<br />
Returns: -<br />
</source><br />
<br />
'''POST /api/v1/accounts/addRoleToUser'''<br />
<source> <br />
Params: string role, string userId<br />
<br />
Returns: UserDTO<br />
</source><br />
<br />
'''DELETE /api/v1/accounts/deactivate/{id}'''<br />
<source> <br />
Params: string id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Promotions===<br />
'''GET /api/v1/promotions '''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<PromotionDTO> <br />
</source><br />
<br />
'''GET /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: PromotionDTO<br />
</source><br />
<br />
'''POST /api/v1/promotions'''<br />
<source> <br />
Params: PromotionDTO promotionDTO<br />
<br />
Returns: PromotionDTO newPromotion<br />
</source><br />
<br />
'''PUT /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id, PromotionDTO promotionDTO<br />
<br />
Returns: PromotionDTO updatedPromotion<br />
</source><br />
<br />
'''DELETE /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Restaurants===<br />
'''GET /api/v1/restaurants'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<SimpleRestaurantDTO><br />
</source><br />
<br />
'''GET /api/v1/restaurants/search?name=th'''<br />
<source> <br />
Params: string name<br />
<br />
Returns: List<SimpleRestaurantDTO> result<br />
</source><br />
<br />
'''GET /api/v1/restaurants/top'''<br />
<source> <br />
Params: int amount<br />
<br />
Returns: List<SimpleRestaurantDTO> result<br />
</source><br />
<br />
'''GET /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: RestaurantDTO r<br />
</source><br />
<br />
'''POST /api/v1/restaurants/addUserToRestaurant'''<br />
<source> <br />
Params: int id, string userId<br />
<br />
Returns: -<br />
</source><br />
<br />
'''POST /api/v1/restaurants'''<br />
<source> <br />
Params: PostRestaurantDTO restaurantDTO<br />
<br />
Returns: RestaurantDTO newRestaurant<br />
</source><br />
<br />
'''PUT /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id, PostRestaurantDTO restaurantDTO<br />
<br />
Returns: PostRestaurantDTO updatedRestaurantDTO<br />
</source><br />
<br />
'''DELETE /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Menus===<br />
'''GET /api/v1/menus'''<br />
<source><br />
Params: -<br />
<br />
Returns: List<MenuDTO><br />
</source><br />
<br />
'''GET /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: MenuDTO menuDTO<br />
</source><br />
<br />
'''POST /api/v1/menus'''<br />
<source> <br />
Params: PostMenuDTO menuDTO<br />
<br />
Returns: MenuDTO newMenu<br />
</source><br />
<br />
'''PUT /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id, PostMenuDTO menuDTO<br />
<br />
Returns: MenuDTO updatedMenu<br />
</source><br />
<br />
'''PUT api/v1/Menus/{id}/Dishes'''<br />
<source> <br />
Params: int menuId, int[] dishIds<br />
<br />
Returns: -<br />
</source><br />
<br />
'''DELETE /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Dishes===<br />
'''GET /api/v1/dishes'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<DishDTO><br />
</source><br />
<br />
'''GET /api/v1/dishes/daily'''<br />
<source> <br />
Params: bool vegan, bool glutenFree, bool lactoseFree<br />
<br />
Returns: List<SimpleDishDTO> result<br />
</source><br />
<br />
'''GET: api/v1/dishes/search?title=th&priceLimit=null'''<br />
<source> <br />
Params: string title, decimal? priceLimit<br />
<br />
Returns: List<DishDTO> result<br />
</source><br />
<br />
'''GET /api/v1/dishes/top'''<br />
<source> <br />
Params: int amount<br />
<br />
Returns: List<DishDTO> result<br />
</source><br />
<br />
'''GET /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: DishDTO dishDTO<br />
</source><br />
<br />
'''POST /api/v1/dishes'''<br />
<source> <br />
Params: PostDishDTO dishDTO<br />
<br />
Returns: DishDTO newDish<br />
</source><br />
<br />
'''PUT /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id, PostDishDTO dishDTO<br />
<br />
Returns: DishDTO updatedDish<br />
</source><br />
<br />
'''PUT api/v1/Dishes/{id}/Ingredients'''<br />
<source> <br />
Params: int dishId, PostIngredientForDishDTO[] ingredients<br />
<br />
Returns: -<br />
</source><br />
<br />
'''DELETE /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Ingredients===<br />
'''GET /api/v1/ingredients'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<IngredientDTO><br />
</source><br />
<br />
'''GET /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: IngredientDTO i<br />
</source><br />
<br />
'''POST /api/v1/ingredients'''<br />
<source> <br />
Params: PostIngredientDTO ingredientDTO<br />
<br />
Returns: IngredientDTO newIngredient<br />
</source><br />
<br />
'''PUT /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id, PostIngredientDTO ingredientDTO<br />
<br />
Returns: IngredientDTO updatedIngredient<br />
</source><br />
<br />
'''DELETE /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Ratings===<br />
'''GET /api/v1/ratings'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<RatingLogDTO><br />
</source><br />
<br />
'''GET /api/v1/ratings/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: RatingLogDTO dto<br />
</source><br />
<br />
'''POST /api/v1/ratings'''<br />
<source> <br />
Params: RatingLogForEntityDTO ratingDTO<br />
<br />
Returns: RatingLogDTO newRating<br />
</source><br />
<br />
'''PUT api/v1/ratings/{id}'''<br />
<source> <br />
Params: int id, RatingLogForEntityDTO ratingDTO<br />
<br />
Returns: RatingLogDTO updatedRating<br />
</source><br />
<br />
'''DELETE api/v1/ratings/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===RequestLog===<br />
'''GET: api/v1/usageData/{userId}'''<br />
<source> <br />
Params: string userId<br />
<br />
Returns: List<RequestLogDTO><br />
</source><br />
<br />
== Lõpptoote kasutusjuhend ==<br />
<br />
* Kloonida kohalikku arvutisse repository aadressilt [https://github.com/sikumiku/TaisKohtApi https://github.com/sikumiku/TaisKohtApi]<br />
* Installida NodeJS<br />
* <source>npm install webpack -g</source><br />
* <source>npm install -cli -g</source><br />
* Frontend rakenduse kasutamiseks valida Startup meetoditest IIS Express, veebiteenuse ja Swaggeri kasutamiseks käivitada Api Swagger<br />
* Esimese admin kasutaja loomiseks tuleb kasutaja registreerida admin@gmail.com e-mailiga<br />
<br />
== XML/XSD/XSLT ==<br />
<br />
=== XML ===<br />
<br />
<source><?xml version="1.0" encoding="utf-8" ?><br />
<?xml-stylesheet type="text/xsl" href="XMLFileXML.xslt"?><br />
<restaurants><br />
<restaurant id="1" url="https://kuuspelmeeni.ee" contactnumber="507783342" email="kuuspelmeeni@gmail.com"><br />
<name><![CDATA[Kuus Pelmeeni]]></name><br />
<menus><br />
<menu id="1" repetitioninterval="30"><br />
<name><![CDATA[Päevamenüü]]></name><br />
<activefrom>2018-05-27T12:00:00</activefrom><br />
<activeto>2018-05-28T12:00:00</activeto><br />
<dishes><br />
<dish id="1" vegan="false" lactosefree="false" glutenfree="false" daily="true" kcal="550" dailyprice="4"><br />
<title><![CDATA[8 pelmeeni]]></title><br />
<description><![CDATA[8 pelmeeni 6 asemel serveeritud tervisliku koguse hapukoore ja tilliga]]></description><br />
<availablefrom>2018-05-27T12:00:00</availablefrom><br />
<availableto>2018-05-28T12:00:00</availableto><br />
<ingredients><br />
<ingredient id="1" amountunit="g"><br />
<name>Sealiha</name><br />
<description>Rakvere sealiha</description><br />
</ingredient><br />
<ingredient id="2" amountunit="g"><br />
<name>Hapukoor</name><br />
<description>Alma hapukoor</description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="9"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Parim päevaroog viimasel ajal.]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
</comments><br />
</rating><br />
<promotion id="1" type="visual" classname="bold-red-border-2px"><br />
<name>2px red border</name><br />
<description><![CDATA[Displays a 2px wide red border around the component that is promoted.]]></description><br />
<validto>2018-06-25T12:00:00</validto><br />
</promotion><br />
</dish><br />
<dish id="2" vegan="true" lactosefree="true" glutenfree="true" daily="true" kcal="320" price="4"><br />
<title><![CDATA[Kurgisalat]]></title><br />
<description><![CDATA[Erinevatel viisidel töödeldud kurk serveeritud koos jõhvikatega. Tervislik amps.]]></description><br />
<availablefrom>2018-05-27T12:00:00</availablefrom><br />
<availableto>2018-05-28T12:00:00</availableto><br />
<ingredients/><br />
<rating ratingvalue="4"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Jäin veel väga näljaseks peale selle söömist.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
</dishes><br />
</menu><br />
<menu id="2"><br />
<name><![CDATA[Põhimenüü]]></name><br />
<dishes><br />
<dish id="4" vegan="false" lactosefree="false" glutenfree="false" daily="false" kcal="550" price="5"><br />
<title><![CDATA[6 pelmeeni]]></title><br />
<description><![CDATA[6 pelmeeni serveeritud tervisliku koguse hapukoore ja tilliga]]></description><br />
<ingredients><br />
<ingredient id="1" amountunit="g"><br />
<name>Sealiha</name><br />
<description>Rakvere sealiha</description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="9.5"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Käin seda iga päev söömas.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Parim toit selles restoranis.]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
<dish id="5" vegan="false" lactosefree="false" glutenfree="true" daily="false" kcal="460" price="3.8"><br />
<title><![CDATA[Kartulisalat]]></title><br />
<description><![CDATA[Sinki sisaldav traditsiooniline kartulisalat.]]></description><br />
<ingredients/><br />
</dish><br />
<dish id="6" vegan="false" lactosefree="false" glutenfree="false" daily="false" kcal="610" price="3.9"><br />
<title><![CDATA[Šokolaadikook]]></title><br />
<description><![CDATA[Ahvatlev glasuuritud šokolaadikook.]]></description><br />
<ingredients/><br />
<rating ratingvalue="7.8"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Šokolaadikooki on keeruline metsa keerata.]]></commenttext><br />
<username>mutikas3</username><br />
<userid>3a29b94a-3f17-469d-a44d-f7d85e98dd3e</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
</dishes><br />
</menu><br />
</menus><br />
<dishes/><br />
<address id="1" country="Eesti"><br />
<addressfirstline>Tatari 12</addressfirstline><br />
<locality>Tallinn</locality><br />
<postcode>10132</postcode><br />
<region>Harjumaa</region><br />
</address><br />
<promotion/><br />
<rating ratingvalue="7.5"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Parim restoran üldse!]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Ma sain ainult 5 pelmeeni. Ootasin kuute.]]></commenttext><br />
<username>kyllikekallike1</username><br />
<userid>6af271dd-0e11-4ae6-98be-111762664318</userid><br />
</comment><br />
</comments><br />
</rating><br />
</restaurant><br />
<restaurant id="2" url="https://kolmkokka.ee" contactnumber="6522351" email="kolmkokka@gmail.com"><br />
<name><![CDATA[Kolm kokka]]></name><br />
<menus/><br />
<dishes><br />
<dish id="7" vegan="false" lactosefree="true" glutenfree="false" daily="false" kcal="470" price="14"><br />
<title><![CDATA[Ahjulõhe juurikatega]]></title><br />
<description><![CDATA[Ahjulõhe serveeritud püreestatud porgandite ja lillkapsaga.]]></description><br />
<ingredients><br />
<ingredient id="11" amountunit="tk" amount="1"><br />
<name>Ahjulõhe</name><br />
<description><![CDATA[Värske ahjulõhe]]></description><br />
</ingredient><br />
<ingredient id="12" amountunit="g"><br />
<name>Püreestatud porgand</name><br />
<description><![CDATA[Eesti porgand, mis on kergelt püreestatud]]></description><br />
</ingredient><br />
<ingredient id="13" amountunit="g"><br />
<name>Püreestatud lillkapsas</name><br />
<description><![CDATA[Eesti lillkapsas, mis on kergelt püreestatud ja maitsestatud]]></description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="8.9"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Kindlasti minu üks lemmikuid.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Pole midagi halba öelda.]]></commenttext><br />
<username>tiiuviiu</username><br />
<userid>0730a7b7-3a9c-4e26-962f-da9a8daeab8a</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
<dish id="8" vegan="true" lactosefree="true" glutenfree="true" daily="true" dailyprice="5"><br />
<title><![CDATA[Ingverisupp]]></title><br />
<description><![CDATA[Ingveriga vürtsistatud ingverisupp, mis viib keele alla.]]></description><br />
<availablefrom>2018-05-25T12:00:00</availablefrom><br />
<availableto>2018-06-25T12:00:00</availableto><br />
<ingredients><br />
<ingredient id="14" amountunit="g" amount="20"><br />
<name>Ingver</name><br />
<description><![CDATA[Tükeldatud ingver]]></description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="6"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Liiga palju ingverit.]]></commenttext><br />
<username>kyllikekallike1</username><br />
<userid>6af271dd-0e11-4ae6-98be-111762664318</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
<dish id="9" vegan="false" lactosefree="false" glutenfree="true" daily="false" kcal="340" price="4.5"><br />
<title><![CDATA[Apelsinijäätis]]></title><br />
<description><![CDATA[Apelsinimaitseline jäätis serveeritud riivitud apelsinikoorega.]]></description><br />
<ingredients/><br />
<rating ratingvalue="8"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Väga huvitav magustoit, prooviks veel.]]></commenttext><br />
<username>mutikas3</username><br />
<userid>3a29b94a-3f17-469d-a44d-f7d85e98dd3e</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Üks mu lemmikuid magustoite.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
</dishes><br />
<address id="2" country="Eesti"><br />
<addressfirstline>Laia 12</addressfirstline><br />
<locality>Tallinn</locality><br />
<postcode>13022</postcode><br />
<region>Harjumaa</region><br />
</address><br />
<promotion/><br />
<rating ratingvalue="8.1"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Hinnad on natuke liiga kallid minu jaoks, aga toit om maitsev.]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Ma kindlasti telliks kala uuesti. Väga mahlakas oli.]]></commenttext><br />
<username>kyllikekallike1</username><br />
<userid>6af271dd-0e11-4ae6-98be-111762664318</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Asukoht oli päris tore. Miljöö ka.]]></commenttext><br />
<username>mutikas3</username><br />
<userid>3a29b94a-3f17-469d-a44d-f7d85e98dd3e</userid><br />
</comment><br />
</comments><br />
</rating><br />
</restaurant><br />
</restaurants></source><br />
<br />
=== XSD ===<br />
<br />
<source><?xml version="1.0" encoding="utf-8"?><br />
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema"><br />
<xs:element name="restaurants"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="restaurant"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="menus"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="menu"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="activefrom" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="activeto" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="dishes"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="dish"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="title" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="availablefrom" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="availableto" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="servetime" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="ingredients"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="ingredient"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="amountunit" type="xs:string" use="required" /><br />
<xs:attribute name="amount" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="rating" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="comments"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="comment"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="commenttext" type="xs:string" /><br />
<xs:element name="username" type="xs:string" /><br />
<xs:element name="userid" type="xs:string" /><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="ratingvalue" type="xs:decimal" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="validto" type="xs:dateTime" minOccurs="0" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="type" type="xs:string" use="required" /><br />
<xs:attribute name="classname" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="vegan" type="xs:boolean" use="optional" /><br />
<xs:attribute name="lactosefree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="glutenfree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="daily" type="xs:boolean" use="optional" /><br />
<xs:attribute name="kcal" type="xs:int" use="optional" /><br />
<xs:attribute name="weightg" type="xs:decimal" use="optional" /><br />
<xs:attribute name="price" type="xs:decimal" use="optional" /><br />
<xs:attribute name="dailyprice" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="validto" type="xs:dateTime" minOccurs="0" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="type" type="xs:string" use="required" /><br />
<xs:attribute name="classname" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="repetitioninterval" type="xs:int" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="dishes"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="dish"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="title" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="availablefrom" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="availableto" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="servetime" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="ingredients"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="ingredient"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="amountunit" type="xs:string" use="required" /><br />
<xs:attribute name="amount" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="rating"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="comments"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="comment"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="commenttext" type="xs:string" /><br />
<xs:element name="username" type="xs:string" /><br />
<xs:element name="userid" type="xs:string" /><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="ratingvalue" type="xs:decimal" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="validto" type="xs:dateTime" minOccurs="0" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="type" type="xs:string" use="required" /><br />
<xs:attribute name="classname" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="vegan" type="xs:boolean" use="optional" /><br />
<xs:attribute name="lactosefree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="glutenfree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="daily" type="xs:boolean" use="optional" /><br />
<xs:attribute name="kcal" type="xs:int" use="optional" /><br />
<xs:attribute name="weightg" type="xs:decimal" use="optional" /><br />
<xs:attribute name="price" type="xs:decimal" use="optional" /><br />
<xs:attribute name="dailyprice" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="address"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="addressfirstline" type="xs:string" /><br />
<xs:element name="locality" type="xs:string" /><br />
<xs:element name="postcode" type="xs:string" /><br />
<xs:element name="region" type="xs:string" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="country" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion" /><br />
<xs:element name="rating" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="comments"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="comment"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="commenttext" type="xs:string" /><br />
<xs:element name="username" type="xs:string" /><br />
<xs:element name="userid" type="xs:string" /><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="ratingvalue" type="xs:decimal" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="url" type="xs:string" use="required" /><br />
<xs:attribute name="contactnumber" type="xs:string" use="required" /><br />
<xs:attribute name="email" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:schema></source><br />
<br />
=== XSLT(HTML) ===<br />
<br />
<source><?xml version="1.0" encoding="utf-8" ?><br />
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:msxsl="urn:schemas-microsoft-com:xslt" exclude-result-prefixes="msxsl"><br />
<xsl:output method="html" indent="yes"/><br />
<xsl:template match="/restaurants"><br />
<html><br />
<head><br />
<title>Täis Kõht</title><br />
</head><br />
<body><br />
<xsl:for-each select="restaurant"><br />
<h1 style="color:DodgerBlue"><br />
<xsl:value-of select="name"/><br />
</h1><br />
<div><br />
<xsl:value-of select="@url"/><br />
</div><br />
<div><br />
<xsl:text>Kontakt number: </xsl:text><br />
<xsl:value-of select="@contactnumber"/><br />
</div><br />
<div><br />
<xsl:text>email: </xsl:text><br />
<xsl:value-of select="@email"/><br />
</div><br />
<div><br />
<xsl:text>Aadress: </xsl:text><br />
<xsl:value-of select="address/addressfirstline"/><br />
<xsl:text>, </xsl:text><br />
<xsl:value-of select="address/locality"/><br />
<xsl:text>, </xsl:text><br />
<xsl:value-of select="address/postcode"/><br />
<xsl:text>, </xsl:text><br />
<xsl:value-of select="address/@country"/><br />
</div><br />
<br />
<xsl:choose><br />
<xsl:when test="menus/menu"><br />
<xsl:for-each select="menus/menu"><br />
<xsl:sort select="name"/><br />
<h3><br />
<xsl:value-of select="name"/><br />
</h3><br />
<br />
<xsl:if test="activefrom != '' and activeto != ''"><br />
<xsl:text> </xsl:text><br />
<xsl:value-of select="substring(activefrom,1,10)"/><br />
<xsl:text> kuni </xsl:text><br />
<xsl:value-of select="substring(activeto,1,10)"/><br />
</xsl:if><br />
<br />
<ul><br />
<xsl:for-each select="dishes/dish"><br />
<xsl:sort select="title"/><br />
<br />
<xsl:if test="availablefrom != '' and availableto != ''"><br />
<xsl:value-of select="substring(availablefrom,1,10)"/><br />
<xsl:text> kuni </xsl:text><br />
<xsl:value-of select="substring(availableto,1,10)"/><br />
</xsl:if><br />
<br />
<li><br />
<span style="font-weight:bold"><br />
<xsl:value-of select="title"/><br />
</span><br />
<xsl:text> - </xsl:text><br />
<xsl:value-of select="description"/><br />
<xsl:text> </xsl:text><br />
<span style="font-weight:bold"><br />
<xsl:if test="@glutenfree='true'"><br />
<xsl:text>G </xsl:text><br />
</xsl:if><br />
<xsl:if test="@lactosefree='true'"><br />
<xsl:text>L </xsl:text><br />
</xsl:if><br />
<xsl:if test="@vegan='true'"><br />
<xsl:text>V </xsl:text><br />
</xsl:if><br />
</span><br />
</li><br />
<br />
<xsl:for-each select="ingredients/ingredient"><br />
<xsl:value-of select="name"/><br />
<xsl:if test="position()!=last()"><br />
<xsl:text>, </xsl:text><br />
</xsl:if><br />
</xsl:for-each><br />
<br />
<p style="font-weight:bold"><br />
<xsl:text>Hind: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="@price!=''"><br />
<xsl:value-of select="@price"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>-</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
<xsl:text> / Päevapakkumise hind: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="@dailyprice!=''"><br />
<xsl:value-of select="@dailyprice"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>-</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
</p><br />
<br />
<div style="background-color:LightGray;"><br />
<xsl:text>Hinnang praele: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="rating/@ratingvalue!=''"><br />
<xsl:value-of select="rating/@ratingvalue"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>Ei ole veel hinnatud!</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
<br />
<br/><br />
<xsl:for-each select="rating/comments/comment"><br />
<xsl:value-of select="username"/><br />
<xsl:text>: </xsl:text><br />
<xsl:value-of select="commenttext"/><br />
<br/><br />
</xsl:for-each><br />
</div><br />
<br/><br />
</xsl:for-each><br />
</ul><br />
</xsl:for-each><br />
</xsl:when><br />
<xsl:otherwise><br />
<ul><br />
<xsl:for-each select="dishes/dish"><br />
<xsl:sort select="title"/><br />
<br />
<xsl:if test="availablefrom != '' and availableto != ''"><br />
<xsl:value-of select="substring(availablefrom,1,10)"/><br />
<xsl:text> kuni </xsl:text><br />
<xsl:value-of select="substring(availableto,1,10)"/><br />
</xsl:if><br />
<br />
<li><br />
<span style="font-weight:bold"><br />
<xsl:value-of select="title"/><br />
</span><br />
<xsl:text> - </xsl:text><br />
<xsl:value-of select="description"/><br />
<xsl:text> </xsl:text><br />
<span style="font-weight:bold"><br />
<xsl:if test="@glutenfree='true'"><br />
<xsl:text>G </xsl:text><br />
</xsl:if><br />
<xsl:if test="@lactosefree='true'"><br />
<xsl:text>L </xsl:text><br />
</xsl:if><br />
<xsl:if test="@vegan='true'"><br />
<xsl:text>V </xsl:text><br />
</xsl:if><br />
</span><br />
</li><br />
<br />
<xsl:for-each select="ingredients/ingredient"><br />
<xsl:value-of select="name"/><br />
<xsl:if test="position()!=last()"><br />
<xsl:text>, </xsl:text><br />
</xsl:if><br />
</xsl:for-each><br />
<br />
<p style="font-weight:bold"><br />
<xsl:text>Hind: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="@price!=''"><br />
<xsl:value-of select="@price"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>-</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
<xsl:text> / Päevapakkumise hind: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="@dailyprice!=''"><br />
<xsl:value-of select="@dailyprice"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>-</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
</p><br />
<br />
<div style="background-color:LightGray;"><br />
<xsl:text>Hinnang praele: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="rating/@ratingvalue!=''"><br />
<xsl:value-of select="rating/@ratingvalue"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>Ei ole veel hinnatud!</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
<br />
<br/><br />
<xsl:for-each select="rating/comments/comment"><br />
<xsl:value-of select="username"/><br />
<xsl:text>: </xsl:text><br />
<xsl:value-of select="commenttext"/><br />
<br/><br />
</xsl:for-each><br />
</div><br />
<br/><br />
</xsl:for-each><br />
</ul><br />
</xsl:otherwise><br />
</xsl:choose><br />
<br />
<div style="background-color:LightGray;"><br />
<xsl:text>Hinnang restoranile: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="rating/@ratingvalue!=''"><br />
<xsl:value-of select="rating/@ratingvalue"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>Ei ole veel hinnatud!</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
<br />
<br />
<br/><br />
<xsl:for-each select="rating/comments/comment"><br />
<xsl:value-of select="username"/><br />
<xsl:text>: </xsl:text><br />
<xsl:value-of select="commenttext"/><br />
<br/><br />
</xsl:for-each><br />
</div><br />
<br />
<p><br />
<xsl:text>*G - gluteenivaba, </xsl:text><br />
<xsl:text>L - laktoosivaba, </xsl:text><br />
<xsl:text>V - vegan </xsl:text><br />
</p><br />
<br />
</xsl:for-each><br />
</body><br />
</html><br />
</xsl:template><br />
</xsl:stylesheet></source><br />
<br />
=== XSLT(XML) ===<br />
<br />
XML'is kuvatakse elemendid ja atribuudid eesti keeles. Kuvatakse restorani andmed ja toidud, mille hinnang on 8 või rohkem punkti.<br />
<br />
<source><?xml version="1.0" encoding="utf-8" ?><br />
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"<br />
xmlns:msxsl="urn:schemas-microsoft-com:xslt" exclude-result-prefixes="msxsl"><br />
<xsl:output method="xml" indent="yes"/><br />
<br />
<xsl:template match="/restaurants"><br />
<restoranid><br />
<xsl:for-each select="restaurant"><br />
<restoran url="{@url}" telefon="{@contactnumber}" email="{@email}"><br />
<nimi><br />
<xsl:value-of select="name"/><br />
</nimi><br />
<aadress><br />
<postiaadress><br />
<xsl:value-of select="address/addressfirstline"/><br />
</postiaadress><br />
<linn><br />
<xsl:value-of select="address/locality"/><br />
</linn><br />
<indeks><br />
<xsl:value-of select="address/postcode"/><br />
</indeks><br />
<riik><br />
<xsl:value-of select="address/@country"/><br />
</riik><br />
</aadress><br />
<br />
<parimadToidud><br />
<xsl:choose><br />
<xsl:when test="menus/menu/dishes/dish"><br />
<xsl:for-each select="menus/menu/dishes/dish"><br />
<xsl:if test="rating/@ratingvalue &gt;= 8.0"><br />
<heaToit hinnang="{rating/@ratingvalue}" paevaPakkumiseHind="{@dailyprice}" hind="{@price}" <br />
vegan="{@vegan}" laktoosivaba="{@lactosefree}" gluteenivaba="{@glutenfree}"><br />
<nimi><br />
<xsl:value-of select="title"/><br />
</nimi><br />
<kirjeldus><br />
<xsl:value-of select="description"/><br />
</kirjeldus><br />
</heaToit><br />
</xsl:if><br />
</xsl:for-each><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:for-each select="dishes/dish"><br />
<xsl:if test="rating/@ratingvalue &gt;= 8.0"><br />
<heaToit hinnang="{rating/@ratingvalue}" paevaPakkumiseHind="{@dailyprice}" hind="{@price}" <br />
vegan="{@vegan}" laktoosivaba="{@lactosefree}" gluteenivaba="{@glutenfree}"><br />
<nimi><br />
<xsl:value-of select="title"/><br />
</nimi><br />
<kirjeldus><br />
<xsl:value-of select="description"/><br />
</kirjeldus><br />
</heaToit><br />
</xsl:if><br />
</xsl:for-each><br />
</xsl:otherwise><br />
</xsl:choose><br />
</parimadToidud><br />
</restoran><br />
</xsl:for-each><br />
</restoranid><br />
</xsl:template><br />
</xsl:stylesheet><br />
</source><br />
<br />
== Retsensioonid ==<br />
<br />
=== Veebiteenuse retsensioon meeskonnale [https://wiki.itcollege.ee/index.php/MOT MOT] ===<br />
<br />
* Puudub README vms. Dokumentatsioon projekti ülespanemiseks ja seadistamiseks.<br />
* Rollide loomine vigane, seda võiks teha eraldi failis, mis on DAL.App.EF projektis (kasutasime algul sama lähenemist nagu antud projekt). Takistab esialgset andmebaasi uuendust, kui rollid veel puuduvad. Rakenduse installimine tarnitud kujul ei õnnestunud. Selleks et Nuget Package Manageri käsk Update-Database töötaks pidi ajutiselt välja kommenteerima Startup.cs faili rea 153 (// CreateRoles(services).Wait();).<br />
==== Andmebaasist: ====<br />
* Üldiselt paneksin igale väljale juurde AddTime ja UpdateTime see on hea tava millest korduvalt ka andmebaasi alustes räägiti ja rõhutati.<br />
==== Olemitest: ====<br />
* Kui juba domainis nimetate kõik olemid singulaarselt siis võiks ju sama teha ka andmebaasis - lisakeerukuse loomine kohas kus see ei ole vajalik.<br />
* Entity-te arv oli nõutust väiksem - Kokku 8 olemit, millest 1 on many-to-many liittabel ja 1 otsene koopia Identity framework Users tabelist. <br />
* Olem People ~= Users ja sisaldab ka viidet Identity tabelile ApplicationUsers (ApplicationUserId). Juhul kui see on mõeldud rakendusega mitte registreerunud kasutajate võistlusele kirja panemiseks, siis oleks olemil rohkem infot vaja - vähemalt mingigi kontakti väli (email |/& tel.nr. |/& aadress).<br />
* Competition.Comment on varchar(100) - võiks ja peaks olema varchar(1000)<br />
* Competition.CompetitionPlaceId - kui võistluse toimumiskoht mingil põhjusel peaks keelduma korraldusest või kui võistlust alles pannakse kokku ja ei ole veel teada kus see toimuma saab siis mis peaks sinna sisestama (NOT NULL => NULL)<br />
* Competition.Time -> Mis aega see näitab? Property nimest seda välja ei loe. Kui StartTime, siis kus on EndTime või Duration?<br />
* CompetitionPlace.County -> int type enum default väärtus on 0, kuna see pole aga enumi klassis implementeeritud põhjustab see vea. (Millisele maakonnale vastab 0?) See teada tuntud probleem millele google annab hõlpsasti erinevaid lahendusi: näiteks [https://stackoverflow.com/questions/24350377/entity-framework-6-code-first-required-enum-data-type-not-working?utm_medium=organic&utm_source=google_rich_qa&utm_campaign=google_rich_qa siin] ja [https://stackoverflow.com/questions/529929/choosing-the-default-value-of-an-enum-type-without-having-to-change-values/529937?utm_medium=organic&utm_source=google_rich_qa&utm_campaign=google_rich_qa siin].<br />
* Väljad mis viitavad Identity framework olemitele läbi nende ID-de ei peaks olema nvarchar(max) vaid nvarchar(450) (kuigi isegi see on reaalsuses liiga pikk).<br />
* PersonInTeam.PersonInTeamId -> ei peaks olema sellist välja üldse, selle tabeli PK peaks olema kombinatsioon nende tabeli ID-st mida ta ühendab. Praegu ei ole unique indeksit üle nende, mis tähendab et sama inimene saab mitu korda sama tiimiga liituda.<br />
* Participations - Miks selline nimi, kui registreerimine juba oli? Saan aru et selles olemis tahetakse säilitada võistluse tulemusi. Siis võiks ju juba olla CompetitionResults. Kus on aga saavutatud koha numbri talletamine? Kui võistluse punktid ja ajad on kõik kirja saadud siis tahaks ju tulemusi ka kuidagi näha ja võrrelda ning selle võrdluse tulemi kuhugi salvestada.<br />
* Participations.Time - Mis aega näitab? Eeldan, et võistluse läbimise aega? Kui nii, siis miks ei ole NULL lubatud - mõnedel võistlustel aega ju ei mõõdeta?<br />
* Participation.Points - Kas igal võistlusel antakse ainult täisarv punkte (int)? Võiks igaks juhuks siiski implementeerida double väärtuse tüübi. Lisaks ei ole võimalik osalust luua ilma punkte teadmata - peaks siis määrama default väärtus. Mõnede võistluste puhul jälle punkte ei anta vaid mõõdetakse aega.<br />
* Participation.Disqualified - Nullid ei ole lubatud -> järelikult oleks default väärtust vaja.<br />
* Registrations - Projekti Must have alla on märgitud “Osaleja saab registreerida võistlusele meeskonda” kuid olemis puudub TeamsId ning samuti ei ole seda võimalust kuidagi läbi Servicei implementeeritud.<br />
* Registrations - Millal registreering tehti on suhteliselt tähtis teada. Paljude võistluste puhul sõltub sellest näiteks registreerimistasu. <br />
==== DTO-d: ====<br />
* Täiesti mõttetult sisse toodud kiht, lihtsalt selleks et nii oli ette nähtud. Kõik DTO-d konverteeritakse ümber 1:1-le Domain objektideks ja vastupidi.<br />
* Üldiselt oleks vaja teha tööd veel DTOdega, et need rohkem peegeldaksid oma kasutust. Näiteks:<br />
** küsides kõiki võistlusi, kas meil on tarvis avalikustada kliendile, mis on kasutaja ID, kes iga võistluse lõi? DTOsid võiks olla rohkem erinevate kasutusjuhtumite jaoks. <br />
** CompetitionDTO võiks sisaldada ka nimekirja võistlejatest, kus koondatakse info ManyToMany seoste põhjal kasutades vahetabelit, nagu näiteks:<br />
<source><br />
List<PersonDTO> people = c.Participation<br />
.FindAll(p => p.CompetitionId == c.CompetitionId)<br />
.Select(PersonDTO.CreateFromParticipation)<br />
.ToList();<br />
</source><br />
<br />
==== API Kontrolleritest: ====<br />
* Puudub Swagger startup konfiguratsioon, Swagger annotatsioonid kaotavad mõtte ning pole võimalik kontrollida, kas need on korrektselt loodud.<br />
* ProducesResponse annotatsiooni pole kusagile lisatud, staatuskoodid on natuke poolikult läbi mõeldud, vähemalt need, mida Swaggeri raames mainitud on<br />
*Annotatsioon Authorize, kus on ära määratud AuthorizationScheme peaks minema kogu klassi peale, meetodis saab ära määrata vaid selle, mis rollid on lubatud.<br />
* AccountController<br />
** Response code uue kasutaja loomisel võiks olla 201<br />
** Puuduvad koodid nagu 429, 500<br />
** Registreerumisel võiks kontrollida, kas kasutaja on juba olemas, mitte vaid rolli olemasolu<br />
** Kas kasutajal ei või antud kontekstis olla mitu rolli? Sisselogimisel võetakse rollide seast vaid esimene ja lisatakse juurde Claimile. Võimalus kirjutada ka meetod, mis lisab kasutajale kõik rollid.<br />
* CompetitionPlacesController/CompetitionsController/CompetitionTypesController/ParticipationsController/RegistrationsController/TeamsController <br />
** Antud kontrollerid on kõik väga sarnase loogikaga<br />
** Get() tagastab vaid koodi 200, tagastuskoodi võimalusi on veel<br />
** Post() meetod küsib sisse DTOd, mille üheks parameetriks on id, id genereeritakse automaatselt, seda ei peaks panema kaasa postitatavasse mudelisse, mis alles loob objekti<br />
** Put() puhul sama kriitika, siin on id küll vajalik, aga see juba pannakse kaasa parameetrina eraldi<br />
** See tundub natuke veidrana üritada kontrollida uuendatud mudeli põhjal, kas tegemist oli BadRequestiga. Eelkõige peaks id puhul üles otsima, kas antud objekt on üldse olemas ja seejärel üritada uuendada, muidu tagastada BadRequest. Kui see ei õnnestu, siis peaks juba errorkood 500 peegeldama seda, et midagi läks teenuse poole peal valesti. <br />
** Sama kommentaar deletemise kohta, enne tuleks kontrollida, kas objekt on olemas. Siis alles objekt kustutada.<br />
* PeopleController<br />
** Kas tõepoolest igaüks saab pärida infot inimeste kohta ja neid postitada? <br />
* PersonInTeamsController <br />
** API disaini poole pealt on natuke veider teha vahetabelite kohta kontroller. Tundub loogilisem panna antud kontrolleri meetodid teistesse kontroleritesse, mis on seotud siis kas meeskondade või inimestega. Näiteks küsida ** PeopleControlleris kõik inimesed, kes on meeskondades või küsida neid meeskonna järgi. TeamsControlleris seevastu anda võimalus lisada uusi inimesi meeskonda, neid muuta või eemaldada.<br />
Id järgi ei hakka ükski klient küsima vahetabeli kohta infot, see tundub otstarbetu tegevus, pigem küsida kas meeskonna või inimese id järgi sissekandeid<br />
* Kriitika kontrollerite kohta: kontrollerid enamuses pöörduvad vaid spetsiifiliste domeenide poole ja viivad ellu väga tavalist CRUD funktsionaalsust, mille tõttu tundub, et need on natuke veel toored. Näiteks on välja toodud “must have” nimekirjas projekti analüüsis, et meeskonna liige peaks saama muuta meeskonna andmeid. Antud kontrollerites vaid autentitakse, et kasutaja oleks rollis “participant”, kuid mitte seda, kas ta ka muudetava meeskonna liige on. Samuti pole võimalik kasutajatel näha, palju on mingile võistlusele osalejaid registreerunud, CompetitionsController ei tegele sellega, et tagastada võistlusele registreerunud kasutajaid, selle asemel on olemas ParticipationsController, mis tagastab vahetabeli infot selle kohta, mis võistlusega on seotud mis inimene. See võib olla tohutult suur info, mida hakata filtreerima kliendi poolelt. Rohkem tuleks teha andmete agregeerimist vastavalt teenuse kontekstile.<br />
<br />
==== Projekti kihid/struktuur: ====<br />
* Olemas Business Logic, Data Access Layer, DTO’d, Service’id, Unit of Work, domeeniklassid ning API spetsiifilised kontrollerid, mis asuvad oma kaustas põhiprojekti all . DAL omab erinevaid kihte interface’ide ja neid implementeerivate klasside jaoks. Repositooriumitega suhtlemine on abstraktne, kõik käib läbi Data Access Layer’i, mille pööle pöörduvad teenuseklassid ning DAL erinevad kihid hoolitsevad selle eest, et loodaks õiget tüüpi repositooriumeid, andmeid agregeeritakse, uuendatakse ja salvestatakse organiseeritud kujul ning neid tagastatakse teenustele soovitud kujul (DTOd).<br />
<br />
== Logiraamat ==<br />
<br />
===07.02.2018===<br />
Gupi loomine ning suhtluskanali seadistamine<br />
<br />
=== 24.03.2018 ===<br />
Trello boardi loomine<br />
<br />
=== 25.03.2018 ===<br />
Wiki lehe loomine. Esimene tõsisem projekti koosolek ning tegevuskava paika panemine.<br />
<br />
=== 26.03.2018 ===<br />
<br />
Alustasime veebiteenuse analüüsiga ja funktsionaalsuse kirjeldamisega.<br />
<br />
=== 27.03.2018 ===<br />
Täiendasime veebiteenuse analüüsi.<br />
<br />
Esmase andmebaasi mudeli koostamine.<br />
<br />
Postitatud esimeste analüüsi arutelude põhjal valminud algne prototüüp.<br />
<br />
=== 30.03.2018 ===<br />
Valmis andmebaasimudel.<br />
<br />
=== 08.04.2018 ===<br />
Tehtud muudatused analüüsis vastavalt tagasisidele.<br />
<br />
=== 19.04.2018 ===<br />
Loodud projekti põhi koos domeenimudelitega. Projekt lisatud Githubi: https://github.com/sikumiku/TaisKohtApi<br />
<br />
=== 05-06.05.2018 ===<br />
Osalesime hackathonil. Lisatud controllerid, service'id koos vajalike kihtidega.<br />
<br />
=== 16.05.2018 ===<br />
Uuendatud andmebaasimudelit, DTO'sid.<br />
<br />
=== 18-19.05.2018 ===<br />
Lisatud klientrakendus, security, äriloogikat.<br />
<br />
=== 20.05.2018 ===<br />
Lisatud API dokumentatsioon.<br />
<br />
=== 22-24.05.2018 ===<br />
Uuendatud contoller'eid, service'id.<br />
<br />
=== 25-27.05.2018 ===<br />
Uuendatud contoller'eid, service'id. Lisatud kasutajate ja rollide kontrolle meetoditesse. Täiustatud klientrakendust. Swagger dokumentatsioon.<br />
<br />
=== 31.05-01.06.2018 ===<br />
Tegeletud XML, XSD ja XSLT failide loomisega.<br />
<br />
=== 02.06-03.06.2018 ===<br />
Tegeletud XML ja XSLT failide täiustamisega ja retsensioonide kirjutamisega.</div>
Saasma
https://wiki.itcollege.ee/index.php?title=BeerPressure&diff=131182
BeerPressure
2018-06-03T20:43:49Z
<p>Saasma: /* API Kontrolleritest: */</p>
<hr />
<div>== Meeskond ja rollid ==<br />
<br />
* Sigrid Aasma (arendaja)<br />
* Evelin Jõgi (arendaja)<br />
* Martin Kask (projektijuht, arendaja)<br />
* Marko Nõu (arendaja)<br />
<br />
== Idee ==<br />
'''Toidukohtade põhimenüüde ja päevapakkumiste teenus'''<br />
<br />
Soovime pakkuda toidukohtade põhimenüüde ja päevapakkumiste teenust. On olemas mitmeid kodulehti “päevapakkumised”, kus on kirjas toidukohtade päevapraed. Kuid tavaliselt sellistel lehtedel ei ole masinloetavaid andmeid ehk siis varianti, et saad saata API pihta mingi kuupäeva koos päevapraadidega andmete uuendamiseks ja saad sama API käest küsida tänaseid päevapraade. Andmeid võiks saada küsida restorani, kuupäeva, asukoha või otsisõna/otsisõnaosa põhiselt. Selline teenus lihtsustaks ka toidukohtade päevapakkumiste haldamist, kuna praegu peavad teenuse pakkujad vastavat informatsiooni uuendama mitmes erinevas kohas - nii erinevates portaalides, kui ka enda veebileheküljel. Samuti oleks toidukohtade kogu menüü haldamine ühes kohas.<br />
<br />
=== Esialgne prototüüp ===<br />
<br />
[[File:TäisKõhtProto1.mp4]]<br />
<br />
Esialgne prototüüp: [http://enos.itcollege.ee/~saasma/VR2/Proto/K%C3%B5htT%C3%A4is/#g=1&p=home navigeeritav versioon vol.1]<br />
<br />
=== Prototüübi muutus projekti käigus ===<br />
<br />
Prototüüp: [http://enos.itcollege.ee/~saasma/VR2/Proto/T%C3%A4isK%C3%B5ht/K%C3%B5htT%C3%A4is/#g=1&p=home navigeeritav versioon vol.2]<br />
<br />
== Kasutatav arendustehnoloogia ==<br />
<br />
Veebiteenuse loomisel kasutame ASP.NET Core tehnoloogiat ja kursusel õpitud arendusmustreid.<br />
<br />
Klientrakenduse loomisel kasutame Node.js + React'i.<br />
<br />
== Veebiteenuse analüüs ==<br />
Pakume toidukohtade põhimenüüde ja päevapakkumiste teenust, kuhu on kokku koondatud erinevate toidukohtade menüüd üle Eesti. Põhimenüü alla kuuluvad pikaajalised menüüd, mis kehtivad püsivalt, hooajaliselt või mingil konkreetsel nädalapäeval. Päevapakkumiste alla kuuluvad konkreetse kuupäevaga seotud päevapakkumised. Päevapakkumiste korral kuvatakse lisainfona, kas pakkumine kehtib mingis konkreetses ajavahemikus või kogu toidukoha lahtioleku aja.<br />
<br />
Eesmärk on koguda ühte kohta kokku erinevate toidukohtade menüüd ja päevapakkumised, et kliendid saaksid mugavalt ja kiiresti oma valikuid teha. Kliendid käivad enamasti päevapakkumisi söömas lõuna ajal ja selleks ettenähtud aeg on piiratud. Sellepärast on oluline, et klient saaks teha oma valiku võimalikult kiiresti. Tänu loodavale veebiteenusele ei pea kliendid käima erinevates portaalides, et tutvuda erinevate toidukohtade pakkumistega. Kuna teenust on mugav kasutada ja klient saab oma valiku kiiresti tehtud, siis tõenäoliselt teeb klient valiku selles keskkonnas olevate toiduasutuste seast. Lisaks võimaldab teenus toiduasutustel paika panna oma pikaajalisem põhimenüü ning seda rakenduses ja võimalusel ka söögikohas kuvada. Sellepärast on ka toidukohtade huvi antud keskkonnas üleval olla ja meiega oma andmeid jagada, sest see suurendab nende klientuuri ning muudab oma menüü haldamise kergemaks.<br />
<br />
Veebiteenuse loomisel lähtume eelkõige sellest, et kliendil oleks teenust mugav kasutada ja ta saaks oma valiku kiiresti tehtud. Arvestame, et kliendid on erinevad. Mõni eelistab mõnda kindlat toidukohta, sel juhul saab ta valida oma soovitud kohad ja võrrelda nende kohtade tänase päeva pakkumisi ning menüüsid. Mõnele inimesele on oluline pakutav söök ja ta eelistab pakkumist otsida prae nimetuses oleva sõna või sõnaosa järgi ning lähtuda seejärel valiku tegemisel toidukoha keskmisest hindest või toidu hinnast. Mõne kliendi jaoks on oluline hind ja selleks, et oma valikut teha sobivas hinnavahemikus on tal võimalik sisestada maksimum hinna piirang. Kindlasti on antud teenuse juures kõikide klientide jaoks oluline päevapakkumiste asukohapõhine eristatus. Kliendid, kes soovivad oma konto luua, võivad oma eelistatud valikud meelde jätta ja järgmisel korral kuvatakse neid talle automaatselt.<br />
<br />
Teenuse must-have funktsionaalsus tagab teenuse toimimise ja põhifunktsioonid. Teenuse nice-to-have funktsionaalsus annab rakendusele lisandväärtust.<br />
<br />
Arvestades pakutava teenusega, siis näeme, et aktiivseim teenuse kasutamine võib olla tööpäevadel vahemikus 11.00-15.00, kui kliendid tutvuvad päevapakkumistega. Teenus peab tekkivale koormusele vastu pidama.<br />
<br />
Teenuse pakkumine peab olema turvaline. Selle tagamiseks tuleb sisestatavaid andmeid valideerida ja andmebaasi sisestavate andmete mahtu piirata. Toidukohtade sisestatud andmed peavad olema kaitstud, et toitude koostised ei saaks avalikuks. Põhjendatud juhtudel on võimalik kasutajaid lukku panna.<br />
<br />
== Kasutajad ==<br />
<br />
<br />
* Admin - lehe administraator, kellel on õigus lehte, kasutajaid ja nende õiguseid hallata. Tema huvi on, et teenus toimiks tõrgeteta.<br />
* Toiduasutus (tasuta kasutaja) - saab hoida lehel ühte põhimenüüd ja päevapakkumisi.<br />
* Toiduasutus (tellimusega kasutaja) - saab hoida lehel piiramatu arv põhimenüüsid ja päevapakkumisi.<br />
Toiduasutused on teenusest huvitatud, et nende menüüde haldamine oleks kerge ja mugav ning nad saaksid oma klientide arvu suurendada.<br />
* Külastaja - klient, kes valib söögikohta. Tema on huvitatud eelkõige sellest, et teenust saaks kasutada mugavalt ja kiirelt ning toidukohtade valik oleks võimalikult suur.<br />
<br />
== Rakenduse must-have funktsionaalsus ==<br />
<br />
* Kasutajad saavad sisse logida<br />
* Kasutajatel on erinevad rollid: admin, toidukoht (tasuta ja tasulise tellimusega), klient<br />
* Kasutajate arvepidamine kasutajate lõikes:<br />
** sisselogimise kuupäev, kellaaeg<br />
** pakkumiste lisamine<br />
** pakkumiste muutmine<br />
** pakkumiste kustutamine<br />
** õiguste kehtimise periood (tasuta ja tellimusega toidukoht)<br />
** pakkumistele klikkimise arv<br />
* Kasutajaid on võimalik hallata:<br />
** kasutajale õiguste andmine (menüüde arvu suurendamine, tellimusega toidukohal), rolli määramine<br />
** Kasutajat on võimalik piirata: õiguseid piirata (piiratud menüüde arv, tasuta liitunud toidukohal) ja lukku panna<br />
* Päevapakkumisi/menüüsid saab küsida: <br />
** toidukoha järgi, <br />
** kuupäeva põhiselt (ainult päevapakkumisi), <br />
** asukoha põhiselt,<br />
** toidu nimetuses esineva otsisõna/otsisõna osa põhiselt,<br />
** hinna põhiselt (max hinna piirang).<br />
* Klientrakenduses realiseeritakse CRUD meetodid (menüüsid/päevapakkumisi saab sisestada, lugeda, uuendada, kustutada)<br />
* Toidukohale saab anda hindeid ja kuvatakse keskmist hinnet.<br />
* Toidule saab anda hindeid ja kuvatakse keskmist hinnet.<br />
<br />
== Nice-to-have funktsionaalsus ==<br />
<br />
* Info selle kohta, kas päevapakkumine on otsas<br />
* Päevapakkumisi/menüüsid saab kommenteerida ja neid kommentaare kuvatakse avalikult.<br />
* Söögikohtade kodulehtedelt otsimise script, mis genereerib juba olemasolevate kodulehtede baasil päevamenüüsid.<br />
* Toiduvaliku piiramine allergeenide/vegan/jms. koostisosade põhiselt.<br />
* Aruandlused ja võrdlused toidukohtadele, et võrrelda end konkurentidega.<br />
* Teenus soovitab toidukohtadele nende varasemate päevapraadide populaarsuse alusel uue nädala menüüd.<br />
* Erinevad toidukohtade/toitude pingeread klientidele, et anda valikuteks ideid.<br />
* Soovitused klientidele, mida teised kliendid sarnaste eelistustega on veel valinud.<br />
<br />
== Andmebaasi ülesehitus - projekti algus ==<br />
<br />
[[File: BeerPressureAndmebaasimudel.png]]<br />
<br />
== Andmebaasi ülesehitus - projekti lõpp ==<br />
<br />
[[File: Ta2isKo6ht-DB-FINAL.png]]<br />
<br />
== Projekti repository ==<br />
<br />
https://github.com/sikumiku/TaisKohtApi<br />
<br />
Zip fail saadaval: <br />
(master branchi viimane commit esitamise ajal)<br />
https://github.com/sikumiku/TaisKohtApi/archive/61438e187a1a972410c8a3bc6274d69489d00aa6.zip<br />
<br />
== API v1 dokumentatsioon ==<br />
<br />
===Security===<br />
'''POST /api/account/register'''<br />
<source><br />
Params: RegisterViewModel registerViewModel<br />
<br />
Returns: token<br />
</source><br />
<br />
'''POST /api/account/login'''<br />
<source> <br />
Params: LoginViewModel model<br />
<br />
Returns: token<br />
</source><br />
<br />
'''POST /api/account/logout'''<br />
<source> <br />
Params: -<br />
<br />
Returns: -<br />
</source><br />
<br />
===Accounts===<br />
'''GET /api/v1/accounts/getAllUsersInRole'''<br />
<source> <br />
Params: string role<br />
<br />
Returns: List<UserDTO><br />
</source><br />
<br />
'''GET /api/v1/accounts/{id}'''<br />
<source> <br />
Params: string id<br />
<br />
Returns: UserDTO<br />
</source><br />
<br />
'''PUT /api/v1/accounts/{id}'''<br />
<source> <br />
Params: string id, UpdateUserDTO userDTO<br />
<br />
Returns: -<br />
</source><br />
<br />
'''POST /api/v1/accounts/addRole'''<br />
<source> <br />
Params: string role<br />
<br />
Returns: -<br />
</source><br />
<br />
'''POST /api/v1/accounts/addRoleToUser'''<br />
<source> <br />
Params: string role, string userId<br />
<br />
Returns: UserDTO<br />
</source><br />
<br />
'''DELETE /api/v1/accounts/deactivate/{id}'''<br />
<source> <br />
Params: string id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Promotions===<br />
'''GET /api/v1/promotions '''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<PromotionDTO> <br />
</source><br />
<br />
'''GET /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: PromotionDTO<br />
</source><br />
<br />
'''POST /api/v1/promotions'''<br />
<source> <br />
Params: PromotionDTO promotionDTO<br />
<br />
Returns: PromotionDTO newPromotion<br />
</source><br />
<br />
'''PUT /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id, PromotionDTO promotionDTO<br />
<br />
Returns: PromotionDTO updatedPromotion<br />
</source><br />
<br />
'''DELETE /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Restaurants===<br />
'''GET /api/v1/restaurants'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<SimpleRestaurantDTO><br />
</source><br />
<br />
'''GET /api/v1/restaurants/search?name=th'''<br />
<source> <br />
Params: string name<br />
<br />
Returns: List<SimpleRestaurantDTO> result<br />
</source><br />
<br />
'''GET /api/v1/restaurants/top'''<br />
<source> <br />
Params: int amount<br />
<br />
Returns: List<SimpleRestaurantDTO> result<br />
</source><br />
<br />
'''GET /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: RestaurantDTO r<br />
</source><br />
<br />
'''POST /api/v1/restaurants/addUserToRestaurant'''<br />
<source> <br />
Params: int id, string userId<br />
<br />
Returns: -<br />
</source><br />
<br />
'''POST /api/v1/restaurants'''<br />
<source> <br />
Params: PostRestaurantDTO restaurantDTO<br />
<br />
Returns: RestaurantDTO newRestaurant<br />
</source><br />
<br />
'''PUT /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id, PostRestaurantDTO restaurantDTO<br />
<br />
Returns: PostRestaurantDTO updatedRestaurantDTO<br />
</source><br />
<br />
'''DELETE /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Menus===<br />
'''GET /api/v1/menus'''<br />
<source><br />
Params: -<br />
<br />
Returns: List<MenuDTO><br />
</source><br />
<br />
'''GET /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: MenuDTO menuDTO<br />
</source><br />
<br />
'''POST /api/v1/menus'''<br />
<source> <br />
Params: PostMenuDTO menuDTO<br />
<br />
Returns: MenuDTO newMenu<br />
</source><br />
<br />
'''PUT /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id, PostMenuDTO menuDTO<br />
<br />
Returns: MenuDTO updatedMenu<br />
</source><br />
<br />
'''PUT api/v1/Menus/{id}/Dishes'''<br />
<source> <br />
Params: int menuId, int[] dishIds<br />
<br />
Returns: -<br />
</source><br />
<br />
'''DELETE /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Dishes===<br />
'''GET /api/v1/dishes'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<DishDTO><br />
</source><br />
<br />
'''GET /api/v1/dishes/daily'''<br />
<source> <br />
Params: bool vegan, bool glutenFree, bool lactoseFree<br />
<br />
Returns: List<SimpleDishDTO> result<br />
</source><br />
<br />
'''GET: api/v1/dishes/search?title=th&priceLimit=null'''<br />
<source> <br />
Params: string title, decimal? priceLimit<br />
<br />
Returns: List<DishDTO> result<br />
</source><br />
<br />
'''GET /api/v1/dishes/top'''<br />
<source> <br />
Params: int amount<br />
<br />
Returns: List<DishDTO> result<br />
</source><br />
<br />
'''GET /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: DishDTO dishDTO<br />
</source><br />
<br />
'''POST /api/v1/dishes'''<br />
<source> <br />
Params: PostDishDTO dishDTO<br />
<br />
Returns: DishDTO newDish<br />
</source><br />
<br />
'''PUT /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id, PostDishDTO dishDTO<br />
<br />
Returns: DishDTO updatedDish<br />
</source><br />
<br />
'''PUT api/v1/Dishes/{id}/Ingredients'''<br />
<source> <br />
Params: int dishId, PostIngredientForDishDTO[] ingredients<br />
<br />
Returns: -<br />
</source><br />
<br />
'''DELETE /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Ingredients===<br />
'''GET /api/v1/ingredients'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<IngredientDTO><br />
</source><br />
<br />
'''GET /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: IngredientDTO i<br />
</source><br />
<br />
'''POST /api/v1/ingredients'''<br />
<source> <br />
Params: PostIngredientDTO ingredientDTO<br />
<br />
Returns: IngredientDTO newIngredient<br />
</source><br />
<br />
'''PUT /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id, PostIngredientDTO ingredientDTO<br />
<br />
Returns: IngredientDTO updatedIngredient<br />
</source><br />
<br />
'''DELETE /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Ratings===<br />
'''GET /api/v1/ratings'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<RatingLogDTO><br />
</source><br />
<br />
'''GET /api/v1/ratings/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: RatingLogDTO dto<br />
</source><br />
<br />
'''POST /api/v1/ratings'''<br />
<source> <br />
Params: RatingLogForEntityDTO ratingDTO<br />
<br />
Returns: RatingLogDTO newRating<br />
</source><br />
<br />
'''PUT api/v1/ratings/{id}'''<br />
<source> <br />
Params: int id, RatingLogForEntityDTO ratingDTO<br />
<br />
Returns: RatingLogDTO updatedRating<br />
</source><br />
<br />
'''DELETE api/v1/ratings/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===RequestLog===<br />
'''GET: api/v1/usageData/{userId}'''<br />
<source> <br />
Params: string userId<br />
<br />
Returns: List<RequestLogDTO><br />
</source><br />
<br />
== Lõpptoote kasutusjuhend ==<br />
<br />
* Kloonida kohalikku arvutisse repository aadressilt [https://github.com/sikumiku/TaisKohtApi https://github.com/sikumiku/TaisKohtApi]<br />
* Installida NodeJS<br />
* <source>npm install webpack -g</source><br />
* <source>npm install -cli -g</source><br />
* Frontend rakenduse kasutamiseks valida Startup meetoditest IIS Express, veebiteenuse ja Swaggeri kasutamiseks käivitada Api Swagger<br />
* Esimese admin kasutaja loomiseks tuleb kasutaja registreerida admin@gmail.com e-mailiga<br />
<br />
== XML/XSD/XSLT ==<br />
<br />
=== XML ===<br />
<br />
<source><?xml version="1.0" encoding="utf-8" ?><br />
<?xml-stylesheet type="text/xsl" href="XMLFileXML.xslt"?><br />
<restaurants><br />
<restaurant id="1" url="https://kuuspelmeeni.ee" contactnumber="507783342" email="kuuspelmeeni@gmail.com"><br />
<name><![CDATA[Kuus Pelmeeni]]></name><br />
<menus><br />
<menu id="1" repetitioninterval="30"><br />
<name><![CDATA[Päevamenüü]]></name><br />
<activefrom>2018-05-27T12:00:00</activefrom><br />
<activeto>2018-05-28T12:00:00</activeto><br />
<dishes><br />
<dish id="1" vegan="false" lactosefree="false" glutenfree="false" daily="true" kcal="550" dailyprice="4"><br />
<title><![CDATA[8 pelmeeni]]></title><br />
<description><![CDATA[8 pelmeeni 6 asemel serveeritud tervisliku koguse hapukoore ja tilliga]]></description><br />
<availablefrom>2018-05-27T12:00:00</availablefrom><br />
<availableto>2018-05-28T12:00:00</availableto><br />
<ingredients><br />
<ingredient id="1" amountunit="g"><br />
<name>Sealiha</name><br />
<description>Rakvere sealiha</description><br />
</ingredient><br />
<ingredient id="2" amountunit="g"><br />
<name>Hapukoor</name><br />
<description>Alma hapukoor</description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="9"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Parim päevaroog viimasel ajal.]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
</comments><br />
</rating><br />
<promotion id="1" type="visual" classname="bold-red-border-2px"><br />
<name>2px red border</name><br />
<description><![CDATA[Displays a 2px wide red border around the component that is promoted.]]></description><br />
<validto>2018-06-25T12:00:00</validto><br />
</promotion><br />
</dish><br />
<dish id="2" vegan="true" lactosefree="true" glutenfree="true" daily="true" kcal="320" price="4"><br />
<title><![CDATA[Kurgisalat]]></title><br />
<description><![CDATA[Erinevatel viisidel töödeldud kurk serveeritud koos jõhvikatega. Tervislik amps.]]></description><br />
<availablefrom>2018-05-27T12:00:00</availablefrom><br />
<availableto>2018-05-28T12:00:00</availableto><br />
<ingredients/><br />
<rating ratingvalue="4"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Jäin veel väga näljaseks peale selle söömist.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
</dishes><br />
</menu><br />
<menu id="2"><br />
<name><![CDATA[Põhimenüü]]></name><br />
<dishes><br />
<dish id="4" vegan="false" lactosefree="false" glutenfree="false" daily="false" kcal="550" price="5"><br />
<title><![CDATA[6 pelmeeni]]></title><br />
<description><![CDATA[6 pelmeeni serveeritud tervisliku koguse hapukoore ja tilliga]]></description><br />
<ingredients><br />
<ingredient id="1" amountunit="g"><br />
<name>Sealiha</name><br />
<description>Rakvere sealiha</description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="9.5"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Käin seda iga päev söömas.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Parim toit selles restoranis.]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
<dish id="5" vegan="false" lactosefree="false" glutenfree="true" daily="false" kcal="460" price="3.8"><br />
<title><![CDATA[Kartulisalat]]></title><br />
<description><![CDATA[Sinki sisaldav traditsiooniline kartulisalat.]]></description><br />
<ingredients/><br />
</dish><br />
<dish id="6" vegan="false" lactosefree="false" glutenfree="false" daily="false" kcal="610" price="3.9"><br />
<title><![CDATA[Šokolaadikook]]></title><br />
<description><![CDATA[Ahvatlev glasuuritud šokolaadikook.]]></description><br />
<ingredients/><br />
<rating ratingvalue="7.8"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Šokolaadikooki on keeruline metsa keerata.]]></commenttext><br />
<username>mutikas3</username><br />
<userid>3a29b94a-3f17-469d-a44d-f7d85e98dd3e</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
</dishes><br />
</menu><br />
</menus><br />
<dishes/><br />
<address id="1" country="Eesti"><br />
<addressfirstline>Tatari 12</addressfirstline><br />
<locality>Tallinn</locality><br />
<postcode>10132</postcode><br />
<region>Harjumaa</region><br />
</address><br />
<promotion/><br />
<rating ratingvalue="7.5"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Parim restoran üldse!]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Ma sain ainult 5 pelmeeni. Ootasin kuute.]]></commenttext><br />
<username>kyllikekallike1</username><br />
<userid>6af271dd-0e11-4ae6-98be-111762664318</userid><br />
</comment><br />
</comments><br />
</rating><br />
</restaurant><br />
<restaurant id="2" url="https://kolmkokka.ee" contactnumber="6522351" email="kolmkokka@gmail.com"><br />
<name><![CDATA[Kolm kokka]]></name><br />
<menus/><br />
<dishes><br />
<dish id="7" vegan="false" lactosefree="true" glutenfree="false" daily="false" kcal="470" price="14"><br />
<title><![CDATA[Ahjulõhe juurikatega]]></title><br />
<description><![CDATA[Ahjulõhe serveeritud püreestatud porgandite ja lillkapsaga.]]></description><br />
<ingredients><br />
<ingredient id="11" amountunit="tk" amount="1"><br />
<name>Ahjulõhe</name><br />
<description><![CDATA[Värske ahjulõhe]]></description><br />
</ingredient><br />
<ingredient id="12" amountunit="g"><br />
<name>Püreestatud porgand</name><br />
<description><![CDATA[Eesti porgand, mis on kergelt püreestatud]]></description><br />
</ingredient><br />
<ingredient id="13" amountunit="g"><br />
<name>Püreestatud lillkapsas</name><br />
<description><![CDATA[Eesti lillkapsas, mis on kergelt püreestatud ja maitsestatud]]></description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="8.9"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Kindlasti minu üks lemmikuid.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Pole midagi halba öelda.]]></commenttext><br />
<username>tiiuviiu</username><br />
<userid>0730a7b7-3a9c-4e26-962f-da9a8daeab8a</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
<dish id="8" vegan="true" lactosefree="true" glutenfree="true" daily="true" dailyprice="5"><br />
<title><![CDATA[Ingverisupp]]></title><br />
<description><![CDATA[Ingveriga vürtsistatud ingverisupp, mis viib keele alla.]]></description><br />
<availablefrom>2018-05-25T12:00:00</availablefrom><br />
<availableto>2018-06-25T12:00:00</availableto><br />
<ingredients><br />
<ingredient id="14" amountunit="g" amount="20"><br />
<name>Ingver</name><br />
<description><![CDATA[Tükeldatud ingver]]></description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="6"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Liiga palju ingverit.]]></commenttext><br />
<username>kyllikekallike1</username><br />
<userid>6af271dd-0e11-4ae6-98be-111762664318</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
<dish id="9" vegan="false" lactosefree="false" glutenfree="true" daily="false" kcal="340" price="4.5"><br />
<title><![CDATA[Apelsinijäätis]]></title><br />
<description><![CDATA[Apelsinimaitseline jäätis serveeritud riivitud apelsinikoorega.]]></description><br />
<ingredients/><br />
<rating ratingvalue="8"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Väga huvitav magustoit, prooviks veel.]]></commenttext><br />
<username>mutikas3</username><br />
<userid>3a29b94a-3f17-469d-a44d-f7d85e98dd3e</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Üks mu lemmikuid magustoite.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
</dishes><br />
<address id="2" country="Eesti"><br />
<addressfirstline>Laia 12</addressfirstline><br />
<locality>Tallinn</locality><br />
<postcode>13022</postcode><br />
<region>Harjumaa</region><br />
</address><br />
<promotion/><br />
<rating ratingvalue="8.1"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Hinnad on natuke liiga kallid minu jaoks, aga toit om maitsev.]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Ma kindlasti telliks kala uuesti. Väga mahlakas oli.]]></commenttext><br />
<username>kyllikekallike1</username><br />
<userid>6af271dd-0e11-4ae6-98be-111762664318</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Asukoht oli päris tore. Miljöö ka.]]></commenttext><br />
<username>mutikas3</username><br />
<userid>3a29b94a-3f17-469d-a44d-f7d85e98dd3e</userid><br />
</comment><br />
</comments><br />
</rating><br />
</restaurant><br />
</restaurants></source><br />
<br />
=== XSD ===<br />
<br />
<source><?xml version="1.0" encoding="utf-8"?><br />
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema"><br />
<xs:element name="restaurants"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="restaurant"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="menus"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="menu"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="activefrom" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="activeto" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="dishes"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="dish"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="title" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="availablefrom" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="availableto" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="servetime" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="ingredients"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="ingredient"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="amountunit" type="xs:string" use="required" /><br />
<xs:attribute name="amount" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="rating" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="comments"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="comment"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="commenttext" type="xs:string" /><br />
<xs:element name="username" type="xs:string" /><br />
<xs:element name="userid" type="xs:string" /><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="ratingvalue" type="xs:decimal" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="validto" type="xs:dateTime" minOccurs="0" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="type" type="xs:string" use="required" /><br />
<xs:attribute name="classname" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="vegan" type="xs:boolean" use="optional" /><br />
<xs:attribute name="lactosefree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="glutenfree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="daily" type="xs:boolean" use="optional" /><br />
<xs:attribute name="kcal" type="xs:int" use="optional" /><br />
<xs:attribute name="weightg" type="xs:decimal" use="optional" /><br />
<xs:attribute name="price" type="xs:decimal" use="optional" /><br />
<xs:attribute name="dailyprice" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="validto" type="xs:dateTime" minOccurs="0" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="type" type="xs:string" use="required" /><br />
<xs:attribute name="classname" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="repetitioninterval" type="xs:int" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="dishes"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="dish"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="title" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="availablefrom" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="availableto" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="servetime" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="ingredients"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="ingredient"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="amountunit" type="xs:string" use="required" /><br />
<xs:attribute name="amount" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="rating"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="comments"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="comment"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="commenttext" type="xs:string" /><br />
<xs:element name="username" type="xs:string" /><br />
<xs:element name="userid" type="xs:string" /><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="ratingvalue" type="xs:decimal" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="validto" type="xs:dateTime" minOccurs="0" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="type" type="xs:string" use="required" /><br />
<xs:attribute name="classname" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="vegan" type="xs:boolean" use="optional" /><br />
<xs:attribute name="lactosefree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="glutenfree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="daily" type="xs:boolean" use="optional" /><br />
<xs:attribute name="kcal" type="xs:int" use="optional" /><br />
<xs:attribute name="weightg" type="xs:decimal" use="optional" /><br />
<xs:attribute name="price" type="xs:decimal" use="optional" /><br />
<xs:attribute name="dailyprice" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="address"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="addressfirstline" type="xs:string" /><br />
<xs:element name="locality" type="xs:string" /><br />
<xs:element name="postcode" type="xs:string" /><br />
<xs:element name="region" type="xs:string" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="country" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion" /><br />
<xs:element name="rating" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="comments"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="comment"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="commenttext" type="xs:string" /><br />
<xs:element name="username" type="xs:string" /><br />
<xs:element name="userid" type="xs:string" /><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="ratingvalue" type="xs:decimal" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="url" type="xs:string" use="required" /><br />
<xs:attribute name="contactnumber" type="xs:string" use="required" /><br />
<xs:attribute name="email" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:schema></source><br />
<br />
=== XSLT(HTML) ===<br />
<br />
<source><?xml version="1.0" encoding="utf-8" ?><br />
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:msxsl="urn:schemas-microsoft-com:xslt" exclude-result-prefixes="msxsl"><br />
<xsl:output method="html" indent="yes"/><br />
<xsl:template match="/restaurants"><br />
<html><br />
<head><br />
<title>Täis Kõht</title><br />
</head><br />
<body><br />
<xsl:for-each select="restaurant"><br />
<h1 style="color:DodgerBlue"><br />
<xsl:value-of select="name"/><br />
</h1><br />
<div><br />
<xsl:value-of select="@url"/><br />
</div><br />
<div><br />
<xsl:text>Kontakt number: </xsl:text><br />
<xsl:value-of select="@contactnumber"/><br />
</div><br />
<div><br />
<xsl:text>email: </xsl:text><br />
<xsl:value-of select="@email"/><br />
</div><br />
<div><br />
<xsl:text>Aadress: </xsl:text><br />
<xsl:value-of select="address/addressfirstline"/><br />
<xsl:text>, </xsl:text><br />
<xsl:value-of select="address/locality"/><br />
<xsl:text>, </xsl:text><br />
<xsl:value-of select="address/postcode"/><br />
<xsl:text>, </xsl:text><br />
<xsl:value-of select="address/@country"/><br />
</div><br />
<br />
<xsl:choose><br />
<xsl:when test="menus/menu"><br />
<xsl:for-each select="menus/menu"><br />
<xsl:sort select="name"/><br />
<h3><br />
<xsl:value-of select="name"/><br />
</h3><br />
<br />
<xsl:if test="activefrom != '' and activeto != ''"><br />
<xsl:text> </xsl:text><br />
<xsl:value-of select="substring(activefrom,1,10)"/><br />
<xsl:text> kuni </xsl:text><br />
<xsl:value-of select="substring(activeto,1,10)"/><br />
</xsl:if><br />
<br />
<ul><br />
<xsl:for-each select="dishes/dish"><br />
<xsl:sort select="title"/><br />
<br />
<xsl:if test="availablefrom != '' and availableto != ''"><br />
<xsl:value-of select="substring(availablefrom,1,10)"/><br />
<xsl:text> kuni </xsl:text><br />
<xsl:value-of select="substring(availableto,1,10)"/><br />
</xsl:if><br />
<br />
<li><br />
<span style="font-weight:bold"><br />
<xsl:value-of select="title"/><br />
</span><br />
<xsl:text> - </xsl:text><br />
<xsl:value-of select="description"/><br />
<xsl:text> </xsl:text><br />
<span style="font-weight:bold"><br />
<xsl:if test="@glutenfree='true'"><br />
<xsl:text>G </xsl:text><br />
</xsl:if><br />
<xsl:if test="@lactosefree='true'"><br />
<xsl:text>L </xsl:text><br />
</xsl:if><br />
<xsl:if test="@vegan='true'"><br />
<xsl:text>V </xsl:text><br />
</xsl:if><br />
</span><br />
</li><br />
<br />
<xsl:for-each select="ingredients/ingredient"><br />
<xsl:value-of select="name"/><br />
<xsl:if test="position()!=last()"><br />
<xsl:text>, </xsl:text><br />
</xsl:if><br />
</xsl:for-each><br />
<br />
<p style="font-weight:bold"><br />
<xsl:text>Hind: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="@price!=''"><br />
<xsl:value-of select="@price"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>-</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
<xsl:text> / Päevapakkumise hind: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="@dailyprice!=''"><br />
<xsl:value-of select="@dailyprice"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>-</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
</p><br />
<br />
<div style="background-color:LightGray;"><br />
<xsl:text>Hinnang praele: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="rating/@ratingvalue!=''"><br />
<xsl:value-of select="rating/@ratingvalue"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>Ei ole veel hinnatud!</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
<br />
<br/><br />
<xsl:for-each select="rating/comments/comment"><br />
<xsl:value-of select="username"/><br />
<xsl:text>: </xsl:text><br />
<xsl:value-of select="commenttext"/><br />
<br/><br />
</xsl:for-each><br />
</div><br />
<br/><br />
</xsl:for-each><br />
</ul><br />
</xsl:for-each><br />
</xsl:when><br />
<xsl:otherwise><br />
<ul><br />
<xsl:for-each select="dishes/dish"><br />
<xsl:sort select="title"/><br />
<br />
<xsl:if test="availablefrom != '' and availableto != ''"><br />
<xsl:value-of select="substring(availablefrom,1,10)"/><br />
<xsl:text> kuni </xsl:text><br />
<xsl:value-of select="substring(availableto,1,10)"/><br />
</xsl:if><br />
<br />
<li><br />
<span style="font-weight:bold"><br />
<xsl:value-of select="title"/><br />
</span><br />
<xsl:text> - </xsl:text><br />
<xsl:value-of select="description"/><br />
<xsl:text> </xsl:text><br />
<span style="font-weight:bold"><br />
<xsl:if test="@glutenfree='true'"><br />
<xsl:text>G </xsl:text><br />
</xsl:if><br />
<xsl:if test="@lactosefree='true'"><br />
<xsl:text>L </xsl:text><br />
</xsl:if><br />
<xsl:if test="@vegan='true'"><br />
<xsl:text>V </xsl:text><br />
</xsl:if><br />
</span><br />
</li><br />
<br />
<xsl:for-each select="ingredients/ingredient"><br />
<xsl:value-of select="name"/><br />
<xsl:if test="position()!=last()"><br />
<xsl:text>, </xsl:text><br />
</xsl:if><br />
</xsl:for-each><br />
<br />
<p style="font-weight:bold"><br />
<xsl:text>Hind: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="@price!=''"><br />
<xsl:value-of select="@price"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>-</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
<xsl:text> / Päevapakkumise hind: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="@dailyprice!=''"><br />
<xsl:value-of select="@dailyprice"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>-</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
</p><br />
<br />
<div style="background-color:LightGray;"><br />
<xsl:text>Hinnang praele: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="rating/@ratingvalue!=''"><br />
<xsl:value-of select="rating/@ratingvalue"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>Ei ole veel hinnatud!</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
<br />
<br/><br />
<xsl:for-each select="rating/comments/comment"><br />
<xsl:value-of select="username"/><br />
<xsl:text>: </xsl:text><br />
<xsl:value-of select="commenttext"/><br />
<br/><br />
</xsl:for-each><br />
</div><br />
<br/><br />
</xsl:for-each><br />
</ul><br />
</xsl:otherwise><br />
</xsl:choose><br />
<br />
<div style="background-color:LightGray;"><br />
<xsl:text>Hinnang restoranile: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="rating/@ratingvalue!=''"><br />
<xsl:value-of select="rating/@ratingvalue"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>Ei ole veel hinnatud!</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
<br />
<br />
<br/><br />
<xsl:for-each select="rating/comments/comment"><br />
<xsl:value-of select="username"/><br />
<xsl:text>: </xsl:text><br />
<xsl:value-of select="commenttext"/><br />
<br/><br />
</xsl:for-each><br />
</div><br />
<br />
<p><br />
<xsl:text>*G - gluteenivaba, </xsl:text><br />
<xsl:text>L - laktoosivaba, </xsl:text><br />
<xsl:text>V - vegan </xsl:text><br />
</p><br />
<br />
</xsl:for-each><br />
</body><br />
</html><br />
</xsl:template><br />
</xsl:stylesheet></source><br />
<br />
=== XSLT(XML) ===<br />
<br />
XML'is kuvatakse elemendid ja atribuudid eesti keeles. Kuvatakse restorani andmed ja toidud, mille hinnang on 8 või rohkem punkti.<br />
<br />
<source><?xml version="1.0" encoding="utf-8" ?><br />
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"<br />
xmlns:msxsl="urn:schemas-microsoft-com:xslt" exclude-result-prefixes="msxsl"><br />
<xsl:output method="xml" indent="yes"/><br />
<br />
<xsl:template match="/restaurants"><br />
<restoranid><br />
<xsl:for-each select="restaurant"><br />
<restoran url="{@url}" telefon="{@contactnumber}" email="{@email}"><br />
<nimi><br />
<xsl:value-of select="name"/><br />
</nimi><br />
<aadress><br />
<postiaadress><br />
<xsl:value-of select="address/addressfirstline"/><br />
</postiaadress><br />
<linn><br />
<xsl:value-of select="address/locality"/><br />
</linn><br />
<indeks><br />
<xsl:value-of select="address/postcode"/><br />
</indeks><br />
<riik><br />
<xsl:value-of select="address/@country"/><br />
</riik><br />
</aadress><br />
<br />
<parimadToidud><br />
<xsl:choose><br />
<xsl:when test="menus/menu/dishes/dish"><br />
<xsl:for-each select="menus/menu/dishes/dish"><br />
<xsl:if test="rating/@ratingvalue &gt;= 8.0"><br />
<heaToit hinnang="{rating/@ratingvalue}" paevaPakkumiseHind="{@dailyprice}" hind="{@price}" <br />
vegan="{@vegan}" laktoosivaba="{@lactosefree}" gluteenivaba="{@glutenfree}"><br />
<nimi><br />
<xsl:value-of select="title"/><br />
</nimi><br />
<kirjeldus><br />
<xsl:value-of select="description"/><br />
</kirjeldus><br />
</heaToit><br />
</xsl:if><br />
</xsl:for-each><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:for-each select="dishes/dish"><br />
<xsl:if test="rating/@ratingvalue &gt;= 8.0"><br />
<heaToit hinnang="{rating/@ratingvalue}" paevaPakkumiseHind="{@dailyprice}" hind="{@price}" <br />
vegan="{@vegan}" laktoosivaba="{@lactosefree}" gluteenivaba="{@glutenfree}"><br />
<nimi><br />
<xsl:value-of select="title"/><br />
</nimi><br />
<kirjeldus><br />
<xsl:value-of select="description"/><br />
</kirjeldus><br />
</heaToit><br />
</xsl:if><br />
</xsl:for-each><br />
</xsl:otherwise><br />
</xsl:choose><br />
</parimadToidud><br />
</restoran><br />
</xsl:for-each><br />
</restoranid><br />
</xsl:template><br />
</xsl:stylesheet><br />
</source><br />
<br />
== Retsensioonid ==<br />
<br />
=== Veebiteenuse retsensioon meeskonnale [https://wiki.itcollege.ee/index.php/MOT MOT] ===<br />
<br />
* Puudub README vms. Dokumentatsioon projekti ülespanemiseks ja seadistamiseks.<br />
* Rollide loomine vigane, seda võiks teha eraldi failis, mis on DAL.App.EF projektis (kasutasime algul sama lähenemist nagu antud projekt). Takistab esialgset andmebaasi uuendust, kui rollid veel puuduvad. Rakenduse installimine tarnitud kujul ei õnnestunud. Selleks et Nuget Package Manageri käsk Update-Database töötaks pidi ajutiselt välja kommenteerima Startup.cs faili rea 153 (// CreateRoles(services).Wait();).<br />
==== Andmebaasist: ====<br />
* Üldiselt paneksin igale väljale juurde AddTime ja UpdateTime see on hea tava millest korduvalt ka andmebaasi alustes räägiti ja rõhutati.<br />
==== Olemitest: ====<br />
* Kui juba domainis nimetate kõik olemid singulaarselt siis võiks ju sama teha ka andmebaasis - lisakeerukuse loomine kohas kus see ei ole vajalik.<br />
* Entity-te arv oli nõutust väiksem - Kokku 8 olemit, millest 1 on many-to-many liittabel ja 1 otsene koopia Identity framework Users tabelist. <br />
* Olem People ~= Users ja sisaldab ka viidet Identity tabelile ApplicationUsers (ApplicationUserId). Juhul kui see on mõeldud rakendusega mitte registreerunud kasutajate võistlusele kirja panemiseks, siis oleks olemil rohkem infot vaja - vähemalt mingigi kontakti väli (email |/& tel.nr. |/& aadress).<br />
* Competition.Comment on varchar(100) - võiks ja peaks olema varchar(1000)<br />
* Competition.CompetitionPlaceId - kui võistluse toimumiskoht mingil põhjusel peaks keelduma korraldusest või kui võistlust alles pannakse kokku ja ei ole veel teada kus see toimuma saab siis mis peaks sinna sisestama (NOT NULL => NULL)<br />
* Competition.Time -> Mis aega see näitab? Property nimest seda välja ei loe. Kui StartTime, siis kus on EndTime või Duration?<br />
* CompetitionPlace.County -> int type enum default väärtus on 0, kuna see pole aga enumi klassis implementeeritud põhjustab see vea. (Millisele maakonnale vastab 0?) See teada tuntud probleem millele google annab hõlpsasti erinevaid lahendusi: näiteks [https://stackoverflow.com/questions/24350377/entity-framework-6-code-first-required-enum-data-type-not-working?utm_medium=organic&utm_source=google_rich_qa&utm_campaign=google_rich_qa siin] ja [https://stackoverflow.com/questions/529929/choosing-the-default-value-of-an-enum-type-without-having-to-change-values/529937?utm_medium=organic&utm_source=google_rich_qa&utm_campaign=google_rich_qa siin].<br />
* Väljad mis viitavad Identity framework olemitele läbi nende ID-de ei peaks olema nvarchar(max) vaid nvarchar(450) (kuigi isegi see on reaalsuses liiga pikk).<br />
* PersonInTeam.PersonInTeamId -> ei peaks olema sellist välja üldse, selle tabeli PK peaks olema kombinatsioon nende tabeli ID-st mida ta ühendab. Praegu ei ole unique indeksit üle nende, mis tähendab et sama inimene saab mitu korda sama tiimiga liituda.<br />
* Participations - Miks selline nimi, kui registreerimine juba oli? Saan aru et selles olemis tahetakse säilitada võistluse tulemusi. Siis võiks ju juba olla CompetitionResults. Kus on aga saavutatud koha numbri talletamine? Kui võistluse punktid ja ajad on kõik kirja saadud siis tahaks ju tulemusi ka kuidagi näha ja võrrelda ning selle võrdluse tulemi kuhugi salvestada.<br />
* Participations.Time - Mis aega näitab? Eeldan, et võistluse läbimise aega? Kui nii, siis miks ei ole NULL lubatud - mõnedel võistlustel aega ju ei mõõdeta?<br />
* Participation.Points - Kas igal võistlusel antakse ainult täisarv punkte (int)? Võiks igaks juhuks siiski implementeerida double väärtuse tüübi. Lisaks ei ole võimalik osalust luua ilma punkte teadmata - peaks siis määrama default väärtus. Mõnede võistluste puhul jälle punkte ei anta vaid mõõdetakse aega.<br />
* Participation.Disqualified - Nullid ei ole lubatud -> järelikult oleks default väärtust vaja.<br />
* Registrations - Projekti Must have alla on märgitud “Osaleja saab registreerida võistlusele meeskonda” kuid olemis puudub TeamsId ning samuti ei ole seda võimalust kuidagi läbi Servicei implementeeritud.<br />
* Registrations - Millal registreering tehti on suhteliselt tähtis teada. Paljude võistluste puhul sõltub sellest näiteks registreerimistasu. <br />
==== DTO-d: ====<br />
* Täiesti mõttetult sisse toodud kiht, lihtsalt selleks et nii oli ette nähtud. Kõik DTO-d konverteeritakse ümber 1:1-le Domain objektideks ja vastupidi.<br />
* Üldiselt oleks vaja teha tööd veel DTOdega, et need rohkem peegeldaksid oma kasutust. Näiteks:<br />
** küsides kõiki võistlusi, kas meil on tarvis avalikustada kliendile, mis on kasutaja ID, kes iga võistluse lõi? DTOsid võiks olla rohkem erinevate kasutusjuhtumite jaoks. <br />
** CompetitionDTO võiks sisaldada ka nimekirja võistlejatest, kus koondatakse info ManyToMany seoste põhjal kasutades vahetabelit, nagu näiteks:<br />
<source><br />
List<PersonDTO> people = c.Participation<br />
.FindAll(p => p.CompetitionId == c.CompetitionId)<br />
.Select(PersonDTO.CreateFromParticipation)<br />
.ToList();<br />
</source><br />
<br />
==== API Kontrolleritest: ====<br />
* Puudub Swagger startup konfiguratsioon, Swagger annotatsioonid kaotavad mõtte ning pole võimalik kontrollida, kas need on korrektselt loodud.<br />
* ProducesResponse annotatsiooni pole kusagile lisatud, staatuskoodid on natuke poolikult läbi mõeldud, vähemalt need, mida Swaggeri raames mainitud on<br />
*Annotatsioon Authorize, kus on ära määratud AuthorizationScheme peaks minema kogu klassi peale, meetodis saab ära määrata vaid selle, mis rollid on lubatud.<br />
* AccountController<br />
** Response code uue kasutaja loomisel võiks olla 201<br />
** Puuduvad koodid nagu 429, 500<br />
** Registreerumisel võiks kontrollida, kas kasutaja on juba olemas, mitte vaid rolli olemasolu<br />
** Kas kasutajal ei või antud kontekstis olla mitu rolli? Sisselogimisel võetakse rollide seast vaid esimene ja lisatakse juurde Claimile. Võimalus kirjutada ka meetod, mis lisab kasutajale kõik rollid.<br />
** CompetitionPlacesController/CompetitionsController/CompetitionTypesController/ParticipationsController/RegistrationsController/TeamsController. Antud kontrollerid on kõik väga sarnase loogikaga<br />
** Get() tagastab vaid koodi 200, tagastuskoodi võimalusi on veel<br />
** Post() meetod küsib sisse DTOd, mille üheks parameetriks on id, id genereeritakse automaatselt, seda ei peaks panema kaasa postitatavasse mudelisse, mis alles loob objekti<br />
** Put() puhul sama kriitika, siin on id küll vajalik, aga see juba pannakse kaasa parameetrina eraldi<br />
** See tundub natuke veidrana üritada kontrollida uuendatud mudeli põhjal, kas tegemist oli BadRequestiga. Eelkõige peaks id puhul üles otsima, kas antud objekt on üldse olemas ja seejärel üritada uuendada, muidu tagastada BadRequest. Kui see ei õnnestu, siis peaks juba errorkood 500 peegeldama seda, et midagi läks teenuse poole peal valesti. <br />
** Sama kommentaar deletemise kohta, enne tuleks kontrollida, kas objekt on olemas. Siis alles objekt kustutada.<br />
* PeopleController<br />
** Kas tõepoolest igaüks saab pärida infot inimeste kohta ja neid postitada? <br />
* PersonInTeamsController <br />
** API disaini poole pealt on natuke veider teha vahetabelite kohta kontroller. Tundub loogilisem panna antud kontrolleri meetodid teistesse kontroleritesse, mis on seotud siis kas meeskondade või inimestega. Näiteks küsida ** PeopleControlleris kõik inimesed, kes on meeskondades või küsida neid meeskonna järgi. TeamsControlleris seevastu anda võimalus lisada uusi inimesi meeskonda, neid muuta või eemaldada.<br />
Id järgi ei hakka ükski klient küsima vahetabeli kohta infot, see tundub otstarbetu tegevus, pigem küsida kas meeskonna või inimese id järgi sissekandeid<br />
* Kriitika kontrollerite kohta: kontrollerid enamuses pöörduvad vaid spetsiifiliste domeenide poole ja viivad ellu väga tavalist CRUD funktsionaalsust, mille tõttu tundub, et need on natuke veel toored. Näiteks on välja toodud “must have” nimekirjas projekti analüüsis, et meeskonna liige peaks saama muuta meeskonna andmeid. Antud kontrollerites vaid autentitakse, et kasutaja oleks rollis “participant”, kuid mitte seda, kas ta ka muudetava meeskonna liige on. Samuti pole võimalik kasutajatel näha, palju on mingile võistlusele osalejaid registreerunud, CompetitionsController ei tegele sellega, et tagastada võistlusele registreerunud kasutajaid, selle asemel on olemas ParticipationsController, mis tagastab vahetabeli infot selle kohta, mis võistlusega on seotud mis inimene. See võib olla tohutult suur info, mida hakata filtreerima kliendi poolelt. Rohkem tuleks teha andmete agregeerimist vastavalt teenuse kontekstile.<br />
<br />
==== Projekti kihid/struktuur: ====<br />
* Olemas Business Logic, Data Access Layer, DTO’d, Service’id, Unit of Work, domeeniklassid ning API spetsiifilised kontrollerid, mis asuvad oma kaustas põhiprojekti all . DAL omab erinevaid kihte interface’ide ja neid implementeerivate klasside jaoks. Repositooriumitega suhtlemine on abstraktne, kõik käib läbi Data Access Layer’i, mille pööle pöörduvad teenuseklassid ning DAL erinevad kihid hoolitsevad selle eest, et loodaks õiget tüüpi repositooriumeid, andmeid agregeeritakse, uuendatakse ja salvestatakse organiseeritud kujul ning neid tagastatakse teenustele soovitud kujul (DTOd).<br />
<br />
== Logiraamat ==<br />
<br />
===07.02.2018===<br />
Gupi loomine ning suhtluskanali seadistamine<br />
<br />
=== 24.03.2018 ===<br />
Trello boardi loomine<br />
<br />
=== 25.03.2018 ===<br />
Wiki lehe loomine. Esimene tõsisem projekti koosolek ning tegevuskava paika panemine.<br />
<br />
=== 26.03.2018 ===<br />
<br />
Alustasime veebiteenuse analüüsiga ja funktsionaalsuse kirjeldamisega.<br />
<br />
=== 27.03.2018 ===<br />
Täiendasime veebiteenuse analüüsi.<br />
<br />
Esmase andmebaasi mudeli koostamine.<br />
<br />
Postitatud esimeste analüüsi arutelude põhjal valminud algne prototüüp.<br />
<br />
=== 30.03.2018 ===<br />
Valmis andmebaasimudel.<br />
<br />
=== 08.04.2018 ===<br />
Tehtud muudatused analüüsis vastavalt tagasisidele.<br />
<br />
=== 19.04.2018 ===<br />
Loodud projekti põhi koos domeenimudelitega. Projekt lisatud Githubi: https://github.com/sikumiku/TaisKohtApi<br />
<br />
=== 05-06.05.2018 ===<br />
Osalesime hackathonil. Lisatud controllerid, service'id koos vajalike kihtidega.<br />
<br />
=== 16.05.2018 ===<br />
Uuendatud andmebaasimudelit, DTO'sid.<br />
<br />
=== 18-19.05.2018 ===<br />
Lisatud klientrakendus, security, äriloogikat.<br />
<br />
=== 20.05.2018 ===<br />
Lisatud API dokumentatsioon.<br />
<br />
=== 22-24.05.2018 ===<br />
Uuendatud contoller'eid, service'id.<br />
<br />
=== 25-27.05.2018 ===<br />
Uuendatud contoller'eid, service'id. Lisatud kasutajate ja rollide kontrolle meetoditesse. Täiustatud klientrakendust. Swagger dokumentatsioon.<br />
<br />
=== 31.05-01.06.2018 ===<br />
Tegeletud XML, XSD ja XSLT failide loomisega.<br />
<br />
=== 02.06-03.06.2018 ===<br />
Tegeletud XML ja XSLT failide täiustamisega ja retsensioonide kirjutamisega.</div>
Saasma
https://wiki.itcollege.ee/index.php?title=BeerPressure&diff=131180
BeerPressure
2018-06-03T20:42:22Z
<p>Saasma: /* Retsensioonid */</p>
<hr />
<div>== Meeskond ja rollid ==<br />
<br />
* Sigrid Aasma (arendaja)<br />
* Evelin Jõgi (arendaja)<br />
* Martin Kask (projektijuht, arendaja)<br />
* Marko Nõu (arendaja)<br />
<br />
== Idee ==<br />
'''Toidukohtade põhimenüüde ja päevapakkumiste teenus'''<br />
<br />
Soovime pakkuda toidukohtade põhimenüüde ja päevapakkumiste teenust. On olemas mitmeid kodulehti “päevapakkumised”, kus on kirjas toidukohtade päevapraed. Kuid tavaliselt sellistel lehtedel ei ole masinloetavaid andmeid ehk siis varianti, et saad saata API pihta mingi kuupäeva koos päevapraadidega andmete uuendamiseks ja saad sama API käest küsida tänaseid päevapraade. Andmeid võiks saada küsida restorani, kuupäeva, asukoha või otsisõna/otsisõnaosa põhiselt. Selline teenus lihtsustaks ka toidukohtade päevapakkumiste haldamist, kuna praegu peavad teenuse pakkujad vastavat informatsiooni uuendama mitmes erinevas kohas - nii erinevates portaalides, kui ka enda veebileheküljel. Samuti oleks toidukohtade kogu menüü haldamine ühes kohas.<br />
<br />
=== Esialgne prototüüp ===<br />
<br />
[[File:TäisKõhtProto1.mp4]]<br />
<br />
Esialgne prototüüp: [http://enos.itcollege.ee/~saasma/VR2/Proto/K%C3%B5htT%C3%A4is/#g=1&p=home navigeeritav versioon vol.1]<br />
<br />
=== Prototüübi muutus projekti käigus ===<br />
<br />
Prototüüp: [http://enos.itcollege.ee/~saasma/VR2/Proto/T%C3%A4isK%C3%B5ht/K%C3%B5htT%C3%A4is/#g=1&p=home navigeeritav versioon vol.2]<br />
<br />
== Kasutatav arendustehnoloogia ==<br />
<br />
Veebiteenuse loomisel kasutame ASP.NET Core tehnoloogiat ja kursusel õpitud arendusmustreid.<br />
<br />
Klientrakenduse loomisel kasutame Node.js + React'i.<br />
<br />
== Veebiteenuse analüüs ==<br />
Pakume toidukohtade põhimenüüde ja päevapakkumiste teenust, kuhu on kokku koondatud erinevate toidukohtade menüüd üle Eesti. Põhimenüü alla kuuluvad pikaajalised menüüd, mis kehtivad püsivalt, hooajaliselt või mingil konkreetsel nädalapäeval. Päevapakkumiste alla kuuluvad konkreetse kuupäevaga seotud päevapakkumised. Päevapakkumiste korral kuvatakse lisainfona, kas pakkumine kehtib mingis konkreetses ajavahemikus või kogu toidukoha lahtioleku aja.<br />
<br />
Eesmärk on koguda ühte kohta kokku erinevate toidukohtade menüüd ja päevapakkumised, et kliendid saaksid mugavalt ja kiiresti oma valikuid teha. Kliendid käivad enamasti päevapakkumisi söömas lõuna ajal ja selleks ettenähtud aeg on piiratud. Sellepärast on oluline, et klient saaks teha oma valiku võimalikult kiiresti. Tänu loodavale veebiteenusele ei pea kliendid käima erinevates portaalides, et tutvuda erinevate toidukohtade pakkumistega. Kuna teenust on mugav kasutada ja klient saab oma valiku kiiresti tehtud, siis tõenäoliselt teeb klient valiku selles keskkonnas olevate toiduasutuste seast. Lisaks võimaldab teenus toiduasutustel paika panna oma pikaajalisem põhimenüü ning seda rakenduses ja võimalusel ka söögikohas kuvada. Sellepärast on ka toidukohtade huvi antud keskkonnas üleval olla ja meiega oma andmeid jagada, sest see suurendab nende klientuuri ning muudab oma menüü haldamise kergemaks.<br />
<br />
Veebiteenuse loomisel lähtume eelkõige sellest, et kliendil oleks teenust mugav kasutada ja ta saaks oma valiku kiiresti tehtud. Arvestame, et kliendid on erinevad. Mõni eelistab mõnda kindlat toidukohta, sel juhul saab ta valida oma soovitud kohad ja võrrelda nende kohtade tänase päeva pakkumisi ning menüüsid. Mõnele inimesele on oluline pakutav söök ja ta eelistab pakkumist otsida prae nimetuses oleva sõna või sõnaosa järgi ning lähtuda seejärel valiku tegemisel toidukoha keskmisest hindest või toidu hinnast. Mõne kliendi jaoks on oluline hind ja selleks, et oma valikut teha sobivas hinnavahemikus on tal võimalik sisestada maksimum hinna piirang. Kindlasti on antud teenuse juures kõikide klientide jaoks oluline päevapakkumiste asukohapõhine eristatus. Kliendid, kes soovivad oma konto luua, võivad oma eelistatud valikud meelde jätta ja järgmisel korral kuvatakse neid talle automaatselt.<br />
<br />
Teenuse must-have funktsionaalsus tagab teenuse toimimise ja põhifunktsioonid. Teenuse nice-to-have funktsionaalsus annab rakendusele lisandväärtust.<br />
<br />
Arvestades pakutava teenusega, siis näeme, et aktiivseim teenuse kasutamine võib olla tööpäevadel vahemikus 11.00-15.00, kui kliendid tutvuvad päevapakkumistega. Teenus peab tekkivale koormusele vastu pidama.<br />
<br />
Teenuse pakkumine peab olema turvaline. Selle tagamiseks tuleb sisestatavaid andmeid valideerida ja andmebaasi sisestavate andmete mahtu piirata. Toidukohtade sisestatud andmed peavad olema kaitstud, et toitude koostised ei saaks avalikuks. Põhjendatud juhtudel on võimalik kasutajaid lukku panna.<br />
<br />
== Kasutajad ==<br />
<br />
<br />
* Admin - lehe administraator, kellel on õigus lehte, kasutajaid ja nende õiguseid hallata. Tema huvi on, et teenus toimiks tõrgeteta.<br />
* Toiduasutus (tasuta kasutaja) - saab hoida lehel ühte põhimenüüd ja päevapakkumisi.<br />
* Toiduasutus (tellimusega kasutaja) - saab hoida lehel piiramatu arv põhimenüüsid ja päevapakkumisi.<br />
Toiduasutused on teenusest huvitatud, et nende menüüde haldamine oleks kerge ja mugav ning nad saaksid oma klientide arvu suurendada.<br />
* Külastaja - klient, kes valib söögikohta. Tema on huvitatud eelkõige sellest, et teenust saaks kasutada mugavalt ja kiirelt ning toidukohtade valik oleks võimalikult suur.<br />
<br />
== Rakenduse must-have funktsionaalsus ==<br />
<br />
* Kasutajad saavad sisse logida<br />
* Kasutajatel on erinevad rollid: admin, toidukoht (tasuta ja tasulise tellimusega), klient<br />
* Kasutajate arvepidamine kasutajate lõikes:<br />
** sisselogimise kuupäev, kellaaeg<br />
** pakkumiste lisamine<br />
** pakkumiste muutmine<br />
** pakkumiste kustutamine<br />
** õiguste kehtimise periood (tasuta ja tellimusega toidukoht)<br />
** pakkumistele klikkimise arv<br />
* Kasutajaid on võimalik hallata:<br />
** kasutajale õiguste andmine (menüüde arvu suurendamine, tellimusega toidukohal), rolli määramine<br />
** Kasutajat on võimalik piirata: õiguseid piirata (piiratud menüüde arv, tasuta liitunud toidukohal) ja lukku panna<br />
* Päevapakkumisi/menüüsid saab küsida: <br />
** toidukoha järgi, <br />
** kuupäeva põhiselt (ainult päevapakkumisi), <br />
** asukoha põhiselt,<br />
** toidu nimetuses esineva otsisõna/otsisõna osa põhiselt,<br />
** hinna põhiselt (max hinna piirang).<br />
* Klientrakenduses realiseeritakse CRUD meetodid (menüüsid/päevapakkumisi saab sisestada, lugeda, uuendada, kustutada)<br />
* Toidukohale saab anda hindeid ja kuvatakse keskmist hinnet.<br />
* Toidule saab anda hindeid ja kuvatakse keskmist hinnet.<br />
<br />
== Nice-to-have funktsionaalsus ==<br />
<br />
* Info selle kohta, kas päevapakkumine on otsas<br />
* Päevapakkumisi/menüüsid saab kommenteerida ja neid kommentaare kuvatakse avalikult.<br />
* Söögikohtade kodulehtedelt otsimise script, mis genereerib juba olemasolevate kodulehtede baasil päevamenüüsid.<br />
* Toiduvaliku piiramine allergeenide/vegan/jms. koostisosade põhiselt.<br />
* Aruandlused ja võrdlused toidukohtadele, et võrrelda end konkurentidega.<br />
* Teenus soovitab toidukohtadele nende varasemate päevapraadide populaarsuse alusel uue nädala menüüd.<br />
* Erinevad toidukohtade/toitude pingeread klientidele, et anda valikuteks ideid.<br />
* Soovitused klientidele, mida teised kliendid sarnaste eelistustega on veel valinud.<br />
<br />
== Andmebaasi ülesehitus - projekti algus ==<br />
<br />
[[File: BeerPressureAndmebaasimudel.png]]<br />
<br />
== Andmebaasi ülesehitus - projekti lõpp ==<br />
<br />
[[File: Ta2isKo6ht-DB-FINAL.png]]<br />
<br />
== Projekti repository ==<br />
<br />
https://github.com/sikumiku/TaisKohtApi<br />
<br />
Zip fail saadaval: <br />
(master branchi viimane commit esitamise ajal)<br />
https://github.com/sikumiku/TaisKohtApi/archive/61438e187a1a972410c8a3bc6274d69489d00aa6.zip<br />
<br />
== API v1 dokumentatsioon ==<br />
<br />
===Security===<br />
'''POST /api/account/register'''<br />
<source><br />
Params: RegisterViewModel registerViewModel<br />
<br />
Returns: token<br />
</source><br />
<br />
'''POST /api/account/login'''<br />
<source> <br />
Params: LoginViewModel model<br />
<br />
Returns: token<br />
</source><br />
<br />
'''POST /api/account/logout'''<br />
<source> <br />
Params: -<br />
<br />
Returns: -<br />
</source><br />
<br />
===Accounts===<br />
'''GET /api/v1/accounts/getAllUsersInRole'''<br />
<source> <br />
Params: string role<br />
<br />
Returns: List<UserDTO><br />
</source><br />
<br />
'''GET /api/v1/accounts/{id}'''<br />
<source> <br />
Params: string id<br />
<br />
Returns: UserDTO<br />
</source><br />
<br />
'''PUT /api/v1/accounts/{id}'''<br />
<source> <br />
Params: string id, UpdateUserDTO userDTO<br />
<br />
Returns: -<br />
</source><br />
<br />
'''POST /api/v1/accounts/addRole'''<br />
<source> <br />
Params: string role<br />
<br />
Returns: -<br />
</source><br />
<br />
'''POST /api/v1/accounts/addRoleToUser'''<br />
<source> <br />
Params: string role, string userId<br />
<br />
Returns: UserDTO<br />
</source><br />
<br />
'''DELETE /api/v1/accounts/deactivate/{id}'''<br />
<source> <br />
Params: string id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Promotions===<br />
'''GET /api/v1/promotions '''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<PromotionDTO> <br />
</source><br />
<br />
'''GET /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: PromotionDTO<br />
</source><br />
<br />
'''POST /api/v1/promotions'''<br />
<source> <br />
Params: PromotionDTO promotionDTO<br />
<br />
Returns: PromotionDTO newPromotion<br />
</source><br />
<br />
'''PUT /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id, PromotionDTO promotionDTO<br />
<br />
Returns: PromotionDTO updatedPromotion<br />
</source><br />
<br />
'''DELETE /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Restaurants===<br />
'''GET /api/v1/restaurants'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<SimpleRestaurantDTO><br />
</source><br />
<br />
'''GET /api/v1/restaurants/search?name=th'''<br />
<source> <br />
Params: string name<br />
<br />
Returns: List<SimpleRestaurantDTO> result<br />
</source><br />
<br />
'''GET /api/v1/restaurants/top'''<br />
<source> <br />
Params: int amount<br />
<br />
Returns: List<SimpleRestaurantDTO> result<br />
</source><br />
<br />
'''GET /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: RestaurantDTO r<br />
</source><br />
<br />
'''POST /api/v1/restaurants/addUserToRestaurant'''<br />
<source> <br />
Params: int id, string userId<br />
<br />
Returns: -<br />
</source><br />
<br />
'''POST /api/v1/restaurants'''<br />
<source> <br />
Params: PostRestaurantDTO restaurantDTO<br />
<br />
Returns: RestaurantDTO newRestaurant<br />
</source><br />
<br />
'''PUT /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id, PostRestaurantDTO restaurantDTO<br />
<br />
Returns: PostRestaurantDTO updatedRestaurantDTO<br />
</source><br />
<br />
'''DELETE /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Menus===<br />
'''GET /api/v1/menus'''<br />
<source><br />
Params: -<br />
<br />
Returns: List<MenuDTO><br />
</source><br />
<br />
'''GET /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: MenuDTO menuDTO<br />
</source><br />
<br />
'''POST /api/v1/menus'''<br />
<source> <br />
Params: PostMenuDTO menuDTO<br />
<br />
Returns: MenuDTO newMenu<br />
</source><br />
<br />
'''PUT /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id, PostMenuDTO menuDTO<br />
<br />
Returns: MenuDTO updatedMenu<br />
</source><br />
<br />
'''PUT api/v1/Menus/{id}/Dishes'''<br />
<source> <br />
Params: int menuId, int[] dishIds<br />
<br />
Returns: -<br />
</source><br />
<br />
'''DELETE /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Dishes===<br />
'''GET /api/v1/dishes'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<DishDTO><br />
</source><br />
<br />
'''GET /api/v1/dishes/daily'''<br />
<source> <br />
Params: bool vegan, bool glutenFree, bool lactoseFree<br />
<br />
Returns: List<SimpleDishDTO> result<br />
</source><br />
<br />
'''GET: api/v1/dishes/search?title=th&priceLimit=null'''<br />
<source> <br />
Params: string title, decimal? priceLimit<br />
<br />
Returns: List<DishDTO> result<br />
</source><br />
<br />
'''GET /api/v1/dishes/top'''<br />
<source> <br />
Params: int amount<br />
<br />
Returns: List<DishDTO> result<br />
</source><br />
<br />
'''GET /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: DishDTO dishDTO<br />
</source><br />
<br />
'''POST /api/v1/dishes'''<br />
<source> <br />
Params: PostDishDTO dishDTO<br />
<br />
Returns: DishDTO newDish<br />
</source><br />
<br />
'''PUT /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id, PostDishDTO dishDTO<br />
<br />
Returns: DishDTO updatedDish<br />
</source><br />
<br />
'''PUT api/v1/Dishes/{id}/Ingredients'''<br />
<source> <br />
Params: int dishId, PostIngredientForDishDTO[] ingredients<br />
<br />
Returns: -<br />
</source><br />
<br />
'''DELETE /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Ingredients===<br />
'''GET /api/v1/ingredients'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<IngredientDTO><br />
</source><br />
<br />
'''GET /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: IngredientDTO i<br />
</source><br />
<br />
'''POST /api/v1/ingredients'''<br />
<source> <br />
Params: PostIngredientDTO ingredientDTO<br />
<br />
Returns: IngredientDTO newIngredient<br />
</source><br />
<br />
'''PUT /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id, PostIngredientDTO ingredientDTO<br />
<br />
Returns: IngredientDTO updatedIngredient<br />
</source><br />
<br />
'''DELETE /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Ratings===<br />
'''GET /api/v1/ratings'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<RatingLogDTO><br />
</source><br />
<br />
'''GET /api/v1/ratings/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: RatingLogDTO dto<br />
</source><br />
<br />
'''POST /api/v1/ratings'''<br />
<source> <br />
Params: RatingLogForEntityDTO ratingDTO<br />
<br />
Returns: RatingLogDTO newRating<br />
</source><br />
<br />
'''PUT api/v1/ratings/{id}'''<br />
<source> <br />
Params: int id, RatingLogForEntityDTO ratingDTO<br />
<br />
Returns: RatingLogDTO updatedRating<br />
</source><br />
<br />
'''DELETE api/v1/ratings/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===RequestLog===<br />
'''GET: api/v1/usageData/{userId}'''<br />
<source> <br />
Params: string userId<br />
<br />
Returns: List<RequestLogDTO><br />
</source><br />
<br />
== Lõpptoote kasutusjuhend ==<br />
<br />
* Kloonida kohalikku arvutisse repository aadressilt [https://github.com/sikumiku/TaisKohtApi https://github.com/sikumiku/TaisKohtApi]<br />
* Installida NodeJS<br />
* <source>npm install webpack -g</source><br />
* <source>npm install -cli -g</source><br />
* Frontend rakenduse kasutamiseks valida Startup meetoditest IIS Express, veebiteenuse ja Swaggeri kasutamiseks käivitada Api Swagger<br />
* Esimese admin kasutaja loomiseks tuleb kasutaja registreerida admin@gmail.com e-mailiga<br />
<br />
== XML/XSD/XSLT ==<br />
<br />
=== XML ===<br />
<br />
<source><?xml version="1.0" encoding="utf-8" ?><br />
<?xml-stylesheet type="text/xsl" href="XMLFileXML.xslt"?><br />
<restaurants><br />
<restaurant id="1" url="https://kuuspelmeeni.ee" contactnumber="507783342" email="kuuspelmeeni@gmail.com"><br />
<name><![CDATA[Kuus Pelmeeni]]></name><br />
<menus><br />
<menu id="1" repetitioninterval="30"><br />
<name><![CDATA[Päevamenüü]]></name><br />
<activefrom>2018-05-27T12:00:00</activefrom><br />
<activeto>2018-05-28T12:00:00</activeto><br />
<dishes><br />
<dish id="1" vegan="false" lactosefree="false" glutenfree="false" daily="true" kcal="550" dailyprice="4"><br />
<title><![CDATA[8 pelmeeni]]></title><br />
<description><![CDATA[8 pelmeeni 6 asemel serveeritud tervisliku koguse hapukoore ja tilliga]]></description><br />
<availablefrom>2018-05-27T12:00:00</availablefrom><br />
<availableto>2018-05-28T12:00:00</availableto><br />
<ingredients><br />
<ingredient id="1" amountunit="g"><br />
<name>Sealiha</name><br />
<description>Rakvere sealiha</description><br />
</ingredient><br />
<ingredient id="2" amountunit="g"><br />
<name>Hapukoor</name><br />
<description>Alma hapukoor</description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="9"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Parim päevaroog viimasel ajal.]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
</comments><br />
</rating><br />
<promotion id="1" type="visual" classname="bold-red-border-2px"><br />
<name>2px red border</name><br />
<description><![CDATA[Displays a 2px wide red border around the component that is promoted.]]></description><br />
<validto>2018-06-25T12:00:00</validto><br />
</promotion><br />
</dish><br />
<dish id="2" vegan="true" lactosefree="true" glutenfree="true" daily="true" kcal="320" price="4"><br />
<title><![CDATA[Kurgisalat]]></title><br />
<description><![CDATA[Erinevatel viisidel töödeldud kurk serveeritud koos jõhvikatega. Tervislik amps.]]></description><br />
<availablefrom>2018-05-27T12:00:00</availablefrom><br />
<availableto>2018-05-28T12:00:00</availableto><br />
<ingredients/><br />
<rating ratingvalue="4"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Jäin veel väga näljaseks peale selle söömist.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
</dishes><br />
</menu><br />
<menu id="2"><br />
<name><![CDATA[Põhimenüü]]></name><br />
<dishes><br />
<dish id="4" vegan="false" lactosefree="false" glutenfree="false" daily="false" kcal="550" price="5"><br />
<title><![CDATA[6 pelmeeni]]></title><br />
<description><![CDATA[6 pelmeeni serveeritud tervisliku koguse hapukoore ja tilliga]]></description><br />
<ingredients><br />
<ingredient id="1" amountunit="g"><br />
<name>Sealiha</name><br />
<description>Rakvere sealiha</description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="9.5"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Käin seda iga päev söömas.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Parim toit selles restoranis.]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
<dish id="5" vegan="false" lactosefree="false" glutenfree="true" daily="false" kcal="460" price="3.8"><br />
<title><![CDATA[Kartulisalat]]></title><br />
<description><![CDATA[Sinki sisaldav traditsiooniline kartulisalat.]]></description><br />
<ingredients/><br />
</dish><br />
<dish id="6" vegan="false" lactosefree="false" glutenfree="false" daily="false" kcal="610" price="3.9"><br />
<title><![CDATA[Šokolaadikook]]></title><br />
<description><![CDATA[Ahvatlev glasuuritud šokolaadikook.]]></description><br />
<ingredients/><br />
<rating ratingvalue="7.8"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Šokolaadikooki on keeruline metsa keerata.]]></commenttext><br />
<username>mutikas3</username><br />
<userid>3a29b94a-3f17-469d-a44d-f7d85e98dd3e</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
</dishes><br />
</menu><br />
</menus><br />
<dishes/><br />
<address id="1" country="Eesti"><br />
<addressfirstline>Tatari 12</addressfirstline><br />
<locality>Tallinn</locality><br />
<postcode>10132</postcode><br />
<region>Harjumaa</region><br />
</address><br />
<promotion/><br />
<rating ratingvalue="7.5"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Parim restoran üldse!]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Ma sain ainult 5 pelmeeni. Ootasin kuute.]]></commenttext><br />
<username>kyllikekallike1</username><br />
<userid>6af271dd-0e11-4ae6-98be-111762664318</userid><br />
</comment><br />
</comments><br />
</rating><br />
</restaurant><br />
<restaurant id="2" url="https://kolmkokka.ee" contactnumber="6522351" email="kolmkokka@gmail.com"><br />
<name><![CDATA[Kolm kokka]]></name><br />
<menus/><br />
<dishes><br />
<dish id="7" vegan="false" lactosefree="true" glutenfree="false" daily="false" kcal="470" price="14"><br />
<title><![CDATA[Ahjulõhe juurikatega]]></title><br />
<description><![CDATA[Ahjulõhe serveeritud püreestatud porgandite ja lillkapsaga.]]></description><br />
<ingredients><br />
<ingredient id="11" amountunit="tk" amount="1"><br />
<name>Ahjulõhe</name><br />
<description><![CDATA[Värske ahjulõhe]]></description><br />
</ingredient><br />
<ingredient id="12" amountunit="g"><br />
<name>Püreestatud porgand</name><br />
<description><![CDATA[Eesti porgand, mis on kergelt püreestatud]]></description><br />
</ingredient><br />
<ingredient id="13" amountunit="g"><br />
<name>Püreestatud lillkapsas</name><br />
<description><![CDATA[Eesti lillkapsas, mis on kergelt püreestatud ja maitsestatud]]></description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="8.9"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Kindlasti minu üks lemmikuid.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Pole midagi halba öelda.]]></commenttext><br />
<username>tiiuviiu</username><br />
<userid>0730a7b7-3a9c-4e26-962f-da9a8daeab8a</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
<dish id="8" vegan="true" lactosefree="true" glutenfree="true" daily="true" dailyprice="5"><br />
<title><![CDATA[Ingverisupp]]></title><br />
<description><![CDATA[Ingveriga vürtsistatud ingverisupp, mis viib keele alla.]]></description><br />
<availablefrom>2018-05-25T12:00:00</availablefrom><br />
<availableto>2018-06-25T12:00:00</availableto><br />
<ingredients><br />
<ingredient id="14" amountunit="g" amount="20"><br />
<name>Ingver</name><br />
<description><![CDATA[Tükeldatud ingver]]></description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="6"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Liiga palju ingverit.]]></commenttext><br />
<username>kyllikekallike1</username><br />
<userid>6af271dd-0e11-4ae6-98be-111762664318</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
<dish id="9" vegan="false" lactosefree="false" glutenfree="true" daily="false" kcal="340" price="4.5"><br />
<title><![CDATA[Apelsinijäätis]]></title><br />
<description><![CDATA[Apelsinimaitseline jäätis serveeritud riivitud apelsinikoorega.]]></description><br />
<ingredients/><br />
<rating ratingvalue="8"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Väga huvitav magustoit, prooviks veel.]]></commenttext><br />
<username>mutikas3</username><br />
<userid>3a29b94a-3f17-469d-a44d-f7d85e98dd3e</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Üks mu lemmikuid magustoite.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
</dishes><br />
<address id="2" country="Eesti"><br />
<addressfirstline>Laia 12</addressfirstline><br />
<locality>Tallinn</locality><br />
<postcode>13022</postcode><br />
<region>Harjumaa</region><br />
</address><br />
<promotion/><br />
<rating ratingvalue="8.1"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Hinnad on natuke liiga kallid minu jaoks, aga toit om maitsev.]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Ma kindlasti telliks kala uuesti. Väga mahlakas oli.]]></commenttext><br />
<username>kyllikekallike1</username><br />
<userid>6af271dd-0e11-4ae6-98be-111762664318</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Asukoht oli päris tore. Miljöö ka.]]></commenttext><br />
<username>mutikas3</username><br />
<userid>3a29b94a-3f17-469d-a44d-f7d85e98dd3e</userid><br />
</comment><br />
</comments><br />
</rating><br />
</restaurant><br />
</restaurants></source><br />
<br />
=== XSD ===<br />
<br />
<source><?xml version="1.0" encoding="utf-8"?><br />
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema"><br />
<xs:element name="restaurants"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="restaurant"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="menus"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="menu"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="activefrom" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="activeto" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="dishes"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="dish"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="title" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="availablefrom" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="availableto" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="servetime" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="ingredients"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="ingredient"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="amountunit" type="xs:string" use="required" /><br />
<xs:attribute name="amount" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="rating" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="comments"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="comment"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="commenttext" type="xs:string" /><br />
<xs:element name="username" type="xs:string" /><br />
<xs:element name="userid" type="xs:string" /><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="ratingvalue" type="xs:decimal" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="validto" type="xs:dateTime" minOccurs="0" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="type" type="xs:string" use="required" /><br />
<xs:attribute name="classname" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="vegan" type="xs:boolean" use="optional" /><br />
<xs:attribute name="lactosefree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="glutenfree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="daily" type="xs:boolean" use="optional" /><br />
<xs:attribute name="kcal" type="xs:int" use="optional" /><br />
<xs:attribute name="weightg" type="xs:decimal" use="optional" /><br />
<xs:attribute name="price" type="xs:decimal" use="optional" /><br />
<xs:attribute name="dailyprice" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="validto" type="xs:dateTime" minOccurs="0" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="type" type="xs:string" use="required" /><br />
<xs:attribute name="classname" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="repetitioninterval" type="xs:int" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="dishes"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="dish"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="title" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="availablefrom" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="availableto" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="servetime" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="ingredients"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="ingredient"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="amountunit" type="xs:string" use="required" /><br />
<xs:attribute name="amount" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="rating"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="comments"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="comment"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="commenttext" type="xs:string" /><br />
<xs:element name="username" type="xs:string" /><br />
<xs:element name="userid" type="xs:string" /><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="ratingvalue" type="xs:decimal" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="validto" type="xs:dateTime" minOccurs="0" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="type" type="xs:string" use="required" /><br />
<xs:attribute name="classname" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="vegan" type="xs:boolean" use="optional" /><br />
<xs:attribute name="lactosefree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="glutenfree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="daily" type="xs:boolean" use="optional" /><br />
<xs:attribute name="kcal" type="xs:int" use="optional" /><br />
<xs:attribute name="weightg" type="xs:decimal" use="optional" /><br />
<xs:attribute name="price" type="xs:decimal" use="optional" /><br />
<xs:attribute name="dailyprice" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="address"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="addressfirstline" type="xs:string" /><br />
<xs:element name="locality" type="xs:string" /><br />
<xs:element name="postcode" type="xs:string" /><br />
<xs:element name="region" type="xs:string" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="country" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion" /><br />
<xs:element name="rating" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="comments"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="comment"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="commenttext" type="xs:string" /><br />
<xs:element name="username" type="xs:string" /><br />
<xs:element name="userid" type="xs:string" /><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="ratingvalue" type="xs:decimal" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="url" type="xs:string" use="required" /><br />
<xs:attribute name="contactnumber" type="xs:string" use="required" /><br />
<xs:attribute name="email" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:schema></source><br />
<br />
=== XSLT(HTML) ===<br />
<br />
<source><?xml version="1.0" encoding="utf-8" ?><br />
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:msxsl="urn:schemas-microsoft-com:xslt" exclude-result-prefixes="msxsl"><br />
<xsl:output method="html" indent="yes"/><br />
<xsl:template match="/restaurants"><br />
<html><br />
<head><br />
<title>Täis Kõht</title><br />
</head><br />
<body><br />
<xsl:for-each select="restaurant"><br />
<h1 style="color:DodgerBlue"><br />
<xsl:value-of select="name"/><br />
</h1><br />
<div><br />
<xsl:value-of select="@url"/><br />
</div><br />
<div><br />
<xsl:text>Kontakt number: </xsl:text><br />
<xsl:value-of select="@contactnumber"/><br />
</div><br />
<div><br />
<xsl:text>email: </xsl:text><br />
<xsl:value-of select="@email"/><br />
</div><br />
<div><br />
<xsl:text>Aadress: </xsl:text><br />
<xsl:value-of select="address/addressfirstline"/><br />
<xsl:text>, </xsl:text><br />
<xsl:value-of select="address/locality"/><br />
<xsl:text>, </xsl:text><br />
<xsl:value-of select="address/postcode"/><br />
<xsl:text>, </xsl:text><br />
<xsl:value-of select="address/@country"/><br />
</div><br />
<br />
<xsl:choose><br />
<xsl:when test="menus/menu"><br />
<xsl:for-each select="menus/menu"><br />
<xsl:sort select="name"/><br />
<h3><br />
<xsl:value-of select="name"/><br />
</h3><br />
<br />
<xsl:if test="activefrom != '' and activeto != ''"><br />
<xsl:text> </xsl:text><br />
<xsl:value-of select="substring(activefrom,1,10)"/><br />
<xsl:text> kuni </xsl:text><br />
<xsl:value-of select="substring(activeto,1,10)"/><br />
</xsl:if><br />
<br />
<ul><br />
<xsl:for-each select="dishes/dish"><br />
<xsl:sort select="title"/><br />
<br />
<xsl:if test="availablefrom != '' and availableto != ''"><br />
<xsl:value-of select="substring(availablefrom,1,10)"/><br />
<xsl:text> kuni </xsl:text><br />
<xsl:value-of select="substring(availableto,1,10)"/><br />
</xsl:if><br />
<br />
<li><br />
<span style="font-weight:bold"><br />
<xsl:value-of select="title"/><br />
</span><br />
<xsl:text> - </xsl:text><br />
<xsl:value-of select="description"/><br />
<xsl:text> </xsl:text><br />
<span style="font-weight:bold"><br />
<xsl:if test="@glutenfree='true'"><br />
<xsl:text>G </xsl:text><br />
</xsl:if><br />
<xsl:if test="@lactosefree='true'"><br />
<xsl:text>L </xsl:text><br />
</xsl:if><br />
<xsl:if test="@vegan='true'"><br />
<xsl:text>V </xsl:text><br />
</xsl:if><br />
</span><br />
</li><br />
<br />
<xsl:for-each select="ingredients/ingredient"><br />
<xsl:value-of select="name"/><br />
<xsl:if test="position()!=last()"><br />
<xsl:text>, </xsl:text><br />
</xsl:if><br />
</xsl:for-each><br />
<br />
<p style="font-weight:bold"><br />
<xsl:text>Hind: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="@price!=''"><br />
<xsl:value-of select="@price"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>-</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
<xsl:text> / Päevapakkumise hind: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="@dailyprice!=''"><br />
<xsl:value-of select="@dailyprice"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>-</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
</p><br />
<br />
<div style="background-color:LightGray;"><br />
<xsl:text>Hinnang praele: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="rating/@ratingvalue!=''"><br />
<xsl:value-of select="rating/@ratingvalue"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>Ei ole veel hinnatud!</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
<br />
<br/><br />
<xsl:for-each select="rating/comments/comment"><br />
<xsl:value-of select="username"/><br />
<xsl:text>: </xsl:text><br />
<xsl:value-of select="commenttext"/><br />
<br/><br />
</xsl:for-each><br />
</div><br />
<br/><br />
</xsl:for-each><br />
</ul><br />
</xsl:for-each><br />
</xsl:when><br />
<xsl:otherwise><br />
<ul><br />
<xsl:for-each select="dishes/dish"><br />
<xsl:sort select="title"/><br />
<br />
<xsl:if test="availablefrom != '' and availableto != ''"><br />
<xsl:value-of select="substring(availablefrom,1,10)"/><br />
<xsl:text> kuni </xsl:text><br />
<xsl:value-of select="substring(availableto,1,10)"/><br />
</xsl:if><br />
<br />
<li><br />
<span style="font-weight:bold"><br />
<xsl:value-of select="title"/><br />
</span><br />
<xsl:text> - </xsl:text><br />
<xsl:value-of select="description"/><br />
<xsl:text> </xsl:text><br />
<span style="font-weight:bold"><br />
<xsl:if test="@glutenfree='true'"><br />
<xsl:text>G </xsl:text><br />
</xsl:if><br />
<xsl:if test="@lactosefree='true'"><br />
<xsl:text>L </xsl:text><br />
</xsl:if><br />
<xsl:if test="@vegan='true'"><br />
<xsl:text>V </xsl:text><br />
</xsl:if><br />
</span><br />
</li><br />
<br />
<xsl:for-each select="ingredients/ingredient"><br />
<xsl:value-of select="name"/><br />
<xsl:if test="position()!=last()"><br />
<xsl:text>, </xsl:text><br />
</xsl:if><br />
</xsl:for-each><br />
<br />
<p style="font-weight:bold"><br />
<xsl:text>Hind: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="@price!=''"><br />
<xsl:value-of select="@price"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>-</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
<xsl:text> / Päevapakkumise hind: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="@dailyprice!=''"><br />
<xsl:value-of select="@dailyprice"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>-</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
</p><br />
<br />
<div style="background-color:LightGray;"><br />
<xsl:text>Hinnang praele: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="rating/@ratingvalue!=''"><br />
<xsl:value-of select="rating/@ratingvalue"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>Ei ole veel hinnatud!</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
<br />
<br/><br />
<xsl:for-each select="rating/comments/comment"><br />
<xsl:value-of select="username"/><br />
<xsl:text>: </xsl:text><br />
<xsl:value-of select="commenttext"/><br />
<br/><br />
</xsl:for-each><br />
</div><br />
<br/><br />
</xsl:for-each><br />
</ul><br />
</xsl:otherwise><br />
</xsl:choose><br />
<br />
<div style="background-color:LightGray;"><br />
<xsl:text>Hinnang restoranile: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="rating/@ratingvalue!=''"><br />
<xsl:value-of select="rating/@ratingvalue"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>Ei ole veel hinnatud!</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
<br />
<br />
<br/><br />
<xsl:for-each select="rating/comments/comment"><br />
<xsl:value-of select="username"/><br />
<xsl:text>: </xsl:text><br />
<xsl:value-of select="commenttext"/><br />
<br/><br />
</xsl:for-each><br />
</div><br />
<br />
<p><br />
<xsl:text>*G - gluteenivaba, </xsl:text><br />
<xsl:text>L - laktoosivaba, </xsl:text><br />
<xsl:text>V - vegan </xsl:text><br />
</p><br />
<br />
</xsl:for-each><br />
</body><br />
</html><br />
</xsl:template><br />
</xsl:stylesheet></source><br />
<br />
=== XSLT(XML) ===<br />
<br />
XML'is kuvatakse elemendid ja atribuudid eesti keeles. Kuvatakse restorani andmed ja toidud, mille hinnang on 8 või rohkem punkti.<br />
<br />
<source><?xml version="1.0" encoding="utf-8" ?><br />
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"<br />
xmlns:msxsl="urn:schemas-microsoft-com:xslt" exclude-result-prefixes="msxsl"><br />
<xsl:output method="xml" indent="yes"/><br />
<br />
<xsl:template match="/restaurants"><br />
<restoranid><br />
<xsl:for-each select="restaurant"><br />
<restoran url="{@url}" telefon="{@contactnumber}" email="{@email}"><br />
<nimi><br />
<xsl:value-of select="name"/><br />
</nimi><br />
<aadress><br />
<postiaadress><br />
<xsl:value-of select="address/addressfirstline"/><br />
</postiaadress><br />
<linn><br />
<xsl:value-of select="address/locality"/><br />
</linn><br />
<indeks><br />
<xsl:value-of select="address/postcode"/><br />
</indeks><br />
<riik><br />
<xsl:value-of select="address/@country"/><br />
</riik><br />
</aadress><br />
<br />
<parimadToidud><br />
<xsl:choose><br />
<xsl:when test="menus/menu/dishes/dish"><br />
<xsl:for-each select="menus/menu/dishes/dish"><br />
<xsl:if test="rating/@ratingvalue &gt;= 8.0"><br />
<heaToit hinnang="{rating/@ratingvalue}" paevaPakkumiseHind="{@dailyprice}" hind="{@price}" <br />
vegan="{@vegan}" laktoosivaba="{@lactosefree}" gluteenivaba="{@glutenfree}"><br />
<nimi><br />
<xsl:value-of select="title"/><br />
</nimi><br />
<kirjeldus><br />
<xsl:value-of select="description"/><br />
</kirjeldus><br />
</heaToit><br />
</xsl:if><br />
</xsl:for-each><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:for-each select="dishes/dish"><br />
<xsl:if test="rating/@ratingvalue &gt;= 8.0"><br />
<heaToit hinnang="{rating/@ratingvalue}" paevaPakkumiseHind="{@dailyprice}" hind="{@price}" <br />
vegan="{@vegan}" laktoosivaba="{@lactosefree}" gluteenivaba="{@glutenfree}"><br />
<nimi><br />
<xsl:value-of select="title"/><br />
</nimi><br />
<kirjeldus><br />
<xsl:value-of select="description"/><br />
</kirjeldus><br />
</heaToit><br />
</xsl:if><br />
</xsl:for-each><br />
</xsl:otherwise><br />
</xsl:choose><br />
</parimadToidud><br />
</restoran><br />
</xsl:for-each><br />
</restoranid><br />
</xsl:template><br />
</xsl:stylesheet><br />
</source><br />
<br />
== Retsensioonid ==<br />
<br />
=== Veebiteenuse retsensioon meeskonnale [https://wiki.itcollege.ee/index.php/MOT MOT] ===<br />
<br />
* Puudub README vms. Dokumentatsioon projekti ülespanemiseks ja seadistamiseks.<br />
* Rollide loomine vigane, seda võiks teha eraldi failis, mis on DAL.App.EF projektis (kasutasime algul sama lähenemist nagu antud projekt). Takistab esialgset andmebaasi uuendust, kui rollid veel puuduvad. Rakenduse installimine tarnitud kujul ei õnnestunud. Selleks et Nuget Package Manageri käsk Update-Database töötaks pidi ajutiselt välja kommenteerima Startup.cs faili rea 153 (// CreateRoles(services).Wait();).<br />
==== Andmebaasist: ====<br />
* Üldiselt paneksin igale väljale juurde AddTime ja UpdateTime see on hea tava millest korduvalt ka andmebaasi alustes räägiti ja rõhutati.<br />
==== Olemitest: ====<br />
* Kui juba domainis nimetate kõik olemid singulaarselt siis võiks ju sama teha ka andmebaasis - lisakeerukuse loomine kohas kus see ei ole vajalik.<br />
* Entity-te arv oli nõutust väiksem - Kokku 8 olemit, millest 1 on many-to-many liittabel ja 1 otsene koopia Identity framework Users tabelist. <br />
* Olem People ~= Users ja sisaldab ka viidet Identity tabelile ApplicationUsers (ApplicationUserId). Juhul kui see on mõeldud rakendusega mitte registreerunud kasutajate võistlusele kirja panemiseks, siis oleks olemil rohkem infot vaja - vähemalt mingigi kontakti väli (email |/& tel.nr. |/& aadress).<br />
* Competition.Comment on varchar(100) - võiks ja peaks olema varchar(1000)<br />
* Competition.CompetitionPlaceId - kui võistluse toimumiskoht mingil põhjusel peaks keelduma korraldusest või kui võistlust alles pannakse kokku ja ei ole veel teada kus see toimuma saab siis mis peaks sinna sisestama (NOT NULL => NULL)<br />
* Competition.Time -> Mis aega see näitab? Property nimest seda välja ei loe. Kui StartTime, siis kus on EndTime või Duration?<br />
* CompetitionPlace.County -> int type enum default väärtus on 0, kuna see pole aga enumi klassis implementeeritud põhjustab see vea. (Millisele maakonnale vastab 0?) See teada tuntud probleem millele google annab hõlpsasti erinevaid lahendusi: näiteks [https://stackoverflow.com/questions/24350377/entity-framework-6-code-first-required-enum-data-type-not-working?utm_medium=organic&utm_source=google_rich_qa&utm_campaign=google_rich_qa siin] ja [https://stackoverflow.com/questions/529929/choosing-the-default-value-of-an-enum-type-without-having-to-change-values/529937?utm_medium=organic&utm_source=google_rich_qa&utm_campaign=google_rich_qa siin].<br />
* Väljad mis viitavad Identity framework olemitele läbi nende ID-de ei peaks olema nvarchar(max) vaid nvarchar(450) (kuigi isegi see on reaalsuses liiga pikk).<br />
* PersonInTeam.PersonInTeamId -> ei peaks olema sellist välja üldse, selle tabeli PK peaks olema kombinatsioon nende tabeli ID-st mida ta ühendab. Praegu ei ole unique indeksit üle nende, mis tähendab et sama inimene saab mitu korda sama tiimiga liituda.<br />
* Participations - Miks selline nimi, kui registreerimine juba oli? Saan aru et selles olemis tahetakse säilitada võistluse tulemusi. Siis võiks ju juba olla CompetitionResults. Kus on aga saavutatud koha numbri talletamine? Kui võistluse punktid ja ajad on kõik kirja saadud siis tahaks ju tulemusi ka kuidagi näha ja võrrelda ning selle võrdluse tulemi kuhugi salvestada.<br />
* Participations.Time - Mis aega näitab? Eeldan, et võistluse läbimise aega? Kui nii, siis miks ei ole NULL lubatud - mõnedel võistlustel aega ju ei mõõdeta?<br />
* Participation.Points - Kas igal võistlusel antakse ainult täisarv punkte (int)? Võiks igaks juhuks siiski implementeerida double väärtuse tüübi. Lisaks ei ole võimalik osalust luua ilma punkte teadmata - peaks siis määrama default väärtus. Mõnede võistluste puhul jälle punkte ei anta vaid mõõdetakse aega.<br />
* Participation.Disqualified - Nullid ei ole lubatud -> järelikult oleks default väärtust vaja.<br />
* Registrations - Projekti Must have alla on märgitud “Osaleja saab registreerida võistlusele meeskonda” kuid olemis puudub TeamsId ning samuti ei ole seda võimalust kuidagi läbi Servicei implementeeritud.<br />
* Registrations - Millal registreering tehti on suhteliselt tähtis teada. Paljude võistluste puhul sõltub sellest näiteks registreerimistasu. <br />
==== DTO-d: ====<br />
* Täiesti mõttetult sisse toodud kiht, lihtsalt selleks et nii oli ette nähtud. Kõik DTO-d konverteeritakse ümber 1:1-le Domain objektideks ja vastupidi.<br />
* Üldiselt oleks vaja teha tööd veel DTOdega, et need rohkem peegeldaksid oma kasutust. Näiteks:<br />
** küsides kõiki võistlusi, kas meil on tarvis avalikustada kliendile, mis on kasutaja ID, kes iga võistluse lõi? DTOsid võiks olla rohkem erinevate kasutusjuhtumite jaoks. <br />
** CompetitionDTO võiks sisaldada ka nimekirja võistlejatest, kus koondatakse info ManyToMany seoste põhjal kasutades vahetabelit, nagu näiteks:<br />
<source><br />
List<PersonDTO> people = c.Participation<br />
.FindAll(p => p.CompetitionId == c.CompetitionId)<br />
.Select(PersonDTO.CreateFromParticipation)<br />
.ToList();<br />
</source><br />
<br />
==== API Kontrolleritest: ====<br />
* Puudub Swagger startup konfiguratsioon, Swagger annotatsioonid kaotavad mõtte ning pole võimalik kontrollida, kas need on korrektselt loodud.<br />
* ProducesResponse annotatsiooni pole kusagile lisatud, staatuskoodid on natuke poolikult läbi mõeldud, vähemalt need, mida Swaggeri raames mainitud on<br />
*Annotatsioon Authorize, kus on ära määratud AuthorizationScheme peaks minema kogu klassi peale, meetodis saab ära määrata vaid selle, mis rollid on lubatud.<br />
* AccountController<br />
** Response code uue kasutaja loomisel võiks olla 201<br />
** Puuduvad koodid nagu 429, 500<br />
** Registreerumisel võiks kontrollida, kas kasutaja on juba olemas, mitte vaid rolli olemasolu<br />
** Kas kasutajal ei või antud kontekstis olla mitu rolli? Sisselogimisel võetakse rollide seast vaid esimene ja lisatakse juurde Claimile. Võimalus kirjutada ka meetod, mis lisab kasutajale kõik rollid.<br />
** CompetitionPlacesController/CompetitionsController/CompetitionTypesController/ParticipationsController/RegistrationsController/TeamsController<br />
Antud kontrollerid on kõik väga sarnase loogikaga<br />
** Get() tagastab vaid koodi 200, tagastuskoodi võimalusi on veel<br />
** Post() meetod küsib sisse DTOd, mille üheks parameetriks on id, id genereeritakse automaatselt, seda ei peaks panema kaasa postitatavasse mudelisse, mis alles loob objekti<br />
** Put() puhul sama kriitika, siin on id küll vajalik, aga see juba pannakse kaasa parameetrina eraldi<br />
** See tundub natuke veidrana üritada kontrollida uuendatud mudeli põhjal, kas tegemist oli BadRequestiga. Eelkõige peaks id puhul üles otsima, kas antud objekt on üldse olemas ja seejärel üritada uuendada, muidu tagastada BadRequest. Kui see ei õnnestu, siis peaks juba errorkood 500 peegeldama seda, et midagi läks teenuse poole peal valesti. <br />
** Sama kommentaar deletemise kohta, enne tuleks kontrollida, kas objekt on olemas. Siis alles objekt kustutada.<br />
* PeopleController<br />
** Kas tõepoolest igaüks saab pärida infot inimeste kohta ja neid postitada? <br />
* PersonInTeamsController <br />
** API disaini poole pealt on natuke veider teha vahetabelite kohta kontroller. Tundub loogilisem panna antud kontrolleri meetodid teistesse kontroleritesse, mis on seotud siis kas meeskondade või inimestega. Näiteks küsida ** PeopleControlleris kõik inimesed, kes on meeskondades või küsida neid meeskonna järgi. TeamsControlleris seevastu anda võimalus lisada uusi inimesi meeskonda, neid muuta või eemaldada.<br />
Id järgi ei hakka ükski klient küsima vahetabeli kohta infot, see tundub otstarbetu tegevus, pigem küsida kas meeskonna või inimese id järgi sissekandeid<br />
* Kriitika kontrollerite kohta: kontrollerid enamuses pöörduvad vaid spetsiifiliste domeenide poole ja viivad ellu väga tavalist CRUD funktsionaalsust, mille tõttu tundub, et need on natuke veel toored. Näiteks on välja toodud “must have” nimekirjas projekti analüüsis, et meeskonna liige peaks saama muuta meeskonna andmeid. Antud kontrollerites vaid autentitakse, et kasutaja oleks rollis “participant”, kuid mitte seda, kas ta ka muudetava meeskonna liige on. Samuti pole võimalik kasutajatel näha, palju on mingile võistlusele osalejaid registreerunud, CompetitionsController ei tegele sellega, et tagastada võistlusele registreerunud kasutajaid, selle asemel on olemas ParticipationsController, mis tagastab vahetabeli infot selle kohta, mis võistlusega on seotud mis inimene. See võib olla tohutult suur info, mida hakata filtreerima kliendi poolelt. Rohkem tuleks teha andmete agregeerimist vastavalt teenuse kontekstile. <br />
<br />
==== Projekti kihid/struktuur: ====<br />
* Olemas Business Logic, Data Access Layer, DTO’d, Service’id, Unit of Work, domeeniklassid ning API spetsiifilised kontrollerid, mis asuvad oma kaustas põhiprojekti all . DAL omab erinevaid kihte interface’ide ja neid implementeerivate klasside jaoks. Repositooriumitega suhtlemine on abstraktne, kõik käib läbi Data Access Layer’i, mille pööle pöörduvad teenuseklassid ning DAL erinevad kihid hoolitsevad selle eest, et loodaks õiget tüüpi repositooriumeid, andmeid agregeeritakse, uuendatakse ja salvestatakse organiseeritud kujul ning neid tagastatakse teenustele soovitud kujul (DTOd).<br />
<br />
== Logiraamat ==<br />
<br />
===07.02.2018===<br />
Gupi loomine ning suhtluskanali seadistamine<br />
<br />
=== 24.03.2018 ===<br />
Trello boardi loomine<br />
<br />
=== 25.03.2018 ===<br />
Wiki lehe loomine. Esimene tõsisem projekti koosolek ning tegevuskava paika panemine.<br />
<br />
=== 26.03.2018 ===<br />
<br />
Alustasime veebiteenuse analüüsiga ja funktsionaalsuse kirjeldamisega.<br />
<br />
=== 27.03.2018 ===<br />
Täiendasime veebiteenuse analüüsi.<br />
<br />
Esmase andmebaasi mudeli koostamine.<br />
<br />
Postitatud esimeste analüüsi arutelude põhjal valminud algne prototüüp.<br />
<br />
=== 30.03.2018 ===<br />
Valmis andmebaasimudel.<br />
<br />
=== 08.04.2018 ===<br />
Tehtud muudatused analüüsis vastavalt tagasisidele.<br />
<br />
=== 19.04.2018 ===<br />
Loodud projekti põhi koos domeenimudelitega. Projekt lisatud Githubi: https://github.com/sikumiku/TaisKohtApi<br />
<br />
=== 05-06.05.2018 ===<br />
Osalesime hackathonil. Lisatud controllerid, service'id koos vajalike kihtidega.<br />
<br />
=== 16.05.2018 ===<br />
Uuendatud andmebaasimudelit, DTO'sid.<br />
<br />
=== 18-19.05.2018 ===<br />
Lisatud klientrakendus, security, äriloogikat.<br />
<br />
=== 20.05.2018 ===<br />
Lisatud API dokumentatsioon.<br />
<br />
=== 22-24.05.2018 ===<br />
Uuendatud contoller'eid, service'id.<br />
<br />
=== 25-27.05.2018 ===<br />
Uuendatud contoller'eid, service'id. Lisatud kasutajate ja rollide kontrolle meetoditesse. Täiustatud klientrakendust. Swagger dokumentatsioon.<br />
<br />
=== 31.05-01.06.2018 ===<br />
Tegeletud XML, XSD ja XSLT failide loomisega.<br />
<br />
=== 02.06-03.06.2018 ===<br />
Tegeletud XML ja XSLT failide täiustamisega ja retsensioonide kirjutamisega.</div>
Saasma
https://wiki.itcollege.ee/index.php?title=BeerPressure&diff=131176
BeerPressure
2018-06-03T20:34:33Z
<p>Saasma: </p>
<hr />
<div>== Meeskond ja rollid ==<br />
<br />
* Sigrid Aasma (arendaja)<br />
* Evelin Jõgi (arendaja)<br />
* Martin Kask (projektijuht, arendaja)<br />
* Marko Nõu (arendaja)<br />
<br />
== Idee ==<br />
'''Toidukohtade põhimenüüde ja päevapakkumiste teenus'''<br />
<br />
Soovime pakkuda toidukohtade põhimenüüde ja päevapakkumiste teenust. On olemas mitmeid kodulehti “päevapakkumised”, kus on kirjas toidukohtade päevapraed. Kuid tavaliselt sellistel lehtedel ei ole masinloetavaid andmeid ehk siis varianti, et saad saata API pihta mingi kuupäeva koos päevapraadidega andmete uuendamiseks ja saad sama API käest küsida tänaseid päevapraade. Andmeid võiks saada küsida restorani, kuupäeva, asukoha või otsisõna/otsisõnaosa põhiselt. Selline teenus lihtsustaks ka toidukohtade päevapakkumiste haldamist, kuna praegu peavad teenuse pakkujad vastavat informatsiooni uuendama mitmes erinevas kohas - nii erinevates portaalides, kui ka enda veebileheküljel. Samuti oleks toidukohtade kogu menüü haldamine ühes kohas.<br />
<br />
=== Esialgne prototüüp ===<br />
<br />
[[File:TäisKõhtProto1.mp4]]<br />
<br />
Esialgne prototüüp: [http://enos.itcollege.ee/~saasma/VR2/Proto/K%C3%B5htT%C3%A4is/#g=1&p=home navigeeritav versioon vol.1]<br />
<br />
=== Prototüübi muutus projekti käigus ===<br />
<br />
Prototüüp: [http://enos.itcollege.ee/~saasma/VR2/Proto/T%C3%A4isK%C3%B5ht/K%C3%B5htT%C3%A4is/#g=1&p=home navigeeritav versioon vol.2]<br />
<br />
== Kasutatav arendustehnoloogia ==<br />
<br />
Veebiteenuse loomisel kasutame ASP.NET Core tehnoloogiat ja kursusel õpitud arendusmustreid.<br />
<br />
Klientrakenduse loomisel kasutame Node.js + React'i.<br />
<br />
== Veebiteenuse analüüs ==<br />
Pakume toidukohtade põhimenüüde ja päevapakkumiste teenust, kuhu on kokku koondatud erinevate toidukohtade menüüd üle Eesti. Põhimenüü alla kuuluvad pikaajalised menüüd, mis kehtivad püsivalt, hooajaliselt või mingil konkreetsel nädalapäeval. Päevapakkumiste alla kuuluvad konkreetse kuupäevaga seotud päevapakkumised. Päevapakkumiste korral kuvatakse lisainfona, kas pakkumine kehtib mingis konkreetses ajavahemikus või kogu toidukoha lahtioleku aja.<br />
<br />
Eesmärk on koguda ühte kohta kokku erinevate toidukohtade menüüd ja päevapakkumised, et kliendid saaksid mugavalt ja kiiresti oma valikuid teha. Kliendid käivad enamasti päevapakkumisi söömas lõuna ajal ja selleks ettenähtud aeg on piiratud. Sellepärast on oluline, et klient saaks teha oma valiku võimalikult kiiresti. Tänu loodavale veebiteenusele ei pea kliendid käima erinevates portaalides, et tutvuda erinevate toidukohtade pakkumistega. Kuna teenust on mugav kasutada ja klient saab oma valiku kiiresti tehtud, siis tõenäoliselt teeb klient valiku selles keskkonnas olevate toiduasutuste seast. Lisaks võimaldab teenus toiduasutustel paika panna oma pikaajalisem põhimenüü ning seda rakenduses ja võimalusel ka söögikohas kuvada. Sellepärast on ka toidukohtade huvi antud keskkonnas üleval olla ja meiega oma andmeid jagada, sest see suurendab nende klientuuri ning muudab oma menüü haldamise kergemaks.<br />
<br />
Veebiteenuse loomisel lähtume eelkõige sellest, et kliendil oleks teenust mugav kasutada ja ta saaks oma valiku kiiresti tehtud. Arvestame, et kliendid on erinevad. Mõni eelistab mõnda kindlat toidukohta, sel juhul saab ta valida oma soovitud kohad ja võrrelda nende kohtade tänase päeva pakkumisi ning menüüsid. Mõnele inimesele on oluline pakutav söök ja ta eelistab pakkumist otsida prae nimetuses oleva sõna või sõnaosa järgi ning lähtuda seejärel valiku tegemisel toidukoha keskmisest hindest või toidu hinnast. Mõne kliendi jaoks on oluline hind ja selleks, et oma valikut teha sobivas hinnavahemikus on tal võimalik sisestada maksimum hinna piirang. Kindlasti on antud teenuse juures kõikide klientide jaoks oluline päevapakkumiste asukohapõhine eristatus. Kliendid, kes soovivad oma konto luua, võivad oma eelistatud valikud meelde jätta ja järgmisel korral kuvatakse neid talle automaatselt.<br />
<br />
Teenuse must-have funktsionaalsus tagab teenuse toimimise ja põhifunktsioonid. Teenuse nice-to-have funktsionaalsus annab rakendusele lisandväärtust.<br />
<br />
Arvestades pakutava teenusega, siis näeme, et aktiivseim teenuse kasutamine võib olla tööpäevadel vahemikus 11.00-15.00, kui kliendid tutvuvad päevapakkumistega. Teenus peab tekkivale koormusele vastu pidama.<br />
<br />
Teenuse pakkumine peab olema turvaline. Selle tagamiseks tuleb sisestatavaid andmeid valideerida ja andmebaasi sisestavate andmete mahtu piirata. Toidukohtade sisestatud andmed peavad olema kaitstud, et toitude koostised ei saaks avalikuks. Põhjendatud juhtudel on võimalik kasutajaid lukku panna.<br />
<br />
== Kasutajad ==<br />
<br />
<br />
* Admin - lehe administraator, kellel on õigus lehte, kasutajaid ja nende õiguseid hallata. Tema huvi on, et teenus toimiks tõrgeteta.<br />
* Toiduasutus (tasuta kasutaja) - saab hoida lehel ühte põhimenüüd ja päevapakkumisi.<br />
* Toiduasutus (tellimusega kasutaja) - saab hoida lehel piiramatu arv põhimenüüsid ja päevapakkumisi.<br />
Toiduasutused on teenusest huvitatud, et nende menüüde haldamine oleks kerge ja mugav ning nad saaksid oma klientide arvu suurendada.<br />
* Külastaja - klient, kes valib söögikohta. Tema on huvitatud eelkõige sellest, et teenust saaks kasutada mugavalt ja kiirelt ning toidukohtade valik oleks võimalikult suur.<br />
<br />
== Rakenduse must-have funktsionaalsus ==<br />
<br />
* Kasutajad saavad sisse logida<br />
* Kasutajatel on erinevad rollid: admin, toidukoht (tasuta ja tasulise tellimusega), klient<br />
* Kasutajate arvepidamine kasutajate lõikes:<br />
** sisselogimise kuupäev, kellaaeg<br />
** pakkumiste lisamine<br />
** pakkumiste muutmine<br />
** pakkumiste kustutamine<br />
** õiguste kehtimise periood (tasuta ja tellimusega toidukoht)<br />
** pakkumistele klikkimise arv<br />
* Kasutajaid on võimalik hallata:<br />
** kasutajale õiguste andmine (menüüde arvu suurendamine, tellimusega toidukohal), rolli määramine<br />
** Kasutajat on võimalik piirata: õiguseid piirata (piiratud menüüde arv, tasuta liitunud toidukohal) ja lukku panna<br />
* Päevapakkumisi/menüüsid saab küsida: <br />
** toidukoha järgi, <br />
** kuupäeva põhiselt (ainult päevapakkumisi), <br />
** asukoha põhiselt,<br />
** toidu nimetuses esineva otsisõna/otsisõna osa põhiselt,<br />
** hinna põhiselt (max hinna piirang).<br />
* Klientrakenduses realiseeritakse CRUD meetodid (menüüsid/päevapakkumisi saab sisestada, lugeda, uuendada, kustutada)<br />
* Toidukohale saab anda hindeid ja kuvatakse keskmist hinnet.<br />
* Toidule saab anda hindeid ja kuvatakse keskmist hinnet.<br />
<br />
== Nice-to-have funktsionaalsus ==<br />
<br />
* Info selle kohta, kas päevapakkumine on otsas<br />
* Päevapakkumisi/menüüsid saab kommenteerida ja neid kommentaare kuvatakse avalikult.<br />
* Söögikohtade kodulehtedelt otsimise script, mis genereerib juba olemasolevate kodulehtede baasil päevamenüüsid.<br />
* Toiduvaliku piiramine allergeenide/vegan/jms. koostisosade põhiselt.<br />
* Aruandlused ja võrdlused toidukohtadele, et võrrelda end konkurentidega.<br />
* Teenus soovitab toidukohtadele nende varasemate päevapraadide populaarsuse alusel uue nädala menüüd.<br />
* Erinevad toidukohtade/toitude pingeread klientidele, et anda valikuteks ideid.<br />
* Soovitused klientidele, mida teised kliendid sarnaste eelistustega on veel valinud.<br />
<br />
== Andmebaasi ülesehitus - projekti algus ==<br />
<br />
[[File: BeerPressureAndmebaasimudel.png]]<br />
<br />
== Andmebaasi ülesehitus - projekti lõpp ==<br />
<br />
[[File: Ta2isKo6ht-DB-FINAL.png]]<br />
<br />
== Projekti repository ==<br />
<br />
https://github.com/sikumiku/TaisKohtApi<br />
<br />
Zip fail saadaval: <br />
(master branchi viimane commit esitamise ajal)<br />
https://github.com/sikumiku/TaisKohtApi/archive/61438e187a1a972410c8a3bc6274d69489d00aa6.zip<br />
<br />
== API v1 dokumentatsioon ==<br />
<br />
===Security===<br />
'''POST /api/account/register'''<br />
<source><br />
Params: RegisterViewModel registerViewModel<br />
<br />
Returns: token<br />
</source><br />
<br />
'''POST /api/account/login'''<br />
<source> <br />
Params: LoginViewModel model<br />
<br />
Returns: token<br />
</source><br />
<br />
'''POST /api/account/logout'''<br />
<source> <br />
Params: -<br />
<br />
Returns: -<br />
</source><br />
<br />
===Accounts===<br />
'''GET /api/v1/accounts/getAllUsersInRole'''<br />
<source> <br />
Params: string role<br />
<br />
Returns: List<UserDTO><br />
</source><br />
<br />
'''GET /api/v1/accounts/{id}'''<br />
<source> <br />
Params: string id<br />
<br />
Returns: UserDTO<br />
</source><br />
<br />
'''PUT /api/v1/accounts/{id}'''<br />
<source> <br />
Params: string id, UpdateUserDTO userDTO<br />
<br />
Returns: -<br />
</source><br />
<br />
'''POST /api/v1/accounts/addRole'''<br />
<source> <br />
Params: string role<br />
<br />
Returns: -<br />
</source><br />
<br />
'''POST /api/v1/accounts/addRoleToUser'''<br />
<source> <br />
Params: string role, string userId<br />
<br />
Returns: UserDTO<br />
</source><br />
<br />
'''DELETE /api/v1/accounts/deactivate/{id}'''<br />
<source> <br />
Params: string id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Promotions===<br />
'''GET /api/v1/promotions '''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<PromotionDTO> <br />
</source><br />
<br />
'''GET /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: PromotionDTO<br />
</source><br />
<br />
'''POST /api/v1/promotions'''<br />
<source> <br />
Params: PromotionDTO promotionDTO<br />
<br />
Returns: PromotionDTO newPromotion<br />
</source><br />
<br />
'''PUT /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id, PromotionDTO promotionDTO<br />
<br />
Returns: PromotionDTO updatedPromotion<br />
</source><br />
<br />
'''DELETE /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Restaurants===<br />
'''GET /api/v1/restaurants'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<SimpleRestaurantDTO><br />
</source><br />
<br />
'''GET /api/v1/restaurants/search?name=th'''<br />
<source> <br />
Params: string name<br />
<br />
Returns: List<SimpleRestaurantDTO> result<br />
</source><br />
<br />
'''GET /api/v1/restaurants/top'''<br />
<source> <br />
Params: int amount<br />
<br />
Returns: List<SimpleRestaurantDTO> result<br />
</source><br />
<br />
'''GET /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: RestaurantDTO r<br />
</source><br />
<br />
'''POST /api/v1/restaurants/addUserToRestaurant'''<br />
<source> <br />
Params: int id, string userId<br />
<br />
Returns: -<br />
</source><br />
<br />
'''POST /api/v1/restaurants'''<br />
<source> <br />
Params: PostRestaurantDTO restaurantDTO<br />
<br />
Returns: RestaurantDTO newRestaurant<br />
</source><br />
<br />
'''PUT /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id, PostRestaurantDTO restaurantDTO<br />
<br />
Returns: PostRestaurantDTO updatedRestaurantDTO<br />
</source><br />
<br />
'''DELETE /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Menus===<br />
'''GET /api/v1/menus'''<br />
<source><br />
Params: -<br />
<br />
Returns: List<MenuDTO><br />
</source><br />
<br />
'''GET /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: MenuDTO menuDTO<br />
</source><br />
<br />
'''POST /api/v1/menus'''<br />
<source> <br />
Params: PostMenuDTO menuDTO<br />
<br />
Returns: MenuDTO newMenu<br />
</source><br />
<br />
'''PUT /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id, PostMenuDTO menuDTO<br />
<br />
Returns: MenuDTO updatedMenu<br />
</source><br />
<br />
'''PUT api/v1/Menus/{id}/Dishes'''<br />
<source> <br />
Params: int menuId, int[] dishIds<br />
<br />
Returns: -<br />
</source><br />
<br />
'''DELETE /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Dishes===<br />
'''GET /api/v1/dishes'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<DishDTO><br />
</source><br />
<br />
'''GET /api/v1/dishes/daily'''<br />
<source> <br />
Params: bool vegan, bool glutenFree, bool lactoseFree<br />
<br />
Returns: List<SimpleDishDTO> result<br />
</source><br />
<br />
'''GET: api/v1/dishes/search?title=th&priceLimit=null'''<br />
<source> <br />
Params: string title, decimal? priceLimit<br />
<br />
Returns: List<DishDTO> result<br />
</source><br />
<br />
'''GET /api/v1/dishes/top'''<br />
<source> <br />
Params: int amount<br />
<br />
Returns: List<DishDTO> result<br />
</source><br />
<br />
'''GET /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: DishDTO dishDTO<br />
</source><br />
<br />
'''POST /api/v1/dishes'''<br />
<source> <br />
Params: PostDishDTO dishDTO<br />
<br />
Returns: DishDTO newDish<br />
</source><br />
<br />
'''PUT /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id, PostDishDTO dishDTO<br />
<br />
Returns: DishDTO updatedDish<br />
</source><br />
<br />
'''PUT api/v1/Dishes/{id}/Ingredients'''<br />
<source> <br />
Params: int dishId, PostIngredientForDishDTO[] ingredients<br />
<br />
Returns: -<br />
</source><br />
<br />
'''DELETE /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Ingredients===<br />
'''GET /api/v1/ingredients'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<IngredientDTO><br />
</source><br />
<br />
'''GET /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: IngredientDTO i<br />
</source><br />
<br />
'''POST /api/v1/ingredients'''<br />
<source> <br />
Params: PostIngredientDTO ingredientDTO<br />
<br />
Returns: IngredientDTO newIngredient<br />
</source><br />
<br />
'''PUT /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id, PostIngredientDTO ingredientDTO<br />
<br />
Returns: IngredientDTO updatedIngredient<br />
</source><br />
<br />
'''DELETE /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Ratings===<br />
'''GET /api/v1/ratings'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<RatingLogDTO><br />
</source><br />
<br />
'''GET /api/v1/ratings/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: RatingLogDTO dto<br />
</source><br />
<br />
'''POST /api/v1/ratings'''<br />
<source> <br />
Params: RatingLogForEntityDTO ratingDTO<br />
<br />
Returns: RatingLogDTO newRating<br />
</source><br />
<br />
'''PUT api/v1/ratings/{id}'''<br />
<source> <br />
Params: int id, RatingLogForEntityDTO ratingDTO<br />
<br />
Returns: RatingLogDTO updatedRating<br />
</source><br />
<br />
'''DELETE api/v1/ratings/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===RequestLog===<br />
'''GET: api/v1/usageData/{userId}'''<br />
<source> <br />
Params: string userId<br />
<br />
Returns: List<RequestLogDTO><br />
</source><br />
<br />
== Lõpptoote kasutusjuhend ==<br />
<br />
* Kloonida kohalikku arvutisse repository aadressilt [https://github.com/sikumiku/TaisKohtApi https://github.com/sikumiku/TaisKohtApi]<br />
* Installida NodeJS<br />
* <source>npm install webpack -g</source><br />
* <source>npm install -cli -g</source><br />
* Frontend rakenduse kasutamiseks valida Startup meetoditest IIS Express, veebiteenuse ja Swaggeri kasutamiseks käivitada Api Swagger<br />
* Esimese admin kasutaja loomiseks tuleb kasutaja registreerida admin@gmail.com e-mailiga<br />
<br />
== XML/XSD/XSLT ==<br />
<br />
=== XML ===<br />
<br />
<source><?xml version="1.0" encoding="utf-8" ?><br />
<?xml-stylesheet type="text/xsl" href="XMLFileXML.xslt"?><br />
<restaurants><br />
<restaurant id="1" url="https://kuuspelmeeni.ee" contactnumber="507783342" email="kuuspelmeeni@gmail.com"><br />
<name><![CDATA[Kuus Pelmeeni]]></name><br />
<menus><br />
<menu id="1" repetitioninterval="30"><br />
<name><![CDATA[Päevamenüü]]></name><br />
<activefrom>2018-05-27T12:00:00</activefrom><br />
<activeto>2018-05-28T12:00:00</activeto><br />
<dishes><br />
<dish id="1" vegan="false" lactosefree="false" glutenfree="false" daily="true" kcal="550" dailyprice="4"><br />
<title><![CDATA[8 pelmeeni]]></title><br />
<description><![CDATA[8 pelmeeni 6 asemel serveeritud tervisliku koguse hapukoore ja tilliga]]></description><br />
<availablefrom>2018-05-27T12:00:00</availablefrom><br />
<availableto>2018-05-28T12:00:00</availableto><br />
<ingredients><br />
<ingredient id="1" amountunit="g"><br />
<name>Sealiha</name><br />
<description>Rakvere sealiha</description><br />
</ingredient><br />
<ingredient id="2" amountunit="g"><br />
<name>Hapukoor</name><br />
<description>Alma hapukoor</description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="9"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Parim päevaroog viimasel ajal.]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
</comments><br />
</rating><br />
<promotion id="1" type="visual" classname="bold-red-border-2px"><br />
<name>2px red border</name><br />
<description><![CDATA[Displays a 2px wide red border around the component that is promoted.]]></description><br />
<validto>2018-06-25T12:00:00</validto><br />
</promotion><br />
</dish><br />
<dish id="2" vegan="true" lactosefree="true" glutenfree="true" daily="true" kcal="320" price="4"><br />
<title><![CDATA[Kurgisalat]]></title><br />
<description><![CDATA[Erinevatel viisidel töödeldud kurk serveeritud koos jõhvikatega. Tervislik amps.]]></description><br />
<availablefrom>2018-05-27T12:00:00</availablefrom><br />
<availableto>2018-05-28T12:00:00</availableto><br />
<ingredients/><br />
<rating ratingvalue="4"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Jäin veel väga näljaseks peale selle söömist.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
</dishes><br />
</menu><br />
<menu id="2"><br />
<name><![CDATA[Põhimenüü]]></name><br />
<dishes><br />
<dish id="4" vegan="false" lactosefree="false" glutenfree="false" daily="false" kcal="550" price="5"><br />
<title><![CDATA[6 pelmeeni]]></title><br />
<description><![CDATA[6 pelmeeni serveeritud tervisliku koguse hapukoore ja tilliga]]></description><br />
<ingredients><br />
<ingredient id="1" amountunit="g"><br />
<name>Sealiha</name><br />
<description>Rakvere sealiha</description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="9.5"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Käin seda iga päev söömas.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Parim toit selles restoranis.]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
<dish id="5" vegan="false" lactosefree="false" glutenfree="true" daily="false" kcal="460" price="3.8"><br />
<title><![CDATA[Kartulisalat]]></title><br />
<description><![CDATA[Sinki sisaldav traditsiooniline kartulisalat.]]></description><br />
<ingredients/><br />
</dish><br />
<dish id="6" vegan="false" lactosefree="false" glutenfree="false" daily="false" kcal="610" price="3.9"><br />
<title><![CDATA[Šokolaadikook]]></title><br />
<description><![CDATA[Ahvatlev glasuuritud šokolaadikook.]]></description><br />
<ingredients/><br />
<rating ratingvalue="7.8"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Šokolaadikooki on keeruline metsa keerata.]]></commenttext><br />
<username>mutikas3</username><br />
<userid>3a29b94a-3f17-469d-a44d-f7d85e98dd3e</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
</dishes><br />
</menu><br />
</menus><br />
<dishes/><br />
<address id="1" country="Eesti"><br />
<addressfirstline>Tatari 12</addressfirstline><br />
<locality>Tallinn</locality><br />
<postcode>10132</postcode><br />
<region>Harjumaa</region><br />
</address><br />
<promotion/><br />
<rating ratingvalue="7.5"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Parim restoran üldse!]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Ma sain ainult 5 pelmeeni. Ootasin kuute.]]></commenttext><br />
<username>kyllikekallike1</username><br />
<userid>6af271dd-0e11-4ae6-98be-111762664318</userid><br />
</comment><br />
</comments><br />
</rating><br />
</restaurant><br />
<restaurant id="2" url="https://kolmkokka.ee" contactnumber="6522351" email="kolmkokka@gmail.com"><br />
<name><![CDATA[Kolm kokka]]></name><br />
<menus/><br />
<dishes><br />
<dish id="7" vegan="false" lactosefree="true" glutenfree="false" daily="false" kcal="470" price="14"><br />
<title><![CDATA[Ahjulõhe juurikatega]]></title><br />
<description><![CDATA[Ahjulõhe serveeritud püreestatud porgandite ja lillkapsaga.]]></description><br />
<ingredients><br />
<ingredient id="11" amountunit="tk" amount="1"><br />
<name>Ahjulõhe</name><br />
<description><![CDATA[Värske ahjulõhe]]></description><br />
</ingredient><br />
<ingredient id="12" amountunit="g"><br />
<name>Püreestatud porgand</name><br />
<description><![CDATA[Eesti porgand, mis on kergelt püreestatud]]></description><br />
</ingredient><br />
<ingredient id="13" amountunit="g"><br />
<name>Püreestatud lillkapsas</name><br />
<description><![CDATA[Eesti lillkapsas, mis on kergelt püreestatud ja maitsestatud]]></description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="8.9"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Kindlasti minu üks lemmikuid.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Pole midagi halba öelda.]]></commenttext><br />
<username>tiiuviiu</username><br />
<userid>0730a7b7-3a9c-4e26-962f-da9a8daeab8a</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
<dish id="8" vegan="true" lactosefree="true" glutenfree="true" daily="true" dailyprice="5"><br />
<title><![CDATA[Ingverisupp]]></title><br />
<description><![CDATA[Ingveriga vürtsistatud ingverisupp, mis viib keele alla.]]></description><br />
<availablefrom>2018-05-25T12:00:00</availablefrom><br />
<availableto>2018-06-25T12:00:00</availableto><br />
<ingredients><br />
<ingredient id="14" amountunit="g" amount="20"><br />
<name>Ingver</name><br />
<description><![CDATA[Tükeldatud ingver]]></description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="6"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Liiga palju ingverit.]]></commenttext><br />
<username>kyllikekallike1</username><br />
<userid>6af271dd-0e11-4ae6-98be-111762664318</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
<dish id="9" vegan="false" lactosefree="false" glutenfree="true" daily="false" kcal="340" price="4.5"><br />
<title><![CDATA[Apelsinijäätis]]></title><br />
<description><![CDATA[Apelsinimaitseline jäätis serveeritud riivitud apelsinikoorega.]]></description><br />
<ingredients/><br />
<rating ratingvalue="8"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Väga huvitav magustoit, prooviks veel.]]></commenttext><br />
<username>mutikas3</username><br />
<userid>3a29b94a-3f17-469d-a44d-f7d85e98dd3e</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Üks mu lemmikuid magustoite.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
</dishes><br />
<address id="2" country="Eesti"><br />
<addressfirstline>Laia 12</addressfirstline><br />
<locality>Tallinn</locality><br />
<postcode>13022</postcode><br />
<region>Harjumaa</region><br />
</address><br />
<promotion/><br />
<rating ratingvalue="8.1"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Hinnad on natuke liiga kallid minu jaoks, aga toit om maitsev.]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Ma kindlasti telliks kala uuesti. Väga mahlakas oli.]]></commenttext><br />
<username>kyllikekallike1</username><br />
<userid>6af271dd-0e11-4ae6-98be-111762664318</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Asukoht oli päris tore. Miljöö ka.]]></commenttext><br />
<username>mutikas3</username><br />
<userid>3a29b94a-3f17-469d-a44d-f7d85e98dd3e</userid><br />
</comment><br />
</comments><br />
</rating><br />
</restaurant><br />
</restaurants></source><br />
<br />
=== XSD ===<br />
<br />
<source><?xml version="1.0" encoding="utf-8"?><br />
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema"><br />
<xs:element name="restaurants"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="restaurant"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="menus"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="menu"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="activefrom" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="activeto" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="dishes"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="dish"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="title" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="availablefrom" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="availableto" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="servetime" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="ingredients"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="ingredient"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="amountunit" type="xs:string" use="required" /><br />
<xs:attribute name="amount" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="rating" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="comments"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="comment"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="commenttext" type="xs:string" /><br />
<xs:element name="username" type="xs:string" /><br />
<xs:element name="userid" type="xs:string" /><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="ratingvalue" type="xs:decimal" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="validto" type="xs:dateTime" minOccurs="0" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="type" type="xs:string" use="required" /><br />
<xs:attribute name="classname" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="vegan" type="xs:boolean" use="optional" /><br />
<xs:attribute name="lactosefree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="glutenfree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="daily" type="xs:boolean" use="optional" /><br />
<xs:attribute name="kcal" type="xs:int" use="optional" /><br />
<xs:attribute name="weightg" type="xs:decimal" use="optional" /><br />
<xs:attribute name="price" type="xs:decimal" use="optional" /><br />
<xs:attribute name="dailyprice" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="validto" type="xs:dateTime" minOccurs="0" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="type" type="xs:string" use="required" /><br />
<xs:attribute name="classname" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="repetitioninterval" type="xs:int" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="dishes"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="dish"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="title" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="availablefrom" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="availableto" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="servetime" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="ingredients"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="ingredient"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="amountunit" type="xs:string" use="required" /><br />
<xs:attribute name="amount" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="rating"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="comments"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="comment"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="commenttext" type="xs:string" /><br />
<xs:element name="username" type="xs:string" /><br />
<xs:element name="userid" type="xs:string" /><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="ratingvalue" type="xs:decimal" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="validto" type="xs:dateTime" minOccurs="0" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="type" type="xs:string" use="required" /><br />
<xs:attribute name="classname" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="vegan" type="xs:boolean" use="optional" /><br />
<xs:attribute name="lactosefree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="glutenfree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="daily" type="xs:boolean" use="optional" /><br />
<xs:attribute name="kcal" type="xs:int" use="optional" /><br />
<xs:attribute name="weightg" type="xs:decimal" use="optional" /><br />
<xs:attribute name="price" type="xs:decimal" use="optional" /><br />
<xs:attribute name="dailyprice" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="address"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="addressfirstline" type="xs:string" /><br />
<xs:element name="locality" type="xs:string" /><br />
<xs:element name="postcode" type="xs:string" /><br />
<xs:element name="region" type="xs:string" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="country" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion" /><br />
<xs:element name="rating" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="comments"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="comment"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="commenttext" type="xs:string" /><br />
<xs:element name="username" type="xs:string" /><br />
<xs:element name="userid" type="xs:string" /><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="ratingvalue" type="xs:decimal" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="url" type="xs:string" use="required" /><br />
<xs:attribute name="contactnumber" type="xs:string" use="required" /><br />
<xs:attribute name="email" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:schema></source><br />
<br />
=== XSLT(HTML) ===<br />
<br />
<source><?xml version="1.0" encoding="utf-8" ?><br />
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:msxsl="urn:schemas-microsoft-com:xslt" exclude-result-prefixes="msxsl"><br />
<xsl:output method="html" indent="yes"/><br />
<xsl:template match="/restaurants"><br />
<html><br />
<head><br />
<title>Täis Kõht</title><br />
</head><br />
<body><br />
<xsl:for-each select="restaurant"><br />
<h1 style="color:DodgerBlue"><br />
<xsl:value-of select="name"/><br />
</h1><br />
<div><br />
<xsl:value-of select="@url"/><br />
</div><br />
<div><br />
<xsl:text>Kontakt number: </xsl:text><br />
<xsl:value-of select="@contactnumber"/><br />
</div><br />
<div><br />
<xsl:text>email: </xsl:text><br />
<xsl:value-of select="@email"/><br />
</div><br />
<div><br />
<xsl:text>Aadress: </xsl:text><br />
<xsl:value-of select="address/addressfirstline"/><br />
<xsl:text>, </xsl:text><br />
<xsl:value-of select="address/locality"/><br />
<xsl:text>, </xsl:text><br />
<xsl:value-of select="address/postcode"/><br />
<xsl:text>, </xsl:text><br />
<xsl:value-of select="address/@country"/><br />
</div><br />
<br />
<xsl:choose><br />
<xsl:when test="menus/menu"><br />
<xsl:for-each select="menus/menu"><br />
<xsl:sort select="name"/><br />
<h3><br />
<xsl:value-of select="name"/><br />
</h3><br />
<br />
<xsl:if test="activefrom != '' and activeto != ''"><br />
<xsl:text> </xsl:text><br />
<xsl:value-of select="substring(activefrom,1,10)"/><br />
<xsl:text> kuni </xsl:text><br />
<xsl:value-of select="substring(activeto,1,10)"/><br />
</xsl:if><br />
<br />
<ul><br />
<xsl:for-each select="dishes/dish"><br />
<xsl:sort select="title"/><br />
<br />
<xsl:if test="availablefrom != '' and availableto != ''"><br />
<xsl:value-of select="substring(availablefrom,1,10)"/><br />
<xsl:text> kuni </xsl:text><br />
<xsl:value-of select="substring(availableto,1,10)"/><br />
</xsl:if><br />
<br />
<li><br />
<span style="font-weight:bold"><br />
<xsl:value-of select="title"/><br />
</span><br />
<xsl:text> - </xsl:text><br />
<xsl:value-of select="description"/><br />
<xsl:text> </xsl:text><br />
<span style="font-weight:bold"><br />
<xsl:if test="@glutenfree='true'"><br />
<xsl:text>G </xsl:text><br />
</xsl:if><br />
<xsl:if test="@lactosefree='true'"><br />
<xsl:text>L </xsl:text><br />
</xsl:if><br />
<xsl:if test="@vegan='true'"><br />
<xsl:text>V </xsl:text><br />
</xsl:if><br />
</span><br />
</li><br />
<br />
<xsl:for-each select="ingredients/ingredient"><br />
<xsl:value-of select="name"/><br />
<xsl:if test="position()!=last()"><br />
<xsl:text>, </xsl:text><br />
</xsl:if><br />
</xsl:for-each><br />
<br />
<p style="font-weight:bold"><br />
<xsl:text>Hind: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="@price!=''"><br />
<xsl:value-of select="@price"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>-</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
<xsl:text> / Päevapakkumise hind: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="@dailyprice!=''"><br />
<xsl:value-of select="@dailyprice"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>-</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
</p><br />
<br />
<div style="background-color:LightGray;"><br />
<xsl:text>Hinnang praele: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="rating/@ratingvalue!=''"><br />
<xsl:value-of select="rating/@ratingvalue"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>Ei ole veel hinnatud!</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
<br />
<br/><br />
<xsl:for-each select="rating/comments/comment"><br />
<xsl:value-of select="username"/><br />
<xsl:text>: </xsl:text><br />
<xsl:value-of select="commenttext"/><br />
<br/><br />
</xsl:for-each><br />
</div><br />
<br/><br />
</xsl:for-each><br />
</ul><br />
</xsl:for-each><br />
</xsl:when><br />
<xsl:otherwise><br />
<ul><br />
<xsl:for-each select="dishes/dish"><br />
<xsl:sort select="title"/><br />
<br />
<xsl:if test="availablefrom != '' and availableto != ''"><br />
<xsl:value-of select="substring(availablefrom,1,10)"/><br />
<xsl:text> kuni </xsl:text><br />
<xsl:value-of select="substring(availableto,1,10)"/><br />
</xsl:if><br />
<br />
<li><br />
<span style="font-weight:bold"><br />
<xsl:value-of select="title"/><br />
</span><br />
<xsl:text> - </xsl:text><br />
<xsl:value-of select="description"/><br />
<xsl:text> </xsl:text><br />
<span style="font-weight:bold"><br />
<xsl:if test="@glutenfree='true'"><br />
<xsl:text>G </xsl:text><br />
</xsl:if><br />
<xsl:if test="@lactosefree='true'"><br />
<xsl:text>L </xsl:text><br />
</xsl:if><br />
<xsl:if test="@vegan='true'"><br />
<xsl:text>V </xsl:text><br />
</xsl:if><br />
</span><br />
</li><br />
<br />
<xsl:for-each select="ingredients/ingredient"><br />
<xsl:value-of select="name"/><br />
<xsl:if test="position()!=last()"><br />
<xsl:text>, </xsl:text><br />
</xsl:if><br />
</xsl:for-each><br />
<br />
<p style="font-weight:bold"><br />
<xsl:text>Hind: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="@price!=''"><br />
<xsl:value-of select="@price"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>-</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
<xsl:text> / Päevapakkumise hind: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="@dailyprice!=''"><br />
<xsl:value-of select="@dailyprice"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>-</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
</p><br />
<br />
<div style="background-color:LightGray;"><br />
<xsl:text>Hinnang praele: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="rating/@ratingvalue!=''"><br />
<xsl:value-of select="rating/@ratingvalue"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>Ei ole veel hinnatud!</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
<br />
<br/><br />
<xsl:for-each select="rating/comments/comment"><br />
<xsl:value-of select="username"/><br />
<xsl:text>: </xsl:text><br />
<xsl:value-of select="commenttext"/><br />
<br/><br />
</xsl:for-each><br />
</div><br />
<br/><br />
</xsl:for-each><br />
</ul><br />
</xsl:otherwise><br />
</xsl:choose><br />
<br />
<div style="background-color:LightGray;"><br />
<xsl:text>Hinnang restoranile: </xsl:text><br />
<xsl:choose><br />
<xsl:when test="rating/@ratingvalue!=''"><br />
<xsl:value-of select="rating/@ratingvalue"/><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:text>Ei ole veel hinnatud!</xsl:text><br />
</xsl:otherwise><br />
</xsl:choose><br />
<br />
<br />
<br/><br />
<xsl:for-each select="rating/comments/comment"><br />
<xsl:value-of select="username"/><br />
<xsl:text>: </xsl:text><br />
<xsl:value-of select="commenttext"/><br />
<br/><br />
</xsl:for-each><br />
</div><br />
<br />
<p><br />
<xsl:text>*G - gluteenivaba, </xsl:text><br />
<xsl:text>L - laktoosivaba, </xsl:text><br />
<xsl:text>V - vegan </xsl:text><br />
</p><br />
<br />
</xsl:for-each><br />
</body><br />
</html><br />
</xsl:template><br />
</xsl:stylesheet></source><br />
<br />
=== XSLT(XML) ===<br />
<br />
XML'is kuvatakse elemendid ja atribuudid eesti keeles. Kuvatakse restorani andmed ja toidud, mille hinnang on 8 või rohkem punkti.<br />
<br />
<source><?xml version="1.0" encoding="utf-8" ?><br />
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"<br />
xmlns:msxsl="urn:schemas-microsoft-com:xslt" exclude-result-prefixes="msxsl"><br />
<xsl:output method="xml" indent="yes"/><br />
<br />
<xsl:template match="/restaurants"><br />
<restoranid><br />
<xsl:for-each select="restaurant"><br />
<restoran url="{@url}" telefon="{@contactnumber}" email="{@email}"><br />
<nimi><br />
<xsl:value-of select="name"/><br />
</nimi><br />
<aadress><br />
<postiaadress><br />
<xsl:value-of select="address/addressfirstline"/><br />
</postiaadress><br />
<linn><br />
<xsl:value-of select="address/locality"/><br />
</linn><br />
<indeks><br />
<xsl:value-of select="address/postcode"/><br />
</indeks><br />
<riik><br />
<xsl:value-of select="address/@country"/><br />
</riik><br />
</aadress><br />
<br />
<parimadToidud><br />
<xsl:choose><br />
<xsl:when test="menus/menu/dishes/dish"><br />
<xsl:for-each select="menus/menu/dishes/dish"><br />
<xsl:if test="rating/@ratingvalue &gt;= 8.0"><br />
<heaToit hinnang="{rating/@ratingvalue}" paevaPakkumiseHind="{@dailyprice}" hind="{@price}" <br />
vegan="{@vegan}" laktoosivaba="{@lactosefree}" gluteenivaba="{@glutenfree}"><br />
<nimi><br />
<xsl:value-of select="title"/><br />
</nimi><br />
<kirjeldus><br />
<xsl:value-of select="description"/><br />
</kirjeldus><br />
</heaToit><br />
</xsl:if><br />
</xsl:for-each><br />
</xsl:when><br />
<xsl:otherwise><br />
<xsl:for-each select="dishes/dish"><br />
<xsl:if test="rating/@ratingvalue &gt;= 8.0"><br />
<heaToit hinnang="{rating/@ratingvalue}" paevaPakkumiseHind="{@dailyprice}" hind="{@price}" <br />
vegan="{@vegan}" laktoosivaba="{@lactosefree}" gluteenivaba="{@glutenfree}"><br />
<nimi><br />
<xsl:value-of select="title"/><br />
</nimi><br />
<kirjeldus><br />
<xsl:value-of select="description"/><br />
</kirjeldus><br />
</heaToit><br />
</xsl:if><br />
</xsl:for-each><br />
</xsl:otherwise><br />
</xsl:choose><br />
</parimadToidud><br />
</restoran><br />
</xsl:for-each><br />
</restoranid><br />
</xsl:template><br />
</xsl:stylesheet><br />
</source><br />
<br />
== Retsensioonid ==<br />
<br />
== Logiraamat ==<br />
<br />
===07.02.2018===<br />
Gupi loomine ning suhtluskanali seadistamine<br />
<br />
=== 24.03.2018 ===<br />
Trello boardi loomine<br />
<br />
=== 25.03.2018 ===<br />
Wiki lehe loomine. Esimene tõsisem projekti koosolek ning tegevuskava paika panemine.<br />
<br />
=== 26.03.2018 ===<br />
<br />
Alustasime veebiteenuse analüüsiga ja funktsionaalsuse kirjeldamisega.<br />
<br />
=== 27.03.2018 ===<br />
Täiendasime veebiteenuse analüüsi.<br />
<br />
Esmase andmebaasi mudeli koostamine.<br />
<br />
Postitatud esimeste analüüsi arutelude põhjal valminud algne prototüüp.<br />
<br />
=== 30.03.2018 ===<br />
Valmis andmebaasimudel.<br />
<br />
=== 08.04.2018 ===<br />
Tehtud muudatused analüüsis vastavalt tagasisidele.<br />
<br />
=== 19.04.2018 ===<br />
Loodud projekti põhi koos domeenimudelitega. Projekt lisatud Githubi: https://github.com/sikumiku/TaisKohtApi<br />
<br />
=== 05-06.05.2018 ===<br />
Osalesime hackathonil. Lisatud controllerid, service'id koos vajalike kihtidega.<br />
<br />
=== 16.05.2018 ===<br />
Uuendatud andmebaasimudelit, DTO'sid.<br />
<br />
=== 18-19.05.2018 ===<br />
Lisatud klientrakendus, security, äriloogikat.<br />
<br />
=== 20.05.2018 ===<br />
Lisatud API dokumentatsioon.<br />
<br />
=== 22-24.05.2018 ===<br />
Uuendatud contoller'eid, service'id.<br />
<br />
=== 25-27.05.2018 ===<br />
Uuendatud contoller'eid, service'id. Lisatud kasutajate ja rollide kontrolle meetoditesse. Täiustatud klientrakendust. Swagger dokumentatsioon.<br />
<br />
=== 31.05-01.06.2018 ===<br />
Tegeletud XML, XSD ja XSLT failide loomisega.</div>
Saasma
https://wiki.itcollege.ee/index.php?title=BeerPressure&diff=131109
BeerPressure
2018-06-02T21:28:40Z
<p>Saasma: /* XML/XSD/XSLT */</p>
<hr />
<div>== Meeskond ja rollid ==<br />
<br />
* Sigrid Aasma (arendaja)<br />
* Evelin Jõgi (arendaja)<br />
* Martin Kask (projektijuht, arendaja)<br />
* Marko Nõu (arendaja)<br />
<br />
== Idee ==<br />
'''Toidukohtade põhimenüüde ja päevapakkumiste teenus'''<br />
<br />
Soovime pakkuda toidukohtade põhimenüüde ja päevapakkumiste teenust. On olemas mitmeid kodulehti “päevapakkumised”, kus on kirjas toidukohtade päevapraed. Kuid tavaliselt sellistel lehtedel ei ole masinloetavaid andmeid ehk siis varianti, et saad saata API pihta mingi kuupäeva koos päevapraadidega andmete uuendamiseks ja saad sama API käest küsida tänaseid päevapraade. Andmeid võiks saada küsida restorani, kuupäeva, asukoha või otsisõna/otsisõnaosa põhiselt. Selline teenus lihtsustaks ka toidukohtade päevapakkumiste haldamist, kuna praegu peavad teenuse pakkujad vastavat informatsiooni uuendama mitmes erinevas kohas - nii erinevates portaalides, kui ka enda veebileheküljel. Samuti oleks toidukohtade kogu menüü haldamine ühes kohas.<br />
<br />
=== Esialgne prototüüp ===<br />
<br />
[[File:TäisKõhtProto1.mp4]]<br />
<br />
Esialgne prototüüp: [http://enos.itcollege.ee/~saasma/VR2/Proto/K%C3%B5htT%C3%A4is/#g=1&p=home navigeeritav versioon vol.1]<br />
<br />
=== Prototüübi muutus projekti käigus ===<br />
<br />
Prototüüp: [http://enos.itcollege.ee/~saasma/VR2/Proto/T%C3%A4isK%C3%B5ht/K%C3%B5htT%C3%A4is/#g=1&p=home navigeeritav versioon vol.2]<br />
<br />
== Kasutatav arendustehnoloogia ==<br />
<br />
Veebiteenuse loomisel kasutame ASP.NET Core tehnoloogiat ja kursusel õpitud arendusmustreid.<br />
<br />
Klientrakenduse loomisel kasutame Node.js + React'i.<br />
<br />
== Veebiteenuse analüüs ==<br />
Pakume toidukohtade põhimenüüde ja päevapakkumiste teenust, kuhu on kokku koondatud erinevate toidukohtade menüüd üle Eesti. Põhimenüü alla kuuluvad pikaajalised menüüd, mis kehtivad püsivalt, hooajaliselt või mingil konkreetsel nädalapäeval. Päevapakkumiste alla kuuluvad konkreetse kuupäevaga seotud päevapakkumised. Päevapakkumiste korral kuvatakse lisainfona, kas pakkumine kehtib mingis konkreetses ajavahemikus või kogu toidukoha lahtioleku aja.<br />
<br />
Eesmärk on koguda ühte kohta kokku erinevate toidukohtade menüüd ja päevapakkumised, et kliendid saaksid mugavalt ja kiiresti oma valikuid teha. Kliendid käivad enamasti päevapakkumisi söömas lõuna ajal ja selleks ettenähtud aeg on piiratud. Sellepärast on oluline, et klient saaks teha oma valiku võimalikult kiiresti. Tänu loodavale veebiteenusele ei pea kliendid käima erinevates portaalides, et tutvuda erinevate toidukohtade pakkumistega. Kuna teenust on mugav kasutada ja klient saab oma valiku kiiresti tehtud, siis tõenäoliselt teeb klient valiku selles keskkonnas olevate toiduasutuste seast. Lisaks võimaldab teenus toiduasutustel paika panna oma pikaajalisem põhimenüü ning seda rakenduses ja võimalusel ka söögikohas kuvada. Sellepärast on ka toidukohtade huvi antud keskkonnas üleval olla ja meiega oma andmeid jagada, sest see suurendab nende klientuuri ning muudab oma menüü haldamise kergemaks.<br />
<br />
Veebiteenuse loomisel lähtume eelkõige sellest, et kliendil oleks teenust mugav kasutada ja ta saaks oma valiku kiiresti tehtud. Arvestame, et kliendid on erinevad. Mõni eelistab mõnda kindlat toidukohta, sel juhul saab ta valida oma soovitud kohad ja võrrelda nende kohtade tänase päeva pakkumisi ning menüüsid. Mõnele inimesele on oluline pakutav söök ja ta eelistab pakkumist otsida prae nimetuses oleva sõna või sõnaosa järgi ning lähtuda seejärel valiku tegemisel toidukoha keskmisest hindest või toidu hinnast. Mõne kliendi jaoks on oluline hind ja selleks, et oma valikut teha sobivas hinnavahemikus on tal võimalik sisestada maksimum hinna piirang. Kindlasti on antud teenuse juures kõikide klientide jaoks oluline päevapakkumiste asukohapõhine eristatus. Kliendid, kes soovivad oma konto luua, võivad oma eelistatud valikud meelde jätta ja järgmisel korral kuvatakse neid talle automaatselt.<br />
<br />
Teenuse must-have funktsionaalsus tagab teenuse toimimise ja põhifunktsioonid. Teenuse nice-to-have funktsionaalsus annab rakendusele lisandväärtust.<br />
<br />
Arvestades pakutava teenusega, siis näeme, et aktiivseim teenuse kasutamine võib olla tööpäevadel vahemikus 11.00-15.00, kui kliendid tutvuvad päevapakkumistega. Teenus peab tekkivale koormusele vastu pidama.<br />
<br />
Teenuse pakkumine peab olema turvaline. Selle tagamiseks tuleb sisestatavaid andmeid valideerida ja andmebaasi sisestavate andmete mahtu piirata. Toidukohtade sisestatud andmed peavad olema kaitstud, et toitude koostised ei saaks avalikuks. Põhjendatud juhtudel on võimalik kasutajaid lukku panna.<br />
<br />
== Kasutajad ==<br />
<br />
<br />
* Admin - lehe administraator, kellel on õigus lehte, kasutajaid ja nende õiguseid hallata. Tema huvi on, et teenus toimiks tõrgeteta.<br />
* Toiduasutus (tasuta kasutaja) - saab hoida lehel ühte põhimenüüd ja päevapakkumisi.<br />
* Toiduasutus (tellimusega kasutaja) - saab hoida lehel piiramatu arv põhimenüüsid ja päevapakkumisi.<br />
Toiduasutused on teenusest huvitatud, et nende menüüde haldamine oleks kerge ja mugav ning nad saaksid oma klientide arvu suurendada.<br />
* Külastaja - klient, kes valib söögikohta. Tema on huvitatud eelkõige sellest, et teenust saaks kasutada mugavalt ja kiirelt ning toidukohtade valik oleks võimalikult suur.<br />
<br />
== Rakenduse must-have funktsionaalsus ==<br />
<br />
* Kasutajad saavad sisse logida<br />
* Kasutajatel on erinevad rollid: admin, toidukoht (tasuta ja tasulise tellimusega), klient<br />
* Kasutajate arvepidamine kasutajate lõikes:<br />
** sisselogimise kuupäev, kellaaeg<br />
** pakkumiste lisamine<br />
** pakkumiste muutmine<br />
** pakkumiste kustutamine<br />
** õiguste kehtimise periood (tasuta ja tellimusega toidukoht)<br />
** pakkumistele klikkimise arv<br />
* Kasutajaid on võimalik hallata:<br />
** kasutajale õiguste andmine (menüüde arvu suurendamine, tellimusega toidukohal), rolli määramine<br />
** Kasutajat on võimalik piirata: õiguseid piirata (piiratud menüüde arv, tasuta liitunud toidukohal) ja lukku panna<br />
* Päevapakkumisi/menüüsid saab küsida: <br />
** toidukoha järgi, <br />
** kuupäeva põhiselt (ainult päevapakkumisi), <br />
** asukoha põhiselt,<br />
** toidu nimetuses esineva otsisõna/otsisõna osa põhiselt,<br />
** hinna põhiselt (max hinna piirang).<br />
* Klientrakenduses realiseeritakse CRUD meetodid (menüüsid/päevapakkumisi saab sisestada, lugeda, uuendada, kustutada)<br />
* Toidukohale saab anda hindeid ja kuvatakse keskmist hinnet.<br />
* Toidule saab anda hindeid ja kuvatakse keskmist hinnet.<br />
<br />
== Nice-to-have funktsionaalsus ==<br />
<br />
* Info selle kohta, kas päevapakkumine on otsas<br />
* Päevapakkumisi/menüüsid saab kommenteerida ja neid kommentaare kuvatakse avalikult.<br />
* Söögikohtade kodulehtedelt otsimise script, mis genereerib juba olemasolevate kodulehtede baasil päevamenüüsid.<br />
* Toiduvaliku piiramine allergeenide/vegan/jms. koostisosade põhiselt.<br />
* Aruandlused ja võrdlused toidukohtadele, et võrrelda end konkurentidega.<br />
* Teenus soovitab toidukohtadele nende varasemate päevapraadide populaarsuse alusel uue nädala menüüd.<br />
* Erinevad toidukohtade/toitude pingeread klientidele, et anda valikuteks ideid.<br />
* Soovitused klientidele, mida teised kliendid sarnaste eelistustega on veel valinud.<br />
<br />
== Andmebaasi ülesehitus - projekti algus ==<br />
<br />
[[File: BeerPressureAndmebaasimudel.png]]<br />
<br />
== Andmebaasi ülesehitus - projekti lõpp ==<br />
<br />
[[File: Ta2isKo6ht-DB-FINAL.png]]<br />
<br />
== Projekti repository ==<br />
<br />
https://github.com/sikumiku/TaisKohtApi<br />
<br />
Zip fail saadaval: <br />
(master branchi viimane commit esitamise ajal)<br />
https://github.com/sikumiku/TaisKohtApi/archive/61438e187a1a972410c8a3bc6274d69489d00aa6.zip<br />
<br />
== API v1 dokumentatsioon ==<br />
<br />
===Security===<br />
'''POST /api/account/register'''<br />
<source><br />
Params: RegisterViewModel registerViewModel<br />
<br />
Returns: token<br />
</source><br />
<br />
'''POST /api/account/login'''<br />
<source> <br />
Params: LoginViewModel model<br />
<br />
Returns: token<br />
</source><br />
<br />
'''POST /api/account/logout'''<br />
<source> <br />
Params: -<br />
<br />
Returns: -<br />
</source><br />
<br />
===Accounts===<br />
'''GET /api/v1/accounts/getAllUsersInRole'''<br />
<source> <br />
Params: string role<br />
<br />
Returns: List<UserDTO><br />
</source><br />
<br />
'''GET /api/v1/accounts/{id}'''<br />
<source> <br />
Params: string id<br />
<br />
Returns: UserDTO<br />
</source><br />
<br />
'''PUT /api/v1/accounts/{id}'''<br />
<source> <br />
Params: string id, UpdateUserDTO userDTO<br />
<br />
Returns: -<br />
</source><br />
<br />
'''POST /api/v1/accounts/addRole'''<br />
<source> <br />
Params: string role<br />
<br />
Returns: -<br />
</source><br />
<br />
'''POST /api/v1/accounts/addRoleToUser'''<br />
<source> <br />
Params: string role, string userId<br />
<br />
Returns: UserDTO<br />
</source><br />
<br />
'''DELETE /api/v1/accounts/deactivate/{id}'''<br />
<source> <br />
Params: string id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Promotions===<br />
'''GET /api/v1/promotions '''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<PromotionDTO> <br />
</source><br />
<br />
'''GET /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: PromotionDTO<br />
</source><br />
<br />
'''POST /api/v1/promotions'''<br />
<source> <br />
Params: PromotionDTO promotionDTO<br />
<br />
Returns: PromotionDTO newPromotion<br />
</source><br />
<br />
'''PUT /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id, PromotionDTO promotionDTO<br />
<br />
Returns: PromotionDTO updatedPromotion<br />
</source><br />
<br />
'''DELETE /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Restaurants===<br />
'''GET /api/v1/restaurants'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<SimpleRestaurantDTO><br />
</source><br />
<br />
'''GET /api/v1/restaurants/search?name=th'''<br />
<source> <br />
Params: string name<br />
<br />
Returns: List<SimpleRestaurantDTO> result<br />
</source><br />
<br />
'''GET /api/v1/restaurants/top'''<br />
<source> <br />
Params: int amount<br />
<br />
Returns: List<SimpleRestaurantDTO> result<br />
</source><br />
<br />
'''GET /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: RestaurantDTO r<br />
</source><br />
<br />
'''POST /api/v1/restaurants/addUserToRestaurant'''<br />
<source> <br />
Params: int id, string userId<br />
<br />
Returns: -<br />
</source><br />
<br />
'''POST /api/v1/restaurants'''<br />
<source> <br />
Params: PostRestaurantDTO restaurantDTO<br />
<br />
Returns: RestaurantDTO newRestaurant<br />
</source><br />
<br />
'''PUT /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id, PostRestaurantDTO restaurantDTO<br />
<br />
Returns: PostRestaurantDTO updatedRestaurantDTO<br />
</source><br />
<br />
'''DELETE /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Menus===<br />
'''GET /api/v1/menus'''<br />
<source><br />
Params: -<br />
<br />
Returns: List<MenuDTO><br />
</source><br />
<br />
'''GET /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: MenuDTO menuDTO<br />
</source><br />
<br />
'''POST /api/v1/menus'''<br />
<source> <br />
Params: PostMenuDTO menuDTO<br />
<br />
Returns: MenuDTO newMenu<br />
</source><br />
<br />
'''PUT /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id, PostMenuDTO menuDTO<br />
<br />
Returns: MenuDTO updatedMenu<br />
</source><br />
<br />
'''PUT api/v1/Menus/{id}/Dishes'''<br />
<source> <br />
Params: int menuId, int[] dishIds<br />
<br />
Returns: -<br />
</source><br />
<br />
'''DELETE /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Dishes===<br />
'''GET /api/v1/dishes'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<DishDTO><br />
</source><br />
<br />
'''GET /api/v1/dishes/daily'''<br />
<source> <br />
Params: bool vegan, bool glutenFree, bool lactoseFree<br />
<br />
Returns: List<SimpleDishDTO> result<br />
</source><br />
<br />
'''GET: api/v1/dishes/search?title=th&priceLimit=null'''<br />
<source> <br />
Params: string title, decimal? priceLimit<br />
<br />
Returns: List<DishDTO> result<br />
</source><br />
<br />
'''GET /api/v1/dishes/top'''<br />
<source> <br />
Params: int amount<br />
<br />
Returns: List<DishDTO> result<br />
</source><br />
<br />
'''GET /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: DishDTO dishDTO<br />
</source><br />
<br />
'''POST /api/v1/dishes'''<br />
<source> <br />
Params: PostDishDTO dishDTO<br />
<br />
Returns: DishDTO newDish<br />
</source><br />
<br />
'''PUT /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id, PostDishDTO dishDTO<br />
<br />
Returns: DishDTO updatedDish<br />
</source><br />
<br />
'''PUT api/v1/Dishes/{id}/Ingredients'''<br />
<source> <br />
Params: int dishId, PostIngredientForDishDTO[] ingredients<br />
<br />
Returns: -<br />
</source><br />
<br />
'''DELETE /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Ingredients===<br />
'''GET /api/v1/ingredients'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<IngredientDTO><br />
</source><br />
<br />
'''GET /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: IngredientDTO i<br />
</source><br />
<br />
'''POST /api/v1/ingredients'''<br />
<source> <br />
Params: PostIngredientDTO ingredientDTO<br />
<br />
Returns: IngredientDTO newIngredient<br />
</source><br />
<br />
'''PUT /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id, PostIngredientDTO ingredientDTO<br />
<br />
Returns: IngredientDTO updatedIngredient<br />
</source><br />
<br />
'''DELETE /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Ratings===<br />
'''GET /api/v1/ratings'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<RatingLogDTO><br />
</source><br />
<br />
'''GET /api/v1/ratings/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: RatingLogDTO dto<br />
</source><br />
<br />
'''POST /api/v1/ratings'''<br />
<source> <br />
Params: RatingLogForEntityDTO ratingDTO<br />
<br />
Returns: RatingLogDTO newRating<br />
</source><br />
<br />
'''PUT api/v1/ratings/{id}'''<br />
<source> <br />
Params: int id, RatingLogForEntityDTO ratingDTO<br />
<br />
Returns: RatingLogDTO updatedRating<br />
</source><br />
<br />
'''DELETE api/v1/ratings/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===RequestLog===<br />
'''GET: api/v1/usageData/{userId}'''<br />
<source> <br />
Params: string userId<br />
<br />
Returns: List<RequestLogDTO><br />
</source><br />
<br />
== Lõpptoote kasutusjuhend ==<br />
<br />
* Kloonida kohalikku arvutisse repository aadressilt [https://github.com/sikumiku/TaisKohtApi https://github.com/sikumiku/TaisKohtApi]<br />
* Installida NodeJS<br />
* <source>npm install webpack -g</source><br />
* <source>npm install -cli -g</source><br />
* Frontend rakenduse kasutamiseks valida Startup meetoditest IIS Express, veebiteenuse ja Swaggeri kasutamiseks käivitada Api Swagger<br />
* Esimese admin kasutaja loomiseks tuleb kasutaja registreerida admin@gmail.com e-mailiga<br />
<br />
== XML/XSD/XSLT ==<br />
<br />
=== XML ===<br />
<br />
<source><?xml version="1.0" encoding="utf-8" ?><br />
<restaurants><br />
<restaurant id="1" url="https://kuuspelmeeni.ee" contactnumber="507783342" email="kuuspelmeeni@gmail.com"><br />
<name><![CDATA[Kuus Pelmeeni]]></name><br />
<menus><br />
<menu id="1" repetitioninterval="30"><br />
<name><![CDATA[Päevamenüü]]></name><br />
<activefrom>2018-05-27T12:00:00</activefrom><br />
<activeto>2018-05-28T12:00:00</activeto><br />
<dishes><br />
<dish id="1" vegan="false" lactosefree="false" glutenfree="false" daily="true" kcal="550" dailyprice="4"><br />
<title><![CDATA[8 pelmeeni]]></title><br />
<description><![CDATA[8 pelmeeni 6 asemel serveeritud tervisliku koguse hapukoore ja tilliga]]></description><br />
<availablefrom>2018-05-27T12:00:00</availablefrom><br />
<availableto>2018-05-28T12:00:00</availableto><br />
<ingredients><br />
<ingredient id="1" amountunit="g"><br />
<name>Sealiha</name><br />
<description>Rakvere sealiha</description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="9"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Parim päevaroog viimasel ajal.]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
</comments><br />
</rating><br />
<promotion id="1" type="visual" classname="bold-red-border-2px"><br />
<name>2px red border</name><br />
<description><![CDATA[Displays a 2px wide red border around the component that is promoted.]]></description><br />
<validto>2018-06-25T12:00:00</validto><br />
</promotion><br />
</dish><br />
<dish id="2" vegan="true" lactosefree="true" glutenfree="true" daily="true" kcal="320" price="4"><br />
<title><![CDATA[Kurgisalat]]></title><br />
<description><![CDATA[Erinevatel viisidel töödeldud kurk serveeritud koos jõhvikatega. Tervislik amps.]]></description><br />
<availablefrom>2018-05-27T12:00:00</availablefrom><br />
<availableto>2018-05-28T12:00:00</availableto><br />
<ingredients/><br />
<rating ratingvalue="4"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Jäin veel väga näljaseks peale selle söömist.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
</dishes><br />
</menu><br />
<menu id="2"><br />
<name><![CDATA[Põhimenüü]]></name><br />
<dishes><br />
<dish id="4" vegan="false" lactosefree="false" glutenfree="false" daily="false" kcal="550" price="5"><br />
<title><![CDATA[6 pelmeeni]]></title><br />
<description><![CDATA[6 pelmeeni serveeritud tervisliku koguse hapukoore ja tilliga]]></description><br />
<ingredients><br />
<ingredient id="1" amountunit="g"><br />
<name>Sealiha</name><br />
<description>Rakvere sealiha</description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="9.5"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Käin seda iga päev söömas.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Parim toit selles restoranis.]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
<dish id="5" vegan="false" lactosefree="false" glutenfree="true" daily="false" kcal="460" price="3.8"><br />
<title><![CDATA[Kartulisalat]]></title><br />
<description><![CDATA[Sinki sisaldav traditsiooniline kartulisalat.]]></description><br />
<ingredients/><br />
</dish><br />
<dish id="6" vegan="false" lactosefree="false" glutenfree="false" daily="false" kcal="610" price="3.9"><br />
<title><![CDATA[Šokolaadikook]]></title><br />
<description><![CDATA[Ahvatlev glasuuritud šokolaadikook.]]></description><br />
<ingredients/><br />
<rating ratingvalue="7.8"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Šokolaadikooki on keeruline metsa keerata.]]></commenttext><br />
<username>mutikas3</username><br />
<userid>3a29b94a-3f17-469d-a44d-f7d85e98dd3e</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
</dishes><br />
</menu><br />
</menus><br />
<dishes/><br />
<address id="1" country="Eesti"><br />
<addressfirstline>Tatari 12</addressfirstline><br />
<locality>Tallinn</locality><br />
<postcode>10132</postcode><br />
<region>Harjumaa</region><br />
</address><br />
<promotion/><br />
<rating ratingvalue="7.5"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Parim restoran üldse!]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Ma sain ainult 5 pelmeeni. Ootasin kuute.]]></commenttext><br />
<username>kyllikekallike1</username><br />
<userid>6af271dd-0e11-4ae6-98be-111762664318</userid><br />
</comment><br />
</comments><br />
</rating><br />
</restaurant><br />
<restaurant id="2" url="https://kolmkokka.ee" contactnumber="6522351" email="kolmkokka@gmail.com"><br />
<name><![CDATA[Kolm kokka]]></name><br />
<menus/><br />
<dishes><br />
<dish id="7" vegan="false" lactosefree="true" glutenfree="false" daily="false" kcal="470" price="14"><br />
<title><![CDATA[Ahjulõhe juurikatega]]></title><br />
<description><![CDATA[Ahjulõhe serveeritud püreestatud porgandite ja lillkapsaga.]]></description><br />
<ingredients><br />
<ingredient id="11" amountunit="tk" amount="1"><br />
<name>Ahjulõhe</name><br />
<description><![CDATA[Värske ahjulõhe]]></description><br />
</ingredient><br />
<ingredient id="12" amountunit="g"><br />
<name>Püreestatud porgand</name><br />
<description><![CDATA[Eesti porgand, mis on kergelt püreestatud]]></description><br />
</ingredient><br />
<ingredient id="13" amountunit="g"><br />
<name>Püreestatud lillkapsas</name><br />
<description><![CDATA[Eesti lillkapsas, mis on kergelt püreestatud ja maitsestatud]]></description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="8.9"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Kindlasti minu üks lemmikuid.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Pole midagi halba öelda.]]></commenttext><br />
<username>tiiuviiu</username><br />
<userid>0730a7b7-3a9c-4e26-962f-da9a8daeab8a</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
<dish id="8" vegan="true" lactosefree="true" glutenfree="true" daily="true" dailyprice="5"><br />
<title><![CDATA[Ingverisupp]]></title><br />
<description><![CDATA[Ingveriga vürtsistatud ingverisupp, mis viib keele alla.]]></description><br />
<availablefrom>2018-05-25T12:00:00</availablefrom><br />
<availableto>2018-06-25T12:00:00</availableto><br />
<ingredients><br />
<ingredient id="14" amountunit="g" amount="20"><br />
<name>Ingver</name><br />
<description><![CDATA[Tükeldatud ingver]]></description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="6"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Liiga palju ingverit.]]></commenttext><br />
<username>kyllikekallike1</username><br />
<userid>6af271dd-0e11-4ae6-98be-111762664318</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
<dish id="9" vegan="false" lactosefree="false" glutenfree="true" daily="false" kcal="340" price="4.5"><br />
<title><![CDATA[Apelsinijäätis]]></title><br />
<description><![CDATA[Apelsinimaitseline jäätis serveeritud riivitud apelsinikoorega.]]></description><br />
<ingredients/><br />
<rating ratingvalue="8"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Väga huvitav magustoit, prooviks veel.]]></commenttext><br />
<username>mutikas3</username><br />
<userid>3a29b94a-3f17-469d-a44d-f7d85e98dd3e</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Üks mu lemmikuid magustoite.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
</comments><br />
</rating><br />
</dish><br />
</dishes><br />
<address id="2" country="Eesti"><br />
<addressfirstline>Laia 12</addressfirstline><br />
<locality>Tallinn</locality><br />
<postcode>13022</postcode><br />
<region>Harjumaa</region><br />
</address><br />
<promotion/><br />
<rating ratingvalue="8.1"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Hinnad on natuke liiga kallid minu jaoks, aga toit om maitsev.]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Ma kindlasti telliks kala uuesti. Väga mahlakas oli.]]></commenttext><br />
<username>kyllikekallike1</username><br />
<userid>6af271dd-0e11-4ae6-98be-111762664318</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Asukoht oli päris tore. Miljöö ka.]]></commenttext><br />
<username>mutikas3</username><br />
<userid>3a29b94a-3f17-469d-a44d-f7d85e98dd3e</userid><br />
</comment><br />
</comments><br />
</rating><br />
</restaurant><br />
</restaurants></source><br />
<br />
=== XSD ===<br />
<br />
<source><?xml version="1.0" encoding="utf-8"?><br />
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema"><br />
<xs:element name="restaurants"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="restaurant"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="menus"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="menu"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="activefrom" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="activeto" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="dishes"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="dish"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="title" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="availablefrom" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="availableto" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="servetime" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="ingredients"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="ingredient"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="amountunit" type="xs:string" use="required" /><br />
<xs:attribute name="amount" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="rating" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="comments"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="comment"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="commenttext" type="xs:string" /><br />
<xs:element name="username" type="xs:string" /><br />
<xs:element name="userid" type="xs:string" /><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="ratingvalue" type="xs:decimal" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="validto" type="xs:dateTime" minOccurs="0" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="type" type="xs:string" use="required" /><br />
<xs:attribute name="classname" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="vegan" type="xs:boolean" use="optional" /><br />
<xs:attribute name="lactosefree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="glutenfree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="daily" type="xs:boolean" use="optional" /><br />
<xs:attribute name="kcal" type="xs:int" use="optional" /><br />
<xs:attribute name="weightg" type="xs:decimal" use="optional" /><br />
<xs:attribute name="price" type="xs:decimal" use="optional" /><br />
<xs:attribute name="dailyprice" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="validto" type="xs:dateTime" minOccurs="0" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="type" type="xs:string" use="required" /><br />
<xs:attribute name="classname" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="repetitioninterval" type="xs:int" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="dishes"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="dish"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="title" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="availablefrom" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="availableto" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="servetime" type="xs:dateTime" minOccurs="0" /><br />
<xs:element name="ingredients"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="ingredient"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="amountunit" type="xs:string" use="required" /><br />
<xs:attribute name="amount" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="rating"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="comments"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="comment"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="commenttext" type="xs:string" /><br />
<xs:element name="username" type="xs:string" /><br />
<xs:element name="userid" type="xs:string" /><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="ratingvalue" type="xs:decimal" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="validto" type="xs:dateTime" minOccurs="0" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="type" type="xs:string" use="required" /><br />
<xs:attribute name="classname" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="vegan" type="xs:boolean" use="optional" /><br />
<xs:attribute name="lactosefree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="glutenfree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="daily" type="xs:boolean" use="optional" /><br />
<xs:attribute name="kcal" type="xs:int" use="optional" /><br />
<xs:attribute name="weightg" type="xs:decimal" use="optional" /><br />
<xs:attribute name="price" type="xs:decimal" use="optional" /><br />
<xs:attribute name="dailyprice" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="address"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="addressfirstline" type="xs:string" /><br />
<xs:element name="locality" type="xs:string" /><br />
<xs:element name="postcode" type="xs:string" /><br />
<xs:element name="region" type="xs:string" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="country" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion" /><br />
<xs:element name="rating" minOccurs="0"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="comments"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0" maxOccurs="unbounded"><br />
<xs:element name="comment"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="commenttext" type="xs:string" /><br />
<xs:element name="username" type="xs:string" /><br />
<xs:element name="userid" type="xs:string" /><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="ratingvalue" type="xs:decimal" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="url" type="xs:string" use="required" /><br />
<xs:attribute name="contactnumber" type="xs:string" use="required" /><br />
<xs:attribute name="email" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:schema></source><br />
<br />
=== XSLT(HTML) ===<br />
<br />
<source></source><br />
<br />
=== XSLT(XML) ===<br />
<br />
<source></source><br />
<br />
== Logiraamat ==<br />
<br />
===07.02.2018===<br />
Gupi loomine ning suhtluskanali seadistamine<br />
<br />
=== 24.03.2018 ===<br />
Trello boardi loomine<br />
<br />
=== 25.03.2018 ===<br />
Wiki lehe loomine. Esimene tõsisem projekti koosolek ning tegevuskava paika panemine.<br />
<br />
=== 26.03.2018 ===<br />
<br />
Alustasime veebiteenuse analüüsiga ja funktsionaalsuse kirjeldamisega.<br />
<br />
=== 27.03.2018 ===<br />
Täiendasime veebiteenuse analüüsi.<br />
<br />
Esmase andmebaasi mudeli koostamine.<br />
<br />
Postitatud esimeste analüüsi arutelude põhjal valminud algne prototüüp.<br />
<br />
=== 30.03.2018 ===<br />
Valmis andmebaasimudel.<br />
<br />
=== 08.04.2018 ===<br />
Tehtud muudatused analüüsis vastavalt tagasisidele.<br />
<br />
=== 19.04.2018 ===<br />
Loodud projekti põhi koos domeenimudelitega. Projekt lisatud Githubi: https://github.com/sikumiku/TaisKohtApi<br />
<br />
=== 05-06.05.2018 ===<br />
Osalesime hackathonil. Lisatud controllerid, service'id koos vajalike kihtidega.<br />
<br />
=== 16.05.2018 ===<br />
Uuendatud andmebaasimudelit, DTO'sid.<br />
<br />
=== 18-19.05.2018 ===<br />
Lisatud klientrakendus, security, äriloogikat.<br />
<br />
=== 20.05.2018 ===<br />
Lisatud API dokumentatsioon.<br />
<br />
=== 22-24.05.2018 ===<br />
Uuendatud contoller'eid, service'id.<br />
<br />
=== 25-27.05.2018 ===<br />
Uuendatud contoller'eid, service'id. Lisatud kasutajate ja rollide kontrolle meetoditesse. Täiustatud klientrakendust. Swagger dokumentatsioon.<br />
<br />
=== 31.05-01.06.2018 ===<br />
Tegeletud XML, XSD ja XSLT failide loomisega.</div>
Saasma
https://wiki.itcollege.ee/index.php?title=BeerPressure&diff=131044
BeerPressure
2018-06-01T18:18:10Z
<p>Saasma: /* Logiraamat */</p>
<hr />
<div>== Meeskond ja rollid ==<br />
<br />
* Sigrid Aasma (arendaja)<br />
* Evelin Jõgi (arendaja)<br />
* Martin Kask (projektijuht, arendaja)<br />
* Marko Nõu (arendaja)<br />
<br />
== Idee ==<br />
'''Toidukohtade põhimenüüde ja päevapakkumiste teenus'''<br />
<br />
Soovime pakkuda toidukohtade põhimenüüde ja päevapakkumiste teenust. On olemas mitmeid kodulehti “päevapakkumised”, kus on kirjas toidukohtade päevapraed. Kuid tavaliselt sellistel lehtedel ei ole masinloetavaid andmeid ehk siis varianti, et saad saata API pihta mingi kuupäeva koos päevapraadidega andmete uuendamiseks ja saad sama API käest küsida tänaseid päevapraade. Andmeid võiks saada küsida restorani, kuupäeva, asukoha või otsisõna/otsisõnaosa põhiselt. Selline teenus lihtsustaks ka toidukohtade päevapakkumiste haldamist, kuna praegu peavad teenuse pakkujad vastavat informatsiooni uuendama mitmes erinevas kohas - nii erinevates portaalides, kui ka enda veebileheküljel. Samuti oleks toidukohtade kogu menüü haldamine ühes kohas.<br />
<br />
=== Esialgne prototüüp ===<br />
<br />
[[File:TäisKõhtProto1.mp4]]<br />
<br />
Esialgne prototüüp: [http://enos.itcollege.ee/~saasma/VR2/Proto/K%C3%B5htT%C3%A4is/#g=1&p=home navigeeritav versioon vol.1]<br />
<br />
=== Prototüübi muutus projekti käigus ===<br />
<br />
Prototüüp: [http://enos.itcollege.ee/~saasma/VR2/Proto/T%C3%A4isK%C3%B5ht/K%C3%B5htT%C3%A4is/#g=1&p=home navigeeritav versioon vol.2]<br />
<br />
== Kasutatav arendustehnoloogia ==<br />
<br />
Veebiteenuse loomisel kasutame ASP.NET Core tehnoloogiat ja kursusel õpitud arendusmustreid.<br />
<br />
Klientrakenduse loomisel kasutame Node.js + React'i.<br />
<br />
== Veebiteenuse analüüs ==<br />
Pakume toidukohtade põhimenüüde ja päevapakkumiste teenust, kuhu on kokku koondatud erinevate toidukohtade menüüd üle Eesti. Põhimenüü alla kuuluvad pikaajalised menüüd, mis kehtivad püsivalt, hooajaliselt või mingil konkreetsel nädalapäeval. Päevapakkumiste alla kuuluvad konkreetse kuupäevaga seotud päevapakkumised. Päevapakkumiste korral kuvatakse lisainfona, kas pakkumine kehtib mingis konkreetses ajavahemikus või kogu toidukoha lahtioleku aja.<br />
<br />
Eesmärk on koguda ühte kohta kokku erinevate toidukohtade menüüd ja päevapakkumised, et kliendid saaksid mugavalt ja kiiresti oma valikuid teha. Kliendid käivad enamasti päevapakkumisi söömas lõuna ajal ja selleks ettenähtud aeg on piiratud. Sellepärast on oluline, et klient saaks teha oma valiku võimalikult kiiresti. Tänu loodavale veebiteenusele ei pea kliendid käima erinevates portaalides, et tutvuda erinevate toidukohtade pakkumistega. Kuna teenust on mugav kasutada ja klient saab oma valiku kiiresti tehtud, siis tõenäoliselt teeb klient valiku selles keskkonnas olevate toiduasutuste seast. Lisaks võimaldab teenus toiduasutustel paika panna oma pikaajalisem põhimenüü ning seda rakenduses ja võimalusel ka söögikohas kuvada. Sellepärast on ka toidukohtade huvi antud keskkonnas üleval olla ja meiega oma andmeid jagada, sest see suurendab nende klientuuri ning muudab oma menüü haldamise kergemaks.<br />
<br />
Veebiteenuse loomisel lähtume eelkõige sellest, et kliendil oleks teenust mugav kasutada ja ta saaks oma valiku kiiresti tehtud. Arvestame, et kliendid on erinevad. Mõni eelistab mõnda kindlat toidukohta, sel juhul saab ta valida oma soovitud kohad ja võrrelda nende kohtade tänase päeva pakkumisi ning menüüsid. Mõnele inimesele on oluline pakutav söök ja ta eelistab pakkumist otsida prae nimetuses oleva sõna või sõnaosa järgi ning lähtuda seejärel valiku tegemisel toidukoha keskmisest hindest või toidu hinnast. Mõne kliendi jaoks on oluline hind ja selleks, et oma valikut teha sobivas hinnavahemikus on tal võimalik sisestada maksimum hinna piirang. Kindlasti on antud teenuse juures kõikide klientide jaoks oluline päevapakkumiste asukohapõhine eristatus. Kliendid, kes soovivad oma konto luua, võivad oma eelistatud valikud meelde jätta ja järgmisel korral kuvatakse neid talle automaatselt.<br />
<br />
Teenuse must-have funktsionaalsus tagab teenuse toimimise ja põhifunktsioonid. Teenuse nice-to-have funktsionaalsus annab rakendusele lisandväärtust.<br />
<br />
Arvestades pakutava teenusega, siis näeme, et aktiivseim teenuse kasutamine võib olla tööpäevadel vahemikus 11.00-15.00, kui kliendid tutvuvad päevapakkumistega. Teenus peab tekkivale koormusele vastu pidama.<br />
<br />
Teenuse pakkumine peab olema turvaline. Selle tagamiseks tuleb sisestatavaid andmeid valideerida ja andmebaasi sisestavate andmete mahtu piirata. Toidukohtade sisestatud andmed peavad olema kaitstud, et toitude koostised ei saaks avalikuks. Põhjendatud juhtudel on võimalik kasutajaid lukku panna.<br />
<br />
== Kasutajad ==<br />
<br />
<br />
* Admin - lehe administraator, kellel on õigus lehte, kasutajaid ja nende õiguseid hallata. Tema huvi on, et teenus toimiks tõrgeteta.<br />
* Toiduasutus (tasuta kasutaja) - saab hoida lehel ühte põhimenüüd ja päevapakkumisi.<br />
* Toiduasutus (tellimusega kasutaja) - saab hoida lehel piiramatu arv põhimenüüsid ja päevapakkumisi.<br />
Toiduasutused on teenusest huvitatud, et nende menüüde haldamine oleks kerge ja mugav ning nad saaksid oma klientide arvu suurendada.<br />
* Külastaja - klient, kes valib söögikohta. Tema on huvitatud eelkõige sellest, et teenust saaks kasutada mugavalt ja kiirelt ning toidukohtade valik oleks võimalikult suur.<br />
<br />
== Rakenduse must-have funktsionaalsus ==<br />
<br />
* Kasutajad saavad sisse logida<br />
* Kasutajatel on erinevad rollid: admin, toidukoht (tasuta ja tasulise tellimusega), klient<br />
* Kasutajate arvepidamine kasutajate lõikes:<br />
** sisselogimise kuupäev, kellaaeg<br />
** pakkumiste lisamine<br />
** pakkumiste muutmine<br />
** pakkumiste kustutamine<br />
** õiguste kehtimise periood (tasuta ja tellimusega toidukoht)<br />
** pakkumistele klikkimise arv<br />
* Kasutajaid on võimalik hallata:<br />
** kasutajale õiguste andmine (menüüde arvu suurendamine, tellimusega toidukohal), rolli määramine<br />
** Kasutajat on võimalik piirata: õiguseid piirata (piiratud menüüde arv, tasuta liitunud toidukohal) ja lukku panna<br />
* Päevapakkumisi/menüüsid saab küsida: <br />
** toidukoha järgi, <br />
** kuupäeva põhiselt (ainult päevapakkumisi), <br />
** asukoha põhiselt,<br />
** toidu nimetuses esineva otsisõna/otsisõna osa põhiselt,<br />
** hinna põhiselt (max hinna piirang).<br />
* Klientrakenduses realiseeritakse CRUD meetodid (menüüsid/päevapakkumisi saab sisestada, lugeda, uuendada, kustutada)<br />
* Toidukohale saab anda hindeid ja kuvatakse keskmist hinnet.<br />
* Toidule saab anda hindeid ja kuvatakse keskmist hinnet.<br />
<br />
== Nice-to-have funktsionaalsus ==<br />
<br />
* Info selle kohta, kas päevapakkumine on otsas<br />
* Päevapakkumisi/menüüsid saab kommenteerida ja neid kommentaare kuvatakse avalikult.<br />
* Söögikohtade kodulehtedelt otsimise script, mis genereerib juba olemasolevate kodulehtede baasil päevamenüüsid.<br />
* Toiduvaliku piiramine allergeenide/vegan/jms. koostisosade põhiselt.<br />
* Aruandlused ja võrdlused toidukohtadele, et võrrelda end konkurentidega.<br />
* Teenus soovitab toidukohtadele nende varasemate päevapraadide populaarsuse alusel uue nädala menüüd.<br />
* Erinevad toidukohtade/toitude pingeread klientidele, et anda valikuteks ideid.<br />
* Soovitused klientidele, mida teised kliendid sarnaste eelistustega on veel valinud.<br />
<br />
== Andmebaasi ülesehitus - projekti algus ==<br />
<br />
[[File: BeerPressureAndmebaasimudel.png]]<br />
<br />
== Andmebaasi ülesehitus - projekti lõpp ==<br />
<br />
[[File: Ta2isKo6ht-DB-FINAL.png]]<br />
<br />
== Projekti repository ==<br />
<br />
https://github.com/sikumiku/TaisKohtApi<br />
<br />
Zip fail saadaval: <br />
(master branchi viimane commit esitamise ajal)<br />
https://github.com/sikumiku/TaisKohtApi/archive/61438e187a1a972410c8a3bc6274d69489d00aa6.zip<br />
<br />
== API v1 dokumentatsioon ==<br />
<br />
===Security===<br />
'''POST /api/account/register'''<br />
<source><br />
Params: RegisterViewModel registerViewModel<br />
<br />
Returns: token<br />
</source><br />
<br />
'''POST /api/account/login'''<br />
<source> <br />
Params: LoginViewModel model<br />
<br />
Returns: token<br />
</source><br />
<br />
'''POST /api/account/logout'''<br />
<source> <br />
Params: -<br />
<br />
Returns: -<br />
</source><br />
<br />
===Accounts===<br />
'''GET /api/v1/accounts/getAllUsersInRole'''<br />
<source> <br />
Params: string role<br />
<br />
Returns: List<UserDTO><br />
</source><br />
<br />
'''GET /api/v1/accounts/{id}'''<br />
<source> <br />
Params: string id<br />
<br />
Returns: UserDTO<br />
</source><br />
<br />
'''PUT /api/v1/accounts/{id}'''<br />
<source> <br />
Params: string id, UpdateUserDTO userDTO<br />
<br />
Returns: -<br />
</source><br />
<br />
'''POST /api/v1/accounts/addRole'''<br />
<source> <br />
Params: string role<br />
<br />
Returns: -<br />
</source><br />
<br />
'''POST /api/v1/accounts/addRoleToUser'''<br />
<source> <br />
Params: string role, string userId<br />
<br />
Returns: UserDTO<br />
</source><br />
<br />
'''DELETE /api/v1/accounts/deactivate/{id}'''<br />
<source> <br />
Params: string id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Promotions===<br />
'''GET /api/v1/promotions '''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<PromotionDTO> <br />
</source><br />
<br />
'''GET /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: PromotionDTO<br />
</source><br />
<br />
'''POST /api/v1/promotions'''<br />
<source> <br />
Params: PromotionDTO promotionDTO<br />
<br />
Returns: PromotionDTO newPromotion<br />
</source><br />
<br />
'''PUT /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id, PromotionDTO promotionDTO<br />
<br />
Returns: PromotionDTO updatedPromotion<br />
</source><br />
<br />
'''DELETE /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Restaurants===<br />
'''GET /api/v1/restaurants'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<SimpleRestaurantDTO><br />
</source><br />
<br />
'''GET /api/v1/restaurants/search?name=th'''<br />
<source> <br />
Params: string name<br />
<br />
Returns: List<SimpleRestaurantDTO> result<br />
</source><br />
<br />
'''GET /api/v1/restaurants/top'''<br />
<source> <br />
Params: int amount<br />
<br />
Returns: List<SimpleRestaurantDTO> result<br />
</source><br />
<br />
'''GET /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: RestaurantDTO r<br />
</source><br />
<br />
'''POST /api/v1/restaurants/addUserToRestaurant'''<br />
<source> <br />
Params: int id, string userId<br />
<br />
Returns: -<br />
</source><br />
<br />
'''POST /api/v1/restaurants'''<br />
<source> <br />
Params: PostRestaurantDTO restaurantDTO<br />
<br />
Returns: RestaurantDTO newRestaurant<br />
</source><br />
<br />
'''PUT /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id, PostRestaurantDTO restaurantDTO<br />
<br />
Returns: PostRestaurantDTO updatedRestaurantDTO<br />
</source><br />
<br />
'''DELETE /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Menus===<br />
'''GET /api/v1/menus'''<br />
<source><br />
Params: -<br />
<br />
Returns: List<MenuDTO><br />
</source><br />
<br />
'''GET /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: MenuDTO menuDTO<br />
</source><br />
<br />
'''POST /api/v1/menus'''<br />
<source> <br />
Params: PostMenuDTO menuDTO<br />
<br />
Returns: MenuDTO newMenu<br />
</source><br />
<br />
'''PUT /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id, PostMenuDTO menuDTO<br />
<br />
Returns: MenuDTO updatedMenu<br />
</source><br />
<br />
'''PUT api/v1/Menus/{id}/Dishes'''<br />
<source> <br />
Params: int menuId, int[] dishIds<br />
<br />
Returns: -<br />
</source><br />
<br />
'''DELETE /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Dishes===<br />
'''GET /api/v1/dishes'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<DishDTO><br />
</source><br />
<br />
'''GET /api/v1/dishes/daily'''<br />
<source> <br />
Params: bool vegan, bool glutenFree, bool lactoseFree<br />
<br />
Returns: List<SimpleDishDTO> result<br />
</source><br />
<br />
'''GET: api/v1/dishes/search?title=th&priceLimit=null'''<br />
<source> <br />
Params: string title, decimal? priceLimit<br />
<br />
Returns: List<DishDTO> result<br />
</source><br />
<br />
'''GET /api/v1/dishes/top'''<br />
<source> <br />
Params: int amount<br />
<br />
Returns: List<DishDTO> result<br />
</source><br />
<br />
'''GET /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: DishDTO dishDTO<br />
</source><br />
<br />
'''POST /api/v1/dishes'''<br />
<source> <br />
Params: PostDishDTO dishDTO<br />
<br />
Returns: DishDTO newDish<br />
</source><br />
<br />
'''PUT /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id, PostDishDTO dishDTO<br />
<br />
Returns: DishDTO updatedDish<br />
</source><br />
<br />
'''PUT api/v1/Dishes/{id}/Ingredients'''<br />
<source> <br />
Params: int dishId, PostIngredientForDishDTO[] ingredients<br />
<br />
Returns: -<br />
</source><br />
<br />
'''DELETE /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Ingredients===<br />
'''GET /api/v1/ingredients'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<IngredientDTO><br />
</source><br />
<br />
'''GET /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: IngredientDTO i<br />
</source><br />
<br />
'''POST /api/v1/ingredients'''<br />
<source> <br />
Params: PostIngredientDTO ingredientDTO<br />
<br />
Returns: IngredientDTO newIngredient<br />
</source><br />
<br />
'''PUT /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id, PostIngredientDTO ingredientDTO<br />
<br />
Returns: IngredientDTO updatedIngredient<br />
</source><br />
<br />
'''DELETE /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Ratings===<br />
'''GET /api/v1/ratings'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<RatingLogDTO><br />
</source><br />
<br />
'''GET /api/v1/ratings/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: RatingLogDTO dto<br />
</source><br />
<br />
'''POST /api/v1/ratings'''<br />
<source> <br />
Params: RatingLogForEntityDTO ratingDTO<br />
<br />
Returns: RatingLogDTO newRating<br />
</source><br />
<br />
'''PUT api/v1/ratings/{id}'''<br />
<source> <br />
Params: int id, RatingLogForEntityDTO ratingDTO<br />
<br />
Returns: RatingLogDTO updatedRating<br />
</source><br />
<br />
'''DELETE api/v1/ratings/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===RequestLog===<br />
'''GET: api/v1/usageData/{userId}'''<br />
<source> <br />
Params: string userId<br />
<br />
Returns: List<RequestLogDTO><br />
</source><br />
<br />
== Lõpptoote kasutusjuhend ==<br />
<br />
* Kloonida kohalikku arvutisse repository aadressilt [https://github.com/sikumiku/TaisKohtApi https://github.com/sikumiku/TaisKohtApi]<br />
* Installida NodeJS<br />
* <source>npm install webpack -g</source><br />
* <source>npm install -cli -g</source><br />
* Frontend rakenduse kasutamiseks valida Startup meetoditest IIS Express, veebiteenuse ja Swaggeri kasutamiseks käivitada Api Swagger<br />
* Esimese admin kasutaja loomiseks tuleb kasutaja registreerida admin@gmail.com e-mailiga<br />
<br />
== XML/XSD/XSLT ==<br />
<br />
=== XML ===<br />
<br />
<source><?xml version="1.0" encoding="utf-8" ?><br />
<restaurants><br />
<restaurant id="1" url="https://kuuspelmeeni.ee" contactnumber="507783342" email="kuuspelmeeni@gmail.com"><br />
<name><![CDATA[Kuus Pelmeeni]]></name><br />
<menus><br />
<menu id="1" repetitioninterval="30"><br />
<name><![CDATA[Päevamenüü]]></name><br />
<activefrom>5/27/2018 12:00:00 PM</activefrom><br />
<activeto>5/28/2018 12:00:00 PM</activeto><br />
<dishes><br />
<dish id="1" vegan="false" lactosefree="false" glutenfree="false" daily="true" kcal="550" weightg="" price="" dailyprice="4"><br />
<title><![CDATA[8 pelmeeni]]></title><br />
<description><![CDATA[8 pelmeeni 6 asemel serveeritud tervisliku koguse hapukoore ja tilliga]]></description><br />
<availablefrom>5/27/2018 12:00:00 PM</availablefrom><br />
<availableto>5/28/2018 12:00:00 PM</availableto><br />
<servetime/><br />
<ingredients><br />
<ingredient id="1" amountunit="g" amount=""><br />
<name>Sealiha</name><br />
<description>Rakvere sealiha</description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="9"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Parim päevaroog viimasel ajal.]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
</comments><br />
</rating><br />
<promotion id="1" type="visual" classname="bold-red-border-2px"><br />
<name>2px red border</name><br />
<description><![CDATA[Displays a 2px wide red border around the component that is promoted.]]></description><br />
<validto>6/25/2018 12:00:00 PM</validto><br />
</promotion><br />
</dish><br />
<dish id="2" vegan="true" lactosefree="true" glutenfree="true" daily="true" kcal="320" weightg="" price="4" dailyprice=""><br />
<title><![CDATA[Kurgisalat]]></title><br />
<description><![CDATA[Erinevatel viisidel töödeldud kurk serveeritud koos jõhvikatega. Tervislik amps.]]></description><br />
<availablefrom>5/27/2018 12:00:00 PM</availablefrom><br />
<availableto>5/28/2018 12:00:00 PM</availableto><br />
<servetime/><br />
<ingredients/><br />
<rating><br />
<ratingvalue>4</ratingvalue><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Jäin veel väga näljaseks peale selle söömist.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
</comments><br />
</rating><br />
<promotion/><br />
</dish><br />
</dishes><br />
<promotion/><br />
</menu><br />
<menu id="2" repetitioninterval=""><br />
<name><![CDATA[Põhimenüü]]></name><br />
<activefrom/><br />
<activeto/><br />
<dishes><br />
<dish id="4" vegan="false" lactosefree="false" glutenfree="false" daily="false" kcal="550" weightg="" price="5" dailyprice=""><br />
<title><![CDATA[6 pelmeeni]]></title><br />
<description><![CDATA[6 pelmeeni serveeritud tervisliku koguse hapukoore ja tilliga]]></description><br />
<availablefrom/><br />
<availableto/><br />
<servetime/><br />
<ingredients><br />
<ingredient id="1" amountunit="g" amount=""><br />
<name>Sealiha</name><br />
<description>Rakvere sealiha</description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="9.5"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Käin seda iga päev söömas.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Parim toit selles restoranis.]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
</comments><br />
</rating><br />
<promotion/><br />
</dish><br />
<dish id="5" vegan="false" lactosefree="false" glutenfree="true" daily="false" kcal="460" weightg="" price="3.8" dailyprice=""><br />
<title><![CDATA[Kartulisalat]]></title><br />
<description><![CDATA[Sinki sisaldav traditsiooniline kartulisalat.]]></description><br />
<availablefrom/><br />
<availableto/><br />
<servetime/><br />
<ingredients/><br />
<rating/><br />
<promotion/><br />
</dish><br />
<dish id="6" vegan="false" lactosefree="false" glutenfree="false" daily="false" kcal="610" weightg="" price="3.9" dailyprice=""><br />
<title><![CDATA[Šokolaadikook]]></title><br />
<description><![CDATA[Ahvatlev glasuuritud šokolaadikook.]]></description><br />
<availablefrom/><br />
<availableto/><br />
<servetime/><br />
<ingredients/><br />
<rating ratingvalue="7.8"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Šokolaadikooki on keeruline metsa keerata.]]></commenttext><br />
<username>mutikas3</username><br />
<userid>3a29b94a-3f17-469d-a44d-f7d85e98dd3e</userid><br />
</comment><br />
</comments><br />
</rating><br />
<promotion/><br />
</dish><br />
</dishes><br />
<promotion/><br />
</menu><br />
</menus><br />
<dishes/><br />
<address id="1" country="Eesti"><br />
<addressfirstline>Tatari 12</addressfirstline><br />
<locality>Tallinn</locality><br />
<postcode>10132</postcode><br />
<region>Harjumaa</region><br />
</address><br />
<promotion/><br />
<rating ratingvalue="7.5"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Parim restoran üldse!]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Ma sain ainult 5 pelmeeni. Ootasin kuute.]]></commenttext><br />
<username>kyllikekallike1</username><br />
<userid>6af271dd-0e11-4ae6-98be-111762664318</userid><br />
</comment><br />
</comments><br />
</rating><br />
</restaurant><br />
<restaurant id="2" url="https://kolmkokka.ee" contactnumber="6522351" email="kolmkokka@gmail.com"><br />
<name><![CDATA[Kolm kokka]]></name><br />
<menus/><br />
<dishes><br />
<dish id="7" vegan="false" lactosefree="true" glutenfree="false" daily="false" kcal="470" weightg="" price="14" dailyprice=""><br />
<title><![CDATA[Ahjulõhe juurikatega]]></title><br />
<description><![CDATA[Ahjulõhe serveeritud püreestatud porgandite ja lillkapsaga.]]></description><br />
<availablefrom/><br />
<availableto/><br />
<servetime/><br />
<ingredients><br />
<ingredient id="11" amountunit="tk" amount="1"><br />
<name>Ahjulõhe</name><br />
<description><![CDATA[Värske ahjulõhe]]></description><br />
</ingredient><br />
<ingredient id="12" amountunit="g" amount=""><br />
<name>Püreestatud porgand</name><br />
<description><![CDATA[Eesti porgand, mis on kergelt püreestatud]]></description><br />
</ingredient><br />
<ingredient id="13" amountunit="g" amount=""><br />
<name>Püreestatud lillkapsas</name><br />
<description><![CDATA[Eesti lillkapsas, mis on kergelt püreestatud ja maitsestatud]]></description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="8.9"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Kindlasti minu üks lemmikuid.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Pole midagi halba öelda.]]></commenttext><br />
<username>tiiuviiu</username><br />
<userid>0730a7b7-3a9c-4e26-962f-da9a8daeab8a</userid><br />
</comment><br />
</comments><br />
</rating><br />
<promotion/><br />
</dish><br />
<dish id="8" vegan="true" lactosefree="true" glutenfree="true" daily="true" kcal="" weightg="" price="" dailyprice="5"><br />
<title><![CDATA[Ingverisupp]]></title><br />
<description><![CDATA[Ingveriga vürtsistatud ingverisupp, mis viib keele alla.]]></description><br />
<availablefrom>5/25/2018 12:00:00 PM</availablefrom><br />
<availableto>6/25/2018 12:00:00 PM</availableto><br />
<servetime/><br />
<ingredients><br />
<ingredient id="14" amountunit="g" amount="20"><br />
<name>Ingver</name><br />
<description><![CDATA[Tükeldatud ingver]]></description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="6"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Liiga palju ingverit.]]></commenttext><br />
<username>kyllikekallike1</username><br />
<userid>6af271dd-0e11-4ae6-98be-111762664318</userid><br />
</comment><br />
</comments><br />
</rating><br />
<promotion/><br />
</dish><br />
<dish id="9" vegan="false" lactosefree="false" glutenfree="true" daily="false" kcal="340" weightg="" price="4.5" dailyprice=""><br />
<title><![CDATA[Apelsinijäätis]]></title><br />
<description><![CDATA[Apelsinimaitseline jäätis serveeritud riivitud apelsinikoorega.]]></description><br />
<availablefrom/><br />
<availableto/><br />
<servetime/><br />
<ingredients/><br />
<rating ratingvalue="8"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Väga huvitav magustoit, prooviks veel.]]></commenttext><br />
<username>mutikas3</username><br />
<userid>3a29b94a-3f17-469d-a44d-f7d85e98dd3e</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Üks mu lemmikuid magustoite.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
</comments><br />
</rating><br />
<promotion/><br />
</dish><br />
</dishes><br />
<address id="2" country="Eesti"><br />
<addressfirstline>Laia 12</addressfirstline><br />
<locality>Tallinn</locality><br />
<postcode>13022</postcode><br />
<region>Harjumaa</region><br />
</address><br />
<promotion/><br />
<rating ratingvalue="8.1"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Hinnad on natuke liiga kallid minu jaoks, aga toit om maitsev.]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Ma kindlasti telliks kala uuesti. Väga mahlakas oli.]]></commenttext><br />
<username>kyllikekallike1</username><br />
<userid>6af271dd-0e11-4ae6-98be-111762664318</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Asukoht oli päris tore. Miljöö ka.]]></commenttext><br />
<username>mutikas3</username><br />
<userid>3a29b94a-3f17-469d-a44d-f7d85e98dd3e</userid><br />
</comment><br />
</comments><br />
</rating><br />
</restaurant><br />
</restaurants></source><br />
<br />
=== XSD ===<br />
<br />
<source><?xml version="1.0" encoding="utf-8"?><br />
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema"><br />
<xs:element name="restaurants"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element maxOccurs="unbounded" name="restaurant"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="menus"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0"><br />
<xs:element maxOccurs="unbounded" name="menu"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="activefrom" type="xs:dateTime" /><br />
<xs:element name="activeto" type="xs:dateTime" /><br />
<xs:element name="dishes"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element maxOccurs="unbounded" name="dish"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="title" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="availablefrom" type="xs:dateTime" /><br />
<xs:element name="availableto" type="xs:dateTime" /><br />
<xs:element name="servetime" type="xs:dateTime" /><br />
<xs:element name="ingredients"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0"><br />
<xs:element name="ingredient"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:unsignedByte" use="required" /><br />
<xs:attribute name="amountunit" type="xs:string" use="required" /><br />
<xs:attribute name="amount" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="rating"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0"><br />
<xs:element minOccurs="0" name="ratingvalue" type="xs:unsignedByte" /><br />
<xs:element name="comments"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element maxOccurs="unbounded" name="comment"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="commenttext" type="xs:string" /><br />
<xs:element name="username" type="xs:string" /><br />
<xs:element name="userid" type="xs:string" /><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="ratingvalue" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0"><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="validto" type="xs:dateTime" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="type" type="xs:string" use="optional" /><br />
<xs:attribute name="classname" type="xs:string" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="vegan" type="xs:boolean" use="optional" /><br />
<xs:attribute name="lactosefree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="glutenfree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="daily" type="xs:boolean" use="optional" /><br />
<xs:attribute name="kcal" type="xs:unsignedShort" use="optional" /><br />
<xs:attribute name="weightg" type="xs:decimal" use="optional" /><br />
<xs:attribute name="price" type="xs:decimal" use="optional" /><br />
<xs:attribute name="dailyprice" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="repetitioninterval" type="xs:int" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="dishes"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0"><br />
<xs:element maxOccurs="unbounded" name="dish"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="title" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="availablefrom" type="xs:dateTime" /><br />
<xs:element name="availableto" type="xs:dateTime" /><br />
<xs:element name="servetime" type="xs:dateTime" /><br />
<xs:element name="ingredients"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0"><br />
<xs:element maxOccurs="unbounded" name="ingredient"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="amountunit" type="xs:string" use="required" /><br />
<xs:attribute name="amount" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="rating"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="comments"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element maxOccurs="unbounded" name="comment"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="commenttext" type="xs:string" /><br />
<xs:element name="username" type="xs:string" /><br />
<xs:element name="userid" type="xs:string" /><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="ratingvalue" type="xs:decimal" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="vegan" type="xs:boolean" use="optional" /><br />
<xs:attribute name="lactosefree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="glutenfree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="daily" type="xs:boolean" use="optional" /><br />
<xs:attribute name="kcal" type="xs:int" use="optional" /><br />
<xs:attribute name="weightg" type="xs:decimal" use="optional" /><br />
<xs:attribute name="price" type="xs:decimal" use="optional" /><br />
<xs:attribute name="dailyprice" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="address"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="addressfirstline" type="xs:string" /><br />
<xs:element name="locality" type="xs:string" /><br />
<xs:element name="postcode" type="xs:string" /><br />
<xs:element name="region" type="xs:string" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="country" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion" /><br />
<xs:element name="rating"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="comments"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element maxOccurs="unbounded" name="comment"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="commenttext" type="xs:string" /><br />
<xs:element name="username" type="xs:string" /><br />
<xs:element name="userid" type="xs:string" /><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="ratingvalue" type="xs:decimal" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="url" type="xs:string" use="required" /><br />
<xs:attribute name="contactnumber" type="xs:string" use="required" /><br />
<xs:attribute name="email" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:schema></source><br />
<br />
=== XSLT(HTML) ===<br />
<br />
<source></source><br />
<br />
=== XSLT(XML) ===<br />
<br />
<source></source><br />
<br />
== Logiraamat ==<br />
<br />
===07.02.2018===<br />
Gupi loomine ning suhtluskanali seadistamine<br />
<br />
=== 24.03.2018 ===<br />
Trello boardi loomine<br />
<br />
=== 25.03.2018 ===<br />
Wiki lehe loomine. Esimene tõsisem projekti koosolek ning tegevuskava paika panemine.<br />
<br />
=== 26.03.2018 ===<br />
<br />
Alustasime veebiteenuse analüüsiga ja funktsionaalsuse kirjeldamisega.<br />
<br />
=== 27.03.2018 ===<br />
Täiendasime veebiteenuse analüüsi.<br />
<br />
Esmase andmebaasi mudeli koostamine.<br />
<br />
Postitatud esimeste analüüsi arutelude põhjal valminud algne prototüüp.<br />
<br />
=== 30.03.2018 ===<br />
Valmis andmebaasimudel.<br />
<br />
=== 08.04.2018 ===<br />
Tehtud muudatused analüüsis vastavalt tagasisidele.<br />
<br />
=== 19.04.2018 ===<br />
Loodud projekti põhi koos domeenimudelitega. Projekt lisatud Githubi: https://github.com/sikumiku/TaisKohtApi<br />
<br />
=== 05-06.05.2018 ===<br />
Osalesime hackathonil. Lisatud controllerid, service'id koos vajalike kihtidega.<br />
<br />
=== 16.05.2018 ===<br />
Uuendatud andmebaasimudelit, DTO'sid.<br />
<br />
=== 18-19.05.2018 ===<br />
Lisatud klientrakendus, security, äriloogikat.<br />
<br />
=== 20.05.2018 ===<br />
Lisatud API dokumentatsioon.<br />
<br />
=== 22-24.05.2018 ===<br />
Uuendatud contoller'eid, service'id.<br />
<br />
=== 25-27.05.2018 ===<br />
Uuendatud contoller'eid, service'id. Lisatud kasutajate ja rollide kontrolle meetoditesse. Täiustatud klientrakendust. Swagger dokumentatsioon.<br />
<br />
=== 31.05-01.06.2018 ===<br />
Tegeletud XML, XSD ja XSLT failide loomisega.</div>
Saasma
https://wiki.itcollege.ee/index.php?title=BeerPressure&diff=131043
BeerPressure
2018-06-01T18:17:07Z
<p>Saasma: </p>
<hr />
<div>== Meeskond ja rollid ==<br />
<br />
* Sigrid Aasma (arendaja)<br />
* Evelin Jõgi (arendaja)<br />
* Martin Kask (projektijuht, arendaja)<br />
* Marko Nõu (arendaja)<br />
<br />
== Idee ==<br />
'''Toidukohtade põhimenüüde ja päevapakkumiste teenus'''<br />
<br />
Soovime pakkuda toidukohtade põhimenüüde ja päevapakkumiste teenust. On olemas mitmeid kodulehti “päevapakkumised”, kus on kirjas toidukohtade päevapraed. Kuid tavaliselt sellistel lehtedel ei ole masinloetavaid andmeid ehk siis varianti, et saad saata API pihta mingi kuupäeva koos päevapraadidega andmete uuendamiseks ja saad sama API käest küsida tänaseid päevapraade. Andmeid võiks saada küsida restorani, kuupäeva, asukoha või otsisõna/otsisõnaosa põhiselt. Selline teenus lihtsustaks ka toidukohtade päevapakkumiste haldamist, kuna praegu peavad teenuse pakkujad vastavat informatsiooni uuendama mitmes erinevas kohas - nii erinevates portaalides, kui ka enda veebileheküljel. Samuti oleks toidukohtade kogu menüü haldamine ühes kohas.<br />
<br />
=== Esialgne prototüüp ===<br />
<br />
[[File:TäisKõhtProto1.mp4]]<br />
<br />
Esialgne prototüüp: [http://enos.itcollege.ee/~saasma/VR2/Proto/K%C3%B5htT%C3%A4is/#g=1&p=home navigeeritav versioon vol.1]<br />
<br />
=== Prototüübi muutus projekti käigus ===<br />
<br />
Prototüüp: [http://enos.itcollege.ee/~saasma/VR2/Proto/T%C3%A4isK%C3%B5ht/K%C3%B5htT%C3%A4is/#g=1&p=home navigeeritav versioon vol.2]<br />
<br />
== Kasutatav arendustehnoloogia ==<br />
<br />
Veebiteenuse loomisel kasutame ASP.NET Core tehnoloogiat ja kursusel õpitud arendusmustreid.<br />
<br />
Klientrakenduse loomisel kasutame Node.js + React'i.<br />
<br />
== Veebiteenuse analüüs ==<br />
Pakume toidukohtade põhimenüüde ja päevapakkumiste teenust, kuhu on kokku koondatud erinevate toidukohtade menüüd üle Eesti. Põhimenüü alla kuuluvad pikaajalised menüüd, mis kehtivad püsivalt, hooajaliselt või mingil konkreetsel nädalapäeval. Päevapakkumiste alla kuuluvad konkreetse kuupäevaga seotud päevapakkumised. Päevapakkumiste korral kuvatakse lisainfona, kas pakkumine kehtib mingis konkreetses ajavahemikus või kogu toidukoha lahtioleku aja.<br />
<br />
Eesmärk on koguda ühte kohta kokku erinevate toidukohtade menüüd ja päevapakkumised, et kliendid saaksid mugavalt ja kiiresti oma valikuid teha. Kliendid käivad enamasti päevapakkumisi söömas lõuna ajal ja selleks ettenähtud aeg on piiratud. Sellepärast on oluline, et klient saaks teha oma valiku võimalikult kiiresti. Tänu loodavale veebiteenusele ei pea kliendid käima erinevates portaalides, et tutvuda erinevate toidukohtade pakkumistega. Kuna teenust on mugav kasutada ja klient saab oma valiku kiiresti tehtud, siis tõenäoliselt teeb klient valiku selles keskkonnas olevate toiduasutuste seast. Lisaks võimaldab teenus toiduasutustel paika panna oma pikaajalisem põhimenüü ning seda rakenduses ja võimalusel ka söögikohas kuvada. Sellepärast on ka toidukohtade huvi antud keskkonnas üleval olla ja meiega oma andmeid jagada, sest see suurendab nende klientuuri ning muudab oma menüü haldamise kergemaks.<br />
<br />
Veebiteenuse loomisel lähtume eelkõige sellest, et kliendil oleks teenust mugav kasutada ja ta saaks oma valiku kiiresti tehtud. Arvestame, et kliendid on erinevad. Mõni eelistab mõnda kindlat toidukohta, sel juhul saab ta valida oma soovitud kohad ja võrrelda nende kohtade tänase päeva pakkumisi ning menüüsid. Mõnele inimesele on oluline pakutav söök ja ta eelistab pakkumist otsida prae nimetuses oleva sõna või sõnaosa järgi ning lähtuda seejärel valiku tegemisel toidukoha keskmisest hindest või toidu hinnast. Mõne kliendi jaoks on oluline hind ja selleks, et oma valikut teha sobivas hinnavahemikus on tal võimalik sisestada maksimum hinna piirang. Kindlasti on antud teenuse juures kõikide klientide jaoks oluline päevapakkumiste asukohapõhine eristatus. Kliendid, kes soovivad oma konto luua, võivad oma eelistatud valikud meelde jätta ja järgmisel korral kuvatakse neid talle automaatselt.<br />
<br />
Teenuse must-have funktsionaalsus tagab teenuse toimimise ja põhifunktsioonid. Teenuse nice-to-have funktsionaalsus annab rakendusele lisandväärtust.<br />
<br />
Arvestades pakutava teenusega, siis näeme, et aktiivseim teenuse kasutamine võib olla tööpäevadel vahemikus 11.00-15.00, kui kliendid tutvuvad päevapakkumistega. Teenus peab tekkivale koormusele vastu pidama.<br />
<br />
Teenuse pakkumine peab olema turvaline. Selle tagamiseks tuleb sisestatavaid andmeid valideerida ja andmebaasi sisestavate andmete mahtu piirata. Toidukohtade sisestatud andmed peavad olema kaitstud, et toitude koostised ei saaks avalikuks. Põhjendatud juhtudel on võimalik kasutajaid lukku panna.<br />
<br />
== Kasutajad ==<br />
<br />
<br />
* Admin - lehe administraator, kellel on õigus lehte, kasutajaid ja nende õiguseid hallata. Tema huvi on, et teenus toimiks tõrgeteta.<br />
* Toiduasutus (tasuta kasutaja) - saab hoida lehel ühte põhimenüüd ja päevapakkumisi.<br />
* Toiduasutus (tellimusega kasutaja) - saab hoida lehel piiramatu arv põhimenüüsid ja päevapakkumisi.<br />
Toiduasutused on teenusest huvitatud, et nende menüüde haldamine oleks kerge ja mugav ning nad saaksid oma klientide arvu suurendada.<br />
* Külastaja - klient, kes valib söögikohta. Tema on huvitatud eelkõige sellest, et teenust saaks kasutada mugavalt ja kiirelt ning toidukohtade valik oleks võimalikult suur.<br />
<br />
== Rakenduse must-have funktsionaalsus ==<br />
<br />
* Kasutajad saavad sisse logida<br />
* Kasutajatel on erinevad rollid: admin, toidukoht (tasuta ja tasulise tellimusega), klient<br />
* Kasutajate arvepidamine kasutajate lõikes:<br />
** sisselogimise kuupäev, kellaaeg<br />
** pakkumiste lisamine<br />
** pakkumiste muutmine<br />
** pakkumiste kustutamine<br />
** õiguste kehtimise periood (tasuta ja tellimusega toidukoht)<br />
** pakkumistele klikkimise arv<br />
* Kasutajaid on võimalik hallata:<br />
** kasutajale õiguste andmine (menüüde arvu suurendamine, tellimusega toidukohal), rolli määramine<br />
** Kasutajat on võimalik piirata: õiguseid piirata (piiratud menüüde arv, tasuta liitunud toidukohal) ja lukku panna<br />
* Päevapakkumisi/menüüsid saab küsida: <br />
** toidukoha järgi, <br />
** kuupäeva põhiselt (ainult päevapakkumisi), <br />
** asukoha põhiselt,<br />
** toidu nimetuses esineva otsisõna/otsisõna osa põhiselt,<br />
** hinna põhiselt (max hinna piirang).<br />
* Klientrakenduses realiseeritakse CRUD meetodid (menüüsid/päevapakkumisi saab sisestada, lugeda, uuendada, kustutada)<br />
* Toidukohale saab anda hindeid ja kuvatakse keskmist hinnet.<br />
* Toidule saab anda hindeid ja kuvatakse keskmist hinnet.<br />
<br />
== Nice-to-have funktsionaalsus ==<br />
<br />
* Info selle kohta, kas päevapakkumine on otsas<br />
* Päevapakkumisi/menüüsid saab kommenteerida ja neid kommentaare kuvatakse avalikult.<br />
* Söögikohtade kodulehtedelt otsimise script, mis genereerib juba olemasolevate kodulehtede baasil päevamenüüsid.<br />
* Toiduvaliku piiramine allergeenide/vegan/jms. koostisosade põhiselt.<br />
* Aruandlused ja võrdlused toidukohtadele, et võrrelda end konkurentidega.<br />
* Teenus soovitab toidukohtadele nende varasemate päevapraadide populaarsuse alusel uue nädala menüüd.<br />
* Erinevad toidukohtade/toitude pingeread klientidele, et anda valikuteks ideid.<br />
* Soovitused klientidele, mida teised kliendid sarnaste eelistustega on veel valinud.<br />
<br />
== Andmebaasi ülesehitus - projekti algus ==<br />
<br />
[[File: BeerPressureAndmebaasimudel.png]]<br />
<br />
== Andmebaasi ülesehitus - projekti lõpp ==<br />
<br />
[[File: Ta2isKo6ht-DB-FINAL.png]]<br />
<br />
== Projekti repository ==<br />
<br />
https://github.com/sikumiku/TaisKohtApi<br />
<br />
Zip fail saadaval: <br />
(master branchi viimane commit esitamise ajal)<br />
https://github.com/sikumiku/TaisKohtApi/archive/61438e187a1a972410c8a3bc6274d69489d00aa6.zip<br />
<br />
== API v1 dokumentatsioon ==<br />
<br />
===Security===<br />
'''POST /api/account/register'''<br />
<source><br />
Params: RegisterViewModel registerViewModel<br />
<br />
Returns: token<br />
</source><br />
<br />
'''POST /api/account/login'''<br />
<source> <br />
Params: LoginViewModel model<br />
<br />
Returns: token<br />
</source><br />
<br />
'''POST /api/account/logout'''<br />
<source> <br />
Params: -<br />
<br />
Returns: -<br />
</source><br />
<br />
===Accounts===<br />
'''GET /api/v1/accounts/getAllUsersInRole'''<br />
<source> <br />
Params: string role<br />
<br />
Returns: List<UserDTO><br />
</source><br />
<br />
'''GET /api/v1/accounts/{id}'''<br />
<source> <br />
Params: string id<br />
<br />
Returns: UserDTO<br />
</source><br />
<br />
'''PUT /api/v1/accounts/{id}'''<br />
<source> <br />
Params: string id, UpdateUserDTO userDTO<br />
<br />
Returns: -<br />
</source><br />
<br />
'''POST /api/v1/accounts/addRole'''<br />
<source> <br />
Params: string role<br />
<br />
Returns: -<br />
</source><br />
<br />
'''POST /api/v1/accounts/addRoleToUser'''<br />
<source> <br />
Params: string role, string userId<br />
<br />
Returns: UserDTO<br />
</source><br />
<br />
'''DELETE /api/v1/accounts/deactivate/{id}'''<br />
<source> <br />
Params: string id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Promotions===<br />
'''GET /api/v1/promotions '''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<PromotionDTO> <br />
</source><br />
<br />
'''GET /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: PromotionDTO<br />
</source><br />
<br />
'''POST /api/v1/promotions'''<br />
<source> <br />
Params: PromotionDTO promotionDTO<br />
<br />
Returns: PromotionDTO newPromotion<br />
</source><br />
<br />
'''PUT /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id, PromotionDTO promotionDTO<br />
<br />
Returns: PromotionDTO updatedPromotion<br />
</source><br />
<br />
'''DELETE /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Restaurants===<br />
'''GET /api/v1/restaurants'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<SimpleRestaurantDTO><br />
</source><br />
<br />
'''GET /api/v1/restaurants/search?name=th'''<br />
<source> <br />
Params: string name<br />
<br />
Returns: List<SimpleRestaurantDTO> result<br />
</source><br />
<br />
'''GET /api/v1/restaurants/top'''<br />
<source> <br />
Params: int amount<br />
<br />
Returns: List<SimpleRestaurantDTO> result<br />
</source><br />
<br />
'''GET /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: RestaurantDTO r<br />
</source><br />
<br />
'''POST /api/v1/restaurants/addUserToRestaurant'''<br />
<source> <br />
Params: int id, string userId<br />
<br />
Returns: -<br />
</source><br />
<br />
'''POST /api/v1/restaurants'''<br />
<source> <br />
Params: PostRestaurantDTO restaurantDTO<br />
<br />
Returns: RestaurantDTO newRestaurant<br />
</source><br />
<br />
'''PUT /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id, PostRestaurantDTO restaurantDTO<br />
<br />
Returns: PostRestaurantDTO updatedRestaurantDTO<br />
</source><br />
<br />
'''DELETE /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Menus===<br />
'''GET /api/v1/menus'''<br />
<source><br />
Params: -<br />
<br />
Returns: List<MenuDTO><br />
</source><br />
<br />
'''GET /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: MenuDTO menuDTO<br />
</source><br />
<br />
'''POST /api/v1/menus'''<br />
<source> <br />
Params: PostMenuDTO menuDTO<br />
<br />
Returns: MenuDTO newMenu<br />
</source><br />
<br />
'''PUT /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id, PostMenuDTO menuDTO<br />
<br />
Returns: MenuDTO updatedMenu<br />
</source><br />
<br />
'''PUT api/v1/Menus/{id}/Dishes'''<br />
<source> <br />
Params: int menuId, int[] dishIds<br />
<br />
Returns: -<br />
</source><br />
<br />
'''DELETE /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Dishes===<br />
'''GET /api/v1/dishes'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<DishDTO><br />
</source><br />
<br />
'''GET /api/v1/dishes/daily'''<br />
<source> <br />
Params: bool vegan, bool glutenFree, bool lactoseFree<br />
<br />
Returns: List<SimpleDishDTO> result<br />
</source><br />
<br />
'''GET: api/v1/dishes/search?title=th&priceLimit=null'''<br />
<source> <br />
Params: string title, decimal? priceLimit<br />
<br />
Returns: List<DishDTO> result<br />
</source><br />
<br />
'''GET /api/v1/dishes/top'''<br />
<source> <br />
Params: int amount<br />
<br />
Returns: List<DishDTO> result<br />
</source><br />
<br />
'''GET /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: DishDTO dishDTO<br />
</source><br />
<br />
'''POST /api/v1/dishes'''<br />
<source> <br />
Params: PostDishDTO dishDTO<br />
<br />
Returns: DishDTO newDish<br />
</source><br />
<br />
'''PUT /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id, PostDishDTO dishDTO<br />
<br />
Returns: DishDTO updatedDish<br />
</source><br />
<br />
'''PUT api/v1/Dishes/{id}/Ingredients'''<br />
<source> <br />
Params: int dishId, PostIngredientForDishDTO[] ingredients<br />
<br />
Returns: -<br />
</source><br />
<br />
'''DELETE /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Ingredients===<br />
'''GET /api/v1/ingredients'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<IngredientDTO><br />
</source><br />
<br />
'''GET /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: IngredientDTO i<br />
</source><br />
<br />
'''POST /api/v1/ingredients'''<br />
<source> <br />
Params: PostIngredientDTO ingredientDTO<br />
<br />
Returns: IngredientDTO newIngredient<br />
</source><br />
<br />
'''PUT /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id, PostIngredientDTO ingredientDTO<br />
<br />
Returns: IngredientDTO updatedIngredient<br />
</source><br />
<br />
'''DELETE /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Ratings===<br />
'''GET /api/v1/ratings'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<RatingLogDTO><br />
</source><br />
<br />
'''GET /api/v1/ratings/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: RatingLogDTO dto<br />
</source><br />
<br />
'''POST /api/v1/ratings'''<br />
<source> <br />
Params: RatingLogForEntityDTO ratingDTO<br />
<br />
Returns: RatingLogDTO newRating<br />
</source><br />
<br />
'''PUT api/v1/ratings/{id}'''<br />
<source> <br />
Params: int id, RatingLogForEntityDTO ratingDTO<br />
<br />
Returns: RatingLogDTO updatedRating<br />
</source><br />
<br />
'''DELETE api/v1/ratings/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===RequestLog===<br />
'''GET: api/v1/usageData/{userId}'''<br />
<source> <br />
Params: string userId<br />
<br />
Returns: List<RequestLogDTO><br />
</source><br />
<br />
== Lõpptoote kasutusjuhend ==<br />
<br />
* Kloonida kohalikku arvutisse repository aadressilt [https://github.com/sikumiku/TaisKohtApi https://github.com/sikumiku/TaisKohtApi]<br />
* Installida NodeJS<br />
* <source>npm install webpack -g</source><br />
* <source>npm install -cli -g</source><br />
* Frontend rakenduse kasutamiseks valida Startup meetoditest IIS Express, veebiteenuse ja Swaggeri kasutamiseks käivitada Api Swagger<br />
* Esimese admin kasutaja loomiseks tuleb kasutaja registreerida admin@gmail.com e-mailiga<br />
<br />
== XML/XSD/XSLT ==<br />
<br />
=== XML ===<br />
<br />
<source><?xml version="1.0" encoding="utf-8" ?><br />
<restaurants><br />
<restaurant id="1" url="https://kuuspelmeeni.ee" contactnumber="507783342" email="kuuspelmeeni@gmail.com"><br />
<name><![CDATA[Kuus Pelmeeni]]></name><br />
<menus><br />
<menu id="1" repetitioninterval="30"><br />
<name><![CDATA[Päevamenüü]]></name><br />
<activefrom>5/27/2018 12:00:00 PM</activefrom><br />
<activeto>5/28/2018 12:00:00 PM</activeto><br />
<dishes><br />
<dish id="1" vegan="false" lactosefree="false" glutenfree="false" daily="true" kcal="550" weightg="" price="" dailyprice="4"><br />
<title><![CDATA[8 pelmeeni]]></title><br />
<description><![CDATA[8 pelmeeni 6 asemel serveeritud tervisliku koguse hapukoore ja tilliga]]></description><br />
<availablefrom>5/27/2018 12:00:00 PM</availablefrom><br />
<availableto>5/28/2018 12:00:00 PM</availableto><br />
<servetime/><br />
<ingredients><br />
<ingredient id="1" amountunit="g" amount=""><br />
<name>Sealiha</name><br />
<description>Rakvere sealiha</description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="9"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Parim päevaroog viimasel ajal.]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
</comments><br />
</rating><br />
<promotion id="1" type="visual" classname="bold-red-border-2px"><br />
<name>2px red border</name><br />
<description><![CDATA[Displays a 2px wide red border around the component that is promoted.]]></description><br />
<validto>6/25/2018 12:00:00 PM</validto><br />
</promotion><br />
</dish><br />
<dish id="2" vegan="true" lactosefree="true" glutenfree="true" daily="true" kcal="320" weightg="" price="4" dailyprice=""><br />
<title><![CDATA[Kurgisalat]]></title><br />
<description><![CDATA[Erinevatel viisidel töödeldud kurk serveeritud koos jõhvikatega. Tervislik amps.]]></description><br />
<availablefrom>5/27/2018 12:00:00 PM</availablefrom><br />
<availableto>5/28/2018 12:00:00 PM</availableto><br />
<servetime/><br />
<ingredients/><br />
<rating><br />
<ratingvalue>4</ratingvalue><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Jäin veel väga näljaseks peale selle söömist.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
</comments><br />
</rating><br />
<promotion/><br />
</dish><br />
</dishes><br />
<promotion/><br />
</menu><br />
<menu id="2" repetitioninterval=""><br />
<name><![CDATA[Põhimenüü]]></name><br />
<activefrom/><br />
<activeto/><br />
<dishes><br />
<dish id="4" vegan="false" lactosefree="false" glutenfree="false" daily="false" kcal="550" weightg="" price="5" dailyprice=""><br />
<title><![CDATA[6 pelmeeni]]></title><br />
<description><![CDATA[6 pelmeeni serveeritud tervisliku koguse hapukoore ja tilliga]]></description><br />
<availablefrom/><br />
<availableto/><br />
<servetime/><br />
<ingredients><br />
<ingredient id="1" amountunit="g" amount=""><br />
<name>Sealiha</name><br />
<description>Rakvere sealiha</description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="9.5"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Käin seda iga päev söömas.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Parim toit selles restoranis.]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
</comments><br />
</rating><br />
<promotion/><br />
</dish><br />
<dish id="5" vegan="false" lactosefree="false" glutenfree="true" daily="false" kcal="460" weightg="" price="3.8" dailyprice=""><br />
<title><![CDATA[Kartulisalat]]></title><br />
<description><![CDATA[Sinki sisaldav traditsiooniline kartulisalat.]]></description><br />
<availablefrom/><br />
<availableto/><br />
<servetime/><br />
<ingredients/><br />
<rating/><br />
<promotion/><br />
</dish><br />
<dish id="6" vegan="false" lactosefree="false" glutenfree="false" daily="false" kcal="610" weightg="" price="3.9" dailyprice=""><br />
<title><![CDATA[Šokolaadikook]]></title><br />
<description><![CDATA[Ahvatlev glasuuritud šokolaadikook.]]></description><br />
<availablefrom/><br />
<availableto/><br />
<servetime/><br />
<ingredients/><br />
<rating ratingvalue="7.8"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Šokolaadikooki on keeruline metsa keerata.]]></commenttext><br />
<username>mutikas3</username><br />
<userid>3a29b94a-3f17-469d-a44d-f7d85e98dd3e</userid><br />
</comment><br />
</comments><br />
</rating><br />
<promotion/><br />
</dish><br />
</dishes><br />
<promotion/><br />
</menu><br />
</menus><br />
<dishes/><br />
<address id="1" country="Eesti"><br />
<addressfirstline>Tatari 12</addressfirstline><br />
<locality>Tallinn</locality><br />
<postcode>10132</postcode><br />
<region>Harjumaa</region><br />
</address><br />
<promotion/><br />
<rating ratingvalue="7.5"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Parim restoran üldse!]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Ma sain ainult 5 pelmeeni. Ootasin kuute.]]></commenttext><br />
<username>kyllikekallike1</username><br />
<userid>6af271dd-0e11-4ae6-98be-111762664318</userid><br />
</comment><br />
</comments><br />
</rating><br />
</restaurant><br />
<restaurant id="2" url="https://kolmkokka.ee" contactnumber="6522351" email="kolmkokka@gmail.com"><br />
<name><![CDATA[Kolm kokka]]></name><br />
<menus/><br />
<dishes><br />
<dish id="7" vegan="false" lactosefree="true" glutenfree="false" daily="false" kcal="470" weightg="" price="14" dailyprice=""><br />
<title><![CDATA[Ahjulõhe juurikatega]]></title><br />
<description><![CDATA[Ahjulõhe serveeritud püreestatud porgandite ja lillkapsaga.]]></description><br />
<availablefrom/><br />
<availableto/><br />
<servetime/><br />
<ingredients><br />
<ingredient id="11" amountunit="tk" amount="1"><br />
<name>Ahjulõhe</name><br />
<description><![CDATA[Värske ahjulõhe]]></description><br />
</ingredient><br />
<ingredient id="12" amountunit="g" amount=""><br />
<name>Püreestatud porgand</name><br />
<description><![CDATA[Eesti porgand, mis on kergelt püreestatud]]></description><br />
</ingredient><br />
<ingredient id="13" amountunit="g" amount=""><br />
<name>Püreestatud lillkapsas</name><br />
<description><![CDATA[Eesti lillkapsas, mis on kergelt püreestatud ja maitsestatud]]></description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="8.9"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Kindlasti minu üks lemmikuid.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Pole midagi halba öelda.]]></commenttext><br />
<username>tiiuviiu</username><br />
<userid>0730a7b7-3a9c-4e26-962f-da9a8daeab8a</userid><br />
</comment><br />
</comments><br />
</rating><br />
<promotion/><br />
</dish><br />
<dish id="8" vegan="true" lactosefree="true" glutenfree="true" daily="true" kcal="" weightg="" price="" dailyprice="5"><br />
<title><![CDATA[Ingverisupp]]></title><br />
<description><![CDATA[Ingveriga vürtsistatud ingverisupp, mis viib keele alla.]]></description><br />
<availablefrom>5/25/2018 12:00:00 PM</availablefrom><br />
<availableto>6/25/2018 12:00:00 PM</availableto><br />
<servetime/><br />
<ingredients><br />
<ingredient id="14" amountunit="g" amount="20"><br />
<name>Ingver</name><br />
<description><![CDATA[Tükeldatud ingver]]></description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="6"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Liiga palju ingverit.]]></commenttext><br />
<username>kyllikekallike1</username><br />
<userid>6af271dd-0e11-4ae6-98be-111762664318</userid><br />
</comment><br />
</comments><br />
</rating><br />
<promotion/><br />
</dish><br />
<dish id="9" vegan="false" lactosefree="false" glutenfree="true" daily="false" kcal="340" weightg="" price="4.5" dailyprice=""><br />
<title><![CDATA[Apelsinijäätis]]></title><br />
<description><![CDATA[Apelsinimaitseline jäätis serveeritud riivitud apelsinikoorega.]]></description><br />
<availablefrom/><br />
<availableto/><br />
<servetime/><br />
<ingredients/><br />
<rating ratingvalue="8"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Väga huvitav magustoit, prooviks veel.]]></commenttext><br />
<username>mutikas3</username><br />
<userid>3a29b94a-3f17-469d-a44d-f7d85e98dd3e</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Üks mu lemmikuid magustoite.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
</comments><br />
</rating><br />
<promotion/><br />
</dish><br />
</dishes><br />
<address id="2" country="Eesti"><br />
<addressfirstline>Laia 12</addressfirstline><br />
<locality>Tallinn</locality><br />
<postcode>13022</postcode><br />
<region>Harjumaa</region><br />
</address><br />
<promotion/><br />
<rating ratingvalue="8.1"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Hinnad on natuke liiga kallid minu jaoks, aga toit om maitsev.]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Ma kindlasti telliks kala uuesti. Väga mahlakas oli.]]></commenttext><br />
<username>kyllikekallike1</username><br />
<userid>6af271dd-0e11-4ae6-98be-111762664318</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Asukoht oli päris tore. Miljöö ka.]]></commenttext><br />
<username>mutikas3</username><br />
<userid>3a29b94a-3f17-469d-a44d-f7d85e98dd3e</userid><br />
</comment><br />
</comments><br />
</rating><br />
</restaurant><br />
</restaurants></source><br />
<br />
=== XSD ===<br />
<br />
<source><?xml version="1.0" encoding="utf-8"?><br />
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema"><br />
<xs:element name="restaurants"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element maxOccurs="unbounded" name="restaurant"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="menus"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0"><br />
<xs:element maxOccurs="unbounded" name="menu"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="activefrom" type="xs:dateTime" /><br />
<xs:element name="activeto" type="xs:dateTime" /><br />
<xs:element name="dishes"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element maxOccurs="unbounded" name="dish"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="title" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="availablefrom" type="xs:dateTime" /><br />
<xs:element name="availableto" type="xs:dateTime" /><br />
<xs:element name="servetime" type="xs:dateTime" /><br />
<xs:element name="ingredients"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0"><br />
<xs:element name="ingredient"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:unsignedByte" use="required" /><br />
<xs:attribute name="amountunit" type="xs:string" use="required" /><br />
<xs:attribute name="amount" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="rating"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0"><br />
<xs:element minOccurs="0" name="ratingvalue" type="xs:unsignedByte" /><br />
<xs:element name="comments"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element maxOccurs="unbounded" name="comment"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="commenttext" type="xs:string" /><br />
<xs:element name="username" type="xs:string" /><br />
<xs:element name="userid" type="xs:string" /><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="ratingvalue" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0"><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="validto" type="xs:dateTime" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="type" type="xs:string" use="optional" /><br />
<xs:attribute name="classname" type="xs:string" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="vegan" type="xs:boolean" use="optional" /><br />
<xs:attribute name="lactosefree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="glutenfree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="daily" type="xs:boolean" use="optional" /><br />
<xs:attribute name="kcal" type="xs:unsignedShort" use="optional" /><br />
<xs:attribute name="weightg" type="xs:decimal" use="optional" /><br />
<xs:attribute name="price" type="xs:decimal" use="optional" /><br />
<xs:attribute name="dailyprice" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="repetitioninterval" type="xs:int" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="dishes"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0"><br />
<xs:element maxOccurs="unbounded" name="dish"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="title" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="availablefrom" type="xs:dateTime" /><br />
<xs:element name="availableto" type="xs:dateTime" /><br />
<xs:element name="servetime" type="xs:dateTime" /><br />
<xs:element name="ingredients"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0"><br />
<xs:element maxOccurs="unbounded" name="ingredient"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="amountunit" type="xs:string" use="required" /><br />
<xs:attribute name="amount" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="rating"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="comments"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element maxOccurs="unbounded" name="comment"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="commenttext" type="xs:string" /><br />
<xs:element name="username" type="xs:string" /><br />
<xs:element name="userid" type="xs:string" /><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="ratingvalue" type="xs:decimal" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="vegan" type="xs:boolean" use="optional" /><br />
<xs:attribute name="lactosefree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="glutenfree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="daily" type="xs:boolean" use="optional" /><br />
<xs:attribute name="kcal" type="xs:int" use="optional" /><br />
<xs:attribute name="weightg" type="xs:decimal" use="optional" /><br />
<xs:attribute name="price" type="xs:decimal" use="optional" /><br />
<xs:attribute name="dailyprice" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="address"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="addressfirstline" type="xs:string" /><br />
<xs:element name="locality" type="xs:string" /><br />
<xs:element name="postcode" type="xs:string" /><br />
<xs:element name="region" type="xs:string" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="country" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion" /><br />
<xs:element name="rating"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="comments"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element maxOccurs="unbounded" name="comment"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="commenttext" type="xs:string" /><br />
<xs:element name="username" type="xs:string" /><br />
<xs:element name="userid" type="xs:string" /><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="ratingvalue" type="xs:decimal" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="url" type="xs:string" use="required" /><br />
<xs:attribute name="contactnumber" type="xs:string" use="required" /><br />
<xs:attribute name="email" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:schema></source><br />
<br />
=== XSLT(HTML) ===<br />
<br />
<source></source><br />
<br />
=== XSLT(XML) ===<br />
<br />
<source></source><br />
<br />
== Logiraamat ==<br />
<br />
===07.02.2018===<br />
Gupi loomine ning suhtluskanali seadistamine<br />
<br />
=== 24.03.2018 ===<br />
Trello boardi loomine<br />
<br />
=== 25.03.2018 ===<br />
Wiki lehe loomine. Esimene tõsisem projekti koosolek ning tegevuskava paika panemine.<br />
<br />
=== 26.03.2018 ===<br />
<br />
Alustasime veebiteenuse analüüsiga ja funktsionaalsuse kirjeldamisega.<br />
<br />
=== 27.03.2018 ===<br />
Täiendasime veebiteenuse analüüsi.<br />
<br />
Esmase andmebaasi mudeli koostamine.<br />
<br />
Postitatud esimeste analüüsi arutelude põhjal valminud algne prototüüp.<br />
<br />
=== 30.03.2018 ===<br />
Valmis andmebaasimudel.<br />
<br />
=== 08.04.2018 ===<br />
Tehtud muudatused analüüsis vastavalt tagasisidele.<br />
<br />
=== 19.04.2018 ===<br />
Loodud projekti põhi koos domeenimudelitega. Projekt lisatud Githubi: https://github.com/sikumiku/TaisKohtApi<br />
<br />
=== 05-06.05.2018 ===<br />
Osalesime hackathonil. Lisatud controllerid, service'id koos vajalike kihtidega.<br />
<br />
=== 16.05.2018 ===<br />
Uuendatud andmebaasimudelit, DTO'sid.<br />
<br />
=== 18-19.05.2018 ===<br />
Lisatud klientrakendus, security, äriloogikat.<br />
<br />
=== 20.05.2018 ===<br />
Lisatud API dokumentatsioon.<br />
<br />
=== 22-24.05.2018 ===<br />
Uuendatud contoller'eid, service'id.<br />
<br />
=== 25-27.05.2018 ===<br />
Uuendatud contoller'eid, service'id. Lisatud kasutajate ja rollide kontrolle meetoditesse. Täiustatud klientrakendust. Swagger dokumentatsioon.</div>
Saasma
https://wiki.itcollege.ee/index.php?title=BeerPressure&diff=131042
BeerPressure
2018-06-01T18:14:54Z
<p>Saasma: </p>
<hr />
<div>== Meeskond ja rollid ==<br />
<br />
* Sigrid Aasma (arendaja)<br />
* Evelin Jõgi (arendaja)<br />
* Martin Kask (projektijuht, arendaja)<br />
* Marko Nõu (arendaja)<br />
<br />
== Idee ==<br />
'''Toidukohtade põhimenüüde ja päevapakkumiste teenus'''<br />
<br />
Soovime pakkuda toidukohtade põhimenüüde ja päevapakkumiste teenust. On olemas mitmeid kodulehti “päevapakkumised”, kus on kirjas toidukohtade päevapraed. Kuid tavaliselt sellistel lehtedel ei ole masinloetavaid andmeid ehk siis varianti, et saad saata API pihta mingi kuupäeva koos päevapraadidega andmete uuendamiseks ja saad sama API käest küsida tänaseid päevapraade. Andmeid võiks saada küsida restorani, kuupäeva, asukoha või otsisõna/otsisõnaosa põhiselt. Selline teenus lihtsustaks ka toidukohtade päevapakkumiste haldamist, kuna praegu peavad teenuse pakkujad vastavat informatsiooni uuendama mitmes erinevas kohas - nii erinevates portaalides, kui ka enda veebileheküljel. Samuti oleks toidukohtade kogu menüü haldamine ühes kohas.<br />
<br />
=== Esialgne prototüüp ===<br />
<br />
[[File:TäisKõhtProto1.mp4]]<br />
<br />
Esialgne prototüüp: [http://enos.itcollege.ee/~saasma/VR2/Proto/K%C3%B5htT%C3%A4is/#g=1&p=home navigeeritav versioon vol.1]<br />
<br />
=== Prototüübi muutus projekti käigus ===<br />
<br />
Prototüüp: [http://enos.itcollege.ee/~saasma/VR2/Proto/T%C3%A4isK%C3%B5ht/K%C3%B5htT%C3%A4is/#g=1&p=home navigeeritav versioon vol.2]<br />
<br />
== Kasutatav arendustehnoloogia ==<br />
<br />
Veebiteenuse loomisel kasutame ASP.NET Core tehnoloogiat ja kursusel õpitud arendusmustreid.<br />
<br />
Klientrakenduse loomisel kasutame Node.js + React'i.<br />
<br />
== Veebiteenuse analüüs ==<br />
Pakume toidukohtade põhimenüüde ja päevapakkumiste teenust, kuhu on kokku koondatud erinevate toidukohtade menüüd üle Eesti. Põhimenüü alla kuuluvad pikaajalised menüüd, mis kehtivad püsivalt, hooajaliselt või mingil konkreetsel nädalapäeval. Päevapakkumiste alla kuuluvad konkreetse kuupäevaga seotud päevapakkumised. Päevapakkumiste korral kuvatakse lisainfona, kas pakkumine kehtib mingis konkreetses ajavahemikus või kogu toidukoha lahtioleku aja.<br />
<br />
Eesmärk on koguda ühte kohta kokku erinevate toidukohtade menüüd ja päevapakkumised, et kliendid saaksid mugavalt ja kiiresti oma valikuid teha. Kliendid käivad enamasti päevapakkumisi söömas lõuna ajal ja selleks ettenähtud aeg on piiratud. Sellepärast on oluline, et klient saaks teha oma valiku võimalikult kiiresti. Tänu loodavale veebiteenusele ei pea kliendid käima erinevates portaalides, et tutvuda erinevate toidukohtade pakkumistega. Kuna teenust on mugav kasutada ja klient saab oma valiku kiiresti tehtud, siis tõenäoliselt teeb klient valiku selles keskkonnas olevate toiduasutuste seast. Lisaks võimaldab teenus toiduasutustel paika panna oma pikaajalisem põhimenüü ning seda rakenduses ja võimalusel ka söögikohas kuvada. Sellepärast on ka toidukohtade huvi antud keskkonnas üleval olla ja meiega oma andmeid jagada, sest see suurendab nende klientuuri ning muudab oma menüü haldamise kergemaks.<br />
<br />
Veebiteenuse loomisel lähtume eelkõige sellest, et kliendil oleks teenust mugav kasutada ja ta saaks oma valiku kiiresti tehtud. Arvestame, et kliendid on erinevad. Mõni eelistab mõnda kindlat toidukohta, sel juhul saab ta valida oma soovitud kohad ja võrrelda nende kohtade tänase päeva pakkumisi ning menüüsid. Mõnele inimesele on oluline pakutav söök ja ta eelistab pakkumist otsida prae nimetuses oleva sõna või sõnaosa järgi ning lähtuda seejärel valiku tegemisel toidukoha keskmisest hindest või toidu hinnast. Mõne kliendi jaoks on oluline hind ja selleks, et oma valikut teha sobivas hinnavahemikus on tal võimalik sisestada maksimum hinna piirang. Kindlasti on antud teenuse juures kõikide klientide jaoks oluline päevapakkumiste asukohapõhine eristatus. Kliendid, kes soovivad oma konto luua, võivad oma eelistatud valikud meelde jätta ja järgmisel korral kuvatakse neid talle automaatselt.<br />
<br />
Teenuse must-have funktsionaalsus tagab teenuse toimimise ja põhifunktsioonid. Teenuse nice-to-have funktsionaalsus annab rakendusele lisandväärtust.<br />
<br />
Arvestades pakutava teenusega, siis näeme, et aktiivseim teenuse kasutamine võib olla tööpäevadel vahemikus 11.00-15.00, kui kliendid tutvuvad päevapakkumistega. Teenus peab tekkivale koormusele vastu pidama.<br />
<br />
Teenuse pakkumine peab olema turvaline. Selle tagamiseks tuleb sisestatavaid andmeid valideerida ja andmebaasi sisestavate andmete mahtu piirata. Toidukohtade sisestatud andmed peavad olema kaitstud, et toitude koostised ei saaks avalikuks. Põhjendatud juhtudel on võimalik kasutajaid lukku panna.<br />
<br />
== Kasutajad ==<br />
<br />
<br />
* Admin - lehe administraator, kellel on õigus lehte, kasutajaid ja nende õiguseid hallata. Tema huvi on, et teenus toimiks tõrgeteta.<br />
* Toiduasutus (tasuta kasutaja) - saab hoida lehel ühte põhimenüüd ja päevapakkumisi.<br />
* Toiduasutus (tellimusega kasutaja) - saab hoida lehel piiramatu arv põhimenüüsid ja päevapakkumisi.<br />
Toiduasutused on teenusest huvitatud, et nende menüüde haldamine oleks kerge ja mugav ning nad saaksid oma klientide arvu suurendada.<br />
* Külastaja - klient, kes valib söögikohta. Tema on huvitatud eelkõige sellest, et teenust saaks kasutada mugavalt ja kiirelt ning toidukohtade valik oleks võimalikult suur.<br />
<br />
== Rakenduse must-have funktsionaalsus ==<br />
<br />
* Kasutajad saavad sisse logida<br />
* Kasutajatel on erinevad rollid: admin, toidukoht (tasuta ja tasulise tellimusega), klient<br />
* Kasutajate arvepidamine kasutajate lõikes:<br />
** sisselogimise kuupäev, kellaaeg<br />
** pakkumiste lisamine<br />
** pakkumiste muutmine<br />
** pakkumiste kustutamine<br />
** õiguste kehtimise periood (tasuta ja tellimusega toidukoht)<br />
** pakkumistele klikkimise arv<br />
* Kasutajaid on võimalik hallata:<br />
** kasutajale õiguste andmine (menüüde arvu suurendamine, tellimusega toidukohal), rolli määramine<br />
** Kasutajat on võimalik piirata: õiguseid piirata (piiratud menüüde arv, tasuta liitunud toidukohal) ja lukku panna<br />
* Päevapakkumisi/menüüsid saab küsida: <br />
** toidukoha järgi, <br />
** kuupäeva põhiselt (ainult päevapakkumisi), <br />
** asukoha põhiselt,<br />
** toidu nimetuses esineva otsisõna/otsisõna osa põhiselt,<br />
** hinna põhiselt (max hinna piirang).<br />
* Klientrakenduses realiseeritakse CRUD meetodid (menüüsid/päevapakkumisi saab sisestada, lugeda, uuendada, kustutada)<br />
* Toidukohale saab anda hindeid ja kuvatakse keskmist hinnet.<br />
* Toidule saab anda hindeid ja kuvatakse keskmist hinnet.<br />
<br />
== Nice-to-have funktsionaalsus ==<br />
<br />
* Info selle kohta, kas päevapakkumine on otsas<br />
* Päevapakkumisi/menüüsid saab kommenteerida ja neid kommentaare kuvatakse avalikult.<br />
* Söögikohtade kodulehtedelt otsimise script, mis genereerib juba olemasolevate kodulehtede baasil päevamenüüsid.<br />
* Toiduvaliku piiramine allergeenide/vegan/jms. koostisosade põhiselt.<br />
* Aruandlused ja võrdlused toidukohtadele, et võrrelda end konkurentidega.<br />
* Teenus soovitab toidukohtadele nende varasemate päevapraadide populaarsuse alusel uue nädala menüüd.<br />
* Erinevad toidukohtade/toitude pingeread klientidele, et anda valikuteks ideid.<br />
* Soovitused klientidele, mida teised kliendid sarnaste eelistustega on veel valinud.<br />
<br />
== Andmebaasi ülesehitus - projekti algus ==<br />
<br />
[[File: BeerPressureAndmebaasimudel.png]]<br />
<br />
== Andmebaasi ülesehitus - projekti lõpp ==<br />
<br />
[[File: Ta2isKo6ht-DB-FINAL.png]]<br />
<br />
== Projekti repository ==<br />
<br />
https://github.com/sikumiku/TaisKohtApi<br />
<br />
Zip fail saadaval: <br />
(master branchi viimane commit esitamise ajal)<br />
https://github.com/sikumiku/TaisKohtApi/archive/61438e187a1a972410c8a3bc6274d69489d00aa6.zip<br />
<br />
== API v1 dokumentatsioon ==<br />
<br />
===Security===<br />
'''POST /api/account/register'''<br />
<source><br />
Params: RegisterViewModel registerViewModel<br />
<br />
Returns: token<br />
</source><br />
<br />
'''POST /api/account/login'''<br />
<source> <br />
Params: LoginViewModel model<br />
<br />
Returns: token<br />
</source><br />
<br />
'''POST /api/account/logout'''<br />
<source> <br />
Params: -<br />
<br />
Returns: -<br />
</source><br />
<br />
===Accounts===<br />
'''GET /api/v1/accounts/getAllUsersInRole'''<br />
<source> <br />
Params: string role<br />
<br />
Returns: List<UserDTO><br />
</source><br />
<br />
'''GET /api/v1/accounts/{id}'''<br />
<source> <br />
Params: string id<br />
<br />
Returns: UserDTO<br />
</source><br />
<br />
'''PUT /api/v1/accounts/{id}'''<br />
<source> <br />
Params: string id, UpdateUserDTO userDTO<br />
<br />
Returns: -<br />
</source><br />
<br />
'''POST /api/v1/accounts/addRole'''<br />
<source> <br />
Params: string role<br />
<br />
Returns: -<br />
</source><br />
<br />
'''POST /api/v1/accounts/addRoleToUser'''<br />
<source> <br />
Params: string role, string userId<br />
<br />
Returns: UserDTO<br />
</source><br />
<br />
'''DELETE /api/v1/accounts/deactivate/{id}'''<br />
<source> <br />
Params: string id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Promotions===<br />
'''GET /api/v1/promotions '''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<PromotionDTO> <br />
</source><br />
<br />
'''GET /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: PromotionDTO<br />
</source><br />
<br />
'''POST /api/v1/promotions'''<br />
<source> <br />
Params: PromotionDTO promotionDTO<br />
<br />
Returns: PromotionDTO newPromotion<br />
</source><br />
<br />
'''PUT /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id, PromotionDTO promotionDTO<br />
<br />
Returns: PromotionDTO updatedPromotion<br />
</source><br />
<br />
'''DELETE /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Restaurants===<br />
'''GET /api/v1/restaurants'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<SimpleRestaurantDTO><br />
</source><br />
<br />
'''GET /api/v1/restaurants/search?name=th'''<br />
<source> <br />
Params: string name<br />
<br />
Returns: List<SimpleRestaurantDTO> result<br />
</source><br />
<br />
'''GET /api/v1/restaurants/top'''<br />
<source> <br />
Params: int amount<br />
<br />
Returns: List<SimpleRestaurantDTO> result<br />
</source><br />
<br />
'''GET /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: RestaurantDTO r<br />
</source><br />
<br />
'''POST /api/v1/restaurants/addUserToRestaurant'''<br />
<source> <br />
Params: int id, string userId<br />
<br />
Returns: -<br />
</source><br />
<br />
'''POST /api/v1/restaurants'''<br />
<source> <br />
Params: PostRestaurantDTO restaurantDTO<br />
<br />
Returns: RestaurantDTO newRestaurant<br />
</source><br />
<br />
'''PUT /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id, PostRestaurantDTO restaurantDTO<br />
<br />
Returns: PostRestaurantDTO updatedRestaurantDTO<br />
</source><br />
<br />
'''DELETE /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Menus===<br />
'''GET /api/v1/menus'''<br />
<source><br />
Params: -<br />
<br />
Returns: List<MenuDTO><br />
</source><br />
<br />
'''GET /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: MenuDTO menuDTO<br />
</source><br />
<br />
'''POST /api/v1/menus'''<br />
<source> <br />
Params: PostMenuDTO menuDTO<br />
<br />
Returns: MenuDTO newMenu<br />
</source><br />
<br />
'''PUT /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id, PostMenuDTO menuDTO<br />
<br />
Returns: MenuDTO updatedMenu<br />
</source><br />
<br />
'''PUT api/v1/Menus/{id}/Dishes'''<br />
<source> <br />
Params: int menuId, int[] dishIds<br />
<br />
Returns: -<br />
</source><br />
<br />
'''DELETE /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Dishes===<br />
'''GET /api/v1/dishes'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<DishDTO><br />
</source><br />
<br />
'''GET /api/v1/dishes/daily'''<br />
<source> <br />
Params: bool vegan, bool glutenFree, bool lactoseFree<br />
<br />
Returns: List<SimpleDishDTO> result<br />
</source><br />
<br />
'''GET: api/v1/dishes/search?title=th&priceLimit=null'''<br />
<source> <br />
Params: string title, decimal? priceLimit<br />
<br />
Returns: List<DishDTO> result<br />
</source><br />
<br />
'''GET /api/v1/dishes/top'''<br />
<source> <br />
Params: int amount<br />
<br />
Returns: List<DishDTO> result<br />
</source><br />
<br />
'''GET /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: DishDTO dishDTO<br />
</source><br />
<br />
'''POST /api/v1/dishes'''<br />
<source> <br />
Params: PostDishDTO dishDTO<br />
<br />
Returns: DishDTO newDish<br />
</source><br />
<br />
'''PUT /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id, PostDishDTO dishDTO<br />
<br />
Returns: DishDTO updatedDish<br />
</source><br />
<br />
'''PUT api/v1/Dishes/{id}/Ingredients'''<br />
<source> <br />
Params: int dishId, PostIngredientForDishDTO[] ingredients<br />
<br />
Returns: -<br />
</source><br />
<br />
'''DELETE /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Ingredients===<br />
'''GET /api/v1/ingredients'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<IngredientDTO><br />
</source><br />
<br />
'''GET /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: IngredientDTO i<br />
</source><br />
<br />
'''POST /api/v1/ingredients'''<br />
<source> <br />
Params: PostIngredientDTO ingredientDTO<br />
<br />
Returns: IngredientDTO newIngredient<br />
</source><br />
<br />
'''PUT /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id, PostIngredientDTO ingredientDTO<br />
<br />
Returns: IngredientDTO updatedIngredient<br />
</source><br />
<br />
'''DELETE /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Ratings===<br />
'''GET /api/v1/ratings'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<RatingLogDTO><br />
</source><br />
<br />
'''GET /api/v1/ratings/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: RatingLogDTO dto<br />
</source><br />
<br />
'''POST /api/v1/ratings'''<br />
<source> <br />
Params: RatingLogForEntityDTO ratingDTO<br />
<br />
Returns: RatingLogDTO newRating<br />
</source><br />
<br />
'''PUT api/v1/ratings/{id}'''<br />
<source> <br />
Params: int id, RatingLogForEntityDTO ratingDTO<br />
<br />
Returns: RatingLogDTO updatedRating<br />
</source><br />
<br />
'''DELETE api/v1/ratings/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===RequestLog===<br />
'''GET: api/v1/usageData/{userId}'''<br />
<source> <br />
Params: string userId<br />
<br />
Returns: List<RequestLogDTO><br />
</source><br />
<br />
== Lõpptoote kasutusjuhend ==<br />
<br />
* Kloonida kohalikku arvutisse repository aadressilt [https://github.com/sikumiku/TaisKohtApi https://github.com/sikumiku/TaisKohtApi]<br />
* Installida NodeJS<br />
* <source>npm install webpack -g</source><br />
* <source>npm install -cli -g</source><br />
* Frontend rakenduse kasutamiseks valida Startup meetoditest IIS Express, veebiteenuse ja Swaggeri kasutamiseks käivitada Api Swagger<br />
* Esimese admin kasutaja loomiseks tuleb kasutaja registreerida admin@gmail.com e-mailiga<br />
<br />
== XML/XSD/XSLT ==<br />
<br />
=== XML ===<br />
<br />
<source><?xml version="1.0" encoding="utf-8" ?><br />
<restaurants><br />
<restaurant id="1" url="https://kuuspelmeeni.ee" contactnumber="507783342" email="kuuspelmeeni@gmail.com"><br />
<name><![CDATA[Kuus Pelmeeni]]></name><br />
<menus><br />
<menu id="1" repetitioninterval="30"><br />
<name><![CDATA[Päevamenüü]]></name><br />
<activefrom>5/27/2018 12:00:00 PM</activefrom><br />
<activeto>5/28/2018 12:00:00 PM</activeto><br />
<dishes><br />
<dish id="1" vegan="false" lactosefree="false" glutenfree="false" daily="true" kcal="550" weightg="" price="" dailyprice="4"><br />
<title><![CDATA[8 pelmeeni]]></title><br />
<description><![CDATA[8 pelmeeni 6 asemel serveeritud tervisliku koguse hapukoore ja tilliga]]></description><br />
<availablefrom>5/27/2018 12:00:00 PM</availablefrom><br />
<availableto>5/28/2018 12:00:00 PM</availableto><br />
<servetime/><br />
<ingredients><br />
<ingredient id="1" amountunit="g" amount=""><br />
<name>Sealiha</name><br />
<description>Rakvere sealiha</description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="9"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Parim päevaroog viimasel ajal.]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
</comments><br />
</rating><br />
<promotion id="1" type="visual" classname="bold-red-border-2px"><br />
<name>2px red border</name><br />
<description><![CDATA[Displays a 2px wide red border around the component that is promoted.]]></description><br />
<validto>6/25/2018 12:00:00 PM</validto><br />
</promotion><br />
</dish><br />
<dish id="2" vegan="true" lactosefree="true" glutenfree="true" daily="true" kcal="320" weightg="" price="4" dailyprice=""><br />
<title><![CDATA[Kurgisalat]]></title><br />
<description><![CDATA[Erinevatel viisidel töödeldud kurk serveeritud koos jõhvikatega. Tervislik amps.]]></description><br />
<availablefrom>5/27/2018 12:00:00 PM</availablefrom><br />
<availableto>5/28/2018 12:00:00 PM</availableto><br />
<servetime/><br />
<ingredients/><br />
<rating><br />
<ratingvalue>4</ratingvalue><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Jäin veel väga näljaseks peale selle söömist.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
</comments><br />
</rating><br />
<promotion/><br />
</dish><br />
</dishes><br />
<promotion/><br />
</menu><br />
<menu id="2" repetitioninterval=""><br />
<name><![CDATA[Põhimenüü]]></name><br />
<activefrom/><br />
<activeto/><br />
<dishes><br />
<dish id="4" vegan="false" lactosefree="false" glutenfree="false" daily="false" kcal="550" weightg="" price="5" dailyprice=""><br />
<title><![CDATA[6 pelmeeni]]></title><br />
<description><![CDATA[6 pelmeeni serveeritud tervisliku koguse hapukoore ja tilliga]]></description><br />
<availablefrom/><br />
<availableto/><br />
<servetime/><br />
<ingredients><br />
<ingredient id="1" amountunit="g" amount=""><br />
<name>Sealiha</name><br />
<description>Rakvere sealiha</description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="9.5"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Käin seda iga päev söömas.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Parim toit selles restoranis.]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
</comments><br />
</rating><br />
<promotion/><br />
</dish><br />
<dish id="5" vegan="false" lactosefree="false" glutenfree="true" daily="false" kcal="460" weightg="" price="3.8" dailyprice=""><br />
<title><![CDATA[Kartulisalat]]></title><br />
<description><![CDATA[Sinki sisaldav traditsiooniline kartulisalat.]]></description><br />
<availablefrom/><br />
<availableto/><br />
<servetime/><br />
<ingredients/><br />
<rating/><br />
<promotion/><br />
</dish><br />
<dish id="6" vegan="false" lactosefree="false" glutenfree="false" daily="false" kcal="610" weightg="" price="3.9" dailyprice=""><br />
<title><![CDATA[Šokolaadikook]]></title><br />
<description><![CDATA[Ahvatlev glasuuritud šokolaadikook.]]></description><br />
<availablefrom/><br />
<availableto/><br />
<servetime/><br />
<ingredients/><br />
<rating ratingvalue="7.8"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Šokolaadikooki on keeruline metsa keerata.]]></commenttext><br />
<username>mutikas3</username><br />
<userid>3a29b94a-3f17-469d-a44d-f7d85e98dd3e</userid><br />
</comment><br />
</comments><br />
</rating><br />
<promotion/><br />
</dish><br />
</dishes><br />
<promotion/><br />
</menu><br />
</menus><br />
<dishes/><br />
<address id="1" country="Eesti"><br />
<addressfirstline>Tatari 12</addressfirstline><br />
<locality>Tallinn</locality><br />
<postcode>10132</postcode><br />
<region>Harjumaa</region><br />
</address><br />
<promotion/><br />
<rating ratingvalue="7.5"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Parim restoran üldse!]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Ma sain ainult 5 pelmeeni. Ootasin kuute.]]></commenttext><br />
<username>kyllikekallike1</username><br />
<userid>6af271dd-0e11-4ae6-98be-111762664318</userid><br />
</comment><br />
</comments><br />
</rating><br />
</restaurant><br />
<restaurant id="2" url="https://kolmkokka.ee" contactnumber="6522351" email="kolmkokka@gmail.com"><br />
<name><![CDATA[Kolm kokka]]></name><br />
<menus/><br />
<dishes><br />
<dish id="7" vegan="false" lactosefree="true" glutenfree="false" daily="false" kcal="470" weightg="" price="14" dailyprice=""><br />
<title><![CDATA[Ahjulõhe juurikatega]]></title><br />
<description><![CDATA[Ahjulõhe serveeritud püreestatud porgandite ja lillkapsaga.]]></description><br />
<availablefrom/><br />
<availableto/><br />
<servetime/><br />
<ingredients><br />
<ingredient id="11" amountunit="tk" amount="1"><br />
<name>Ahjulõhe</name><br />
<description><![CDATA[Värske ahjulõhe]]></description><br />
</ingredient><br />
<ingredient id="12" amountunit="g" amount=""><br />
<name>Püreestatud porgand</name><br />
<description><![CDATA[Eesti porgand, mis on kergelt püreestatud]]></description><br />
</ingredient><br />
<ingredient id="13" amountunit="g" amount=""><br />
<name>Püreestatud lillkapsas</name><br />
<description><![CDATA[Eesti lillkapsas, mis on kergelt püreestatud ja maitsestatud]]></description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="8.9"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Kindlasti minu üks lemmikuid.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Pole midagi halba öelda.]]></commenttext><br />
<username>tiiuviiu</username><br />
<userid>0730a7b7-3a9c-4e26-962f-da9a8daeab8a</userid><br />
</comment><br />
</comments><br />
</rating><br />
<promotion/><br />
</dish><br />
<dish id="8" vegan="true" lactosefree="true" glutenfree="true" daily="true" kcal="" weightg="" price="" dailyprice="5"><br />
<title><![CDATA[Ingverisupp]]></title><br />
<description><![CDATA[Ingveriga vürtsistatud ingverisupp, mis viib keele alla.]]></description><br />
<availablefrom>5/25/2018 12:00:00 PM</availablefrom><br />
<availableto>6/25/2018 12:00:00 PM</availableto><br />
<servetime/><br />
<ingredients><br />
<ingredient id="14" amountunit="g" amount="20"><br />
<name>Ingver</name><br />
<description><![CDATA[Tükeldatud ingver]]></description><br />
</ingredient><br />
</ingredients><br />
<rating ratingvalue="6"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Liiga palju ingverit.]]></commenttext><br />
<username>kyllikekallike1</username><br />
<userid>6af271dd-0e11-4ae6-98be-111762664318</userid><br />
</comment><br />
</comments><br />
</rating><br />
<promotion/><br />
</dish><br />
<dish id="9" vegan="false" lactosefree="false" glutenfree="true" daily="false" kcal="340" weightg="" price="4.5" dailyprice=""><br />
<title><![CDATA[Apelsinijäätis]]></title><br />
<description><![CDATA[Apelsinimaitseline jäätis serveeritud riivitud apelsinikoorega.]]></description><br />
<availablefrom/><br />
<availableto/><br />
<servetime/><br />
<ingredients/><br />
<rating ratingvalue="8"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Väga huvitav magustoit, prooviks veel.]]></commenttext><br />
<username>mutikas3</username><br />
<userid>3a29b94a-3f17-469d-a44d-f7d85e98dd3e</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Üks mu lemmikuid magustoite.]]></commenttext><br />
<username>ingupingu22</username><br />
<userid>45b09f05-33fd-4041-995e-ecdb7ec61939</userid><br />
</comment><br />
</comments><br />
</rating><br />
<promotion/><br />
</dish><br />
</dishes><br />
<address id="2" country="Eesti"><br />
<addressfirstline>Laia 12</addressfirstline><br />
<locality>Tallinn</locality><br />
<postcode>13022</postcode><br />
<region>Harjumaa</region><br />
</address><br />
<promotion/><br />
<rating ratingvalue="8.1"><br />
<comments><br />
<comment><br />
<commenttext><![CDATA[Hinnad on natuke liiga kallid minu jaoks, aga toit om maitsev.]]></commenttext><br />
<username>peeterpakiraam66</username><br />
<userid>3a9dd653-30fb-40ab-97b1-33cb82d336eb</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Ma kindlasti telliks kala uuesti. Väga mahlakas oli.]]></commenttext><br />
<username>kyllikekallike1</username><br />
<userid>6af271dd-0e11-4ae6-98be-111762664318</userid><br />
</comment><br />
<comment><br />
<commenttext><![CDATA[Asukoht oli päris tore. Miljöö ka.]]></commenttext><br />
<username>mutikas3</username><br />
<userid>3a29b94a-3f17-469d-a44d-f7d85e98dd3e</userid><br />
</comment><br />
</comments><br />
</rating><br />
</restaurant><br />
</restaurants></source><br />
<br />
=== XSD ===<br />
<br />
<source><?xml version="1.0" encoding="utf-8"?><br />
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema"><br />
<xs:element name="restaurants"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element maxOccurs="unbounded" name="restaurant"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="menus"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0"><br />
<xs:element maxOccurs="unbounded" name="menu"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="activefrom" type="xs:dateTime" /><br />
<xs:element name="activeto" type="xs:dateTime" /><br />
<xs:element name="dishes"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element maxOccurs="unbounded" name="dish"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="title" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="availablefrom" type="xs:dateTime" /><br />
<xs:element name="availableto" type="xs:dateTime" /><br />
<xs:element name="servetime" type="xs:dateTime" /><br />
<xs:element name="ingredients"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0"><br />
<xs:element name="ingredient"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:unsignedByte" use="required" /><br />
<xs:attribute name="amountunit" type="xs:string" use="required" /><br />
<xs:attribute name="amount" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="rating"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0"><br />
<xs:element minOccurs="0" name="ratingvalue" type="xs:unsignedByte" /><br />
<xs:element name="comments"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element maxOccurs="unbounded" name="comment"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="commenttext" type="xs:string" /><br />
<xs:element name="username" type="xs:string" /><br />
<xs:element name="userid" type="xs:string" /><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="ratingvalue" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0"><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="validto" type="xs:dateTime" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="type" type="xs:string" use="optional" /><br />
<xs:attribute name="classname" type="xs:string" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="vegan" type="xs:boolean" use="optional" /><br />
<xs:attribute name="lactosefree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="glutenfree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="daily" type="xs:boolean" use="optional" /><br />
<xs:attribute name="kcal" type="xs:unsignedShort" use="optional" /><br />
<xs:attribute name="weightg" type="xs:decimal" use="optional" /><br />
<xs:attribute name="price" type="xs:decimal" use="optional" /><br />
<xs:attribute name="dailyprice" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="repetitioninterval" type="xs:int" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="dishes"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0"><br />
<xs:element maxOccurs="unbounded" name="dish"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="title" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
<xs:element name="availablefrom" type="xs:dateTime" /><br />
<xs:element name="availableto" type="xs:dateTime" /><br />
<xs:element name="servetime" type="xs:dateTime" /><br />
<xs:element name="ingredients"><br />
<xs:complexType><br />
<xs:sequence minOccurs="0"><br />
<xs:element maxOccurs="unbounded" name="ingredient"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="name" type="xs:string" /><br />
<xs:element name="description" type="xs:string" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="amountunit" type="xs:string" use="required" /><br />
<xs:attribute name="amount" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="rating"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="comments"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element maxOccurs="unbounded" name="comment"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="commenttext" type="xs:string" /><br />
<xs:element name="username" type="xs:string" /><br />
<xs:element name="userid" type="xs:string" /><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="ratingvalue" type="xs:decimal" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="vegan" type="xs:boolean" use="optional" /><br />
<xs:attribute name="lactosefree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="glutenfree" type="xs:boolean" use="optional" /><br />
<xs:attribute name="daily" type="xs:boolean" use="optional" /><br />
<xs:attribute name="kcal" type="xs:int" use="optional" /><br />
<xs:attribute name="weightg" type="xs:decimal" use="optional" /><br />
<xs:attribute name="price" type="xs:decimal" use="optional" /><br />
<xs:attribute name="dailyprice" type="xs:decimal" use="optional" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="address"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="addressfirstline" type="xs:string" /><br />
<xs:element name="locality" type="xs:string" /><br />
<xs:element name="postcode" type="xs:string" /><br />
<xs:element name="region" type="xs:string" /><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="country" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
<xs:element name="promotion" /><br />
<xs:element name="rating"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="comments"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element maxOccurs="unbounded" name="comment"><br />
<xs:complexType><br />
<xs:sequence><br />
<xs:element name="commenttext" type="xs:string" /><br />
<xs:element name="username" type="xs:string" /><br />
<xs:element name="userid" type="xs:string" /><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="ratingvalue" type="xs:decimal" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
<xs:attribute name="id" type="xs:int" use="required" /><br />
<xs:attribute name="url" type="xs:string" use="required" /><br />
<xs:attribute name="contactnumber" type="xs:string" use="required" /><br />
<xs:attribute name="email" type="xs:string" use="required" /><br />
</xs:complexType><br />
</xs:element><br />
</xs:sequence><br />
</xs:complexType><br />
</xs:element><br />
</xs:schema></source><br />
<br />
== Logiraamat ==<br />
<br />
===07.02.2018===<br />
Gupi loomine ning suhtluskanali seadistamine<br />
<br />
=== 24.03.2018 ===<br />
Trello boardi loomine<br />
<br />
=== 25.03.2018 ===<br />
Wiki lehe loomine. Esimene tõsisem projekti koosolek ning tegevuskava paika panemine.<br />
<br />
=== 26.03.2018 ===<br />
<br />
Alustasime veebiteenuse analüüsiga ja funktsionaalsuse kirjeldamisega.<br />
<br />
=== 27.03.2018 ===<br />
Täiendasime veebiteenuse analüüsi.<br />
<br />
Esmase andmebaasi mudeli koostamine.<br />
<br />
Postitatud esimeste analüüsi arutelude põhjal valminud algne prototüüp.<br />
<br />
=== 30.03.2018 ===<br />
Valmis andmebaasimudel.<br />
<br />
=== 08.04.2018 ===<br />
Tehtud muudatused analüüsis vastavalt tagasisidele.<br />
<br />
=== 19.04.2018 ===<br />
Loodud projekti põhi koos domeenimudelitega. Projekt lisatud Githubi: https://github.com/sikumiku/TaisKohtApi<br />
<br />
=== 05-06.05.2018 ===<br />
Osalesime hackathonil. Lisatud controllerid, service'id koos vajalike kihtidega.<br />
<br />
=== 16.05.2018 ===<br />
Uuendatud andmebaasimudelit, DTO'sid.<br />
<br />
=== 18-19.05.2018 ===<br />
Lisatud klientrakendus, security, äriloogikat.<br />
<br />
=== 20.05.2018 ===<br />
Lisatud API dokumentatsioon.<br />
<br />
=== 22-24.05.2018 ===<br />
Uuendatud contoller'eid, service'id.<br />
<br />
=== 25-27.05.2018 ===<br />
Uuendatud contoller'eid, service'id. Lisatud kasutajate ja rollide kontrolle meetoditesse. Täiustatud klientrakendust. Swagger dokumentatsioon.</div>
Saasma
https://wiki.itcollege.ee/index.php?title=BeerPressure&diff=130890
BeerPressure
2018-05-27T20:08:37Z
<p>Saasma: </p>
<hr />
<div>== Meeskond ja rollid ==<br />
<br />
* Sigrid Aasma (arendaja)<br />
* Evelin Jõgi (arendaja)<br />
* Martin Kask (projektijuht, arendaja)<br />
* Marko Nõu (arendaja)<br />
<br />
== Idee ==<br />
'''Toidukohtade põhimenüüde ja päevapakkumiste teenus'''<br />
<br />
Soovime pakkuda toidukohtade põhimenüüde ja päevapakkumiste teenust. On olemas mitmeid kodulehti “päevapakkumised”, kus on kirjas toidukohtade päevapraed. Kuid tavaliselt sellistel lehtedel ei ole masinloetavaid andmeid ehk siis varianti, et saad saata API pihta mingi kuupäeva koos päevapraadidega andmete uuendamiseks ja saad sama API käest küsida tänaseid päevapraade. Andmeid võiks saada küsida restorani, kuupäeva, asukoha või otsisõna/otsisõnaosa põhiselt. Selline teenus lihtsustaks ka toidukohtade päevapakkumiste haldamist, kuna praegu peavad teenuse pakkujad vastavat informatsiooni uuendama mitmes erinevas kohas - nii erinevates portaalides, kui ka enda veebileheküljel. Samuti oleks toidukohtade kogu menüü haldamine ühes kohas.<br />
<br />
=== Esialgne prototüüp ===<br />
<br />
[[File:TäisKõhtProto1.mp4]]<br />
<br />
Esialgne prototüüp: [http://enos.itcollege.ee/~saasma/VR2/Proto/K%C3%B5htT%C3%A4is/#g=1&p=home navigeeritav versioon vol.1]<br />
<br />
=== Prototüübi muutus projekti käigus ===<br />
<br />
Prototüüp: [http://enos.itcollege.ee/~saasma/VR2/Proto/T%C3%A4isK%C3%B5ht/K%C3%B5htT%C3%A4is/#g=1&p=home navigeeritav versioon vol.2]<br />
<br />
== Kasutatav arendustehnoloogia ==<br />
<br />
Veebiteenuse loomisel kasutame ASP.NET Core tehnoloogiat ja kursusel õpitud arendusmustreid.<br />
<br />
Klientrakenduse loomisel kasutame Node.js + React'i.<br />
<br />
== Veebiteenuse analüüs ==<br />
Pakume toidukohtade põhimenüüde ja päevapakkumiste teenust, kuhu on kokku koondatud erinevate toidukohtade menüüd üle Eesti. Põhimenüü alla kuuluvad pikaajalised menüüd, mis kehtivad püsivalt, hooajaliselt või mingil konkreetsel nädalapäeval. Päevapakkumiste alla kuuluvad konkreetse kuupäevaga seotud päevapakkumised. Päevapakkumiste korral kuvatakse lisainfona, kas pakkumine kehtib mingis konkreetses ajavahemikus või kogu toidukoha lahtioleku aja.<br />
<br />
Eesmärk on koguda ühte kohta kokku erinevate toidukohtade menüüd ja päevapakkumised, et kliendid saaksid mugavalt ja kiiresti oma valikuid teha. Kliendid käivad enamasti päevapakkumisi söömas lõuna ajal ja selleks ettenähtud aeg on piiratud. Sellepärast on oluline, et klient saaks teha oma valiku võimalikult kiiresti. Tänu loodavale veebiteenusele ei pea kliendid käima erinevates portaalides, et tutvuda erinevate toidukohtade pakkumistega. Kuna teenust on mugav kasutada ja klient saab oma valiku kiiresti tehtud, siis tõenäoliselt teeb klient valiku selles keskkonnas olevate toiduasutuste seast. Lisaks võimaldab teenus toiduasutustel paika panna oma pikaajalisem põhimenüü ning seda rakenduses ja võimalusel ka söögikohas kuvada. Sellepärast on ka toidukohtade huvi antud keskkonnas üleval olla ja meiega oma andmeid jagada, sest see suurendab nende klientuuri ning muudab oma menüü haldamise kergemaks.<br />
<br />
Veebiteenuse loomisel lähtume eelkõige sellest, et kliendil oleks teenust mugav kasutada ja ta saaks oma valiku kiiresti tehtud. Arvestame, et kliendid on erinevad. Mõni eelistab mõnda kindlat toidukohta, sel juhul saab ta valida oma soovitud kohad ja võrrelda nende kohtade tänase päeva pakkumisi ning menüüsid. Mõnele inimesele on oluline pakutav söök ja ta eelistab pakkumist otsida prae nimetuses oleva sõna või sõnaosa järgi ning lähtuda seejärel valiku tegemisel toidukoha keskmisest hindest või toidu hinnast. Mõne kliendi jaoks on oluline hind ja selleks, et oma valikut teha sobivas hinnavahemikus on tal võimalik sisestada maksimum hinna piirang. Kindlasti on antud teenuse juures kõikide klientide jaoks oluline päevapakkumiste asukohapõhine eristatus. Kliendid, kes soovivad oma konto luua, võivad oma eelistatud valikud meelde jätta ja järgmisel korral kuvatakse neid talle automaatselt.<br />
<br />
Teenuse must-have funktsionaalsus tagab teenuse toimimise ja põhifunktsioonid. Teenuse nice-to-have funktsionaalsus annab rakendusele lisandväärtust.<br />
<br />
Arvestades pakutava teenusega, siis näeme, et aktiivseim teenuse kasutamine võib olla tööpäevadel vahemikus 11.00-15.00, kui kliendid tutvuvad päevapakkumistega. Teenus peab tekkivale koormusele vastu pidama.<br />
<br />
Teenuse pakkumine peab olema turvaline. Selle tagamiseks tuleb sisestatavaid andmeid valideerida ja andmebaasi sisestavate andmete mahtu piirata. Toidukohtade sisestatud andmed peavad olema kaitstud, et toitude koostised ei saaks avalikuks. Põhjendatud juhtudel on võimalik kasutajaid lukku panna.<br />
<br />
== Kasutajad ==<br />
<br />
<br />
* Admin - lehe administraator, kellel on õigus lehte, kasutajaid ja nende õiguseid hallata. Tema huvi on, et teenus toimiks tõrgeteta.<br />
* Toiduasutus (tasuta kasutaja) - saab hoida lehel ühte põhimenüüd ja päevapakkumisi.<br />
* Toiduasutus (tellimusega kasutaja) - saab hoida lehel piiramatu arv põhimenüüsid ja päevapakkumisi.<br />
Toiduasutused on teenusest huvitatud, et nende menüüde haldamine oleks kerge ja mugav ning nad saaksid oma klientide arvu suurendada.<br />
* Külastaja - klient, kes valib söögikohta. Tema on huvitatud eelkõige sellest, et teenust saaks kasutada mugavalt ja kiirelt ning toidukohtade valik oleks võimalikult suur.<br />
<br />
== Rakenduse must-have funktsionaalsus ==<br />
<br />
* Kasutajad saavad sisse logida<br />
* Kasutajatel on erinevad rollid: admin, toidukoht (tasuta ja tasulise tellimusega), klient<br />
* Kasutajate arvepidamine kasutajate lõikes:<br />
** sisselogimise kuupäev, kellaaeg<br />
** pakkumiste lisamine<br />
** pakkumiste muutmine<br />
** pakkumiste kustutamine<br />
** õiguste kehtimise periood (tasuta ja tellimusega toidukoht)<br />
** pakkumistele klikkimise arv<br />
* Kasutajaid on võimalik hallata:<br />
** kasutajale õiguste andmine (menüüde arvu suurendamine, tellimusega toidukohal), rolli määramine<br />
** Kasutajat on võimalik piirata: õiguseid piirata (piiratud menüüde arv, tasuta liitunud toidukohal) ja lukku panna<br />
* Päevapakkumisi/menüüsid saab küsida: <br />
** toidukoha järgi, <br />
** kuupäeva põhiselt (ainult päevapakkumisi), <br />
** asukoha põhiselt,<br />
** toidu nimetuses esineva otsisõna/otsisõna osa põhiselt,<br />
** hinna põhiselt (max hinna piirang).<br />
* Klientrakenduses realiseeritakse CRUD meetodid (menüüsid/päevapakkumisi saab sisestada, lugeda, uuendada, kustutada)<br />
* Toidukohale saab anda hindeid ja kuvatakse keskmist hinnet.<br />
* Toidule saab anda hindeid ja kuvatakse keskmist hinnet.<br />
<br />
== Nice-to-have funktsionaalsus ==<br />
<br />
* Info selle kohta, kas päevapakkumine on otsas<br />
* Päevapakkumisi/menüüsid saab kommenteerida ja neid kommentaare kuvatakse avalikult.<br />
* Söögikohtade kodulehtedelt otsimise script, mis genereerib juba olemasolevate kodulehtede baasil päevamenüüsid.<br />
* Toiduvaliku piiramine allergeenide/vegan/jms. koostisosade põhiselt.<br />
* Aruandlused ja võrdlused toidukohtadele, et võrrelda end konkurentidega.<br />
* Teenus soovitab toidukohtadele nende varasemate päevapraadide populaarsuse alusel uue nädala menüüd.<br />
* Erinevad toidukohtade/toitude pingeread klientidele, et anda valikuteks ideid.<br />
* Soovitused klientidele, mida teised kliendid sarnaste eelistustega on veel valinud.<br />
<br />
== Andmebaasi ülesehitus - projekti algus ==<br />
<br />
[[File: BeerPressureAndmebaasimudel.png]]<br />
<br />
== Andmebaasi ülesehitus - projekti lõpp ==<br />
<br />
[[File: TäisKõht-2018-05-27 21 58.png]]<br />
<br />
== Projekti repository ==<br />
<br />
https://github.com/sikumiku/TaisKohtApi<br />
<br />
Zip fail saadaval: <br />
<br />
== API v1 dokumentatsioon ==<br />
<br />
===Security===<br />
'''POST /api/account/register'''<br />
<source><br />
Params: RegisterViewModel registerViewModel<br />
<br />
Returns: token<br />
</source><br />
<br />
'''POST /api/account/login'''<br />
<source> <br />
Params: LoginViewModel model<br />
<br />
Returns: token<br />
</source><br />
<br />
'''POST /api/account/logout'''<br />
<source> <br />
Params: -<br />
<br />
Returns: -<br />
</source><br />
<br />
===Accounts===<br />
'''GET /api/v1/accounts/getAllUsersInRole'''<br />
<source> <br />
Params: string role<br />
<br />
Returns: List<UserDTO><br />
</source><br />
<br />
'''GET /api/v1/accounts/{id}'''<br />
<source> <br />
Params: string id<br />
<br />
Returns: UserDTO<br />
</source><br />
<br />
'''PUT /api/v1/accounts/{id}'''<br />
<source> <br />
Params: string id, UpdateUserDTO userDTO<br />
<br />
Returns: -<br />
</source><br />
<br />
'''POST /api/v1/accounts/addRole'''<br />
<source> <br />
Params: string role<br />
<br />
Returns: -<br />
</source><br />
<br />
'''POST /api/v1/accounts/addRoleToUser'''<br />
<source> <br />
Params: string role, string userId<br />
<br />
Returns: UserDTO<br />
</source><br />
<br />
'''DELETE /api/v1/accounts/deactivate/{id}'''<br />
<source> <br />
Params: string id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Promotions===<br />
'''GET /api/v1/promotions '''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<PromotionDTO> <br />
</source><br />
<br />
'''GET /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: PromotionDTO<br />
</source><br />
<br />
'''POST /api/v1/promotions'''<br />
<source> <br />
Params: PromotionDTO promotionDTO<br />
<br />
Returns: PromotionDTO newPromotion<br />
</source><br />
<br />
'''PUT /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id, PromotionDTO promotionDTO<br />
<br />
Returns: PromotionDTO updatedPromotion<br />
</source><br />
<br />
'''DELETE /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Restaurants===<br />
'''GET /api/v1/restaurants'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<SimpleRestaurantDTO><br />
</source><br />
<br />
'''GET /api/v1/restaurants/search?name=th'''<br />
<source> <br />
Params: string name<br />
<br />
Returns: List<SimpleRestaurantDTO> result<br />
</source><br />
<br />
'''GET /api/v1/restaurants/top'''<br />
<source> <br />
Params: int amount<br />
<br />
Returns: List<SimpleRestaurantDTO> result<br />
</source><br />
<br />
'''GET /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: RestaurantDTO r<br />
</source><br />
<br />
'''POST /api/v1/restaurants/addUserToRestaurant'''<br />
<source> <br />
Params: int id, string userId<br />
<br />
Returns: -<br />
</source><br />
<br />
'''POST /api/v1/restaurants'''<br />
<source> <br />
Params: PostRestaurantDTO restaurantDTO<br />
<br />
Returns: RestaurantDTO newRestaurant<br />
</source><br />
<br />
'''PUT /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id, PostRestaurantDTO restaurantDTO<br />
<br />
Returns: PostRestaurantDTO updatedRestaurantDTO<br />
</source><br />
<br />
'''DELETE /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Menus===<br />
'''GET /api/v1/menus'''<br />
<source><br />
Params: -<br />
<br />
Returns: List<MenuDTO><br />
</source><br />
<br />
'''GET /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: MenuDTO menuDTO<br />
</source><br />
<br />
'''POST /api/v1/menus'''<br />
<source> <br />
Params: PostMenuDTO menuDTO<br />
<br />
Returns: MenuDTO newMenu<br />
</source><br />
<br />
'''PUT /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id, PostMenuDTO menuDTO<br />
<br />
Returns: MenuDTO updatedMenu<br />
</source><br />
<br />
'''PUT api/v1/Menus/{id}/Dishes'''<br />
<source> <br />
Params: int menuId, int[] dishIds<br />
<br />
Returns: -<br />
</source><br />
<br />
'''DELETE /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Dishes===<br />
'''GET /api/v1/dishes'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<DishDTO><br />
</source><br />
<br />
'''GET /api/v1/dishes/daily'''<br />
<source> <br />
Params: bool vegan, bool glutenFree, bool lactoseFree<br />
<br />
Returns: List<SimpleDishDTO> result<br />
</source><br />
<br />
'''GET: api/v1/dishes/search?title=th&priceLimit=null'''<br />
<source> <br />
Params: string title, decimal? priceLimit<br />
<br />
Returns: List<DishDTO> result<br />
</source><br />
<br />
'''GET /api/v1/dishes/top'''<br />
<source> <br />
Params: int amount<br />
<br />
Returns: List<DishDTO> result<br />
</source><br />
<br />
'''GET /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: DishDTO dishDTO<br />
</source><br />
<br />
'''POST /api/v1/dishes'''<br />
<source> <br />
Params: PostDishDTO dishDTO<br />
<br />
Returns: DishDTO newDish<br />
</source><br />
<br />
'''PUT /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id, PostDishDTO dishDTO<br />
<br />
Returns: DishDTO updatedDish<br />
</source><br />
<br />
'''PUT api/v1/Dishes/{id}/Ingredients'''<br />
<source> <br />
Params: int dishId, PostIngredientForDishDTO[] ingredients<br />
<br />
Returns: -<br />
</source><br />
<br />
'''DELETE /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Ingredients===<br />
'''GET /api/v1/ingredients'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<IngredientDTO><br />
</source><br />
<br />
'''GET /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: IngredientDTO i<br />
</source><br />
<br />
'''POST /api/v1/ingredients'''<br />
<source> <br />
Params: PostIngredientDTO ingredientDTO<br />
<br />
Returns: IngredientDTO newIngredient<br />
</source><br />
<br />
'''PUT /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id, PostIngredientDTO ingredientDTO<br />
<br />
Returns: IngredientDTO updatedIngredient<br />
</source><br />
<br />
'''DELETE /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Ratings===<br />
'''GET /api/v1/ratings'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<RatingLogDTO><br />
</source><br />
<br />
'''GET /api/v1/ratings/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: RatingLogDTO dto<br />
</source><br />
<br />
'''POST /api/v1/ratings'''<br />
<source> <br />
Params: RatingLogForEntityDTO ratingDTO<br />
<br />
Returns: RatingLogDTO newRating<br />
</source><br />
<br />
'''PUT api/v1/ratings/{id}'''<br />
<source> <br />
Params: int id, RatingLogForEntityDTO ratingDTO<br />
<br />
Returns: RatingLogDTO updatedRating<br />
</source><br />
<br />
'''DELETE api/v1/ratings/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===RequestLog===<br />
'''GET: api/v1/usageData/{userId}'''<br />
<source> <br />
Params: string userId<br />
<br />
Returns: List<RequestLogDTO><br />
</source><br />
<br />
== Lõpptoote kasutusjuhend ==<br />
<br />
* Kloonida kohalikku arvutisse repository aadressilt [https://github.com/sikumiku/TaisKohtApi https://github.com/sikumiku/TaisKohtApi]<br />
* Installida NodeJS<br />
* <source>npm install webpack -g</source><br />
* <source>npm install -cli -g</source><br />
* Frontend rakenduse kasutamiseks valida Startup meetoditest IIS Express, veebiteenuse ja Swaggeri kasutamiseks käivitada Api Swagger<br />
<br />
== Logiraamat ==<br />
<br />
===07.02.2018===<br />
Gupi loomine ning suhtluskanali seadistamine<br />
<br />
=== 24.03.2018 ===<br />
Trello boardi loomine<br />
<br />
=== 25.03.2018 ===<br />
Wiki lehe loomine. Esimene tõsisem projekti koosolek ning tegevuskava paika panemine.<br />
<br />
=== 26.03.2018 ===<br />
<br />
Alustasime veebiteenuse analüüsiga ja funktsionaalsuse kirjeldamisega.<br />
<br />
=== 27.03.2018 ===<br />
Täiendasime veebiteenuse analüüsi.<br />
<br />
Esmase andmebaasi mudeli koostamine.<br />
<br />
Postitatud esimeste analüüsi arutelude põhjal valminud algne prototüüp.<br />
<br />
=== 30.03.2018 ===<br />
Valmis andmebaasimudel.<br />
<br />
=== 08.04.2018 ===<br />
Tehtud muudatused analüüsis vastavalt tagasisidele.<br />
<br />
=== 19.04.2018 ===<br />
Loodud projekti põhi koos domeenimudelitega. Projekt lisatud Githubi: https://github.com/sikumiku/TaisKohtApi<br />
<br />
=== 05-06.05.2018 ===<br />
Osalesime hackathonil. Lisatud controllerid, service'id koos vajalike kihtidega.<br />
<br />
=== 16.05.2018 ===<br />
Uuendatud andmebaasimudelit, DTO'sid.<br />
<br />
=== 18-19.05.2018 ===<br />
Lisatud klientrakendus, security, äriloogikat.<br />
<br />
=== 20.05.2018 ===<br />
Lisatud API dokumentatsioon.<br />
<br />
=== 22-24.05.2018 ===<br />
Uuendatud contoller'eid, service'id.<br />
<br />
=== 25-27.05.2018 ===<br />
Uuendatud contoller'eid, service'id. Lisatud kasutajate ja rollide kontrolle meetoditesse. Täiustatud klientrakendust. Swagger dokumentatsioon.</div>
Saasma
https://wiki.itcollege.ee/index.php?title=BeerPressure&diff=130869
BeerPressure
2018-05-27T19:17:22Z
<p>Saasma: /* Idee */</p>
<hr />
<div>== Meeskond ja rollid ==<br />
<br />
* Sigrid Aasma (arendaja)<br />
* Evelin Jõgi (arendaja)<br />
* Martin Kask (projektijuht, arendaja)<br />
* Marko Nõu (arendaja)<br />
<br />
== Idee ==<br />
'''Toidukohtade põhimenüüde ja päevapakkumiste teenus'''<br />
<br />
Soovime pakkuda toidukohtade põhimenüüde ja päevapakkumiste teenust. On olemas mitmeid kodulehti “päevapakkumised”, kus on kirjas toidukohtade päevapraed. Kuid tavaliselt sellistel lehtedel ei ole masinloetavaid andmeid ehk siis varianti, et saad saata API pihta mingi kuupäeva koos päevapraadidega andmete uuendamiseks ja saad sama API käest küsida tänaseid päevapraade. Andmeid võiks saada küsida restorani, kuupäeva, asukoha või otsisõna/otsisõnaosa põhiselt. Selline teenus lihtsustaks ka toidukohtade päevapakkumiste haldamist, kuna praegu peavad teenuse pakkujad vastavat informatsiooni uuendama mitmes erinevas kohas - nii erinevates portaalides, kui ka enda veebileheküljel. Samuti oleks toidukohtade kogu menüü haldamine ühes kohas.<br />
<br />
=== Esialgne prototüüp ===<br />
<br />
[[File:TäisKõhtProto1.mp4]]<br />
<br />
Esialgne prototüüp: [http://enos.itcollege.ee/~saasma/VR2/Proto/K%C3%B5htT%C3%A4is/#g=1&p=home navigeeritav versioon vol.1]<br />
<br />
=== Prototüübi muutus projekti käigus ===<br />
<br />
Prototüüp: [http://enos.itcollege.ee/~saasma/VR2/Proto/T%C3%A4isK%C3%B5ht/K%C3%B5htT%C3%A4is/#g=1&p=home navigeeritav versioon vol.2]<br />
<br />
== Kasutatav arendustehnoloogia ==<br />
<br />
Veebiteenuse loomisel kasutame ASP.NET Core tehnoloogiat ja kursusel õpitud arendusmustreid.<br />
<br />
Klientrakenduse loomisel kasutame Node.js + React'i.<br />
<br />
== Veebiteenuse analüüs ==<br />
Pakume toidukohtade põhimenüüde ja päevapakkumiste teenust, kuhu on kokku koondatud erinevate toidukohtade menüüd üle Eesti. Põhimenüü alla kuuluvad pikaajalised menüüd, mis kehtivad püsivalt, hooajaliselt või mingil konkreetsel nädalapäeval. Päevapakkumiste alla kuuluvad konkreetse kuupäevaga seotud päevapakkumised. Päevapakkumiste korral kuvatakse lisainfona, kas pakkumine kehtib mingis konkreetses ajavahemikus või kogu toidukoha lahtioleku aja.<br />
<br />
Eesmärk on koguda ühte kohta kokku erinevate toidukohtade menüüd ja päevapakkumised, et kliendid saaksid mugavalt ja kiiresti oma valikuid teha. Kliendid käivad enamasti päevapakkumisi söömas lõuna ajal ja selleks ettenähtud aeg on piiratud. Sellepärast on oluline, et klient saaks teha oma valiku võimalikult kiiresti. Tänu loodavale veebiteenusele ei pea kliendid käima erinevates portaalides, et tutvuda erinevate toidukohtade pakkumistega. Kuna teenust on mugav kasutada ja klient saab oma valiku kiiresti tehtud, siis tõenäoliselt teeb klient valiku selles keskkonnas olevate toiduasutuste seast. Lisaks võimaldab teenus toiduasutustel paika panna oma pikaajalisem põhimenüü ning seda rakenduses ja võimalusel ka söögikohas kuvada. Sellepärast on ka toidukohtade huvi antud keskkonnas üleval olla ja meiega oma andmeid jagada, sest see suurendab nende klientuuri ning muudab oma menüü haldamise kergemaks.<br />
<br />
Veebiteenuse loomisel lähtume eelkõige sellest, et kliendil oleks teenust mugav kasutada ja ta saaks oma valiku kiiresti tehtud. Arvestame, et kliendid on erinevad. Mõni eelistab mõnda kindlat toidukohta, sel juhul saab ta valida oma soovitud kohad ja võrrelda nende kohtade tänase päeva pakkumisi ning menüüsid. Mõnele inimesele on oluline pakutav söök ja ta eelistab pakkumist otsida prae nimetuses oleva sõna või sõnaosa järgi ning lähtuda seejärel valiku tegemisel toidukoha keskmisest hindest või toidu hinnast. Mõne kliendi jaoks on oluline hind ja selleks, et oma valikut teha sobivas hinnavahemikus on tal võimalik sisestada maksimum hinna piirang. Kindlasti on antud teenuse juures kõikide klientide jaoks oluline päevapakkumiste asukohapõhine eristatus. Kliendid, kes soovivad oma konto luua, võivad oma eelistatud valikud meelde jätta ja järgmisel korral kuvatakse neid talle automaatselt.<br />
<br />
Teenuse must-have funktsionaalsus tagab teenuse toimimise ja põhifunktsioonid. Teenuse nice-to-have funktsionaalsus annab rakendusele lisandväärtust.<br />
<br />
Arvestades pakutava teenusega, siis näeme, et aktiivseim teenuse kasutamine võib olla tööpäevadel vahemikus 11.00-15.00, kui kliendid tutvuvad päevapakkumistega. Teenus peab tekkivale koormusele vastu pidama.<br />
<br />
Teenuse pakkumine peab olema turvaline. Selle tagamiseks tuleb sisestatavaid andmeid valideerida ja andmebaasi sisestavate andmete mahtu piirata. Toidukohtade sisestatud andmed peavad olema kaitstud, et toitude koostised ei saaks avalikuks. Põhjendatud juhtudel on võimalik kasutajaid lukku panna.<br />
<br />
== Kasutajad ==<br />
<br />
<br />
* Admin - lehe administraator, kellel on õigus lehte, kasutajaid ja nende õiguseid hallata. Tema huvi on, et teenus toimiks tõrgeteta.<br />
* Toiduasutus (tasuta kasutaja) - saab hoida lehel ühte põhimenüüd ja päevapakkumisi.<br />
* Toiduasutus (tellimusega kasutaja) - saab hoida lehel piiramatu arv põhimenüüsid ja päevapakkumisi.<br />
Toiduasutused on teenusest huvitatud, et nende menüüde haldamine oleks kerge ja mugav ning nad saaksid oma klientide arvu suurendada.<br />
* Külastaja - klient, kes valib söögikohta. Tema on huvitatud eelkõige sellest, et teenust saaks kasutada mugavalt ja kiirelt ning toidukohtade valik oleks võimalikult suur.<br />
<br />
== Rakenduse must-have funktsionaalsus ==<br />
<br />
* Kasutajad saavad sisse logida<br />
* Kasutajatel on erinevad rollid: admin, toidukoht (tasuta ja tasulise tellimusega), klient<br />
* Kasutajate arvepidamine kasutajate lõikes:<br />
** sisselogimise kuupäev, kellaaeg<br />
** pakkumiste lisamine<br />
** pakkumiste muutmine<br />
** pakkumiste kustutamine<br />
** õiguste kehtimise periood (tasuta ja tellimusega toidukoht)<br />
** pakkumistele klikkimise arv<br />
* Kasutajaid on võimalik hallata:<br />
** kasutajale õiguste andmine (menüüde arvu suurendamine, tellimusega toidukohal), rolli määramine<br />
** Kasutajat on võimalik piirata: õiguseid piirata (piiratud menüüde arv, tasuta liitunud toidukohal) ja lukku panna<br />
* Päevapakkumisi/menüüsid saab küsida: <br />
** toidukoha järgi, <br />
** kuupäeva põhiselt (ainult päevapakkumisi), <br />
** asukoha põhiselt,<br />
** toidu nimetuses esineva otsisõna/otsisõna osa põhiselt,<br />
** hinna põhiselt (max hinna piirang).<br />
* Klientrakenduses realiseeritakse CRUD meetodid (menüüsid/päevapakkumisi saab sisestada, lugeda, uuendada, kustutada)<br />
* Toidukohale saab anda hindeid ja kuvatakse keskmist hinnet.<br />
* Toidule saab anda hindeid ja kuvatakse keskmist hinnet.<br />
<br />
== Nice-to-have funktsionaalsus ==<br />
<br />
* Info selle kohta, kas päevapakkumine on otsas<br />
* Päevapakkumisi/menüüsid saab kommenteerida ja neid kommentaare kuvatakse avalikult.<br />
* Söögikohtade kodulehtedelt otsimise script, mis genereerib juba olemasolevate kodulehtede baasil päevamenüüsid.<br />
* Toiduvaliku piiramine allergeenide/vegan/jms. koostisosade põhiselt.<br />
* Aruandlused ja võrdlused toidukohtadele, et võrrelda end konkurentidega.<br />
* Teenus soovitab toidukohtadele nende varasemate päevapraadide populaarsuse alusel uue nädala menüüd.<br />
* Erinevad toidukohtade/toitude pingeread klientidele, et anda valikuteks ideid.<br />
* Soovitused klientidele, mida teised kliendid sarnaste eelistustega on veel valinud.<br />
<br />
== Andmebaasi ülesehitus - projekti algus ==<br />
<br />
[[File: BeerPressureAndmebaasimudel.png]]<br />
<br />
== Andmebaasi ülesehitus - projekti lõpp ==<br />
<br />
[[File: TäisKõht-2018-05-27 21 58.png]]<br />
<br />
== API v1 dokumentatsioon ==<br />
<br />
===Security===<br />
'''POST /api/account/register'''<br />
<source><br />
Params: RegisterViewModel registerViewModel<br />
<br />
Returns: token<br />
</source><br />
<br />
'''POST /api/account/login'''<br />
<source> <br />
Params: LoginViewModel model<br />
<br />
Returns: token<br />
</source><br />
<br />
'''POST /api/account/logout'''<br />
<source> <br />
Params: -<br />
<br />
Returns: -<br />
</source><br />
<br />
===Accounts===<br />
'''GET /api/v1/accounts/getAllUsersInRole'''<br />
<source> <br />
Params: string role<br />
<br />
Returns: List<UserDTO><br />
</source><br />
<br />
'''GET /api/v1/accounts/{id}'''<br />
<source> <br />
Params: string id<br />
<br />
Returns: UserDTO<br />
</source><br />
<br />
'''PUT /api/v1/accounts/{id}'''<br />
<source> <br />
Params: string id, UpdateUserDTO userDTO<br />
<br />
Returns: -<br />
</source><br />
<br />
'''POST /api/v1/accounts/addRole'''<br />
<source> <br />
Params: string role<br />
<br />
Returns: -<br />
</source><br />
<br />
'''POST /api/v1/accounts/addRoleToUser'''<br />
<source> <br />
Params: string role, string userId<br />
<br />
Returns: UserDTO<br />
</source><br />
<br />
'''DELETE /api/v1/accounts/deactivate/{id}'''<br />
<source> <br />
Params: string id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Promotions===<br />
'''GET /api/v1/promotions '''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<PromotionDTO> <br />
</source><br />
<br />
'''GET /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: PromotionDTO<br />
</source><br />
<br />
'''POST /api/v1/promotions'''<br />
<source> <br />
Params: PromotionDTO promotionDTO<br />
<br />
Returns: PromotionDTO newPromotion<br />
</source><br />
<br />
'''PUT /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id, PromotionDTO promotionDTO<br />
<br />
Returns: PromotionDTO updatedPromotion<br />
</source><br />
<br />
'''DELETE /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Restaurants===<br />
'''GET /api/v1/restaurants'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<RestaurantDTO><br />
</source><br />
<br />
'''GET /api/v1/restaurants/search?name=th'''<br />
<source> <br />
Params: string name<br />
<br />
Returns: List<RestaurantDTO><br />
</source><br />
<br />
'''GET /api/v1/restaurants/top'''<br />
<source> <br />
Params: int amount<br />
<br />
Returns: List<RestaurantDTO><br />
</source><br />
<br />
'''GET /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: RestaurantDTO<br />
</source><br />
<br />
'''GET /api/v1/restaurants/{userId}'''<br />
<source> <br />
Params: int userId<br />
<br />
Returns: List<RestaurantDTO><br />
</source><br />
<br />
'''POST /api/v1/restaurants'''<br />
<source> <br />
Params: RestaurantDTO<br />
<br />
Returns: RestaurantDTO<br />
</source><br />
<br />
'''PUT /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id, RestaurantDTO<br />
<br />
Returns: -<br />
</source><br />
<br />
'''DELETE /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Menus===<br />
'''GET /api/v1/menus'''<br />
<source><br />
Params: -<br />
<br />
Returns: List<MenuDTO><br />
</source><br />
<br />
'''GET /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: MenuDTO<br />
</source><br />
<br />
'''POST /api/v1/menus'''<br />
<source> <br />
Params: MenuDTO<br />
<br />
Returns: MenuDTO<br />
</source><br />
<br />
'''PUT /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id, MenuDTO<br />
<br />
Returns: -<br />
</source><br />
<br />
'''DELETE /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Dishes===<br />
'''GET /api/v1/dishes'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<DishDTO><br />
</source><br />
<br />
'''GET /api/v1/dishes/daily'''<br />
<source> <br />
Params: bool vegan, bool glutenFree, bool lactoseFree<br />
<br />
Returns: List<DishDTO><br />
</source><br />
<br />
'''GET /api/v1/dishes/search?title=th'''<br />
<source> <br />
Params: string title<br />
<br />
Returns: List<DishDTO><br />
</source><br />
<br />
'''GET /api/v1/dishes/pricelimit'''<br />
<source> <br />
Params: decimal priceLimit<br />
<br />
Returns: List<DishDTO><br />
</source><br />
<br />
'''GET /api/v1/dishes/top'''<br />
<source> <br />
Params: int amount<br />
<br />
Returns: List<DishDTO><br />
</source><br />
<br />
'''GET /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: DishDTO<br />
</source><br />
<br />
'''POST /api/v1/dishes'''<br />
<source> <br />
Params: DishDTO<br />
<br />
Returns: DishDTO<br />
</source><br />
<br />
'''PUT /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id, DishDTO<br />
<br />
Returns: -<br />
</source><br />
<br />
'''DELETE /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Ingredients===<br />
'''GET /api/v1/ingredients'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<IngredientDTO><br />
</source><br />
<br />
'''GET /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: IngredientDTO<br />
</source><br />
<br />
'''POST /api/v1/ingredients'''<br />
<source> <br />
Params: IngredientDTO<br />
<br />
Returns: IngredientDTO<br />
</source><br />
<br />
'''PUT /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id, IngredientDTO<br />
<br />
Returns: -<br />
</source><br />
<br />
'''DELETE /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Ratings===<br />
'''GET /api/v1/ratings/dish/{id}'''<br />
<source> <br />
Params: int dishId<br />
<br />
Returns: DishDTO, int dishRating<br />
</source><br />
<br />
'''GET /api/v1/ratings/restaurant/{id}'''<br />
<source> <br />
Params: int restaurantId<br />
<br />
Returns: RestaurantDTO, int restaurantRating<br />
</source><br />
<br />
'''POST /api/v1/ratings/dish/{id}'''<br />
<source> <br />
Params: int dishRating<br />
<br />
Returns: DishDTO, int dishRating<br />
</source><br />
<br />
'''POST /api/v1/ratings/restaurant/{id}'''<br />
<source> <br />
Params: int restaurantRating<br />
<br />
Returns: RestaurantDTO, int restaurantRating<br />
</source><br />
<br />
== Lõpptoote kasutusjuhend ==<br />
<br />
* Kloonida kohalikku arvutisse repository aadressilt [https://github.com/sikumiku/TaisKohtApi https://github.com/sikumiku/TaisKohtApi]<br />
* Installida NodeJS<br />
* <source>npm install webpack -g</source><br />
* <source>npm install -cli -g</source><br />
* Frontend rakenduse kasutamiseks valida Startup meetoditest IIS Express, veebiteenuse ja Swaggeri kasutamiseks käivitada Api Swagger<br />
<br />
== Logiraamat ==<br />
<br />
===07.02.2018===<br />
Gupi loomine ning suhtluskanali seadistamine<br />
<br />
=== 24.03.2018 ===<br />
Trello boardi loomine<br />
<br />
=== 25.03.2018 ===<br />
Wiki lehe loomine. Esimene tõsisem projekti koosolek ning tegevuskava paika panemine.<br />
<br />
=== 26.03.2018 ===<br />
<br />
Alustasime veebiteenuse analüüsiga ja funktsionaalsuse kirjeldamisega.<br />
<br />
=== 27.03.2018 ===<br />
Täiendasime veebiteenuse analüüsi.<br />
<br />
Esmase andmebaasi mudeli koostamine.<br />
<br />
Postitatud esimeste analüüsi arutelude põhjal valminud algne prototüüp.<br />
<br />
=== 30.03.2018 ===<br />
Valmis andmebaasimudel.<br />
<br />
=== 08.04.2018 ===<br />
Tehtud muudatused analüüsis vastavalt tagasisidele.<br />
<br />
=== 19.04.2018 ===<br />
Loodud projekti põhi koos domeenimudelitega. Projekt lisatud Githubi: https://github.com/sikumiku/TaisKohtApi<br />
<br />
=== 05-06.05.2018 ===<br />
Osalesime hackathonil. Lisatud controllerid, service'id koos vajalike kihtidega.<br />
<br />
=== 16.05.2018 ===<br />
Uuendatud andmebaasimudelit, DTO'sid.<br />
<br />
=== 18-19.05.2018 ===<br />
Lisatud klientrakendus, security, äriloogikat.<br />
<br />
=== 20.05.2018 ===<br />
Lisatud API dokumentatsioon.<br />
<br />
=== 22-24.05.2018 ===<br />
Uuendatud contoller'eid, service'id.<br />
<br />
=== 25-27.05.2018 ===<br />
Uuendatud contoller'eid, service'id. Lisatud kasutajate ja rollide kontrolle meetoditesse. Täiustatud klientrakendust. Swagger dokumentatsioon.</div>
Saasma
https://wiki.itcollege.ee/index.php?title=BeerPressure&diff=130866
BeerPressure
2018-05-27T19:11:34Z
<p>Saasma: /* Lõpptoote kasutusjuhend */</p>
<hr />
<div>== Meeskond ja rollid ==<br />
<br />
* Sigrid Aasma (arendaja)<br />
* Evelin Jõgi (arendaja)<br />
* Martin Kask (projektijuht, arendaja)<br />
* Marko Nõu (arendaja)<br />
<br />
== Idee ==<br />
'''Toidukohtade põhimenüüde ja päevapakkumiste teenus'''<br />
<br />
Soovime pakkuda toidukohtade põhimenüüde ja päevapakkumiste teenust. On olemas mitmeid kodulehti “päevapakkumised”, kus on kirjas toidukohtade päevapraed. Kuid tavaliselt sellistel lehtedel ei ole masinloetavaid andmeid ehk siis varianti, et saad saata API pihta mingi kuupäeva koos päevapraadidega andmete uuendamiseks ja saad sama API käest küsida tänaseid päevapraade. Andmeid võiks saada küsida restorani, kuupäeva, asukoha või otsisõna/otsisõnaosa põhiselt. Selline teenus lihtsustaks ka toidukohtade päevapakkumiste haldamist, kuna praegu peavad teenuse pakkujad vastavat informatsiooni uuendama mitmes erinevas kohas - nii erinevates portaalides, kui ka enda veebileheküljel. Samuti oleks toidukohtade kogu menüü haldamine ühes kohas.<br />
<br />
[[File:TäisKõhtProto1.mp4]]<br />
<br />
Esialgne prototüüp: [http://enos.itcollege.ee/~saasma/VR2/Proto/K%C3%B5htT%C3%A4is/#g=1&p=home navigeeritav versioon]<br />
<br />
== Kasutatav arendustehnoloogia ==<br />
<br />
Veebiteenuse loomisel kasutame ASP.NET Core tehnoloogiat ja kursusel õpitud arendusmustreid.<br />
<br />
Klientrakenduse loomisel kasutame Node.js + React'i.<br />
<br />
== Veebiteenuse analüüs ==<br />
Pakume toidukohtade põhimenüüde ja päevapakkumiste teenust, kuhu on kokku koondatud erinevate toidukohtade menüüd üle Eesti. Põhimenüü alla kuuluvad pikaajalised menüüd, mis kehtivad püsivalt, hooajaliselt või mingil konkreetsel nädalapäeval. Päevapakkumiste alla kuuluvad konkreetse kuupäevaga seotud päevapakkumised. Päevapakkumiste korral kuvatakse lisainfona, kas pakkumine kehtib mingis konkreetses ajavahemikus või kogu toidukoha lahtioleku aja.<br />
<br />
Eesmärk on koguda ühte kohta kokku erinevate toidukohtade menüüd ja päevapakkumised, et kliendid saaksid mugavalt ja kiiresti oma valikuid teha. Kliendid käivad enamasti päevapakkumisi söömas lõuna ajal ja selleks ettenähtud aeg on piiratud. Sellepärast on oluline, et klient saaks teha oma valiku võimalikult kiiresti. Tänu loodavale veebiteenusele ei pea kliendid käima erinevates portaalides, et tutvuda erinevate toidukohtade pakkumistega. Kuna teenust on mugav kasutada ja klient saab oma valiku kiiresti tehtud, siis tõenäoliselt teeb klient valiku selles keskkonnas olevate toiduasutuste seast. Lisaks võimaldab teenus toiduasutustel paika panna oma pikaajalisem põhimenüü ning seda rakenduses ja võimalusel ka söögikohas kuvada. Sellepärast on ka toidukohtade huvi antud keskkonnas üleval olla ja meiega oma andmeid jagada, sest see suurendab nende klientuuri ning muudab oma menüü haldamise kergemaks.<br />
<br />
Veebiteenuse loomisel lähtume eelkõige sellest, et kliendil oleks teenust mugav kasutada ja ta saaks oma valiku kiiresti tehtud. Arvestame, et kliendid on erinevad. Mõni eelistab mõnda kindlat toidukohta, sel juhul saab ta valida oma soovitud kohad ja võrrelda nende kohtade tänase päeva pakkumisi ning menüüsid. Mõnele inimesele on oluline pakutav söök ja ta eelistab pakkumist otsida prae nimetuses oleva sõna või sõnaosa järgi ning lähtuda seejärel valiku tegemisel toidukoha keskmisest hindest või toidu hinnast. Mõne kliendi jaoks on oluline hind ja selleks, et oma valikut teha sobivas hinnavahemikus on tal võimalik sisestada maksimum hinna piirang. Kindlasti on antud teenuse juures kõikide klientide jaoks oluline päevapakkumiste asukohapõhine eristatus. Kliendid, kes soovivad oma konto luua, võivad oma eelistatud valikud meelde jätta ja järgmisel korral kuvatakse neid talle automaatselt.<br />
<br />
Teenuse must-have funktsionaalsus tagab teenuse toimimise ja põhifunktsioonid. Teenuse nice-to-have funktsionaalsus annab rakendusele lisandväärtust.<br />
<br />
Arvestades pakutava teenusega, siis näeme, et aktiivseim teenuse kasutamine võib olla tööpäevadel vahemikus 11.00-15.00, kui kliendid tutvuvad päevapakkumistega. Teenus peab tekkivale koormusele vastu pidama.<br />
<br />
Teenuse pakkumine peab olema turvaline. Selle tagamiseks tuleb sisestatavaid andmeid valideerida ja andmebaasi sisestavate andmete mahtu piirata. Toidukohtade sisestatud andmed peavad olema kaitstud, et toitude koostised ei saaks avalikuks. Põhjendatud juhtudel on võimalik kasutajaid lukku panna.<br />
<br />
== Kasutajad ==<br />
<br />
<br />
* Admin - lehe administraator, kellel on õigus lehte, kasutajaid ja nende õiguseid hallata. Tema huvi on, et teenus toimiks tõrgeteta.<br />
* Toiduasutus (tasuta kasutaja) - saab hoida lehel ühte põhimenüüd ja päevapakkumisi.<br />
* Toiduasutus (tellimusega kasutaja) - saab hoida lehel piiramatu arv põhimenüüsid ja päevapakkumisi.<br />
Toiduasutused on teenusest huvitatud, et nende menüüde haldamine oleks kerge ja mugav ning nad saaksid oma klientide arvu suurendada.<br />
* Külastaja - klient, kes valib söögikohta. Tema on huvitatud eelkõige sellest, et teenust saaks kasutada mugavalt ja kiirelt ning toidukohtade valik oleks võimalikult suur.<br />
<br />
== Rakenduse must-have funktsionaalsus ==<br />
<br />
* Kasutajad saavad sisse logida<br />
* Kasutajatel on erinevad rollid: admin, toidukoht (tasuta ja tasulise tellimusega), klient<br />
* Kasutajate arvepidamine kasutajate lõikes:<br />
** sisselogimise kuupäev, kellaaeg<br />
** pakkumiste lisamine<br />
** pakkumiste muutmine<br />
** pakkumiste kustutamine<br />
** õiguste kehtimise periood (tasuta ja tellimusega toidukoht)<br />
** pakkumistele klikkimise arv<br />
* Kasutajaid on võimalik hallata:<br />
** kasutajale õiguste andmine (menüüde arvu suurendamine, tellimusega toidukohal), rolli määramine<br />
** Kasutajat on võimalik piirata: õiguseid piirata (piiratud menüüde arv, tasuta liitunud toidukohal) ja lukku panna<br />
* Päevapakkumisi/menüüsid saab küsida: <br />
** toidukoha järgi, <br />
** kuupäeva põhiselt (ainult päevapakkumisi), <br />
** asukoha põhiselt,<br />
** toidu nimetuses esineva otsisõna/otsisõna osa põhiselt,<br />
** hinna põhiselt (max hinna piirang).<br />
* Klientrakenduses realiseeritakse CRUD meetodid (menüüsid/päevapakkumisi saab sisestada, lugeda, uuendada, kustutada)<br />
* Toidukohale saab anda hindeid ja kuvatakse keskmist hinnet.<br />
* Toidule saab anda hindeid ja kuvatakse keskmist hinnet.<br />
<br />
== Nice-to-have funktsionaalsus ==<br />
<br />
* Info selle kohta, kas päevapakkumine on otsas<br />
* Päevapakkumisi/menüüsid saab kommenteerida ja neid kommentaare kuvatakse avalikult.<br />
* Söögikohtade kodulehtedelt otsimise script, mis genereerib juba olemasolevate kodulehtede baasil päevamenüüsid.<br />
* Toiduvaliku piiramine allergeenide/vegan/jms. koostisosade põhiselt.<br />
* Aruandlused ja võrdlused toidukohtadele, et võrrelda end konkurentidega.<br />
* Teenus soovitab toidukohtadele nende varasemate päevapraadide populaarsuse alusel uue nädala menüüd.<br />
* Erinevad toidukohtade/toitude pingeread klientidele, et anda valikuteks ideid.<br />
* Soovitused klientidele, mida teised kliendid sarnaste eelistustega on veel valinud.<br />
<br />
== Andmebaasi ülesehitus - projekti algus ==<br />
<br />
[[File: BeerPressureAndmebaasimudel.png]]<br />
<br />
== Andmebaasi ülesehitus - projekti lõpp ==<br />
<br />
[[File: TäisKõht-2018-05-27 21 58.png]]<br />
<br />
== API v1 dokumentatsioon ==<br />
<br />
===Security===<br />
'''POST /api/account/register'''<br />
<source><br />
Params: RegisterViewModel registerViewModel<br />
<br />
Returns: token<br />
</source><br />
<br />
'''POST /api/account/login'''<br />
<source> <br />
Params: LoginViewModel model<br />
<br />
Returns: token<br />
</source><br />
<br />
'''POST /api/account/logout'''<br />
<source> <br />
Params: -<br />
<br />
Returns: -<br />
</source><br />
<br />
===Accounts===<br />
'''GET /api/v1/accounts/getAllUsersInRole'''<br />
<source> <br />
Params: string role<br />
<br />
Returns: List<UserDTO><br />
</source><br />
<br />
'''GET /api/v1/accounts/{id}'''<br />
<source> <br />
Params: string id<br />
<br />
Returns: UserDTO<br />
</source><br />
<br />
'''PUT /api/v1/accounts/{id}'''<br />
<source> <br />
Params: string id, UpdateUserDTO userDTO<br />
<br />
Returns: -<br />
</source><br />
<br />
'''POST /api/v1/accounts/addRole'''<br />
<source> <br />
Params: string role<br />
<br />
Returns: -<br />
</source><br />
<br />
'''POST /api/v1/accounts/addRoleToUser'''<br />
<source> <br />
Params: string role, string userId<br />
<br />
Returns: UserDTO<br />
</source><br />
<br />
'''DELETE /api/v1/accounts/deactivate/{id}'''<br />
<source> <br />
Params: string id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Promotions===<br />
'''GET /api/v1/promotions '''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<PromotionDTO> <br />
</source><br />
<br />
'''GET /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: PromotionDTO<br />
</source><br />
<br />
'''POST /api/v1/promotions'''<br />
<source> <br />
Params: PromotionDTO promotionDTO<br />
<br />
Returns: PromotionDTO newPromotion<br />
</source><br />
<br />
'''PUT /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id, PromotionDTO promotionDTO<br />
<br />
Returns: PromotionDTO updatedPromotion<br />
</source><br />
<br />
'''DELETE /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Restaurants===<br />
'''GET /api/v1/restaurants'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<RestaurantDTO><br />
</source><br />
<br />
'''GET /api/v1/restaurants/search?name=th'''<br />
<source> <br />
Params: string name<br />
<br />
Returns: List<RestaurantDTO><br />
</source><br />
<br />
'''GET /api/v1/restaurants/top'''<br />
<source> <br />
Params: int amount<br />
<br />
Returns: List<RestaurantDTO><br />
</source><br />
<br />
'''GET /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: RestaurantDTO<br />
</source><br />
<br />
'''GET /api/v1/restaurants/{userId}'''<br />
<source> <br />
Params: int userId<br />
<br />
Returns: List<RestaurantDTO><br />
</source><br />
<br />
'''POST /api/v1/restaurants'''<br />
<source> <br />
Params: RestaurantDTO<br />
<br />
Returns: RestaurantDTO<br />
</source><br />
<br />
'''PUT /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id, RestaurantDTO<br />
<br />
Returns: -<br />
</source><br />
<br />
'''DELETE /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Menus===<br />
'''GET /api/v1/menus'''<br />
<source><br />
Params: -<br />
<br />
Returns: List<MenuDTO><br />
</source><br />
<br />
'''GET /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: MenuDTO<br />
</source><br />
<br />
'''POST /api/v1/menus'''<br />
<source> <br />
Params: MenuDTO<br />
<br />
Returns: MenuDTO<br />
</source><br />
<br />
'''PUT /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id, MenuDTO<br />
<br />
Returns: -<br />
</source><br />
<br />
'''DELETE /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Dishes===<br />
'''GET /api/v1/dishes'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<DishDTO><br />
</source><br />
<br />
'''GET /api/v1/dishes/daily'''<br />
<source> <br />
Params: bool vegan, bool glutenFree, bool lactoseFree<br />
<br />
Returns: List<DishDTO><br />
</source><br />
<br />
'''GET /api/v1/dishes/search?title=th'''<br />
<source> <br />
Params: string title<br />
<br />
Returns: List<DishDTO><br />
</source><br />
<br />
'''GET /api/v1/dishes/pricelimit'''<br />
<source> <br />
Params: decimal priceLimit<br />
<br />
Returns: List<DishDTO><br />
</source><br />
<br />
'''GET /api/v1/dishes/top'''<br />
<source> <br />
Params: int amount<br />
<br />
Returns: List<DishDTO><br />
</source><br />
<br />
'''GET /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: DishDTO<br />
</source><br />
<br />
'''POST /api/v1/dishes'''<br />
<source> <br />
Params: DishDTO<br />
<br />
Returns: DishDTO<br />
</source><br />
<br />
'''PUT /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id, DishDTO<br />
<br />
Returns: -<br />
</source><br />
<br />
'''DELETE /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Ingredients===<br />
'''GET /api/v1/ingredients'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<IngredientDTO><br />
</source><br />
<br />
'''GET /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: IngredientDTO<br />
</source><br />
<br />
'''POST /api/v1/ingredients'''<br />
<source> <br />
Params: IngredientDTO<br />
<br />
Returns: IngredientDTO<br />
</source><br />
<br />
'''PUT /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id, IngredientDTO<br />
<br />
Returns: -<br />
</source><br />
<br />
'''DELETE /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Ratings===<br />
'''GET /api/v1/ratings/dish/{id}'''<br />
<source> <br />
Params: int dishId<br />
<br />
Returns: DishDTO, int dishRating<br />
</source><br />
<br />
'''GET /api/v1/ratings/restaurant/{id}'''<br />
<source> <br />
Params: int restaurantId<br />
<br />
Returns: RestaurantDTO, int restaurantRating<br />
</source><br />
<br />
'''POST /api/v1/ratings/dish/{id}'''<br />
<source> <br />
Params: int dishRating<br />
<br />
Returns: DishDTO, int dishRating<br />
</source><br />
<br />
'''POST /api/v1/ratings/restaurant/{id}'''<br />
<source> <br />
Params: int restaurantRating<br />
<br />
Returns: RestaurantDTO, int restaurantRating<br />
</source><br />
<br />
== Lõpptoote kasutusjuhend ==<br />
<br />
* Kloonida kohalikku arvutisse repository aadressilt [https://github.com/sikumiku/TaisKohtApi https://github.com/sikumiku/TaisKohtApi]<br />
* Installida NodeJS<br />
* <source>npm install webpack -g</source><br />
* <source>npm install -cli -g</source><br />
* Frontend rakenduse kasutamiseks valida Startup meetoditest IIS Express, veebiteenuse ja Swaggeri kasutamiseks käivitada Api Swagger<br />
<br />
== Logiraamat ==<br />
<br />
===07.02.2018===<br />
Gupi loomine ning suhtluskanali seadistamine<br />
<br />
=== 24.03.2018 ===<br />
Trello boardi loomine<br />
<br />
=== 25.03.2018 ===<br />
Wiki lehe loomine. Esimene tõsisem projekti koosolek ning tegevuskava paika panemine.<br />
<br />
=== 26.03.2018 ===<br />
<br />
Alustasime veebiteenuse analüüsiga ja funktsionaalsuse kirjeldamisega.<br />
<br />
=== 27.03.2018 ===<br />
Täiendasime veebiteenuse analüüsi.<br />
<br />
Esmase andmebaasi mudeli koostamine.<br />
<br />
Postitatud esimeste analüüsi arutelude põhjal valminud algne prototüüp.<br />
<br />
=== 30.03.2018 ===<br />
Valmis andmebaasimudel.<br />
<br />
=== 08.04.2018 ===<br />
Tehtud muudatused analüüsis vastavalt tagasisidele.<br />
<br />
=== 19.04.2018 ===<br />
Loodud projekti põhi koos domeenimudelitega. Projekt lisatud Githubi: https://github.com/sikumiku/TaisKohtApi<br />
<br />
=== 05-06.05.2018 ===<br />
Osalesime hackathonil. Lisatud controllerid, service'id koos vajalike kihtidega.<br />
<br />
=== 16.05.2018 ===<br />
Uuendatud andmebaasimudelit, DTO'sid.<br />
<br />
=== 18-19.05.2018 ===<br />
Lisatud klientrakendus, security, äriloogikat.<br />
<br />
=== 20.05.2018 ===<br />
Lisatud API dokumentatsioon.<br />
<br />
=== 22-24.05.2018 ===<br />
Uuendatud contoller'eid, service'id.<br />
<br />
=== 25-27.05.2018 ===<br />
Uuendatud contoller'eid, service'id. Lisatud kasutajate ja rollide kontrolle meetoditesse. Täiustatud klientrakendust. Swagger dokumentatsioon.</div>
Saasma
https://wiki.itcollege.ee/index.php?title=BeerPressure&diff=130863
BeerPressure
2018-05-27T19:07:58Z
<p>Saasma: </p>
<hr />
<div>== Meeskond ja rollid ==<br />
<br />
* Sigrid Aasma (arendaja)<br />
* Evelin Jõgi (arendaja)<br />
* Martin Kask (projektijuht, arendaja)<br />
* Marko Nõu (arendaja)<br />
<br />
== Idee ==<br />
'''Toidukohtade põhimenüüde ja päevapakkumiste teenus'''<br />
<br />
Soovime pakkuda toidukohtade põhimenüüde ja päevapakkumiste teenust. On olemas mitmeid kodulehti “päevapakkumised”, kus on kirjas toidukohtade päevapraed. Kuid tavaliselt sellistel lehtedel ei ole masinloetavaid andmeid ehk siis varianti, et saad saata API pihta mingi kuupäeva koos päevapraadidega andmete uuendamiseks ja saad sama API käest küsida tänaseid päevapraade. Andmeid võiks saada küsida restorani, kuupäeva, asukoha või otsisõna/otsisõnaosa põhiselt. Selline teenus lihtsustaks ka toidukohtade päevapakkumiste haldamist, kuna praegu peavad teenuse pakkujad vastavat informatsiooni uuendama mitmes erinevas kohas - nii erinevates portaalides, kui ka enda veebileheküljel. Samuti oleks toidukohtade kogu menüü haldamine ühes kohas.<br />
<br />
[[File:TäisKõhtProto1.mp4]]<br />
<br />
Esialgne prototüüp: [http://enos.itcollege.ee/~saasma/VR2/Proto/K%C3%B5htT%C3%A4is/#g=1&p=home navigeeritav versioon]<br />
<br />
== Kasutatav arendustehnoloogia ==<br />
<br />
Veebiteenuse loomisel kasutame ASP.NET Core tehnoloogiat ja kursusel õpitud arendusmustreid.<br />
<br />
Klientrakenduse loomisel kasutame Node.js + React'i.<br />
<br />
== Veebiteenuse analüüs ==<br />
Pakume toidukohtade põhimenüüde ja päevapakkumiste teenust, kuhu on kokku koondatud erinevate toidukohtade menüüd üle Eesti. Põhimenüü alla kuuluvad pikaajalised menüüd, mis kehtivad püsivalt, hooajaliselt või mingil konkreetsel nädalapäeval. Päevapakkumiste alla kuuluvad konkreetse kuupäevaga seotud päevapakkumised. Päevapakkumiste korral kuvatakse lisainfona, kas pakkumine kehtib mingis konkreetses ajavahemikus või kogu toidukoha lahtioleku aja.<br />
<br />
Eesmärk on koguda ühte kohta kokku erinevate toidukohtade menüüd ja päevapakkumised, et kliendid saaksid mugavalt ja kiiresti oma valikuid teha. Kliendid käivad enamasti päevapakkumisi söömas lõuna ajal ja selleks ettenähtud aeg on piiratud. Sellepärast on oluline, et klient saaks teha oma valiku võimalikult kiiresti. Tänu loodavale veebiteenusele ei pea kliendid käima erinevates portaalides, et tutvuda erinevate toidukohtade pakkumistega. Kuna teenust on mugav kasutada ja klient saab oma valiku kiiresti tehtud, siis tõenäoliselt teeb klient valiku selles keskkonnas olevate toiduasutuste seast. Lisaks võimaldab teenus toiduasutustel paika panna oma pikaajalisem põhimenüü ning seda rakenduses ja võimalusel ka söögikohas kuvada. Sellepärast on ka toidukohtade huvi antud keskkonnas üleval olla ja meiega oma andmeid jagada, sest see suurendab nende klientuuri ning muudab oma menüü haldamise kergemaks.<br />
<br />
Veebiteenuse loomisel lähtume eelkõige sellest, et kliendil oleks teenust mugav kasutada ja ta saaks oma valiku kiiresti tehtud. Arvestame, et kliendid on erinevad. Mõni eelistab mõnda kindlat toidukohta, sel juhul saab ta valida oma soovitud kohad ja võrrelda nende kohtade tänase päeva pakkumisi ning menüüsid. Mõnele inimesele on oluline pakutav söök ja ta eelistab pakkumist otsida prae nimetuses oleva sõna või sõnaosa järgi ning lähtuda seejärel valiku tegemisel toidukoha keskmisest hindest või toidu hinnast. Mõne kliendi jaoks on oluline hind ja selleks, et oma valikut teha sobivas hinnavahemikus on tal võimalik sisestada maksimum hinna piirang. Kindlasti on antud teenuse juures kõikide klientide jaoks oluline päevapakkumiste asukohapõhine eristatus. Kliendid, kes soovivad oma konto luua, võivad oma eelistatud valikud meelde jätta ja järgmisel korral kuvatakse neid talle automaatselt.<br />
<br />
Teenuse must-have funktsionaalsus tagab teenuse toimimise ja põhifunktsioonid. Teenuse nice-to-have funktsionaalsus annab rakendusele lisandväärtust.<br />
<br />
Arvestades pakutava teenusega, siis näeme, et aktiivseim teenuse kasutamine võib olla tööpäevadel vahemikus 11.00-15.00, kui kliendid tutvuvad päevapakkumistega. Teenus peab tekkivale koormusele vastu pidama.<br />
<br />
Teenuse pakkumine peab olema turvaline. Selle tagamiseks tuleb sisestatavaid andmeid valideerida ja andmebaasi sisestavate andmete mahtu piirata. Toidukohtade sisestatud andmed peavad olema kaitstud, et toitude koostised ei saaks avalikuks. Põhjendatud juhtudel on võimalik kasutajaid lukku panna.<br />
<br />
== Kasutajad ==<br />
<br />
<br />
* Admin - lehe administraator, kellel on õigus lehte, kasutajaid ja nende õiguseid hallata. Tema huvi on, et teenus toimiks tõrgeteta.<br />
* Toiduasutus (tasuta kasutaja) - saab hoida lehel ühte põhimenüüd ja päevapakkumisi.<br />
* Toiduasutus (tellimusega kasutaja) - saab hoida lehel piiramatu arv põhimenüüsid ja päevapakkumisi.<br />
Toiduasutused on teenusest huvitatud, et nende menüüde haldamine oleks kerge ja mugav ning nad saaksid oma klientide arvu suurendada.<br />
* Külastaja - klient, kes valib söögikohta. Tema on huvitatud eelkõige sellest, et teenust saaks kasutada mugavalt ja kiirelt ning toidukohtade valik oleks võimalikult suur.<br />
<br />
== Rakenduse must-have funktsionaalsus ==<br />
<br />
* Kasutajad saavad sisse logida<br />
* Kasutajatel on erinevad rollid: admin, toidukoht (tasuta ja tasulise tellimusega), klient<br />
* Kasutajate arvepidamine kasutajate lõikes:<br />
** sisselogimise kuupäev, kellaaeg<br />
** pakkumiste lisamine<br />
** pakkumiste muutmine<br />
** pakkumiste kustutamine<br />
** õiguste kehtimise periood (tasuta ja tellimusega toidukoht)<br />
** pakkumistele klikkimise arv<br />
* Kasutajaid on võimalik hallata:<br />
** kasutajale õiguste andmine (menüüde arvu suurendamine, tellimusega toidukohal), rolli määramine<br />
** Kasutajat on võimalik piirata: õiguseid piirata (piiratud menüüde arv, tasuta liitunud toidukohal) ja lukku panna<br />
* Päevapakkumisi/menüüsid saab küsida: <br />
** toidukoha järgi, <br />
** kuupäeva põhiselt (ainult päevapakkumisi), <br />
** asukoha põhiselt,<br />
** toidu nimetuses esineva otsisõna/otsisõna osa põhiselt,<br />
** hinna põhiselt (max hinna piirang).<br />
* Klientrakenduses realiseeritakse CRUD meetodid (menüüsid/päevapakkumisi saab sisestada, lugeda, uuendada, kustutada)<br />
* Toidukohale saab anda hindeid ja kuvatakse keskmist hinnet.<br />
* Toidule saab anda hindeid ja kuvatakse keskmist hinnet.<br />
<br />
== Nice-to-have funktsionaalsus ==<br />
<br />
* Info selle kohta, kas päevapakkumine on otsas<br />
* Päevapakkumisi/menüüsid saab kommenteerida ja neid kommentaare kuvatakse avalikult.<br />
* Söögikohtade kodulehtedelt otsimise script, mis genereerib juba olemasolevate kodulehtede baasil päevamenüüsid.<br />
* Toiduvaliku piiramine allergeenide/vegan/jms. koostisosade põhiselt.<br />
* Aruandlused ja võrdlused toidukohtadele, et võrrelda end konkurentidega.<br />
* Teenus soovitab toidukohtadele nende varasemate päevapraadide populaarsuse alusel uue nädala menüüd.<br />
* Erinevad toidukohtade/toitude pingeread klientidele, et anda valikuteks ideid.<br />
* Soovitused klientidele, mida teised kliendid sarnaste eelistustega on veel valinud.<br />
<br />
== Andmebaasi ülesehitus - projekti algus ==<br />
<br />
[[File: BeerPressureAndmebaasimudel.png]]<br />
<br />
== Andmebaasi ülesehitus - projekti lõpp ==<br />
<br />
[[File: TäisKõht-2018-05-27 21 58.png]]<br />
<br />
== API v1 dokumentatsioon ==<br />
<br />
===Security===<br />
'''POST /api/account/register'''<br />
<source><br />
Params: RegisterViewModel registerViewModel<br />
<br />
Returns: token<br />
</source><br />
<br />
'''POST /api/account/login'''<br />
<source> <br />
Params: LoginViewModel model<br />
<br />
Returns: token<br />
</source><br />
<br />
'''POST /api/account/logout'''<br />
<source> <br />
Params: -<br />
<br />
Returns: -<br />
</source><br />
<br />
===Accounts===<br />
'''GET /api/v1/accounts/getAllUsersInRole'''<br />
<source> <br />
Params: string role<br />
<br />
Returns: List<UserDTO><br />
</source><br />
<br />
'''GET /api/v1/accounts/{id}'''<br />
<source> <br />
Params: string id<br />
<br />
Returns: UserDTO<br />
</source><br />
<br />
'''PUT /api/v1/accounts/{id}'''<br />
<source> <br />
Params: string id, UpdateUserDTO userDTO<br />
<br />
Returns: -<br />
</source><br />
<br />
'''POST /api/v1/accounts/addRole'''<br />
<source> <br />
Params: string role<br />
<br />
Returns: -<br />
</source><br />
<br />
'''POST /api/v1/accounts/addRoleToUser'''<br />
<source> <br />
Params: string role, string userId<br />
<br />
Returns: UserDTO<br />
</source><br />
<br />
'''DELETE /api/v1/accounts/deactivate/{id}'''<br />
<source> <br />
Params: string id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Promotions===<br />
'''GET /api/v1/promotions '''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<PromotionDTO> <br />
</source><br />
<br />
'''GET /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: PromotionDTO<br />
</source><br />
<br />
'''POST /api/v1/promotions'''<br />
<source> <br />
Params: PromotionDTO promotionDTO<br />
<br />
Returns: PromotionDTO<br />
</source><br />
<br />
'''PUT /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id, PromotionDTO promotionDTO<br />
<br />
Returns: PromotionDTO<br />
</source><br />
<br />
'''DELETE /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Restaurants===<br />
'''GET /api/v1/restaurants'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<RestaurantDTO><br />
</source><br />
<br />
'''GET /api/v1/restaurants/search?name=th'''<br />
<source> <br />
Params: string name<br />
<br />
Returns: List<RestaurantDTO><br />
</source><br />
<br />
'''GET /api/v1/restaurants/top'''<br />
<source> <br />
Params: int amount<br />
<br />
Returns: List<RestaurantDTO><br />
</source><br />
<br />
'''GET /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: RestaurantDTO<br />
</source><br />
<br />
'''GET /api/v1/restaurants/{userId}'''<br />
<source> <br />
Params: int userId<br />
<br />
Returns: List<RestaurantDTO><br />
</source><br />
<br />
'''POST /api/v1/restaurants'''<br />
<source> <br />
Params: RestaurantDTO<br />
<br />
Returns: RestaurantDTO<br />
</source><br />
<br />
'''PUT /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id, RestaurantDTO<br />
<br />
Returns: -<br />
</source><br />
<br />
'''DELETE /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Menus===<br />
'''GET /api/v1/menus'''<br />
<source><br />
Params: -<br />
<br />
Returns: List<MenuDTO><br />
</source><br />
<br />
'''GET /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: MenuDTO<br />
</source><br />
<br />
'''POST /api/v1/menus'''<br />
<source> <br />
Params: MenuDTO<br />
<br />
Returns: MenuDTO<br />
</source><br />
<br />
'''PUT /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id, MenuDTO<br />
<br />
Returns: -<br />
</source><br />
<br />
'''DELETE /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Dishes===<br />
'''GET /api/v1/dishes'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<DishDTO><br />
</source><br />
<br />
'''GET /api/v1/dishes/daily'''<br />
<source> <br />
Params: bool vegan, bool glutenFree, bool lactoseFree<br />
<br />
Returns: List<DishDTO><br />
</source><br />
<br />
'''GET /api/v1/dishes/search?title=th'''<br />
<source> <br />
Params: string title<br />
<br />
Returns: List<DishDTO><br />
</source><br />
<br />
'''GET /api/v1/dishes/pricelimit'''<br />
<source> <br />
Params: decimal priceLimit<br />
<br />
Returns: List<DishDTO><br />
</source><br />
<br />
'''GET /api/v1/dishes/top'''<br />
<source> <br />
Params: int amount<br />
<br />
Returns: List<DishDTO><br />
</source><br />
<br />
'''GET /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: DishDTO<br />
</source><br />
<br />
'''POST /api/v1/dishes'''<br />
<source> <br />
Params: DishDTO<br />
<br />
Returns: DishDTO<br />
</source><br />
<br />
'''PUT /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id, DishDTO<br />
<br />
Returns: -<br />
</source><br />
<br />
'''DELETE /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Ingredients===<br />
'''GET /api/v1/ingredients'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<IngredientDTO><br />
</source><br />
<br />
'''GET /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: IngredientDTO<br />
</source><br />
<br />
'''POST /api/v1/ingredients'''<br />
<source> <br />
Params: IngredientDTO<br />
<br />
Returns: IngredientDTO<br />
</source><br />
<br />
'''PUT /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id, IngredientDTO<br />
<br />
Returns: -<br />
</source><br />
<br />
'''DELETE /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Ratings===<br />
'''GET /api/v1/ratings/dish/{id}'''<br />
<source> <br />
Params: int dishId<br />
<br />
Returns: DishDTO, int dishRating<br />
</source><br />
<br />
'''GET /api/v1/ratings/restaurant/{id}'''<br />
<source> <br />
Params: int restaurantId<br />
<br />
Returns: RestaurantDTO, int restaurantRating<br />
</source><br />
<br />
'''POST /api/v1/ratings/dish/{id}'''<br />
<source> <br />
Params: int dishRating<br />
<br />
Returns: DishDTO, int dishRating<br />
</source><br />
<br />
'''POST /api/v1/ratings/restaurant/{id}'''<br />
<source> <br />
Params: int restaurantRating<br />
<br />
Returns: RestaurantDTO, int restaurantRating<br />
</source><br />
<br />
== Lõpptoote kasutusjuhend ==<br />
<br />
* Installida NodeJS<br />
* <source>npm install webpack -g</source><br />
* <source>npm install -cli -g</source><br />
<br />
== Logiraamat ==<br />
<br />
===07.02.2018===<br />
Gupi loomine ning suhtluskanali seadistamine<br />
<br />
=== 24.03.2018 ===<br />
Trello boardi loomine<br />
<br />
=== 25.03.2018 ===<br />
Wiki lehe loomine. Esimene tõsisem projekti koosolek ning tegevuskava paika panemine.<br />
<br />
=== 26.03.2018 ===<br />
<br />
Alustasime veebiteenuse analüüsiga ja funktsionaalsuse kirjeldamisega.<br />
<br />
=== 27.03.2018 ===<br />
Täiendasime veebiteenuse analüüsi.<br />
<br />
Esmase andmebaasi mudeli koostamine.<br />
<br />
Postitatud esimeste analüüsi arutelude põhjal valminud algne prototüüp.<br />
<br />
=== 30.03.2018 ===<br />
Valmis andmebaasimudel.<br />
<br />
=== 08.04.2018 ===<br />
Tehtud muudatused analüüsis vastavalt tagasisidele.<br />
<br />
=== 19.04.2018 ===<br />
Loodud projekti põhi koos domeenimudelitega. Projekt lisatud Githubi: https://github.com/sikumiku/TaisKohtApi<br />
<br />
=== 05-06.05.2018 ===<br />
Osalesime hackathonil. Lisatud controllerid, service'id koos vajalike kihtidega.<br />
<br />
=== 16.05.2018 ===<br />
Uuendatud andmebaasimudelit, DTO'sid.<br />
<br />
=== 18-19.05.2018 ===<br />
Lisatud klientrakendus, security, äriloogikat.<br />
<br />
=== 20.05.2018 ===<br />
Lisatud API dokumentatsioon.<br />
<br />
=== 22-24.05.2018 ===<br />
Uuendatud contoller'eid, service'id.<br />
<br />
=== 25-27.05.2018 ===<br />
Uuendatud contoller'eid, service'id. Lisatud kasutajate ja rollide kontrolle meetoditesse. Täiustatud klientrakendust. Swagger dokumentatsioon.</div>
Saasma
https://wiki.itcollege.ee/index.php?title=BeerPressure&diff=130860
BeerPressure
2018-05-27T19:04:20Z
<p>Saasma: </p>
<hr />
<div>== Meeskond ja rollid ==<br />
<br />
* Sigrid Aasma (arendaja)<br />
* Evelin Jõgi (arendaja)<br />
* Martin Kask (projektijuht, arendaja)<br />
* Marko Nõu (arendaja)<br />
<br />
== Idee ==<br />
'''Toidukohtade põhimenüüde ja päevapakkumiste teenus'''<br />
<br />
Soovime pakkuda toidukohtade põhimenüüde ja päevapakkumiste teenust. On olemas mitmeid kodulehti “päevapakkumised”, kus on kirjas toidukohtade päevapraed. Kuid tavaliselt sellistel lehtedel ei ole masinloetavaid andmeid ehk siis varianti, et saad saata API pihta mingi kuupäeva koos päevapraadidega andmete uuendamiseks ja saad sama API käest küsida tänaseid päevapraade. Andmeid võiks saada küsida restorani, kuupäeva, asukoha või otsisõna/otsisõnaosa põhiselt. Selline teenus lihtsustaks ka toidukohtade päevapakkumiste haldamist, kuna praegu peavad teenuse pakkujad vastavat informatsiooni uuendama mitmes erinevas kohas - nii erinevates portaalides, kui ka enda veebileheküljel. Samuti oleks toidukohtade kogu menüü haldamine ühes kohas.<br />
<br />
[[File:TäisKõhtProto1.mp4]]<br />
<br />
Esialgne prototüüp: [http://enos.itcollege.ee/~saasma/VR2/Proto/K%C3%B5htT%C3%A4is/#g=1&p=home navigeeritav versioon]<br />
<br />
== Kasutatav arendustehnoloogia ==<br />
<br />
Veebiteenuse loomisel kasutame ASP.NET Core tehnoloogiat ja kursusel õpitud arendusmustreid.<br />
<br />
Klientrakenduse loomisel kasutame Node.js + React'i.<br />
<br />
== Veebiteenuse analüüs ==<br />
Pakume toidukohtade põhimenüüde ja päevapakkumiste teenust, kuhu on kokku koondatud erinevate toidukohtade menüüd üle Eesti. Põhimenüü alla kuuluvad pikaajalised menüüd, mis kehtivad püsivalt, hooajaliselt või mingil konkreetsel nädalapäeval. Päevapakkumiste alla kuuluvad konkreetse kuupäevaga seotud päevapakkumised. Päevapakkumiste korral kuvatakse lisainfona, kas pakkumine kehtib mingis konkreetses ajavahemikus või kogu toidukoha lahtioleku aja.<br />
<br />
Eesmärk on koguda ühte kohta kokku erinevate toidukohtade menüüd ja päevapakkumised, et kliendid saaksid mugavalt ja kiiresti oma valikuid teha. Kliendid käivad enamasti päevapakkumisi söömas lõuna ajal ja selleks ettenähtud aeg on piiratud. Sellepärast on oluline, et klient saaks teha oma valiku võimalikult kiiresti. Tänu loodavale veebiteenusele ei pea kliendid käima erinevates portaalides, et tutvuda erinevate toidukohtade pakkumistega. Kuna teenust on mugav kasutada ja klient saab oma valiku kiiresti tehtud, siis tõenäoliselt teeb klient valiku selles keskkonnas olevate toiduasutuste seast. Lisaks võimaldab teenus toiduasutustel paika panna oma pikaajalisem põhimenüü ning seda rakenduses ja võimalusel ka söögikohas kuvada. Sellepärast on ka toidukohtade huvi antud keskkonnas üleval olla ja meiega oma andmeid jagada, sest see suurendab nende klientuuri ning muudab oma menüü haldamise kergemaks.<br />
<br />
Veebiteenuse loomisel lähtume eelkõige sellest, et kliendil oleks teenust mugav kasutada ja ta saaks oma valiku kiiresti tehtud. Arvestame, et kliendid on erinevad. Mõni eelistab mõnda kindlat toidukohta, sel juhul saab ta valida oma soovitud kohad ja võrrelda nende kohtade tänase päeva pakkumisi ning menüüsid. Mõnele inimesele on oluline pakutav söök ja ta eelistab pakkumist otsida prae nimetuses oleva sõna või sõnaosa järgi ning lähtuda seejärel valiku tegemisel toidukoha keskmisest hindest või toidu hinnast. Mõne kliendi jaoks on oluline hind ja selleks, et oma valikut teha sobivas hinnavahemikus on tal võimalik sisestada maksimum hinna piirang. Kindlasti on antud teenuse juures kõikide klientide jaoks oluline päevapakkumiste asukohapõhine eristatus. Kliendid, kes soovivad oma konto luua, võivad oma eelistatud valikud meelde jätta ja järgmisel korral kuvatakse neid talle automaatselt.<br />
<br />
Teenuse must-have funktsionaalsus tagab teenuse toimimise ja põhifunktsioonid. Teenuse nice-to-have funktsionaalsus annab rakendusele lisandväärtust.<br />
<br />
Arvestades pakutava teenusega, siis näeme, et aktiivseim teenuse kasutamine võib olla tööpäevadel vahemikus 11.00-15.00, kui kliendid tutvuvad päevapakkumistega. Teenus peab tekkivale koormusele vastu pidama.<br />
<br />
Teenuse pakkumine peab olema turvaline. Selle tagamiseks tuleb sisestatavaid andmeid valideerida ja andmebaasi sisestavate andmete mahtu piirata. Toidukohtade sisestatud andmed peavad olema kaitstud, et toitude koostised ei saaks avalikuks. Põhjendatud juhtudel on võimalik kasutajaid lukku panna.<br />
<br />
== Kasutajad ==<br />
<br />
<br />
* Admin - lehe administraator, kellel on õigus lehte, kasutajaid ja nende õiguseid hallata. Tema huvi on, et teenus toimiks tõrgeteta.<br />
* Toiduasutus (tasuta kasutaja) - saab hoida lehel ühte põhimenüüd ja päevapakkumisi.<br />
* Toiduasutus (tellimusega kasutaja) - saab hoida lehel piiramatu arv põhimenüüsid ja päevapakkumisi.<br />
Toiduasutused on teenusest huvitatud, et nende menüüde haldamine oleks kerge ja mugav ning nad saaksid oma klientide arvu suurendada.<br />
* Külastaja - klient, kes valib söögikohta. Tema on huvitatud eelkõige sellest, et teenust saaks kasutada mugavalt ja kiirelt ning toidukohtade valik oleks võimalikult suur.<br />
<br />
== Rakenduse must-have funktsionaalsus ==<br />
<br />
* Kasutajad saavad sisse logida<br />
* Kasutajatel on erinevad rollid: admin, toidukoht (tasuta ja tasulise tellimusega), klient<br />
* Kasutajate arvepidamine kasutajate lõikes:<br />
** sisselogimise kuupäev, kellaaeg<br />
** pakkumiste lisamine<br />
** pakkumiste muutmine<br />
** pakkumiste kustutamine<br />
** õiguste kehtimise periood (tasuta ja tellimusega toidukoht)<br />
** pakkumistele klikkimise arv<br />
* Kasutajaid on võimalik hallata:<br />
** kasutajale õiguste andmine (menüüde arvu suurendamine, tellimusega toidukohal), rolli määramine<br />
** Kasutajat on võimalik piirata: õiguseid piirata (piiratud menüüde arv, tasuta liitunud toidukohal) ja lukku panna<br />
* Päevapakkumisi/menüüsid saab küsida: <br />
** toidukoha järgi, <br />
** kuupäeva põhiselt (ainult päevapakkumisi), <br />
** asukoha põhiselt,<br />
** toidu nimetuses esineva otsisõna/otsisõna osa põhiselt,<br />
** hinna põhiselt (max hinna piirang).<br />
* Klientrakenduses realiseeritakse CRUD meetodid (menüüsid/päevapakkumisi saab sisestada, lugeda, uuendada, kustutada)<br />
* Toidukohale saab anda hindeid ja kuvatakse keskmist hinnet.<br />
* Toidule saab anda hindeid ja kuvatakse keskmist hinnet.<br />
<br />
== Nice-to-have funktsionaalsus ==<br />
<br />
* Info selle kohta, kas päevapakkumine on otsas<br />
* Päevapakkumisi/menüüsid saab kommenteerida ja neid kommentaare kuvatakse avalikult.<br />
* Söögikohtade kodulehtedelt otsimise script, mis genereerib juba olemasolevate kodulehtede baasil päevamenüüsid.<br />
* Toiduvaliku piiramine allergeenide/vegan/jms. koostisosade põhiselt.<br />
* Aruandlused ja võrdlused toidukohtadele, et võrrelda end konkurentidega.<br />
* Teenus soovitab toidukohtadele nende varasemate päevapraadide populaarsuse alusel uue nädala menüüd.<br />
* Erinevad toidukohtade/toitude pingeread klientidele, et anda valikuteks ideid.<br />
* Soovitused klientidele, mida teised kliendid sarnaste eelistustega on veel valinud.<br />
<br />
== Andmebaasi ülesehitus - projekti algus ==<br />
<br />
[[File: BeerPressureAndmebaasimudel.png]]<br />
<br />
== Andmebaasi ülesehitus - projekti lõpp ==<br />
<br />
[[File: TäisKõht-2018-05-27 21 58.png]]<br />
<br />
== API v1 dokumentatsioon ==<br />
<br />
===Security===<br />
'''POST /api/account/register'''<br />
<source><br />
Params: RegisterViewModel registerViewModel<br />
<br />
Returns: token<br />
</source><br />
<br />
'''POST /api/account/login'''<br />
<source> <br />
Params: LoginViewModel model<br />
<br />
Returns: token<br />
</source><br />
<br />
'''POST /api/account/logout'''<br />
<source> <br />
Params: -<br />
<br />
Returns: -<br />
</source><br />
<br />
===Accounts===<br />
'''GET /api/v1/accounts/getAllUsersInRole'''<br />
<source> <br />
Params: string role<br />
<br />
Returns: List<UserDTO><br />
</source><br />
<br />
'''GET /api/v1/accounts/{id}'''<br />
<source> <br />
Params: string id<br />
<br />
Returns: UserDTO<br />
</source><br />
<br />
'''PUT /api/v1/accounts/{id}'''<br />
<source> <br />
Params: string id, UpdateUserDTO userDTO<br />
<br />
Returns: -<br />
</source><br />
<br />
'''POST /api/v1/accounts/addRole'''<br />
<source> <br />
Params: string role<br />
<br />
Returns: -<br />
</source><br />
<br />
'''POST /api/v1/accounts/addRoleToUser'''<br />
<source> <br />
Params: string role, string userId<br />
<br />
Returns: UserDTO<br />
</source><br />
<br />
'''DELETE /api/v1/accounts/deactivate/{id}'''<br />
<source> <br />
Params: string id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Promotions===<br />
'''GET /api/v1/promotions '''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<PromotionDTO> <br />
</source><br />
<br />
'''GET /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: PromotionDTO<br />
</source><br />
<br />
'''POST /api/v1/promotions'''<br />
<source> <br />
Params: PromotionDTO<br />
<br />
Returns: PromotionDTO<br />
</source><br />
<br />
'''PUT /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id, PromotionDTO<br />
<br />
Returns: -<br />
</source><br />
<br />
'''DELETE /api/v1/promotions/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Restaurants===<br />
'''GET /api/v1/restaurants'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<RestaurantDTO><br />
</source><br />
<br />
'''GET /api/v1/restaurants/search?name=th'''<br />
<source> <br />
Params: string name<br />
<br />
Returns: List<RestaurantDTO><br />
</source><br />
<br />
'''GET /api/v1/restaurants/top'''<br />
<source> <br />
Params: int amount<br />
<br />
Returns: List<RestaurantDTO><br />
</source><br />
<br />
'''GET /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: RestaurantDTO<br />
</source><br />
<br />
'''GET /api/v1/restaurants/{userId}'''<br />
<source> <br />
Params: int userId<br />
<br />
Returns: List<RestaurantDTO><br />
</source><br />
<br />
'''POST /api/v1/restaurants'''<br />
<source> <br />
Params: RestaurantDTO<br />
<br />
Returns: RestaurantDTO<br />
</source><br />
<br />
'''PUT /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id, RestaurantDTO<br />
<br />
Returns: -<br />
</source><br />
<br />
'''DELETE /api/v1/restaurants/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Menus===<br />
'''GET /api/v1/menus'''<br />
<source><br />
Params: -<br />
<br />
Returns: List<MenuDTO><br />
</source><br />
<br />
'''GET /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: MenuDTO<br />
</source><br />
<br />
'''POST /api/v1/menus'''<br />
<source> <br />
Params: MenuDTO<br />
<br />
Returns: MenuDTO<br />
</source><br />
<br />
'''PUT /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id, MenuDTO<br />
<br />
Returns: -<br />
</source><br />
<br />
'''DELETE /api/v1/menus/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Dishes===<br />
'''GET /api/v1/dishes'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<DishDTO><br />
</source><br />
<br />
'''GET /api/v1/dishes/daily'''<br />
<source> <br />
Params: bool vegan, bool glutenFree, bool lactoseFree<br />
<br />
Returns: List<DishDTO><br />
</source><br />
<br />
'''GET /api/v1/dishes/search?title=th'''<br />
<source> <br />
Params: string title<br />
<br />
Returns: List<DishDTO><br />
</source><br />
<br />
'''GET /api/v1/dishes/pricelimit'''<br />
<source> <br />
Params: decimal priceLimit<br />
<br />
Returns: List<DishDTO><br />
</source><br />
<br />
'''GET /api/v1/dishes/top'''<br />
<source> <br />
Params: int amount<br />
<br />
Returns: List<DishDTO><br />
</source><br />
<br />
'''GET /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: DishDTO<br />
</source><br />
<br />
'''POST /api/v1/dishes'''<br />
<source> <br />
Params: DishDTO<br />
<br />
Returns: DishDTO<br />
</source><br />
<br />
'''PUT /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id, DishDTO<br />
<br />
Returns: -<br />
</source><br />
<br />
'''DELETE /api/v1/dishes/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Ingredients===<br />
'''GET /api/v1/ingredients'''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<IngredientDTO><br />
</source><br />
<br />
'''GET /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: IngredientDTO<br />
</source><br />
<br />
'''POST /api/v1/ingredients'''<br />
<source> <br />
Params: IngredientDTO<br />
<br />
Returns: IngredientDTO<br />
</source><br />
<br />
'''PUT /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id, IngredientDTO<br />
<br />
Returns: -<br />
</source><br />
<br />
'''DELETE /api/v1/ingredients/{id}'''<br />
<source> <br />
Params: int id<br />
<br />
Returns: -<br />
</source><br />
<br />
===Ratings===<br />
'''GET /api/v1/ratings/dish/{id}'''<br />
<source> <br />
Params: int dishId<br />
<br />
Returns: DishDTO, int dishRating<br />
</source><br />
<br />
'''GET /api/v1/ratings/restaurant/{id}'''<br />
<source> <br />
Params: int restaurantId<br />
<br />
Returns: RestaurantDTO, int restaurantRating<br />
</source><br />
<br />
'''POST /api/v1/ratings/dish/{id}'''<br />
<source> <br />
Params: int dishRating<br />
<br />
Returns: DishDTO, int dishRating<br />
</source><br />
<br />
'''POST /api/v1/ratings/restaurant/{id}'''<br />
<source> <br />
Params: int restaurantRating<br />
<br />
Returns: RestaurantDTO, int restaurantRating<br />
</source><br />
<br />
== Lõpptoote kasutusjuhend ==<br />
<br />
TODO<br />
<br />
<br />
== Logiraamat ==<br />
<br />
===07.02.2018===<br />
Gupi loomine ning suhtluskanali seadistamine<br />
<br />
=== 24.03.2018 ===<br />
Trello boardi loomine<br />
<br />
=== 25.03.2018 ===<br />
Wiki lehe loomine. Esimene tõsisem projekti koosolek ning tegevuskava paika panemine.<br />
<br />
=== 26.03.2018 ===<br />
<br />
Alustasime veebiteenuse analüüsiga ja funktsionaalsuse kirjeldamisega.<br />
<br />
=== 27.03.2018 ===<br />
Täiendasime veebiteenuse analüüsi.<br />
<br />
Esmase andmebaasi mudeli koostamine.<br />
<br />
Postitatud esimeste analüüsi arutelude põhjal valminud algne prototüüp.<br />
<br />
=== 30.03.2018 ===<br />
Valmis andmebaasimudel.<br />
<br />
=== 08.04.2018 ===<br />
Tehtud muudatused analüüsis vastavalt tagasisidele.<br />
<br />
=== 19.04.2018 ===<br />
Loodud projekti põhi koos domeenimudelitega. Projekt lisatud Githubi: https://github.com/sikumiku/TaisKohtApi<br />
<br />
=== 05-06.05.2018 ===<br />
Osalesime hackathonil. Lisatud controllerid, service'id koos vajalike kihtidega.<br />
<br />
=== 16.05.2018 ===<br />
Uuendatud andmebaasimudelit, DTO'sid.<br />
<br />
=== 18-19.05.2018 ===<br />
Lisatud klientrakendus, security, äriloogikat.<br />
<br />
=== 20.05.2018 ===<br />
Lisatud API dokumentatsioon.<br />
<br />
=== 22-24.05.2018 ===<br />
Uuendatud contoller'eid, service'id.<br />
<br />
=== 25-27.05.2018 ===<br />
Uuendatud contoller'eid, service'id. Lisatud kasutajate ja rollide kontrolle meetoditesse. Täiustatud klientrakendust. Swagger dokumentatsioon.</div>
Saasma
https://wiki.itcollege.ee/index.php?title=File:T%C3%A4isK%C3%B5ht-2018-05-27_21_58.png&diff=130859
File:TäisKõht-2018-05-27 21 58.png
2018-05-27T19:03:59Z
<p>Saasma: </p>
<hr />
<div></div>
Saasma
https://wiki.itcollege.ee/index.php?title=BeerPressure&diff=130824
BeerPressure
2018-05-27T17:15:28Z
<p>Saasma: /* API v1 dokumentatsioon */</p>
<hr />
<div>== Meeskond ja rollid ==<br />
<br />
* Sigrid Aasma (arendaja)<br />
* Evelin Jõgi (arendaja)<br />
* Martin Kask (projektijuht, arendaja)<br />
* Marko Nõu (arendaja)<br />
<br />
== Idee ==<br />
'''Toidukohtade põhimenüüde ja päevapakkumiste teenus'''<br />
<br />
Soovime pakkuda toidukohtade põhimenüüde ja päevapakkumiste teenust. On olemas mitmeid kodulehti “päevapakkumised”, kus on kirjas toidukohtade päevapraed. Kuid tavaliselt sellistel lehtedel ei ole masinloetavaid andmeid ehk siis varianti, et saad saata API pihta mingi kuupäeva koos päevapraadidega andmete uuendamiseks ja saad sama API käest küsida tänaseid päevapraade. Andmeid võiks saada küsida restorani, kuupäeva, asukoha või otsisõna/otsisõnaosa põhiselt. Selline teenus lihtsustaks ka toidukohtade päevapakkumiste haldamist, kuna praegu peavad teenuse pakkujad vastavat informatsiooni uuendama mitmes erinevas kohas - nii erinevates portaalides, kui ka enda veebileheküljel. Samuti oleks toidukohtade kogu menüü haldamine ühes kohas.<br />
<br />
[[File:TäisKõhtProto1.mp4]]<br />
<br />
Esialgne prototüüp: [http://enos.itcollege.ee/~saasma/VR2/Proto/K%C3%B5htT%C3%A4is/#g=1&p=home navigeeritav versioon]<br />
<br />
== Kasutatav arendustehnoloogia ==<br />
<br />
Veebiteenuse loomisel kasutame ASP.NET Core tehnoloogiat ja kursusel õpitud arendusmustreid.<br />
<br />
Klientrakenduse loomisel kasutame Node.js + React'i.<br />
<br />
== Veebiteenuse analüüs ==<br />
Pakume toidukohtade põhimenüüde ja päevapakkumiste teenust, kuhu on kokku koondatud erinevate toidukohtade menüüd üle Eesti. Põhimenüü alla kuuluvad pikaajalised menüüd, mis kehtivad püsivalt, hooajaliselt või mingil konkreetsel nädalapäeval. Päevapakkumiste alla kuuluvad konkreetse kuupäevaga seotud päevapakkumised. Päevapakkumiste korral kuvatakse lisainfona, kas pakkumine kehtib mingis konkreetses ajavahemikus või kogu toidukoha lahtioleku aja.<br />
<br />
Eesmärk on koguda ühte kohta kokku erinevate toidukohtade menüüd ja päevapakkumised, et kliendid saaksid mugavalt ja kiiresti oma valikuid teha. Kliendid käivad enamasti päevapakkumisi söömas lõuna ajal ja selleks ettenähtud aeg on piiratud. Sellepärast on oluline, et klient saaks teha oma valiku võimalikult kiiresti. Tänu loodavale veebiteenusele ei pea kliendid käima erinevates portaalides, et tutvuda erinevate toidukohtade pakkumistega. Kuna teenust on mugav kasutada ja klient saab oma valiku kiiresti tehtud, siis tõenäoliselt teeb klient valiku selles keskkonnas olevate toiduasutuste seast. Lisaks võimaldab teenus toiduasutustel paika panna oma pikaajalisem põhimenüü ning seda rakenduses ja võimalusel ka söögikohas kuvada. Sellepärast on ka toidukohtade huvi antud keskkonnas üleval olla ja meiega oma andmeid jagada, sest see suurendab nende klientuuri ning muudab oma menüü haldamise kergemaks.<br />
<br />
Veebiteenuse loomisel lähtume eelkõige sellest, et kliendil oleks teenust mugav kasutada ja ta saaks oma valiku kiiresti tehtud. Arvestame, et kliendid on erinevad. Mõni eelistab mõnda kindlat toidukohta, sel juhul saab ta valida oma soovitud kohad ja võrrelda nende kohtade tänase päeva pakkumisi ning menüüsid. Mõnele inimesele on oluline pakutav söök ja ta eelistab pakkumist otsida prae nimetuses oleva sõna või sõnaosa järgi ning lähtuda seejärel valiku tegemisel toidukoha keskmisest hindest või toidu hinnast. Mõne kliendi jaoks on oluline hind ja selleks, et oma valikut teha sobivas hinnavahemikus on tal võimalik sisestada maksimum hinna piirang. Kindlasti on antud teenuse juures kõikide klientide jaoks oluline päevapakkumiste asukohapõhine eristatus. Kliendid, kes soovivad oma konto luua, võivad oma eelistatud valikud meelde jätta ja järgmisel korral kuvatakse neid talle automaatselt.<br />
<br />
Teenuse must-have funktsionaalsus tagab teenuse toimimise ja põhifunktsioonid. Teenuse nice-to-have funktsionaalsus annab rakendusele lisandväärtust.<br />
<br />
Arvestades pakutava teenusega, siis näeme, et aktiivseim teenuse kasutamine võib olla tööpäevadel vahemikus 11.00-15.00, kui kliendid tutvuvad päevapakkumistega. Teenus peab tekkivale koormusele vastu pidama.<br />
<br />
Teenuse pakkumine peab olema turvaline. Selle tagamiseks tuleb sisestatavaid andmeid valideerida ja andmebaasi sisestavate andmete mahtu piirata. Toidukohtade sisestatud andmed peavad olema kaitstud, et toitude koostised ei saaks avalikuks. Põhjendatud juhtudel on võimalik kasutajaid lukku panna.<br />
<br />
== Kasutajad ==<br />
<br />
<br />
* Admin - lehe administraator, kellel on õigus lehte, kasutajaid ja nende õiguseid hallata. Tema huvi on, et teenus toimiks tõrgeteta.<br />
* Toiduasutus (tasuta kasutaja) - saab hoida lehel ühte põhimenüüd ja päevapakkumisi.<br />
* Toiduasutus (tellimusega kasutaja) - saab hoida lehel piiramatu arv põhimenüüsid ja päevapakkumisi.<br />
Toiduasutused on teenusest huvitatud, et nende menüüde haldamine oleks kerge ja mugav ning nad saaksid oma klientide arvu suurendada.<br />
* Külastaja - klient, kes valib söögikohta. Tema on huvitatud eelkõige sellest, et teenust saaks kasutada mugavalt ja kiirelt ning toidukohtade valik oleks võimalikult suur.<br />
<br />
== Rakenduse must-have funktsionaalsus ==<br />
<br />
* Kasutajad saavad sisse logida<br />
* Kasutajatel on erinevad rollid: admin, toidukoht (tasuta ja tasulise tellimusega), klient<br />
* Kasutajate arvepidamine kasutajate lõikes:<br />
** sisselogimise kuupäev, kellaaeg<br />
** pakkumiste lisamine<br />
** pakkumiste muutmine<br />
** pakkumiste kustutamine<br />
** õiguste kehtimise periood (tasuta ja tellimusega toidukoht)<br />
** pakkumistele klikkimise arv<br />
* Kasutajaid on võimalik hallata:<br />
** kasutajale õiguste andmine (menüüde arvu suurendamine, tellimusega toidukohal), rolli määramine<br />
** Kasutajat on võimalik piirata: õiguseid piirata (piiratud menüüde arv, tasuta liitunud toidukohal) ja lukku panna<br />
* Päevapakkumisi/menüüsid saab küsida: <br />
** toidukoha järgi, <br />
** kuupäeva põhiselt (ainult päevapakkumisi), <br />
** asukoha põhiselt,<br />
** toidu nimetuses esineva otsisõna/otsisõna osa põhiselt,<br />
** hinna põhiselt (max hinna piirang).<br />
* Klientrakenduses realiseeritakse CRUD meetodid (menüüsid/päevapakkumisi saab sisestada, lugeda, uuendada, kustutada)<br />
* Toidukohale saab anda hindeid ja kuvatakse keskmist hinnet.<br />
* Toidule saab anda hindeid ja kuvatakse keskmist hinnet.<br />
<br />
== Nice-to-have funktsionaalsus ==<br />
<br />
* Info selle kohta, kas päevapakkumine on otsas<br />
* Päevapakkumisi/menüüsid saab kommenteerida ja neid kommentaare kuvatakse avalikult.<br />
* Söögikohtade kodulehtedelt otsimise script, mis genereerib juba olemasolevate kodulehtede baasil päevamenüüsid.<br />
* Toiduvaliku piiramine allergeenide/vegan/jms. koostisosade põhiselt.<br />
* Aruandlused ja võrdlused toidukohtadele, et võrrelda end konkurentidega.<br />
* Teenus soovitab toidukohtadele nende varasemate päevapraadide populaarsuse alusel uue nädala menüüd.<br />
* Erinevad toidukohtade/toitude pingeread klientidele, et anda valikuteks ideid.<br />
* Soovitused klientidele, mida teised kliendid sarnaste eelistustega on veel valinud.<br />
<br />
== Andmebaasi ülesehitus ==<br />
<br />
[[File: BeerPressureAndmebaasimudel.png]]<br />
<br />
== API v1 dokumentatsioon ==<br />
<br />
===Promotions===<br />
'''GET /api/v1/promotions '''<br />
<source> <br />
Params: -<br />
<br />
Returns: List<PromotionDTO> <br />
</source><br />
<br />
'''/api/v1/Promotions/{id}'''<br />
<source> GET /api/v1/Promotions/{id} </source><br />
Params: int id<br />
<br />
Returns: PromotionDTO<br />
<br />
'''/api/v1/Promotions'''<br />
<source> POST /api/v1/Promotions </source><br />
Params: PromotionDTO<br />
<br />
Returns: PromotionDTO<br />
<br />
'''/api/v1/Promotions/{id}'''<br />
<source> PUT /api/v1/Promotions/{id} </source><br />
Params: int id, PromotionDTO<br />
<br />
Returns: -<br />
<br />
'''/api/v1/Promotions/{id}'''<br />
<source> DELETE /api/v1/Promotions/{id} </source><br />
Params: int id<br />
<br />
Returns: -<br />
<br />
<br />
'''/api/v1/Restaurants'''<br />
<source> GET /api/v1/Restaurants </source><br />
Params: -<br />
<br />
Returns: List<RestaurantDTO><br />
<br />
'''/api/v1/Restaurants/search?name=th'''<br />
<source> GET /api/v1/Restaurants/search?name=th </source><br />
Params: string name<br />
<br />
Returns: List<RestaurantDTO><br />
<br />
'''/api/v1/Restaurants/Top'''<br />
<source> GET /api/v1/Restaurants/Top </source><br />
Params: int amount<br />
<br />
Returns: List<RestaurantDTO><br />
<br />
'''/api/v1/Restaurants/{id}'''<br />
<source> GET /api/v1/Restaurants/{id} </source><br />
Params: int id<br />
<br />
Returns: RestaurantDTO<br />
<br />
'''/api/v1/Restaurants/{userId}'''<br />
<source> GET /api/v1/Restaurants/{userId} </source><br />
Params: int userId<br />
<br />
Returns: List<RestaurantDTO><br />
<br />
'''/api/v1/Restaurants'''<br />
<source> POST /api/v1/Restaurants </source><br />
Params: RestaurantDTO<br />
<br />
Returns: RestaurantDTO<br />
<br />
'''/api/v1/Restaurants/{id}'''<br />
<source> PUT /api/v1/Restaurants/{id} </source><br />
Params: int id, RestaurantDTO<br />
<br />
Returns: -<br />
<br />
'''/api/v1/Restaurants/{id}'''<br />
<source> DELETE /api/v1/Restaurants/{id} </source><br />
Params: int id<br />
<br />
Returns: -<br />
<br />
<br />
'''/api/v1/Users'''<br />
<source> GET /api/v1/Users </source><br />
Params: -<br />
<br />
Returns: List<UserDTO><br />
<br />
'''/api/v1/Users/{id}'''<br />
<source> GET /api/v1/Users/{id} </source><br />
Params: int id<br />
<br />
Returns: UserDTO<br />
<br />
'''/api/v1/Users'''<br />
<source> POST /api/v1/Users </source><br />
Params: UserDTO<br />
<br />
Returns: UserDTO<br />
<br />
'''/api/v1/Users/{id}'''<br />
<source> PUT /api/v1/Users/{id} </source><br />
Params: int id, UserDTO<br />
<br />
Returns: -<br />
<br />
'''/api/v1/Users/deactivate/{id}'''<br />
<source> PUT /api/v1/Users/deactivate/{id} </source><br />
Params: int id<br />
<br />
Returns: -<br />
<br />
'''/api/v1/Users/{id}'''<br />
<source> DELETE /api/v1/Users/{id} </source><br />
Params: int id<br />
<br />
Returns: -<br />
<br />
<br />
'''/api/v1/Menus'''<br />
<source> GET /api/v1/Menus </source><br />
Params: -<br />
<br />
Returns: List<MenuDTO><br />
<br />
'''/api/v1/Menus/{id}'''<br />
<source> GET /api/v1/Menus/{id} </source><br />
Params: int id<br />
<br />
Returns: MenuDTO<br />
<br />
'''/api/v1/Menus'''<br />
<source> POST /api/v1/Menus </source><br />
Params: MenuDTO<br />
<br />
Returns: MenuDTO<br />
<br />
'''/api/v1/Menus/{id}'''<br />
<source> PUT /api/v1/Menus/{id} </source><br />
Params: int id, MenuDTO<br />
<br />
Returns: -<br />
<br />
'''/api/v1/Menus/{id}'''<br />
<source> DELETE /api/v1/Menus/{id} </source><br />
Params: int id<br />
<br />
Returns: -<br />
<br />
<br />
'''/api/v1/Dishes'''<br />
<source> GET /api/v1/Dishes </source><br />
Params: -<br />
<br />
Returns: List<DishDTO><br />
<br />
'''/api/v1/Dishes/Daily'''<br />
<source> GET /api/v1/Dishes/Daily </source><br />
Params: bool vegan, bool glutenFree, bool lactoseFree<br />
<br />
Returns: List<DishDTO><br />
<br />
'''/api/v1/Dishes/search?title=th'''<br />
<source> GET /api/v1/Dishes/search?title=th </source><br />
Params: string title<br />
<br />
Returns: List<DishDTO><br />
<br />
'''/api/v1/Dishes/Price'''<br />
<source> GET /api/v1/Dishes/Price </source><br />
Params: decimal priceLimit<br />
<br />
Returns: List<DishDTO><br />
<br />
'''/api/v1/Dishes/Top'''<br />
<source> GET /api/v1/Dishes/Top </source><br />
Params: int amount<br />
<br />
Returns: List<DishDTO><br />
<br />
'''/api/v1/Dishes/{id}'''<br />
<source> GET /api/v1/Dishes/{id} </source><br />
Params: int id<br />
<br />
Returns: DishDTO<br />
<br />
'''/api/v1/Dishes'''<br />
<source> POST /api/v1/Dishes </source><br />
Params: DishDTO<br />
<br />
Returns: DishDTO<br />
<br />
'''/api/v1/Dishes/{id}'''<br />
<source> PUT /api/v1/Dishes/{id} </source><br />
Params: int id, DishDTO<br />
<br />
Returns: -<br />
<br />
'''/api/v1/Dishes/{id}'''<br />
<source> DELETE /api/v1/Dishes/{id} </source><br />
Params: int id<br />
<br />
Returns: -<br />
<br />
<br />
'''/api/v1/Ingredients'''<br />
<source> GET /api/v1/Ingredients </source><br />
Params: -<br />
<br />
Returns: List<IngredientDTO><br />
<br />
'''/api/v1/Ingredients/{id}'''<br />
<source> GET /api/v1/Ingredients/{id} </source><br />
Params: int id<br />
<br />
Returns: IngredientDTO<br />
<br />
'''/api/v1/Ingredients'''<br />
<source> POST /api/v1/Ingredients </source><br />
Params: IngredientDTO<br />
<br />
Returns: IngredientDTO<br />
<br />
'''/api/v1/Ingredients/{id}'''<br />
<source> PUT /api/v1/Ingredients/{id} </source><br />
Params: int id, IngredientDTO<br />
<br />
Returns: -<br />
<br />
'''/api/v1/Ingredients/{id}'''<br />
<source> DELETE /api/v1/Ingredients/{id} </source><br />
Params: int id<br />
<br />
Returns: -<br />
<br />
<br />
'''/api/v1/Ratings/Dish/{id}'''<br />
<source> GET /api/v1/Ratings/Dish/{id} </source><br />
Params: int dishId<br />
<br />
Returns: DishDTO, int dishRating<br />
<br />
'''/api/v1/Ratings/Restaurant/{id}'''<br />
<source> GET /api/v1/Ratings/Restaurant/{id} </source><br />
Params: int restaurantId<br />
<br />
Returns: RestaurantDTO, int restaurantRating<br />
<br />
'''/api/v1/Ratings/Dish/{id}'''<br />
<source> POST /api/v1/Ratings/Dish/{id} </source><br />
Params: int dishRating<br />
<br />
Returns: DishDTO, int dishRating<br />
<br />
'''/api/v1/Ratings/Restaurant/{id}'''<br />
<source> POST /api/v1/Ratings/Restaurant/{id} </source><br />
Params: int restaurantRating<br />
<br />
Returns: RestaurantDTO, int restaurantRating<br />
<br />
<br />
'''/api/v1/Account/login'''<br />
<source> POST /api/v1/Account/login </source><br />
Params: LoginViewModel<br />
<br />
Returns: token<br />
<br />
'''/api/v1/Account/register'''<br />
<source> POST /api/v1/Account/register </source><br />
Params: RegisterViewModel<br />
<br />
Returns: token<br />
<br />
'''/api/v1/Account/logout'''<br />
<source> POST /api/v1/Account/logout </source><br />
Params: -<br />
<br />
Returns: -<br />
<br />
<br />
'''/api/v1/Account/addRole'''<br />
<source> POST /api/v1/Account/addRole </source><br />
Params: role<br />
<br />
Returns: -<br />
<br />
== Lõpptoote kasutusjuhend ==<br />
<br />
TODO<br />
<br />
<br />
== Logiraamat ==<br />
<br />
===07.02.2018===<br />
Gupi loomine ning suhtluskanali seadistamine<br />
<br />
=== 24.03.2018 ===<br />
Trello boardi loomine<br />
<br />
=== 25.03.2018 ===<br />
Wiki lehe loomine. Esimene tõsisem projekti koosolek ning tegevuskava paika panemine.<br />
<br />
=== 26.03.2018 ===<br />
<br />
Alustasime veebiteenuse analüüsiga ja funktsionaalsuse kirjeldamisega.<br />
<br />
=== 27.03.2018 ===<br />
Täiendasime veebiteenuse analüüsi.<br />
<br />
Esmase andmebaasi mudeli koostamine.<br />
<br />
Postitatud esimeste analüüsi arutelude põhjal valminud algne prototüüp.<br />
<br />
=== 30.03.2018 ===<br />
Valmis andmebaasimudel.<br />
<br />
=== 08.04.2018 ===<br />
Tehtud muudatused analüüsis vastavalt tagasisidele.<br />
<br />
=== 19.04.2018 ===<br />
Loodud projekti põhi koos domeenimudelitega. Projekt lisatud Githubi: https://github.com/sikumiku/TaisKohtApi<br />
<br />
=== 05-06.05.2018 ===<br />
Osalesime hackathonil. Lisatud controllerid, service'id koos vajalike kihtidega.<br />
<br />
=== 16.05.2018 ===<br />
Uuendatud andmebaasimudelit, DTO'sid.<br />
<br />
=== 18-19.05.2018 ===<br />
Lisatud klientrakendus, security, äriloogikat.<br />
<br />
=== 20.05.2018 ===<br />
Lisatud API dokumentatsioon.<br />
<br />
=== 22-24.05.2018 ===<br />
Uuendatud contoller'eid, service'id.<br />
<br />
=== 25-27.05.2018 ===<br />
Uuendatud contoller'eid, service'id. Lisatud kasutajate ja rollide kontrolle meetoditesse. Täiustatud klientrakendust. Swagger dokumentatsioon.</div>
Saasma
https://wiki.itcollege.ee/index.php?title=BeerPressure&diff=130727
BeerPressure
2018-05-20T11:59:27Z
<p>Saasma: /* API v1 dokumentatsioon */</p>
<hr />
<div>== Meeskond ja rollid ==<br />
<br />
* Sigrid Aasma (arendaja)<br />
* Evelin Jõgi (arendaja)<br />
* Martin Kask (projektijuht, arendaja)<br />
* Marko Nõu (arendaja)<br />
<br />
== Idee ==<br />
'''Toidukohtade põhimenüüde ja päevapakkumiste teenus'''<br />
<br />
Soovime pakkuda toidukohtade põhimenüüde ja päevapakkumiste teenust. On olemas mitmeid kodulehti “päevapakkumised”, kus on kirjas toidukohtade päevapraed. Kuid tavaliselt sellistel lehtedel ei ole masinloetavaid andmeid ehk siis varianti, et saad saata API pihta mingi kuupäeva koos päevapraadidega andmete uuendamiseks ja saad sama API käest küsida tänaseid päevapraade. Andmeid võiks saada küsida restorani, kuupäeva, asukoha või otsisõna/otsisõnaosa põhiselt. Selline teenus lihtsustaks ka toidukohtade päevapakkumiste haldamist, kuna praegu peavad teenuse pakkujad vastavat informatsiooni uuendama mitmes erinevas kohas - nii erinevates portaalides, kui ka enda veebileheküljel. Samuti oleks toidukohtade kogu menüü haldamine ühes kohas.<br />
<br />
[[File:TäisKõhtProto1.mp4]]<br />
<br />
Esialgne prototüüp: [http://enos.itcollege.ee/~saasma/VR2/Proto/K%C3%B5htT%C3%A4is/#g=1&p=home navigeeritav versioon]<br />
<br />
== Kasutatav arendustehnoloogia ==<br />
<br />
Veebiteenuse loomisel kasutame ASP.NET Core tehnoloogiat ja kursusel õpitud arendusmustreid.<br />
<br />
Klientrakenduse loomisel kasutame Node.js + React'i.<br />
<br />
== Veebiteenuse analüüs ==<br />
Pakume toidukohtade põhimenüüde ja päevapakkumiste teenust, kuhu on kokku koondatud erinevate toidukohtade menüüd üle Eesti. Põhimenüü alla kuuluvad pikaajalised menüüd, mis kehtivad püsivalt, hooajaliselt või mingil konkreetsel nädalapäeval. Päevapakkumiste alla kuuluvad konkreetse kuupäevaga seotud päevapakkumised. Päevapakkumiste korral kuvatakse lisainfona, kas pakkumine kehtib mingis konkreetses ajavahemikus või kogu toidukoha lahtioleku aja.<br />
<br />
Eesmärk on koguda ühte kohta kokku erinevate toidukohtade menüüd ja päevapakkumised, et kliendid saaksid mugavalt ja kiiresti oma valikuid teha. Kliendid käivad enamasti päevapakkumisi söömas lõuna ajal ja selleks ettenähtud aeg on piiratud. Sellepärast on oluline, et klient saaks teha oma valiku võimalikult kiiresti. Tänu loodavale veebiteenusele ei pea kliendid käima erinevates portaalides, et tutvuda erinevate toidukohtade pakkumistega. Kuna teenust on mugav kasutada ja klient saab oma valiku kiiresti tehtud, siis tõenäoliselt teeb klient valiku selles keskkonnas olevate toiduasutuste seast. Lisaks võimaldab teenus toiduasutustel paika panna oma pikaajalisem põhimenüü ning seda rakenduses ja võimalusel ka söögikohas kuvada. Sellepärast on ka toidukohtade huvi antud keskkonnas üleval olla ja meiega oma andmeid jagada, sest see suurendab nende klientuuri ning muudab oma menüü haldamise kergemaks.<br />
<br />
Veebiteenuse loomisel lähtume eelkõige sellest, et kliendil oleks teenust mugav kasutada ja ta saaks oma valiku kiiresti tehtud. Arvestame, et kliendid on erinevad. Mõni eelistab mõnda kindlat toidukohta, sel juhul saab ta valida oma soovitud kohad ja võrrelda nende kohtade tänase päeva pakkumisi ning menüüsid. Mõnele inimesele on oluline pakutav söök ja ta eelistab pakkumist otsida prae nimetuses oleva sõna või sõnaosa järgi ning lähtuda seejärel valiku tegemisel toidukoha keskmisest hindest või toidu hinnast. Mõne kliendi jaoks on oluline hind ja selleks, et oma valikut teha sobivas hinnavahemikus on tal võimalik sisestada maksimum hinna piirang. Kindlasti on antud teenuse juures kõikide klientide jaoks oluline päevapakkumiste asukohapõhine eristatus. Kliendid, kes soovivad oma konto luua, võivad oma eelistatud valikud meelde jätta ja järgmisel korral kuvatakse neid talle automaatselt.<br />
<br />
Teenuse must-have funktsionaalsus tagab teenuse toimimise ja põhifunktsioonid. Teenuse nice-to-have funktsionaalsus annab rakendusele lisandväärtust.<br />
<br />
Arvestades pakutava teenusega, siis näeme, et aktiivseim teenuse kasutamine võib olla tööpäevadel vahemikus 11.00-15.00, kui kliendid tutvuvad päevapakkumistega. Teenus peab tekkivale koormusele vastu pidama.<br />
<br />
Teenuse pakkumine peab olema turvaline. Selle tagamiseks tuleb sisestatavaid andmeid valideerida ja andmebaasi sisestavate andmete mahtu piirata. Toidukohtade sisestatud andmed peavad olema kaitstud, et toitude koostised ei saaks avalikuks. Põhjendatud juhtudel on võimalik kasutajaid lukku panna.<br />
<br />
== Kasutajad ==<br />
<br />
<br />
* Admin - lehe administraator, kellel on õigus lehte, kasutajaid ja nende õiguseid hallata. Tema huvi on, et teenus toimiks tõrgeteta.<br />
* Toiduasutus (tasuta kasutaja) - saab hoida lehel ühte põhimenüüd ja päevapakkumisi.<br />
* Toiduasutus (tellimusega kasutaja) - saab hoida lehel piiramatu arv põhimenüüsid ja päevapakkumisi.<br />
Toiduasutused on teenusest huvitatud, et nende menüüde haldamine oleks kerge ja mugav ning nad saaksid oma klientide arvu suurendada.<br />
* Külastaja - klient, kes valib söögikohta. Tema on huvitatud eelkõige sellest, et teenust saaks kasutada mugavalt ja kiirelt ning toidukohtade valik oleks võimalikult suur.<br />
<br />
== Rakenduse must-have funktsionaalsus ==<br />
<br />
* Kasutajad saavad sisse logida<br />
* Kasutajatel on erinevad rollid: admin, toidukoht (tasuta ja tasulise tellimusega), klient<br />
* Kasutajate arvepidamine kasutajate lõikes:<br />
** sisselogimise kuupäev, kellaaeg<br />
** pakkumiste lisamine<br />
** pakkumiste muutmine<br />
** pakkumiste kustutamine<br />
** õiguste kehtimise periood (tasuta ja tellimusega toidukoht)<br />
** pakkumistele klikkimise arv<br />
* Kasutajaid on võimalik hallata:<br />
** kasutajale õiguste andmine (menüüde arvu suurendamine, tellimusega toidukohal), rolli määramine<br />
** Kasutajat on võimalik piirata: õiguseid piirata (piiratud menüüde arv, tasuta liitunud toidukohal) ja lukku panna<br />
* Päevapakkumisi/menüüsid saab küsida: <br />
** toidukoha järgi, <br />
** kuupäeva põhiselt (ainult päevapakkumisi), <br />
** asukoha põhiselt,<br />
** toidu nimetuses esineva otsisõna/otsisõna osa põhiselt,<br />
** hinna põhiselt (max hinna piirang).<br />
* Klientrakenduses realiseeritakse CRUD meetodid (menüüsid/päevapakkumisi saab sisestada, lugeda, uuendada, kustutada)<br />
* Toidukohale saab anda hindeid ja kuvatakse keskmist hinnet.<br />
* Toidule saab anda hindeid ja kuvatakse keskmist hinnet.<br />
<br />
== Nice-to-have funktsionaalsus ==<br />
<br />
* Info selle kohta, kas päevapakkumine on otsas<br />
* Päevapakkumisi/menüüsid saab kommenteerida ja neid kommentaare kuvatakse avalikult.<br />
* Söögikohtade kodulehtedelt otsimise script, mis genereerib juba olemasolevate kodulehtede baasil päevamenüüsid.<br />
* Toiduvaliku piiramine allergeenide/vegan/jms. koostisosade põhiselt.<br />
* Aruandlused ja võrdlused toidukohtadele, et võrrelda end konkurentidega.<br />
* Teenus soovitab toidukohtadele nende varasemate päevapraadide populaarsuse alusel uue nädala menüüd.<br />
* Erinevad toidukohtade/toitude pingeread klientidele, et anda valikuteks ideid.<br />
* Soovitused klientidele, mida teised kliendid sarnaste eelistustega on veel valinud.<br />
<br />
== Andmebaasi ülesehitus ==<br />
<br />
[[File: BeerPressureAndmebaasimudel.png]]<br />
<br />
== API v1 dokumentatsioon ==<br />
<br />
'''/api/v1/Restaurants'''<br />
<source> GET /api/v1/Restaurants </source><br />
Params: -<br />
<br />
Tagastab: List<RestaurantDTO><br />
<br />
== Lõpptoote kasutusjuhend ==<br />
<br />
TODO<br />
<br />
<br />
== Logiraamat ==<br />
<br />
===07.02.2018===<br />
Gupi loomine ning suhtluskanali seadistamine<br />
<br />
=== 24.03.2018 ===<br />
Trello boardi loomine<br />
<br />
=== 25.03.2018 ===<br />
Wiki lehe loomine. Esimene tõsisem projekti koosolek ning tegevuskava paika panemine.<br />
<br />
=== 26.03.2018 ===<br />
<br />
Alustasime veebiteenuse analüüsiga ja funktsionaalsuse kirjeldamisega.<br />
<br />
=== 27.03.2018 ===<br />
Täiendasime veebiteenuse analüüsi.<br />
<br />
Esmase andmebaasi mudeli koostamine.<br />
<br />
Postitatud esimeste analüüsi arutelude põhjal valminud algne prototüüp.<br />
<br />
=== 30.03.2018 ===<br />
Valmis andmebaasimudel.<br />
<br />
=== 08.04.2018 ===<br />
Tehtud muudatused analüüsis vastavalt tagasisidele.<br />
<br />
=== 19.04.2018 ===<br />
Loodud projekti põhi koos domeenimudelitega. Projekt lisatud Githubi: https://github.com/sikumiku/TaisKohtApi</div>
Saasma
https://wiki.itcollege.ee/index.php?title=BeerPressure&diff=130726
BeerPressure
2018-05-20T11:59:13Z
<p>Saasma: </p>
<hr />
<div>== Meeskond ja rollid ==<br />
<br />
* Sigrid Aasma (arendaja)<br />
* Evelin Jõgi (arendaja)<br />
* Martin Kask (projektijuht, arendaja)<br />
* Marko Nõu (arendaja)<br />
<br />
== Idee ==<br />
'''Toidukohtade põhimenüüde ja päevapakkumiste teenus'''<br />
<br />
Soovime pakkuda toidukohtade põhimenüüde ja päevapakkumiste teenust. On olemas mitmeid kodulehti “päevapakkumised”, kus on kirjas toidukohtade päevapraed. Kuid tavaliselt sellistel lehtedel ei ole masinloetavaid andmeid ehk siis varianti, et saad saata API pihta mingi kuupäeva koos päevapraadidega andmete uuendamiseks ja saad sama API käest küsida tänaseid päevapraade. Andmeid võiks saada küsida restorani, kuupäeva, asukoha või otsisõna/otsisõnaosa põhiselt. Selline teenus lihtsustaks ka toidukohtade päevapakkumiste haldamist, kuna praegu peavad teenuse pakkujad vastavat informatsiooni uuendama mitmes erinevas kohas - nii erinevates portaalides, kui ka enda veebileheküljel. Samuti oleks toidukohtade kogu menüü haldamine ühes kohas.<br />
<br />
[[File:TäisKõhtProto1.mp4]]<br />
<br />
Esialgne prototüüp: [http://enos.itcollege.ee/~saasma/VR2/Proto/K%C3%B5htT%C3%A4is/#g=1&p=home navigeeritav versioon]<br />
<br />
== Kasutatav arendustehnoloogia ==<br />
<br />
Veebiteenuse loomisel kasutame ASP.NET Core tehnoloogiat ja kursusel õpitud arendusmustreid.<br />
<br />
Klientrakenduse loomisel kasutame Node.js + React'i.<br />
<br />
== Veebiteenuse analüüs ==<br />
Pakume toidukohtade põhimenüüde ja päevapakkumiste teenust, kuhu on kokku koondatud erinevate toidukohtade menüüd üle Eesti. Põhimenüü alla kuuluvad pikaajalised menüüd, mis kehtivad püsivalt, hooajaliselt või mingil konkreetsel nädalapäeval. Päevapakkumiste alla kuuluvad konkreetse kuupäevaga seotud päevapakkumised. Päevapakkumiste korral kuvatakse lisainfona, kas pakkumine kehtib mingis konkreetses ajavahemikus või kogu toidukoha lahtioleku aja.<br />
<br />
Eesmärk on koguda ühte kohta kokku erinevate toidukohtade menüüd ja päevapakkumised, et kliendid saaksid mugavalt ja kiiresti oma valikuid teha. Kliendid käivad enamasti päevapakkumisi söömas lõuna ajal ja selleks ettenähtud aeg on piiratud. Sellepärast on oluline, et klient saaks teha oma valiku võimalikult kiiresti. Tänu loodavale veebiteenusele ei pea kliendid käima erinevates portaalides, et tutvuda erinevate toidukohtade pakkumistega. Kuna teenust on mugav kasutada ja klient saab oma valiku kiiresti tehtud, siis tõenäoliselt teeb klient valiku selles keskkonnas olevate toiduasutuste seast. Lisaks võimaldab teenus toiduasutustel paika panna oma pikaajalisem põhimenüü ning seda rakenduses ja võimalusel ka söögikohas kuvada. Sellepärast on ka toidukohtade huvi antud keskkonnas üleval olla ja meiega oma andmeid jagada, sest see suurendab nende klientuuri ning muudab oma menüü haldamise kergemaks.<br />
<br />
Veebiteenuse loomisel lähtume eelkõige sellest, et kliendil oleks teenust mugav kasutada ja ta saaks oma valiku kiiresti tehtud. Arvestame, et kliendid on erinevad. Mõni eelistab mõnda kindlat toidukohta, sel juhul saab ta valida oma soovitud kohad ja võrrelda nende kohtade tänase päeva pakkumisi ning menüüsid. Mõnele inimesele on oluline pakutav söök ja ta eelistab pakkumist otsida prae nimetuses oleva sõna või sõnaosa järgi ning lähtuda seejärel valiku tegemisel toidukoha keskmisest hindest või toidu hinnast. Mõne kliendi jaoks on oluline hind ja selleks, et oma valikut teha sobivas hinnavahemikus on tal võimalik sisestada maksimum hinna piirang. Kindlasti on antud teenuse juures kõikide klientide jaoks oluline päevapakkumiste asukohapõhine eristatus. Kliendid, kes soovivad oma konto luua, võivad oma eelistatud valikud meelde jätta ja järgmisel korral kuvatakse neid talle automaatselt.<br />
<br />
Teenuse must-have funktsionaalsus tagab teenuse toimimise ja põhifunktsioonid. Teenuse nice-to-have funktsionaalsus annab rakendusele lisandväärtust.<br />
<br />
Arvestades pakutava teenusega, siis näeme, et aktiivseim teenuse kasutamine võib olla tööpäevadel vahemikus 11.00-15.00, kui kliendid tutvuvad päevapakkumistega. Teenus peab tekkivale koormusele vastu pidama.<br />
<br />
Teenuse pakkumine peab olema turvaline. Selle tagamiseks tuleb sisestatavaid andmeid valideerida ja andmebaasi sisestavate andmete mahtu piirata. Toidukohtade sisestatud andmed peavad olema kaitstud, et toitude koostised ei saaks avalikuks. Põhjendatud juhtudel on võimalik kasutajaid lukku panna.<br />
<br />
== Kasutajad ==<br />
<br />
<br />
* Admin - lehe administraator, kellel on õigus lehte, kasutajaid ja nende õiguseid hallata. Tema huvi on, et teenus toimiks tõrgeteta.<br />
* Toiduasutus (tasuta kasutaja) - saab hoida lehel ühte põhimenüüd ja päevapakkumisi.<br />
* Toiduasutus (tellimusega kasutaja) - saab hoida lehel piiramatu arv põhimenüüsid ja päevapakkumisi.<br />
Toiduasutused on teenusest huvitatud, et nende menüüde haldamine oleks kerge ja mugav ning nad saaksid oma klientide arvu suurendada.<br />
* Külastaja - klient, kes valib söögikohta. Tema on huvitatud eelkõige sellest, et teenust saaks kasutada mugavalt ja kiirelt ning toidukohtade valik oleks võimalikult suur.<br />
<br />
== Rakenduse must-have funktsionaalsus ==<br />
<br />
* Kasutajad saavad sisse logida<br />
* Kasutajatel on erinevad rollid: admin, toidukoht (tasuta ja tasulise tellimusega), klient<br />
* Kasutajate arvepidamine kasutajate lõikes:<br />
** sisselogimise kuupäev, kellaaeg<br />
** pakkumiste lisamine<br />
** pakkumiste muutmine<br />
** pakkumiste kustutamine<br />
** õiguste kehtimise periood (tasuta ja tellimusega toidukoht)<br />
** pakkumistele klikkimise arv<br />
* Kasutajaid on võimalik hallata:<br />
** kasutajale õiguste andmine (menüüde arvu suurendamine, tellimusega toidukohal), rolli määramine<br />
** Kasutajat on võimalik piirata: õiguseid piirata (piiratud menüüde arv, tasuta liitunud toidukohal) ja lukku panna<br />
* Päevapakkumisi/menüüsid saab küsida: <br />
** toidukoha järgi, <br />
** kuupäeva põhiselt (ainult päevapakkumisi), <br />
** asukoha põhiselt,<br />
** toidu nimetuses esineva otsisõna/otsisõna osa põhiselt,<br />
** hinna põhiselt (max hinna piirang).<br />
* Klientrakenduses realiseeritakse CRUD meetodid (menüüsid/päevapakkumisi saab sisestada, lugeda, uuendada, kustutada)<br />
* Toidukohale saab anda hindeid ja kuvatakse keskmist hinnet.<br />
* Toidule saab anda hindeid ja kuvatakse keskmist hinnet.<br />
<br />
== Nice-to-have funktsionaalsus ==<br />
<br />
* Info selle kohta, kas päevapakkumine on otsas<br />
* Päevapakkumisi/menüüsid saab kommenteerida ja neid kommentaare kuvatakse avalikult.<br />
* Söögikohtade kodulehtedelt otsimise script, mis genereerib juba olemasolevate kodulehtede baasil päevamenüüsid.<br />
* Toiduvaliku piiramine allergeenide/vegan/jms. koostisosade põhiselt.<br />
* Aruandlused ja võrdlused toidukohtadele, et võrrelda end konkurentidega.<br />
* Teenus soovitab toidukohtadele nende varasemate päevapraadide populaarsuse alusel uue nädala menüüd.<br />
* Erinevad toidukohtade/toitude pingeread klientidele, et anda valikuteks ideid.<br />
* Soovitused klientidele, mida teised kliendid sarnaste eelistustega on veel valinud.<br />
<br />
== Andmebaasi ülesehitus ==<br />
<br />
[[File: BeerPressureAndmebaasimudel.png]]<br />
<br />
== API v1 dokumentatsioon ==<br />
<br />
'''/api/v1/Restaurants'''<br />
<source> GET /api/v1/Restaurants </source><br />
Params: -<br />
Tagastab: List<RestaurantDTO><br />
<br />
== Lõpptoote kasutusjuhend ==<br />
<br />
TODO<br />
<br />
<br />
== Logiraamat ==<br />
<br />
===07.02.2018===<br />
Gupi loomine ning suhtluskanali seadistamine<br />
<br />
=== 24.03.2018 ===<br />
Trello boardi loomine<br />
<br />
=== 25.03.2018 ===<br />
Wiki lehe loomine. Esimene tõsisem projekti koosolek ning tegevuskava paika panemine.<br />
<br />
=== 26.03.2018 ===<br />
<br />
Alustasime veebiteenuse analüüsiga ja funktsionaalsuse kirjeldamisega.<br />
<br />
=== 27.03.2018 ===<br />
Täiendasime veebiteenuse analüüsi.<br />
<br />
Esmase andmebaasi mudeli koostamine.<br />
<br />
Postitatud esimeste analüüsi arutelude põhjal valminud algne prototüüp.<br />
<br />
=== 30.03.2018 ===<br />
Valmis andmebaasimudel.<br />
<br />
=== 08.04.2018 ===<br />
Tehtud muudatused analüüsis vastavalt tagasisidele.<br />
<br />
=== 19.04.2018 ===<br />
Loodud projekti põhi koos domeenimudelitega. Projekt lisatud Githubi: https://github.com/sikumiku/TaisKohtApi</div>
Saasma
https://wiki.itcollege.ee/index.php?title=BeerPressure&diff=130392
BeerPressure
2018-04-19T21:36:02Z
<p>Saasma: /* Logiraamat */</p>
<hr />
<div>== Meeskond ja rollid ==<br />
<br />
* Sigrid Aasma (arendaja)<br />
* Evelin Jõgi (arendaja)<br />
* Martin Kask (projektijuht, arendaja)<br />
* Marko Nõu (arendaja)<br />
<br />
== Idee ==<br />
'''Toidukohtade põhimenüüde ja päevapakkumiste teenus'''<br />
<br />
Soovime pakkuda toidukohtade põhimenüüde ja päevapakkumiste teenust. On olemas mitmeid kodulehti “päevapakkumised”, kus on kirjas toidukohtade päevapraed. Kuid tavaliselt sellistel lehtedel ei ole masinloetavaid andmeid ehk siis varianti, et saad saata API pihta mingi kuupäeva koos päevapraadidega andmete uuendamiseks ja saad sama API käest küsida tänaseid päevapraade. Andmeid võiks saada küsida restorani, kuupäeva, asukoha või otsisõna/otsisõnaosa põhiselt. Selline teenus lihtsustaks ka toidukohtade päevapakkumiste haldamist, kuna praegu peavad teenuse pakkujad vastavat informatsiooni uuendama mitmes erinevas kohas - nii erinevates portaalides, kui ka enda veebileheküljel. Samuti oleks toidukohtade kogu menüü haldamine ühes kohas.<br />
<br />
[[File:TäisKõhtProto1.mp4]]<br />
<br />
Esialgne prototüüp: [http://enos.itcollege.ee/~saasma/VR2/Proto/K%C3%B5htT%C3%A4is/#g=1&p=home navigeeritav versioon]<br />
<br />
== Kasutatav arendustehnoloogia ==<br />
<br />
Veebiteenuse loomisel kasutame ASP.NET Core tehnoloogiat ja kursusel õpitud arendusmustreid.<br />
<br />
Klientrakenduse loomisel kasutame Node.js + React'i.<br />
<br />
== Veebiteenuse analüüs ==<br />
Pakume toidukohtade põhimenüüde ja päevapakkumiste teenust, kuhu on kokku koondatud erinevate toidukohtade menüüd üle Eesti. Põhimenüü alla kuuluvad pikaajalised menüüd, mis kehtivad püsivalt, hooajaliselt või mingil konkreetsel nädalapäeval. Päevapakkumiste alla kuuluvad konkreetse kuupäevaga seotud päevapakkumised. Päevapakkumiste korral kuvatakse lisainfona, kas pakkumine kehtib mingis konkreetses ajavahemikus või kogu toidukoha lahtioleku aja.<br />
<br />
Eesmärk on koguda ühte kohta kokku erinevate toidukohtade menüüd ja päevapakkumised, et kliendid saaksid mugavalt ja kiiresti oma valikuid teha. Kliendid käivad enamasti päevapakkumisi söömas lõuna ajal ja selleks ettenähtud aeg on piiratud. Sellepärast on oluline, et klient saaks teha oma valiku võimalikult kiiresti. Tänu loodavale veebiteenusele ei pea kliendid käima erinevates portaalides, et tutvuda erinevate toidukohtade pakkumistega. Kuna teenust on mugav kasutada ja klient saab oma valiku kiiresti tehtud, siis tõenäoliselt teeb klient valiku selles keskkonnas olevate toiduasutuste seast. Lisaks võimaldab teenus toiduasutustel paika panna oma pikaajalisem põhimenüü ning seda rakenduses ja võimalusel ka söögikohas kuvada. Sellepärast on ka toidukohtade huvi antud keskkonnas üleval olla ja meiega oma andmeid jagada, sest see suurendab nende klientuuri ning muudab oma menüü haldamise kergemaks.<br />
<br />
Veebiteenuse loomisel lähtume eelkõige sellest, et kliendil oleks teenust mugav kasutada ja ta saaks oma valiku kiiresti tehtud. Arvestame, et kliendid on erinevad. Mõni eelistab mõnda kindlat toidukohta, sel juhul saab ta valida oma soovitud kohad ja võrrelda nende kohtade tänase päeva pakkumisi ning menüüsid. Mõnele inimesele on oluline pakutav söök ja ta eelistab pakkumist otsida prae nimetuses oleva sõna või sõnaosa järgi ning lähtuda seejärel valiku tegemisel toidukoha keskmisest hindest või toidu hinnast. Mõne kliendi jaoks on oluline hind ja selleks, et oma valikut teha sobivas hinnavahemikus on tal võimalik sisestada maksimum hinna piirang. Kindlasti on antud teenuse juures kõikide klientide jaoks oluline päevapakkumiste asukohapõhine eristatus. Kliendid, kes soovivad oma konto luua, võivad oma eelistatud valikud meelde jätta ja järgmisel korral kuvatakse neid talle automaatselt.<br />
<br />
Teenuse must-have funktsionaalsus tagab teenuse toimimise ja põhifunktsioonid. Teenuse nice-to-have funktsionaalsus annab rakendusele lisandväärtust.<br />
<br />
Arvestades pakutava teenusega, siis näeme, et aktiivseim teenuse kasutamine võib olla tööpäevadel vahemikus 11.00-15.00, kui kliendid tutvuvad päevapakkumistega. Teenus peab tekkivale koormusele vastu pidama.<br />
<br />
Teenuse pakkumine peab olema turvaline. Selle tagamiseks tuleb sisestatavaid andmeid valideerida ja andmebaasi sisestavate andmete mahtu piirata. Toidukohtade sisestatud andmed peavad olema kaitstud, et toitude koostised ei saaks avalikuks. Põhjendatud juhtudel on võimalik kasutajaid lukku panna.<br />
<br />
== Kasutajad ==<br />
<br />
<br />
* Admin - lehe administraator, kellel on õigus lehte, kasutajaid ja nende õiguseid hallata. Tema huvi on, et teenus toimiks tõrgeteta.<br />
* Toiduasutus (tasuta kasutaja) - saab hoida lehel ühte põhimenüüd ja päevapakkumisi.<br />
* Toiduasutus (tellimusega kasutaja) - saab hoida lehel piiramatu arv põhimenüüsid ja päevapakkumisi.<br />
Toiduasutused on teenusest huvitatud, et nende menüüde haldamine oleks kerge ja mugav ning nad saaksid oma klientide arvu suurendada.<br />
* Külastaja - klient, kes valib söögikohta. Tema on huvitatud eelkõige sellest, et teenust saaks kasutada mugavalt ja kiirelt ning toidukohtade valik oleks võimalikult suur.<br />
<br />
== Rakenduse must-have funktsionaalsus ==<br />
<br />
* Kasutajad saavad sisse logida<br />
* Kasutajatel on erinevad rollid: admin, toidukoht (tasuta ja tasulise tellimusega), klient<br />
* Kasutajate arvepidamine kasutajate lõikes:<br />
** sisselogimise kuupäev, kellaaeg<br />
** pakkumiste lisamine<br />
** pakkumiste muutmine<br />
** pakkumiste kustutamine<br />
** õiguste kehtimise periood (tasuta ja tellimusega toidukoht)<br />
** pakkumistele klikkimise arv<br />
* Kasutajaid on võimalik hallata:<br />
** kasutajale õiguste andmine (menüüde arvu suurendamine, tellimusega toidukohal), rolli määramine<br />
** Kasutajat on võimalik piirata: õiguseid piirata (piiratud menüüde arv, tasuta liitunud toidukohal) ja lukku panna<br />
* Päevapakkumisi/menüüsid saab küsida: <br />
** toidukoha järgi, <br />
** kuupäeva põhiselt (ainult päevapakkumisi), <br />
** asukoha põhiselt,<br />
** toidu nimetuses esineva otsisõna/otsisõna osa põhiselt,<br />
** hinna põhiselt (max hinna piirang).<br />
* Klientrakenduses realiseeritakse CRUD meetodid (menüüsid/päevapakkumisi saab sisestada, lugeda, uuendada, kustutada)<br />
* Toidukohale saab anda hindeid ja kuvatakse keskmist hinnet.<br />
* Toidule saab anda hindeid ja kuvatakse keskmist hinnet.<br />
<br />
== Nice-to-have funktsionaalsus ==<br />
<br />
* Info selle kohta, kas päevapakkumine on otsas<br />
* Päevapakkumisi/menüüsid saab kommenteerida ja neid kommentaare kuvatakse avalikult.<br />
* Söögikohtade kodulehtedelt otsimise script, mis genereerib juba olemasolevate kodulehtede baasil päevamenüüsid.<br />
* Toiduvaliku piiramine allergeenide/vegan/jms. koostisosade põhiselt.<br />
* Aruandlused ja võrdlused toidukohtadele, et võrrelda end konkurentidega.<br />
* Teenus soovitab toidukohtadele nende varasemate päevapraadide populaarsuse alusel uue nädala menüüd.<br />
* Erinevad toidukohtade/toitude pingeread klientidele, et anda valikuteks ideid.<br />
* Soovitused klientidele, mida teised kliendid sarnaste eelistustega on veel valinud.<br />
<br />
== Andmebaasi ülesehitus ==<br />
<br />
[[File: BeerPressureAndmebaasimudel.png]]<br />
== Lõpptoote kasutusjuhend ==<br />
<br />
TODO<br />
<br />
<br />
== Logiraamat ==<br />
<br />
===07.02.2018===<br />
Gupi loomine ning suhtluskanali seadistamine<br />
<br />
=== 24.03.2018 ===<br />
Trello boardi loomine<br />
<br />
=== 25.03.2018 ===<br />
Wiki lehe loomine. Esimene tõsisem projekti koosolek ning tegevuskava paika panemine.<br />
<br />
=== 26.03.2018 ===<br />
<br />
Alustasime veebiteenuse analüüsiga ja funktsionaalsuse kirjeldamisega.<br />
<br />
=== 27.03.2018 ===<br />
Täiendasime veebiteenuse analüüsi.<br />
<br />
Esmase andmebaasi mudeli koostamine.<br />
<br />
Postitatud esimeste analüüsi arutelude põhjal valminud algne prototüüp.<br />
<br />
=== 30.03.2018 ===<br />
Valmis andmebaasimudel.<br />
<br />
=== 08.04.2018 ===<br />
Tehtud muudatused analüüsis vastavalt tagasisidele.<br />
<br />
=== 19.04.2018 ===<br />
Loodud projekti põhi koos domeenimudelitega. Projekt lisatud Githubi: https://github.com/sikumiku/TaisKohtApi</div>
Saasma
https://wiki.itcollege.ee/index.php?title=Kodut%C3%B6%C3%B6_aines_%22V%C3%B5rgurakendused_II:_hajuss%C3%BCsteemide_ehitamine%22_2018&diff=130331
Kodutöö aines "Võrgurakendused II: hajussüsteemide ehitamine" 2018
2018-04-08T19:52:40Z
<p>Saasma: /* Meeskond: BeerPressure */</p>
<hr />
<div>[[Category: Võrgurakendused II: hajussüsteemide ehitamine]]<br />
__NOINDEX__<br />
<br />
=Kodutöö aines "Võrgurakendused II: hajussüsteemide ehitamine" 2018=<br />
==Eesmärk==<br />
Saada praktiline kogemus hajussüsteemide ehitamisest XML(SOAP) või Rest veebiteenusel ja sellele klientrakenduse loomise abil ning süvendada meeskonnatööoskust. <br />
*SOAP veebiteenuse puhul eeldatakse WCF tehnoloogia kasutamist. Vanema põlvkonna ASP.NET veebiteenuse loomine ei ole lubatud, kuna seda ei toeta ka Microsoft enam tänasel päeval.<br />
*REST teenuste loomisel tuleks kasutada ASP.NET Web API2/ASP.NET Core 2.0/WCF võimalusi.<br />
<br />
Kaugem eesmärk on loomulikult hinne :).<br />
<br />
==Reeglid==<br />
''' Kodutöö koosneb kolmest eraldiseisvast ülesandest:'''<br />
* Luua XML fail vabalt valitud andmete edastamiseks,selle faili skeemifail ning XSL fail(id) erinevate transformatsioonide tarvis (soovitavalt vähemalt andmete HTML ja XML kujul kuvamiseks)<br />
* Luua veebiteenus, mis võimaldaks pakkuda teenust, eristada kasutajaid ning näidata teenuse kasutamise statistikat kasutajate ja tegevuste lõikes<br />
* Luua klientrakendus<br />
<br />
Ühte projektimeeskonda kuulub 3..4 tudengit ning ühel teemal teostab projekti üks või mitu meeskonda. 1,2 ja viie liikmelised meeskonnad tuleks õppejõuga eraldi kooskõlastada.<br />
<br />
Töö käiku kajastatakse http://wiki.itcollege.ee keskkonnas. Wikilehe täitmise eesmärke on kaks: nii on võimalik kirja panna kõik mõtted ja ideed (ning nendest jääb jälg) ning õppejõul on hiljem võimalik saada ülevaade iga projektimeeskonna liikme panusest.<br />
<br />
==Tähtajad==<br />
<br />
<br />
* '''Veebiteenus''' [https://wiki.itcollege.ee/index.php/Kodut%C3%B6%C3%B6_aines_%22V%C3%B5rgurakendused_II:_hajuss%C3%BCsteemide_ehitamine%22_2018#Veebiteenus NB! Täpsem info]<br />
** Veebiteenuse analüüs peab olema valmis, esitatud ja wikilehel kirjeldatud hiljemalt: '''01.aprill 2018'''. Lisaks on '''Meeskonnad on loonud omale enda wiki lehe, kuhu kirjeldavad meeskonna ja panevad nad üles oma tööd. Lisaks hakkavad kogunema ka sinna teiste gruppide poolt kirjutatavad retsensioonid. <ins>Meeskonnalehed lingitakse selle lehe lõppu Meeskonna pealkirja alla.</ins>'''<br />
** Veebiteenus peab olema valmis, esitatud ja ja wikilehel kirjeldatud hiljemalt '''27. mai 2018'''.<br />
** Retsensioonid veebiteenuste kohta peavad tehtud olema '''03. juuni 2018'''.<br />
<br />
<br />
* '''Klientrakendused''' [https://wiki.itcollege.ee/index.php/Kodut%C3%B6%C3%B6_aines_%22V%C3%B5rgurakendused_II:_hajuss%C3%BCsteemide_ehitamine%22_2018#Klientrakendus NB! Täpsem info]<br />
** Klientrakendused peavad olema valmis, esitatud ja ja wikilehel kirjeldatud hiljemalt '''27. mai 2018'''.<br />
** Retsensioonid klientrakenduste kohta peavad tehtud olema '''03. juuni 2018'''.<br />
<br />
<br />
* '''XML fail''' [https://wiki.itcollege.ee/index.php/Kodut%C3%B6%C3%B6_aines_%22V%C3%B5rgurakendused_II:_hajuss%C3%BCsteemide_ehitamine%22_2018#XML_andmefail NB! Täpsem info]<br />
** XML fail, stiilifail ja skeemifail peavad olema valmis ja wikilehel kirjeldatud hiljemalt '''01. juuni 2018'''.<br />
** Retsensioonid XML-failide kohta peavad tehtud olema '''05.juuni 2018'''.<br />
<br />
==Hindamine==<br />
===Üldised kriteeriumid===<br />
<br />
Teostatuks loetakse projekt juhul, kui lähteülesanne on realiseeritud, lahendus on töötav, kuid esineb suuremaid vigu ning piirsituatsioonidega ei ole arvestatud.<br />
<br />
Maksimumtulemuse saavutamiseks peab projekt olema teostatud tehniliselt veatult ning varustatud dokumentatsiooniga, milles sisaldub arendusprotsessi kirjeldus (peab selguma ka iga rühmaliikme panus projekti teostamisel), paigaldusjuhend ning lahenduse kirjeldus. <br />
<br />
'''Maksimumtulemuse annab (vähemalt 4/7):'''<br />
<br />
* Majanduslik mõtlemine (kas loodav teenus ja rakendused oleks kasutatav ka ärilistel eesmärkidel)<br />
* Mobiilirakendused/Angularis/reactis loodud klientrakendus<br />
* Kogukondade kaasamine<br />
* Kasutajamugavus<br />
* Läbimõeldud töökorraldus<br />
* Lisavõimaluste realiseerimine (vt näidisteemad)<br />
* Korraliku arhitektuuriga kirjutatud kood<br />
<br />
===XML andmefail===<br />
Ülesande täitmiseks tuleb luua XML fail andmete edastamiseks, selle XML faili skeemifail ning minimaalselt kaks sobivat XSL transformatsiooni faili loodud XML failis olevate andmete transformeerimiseks HTML formaati ja XML faili formaadi muutmiseks. Transformatsioonid peavad sisaldama midagi enamat, kui ainult üks for-each klausel. Transformatsiooni käigus peaks kasutama vajadusel parameetreid ning kindlasti ka erinevaid tingimuste kontrolle.<br />
<br />
XML-il peab olema vähemalt 4 loogilist dimensiooni.<br />
<dim1><br />
<dim2><br />
<dim3><br />
<dim4><br />
</dim4><br />
</dim3><br />
</dim2><br />
</dim1><br />
Lisaks tuleb kasutada 3-el dimensioonil attribuute, mis one enamat, kui lihtsalt ID.<br />
<br />
===Veebiteenus===<br />
Loodav veebiteenus peab võimaldama:<br />
* Teenuse pakkumist<br />
* '''Teenuse kasutajate tuvastamist ning haldamist'''<br />
* Teenuse kasutajate ja kasutusstatistika üle arve pidamist kasutajate lõikes<br />
* Teenuse poole pöördumiste arvu piiramist ja piirangute haldamist.<br />
<br />
Loodav veebiteenus peab toetama mitme kasutaja võimalust.<br />
<br />
Loodav veebiteenus tuleb luua kasutades ''Windows Communication Foundation'' või ASP.NET MVC Web API tehnoloogiat<br />
<br />
Andmebaasis peab olema vähemalt 9 olemit ehk andmebaas on eeldus,<br />
<br />
<br />
Soovitav on luua teenus (FE) ja teenuse seadistamiseks ning kasutajate haldamiseks mõeldud rakendus (BE).<br />
<br />
===Klientrakendus===<br />
Klientrakendus mõnele olemasolevale veebiteenusele, võib olla teostatud veebirakendusena(ASP.NET veebirakendus või hoopis Angulari või Reacti baasil), töölauarakendusena(WPF) või mobiilse rakendusena(Xamarin)<br />
<br />
Variant1: teha klientrakendus enda loodud veebiteenusele <br />
<br />
Variant2: teha klientrakendus mõnele levinud veebiteenusele.<br />
Näiteks: <br />
* http://www.bing.com/developer<br />
* http://www.flickr.com/services/api/response.soap.html<br />
* http://developer.ebay.com/developercenter/windows/<br />
* http://apiwiki.twitter.com/Getting-Started<br />
<br />
===Retsensioonid===<br />
Retsensioon on üliõpilase iseseisva teadustöö kriitilise analüüsi põhjal koostatud argumenteeritud hinnang. Retsensioonis tuleb hinnata töö vastavust esitatud tingimustele, programmikoodi loetavust ning kommenteeritust, dokumentatsiooni ja kirjeldada puudusi. Retsensioonide põhjal on meeskondadel õigus oma projekte parandada enne määratud esitamistähtaja kättejõudmist.<br />
<br />
Retsensioon peab sisaldama minimaalselt...<br />
* XML - ...200 sõna.<br />
* Veebiteenus - ...600 sõna.<br />
* Klientrakendus - ...600 sõna.<br />
<br />
Mõnelauselisest arvamusest ei piisa, kuna tegemist on grupi loodavate arvustustega, mitte individuaalsete arvustustega.<br />
<br />
==Konsultatsioonid==<br />
Igal projektimeeskonnal on piiramatu õigus saada õppejõu käest konsultatsiooni ja juhendamist oma<br />
töö tegemiseks, kas harjutuste ajal või pärast harjutusi ja loenguid. Eriaegade suhtes saab sõlmida<br />
õppejõuga kokkuleppeid kontaktidel<br />
mait.poska [ät] itcollege.ee või (+372 53 469 734)<br />
(teksti originaalautor Priit Raspel)<br />
<br />
==Kaitsmisele registreerumine==<br />
<br />
=Teemad 2018 kevad=<br />
''' Kodutöö koosneb kolmest eraldiseisvast ülesandest:'''<br />
* Luua XML fail vabalt valitud andmete edastamiseks,selle faili skeemifail ning XSL fail(id) erinevate transformatsioonide tarvis (soovitavalt vähemalt andmete HTML ja XML kujul kuvamiseks)<br />
* Luua veebiteenus, mis võimaldaks pakkuda teenust, eristada kasutajaid ning näidata teenuse kasutamise statistikat kasutajate ja tegevuste lõikes<br />
* Luua klientrakendus mõnele olemasolevale või endaloodud veebiteenusele<br />
<br />
NB! XML andmefail ja veebiteenus ei pea olema omavahel seotud.<br />
<br />
<br />
==Näidisteemad==<br />
<br />
<br />
====Ülesanne====<br />
Luua sobiva alguse järgi nimede pakkumise teenus:<br />
* alates kahetähelisetest algustest pakkuda sobivad nimesid<br />
* luua võimalus kasutajatel nimesid lisada<br />
* luua võimalus administraatoril nimesid muuta/kustutada<br />
* meeste ja naiste nimed peavad olema süsteemis eristatavad<br />
* luua võimalus, mis võimaldab kuvada populaarseid nimesid<br />
* luua võimalus ühele kasutajale (või erinevatele kasutajagruppidele) maksimumpäringute hulga määramiseks<br />
* luua võimalus, et nimi lisatakse baasi alles siis, kui administraatori õigustega inimene on selleks vastava loa andnud<br />
<br />
===Külastusstatistika teenus===<br />
Mõte selles, et pakkuda teenust, kus kasutajal on võimalik registreerida külastused ning küsida oma külastusstatistikat.<br />
<br />
====Ülesanne====<br />
Luua külastusstatistika teenus:<br />
* kasutaja saab teenuses registreerida külastusi<br />
* kasutaja saab küsida külastusstatistikat päevade/kuude/kogu perioodi lõikes<br />
* luua võimalus ühele kasutajale (või erinevatele kasutajagruppidele) maksimumpäringute hulga määramiseks<br />
<br />
Lisavõimalused:<br />
* luua võimalus registreerida alamlehtede külastusstatistikat<br />
* luua võimalus külastusstatistikale lisaparameetrite lisamiseks (ip aadress, sirviku versioon jne)<br />
<br />
===Telefoniraamatu teenus===<br />
Mõte selles, et kasutaja saab teenuse abil salvestada kontakte ja nende seast otsida<br />
<br />
====Ülesanne====<br />
Luua telefoniraamatu teenus:<br />
* kasutaja saab teenuses kontakte lisada ja kustutada<br />
* kasutaja saab kontaktide nime/telefoninumbri jne abil otsida<br />
* luua võimalus ühele kasutajale (või erinevatele kasutajagruppidele) maksimumpäringute hulga määramiseks<br />
* kasutajaid on võimalik lisada gruppidesse<br />
* kasutajal on võimalik lisada vajalike kontaktandmete liike<br />
* kasutajatel on võimalik jagada omavahel kontakte ja kontaktide grupper<br />
<br />
===RSS voogude kogumise ja uudiste kuvamise teenus===<br />
Mõte selles, et kasutaja saab teenuse abil salvestada talle huvipakkuvaid RSS vooge ja nendelt voogudelt uudiseid lugeda<br />
<br />
====Ülesanne====<br />
Luua RSS voogude haldusteenus:<br />
* kasutaja saab teenuses RSS vooge lisada ja kustudada<br />
* kasutaja saab pärida talle huvipakkuvate voogude viimaseid uudiseid<br />
* luua võimalus ühele kasutajale (või erinevatele kasutajagruppidele) maksimumpäringute hulga määramiseks<br />
* kasutaja saab RSS vooge vaadata eraldi või grupeeritult<br />
* vooge peab puhverdama, kuna voogude lugemine võtab enamasti üsna palju aega <br />
*<br />
<br />
= Meeskonnad 2018=<br />
==Päevaõpe==<br />
<br />
===[https://wiki.itcollege.ee/index.php/HairSaloon Meeskond: HairSaloon]===<br />
Liikmed:<br />
* Kaido Henrik Elias<br />
* Arvo Paomees<br />
<br />
===[https://wiki.itcollege.ee/index.php/VariousArtists Meeskond: VariousArtists]===<br />
Liikmed:<br />
* Ruudi Vinter<br />
* Madis Roosioks<br />
* Madis Heinsoo<br />
* Pavel Fleišer<br />
<br />
===[https://wiki.itcollege.ee/index.php/Maagikud Meeskond: Maagikud]===<br />
Liikmed:<br />
*Kristina Rästas<br />
*Simo Jaanus<br />
*Artur Tammiste<br />
*Rauno Lõhmus<br />
<br />
===[https://wiki.itcollege.ee/index.php/RaamatuRiiul Meeskond: RaamatuRiiul]===<br />
Liikmed:<br />
* Alo Avi<br />
* Arnika Rästa<br />
* Marite Rammo<br />
<br />
===[https://wiki.itcollege.ee/index.php/Autolugu Meeskond: Autolugu]===<br />
Liikmed:<br />
* Margus Põlma<br />
* Karl Erik Õunapuu<br />
<br />
===[https://wiki.itcollege.ee/index.php/VRII2018 Meeskond: VRII2018]===<br />
Liikmed:<br />
* Kaspar Kaal<br />
* Teet Adamson<br />
* Rahel Kangur<br />
<br />
===[https://wiki.itcollege.ee/index.php/Meeskond_Raavo_V2%E2%84%A2 Meeskond: Raavo V2™]===<br />
Liikmed:<br />
* Peeter Fridolin<br />
* Kristo Leesmann<br />
* Rando Rommot<br />
* Erik Kaup<br />
<br />
===[https://wiki.itcollege.ee/index.php/Pillarofautumn Meeskond: Pillar of Autumn ]===<br />
Liikmed:<br />
* Taavi Põder<br />
* Taavi Vesinurm<br />
* Raido Vell<br />
<br />
===[https://wiki.itcollege.ee/index.php/jaatuli Meeskond: JääTuli]===<br />
Liikmed:<br />
*Tarmo Luugus<br />
*Leho Kivistik<br />
*Hannes Mäeorg<br />
*Marten Tammeleht<br />
<br />
===[https://wiki.itcollege.ee/index.php/JustABot Meeskond: JustABot]===<br />
Liikmed:<br />
*Argo Hansen<br />
<br />
===[https://wiki.itcollege.ee/index.php/Meeskond_Pakiraam Meeskond: Pakiraam]===<br />
Liikmed:<br />
*Kristo Naeris<br />
*Margus Kildemaa<br />
*Indro Kottise<br />
<br />
===[https://wiki.itcollege.ee/index.php/GoFood Meeskond: GoFood]===<br />
Liikmed: <br />
<br />
* Rando Kurel<br />
* Henrik Prangel<br />
* Markus Mänd<br />
* Edgar Tereping<br />
* Jane Kaldma<br />
<br />
===[https://wiki.itcollege.ee/index.php/LTD Meeskond: LearnToDrive]===<br />
'''Liikmed:'''<br />
*Kert Saarma<br />
*Eve Ormisson<br />
*Villem Markus Loigom<br />
*Carlos Kirtsi<br />
<br />
===[https://wiki.itcollege.ee/index.php/Miisiiks Meeskond: Miisiiks]===<br />
Liikmed:<br />
*Christo Aruste<br />
*Heleriin Malkov<br />
*Tõnis Prants<br />
<br />
==Kaugõpe==<br />
<br />
===[https://wiki.itcollege.ee/index.php/BSIS Meeskond: BSIS]===<br />
Liikmed:<br />
* Germo Väli<br />
* siin on vaba koht kui on huvi projekti vastu<br />
<br />
===[https://wiki.itcollege.ee/index.php/BestInShow Meeskond: BestInShow]===<br />
Liikmed:<br />
* Liina Abner<br />
* Marju Pütsepp<br />
* Liisi Taimre<br />
<br />
===[https://wiki.itcollege.ee/index.php/WatchWinders Meeskond: WatchWinders]===<br />
Liikmed:<br />
* Toomas Juhkov<br />
* Kunnar Kukk<br />
* Tiit Kuuskmäe<br />
<br />
===[[ Kuldneloojang | Meeskond: Kuldne loojang]]===<br />
Liikmed:<br />
* Andrus Seiman<br />
* Marko Belzetski<br />
* Priit Tiganik<br />
* Kristjan Peterson<br />
<br />
===[https://wiki.itcollege.ee/index.php/Ophelia Meeskond: Ophelia]===<br />
Liikmed:<br />
* Siim Kallari<br />
* Andres Kepler<br />
* Jorma Rebane<br />
<br />
===[https://wiki.itcollege.ee/index.php/SharpRestoVRII Meeskond: SharpRestoVRII]===<br />
Liikmed:<br />
* Andres Aava<br />
* Henri Annilo<br />
* Jaan Koolmeister<br />
* Lauri Üksti<br />
<br />
===[https://wiki.itcollege.ee/index.php/BeerPressure Meeskond: BeerPressure]===<br />
Liikmed:<br />
* Sigrid Aasma<br />
* Evelin Jõgi<br />
* Martin Kask<br />
* Marko Nõu<br />
<br />
===[[ Memorize | Meeskond: Memorize]]===<br />
Liikmed:<br />
* Madis Uudam<br />
* Olle Mikk<br />
<br />
===[https://wiki.itcollege.ee/index.php/UCanDo Meeskond: UCanDo]===<br />
Liikmed:<br />
* Mart Raus<br />
* Ando Kiidron<br />
* Liina Saar<br />
<br />
'''TFS:''' Coming...<br />
<br />
===[https://wiki.itcollege.ee/index.php/MOT Meeskond: MOT]===<br />
Liikmed:<br />
* Merike Meizner<br />
* Helen Oppar<br />
* Hardi Tiitus<br />
<br />
===[https://wiki.itcollege.ee/index.php/Meeskond:_MealPlanner Meeskond: MealPlanner]===<br />
Liikmed:<br />
*Triin Oja<br />
*Rein Remsu<br />
<br />
===[https://wiki.itcollege.ee/index.php/Meeskond:Curry Meeskond: Curry]===<br />
Liikmed:<br />
* Rain Elken<br />
* Peeter Ploom<br />
<br />
===[https://wiki.itcollege.ee/index.php/Hammas Meeskond: Hammas]===<br />
Liikmed:<br />
* Sten Lunden</div>
Saasma
https://wiki.itcollege.ee/index.php?title=BeerPressure&diff=130322
BeerPressure
2018-04-08T10:30:22Z
<p>Saasma: /* Logiraamat */</p>
<hr />
<div>== Meeskond ja rollid ==<br />
<br />
* Sigrid Aasma (arendaja)<br />
* Evelin Jõgi (arendaja)<br />
* Martin Kask (projektijuht, arendaja)<br />
* Marko Nõu (arendaja)<br />
<br />
== Idee ==<br />
'''Toidukohtade põhimenüüde ja päevapakkumiste teenus'''<br />
<br />
Soovime pakkuda toidukohtade põhimenüüde ja päevapakkumiste teenust. On olemas mitmeid kodulehti “päevapakkumised”, kus on kirjas toidukohtade päevapraed. Kuid tavaliselt sellistel lehtedel ei ole masinloetavaid andmeid ehk siis varianti, et saad saata API pihta mingi kuupäeva koos päevapraadidega andmete uuendamiseks ja saad sama API käest küsida tänaseid päevapraade. Andmeid võiks saada küsida restorani, kuupäeva, asukoha või otsisõna/otsisõnaosa põhiselt. Selline teenus lihtsustaks ka toidukohtade päevapakkumiste haldamist, kuna praegu peavad teenuse pakkujad vastavat informatsiooni uuendama mitmes erinevas kohas - nii erinevates portaalides, kui ka enda veebileheküljel. Samuti oleks toidukohtade kogu menüü haldamine ühes kohas.<br />
<br />
[[File:TäisKõhtProto1.mp4]]<br />
<br />
Esialgne prototüüp: [http://enos.itcollege.ee/~saasma/VR2/Proto/K%C3%B5htT%C3%A4is/#g=1&p=home navigeeritav versioon]<br />
<br />
== Kasutatav arendustehnoloogia ==<br />
<br />
Veebiteenuse loomisel kasutame ASP.NET Core tehnoloogiat ja kursusel õpitud arendusmustreid.<br />
<br />
Klientrakenduse loomisel kasutame Node.js + React'i.<br />
<br />
== Veebiteenuse analüüs ==<br />
Pakume toidukohtade põhimenüüde ja päevapakkumiste teenust, kuhu on kokku koondatud erinevate toidukohtade menüüd üle Eesti. Põhimenüü alla kuuluvad pikaajalised menüüd, mis kehtivad püsivalt, hooajaliselt või mingil konkreetsel nädalapäeval. Päevapakkumiste alla kuuluvad konkreetse kuupäevaga seotud päevapakkumised. Päevapakkumiste korral kuvatakse lisainfona, kas pakkumine kehtib mingis konkreetses ajavahemikus või kogu toidukoha lahtioleku aja.<br />
<br />
Eesmärk on koguda ühte kohta kokku erinevate toidukohtade menüüd ja päevapakkumised, et kliendid saaksid mugavalt ja kiiresti oma valikuid teha. Kliendid käivad enamasti päevapakkumisi söömas lõuna ajal ja selleks ettenähtud aeg on piiratud. Sellepärast on oluline, et klient saaks teha oma valiku võimalikult kiiresti. Tänu loodavale veebiteenusele ei pea kliendid käima erinevates portaalides, et tutvuda erinevate toidukohtade pakkumistega. Kuna teenust on mugav kasutada ja klient saab oma valiku kiiresti tehtud, siis tõenäoliselt teeb klient valiku selles keskkonnas olevate toiduasutuste seast. Lisaks võimaldab teenus toiduasutustel paika panna oma pikaajalisem põhimenüü ning seda rakenduses ja võimalusel ka söögikohas kuvada. Sellepärast on ka toidukohtade huvi antud keskkonnas üleval olla ja meiega oma andmeid jagada, sest see suurendab nende klientuuri ning muudab oma menüü haldamise kergemaks.<br />
<br />
Veebiteenuse loomisel lähtume eelkõige sellest, et kliendil oleks teenust mugav kasutada ja ta saaks oma valiku kiiresti tehtud. Arvestame, et kliendid on erinevad. Mõni eelistab mõnda kindlat toidukohta, sel juhul saab ta valida oma soovitud kohad ja võrrelda nende kohtade tänase päeva pakkumisi ning menüüsid. Mõnele inimesele on oluline pakutav söök ja ta eelistab pakkumist otsida prae nimetuses oleva sõna või sõnaosa järgi ning lähtuda seejärel valiku tegemisel toidukoha keskmisest hindest või toidu hinnast. Mõne kliendi jaoks on oluline hind ja selleks, et oma valikut teha sobivas hinnavahemikus on tal võimalik sisestada maksimum hinna piirang. Kindlasti on antud teenuse juures kõikide klientide jaoks oluline päevapakkumiste asukohapõhine eristatus. Kliendid, kes soovivad oma konto luua, võivad oma eelistatud valikud meelde jätta ja järgmisel korral kuvatakse neid talle automaatselt.<br />
<br />
Teenuse must-have funktsionaalsus tagab teenuse toimimise ja põhifunktsioonid. Teenuse nice-to-have funktsionaalsus annab rakendusele lisandväärtust.<br />
<br />
Arvestades pakutava teenusega, siis näeme, et aktiivseim teenuse kasutamine võib olla tööpäevadel vahemikus 11.00-15.00, kui kliendid tutvuvad päevapakkumistega. Teenus peab tekkivale koormusele vastu pidama.<br />
<br />
Teenuse pakkumine peab olema turvaline. Selle tagamiseks tuleb sisestatavaid andmeid valideerida ja andmebaasi sisestavate andmete mahtu piirata. Toidukohtade sisestatud andmed peavad olema kaitstud, et toitude koostised ei saaks avalikuks. Põhjendatud juhtudel on võimalik kasutajaid lukku panna.<br />
<br />
== Kasutajad ==<br />
<br />
<br />
* Admin - lehe administraator, kellel on õigus lehte, kasutajaid ja nende õiguseid hallata. Tema huvi on, et teenus toimiks tõrgeteta.<br />
* Toiduasutus (tasuta kasutaja) - saab hoida lehel ühte põhimenüüd ja päevapakkumisi.<br />
* Toiduasutus (tellimusega kasutaja) - saab hoida lehel piiramatu arv põhimenüüsid ja päevapakkumisi.<br />
Toiduasutused on teenusest huvitatud, et nende menüüde haldamine oleks kerge ja mugav ning nad saaksid oma klientide arvu suurendada.<br />
* Külastaja - klient, kes valib söögikohta. Tema on huvitatud eelkõige sellest, et teenust saaks kasutada mugavalt ja kiirelt ning toidukohtade valik oleks võimalikult suur.<br />
<br />
== Rakenduse must-have funktsionaalsus ==<br />
<br />
* Kasutajad saavad sisse logida<br />
* Kasutajatel on erinevad rollid: admin, toidukoht (tasuta ja tasulise tellimusega), klient<br />
* Kasutajate arvepidamine kasutajate lõikes:<br />
** sisselogimise kuupäev, kellaaeg<br />
** pakkumiste lisamine<br />
** pakkumiste muutmine<br />
** pakkumiste kustutamine<br />
** õiguste kehtimise periood (tasuta ja tellimusega toidukoht)<br />
** pakkumistele klikkimise arv<br />
* Kasutajaid on võimalik hallata:<br />
** kasutajale õiguste andmine (menüüde arvu suurendamine, tellimusega toidukohal), rolli määramine<br />
** Kasutajat on võimalik piirata: õiguseid piirata (piiratud menüüde arv, tasuta liitunud toidukohal) ja lukku panna<br />
* Päevapakkumisi/menüüsid saab küsida: <br />
** toidukoha järgi, <br />
** kuupäeva põhiselt (ainult päevapakkumisi), <br />
** asukoha põhiselt,<br />
** toidu nimetuses esineva otsisõna/otsisõna osa põhiselt,<br />
** hinna põhiselt (max hinna piirang).<br />
* Klientrakenduses realiseeritakse CRUD meetodid (menüüsid/päevapakkumisi saab sisestada, lugeda, uuendada, kustutada)<br />
* Toidukohale saab anda hindeid ja kuvatakse keskmist hinnet.<br />
* Toidule saab anda hindeid ja kuvatakse keskmist hinnet.<br />
<br />
== Nice-to-have funktsionaalsus ==<br />
<br />
* Info selle kohta, kas päevapakkumine on otsas<br />
* Päevapakkumisi/menüüsid saab kommenteerida ja neid kommentaare kuvatakse avalikult.<br />
* Söögikohtade kodulehtedelt otsimise script, mis genereerib juba olemasolevate kodulehtede baasil päevamenüüsid.<br />
* Toiduvaliku piiramine allergeenide/vegan/jms. koostisosade põhiselt.<br />
* Aruandlused ja võrdlused toidukohtadele, et võrrelda end konkurentidega.<br />
* Teenus soovitab toidukohtadele nende varasemate päevapraadide populaarsuse alusel uue nädala menüüd.<br />
* Erinevad toidukohtade/toitude pingeread klientidele, et anda valikuteks ideid.<br />
* Soovitused klientidele, mida teised kliendid sarnaste eelistustega on veel valinud.<br />
<br />
== Andmebaasi ülesehitus ==<br />
<br />
[[File: BeerPressureAndmebaasimudel.png]]<br />
== Lõpptoote kasutusjuhend ==<br />
<br />
TODO<br />
<br />
<br />
== Logiraamat ==<br />
<br />
===07.02.2018===<br />
Gupi loomine ning suhtluskanali seadistamine<br />
<br />
=== 24.03.2018 ===<br />
Trello boardi loomine<br />
<br />
=== 25.03.2018 ===<br />
Wiki lehe loomine. Esimene tõsisem projekti koosolek ning tegevuskava paika panemine.<br />
<br />
=== 26.03.2018 ===<br />
<br />
Alustasime veebiteenuse analüüsiga ja funktsionaalsuse kirjeldamisega.<br />
<br />
=== 27.03.2018 ===<br />
Täiendasime veebiteenuse analüüsi.<br />
<br />
Esmase andmebaasi mudeli koostamine.<br />
<br />
Postitatud esimeste analüüsi arutelude põhjal valminud algne prototüüp.<br />
<br />
=== 30.03.2018 ===<br />
Valmis andmebaasimudel.<br />
<br />
=== 08.04.2018 ===<br />
Tehtud muudatused analüüsis vastavalt tagasisidele.</div>
Saasma
https://wiki.itcollege.ee/index.php?title=BeerPressure&diff=130320
BeerPressure
2018-04-08T10:28:27Z
<p>Saasma: /* Kasutatav arendustehnoloogia */</p>
<hr />
<div>== Meeskond ja rollid ==<br />
<br />
* Sigrid Aasma (arendaja)<br />
* Evelin Jõgi (arendaja)<br />
* Martin Kask (projektijuht, arendaja)<br />
* Marko Nõu (arendaja)<br />
<br />
== Idee ==<br />
'''Toidukohtade põhimenüüde ja päevapakkumiste teenus'''<br />
<br />
Soovime pakkuda toidukohtade põhimenüüde ja päevapakkumiste teenust. On olemas mitmeid kodulehti “päevapakkumised”, kus on kirjas toidukohtade päevapraed. Kuid tavaliselt sellistel lehtedel ei ole masinloetavaid andmeid ehk siis varianti, et saad saata API pihta mingi kuupäeva koos päevapraadidega andmete uuendamiseks ja saad sama API käest küsida tänaseid päevapraade. Andmeid võiks saada küsida restorani, kuupäeva, asukoha või otsisõna/otsisõnaosa põhiselt. Selline teenus lihtsustaks ka toidukohtade päevapakkumiste haldamist, kuna praegu peavad teenuse pakkujad vastavat informatsiooni uuendama mitmes erinevas kohas - nii erinevates portaalides, kui ka enda veebileheküljel. Samuti oleks toidukohtade kogu menüü haldamine ühes kohas.<br />
<br />
[[File:TäisKõhtProto1.mp4]]<br />
<br />
Esialgne prototüüp: [http://enos.itcollege.ee/~saasma/VR2/Proto/K%C3%B5htT%C3%A4is/#g=1&p=home navigeeritav versioon]<br />
<br />
== Kasutatav arendustehnoloogia ==<br />
<br />
Veebiteenuse loomisel kasutame ASP.NET Core tehnoloogiat ja kursusel õpitud arendusmustreid.<br />
<br />
Klientrakenduse loomisel kasutame Node.js + React'i.<br />
<br />
== Veebiteenuse analüüs ==<br />
Pakume toidukohtade põhimenüüde ja päevapakkumiste teenust, kuhu on kokku koondatud erinevate toidukohtade menüüd üle Eesti. Põhimenüü alla kuuluvad pikaajalised menüüd, mis kehtivad püsivalt, hooajaliselt või mingil konkreetsel nädalapäeval. Päevapakkumiste alla kuuluvad konkreetse kuupäevaga seotud päevapakkumised. Päevapakkumiste korral kuvatakse lisainfona, kas pakkumine kehtib mingis konkreetses ajavahemikus või kogu toidukoha lahtioleku aja.<br />
<br />
Eesmärk on koguda ühte kohta kokku erinevate toidukohtade menüüd ja päevapakkumised, et kliendid saaksid mugavalt ja kiiresti oma valikuid teha. Kliendid käivad enamasti päevapakkumisi söömas lõuna ajal ja selleks ettenähtud aeg on piiratud. Sellepärast on oluline, et klient saaks teha oma valiku võimalikult kiiresti. Tänu loodavale veebiteenusele ei pea kliendid käima erinevates portaalides, et tutvuda erinevate toidukohtade pakkumistega. Kuna teenust on mugav kasutada ja klient saab oma valiku kiiresti tehtud, siis tõenäoliselt teeb klient valiku selles keskkonnas olevate toiduasutuste seast. Lisaks võimaldab teenus toiduasutustel paika panna oma pikaajalisem põhimenüü ning seda rakenduses ja võimalusel ka söögikohas kuvada. Sellepärast on ka toidukohtade huvi antud keskkonnas üleval olla ja meiega oma andmeid jagada, sest see suurendab nende klientuuri ning muudab oma menüü haldamise kergemaks.<br />
<br />
Veebiteenuse loomisel lähtume eelkõige sellest, et kliendil oleks teenust mugav kasutada ja ta saaks oma valiku kiiresti tehtud. Arvestame, et kliendid on erinevad. Mõni eelistab mõnda kindlat toidukohta, sel juhul saab ta valida oma soovitud kohad ja võrrelda nende kohtade tänase päeva pakkumisi ning menüüsid. Mõnele inimesele on oluline pakutav söök ja ta eelistab pakkumist otsida prae nimetuses oleva sõna või sõnaosa järgi ning lähtuda seejärel valiku tegemisel toidukoha keskmisest hindest või toidu hinnast. Mõne kliendi jaoks on oluline hind ja selleks, et oma valikut teha sobivas hinnavahemikus on tal võimalik sisestada maksimum hinna piirang. Kindlasti on antud teenuse juures kõikide klientide jaoks oluline päevapakkumiste asukohapõhine eristatus. Kliendid, kes soovivad oma konto luua, võivad oma eelistatud valikud meelde jätta ja järgmisel korral kuvatakse neid talle automaatselt.<br />
<br />
Teenuse must-have funktsionaalsus tagab teenuse toimimise ja põhifunktsioonid. Teenuse nice-to-have funktsionaalsus annab rakendusele lisandväärtust.<br />
<br />
Arvestades pakutava teenusega, siis näeme, et aktiivseim teenuse kasutamine võib olla tööpäevadel vahemikus 11.00-15.00, kui kliendid tutvuvad päevapakkumistega. Teenus peab tekkivale koormusele vastu pidama.<br />
<br />
Teenuse pakkumine peab olema turvaline. Selle tagamiseks tuleb sisestatavaid andmeid valideerida ja andmebaasi sisestavate andmete mahtu piirata. Toidukohtade sisestatud andmed peavad olema kaitstud, et toitude koostised ei saaks avalikuks. Põhjendatud juhtudel on võimalik kasutajaid lukku panna.<br />
<br />
== Kasutajad ==<br />
<br />
<br />
* Admin - lehe administraator, kellel on õigus lehte, kasutajaid ja nende õiguseid hallata. Tema huvi on, et teenus toimiks tõrgeteta.<br />
* Toiduasutus (tasuta kasutaja) - saab hoida lehel ühte põhimenüüd ja päevapakkumisi.<br />
* Toiduasutus (tellimusega kasutaja) - saab hoida lehel piiramatu arv põhimenüüsid ja päevapakkumisi.<br />
Toiduasutused on teenusest huvitatud, et nende menüüde haldamine oleks kerge ja mugav ning nad saaksid oma klientide arvu suurendada.<br />
* Külastaja - klient, kes valib söögikohta. Tema on huvitatud eelkõige sellest, et teenust saaks kasutada mugavalt ja kiirelt ning toidukohtade valik oleks võimalikult suur.<br />
<br />
== Rakenduse must-have funktsionaalsus ==<br />
<br />
* Kasutajad saavad sisse logida<br />
* Kasutajatel on erinevad rollid: admin, toidukoht (tasuta ja tasulise tellimusega), klient<br />
* Kasutajate arvepidamine kasutajate lõikes:<br />
** sisselogimise kuupäev, kellaaeg<br />
** pakkumiste lisamine<br />
** pakkumiste muutmine<br />
** pakkumiste kustutamine<br />
** õiguste kehtimise periood (tasuta ja tellimusega toidukoht)<br />
** pakkumistele klikkimise arv<br />
* Kasutajaid on võimalik hallata:<br />
** kasutajale õiguste andmine (menüüde arvu suurendamine, tellimusega toidukohal), rolli määramine<br />
** Kasutajat on võimalik piirata: õiguseid piirata (piiratud menüüde arv, tasuta liitunud toidukohal) ja lukku panna<br />
* Päevapakkumisi/menüüsid saab küsida: <br />
** toidukoha järgi, <br />
** kuupäeva põhiselt (ainult päevapakkumisi), <br />
** asukoha põhiselt,<br />
** toidu nimetuses esineva otsisõna/otsisõna osa põhiselt,<br />
** hinna põhiselt (max hinna piirang).<br />
* Klientrakenduses realiseeritakse CRUD meetodid (menüüsid/päevapakkumisi saab sisestada, lugeda, uuendada, kustutada)<br />
* Toidukohale saab anda hindeid ja kuvatakse keskmist hinnet.<br />
* Toidule saab anda hindeid ja kuvatakse keskmist hinnet.<br />
<br />
== Nice-to-have funktsionaalsus ==<br />
<br />
* Info selle kohta, kas päevapakkumine on otsas<br />
* Päevapakkumisi/menüüsid saab kommenteerida ja neid kommentaare kuvatakse avalikult.<br />
* Söögikohtade kodulehtedelt otsimise script, mis genereerib juba olemasolevate kodulehtede baasil päevamenüüsid.<br />
* Toiduvaliku piiramine allergeenide/vegan/jms. koostisosade põhiselt.<br />
* Aruandlused ja võrdlused toidukohtadele, et võrrelda end konkurentidega.<br />
* Teenus soovitab toidukohtadele nende varasemate päevapraadide populaarsuse alusel uue nädala menüüd.<br />
* Erinevad toidukohtade/toitude pingeread klientidele, et anda valikuteks ideid.<br />
* Soovitused klientidele, mida teised kliendid sarnaste eelistustega on veel valinud.<br />
<br />
== Andmebaasi ülesehitus ==<br />
<br />
[[File: BeerPressureAndmebaasimudel.png]]<br />
== Lõpptoote kasutusjuhend ==<br />
<br />
TODO<br />
<br />
<br />
== Logiraamat ==<br />
<br />
===07.02.2018===<br />
Gupi loomine ning suhtluskanali seadistamine<br />
<br />
=== 24.03.2018 ===<br />
Trello boardi loomine<br />
<br />
=== 25.03.2018 ===<br />
Wiki lehe loomine. Esimene tõsisem projekti koosolek ning tegevuskava paika panemine.<br />
<br />
=== 26.03.2018 ===<br />
<br />
Alustasime veebiteenuse analüüsiga ja funktsionaalsuse kirjeldamisega.<br />
<br />
=== 27.03.2018 ===<br />
Täiendasime veebiteenuse analüüsi.<br />
<br />
Esmase andmebaasi mudeli koostamine.<br />
<br />
Postitatud esimeste analüüsi arutelude põhjal valminud algne prototüüp.<br />
<br />
=== 30.03.2018 ===<br />
Valmis andmebaasimudel.</div>
Saasma
https://wiki.itcollege.ee/index.php?title=BeerPressure&diff=130319
BeerPressure
2018-04-08T10:23:31Z
<p>Saasma: /* Nice-to-have funktsionaalsus */</p>
<hr />
<div>== Meeskond ja rollid ==<br />
<br />
* Sigrid Aasma (arendaja)<br />
* Evelin Jõgi (arendaja)<br />
* Martin Kask (projektijuht, arendaja)<br />
* Marko Nõu (arendaja)<br />
<br />
== Idee ==<br />
'''Toidukohtade põhimenüüde ja päevapakkumiste teenus'''<br />
<br />
Soovime pakkuda toidukohtade põhimenüüde ja päevapakkumiste teenust. On olemas mitmeid kodulehti “päevapakkumised”, kus on kirjas toidukohtade päevapraed. Kuid tavaliselt sellistel lehtedel ei ole masinloetavaid andmeid ehk siis varianti, et saad saata API pihta mingi kuupäeva koos päevapraadidega andmete uuendamiseks ja saad sama API käest küsida tänaseid päevapraade. Andmeid võiks saada küsida restorani, kuupäeva, asukoha või otsisõna/otsisõnaosa põhiselt. Selline teenus lihtsustaks ka toidukohtade päevapakkumiste haldamist, kuna praegu peavad teenuse pakkujad vastavat informatsiooni uuendama mitmes erinevas kohas - nii erinevates portaalides, kui ka enda veebileheküljel. Samuti oleks toidukohtade kogu menüü haldamine ühes kohas.<br />
<br />
[[File:TäisKõhtProto1.mp4]]<br />
<br />
Esialgne prototüüp: [http://enos.itcollege.ee/~saasma/VR2/Proto/K%C3%B5htT%C3%A4is/#g=1&p=home navigeeritav versioon]<br />
<br />
== Kasutatav arendustehnoloogia ==<br />
<br />
Veebiteenuse loomisel kasutame ASP.NET MVC Web API tehnoloogiat ja kursusel õpitud arendusmustreid.<br />
<br />
Klientrakenduse loomisel kasutame Node.js + Angular/Backbone/React.<br />
<br />
== Veebiteenuse analüüs ==<br />
Pakume toidukohtade põhimenüüde ja päevapakkumiste teenust, kuhu on kokku koondatud erinevate toidukohtade menüüd üle Eesti. Põhimenüü alla kuuluvad pikaajalised menüüd, mis kehtivad püsivalt, hooajaliselt või mingil konkreetsel nädalapäeval. Päevapakkumiste alla kuuluvad konkreetse kuupäevaga seotud päevapakkumised. Päevapakkumiste korral kuvatakse lisainfona, kas pakkumine kehtib mingis konkreetses ajavahemikus või kogu toidukoha lahtioleku aja.<br />
<br />
Eesmärk on koguda ühte kohta kokku erinevate toidukohtade menüüd ja päevapakkumised, et kliendid saaksid mugavalt ja kiiresti oma valikuid teha. Kliendid käivad enamasti päevapakkumisi söömas lõuna ajal ja selleks ettenähtud aeg on piiratud. Sellepärast on oluline, et klient saaks teha oma valiku võimalikult kiiresti. Tänu loodavale veebiteenusele ei pea kliendid käima erinevates portaalides, et tutvuda erinevate toidukohtade pakkumistega. Kuna teenust on mugav kasutada ja klient saab oma valiku kiiresti tehtud, siis tõenäoliselt teeb klient valiku selles keskkonnas olevate toiduasutuste seast. Lisaks võimaldab teenus toiduasutustel paika panna oma pikaajalisem põhimenüü ning seda rakenduses ja võimalusel ka söögikohas kuvada. Sellepärast on ka toidukohtade huvi antud keskkonnas üleval olla ja meiega oma andmeid jagada, sest see suurendab nende klientuuri ning muudab oma menüü haldamise kergemaks.<br />
<br />
Veebiteenuse loomisel lähtume eelkõige sellest, et kliendil oleks teenust mugav kasutada ja ta saaks oma valiku kiiresti tehtud. Arvestame, et kliendid on erinevad. Mõni eelistab mõnda kindlat toidukohta, sel juhul saab ta valida oma soovitud kohad ja võrrelda nende kohtade tänase päeva pakkumisi ning menüüsid. Mõnele inimesele on oluline pakutav söök ja ta eelistab pakkumist otsida prae nimetuses oleva sõna või sõnaosa järgi ning lähtuda seejärel valiku tegemisel toidukoha keskmisest hindest või toidu hinnast. Mõne kliendi jaoks on oluline hind ja selleks, et oma valikut teha sobivas hinnavahemikus on tal võimalik sisestada maksimum hinna piirang. Kindlasti on antud teenuse juures kõikide klientide jaoks oluline päevapakkumiste asukohapõhine eristatus. Kliendid, kes soovivad oma konto luua, võivad oma eelistatud valikud meelde jätta ja järgmisel korral kuvatakse neid talle automaatselt.<br />
<br />
Teenuse must-have funktsionaalsus tagab teenuse toimimise ja põhifunktsioonid. Teenuse nice-to-have funktsionaalsus annab rakendusele lisandväärtust.<br />
<br />
Arvestades pakutava teenusega, siis näeme, et aktiivseim teenuse kasutamine võib olla tööpäevadel vahemikus 11.00-15.00, kui kliendid tutvuvad päevapakkumistega. Teenus peab tekkivale koormusele vastu pidama.<br />
<br />
Teenuse pakkumine peab olema turvaline. Selle tagamiseks tuleb sisestatavaid andmeid valideerida ja andmebaasi sisestavate andmete mahtu piirata. Toidukohtade sisestatud andmed peavad olema kaitstud, et toitude koostised ei saaks avalikuks. Põhjendatud juhtudel on võimalik kasutajaid lukku panna.<br />
<br />
== Kasutajad ==<br />
<br />
<br />
* Admin - lehe administraator, kellel on õigus lehte, kasutajaid ja nende õiguseid hallata. Tema huvi on, et teenus toimiks tõrgeteta.<br />
* Toiduasutus (tasuta kasutaja) - saab hoida lehel ühte põhimenüüd ja päevapakkumisi.<br />
* Toiduasutus (tellimusega kasutaja) - saab hoida lehel piiramatu arv põhimenüüsid ja päevapakkumisi.<br />
Toiduasutused on teenusest huvitatud, et nende menüüde haldamine oleks kerge ja mugav ning nad saaksid oma klientide arvu suurendada.<br />
* Külastaja - klient, kes valib söögikohta. Tema on huvitatud eelkõige sellest, et teenust saaks kasutada mugavalt ja kiirelt ning toidukohtade valik oleks võimalikult suur.<br />
<br />
== Rakenduse must-have funktsionaalsus ==<br />
<br />
* Kasutajad saavad sisse logida<br />
* Kasutajatel on erinevad rollid: admin, toidukoht (tasuta ja tasulise tellimusega), klient<br />
* Kasutajate arvepidamine kasutajate lõikes:<br />
** sisselogimise kuupäev, kellaaeg<br />
** pakkumiste lisamine<br />
** pakkumiste muutmine<br />
** pakkumiste kustutamine<br />
** õiguste kehtimise periood (tasuta ja tellimusega toidukoht)<br />
** pakkumistele klikkimise arv<br />
* Kasutajaid on võimalik hallata:<br />
** kasutajale õiguste andmine (menüüde arvu suurendamine, tellimusega toidukohal), rolli määramine<br />
** Kasutajat on võimalik piirata: õiguseid piirata (piiratud menüüde arv, tasuta liitunud toidukohal) ja lukku panna<br />
* Päevapakkumisi/menüüsid saab küsida: <br />
** toidukoha järgi, <br />
** kuupäeva põhiselt (ainult päevapakkumisi), <br />
** asukoha põhiselt,<br />
** toidu nimetuses esineva otsisõna/otsisõna osa põhiselt,<br />
** hinna põhiselt (max hinna piirang).<br />
* Klientrakenduses realiseeritakse CRUD meetodid (menüüsid/päevapakkumisi saab sisestada, lugeda, uuendada, kustutada)<br />
* Toidukohale saab anda hindeid ja kuvatakse keskmist hinnet.<br />
* Toidule saab anda hindeid ja kuvatakse keskmist hinnet.<br />
<br />
== Nice-to-have funktsionaalsus ==<br />
<br />
* Info selle kohta, kas päevapakkumine on otsas<br />
* Päevapakkumisi/menüüsid saab kommenteerida ja neid kommentaare kuvatakse avalikult.<br />
* Söögikohtade kodulehtedelt otsimise script, mis genereerib juba olemasolevate kodulehtede baasil päevamenüüsid.<br />
* Toiduvaliku piiramine allergeenide/vegan/jms. koostisosade põhiselt.<br />
* Aruandlused ja võrdlused toidukohtadele, et võrrelda end konkurentidega.<br />
* Teenus soovitab toidukohtadele nende varasemate päevapraadide populaarsuse alusel uue nädala menüüd.<br />
* Erinevad toidukohtade/toitude pingeread klientidele, et anda valikuteks ideid.<br />
* Soovitused klientidele, mida teised kliendid sarnaste eelistustega on veel valinud.<br />
<br />
== Andmebaasi ülesehitus ==<br />
<br />
[[File: BeerPressureAndmebaasimudel.png]]<br />
== Lõpptoote kasutusjuhend ==<br />
<br />
TODO<br />
<br />
<br />
== Logiraamat ==<br />
<br />
===07.02.2018===<br />
Gupi loomine ning suhtluskanali seadistamine<br />
<br />
=== 24.03.2018 ===<br />
Trello boardi loomine<br />
<br />
=== 25.03.2018 ===<br />
Wiki lehe loomine. Esimene tõsisem projekti koosolek ning tegevuskava paika panemine.<br />
<br />
=== 26.03.2018 ===<br />
<br />
Alustasime veebiteenuse analüüsiga ja funktsionaalsuse kirjeldamisega.<br />
<br />
=== 27.03.2018 ===<br />
Täiendasime veebiteenuse analüüsi.<br />
<br />
Esmase andmebaasi mudeli koostamine.<br />
<br />
Postitatud esimeste analüüsi arutelude põhjal valminud algne prototüüp.<br />
<br />
=== 30.03.2018 ===<br />
Valmis andmebaasimudel.</div>
Saasma
https://wiki.itcollege.ee/index.php?title=BeerPressure&diff=130318
BeerPressure
2018-04-08T10:23:22Z
<p>Saasma: /* Rakenduse must-have funktsionaalsus */</p>
<hr />
<div>== Meeskond ja rollid ==<br />
<br />
* Sigrid Aasma (arendaja)<br />
* Evelin Jõgi (arendaja)<br />
* Martin Kask (projektijuht, arendaja)<br />
* Marko Nõu (arendaja)<br />
<br />
== Idee ==<br />
'''Toidukohtade põhimenüüde ja päevapakkumiste teenus'''<br />
<br />
Soovime pakkuda toidukohtade põhimenüüde ja päevapakkumiste teenust. On olemas mitmeid kodulehti “päevapakkumised”, kus on kirjas toidukohtade päevapraed. Kuid tavaliselt sellistel lehtedel ei ole masinloetavaid andmeid ehk siis varianti, et saad saata API pihta mingi kuupäeva koos päevapraadidega andmete uuendamiseks ja saad sama API käest küsida tänaseid päevapraade. Andmeid võiks saada küsida restorani, kuupäeva, asukoha või otsisõna/otsisõnaosa põhiselt. Selline teenus lihtsustaks ka toidukohtade päevapakkumiste haldamist, kuna praegu peavad teenuse pakkujad vastavat informatsiooni uuendama mitmes erinevas kohas - nii erinevates portaalides, kui ka enda veebileheküljel. Samuti oleks toidukohtade kogu menüü haldamine ühes kohas.<br />
<br />
[[File:TäisKõhtProto1.mp4]]<br />
<br />
Esialgne prototüüp: [http://enos.itcollege.ee/~saasma/VR2/Proto/K%C3%B5htT%C3%A4is/#g=1&p=home navigeeritav versioon]<br />
<br />
== Kasutatav arendustehnoloogia ==<br />
<br />
Veebiteenuse loomisel kasutame ASP.NET MVC Web API tehnoloogiat ja kursusel õpitud arendusmustreid.<br />
<br />
Klientrakenduse loomisel kasutame Node.js + Angular/Backbone/React.<br />
<br />
== Veebiteenuse analüüs ==<br />
Pakume toidukohtade põhimenüüde ja päevapakkumiste teenust, kuhu on kokku koondatud erinevate toidukohtade menüüd üle Eesti. Põhimenüü alla kuuluvad pikaajalised menüüd, mis kehtivad püsivalt, hooajaliselt või mingil konkreetsel nädalapäeval. Päevapakkumiste alla kuuluvad konkreetse kuupäevaga seotud päevapakkumised. Päevapakkumiste korral kuvatakse lisainfona, kas pakkumine kehtib mingis konkreetses ajavahemikus või kogu toidukoha lahtioleku aja.<br />
<br />
Eesmärk on koguda ühte kohta kokku erinevate toidukohtade menüüd ja päevapakkumised, et kliendid saaksid mugavalt ja kiiresti oma valikuid teha. Kliendid käivad enamasti päevapakkumisi söömas lõuna ajal ja selleks ettenähtud aeg on piiratud. Sellepärast on oluline, et klient saaks teha oma valiku võimalikult kiiresti. Tänu loodavale veebiteenusele ei pea kliendid käima erinevates portaalides, et tutvuda erinevate toidukohtade pakkumistega. Kuna teenust on mugav kasutada ja klient saab oma valiku kiiresti tehtud, siis tõenäoliselt teeb klient valiku selles keskkonnas olevate toiduasutuste seast. Lisaks võimaldab teenus toiduasutustel paika panna oma pikaajalisem põhimenüü ning seda rakenduses ja võimalusel ka söögikohas kuvada. Sellepärast on ka toidukohtade huvi antud keskkonnas üleval olla ja meiega oma andmeid jagada, sest see suurendab nende klientuuri ning muudab oma menüü haldamise kergemaks.<br />
<br />
Veebiteenuse loomisel lähtume eelkõige sellest, et kliendil oleks teenust mugav kasutada ja ta saaks oma valiku kiiresti tehtud. Arvestame, et kliendid on erinevad. Mõni eelistab mõnda kindlat toidukohta, sel juhul saab ta valida oma soovitud kohad ja võrrelda nende kohtade tänase päeva pakkumisi ning menüüsid. Mõnele inimesele on oluline pakutav söök ja ta eelistab pakkumist otsida prae nimetuses oleva sõna või sõnaosa järgi ning lähtuda seejärel valiku tegemisel toidukoha keskmisest hindest või toidu hinnast. Mõne kliendi jaoks on oluline hind ja selleks, et oma valikut teha sobivas hinnavahemikus on tal võimalik sisestada maksimum hinna piirang. Kindlasti on antud teenuse juures kõikide klientide jaoks oluline päevapakkumiste asukohapõhine eristatus. Kliendid, kes soovivad oma konto luua, võivad oma eelistatud valikud meelde jätta ja järgmisel korral kuvatakse neid talle automaatselt.<br />
<br />
Teenuse must-have funktsionaalsus tagab teenuse toimimise ja põhifunktsioonid. Teenuse nice-to-have funktsionaalsus annab rakendusele lisandväärtust.<br />
<br />
Arvestades pakutava teenusega, siis näeme, et aktiivseim teenuse kasutamine võib olla tööpäevadel vahemikus 11.00-15.00, kui kliendid tutvuvad päevapakkumistega. Teenus peab tekkivale koormusele vastu pidama.<br />
<br />
Teenuse pakkumine peab olema turvaline. Selle tagamiseks tuleb sisestatavaid andmeid valideerida ja andmebaasi sisestavate andmete mahtu piirata. Toidukohtade sisestatud andmed peavad olema kaitstud, et toitude koostised ei saaks avalikuks. Põhjendatud juhtudel on võimalik kasutajaid lukku panna.<br />
<br />
== Kasutajad ==<br />
<br />
<br />
* Admin - lehe administraator, kellel on õigus lehte, kasutajaid ja nende õiguseid hallata. Tema huvi on, et teenus toimiks tõrgeteta.<br />
* Toiduasutus (tasuta kasutaja) - saab hoida lehel ühte põhimenüüd ja päevapakkumisi.<br />
* Toiduasutus (tellimusega kasutaja) - saab hoida lehel piiramatu arv põhimenüüsid ja päevapakkumisi.<br />
Toiduasutused on teenusest huvitatud, et nende menüüde haldamine oleks kerge ja mugav ning nad saaksid oma klientide arvu suurendada.<br />
* Külastaja - klient, kes valib söögikohta. Tema on huvitatud eelkõige sellest, et teenust saaks kasutada mugavalt ja kiirelt ning toidukohtade valik oleks võimalikult suur.<br />
<br />
== Rakenduse must-have funktsionaalsus ==<br />
<br />
* Kasutajad saavad sisse logida<br />
* Kasutajatel on erinevad rollid: admin, toidukoht (tasuta ja tasulise tellimusega), klient<br />
* Kasutajate arvepidamine kasutajate lõikes:<br />
** sisselogimise kuupäev, kellaaeg<br />
** pakkumiste lisamine<br />
** pakkumiste muutmine<br />
** pakkumiste kustutamine<br />
** õiguste kehtimise periood (tasuta ja tellimusega toidukoht)<br />
** pakkumistele klikkimise arv<br />
* Kasutajaid on võimalik hallata:<br />
** kasutajale õiguste andmine (menüüde arvu suurendamine, tellimusega toidukohal), rolli määramine<br />
** Kasutajat on võimalik piirata: õiguseid piirata (piiratud menüüde arv, tasuta liitunud toidukohal) ja lukku panna<br />
* Päevapakkumisi/menüüsid saab küsida: <br />
** toidukoha järgi, <br />
** kuupäeva põhiselt (ainult päevapakkumisi), <br />
** asukoha põhiselt,<br />
** toidu nimetuses esineva otsisõna/otsisõna osa põhiselt,<br />
** hinna põhiselt (max hinna piirang).<br />
* Klientrakenduses realiseeritakse CRUD meetodid (menüüsid/päevapakkumisi saab sisestada, lugeda, uuendada, kustutada)<br />
* Toidukohale saab anda hindeid ja kuvatakse keskmist hinnet.<br />
* Toidule saab anda hindeid ja kuvatakse keskmist hinnet.<br />
<br />
== Nice-to-have funktsionaalsus ==<br />
<br />
* Info selle kohta, kas päevapakkumine on otsas<br />
* Toidukohale saab anda hindeid ja kuvatakse keskmist hinnet.<br />
* Toidule saab anda hindeid ja kuvatakse keskmist hinnet.<br />
* Päevapakkumisi/menüüsid saab kommenteerida ja neid kommentaare kuvatakse avalikult.<br />
* Söögikohtade kodulehtedelt otsimise script, mis genereerib juba olemasolevate kodulehtede baasil päevamenüüsid.<br />
* Toiduvaliku piiramine allergeenide/vegan/jms. koostisosade põhiselt.<br />
* Aruandlused ja võrdlused toidukohtadele, et võrrelda end konkurentidega.<br />
* Teenus soovitab toidukohtadele nende varasemate päevapraadide populaarsuse alusel uue nädala menüüd.<br />
* Erinevad toidukohtade/toitude pingeread klientidele, et anda valikuteks ideid.<br />
* Soovitused klientidele, mida teised kliendid sarnaste eelistustega on veel valinud.<br />
<br />
== Andmebaasi ülesehitus ==<br />
<br />
[[File: BeerPressureAndmebaasimudel.png]]<br />
== Lõpptoote kasutusjuhend ==<br />
<br />
TODO<br />
<br />
<br />
== Logiraamat ==<br />
<br />
===07.02.2018===<br />
Gupi loomine ning suhtluskanali seadistamine<br />
<br />
=== 24.03.2018 ===<br />
Trello boardi loomine<br />
<br />
=== 25.03.2018 ===<br />
Wiki lehe loomine. Esimene tõsisem projekti koosolek ning tegevuskava paika panemine.<br />
<br />
=== 26.03.2018 ===<br />
<br />
Alustasime veebiteenuse analüüsiga ja funktsionaalsuse kirjeldamisega.<br />
<br />
=== 27.03.2018 ===<br />
Täiendasime veebiteenuse analüüsi.<br />
<br />
Esmase andmebaasi mudeli koostamine.<br />
<br />
Postitatud esimeste analüüsi arutelude põhjal valminud algne prototüüp.<br />
<br />
=== 30.03.2018 ===<br />
Valmis andmebaasimudel.</div>
Saasma
https://wiki.itcollege.ee/index.php?title=BeerPressure&diff=129789
BeerPressure
2018-03-27T06:26:58Z
<p>Saasma: /* Idee */</p>
<hr />
<div>== Meeskond ja rollid ==<br />
<br />
* Sigrid Aasma<br />
* Evelin Jõgi<br />
* Martin Kask<br />
* Marko Nõu<br />
<br />
== Idee ==<br />
'''Päevapakkumiste teenus'''<br />
<br />
On päris mitu kodulehte ‘päevapakkumised’ kus kirjas toidukohtade päevapraed jms. mida sellistel lehtedel pole, on masiloetavad andmed ehk siis variant, et saad saata API pihta mingi kuupäeva koos päevapraadidega<br />
ja saad sama API käest küsida tänased päevapraed kas firma, kuupäeva või asukoha põhiselt. Selline teenus lihtsustaks ka toidukohtade päevapakkumiste haldamist, kuna praegu peavad nad vastavat informatsiooni uuendama mitmes erinevas kohas - nii portaalides, kui ka enda leheküljel.<br />
<br />
[[File:TäisKõhtProto1.mp4]]<br />
<br />
Esialgne prototüüp: [http://enos.itcollege.ee/~saasma/VR2/Proto/K%C3%B5htT%C3%A4is/#g=1&p=home navigeeritav versioon]<br />
<br />
Projekti TFS: TODO<br />
<br />
'''Analüüs''' <br />
TODO<br />
<br />
'''Meie kirjutatud retsensioon'''<br />
TODO<br />
<br />
'''Meie kirjutatud lõpptoote retsensioon'''<br />
TODO<br />
<br />
Projekti Prototüüp:<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
== Lõpptoote kasutusjuhend ==<br />
<br />
TODO<br />
<br />
== Rakenduse must-have sisu ==<br />
<br />
TODO<br />
<br />
== Nice-to-have lisad ==<br />
<br />
TODO<br />
<br />
== Logiraamat ==<br />
<br />
===07.02.2018===<br />
Gupi loomine ning suhtluskanali seadistamine<br />
<br />
=== 24.03.2018 ===<br />
Trello boardi loomine<br />
<br />
=== 25.03.2018 ===<br />
Wiki lehe loomine. Esimene tõsisem projekti koosolek ning tegevuskava paika panemine.<br />
<br />
=== 27.03.2018 ===<br />
Postitatud esimeste analüüsi arutelute põhjal valminud algne prototüüp</div>
Saasma
https://wiki.itcollege.ee/index.php?title=BeerPressure&diff=129788
BeerPressure
2018-03-27T06:25:46Z
<p>Saasma: /* 25.03.2018 */</p>
<hr />
<div>== Meeskond ja rollid ==<br />
<br />
* Sigrid Aasma<br />
* Evelin Jõgi<br />
* Martin Kask<br />
* Marko Nõu<br />
<br />
== Idee ==<br />
'''Päevapakkumiste teenus'''<br />
<br />
On päris mitu kodulehte ‘päevapakkumised’ kus kirjas toidukohtade päevapraed jms. mida sellistel lehtedel pole, on masiloetavad andmed ehk siis variant, et saad saata API pihta mingi kuupäeva koos päevapraadidega<br />
ja saad sama API käest küsida tänased päevapraed kas firma, kuupäeva või asukoha põhiselt. Selline teenus lihtsustaks ka toidukohtade päevapakkumiste haldamist, kuna praegu peavad nad vastavat informatsiooni uuendama mitmes erinevas kohas - nii portaalides, kui ka enda leheküljel.<br />
<br />
[[File:TäisKõhtProto1.mp4]]<br />
<br />
Esialgne prototüüp<br />
<br />
Projekti TFS: TODO<br />
<br />
'''Analüüs''' <br />
TODO<br />
<br />
'''Meie kirjutatud retsensioon'''<br />
TODO<br />
<br />
'''Meie kirjutatud lõpptoote retsensioon'''<br />
TODO<br />
<br />
Projekti Prototüüp:<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
== Lõpptoote kasutusjuhend ==<br />
<br />
TODO<br />
<br />
== Rakenduse must-have sisu ==<br />
<br />
TODO<br />
<br />
== Nice-to-have lisad ==<br />
<br />
TODO<br />
<br />
== Logiraamat ==<br />
<br />
===07.02.2018===<br />
Gupi loomine ning suhtluskanali seadistamine<br />
<br />
=== 24.03.2018 ===<br />
Trello boardi loomine<br />
<br />
=== 25.03.2018 ===<br />
Wiki lehe loomine. Esimene tõsisem projekti koosolek ning tegevuskava paika panemine.<br />
<br />
=== 27.03.2018 ===<br />
Postitatud esimeste analüüsi arutelute põhjal valminud algne prototüüp</div>
Saasma
https://wiki.itcollege.ee/index.php?title=BeerPressure&diff=129787
BeerPressure
2018-03-27T06:24:20Z
<p>Saasma: /* Idee */</p>
<hr />
<div>== Meeskond ja rollid ==<br />
<br />
* Sigrid Aasma<br />
* Evelin Jõgi<br />
* Martin Kask<br />
* Marko Nõu<br />
<br />
== Idee ==<br />
'''Päevapakkumiste teenus'''<br />
<br />
On päris mitu kodulehte ‘päevapakkumised’ kus kirjas toidukohtade päevapraed jms. mida sellistel lehtedel pole, on masiloetavad andmed ehk siis variant, et saad saata API pihta mingi kuupäeva koos päevapraadidega<br />
ja saad sama API käest küsida tänased päevapraed kas firma, kuupäeva või asukoha põhiselt. Selline teenus lihtsustaks ka toidukohtade päevapakkumiste haldamist, kuna praegu peavad nad vastavat informatsiooni uuendama mitmes erinevas kohas - nii portaalides, kui ka enda leheküljel.<br />
<br />
[[File:TäisKõhtProto1.mp4]]<br />
<br />
Esialgne prototüüp<br />
<br />
Projekti TFS: TODO<br />
<br />
'''Analüüs''' <br />
TODO<br />
<br />
'''Meie kirjutatud retsensioon'''<br />
TODO<br />
<br />
'''Meie kirjutatud lõpptoote retsensioon'''<br />
TODO<br />
<br />
Projekti Prototüüp:<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
== Lõpptoote kasutusjuhend ==<br />
<br />
TODO<br />
<br />
== Rakenduse must-have sisu ==<br />
<br />
TODO<br />
<br />
== Nice-to-have lisad ==<br />
<br />
TODO<br />
<br />
== Logiraamat ==<br />
<br />
===07.02.2018===<br />
Gupi loomine ning suhtluskanali seadistamine<br />
<br />
=== 24.03.2018 ===<br />
Trello boardi loomine<br />
<br />
=== 25.03.2018 ===<br />
Wiki lehe loomine. Esimene tõsisem projekti koosolek ning tegevuskava paika panemine.</div>
Saasma
https://wiki.itcollege.ee/index.php?title=BeerPressure&diff=129786
BeerPressure
2018-03-27T06:23:32Z
<p>Saasma: </p>
<hr />
<div>== Meeskond ja rollid ==<br />
<br />
* Sigrid Aasma<br />
* Evelin Jõgi<br />
* Martin Kask<br />
* Marko Nõu<br />
<br />
== Idee ==<br />
'''Päevapakkumiste teenus'''<br />
<br />
On päris mitu kodulehte ‘päevapakkumised’ kus kirjas toidukohtade päevapraed jms. mida sellistel lehtedel pole, on masiloetavad andmed ehk siis variant, et saad saata API pihta mingi kuupäeva koos päevapraadidega<br />
ja saad sama API käest küsida tänased päevapraed kas firma, kuupäeva või asukoha põhiselt. Selline teenus lihtsustaks ka toidukohtade päevapakkumiste haldamist, kuna praegu peavad nad vastavat informatsiooni uuendama mitmes erinevas kohas - nii portaalides, kui ka enda leheküljel.<br />
<br />
[[File:TäisKõhtProto1.mp4]]<br />
Esialgne prototüüp<br />
<br />
Projekti TFS: TODO<br />
<br />
'''Analüüs''' <br />
TODO<br />
<br />
'''Meie kirjutatud retsensioon'''<br />
TODO<br />
<br />
'''Meie kirjutatud lõpptoote retsensioon'''<br />
TODO<br />
<br />
Projekti Prototüüp:<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
== Lõpptoote kasutusjuhend ==<br />
<br />
TODO<br />
<br />
== Rakenduse must-have sisu ==<br />
<br />
TODO<br />
<br />
== Nice-to-have lisad ==<br />
<br />
TODO<br />
<br />
== Logiraamat ==<br />
<br />
===07.02.2018===<br />
Gupi loomine ning suhtluskanali seadistamine<br />
<br />
=== 24.03.2018 ===<br />
Trello boardi loomine<br />
<br />
=== 25.03.2018 ===<br />
Wiki lehe loomine. Esimene tõsisem projekti koosolek ning tegevuskava paika panemine.</div>
Saasma
https://wiki.itcollege.ee/index.php?title=File:T%C3%A4isK%C3%B5htProto1.mp4&diff=129785
File:TäisKõhtProto1.mp4
2018-03-27T06:21:51Z
<p>Saasma: </p>
<hr />
<div></div>
Saasma
https://wiki.itcollege.ee/index.php?title=Talk:FoodBytes&diff=117568
Talk:FoodBytes
2017-02-01T19:33:56Z
<p>Saasma: </p>
<hr />
<div>=Retsensioon meeskond FoodBytes projektile=<br />
Koostanud:[[Meeskond: Elekter (Sigrid Aasma, Kristo Oidermaa ja Tiit Post)]]<br />
<br />
==Analüüsi retsensioon==<br />
<br />
FoodBytes rakenduse idee on hästi selgitatud ning retseptiraamatu funktsionaalsus on piisavalt arusaadav välisele lugejale. Positiivne on ka see, et andmebaasi struktuuri peale on mõeldud, mille põhjal saab juba rakendada funktsionaalsusi, mis on projekti “Must have” nimekirjas. Erinevate tabelite seosed on läbimõeldud ning võimaldab siduda retsepte kategooriate ja koostisosadega.<br />
<br />
<br />
Küll aga on tabelite nimetused natuke segased. Loogiline tunduks tabel, mis jätaks välja sõna “toiduaine”, kuna koostisosa ning toiduaine on üks ja sama asi. Pakuks allolevat struktuuri Retseptide, Toiduaine ning Koostise tabelite asemele, mille puhul on RetseptiKoostisosad vaid siduva tabeli rollis ja ei ole vaja juurde tuua uut terminit.<br />
<br />
<br />
* Retseptid (RetseptID, retseptinimi, kirjeldus, juhend, kuupäev, kasutaja_id, kategooria_id, (pilt_id))<br />
* Koostisosad (KoostisosaID, koostisosa)<br />
* RetseptiKoostisosad (RetseptID, KoostisosaID, kogus, yhik_id)<br />
<br />
<br />
Rakenduse ägedamaks muutmiseks võiks olla võimalus ka retsepti lisamise juures lisada tehtud toidu pilt nagu netiblogides või kokaraamatutes. Inimesed söövad ju eelkõige silmadega. Võiks lisada selle võimaluse “nice to have” funktsionaalsuse juurde.<br />
<br />
<br />
Tekkis mõttekoht seoses kasutajate lisamise ja kontode loomisega. Kuna rakendus on mõeldud koduseks kasutamiseks arvutis, siis näib paroolide loomine kontodele liialdusena. Piisaks ju lihtsalt kui rakenduse kasutaja saab valida või muuta, kes ta täpsemalt on. Samuti kui vaadata ainult “must have” funktsionaalsust, siis ei läheks kasutajate registreerimist ja paroolide haldust jne vaja. Piisab lihtsalt kui retseptiautoriks märkida kellegi nimi.<br />
<br />
Teine idee oleks eraldada toitumispäeviku/ajaloo jälgimine retseptide küljest ja vast siduda see otseselt kasutajaga. Ehk siis andmebaasis “tehtud” tabel paikneks kasutaja küljes ja seal oleks lisaks ka kasutajaId, mis võimaldaks üpriski kiiresti otsida hiljem, et mis retsepte kasutaja on teinud ja nii toitumispäevikut kuvada.<br />
<br />
==Lõpp-produkti retsensioon==<br />
Koostanud:[[Meeskond: Elekter (Sigrid Aasma, Kristo Oidermaa ja Tiit Post)]]<br />
<br />
Retsensiooni üldmulje on see, et paljude plaanitud funktsionaalsustega ei jõudnud meeskond valmis, kuna analüüsi põhjal tundus, et plaanid olid palju suuremad. Rakendus on lihtne ja väikese korrigeerimise järel saab seda ka edukalt kasutada retseptide loomiseks, vaatamiseks ja kustutamiseks (mõningate ebamugavustega). Kahju, et funktsionaalsusi, mida me lootsime näha ei ole tehtud (piltide lisamine ja paroolide ära jätmine), kuid eks need olid ka soovituslikud ettepanekud. <br />
<br />
Toome allpool välja mõned põhilised punktid, mida tähele panime.<br />
<br />
===Plussid===<br />
<br />
* Kood kompileerub.<br />
* Lihtne disain, less is more<br />
* Error check on implementeeritud, retsepte saab avada iga inimene, kuid neid võib kustutada vaid originaalne looja. Ilma sisse logimata ei saa retsepte lisada.<br />
* Kasutatud on MVVM arhitektuuri, kus on eraldatud objektid, päringud, äriloogika ja esitlus (viimase kahe sisu on veidikene segamini).<br />
* Retseptide lisamine ja kustutamine toimib.<br />
* Andmebaas tundub mõistliku struktuuriga (antud funktsionaalsuste juures).<br />
<br />
===Miinused===<br />
* Ei saa lisada uut kasutajat (üritab NULL väärtust salvestada kasutaja tabelis).<br />
* Ei saa vaadata looduid retsepte ilma otsimata<br />
* Saab otsida vaid nime järgi (mitte kategooria järgi nagu eesmärkides)<br />
* Retsepti lisamisel lisatakse “yhik”, “kategooria” tabelitesse uued väljad ka mitteunikaalsete väärtuste puhul, mis ei anna eraldi tabelitele eraldi otstarbekust<br />
* Loodud retsepti ei saa avada (vea tekitab vigane ühiku kuvamine retseptis, töötab ilma ühiku kuvamiseta), lohiseva koodi tõttu on raske kindlaks teha, mida üldse üritatakse võrdsustada Textblcokiga txtblck2, mis antud juhul ka retsepti avamist takistab (ära tuleb kaotada +1 variablist findyhik).<br />
* Retsepte ei saa muuta, peab uuesti looma.<br />
* Välja logides jätab nii kasutajanime kui ka paroolivälja täidetuks<br />
* Kakskeelsus ja segased nimetused koodis (eesti ja inglise keel) <br />
<br />
===Soovitused===<br />
* Kas koostisosade puhul on vajalik, et kasutaja ise lisab teksti? Kui tabelisse lisataks unikaalsed väärtused, oleks efektiivsem anda rippmenüüst kasutajatele ette valik, mida lisada<br />
* Sisse logituna võiks ära kaotada nupu nagu “registreeri uus kasutaja”<br />
* Loetavuse mõttes kasutada paremini namespace'i näiteks Service klassides (using FoodBytes.BusinessObjects)<br />
* Disain on selge, kuid võiks olla viimistletum. Disainielemente on väga vähe, mis informatsiooni paremini esile tooksid.<br />
<br />
===Kokkuvõte===<br />
<br />
Kuigi põhifunksionaalsused on saavutatud, projekt on struktureeritud MVVM arhitektuuriga, andmebaas on selgete omadustega ja programmi üldpildist on kerge aru saada, jääb projekt natukene lahjaks. Programmi seadistamiseks on vaja luua kohalik andmebaas etteantud scriptiga ning enamus funktsionaalsusi pole üldse võimalik kasutada, sest hetkeseisuga ei õnnestu programmil edukalt uut kasutajat andmebaasi lisada. Seda tuleb teha käsitsi. Samuti üks suurimaid programmi omadusi peaks olema see, et kasutajad saavad lihtsa vaevaga vaadata kasutajate loodud retsepte. Hetkel saab neid vaadata ainult siis, kui retsepti nimi on meeles ja seda Otsinguribalt otsida. Retsepte pole võimalik avada, kui just ei kommenteeri välja ühikute kuvamist või ei paranda koodis viga. <br />
<br />
Vaatamata projekti struktuurist ja paljudest meetoditest, tekib segadust ViewModeli ja View külje peal. Meetodid on lohisevad ning liiga palju koodi pesitseb just WPF poole peal, mitte ViewModel poole peal. <br />
<br />
Programmil on palju potentsiaali, kuna idee on hea ja retsepti lisamine andmebaasi töötab. Samuti on ka projekti struktuur paigas, mis vajab korrigeerimist View ja ViewModeli poole pealt. Korda tuleks teha ka vead, mis takistavad programmil töötamast nagu uue kasutaja lisamine ning retsepti avamine (ühiku kuvamine).</div>
Saasma
https://wiki.itcollege.ee/index.php?title=Talk:FoodBytes&diff=117565
Talk:FoodBytes
2017-02-01T19:26:25Z
<p>Saasma: </p>
<hr />
<div>=Retsensioon meeskond FoodBytes projektile=<br />
Koostanud:[[Meeskond: Elekter (Sigrid Aasma, Kristo Oidermaa ja Tiit Post)]]<br />
<br />
==Analüüsi retsensioon==<br />
<br />
FoodBytes rakenduse idee on hästi selgitatud ning retseptiraamatu funktsionaalsus on piisavalt arusaadav välisele lugejale. Positiivne on ka see, et andmebaasi struktuuri peale on mõeldud, mille põhjal saab juba rakendada funktsionaalsusi, mis on projekti “Must have” nimekirjas. Erinevate tabelite seosed on läbimõeldud ning võimaldab siduda retsepte kategooriate ja koostisosadega.<br />
<br />
<br />
Küll aga on tabelite nimetused natuke segased. Loogiline tunduks tabel, mis jätaks välja sõna “toiduaine”, kuna koostisosa ning toiduaine on üks ja sama asi. Pakuks allolevat struktuuri Retseptide, Toiduaine ning Koostise tabelite asemele, mille puhul on RetseptiKoostisosad vaid siduva tabeli rollis ja ei ole vaja juurde tuua uut terminit.<br />
<br />
<br />
* Retseptid (RetseptID, retseptinimi, kirjeldus, juhend, kuupäev, kasutaja_id, kategooria_id, (pilt_id))<br />
* Koostisosad (KoostisosaID, koostisosa)<br />
* RetseptiKoostisosad (RetseptID, KoostisosaID, kogus, yhik_id)<br />
<br />
<br />
Rakenduse ägedamaks muutmiseks võiks olla võimalus ka retsepti lisamise juures lisada tehtud toidu pilt nagu netiblogides või kokaraamatutes. Inimesed söövad ju eelkõige silmadega. Võiks lisada selle võimaluse “nice to have” funktsionaalsuse juurde.<br />
<br />
<br />
Tekkis mõttekoht seoses kasutajate lisamise ja kontode loomisega. Kuna rakendus on mõeldud koduseks kasutamiseks arvutis, siis näib paroolide loomine kontodele liialdusena. Piisaks ju lihtsalt kui rakenduse kasutaja saab valida või muuta, kes ta täpsemalt on. Samuti kui vaadata ainult “must have” funktsionaalsust, siis ei läheks kasutajate registreerimist ja paroolide haldust jne vaja. Piisab lihtsalt kui retseptiautoriks märkida kellegi nimi.<br />
<br />
Teine idee oleks eraldada toitumispäeviku/ajaloo jälgimine retseptide küljest ja vast siduda see otseselt kasutajaga. Ehk siis andmebaasis “tehtud” tabel paikneks kasutaja küljes ja seal oleks lisaks ka kasutajaId, mis võimaldaks üpriski kiiresti otsida hiljem, et mis retsepte kasutaja on teinud ja nii toitumispäevikut kuvada.<br />
<br />
==Lõpp-produkti retsensioon==<br />
Koostanud:[[Meeskond: Elekter (Sigrid Aasma, Kristo Oidermaa ja Tiit Post)]]<br />
<br />
Retsensiooni üldmulje on see, et paljude plaanitud funktsionaalsustega ei jõudnud meeskond valmis, kuna analüüsi põhjal tundus, et plaanid olid palju suuremad. Rakendus on lihtne ja väikese korrigeerimise järjel saab seda ka edukalt kasutada retseptide loomiseks, vaatamiseks ja kustutamiseks (mõningate ebamugavustega). Kahju, et funktsionaalsusi, mida me lootsime näha ei ole tehtud (piltide lisamine ja paroolide ära jätmine), kuid eks need olid ka soovituslikud ettepanekud. <br />
<br />
Toome allpool välja mõned põhilised punktid, mida tähele panime.<br />
<br />
===Plussid===<br />
<br />
* Kood kompileerub.<br />
* Lihtne disain, less is more<br />
* Error check on implementeeritud, retsepte saab avada iga inimene, kuid neid võib kustutada vaid originaalne looja. Ilma sisse logimata ei saa retsepte lisada.<br />
* Kasutatud on MVVM arhitektuuri, kus on eraldatud objektid, päringud, äriloogika ja esitlus (viimase kahe sisu on veidikene segamini).<br />
* Retseptide lisamine ja kustutamine toimib.<br />
* Andmebaas tundub mõistliku struktuuriga (antud funktsionaalsuste juures).<br />
<br />
===Miinused===<br />
* Ei saa lisada uut kasutajat (üritab NULL väärtust salvestada kasutaja tabelis).<br />
* Ei saa vaadata looduid retsepte ilma otsimata<br />
* Saab otsida vaid nime järgi (mitte kategooria järgi nagu eesmärkides)<br />
* Retsepti lisamisel lisatakse “yhik”, “kategooria” tabelitesse uued väljad ka mitteunikaalsete väärtuste puhul, mis ei anna eraldi tabelitele eraldi otstarbekust<br />
* Loodud retsepti ei saa avada (vea tekitab vigane ühiku kuvamine retseptis, töötab ilma ühiku kuvamiseta), lohiseva koodi tõttu on raske kindlaks teha, mida üldse üritatakse võrdsustada Textblcokiga txtblck2, mis antud juhul ka retsepti avamist takistab (ära tuleb kaotada +1 variablist findyhik).<br />
* Retsepte ei saa muuta, peab uuesti looma.<br />
* Välja logides jätab nii kasutajanime kui ka paroolivälja täidetuks <br />
<br />
===Soovitused===<br />
* Kas koostisosade puhul on vajalik, et kasutaja ise lisab teksti? Kui tabelisse lisataks unikaalsed väärtused, oleks efektiivsem anda rippmenüüst kasutajatele ette valik, mida lisada<br />
* Sisse logituna võiks ära kaotada nupu nagu “registreeri uus kasutaja”<br />
* Loetavuse mõttes kasutada paremini namespace'i näiteks Service klassides (using FoodBytes.BusinessObjects)<br />
* Disain on selge, kuid võiks olla viimistletum. Disainielemente on väga vähe, mis informatsiooni paremini esile tooksid.<br />
<br />
===Kokkuvõte===<br />
<br />
Kuigi põhifunksionaalsused on saavutatud, projekt on struktureeritud MVVM arhitektuuriga, andmebaas on selgete omadustega ja programmi üldpildist on kerge aru saada, jääb projekt natukene lahjaks. Programmi seadistamiseks on vaja luua kohalik andmebaas etteantud scriptiga ning enamus funktsionaalsusi pole üldse võimalik kasutada, sest hetkeseisuga ei õnnestu programmil edukalt uut kasutajat andmebaasi lisada. Seda tuleb teha käsitsi. Samuti üks suurimaid programmi omadusi peaks olema see, et kasutajad saavad lihtsa vaevaga vaadata kasutajate loodud retsepte. Hetkel saab neid vaadata ainult siis, kui retsepti nimi on meeles ja seda Otsinguribalt otsida. Retsepte pole võimalik avada, kui just ei kommenteeri välja ühikute kuvamist. <br />
<br />
Vaatamata projekti struktuurist ja paljudest meetoditest, tekib segadust ViewModeli ja View külje peal. Meetodid on lohisevad ning liiga palju koodi pesitseb just WPF poole peal, mitte ViewModel poole peal. <br />
<br />
Programmil on palju potentsiaali, kuna idee on hea ja retsepti lisamine andmebaasi töötab. Samuti on ka projekti struktuur paigas, mis vajab korrigeerimist View ja ViewModeli poole pealt. Korda tuleks teha ka vead, mis takistavad programmil töötamast nagu uue kasutaja lisamine ning retsepti avamine (ühiku kuvamine).</div>
Saasma
https://wiki.itcollege.ee/index.php?title=Talk:FoodBytes&diff=117407
Talk:FoodBytes
2017-01-30T22:20:20Z
<p>Saasma: </p>
<hr />
<div>Retsensioon: <br />
<br />
Meeskond Elekter (Sigrid Aasma, Kristo Oidermaa ja Tiit Post).<br />
<br />
FoodBytes rakenduse idee on hästi selgitatud ning retseptiraamatu funktsionaalsus on piisavalt arusaadav välisele lugejale. Positiivne on ka see, et andmebaasi struktuuri peale on mõeldud, mille põhjal saab juba rakendada funktsionaalsusi, mis on projekti “Must have” nimekirjas. Erinevate tabelite seosed on läbimõeldud ning võimaldab siduda retsepte kategooriate ja koostisosadega.<br />
<br />
<br />
Küll aga on tabelite nimetused natuke segased. Loogiline tunduks tabel, mis jätaks välja sõna “toiduaine”, kuna koostisosa ning toiduaine on üks ja sama asi. Pakuks allolevat struktuuri Retseptide, Toiduaine ning Koostise tabelite asemele, mille puhul on RetseptiKoostisosad vaid siduva tabeli rollis ja ei ole vaja juurde tuua uut terminit.<br />
<br />
<br />
* Retseptid (RetseptID, retseptinimi, kirjeldus, juhend, kuupäev, kasutaja_id, kategooria_id, (pilt_id))<br />
* Koostisosad (KoostisosaID, koostisosa)<br />
* RetseptiKoostisosad (RetseptID, KoostisosaID, kogus, yhik_id)<br />
<br />
<br />
Rakenduse ägedamaks muutmiseks võiks olla võimalus ka retsepti lisamise juures lisada tehtud toidu pilt nagu netiblogides või kokaraamatutes. Inimesed söövad ju eelkõige silmadega. Võiks lisada selle võimaluse “nice to have” funktsionaalsuse juurde.<br />
<br />
<br />
Tekkis mõttekoht seoses kasutajate lisamise ja kontode loomisega. Kuna rakendus on mõeldud koduseks kasutamiseks arvutis, siis näib paroolide loomine kontodele liialdusena. Piisaks ju lihtsalt kui rakenduse kasutaja saab valida või muuta, kes ta täpsemalt on. Samuti kui vaadata ainult “must have” funktsionaalsust, siis ei läheks kasutajate registreerimist ja paroolide haldust jne vaja. Piisab lihtsalt kui retseptiautoriks märkida kellegi nimi.<br />
<br />
Teine idee oleks eraldada toitumispäeviku/ajaloo jälgimine retseptide küljest ja vast siduda see otseselt kasutajaga. Ehk siis andmebaasis “tehtud” tabel paikneks kasutaja küljes ja seal oleks lisaks ka kasutajaId, mis võimaldaks üpriski kiiresti otsida hiljem, et mis retsepte kasutaja on teinud ja nii toitumispäevikut kuvada.<br />
<br />
Lõpptoote retsensioon: Work In Progress</div>
Saasma
https://wiki.itcollege.ee/index.php?title=Talk:FoodBytes&diff=117406
Talk:FoodBytes
2017-01-30T22:20:03Z
<p>Saasma: </p>
<hr />
<div>Retsensioon: <br />
<br />
Meeskond Elekter (Sigrid Aasma, Kristo Oidermaa ja Tiit Post).<br />
<br />
FoodBytes rakenduse idee on hästi selgitatud ning retseptiraamatu funktsionaalsus on piisavalt arusaadav välisele lugejale. Positiivne on ka see, et andmebaasi struktuuri peale on mõeldud, mille põhjal saab juba rakendada funktsionaalsusi, mis on projekti “Must have” nimekirjas. Erinevate tabelite seosed on läbimõeldud ning võimaldab siduda retsepte kategooriate ja koostisosadega.<br />
<br />
<br />
Küll aga on tabelite nimetused natuke segased. Loogiline tunduks tabel, mis jätaks välja sõna “toiduaine”, kuna koostisosa ning toiduaine on üks ja sama asi. Pakuks allolevat struktuuri Retseptide, Toiduaine ning Koostise tabelite asemele, mille puhul on RetseptiKoostisosad vaid siduva tabeli rollis ja ei ole vaja juurde tuua uut terminit.<br />
<br />
<br />
* Retseptid (RetseptID, retseptinimi, kirjeldus, juhend, kuupäev, kasutaja_id, kategooria_id, (pilt_id))<br />
* Koostisosad (KoostisosaID, koostisosa)<br />
* RetseptiKoostisosad (RetseptID, KoostisosaID, kogus, yhik_id)<br />
<br />
<br />
Rakenduse ägedamaks muutmiseks võiks olla võimalus ka retsepti lisamise juures lisada tehtud toidu pilt nagu netiblogides või kokaraamatutes. Inimesed söövad ju eelkõige silmadega. Võiks lisada selle võimaluse “nice to have” funktsionaalsuse juurde.<br />
<br />
<br />
Tekkis mõttekoht seoses kasutajate lisamise ja kontode loomisega. Kuna rakendus on mõeldud koduseks kasutamiseks arvutis, siis näib paroolide loomine kontodele liialdusena. Piisaks ju lihtsalt kui rakenduse kasutaja saab valida või muuta, kes ta täpsemalt on. Samuti kui vaadata ainult “must have” funktsionaalsust, siis ei läheks kasutajate registreerimist ja paroolide haldust jne vaja. Piisab lihtsalt kui retseptiautoriks märkida kellegi nimi.<br />
<br />
Lõpptoote retsensioon: Work In Progress<br />
<br />
Teine idee oleks eraldada toitumispäeviku/ajaloo jälgimine retseptide küljest ja vast siduda see otseselt kasutajaga. Ehk siis andmebaasis “tehtud” tabel paikneks kasutaja küljes ja seal oleks lisaks ka kasutajaId, mis võimaldaks üpriski kiiresti otsida hiljem, et mis retsepte kasutaja on teinud ja nii toitumispäevikut kuvada.</div>
Saasma
https://wiki.itcollege.ee/index.php?title=Elekter&diff=117082
Elekter
2017-01-24T23:04:11Z
<p>Saasma: </p>
<hr />
<div>[[Category:Programmeerimine_CSharp_keeles_(2016)]]<br />
== Meeskond ==<br />
<br />
* Sigrid Aasma<br />
* Kristo Oidermaa - projektijuht<br />
* Tiit Post<br />
<br />
== Idee ==<br />
<br />
Korteriühistule või haldusfirmale sobiv programm, mis võimaldab mugavalt hallata kortermajadele laekuvaid arveid, neid jaotada korterite vahel ning kontrollida võlglaste staatust.<br />
<br />
[[File:Elekter_logo_3.png]]<br />
<br />
== Tehnoloogia ==<br />
C#, Windows Presentation Foundation, andmebaasid.<br />
<br />
== Analüüs ==<br />
'''Rakenduse üldkirjeldus:'''<br />
<br />
Tiimi Elekter rakendus on mõeldud korteriühistule või haldusfirmale, et mugavalt hallata ja koostada arveid. Rakendus hõlmab nii laekuvate arvete (haldustasu, koristus, üldelekter, küte, remondifond, prügivedu, kindlustus) süsteemis registreerimist kui ka ühistuliikmetele arvete väljastamist iga kuu kaupa. Samuti peab rakendus ja andmebaas sisaldama kõike muud vajalikku infot, mis kajastuvad tavapärasel korteriühistu poolt saadetaval arvel. <br />
<br />
Kasutust leiaks antud rakendus pigem väiksemate haldusfirmade või ühistute endi käes. Suurematel haldusfirmadel on endal sarnased programmid olemas (näiteks Kvatro oma). Tegemist ei oleks ühistule/haldusfirmale sobiva raamatupidamistarkvaraga vaid pigem lisarakendusega, mis on mõeldud eelkõige haldurile ning tulevikus võiks antud rakendus olla otse seotud ka raamatupidamissüsteemiga. Arvatavasti väiksemate haldusfirmade või ühistute puhul käib jagamine paljuski excelis või niipalju kui raamatupidamistarkvara lubab teha.<br />
<br />
<br />
'''Täpsem sisu:'''<br />
<br />
Rakendus sisaldab endas kortermajade/ühistuste lisamist, sellega seoses ka kõigi korterite, vastutavate isikute ja nende kontaktide lisamist. Ennekõike on tähtis kätte saada vajalik algandmestik hilisemateks arvutusteks ning kokku leppida, kuidas hakkab toimuma erinevate kululiikide jagamine korterite vahel (ruutmeertri põhiselt, korteri põhiselt või fikseeritud summa).<br />
<br />
Teine osa rakendusest on laekunud kommunaalarvete lisamine (elekter, prügi jne). Osad arved laekuvad iga korteri kohta, osad arved on kogu ühistu kanda ja jaotada korterite vahel. Rakendus keskendub just nendele arvetele, mis laekuvad otse ühistule ning mida on vaja ühistuliikmete vahel jaotada. Lisaks tuleb arvetust pidada muude lisakulude üle nagu remondifondid, parkimiskohtade kulud/süsteem jne.<br />
<br />
Kolmas osa on arvete koostamise süsteem, mis kõigepealt kontrollib kas kõik soovitava kuu kommunaalarved on laekunud ühistule ning jaotab vastavalt kokkulepitud valemitele need korterite vahel ära. Soov oleks antud arved koostada eraldi dokumendina ja tuleviku võimalusena saata otse ka vastutavale isikule näiteks e-maili peale.<br />
<br />
Neljas osa süsteemist oleks võlglaste/ettemaksete haldus. Süsteem võimaldaks ka arvet pidada iga korteri kohta välja läinud arvete ja laekunud maksete üle ning edasiarendusena võiks arvestada ka viiviseid. Nii saaks iga uue väljastatava arve puhul kohe kajastada ka korteri varasemat võlgnevust või ettemakset. Samuti võiks toimuda automaatsed teavitused või märguanded kui mõne korteri võlgnevus on liiga suureks läinud.<br />
<br />
<br />
'''Eesmärk ja võimalikud tulevikusuunad:'''<br />
<br />
Eesmärk on muuta erinevate arvete haldamine ühistutele lihtsamaks rakenduse keskkonna kaudu. Kui ühistu andmed on juba sisestatud kasutaja poolt, on ainuke töö sisestada info erinevate arvete kohta. Tulevikufunktsioonidena võivad lisanduda ka analüüsi pool ja täpsemad otsingufunktsioonid. Näiteks korteritemüügi puhul saab potentsiaalsetele ostjatele näidata täpsemat kommunaalarvete ajalugu iga kuu kaupa.<br />
<br />
Samuti võib tulevikus tekkinud andmebaas olla kasulik haldusfirmadele renoveerimiste planeerimisel – näiteks küttearved ruutmeetri kohta renoveerimata ja renoveeritud majas, mis oleks oluline sisend remontide planeerimise protsessis. <br />
<br />
Edasiseks arenduseks oleks ühe võimalusena ka korteriomanikule sobiva rakenduse loomine, kus korteriomanik ise saab enda korteriga seotud infot turvaliselt vaadata.<br />
<br />
<br />
'''Milliste osade realiseerimine võib osutuda problemaatiliseks?'''<br />
<br />
Üks tähtsamaid tegevusi on kohe alguses andmebaasid sobivalt valmis disainida juba ette mõelda, et milliseid andmeid on täpselt vaja, et lõppprodukt väljastatava arve põhjal saaks valmis. Üks pool hõlmab kindlasti erinevate korterite/majade sidumist erinevate arvetega, et päringud oleks võimalikud lihtsad ning kiired. <br />
<br />
Teine keerulisem pool on vast valmisolek erijuhtudeks. Esineb kortermajasid, kus parkimist kasutavad ainult osa korterid või katusekorruse korteritel on eraldi küttelahendused. Seega võivad kajastuda sama maja erinevate korterite ühistuarvetel ka erinevad kululiigid.<br />
<br />
Samuti võib keeruliseks osutuda viiviste ja ettemaksete arvestus. Siinkohal tuleks täpselt välja mõelda, mis ajahetkel hakkab viivise arvestus peale ning mis hetkedel uued arved väljastatakse. Just ajalise mõõte planeerimine on tähtis, et ei tekiks probleeme, kui mõni arve laekub hiljem või varem eeldatavast plaanis.<br />
<br />
<br />
'''Tööde jaotus:'''<br />
<br />
Sigrid – user interface ja disain WPFs, väljundi disain ja kood, blogi eest hoolitsemine<br />
<br />
Kristo – projektijuht ja järelevalve, teeb kõike natukene <br />
<br />
Tiit – kirjutab koodi ja loob andmebaase<br />
<br />
<br />
=== Must have: ===<br />
* Kortermajade lisamine andmebaasi (vajalik info:maja id, tänava nimi ja maja nr, korterite arv, ruutmeetreid kokku, ühistuinfo ja rekvisiidid)<br />
* Korterite lisamine kortermajadele (vajalik info: kortermaja id, korteri nr, suurus ruutmeetrites, omaniku nimi, omaniku kontakid)<br />
* Lihtsamad otsingufuntksioonid – näiteks korteriomaniku kontakti leidmiseks<br />
* Majade/korterit info muutmine/kustutamine (näiteks uue omaniku kirjapanek)<br />
* Laekunud arvete lisamine andmebaasi (vajalik info kortermaja id, arve liik, mis perioodi arve, summa)<br />
* Võimalus vaadata, kas kortermaja kohta on kõik arved laekunud enne korterile arve koostamist<br />
* Korteritele arvete koostamine koos arvutustega iga kuu kohta ning rakenduses kuvamine<br />
* Uute arvete salvestamine (doc/pdf)<br />
* Korterite võlgnevuste/ettemaksete üle arvepidamine, koos korteritelt laekunud maksete registreerimisega. Viiviste arvutus ja arvele lisamine.<br />
* Lisakululiikide haldus, mille kohta ei laeku arveid või mis ei käi kõigi korterite kohta.<br />
<br />
=== Nice to have: ===<br />
* Koostatud arvete saatmise võimalus omaniku e-mailile<br />
* Võlglastele automaatsete teadete saatmine<br />
* Automaatsed meeldetuletused (et mingi arve koostada, kontrollida laekumist.<br />
* Erinevad raportid/koondväljavõtted (korterite, majade ja kululiikide kohta)<br />
* Veearvete koostamise süsteem, kus iga korter raporteerib näidud ja seeläbi jaotatakse ka veekulud. Hõlmaks ka tasandamist juhtudele kui näite ei raporteerita ja seega automaatseid prognoose.<br />
<br />
== Andmebaasimudelid ==<br />
<br />
[[File:Elekter Andmebaasi mudel.jpg]]<br />
<br />
== Prototüüp ==<br />
<br />
Prototüüp asub siin: [https://drive.google.com/open?id=0B13XA4AyIfQNc05vSi1UNTRsbkU prototüüp]<br />
<br />
== Workload ==<br />
<br />
=== 09.10.2016 ===<br />
* Tiimi moodustamine ja esimene kogunemine<br />
* Teema valik ja esimeste tegevussuundade paika panemine<br />
<br />
=== 11.10.2016 ===<br />
* Loodi wiki leht<br />
<br />
=== 16.10.2016 ===<br />
* Loodi ajaveeb: [https://i243elekter.wordpress.com/ https://i243elekter.wordpress.com/]<br />
<br />
=== 30.10.2016 ===<br />
* Projekti analüüsi osa lõpetamine<br />
<br />
=== 30.10.2016 ===<br />
* Projekti logo ning programmi loogika: [https://drive.google.com/file/d/0B6rC6xduz_u4YUNzUFN1N3hpQjQ/view?usp=sharing Draw.io's koostatud skeem]<br />
<br />
=== 07.11.2016 ===<br />
* FoodBytes retsensioon: [[Talk:FoodBytes]]<br />
<br />
=== 07.11.2016 ===<br />
* Lisatud andmebaasiskeem<br />
<br />
=== 18.12.2016 ===<br />
* Saime valmis prototüübi täpselt tähtajaks: [https://drive.google.com/open?id=0B13XA4AyIfQNc05vSi1UNTRsbkU prototüüp]<br />
<br />
=== 22.01.2017 ===<br />
* Viimased uuendused projektis ja valmistatud dokumentatsioon kasutusjuhendiga: [https://drive.google.com/open?id=0B6rC6xduz_u4RXN2ZDNVVTRLeUU lõpp-produkt]</div>
Saasma
https://wiki.itcollege.ee/index.php?title=Elekter&diff=117081
Elekter
2017-01-24T23:02:55Z
<p>Saasma: /* Workload */</p>
<hr />
<div>[[Category:Programmeerimine_CSharp_keeles_(2016)]]<br />
== Meeskond ==<br />
<br />
* Sigrid Aasma<br />
* Kristo Oidermaa - projektijuht<br />
* Tiit Post<br />
<br />
== Idee ==<br />
<br />
Korteriühistule või haldusfirmale sobiv programm, mis võimaldab mugavalt hallata kortermajadele laekuvaid arveid, neid jaotada korterite vahel ning kontrollida võlglaste staatust.<br />
<br />
[[File:Elekter_logo_3.png]]<br />
<br />
== Tehnoloogia ==<br />
C#, Windows Presentation Foundation, andmebaasid.<br />
<br />
== Analüüs ==<br />
'''Rakenduse üldkirjeldus:'''<br />
<br />
Tiimi Elekter rakendus on mõeldud korteriühistule või haldusfirmale, et mugavalt hallata ja koostada arveid. Rakendus hõlmab nii laekuvate arvete (haldustasu, koristus, üldelekter, küte, remondifond, prügivedu, kindlustus) süsteemis registreerimist kui ka ühistuliikmetele arvete väljastamist iga kuu kaupa. Samuti peab rakendus ja andmebaas sisaldama kõike muud vajalikku infot, mis kajastuvad tavapärasel korteriühistu poolt saadetaval arvel. <br />
<br />
Kasutust leiaks antud rakendus pigem väiksemate haldusfirmade või ühistute endi käes. Suurematel haldusfirmadel on endal sarnased programmid olemas (näiteks Kvatro oma). Tegemist ei oleks ühistule/haldusfirmale sobiva raamatupidamistarkvaraga vaid pigem lisarakendusega, mis on mõeldud eelkõige haldurile ning tulevikus võiks antud rakendus olla otse seotud ka raamatupidamissüsteemiga. Arvatavasti väiksemate haldusfirmade või ühistute puhul käib jagamine paljuski excelis või niipalju kui raamatupidamistarkvara lubab teha.<br />
<br />
<br />
'''Täpsem sisu:'''<br />
<br />
Rakendus sisaldab endas kortermajade/ühistuste lisamist, sellega seoses ka kõigi korterite, vastutavate isikute ja nende kontaktide lisamist. Ennekõike on tähtis kätte saada vajalik algandmestik hilisemateks arvutusteks ning kokku leppida, kuidas hakkab toimuma erinevate kululiikide jagamine korterite vahel (ruutmeertri põhiselt, korteri põhiselt või fikseeritud summa).<br />
<br />
Teine osa rakendusest on laekunud kommunaalarvete lisamine (elekter, prügi jne). Osad arved laekuvad iga korteri kohta, osad arved on kogu ühistu kanda ja jaotada korterite vahel. Rakendus keskendub just nendele arvetele, mis laekuvad otse ühistule ning mida on vaja ühistuliikmete vahel jaotada. Lisaks tuleb arvetust pidada muude lisakulude üle nagu remondifondid, parkimiskohtade kulud/süsteem jne.<br />
<br />
Kolmas osa on arvete koostamise süsteem, mis kõigepealt kontrollib kas kõik soovitava kuu kommunaalarved on laekunud ühistule ning jaotab vastavalt kokkulepitud valemitele need korterite vahel ära. Soov oleks antud arved koostada eraldi dokumendina ja tuleviku võimalusena saata otse ka vastutavale isikule näiteks e-maili peale.<br />
<br />
Neljas osa süsteemist oleks võlglaste/ettemaksete haldus. Süsteem võimaldaks ka arvet pidada iga korteri kohta välja läinud arvete ja laekunud maksete üle ning edasiarendusena võiks arvestada ka viiviseid. Nii saaks iga uue väljastatava arve puhul kohe kajastada ka korteri varasemat võlgnevust või ettemakset. Samuti võiks toimuda automaatsed teavitused või märguanded kui mõne korteri võlgnevus on liiga suureks läinud.<br />
<br />
<br />
'''Eesmärk ja võimalikud tulevikusuunad:'''<br />
<br />
Eesmärk on muuta erinevate arvete haldamine ühistutele lihtsamaks rakenduse keskkonna kaudu. Kui ühistu andmed on juba sisestatud kasutaja poolt, on ainuke töö sisestada info erinevate arvete kohta. Tulevikufunktsioonidena võivad lisanduda ka analüüsi pool ja täpsemad otsingufunktsioonid. Näiteks korteritemüügi puhul saab potentsiaalsetele ostjatele näidata täpsemat kommunaalarvete ajalugu iga kuu kaupa.<br />
<br />
Samuti võib tulevikus tekkinud andmebaas olla kasulik haldusfirmadele renoveerimiste planeerimisel – näiteks küttearved ruutmeetri kohta renoveerimata ja renoveeritud majas, mis oleks oluline sisend remontide planeerimise protsessis. <br />
<br />
Edasiseks arenduseks oleks ühe võimalusena ka korteriomanikule sobiva rakenduse loomine, kus korteriomanik ise saab enda korteriga seotud infot turvaliselt vaadata.<br />
<br />
<br />
'''Milliste osade realiseerimine võib osutuda problemaatiliseks?'''<br />
<br />
Üks tähtsamaid tegevusi on kohe alguses andmebaasid sobivalt valmis disainida juba ette mõelda, et milliseid andmeid on täpselt vaja, et lõppprodukt väljastatava arve põhjal saaks valmis. Üks pool hõlmab kindlasti erinevate korterite/majade sidumist erinevate arvetega, et päringud oleks võimalikud lihtsad ning kiired. <br />
<br />
Teine keerulisem pool on vast valmisolek erijuhtudeks. Esineb kortermajasid, kus parkimist kasutavad ainult osa korterid või katusekorruse korteritel on eraldi küttelahendused. Seega võivad kajastuda sama maja erinevate korterite ühistuarvetel ka erinevad kululiigid.<br />
<br />
Samuti võib keeruliseks osutuda viiviste ja ettemaksete arvestus. Siinkohal tuleks täpselt välja mõelda, mis ajahetkel hakkab viivise arvestus peale ning mis hetkedel uued arved väljastatakse. Just ajalise mõõte planeerimine on tähtis, et ei tekiks probleeme, kui mõni arve laekub hiljem või varem eeldatavast plaanis.<br />
<br />
<br />
'''Tööde jaotus:'''<br />
<br />
Sigrid – user interface ja disain WPFs, väljundi disain ja kood, blogi eest hoolitsemine<br />
<br />
Kristo – projektijuht ja järelevalve, teeb kõike natukene <br />
<br />
Tiit – kirjutab koodi ja loob andmebaase<br />
<br />
<br />
=== Must have: ===<br />
* Kortermajade lisamine andmebaasi (vajalik info:maja id, tänava nimi ja maja nr, korterite arv, ruutmeetreid kokku, ühistuinfo ja rekvisiidid)<br />
* Korterite lisamine kortermajadele (vajalik info: kortermaja id, korteri nr, suurus ruutmeetrites, omaniku nimi, omaniku kontakid)<br />
* Lihtsamad otsingufuntksioonid – näiteks korteriomaniku kontakti leidmiseks<br />
* Majade/korterit info muutmine/kustutamine (näiteks uue omaniku kirjapanek)<br />
* Laekunud arvete lisamine andmebaasi (vajalik info kortermaja id, arve liik, mis perioodi arve, summa)<br />
* Võimalus vaadata, kas kortermaja kohta on kõik arved laekunud enne korterile arve koostamist<br />
* Korteritele arvete koostamine koos arvutustega iga kuu kohta ning rakenduses kuvamine<br />
* Uute arvete salvestamine (doc/pdf)<br />
* Korterite võlgnevuste/ettemaksete üle arvepidamine, koos korteritelt laekunud maksete registreerimisega. Viiviste arvutus ja arvele lisamine.<br />
* Lisakululiikide haldus, mille kohta ei laeku arveid või mis ei käi kõigi korterite kohta.<br />
<br />
=== Nice to have: ===<br />
* Koostatud arvete saatmise võimalus omaniku e-mailile<br />
* Võlglastele automaatsete teadete saatmine<br />
* Automaatsed meeldetuletused (et mingi arve koostada, kontrollida laekumist.<br />
* Erinevad raportid/koondväljavõtted (korterite, majade ja kululiikide kohta)<br />
* Veearvete koostamise süsteem, kus iga korter raporteerib näidud ja seeläbi jaotatakse ka veekulud. Hõlmaks ka tasandamist juhtudele kui näite ei raporteerita ja seega automaatseid prognoose.<br />
<br />
== Andmebaasimudelid ==<br />
<br />
[[File:Elekter Andmebaasi mudel.jpg]]<br />
<br />
== Prototüüp ==<br />
<br />
Prototüüp asub siin: [https://drive.google.com/open?id=0B13XA4AyIfQNc05vSi1UNTRsbkU prototüüp]<br />
<br />
== Workload ==<br />
<br />
=== 09.10.2016 ===<br />
* Tiimi moodustamine ja esimene kogunemine<br />
* Teema valik ja esimeste tegevussuundade paika panemine<br />
<br />
=== 11.10.2016 ===<br />
* Loodi wiki leht<br />
<br />
=== 16.10.2016 ===<br />
* Loodi ajaveeb: [https://i243elekter.wordpress.com/ https://i243elekter.wordpress.com/]<br />
<br />
=== 30.10.2016 ===<br />
* Projekti analüüsi osa lõpetamine<br />
<br />
=== 30.10.2016 ===<br />
* Projekti logo ning programmi loogika: [https://drive.google.com/file/d/0B6rC6xduz_u4YUNzUFN1N3hpQjQ/view?usp=sharing Draw.io's koostatud skeem]<br />
<br />
=== 07.11.2016 ===<br />
* FoodBytes retsensioon: [[Talk:FoodBytes]]<br />
<br />
=== 07.11.2016 ===<br />
* Lisatud andmebaasiskeem<br />
<br />
=== 18.12.2016 ===<br />
* Saime valmis prototüübi täpselt tähtajaks: [https://drive.google.com/open?id=0B13XA4AyIfQNc05vSi1UNTRsbkU prototüüp]<br />
<br />
== 22.01.2017 ==<br />
* Viimased uuendused projektis ja valmistatud dokumentatsioon kasutusjuhendiga: [https://drive.google.com/open?id=0B6rC6xduz_u4RXN2ZDNVVTRLeUU lõpp-produkt]</div>
Saasma
https://wiki.itcollege.ee/index.php?title=Elekter&diff=114122
Elekter
2016-11-07T18:37:48Z
<p>Saasma: /* Workload */</p>
<hr />
<div>[[Category:Programmeerimine_CSharp_keeles_(2016)]]<br />
== Meeskond ==<br />
<br />
* Sigrid Aasma<br />
* Kristo Oidermaa - projektijuht<br />
* Tiit Post<br />
<br />
== Idee ==<br />
<br />
Korteriühistule või haldusfirmale sobiv programm, mis võimaldab mugavalt hallata kortermajadele laekuvaid arveid, neid jaotada korterite vahel ning kontrollida võlglaste staatust.<br />
<br />
[[File:Elekter_logo_3.png]]<br />
<br />
== Tehnoloogia ==<br />
C#, Windows Presentation Foundation, andmebaasid.<br />
<br />
== Analüüs ==<br />
'''Rakenduse üldkirjeldus:'''<br />
<br />
Tiimi Elekter rakendus on mõeldud korteriühistule või haldusfirmale, et mugavalt hallata ja koostada arveid. Rakendus hõlmab nii laekuvate arvete (haldustasu, koristus, üldelekter, küte, remondifond, prügivedu, kindlustus) süsteemis registreerimist kui ka ühistuliikmetele arvete väljastamist iga kuu kaupa. Samuti peab rakendus ja andmebaas sisaldama kõike muud vajalikku infot, mis kajastuvad tavapärasel korteriühistu poolt saadetaval arvel. <br />
<br />
Kasutust leiaks antud rakendus pigem väiksemate haldusfirmade või ühistute endi käes. Suurematel haldusfirmadel on endal sarnased programmid olemas (näiteks Kvatro oma). Tegemist ei oleks ühistule/haldusfirmale sobiva raamatupidamistarkvaraga vaid pigem lisarakendusega, mis on mõeldud eelkõige haldurile ning tulevikus võiks antud rakendus olla otse seotud ka raamatupidamissüsteemiga. Arvatavasti väiksemate haldusfirmade või ühistute puhul käib jagamine paljuski excelis või niipalju kui raamatupidamistarkvara lubab teha.<br />
<br />
<br />
'''Täpsem sisu:'''<br />
<br />
Rakendus sisaldab endas kortermajade/ühistuste lisamist, sellega seoses ka kõigi korterite, vastutavate isikute ja nende kontaktide lisamist. Ennekõike on tähtis kätte saada vajalik algandmestik hilisemateks arvutusteks ning kokku leppida, kuidas hakkab toimuma erinevate kululiikide jagamine korterite vahel (ruutmeertri põhiselt, korteri põhiselt või fikseeritud summa).<br />
<br />
Teine osa rakendusest on laekunud kommunaalarvete lisamine (elekter, prügi jne). Osad arved laekuvad iga korteri kohta, osad arved on kogu ühistu kanda ja jaotada korterite vahel. Rakendus keskendub just nendele arvetele, mis laekuvad otse ühistule ning mida on vaja ühistuliikmete vahel jaotada. Lisaks tuleb arvetust pidada muude lisakulude üle nagu remondifondid, parkimiskohtade kulud/süsteem jne.<br />
<br />
Kolmas osa on arvete koostamise süsteem, mis kõigepealt kontrollib kas kõik soovitava kuu kommunaalarved on laekunud ühistule ning jaotab vastavalt kokkulepitud valemitele need korterite vahel ära. Soov oleks antud arved koostada eraldi dokumendina ja tuleviku võimalusena saata otse ka vastutavale isikule näiteks e-maili peale.<br />
<br />
Neljas osa süsteemist oleks võlglaste/ettemaksete haldus. Süsteem võimaldaks ka arvet pidada iga korteri kohta välja läinud arvete ja laekunud maksete üle ning edasiarendusena võiks arvestada ka viiviseid. Nii saaks iga uue väljastatava arve puhul kohe kajastada ka korteri varasemat võlgnevust või ettemakset. Samuti võiks toimuda automaatsed teavitused või märguanded kui mõne korteri võlgnevus on liiga suureks läinud.<br />
<br />
<br />
'''Eesmärk ja võimalikud tulevikusuunad:'''<br />
<br />
Eesmärk on muuta erinevate arvete haldamine ühistutele lihtsamaks rakenduse keskkonna kaudu. Kui ühistu andmed on juba sisestatud kasutaja poolt, on ainuke töö sisestada info erinevate arvete kohta. Tulevikufunktsioonidena võivad lisanduda ka analüüsi pool ja täpsemad otsingufunktsioonid. Näiteks korteritemüügi puhul saab potentsiaalsetele ostjatele näidata täpsemat kommunaalarvete ajalugu iga kuu kaupa.<br />
<br />
Samuti võib tulevikus tekkinud andmebaas olla kasulik haldusfirmadele renoveerimiste planeerimisel – näiteks küttearved ruutmeetri kohta renoveerimata ja renoveeritud majas, mis oleks oluline sisend remontide planeerimise protsessis. <br />
<br />
Edasiseks arenduseks oleks ühe võimalusena ka korteriomanikule sobiva rakenduse loomine, kus korteriomanik ise saab enda korteriga seotud infot turvaliselt vaadata.<br />
<br />
<br />
'''Milliste osade realiseerimine võib osutuda problemaatiliseks?'''<br />
<br />
Üks tähtsamaid tegevusi on kohe alguses andmebaasid sobivalt valmis disainida juba ette mõelda, et milliseid andmeid on täpselt vaja, et lõppprodukt väljastatava arve põhjal saaks valmis. Üks pool hõlmab kindlasti erinevate korterite/majade sidumist erinevate arvetega, et päringud oleks võimalikud lihtsad ning kiired. <br />
<br />
Teine keerulisem pool on vast valmisolek erijuhtudeks. Esineb kortermajasid, kus parkimist kasutavad ainult osa korterid või katusekorruse korteritel on eraldi küttelahendused. Seega võivad kajastuda sama maja erinevate korterite ühistuarvetel ka erinevad kululiigid.<br />
<br />
Samuti võib keeruliseks osutuda viiviste ja ettemaksete arvestus. Siinkohal tuleks täpselt välja mõelda, mis ajahetkel hakkab viivise arvestus peale ning mis hetkedel uued arved väljastatakse. Just ajalise mõõte planeerimine on tähtis, et ei tekiks probleeme, kui mõni arve laekub hiljem või varem eeldatavast plaanis.<br />
<br />
<br />
'''Tööde jaotus:'''<br />
<br />
Sigrid – user interface ja disain WPFs, väljundi disain ja kood, blogi eest hoolitsemine<br />
<br />
Kristo – projektijuht ja järelevalve, teeb kõike natukene <br />
<br />
Tiit – kirjutab koodi ja loob andmebaase<br />
<br />
<br />
=== Must have: ===<br />
* Kortermajade lisamine andmebaasi (vajalik info:maja id, tänava nimi ja maja nr, korterite arv, ruutmeetreid kokku, ühistuinfo ja rekvisiidid)<br />
* Korterite lisamine kortermajadele (vajalik info: kortermaja id, korteri nr, suurus ruutmeetrites, omaniku nimi, omaniku kontakid)<br />
* Lihtsamad otsingufuntksioonid – näiteks korteriomaniku kontakti leidmiseks<br />
* Majade/korterit info muutmine/kustutamine (näiteks uue omaniku kirjapanek)<br />
* Laekunud arvete lisamine andmebaasi (vajalik info kortermaja id, arve liik, mis perioodi arve, summa)<br />
* Võimalus vaadata, kas kortermaja kohta on kõik arved laekunud enne korterile arve koostamist<br />
* Korteritele arvete koostamine koos arvutustega iga kuu kohta ning rakenduses kuvamine<br />
* Uute arvete salvestamine (doc/pdf)<br />
* Korterite võlgnevuste/ettemaksete üle arvepidamine, koos korteritelt laekunud maksete registreerimisega. Viiviste arvutus ja arvele lisamine.<br />
* Lisakululiikide haldus, mille kohta ei laeku arveid või mis ei käi kõigi korterite kohta.<br />
<br />
=== Nice to have: ===<br />
* Koostatud arvete saatmise võimalus omaniku e-mailile<br />
* Võlglastele automaatsete teadete saatmine<br />
* Automaatsed meeldetuletused (et mingi arve koostada, kontrollida laekumist.<br />
* Erinevad raportid/koondväljavõtted (korterite, majade ja kululiikide kohta)<br />
* Veearvete koostamise süsteem, kus iga korter raporteerib näidud ja seeläbi jaotatakse ka veekulud. Hõlmaks ka tasandamist juhtudele kui näite ei raporteerita ja seega automaatseid prognoose.<br />
<br />
== Andmebaasimudelid ==<br />
<br />
[[File:Elekter Andmebaasi mudel.jpg]]<br />
<br />
== Workload ==<br />
<br />
=== 09.10.2016 ===<br />
* Tiimi moodustamine ja esimene kogunemine<br />
* Teema valik ja esimeste tegevussuundade paika panemine<br />
<br />
=== 11.10.2016 ===<br />
* Loodi wiki leht<br />
<br />
=== 16.10.2016 ===<br />
* Loodi ajaveeb: [https://i243elekter.wordpress.com/ https://i243elekter.wordpress.com/]<br />
<br />
=== 30.10.2016 ===<br />
* Projekti analüüsi osa lõpetamine<br />
<br />
=== 30.10.2016 ===<br />
* Projekti logo ning programmi loogika: [https://drive.google.com/file/d/0B6rC6xduz_u4YUNzUFN1N3hpQjQ/view?usp=sharing Draw.io's koostatud skeem]<br />
<br />
=== 07.11.2016 ===<br />
* FoodBytes retsensioon: [[Talk:FoodBytes]]<br />
<br />
=== 07.11.2016 ===<br />
* Lisatud andmebaasiskeem</div>
Saasma
https://wiki.itcollege.ee/index.php?title=Elekter&diff=114113
Elekter
2016-11-07T18:19:14Z
<p>Saasma: </p>
<hr />
<div>[[Category:Programmeerimine_CSharp_keeles_(2016)]]<br />
== Meeskond ==<br />
<br />
* Sigrid Aasma<br />
* Kristo Oidermaa - projektijuht<br />
* Tiit Post<br />
<br />
== Idee ==<br />
<br />
Korteriühistule või haldusfirmale sobiv programm, mis võimaldab mugavalt hallata kortermajadele laekuvaid arveid, neid jaotada korterite vahel ning kontrollida võlglaste staatust.<br />
<br />
[[File:Elekter_logo_3.png]]<br />
<br />
== Tehnoloogia ==<br />
C#, Windows Presentation Foundation, andmebaasid.<br />
<br />
== Analüüs ==<br />
'''Rakenduse üldkirjeldus:'''<br />
<br />
Tiimi Elekter rakendus on mõeldud korteriühistule või haldusfirmale, et mugavalt hallata ja koostada arveid. Rakendus hõlmab nii laekuvate arvete (haldustasu, koristus, üldelekter, küte, remondifond, prügivedu, kindlustus) süsteemis registreerimist kui ka ühistuliikmetele arvete väljastamist iga kuu kaupa. Samuti peab rakendus ja andmebaas sisaldama kõike muud vajalikku infot, mis kajastuvad tavapärasel korteriühistu poolt saadetaval arvel. <br />
<br />
Kasutust leiaks antud rakendus pigem väiksemate haldusfirmade või ühistute endi käes. Suurematel haldusfirmadel on endal sarnased programmid olemas (näiteks Kvatro oma). Tegemist ei oleks ühistule/haldusfirmale sobiva raamatupidamistarkvaraga vaid pigem lisarakendusega, mis on mõeldud eelkõige haldurile ning tulevikus võiks antud rakendus olla otse seotud ka raamatupidamissüsteemiga. Arvatavasti väiksemate haldusfirmade või ühistute puhul käib jagamine paljuski excelis või niipalju kui raamatupidamistarkvara lubab teha.<br />
<br />
<br />
'''Täpsem sisu:'''<br />
<br />
Rakendus sisaldab endas kortermajade/ühistuste lisamist, sellega seoses ka kõigi korterite, vastutavate isikute ja nende kontaktide lisamist. Ennekõike on tähtis kätte saada vajalik algandmestik hilisemateks arvutusteks ning kokku leppida, kuidas hakkab toimuma erinevate kululiikide jagamine korterite vahel (ruutmeertri põhiselt, korteri põhiselt või fikseeritud summa).<br />
<br />
Teine osa rakendusest on laekunud kommunaalarvete lisamine (elekter, prügi jne). Osad arved laekuvad iga korteri kohta, osad arved on kogu ühistu kanda ja jaotada korterite vahel. Rakendus keskendub just nendele arvetele, mis laekuvad otse ühistule ning mida on vaja ühistuliikmete vahel jaotada. Lisaks tuleb arvetust pidada muude lisakulude üle nagu remondifondid, parkimiskohtade kulud/süsteem jne.<br />
<br />
Kolmas osa on arvete koostamise süsteem, mis kõigepealt kontrollib kas kõik soovitava kuu kommunaalarved on laekunud ühistule ning jaotab vastavalt kokkulepitud valemitele need korterite vahel ära. Soov oleks antud arved koostada eraldi dokumendina ja tuleviku võimalusena saata otse ka vastutavale isikule näiteks e-maili peale.<br />
<br />
Neljas osa süsteemist oleks võlglaste/ettemaksete haldus. Süsteem võimaldaks ka arvet pidada iga korteri kohta välja läinud arvete ja laekunud maksete üle ning edasiarendusena võiks arvestada ka viiviseid. Nii saaks iga uue väljastatava arve puhul kohe kajastada ka korteri varasemat võlgnevust või ettemakset. Samuti võiks toimuda automaatsed teavitused või märguanded kui mõne korteri võlgnevus on liiga suureks läinud.<br />
<br />
<br />
'''Eesmärk ja võimalikud tulevikusuunad:'''<br />
<br />
Eesmärk on muuta erinevate arvete haldamine ühistutele lihtsamaks rakenduse keskkonna kaudu. Kui ühistu andmed on juba sisestatud kasutaja poolt, on ainuke töö sisestada info erinevate arvete kohta. Tulevikufunktsioonidena võivad lisanduda ka analüüsi pool ja täpsemad otsingufunktsioonid. Näiteks korteritemüügi puhul saab potentsiaalsetele ostjatele näidata täpsemat kommunaalarvete ajalugu iga kuu kaupa.<br />
<br />
Samuti võib tulevikus tekkinud andmebaas olla kasulik haldusfirmadele renoveerimiste planeerimisel – näiteks küttearved ruutmeetri kohta renoveerimata ja renoveeritud majas, mis oleks oluline sisend remontide planeerimise protsessis. <br />
<br />
Edasiseks arenduseks oleks ühe võimalusena ka korteriomanikule sobiva rakenduse loomine, kus korteriomanik ise saab enda korteriga seotud infot turvaliselt vaadata.<br />
<br />
<br />
'''Milliste osade realiseerimine võib osutuda problemaatiliseks?'''<br />
<br />
Üks tähtsamaid tegevusi on kohe alguses andmebaasid sobivalt valmis disainida juba ette mõelda, et milliseid andmeid on täpselt vaja, et lõppprodukt väljastatava arve põhjal saaks valmis. Üks pool hõlmab kindlasti erinevate korterite/majade sidumist erinevate arvetega, et päringud oleks võimalikud lihtsad ning kiired. <br />
<br />
Teine keerulisem pool on vast valmisolek erijuhtudeks. Esineb kortermajasid, kus parkimist kasutavad ainult osa korterid või katusekorruse korteritel on eraldi küttelahendused. Seega võivad kajastuda sama maja erinevate korterite ühistuarvetel ka erinevad kululiigid.<br />
<br />
Samuti võib keeruliseks osutuda viiviste ja ettemaksete arvestus. Siinkohal tuleks täpselt välja mõelda, mis ajahetkel hakkab viivise arvestus peale ning mis hetkedel uued arved väljastatakse. Just ajalise mõõte planeerimine on tähtis, et ei tekiks probleeme, kui mõni arve laekub hiljem või varem eeldatavast plaanis.<br />
<br />
<br />
'''Tööde jaotus:'''<br />
<br />
Sigrid – user interface ja disain WPFs, väljundi disain ja kood, blogi eest hoolitsemine<br />
<br />
Kristo – projektijuht ja järelevalve, teeb kõike natukene <br />
<br />
Tiit – kirjutab koodi ja loob andmebaase<br />
<br />
<br />
=== Must have: ===<br />
* Kortermajade lisamine andmebaasi (vajalik info:maja id, tänava nimi ja maja nr, korterite arv, ruutmeetreid kokku, ühistuinfo ja rekvisiidid)<br />
* Korterite lisamine kortermajadele (vajalik info: kortermaja id, korteri nr, suurus ruutmeetrites, omaniku nimi, omaniku kontakid)<br />
* Lihtsamad otsingufuntksioonid – näiteks korteriomaniku kontakti leidmiseks<br />
* Majade/korterit info muutmine/kustutamine (näiteks uue omaniku kirjapanek)<br />
* Laekunud arvete lisamine andmebaasi (vajalik info kortermaja id, arve liik, mis perioodi arve, summa)<br />
* Võimalus vaadata, kas kortermaja kohta on kõik arved laekunud enne korterile arve koostamist<br />
* Korteritele arvete koostamine koos arvutustega iga kuu kohta ning rakenduses kuvamine<br />
* Uute arvete salvestamine (doc/pdf)<br />
* Korterite võlgnevuste/ettemaksete üle arvepidamine, koos korteritelt laekunud maksete registreerimisega. Viiviste arvutus ja arvele lisamine.<br />
* Lisakululiikide haldus, mille kohta ei laeku arveid või mis ei käi kõigi korterite kohta.<br />
<br />
=== Nice to have: ===<br />
* Koostatud arvete saatmise võimalus omaniku e-mailile<br />
* Võlglastele automaatsete teadete saatmine<br />
* Automaatsed meeldetuletused (et mingi arve koostada, kontrollida laekumist.<br />
* Erinevad raportid/koondväljavõtted (korterite, majade ja kululiikide kohta)<br />
* Veearvete koostamise süsteem, kus iga korter raporteerib näidud ja seeläbi jaotatakse ka veekulud. Hõlmaks ka tasandamist juhtudele kui näite ei raporteerita ja seega automaatseid prognoose.<br />
<br />
== Andmebaasimudelid ==<br />
<br />
== Workload ==<br />
<br />
=== 09.10.2016 ===<br />
* Tiimi moodustamine ja esimene kogunemine<br />
* Teema valik ja esimeste tegevussuundade paika panemine<br />
<br />
=== 11.10.2016 ===<br />
* Loodi wiki leht<br />
<br />
=== 16.10.2016 ===<br />
* Loodi ajaveeb: [https://i243elekter.wordpress.com/ https://i243elekter.wordpress.com/]<br />
<br />
=== 30.10.2016 ===<br />
* Projekti analüüsi osa lõpetamine<br />
<br />
=== 30.10.2016 ===<br />
* Projekti logo ning programmi loogika: [https://drive.google.com/file/d/0B6rC6xduz_u4YUNzUFN1N3hpQjQ/view?usp=sharing Draw.io's koostatud skeem]<br />
<br />
=== 07.11.2016 ===<br />
* FoodBytes retsensioon: [[Talk:FoodBytes]]</div>
Saasma
https://wiki.itcollege.ee/index.php?title=Talk:FoodBytes&diff=114111
Talk:FoodBytes
2016-11-07T18:15:28Z
<p>Saasma: </p>
<hr />
<div>Retsensioon: <br />
<br />
Meeskond Elekter (Sigrid Aasma, Kristo Oidermaa ja Tiit Post).<br />
<br />
FoodBytes rakenduse idee on hästi selgitatud ning retseptiraamatu funktsionaalsus on piisavalt arusaadav välisele lugejale. Positiivne on ka see, et andmebaasi struktuuri peale on mõeldud, mille põhjal saab juba rakendada funktsionaalsusi, mis on projekti “Must have” nimekirjas. Erinevate tabelite seosed on läbimõeldud ning võimaldab siduda retsepte kategooriate ja koostisosadega.<br />
<br />
<br />
Küll aga on tabelite nimetused natuke segased. Loogiline tunduks tabel, mis jätaks välja sõna “toiduaine”, kuna koostisosa ning toiduaine on üks ja sama asi. Pakuks allolevat struktuuri Retseptide, Toiduaine ning Koostise tabelite asemele, mille puhul on RetseptiKoostisosad vaid siduva tabeli rollis ja ei ole vaja juurde tuua uut terminit.<br />
<br />
<br />
* Retseptid (RetseptID, retseptinimi, kirjeldus, juhend, kuupäev, kasutaja_id, kategooria_id, (pilt_id))<br />
* Koostisosad (KoostisosaID, koostisosa)<br />
* RetseptiKoostisosad (RetseptID, KoostisosaID, kogus, yhik_id)<br />
<br />
<br />
Rakenduse ägedamaks muutmiseks võiks olla võimalus ka retsepti lisamise juures lisada tehtud toidu pilt nagu netiblogides või kokaraamatutes. Inimesed söövad ju eelkõige silmadega. Võiks lisada selle võimaluse “nice to have” funktsionaalsuse juurde.<br />
<br />
<br />
Tekkis mõttekoht seoses kasutajate lisamise ja kontode loomisega. Kuna rakendus on mõeldud koduseks kasutamiseks arvutis, siis näib paroolide loomine kontodele liialdusena. Piisaks ju lihtsalt kui rakenduse kasutaja saab valida või muuta, kes ta täpsemalt on. Samuti kui vaadata ainult “must have” funktsionaalsust, siis ei läheks kasutajate registreerimist ja paroolide haldust jne vaja. Piisab lihtsalt kui retseptiautoriks märkida kellegi nimi.<br />
<br />
<br />
Teine idee oleks eraldada toitumispäeviku/ajaloo jälgimine retseptide küljest ja vast siduda see otseselt kasutajaga. Ehk siis andmebaasis “tehtud” tabel paikneks kasutaja küljes ja seal oleks lisaks ka kasutajaId, mis võimaldaks üpriski kiiresti otsida hiljem, et mis retsepte kasutaja on teinud ja nii toitumispäevikut kuvada.</div>
Saasma
https://wiki.itcollege.ee/index.php?title=Juhend:_Kodut%C3%B6%C3%B6_aines_%22Programmeerimine_CSharp_keeles%22_(2016)&diff=113914
Juhend: Kodutöö aines "Programmeerimine CSharp keeles" (2016)
2016-11-04T12:50:05Z
<p>Saasma: /* Meeskond: Elekter */</p>
<hr />
<div>=Kodutöö aines "Programmeerimine C# keeles"=<br />
<br />
==Eesmärk==<br />
Saada praktiline arenduskogemus .NET keskkonnas ning arendada meeskonnatöö kogemust ja analüüsivõimet. Kasutada arendusprotsessis koodihoidlat.<br />
<br />
==Reeglid==<br />
Ühte projektimeeskonda kuulub 3-5 tudengit(Soovituslik meeskonna suurus on 3-4). Ühel teemal võib teostada projekti üks või mitu meeskonda.Töö käiku kajastatakse https://wiki.itcollege.ee keskkonnas või soovi korral võib seda teha ka ajaveebis(blogis).<br />
Ajaveebi pidamise eesmärke on kaks: nii on võimalik kirja panna kõik mõtted ja ideed (ning nendest jääb jälg ja dokumentatsioon) ning õppejõul on hiljem võimalik saada ülevaade iga projektimeeskonna liikme panusest. Ajaveebi loob ja ajaveebi haldab projektimeeskond vabalt valitud (avalikus) keskkonnas. <br />
<br />
'''Projekti loomine ja arendamine '''<br />
Projekt lisatakse versioonihaldusesse, kasutades selleks [Team Foundation Service'it http://tfs.visualstudio.com/] ning õppejõule antakse ligipääs. Õppejõu live id: maitposka ät hotmail.com . Projekt peab olema alates algfaasist lisatud TFSi ning kogu tööprotsess toimub versioonihaldust kasutades<br />
<br />
'''Tööde esitamine''' (prototüüb ja lõpptoode)<br />
Töö esitamisel pakitakse see kokku ning lisatakse wiki leheküljele link lähtekoodile. Kui töö lähtekoodi ei soovita mingil põhjusel avalikustata, tuleb õppejõuga selle jaoks sõlmida eraldi kokkulepe. Lähtekood on vajalik, et tööd oleks võimalik hinnata nii õppejõul kui kaastudengitel selle kohta retsensiooni kirjutada.<br />
<br />
'''Team Foundation Service kasutamine''' (tänasel päeval '' Visual Studio online'')<br />
[http://www.visualstudio.com/get-started/sign-up-for-visual-studio-online Step-by-Step juhend]<br />
<br />
NB! Versioonihalduse kohta jagab õppejõud materjale.<br />
<br />
==Tähtaegadest kinnipidamine==<br />
Projekt jaguneb alamosadeks, millele on määratud tähtajad. Tähtaegade ületamisel võimalike punkte ei kaotata. Kui töö aga on esitatud tähtajaks, siis on võimalik selle eest teenida boonuspunkte (enamasti 0-10% võimalikust maksimumist boonust). Enne tähtaega esitatud töö ei tähenda automaatselt maksimumpunkte, kui see ei ole sooritatud korralikult.<br />
<br />
NB! Juhul kui analüüsi tähtajast on möödunud nädal, määrab õppejõud meeskonnale ise vabalt valitud ülesande, mis on võetud näidis teemade alt. Peale seda ei ole võimalik teemat enam muuta.<br />
<br />
==Hindamine==<br />
Teostatuks loetakse projekt juhul, kui lähteülesanne on realiseeritud, lahendus on töötav, kuid esineb suuremaid vigu ning piirsituatsioonidega ei ole arvestatud.<br />
Maksimumtulemuse saavutamiseks peab projekt olema teostatud tehniliselt veatult ning varustatud dokumentatsiooniga, milles sisaldub arendusprotsessi kirjeldus (peab selguma ka iga rühmaliikme panus projekti teostamisel), kasutajajuhend ning lahenduse kirjeldus. Tehnilisi ja vormistuslike puudujääke on võimalik korvata lisavõimaluste realiseerimisega.Üldjuhul tuleb loodud lahendust ka praktikumides või loengutes teistele tudengitele tutvustada (ca 10 min).<br />
Nagu eelpool mainitud, koosneb projekt erinevatest osadest. Punktide arvu määramisel arvestatakse ka tähtajast kinni pidamist, mille toimimisloogika on kirjeldatud eespool.<br />
<br />
===Meeskonna kokkupanek ja idee===<br />
'''27.10.2016''' (2p) (Kuna vahepeal oli loengute toimumise kord paigast ära ning TFSi loomisega on segadust olnud, siis nihutan seda tähtaega)<br />
<br />
Tekitatakse meeskonna wiki lehekülg. Meeskonnal peab olema nimi ning see koosneb kolmest kuni viiest liikmest. Määratakse projektijuht. Juhul kui hakatakse blogi pidama kuskil mujal keskkonnas ilmub selle kohta link. Lühidalt peaks kirjeldama idee olemust nii, et selle üldine suund oleks arusaadav. Samuti peab olema märgitud tehnoloogia, milles hakatakse rakendust looma. Meeskond on loonud TFSi konto ning on saatnud õppejõule kutse.<br />
<br />
===Analüüs===<br />
'''01.11.2016''' (4p)<br />
Analüütilise osa eesmärgiks on arendada tudengite analüüsioskust, mida on vaja ka päris tarkvaraarenduse protsessi juures.'''NB! Miinimum sõnade arv 700''' Selle osa käigus peab valmima loodava rakenduse analüüs, mis sisaldab muu hulgas ka:<br />
*Analüüs rakendusele. (Mida see endas sisaldab? Mis on selle eesmärk? Mida tavakasutaja sellega teha saaks? Milliste osade realiseerimine võib osutuda problemaatiliseks?) Kui on tööjaotus paigas, siis tuua ka see välja.<br />
*Tuua välja nimekiri funktsionaalsusest, mida plaanitakse kindlasti teostada(''Must have'')<br />
*Nimekiri funktsionaalsustest, mis võiks olla, aga mida ei pruugita ajapuuduse tõttu realiseerida.(''Nice to have'')<br />
<br />
'''Retsensioon''' 08.11.2016 (3p)<br />
<br />
===Prototüüp + esitlemine===<br />
'''20.11.2016 '''(10p)<br />
<br />
Valmib projekti esmane realisatsioon. Laias laastus on peafunktsionaalsused realiseeritud(Nimekiri funktsionaalsusest, mida plaanitakse teostada). Rakenduses on loodud erinevad vaated, mis võimaldavad ülevaate rakendusest saada.<br />
<br />
20. novembril esitatakse prototüüp, mida kaitstakse sellele järgneval nädalal. NB! Juhul kui prototüüpi ei kaitsa ja ei esitata, siis ei ole võimalik selle osa eest punkte saada.<br />
<br />
===Lõpptoode===<br />
'''18.12.2016'''(30p)<br />
Selleks faasiks peab projekt maksimumpuntkide saavutamiseks olema teostatud tehniliselt veatult ning varustatud dokumentatsiooniga, milles sisaldub arendusprotsessi kirjeldus (peab selguma ka iga rühmaliikme panus projekti teostamisel), kasutajajuhend ning lahenduse kirjeldus.<br />
<br />
'''Retsensioon''' 08.01.2016(4p)<br />
<br />
===Esitlus/Kaitsmine=== <br />
<br />
'''Toimub loengutes/praktikumides või kokkulepitud ajal enne eksamit''' ''(3p) ''<br />
Esitlusel kaitstakse projekti. Tutvustatakse tehnoloogiat, mida kasutati rakenduse realiseerimiseks. Lühidalt räägitakse tööjaotusest ning probleemidest, mis tekkisid projekti realiseerimisel. Näidatakse lähtekoodi ja demonstreeritakse oma rakendust teistele tudengitele, kes võivad selle kohta küsimusi küsida. Kestvus ~20min.<br />
<br />
====Kaitsmise ajad====<br />
<br />
Siia alla ilmuvad detsembris kaitsmise ajad.<br />
<br />
Ideaalne esitlus, sisaldab endas ka powerpointi, kus on<br />
*väljatoodud meeskonna nimi ja liikmed<br />
*idee<br />
*realiseerimine<br />
*mis oli keerukas?<br />
*mida uut õpiti?<br />
*mõnede keerulisemate probleemide lahendamine<br />
*meeskonnaliikmete panus<br />
<br />
Kaitsmise käigus vaadatakse üle ka kood.<br />
<br />
=Teemad 2016 sügis=<br />
Kodutööna tuleb luua:<br />
<br />
==Nõuded rakendusele==<br />
Loodav rakendus peab:<br />
* Peab kasutama andmebaasi (erikokkuleppel ka XML formaadis andmeallikat)<br />
**Andmebaasis peab olema vähemalt 6 andmebaasi tabelit<br />
* Peab võimaldama tegevuste kohta registri pidamist (logi)<br />
**Rakenduses tehtavad tegevused salvestatakse<br />
* Kasutama kasutajaliidesena ühte järgmistest: Windows Presentation Foundation, Windows Phone , Windows Store App või ASP.Net<br />
* Kood on kommenteeritud ning rakendus on varustatud dokumentatsiooniga<br />
* Maksimumpunktide jaoks kasutatakse vastavalt valitud tehnoloogiale soovitatud arendusmustreid<br />
* Kood on kirjutatud C# programmeerimiskeeles<br />
**Kuna aine nimi on "Programmeerimine C# keeles" ei tohi esitada rakendust, mis on loodud Javas, PHPs vms keeles<br />
* Rakendus on jaotatud kihtidesse<br />
'''Loodav rakendus peab olema loodud objektorienteeritud lähenemist kasutades!''' Klassid, klassid, klassid<br />
*Kood on kommenteeritud<br />
<br />
Lisapunkte annab:<br />
* Silmailu<br />
* Kood on kirjutatud häid praktikaid järgides ja on veatu(testimine, testimine, testimine)<br />
* Orginaalsed ideed ja hea äriidee<br />
<br />
==Kodune raamatukogu==<br />
Kodudes on tihti erinevaid raamatuid (filme, muud nänni) ja sõbrad tahavad neid vahel laenutada.<br />
Loo rakendus, mis<br />
* Võimaldaks sisestada kodused raamatud<br />
* Võimaldaks luua laenutajate profiile<br />
* Raamatuid välja laenutada (tähtajaliselt)<br />
* Laseks koostada erinevaid aruandeid (kodusolevad raamatud, väljalaenutatud raamatud, tähtaja ületanud laenutused jne)<br />
<br />
<br />
Lisavõimalused<br />
* Kui laenutaja profiilis on e-mail, siis saada automaatselt e-kiri „kallis sõber see ja see, Sinu käes on minu raamat, kas tood tagasi ka?”<br />
* Kuva hoiatused, kui laenutaja laenutuste ajalugu on vilets või kui mõni raamat on tagastamata.<br />
* Lase lisada raamatutele pilt<br />
* Loo lihtne veebiliides (et sõbrad saaksid veebist vaadata, mis raamatud kasutajal kodus veel alles on)<br />
Või<br />
<br />
==CRM==<br />
Oma klientidest peab olema ülevaade.<br />
Loo rakendus, mis võimaldab:<br />
* Kliente ning nende kontaktisikuid sisestada, muuta ning kustutada<br />
* Võimalda sisestada kliendikontakte<br />
* Koostada hinnapakkumisi klientidele, kusjuures hinnapakkumine lisatakse süsteemi ka kui kliendikontakt ning saadetakse samast süsteemist kliendile.<br />
* Kliendi andmete vaatamisel kuvatakse ka kliendikontaktid<br />
<br />
<br />
Lisavõimalused<br />
* Loo võimalus, kus kontaktisiku sünnipäeva saabumisel saadetakse automaatselt inimesele meil õnnesoovidega<br />
* Õnnitlusmeilide template’sid võiks olla mitu<br />
* Loo võimalus kliendi huvide (huvialade) kajastamiseks süsteemis<br />
<br />
==Mäng(Unit)==<br />
Loodav mäng peab sisaldama:<br />
* Erinevaid tasemeid<br />
* Punktiarvestust<br />
* XBox puldi tuge<br />
* Klaviatuurilt juhtimise tuge<br />
<br />
'''Loodav mäng peab olema loodud objektorienteeritud lähenemist kasutades!''' Klassid, klassid, klassid<br />
<br />
Lisapunkte annab:<br />
* Silmailu<br />
* Kood on kirjutatud häid praktikaid järgides ja on veatu(testimine, testimine, testimine)<br />
* Orginaalsed ideed ja hea ''story''<br />
<br />
=Meeskonnad 2016=<br />
==Päevaõpe==<br />
<br />
===Meeskond: Kuri Kohvikupidaja===<br />
Liikmed:<br />
* Egert Aia<br />
Meeskonna koduleht: [[Kuri_Kohvikupidaja]]<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
Kättesaadav siit: https://drive.google.com/open?id=0BxPYMOn_Lvs6U3g2Rm53TTNZWmc<br />
<br />
Sisse saab logida jalutsis vajutades login<br />
<br />
admini log: 1@eesti.ee<br />
<br />
admini pw: a<br />
<br />
<br />
PS! Checkboxe valides vali esimest checkboxi nii et teed selle aktiivseks ja siis võtad linnukese jälle ära, pärast seda kõik checkboxid töötavad ilusti! =)<br />
<br />
===Meeskond: Pirate Netflix===<br />
Liikmed:<br />
* Arti Zirk<br />
* Mihkel Vajak<br />
* Janno Oolo<br />
* Joosep Voolmaa<br />
Meeskonna koduleht: [[Pirate_Netflix]]<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: D♭===<br />
Liikmed:<br />
* Semjon Greef<br />
* Martin Arusalu<br />
* Martin Nõukas<br />
* Roomet Saadi<br />
Meeskonna koduleht: [[Meeskond: D♭]]<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: ParkWell===<br />
Liikmed:<br />
* Taavi Vesinurm<br />
* Raido Vell<br />
* Madis Roosioks<br />
Meeskonna koduleht: [[ParkWell]]<br />
<br />
Projekti TFS: [https://park-well.visualstudio.com/ParkWell SIIN]<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: Bomory===<br />
Liikmed:<br />
* Hando Laasmägi<br />
* Tarvo Tammejuur<br />
* Cathy Toomast<br />
Meeskonna koduleht: [[Bomory]]<br />
<br />
'''TFS'''<br />
https://eikbomory.visualstudio.com/Bomory<br />
<br />
'''Analüüs'''<br />
Õppejõule saadetud 01.11.2016.<br />
https://wiki.itcollege.ee/index.php/Bomory#Anal.C3.BC.C3.BCs<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: Kassarakendus===<br />
Liikmed:<br />
* Mikk Sarapuu<br />
* Meelis Sääsk<br />
* Piret Pomerants<br />
Meeskonna koduleht: [[Kassarakendus]]<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: Pie Piper===<br />
Liikmed:<br />
* Villem Markus Loigom<br />
* Olari Pipenberg<br />
* Uku-Mart Uprus<br />
* Ardo Erik<br />
Meeskonna koduleht: [[Pie_Piper]]<br />
<br />
'''Retsensioonid'''<br />
NA<br />
<br />
'''Lõpptoode'''<br />
NA<br />
<br />
<br />
===Meeskond: Hidden Mustard===<br />
Liikmed:<br />
* Andreas Kirotar<br />
* Tõnn Vaher<br />
* Aivar Romandi<br />
* Anneli Asser<br />
Meeskonna koduleht: [[Hidden_Mustard]]<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: B12===<br />
Liikmed:<br />
* Kerdo Kullamäe<br />
* Marvin Mardiat<br />
* Martin Paakspuu<br />
Meeskonna koduleht: [[B12]]<br />
<br />
Projekti TFS: https://b12tiim.visualstudio.com/B12/<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: Elibrium ===<br />
Liikmed:<br />
* Märt Häkkinen<br />
* Karl Frank<br />
Meeskonna koduleht: [[Elibrium]]<br />
<br />
Projekti TFS: https://m-hakkinen.visualstudio.com/Elibrium<br />
<br />
'''Retsensioonid'''<br />
*Analüüsi retsensioon meeskonnale '''Gurmaanid''' asub [https://wiki.itcollege.ee/index.php/Talk:Meeskond:_Gurmaanid siin]<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: CozinHero ===<br />
Liikmed:<br />
* Taavi Metsvahi<br />
* Kai Kallastu<br />
Meeskonna koduleht: [[CozinHero]]<br />
<br />
Projekti TFS: https://metsvahi.visualstudio.com/CozinHero<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: Bank ===<br />
Liikmed:<br />
* Aleksei Kopõlov<br />
* Teet Adamson<br />
* Sander Perens<br />
* Tarvo Sbitnev<br />
Meeskonna koduleht: [https://wiki.itcollege.ee/index.php/Bank Bank]<br />
<br />
Projekti TFS: https://perens.visualstudio.com/Projekt%20Bank/tiimi%20nimi<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: ATDV===<br />
Liikmed:<br />
* Aldin Talve - arendaja<br />
* Delia Viirmaa - projektijuht<br />
* Mart-Erki Nõumees - arendaja<br />
<br />
Meeskonna koduleht: [[ATDV]]<br />
<br />
ADTV TFS: [https://adtvmn.visualstudio.com/ADTV SIIN]<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: Sõnajalg===<br />
Liikmed:<br />
* Argo Hansen<br />
* Ragnar Rästas<br />
Meeskonna koduleht: [[Sõnajalg]]<br />
<br />
Projekti TFS: https://sonajalg-itk.visualstudio.com/<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond:Gurmaanid===<br />
Liikmed:<br />
* Koit Kõrvel<br />
* Marko Kask<br />
* Brita Pentšuk<br />
* Ott Sõerumäe<br />
Meeskonna koduleht: [[Gurmaanid]]<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: Korterid Kõrgel Künkal===<br />
Liikmed:<br />
* Edward Mardo<br />
Meeskonna koduleht: [[Korterid_Kõrgel_Künkal]]<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: Librarians===<br />
Liikmed:<br />
* Kerttu Liis Lootus<br />
* Lisandra Noor<br />
* Lisette Noor<br />
Meeskonna koduleht: [[Librarians]]<br />
<br />
Projekti TFS: https://klootus.visualstudio.com/Librarians<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: Brainery===<br />
Liikmed:<br />
* Madis Lugus<br />
* Elina Kuldkepp<br />
* Berit Põldoja<br />
* Taavi Teearu<br />
Meeskonna koduleht: [[Brainery]]<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: Rent A Book===<br />
Liikmed:<br />
* Aapo Kersalu<br />
* Kristjan Kotto<br />
* Paul John Niidas<br />
<br />
Meeskonna koduleht: [[Rent A Book]]<br />
<br />
'''Retsensioonid''" <br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: BMS===<br />
Liikmed:<br />
* Kert Kukk<br />
Meeskonna koduleht: [[BMS]]<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: Dogify===<br />
Liikmed:<br />
* Roland Soosaar<br />
* Krista Norak<br />
* Mihkel Roots<br />
<br />
Meeskonna koduleht [[Dogify]]<br />
<br />
'''Projekti TFS:''' https://rososa.visualstudio.com/Dogify/<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: ForeverNotes===<br />
Liikmed:<br />
* Margus Muru<br />
* Joosep Koort<br />
* Martin Nigul<br />
Meeskonna koduleht: [[ForeverNotes]]<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: NullPointerException===<br />
Liikmed:<br />
* Kertu Nurmberg<br />
* Tõnis Piirits<br />
Meeskonna koduleht: [[NullPointerException]]<br />
<br />
'''Projekti TFS:''' https://null-pointer-exception.visualstudio.com/CSGO%20Triggerbot<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
==Kaugõpe==<br />
<br />
===Meeskond: Autoparandaja===<br />
Liikmed:<br />
* Mihkel Viilveer<br />
Meeskonna koduleht: [[Autoparandaja]]<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
'''TFS'''<br />
https://tostukid.visualstudio.com<br />
<br />
===Meeskond: Paabel===<br />
Liikmed:<br />
* Rutt Lindström<br />
* Esta Prangel<br />
* Krista Rüütel<br />
* Liina Abner<br />
<br />
Meeskonna koduleht: [[Paabel]]<br />
<br />
'''Retsensioonid'''<br />
TODO Projekti "Isearve" retsensioon: [[Talk:Isearve]]<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: Agraarbeib===<br />
<br />
Liikmed:<br />
* Kaia Runthal<br />
* Marianne Trubetskoi<br />
* Taavi Tilk<br />
* Mihkel Matson<br />
<br />
Meeskonna koduleht: [[Agraarbeib]]<br />
<br />
Projekti TFS: https://kaia.visualstudio.com/MeieTalu<br />
<br />
'''Analüüs (01.11)'''<br />
[https://wiki.itcollege.ee/index.php/Agraarbeib/Analyys Analüüs Wikis]<br />
<br />
'''Analüüsi retsensioon (08.11) TODO'''<br />
[https://wiki.itcollege.ee/index.php/Agraarbeib/AnalüüsiRetsensioon Retsensioon meeskonna [[Elekter]] analüüsile]<br />
<br />
'''Prototüüp (20.11) TODO''' <br />
[https://wiki.itcollege.ee/index.php/Agraarbeib/Prototüüp Prototüüp]<br />
<br />
'''Lõpptoode (18.12) TODO''' <br />
[https://wiki.itcollege.ee/index.php/Agraarbeib/Lõpptoode Lõpptoode]<br />
<br />
'''Lõpptoote retsensioon (08.01) TODO''' <br />
[https://wiki.itcollege.ee/index.php/Agraarbeib/LõpptooteRetsensioon Retsensioon meeskonna ??? tootele]<br />
<br />
===Meeskond: MoneyG 1.0===<br />
Liikmed:<br />
* Liina Saar<br />
* Mart Raus<br />
* Ando Kiidron<br />
* Andres Kepler<br />
<br />
Meeskonna koduleht: [[MoneyG 1.0]]<br />
<br />
Projekti TFS: [http://452b.visualstudio.com]<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
TODO<br />
===Meeskond: Laener===<br />
Liikmed:<br />
* Martin Kask - programmeerija<br />
* Marko Nõu - programmeerija<br />
* Anto Animägi - projektijuht<br />
<br />
Meeskonna koduleht: [[Laener]]<br />
<br />
Projekti TFS: [https://kaskmartin.visualstudio.com/Laener]<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: Vitamin C#===<br />
Liikmed:<br />
* Marko Belzetski<br />
* Rene Väli<br />
* Kaia Tomson<br />
<br />
Meeskonna koduleht: [[Vitamin C#]]<br />
<br />
Projekti TFS: [https://fevertree.visualstudio.com/Vitamiin%20Csharp https://fevertree.visualstudio.com/Vitamiin%20Csharp]<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: Kingalaenutus===<br />
Liikmed:<br />
* Kristi Saare<br />
* Kersti Maurer<br />
* Liisi Taimre<br />
<br />
<br />
Meeskonna koduleht: [[Kingalaenutus]]<br />
<br />
'''projekti TFS: https://kingalaenutus.visualstudio.com/Kingalaenutus'''<br />
NB! Õppejõud lisatud itcollege aadressiga.<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: Isearve ===<br />
Liikmed:<br />
* Siim Kallari<br />
* Priit Tiganik<br />
<br />
Meeskonna koduleht: [[Isearve]]<br />
<br />
Projekti TFS: [https://isearve.visualstudio.com/IseArve https://isearve.visualstudio.com/IseArve]<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: DevHelp===<br />
Liikmed:<br />
* Martin Jääger (projektijuht)<br />
* Mikk Erlenheim<br />
* Kristo Leemets<br />
Meeskonna koduleht: [[DevHelp]]<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
Projekti TFS: [https://devhelp.visualstudio.com/]<br />
<br />
===Meeskond: Elekter ===<br />
'''Liikmed:'''<br />
* Sigrid Aasma<br />
* Kristo Oidermaa<br />
* Tiit Post<br />
<br />
'''Meeskonna koduleht:''' [[Elekter]]<br />
<br />
'''Projekti TFS:''' [https://elekter.visualstudio.com/Elekter/ https://elekter.visualstudio.com/Elekter]<br />
<br />
'''Retsensioon:''' Projekt FoodBytes (TODO)<br />
<br />
===Meeskond: Battle2048===<br />
Liikmed:<br />
*Andrus Seiman<br />
*Annely Aasalaid<br />
*Kristjan Peterson<br />
<br />
Meeskonna koduleht: [[Battle2048]]<br />
<br />
Projekti TFS:<br />
TODO<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: EasyDesk===<br />
Liikmed:<br />
* Marju Pütsepp<br />
<br />
Meeskonna koduleht: [[EasyDesk]]<br />
<br />
Projekti TFS: https://marjup.visualstudio.com/EasyDesk<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: Ajamasin===<br />
Liikmed:<br />
* Liina Hellerma<br />
* Teele Sepman<br />
<br />
Meeskonna koduleht:[[Ajamasin]]<br />
<br />
Projekti TFS: https://teelesepman.visualstudio.com/Ajamasin/ (https://ajamasin.visualstudio.com/Ajamasin)<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: Jarvis===<br />
Liikmed:<br />
<br />
* Grigori Palamartšuk - Scrum Master & Product owner<br />
* Andrei Grigorjev - arendaja<br />
* Artyom Likhachev - arendaja<br />
* Maksim Tšeljabov - arendaja<br />
<br />
Meeskonna koduleht: [https://wiki.itcollege.ee/index.php/JARVIS Jarvis]<br />
<br />
Projekti TFS: [https://grigorip.visualstudio.com/Jarvis Jarvis]<br />
<br />
'''Retsensioonid'''<br />
TBD<br />
<br />
'''Lõpptoode'''<br />
TBD<br />
<br />
===Meeskond: TikTokTek===<br />
Liikmed:<br />
* Eva Ibrus<br />
* Rain Saarmäe<br />
'''Meeskonna koduleht'''<br />
[[TikTokTek]]<br />
<br />
'''TFS'''<br />
https://tiktoktek.visualstudio.com<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: Rahaplaneerija===<br />
Liikmed:<br />
* Maila Keerus<br />
* Kersti Miller<br />
* Evelin Jõgi<br />
<br />
Meeskonna koduleht:<br />
[[Rahaplaneerija]]<br />
<br />
Projekti TFS: [https://rahaplaneerija.visualstudio.com/Rahaplaneerija Rahaplaneerija]<br />
<br />
'''Retsensioonid''':<br />
[[Talk:EasyDesk]]<br />
<br />
'''Lõpptoode''':<br />
TODO<br />
<br />
===Meeskond: Garden of Towers===<br />
Liikmed:<br />
* Nele Sergejeva<br />
<br />
Meeskonna koduleht:<br />
https://wiki.itcollege.ee/index.php/Garden_of_Towers<br />
<br />
Projekti TFS: https://gardenoftowers.visualstudio.com/<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: FoodCab===<br />
Liikmed:<br />
* Mario Mustasaar<br />
* Peeter Ploom<br />
* Rain Elken<br />
* Roland Türi<br />
<br />
Meeskonna koduleht:<br />
https://wiki.itcollege.ee/index.php/FoodCab<br />
<br />
Projekti TFS: https://foodcab.visualstudio.com/<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: MyLibrary===<br />
Liikmed:<br />
* Madis Uudam - projektijuht, arendaja<br />
* Olle Mikk - arendaja<br />
<br />
Meeskonna koduleht: https://mylibrary16.wordpress.com/<br />
<br />
Projekti TFS:<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
=== Meeskond: OnTime ===<br />
Liikmed:<br />
*Tatjana Kruglova<br />
<br />
Meeskonna koduleht:<br />
https://wiki.itcollege.ee/index.php/OnTime<br />
<br />
Projetki TFS: https://ontimekruglova.visualstudio.com/OnTime/<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
=== Meeskond: FoodBytes ===<br />
Liikmed:<br />
*Aet Udusaar<br />
*Taavi Põder<br />
<br />
Meeskonna koduleht:<br />
https://wiki.itcollege.ee/index.php/FoodBytes<br />
<br />
Projekti TFS: https://foodbytes.visualstudio.com/FoodBytes/<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: SeDuM===<br />
Liikmed:<br />
*Liina Laumets <br />
<br />
Meeskonna koduleht: [[Meeskond: SeDuM]]<br />
<br />
Projekti TFS:<br />
<br />
'''Retsensioonid'''<br />
<br />
'''Prototüüp'''<br />
<br />
'''Lõpptoode'''</div>
Saasma
https://wiki.itcollege.ee/index.php?title=Juhend:_Kodut%C3%B6%C3%B6_aines_%22Programmeerimine_CSharp_keeles%22_(2016)&diff=113913
Juhend: Kodutöö aines "Programmeerimine CSharp keeles" (2016)
2016-11-04T12:49:51Z
<p>Saasma: /* Meeskond: Elekter */</p>
<hr />
<div>=Kodutöö aines "Programmeerimine C# keeles"=<br />
<br />
==Eesmärk==<br />
Saada praktiline arenduskogemus .NET keskkonnas ning arendada meeskonnatöö kogemust ja analüüsivõimet. Kasutada arendusprotsessis koodihoidlat.<br />
<br />
==Reeglid==<br />
Ühte projektimeeskonda kuulub 3-5 tudengit(Soovituslik meeskonna suurus on 3-4). Ühel teemal võib teostada projekti üks või mitu meeskonda.Töö käiku kajastatakse https://wiki.itcollege.ee keskkonnas või soovi korral võib seda teha ka ajaveebis(blogis).<br />
Ajaveebi pidamise eesmärke on kaks: nii on võimalik kirja panna kõik mõtted ja ideed (ning nendest jääb jälg ja dokumentatsioon) ning õppejõul on hiljem võimalik saada ülevaade iga projektimeeskonna liikme panusest. Ajaveebi loob ja ajaveebi haldab projektimeeskond vabalt valitud (avalikus) keskkonnas. <br />
<br />
'''Projekti loomine ja arendamine '''<br />
Projekt lisatakse versioonihaldusesse, kasutades selleks [Team Foundation Service'it http://tfs.visualstudio.com/] ning õppejõule antakse ligipääs. Õppejõu live id: maitposka ät hotmail.com . Projekt peab olema alates algfaasist lisatud TFSi ning kogu tööprotsess toimub versioonihaldust kasutades<br />
<br />
'''Tööde esitamine''' (prototüüb ja lõpptoode)<br />
Töö esitamisel pakitakse see kokku ning lisatakse wiki leheküljele link lähtekoodile. Kui töö lähtekoodi ei soovita mingil põhjusel avalikustata, tuleb õppejõuga selle jaoks sõlmida eraldi kokkulepe. Lähtekood on vajalik, et tööd oleks võimalik hinnata nii õppejõul kui kaastudengitel selle kohta retsensiooni kirjutada.<br />
<br />
'''Team Foundation Service kasutamine''' (tänasel päeval '' Visual Studio online'')<br />
[http://www.visualstudio.com/get-started/sign-up-for-visual-studio-online Step-by-Step juhend]<br />
<br />
NB! Versioonihalduse kohta jagab õppejõud materjale.<br />
<br />
==Tähtaegadest kinnipidamine==<br />
Projekt jaguneb alamosadeks, millele on määratud tähtajad. Tähtaegade ületamisel võimalike punkte ei kaotata. Kui töö aga on esitatud tähtajaks, siis on võimalik selle eest teenida boonuspunkte (enamasti 0-10% võimalikust maksimumist boonust). Enne tähtaega esitatud töö ei tähenda automaatselt maksimumpunkte, kui see ei ole sooritatud korralikult.<br />
<br />
NB! Juhul kui analüüsi tähtajast on möödunud nädal, määrab õppejõud meeskonnale ise vabalt valitud ülesande, mis on võetud näidis teemade alt. Peale seda ei ole võimalik teemat enam muuta.<br />
<br />
==Hindamine==<br />
Teostatuks loetakse projekt juhul, kui lähteülesanne on realiseeritud, lahendus on töötav, kuid esineb suuremaid vigu ning piirsituatsioonidega ei ole arvestatud.<br />
Maksimumtulemuse saavutamiseks peab projekt olema teostatud tehniliselt veatult ning varustatud dokumentatsiooniga, milles sisaldub arendusprotsessi kirjeldus (peab selguma ka iga rühmaliikme panus projekti teostamisel), kasutajajuhend ning lahenduse kirjeldus. Tehnilisi ja vormistuslike puudujääke on võimalik korvata lisavõimaluste realiseerimisega.Üldjuhul tuleb loodud lahendust ka praktikumides või loengutes teistele tudengitele tutvustada (ca 10 min).<br />
Nagu eelpool mainitud, koosneb projekt erinevatest osadest. Punktide arvu määramisel arvestatakse ka tähtajast kinni pidamist, mille toimimisloogika on kirjeldatud eespool.<br />
<br />
===Meeskonna kokkupanek ja idee===<br />
'''27.10.2016''' (2p) (Kuna vahepeal oli loengute toimumise kord paigast ära ning TFSi loomisega on segadust olnud, siis nihutan seda tähtaega)<br />
<br />
Tekitatakse meeskonna wiki lehekülg. Meeskonnal peab olema nimi ning see koosneb kolmest kuni viiest liikmest. Määratakse projektijuht. Juhul kui hakatakse blogi pidama kuskil mujal keskkonnas ilmub selle kohta link. Lühidalt peaks kirjeldama idee olemust nii, et selle üldine suund oleks arusaadav. Samuti peab olema märgitud tehnoloogia, milles hakatakse rakendust looma. Meeskond on loonud TFSi konto ning on saatnud õppejõule kutse.<br />
<br />
===Analüüs===<br />
'''01.11.2016''' (4p)<br />
Analüütilise osa eesmärgiks on arendada tudengite analüüsioskust, mida on vaja ka päris tarkvaraarenduse protsessi juures.'''NB! Miinimum sõnade arv 700''' Selle osa käigus peab valmima loodava rakenduse analüüs, mis sisaldab muu hulgas ka:<br />
*Analüüs rakendusele. (Mida see endas sisaldab? Mis on selle eesmärk? Mida tavakasutaja sellega teha saaks? Milliste osade realiseerimine võib osutuda problemaatiliseks?) Kui on tööjaotus paigas, siis tuua ka see välja.<br />
*Tuua välja nimekiri funktsionaalsusest, mida plaanitakse kindlasti teostada(''Must have'')<br />
*Nimekiri funktsionaalsustest, mis võiks olla, aga mida ei pruugita ajapuuduse tõttu realiseerida.(''Nice to have'')<br />
<br />
'''Retsensioon''' 08.11.2016 (3p)<br />
<br />
===Prototüüp + esitlemine===<br />
'''20.11.2016 '''(10p)<br />
<br />
Valmib projekti esmane realisatsioon. Laias laastus on peafunktsionaalsused realiseeritud(Nimekiri funktsionaalsusest, mida plaanitakse teostada). Rakenduses on loodud erinevad vaated, mis võimaldavad ülevaate rakendusest saada.<br />
<br />
20. novembril esitatakse prototüüp, mida kaitstakse sellele järgneval nädalal. NB! Juhul kui prototüüpi ei kaitsa ja ei esitata, siis ei ole võimalik selle osa eest punkte saada.<br />
<br />
===Lõpptoode===<br />
'''18.12.2016'''(30p)<br />
Selleks faasiks peab projekt maksimumpuntkide saavutamiseks olema teostatud tehniliselt veatult ning varustatud dokumentatsiooniga, milles sisaldub arendusprotsessi kirjeldus (peab selguma ka iga rühmaliikme panus projekti teostamisel), kasutajajuhend ning lahenduse kirjeldus.<br />
<br />
'''Retsensioon''' 08.01.2016(4p)<br />
<br />
===Esitlus/Kaitsmine=== <br />
<br />
'''Toimub loengutes/praktikumides või kokkulepitud ajal enne eksamit''' ''(3p) ''<br />
Esitlusel kaitstakse projekti. Tutvustatakse tehnoloogiat, mida kasutati rakenduse realiseerimiseks. Lühidalt räägitakse tööjaotusest ning probleemidest, mis tekkisid projekti realiseerimisel. Näidatakse lähtekoodi ja demonstreeritakse oma rakendust teistele tudengitele, kes võivad selle kohta küsimusi küsida. Kestvus ~20min.<br />
<br />
====Kaitsmise ajad====<br />
<br />
Siia alla ilmuvad detsembris kaitsmise ajad.<br />
<br />
Ideaalne esitlus, sisaldab endas ka powerpointi, kus on<br />
*väljatoodud meeskonna nimi ja liikmed<br />
*idee<br />
*realiseerimine<br />
*mis oli keerukas?<br />
*mida uut õpiti?<br />
*mõnede keerulisemate probleemide lahendamine<br />
*meeskonnaliikmete panus<br />
<br />
Kaitsmise käigus vaadatakse üle ka kood.<br />
<br />
=Teemad 2016 sügis=<br />
Kodutööna tuleb luua:<br />
<br />
==Nõuded rakendusele==<br />
Loodav rakendus peab:<br />
* Peab kasutama andmebaasi (erikokkuleppel ka XML formaadis andmeallikat)<br />
**Andmebaasis peab olema vähemalt 6 andmebaasi tabelit<br />
* Peab võimaldama tegevuste kohta registri pidamist (logi)<br />
**Rakenduses tehtavad tegevused salvestatakse<br />
* Kasutama kasutajaliidesena ühte järgmistest: Windows Presentation Foundation, Windows Phone , Windows Store App või ASP.Net<br />
* Kood on kommenteeritud ning rakendus on varustatud dokumentatsiooniga<br />
* Maksimumpunktide jaoks kasutatakse vastavalt valitud tehnoloogiale soovitatud arendusmustreid<br />
* Kood on kirjutatud C# programmeerimiskeeles<br />
**Kuna aine nimi on "Programmeerimine C# keeles" ei tohi esitada rakendust, mis on loodud Javas, PHPs vms keeles<br />
* Rakendus on jaotatud kihtidesse<br />
'''Loodav rakendus peab olema loodud objektorienteeritud lähenemist kasutades!''' Klassid, klassid, klassid<br />
*Kood on kommenteeritud<br />
<br />
Lisapunkte annab:<br />
* Silmailu<br />
* Kood on kirjutatud häid praktikaid järgides ja on veatu(testimine, testimine, testimine)<br />
* Orginaalsed ideed ja hea äriidee<br />
<br />
==Kodune raamatukogu==<br />
Kodudes on tihti erinevaid raamatuid (filme, muud nänni) ja sõbrad tahavad neid vahel laenutada.<br />
Loo rakendus, mis<br />
* Võimaldaks sisestada kodused raamatud<br />
* Võimaldaks luua laenutajate profiile<br />
* Raamatuid välja laenutada (tähtajaliselt)<br />
* Laseks koostada erinevaid aruandeid (kodusolevad raamatud, väljalaenutatud raamatud, tähtaja ületanud laenutused jne)<br />
<br />
<br />
Lisavõimalused<br />
* Kui laenutaja profiilis on e-mail, siis saada automaatselt e-kiri „kallis sõber see ja see, Sinu käes on minu raamat, kas tood tagasi ka?”<br />
* Kuva hoiatused, kui laenutaja laenutuste ajalugu on vilets või kui mõni raamat on tagastamata.<br />
* Lase lisada raamatutele pilt<br />
* Loo lihtne veebiliides (et sõbrad saaksid veebist vaadata, mis raamatud kasutajal kodus veel alles on)<br />
Või<br />
<br />
==CRM==<br />
Oma klientidest peab olema ülevaade.<br />
Loo rakendus, mis võimaldab:<br />
* Kliente ning nende kontaktisikuid sisestada, muuta ning kustutada<br />
* Võimalda sisestada kliendikontakte<br />
* Koostada hinnapakkumisi klientidele, kusjuures hinnapakkumine lisatakse süsteemi ka kui kliendikontakt ning saadetakse samast süsteemist kliendile.<br />
* Kliendi andmete vaatamisel kuvatakse ka kliendikontaktid<br />
<br />
<br />
Lisavõimalused<br />
* Loo võimalus, kus kontaktisiku sünnipäeva saabumisel saadetakse automaatselt inimesele meil õnnesoovidega<br />
* Õnnitlusmeilide template’sid võiks olla mitu<br />
* Loo võimalus kliendi huvide (huvialade) kajastamiseks süsteemis<br />
<br />
==Mäng(Unit)==<br />
Loodav mäng peab sisaldama:<br />
* Erinevaid tasemeid<br />
* Punktiarvestust<br />
* XBox puldi tuge<br />
* Klaviatuurilt juhtimise tuge<br />
<br />
'''Loodav mäng peab olema loodud objektorienteeritud lähenemist kasutades!''' Klassid, klassid, klassid<br />
<br />
Lisapunkte annab:<br />
* Silmailu<br />
* Kood on kirjutatud häid praktikaid järgides ja on veatu(testimine, testimine, testimine)<br />
* Orginaalsed ideed ja hea ''story''<br />
<br />
=Meeskonnad 2016=<br />
==Päevaõpe==<br />
<br />
===Meeskond: Kuri Kohvikupidaja===<br />
Liikmed:<br />
* Egert Aia<br />
Meeskonna koduleht: [[Kuri_Kohvikupidaja]]<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
Kättesaadav siit: https://drive.google.com/open?id=0BxPYMOn_Lvs6U3g2Rm53TTNZWmc<br />
<br />
Sisse saab logida jalutsis vajutades login<br />
<br />
admini log: 1@eesti.ee<br />
<br />
admini pw: a<br />
<br />
<br />
PS! Checkboxe valides vali esimest checkboxi nii et teed selle aktiivseks ja siis võtad linnukese jälle ära, pärast seda kõik checkboxid töötavad ilusti! =)<br />
<br />
===Meeskond: Pirate Netflix===<br />
Liikmed:<br />
* Arti Zirk<br />
* Mihkel Vajak<br />
* Janno Oolo<br />
* Joosep Voolmaa<br />
Meeskonna koduleht: [[Pirate_Netflix]]<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: D♭===<br />
Liikmed:<br />
* Semjon Greef<br />
* Martin Arusalu<br />
* Martin Nõukas<br />
* Roomet Saadi<br />
Meeskonna koduleht: [[Meeskond: D♭]]<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: ParkWell===<br />
Liikmed:<br />
* Taavi Vesinurm<br />
* Raido Vell<br />
* Madis Roosioks<br />
Meeskonna koduleht: [[ParkWell]]<br />
<br />
Projekti TFS: [https://park-well.visualstudio.com/ParkWell SIIN]<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: Bomory===<br />
Liikmed:<br />
* Hando Laasmägi<br />
* Tarvo Tammejuur<br />
* Cathy Toomast<br />
Meeskonna koduleht: [[Bomory]]<br />
<br />
'''TFS'''<br />
https://eikbomory.visualstudio.com/Bomory<br />
<br />
'''Analüüs'''<br />
Õppejõule saadetud 01.11.2016.<br />
https://wiki.itcollege.ee/index.php/Bomory#Anal.C3.BC.C3.BCs<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: Kassarakendus===<br />
Liikmed:<br />
* Mikk Sarapuu<br />
* Meelis Sääsk<br />
* Piret Pomerants<br />
Meeskonna koduleht: [[Kassarakendus]]<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: Pie Piper===<br />
Liikmed:<br />
* Villem Markus Loigom<br />
* Olari Pipenberg<br />
* Uku-Mart Uprus<br />
* Ardo Erik<br />
Meeskonna koduleht: [[Pie_Piper]]<br />
<br />
'''Retsensioonid'''<br />
NA<br />
<br />
'''Lõpptoode'''<br />
NA<br />
<br />
<br />
===Meeskond: Hidden Mustard===<br />
Liikmed:<br />
* Andreas Kirotar<br />
* Tõnn Vaher<br />
* Aivar Romandi<br />
* Anneli Asser<br />
Meeskonna koduleht: [[Hidden_Mustard]]<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: B12===<br />
Liikmed:<br />
* Kerdo Kullamäe<br />
* Marvin Mardiat<br />
* Martin Paakspuu<br />
Meeskonna koduleht: [[B12]]<br />
<br />
Projekti TFS: https://b12tiim.visualstudio.com/B12/<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: Elibrium ===<br />
Liikmed:<br />
* Märt Häkkinen<br />
* Karl Frank<br />
Meeskonna koduleht: [[Elibrium]]<br />
<br />
Projekti TFS: https://m-hakkinen.visualstudio.com/Elibrium<br />
<br />
'''Retsensioonid'''<br />
*Analüüsi retsensioon meeskonnale '''Gurmaanid''' asub [https://wiki.itcollege.ee/index.php/Talk:Meeskond:_Gurmaanid siin]<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: CozinHero ===<br />
Liikmed:<br />
* Taavi Metsvahi<br />
* Kai Kallastu<br />
Meeskonna koduleht: [[CozinHero]]<br />
<br />
Projekti TFS: https://metsvahi.visualstudio.com/CozinHero<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: Bank ===<br />
Liikmed:<br />
* Aleksei Kopõlov<br />
* Teet Adamson<br />
* Sander Perens<br />
* Tarvo Sbitnev<br />
Meeskonna koduleht: [https://wiki.itcollege.ee/index.php/Bank Bank]<br />
<br />
Projekti TFS: https://perens.visualstudio.com/Projekt%20Bank/tiimi%20nimi<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: ATDV===<br />
Liikmed:<br />
* Aldin Talve - arendaja<br />
* Delia Viirmaa - projektijuht<br />
* Mart-Erki Nõumees - arendaja<br />
<br />
Meeskonna koduleht: [[ATDV]]<br />
<br />
ADTV TFS: [https://adtvmn.visualstudio.com/ADTV SIIN]<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: Sõnajalg===<br />
Liikmed:<br />
* Argo Hansen<br />
* Ragnar Rästas<br />
Meeskonna koduleht: [[Sõnajalg]]<br />
<br />
Projekti TFS: https://sonajalg-itk.visualstudio.com/<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond:Gurmaanid===<br />
Liikmed:<br />
* Koit Kõrvel<br />
* Marko Kask<br />
* Brita Pentšuk<br />
* Ott Sõerumäe<br />
Meeskonna koduleht: [[Gurmaanid]]<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: Korterid Kõrgel Künkal===<br />
Liikmed:<br />
* Edward Mardo<br />
Meeskonna koduleht: [[Korterid_Kõrgel_Künkal]]<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: Librarians===<br />
Liikmed:<br />
* Kerttu Liis Lootus<br />
* Lisandra Noor<br />
* Lisette Noor<br />
Meeskonna koduleht: [[Librarians]]<br />
<br />
Projekti TFS: https://klootus.visualstudio.com/Librarians<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: Brainery===<br />
Liikmed:<br />
* Madis Lugus<br />
* Elina Kuldkepp<br />
* Berit Põldoja<br />
* Taavi Teearu<br />
Meeskonna koduleht: [[Brainery]]<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: Rent A Book===<br />
Liikmed:<br />
* Aapo Kersalu<br />
* Kristjan Kotto<br />
* Paul John Niidas<br />
<br />
Meeskonna koduleht: [[Rent A Book]]<br />
<br />
'''Retsensioonid''" <br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: BMS===<br />
Liikmed:<br />
* Kert Kukk<br />
Meeskonna koduleht: [[BMS]]<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: Dogify===<br />
Liikmed:<br />
* Roland Soosaar<br />
* Krista Norak<br />
* Mihkel Roots<br />
<br />
Meeskonna koduleht [[Dogify]]<br />
<br />
'''Projekti TFS:''' https://rososa.visualstudio.com/Dogify/<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: ForeverNotes===<br />
Liikmed:<br />
* Margus Muru<br />
* Joosep Koort<br />
* Martin Nigul<br />
Meeskonna koduleht: [[ForeverNotes]]<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: NullPointerException===<br />
Liikmed:<br />
* Kertu Nurmberg<br />
* Tõnis Piirits<br />
Meeskonna koduleht: [[NullPointerException]]<br />
<br />
'''Projekti TFS:''' https://null-pointer-exception.visualstudio.com/CSGO%20Triggerbot<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
==Kaugõpe==<br />
<br />
===Meeskond: Autoparandaja===<br />
Liikmed:<br />
* Mihkel Viilveer<br />
Meeskonna koduleht: [[Autoparandaja]]<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
'''TFS'''<br />
https://tostukid.visualstudio.com<br />
<br />
===Meeskond: Paabel===<br />
Liikmed:<br />
* Rutt Lindström<br />
* Esta Prangel<br />
* Krista Rüütel<br />
* Liina Abner<br />
<br />
Meeskonna koduleht: [[Paabel]]<br />
<br />
'''Retsensioonid'''<br />
TODO Projekti "Isearve" retsensioon: [[Talk:Isearve]]<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: Agraarbeib===<br />
<br />
Liikmed:<br />
* Kaia Runthal<br />
* Marianne Trubetskoi<br />
* Taavi Tilk<br />
* Mihkel Matson<br />
<br />
Meeskonna koduleht: [[Agraarbeib]]<br />
<br />
Projekti TFS: https://kaia.visualstudio.com/MeieTalu<br />
<br />
'''Analüüs (01.11)'''<br />
[https://wiki.itcollege.ee/index.php/Agraarbeib/Analyys Analüüs Wikis]<br />
<br />
'''Analüüsi retsensioon (08.11) TODO'''<br />
[https://wiki.itcollege.ee/index.php/Agraarbeib/AnalüüsiRetsensioon Retsensioon meeskonna [[Elekter]] analüüsile]<br />
<br />
'''Prototüüp (20.11) TODO''' <br />
[https://wiki.itcollege.ee/index.php/Agraarbeib/Prototüüp Prototüüp]<br />
<br />
'''Lõpptoode (18.12) TODO''' <br />
[https://wiki.itcollege.ee/index.php/Agraarbeib/Lõpptoode Lõpptoode]<br />
<br />
'''Lõpptoote retsensioon (08.01) TODO''' <br />
[https://wiki.itcollege.ee/index.php/Agraarbeib/LõpptooteRetsensioon Retsensioon meeskonna ??? tootele]<br />
<br />
===Meeskond: MoneyG 1.0===<br />
Liikmed:<br />
* Liina Saar<br />
* Mart Raus<br />
* Ando Kiidron<br />
* Andres Kepler<br />
<br />
Meeskonna koduleht: [[MoneyG 1.0]]<br />
<br />
Projekti TFS: [http://452b.visualstudio.com]<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
TODO<br />
===Meeskond: Laener===<br />
Liikmed:<br />
* Martin Kask - programmeerija<br />
* Marko Nõu - programmeerija<br />
* Anto Animägi - projektijuht<br />
<br />
Meeskonna koduleht: [[Laener]]<br />
<br />
Projekti TFS: [https://kaskmartin.visualstudio.com/Laener]<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: Vitamin C#===<br />
Liikmed:<br />
* Marko Belzetski<br />
* Rene Väli<br />
* Kaia Tomson<br />
<br />
Meeskonna koduleht: [[Vitamin C#]]<br />
<br />
Projekti TFS: [https://fevertree.visualstudio.com/Vitamiin%20Csharp https://fevertree.visualstudio.com/Vitamiin%20Csharp]<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: Kingalaenutus===<br />
Liikmed:<br />
* Kristi Saare<br />
* Kersti Maurer<br />
* Liisi Taimre<br />
<br />
<br />
Meeskonna koduleht: [[Kingalaenutus]]<br />
<br />
'''projekti TFS: https://kingalaenutus.visualstudio.com/Kingalaenutus'''<br />
NB! Õppejõud lisatud itcollege aadressiga.<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: Isearve ===<br />
Liikmed:<br />
* Siim Kallari<br />
* Priit Tiganik<br />
<br />
Meeskonna koduleht: [[Isearve]]<br />
<br />
Projekti TFS: [https://isearve.visualstudio.com/IseArve https://isearve.visualstudio.com/IseArve]<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: DevHelp===<br />
Liikmed:<br />
* Martin Jääger (projektijuht)<br />
* Mikk Erlenheim<br />
* Kristo Leemets<br />
Meeskonna koduleht: [[DevHelp]]<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
Projekti TFS: [https://devhelp.visualstudio.com/]<br />
<br />
===Meeskond: Elekter ===<br />
Liikmed:<br />
* Sigrid Aasma<br />
* Kristo Oidermaa<br />
* Tiit Post<br />
<br />
'''Meeskonna koduleht:''' [[Elekter]]<br />
<br />
'''Projekti TFS:''' [https://elekter.visualstudio.com/Elekter/ https://elekter.visualstudio.com/Elekter]<br />
<br />
'''Retsensioon:''' Projekt FoodBytes (TODO)<br />
<br />
===Meeskond: Battle2048===<br />
Liikmed:<br />
*Andrus Seiman<br />
*Annely Aasalaid<br />
*Kristjan Peterson<br />
<br />
Meeskonna koduleht: [[Battle2048]]<br />
<br />
Projekti TFS:<br />
TODO<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: EasyDesk===<br />
Liikmed:<br />
* Marju Pütsepp<br />
<br />
Meeskonna koduleht: [[EasyDesk]]<br />
<br />
Projekti TFS: https://marjup.visualstudio.com/EasyDesk<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: Ajamasin===<br />
Liikmed:<br />
* Liina Hellerma<br />
* Teele Sepman<br />
<br />
Meeskonna koduleht:[[Ajamasin]]<br />
<br />
Projekti TFS: https://teelesepman.visualstudio.com/Ajamasin/ (https://ajamasin.visualstudio.com/Ajamasin)<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: Jarvis===<br />
Liikmed:<br />
<br />
* Grigori Palamartšuk - Scrum Master & Product owner<br />
* Andrei Grigorjev - arendaja<br />
* Artyom Likhachev - arendaja<br />
* Maksim Tšeljabov - arendaja<br />
<br />
Meeskonna koduleht: [https://wiki.itcollege.ee/index.php/JARVIS Jarvis]<br />
<br />
Projekti TFS: [https://grigorip.visualstudio.com/Jarvis Jarvis]<br />
<br />
'''Retsensioonid'''<br />
TBD<br />
<br />
'''Lõpptoode'''<br />
TBD<br />
<br />
===Meeskond: TikTokTek===<br />
Liikmed:<br />
* Eva Ibrus<br />
* Rain Saarmäe<br />
'''Meeskonna koduleht'''<br />
[[TikTokTek]]<br />
<br />
'''TFS'''<br />
https://tiktoktek.visualstudio.com<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: Rahaplaneerija===<br />
Liikmed:<br />
* Maila Keerus<br />
* Kersti Miller<br />
* Evelin Jõgi<br />
<br />
Meeskonna koduleht:<br />
[[Rahaplaneerija]]<br />
<br />
Projekti TFS: [https://rahaplaneerija.visualstudio.com/Rahaplaneerija Rahaplaneerija]<br />
<br />
'''Retsensioonid''':<br />
[[Talk:EasyDesk]]<br />
<br />
'''Lõpptoode''':<br />
TODO<br />
<br />
===Meeskond: Garden of Towers===<br />
Liikmed:<br />
* Nele Sergejeva<br />
<br />
Meeskonna koduleht:<br />
https://wiki.itcollege.ee/index.php/Garden_of_Towers<br />
<br />
Projekti TFS: https://gardenoftowers.visualstudio.com/<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: FoodCab===<br />
Liikmed:<br />
* Mario Mustasaar<br />
* Peeter Ploom<br />
* Rain Elken<br />
* Roland Türi<br />
<br />
Meeskonna koduleht:<br />
https://wiki.itcollege.ee/index.php/FoodCab<br />
<br />
Projekti TFS: https://foodcab.visualstudio.com/<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: MyLibrary===<br />
Liikmed:<br />
* Madis Uudam - projektijuht, arendaja<br />
* Olle Mikk - arendaja<br />
<br />
Meeskonna koduleht: https://mylibrary16.wordpress.com/<br />
<br />
Projekti TFS:<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
=== Meeskond: OnTime ===<br />
Liikmed:<br />
*Tatjana Kruglova<br />
<br />
Meeskonna koduleht:<br />
https://wiki.itcollege.ee/index.php/OnTime<br />
<br />
Projetki TFS: https://ontimekruglova.visualstudio.com/OnTime/<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
=== Meeskond: FoodBytes ===<br />
Liikmed:<br />
*Aet Udusaar<br />
*Taavi Põder<br />
<br />
Meeskonna koduleht:<br />
https://wiki.itcollege.ee/index.php/FoodBytes<br />
<br />
Projekti TFS: https://foodbytes.visualstudio.com/FoodBytes/<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: SeDuM===<br />
Liikmed:<br />
*Liina Laumets <br />
<br />
Meeskonna koduleht: [[Meeskond: SeDuM]]<br />
<br />
Projekti TFS:<br />
<br />
'''Retsensioonid'''<br />
<br />
'''Prototüüp'''<br />
<br />
'''Lõpptoode'''</div>
Saasma
https://wiki.itcollege.ee/index.php?title=Juhend:_Kodut%C3%B6%C3%B6_aines_%22Programmeerimine_CSharp_keeles%22_(2016)&diff=113912
Juhend: Kodutöö aines "Programmeerimine CSharp keeles" (2016)
2016-11-04T12:49:04Z
<p>Saasma: /* Meeskond: Elekter */</p>
<hr />
<div>=Kodutöö aines "Programmeerimine C# keeles"=<br />
<br />
==Eesmärk==<br />
Saada praktiline arenduskogemus .NET keskkonnas ning arendada meeskonnatöö kogemust ja analüüsivõimet. Kasutada arendusprotsessis koodihoidlat.<br />
<br />
==Reeglid==<br />
Ühte projektimeeskonda kuulub 3-5 tudengit(Soovituslik meeskonna suurus on 3-4). Ühel teemal võib teostada projekti üks või mitu meeskonda.Töö käiku kajastatakse https://wiki.itcollege.ee keskkonnas või soovi korral võib seda teha ka ajaveebis(blogis).<br />
Ajaveebi pidamise eesmärke on kaks: nii on võimalik kirja panna kõik mõtted ja ideed (ning nendest jääb jälg ja dokumentatsioon) ning õppejõul on hiljem võimalik saada ülevaade iga projektimeeskonna liikme panusest. Ajaveebi loob ja ajaveebi haldab projektimeeskond vabalt valitud (avalikus) keskkonnas. <br />
<br />
'''Projekti loomine ja arendamine '''<br />
Projekt lisatakse versioonihaldusesse, kasutades selleks [Team Foundation Service'it http://tfs.visualstudio.com/] ning õppejõule antakse ligipääs. Õppejõu live id: maitposka ät hotmail.com . Projekt peab olema alates algfaasist lisatud TFSi ning kogu tööprotsess toimub versioonihaldust kasutades<br />
<br />
'''Tööde esitamine''' (prototüüb ja lõpptoode)<br />
Töö esitamisel pakitakse see kokku ning lisatakse wiki leheküljele link lähtekoodile. Kui töö lähtekoodi ei soovita mingil põhjusel avalikustata, tuleb õppejõuga selle jaoks sõlmida eraldi kokkulepe. Lähtekood on vajalik, et tööd oleks võimalik hinnata nii õppejõul kui kaastudengitel selle kohta retsensiooni kirjutada.<br />
<br />
'''Team Foundation Service kasutamine''' (tänasel päeval '' Visual Studio online'')<br />
[http://www.visualstudio.com/get-started/sign-up-for-visual-studio-online Step-by-Step juhend]<br />
<br />
NB! Versioonihalduse kohta jagab õppejõud materjale.<br />
<br />
==Tähtaegadest kinnipidamine==<br />
Projekt jaguneb alamosadeks, millele on määratud tähtajad. Tähtaegade ületamisel võimalike punkte ei kaotata. Kui töö aga on esitatud tähtajaks, siis on võimalik selle eest teenida boonuspunkte (enamasti 0-10% võimalikust maksimumist boonust). Enne tähtaega esitatud töö ei tähenda automaatselt maksimumpunkte, kui see ei ole sooritatud korralikult.<br />
<br />
NB! Juhul kui analüüsi tähtajast on möödunud nädal, määrab õppejõud meeskonnale ise vabalt valitud ülesande, mis on võetud näidis teemade alt. Peale seda ei ole võimalik teemat enam muuta.<br />
<br />
==Hindamine==<br />
Teostatuks loetakse projekt juhul, kui lähteülesanne on realiseeritud, lahendus on töötav, kuid esineb suuremaid vigu ning piirsituatsioonidega ei ole arvestatud.<br />
Maksimumtulemuse saavutamiseks peab projekt olema teostatud tehniliselt veatult ning varustatud dokumentatsiooniga, milles sisaldub arendusprotsessi kirjeldus (peab selguma ka iga rühmaliikme panus projekti teostamisel), kasutajajuhend ning lahenduse kirjeldus. Tehnilisi ja vormistuslike puudujääke on võimalik korvata lisavõimaluste realiseerimisega.Üldjuhul tuleb loodud lahendust ka praktikumides või loengutes teistele tudengitele tutvustada (ca 10 min).<br />
Nagu eelpool mainitud, koosneb projekt erinevatest osadest. Punktide arvu määramisel arvestatakse ka tähtajast kinni pidamist, mille toimimisloogika on kirjeldatud eespool.<br />
<br />
===Meeskonna kokkupanek ja idee===<br />
'''27.10.2016''' (2p) (Kuna vahepeal oli loengute toimumise kord paigast ära ning TFSi loomisega on segadust olnud, siis nihutan seda tähtaega)<br />
<br />
Tekitatakse meeskonna wiki lehekülg. Meeskonnal peab olema nimi ning see koosneb kolmest kuni viiest liikmest. Määratakse projektijuht. Juhul kui hakatakse blogi pidama kuskil mujal keskkonnas ilmub selle kohta link. Lühidalt peaks kirjeldama idee olemust nii, et selle üldine suund oleks arusaadav. Samuti peab olema märgitud tehnoloogia, milles hakatakse rakendust looma. Meeskond on loonud TFSi konto ning on saatnud õppejõule kutse.<br />
<br />
===Analüüs===<br />
'''01.11.2016''' (4p)<br />
Analüütilise osa eesmärgiks on arendada tudengite analüüsioskust, mida on vaja ka päris tarkvaraarenduse protsessi juures.'''NB! Miinimum sõnade arv 700''' Selle osa käigus peab valmima loodava rakenduse analüüs, mis sisaldab muu hulgas ka:<br />
*Analüüs rakendusele. (Mida see endas sisaldab? Mis on selle eesmärk? Mida tavakasutaja sellega teha saaks? Milliste osade realiseerimine võib osutuda problemaatiliseks?) Kui on tööjaotus paigas, siis tuua ka see välja.<br />
*Tuua välja nimekiri funktsionaalsusest, mida plaanitakse kindlasti teostada(''Must have'')<br />
*Nimekiri funktsionaalsustest, mis võiks olla, aga mida ei pruugita ajapuuduse tõttu realiseerida.(''Nice to have'')<br />
<br />
'''Retsensioon''' 08.11.2016 (3p)<br />
<br />
===Prototüüp + esitlemine===<br />
'''20.11.2016 '''(10p)<br />
<br />
Valmib projekti esmane realisatsioon. Laias laastus on peafunktsionaalsused realiseeritud(Nimekiri funktsionaalsusest, mida plaanitakse teostada). Rakenduses on loodud erinevad vaated, mis võimaldavad ülevaate rakendusest saada.<br />
<br />
20. novembril esitatakse prototüüp, mida kaitstakse sellele järgneval nädalal. NB! Juhul kui prototüüpi ei kaitsa ja ei esitata, siis ei ole võimalik selle osa eest punkte saada.<br />
<br />
===Lõpptoode===<br />
'''18.12.2016'''(30p)<br />
Selleks faasiks peab projekt maksimumpuntkide saavutamiseks olema teostatud tehniliselt veatult ning varustatud dokumentatsiooniga, milles sisaldub arendusprotsessi kirjeldus (peab selguma ka iga rühmaliikme panus projekti teostamisel), kasutajajuhend ning lahenduse kirjeldus.<br />
<br />
'''Retsensioon''' 08.01.2016(4p)<br />
<br />
===Esitlus/Kaitsmine=== <br />
<br />
'''Toimub loengutes/praktikumides või kokkulepitud ajal enne eksamit''' ''(3p) ''<br />
Esitlusel kaitstakse projekti. Tutvustatakse tehnoloogiat, mida kasutati rakenduse realiseerimiseks. Lühidalt räägitakse tööjaotusest ning probleemidest, mis tekkisid projekti realiseerimisel. Näidatakse lähtekoodi ja demonstreeritakse oma rakendust teistele tudengitele, kes võivad selle kohta küsimusi küsida. Kestvus ~20min.<br />
<br />
====Kaitsmise ajad====<br />
<br />
Siia alla ilmuvad detsembris kaitsmise ajad.<br />
<br />
Ideaalne esitlus, sisaldab endas ka powerpointi, kus on<br />
*väljatoodud meeskonna nimi ja liikmed<br />
*idee<br />
*realiseerimine<br />
*mis oli keerukas?<br />
*mida uut õpiti?<br />
*mõnede keerulisemate probleemide lahendamine<br />
*meeskonnaliikmete panus<br />
<br />
Kaitsmise käigus vaadatakse üle ka kood.<br />
<br />
=Teemad 2016 sügis=<br />
Kodutööna tuleb luua:<br />
<br />
==Nõuded rakendusele==<br />
Loodav rakendus peab:<br />
* Peab kasutama andmebaasi (erikokkuleppel ka XML formaadis andmeallikat)<br />
**Andmebaasis peab olema vähemalt 6 andmebaasi tabelit<br />
* Peab võimaldama tegevuste kohta registri pidamist (logi)<br />
**Rakenduses tehtavad tegevused salvestatakse<br />
* Kasutama kasutajaliidesena ühte järgmistest: Windows Presentation Foundation, Windows Phone , Windows Store App või ASP.Net<br />
* Kood on kommenteeritud ning rakendus on varustatud dokumentatsiooniga<br />
* Maksimumpunktide jaoks kasutatakse vastavalt valitud tehnoloogiale soovitatud arendusmustreid<br />
* Kood on kirjutatud C# programmeerimiskeeles<br />
**Kuna aine nimi on "Programmeerimine C# keeles" ei tohi esitada rakendust, mis on loodud Javas, PHPs vms keeles<br />
* Rakendus on jaotatud kihtidesse<br />
'''Loodav rakendus peab olema loodud objektorienteeritud lähenemist kasutades!''' Klassid, klassid, klassid<br />
*Kood on kommenteeritud<br />
<br />
Lisapunkte annab:<br />
* Silmailu<br />
* Kood on kirjutatud häid praktikaid järgides ja on veatu(testimine, testimine, testimine)<br />
* Orginaalsed ideed ja hea äriidee<br />
<br />
==Kodune raamatukogu==<br />
Kodudes on tihti erinevaid raamatuid (filme, muud nänni) ja sõbrad tahavad neid vahel laenutada.<br />
Loo rakendus, mis<br />
* Võimaldaks sisestada kodused raamatud<br />
* Võimaldaks luua laenutajate profiile<br />
* Raamatuid välja laenutada (tähtajaliselt)<br />
* Laseks koostada erinevaid aruandeid (kodusolevad raamatud, väljalaenutatud raamatud, tähtaja ületanud laenutused jne)<br />
<br />
<br />
Lisavõimalused<br />
* Kui laenutaja profiilis on e-mail, siis saada automaatselt e-kiri „kallis sõber see ja see, Sinu käes on minu raamat, kas tood tagasi ka?”<br />
* Kuva hoiatused, kui laenutaja laenutuste ajalugu on vilets või kui mõni raamat on tagastamata.<br />
* Lase lisada raamatutele pilt<br />
* Loo lihtne veebiliides (et sõbrad saaksid veebist vaadata, mis raamatud kasutajal kodus veel alles on)<br />
Või<br />
<br />
==CRM==<br />
Oma klientidest peab olema ülevaade.<br />
Loo rakendus, mis võimaldab:<br />
* Kliente ning nende kontaktisikuid sisestada, muuta ning kustutada<br />
* Võimalda sisestada kliendikontakte<br />
* Koostada hinnapakkumisi klientidele, kusjuures hinnapakkumine lisatakse süsteemi ka kui kliendikontakt ning saadetakse samast süsteemist kliendile.<br />
* Kliendi andmete vaatamisel kuvatakse ka kliendikontaktid<br />
<br />
<br />
Lisavõimalused<br />
* Loo võimalus, kus kontaktisiku sünnipäeva saabumisel saadetakse automaatselt inimesele meil õnnesoovidega<br />
* Õnnitlusmeilide template’sid võiks olla mitu<br />
* Loo võimalus kliendi huvide (huvialade) kajastamiseks süsteemis<br />
<br />
==Mäng(Unit)==<br />
Loodav mäng peab sisaldama:<br />
* Erinevaid tasemeid<br />
* Punktiarvestust<br />
* XBox puldi tuge<br />
* Klaviatuurilt juhtimise tuge<br />
<br />
'''Loodav mäng peab olema loodud objektorienteeritud lähenemist kasutades!''' Klassid, klassid, klassid<br />
<br />
Lisapunkte annab:<br />
* Silmailu<br />
* Kood on kirjutatud häid praktikaid järgides ja on veatu(testimine, testimine, testimine)<br />
* Orginaalsed ideed ja hea ''story''<br />
<br />
=Meeskonnad 2016=<br />
==Päevaõpe==<br />
<br />
===Meeskond: Kuri Kohvikupidaja===<br />
Liikmed:<br />
* Egert Aia<br />
Meeskonna koduleht: [[Kuri_Kohvikupidaja]]<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
Kättesaadav siit: https://drive.google.com/open?id=0BxPYMOn_Lvs6U3g2Rm53TTNZWmc<br />
<br />
Sisse saab logida jalutsis vajutades login<br />
<br />
admini log: 1@eesti.ee<br />
<br />
admini pw: a<br />
<br />
<br />
PS! Checkboxe valides vali esimest checkboxi nii et teed selle aktiivseks ja siis võtad linnukese jälle ära, pärast seda kõik checkboxid töötavad ilusti! =)<br />
<br />
===Meeskond: Pirate Netflix===<br />
Liikmed:<br />
* Arti Zirk<br />
* Mihkel Vajak<br />
* Janno Oolo<br />
* Joosep Voolmaa<br />
Meeskonna koduleht: [[Pirate_Netflix]]<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: D♭===<br />
Liikmed:<br />
* Semjon Greef<br />
* Martin Arusalu<br />
* Martin Nõukas<br />
* Roomet Saadi<br />
Meeskonna koduleht: [[Meeskond: D♭]]<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: ParkWell===<br />
Liikmed:<br />
* Taavi Vesinurm<br />
* Raido Vell<br />
* Madis Roosioks<br />
Meeskonna koduleht: [[ParkWell]]<br />
<br />
Projekti TFS: [https://park-well.visualstudio.com/ParkWell SIIN]<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: Bomory===<br />
Liikmed:<br />
* Hando Laasmägi<br />
* Tarvo Tammejuur<br />
* Cathy Toomast<br />
Meeskonna koduleht: [[Bomory]]<br />
<br />
'''TFS'''<br />
https://eikbomory.visualstudio.com/Bomory<br />
<br />
'''Analüüs'''<br />
Õppejõule saadetud 01.11.2016.<br />
https://wiki.itcollege.ee/index.php/Bomory#Anal.C3.BC.C3.BCs<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: Kassarakendus===<br />
Liikmed:<br />
* Mikk Sarapuu<br />
* Meelis Sääsk<br />
* Piret Pomerants<br />
Meeskonna koduleht: [[Kassarakendus]]<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: Pie Piper===<br />
Liikmed:<br />
* Villem Markus Loigom<br />
* Olari Pipenberg<br />
* Uku-Mart Uprus<br />
* Ardo Erik<br />
Meeskonna koduleht: [[Pie_Piper]]<br />
<br />
'''Retsensioonid'''<br />
NA<br />
<br />
'''Lõpptoode'''<br />
NA<br />
<br />
<br />
===Meeskond: Hidden Mustard===<br />
Liikmed:<br />
* Andreas Kirotar<br />
* Tõnn Vaher<br />
* Aivar Romandi<br />
* Anneli Asser<br />
Meeskonna koduleht: [[Hidden_Mustard]]<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: B12===<br />
Liikmed:<br />
* Kerdo Kullamäe<br />
* Marvin Mardiat<br />
* Martin Paakspuu<br />
Meeskonna koduleht: [[B12]]<br />
<br />
Projekti TFS: https://b12tiim.visualstudio.com/B12/<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: Elibrium ===<br />
Liikmed:<br />
* Märt Häkkinen<br />
* Karl Frank<br />
Meeskonna koduleht: [[Elibrium]]<br />
<br />
Projekti TFS: https://m-hakkinen.visualstudio.com/Elibrium<br />
<br />
'''Retsensioonid'''<br />
*Analüüsi retsensioon meeskonnale '''Gurmaanid''' asub [https://wiki.itcollege.ee/index.php/Talk:Meeskond:_Gurmaanid siin]<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: CozinHero ===<br />
Liikmed:<br />
* Taavi Metsvahi<br />
* Kai Kallastu<br />
Meeskonna koduleht: [[CozinHero]]<br />
<br />
Projekti TFS: https://metsvahi.visualstudio.com/CozinHero<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: Bank ===<br />
Liikmed:<br />
* Aleksei Kopõlov<br />
* Teet Adamson<br />
* Sander Perens<br />
* Tarvo Sbitnev<br />
Meeskonna koduleht: [https://wiki.itcollege.ee/index.php/Bank Bank]<br />
<br />
Projekti TFS: https://perens.visualstudio.com/Projekt%20Bank/tiimi%20nimi<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: ATDV===<br />
Liikmed:<br />
* Aldin Talve - arendaja<br />
* Delia Viirmaa - projektijuht<br />
* Mart-Erki Nõumees - arendaja<br />
<br />
Meeskonna koduleht: [[ATDV]]<br />
<br />
ADTV TFS: [https://adtvmn.visualstudio.com/ADTV SIIN]<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: Sõnajalg===<br />
Liikmed:<br />
* Argo Hansen<br />
* Ragnar Rästas<br />
Meeskonna koduleht: [[Sõnajalg]]<br />
<br />
Projekti TFS: https://sonajalg-itk.visualstudio.com/<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond:Gurmaanid===<br />
Liikmed:<br />
* Koit Kõrvel<br />
* Marko Kask<br />
* Brita Pentšuk<br />
* Ott Sõerumäe<br />
Meeskonna koduleht: [[Gurmaanid]]<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: Korterid Kõrgel Künkal===<br />
Liikmed:<br />
* Edward Mardo<br />
Meeskonna koduleht: [[Korterid_Kõrgel_Künkal]]<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: Librarians===<br />
Liikmed:<br />
* Kerttu Liis Lootus<br />
* Lisandra Noor<br />
* Lisette Noor<br />
Meeskonna koduleht: [[Librarians]]<br />
<br />
Projekti TFS: https://klootus.visualstudio.com/Librarians<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: Brainery===<br />
Liikmed:<br />
* Madis Lugus<br />
* Elina Kuldkepp<br />
* Berit Põldoja<br />
* Taavi Teearu<br />
Meeskonna koduleht: [[Brainery]]<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: Rent A Book===<br />
Liikmed:<br />
* Aapo Kersalu<br />
* Kristjan Kotto<br />
* Paul John Niidas<br />
<br />
Meeskonna koduleht: [[Rent A Book]]<br />
<br />
'''Retsensioonid''" <br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: BMS===<br />
Liikmed:<br />
* Kert Kukk<br />
Meeskonna koduleht: [[BMS]]<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: Dogify===<br />
Liikmed:<br />
* Roland Soosaar<br />
* Krista Norak<br />
* Mihkel Roots<br />
<br />
Meeskonna koduleht [[Dogify]]<br />
<br />
'''Projekti TFS:''' https://rososa.visualstudio.com/Dogify/<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: ForeverNotes===<br />
Liikmed:<br />
* Margus Muru<br />
* Joosep Koort<br />
* Martin Nigul<br />
Meeskonna koduleht: [[ForeverNotes]]<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: NullPointerException===<br />
Liikmed:<br />
* Kertu Nurmberg<br />
* Tõnis Piirits<br />
Meeskonna koduleht: [[NullPointerException]]<br />
<br />
'''Projekti TFS:''' https://null-pointer-exception.visualstudio.com/CSGO%20Triggerbot<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
==Kaugõpe==<br />
<br />
===Meeskond: Autoparandaja===<br />
Liikmed:<br />
* Mihkel Viilveer<br />
Meeskonna koduleht: [[Autoparandaja]]<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
'''TFS'''<br />
https://tostukid.visualstudio.com<br />
<br />
===Meeskond: Paabel===<br />
Liikmed:<br />
* Rutt Lindström<br />
* Esta Prangel<br />
* Krista Rüütel<br />
* Liina Abner<br />
<br />
Meeskonna koduleht: [[Paabel]]<br />
<br />
'''Retsensioonid'''<br />
TODO Projekti "Isearve" retsensioon: [[Talk:Isearve]]<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: Agraarbeib===<br />
<br />
Liikmed:<br />
* Kaia Runthal<br />
* Marianne Trubetskoi<br />
* Taavi Tilk<br />
* Mihkel Matson<br />
<br />
Meeskonna koduleht: [[Agraarbeib]]<br />
<br />
Projekti TFS: https://kaia.visualstudio.com/MeieTalu<br />
<br />
'''Analüüs (01.11)'''<br />
[https://wiki.itcollege.ee/index.php/Agraarbeib/Analyys Analüüs Wikis]<br />
<br />
'''Analüüsi retsensioon (08.11) TODO'''<br />
[https://wiki.itcollege.ee/index.php/Agraarbeib/AnalüüsiRetsensioon Retsensioon meeskonna [[Elekter]] analüüsile]<br />
<br />
'''Prototüüp (20.11) TODO''' <br />
[https://wiki.itcollege.ee/index.php/Agraarbeib/Prototüüp Prototüüp]<br />
<br />
'''Lõpptoode (18.12) TODO''' <br />
[https://wiki.itcollege.ee/index.php/Agraarbeib/Lõpptoode Lõpptoode]<br />
<br />
'''Lõpptoote retsensioon (08.01) TODO''' <br />
[https://wiki.itcollege.ee/index.php/Agraarbeib/LõpptooteRetsensioon Retsensioon meeskonna ??? tootele]<br />
<br />
===Meeskond: MoneyG 1.0===<br />
Liikmed:<br />
* Liina Saar<br />
* Mart Raus<br />
* Ando Kiidron<br />
* Andres Kepler<br />
<br />
Meeskonna koduleht: [[MoneyG 1.0]]<br />
<br />
Projekti TFS: [http://452b.visualstudio.com]<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
TODO<br />
===Meeskond: Laener===<br />
Liikmed:<br />
* Martin Kask - programmeerija<br />
* Marko Nõu - programmeerija<br />
* Anto Animägi - projektijuht<br />
<br />
Meeskonna koduleht: [[Laener]]<br />
<br />
Projekti TFS: [https://kaskmartin.visualstudio.com/Laener]<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: Vitamin C#===<br />
Liikmed:<br />
* Marko Belzetski<br />
* Rene Väli<br />
* Kaia Tomson<br />
<br />
Meeskonna koduleht: [[Vitamin C#]]<br />
<br />
Projekti TFS: [https://fevertree.visualstudio.com/Vitamiin%20Csharp https://fevertree.visualstudio.com/Vitamiin%20Csharp]<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: Kingalaenutus===<br />
Liikmed:<br />
* Kristi Saare<br />
* Kersti Maurer<br />
* Liisi Taimre<br />
<br />
<br />
Meeskonna koduleht: [[Kingalaenutus]]<br />
<br />
'''projekti TFS: https://kingalaenutus.visualstudio.com/Kingalaenutus'''<br />
NB! Õppejõud lisatud itcollege aadressiga.<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: Isearve ===<br />
Liikmed:<br />
* Siim Kallari<br />
* Priit Tiganik<br />
<br />
Meeskonna koduleht: [[Isearve]]<br />
<br />
Projekti TFS: [https://isearve.visualstudio.com/IseArve https://isearve.visualstudio.com/IseArve]<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: DevHelp===<br />
Liikmed:<br />
* Martin Jääger (projektijuht)<br />
* Mikk Erlenheim<br />
* Kristo Leemets<br />
Meeskonna koduleht: [[DevHelp]]<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
Projekti TFS: [https://devhelp.visualstudio.com/]<br />
<br />
===Meeskond: Elekter ===<br />
Liikmed:<br />
* Sigrid Aasma<br />
* Kristo Oidermaa<br />
* Tiit Post<br />
<br />
Meeskonna koduleht: [[Elekter]]<br />
<br />
Projekti TFS: [https://elekter.visualstudio.com/Elekter/ https://elekter.visualstudio.com/Elekter]<br />
<br />
Retsensioon: Projekt FoodBytes (TODO)<br />
<br />
===Meeskond: Battle2048===<br />
Liikmed:<br />
*Andrus Seiman<br />
*Annely Aasalaid<br />
*Kristjan Peterson<br />
<br />
Meeskonna koduleht: [[Battle2048]]<br />
<br />
Projekti TFS:<br />
TODO<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: EasyDesk===<br />
Liikmed:<br />
* Marju Pütsepp<br />
<br />
Meeskonna koduleht: [[EasyDesk]]<br />
<br />
Projekti TFS: https://marjup.visualstudio.com/EasyDesk<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: Ajamasin===<br />
Liikmed:<br />
* Liina Hellerma<br />
* Teele Sepman<br />
<br />
Meeskonna koduleht:[[Ajamasin]]<br />
<br />
Projekti TFS: https://teelesepman.visualstudio.com/Ajamasin/ (https://ajamasin.visualstudio.com/Ajamasin)<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: Jarvis===<br />
Liikmed:<br />
<br />
* Grigori Palamartšuk - Scrum Master & Product owner<br />
* Andrei Grigorjev - arendaja<br />
* Artyom Likhachev - arendaja<br />
* Maksim Tšeljabov - arendaja<br />
<br />
Meeskonna koduleht: [https://wiki.itcollege.ee/index.php/JARVIS Jarvis]<br />
<br />
Projekti TFS: [https://grigorip.visualstudio.com/Jarvis Jarvis]<br />
<br />
'''Retsensioonid'''<br />
TBD<br />
<br />
'''Lõpptoode'''<br />
TBD<br />
<br />
===Meeskond: TikTokTek===<br />
Liikmed:<br />
* Eva Ibrus<br />
* Rain Saarmäe<br />
'''Meeskonna koduleht'''<br />
[[TikTokTek]]<br />
<br />
'''TFS'''<br />
https://tiktoktek.visualstudio.com<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: Rahaplaneerija===<br />
Liikmed:<br />
* Maila Keerus<br />
* Kersti Miller<br />
* Evelin Jõgi<br />
<br />
Meeskonna koduleht:<br />
[[Rahaplaneerija]]<br />
<br />
Projekti TFS: [https://rahaplaneerija.visualstudio.com/Rahaplaneerija Rahaplaneerija]<br />
<br />
'''Retsensioonid''':<br />
[[Talk:EasyDesk]]<br />
<br />
'''Lõpptoode''':<br />
TODO<br />
<br />
===Meeskond: Garden of Towers===<br />
Liikmed:<br />
* Nele Sergejeva<br />
<br />
Meeskonna koduleht:<br />
https://wiki.itcollege.ee/index.php/Garden_of_Towers<br />
<br />
Projekti TFS: https://gardenoftowers.visualstudio.com/<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: FoodCab===<br />
Liikmed:<br />
* Mario Mustasaar<br />
* Peeter Ploom<br />
* Rain Elken<br />
* Roland Türi<br />
<br />
Meeskonna koduleht:<br />
https://wiki.itcollege.ee/index.php/FoodCab<br />
<br />
Projekti TFS: https://foodcab.visualstudio.com/<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: MyLibrary===<br />
Liikmed:<br />
* Madis Uudam - projektijuht, arendaja<br />
* Olle Mikk - arendaja<br />
<br />
Meeskonna koduleht: https://mylibrary16.wordpress.com/<br />
<br />
Projekti TFS:<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
=== Meeskond: OnTime ===<br />
Liikmed:<br />
*Tatjana Kruglova<br />
<br />
Meeskonna koduleht:<br />
https://wiki.itcollege.ee/index.php/OnTime<br />
<br />
Projetki TFS: https://ontimekruglova.visualstudio.com/OnTime/<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
=== Meeskond: FoodBytes ===<br />
Liikmed:<br />
*Aet Udusaar<br />
*Taavi Põder<br />
<br />
Meeskonna koduleht:<br />
https://wiki.itcollege.ee/index.php/FoodBytes<br />
<br />
Projekti TFS: https://foodbytes.visualstudio.com/FoodBytes/<br />
<br />
'''Retsensioonid'''<br />
TODO<br />
<br />
'''Lõpptoode'''<br />
TODO<br />
<br />
===Meeskond: SeDuM===<br />
Liikmed:<br />
*Liina Laumets <br />
<br />
Meeskonna koduleht: [[Meeskond: SeDuM]]<br />
<br />
Projekti TFS:<br />
<br />
'''Retsensioonid'''<br />
<br />
'''Prototüüp'''<br />
<br />
'''Lõpptoode'''</div>
Saasma
https://wiki.itcollege.ee/index.php?title=Talk:FoodBytes&diff=113904
Talk:FoodBytes
2016-11-04T12:33:04Z
<p>Saasma: Created page with "Retsensioon: Meeskond Elekter (Sigrid Aasma, Kristo Oidermaa ja Tiit Post). Siia tuleb retsensioon FoodBytes projekti kohta."</p>
<hr />
<div>Retsensioon: <br />
<br />
Meeskond Elekter (Sigrid Aasma, Kristo Oidermaa ja Tiit Post).<br />
<br />
Siia tuleb retsensioon FoodBytes projekti kohta.</div>
Saasma