ICO wiki - User contributions [en]

WatchWinders

2018-06-20T04:49:02Z

Tkuuskma: /* Tegevuste logi */

= Meeskond =

Toomas Juhkov, toomas.juhkov@gmail.com 
Tiit Kuuskmäe, tiit.kuuskmae@gmail.com 
Kunnar Kukk, Kunnar.kukk@gmail.com 

= Tegevuste logi =

08.02.2018 - meeskonna loomine, kokkuleppe sõlmimine teema osas 
10.02.2018 - õppejõu teavitamine koos esmase andmemudeliga 
15.02.2018 - lõpliku andmemudeli valmimine(versioon 5) 
18.02.2018 - õppejõu kinnitus, et teema ja meeskond kvalifiseeruvad 
22.02.2018 - viki lehe loomine ja analüüsi koostamise alustamine 
26.02.2018 - tiimi lisandus Kunnar Kukk 
01.03.2018 - tiimi sprint koosolek(seoses täiendava tiimiliikme lisandumisega täpsustasime skoopi) 
03.03.2018 - alustasime koodi kirjutamisega (tabelid klassideks ja annotatsioonid peale) 
06.03.2018 - täiendasime andmemudelit olemiga "UserTypeState" (et saaks muuta kasutajatüüpi) 
08.03.2018 - tiimi sprint koosolek 
18.03.2018 - lisasime olemid "Address", "AddressU", "AddressM", "OfferOfUser", "MediaInOffer" 
22.03.2018 - tiimi sprint koosolek, mis oli pühendatud andmemudeli täiendamisele 
23.03.2018 - pikem tiimi hackathon andmemudeli teemal 
29.03.2018 - täiendatud wiki lehte täielikult ringitöötatud andmemudeliga 
30.03.2018 - täiendatud wiki lehte andmemudeli metainfoga 
09.04.2018 - silusime andmemudelit (mõningad ebavajalikud viited olid sisse jäänud) 
06.05.2018 - panime uuendatud andmemudeli projekti wiki lehele üles 
07.05.2018 - osalesime õppejõu Mait Poska korraldatud hackathonil 
08.06.2018 - XML ülesanne, klientrakenduse ja API kood sai wiki lehel avalikuks 
19.06.2018 - seoses ärilise konfidentsiaalsuse nõudega eemaldasime nii andmemudeli kui koodi (kooskõlastatud õppejõuga)

Terve maikuu oli igapäevane suhtlus üle Skype'i ja fleep.io, mida me ei loginud (liiga tihedaks läks!).

= Kasutatavad metoodikad =

WatchWinders projektis plaanime kasutada peamiselt kaht metoodikat:

1. läbiv retsenseerimine (üks paariline teeb midagi valmis ja teine teeb sellele ülevaatuse; üksus lisatakse kui ülevaatus on lõplikult läbitud ning osapoolte vahel on saabunud konsensus) 
2. paaris programmeerimine (istume ühe masina taha maha ja kirjutame kolmekesi)

Tulenevalt kaugõppe formaadist saab ülekaalus olema esimene variant. Teist metoodikat kasutame nende osade kirjutamiseks, mille puhul võib arvata, et nende lahendamine on keeruline või et lahenduskäike võib olla väga erinevaid. Püüame jooksvalt siinses vikis kajastada ka seda, millise metoodika järgi üks või teine osa valmis.

= Projekti osad =

Alljärgnevalt anname ülevaate projekti osadest: 

(1) andmemudel 
(2) veebiteenuse analüüs 
(3) Minimum Viable Product definitsioon 
(4) Inkrement #1 
(5) Inkrement #2 
(6) Inkrement #3 

Projekti osad on meie viki lehel kirjeldatud valmimise järjekorras.

== Andmemudel ==

Andmemudeli koostamisel lähtusime õppejõu ette antud kriteeriumist, mille järgi andmemudelis on vähemalt 6 põhiolemit (tähistatud tumesinise ja lillaga - meie mudelis 11 tk),
mille hulgas ei sisaldu kasutajate tabelit (Person). 
 
Põhiolemid: 
* Watch - kell 
* Person - kasutaja/kollektsionäär või firma esindaja 
* Box - kellakarp 
* Organization - tootjad, edasimüüjad, hooldus 
* Settings - kellakarbi seade 
* Offer - pakkumine kollektsionäärile 
* Media - meediafailid kellade ja karpide kohta 
* Address - kasutaja/organisatsiooni aadress 
* ElectronicContact - elektrooniliste kontaktide loend 
* Log - logi 
* Access - paroolid ja kasutajanimed 
* Error - vead 
 
Type abiolemid: 
* WatchType - kellatüübid 
* PersonType - isikutüübid: admin, kasutaja 
* OrganizationType - organisatsioonitüübid: tootja, hooldaja, edasimüüja jt 
* ActionType - logi tüübid 
* ContactType - elektroonilise kontakti tüüp: skype, email, telefon jt 
 
Olekud: 
* PersonTypeState - isiku rolli kehtivus ajahetkel (isiku ja tüübi vaheline seos) 
* OrganizationTypeState - organisatsiooni olek(ud) ajahetkel 
 
Kuuluvus: 
* PersonWatch - isikute ja kellade vahelised seosed 
* PersonBox - isiku ja karbi vaheline seos 
* PersonAccess - isiku ja autentimisandmete vaheline seos 
* WatchInBox - kella ja karbi vaheline seos 
* ErrorInWatch - vea ja kella vaheline seos 
* SettingsInBox - seade ja karbi vaheline seos 
* WatchInOrganization - kella ja tootja vaheline seos 
* PersonInOrganization - isiku ja ettevõtte/organisatsiooni vaheline seos 
* SettingsOfWatchType - seade ja kellatüübi vaheline seos 
 
Abstraktsioonid: 
* Locator - abstraktsioon erinevate kontaktitüüpide jaoks 
* Party - abstraktsioon erinevate inimeste, organisatsioonide jt jaoks 
 
Kommunikatsioon: 
* OfferToPerson - isikule suunatud pakkumised 
* OfferFromPerson - isikult lähtuv pakkumine 
 
 
 
[ andmemudel eemaldatud 19.06.2018 seoses ärilise konfidentsiaalsuse nõudega; andmemudeli eemaldamine kooskõlastatud õppejõuga ]
 
 
 

Andmemudel valmis (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

== Veebiteenuse analüüs ==

Alljärgnevalt esitame kellakarpide infosüsteemi analüüsi järgmistes osades:

(1) toote/teenuse kirjeldus 
(2) probleemi kirjeldus 
(3) lahendus 
(4) süsteemi kasutajad 
(5) loodava API võimalused 
(6) funktsionaalsed nõuded 
(7) mittefunktsionaalsed nõuded 

=== Toote/teenuse kirjeldus ===
Teenuse eesmärgiks on lahendada probleem, kuidas jälgida kellakarpide kaudu mehhaaniliste käekellade seisundit ning keerata neid automaatselt üles distantsilt, näiteks juhul, kui kellade kollektsionäär ei asu füüsiliselt igapäevaselt oma kellade juures. Teenus võimaldab ka tootjal uuendada kontaktandmeid, saata personaalseid teateid. Administraatorile annab ülevaate platvormis toimuvast.

=== Probleemi kirjeldus ===
Mehhaaniliste käekellade kollektsionääride huvi kellakarpide vastu on mitmetahuline. Kollektsionääre huvitab arvepidamine – mitu kella, missuguste omaduste ja eripäradega neil kollektsioonis on. Teisalt soov eksponeerida oma kogusid kolleegidele ja sõpradele. Kellakarpidega täidetud sein või riiulid loovad selleks suurepärase võimaluse. Kolmandaks praktiline vajadus tagada kellavedrude õige vinnastatuse aste. Kaasaja mehhaanilised kellamehhanismid (''automatic'') võimaldavad kellakorpuse füüsilisel liigutamisel kellavedru automaatselt vinnastada.

Näiteks piisab kella kinnitamisest käele, et see hakkaks end käe liigutamisel üles keerama. Kuidas keerata aga üles seisvat kella, mis seisab paigal kellakarbis? Selleks on tänapäeva kellakarpides elektrimootor, mis tagab kella liigutamise vastavalt kellatüübile ettenähtud ööpäevase graafiku alusel. Kollektsionääride üheks probleemiks on see, kuidas juhtida sellist karpi ja omada jooksvat ülevaadet kõikidest oma karpidest, nende tehnilisest seadistusest ja kollektsiooni kuuluvatest kelladest olles tööreisil välisriigis?

=== Lahendus ===
Probleemi lahendamiseks ehitame REST + ASP.NET Core + WebAPI koos kliendiga, mis võimaldab kellakollektsionääridel hallata kellasid karpides, administraatoritel saada ülevaate süsteemist ning tootjatele lisada infot kollektsionääridele. Käesoleva projekti käigus '''ei tegeleta''' kahe IoT lahenduse kui terviku seisukohast olulise nüansiga: (i) karbi püsivara (''firmware'') loomisega, (ii) klientrakenduse ''frontend'' lõpliku häälestamisega (ilus .css ja pildid).

=== Süsteemi kasutajad ===
'''Kollektsionäär''' - haldab ja muudab infot oma kellade ning oma kellakarpide kohta. 
'''Administraator''' - haldab süsteemi infot, vajadusel eemaldab probleeme. 
'''Tootja''' - saab saata süsteemi kollektsionääridele mõeldud infot. 
'''Hooldaja''' - saab infot hooldamist vajavate kellade ja -karpide kohta. 

=== Loodava API võimalused ===
Alljärgnevalt vaatame loodava API võimalusi kasutajagruppide kaupa:

'''Kasutajale/kellakollektsionäärile'''
* Saada ülevaade kelladest ja kellakarpidest (lisada, muuta, vaadata).
* Muuta karbis oleva kella kohta käivat informatsiooni (kella nimi, tootja, tootmise aeg, viitenumber, mehhanism, jõureservi jääk (valikuline), foto kellast, kellarihma liik, muu).
* Karpe juhtida (keerata automaatselt üles). Näha ja muuta kella üleskeerava mehhanismi liikumise kiirust ja muid detaile (nt liikumise suund).
* Näha karbi seisundit, kas karp on hetkel wifiga ühendatud või mitte.
* Näha karbilt saabunud veateateid.
* Sisestada infot kella seisundist.
* Suhelda hooldajate ja tootjatega

'''Tootjale'''
* Uuendada kontaktandmeid.
* Saata personaalseid teateid kellakollektsionääridele.

'''Administraatorile'''
* Näha võrku ühendatud karpide arvu.
* Näha karpidesse paigaldatud kellade nimistut (ilma muude kasutajaandmeteta).
* Näha kellade üleskeeramise mehhanismide arvnäitajaid (madalaim kiirus, keskmine kiirus, tippkiirus; samuti liikumise suundade arvnäitajaid).
* IP-aadresside järgi ülevaadet, millistes riikides karpe kasutatakse (üldised arvandmed).
* Veateatega karpide arv süsteemis (üldised arvandmed).

=== Funktsionaalsed nõuded ===
* Kõik tegevused peavad olema autoriseeritud.
* REST + ASP.NET Core + WebAPI tagastab infot valideeritud JSON formaadis.
* API veatöötlus on tehtud, kasutades standardseid veakoode.
* API-le on tehtud 'health check'.
* Kõik kasutajad peavad saama end autoriseerida.
* Kasutaja, tootja ja administraatori tegevused logitakse.
* Logi ei ole muudetav, vaid on kättesaadav.
* Kasutaja ega tootja ei näe teiste kasutajate ega tootjate infot.
* API klient on kohanduv mobiilile, tahvlile ja desktoparvutile.
* Sisendandmed on valideeritud.

=== Mittefunktsionaalsed nõuded ===
* API-le on lisatud Swagger fail.
* Teenus ja tehniline lahendus on dokumenteeritud.
* Süsteemi kood on vabalt ligipääsetav, täiendatav ning allalaetav.

Esitame töö etappidena, kus kõigepealt defineerime ära Minimum Viable Producti [https://en.wikipedia.org/wiki/Minimum_viable_product] ehk selle miinimumi, mis pakub kasutajale maksimaalset väärtust. See tähendab API loomist ning esmase kliendi loomist kõigile MVP-s defineeritud kasutajagruppidele. Seejärel realiseerime projekti inkrementide ehk tootearenduse sammudena, milles lisame uusi funktsionaalsusi. Ideaalis jõuame realiseerida kõik sammud, kuid kuna teeme nimetatud tööd antud ajaraamis ja koosseisus esmakordselt, siis võtame vabaduse ka realiseerida korralikult niipalju, kui jõuame projekti käigus ära teha.

Võimalik, et meie lõpptulemus erineb mõnes osas esitatud analüüsist. Seda olenevalt sellest kui edukalt meil õnnestub plaanitud funktsionaalsusi realiseerida. Erisusi plaanime käsitleda vastavas 'post production' jaotuses, kus loendame ka projektist kogunenud peamised õppetunnid.

Analüüs valmis (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

== Minimum Viable Product definitsioon ==
'''Kasutaja'''
* Kasutaja saab süsteemi logida ning välja logida
* Kasutaja saab lisada uue kellakarbi
* Kasutaja saab lisada uue kella kellakarpi
* Kasutaja saab muuta kella infot kellakarbis
* Kasutaja saab näha ülevaadet oma karpidest
* Kasutaja saab muuta kellakarbi seadeid
* Kasutaja saab kustutada kella karbis
* Kasutaja saab kustutada kellakarbi

'''Administraator'''
* Näeb autoriseeritult logisid

'''Tootja'''
* Saab lisada kontaktandmeid
* Saab kontaktandmeid muuta

== Inkrement #1 ==
'''Kasutaja'''
* Näeb karbilt saabunud veateateid.
* Saab kellakarpe juhtida.

'''Administraator'''
* IP-aadresside järgi ülevaadet, millistes riikides karpe kasutatakse (üldised arvandmed).
* Karpidesse paigaldatud kellade nimistut (ilma muude kasutajaandmeteta).
* Näeb kasutajate statistikat.

'''Tootja'''
* Saata personaalseid teateid kellakollektsionääridele.

== Inkrement #2 ==
'''Kasutaja'''
* Saab saata teate tootjale.
* Näeb tootja vastust.
* Näha karbi seisundit, kas karp on hetkel wifiga ühendatud või mitte.

'''Administraator'''
* Näha kellade üleskeeramise mehhanismide arvnäitajaid (madalaim kiirus, keskmine kiirus, tippkiirus; samuti liikumise suundade arvnäitajaid).
* Näeb tegevuste ajalugu kliendist.

'''Tootja'''
* Saab lugeda kasutaja teadet.
* Saab vastata kasutajale.

'''Hooldaja'''
* Saab info hooldamist vajavate kellade kohta.

== Inkrement #3 ==
'''Kasutaja'''
* On ehitatud keeletugi.

'''Tootja'''
* On ehitatud keeletugi.

'''Hooldaja'''
* On ehitatud keeletugi.

Inkrementid valmisid (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

= XML ülesanne =
Järgnevalt esitame oma XML-ülesande tulemused.

== IT Management Transformation XML To XML ==
<pre>
<?xml version="1.0" encoding="utf-8"?>
<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">
<xsl:output method="xml" indent="yes"/>
<xsl:template match="/">
<unhandledDevices>
<xsl:for-each select="customers/customer/locations/location/items/item[@isInWorkingCondition='false']">
<device>
<name>
<xsl:value-of select="manufacturer"/>
<xsl:text> </xsl:text>
<xsl:value-of select="model"/>
</name>
<ticket>
<xsl:for-each select="tickets/ticket[@isHandled='false']">
<ticket_id>
<xsl:value-of select="@id"/>
</ticket_id>
<issued_in>
<xsl:value-of select="@issuedIn"/>
</issued_in>
<description>
<xsl:value-of select="description"/>
</description>
</xsl:for-each>
</ticket>
</device>
</xsl:for-each>
</unhandledDevices>
</xsl:template>
</xsl:stylesheet>
</pre>

== IT Management Transformation HTML ==

<pre>
<?xml version="1.0" encoding="utf-8"?>
<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">
<xsl:output method="html" indent="yes"/>
<xsl:template match="/">

<html>
<head>
<title>ItManagement Laptops</title>
</head>
<body style="background-color:#F7F7F7">
<h1>Computers</h1>
<xsl:for-each select="/customers/customer/locations/location/items/item[@type='laptopComputer']">
<xsl:sort select="@isActive='false'"/>
<hr />
<div>
<h3>
<xsl:value-of select="manufacturer"/>
</h3>
Model: 
<xsl:value-of select="model"/>
 
Serial number: 
<xsl:value-of select="serialNumber"/>
 
Date of purchase: 
<xsl:value-of select="dateOfPurchase"/>
 
Operating system: 
<xsl:value-of select="operatingSystem"/>
 
Is on active list: 
<xsl:value-of select="@isActive"/>
 
</div>

<div style="background-color:#E3FAEE" >

<xsl:for-each select="tickets/ticket">
<xsl:choose>
<xsl:when test="@isHandled='true'">
<h3>Handled tickets</h3>
<ul>
Issued in: 
<xsl:value-of select="@issuedIn"/>
 
Ticket ID: 
<xsl:value-of select="@id" />
 
Description: 
<xsl:value-of select="description"/>
 
Solution: 
<xsl:value-of select="solution"/>
 
</ul>
</xsl:when>
<xsl:when test="@isHandled='false'">
<div style="background-color:#FDE5E5">
<h3>Unhandled tickets</h3>
<ul>
Issued in: 
<xsl:value-of select="@issuedIn"/>
 
Ticket ID: 
<xsl:value-of select="@id" />
 
Description: 
<xsl:value-of select="description"/>
 
Solution: 
<xsl:value-of select="solution"/>
 
</ul>
</div>
</xsl:when>
</xsl:choose>
</xsl:for-each>

</div>
</xsl:for-each>
</body>
</html>
</xsl:template>
</xsl:stylesheet>
</pre>

== IT Management XSD ==

<pre>
<?xml version="1.0" encoding="utf-8"?>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="customers">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="customer">
<xs:complexType>
<xs:sequence>
<xs:element name="customerName" type="xs:string" />
<xs:element minOccurs="0" name="contactPerson" type="xs:string" />
<xs:element name="e-mail" type="xs:string" />
<xs:element name="phoneNumber" type="xs:string" />
<xs:element name="locations">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="location">
<xs:complexType>
<xs:sequence>
<xs:element name="city" type="xs:string" />
<xs:element name="address" type="xs:string" />
<xs:element name="comment" type="xs:string" />
<xs:element minOccurs="0" name="localContactPerson" type="xs:string" />
<xs:element minOccurs="0" name="localPhone" type="xs:string" />
<xs:element name="items">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="item">
<xs:complexType>
<xs:sequence>
<xs:element name="manufacturer" type="xs:string" />
<xs:element name="model" type="xs:string" />
<xs:element name="serialNumber" type="xs:string" />
<xs:element name="dateOfPurchase" type="xs:date" />
<xs:element minOccurs="0" name="operatingSystem">
<xs:complexType>
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute name="version" type="xs:string" use="required" />
</xs:extension>
</xs:simpleContent>
</xs:complexType>
</xs:element>
<xs:element minOccurs="0" name="tickets">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="ticket">
<xs:complexType>
<xs:sequence>
<xs:element name="description" type="xs:string" />
<xs:element name="solution" type="xs:string" />
</xs:sequence>
<xs:attribute name="id" type="xs:string" use="required" />
<xs:attribute name="issuedIn" type="xs:date" use="required" />
<xs:attribute name="isHandled" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:unsignedInt" use="required" />
<xs:attribute name="type" type="xs:string" use="required" />
<xs:attribute name="isActive" type="xs:boolean" use="required" />
<xs:attribute name="isUnderWarranty" type="xs:boolean" use="required" />
<xs:attribute name="warrantyInMonths" type="xs:unsignedByte" use="required" />
<xs:attribute name="isInWorkingCondition" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="type" type="xs:string" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:unsignedInt" use="required" />
<xs:attribute name="type" type="xs:string" use="required" />
<xs:attribute name="isActive" type="xs:boolean" use="required" />
<xs:attribute name="hasManyLocations" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
</pre>

== IT Management XML ==

<pre>
<?xml version="1.0" encoding="utf-8" ?>
<customers>
<customer id="33" type="company" isActive="true" hasManyLocations="true">
<customerName>Elamustevaba OÜ</customerName>
<contactPerson>Juhan Pühamees</contactPerson>
<e-mail>juhan@evaba.com</e-mail>
<phoneNumber>+37256565656</phoneNumber>
<locations>
<location type="office">
<city>Tallinn</city>
<address><![CDATA[Pikk 7, 56401]]></address>
<comment><![CDATA[3. korrus -> paremat kätt]]></comment>
<localContactPerson>Maiu Piimaauto</localContactPerson>
<localPhone>+3726510510</localPhone>
<items>
<item id="1" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="36" isInWorkingCondition="false">
<manufacturer>Dell</manufacturer>
<model>Inspiron 3558</model>
<serialNumber>6FGH5JN</serialNumber>
<dateOfPurchase>2017-07-22</dateOfPurchase>
<operatingSystem version="1709">Windows 10 Home</operatingSystem>
<tickets>
<ticket id="HWI001" issuedIn="2017-11-21" isHandled="true">
<description><![CDATA[Wi-Fi is not working]]></description>
<solution><![CDATA[Wi-Fi card replaced (Under the warranty)]]></solution>
</ticket>
<ticket id="SWI256" issuedIn="2018-05-05" isHandled="false">
<description><![CDATA[Computer keeps showing login screen]]></description>
<solution></solution>
</ticket>
</tickets>
</item>
<item id="55" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="60" isInWorkingCondition="true">
<manufacturer>Dell</manufacturer>
<model>Latitude E7550</model>
<serialNumber>8JGR78U</serialNumber>
<dateOfPurchase>2016-06-15</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Home</operatingSystem>
</item>
</items>
</location>
<location type="store">
<city>Tallinn</city>
<address><![CDATA[Lai 17, 56401]]></address>
<comment><![CDATA[keldrikorrusel]]></comment>
<localContactPerson>Tanja Õielemb</localContactPerson>
<localPhone>+3726510520</localPhone>
<items>
<item id="83" type="desktopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Lenovo</manufacturer>
<model>ThinkCentre M715</model>
<serialNumber>IO25689AD54KL</serialNumber>
<dateOfPurchase>2017-12-01</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Pro</operatingSystem>
</item>
<item id="12" type="monitor" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>AOC</manufacturer>
<model>L456</model>
<serialNumber>9803987YE54</serialNumber>
<dateOfPurchase>2015-05-03</dateOfPurchase>
<tickets>
<ticket id="HWI126" issuedIn="2016-01-18" isHandled="true">
<description><![CDATA[Doesn't work, no picture.]]></description>
<solution><![CDATA[Wasn't plugged in. Technician did it - works again!]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
<customer id="02" type="private" isActive="true" hasManyLocations="false">
<customerName>Kessu Sisselasi</customerName>
<e-mail>kessu@tripp.org</e-mail>
<phoneNumber>+372555555</phoneNumber>
<locations>
<location type="home">
<city>Saue</city>
<address><![CDATA[Kooli 4-8, 78965]]></address>
<comment><![CDATA[2. korrus. Kitsad koridorid.]]></comment>
<items>
<item id="98" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Acer</manufacturer>
<model>Aspire 5</model>
<serialNumber>475YRT89K4</serialNumber>
<dateOfPurchase>2018-03-25</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Home</operatingSystem>
</item>
<item id="4" type="laptopComputer" isActive="false" isUnderWarranty="false" warrantyInMonths="36" isInWorkingCondition="true">
<manufacturer>Lenovo</manufacturer>
<model>IdeaPad L530</model>
<serialNumber>U89TRY765ME</serialNumber>
<dateOfPurchase>2007-08-14</dateOfPurchase>
<operatingSystem version="">Windows XP</operatingSystem>
<tickets>
<ticket id="SWI069" issuedIn="2010-01-28" isHandled="true">
<description><![CDATA[Blue screen.]]></description>
<solution><![CDATA[Video driver update.]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
<customer id="26" type="company" isActive="true" hasManyLocations="true">
<customerName>Aktsiaselts OÜ</customerName>
<contactPerson>Gunnar Kuningas</contactPerson>
<e-mail>gunnar@kunn.ee</e-mail>
<phoneNumber>+3726985236</phoneNumber>
<locations>
<location type="office">
<city>Loksa</city>
<address><![CDATA[Kalda 14, 78965]]></address>
<comment><![CDATA[Sissepääs Rimi poolt, helesinine uks]]></comment>
<items>
<item id="26" type="laptopComputer" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Apple</manufacturer>
<model>Macbook Air</model>
<serialNumber>258JUY369</serialNumber>
<dateOfPurchase>2017-03-01</dateOfPurchase>
<operatingSystem version="High Sierra">OS X</operatingSystem>
</item>
<item id="59" type="laptopComputer" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="false">
<manufacturer>Acer</manufacturer>
<model>Chromebook 11</model>
<serialNumber>U89TRY765ME</serialNumber>
<dateOfPurchase>2016-04-23</dateOfPurchase>
<operatingSystem version="">Chrome OS</operatingSystem>
<tickets>
<ticket id="HWI046" issuedIn="2010-02-28" isHandled="false">
<description><![CDATA[Stripes on screen]]></description>
<solution><![CDATA[]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
</customers>
</pre>

= Link klientrakendusele ja API-le =
https://drive.google.com/file/d/1FU3XGGVHbn4BNNHAsOs7DQ4CzpEDwZUt/view?usp=sharing (nagu logidest näha lisasime selle lingi 08.06.2018, kuid siin on mõned üleliigsed kataloogid) 
https://drive.google.com/file/d/1A7cxeK15xlWSww_CPxpksSfj0m10qFQV/view?usp=sharing (09.06.2019 laadisime üles paki, kus on kustutatud kaks ebavajalikku kataloogi, mis võivad tekitada segadust)

[ failid eemaldatud seoses ärilise konfidentsiaalsuse nõudega 19.06.2018; failide eemaldamine kooskõlastatud õppejõuga ]

== Palun loe seda "readme" asemel ==

1. meie rakenduse implementeeritud skoop lähtub siin lehel (ülal), analüüsi osas defineeritud "Minimum viable product" kriteeriumitest 
2. lase API käima, tee andmebaaside migratsioonid ja update-database 
3. implementeeritud on kõik teenused, mis on nähtaval Swaggeris aadressil: "localhost:[pordinumber]/Swagger" 
4. kliendirakendus asub kataloogis 'WatchWindersClient' ja tegemist on solutioniga, mille võiks käivitada teises Visual Studio aknas 
5. klientrakenduse käivitumiseks tuleks muuta App.config failis muuta ära localhost portide numbrid asendades need enda arvutis oleva localhost pordiga ning lisada kehtiv JWT AccessToken, mille saab Postmaniga aadressilt api/Security/getToken "Email" ja "Password" abil pärast seda kui kasutaja on loodud 
6. küsimuste ja raskuste korral kirjuta tiit.kuuskmae@gmail.com (API) ja toomas.juhkov@gmail.com (klient). Vastame esimesel võimalusel.

= Retsensioonid =
1. Veebiteenuse retsensioon grupile "Kuldne Loojang". Kättesaadav: https://drive.google.com/file/d/1OtzOCPiWixsrbHcGCcdHgXIgz3_fsC7h/view

= Kasutatud kirjandus ja allikad =

1. Albahari, Joseph, Albari, Ben 2017. C# 7.0 in A Nutshell. Sebastopol: O’Reilly 
2. MariaDB Foundation. MariaDB. Kättesaadav:https://mariadb.org/ 
3. Martin, Robert 2018. Clean Architecture. Boston: Pearson Education

WatchWinders

2018-06-20T04:47:53Z

Tkuuskma: /* Link klientrakendusele ja API-le */

= Meeskond =

Toomas Juhkov, toomas.juhkov@gmail.com 
Tiit Kuuskmäe, tiit.kuuskmae@gmail.com 
Kunnar Kukk, Kunnar.kukk@gmail.com 

= Tegevuste logi =

08.02.2018 - meeskonna loomine, kokkuleppe sõlmimine teema osas 
10.02.2018 - õppejõu teavitamine koos esmase andmemudeliga 
15.02.2018 - lõpliku andmemudeli valmimine(versioon 5) 
18.02.2018 - õppejõu kinnitus, et teema ja meeskond kvalifiseeruvad 
22.02.2018 - viki lehe loomine ja analüüsi koostamise alustamine 
26.02.2018 - tiimi lisandus Kunnar Kukk 
01.03.2018 - tiimi sprint koosolek(seoses täiendava tiimiliikme lisandumisega täpsustasime skoopi) 
03.03.2018 - alustasime koodi kirjutamisega (tabelid klassideks ja annotatsioonid peale) 
06.03.2018 - täiendasime andmemudelit olemiga "UserTypeState" (et saaks muuta kasutajatüüpi) 
08.03.2018 - tiimi sprint koosolek 
18.03.2018 - lisasime olemid "Address", "AddressU", "AddressM", "OfferOfUser", "MediaInOffer" 
22.03.2018 - tiimi sprint koosolek, mis oli pühendatud andmemudeli täiendamisele 
23.03.2018 - pikem tiimi hackathon andmemudeli teemal 
29.03.2018 - täiendatud wiki lehte täielikult ringitöötatud andmemudeliga 
30.03.2018 - täiendatud wiki lehte andmemudeli metainfoga 
09.04.2018 - silusime andmemudelit (mõningad ebavajalikud viited olid sisse jäänud) 
06.05.2018 - panime uuendatud andmemudeli projekti wiki lehele üles 
07.05.2018 - osalesime õppejõu Mait Poska korraldatud hackathonil 
08.06.2018 - XML ülesanne, klientrakenduse ja API kood sai wiki lehel avalikuks 

Terve maikuu oli igapäevane suhtlus üle Skype'i ja fleep.io, mida me ei loginud (liiga tihedaks läks!).

= Kasutatavad metoodikad =

WatchWinders projektis plaanime kasutada peamiselt kaht metoodikat:

1. läbiv retsenseerimine (üks paariline teeb midagi valmis ja teine teeb sellele ülevaatuse; üksus lisatakse kui ülevaatus on lõplikult läbitud ning osapoolte vahel on saabunud konsensus) 
2. paaris programmeerimine (istume ühe masina taha maha ja kirjutame kolmekesi)

Tulenevalt kaugõppe formaadist saab ülekaalus olema esimene variant. Teist metoodikat kasutame nende osade kirjutamiseks, mille puhul võib arvata, et nende lahendamine on keeruline või et lahenduskäike võib olla väga erinevaid. Püüame jooksvalt siinses vikis kajastada ka seda, millise metoodika järgi üks või teine osa valmis.

= Projekti osad =

Alljärgnevalt anname ülevaate projekti osadest: 

(1) andmemudel 
(2) veebiteenuse analüüs 
(3) Minimum Viable Product definitsioon 
(4) Inkrement #1 
(5) Inkrement #2 
(6) Inkrement #3 

Projekti osad on meie viki lehel kirjeldatud valmimise järjekorras.

== Andmemudel ==

Andmemudeli koostamisel lähtusime õppejõu ette antud kriteeriumist, mille järgi andmemudelis on vähemalt 6 põhiolemit (tähistatud tumesinise ja lillaga - meie mudelis 11 tk),
mille hulgas ei sisaldu kasutajate tabelit (Person). 
 
Põhiolemid: 
* Watch - kell 
* Person - kasutaja/kollektsionäär või firma esindaja 
* Box - kellakarp 
* Organization - tootjad, edasimüüjad, hooldus 
* Settings - kellakarbi seade 
* Offer - pakkumine kollektsionäärile 
* Media - meediafailid kellade ja karpide kohta 
* Address - kasutaja/organisatsiooni aadress 
* ElectronicContact - elektrooniliste kontaktide loend 
* Log - logi 
* Access - paroolid ja kasutajanimed 
* Error - vead 
 
Type abiolemid: 
* WatchType - kellatüübid 
* PersonType - isikutüübid: admin, kasutaja 
* OrganizationType - organisatsioonitüübid: tootja, hooldaja, edasimüüja jt 
* ActionType - logi tüübid 
* ContactType - elektroonilise kontakti tüüp: skype, email, telefon jt 
 
Olekud: 
* PersonTypeState - isiku rolli kehtivus ajahetkel (isiku ja tüübi vaheline seos) 
* OrganizationTypeState - organisatsiooni olek(ud) ajahetkel 
 
Kuuluvus: 
* PersonWatch - isikute ja kellade vahelised seosed 
* PersonBox - isiku ja karbi vaheline seos 
* PersonAccess - isiku ja autentimisandmete vaheline seos 
* WatchInBox - kella ja karbi vaheline seos 
* ErrorInWatch - vea ja kella vaheline seos 
* SettingsInBox - seade ja karbi vaheline seos 
* WatchInOrganization - kella ja tootja vaheline seos 
* PersonInOrganization - isiku ja ettevõtte/organisatsiooni vaheline seos 
* SettingsOfWatchType - seade ja kellatüübi vaheline seos 
 
Abstraktsioonid: 
* Locator - abstraktsioon erinevate kontaktitüüpide jaoks 
* Party - abstraktsioon erinevate inimeste, organisatsioonide jt jaoks 
 
Kommunikatsioon: 
* OfferToPerson - isikule suunatud pakkumised 
* OfferFromPerson - isikult lähtuv pakkumine 
 
 
 
[ andmemudel eemaldatud 19.06.2018 seoses ärilise konfidentsiaalsuse nõudega; andmemudeli eemaldamine kooskõlastatud õppejõuga ]
 
 
 

Andmemudel valmis (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

== Veebiteenuse analüüs ==

Alljärgnevalt esitame kellakarpide infosüsteemi analüüsi järgmistes osades:

(1) toote/teenuse kirjeldus 
(2) probleemi kirjeldus 
(3) lahendus 
(4) süsteemi kasutajad 
(5) loodava API võimalused 
(6) funktsionaalsed nõuded 
(7) mittefunktsionaalsed nõuded 

=== Toote/teenuse kirjeldus ===
Teenuse eesmärgiks on lahendada probleem, kuidas jälgida kellakarpide kaudu mehhaaniliste käekellade seisundit ning keerata neid automaatselt üles distantsilt, näiteks juhul, kui kellade kollektsionäär ei asu füüsiliselt igapäevaselt oma kellade juures. Teenus võimaldab ka tootjal uuendada kontaktandmeid, saata personaalseid teateid. Administraatorile annab ülevaate platvormis toimuvast.

=== Probleemi kirjeldus ===
Mehhaaniliste käekellade kollektsionääride huvi kellakarpide vastu on mitmetahuline. Kollektsionääre huvitab arvepidamine – mitu kella, missuguste omaduste ja eripäradega neil kollektsioonis on. Teisalt soov eksponeerida oma kogusid kolleegidele ja sõpradele. Kellakarpidega täidetud sein või riiulid loovad selleks suurepärase võimaluse. Kolmandaks praktiline vajadus tagada kellavedrude õige vinnastatuse aste. Kaasaja mehhaanilised kellamehhanismid (''automatic'') võimaldavad kellakorpuse füüsilisel liigutamisel kellavedru automaatselt vinnastada.

Näiteks piisab kella kinnitamisest käele, et see hakkaks end käe liigutamisel üles keerama. Kuidas keerata aga üles seisvat kella, mis seisab paigal kellakarbis? Selleks on tänapäeva kellakarpides elektrimootor, mis tagab kella liigutamise vastavalt kellatüübile ettenähtud ööpäevase graafiku alusel. Kollektsionääride üheks probleemiks on see, kuidas juhtida sellist karpi ja omada jooksvat ülevaadet kõikidest oma karpidest, nende tehnilisest seadistusest ja kollektsiooni kuuluvatest kelladest olles tööreisil välisriigis?

=== Lahendus ===
Probleemi lahendamiseks ehitame REST + ASP.NET Core + WebAPI koos kliendiga, mis võimaldab kellakollektsionääridel hallata kellasid karpides, administraatoritel saada ülevaate süsteemist ning tootjatele lisada infot kollektsionääridele. Käesoleva projekti käigus '''ei tegeleta''' kahe IoT lahenduse kui terviku seisukohast olulise nüansiga: (i) karbi püsivara (''firmware'') loomisega, (ii) klientrakenduse ''frontend'' lõpliku häälestamisega (ilus .css ja pildid).

=== Süsteemi kasutajad ===
'''Kollektsionäär''' - haldab ja muudab infot oma kellade ning oma kellakarpide kohta. 
'''Administraator''' - haldab süsteemi infot, vajadusel eemaldab probleeme. 
'''Tootja''' - saab saata süsteemi kollektsionääridele mõeldud infot. 
'''Hooldaja''' - saab infot hooldamist vajavate kellade ja -karpide kohta. 

=== Loodava API võimalused ===
Alljärgnevalt vaatame loodava API võimalusi kasutajagruppide kaupa:

'''Kasutajale/kellakollektsionäärile'''
* Saada ülevaade kelladest ja kellakarpidest (lisada, muuta, vaadata).
* Muuta karbis oleva kella kohta käivat informatsiooni (kella nimi, tootja, tootmise aeg, viitenumber, mehhanism, jõureservi jääk (valikuline), foto kellast, kellarihma liik, muu).
* Karpe juhtida (keerata automaatselt üles). Näha ja muuta kella üleskeerava mehhanismi liikumise kiirust ja muid detaile (nt liikumise suund).
* Näha karbi seisundit, kas karp on hetkel wifiga ühendatud või mitte.
* Näha karbilt saabunud veateateid.
* Sisestada infot kella seisundist.
* Suhelda hooldajate ja tootjatega

'''Tootjale'''
* Uuendada kontaktandmeid.
* Saata personaalseid teateid kellakollektsionääridele.

'''Administraatorile'''
* Näha võrku ühendatud karpide arvu.
* Näha karpidesse paigaldatud kellade nimistut (ilma muude kasutajaandmeteta).
* Näha kellade üleskeeramise mehhanismide arvnäitajaid (madalaim kiirus, keskmine kiirus, tippkiirus; samuti liikumise suundade arvnäitajaid).
* IP-aadresside järgi ülevaadet, millistes riikides karpe kasutatakse (üldised arvandmed).
* Veateatega karpide arv süsteemis (üldised arvandmed).

=== Funktsionaalsed nõuded ===
* Kõik tegevused peavad olema autoriseeritud.
* REST + ASP.NET Core + WebAPI tagastab infot valideeritud JSON formaadis.
* API veatöötlus on tehtud, kasutades standardseid veakoode.
* API-le on tehtud 'health check'.
* Kõik kasutajad peavad saama end autoriseerida.
* Kasutaja, tootja ja administraatori tegevused logitakse.
* Logi ei ole muudetav, vaid on kättesaadav.
* Kasutaja ega tootja ei näe teiste kasutajate ega tootjate infot.
* API klient on kohanduv mobiilile, tahvlile ja desktoparvutile.
* Sisendandmed on valideeritud.

=== Mittefunktsionaalsed nõuded ===
* API-le on lisatud Swagger fail.
* Teenus ja tehniline lahendus on dokumenteeritud.
* Süsteemi kood on vabalt ligipääsetav, täiendatav ning allalaetav.

Esitame töö etappidena, kus kõigepealt defineerime ära Minimum Viable Producti [https://en.wikipedia.org/wiki/Minimum_viable_product] ehk selle miinimumi, mis pakub kasutajale maksimaalset väärtust. See tähendab API loomist ning esmase kliendi loomist kõigile MVP-s defineeritud kasutajagruppidele. Seejärel realiseerime projekti inkrementide ehk tootearenduse sammudena, milles lisame uusi funktsionaalsusi. Ideaalis jõuame realiseerida kõik sammud, kuid kuna teeme nimetatud tööd antud ajaraamis ja koosseisus esmakordselt, siis võtame vabaduse ka realiseerida korralikult niipalju, kui jõuame projekti käigus ära teha.

Võimalik, et meie lõpptulemus erineb mõnes osas esitatud analüüsist. Seda olenevalt sellest kui edukalt meil õnnestub plaanitud funktsionaalsusi realiseerida. Erisusi plaanime käsitleda vastavas 'post production' jaotuses, kus loendame ka projektist kogunenud peamised õppetunnid.

Analüüs valmis (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

== Minimum Viable Product definitsioon ==
'''Kasutaja'''
* Kasutaja saab süsteemi logida ning välja logida
* Kasutaja saab lisada uue kellakarbi
* Kasutaja saab lisada uue kella kellakarpi
* Kasutaja saab muuta kella infot kellakarbis
* Kasutaja saab näha ülevaadet oma karpidest
* Kasutaja saab muuta kellakarbi seadeid
* Kasutaja saab kustutada kella karbis
* Kasutaja saab kustutada kellakarbi

'''Administraator'''
* Näeb autoriseeritult logisid

'''Tootja'''
* Saab lisada kontaktandmeid
* Saab kontaktandmeid muuta

== Inkrement #1 ==
'''Kasutaja'''
* Näeb karbilt saabunud veateateid.
* Saab kellakarpe juhtida.

'''Administraator'''
* IP-aadresside järgi ülevaadet, millistes riikides karpe kasutatakse (üldised arvandmed).
* Karpidesse paigaldatud kellade nimistut (ilma muude kasutajaandmeteta).
* Näeb kasutajate statistikat.

'''Tootja'''
* Saata personaalseid teateid kellakollektsionääridele.

== Inkrement #2 ==
'''Kasutaja'''
* Saab saata teate tootjale.
* Näeb tootja vastust.
* Näha karbi seisundit, kas karp on hetkel wifiga ühendatud või mitte.

'''Administraator'''
* Näha kellade üleskeeramise mehhanismide arvnäitajaid (madalaim kiirus, keskmine kiirus, tippkiirus; samuti liikumise suundade arvnäitajaid).
* Näeb tegevuste ajalugu kliendist.

'''Tootja'''
* Saab lugeda kasutaja teadet.
* Saab vastata kasutajale.

'''Hooldaja'''
* Saab info hooldamist vajavate kellade kohta.

== Inkrement #3 ==
'''Kasutaja'''
* On ehitatud keeletugi.

'''Tootja'''
* On ehitatud keeletugi.

'''Hooldaja'''
* On ehitatud keeletugi.

Inkrementid valmisid (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

= XML ülesanne =
Järgnevalt esitame oma XML-ülesande tulemused.

== IT Management Transformation XML To XML ==
<pre>
<?xml version="1.0" encoding="utf-8"?>
<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">
<xsl:output method="xml" indent="yes"/>
<xsl:template match="/">
<unhandledDevices>
<xsl:for-each select="customers/customer/locations/location/items/item[@isInWorkingCondition='false']">
<device>
<name>
<xsl:value-of select="manufacturer"/>
<xsl:text> </xsl:text>
<xsl:value-of select="model"/>
</name>
<ticket>
<xsl:for-each select="tickets/ticket[@isHandled='false']">
<ticket_id>
<xsl:value-of select="@id"/>
</ticket_id>
<issued_in>
<xsl:value-of select="@issuedIn"/>
</issued_in>
<description>
<xsl:value-of select="description"/>
</description>
</xsl:for-each>
</ticket>
</device>
</xsl:for-each>
</unhandledDevices>
</xsl:template>
</xsl:stylesheet>
</pre>

== IT Management Transformation HTML ==

<pre>
<?xml version="1.0" encoding="utf-8"?>
<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">
<xsl:output method="html" indent="yes"/>
<xsl:template match="/">

<html>
<head>
<title>ItManagement Laptops</title>
</head>
<body style="background-color:#F7F7F7">
<h1>Computers</h1>
<xsl:for-each select="/customers/customer/locations/location/items/item[@type='laptopComputer']">
<xsl:sort select="@isActive='false'"/>
<hr />
<div>
<h3>
<xsl:value-of select="manufacturer"/>
</h3>
Model: 
<xsl:value-of select="model"/>
 
Serial number: 
<xsl:value-of select="serialNumber"/>
 
Date of purchase: 
<xsl:value-of select="dateOfPurchase"/>
 
Operating system: 
<xsl:value-of select="operatingSystem"/>
 
Is on active list: 
<xsl:value-of select="@isActive"/>
 
</div>

<div style="background-color:#E3FAEE" >

<xsl:for-each select="tickets/ticket">
<xsl:choose>
<xsl:when test="@isHandled='true'">
<h3>Handled tickets</h3>
<ul>
Issued in: 
<xsl:value-of select="@issuedIn"/>
 
Ticket ID: 
<xsl:value-of select="@id" />
 
Description: 
<xsl:value-of select="description"/>
 
Solution: 
<xsl:value-of select="solution"/>
 
</ul>
</xsl:when>
<xsl:when test="@isHandled='false'">
<div style="background-color:#FDE5E5">
<h3>Unhandled tickets</h3>
<ul>
Issued in: 
<xsl:value-of select="@issuedIn"/>
 
Ticket ID: 
<xsl:value-of select="@id" />
 
Description: 
<xsl:value-of select="description"/>
 
Solution: 
<xsl:value-of select="solution"/>
 
</ul>
</div>
</xsl:when>
</xsl:choose>
</xsl:for-each>

</div>
</xsl:for-each>
</body>
</html>
</xsl:template>
</xsl:stylesheet>
</pre>

== IT Management XSD ==

<pre>
<?xml version="1.0" encoding="utf-8"?>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="customers">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="customer">
<xs:complexType>
<xs:sequence>
<xs:element name="customerName" type="xs:string" />
<xs:element minOccurs="0" name="contactPerson" type="xs:string" />
<xs:element name="e-mail" type="xs:string" />
<xs:element name="phoneNumber" type="xs:string" />
<xs:element name="locations">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="location">
<xs:complexType>
<xs:sequence>
<xs:element name="city" type="xs:string" />
<xs:element name="address" type="xs:string" />
<xs:element name="comment" type="xs:string" />
<xs:element minOccurs="0" name="localContactPerson" type="xs:string" />
<xs:element minOccurs="0" name="localPhone" type="xs:string" />
<xs:element name="items">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="item">
<xs:complexType>
<xs:sequence>
<xs:element name="manufacturer" type="xs:string" />
<xs:element name="model" type="xs:string" />
<xs:element name="serialNumber" type="xs:string" />
<xs:element name="dateOfPurchase" type="xs:date" />
<xs:element minOccurs="0" name="operatingSystem">
<xs:complexType>
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute name="version" type="xs:string" use="required" />
</xs:extension>
</xs:simpleContent>
</xs:complexType>
</xs:element>
<xs:element minOccurs="0" name="tickets">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="ticket">
<xs:complexType>
<xs:sequence>
<xs:element name="description" type="xs:string" />
<xs:element name="solution" type="xs:string" />
</xs:sequence>
<xs:attribute name="id" type="xs:string" use="required" />
<xs:attribute name="issuedIn" type="xs:date" use="required" />
<xs:attribute name="isHandled" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:unsignedInt" use="required" />
<xs:attribute name="type" type="xs:string" use="required" />
<xs:attribute name="isActive" type="xs:boolean" use="required" />
<xs:attribute name="isUnderWarranty" type="xs:boolean" use="required" />
<xs:attribute name="warrantyInMonths" type="xs:unsignedByte" use="required" />
<xs:attribute name="isInWorkingCondition" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="type" type="xs:string" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:unsignedInt" use="required" />
<xs:attribute name="type" type="xs:string" use="required" />
<xs:attribute name="isActive" type="xs:boolean" use="required" />
<xs:attribute name="hasManyLocations" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
</pre>

== IT Management XML ==

<pre>
<?xml version="1.0" encoding="utf-8" ?>
<customers>
<customer id="33" type="company" isActive="true" hasManyLocations="true">
<customerName>Elamustevaba OÜ</customerName>
<contactPerson>Juhan Pühamees</contactPerson>
<e-mail>juhan@evaba.com</e-mail>
<phoneNumber>+37256565656</phoneNumber>
<locations>
<location type="office">
<city>Tallinn</city>
<address><![CDATA[Pikk 7, 56401]]></address>
<comment><![CDATA[3. korrus -> paremat kätt]]></comment>
<localContactPerson>Maiu Piimaauto</localContactPerson>
<localPhone>+3726510510</localPhone>
<items>
<item id="1" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="36" isInWorkingCondition="false">
<manufacturer>Dell</manufacturer>
<model>Inspiron 3558</model>
<serialNumber>6FGH5JN</serialNumber>
<dateOfPurchase>2017-07-22</dateOfPurchase>
<operatingSystem version="1709">Windows 10 Home</operatingSystem>
<tickets>
<ticket id="HWI001" issuedIn="2017-11-21" isHandled="true">
<description><![CDATA[Wi-Fi is not working]]></description>
<solution><![CDATA[Wi-Fi card replaced (Under the warranty)]]></solution>
</ticket>
<ticket id="SWI256" issuedIn="2018-05-05" isHandled="false">
<description><![CDATA[Computer keeps showing login screen]]></description>
<solution></solution>
</ticket>
</tickets>
</item>
<item id="55" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="60" isInWorkingCondition="true">
<manufacturer>Dell</manufacturer>
<model>Latitude E7550</model>
<serialNumber>8JGR78U</serialNumber>
<dateOfPurchase>2016-06-15</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Home</operatingSystem>
</item>
</items>
</location>
<location type="store">
<city>Tallinn</city>
<address><![CDATA[Lai 17, 56401]]></address>
<comment><![CDATA[keldrikorrusel]]></comment>
<localContactPerson>Tanja Õielemb</localContactPerson>
<localPhone>+3726510520</localPhone>
<items>
<item id="83" type="desktopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Lenovo</manufacturer>
<model>ThinkCentre M715</model>
<serialNumber>IO25689AD54KL</serialNumber>
<dateOfPurchase>2017-12-01</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Pro</operatingSystem>
</item>
<item id="12" type="monitor" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>AOC</manufacturer>
<model>L456</model>
<serialNumber>9803987YE54</serialNumber>
<dateOfPurchase>2015-05-03</dateOfPurchase>
<tickets>
<ticket id="HWI126" issuedIn="2016-01-18" isHandled="true">
<description><![CDATA[Doesn't work, no picture.]]></description>
<solution><![CDATA[Wasn't plugged in. Technician did it - works again!]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
<customer id="02" type="private" isActive="true" hasManyLocations="false">
<customerName>Kessu Sisselasi</customerName>
<e-mail>kessu@tripp.org</e-mail>
<phoneNumber>+372555555</phoneNumber>
<locations>
<location type="home">
<city>Saue</city>
<address><![CDATA[Kooli 4-8, 78965]]></address>
<comment><![CDATA[2. korrus. Kitsad koridorid.]]></comment>
<items>
<item id="98" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Acer</manufacturer>
<model>Aspire 5</model>
<serialNumber>475YRT89K4</serialNumber>
<dateOfPurchase>2018-03-25</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Home</operatingSystem>
</item>
<item id="4" type="laptopComputer" isActive="false" isUnderWarranty="false" warrantyInMonths="36" isInWorkingCondition="true">
<manufacturer>Lenovo</manufacturer>
<model>IdeaPad L530</model>
<serialNumber>U89TRY765ME</serialNumber>
<dateOfPurchase>2007-08-14</dateOfPurchase>
<operatingSystem version="">Windows XP</operatingSystem>
<tickets>
<ticket id="SWI069" issuedIn="2010-01-28" isHandled="true">
<description><![CDATA[Blue screen.]]></description>
<solution><![CDATA[Video driver update.]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
<customer id="26" type="company" isActive="true" hasManyLocations="true">
<customerName>Aktsiaselts OÜ</customerName>
<contactPerson>Gunnar Kuningas</contactPerson>
<e-mail>gunnar@kunn.ee</e-mail>
<phoneNumber>+3726985236</phoneNumber>
<locations>
<location type="office">
<city>Loksa</city>
<address><![CDATA[Kalda 14, 78965]]></address>
<comment><![CDATA[Sissepääs Rimi poolt, helesinine uks]]></comment>
<items>
<item id="26" type="laptopComputer" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Apple</manufacturer>
<model>Macbook Air</model>
<serialNumber>258JUY369</serialNumber>
<dateOfPurchase>2017-03-01</dateOfPurchase>
<operatingSystem version="High Sierra">OS X</operatingSystem>
</item>
<item id="59" type="laptopComputer" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="false">
<manufacturer>Acer</manufacturer>
<model>Chromebook 11</model>
<serialNumber>U89TRY765ME</serialNumber>
<dateOfPurchase>2016-04-23</dateOfPurchase>
<operatingSystem version="">Chrome OS</operatingSystem>
<tickets>
<ticket id="HWI046" issuedIn="2010-02-28" isHandled="false">
<description><![CDATA[Stripes on screen]]></description>
<solution><![CDATA[]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
</customers>
</pre>

= Link klientrakendusele ja API-le =
https://drive.google.com/file/d/1FU3XGGVHbn4BNNHAsOs7DQ4CzpEDwZUt/view?usp=sharing (nagu logidest näha lisasime selle lingi 08.06.2018, kuid siin on mõned üleliigsed kataloogid) 
https://drive.google.com/file/d/1A7cxeK15xlWSww_CPxpksSfj0m10qFQV/view?usp=sharing (09.06.2019 laadisime üles paki, kus on kustutatud kaks ebavajalikku kataloogi, mis võivad tekitada segadust)

[ failid eemaldatud seoses ärilise konfidentsiaalsuse nõudega 19.06.2018; failide eemaldamine kooskõlastatud õppejõuga ]

== Palun loe seda "readme" asemel ==

1. meie rakenduse implementeeritud skoop lähtub siin lehel (ülal), analüüsi osas defineeritud "Minimum viable product" kriteeriumitest 
2. lase API käima, tee andmebaaside migratsioonid ja update-database 
3. implementeeritud on kõik teenused, mis on nähtaval Swaggeris aadressil: "localhost:[pordinumber]/Swagger" 
4. kliendirakendus asub kataloogis 'WatchWindersClient' ja tegemist on solutioniga, mille võiks käivitada teises Visual Studio aknas 
5. klientrakenduse käivitumiseks tuleks muuta App.config failis muuta ära localhost portide numbrid asendades need enda arvutis oleva localhost pordiga ning lisada kehtiv JWT AccessToken, mille saab Postmaniga aadressilt api/Security/getToken "Email" ja "Password" abil pärast seda kui kasutaja on loodud 
6. küsimuste ja raskuste korral kirjuta tiit.kuuskmae@gmail.com (API) ja toomas.juhkov@gmail.com (klient). Vastame esimesel võimalusel.

= Retsensioonid =
1. Veebiteenuse retsensioon grupile "Kuldne Loojang". Kättesaadav: https://drive.google.com/file/d/1OtzOCPiWixsrbHcGCcdHgXIgz3_fsC7h/view

= Kasutatud kirjandus ja allikad =

1. Albahari, Joseph, Albari, Ben 2017. C# 7.0 in A Nutshell. Sebastopol: O’Reilly 
2. MariaDB Foundation. MariaDB. Kättesaadav:https://mariadb.org/ 
3. Martin, Robert 2018. Clean Architecture. Boston: Pearson Education

WatchWinders

2018-06-20T04:47:19Z

Tkuuskma: /* Andmemudel */

= Meeskond =

Toomas Juhkov, toomas.juhkov@gmail.com 
Tiit Kuuskmäe, tiit.kuuskmae@gmail.com 
Kunnar Kukk, Kunnar.kukk@gmail.com 

= Tegevuste logi =

08.02.2018 - meeskonna loomine, kokkuleppe sõlmimine teema osas 
10.02.2018 - õppejõu teavitamine koos esmase andmemudeliga 
15.02.2018 - lõpliku andmemudeli valmimine(versioon 5) 
18.02.2018 - õppejõu kinnitus, et teema ja meeskond kvalifiseeruvad 
22.02.2018 - viki lehe loomine ja analüüsi koostamise alustamine 
26.02.2018 - tiimi lisandus Kunnar Kukk 
01.03.2018 - tiimi sprint koosolek(seoses täiendava tiimiliikme lisandumisega täpsustasime skoopi) 
03.03.2018 - alustasime koodi kirjutamisega (tabelid klassideks ja annotatsioonid peale) 
06.03.2018 - täiendasime andmemudelit olemiga "UserTypeState" (et saaks muuta kasutajatüüpi) 
08.03.2018 - tiimi sprint koosolek 
18.03.2018 - lisasime olemid "Address", "AddressU", "AddressM", "OfferOfUser", "MediaInOffer" 
22.03.2018 - tiimi sprint koosolek, mis oli pühendatud andmemudeli täiendamisele 
23.03.2018 - pikem tiimi hackathon andmemudeli teemal 
29.03.2018 - täiendatud wiki lehte täielikult ringitöötatud andmemudeliga 
30.03.2018 - täiendatud wiki lehte andmemudeli metainfoga 
09.04.2018 - silusime andmemudelit (mõningad ebavajalikud viited olid sisse jäänud) 
06.05.2018 - panime uuendatud andmemudeli projekti wiki lehele üles 
07.05.2018 - osalesime õppejõu Mait Poska korraldatud hackathonil 
08.06.2018 - XML ülesanne, klientrakenduse ja API kood sai wiki lehel avalikuks 

Terve maikuu oli igapäevane suhtlus üle Skype'i ja fleep.io, mida me ei loginud (liiga tihedaks läks!).

= Kasutatavad metoodikad =

WatchWinders projektis plaanime kasutada peamiselt kaht metoodikat:

1. läbiv retsenseerimine (üks paariline teeb midagi valmis ja teine teeb sellele ülevaatuse; üksus lisatakse kui ülevaatus on lõplikult läbitud ning osapoolte vahel on saabunud konsensus) 
2. paaris programmeerimine (istume ühe masina taha maha ja kirjutame kolmekesi)

Tulenevalt kaugõppe formaadist saab ülekaalus olema esimene variant. Teist metoodikat kasutame nende osade kirjutamiseks, mille puhul võib arvata, et nende lahendamine on keeruline või et lahenduskäike võib olla väga erinevaid. Püüame jooksvalt siinses vikis kajastada ka seda, millise metoodika järgi üks või teine osa valmis.

= Projekti osad =

Alljärgnevalt anname ülevaate projekti osadest: 

(1) andmemudel 
(2) veebiteenuse analüüs 
(3) Minimum Viable Product definitsioon 
(4) Inkrement #1 
(5) Inkrement #2 
(6) Inkrement #3 

Projekti osad on meie viki lehel kirjeldatud valmimise järjekorras.

== Andmemudel ==

Andmemudeli koostamisel lähtusime õppejõu ette antud kriteeriumist, mille järgi andmemudelis on vähemalt 6 põhiolemit (tähistatud tumesinise ja lillaga - meie mudelis 11 tk),
mille hulgas ei sisaldu kasutajate tabelit (Person). 
 
Põhiolemid: 
* Watch - kell 
* Person - kasutaja/kollektsionäär või firma esindaja 
* Box - kellakarp 
* Organization - tootjad, edasimüüjad, hooldus 
* Settings - kellakarbi seade 
* Offer - pakkumine kollektsionäärile 
* Media - meediafailid kellade ja karpide kohta 
* Address - kasutaja/organisatsiooni aadress 
* ElectronicContact - elektrooniliste kontaktide loend 
* Log - logi 
* Access - paroolid ja kasutajanimed 
* Error - vead 
 
Type abiolemid: 
* WatchType - kellatüübid 
* PersonType - isikutüübid: admin, kasutaja 
* OrganizationType - organisatsioonitüübid: tootja, hooldaja, edasimüüja jt 
* ActionType - logi tüübid 
* ContactType - elektroonilise kontakti tüüp: skype, email, telefon jt 
 
Olekud: 
* PersonTypeState - isiku rolli kehtivus ajahetkel (isiku ja tüübi vaheline seos) 
* OrganizationTypeState - organisatsiooni olek(ud) ajahetkel 
 
Kuuluvus: 
* PersonWatch - isikute ja kellade vahelised seosed 
* PersonBox - isiku ja karbi vaheline seos 
* PersonAccess - isiku ja autentimisandmete vaheline seos 
* WatchInBox - kella ja karbi vaheline seos 
* ErrorInWatch - vea ja kella vaheline seos 
* SettingsInBox - seade ja karbi vaheline seos 
* WatchInOrganization - kella ja tootja vaheline seos 
* PersonInOrganization - isiku ja ettevõtte/organisatsiooni vaheline seos 
* SettingsOfWatchType - seade ja kellatüübi vaheline seos 
 
Abstraktsioonid: 
* Locator - abstraktsioon erinevate kontaktitüüpide jaoks 
* Party - abstraktsioon erinevate inimeste, organisatsioonide jt jaoks 
 
Kommunikatsioon: 
* OfferToPerson - isikule suunatud pakkumised 
* OfferFromPerson - isikult lähtuv pakkumine 
 
 
 
[ andmemudel eemaldatud 19.06.2018 seoses ärilise konfidentsiaalsuse nõudega; andmemudeli eemaldamine kooskõlastatud õppejõuga ]
 
 
 

Andmemudel valmis (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

== Veebiteenuse analüüs ==

Alljärgnevalt esitame kellakarpide infosüsteemi analüüsi järgmistes osades:

(1) toote/teenuse kirjeldus 
(2) probleemi kirjeldus 
(3) lahendus 
(4) süsteemi kasutajad 
(5) loodava API võimalused 
(6) funktsionaalsed nõuded 
(7) mittefunktsionaalsed nõuded 

=== Toote/teenuse kirjeldus ===
Teenuse eesmärgiks on lahendada probleem, kuidas jälgida kellakarpide kaudu mehhaaniliste käekellade seisundit ning keerata neid automaatselt üles distantsilt, näiteks juhul, kui kellade kollektsionäär ei asu füüsiliselt igapäevaselt oma kellade juures. Teenus võimaldab ka tootjal uuendada kontaktandmeid, saata personaalseid teateid. Administraatorile annab ülevaate platvormis toimuvast.

=== Probleemi kirjeldus ===
Mehhaaniliste käekellade kollektsionääride huvi kellakarpide vastu on mitmetahuline. Kollektsionääre huvitab arvepidamine – mitu kella, missuguste omaduste ja eripäradega neil kollektsioonis on. Teisalt soov eksponeerida oma kogusid kolleegidele ja sõpradele. Kellakarpidega täidetud sein või riiulid loovad selleks suurepärase võimaluse. Kolmandaks praktiline vajadus tagada kellavedrude õige vinnastatuse aste. Kaasaja mehhaanilised kellamehhanismid (''automatic'') võimaldavad kellakorpuse füüsilisel liigutamisel kellavedru automaatselt vinnastada.

Näiteks piisab kella kinnitamisest käele, et see hakkaks end käe liigutamisel üles keerama. Kuidas keerata aga üles seisvat kella, mis seisab paigal kellakarbis? Selleks on tänapäeva kellakarpides elektrimootor, mis tagab kella liigutamise vastavalt kellatüübile ettenähtud ööpäevase graafiku alusel. Kollektsionääride üheks probleemiks on see, kuidas juhtida sellist karpi ja omada jooksvat ülevaadet kõikidest oma karpidest, nende tehnilisest seadistusest ja kollektsiooni kuuluvatest kelladest olles tööreisil välisriigis?

=== Lahendus ===
Probleemi lahendamiseks ehitame REST + ASP.NET Core + WebAPI koos kliendiga, mis võimaldab kellakollektsionääridel hallata kellasid karpides, administraatoritel saada ülevaate süsteemist ning tootjatele lisada infot kollektsionääridele. Käesoleva projekti käigus '''ei tegeleta''' kahe IoT lahenduse kui terviku seisukohast olulise nüansiga: (i) karbi püsivara (''firmware'') loomisega, (ii) klientrakenduse ''frontend'' lõpliku häälestamisega (ilus .css ja pildid).

=== Süsteemi kasutajad ===
'''Kollektsionäär''' - haldab ja muudab infot oma kellade ning oma kellakarpide kohta. 
'''Administraator''' - haldab süsteemi infot, vajadusel eemaldab probleeme. 
'''Tootja''' - saab saata süsteemi kollektsionääridele mõeldud infot. 
'''Hooldaja''' - saab infot hooldamist vajavate kellade ja -karpide kohta. 

=== Loodava API võimalused ===
Alljärgnevalt vaatame loodava API võimalusi kasutajagruppide kaupa:

'''Kasutajale/kellakollektsionäärile'''
* Saada ülevaade kelladest ja kellakarpidest (lisada, muuta, vaadata).
* Muuta karbis oleva kella kohta käivat informatsiooni (kella nimi, tootja, tootmise aeg, viitenumber, mehhanism, jõureservi jääk (valikuline), foto kellast, kellarihma liik, muu).
* Karpe juhtida (keerata automaatselt üles). Näha ja muuta kella üleskeerava mehhanismi liikumise kiirust ja muid detaile (nt liikumise suund).
* Näha karbi seisundit, kas karp on hetkel wifiga ühendatud või mitte.
* Näha karbilt saabunud veateateid.
* Sisestada infot kella seisundist.
* Suhelda hooldajate ja tootjatega

'''Tootjale'''
* Uuendada kontaktandmeid.
* Saata personaalseid teateid kellakollektsionääridele.

'''Administraatorile'''
* Näha võrku ühendatud karpide arvu.
* Näha karpidesse paigaldatud kellade nimistut (ilma muude kasutajaandmeteta).
* Näha kellade üleskeeramise mehhanismide arvnäitajaid (madalaim kiirus, keskmine kiirus, tippkiirus; samuti liikumise suundade arvnäitajaid).
* IP-aadresside järgi ülevaadet, millistes riikides karpe kasutatakse (üldised arvandmed).
* Veateatega karpide arv süsteemis (üldised arvandmed).

=== Funktsionaalsed nõuded ===
* Kõik tegevused peavad olema autoriseeritud.
* REST + ASP.NET Core + WebAPI tagastab infot valideeritud JSON formaadis.
* API veatöötlus on tehtud, kasutades standardseid veakoode.
* API-le on tehtud 'health check'.
* Kõik kasutajad peavad saama end autoriseerida.
* Kasutaja, tootja ja administraatori tegevused logitakse.
* Logi ei ole muudetav, vaid on kättesaadav.
* Kasutaja ega tootja ei näe teiste kasutajate ega tootjate infot.
* API klient on kohanduv mobiilile, tahvlile ja desktoparvutile.
* Sisendandmed on valideeritud.

=== Mittefunktsionaalsed nõuded ===
* API-le on lisatud Swagger fail.
* Teenus ja tehniline lahendus on dokumenteeritud.
* Süsteemi kood on vabalt ligipääsetav, täiendatav ning allalaetav.

Esitame töö etappidena, kus kõigepealt defineerime ära Minimum Viable Producti [https://en.wikipedia.org/wiki/Minimum_viable_product] ehk selle miinimumi, mis pakub kasutajale maksimaalset väärtust. See tähendab API loomist ning esmase kliendi loomist kõigile MVP-s defineeritud kasutajagruppidele. Seejärel realiseerime projekti inkrementide ehk tootearenduse sammudena, milles lisame uusi funktsionaalsusi. Ideaalis jõuame realiseerida kõik sammud, kuid kuna teeme nimetatud tööd antud ajaraamis ja koosseisus esmakordselt, siis võtame vabaduse ka realiseerida korralikult niipalju, kui jõuame projekti käigus ära teha.

Võimalik, et meie lõpptulemus erineb mõnes osas esitatud analüüsist. Seda olenevalt sellest kui edukalt meil õnnestub plaanitud funktsionaalsusi realiseerida. Erisusi plaanime käsitleda vastavas 'post production' jaotuses, kus loendame ka projektist kogunenud peamised õppetunnid.

Analüüs valmis (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

== Minimum Viable Product definitsioon ==
'''Kasutaja'''
* Kasutaja saab süsteemi logida ning välja logida
* Kasutaja saab lisada uue kellakarbi
* Kasutaja saab lisada uue kella kellakarpi
* Kasutaja saab muuta kella infot kellakarbis
* Kasutaja saab näha ülevaadet oma karpidest
* Kasutaja saab muuta kellakarbi seadeid
* Kasutaja saab kustutada kella karbis
* Kasutaja saab kustutada kellakarbi

'''Administraator'''
* Näeb autoriseeritult logisid

'''Tootja'''
* Saab lisada kontaktandmeid
* Saab kontaktandmeid muuta

== Inkrement #1 ==
'''Kasutaja'''
* Näeb karbilt saabunud veateateid.
* Saab kellakarpe juhtida.

'''Administraator'''
* IP-aadresside järgi ülevaadet, millistes riikides karpe kasutatakse (üldised arvandmed).
* Karpidesse paigaldatud kellade nimistut (ilma muude kasutajaandmeteta).
* Näeb kasutajate statistikat.

'''Tootja'''
* Saata personaalseid teateid kellakollektsionääridele.

== Inkrement #2 ==
'''Kasutaja'''
* Saab saata teate tootjale.
* Näeb tootja vastust.
* Näha karbi seisundit, kas karp on hetkel wifiga ühendatud või mitte.

'''Administraator'''
* Näha kellade üleskeeramise mehhanismide arvnäitajaid (madalaim kiirus, keskmine kiirus, tippkiirus; samuti liikumise suundade arvnäitajaid).
* Näeb tegevuste ajalugu kliendist.

'''Tootja'''
* Saab lugeda kasutaja teadet.
* Saab vastata kasutajale.

'''Hooldaja'''
* Saab info hooldamist vajavate kellade kohta.

== Inkrement #3 ==
'''Kasutaja'''
* On ehitatud keeletugi.

'''Tootja'''
* On ehitatud keeletugi.

'''Hooldaja'''
* On ehitatud keeletugi.

Inkrementid valmisid (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

= XML ülesanne =
Järgnevalt esitame oma XML-ülesande tulemused.

== IT Management Transformation XML To XML ==
<pre>
<?xml version="1.0" encoding="utf-8"?>
<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">
<xsl:output method="xml" indent="yes"/>
<xsl:template match="/">
<unhandledDevices>
<xsl:for-each select="customers/customer/locations/location/items/item[@isInWorkingCondition='false']">
<device>
<name>
<xsl:value-of select="manufacturer"/>
<xsl:text> </xsl:text>
<xsl:value-of select="model"/>
</name>
<ticket>
<xsl:for-each select="tickets/ticket[@isHandled='false']">
<ticket_id>
<xsl:value-of select="@id"/>
</ticket_id>
<issued_in>
<xsl:value-of select="@issuedIn"/>
</issued_in>
<description>
<xsl:value-of select="description"/>
</description>
</xsl:for-each>
</ticket>
</device>
</xsl:for-each>
</unhandledDevices>
</xsl:template>
</xsl:stylesheet>
</pre>

== IT Management Transformation HTML ==

<pre>
<?xml version="1.0" encoding="utf-8"?>
<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">
<xsl:output method="html" indent="yes"/>
<xsl:template match="/">

<html>
<head>
<title>ItManagement Laptops</title>
</head>
<body style="background-color:#F7F7F7">
<h1>Computers</h1>
<xsl:for-each select="/customers/customer/locations/location/items/item[@type='laptopComputer']">
<xsl:sort select="@isActive='false'"/>
<hr />
<div>
<h3>
<xsl:value-of select="manufacturer"/>
</h3>
Model: 
<xsl:value-of select="model"/>
 
Serial number: 
<xsl:value-of select="serialNumber"/>
 
Date of purchase: 
<xsl:value-of select="dateOfPurchase"/>
 
Operating system: 
<xsl:value-of select="operatingSystem"/>
 
Is on active list: 
<xsl:value-of select="@isActive"/>
 
</div>

<div style="background-color:#E3FAEE" >

<xsl:for-each select="tickets/ticket">
<xsl:choose>
<xsl:when test="@isHandled='true'">
<h3>Handled tickets</h3>
<ul>
Issued in: 
<xsl:value-of select="@issuedIn"/>
 
Ticket ID: 
<xsl:value-of select="@id" />
 
Description: 
<xsl:value-of select="description"/>
 
Solution: 
<xsl:value-of select="solution"/>
 
</ul>
</xsl:when>
<xsl:when test="@isHandled='false'">
<div style="background-color:#FDE5E5">
<h3>Unhandled tickets</h3>
<ul>
Issued in: 
<xsl:value-of select="@issuedIn"/>
 
Ticket ID: 
<xsl:value-of select="@id" />
 
Description: 
<xsl:value-of select="description"/>
 
Solution: 
<xsl:value-of select="solution"/>
 
</ul>
</div>
</xsl:when>
</xsl:choose>
</xsl:for-each>

</div>
</xsl:for-each>
</body>
</html>
</xsl:template>
</xsl:stylesheet>
</pre>

== IT Management XSD ==

<pre>
<?xml version="1.0" encoding="utf-8"?>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="customers">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="customer">
<xs:complexType>
<xs:sequence>
<xs:element name="customerName" type="xs:string" />
<xs:element minOccurs="0" name="contactPerson" type="xs:string" />
<xs:element name="e-mail" type="xs:string" />
<xs:element name="phoneNumber" type="xs:string" />
<xs:element name="locations">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="location">
<xs:complexType>
<xs:sequence>
<xs:element name="city" type="xs:string" />
<xs:element name="address" type="xs:string" />
<xs:element name="comment" type="xs:string" />
<xs:element minOccurs="0" name="localContactPerson" type="xs:string" />
<xs:element minOccurs="0" name="localPhone" type="xs:string" />
<xs:element name="items">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="item">
<xs:complexType>
<xs:sequence>
<xs:element name="manufacturer" type="xs:string" />
<xs:element name="model" type="xs:string" />
<xs:element name="serialNumber" type="xs:string" />
<xs:element name="dateOfPurchase" type="xs:date" />
<xs:element minOccurs="0" name="operatingSystem">
<xs:complexType>
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute name="version" type="xs:string" use="required" />
</xs:extension>
</xs:simpleContent>
</xs:complexType>
</xs:element>
<xs:element minOccurs="0" name="tickets">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="ticket">
<xs:complexType>
<xs:sequence>
<xs:element name="description" type="xs:string" />
<xs:element name="solution" type="xs:string" />
</xs:sequence>
<xs:attribute name="id" type="xs:string" use="required" />
<xs:attribute name="issuedIn" type="xs:date" use="required" />
<xs:attribute name="isHandled" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:unsignedInt" use="required" />
<xs:attribute name="type" type="xs:string" use="required" />
<xs:attribute name="isActive" type="xs:boolean" use="required" />
<xs:attribute name="isUnderWarranty" type="xs:boolean" use="required" />
<xs:attribute name="warrantyInMonths" type="xs:unsignedByte" use="required" />
<xs:attribute name="isInWorkingCondition" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="type" type="xs:string" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:unsignedInt" use="required" />
<xs:attribute name="type" type="xs:string" use="required" />
<xs:attribute name="isActive" type="xs:boolean" use="required" />
<xs:attribute name="hasManyLocations" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
</pre>

== IT Management XML ==

<pre>
<?xml version="1.0" encoding="utf-8" ?>
<customers>
<customer id="33" type="company" isActive="true" hasManyLocations="true">
<customerName>Elamustevaba OÜ</customerName>
<contactPerson>Juhan Pühamees</contactPerson>
<e-mail>juhan@evaba.com</e-mail>
<phoneNumber>+37256565656</phoneNumber>
<locations>
<location type="office">
<city>Tallinn</city>
<address><![CDATA[Pikk 7, 56401]]></address>
<comment><![CDATA[3. korrus -> paremat kätt]]></comment>
<localContactPerson>Maiu Piimaauto</localContactPerson>
<localPhone>+3726510510</localPhone>
<items>
<item id="1" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="36" isInWorkingCondition="false">
<manufacturer>Dell</manufacturer>
<model>Inspiron 3558</model>
<serialNumber>6FGH5JN</serialNumber>
<dateOfPurchase>2017-07-22</dateOfPurchase>
<operatingSystem version="1709">Windows 10 Home</operatingSystem>
<tickets>
<ticket id="HWI001" issuedIn="2017-11-21" isHandled="true">
<description><![CDATA[Wi-Fi is not working]]></description>
<solution><![CDATA[Wi-Fi card replaced (Under the warranty)]]></solution>
</ticket>
<ticket id="SWI256" issuedIn="2018-05-05" isHandled="false">
<description><![CDATA[Computer keeps showing login screen]]></description>
<solution></solution>
</ticket>
</tickets>
</item>
<item id="55" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="60" isInWorkingCondition="true">
<manufacturer>Dell</manufacturer>
<model>Latitude E7550</model>
<serialNumber>8JGR78U</serialNumber>
<dateOfPurchase>2016-06-15</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Home</operatingSystem>
</item>
</items>
</location>
<location type="store">
<city>Tallinn</city>
<address><![CDATA[Lai 17, 56401]]></address>
<comment><![CDATA[keldrikorrusel]]></comment>
<localContactPerson>Tanja Õielemb</localContactPerson>
<localPhone>+3726510520</localPhone>
<items>
<item id="83" type="desktopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Lenovo</manufacturer>
<model>ThinkCentre M715</model>
<serialNumber>IO25689AD54KL</serialNumber>
<dateOfPurchase>2017-12-01</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Pro</operatingSystem>
</item>
<item id="12" type="monitor" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>AOC</manufacturer>
<model>L456</model>
<serialNumber>9803987YE54</serialNumber>
<dateOfPurchase>2015-05-03</dateOfPurchase>
<tickets>
<ticket id="HWI126" issuedIn="2016-01-18" isHandled="true">
<description><![CDATA[Doesn't work, no picture.]]></description>
<solution><![CDATA[Wasn't plugged in. Technician did it - works again!]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
<customer id="02" type="private" isActive="true" hasManyLocations="false">
<customerName>Kessu Sisselasi</customerName>
<e-mail>kessu@tripp.org</e-mail>
<phoneNumber>+372555555</phoneNumber>
<locations>
<location type="home">
<city>Saue</city>
<address><![CDATA[Kooli 4-8, 78965]]></address>
<comment><![CDATA[2. korrus. Kitsad koridorid.]]></comment>
<items>
<item id="98" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Acer</manufacturer>
<model>Aspire 5</model>
<serialNumber>475YRT89K4</serialNumber>
<dateOfPurchase>2018-03-25</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Home</operatingSystem>
</item>
<item id="4" type="laptopComputer" isActive="false" isUnderWarranty="false" warrantyInMonths="36" isInWorkingCondition="true">
<manufacturer>Lenovo</manufacturer>
<model>IdeaPad L530</model>
<serialNumber>U89TRY765ME</serialNumber>
<dateOfPurchase>2007-08-14</dateOfPurchase>
<operatingSystem version="">Windows XP</operatingSystem>
<tickets>
<ticket id="SWI069" issuedIn="2010-01-28" isHandled="true">
<description><![CDATA[Blue screen.]]></description>
<solution><![CDATA[Video driver update.]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
<customer id="26" type="company" isActive="true" hasManyLocations="true">
<customerName>Aktsiaselts OÜ</customerName>
<contactPerson>Gunnar Kuningas</contactPerson>
<e-mail>gunnar@kunn.ee</e-mail>
<phoneNumber>+3726985236</phoneNumber>
<locations>
<location type="office">
<city>Loksa</city>
<address><![CDATA[Kalda 14, 78965]]></address>
<comment><![CDATA[Sissepääs Rimi poolt, helesinine uks]]></comment>
<items>
<item id="26" type="laptopComputer" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Apple</manufacturer>
<model>Macbook Air</model>
<serialNumber>258JUY369</serialNumber>
<dateOfPurchase>2017-03-01</dateOfPurchase>
<operatingSystem version="High Sierra">OS X</operatingSystem>
</item>
<item id="59" type="laptopComputer" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="false">
<manufacturer>Acer</manufacturer>
<model>Chromebook 11</model>
<serialNumber>U89TRY765ME</serialNumber>
<dateOfPurchase>2016-04-23</dateOfPurchase>
<operatingSystem version="">Chrome OS</operatingSystem>
<tickets>
<ticket id="HWI046" issuedIn="2010-02-28" isHandled="false">
<description><![CDATA[Stripes on screen]]></description>
<solution><![CDATA[]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
</customers>
</pre>

= Link klientrakendusele ja API-le =
https://drive.google.com/file/d/1FU3XGGVHbn4BNNHAsOs7DQ4CzpEDwZUt/view?usp=sharing (nagu logidest näha lisasime selle lingi 08.06.2018, kuid siin on mõned üleliigsed kataloogid) 
https://drive.google.com/file/d/1A7cxeK15xlWSww_CPxpksSfj0m10qFQV/view?usp=sharing (09.06.2019 laadisime üles paki, kus on kustutatud kaks ebavajalikku kataloogi, mis võivad tekitada segadust)

[ failid eemaldatud seoses ärilise konfidentsiaalsuse nõudega 19.06.2018 ]

== Palun loe seda "readme" asemel ==

1. meie rakenduse implementeeritud skoop lähtub siin lehel (ülal), analüüsi osas defineeritud "Minimum viable product" kriteeriumitest 
2. lase API käima, tee andmebaaside migratsioonid ja update-database 
3. implementeeritud on kõik teenused, mis on nähtaval Swaggeris aadressil: "localhost:[pordinumber]/Swagger" 
4. kliendirakendus asub kataloogis 'WatchWindersClient' ja tegemist on solutioniga, mille võiks käivitada teises Visual Studio aknas 
5. klientrakenduse käivitumiseks tuleks muuta App.config failis muuta ära localhost portide numbrid asendades need enda arvutis oleva localhost pordiga ning lisada kehtiv JWT AccessToken, mille saab Postmaniga aadressilt api/Security/getToken "Email" ja "Password" abil pärast seda kui kasutaja on loodud 
6. küsimuste ja raskuste korral kirjuta tiit.kuuskmae@gmail.com (API) ja toomas.juhkov@gmail.com (klient). Vastame esimesel võimalusel.

= Retsensioonid =
1. Veebiteenuse retsensioon grupile "Kuldne Loojang". Kättesaadav: https://drive.google.com/file/d/1OtzOCPiWixsrbHcGCcdHgXIgz3_fsC7h/view

= Kasutatud kirjandus ja allikad =

1. Albahari, Joseph, Albari, Ben 2017. C# 7.0 in A Nutshell. Sebastopol: O’Reilly 
2. MariaDB Foundation. MariaDB. Kättesaadav:https://mariadb.org/ 
3. Martin, Robert 2018. Clean Architecture. Boston: Pearson Education

WatchWinders

2018-06-20T04:47:02Z

Tkuuskma: /* Andmemudel */

= Meeskond =

Toomas Juhkov, toomas.juhkov@gmail.com 
Tiit Kuuskmäe, tiit.kuuskmae@gmail.com 
Kunnar Kukk, Kunnar.kukk@gmail.com 

= Tegevuste logi =

08.02.2018 - meeskonna loomine, kokkuleppe sõlmimine teema osas 
10.02.2018 - õppejõu teavitamine koos esmase andmemudeliga 
15.02.2018 - lõpliku andmemudeli valmimine(versioon 5) 
18.02.2018 - õppejõu kinnitus, et teema ja meeskond kvalifiseeruvad 
22.02.2018 - viki lehe loomine ja analüüsi koostamise alustamine 
26.02.2018 - tiimi lisandus Kunnar Kukk 
01.03.2018 - tiimi sprint koosolek(seoses täiendava tiimiliikme lisandumisega täpsustasime skoopi) 
03.03.2018 - alustasime koodi kirjutamisega (tabelid klassideks ja annotatsioonid peale) 
06.03.2018 - täiendasime andmemudelit olemiga "UserTypeState" (et saaks muuta kasutajatüüpi) 
08.03.2018 - tiimi sprint koosolek 
18.03.2018 - lisasime olemid "Address", "AddressU", "AddressM", "OfferOfUser", "MediaInOffer" 
22.03.2018 - tiimi sprint koosolek, mis oli pühendatud andmemudeli täiendamisele 
23.03.2018 - pikem tiimi hackathon andmemudeli teemal 
29.03.2018 - täiendatud wiki lehte täielikult ringitöötatud andmemudeliga 
30.03.2018 - täiendatud wiki lehte andmemudeli metainfoga 
09.04.2018 - silusime andmemudelit (mõningad ebavajalikud viited olid sisse jäänud) 
06.05.2018 - panime uuendatud andmemudeli projekti wiki lehele üles 
07.05.2018 - osalesime õppejõu Mait Poska korraldatud hackathonil 
08.06.2018 - XML ülesanne, klientrakenduse ja API kood sai wiki lehel avalikuks 

Terve maikuu oli igapäevane suhtlus üle Skype'i ja fleep.io, mida me ei loginud (liiga tihedaks läks!).

= Kasutatavad metoodikad =

WatchWinders projektis plaanime kasutada peamiselt kaht metoodikat:

1. läbiv retsenseerimine (üks paariline teeb midagi valmis ja teine teeb sellele ülevaatuse; üksus lisatakse kui ülevaatus on lõplikult läbitud ning osapoolte vahel on saabunud konsensus) 
2. paaris programmeerimine (istume ühe masina taha maha ja kirjutame kolmekesi)

Tulenevalt kaugõppe formaadist saab ülekaalus olema esimene variant. Teist metoodikat kasutame nende osade kirjutamiseks, mille puhul võib arvata, et nende lahendamine on keeruline või et lahenduskäike võib olla väga erinevaid. Püüame jooksvalt siinses vikis kajastada ka seda, millise metoodika järgi üks või teine osa valmis.

= Projekti osad =

Alljärgnevalt anname ülevaate projekti osadest: 

(1) andmemudel 
(2) veebiteenuse analüüs 
(3) Minimum Viable Product definitsioon 
(4) Inkrement #1 
(5) Inkrement #2 
(6) Inkrement #3 

Projekti osad on meie viki lehel kirjeldatud valmimise järjekorras.

== Andmemudel ==

Andmemudeli koostamisel lähtusime õppejõu ette antud kriteeriumist, mille järgi andmemudelis on vähemalt 6 põhiolemit (tähistatud tumesinise ja lillaga - meie mudelis 11 tk),
mille hulgas ei sisaldu kasutajate tabelit (Person). 
 
Põhiolemid: 
* Watch - kell 
* Person - kasutaja/kollektsionäär või firma esindaja 
* Box - kellakarp 
* Organization - tootjad, edasimüüjad, hooldus 
* Settings - kellakarbi seade 
* Offer - pakkumine kollektsionäärile 
* Media - meediafailid kellade ja karpide kohta 
* Address - kasutaja/organisatsiooni aadress 
* ElectronicContact - elektrooniliste kontaktide loend 
* Log - logi 
* Access - paroolid ja kasutajanimed 
* Error - vead 
 
Type abiolemid: 
* WatchType - kellatüübid 
* PersonType - isikutüübid: admin, kasutaja 
* OrganizationType - organisatsioonitüübid: tootja, hooldaja, edasimüüja jt 
* ActionType - logi tüübid 
* ContactType - elektroonilise kontakti tüüp: skype, email, telefon jt 
 
Olekud: 
* PersonTypeState - isiku rolli kehtivus ajahetkel (isiku ja tüübi vaheline seos) 
* OrganizationTypeState - organisatsiooni olek(ud) ajahetkel 
 
Kuuluvus: 
* PersonWatch - isikute ja kellade vahelised seosed 
* PersonBox - isiku ja karbi vaheline seos 
* PersonAccess - isiku ja autentimisandmete vaheline seos 
* WatchInBox - kella ja karbi vaheline seos 
* ErrorInWatch - vea ja kella vaheline seos 
* SettingsInBox - seade ja karbi vaheline seos 
* WatchInOrganization - kella ja tootja vaheline seos 
* PersonInOrganization - isiku ja ettevõtte/organisatsiooni vaheline seos 
* SettingsOfWatchType - seade ja kellatüübi vaheline seos 
 
Abstraktsioonid: 
* Locator - abstraktsioon erinevate kontaktitüüpide jaoks 
* Party - abstraktsioon erinevate inimeste, organisatsioonide jt jaoks 
 
Kommunikatsioon: 
* OfferToPerson - isikule suunatud pakkumised 
* OfferFromPerson - isikult lähtuv pakkumine 
 
 
 
[ andmemudel eemaldatud 19.06.2018 seoses ärilise konfidentsiaalsuse nõudega; andmemudeli eemaldamine kooskõlastatud õppejõuga ]
 
 

Andmemudel valmis (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

== Veebiteenuse analüüs ==

Alljärgnevalt esitame kellakarpide infosüsteemi analüüsi järgmistes osades:

(1) toote/teenuse kirjeldus 
(2) probleemi kirjeldus 
(3) lahendus 
(4) süsteemi kasutajad 
(5) loodava API võimalused 
(6) funktsionaalsed nõuded 
(7) mittefunktsionaalsed nõuded 

=== Toote/teenuse kirjeldus ===
Teenuse eesmärgiks on lahendada probleem, kuidas jälgida kellakarpide kaudu mehhaaniliste käekellade seisundit ning keerata neid automaatselt üles distantsilt, näiteks juhul, kui kellade kollektsionäär ei asu füüsiliselt igapäevaselt oma kellade juures. Teenus võimaldab ka tootjal uuendada kontaktandmeid, saata personaalseid teateid. Administraatorile annab ülevaate platvormis toimuvast.

=== Probleemi kirjeldus ===
Mehhaaniliste käekellade kollektsionääride huvi kellakarpide vastu on mitmetahuline. Kollektsionääre huvitab arvepidamine – mitu kella, missuguste omaduste ja eripäradega neil kollektsioonis on. Teisalt soov eksponeerida oma kogusid kolleegidele ja sõpradele. Kellakarpidega täidetud sein või riiulid loovad selleks suurepärase võimaluse. Kolmandaks praktiline vajadus tagada kellavedrude õige vinnastatuse aste. Kaasaja mehhaanilised kellamehhanismid (''automatic'') võimaldavad kellakorpuse füüsilisel liigutamisel kellavedru automaatselt vinnastada.

Näiteks piisab kella kinnitamisest käele, et see hakkaks end käe liigutamisel üles keerama. Kuidas keerata aga üles seisvat kella, mis seisab paigal kellakarbis? Selleks on tänapäeva kellakarpides elektrimootor, mis tagab kella liigutamise vastavalt kellatüübile ettenähtud ööpäevase graafiku alusel. Kollektsionääride üheks probleemiks on see, kuidas juhtida sellist karpi ja omada jooksvat ülevaadet kõikidest oma karpidest, nende tehnilisest seadistusest ja kollektsiooni kuuluvatest kelladest olles tööreisil välisriigis?

=== Lahendus ===
Probleemi lahendamiseks ehitame REST + ASP.NET Core + WebAPI koos kliendiga, mis võimaldab kellakollektsionääridel hallata kellasid karpides, administraatoritel saada ülevaate süsteemist ning tootjatele lisada infot kollektsionääridele. Käesoleva projekti käigus '''ei tegeleta''' kahe IoT lahenduse kui terviku seisukohast olulise nüansiga: (i) karbi püsivara (''firmware'') loomisega, (ii) klientrakenduse ''frontend'' lõpliku häälestamisega (ilus .css ja pildid).

=== Süsteemi kasutajad ===
'''Kollektsionäär''' - haldab ja muudab infot oma kellade ning oma kellakarpide kohta. 
'''Administraator''' - haldab süsteemi infot, vajadusel eemaldab probleeme. 
'''Tootja''' - saab saata süsteemi kollektsionääridele mõeldud infot. 
'''Hooldaja''' - saab infot hooldamist vajavate kellade ja -karpide kohta. 

=== Loodava API võimalused ===
Alljärgnevalt vaatame loodava API võimalusi kasutajagruppide kaupa:

'''Kasutajale/kellakollektsionäärile'''
* Saada ülevaade kelladest ja kellakarpidest (lisada, muuta, vaadata).
* Muuta karbis oleva kella kohta käivat informatsiooni (kella nimi, tootja, tootmise aeg, viitenumber, mehhanism, jõureservi jääk (valikuline), foto kellast, kellarihma liik, muu).
* Karpe juhtida (keerata automaatselt üles). Näha ja muuta kella üleskeerava mehhanismi liikumise kiirust ja muid detaile (nt liikumise suund).
* Näha karbi seisundit, kas karp on hetkel wifiga ühendatud või mitte.
* Näha karbilt saabunud veateateid.
* Sisestada infot kella seisundist.
* Suhelda hooldajate ja tootjatega

'''Tootjale'''
* Uuendada kontaktandmeid.
* Saata personaalseid teateid kellakollektsionääridele.

'''Administraatorile'''
* Näha võrku ühendatud karpide arvu.
* Näha karpidesse paigaldatud kellade nimistut (ilma muude kasutajaandmeteta).
* Näha kellade üleskeeramise mehhanismide arvnäitajaid (madalaim kiirus, keskmine kiirus, tippkiirus; samuti liikumise suundade arvnäitajaid).
* IP-aadresside järgi ülevaadet, millistes riikides karpe kasutatakse (üldised arvandmed).
* Veateatega karpide arv süsteemis (üldised arvandmed).

=== Funktsionaalsed nõuded ===
* Kõik tegevused peavad olema autoriseeritud.
* REST + ASP.NET Core + WebAPI tagastab infot valideeritud JSON formaadis.
* API veatöötlus on tehtud, kasutades standardseid veakoode.
* API-le on tehtud 'health check'.
* Kõik kasutajad peavad saama end autoriseerida.
* Kasutaja, tootja ja administraatori tegevused logitakse.
* Logi ei ole muudetav, vaid on kättesaadav.
* Kasutaja ega tootja ei näe teiste kasutajate ega tootjate infot.
* API klient on kohanduv mobiilile, tahvlile ja desktoparvutile.
* Sisendandmed on valideeritud.

=== Mittefunktsionaalsed nõuded ===
* API-le on lisatud Swagger fail.
* Teenus ja tehniline lahendus on dokumenteeritud.
* Süsteemi kood on vabalt ligipääsetav, täiendatav ning allalaetav.

Esitame töö etappidena, kus kõigepealt defineerime ära Minimum Viable Producti [https://en.wikipedia.org/wiki/Minimum_viable_product] ehk selle miinimumi, mis pakub kasutajale maksimaalset väärtust. See tähendab API loomist ning esmase kliendi loomist kõigile MVP-s defineeritud kasutajagruppidele. Seejärel realiseerime projekti inkrementide ehk tootearenduse sammudena, milles lisame uusi funktsionaalsusi. Ideaalis jõuame realiseerida kõik sammud, kuid kuna teeme nimetatud tööd antud ajaraamis ja koosseisus esmakordselt, siis võtame vabaduse ka realiseerida korralikult niipalju, kui jõuame projekti käigus ära teha.

Võimalik, et meie lõpptulemus erineb mõnes osas esitatud analüüsist. Seda olenevalt sellest kui edukalt meil õnnestub plaanitud funktsionaalsusi realiseerida. Erisusi plaanime käsitleda vastavas 'post production' jaotuses, kus loendame ka projektist kogunenud peamised õppetunnid.

Analüüs valmis (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

== Minimum Viable Product definitsioon ==
'''Kasutaja'''
* Kasutaja saab süsteemi logida ning välja logida
* Kasutaja saab lisada uue kellakarbi
* Kasutaja saab lisada uue kella kellakarpi
* Kasutaja saab muuta kella infot kellakarbis
* Kasutaja saab näha ülevaadet oma karpidest
* Kasutaja saab muuta kellakarbi seadeid
* Kasutaja saab kustutada kella karbis
* Kasutaja saab kustutada kellakarbi

'''Administraator'''
* Näeb autoriseeritult logisid

'''Tootja'''
* Saab lisada kontaktandmeid
* Saab kontaktandmeid muuta

== Inkrement #1 ==
'''Kasutaja'''
* Näeb karbilt saabunud veateateid.
* Saab kellakarpe juhtida.

'''Administraator'''
* IP-aadresside järgi ülevaadet, millistes riikides karpe kasutatakse (üldised arvandmed).
* Karpidesse paigaldatud kellade nimistut (ilma muude kasutajaandmeteta).
* Näeb kasutajate statistikat.

'''Tootja'''
* Saata personaalseid teateid kellakollektsionääridele.

== Inkrement #2 ==
'''Kasutaja'''
* Saab saata teate tootjale.
* Näeb tootja vastust.
* Näha karbi seisundit, kas karp on hetkel wifiga ühendatud või mitte.

'''Administraator'''
* Näha kellade üleskeeramise mehhanismide arvnäitajaid (madalaim kiirus, keskmine kiirus, tippkiirus; samuti liikumise suundade arvnäitajaid).
* Näeb tegevuste ajalugu kliendist.

'''Tootja'''
* Saab lugeda kasutaja teadet.
* Saab vastata kasutajale.

'''Hooldaja'''
* Saab info hooldamist vajavate kellade kohta.

== Inkrement #3 ==
'''Kasutaja'''
* On ehitatud keeletugi.

'''Tootja'''
* On ehitatud keeletugi.

'''Hooldaja'''
* On ehitatud keeletugi.

Inkrementid valmisid (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

= XML ülesanne =
Järgnevalt esitame oma XML-ülesande tulemused.

== IT Management Transformation XML To XML ==
<pre>
<?xml version="1.0" encoding="utf-8"?>
<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">
<xsl:output method="xml" indent="yes"/>
<xsl:template match="/">
<unhandledDevices>
<xsl:for-each select="customers/customer/locations/location/items/item[@isInWorkingCondition='false']">
<device>
<name>
<xsl:value-of select="manufacturer"/>
<xsl:text> </xsl:text>
<xsl:value-of select="model"/>
</name>
<ticket>
<xsl:for-each select="tickets/ticket[@isHandled='false']">
<ticket_id>
<xsl:value-of select="@id"/>
</ticket_id>
<issued_in>
<xsl:value-of select="@issuedIn"/>
</issued_in>
<description>
<xsl:value-of select="description"/>
</description>
</xsl:for-each>
</ticket>
</device>
</xsl:for-each>
</unhandledDevices>
</xsl:template>
</xsl:stylesheet>
</pre>

== IT Management Transformation HTML ==

<pre>
<?xml version="1.0" encoding="utf-8"?>
<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">
<xsl:output method="html" indent="yes"/>
<xsl:template match="/">

<html>
<head>
<title>ItManagement Laptops</title>
</head>
<body style="background-color:#F7F7F7">
<h1>Computers</h1>
<xsl:for-each select="/customers/customer/locations/location/items/item[@type='laptopComputer']">
<xsl:sort select="@isActive='false'"/>
<hr />
<div>
<h3>
<xsl:value-of select="manufacturer"/>
</h3>
Model: 
<xsl:value-of select="model"/>
 
Serial number: 
<xsl:value-of select="serialNumber"/>
 
Date of purchase: 
<xsl:value-of select="dateOfPurchase"/>
 
Operating system: 
<xsl:value-of select="operatingSystem"/>
 
Is on active list: 
<xsl:value-of select="@isActive"/>
 
</div>

<div style="background-color:#E3FAEE" >

<xsl:for-each select="tickets/ticket">
<xsl:choose>
<xsl:when test="@isHandled='true'">
<h3>Handled tickets</h3>
<ul>
Issued in: 
<xsl:value-of select="@issuedIn"/>
 
Ticket ID: 
<xsl:value-of select="@id" />
 
Description: 
<xsl:value-of select="description"/>
 
Solution: 
<xsl:value-of select="solution"/>
 
</ul>
</xsl:when>
<xsl:when test="@isHandled='false'">
<div style="background-color:#FDE5E5">
<h3>Unhandled tickets</h3>
<ul>
Issued in: 
<xsl:value-of select="@issuedIn"/>
 
Ticket ID: 
<xsl:value-of select="@id" />
 
Description: 
<xsl:value-of select="description"/>
 
Solution: 
<xsl:value-of select="solution"/>
 
</ul>
</div>
</xsl:when>
</xsl:choose>
</xsl:for-each>

</div>
</xsl:for-each>
</body>
</html>
</xsl:template>
</xsl:stylesheet>
</pre>

== IT Management XSD ==

<pre>
<?xml version="1.0" encoding="utf-8"?>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="customers">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="customer">
<xs:complexType>
<xs:sequence>
<xs:element name="customerName" type="xs:string" />
<xs:element minOccurs="0" name="contactPerson" type="xs:string" />
<xs:element name="e-mail" type="xs:string" />
<xs:element name="phoneNumber" type="xs:string" />
<xs:element name="locations">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="location">
<xs:complexType>
<xs:sequence>
<xs:element name="city" type="xs:string" />
<xs:element name="address" type="xs:string" />
<xs:element name="comment" type="xs:string" />
<xs:element minOccurs="0" name="localContactPerson" type="xs:string" />
<xs:element minOccurs="0" name="localPhone" type="xs:string" />
<xs:element name="items">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="item">
<xs:complexType>
<xs:sequence>
<xs:element name="manufacturer" type="xs:string" />
<xs:element name="model" type="xs:string" />
<xs:element name="serialNumber" type="xs:string" />
<xs:element name="dateOfPurchase" type="xs:date" />
<xs:element minOccurs="0" name="operatingSystem">
<xs:complexType>
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute name="version" type="xs:string" use="required" />
</xs:extension>
</xs:simpleContent>
</xs:complexType>
</xs:element>
<xs:element minOccurs="0" name="tickets">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="ticket">
<xs:complexType>
<xs:sequence>
<xs:element name="description" type="xs:string" />
<xs:element name="solution" type="xs:string" />
</xs:sequence>
<xs:attribute name="id" type="xs:string" use="required" />
<xs:attribute name="issuedIn" type="xs:date" use="required" />
<xs:attribute name="isHandled" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:unsignedInt" use="required" />
<xs:attribute name="type" type="xs:string" use="required" />
<xs:attribute name="isActive" type="xs:boolean" use="required" />
<xs:attribute name="isUnderWarranty" type="xs:boolean" use="required" />
<xs:attribute name="warrantyInMonths" type="xs:unsignedByte" use="required" />
<xs:attribute name="isInWorkingCondition" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="type" type="xs:string" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:unsignedInt" use="required" />
<xs:attribute name="type" type="xs:string" use="required" />
<xs:attribute name="isActive" type="xs:boolean" use="required" />
<xs:attribute name="hasManyLocations" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
</pre>

== IT Management XML ==

<pre>
<?xml version="1.0" encoding="utf-8" ?>
<customers>
<customer id="33" type="company" isActive="true" hasManyLocations="true">
<customerName>Elamustevaba OÜ</customerName>
<contactPerson>Juhan Pühamees</contactPerson>
<e-mail>juhan@evaba.com</e-mail>
<phoneNumber>+37256565656</phoneNumber>
<locations>
<location type="office">
<city>Tallinn</city>
<address><![CDATA[Pikk 7, 56401]]></address>
<comment><![CDATA[3. korrus -> paremat kätt]]></comment>
<localContactPerson>Maiu Piimaauto</localContactPerson>
<localPhone>+3726510510</localPhone>
<items>
<item id="1" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="36" isInWorkingCondition="false">
<manufacturer>Dell</manufacturer>
<model>Inspiron 3558</model>
<serialNumber>6FGH5JN</serialNumber>
<dateOfPurchase>2017-07-22</dateOfPurchase>
<operatingSystem version="1709">Windows 10 Home</operatingSystem>
<tickets>
<ticket id="HWI001" issuedIn="2017-11-21" isHandled="true">
<description><![CDATA[Wi-Fi is not working]]></description>
<solution><![CDATA[Wi-Fi card replaced (Under the warranty)]]></solution>
</ticket>
<ticket id="SWI256" issuedIn="2018-05-05" isHandled="false">
<description><![CDATA[Computer keeps showing login screen]]></description>
<solution></solution>
</ticket>
</tickets>
</item>
<item id="55" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="60" isInWorkingCondition="true">
<manufacturer>Dell</manufacturer>
<model>Latitude E7550</model>
<serialNumber>8JGR78U</serialNumber>
<dateOfPurchase>2016-06-15</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Home</operatingSystem>
</item>
</items>
</location>
<location type="store">
<city>Tallinn</city>
<address><![CDATA[Lai 17, 56401]]></address>
<comment><![CDATA[keldrikorrusel]]></comment>
<localContactPerson>Tanja Õielemb</localContactPerson>
<localPhone>+3726510520</localPhone>
<items>
<item id="83" type="desktopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Lenovo</manufacturer>
<model>ThinkCentre M715</model>
<serialNumber>IO25689AD54KL</serialNumber>
<dateOfPurchase>2017-12-01</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Pro</operatingSystem>
</item>
<item id="12" type="monitor" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>AOC</manufacturer>
<model>L456</model>
<serialNumber>9803987YE54</serialNumber>
<dateOfPurchase>2015-05-03</dateOfPurchase>
<tickets>
<ticket id="HWI126" issuedIn="2016-01-18" isHandled="true">
<description><![CDATA[Doesn't work, no picture.]]></description>
<solution><![CDATA[Wasn't plugged in. Technician did it - works again!]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
<customer id="02" type="private" isActive="true" hasManyLocations="false">
<customerName>Kessu Sisselasi</customerName>
<e-mail>kessu@tripp.org</e-mail>
<phoneNumber>+372555555</phoneNumber>
<locations>
<location type="home">
<city>Saue</city>
<address><![CDATA[Kooli 4-8, 78965]]></address>
<comment><![CDATA[2. korrus. Kitsad koridorid.]]></comment>
<items>
<item id="98" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Acer</manufacturer>
<model>Aspire 5</model>
<serialNumber>475YRT89K4</serialNumber>
<dateOfPurchase>2018-03-25</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Home</operatingSystem>
</item>
<item id="4" type="laptopComputer" isActive="false" isUnderWarranty="false" warrantyInMonths="36" isInWorkingCondition="true">
<manufacturer>Lenovo</manufacturer>
<model>IdeaPad L530</model>
<serialNumber>U89TRY765ME</serialNumber>
<dateOfPurchase>2007-08-14</dateOfPurchase>
<operatingSystem version="">Windows XP</operatingSystem>
<tickets>
<ticket id="SWI069" issuedIn="2010-01-28" isHandled="true">
<description><![CDATA[Blue screen.]]></description>
<solution><![CDATA[Video driver update.]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
<customer id="26" type="company" isActive="true" hasManyLocations="true">
<customerName>Aktsiaselts OÜ</customerName>
<contactPerson>Gunnar Kuningas</contactPerson>
<e-mail>gunnar@kunn.ee</e-mail>
<phoneNumber>+3726985236</phoneNumber>
<locations>
<location type="office">
<city>Loksa</city>
<address><![CDATA[Kalda 14, 78965]]></address>
<comment><![CDATA[Sissepääs Rimi poolt, helesinine uks]]></comment>
<items>
<item id="26" type="laptopComputer" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Apple</manufacturer>
<model>Macbook Air</model>
<serialNumber>258JUY369</serialNumber>
<dateOfPurchase>2017-03-01</dateOfPurchase>
<operatingSystem version="High Sierra">OS X</operatingSystem>
</item>
<item id="59" type="laptopComputer" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="false">
<manufacturer>Acer</manufacturer>
<model>Chromebook 11</model>
<serialNumber>U89TRY765ME</serialNumber>
<dateOfPurchase>2016-04-23</dateOfPurchase>
<operatingSystem version="">Chrome OS</operatingSystem>
<tickets>
<ticket id="HWI046" issuedIn="2010-02-28" isHandled="false">
<description><![CDATA[Stripes on screen]]></description>
<solution><![CDATA[]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
</customers>
</pre>

= Link klientrakendusele ja API-le =
https://drive.google.com/file/d/1FU3XGGVHbn4BNNHAsOs7DQ4CzpEDwZUt/view?usp=sharing (nagu logidest näha lisasime selle lingi 08.06.2018, kuid siin on mõned üleliigsed kataloogid) 
https://drive.google.com/file/d/1A7cxeK15xlWSww_CPxpksSfj0m10qFQV/view?usp=sharing (09.06.2019 laadisime üles paki, kus on kustutatud kaks ebavajalikku kataloogi, mis võivad tekitada segadust)

[ failid eemaldatud seoses ärilise konfidentsiaalsuse nõudega 19.06.2018 ]

== Palun loe seda "readme" asemel ==

1. meie rakenduse implementeeritud skoop lähtub siin lehel (ülal), analüüsi osas defineeritud "Minimum viable product" kriteeriumitest 
2. lase API käima, tee andmebaaside migratsioonid ja update-database 
3. implementeeritud on kõik teenused, mis on nähtaval Swaggeris aadressil: "localhost:[pordinumber]/Swagger" 
4. kliendirakendus asub kataloogis 'WatchWindersClient' ja tegemist on solutioniga, mille võiks käivitada teises Visual Studio aknas 
5. klientrakenduse käivitumiseks tuleks muuta App.config failis muuta ära localhost portide numbrid asendades need enda arvutis oleva localhost pordiga ning lisada kehtiv JWT AccessToken, mille saab Postmaniga aadressilt api/Security/getToken "Email" ja "Password" abil pärast seda kui kasutaja on loodud 
6. küsimuste ja raskuste korral kirjuta tiit.kuuskmae@gmail.com (API) ja toomas.juhkov@gmail.com (klient). Vastame esimesel võimalusel.

= Retsensioonid =
1. Veebiteenuse retsensioon grupile "Kuldne Loojang". Kättesaadav: https://drive.google.com/file/d/1OtzOCPiWixsrbHcGCcdHgXIgz3_fsC7h/view

= Kasutatud kirjandus ja allikad =

1. Albahari, Joseph, Albari, Ben 2017. C# 7.0 in A Nutshell. Sebastopol: O’Reilly 
2. MariaDB Foundation. MariaDB. Kättesaadav:https://mariadb.org/ 
3. Martin, Robert 2018. Clean Architecture. Boston: Pearson Education

WatchWinders

2018-06-19T17:53:55Z

Tkuuskma: /* Andmemudel */

= Meeskond =

Toomas Juhkov, toomas.juhkov@gmail.com 
Tiit Kuuskmäe, tiit.kuuskmae@gmail.com 
Kunnar Kukk, Kunnar.kukk@gmail.com 

= Tegevuste logi =

08.02.2018 - meeskonna loomine, kokkuleppe sõlmimine teema osas 
10.02.2018 - õppejõu teavitamine koos esmase andmemudeliga 
15.02.2018 - lõpliku andmemudeli valmimine(versioon 5) 
18.02.2018 - õppejõu kinnitus, et teema ja meeskond kvalifiseeruvad 
22.02.2018 - viki lehe loomine ja analüüsi koostamise alustamine 
26.02.2018 - tiimi lisandus Kunnar Kukk 
01.03.2018 - tiimi sprint koosolek(seoses täiendava tiimiliikme lisandumisega täpsustasime skoopi) 
03.03.2018 - alustasime koodi kirjutamisega (tabelid klassideks ja annotatsioonid peale) 
06.03.2018 - täiendasime andmemudelit olemiga "UserTypeState" (et saaks muuta kasutajatüüpi) 
08.03.2018 - tiimi sprint koosolek 
18.03.2018 - lisasime olemid "Address", "AddressU", "AddressM", "OfferOfUser", "MediaInOffer" 
22.03.2018 - tiimi sprint koosolek, mis oli pühendatud andmemudeli täiendamisele 
23.03.2018 - pikem tiimi hackathon andmemudeli teemal 
29.03.2018 - täiendatud wiki lehte täielikult ringitöötatud andmemudeliga 
30.03.2018 - täiendatud wiki lehte andmemudeli metainfoga 
09.04.2018 - silusime andmemudelit (mõningad ebavajalikud viited olid sisse jäänud) 
06.05.2018 - panime uuendatud andmemudeli projekti wiki lehele üles 
07.05.2018 - osalesime õppejõu Mait Poska korraldatud hackathonil 
08.06.2018 - XML ülesanne, klientrakenduse ja API kood sai wiki lehel avalikuks 

Terve maikuu oli igapäevane suhtlus üle Skype'i ja fleep.io, mida me ei loginud (liiga tihedaks läks!).

= Kasutatavad metoodikad =

WatchWinders projektis plaanime kasutada peamiselt kaht metoodikat:

1. läbiv retsenseerimine (üks paariline teeb midagi valmis ja teine teeb sellele ülevaatuse; üksus lisatakse kui ülevaatus on lõplikult läbitud ning osapoolte vahel on saabunud konsensus) 
2. paaris programmeerimine (istume ühe masina taha maha ja kirjutame kolmekesi)

Tulenevalt kaugõppe formaadist saab ülekaalus olema esimene variant. Teist metoodikat kasutame nende osade kirjutamiseks, mille puhul võib arvata, et nende lahendamine on keeruline või et lahenduskäike võib olla väga erinevaid. Püüame jooksvalt siinses vikis kajastada ka seda, millise metoodika järgi üks või teine osa valmis.

= Projekti osad =

Alljärgnevalt anname ülevaate projekti osadest: 

(1) andmemudel 
(2) veebiteenuse analüüs 
(3) Minimum Viable Product definitsioon 
(4) Inkrement #1 
(5) Inkrement #2 
(6) Inkrement #3 

Projekti osad on meie viki lehel kirjeldatud valmimise järjekorras.

== Andmemudel ==

Andmemudeli koostamisel lähtusime õppejõu ette antud kriteeriumist, mille järgi andmemudelis on vähemalt 6 põhiolemit (tähistatud tumesinise ja lillaga - meie mudelis 11 tk),
mille hulgas ei sisaldu kasutajate tabelit (Person). 
 
Põhiolemid: 
* Watch - kell 
* Person - kasutaja/kollektsionäär või firma esindaja 
* Box - kellakarp 
* Organization - tootjad, edasimüüjad, hooldus 
* Settings - kellakarbi seade 
* Offer - pakkumine kollektsionäärile 
* Media - meediafailid kellade ja karpide kohta 
* Address - kasutaja/organisatsiooni aadress 
* ElectronicContact - elektrooniliste kontaktide loend 
* Log - logi 
* Access - paroolid ja kasutajanimed 
* Error - vead 
 
Type abiolemid: 
* WatchType - kellatüübid 
* PersonType - isikutüübid: admin, kasutaja 
* OrganizationType - organisatsioonitüübid: tootja, hooldaja, edasimüüja jt 
* ActionType - logi tüübid 
* ContactType - elektroonilise kontakti tüüp: skype, email, telefon jt 
 
Olekud: 
* PersonTypeState - isiku rolli kehtivus ajahetkel (isiku ja tüübi vaheline seos) 
* OrganizationTypeState - organisatsiooni olek(ud) ajahetkel 
 
Kuuluvus: 
* PersonWatch - isikute ja kellade vahelised seosed 
* PersonBox - isiku ja karbi vaheline seos 
* PersonAccess - isiku ja autentimisandmete vaheline seos 
* WatchInBox - kella ja karbi vaheline seos 
* ErrorInWatch - vea ja kella vaheline seos 
* SettingsInBox - seade ja karbi vaheline seos 
* WatchInOrganization - kella ja tootja vaheline seos 
* PersonInOrganization - isiku ja ettevõtte/organisatsiooni vaheline seos 
* SettingsOfWatchType - seade ja kellatüübi vaheline seos 
 
Abstraktsioonid: 
* Locator - abstraktsioon erinevate kontaktitüüpide jaoks 
* Party - abstraktsioon erinevate inimeste, organisatsioonide jt jaoks 
 
Kommunikatsioon: 
* OfferToPerson - isikule suunatud pakkumised 
* OfferFromPerson - isikult lähtuv pakkumine 
 
 
 
[ andmemudel eemaldatud 19.06.2018 seoses ärilise konfidentsiaalsuse nõudega ]
 

Andmemudel valmis (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

== Veebiteenuse analüüs ==

Alljärgnevalt esitame kellakarpide infosüsteemi analüüsi järgmistes osades:

(1) toote/teenuse kirjeldus 
(2) probleemi kirjeldus 
(3) lahendus 
(4) süsteemi kasutajad 
(5) loodava API võimalused 
(6) funktsionaalsed nõuded 
(7) mittefunktsionaalsed nõuded 

=== Toote/teenuse kirjeldus ===
Teenuse eesmärgiks on lahendada probleem, kuidas jälgida kellakarpide kaudu mehhaaniliste käekellade seisundit ning keerata neid automaatselt üles distantsilt, näiteks juhul, kui kellade kollektsionäär ei asu füüsiliselt igapäevaselt oma kellade juures. Teenus võimaldab ka tootjal uuendada kontaktandmeid, saata personaalseid teateid. Administraatorile annab ülevaate platvormis toimuvast.

=== Probleemi kirjeldus ===
Mehhaaniliste käekellade kollektsionääride huvi kellakarpide vastu on mitmetahuline. Kollektsionääre huvitab arvepidamine – mitu kella, missuguste omaduste ja eripäradega neil kollektsioonis on. Teisalt soov eksponeerida oma kogusid kolleegidele ja sõpradele. Kellakarpidega täidetud sein või riiulid loovad selleks suurepärase võimaluse. Kolmandaks praktiline vajadus tagada kellavedrude õige vinnastatuse aste. Kaasaja mehhaanilised kellamehhanismid (''automatic'') võimaldavad kellakorpuse füüsilisel liigutamisel kellavedru automaatselt vinnastada.

Näiteks piisab kella kinnitamisest käele, et see hakkaks end käe liigutamisel üles keerama. Kuidas keerata aga üles seisvat kella, mis seisab paigal kellakarbis? Selleks on tänapäeva kellakarpides elektrimootor, mis tagab kella liigutamise vastavalt kellatüübile ettenähtud ööpäevase graafiku alusel. Kollektsionääride üheks probleemiks on see, kuidas juhtida sellist karpi ja omada jooksvat ülevaadet kõikidest oma karpidest, nende tehnilisest seadistusest ja kollektsiooni kuuluvatest kelladest olles tööreisil välisriigis?

=== Lahendus ===
Probleemi lahendamiseks ehitame REST + ASP.NET Core + WebAPI koos kliendiga, mis võimaldab kellakollektsionääridel hallata kellasid karpides, administraatoritel saada ülevaate süsteemist ning tootjatele lisada infot kollektsionääridele. Käesoleva projekti käigus '''ei tegeleta''' kahe IoT lahenduse kui terviku seisukohast olulise nüansiga: (i) karbi püsivara (''firmware'') loomisega, (ii) klientrakenduse ''frontend'' lõpliku häälestamisega (ilus .css ja pildid).

=== Süsteemi kasutajad ===
'''Kollektsionäär''' - haldab ja muudab infot oma kellade ning oma kellakarpide kohta. 
'''Administraator''' - haldab süsteemi infot, vajadusel eemaldab probleeme. 
'''Tootja''' - saab saata süsteemi kollektsionääridele mõeldud infot. 
'''Hooldaja''' - saab infot hooldamist vajavate kellade ja -karpide kohta. 

=== Loodava API võimalused ===
Alljärgnevalt vaatame loodava API võimalusi kasutajagruppide kaupa:

'''Kasutajale/kellakollektsionäärile'''
* Saada ülevaade kelladest ja kellakarpidest (lisada, muuta, vaadata).
* Muuta karbis oleva kella kohta käivat informatsiooni (kella nimi, tootja, tootmise aeg, viitenumber, mehhanism, jõureservi jääk (valikuline), foto kellast, kellarihma liik, muu).
* Karpe juhtida (keerata automaatselt üles). Näha ja muuta kella üleskeerava mehhanismi liikumise kiirust ja muid detaile (nt liikumise suund).
* Näha karbi seisundit, kas karp on hetkel wifiga ühendatud või mitte.
* Näha karbilt saabunud veateateid.
* Sisestada infot kella seisundist.
* Suhelda hooldajate ja tootjatega

'''Tootjale'''
* Uuendada kontaktandmeid.
* Saata personaalseid teateid kellakollektsionääridele.

'''Administraatorile'''
* Näha võrku ühendatud karpide arvu.
* Näha karpidesse paigaldatud kellade nimistut (ilma muude kasutajaandmeteta).
* Näha kellade üleskeeramise mehhanismide arvnäitajaid (madalaim kiirus, keskmine kiirus, tippkiirus; samuti liikumise suundade arvnäitajaid).
* IP-aadresside järgi ülevaadet, millistes riikides karpe kasutatakse (üldised arvandmed).
* Veateatega karpide arv süsteemis (üldised arvandmed).

=== Funktsionaalsed nõuded ===
* Kõik tegevused peavad olema autoriseeritud.
* REST + ASP.NET Core + WebAPI tagastab infot valideeritud JSON formaadis.
* API veatöötlus on tehtud, kasutades standardseid veakoode.
* API-le on tehtud 'health check'.
* Kõik kasutajad peavad saama end autoriseerida.
* Kasutaja, tootja ja administraatori tegevused logitakse.
* Logi ei ole muudetav, vaid on kättesaadav.
* Kasutaja ega tootja ei näe teiste kasutajate ega tootjate infot.
* API klient on kohanduv mobiilile, tahvlile ja desktoparvutile.
* Sisendandmed on valideeritud.

=== Mittefunktsionaalsed nõuded ===
* API-le on lisatud Swagger fail.
* Teenus ja tehniline lahendus on dokumenteeritud.
* Süsteemi kood on vabalt ligipääsetav, täiendatav ning allalaetav.

Esitame töö etappidena, kus kõigepealt defineerime ära Minimum Viable Producti [https://en.wikipedia.org/wiki/Minimum_viable_product] ehk selle miinimumi, mis pakub kasutajale maksimaalset väärtust. See tähendab API loomist ning esmase kliendi loomist kõigile MVP-s defineeritud kasutajagruppidele. Seejärel realiseerime projekti inkrementide ehk tootearenduse sammudena, milles lisame uusi funktsionaalsusi. Ideaalis jõuame realiseerida kõik sammud, kuid kuna teeme nimetatud tööd antud ajaraamis ja koosseisus esmakordselt, siis võtame vabaduse ka realiseerida korralikult niipalju, kui jõuame projekti käigus ära teha.

Võimalik, et meie lõpptulemus erineb mõnes osas esitatud analüüsist. Seda olenevalt sellest kui edukalt meil õnnestub plaanitud funktsionaalsusi realiseerida. Erisusi plaanime käsitleda vastavas 'post production' jaotuses, kus loendame ka projektist kogunenud peamised õppetunnid.

Analüüs valmis (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

== Minimum Viable Product definitsioon ==
'''Kasutaja'''
* Kasutaja saab süsteemi logida ning välja logida
* Kasutaja saab lisada uue kellakarbi
* Kasutaja saab lisada uue kella kellakarpi
* Kasutaja saab muuta kella infot kellakarbis
* Kasutaja saab näha ülevaadet oma karpidest
* Kasutaja saab muuta kellakarbi seadeid
* Kasutaja saab kustutada kella karbis
* Kasutaja saab kustutada kellakarbi

'''Administraator'''
* Näeb autoriseeritult logisid

'''Tootja'''
* Saab lisada kontaktandmeid
* Saab kontaktandmeid muuta

== Inkrement #1 ==
'''Kasutaja'''
* Näeb karbilt saabunud veateateid.
* Saab kellakarpe juhtida.

'''Administraator'''
* IP-aadresside järgi ülevaadet, millistes riikides karpe kasutatakse (üldised arvandmed).
* Karpidesse paigaldatud kellade nimistut (ilma muude kasutajaandmeteta).
* Näeb kasutajate statistikat.

'''Tootja'''
* Saata personaalseid teateid kellakollektsionääridele.

== Inkrement #2 ==
'''Kasutaja'''
* Saab saata teate tootjale.
* Näeb tootja vastust.
* Näha karbi seisundit, kas karp on hetkel wifiga ühendatud või mitte.

'''Administraator'''
* Näha kellade üleskeeramise mehhanismide arvnäitajaid (madalaim kiirus, keskmine kiirus, tippkiirus; samuti liikumise suundade arvnäitajaid).
* Näeb tegevuste ajalugu kliendist.

'''Tootja'''
* Saab lugeda kasutaja teadet.
* Saab vastata kasutajale.

'''Hooldaja'''
* Saab info hooldamist vajavate kellade kohta.

== Inkrement #3 ==
'''Kasutaja'''
* On ehitatud keeletugi.

'''Tootja'''
* On ehitatud keeletugi.

'''Hooldaja'''
* On ehitatud keeletugi.

Inkrementid valmisid (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

= XML ülesanne =
Järgnevalt esitame oma XML-ülesande tulemused.

== IT Management Transformation XML To XML ==
<pre>
<?xml version="1.0" encoding="utf-8"?>
<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">
<xsl:output method="xml" indent="yes"/>
<xsl:template match="/">
<unhandledDevices>
<xsl:for-each select="customers/customer/locations/location/items/item[@isInWorkingCondition='false']">
<device>
<name>
<xsl:value-of select="manufacturer"/>
<xsl:text> </xsl:text>
<xsl:value-of select="model"/>
</name>
<ticket>
<xsl:for-each select="tickets/ticket[@isHandled='false']">
<ticket_id>
<xsl:value-of select="@id"/>
</ticket_id>
<issued_in>
<xsl:value-of select="@issuedIn"/>
</issued_in>
<description>
<xsl:value-of select="description"/>
</description>
</xsl:for-each>
</ticket>
</device>
</xsl:for-each>
</unhandledDevices>
</xsl:template>
</xsl:stylesheet>
</pre>

== IT Management Transformation HTML ==

<pre>
<?xml version="1.0" encoding="utf-8"?>
<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">
<xsl:output method="html" indent="yes"/>
<xsl:template match="/">

<html>
<head>
<title>ItManagement Laptops</title>
</head>
<body style="background-color:#F7F7F7">
<h1>Computers</h1>
<xsl:for-each select="/customers/customer/locations/location/items/item[@type='laptopComputer']">
<xsl:sort select="@isActive='false'"/>
<hr />
<div>
<h3>
<xsl:value-of select="manufacturer"/>
</h3>
Model: 
<xsl:value-of select="model"/>
 
Serial number: 
<xsl:value-of select="serialNumber"/>
 
Date of purchase: 
<xsl:value-of select="dateOfPurchase"/>
 
Operating system: 
<xsl:value-of select="operatingSystem"/>
 
Is on active list: 
<xsl:value-of select="@isActive"/>
 
</div>

<div style="background-color:#E3FAEE" >

<xsl:for-each select="tickets/ticket">
<xsl:choose>
<xsl:when test="@isHandled='true'">
<h3>Handled tickets</h3>
<ul>
Issued in: 
<xsl:value-of select="@issuedIn"/>
 
Ticket ID: 
<xsl:value-of select="@id" />
 
Description: 
<xsl:value-of select="description"/>
 
Solution: 
<xsl:value-of select="solution"/>
 
</ul>
</xsl:when>
<xsl:when test="@isHandled='false'">
<div style="background-color:#FDE5E5">
<h3>Unhandled tickets</h3>
<ul>
Issued in: 
<xsl:value-of select="@issuedIn"/>
 
Ticket ID: 
<xsl:value-of select="@id" />
 
Description: 
<xsl:value-of select="description"/>
 
Solution: 
<xsl:value-of select="solution"/>
 
</ul>
</div>
</xsl:when>
</xsl:choose>
</xsl:for-each>

</div>
</xsl:for-each>
</body>
</html>
</xsl:template>
</xsl:stylesheet>
</pre>

== IT Management XSD ==

<pre>
<?xml version="1.0" encoding="utf-8"?>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="customers">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="customer">
<xs:complexType>
<xs:sequence>
<xs:element name="customerName" type="xs:string" />
<xs:element minOccurs="0" name="contactPerson" type="xs:string" />
<xs:element name="e-mail" type="xs:string" />
<xs:element name="phoneNumber" type="xs:string" />
<xs:element name="locations">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="location">
<xs:complexType>
<xs:sequence>
<xs:element name="city" type="xs:string" />
<xs:element name="address" type="xs:string" />
<xs:element name="comment" type="xs:string" />
<xs:element minOccurs="0" name="localContactPerson" type="xs:string" />
<xs:element minOccurs="0" name="localPhone" type="xs:string" />
<xs:element name="items">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="item">
<xs:complexType>
<xs:sequence>
<xs:element name="manufacturer" type="xs:string" />
<xs:element name="model" type="xs:string" />
<xs:element name="serialNumber" type="xs:string" />
<xs:element name="dateOfPurchase" type="xs:date" />
<xs:element minOccurs="0" name="operatingSystem">
<xs:complexType>
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute name="version" type="xs:string" use="required" />
</xs:extension>
</xs:simpleContent>
</xs:complexType>
</xs:element>
<xs:element minOccurs="0" name="tickets">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="ticket">
<xs:complexType>
<xs:sequence>
<xs:element name="description" type="xs:string" />
<xs:element name="solution" type="xs:string" />
</xs:sequence>
<xs:attribute name="id" type="xs:string" use="required" />
<xs:attribute name="issuedIn" type="xs:date" use="required" />
<xs:attribute name="isHandled" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:unsignedInt" use="required" />
<xs:attribute name="type" type="xs:string" use="required" />
<xs:attribute name="isActive" type="xs:boolean" use="required" />
<xs:attribute name="isUnderWarranty" type="xs:boolean" use="required" />
<xs:attribute name="warrantyInMonths" type="xs:unsignedByte" use="required" />
<xs:attribute name="isInWorkingCondition" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="type" type="xs:string" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:unsignedInt" use="required" />
<xs:attribute name="type" type="xs:string" use="required" />
<xs:attribute name="isActive" type="xs:boolean" use="required" />
<xs:attribute name="hasManyLocations" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
</pre>

== IT Management XML ==

<pre>
<?xml version="1.0" encoding="utf-8" ?>
<customers>
<customer id="33" type="company" isActive="true" hasManyLocations="true">
<customerName>Elamustevaba OÜ</customerName>
<contactPerson>Juhan Pühamees</contactPerson>
<e-mail>juhan@evaba.com</e-mail>
<phoneNumber>+37256565656</phoneNumber>
<locations>
<location type="office">
<city>Tallinn</city>
<address><![CDATA[Pikk 7, 56401]]></address>
<comment><![CDATA[3. korrus -> paremat kätt]]></comment>
<localContactPerson>Maiu Piimaauto</localContactPerson>
<localPhone>+3726510510</localPhone>
<items>
<item id="1" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="36" isInWorkingCondition="false">
<manufacturer>Dell</manufacturer>
<model>Inspiron 3558</model>
<serialNumber>6FGH5JN</serialNumber>
<dateOfPurchase>2017-07-22</dateOfPurchase>
<operatingSystem version="1709">Windows 10 Home</operatingSystem>
<tickets>
<ticket id="HWI001" issuedIn="2017-11-21" isHandled="true">
<description><![CDATA[Wi-Fi is not working]]></description>
<solution><![CDATA[Wi-Fi card replaced (Under the warranty)]]></solution>
</ticket>
<ticket id="SWI256" issuedIn="2018-05-05" isHandled="false">
<description><![CDATA[Computer keeps showing login screen]]></description>
<solution></solution>
</ticket>
</tickets>
</item>
<item id="55" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="60" isInWorkingCondition="true">
<manufacturer>Dell</manufacturer>
<model>Latitude E7550</model>
<serialNumber>8JGR78U</serialNumber>
<dateOfPurchase>2016-06-15</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Home</operatingSystem>
</item>
</items>
</location>
<location type="store">
<city>Tallinn</city>
<address><![CDATA[Lai 17, 56401]]></address>
<comment><![CDATA[keldrikorrusel]]></comment>
<localContactPerson>Tanja Õielemb</localContactPerson>
<localPhone>+3726510520</localPhone>
<items>
<item id="83" type="desktopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Lenovo</manufacturer>
<model>ThinkCentre M715</model>
<serialNumber>IO25689AD54KL</serialNumber>
<dateOfPurchase>2017-12-01</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Pro</operatingSystem>
</item>
<item id="12" type="monitor" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>AOC</manufacturer>
<model>L456</model>
<serialNumber>9803987YE54</serialNumber>
<dateOfPurchase>2015-05-03</dateOfPurchase>
<tickets>
<ticket id="HWI126" issuedIn="2016-01-18" isHandled="true">
<description><![CDATA[Doesn't work, no picture.]]></description>
<solution><![CDATA[Wasn't plugged in. Technician did it - works again!]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
<customer id="02" type="private" isActive="true" hasManyLocations="false">
<customerName>Kessu Sisselasi</customerName>
<e-mail>kessu@tripp.org</e-mail>
<phoneNumber>+372555555</phoneNumber>
<locations>
<location type="home">
<city>Saue</city>
<address><![CDATA[Kooli 4-8, 78965]]></address>
<comment><![CDATA[2. korrus. Kitsad koridorid.]]></comment>
<items>
<item id="98" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Acer</manufacturer>
<model>Aspire 5</model>
<serialNumber>475YRT89K4</serialNumber>
<dateOfPurchase>2018-03-25</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Home</operatingSystem>
</item>
<item id="4" type="laptopComputer" isActive="false" isUnderWarranty="false" warrantyInMonths="36" isInWorkingCondition="true">
<manufacturer>Lenovo</manufacturer>
<model>IdeaPad L530</model>
<serialNumber>U89TRY765ME</serialNumber>
<dateOfPurchase>2007-08-14</dateOfPurchase>
<operatingSystem version="">Windows XP</operatingSystem>
<tickets>
<ticket id="SWI069" issuedIn="2010-01-28" isHandled="true">
<description><![CDATA[Blue screen.]]></description>
<solution><![CDATA[Video driver update.]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
<customer id="26" type="company" isActive="true" hasManyLocations="true">
<customerName>Aktsiaselts OÜ</customerName>
<contactPerson>Gunnar Kuningas</contactPerson>
<e-mail>gunnar@kunn.ee</e-mail>
<phoneNumber>+3726985236</phoneNumber>
<locations>
<location type="office">
<city>Loksa</city>
<address><![CDATA[Kalda 14, 78965]]></address>
<comment><![CDATA[Sissepääs Rimi poolt, helesinine uks]]></comment>
<items>
<item id="26" type="laptopComputer" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Apple</manufacturer>
<model>Macbook Air</model>
<serialNumber>258JUY369</serialNumber>
<dateOfPurchase>2017-03-01</dateOfPurchase>
<operatingSystem version="High Sierra">OS X</operatingSystem>
</item>
<item id="59" type="laptopComputer" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="false">
<manufacturer>Acer</manufacturer>
<model>Chromebook 11</model>
<serialNumber>U89TRY765ME</serialNumber>
<dateOfPurchase>2016-04-23</dateOfPurchase>
<operatingSystem version="">Chrome OS</operatingSystem>
<tickets>
<ticket id="HWI046" issuedIn="2010-02-28" isHandled="false">
<description><![CDATA[Stripes on screen]]></description>
<solution><![CDATA[]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
</customers>
</pre>

= Link klientrakendusele ja API-le =
https://drive.google.com/file/d/1FU3XGGVHbn4BNNHAsOs7DQ4CzpEDwZUt/view?usp=sharing (nagu logidest näha lisasime selle lingi 08.06.2018, kuid siin on mõned üleliigsed kataloogid) 
https://drive.google.com/file/d/1A7cxeK15xlWSww_CPxpksSfj0m10qFQV/view?usp=sharing (09.06.2019 laadisime üles paki, kus on kustutatud kaks ebavajalikku kataloogi, mis võivad tekitada segadust)

[ failid eemaldatud seoses ärilise konfidentsiaalsuse nõudega 19.06.2018 ]

== Palun loe seda "readme" asemel ==

1. meie rakenduse implementeeritud skoop lähtub siin lehel (ülal), analüüsi osas defineeritud "Minimum viable product" kriteeriumitest 
2. lase API käima, tee andmebaaside migratsioonid ja update-database 
3. implementeeritud on kõik teenused, mis on nähtaval Swaggeris aadressil: "localhost:[pordinumber]/Swagger" 
4. kliendirakendus asub kataloogis 'WatchWindersClient' ja tegemist on solutioniga, mille võiks käivitada teises Visual Studio aknas 
5. klientrakenduse käivitumiseks tuleks muuta App.config failis muuta ära localhost portide numbrid asendades need enda arvutis oleva localhost pordiga ning lisada kehtiv JWT AccessToken, mille saab Postmaniga aadressilt api/Security/getToken "Email" ja "Password" abil pärast seda kui kasutaja on loodud 
6. küsimuste ja raskuste korral kirjuta tiit.kuuskmae@gmail.com (API) ja toomas.juhkov@gmail.com (klient). Vastame esimesel võimalusel.

= Retsensioonid =
1. Veebiteenuse retsensioon grupile "Kuldne Loojang". Kättesaadav: https://drive.google.com/file/d/1OtzOCPiWixsrbHcGCcdHgXIgz3_fsC7h/view

= Kasutatud kirjandus ja allikad =

1. Albahari, Joseph, Albari, Ben 2017. C# 7.0 in A Nutshell. Sebastopol: O’Reilly 
2. MariaDB Foundation. MariaDB. Kättesaadav:https://mariadb.org/ 
3. Martin, Robert 2018. Clean Architecture. Boston: Pearson Education

WatchWinders

2018-06-19T17:52:33Z

Tkuuskma: /* Link klientrakendusele ja API-le */

= Meeskond =

Toomas Juhkov, toomas.juhkov@gmail.com 
Tiit Kuuskmäe, tiit.kuuskmae@gmail.com 
Kunnar Kukk, Kunnar.kukk@gmail.com 

= Tegevuste logi =

08.02.2018 - meeskonna loomine, kokkuleppe sõlmimine teema osas 
10.02.2018 - õppejõu teavitamine koos esmase andmemudeliga 
15.02.2018 - lõpliku andmemudeli valmimine(versioon 5) 
18.02.2018 - õppejõu kinnitus, et teema ja meeskond kvalifiseeruvad 
22.02.2018 - viki lehe loomine ja analüüsi koostamise alustamine 
26.02.2018 - tiimi lisandus Kunnar Kukk 
01.03.2018 - tiimi sprint koosolek(seoses täiendava tiimiliikme lisandumisega täpsustasime skoopi) 
03.03.2018 - alustasime koodi kirjutamisega (tabelid klassideks ja annotatsioonid peale) 
06.03.2018 - täiendasime andmemudelit olemiga "UserTypeState" (et saaks muuta kasutajatüüpi) 
08.03.2018 - tiimi sprint koosolek 
18.03.2018 - lisasime olemid "Address", "AddressU", "AddressM", "OfferOfUser", "MediaInOffer" 
22.03.2018 - tiimi sprint koosolek, mis oli pühendatud andmemudeli täiendamisele 
23.03.2018 - pikem tiimi hackathon andmemudeli teemal 
29.03.2018 - täiendatud wiki lehte täielikult ringitöötatud andmemudeliga 
30.03.2018 - täiendatud wiki lehte andmemudeli metainfoga 
09.04.2018 - silusime andmemudelit (mõningad ebavajalikud viited olid sisse jäänud) 
06.05.2018 - panime uuendatud andmemudeli projekti wiki lehele üles 
07.05.2018 - osalesime õppejõu Mait Poska korraldatud hackathonil 
08.06.2018 - XML ülesanne, klientrakenduse ja API kood sai wiki lehel avalikuks 

Terve maikuu oli igapäevane suhtlus üle Skype'i ja fleep.io, mida me ei loginud (liiga tihedaks läks!).

= Kasutatavad metoodikad =

WatchWinders projektis plaanime kasutada peamiselt kaht metoodikat:

1. läbiv retsenseerimine (üks paariline teeb midagi valmis ja teine teeb sellele ülevaatuse; üksus lisatakse kui ülevaatus on lõplikult läbitud ning osapoolte vahel on saabunud konsensus) 
2. paaris programmeerimine (istume ühe masina taha maha ja kirjutame kolmekesi)

Tulenevalt kaugõppe formaadist saab ülekaalus olema esimene variant. Teist metoodikat kasutame nende osade kirjutamiseks, mille puhul võib arvata, et nende lahendamine on keeruline või et lahenduskäike võib olla väga erinevaid. Püüame jooksvalt siinses vikis kajastada ka seda, millise metoodika järgi üks või teine osa valmis.

= Projekti osad =

Alljärgnevalt anname ülevaate projekti osadest: 

(1) andmemudel 
(2) veebiteenuse analüüs 
(3) Minimum Viable Product definitsioon 
(4) Inkrement #1 
(5) Inkrement #2 
(6) Inkrement #3 

Projekti osad on meie viki lehel kirjeldatud valmimise järjekorras.

== Andmemudel ==

Andmemudeli koostamisel lähtusime õppejõu ette antud kriteeriumist, mille järgi andmemudelis on vähemalt 6 põhiolemit (tähistatud tumesinise ja lillaga - meie mudelis 11 tk),
mille hulgas ei sisaldu kasutajate tabelit (Person). 
 
Põhiolemid: 
* Watch - kell 
* Person - kasutaja/kollektsionäär või firma esindaja 
* Box - kellakarp 
* Organization - tootjad, edasimüüjad, hooldus 
* Settings - kellakarbi seade 
* Offer - pakkumine kollektsionäärile 
* Media - meediafailid kellade ja karpide kohta 
* Address - kasutaja/organisatsiooni aadress 
* ElectronicContact - elektrooniliste kontaktide loend 
* Log - logi 
* Access - paroolid ja kasutajanimed 
* Error - vead 
 
Type abiolemid: 
* WatchType - kellatüübid 
* PersonType - isikutüübid: admin, kasutaja 
* OrganizationType - organisatsioonitüübid: tootja, hooldaja, edasimüüja jt 
* ActionType - logi tüübid 
* ContactType - elektroonilise kontakti tüüp: skype, email, telefon jt 
 
Olekud: 
* PersonTypeState - isiku rolli kehtivus ajahetkel (isiku ja tüübi vaheline seos) 
* OrganizationTypeState - organisatsiooni olek(ud) ajahetkel 
 
Kuuluvus: 
* PersonWatch - isikute ja kellade vahelised seosed 
* PersonBox - isiku ja karbi vaheline seos 
* PersonAccess - isiku ja autentimisandmete vaheline seos 
* WatchInBox - kella ja karbi vaheline seos 
* ErrorInWatch - vea ja kella vaheline seos 
* SettingsInBox - seade ja karbi vaheline seos 
* WatchInOrganization - kella ja tootja vaheline seos 
* PersonInOrganization - isiku ja ettevõtte/organisatsiooni vaheline seos 
* SettingsOfWatchType - seade ja kellatüübi vaheline seos 
 
Abstraktsioonid: 
* Locator - abstraktsioon erinevate kontaktitüüpide jaoks 
* Party - abstraktsioon erinevate inimeste, organisatsioonide jt jaoks 
 
Kommunikatsioon: 
* OfferToPerson - isikule suunatud pakkumised 
* OfferFromPerson - isikult lähtuv pakkumine 
 
 
 
[[File:ww_andmemudel_06052018.png]]
 

Andmemudel valmis (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

== Veebiteenuse analüüs ==

Alljärgnevalt esitame kellakarpide infosüsteemi analüüsi järgmistes osades:

(1) toote/teenuse kirjeldus 
(2) probleemi kirjeldus 
(3) lahendus 
(4) süsteemi kasutajad 
(5) loodava API võimalused 
(6) funktsionaalsed nõuded 
(7) mittefunktsionaalsed nõuded 

=== Toote/teenuse kirjeldus ===
Teenuse eesmärgiks on lahendada probleem, kuidas jälgida kellakarpide kaudu mehhaaniliste käekellade seisundit ning keerata neid automaatselt üles distantsilt, näiteks juhul, kui kellade kollektsionäär ei asu füüsiliselt igapäevaselt oma kellade juures. Teenus võimaldab ka tootjal uuendada kontaktandmeid, saata personaalseid teateid. Administraatorile annab ülevaate platvormis toimuvast.

=== Probleemi kirjeldus ===
Mehhaaniliste käekellade kollektsionääride huvi kellakarpide vastu on mitmetahuline. Kollektsionääre huvitab arvepidamine – mitu kella, missuguste omaduste ja eripäradega neil kollektsioonis on. Teisalt soov eksponeerida oma kogusid kolleegidele ja sõpradele. Kellakarpidega täidetud sein või riiulid loovad selleks suurepärase võimaluse. Kolmandaks praktiline vajadus tagada kellavedrude õige vinnastatuse aste. Kaasaja mehhaanilised kellamehhanismid (''automatic'') võimaldavad kellakorpuse füüsilisel liigutamisel kellavedru automaatselt vinnastada.

Näiteks piisab kella kinnitamisest käele, et see hakkaks end käe liigutamisel üles keerama. Kuidas keerata aga üles seisvat kella, mis seisab paigal kellakarbis? Selleks on tänapäeva kellakarpides elektrimootor, mis tagab kella liigutamise vastavalt kellatüübile ettenähtud ööpäevase graafiku alusel. Kollektsionääride üheks probleemiks on see, kuidas juhtida sellist karpi ja omada jooksvat ülevaadet kõikidest oma karpidest, nende tehnilisest seadistusest ja kollektsiooni kuuluvatest kelladest olles tööreisil välisriigis?

=== Lahendus ===
Probleemi lahendamiseks ehitame REST + ASP.NET Core + WebAPI koos kliendiga, mis võimaldab kellakollektsionääridel hallata kellasid karpides, administraatoritel saada ülevaate süsteemist ning tootjatele lisada infot kollektsionääridele. Käesoleva projekti käigus '''ei tegeleta''' kahe IoT lahenduse kui terviku seisukohast olulise nüansiga: (i) karbi püsivara (''firmware'') loomisega, (ii) klientrakenduse ''frontend'' lõpliku häälestamisega (ilus .css ja pildid).

=== Süsteemi kasutajad ===
'''Kollektsionäär''' - haldab ja muudab infot oma kellade ning oma kellakarpide kohta. 
'''Administraator''' - haldab süsteemi infot, vajadusel eemaldab probleeme. 
'''Tootja''' - saab saata süsteemi kollektsionääridele mõeldud infot. 
'''Hooldaja''' - saab infot hooldamist vajavate kellade ja -karpide kohta. 

=== Loodava API võimalused ===
Alljärgnevalt vaatame loodava API võimalusi kasutajagruppide kaupa:

'''Kasutajale/kellakollektsionäärile'''
* Saada ülevaade kelladest ja kellakarpidest (lisada, muuta, vaadata).
* Muuta karbis oleva kella kohta käivat informatsiooni (kella nimi, tootja, tootmise aeg, viitenumber, mehhanism, jõureservi jääk (valikuline), foto kellast, kellarihma liik, muu).
* Karpe juhtida (keerata automaatselt üles). Näha ja muuta kella üleskeerava mehhanismi liikumise kiirust ja muid detaile (nt liikumise suund).
* Näha karbi seisundit, kas karp on hetkel wifiga ühendatud või mitte.
* Näha karbilt saabunud veateateid.
* Sisestada infot kella seisundist.
* Suhelda hooldajate ja tootjatega

'''Tootjale'''
* Uuendada kontaktandmeid.
* Saata personaalseid teateid kellakollektsionääridele.

'''Administraatorile'''
* Näha võrku ühendatud karpide arvu.
* Näha karpidesse paigaldatud kellade nimistut (ilma muude kasutajaandmeteta).
* Näha kellade üleskeeramise mehhanismide arvnäitajaid (madalaim kiirus, keskmine kiirus, tippkiirus; samuti liikumise suundade arvnäitajaid).
* IP-aadresside järgi ülevaadet, millistes riikides karpe kasutatakse (üldised arvandmed).
* Veateatega karpide arv süsteemis (üldised arvandmed).

=== Funktsionaalsed nõuded ===
* Kõik tegevused peavad olema autoriseeritud.
* REST + ASP.NET Core + WebAPI tagastab infot valideeritud JSON formaadis.
* API veatöötlus on tehtud, kasutades standardseid veakoode.
* API-le on tehtud 'health check'.
* Kõik kasutajad peavad saama end autoriseerida.
* Kasutaja, tootja ja administraatori tegevused logitakse.
* Logi ei ole muudetav, vaid on kättesaadav.
* Kasutaja ega tootja ei näe teiste kasutajate ega tootjate infot.
* API klient on kohanduv mobiilile, tahvlile ja desktoparvutile.
* Sisendandmed on valideeritud.

=== Mittefunktsionaalsed nõuded ===
* API-le on lisatud Swagger fail.
* Teenus ja tehniline lahendus on dokumenteeritud.
* Süsteemi kood on vabalt ligipääsetav, täiendatav ning allalaetav.

Esitame töö etappidena, kus kõigepealt defineerime ära Minimum Viable Producti [https://en.wikipedia.org/wiki/Minimum_viable_product] ehk selle miinimumi, mis pakub kasutajale maksimaalset väärtust. See tähendab API loomist ning esmase kliendi loomist kõigile MVP-s defineeritud kasutajagruppidele. Seejärel realiseerime projekti inkrementide ehk tootearenduse sammudena, milles lisame uusi funktsionaalsusi. Ideaalis jõuame realiseerida kõik sammud, kuid kuna teeme nimetatud tööd antud ajaraamis ja koosseisus esmakordselt, siis võtame vabaduse ka realiseerida korralikult niipalju, kui jõuame projekti käigus ära teha.

Võimalik, et meie lõpptulemus erineb mõnes osas esitatud analüüsist. Seda olenevalt sellest kui edukalt meil õnnestub plaanitud funktsionaalsusi realiseerida. Erisusi plaanime käsitleda vastavas 'post production' jaotuses, kus loendame ka projektist kogunenud peamised õppetunnid.

Analüüs valmis (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

== Minimum Viable Product definitsioon ==
'''Kasutaja'''
* Kasutaja saab süsteemi logida ning välja logida
* Kasutaja saab lisada uue kellakarbi
* Kasutaja saab lisada uue kella kellakarpi
* Kasutaja saab muuta kella infot kellakarbis
* Kasutaja saab näha ülevaadet oma karpidest
* Kasutaja saab muuta kellakarbi seadeid
* Kasutaja saab kustutada kella karbis
* Kasutaja saab kustutada kellakarbi

'''Administraator'''
* Näeb autoriseeritult logisid

'''Tootja'''
* Saab lisada kontaktandmeid
* Saab kontaktandmeid muuta

== Inkrement #1 ==
'''Kasutaja'''
* Näeb karbilt saabunud veateateid.
* Saab kellakarpe juhtida.

'''Administraator'''
* IP-aadresside järgi ülevaadet, millistes riikides karpe kasutatakse (üldised arvandmed).
* Karpidesse paigaldatud kellade nimistut (ilma muude kasutajaandmeteta).
* Näeb kasutajate statistikat.

'''Tootja'''
* Saata personaalseid teateid kellakollektsionääridele.

== Inkrement #2 ==
'''Kasutaja'''
* Saab saata teate tootjale.
* Näeb tootja vastust.
* Näha karbi seisundit, kas karp on hetkel wifiga ühendatud või mitte.

'''Administraator'''
* Näha kellade üleskeeramise mehhanismide arvnäitajaid (madalaim kiirus, keskmine kiirus, tippkiirus; samuti liikumise suundade arvnäitajaid).
* Näeb tegevuste ajalugu kliendist.

'''Tootja'''
* Saab lugeda kasutaja teadet.
* Saab vastata kasutajale.

'''Hooldaja'''
* Saab info hooldamist vajavate kellade kohta.

== Inkrement #3 ==
'''Kasutaja'''
* On ehitatud keeletugi.

'''Tootja'''
* On ehitatud keeletugi.

'''Hooldaja'''
* On ehitatud keeletugi.

Inkrementid valmisid (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

= XML ülesanne =
Järgnevalt esitame oma XML-ülesande tulemused.

== IT Management Transformation XML To XML ==
<pre>
<?xml version="1.0" encoding="utf-8"?>
<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">
<xsl:output method="xml" indent="yes"/>
<xsl:template match="/">
<unhandledDevices>
<xsl:for-each select="customers/customer/locations/location/items/item[@isInWorkingCondition='false']">
<device>
<name>
<xsl:value-of select="manufacturer"/>
<xsl:text> </xsl:text>
<xsl:value-of select="model"/>
</name>
<ticket>
<xsl:for-each select="tickets/ticket[@isHandled='false']">
<ticket_id>
<xsl:value-of select="@id"/>
</ticket_id>
<issued_in>
<xsl:value-of select="@issuedIn"/>
</issued_in>
<description>
<xsl:value-of select="description"/>
</description>
</xsl:for-each>
</ticket>
</device>
</xsl:for-each>
</unhandledDevices>
</xsl:template>
</xsl:stylesheet>
</pre>

== IT Management Transformation HTML ==

<pre>
<?xml version="1.0" encoding="utf-8"?>
<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">
<xsl:output method="html" indent="yes"/>
<xsl:template match="/">

<html>
<head>
<title>ItManagement Laptops</title>
</head>
<body style="background-color:#F7F7F7">
<h1>Computers</h1>
<xsl:for-each select="/customers/customer/locations/location/items/item[@type='laptopComputer']">
<xsl:sort select="@isActive='false'"/>
<hr />
<div>
<h3>
<xsl:value-of select="manufacturer"/>
</h3>
Model: 
<xsl:value-of select="model"/>
 
Serial number: 
<xsl:value-of select="serialNumber"/>
 
Date of purchase: 
<xsl:value-of select="dateOfPurchase"/>
 
Operating system: 
<xsl:value-of select="operatingSystem"/>
 
Is on active list: 
<xsl:value-of select="@isActive"/>
 
</div>

<div style="background-color:#E3FAEE" >

<xsl:for-each select="tickets/ticket">
<xsl:choose>
<xsl:when test="@isHandled='true'">
<h3>Handled tickets</h3>
<ul>
Issued in: 
<xsl:value-of select="@issuedIn"/>
 
Ticket ID: 
<xsl:value-of select="@id" />
 
Description: 
<xsl:value-of select="description"/>
 
Solution: 
<xsl:value-of select="solution"/>
 
</ul>
</xsl:when>
<xsl:when test="@isHandled='false'">
<div style="background-color:#FDE5E5">
<h3>Unhandled tickets</h3>
<ul>
Issued in: 
<xsl:value-of select="@issuedIn"/>
 
Ticket ID: 
<xsl:value-of select="@id" />
 
Description: 
<xsl:value-of select="description"/>
 
Solution: 
<xsl:value-of select="solution"/>
 
</ul>
</div>
</xsl:when>
</xsl:choose>
</xsl:for-each>

</div>
</xsl:for-each>
</body>
</html>
</xsl:template>
</xsl:stylesheet>
</pre>

== IT Management XSD ==

<pre>
<?xml version="1.0" encoding="utf-8"?>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="customers">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="customer">
<xs:complexType>
<xs:sequence>
<xs:element name="customerName" type="xs:string" />
<xs:element minOccurs="0" name="contactPerson" type="xs:string" />
<xs:element name="e-mail" type="xs:string" />
<xs:element name="phoneNumber" type="xs:string" />
<xs:element name="locations">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="location">
<xs:complexType>
<xs:sequence>
<xs:element name="city" type="xs:string" />
<xs:element name="address" type="xs:string" />
<xs:element name="comment" type="xs:string" />
<xs:element minOccurs="0" name="localContactPerson" type="xs:string" />
<xs:element minOccurs="0" name="localPhone" type="xs:string" />
<xs:element name="items">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="item">
<xs:complexType>
<xs:sequence>
<xs:element name="manufacturer" type="xs:string" />
<xs:element name="model" type="xs:string" />
<xs:element name="serialNumber" type="xs:string" />
<xs:element name="dateOfPurchase" type="xs:date" />
<xs:element minOccurs="0" name="operatingSystem">
<xs:complexType>
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute name="version" type="xs:string" use="required" />
</xs:extension>
</xs:simpleContent>
</xs:complexType>
</xs:element>
<xs:element minOccurs="0" name="tickets">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="ticket">
<xs:complexType>
<xs:sequence>
<xs:element name="description" type="xs:string" />
<xs:element name="solution" type="xs:string" />
</xs:sequence>
<xs:attribute name="id" type="xs:string" use="required" />
<xs:attribute name="issuedIn" type="xs:date" use="required" />
<xs:attribute name="isHandled" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:unsignedInt" use="required" />
<xs:attribute name="type" type="xs:string" use="required" />
<xs:attribute name="isActive" type="xs:boolean" use="required" />
<xs:attribute name="isUnderWarranty" type="xs:boolean" use="required" />
<xs:attribute name="warrantyInMonths" type="xs:unsignedByte" use="required" />
<xs:attribute name="isInWorkingCondition" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="type" type="xs:string" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:unsignedInt" use="required" />
<xs:attribute name="type" type="xs:string" use="required" />
<xs:attribute name="isActive" type="xs:boolean" use="required" />
<xs:attribute name="hasManyLocations" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
</pre>

== IT Management XML ==

<pre>
<?xml version="1.0" encoding="utf-8" ?>
<customers>
<customer id="33" type="company" isActive="true" hasManyLocations="true">
<customerName>Elamustevaba OÜ</customerName>
<contactPerson>Juhan Pühamees</contactPerson>
<e-mail>juhan@evaba.com</e-mail>
<phoneNumber>+37256565656</phoneNumber>
<locations>
<location type="office">
<city>Tallinn</city>
<address><![CDATA[Pikk 7, 56401]]></address>
<comment><![CDATA[3. korrus -> paremat kätt]]></comment>
<localContactPerson>Maiu Piimaauto</localContactPerson>
<localPhone>+3726510510</localPhone>
<items>
<item id="1" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="36" isInWorkingCondition="false">
<manufacturer>Dell</manufacturer>
<model>Inspiron 3558</model>
<serialNumber>6FGH5JN</serialNumber>
<dateOfPurchase>2017-07-22</dateOfPurchase>
<operatingSystem version="1709">Windows 10 Home</operatingSystem>
<tickets>
<ticket id="HWI001" issuedIn="2017-11-21" isHandled="true">
<description><![CDATA[Wi-Fi is not working]]></description>
<solution><![CDATA[Wi-Fi card replaced (Under the warranty)]]></solution>
</ticket>
<ticket id="SWI256" issuedIn="2018-05-05" isHandled="false">
<description><![CDATA[Computer keeps showing login screen]]></description>
<solution></solution>
</ticket>
</tickets>
</item>
<item id="55" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="60" isInWorkingCondition="true">
<manufacturer>Dell</manufacturer>
<model>Latitude E7550</model>
<serialNumber>8JGR78U</serialNumber>
<dateOfPurchase>2016-06-15</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Home</operatingSystem>
</item>
</items>
</location>
<location type="store">
<city>Tallinn</city>
<address><![CDATA[Lai 17, 56401]]></address>
<comment><![CDATA[keldrikorrusel]]></comment>
<localContactPerson>Tanja Õielemb</localContactPerson>
<localPhone>+3726510520</localPhone>
<items>
<item id="83" type="desktopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Lenovo</manufacturer>
<model>ThinkCentre M715</model>
<serialNumber>IO25689AD54KL</serialNumber>
<dateOfPurchase>2017-12-01</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Pro</operatingSystem>
</item>
<item id="12" type="monitor" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>AOC</manufacturer>
<model>L456</model>
<serialNumber>9803987YE54</serialNumber>
<dateOfPurchase>2015-05-03</dateOfPurchase>
<tickets>
<ticket id="HWI126" issuedIn="2016-01-18" isHandled="true">
<description><![CDATA[Doesn't work, no picture.]]></description>
<solution><![CDATA[Wasn't plugged in. Technician did it - works again!]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
<customer id="02" type="private" isActive="true" hasManyLocations="false">
<customerName>Kessu Sisselasi</customerName>
<e-mail>kessu@tripp.org</e-mail>
<phoneNumber>+372555555</phoneNumber>
<locations>
<location type="home">
<city>Saue</city>
<address><![CDATA[Kooli 4-8, 78965]]></address>
<comment><![CDATA[2. korrus. Kitsad koridorid.]]></comment>
<items>
<item id="98" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Acer</manufacturer>
<model>Aspire 5</model>
<serialNumber>475YRT89K4</serialNumber>
<dateOfPurchase>2018-03-25</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Home</operatingSystem>
</item>
<item id="4" type="laptopComputer" isActive="false" isUnderWarranty="false" warrantyInMonths="36" isInWorkingCondition="true">
<manufacturer>Lenovo</manufacturer>
<model>IdeaPad L530</model>
<serialNumber>U89TRY765ME</serialNumber>
<dateOfPurchase>2007-08-14</dateOfPurchase>
<operatingSystem version="">Windows XP</operatingSystem>
<tickets>
<ticket id="SWI069" issuedIn="2010-01-28" isHandled="true">
<description><![CDATA[Blue screen.]]></description>
<solution><![CDATA[Video driver update.]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
<customer id="26" type="company" isActive="true" hasManyLocations="true">
<customerName>Aktsiaselts OÜ</customerName>
<contactPerson>Gunnar Kuningas</contactPerson>
<e-mail>gunnar@kunn.ee</e-mail>
<phoneNumber>+3726985236</phoneNumber>
<locations>
<location type="office">
<city>Loksa</city>
<address><![CDATA[Kalda 14, 78965]]></address>
<comment><![CDATA[Sissepääs Rimi poolt, helesinine uks]]></comment>
<items>
<item id="26" type="laptopComputer" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Apple</manufacturer>
<model>Macbook Air</model>
<serialNumber>258JUY369</serialNumber>
<dateOfPurchase>2017-03-01</dateOfPurchase>
<operatingSystem version="High Sierra">OS X</operatingSystem>
</item>
<item id="59" type="laptopComputer" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="false">
<manufacturer>Acer</manufacturer>
<model>Chromebook 11</model>
<serialNumber>U89TRY765ME</serialNumber>
<dateOfPurchase>2016-04-23</dateOfPurchase>
<operatingSystem version="">Chrome OS</operatingSystem>
<tickets>
<ticket id="HWI046" issuedIn="2010-02-28" isHandled="false">
<description><![CDATA[Stripes on screen]]></description>
<solution><![CDATA[]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
</customers>
</pre>

= Link klientrakendusele ja API-le =
https://drive.google.com/file/d/1FU3XGGVHbn4BNNHAsOs7DQ4CzpEDwZUt/view?usp=sharing (nagu logidest näha lisasime selle lingi 08.06.2018, kuid siin on mõned üleliigsed kataloogid) 
https://drive.google.com/file/d/1A7cxeK15xlWSww_CPxpksSfj0m10qFQV/view?usp=sharing (09.06.2019 laadisime üles paki, kus on kustutatud kaks ebavajalikku kataloogi, mis võivad tekitada segadust)

[ failid eemaldatud seoses ärilise konfidentsiaalsuse nõudega 19.06.2018 ]

== Palun loe seda "readme" asemel ==

1. meie rakenduse implementeeritud skoop lähtub siin lehel (ülal), analüüsi osas defineeritud "Minimum viable product" kriteeriumitest 
2. lase API käima, tee andmebaaside migratsioonid ja update-database 
3. implementeeritud on kõik teenused, mis on nähtaval Swaggeris aadressil: "localhost:[pordinumber]/Swagger" 
4. kliendirakendus asub kataloogis 'WatchWindersClient' ja tegemist on solutioniga, mille võiks käivitada teises Visual Studio aknas 
5. klientrakenduse käivitumiseks tuleks muuta App.config failis muuta ära localhost portide numbrid asendades need enda arvutis oleva localhost pordiga ning lisada kehtiv JWT AccessToken, mille saab Postmaniga aadressilt api/Security/getToken "Email" ja "Password" abil pärast seda kui kasutaja on loodud 
6. küsimuste ja raskuste korral kirjuta tiit.kuuskmae@gmail.com (API) ja toomas.juhkov@gmail.com (klient). Vastame esimesel võimalusel.

= Retsensioonid =
1. Veebiteenuse retsensioon grupile "Kuldne Loojang". Kättesaadav: https://drive.google.com/file/d/1OtzOCPiWixsrbHcGCcdHgXIgz3_fsC7h/view

= Kasutatud kirjandus ja allikad =

1. Albahari, Joseph, Albari, Ben 2017. C# 7.0 in A Nutshell. Sebastopol: O’Reilly 
2. MariaDB Foundation. MariaDB. Kättesaadav:https://mariadb.org/ 
3. Martin, Robert 2018. Clean Architecture. Boston: Pearson Education

Kodutöö aines "Võrgurakendused II: hajussüsteemide ehitamine" 2018

2018-06-11T15:18:21Z

Tkuuskma: /* Meeskond: WatchWinders */

[[Category: Võrgurakendused II: hajussüsteemide ehitamine]]
__NOINDEX__

=Kodutöö aines "Võrgurakendused II: hajussüsteemide ehitamine" 2018=
==Eesmärk==
Saada praktiline kogemus hajussüsteemide ehitamisest XML(SOAP) või Rest veebiteenusel ja sellele klientrakenduse loomise abil ning süvendada meeskonnatööoskust.
*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.
*REST teenuste loomisel tuleks kasutada ASP.NET Web API2/ASP.NET Core 2.0/WCF võimalusi.

Kaugem eesmärk on loomulikult hinne :).

==Reeglid==
''' Kodutöö koosneb kolmest eraldiseisvast ülesandest:'''
* 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)
* Luua veebiteenus, mis võimaldaks pakkuda teenust, eristada kasutajaid ning näidata teenuse kasutamise statistikat kasutajate ja tegevuste lõikes
* Luua klientrakendus

Ü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.

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.

==Tähtajad==

* '''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]
** 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>'''
** Veebiteenus peab olema valmis, esitatud ja ja wikilehel kirjeldatud hiljemalt '''27. mai 2018'''.
** Retsensioonid veebiteenuste kohta peavad tehtud olema '''03. juuni 2018'''.

* '''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]
** Klientrakendused peavad olema valmis, esitatud ja ja wikilehel kirjeldatud hiljemalt '''27. mai 2018'''.
** Retsensioonid klientrakenduste kohta peavad tehtud olema '''03. juuni 2018'''.

* '''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]
** XML fail, stiilifail ja skeemifail peavad olema valmis ja wikilehel kirjeldatud hiljemalt '''01. juuni 2018'''.
** Retsensioonid XML-failide kohta peavad tehtud olema '''05.juuni 2018'''.

==Hindamine==
===Üldised kriteeriumid===

Teostatuks loetakse projekt juhul, kui lähteülesanne on realiseeritud, lahendus on töötav, kuid esineb suuremaid vigu ning piirsituatsioonidega ei ole arvestatud.

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.

'''Maksimumtulemuse annab (vähemalt 4/7):'''

* Majanduslik mõtlemine (kas loodav teenus ja rakendused oleks kasutatav ka ärilistel eesmärkidel)
* Mobiilirakendused/Angularis/reactis loodud klientrakendus
* Kogukondade kaasamine
* Kasutajamugavus
* Läbimõeldud töökorraldus
* Lisavõimaluste realiseerimine (vt näidisteemad)
* Korraliku arhitektuuriga kirjutatud kood

===XML andmefail===
Ü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.

XML-il peab olema vähemalt 4 loogilist dimensiooni.
<dim1>
<dim2>
<dim3>
<dim4>
</dim4>
</dim3>
</dim2>
</dim1>
Lisaks tuleb kasutada 3-el dimensioonil attribuute, mis one enamat, kui lihtsalt ID.

===Veebiteenus===
Loodav veebiteenus peab võimaldama:
* Teenuse pakkumist
* '''Teenuse kasutajate tuvastamist ning haldamist'''
* Teenuse kasutajate ja kasutusstatistika üle arve pidamist kasutajate lõikes
* Teenuse poole pöördumiste arvu piiramist ja piirangute haldamist.

Loodav veebiteenus peab toetama mitme kasutaja võimalust.

Loodav veebiteenus tuleb luua kasutades ''Windows Communication Foundation'' või ASP.NET MVC Web API tehnoloogiat

Andmebaasis peab olema vähemalt 9 olemit ehk andmebaas on eeldus,

Soovitav on luua teenus (FE) ja teenuse seadistamiseks ning kasutajate haldamiseks mõeldud rakendus (BE).

===Klientrakendus===
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)

Variant1: teha klientrakendus enda loodud veebiteenusele

Variant2: teha klientrakendus mõnele levinud veebiteenusele.
Näiteks:
* http://www.bing.com/developer
* http://www.flickr.com/services/api/response.soap.html
* http://developer.ebay.com/developercenter/windows/
* http://apiwiki.twitter.com/Getting-Started

===Retsensioonid===
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.

Retsensioon peab sisaldama minimaalselt...
* XML - ...200 sõna.
* Veebiteenus - ...600 sõna.
* Klientrakendus - ...600 sõna.

Mõnelauselisest arvamusest ei piisa, kuna tegemist on grupi loodavate arvustustega, mitte individuaalsete arvustustega.

==Konsultatsioonid==
Igal projektimeeskonnal on piiramatu õigus saada õppejõu käest konsultatsiooni ja juhendamist oma
töö tegemiseks, kas harjutuste ajal või pärast harjutusi ja loenguid. Eriaegade suhtes saab sõlmida
õppejõuga kokkuleppeid kontaktidel
mait.poska [ät] itcollege.ee või (+372 53 469 734)
(teksti originaalautor Priit Raspel)

==Kaitsmisele registreerumine==
Kaitsmisele tuleks registreerida järjest(st iga järgmine lisab vajaliku 15min ajaakna) ja suvalisis kellaaegasid ei hakka kuhugi vahele kirjutama

'''05.06.2018'''
*15:00 - Miisiks
*15:15 - Maagikud
*15:30 - GoFood
*15:45 - Raavo V2™
*16:00 - LearnToDrive
Sellele päevale rohkem aegu juurde lisada ei saa

Allpool olevate päevadele võib vabalt aegasid juurde lisada 15min sammga. Reegel on, et aegu lisame järjest

'''06.06.2018'''
*17:00 - Raamaturiiul
*17:15 - Pakiraam
*..

'''09.06.2018'''
*16:00 - MealPlannerSolo(Triin Oja)
*16:15 - Beer Pressure
*16:30 - <div>
*16:45 - NutriCheck
*17:00 - JääTuli
*17:15 - Ophelia
*17:30 - Kuldne Loojang
*17:45 - Hammas
*18:00 - VariousArtists
*18:15 - Pillar Of Autumn
*18:30 - Curry
*18:45 - WatchWinders
*19:00 - MOT
*19:15 - AmateurBB
*19:30 - Autolugu
*19:45 - VRII2018

=Teemad 2018 kevad=
''' Kodutöö koosneb kolmest eraldiseisvast ülesandest:'''
* 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)
* Luua veebiteenus, mis võimaldaks pakkuda teenust, eristada kasutajaid ning näidata teenuse kasutamise statistikat kasutajate ja tegevuste lõikes
* Luua klientrakendus mõnele olemasolevale või endaloodud veebiteenusele

NB! XML andmefail ja veebiteenus ei pea olema omavahel seotud.

==Näidisteemad==

====Ülesanne====
Luua sobiva alguse järgi nimede pakkumise teenus:
* alates kahetähelisetest algustest pakkuda sobivad nimesid
* luua võimalus kasutajatel nimesid lisada
* luua võimalus administraatoril nimesid muuta/kustutada
* meeste ja naiste nimed peavad olema süsteemis eristatavad
* luua võimalus, mis võimaldab kuvada populaarseid nimesid
* luua võimalus ühele kasutajale (või erinevatele kasutajagruppidele) maksimumpäringute hulga määramiseks
* luua võimalus, et nimi lisatakse baasi alles siis, kui administraatori õigustega inimene on selleks vastava loa andnud

===Külastusstatistika teenus===
Mõte selles, et pakkuda teenust, kus kasutajal on võimalik registreerida külastused ning küsida oma külastusstatistikat.

====Ülesanne====
Luua külastusstatistika teenus:
* kasutaja saab teenuses registreerida külastusi
* kasutaja saab küsida külastusstatistikat päevade/kuude/kogu perioodi lõikes
* luua võimalus ühele kasutajale (või erinevatele kasutajagruppidele) maksimumpäringute hulga määramiseks

Lisavõimalused:
* luua võimalus registreerida alamlehtede külastusstatistikat
* luua võimalus külastusstatistikale lisaparameetrite lisamiseks (ip aadress, sirviku versioon jne)

===Telefoniraamatu teenus===
Mõte selles, et kasutaja saab teenuse abil salvestada kontakte ja nende seast otsida

====Ülesanne====
Luua telefoniraamatu teenus:
* kasutaja saab teenuses kontakte lisada ja kustutada
* kasutaja saab kontaktide nime/telefoninumbri jne abil otsida
* luua võimalus ühele kasutajale (või erinevatele kasutajagruppidele) maksimumpäringute hulga määramiseks
* kasutajaid on võimalik lisada gruppidesse
* kasutajal on võimalik lisada vajalike kontaktandmete liike
* kasutajatel on võimalik jagada omavahel kontakte ja kontaktide grupper

===RSS voogude kogumise ja uudiste kuvamise teenus===
Mõte selles, et kasutaja saab teenuse abil salvestada talle huvipakkuvaid RSS vooge ja nendelt voogudelt uudiseid lugeda

====Ülesanne====
Luua RSS voogude haldusteenus:
* kasutaja saab teenuses RSS vooge lisada ja kustudada
* kasutaja saab pärida talle huvipakkuvate voogude viimaseid uudiseid
* luua võimalus ühele kasutajale (või erinevatele kasutajagruppidele) maksimumpäringute hulga määramiseks
* kasutaja saab RSS vooge vaadata eraldi või grupeeritult
* vooge peab puhverdama, kuna voogude lugemine võtab enamasti üsna palju aega
*

= Meeskonnad 2018=
==Päevaõpe==

===[https://wiki.itcollege.ee/index.php/HairSaloon Meeskond: HairSaloon]===
Liikmed:
* Kaido Henrik Elias
* Arvo Paomees

===[https://wiki.itcollege.ee/index.php/VariousArtists Meeskond: VariousArtists]===
Liikmed:
* Ruudi Vinter
* Madis Roosioks
* Pavel Fleišer

Lõpptoode: [https://drive.google.com/open?id=1Pq8Lhrs3G5mGiTje70ww-zMBNB5cXnRh ZIP]

TFS: [https://variousartists.visualstudio.com/VariousArtists/_versionControl/changesets siin]

XML: [https://wiki.itcollege.ee/index.php/VariousArtists#XML siin]

Retsensioonid: [https://wiki.itcollege.ee/index.php/VariousArtists#Retsensioonid siin]

===[https://wiki.itcollege.ee/index.php/Maagikud Meeskond: Maagikud]===
Liikmed:
*Kristina Rästas
*Simo Jaanus
*Artur Tammiste
*Rauno Lõhmus
Lõpptoote [http://enos.itcollege.ee/~sjaanus/c/Airport_solution.zip link]

Veebiteenuse ja klientrakenduse retsensioon tiimile Raavo V2 asub [https://docs.google.com/document/d/1fxmdLa94Do1u5WlmPQjSd4mMmdbDw5WmDne547jqQc4/edit siin]

XML retsensioon tiimile LTD asub [https://docs.google.com/document/d/15rMhpqyG5XHsvOCZJp88ucHkiMa5Non6BbYwBBKT2_Y/edit siin]

===[https://wiki.itcollege.ee/index.php/RaamatuRiiul Meeskond: RaamatuRiiul]===
Liikmed:
* Alo Avi
* Arnika Rästa
* Marite Rammo
'''Meie XML:''' [https://wiki.itcollege.ee/index.php/RaamatuRiiul#XML XML]

'''Meie veebiteenuse, klientrakenduse ja XML retsensioonid meeskonnale Miisiiks:''' [https://wiki.itcollege.ee/index.php/Talk:Miisiiks retsensioonid]

'''Meie veebiteenus ning klientrakendus.''' [https://www.dropbox.com/s/ugbvx4j4zdlbp68/RaamatuRiiul.7z?dl=0 Zip]

===[https://wiki.itcollege.ee/index.php/Autolugu Meeskond: Autolugu]===
Liikmed:
* Margus Põlma
* Karl Erik Õunapuu

Veebiteenus: [http://enos.itcollege.ee/~mpolma/vr2/API.zip]

Klientrakendus: [https://github.com/karlerikounapuu/autolugu-front]

===[https://wiki.itcollege.ee/index.php/VRII2018 Meeskond: VRII2018]===
Liikmed:
* Kaspar Kaal
* Teet Adamson
* Rahel Kangur

===[https://wiki.itcollege.ee/index.php/Meeskond_Raavo_V2%E2%84%A2 Meeskond: Raavo V2™]===
Liikmed:
* Peeter Fridolin
* Kristo Leesmann
* Rando Rommot

Projekti retsensioon meeskonnale [https://wiki.itcollege.ee/index.php/Meeskond_Raavo_V2™#Retsentsioonid Maagikud]

===[https://wiki.itcollege.ee/index.php/Pillarofautumn Meeskond: Pillar of Autumn ]===
Liikmed:
* Taavi Põder
* Taavi Vesinurm (Meeskonnast lahkunud)
* Raido Vell
'''Lõpptoode API ja klientrakendus:''' [https://github.com/taavip9/Veebirakendused-II Lõpptoode]

===[https://wiki.itcollege.ee/index.php/jaatuli Meeskond: JääTuli]===
Liikmed:
*Tarmo Luugus
*Leho Kivistik
*Hannes Mäeorg
*Marten Tammeleht

===[https://wiki.itcollege.ee/index.php/JustABot Meeskond: JustABot]===
Liikmed:
*Argo Hansen

===[https://wiki.itcollege.ee/index.php/Meeskond_Pakiraam Meeskond: Pakiraam]===
Liikmed:
*Kristo Naeris
*Indro Kottise

Klientrakendus [https://github.com/knaeris/VR2Klient siin] ja veebiteenus [https://github.com/knaeris/VR2Projekt siin]

Retsensioon meeskonna Raavo v2 klientrakendusele : [https://wiki.itcollege.ee/index.php/Meeskond_Pakiraam#Retsensioonid Retsensioon]

Retsensioon meeskonna Raavo v2 veebiteenusele:

===[https://wiki.itcollege.ee/index.php/GoFood Meeskond: GoFood]===
Liikmed:

* Rando Kurel
* Henrik Prangel
* Markus Mänd
* Edgar Tereping
* Jane Kaldma

Lõpptoode: [https://wiki.itcollege.ee/index.php/GoFood#Projektikood lõpptoote leiab siit]

Meie rühma kirjutatud retsentsioonid rühmale Maagikud:[https://wiki.itcollege.ee/index.php/GoFood#Retsensioon_rühmale_Maagikud Retsensioon]

===[https://wiki.itcollege.ee/index.php/LTD Meeskond: LearnToDrive]===
'''Liikmed:'''
*Eve Ormisson
*Carlos Kirtsi

Projekt [https://wiki.itcollege.ee/index.php/LTD#Kood_ise asub siin, kliendina kasutame JustInCaseWPFi]

Projekti retsensioon meeskonnale [https://wiki.itcollege.ee/index.php/LTD#Projekti_retsensioon Maagikud]

XML osa retsensioon meeskonnale [https://wiki.itcollege.ee/index.php/LTD#XML_retsensioon RaamatuRiiul]

===[https://wiki.itcollege.ee/index.php/Miisiiks Meeskond: Miisiiks]===
Liikmed:
*Christo Aruste
*Heleriin Malkov
*Tõnis Prants

[https://www.dropbox.com/s/e2vu3ukgckyc2x5/MiisiiksWS.zip?dl=0 Veebiteenus]

Veebiteenus v2 (05.06): [https://www.dropbox.com/s/4acyvc9c7h08xl6/MiisiiksWS-v2.rar?dl=0 Veebiteenus]

[https://www.dropbox.com/s/iwtheohp5mn0lek/MiisiiksC.zip?dl=0 Klientrakendus]

Klientrakendus v2 (05.06): [https://www.dropbox.com/s/m6ijv2yyqthebgr/MiisiiksC2-v2.rar?dl=0 Klientrakendus]

[https://wiki.itcollege.ee/index.php/Miisiiks#XML XML]

Retsensioonid meeskonnale Raavo V2™

Veebiteenus: [https://wiki.itcollege.ee/index.php/Miisiiks#Veebiteenuse_retsensioon Retsensioon]

Klientrakendus: [https://wiki.itcollege.ee/index.php/Miisiiks#Klientrakenduse_retsensioon Retsensioon]

XML: [https://wiki.itcollege.ee/index.php/Miisiiks#XML_retsensioon XML]

===[https://wiki.itcollege.ee/index.php/VR2_div Meeskond: <div>]===
Liikmed:
*Kaarel Pärtel
*Marek Juhanson
*Kai Kallastu

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]

==Kaugõpe==

===[https://wiki.itcollege.ee/index.php/BestInShow Meeskond: BestInShow]===
Liikmed:
* Liina Abner
* Marju Pütsepp
* Liisi Taimre

'''Lõpptoode veebiteenus:''' [https://www.dropbox.com/s/j5ixmwmx45kxcyo/BestInShow.zip?dl=0 https://www.dropbox.com/s/j5ixmwmx45kxcyo/BestInShow.zip?dl=0] 
'''Kasutusjuhend:''' [https://wiki.itcollege.ee/index.php/BestInShow#Kasutusjuhend https://wiki.itcollege.ee/index.php/BestInShow#Kasutusjuhend] 
'''Lõpptoode klient:''' [https://bitbucket.org/Marjup/bestinshow/ https://bitbucket.org/Marjup/bestinshow/] 
'''XML failid:''' [https://wiki.itcollege.ee/index.php/BestInShow#XML_failid Schema, XML ja XSLT HTML ja XML transformatsiooniks] 
Retsensioon veebiteenusele: TODO retsenseerime projekti WatchWinders 
Retsensioon klientrakendusele: TODO retsenseerime projekti WatchWinders 
Retsensioon XML-ile: TODO retsenseerime projekti WatchWinders 

===[https://wiki.itcollege.ee/index.php/AssistDesq Meeskond: AssistDesq]===
Liikmed:
* Karen Grigorjan

===[https://wiki.itcollege.ee/index.php/WatchWinders Meeskond: WatchWinders]===
Liikmed:
* Toomas Juhkov
* Kunnar Kukk
* Tiit Kuuskmäe
[https://wiki.itcollege.ee/index.php/WatchWinders#Link_klientrakendusele_ja_API-le Link klientrakendusele ja API-le] 
[https://drive.google.com/file/d/1OtzOCPiWixsrbHcGCcdHgXIgz3_fsC7h/view Retsensioon grupi "Kuldne Loojang" veebiteenusele]

===[[ Kuldneloojang | Meeskond: Kuldne loojang]]===
'''Liikmed''':
* Andrus Seiman
* Marko Belzetski
* Priit Tiganik
* Kristjan Peterson (loobus)

'''Lõpptoode:'''
algselt üles laetud 02.06.2018, bugide parandusi lisatud 04.06.2018
* [https://www.dropbox.com/s/4h9bvq4k6388fmo/loojang.zip?dl=0 .zip fail rakendus ja klient koos]
* [https://bitbucket.org/itcollegeprojects/loojang-app veebirakenduse repo]
* [https://bitbucket.org/itcollegeprojects/loojang-client klientrakenduse repo]
* [https://wiki.itcollege.ee/index.php/Kuldneloojang#XML_.C3.BClesande_kirjeldus XML: link meie Wiki lehele]

'''Meie tehtud retsensioonid:'''
* [https://wiki.itcollege.ee/index.php/Kuldneloojang#Veebiteenusele veebiteenuse retsensioon meeskonna Curry tööle.]
* [https://wiki.itcollege.ee/index.php/Kuldneloojang#Klientrakendusele klientrakenduse retsensioon meeskonna Curry tööle.]
* [https://wiki.itcollege.ee/index.php/Kuldneloojang#XML-ile XML retsensioon meeskonna Curry tööle.]

===[https://wiki.itcollege.ee/index.php/Ophelia Meeskond: Ophelia]===
Liikmed:
* Siim Kallari
* Andres Kepler (loobus)
* Jorma Rebane

[https://www.dropbox.com/s/v63fkbjnd5umqqm/Ophelia.zip?dl=0 Lõpptoote link]

[https://wiki.itcollege.ee/index.php/Ophelia#L.C3.B5pptoote_kasutusjuhend Kasutusjuhend(Kaasas ka lõpptootes)]

[https://wiki.itcollege.ee/index.php/Ophelia#XML_.C3.9Clesanne XML Ülesanne]

===[https://wiki.itcollege.ee/index.php/SharpRestoVRII Meeskond: SharpRestoVRII]===
Liikmed:
* Andres Aava (lahkunud liige)
* Henri Annilo
* Jaan Koolmeister
* Lauri Üksti

Lähtekood: [http://enos.itcollege.ee/~luksti/CSharp/CSharpResto.zip CSharpResto]

XML: [https://wiki.itcollege.ee/index.php/SharpRestoVRII#XML Wikis]

Retsensioonid:

===[https://wiki.itcollege.ee/index.php/BeerPressure Meeskond: BeerPressure]===
Liikmed:
* Sigrid Aasma
* Evelin Jõgi
* Martin Kask
* Marko Nõu
'''Projekt:''' [https://github.com/sikumiku/TaisKohtApi TaisKohtApi]

'''Lõpptoode:''' [https://github.com/sikumiku/TaisKohtApi/archive/61438e187a1a972410c8a3bc6274d69489d00aa6.zip GitHub commit]

'''XML:''' [https://wiki.itcollege.ee/index.php/BeerPressure#XML.2FXSD.2FXSLT Beer Pressure XML/XSD/XSLT]

'''Meie kirjutatud XML failide retsensioon:''' [https://wiki.itcollege.ee/index.php/Talk:MOT#XML_retsensioon_by_meeskond_BeerPressure: Team MOT retsensioon]

'''Meie kirjutatud veebiteenuse retsensioon:''' [https://wiki.itcollege.ee/index.php/Talk:MOT#Veebiteenuse_retsensensioon_by_meeskond_BeerPressure: Team MOT retsensioon]

'''Meie kirjutatud klientrakenduse retsensioon:''' [https://wiki.itcollege.ee/index.php/Talk:Kuldneloojang#Klientrakenduse_retsensensioon_by_meeskond_BeerPressure: Team Kuldneloojang retsensioon]

===[[ Memorize | Meeskond: Memorize]]===
Liikmed:
* Madis Uudam
* Olle Mikk

===[https://wiki.itcollege.ee/index.php/UCanDo Meeskond: UCanDo]===
Liikmed:
* Mart Raus
* Ando Kiidron (loobus)
* Liina Saar

'''Lõpptoode: ''' [https://drive.google.com/drive/folders/1GIgiG5NvmnnKoQYmWWbfV_9Nhs2dezz8?usp=sharing UCanDo] 
'''Veebiteenuse retsensioon: ''' 
'''Klientrakenduse retsensioon: ''' 
'''XML retsensioon: ''' 

===[https://wiki.itcollege.ee/index.php/MOT Meeskond: MOT]===
Liikmed:
* Merike Meizner
* Helen Oppar (loobus)
* Hardi Tiitus

'''Lõpptoode: ''' http://enos.itcollege.ee/~mmeizner/MOT/ 
'''Meie kirjutatud veebiteenuse, klientrakenduse ja XML'i retsensioon:''' [https://docs.google.com/document/d/16WL12wmvQ_TPcY_-4pG_kjwtstQoX5meEYcigE4Febw/edit?usp=sharing: Team Raavo V2]

===[https://wiki.itcollege.ee/index.php/Meeskond:_MealPlanner Meeskond: MealPlanner]===
Liikmed:
*Triin Oja
*Rein Remsu

===[https://wiki.itcollege.ee/index.php/Meeskond:Curry Meeskond: Curry]===
Liikmed:
* Rain Elken
* Peeter Ploom

'''Lõpptoode: ''' [http://enos.itcollege.ee/~pploom/VR2/ link] 
'''XML: ''' [https://wiki.itcollege.ee/index.php/Meeskond:Curry#XML_andmefail link] 
'''XSD: ''' [https://wiki.itcollege.ee/index.php/Meeskond:Curry#XSD_schema_fail link] 
'''XSLT1: ''' [https://wiki.itcollege.ee/index.php/Meeskond:Curry#XSLT_transformatsioon:_XML_-.3E_HTML link] 
'''XSLT2: ''' [https://wiki.itcollege.ee/index.php/Meeskond:Curry#XSLT_transformatsioon:_XML_-.3E_XML link] 

Curry meeskonna veebiteenust, klientrakendust ja XML-i retsenseerib meeskond KuldneLoojang. Curryle kirjutatud retsensioonid [https://wiki.itcollege.ee/index.php/Kuldneloojang#Meie_tehtud_retsensioonid asuvad siin: link]

===[https://wiki.itcollege.ee/index.php/Hammas Meeskond: Hammas]===

Liikmed:
* Sten Lunden

'''Lõpptoode:''' [https://ildtest.azurewebsites.net azure]
 
'''Projekt:''' [https://github.com/lundens/ild-core github]
 
'''XML''' [https://wiki.itcollege.ee/index.php/Hammas#XML wiki]
 
'''Veebiteenuse retsensioon''' meeskonnale [https://wiki.itcollege.ee/index.php/Hammas#Veebiteenuse_retsensioon_meeskonnale_GoFood GoFood]
 
'''Klientrakenduse retsensioon''' meeskonnale [https://wiki.itcollege.ee/index.php/Hammas#Klientrakenduse_retsensioon_meeskonnale_GoFood GoFood]
 
'''XML retsensioon''' meeskonnale [https://wiki.itcollege.ee/index.php/Hammas#XMLi_retsensioon_meeskonnale_MealPlannerSolo MealPlannerSolo]

===[https://wiki.itcollege.ee/index.php/LabLite Meeskond: LabLite]===
Liikmed:
* Alex Kaska

===[https://wiki.itcollege.ee/index.php/AmateurBB Meeskond: AmateurBB]===
Liikmed:
*Taavi Kivimaa
'''Veebiteenus:''' [https://github.com/Tafkinz/AmateurBB/tree/BB-1 GitHub]
 
'''Klientrakendus:''' [https://github.com/Tafkinz/frontend GitHub]
 
'''XML''' [https://wiki.itcollege.ee/index.php/AmateurBB wiki]
 
'''Veebiteenuse retsensioon'''
 
'''Klientrakenduse retsensioon'''
 
'''XML retsensioon'''

===[https://wiki.itcollege.ee/index.php/MealPlannerSolo Meeskond: MealPlannerSolo]===
Liikmed:
*Triin Oja
'''[https://wiki.itcollege.ee/index.php/MealPlannerSolo#XML_andmefail XML]'''
 
'''[http://enos.itcollege.ee/~troja/VRII2018/ Veebiteenus ja klientrakendus]'''

===[https://wiki.itcollege.ee/index.php/NutriCheck Meeskond: NutriCheck]===
Liikmed:
*Artyom Likhachev
'''Project:'''
 [https://www.dropbox.com/s/irgev5w9ofifg5m/vr2_service-v3.zip?dl=0 Veebiteenus]
 [https://www.dropbox.com/s/7kn1u6z2481ligm/WebClient.zip?dl=0 Klientrakendus]
 '''XML:''' TODO
 '''Retsensioon:''' TODO

Kodutöö aines "Võrgurakendused II: hajussüsteemide ehitamine" 2018

2018-06-11T15:18:07Z

Tkuuskma: /* Meeskond: WatchWinders */

[[Category: Võrgurakendused II: hajussüsteemide ehitamine]]
__NOINDEX__

=Kodutöö aines "Võrgurakendused II: hajussüsteemide ehitamine" 2018=
==Eesmärk==
Saada praktiline kogemus hajussüsteemide ehitamisest XML(SOAP) või Rest veebiteenusel ja sellele klientrakenduse loomise abil ning süvendada meeskonnatööoskust.
*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.
*REST teenuste loomisel tuleks kasutada ASP.NET Web API2/ASP.NET Core 2.0/WCF võimalusi.

Kaugem eesmärk on loomulikult hinne :).

==Reeglid==
''' Kodutöö koosneb kolmest eraldiseisvast ülesandest:'''
* 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)
* Luua veebiteenus, mis võimaldaks pakkuda teenust, eristada kasutajaid ning näidata teenuse kasutamise statistikat kasutajate ja tegevuste lõikes
* Luua klientrakendus

Ü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.

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.

==Tähtajad==

* '''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]
** 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>'''
** Veebiteenus peab olema valmis, esitatud ja ja wikilehel kirjeldatud hiljemalt '''27. mai 2018'''.
** Retsensioonid veebiteenuste kohta peavad tehtud olema '''03. juuni 2018'''.

* '''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]
** Klientrakendused peavad olema valmis, esitatud ja ja wikilehel kirjeldatud hiljemalt '''27. mai 2018'''.
** Retsensioonid klientrakenduste kohta peavad tehtud olema '''03. juuni 2018'''.

* '''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]
** XML fail, stiilifail ja skeemifail peavad olema valmis ja wikilehel kirjeldatud hiljemalt '''01. juuni 2018'''.
** Retsensioonid XML-failide kohta peavad tehtud olema '''05.juuni 2018'''.

==Hindamine==
===Üldised kriteeriumid===

Teostatuks loetakse projekt juhul, kui lähteülesanne on realiseeritud, lahendus on töötav, kuid esineb suuremaid vigu ning piirsituatsioonidega ei ole arvestatud.

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.

'''Maksimumtulemuse annab (vähemalt 4/7):'''

* Majanduslik mõtlemine (kas loodav teenus ja rakendused oleks kasutatav ka ärilistel eesmärkidel)
* Mobiilirakendused/Angularis/reactis loodud klientrakendus
* Kogukondade kaasamine
* Kasutajamugavus
* Läbimõeldud töökorraldus
* Lisavõimaluste realiseerimine (vt näidisteemad)
* Korraliku arhitektuuriga kirjutatud kood

===XML andmefail===
Ü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.

XML-il peab olema vähemalt 4 loogilist dimensiooni.
<dim1>
<dim2>
<dim3>
<dim4>
</dim4>
</dim3>
</dim2>
</dim1>
Lisaks tuleb kasutada 3-el dimensioonil attribuute, mis one enamat, kui lihtsalt ID.

===Veebiteenus===
Loodav veebiteenus peab võimaldama:
* Teenuse pakkumist
* '''Teenuse kasutajate tuvastamist ning haldamist'''
* Teenuse kasutajate ja kasutusstatistika üle arve pidamist kasutajate lõikes
* Teenuse poole pöördumiste arvu piiramist ja piirangute haldamist.

Loodav veebiteenus peab toetama mitme kasutaja võimalust.

Loodav veebiteenus tuleb luua kasutades ''Windows Communication Foundation'' või ASP.NET MVC Web API tehnoloogiat

Andmebaasis peab olema vähemalt 9 olemit ehk andmebaas on eeldus,

Soovitav on luua teenus (FE) ja teenuse seadistamiseks ning kasutajate haldamiseks mõeldud rakendus (BE).

===Klientrakendus===
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)

Variant1: teha klientrakendus enda loodud veebiteenusele

Variant2: teha klientrakendus mõnele levinud veebiteenusele.
Näiteks:
* http://www.bing.com/developer
* http://www.flickr.com/services/api/response.soap.html
* http://developer.ebay.com/developercenter/windows/
* http://apiwiki.twitter.com/Getting-Started

===Retsensioonid===
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.

Retsensioon peab sisaldama minimaalselt...
* XML - ...200 sõna.
* Veebiteenus - ...600 sõna.
* Klientrakendus - ...600 sõna.

Mõnelauselisest arvamusest ei piisa, kuna tegemist on grupi loodavate arvustustega, mitte individuaalsete arvustustega.

==Konsultatsioonid==
Igal projektimeeskonnal on piiramatu õigus saada õppejõu käest konsultatsiooni ja juhendamist oma
töö tegemiseks, kas harjutuste ajal või pärast harjutusi ja loenguid. Eriaegade suhtes saab sõlmida
õppejõuga kokkuleppeid kontaktidel
mait.poska [ät] itcollege.ee või (+372 53 469 734)
(teksti originaalautor Priit Raspel)

==Kaitsmisele registreerumine==
Kaitsmisele tuleks registreerida järjest(st iga järgmine lisab vajaliku 15min ajaakna) ja suvalisis kellaaegasid ei hakka kuhugi vahele kirjutama

'''05.06.2018'''
*15:00 - Miisiks
*15:15 - Maagikud
*15:30 - GoFood
*15:45 - Raavo V2™
*16:00 - LearnToDrive
Sellele päevale rohkem aegu juurde lisada ei saa

Allpool olevate päevadele võib vabalt aegasid juurde lisada 15min sammga. Reegel on, et aegu lisame järjest

'''06.06.2018'''
*17:00 - Raamaturiiul
*17:15 - Pakiraam
*..

'''09.06.2018'''
*16:00 - MealPlannerSolo(Triin Oja)
*16:15 - Beer Pressure
*16:30 - <div>
*16:45 - NutriCheck
*17:00 - JääTuli
*17:15 - Ophelia
*17:30 - Kuldne Loojang
*17:45 - Hammas
*18:00 - VariousArtists
*18:15 - Pillar Of Autumn
*18:30 - Curry
*18:45 - WatchWinders
*19:00 - MOT
*19:15 - AmateurBB
*19:30 - Autolugu
*19:45 - VRII2018

=Teemad 2018 kevad=
''' Kodutöö koosneb kolmest eraldiseisvast ülesandest:'''
* 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)
* Luua veebiteenus, mis võimaldaks pakkuda teenust, eristada kasutajaid ning näidata teenuse kasutamise statistikat kasutajate ja tegevuste lõikes
* Luua klientrakendus mõnele olemasolevale või endaloodud veebiteenusele

NB! XML andmefail ja veebiteenus ei pea olema omavahel seotud.

==Näidisteemad==

====Ülesanne====
Luua sobiva alguse järgi nimede pakkumise teenus:
* alates kahetähelisetest algustest pakkuda sobivad nimesid
* luua võimalus kasutajatel nimesid lisada
* luua võimalus administraatoril nimesid muuta/kustutada
* meeste ja naiste nimed peavad olema süsteemis eristatavad
* luua võimalus, mis võimaldab kuvada populaarseid nimesid
* luua võimalus ühele kasutajale (või erinevatele kasutajagruppidele) maksimumpäringute hulga määramiseks
* luua võimalus, et nimi lisatakse baasi alles siis, kui administraatori õigustega inimene on selleks vastava loa andnud

===Külastusstatistika teenus===
Mõte selles, et pakkuda teenust, kus kasutajal on võimalik registreerida külastused ning küsida oma külastusstatistikat.

====Ülesanne====
Luua külastusstatistika teenus:
* kasutaja saab teenuses registreerida külastusi
* kasutaja saab küsida külastusstatistikat päevade/kuude/kogu perioodi lõikes
* luua võimalus ühele kasutajale (või erinevatele kasutajagruppidele) maksimumpäringute hulga määramiseks

Lisavõimalused:
* luua võimalus registreerida alamlehtede külastusstatistikat
* luua võimalus külastusstatistikale lisaparameetrite lisamiseks (ip aadress, sirviku versioon jne)

===Telefoniraamatu teenus===
Mõte selles, et kasutaja saab teenuse abil salvestada kontakte ja nende seast otsida

====Ülesanne====
Luua telefoniraamatu teenus:
* kasutaja saab teenuses kontakte lisada ja kustutada
* kasutaja saab kontaktide nime/telefoninumbri jne abil otsida
* luua võimalus ühele kasutajale (või erinevatele kasutajagruppidele) maksimumpäringute hulga määramiseks
* kasutajaid on võimalik lisada gruppidesse
* kasutajal on võimalik lisada vajalike kontaktandmete liike
* kasutajatel on võimalik jagada omavahel kontakte ja kontaktide grupper

===RSS voogude kogumise ja uudiste kuvamise teenus===
Mõte selles, et kasutaja saab teenuse abil salvestada talle huvipakkuvaid RSS vooge ja nendelt voogudelt uudiseid lugeda

====Ülesanne====
Luua RSS voogude haldusteenus:
* kasutaja saab teenuses RSS vooge lisada ja kustudada
* kasutaja saab pärida talle huvipakkuvate voogude viimaseid uudiseid
* luua võimalus ühele kasutajale (või erinevatele kasutajagruppidele) maksimumpäringute hulga määramiseks
* kasutaja saab RSS vooge vaadata eraldi või grupeeritult
* vooge peab puhverdama, kuna voogude lugemine võtab enamasti üsna palju aega
*

= Meeskonnad 2018=
==Päevaõpe==

===[https://wiki.itcollege.ee/index.php/HairSaloon Meeskond: HairSaloon]===
Liikmed:
* Kaido Henrik Elias
* Arvo Paomees

===[https://wiki.itcollege.ee/index.php/VariousArtists Meeskond: VariousArtists]===
Liikmed:
* Ruudi Vinter
* Madis Roosioks
* Pavel Fleišer

Lõpptoode: [https://drive.google.com/open?id=1Pq8Lhrs3G5mGiTje70ww-zMBNB5cXnRh ZIP]

TFS: [https://variousartists.visualstudio.com/VariousArtists/_versionControl/changesets siin]

XML: [https://wiki.itcollege.ee/index.php/VariousArtists#XML siin]

Retsensioonid: [https://wiki.itcollege.ee/index.php/VariousArtists#Retsensioonid siin]

===[https://wiki.itcollege.ee/index.php/Maagikud Meeskond: Maagikud]===
Liikmed:
*Kristina Rästas
*Simo Jaanus
*Artur Tammiste
*Rauno Lõhmus
Lõpptoote [http://enos.itcollege.ee/~sjaanus/c/Airport_solution.zip link]

Veebiteenuse ja klientrakenduse retsensioon tiimile Raavo V2 asub [https://docs.google.com/document/d/1fxmdLa94Do1u5WlmPQjSd4mMmdbDw5WmDne547jqQc4/edit siin]

XML retsensioon tiimile LTD asub [https://docs.google.com/document/d/15rMhpqyG5XHsvOCZJp88ucHkiMa5Non6BbYwBBKT2_Y/edit siin]

===[https://wiki.itcollege.ee/index.php/RaamatuRiiul Meeskond: RaamatuRiiul]===
Liikmed:
* Alo Avi
* Arnika Rästa
* Marite Rammo
'''Meie XML:''' [https://wiki.itcollege.ee/index.php/RaamatuRiiul#XML XML]

'''Meie veebiteenuse, klientrakenduse ja XML retsensioonid meeskonnale Miisiiks:''' [https://wiki.itcollege.ee/index.php/Talk:Miisiiks retsensioonid]

'''Meie veebiteenus ning klientrakendus.''' [https://www.dropbox.com/s/ugbvx4j4zdlbp68/RaamatuRiiul.7z?dl=0 Zip]

===[https://wiki.itcollege.ee/index.php/Autolugu Meeskond: Autolugu]===
Liikmed:
* Margus Põlma
* Karl Erik Õunapuu

Veebiteenus: [http://enos.itcollege.ee/~mpolma/vr2/API.zip]

Klientrakendus: [https://github.com/karlerikounapuu/autolugu-front]

===[https://wiki.itcollege.ee/index.php/VRII2018 Meeskond: VRII2018]===
Liikmed:
* Kaspar Kaal
* Teet Adamson
* Rahel Kangur

===[https://wiki.itcollege.ee/index.php/Meeskond_Raavo_V2%E2%84%A2 Meeskond: Raavo V2™]===
Liikmed:
* Peeter Fridolin
* Kristo Leesmann
* Rando Rommot

Projekti retsensioon meeskonnale [https://wiki.itcollege.ee/index.php/Meeskond_Raavo_V2™#Retsentsioonid Maagikud]

===[https://wiki.itcollege.ee/index.php/Pillarofautumn Meeskond: Pillar of Autumn ]===
Liikmed:
* Taavi Põder
* Taavi Vesinurm (Meeskonnast lahkunud)
* Raido Vell
'''Lõpptoode API ja klientrakendus:''' [https://github.com/taavip9/Veebirakendused-II Lõpptoode]

===[https://wiki.itcollege.ee/index.php/jaatuli Meeskond: JääTuli]===
Liikmed:
*Tarmo Luugus
*Leho Kivistik
*Hannes Mäeorg
*Marten Tammeleht

===[https://wiki.itcollege.ee/index.php/JustABot Meeskond: JustABot]===
Liikmed:
*Argo Hansen

===[https://wiki.itcollege.ee/index.php/Meeskond_Pakiraam Meeskond: Pakiraam]===
Liikmed:
*Kristo Naeris
*Indro Kottise

Klientrakendus [https://github.com/knaeris/VR2Klient siin] ja veebiteenus [https://github.com/knaeris/VR2Projekt siin]

Retsensioon meeskonna Raavo v2 klientrakendusele : [https://wiki.itcollege.ee/index.php/Meeskond_Pakiraam#Retsensioonid Retsensioon]

Retsensioon meeskonna Raavo v2 veebiteenusele:

===[https://wiki.itcollege.ee/index.php/GoFood Meeskond: GoFood]===
Liikmed:

* Rando Kurel
* Henrik Prangel
* Markus Mänd
* Edgar Tereping
* Jane Kaldma

Lõpptoode: [https://wiki.itcollege.ee/index.php/GoFood#Projektikood lõpptoote leiab siit]

Meie rühma kirjutatud retsentsioonid rühmale Maagikud:[https://wiki.itcollege.ee/index.php/GoFood#Retsensioon_rühmale_Maagikud Retsensioon]

===[https://wiki.itcollege.ee/index.php/LTD Meeskond: LearnToDrive]===
'''Liikmed:'''
*Eve Ormisson
*Carlos Kirtsi

Projekt [https://wiki.itcollege.ee/index.php/LTD#Kood_ise asub siin, kliendina kasutame JustInCaseWPFi]

Projekti retsensioon meeskonnale [https://wiki.itcollege.ee/index.php/LTD#Projekti_retsensioon Maagikud]

XML osa retsensioon meeskonnale [https://wiki.itcollege.ee/index.php/LTD#XML_retsensioon RaamatuRiiul]

===[https://wiki.itcollege.ee/index.php/Miisiiks Meeskond: Miisiiks]===
Liikmed:
*Christo Aruste
*Heleriin Malkov
*Tõnis Prants

[https://www.dropbox.com/s/e2vu3ukgckyc2x5/MiisiiksWS.zip?dl=0 Veebiteenus]

Veebiteenus v2 (05.06): [https://www.dropbox.com/s/4acyvc9c7h08xl6/MiisiiksWS-v2.rar?dl=0 Veebiteenus]

[https://www.dropbox.com/s/iwtheohp5mn0lek/MiisiiksC.zip?dl=0 Klientrakendus]

Klientrakendus v2 (05.06): [https://www.dropbox.com/s/m6ijv2yyqthebgr/MiisiiksC2-v2.rar?dl=0 Klientrakendus]

[https://wiki.itcollege.ee/index.php/Miisiiks#XML XML]

Retsensioonid meeskonnale Raavo V2™

Veebiteenus: [https://wiki.itcollege.ee/index.php/Miisiiks#Veebiteenuse_retsensioon Retsensioon]

Klientrakendus: [https://wiki.itcollege.ee/index.php/Miisiiks#Klientrakenduse_retsensioon Retsensioon]

XML: [https://wiki.itcollege.ee/index.php/Miisiiks#XML_retsensioon XML]

===[https://wiki.itcollege.ee/index.php/VR2_div Meeskond: <div>]===
Liikmed:
*Kaarel Pärtel
*Marek Juhanson
*Kai Kallastu

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]

==Kaugõpe==

===[https://wiki.itcollege.ee/index.php/BestInShow Meeskond: BestInShow]===
Liikmed:
* Liina Abner
* Marju Pütsepp
* Liisi Taimre

'''Lõpptoode veebiteenus:''' [https://www.dropbox.com/s/j5ixmwmx45kxcyo/BestInShow.zip?dl=0 https://www.dropbox.com/s/j5ixmwmx45kxcyo/BestInShow.zip?dl=0] 
'''Kasutusjuhend:''' [https://wiki.itcollege.ee/index.php/BestInShow#Kasutusjuhend https://wiki.itcollege.ee/index.php/BestInShow#Kasutusjuhend] 
'''Lõpptoode klient:''' [https://bitbucket.org/Marjup/bestinshow/ https://bitbucket.org/Marjup/bestinshow/] 
'''XML failid:''' [https://wiki.itcollege.ee/index.php/BestInShow#XML_failid Schema, XML ja XSLT HTML ja XML transformatsiooniks] 
Retsensioon veebiteenusele: TODO retsenseerime projekti WatchWinders 
Retsensioon klientrakendusele: TODO retsenseerime projekti WatchWinders 
Retsensioon XML-ile: TODO retsenseerime projekti WatchWinders 

===[https://wiki.itcollege.ee/index.php/AssistDesq Meeskond: AssistDesq]===
Liikmed:
* Karen Grigorjan

===[https://wiki.itcollege.ee/index.php/WatchWinders Meeskond: WatchWinders]===
Liikmed:
* Toomas Juhkov
* Kunnar Kukk
* Tiit Kuuskmäe
[https://wiki.itcollege.ee/index.php/WatchWinders#Link_klientrakendusele_ja_API-le Link klientrakendusele ja API-le]
[https://drive.google.com/file/d/1OtzOCPiWixsrbHcGCcdHgXIgz3_fsC7h/view Retsensioon grupi "Kuldne Loojang" veebiteenusele]

===[[ Kuldneloojang | Meeskond: Kuldne loojang]]===
'''Liikmed''':
* Andrus Seiman
* Marko Belzetski
* Priit Tiganik
* Kristjan Peterson (loobus)

'''Lõpptoode:'''
algselt üles laetud 02.06.2018, bugide parandusi lisatud 04.06.2018
* [https://www.dropbox.com/s/4h9bvq4k6388fmo/loojang.zip?dl=0 .zip fail rakendus ja klient koos]
* [https://bitbucket.org/itcollegeprojects/loojang-app veebirakenduse repo]
* [https://bitbucket.org/itcollegeprojects/loojang-client klientrakenduse repo]
* [https://wiki.itcollege.ee/index.php/Kuldneloojang#XML_.C3.BClesande_kirjeldus XML: link meie Wiki lehele]

'''Meie tehtud retsensioonid:'''
* [https://wiki.itcollege.ee/index.php/Kuldneloojang#Veebiteenusele veebiteenuse retsensioon meeskonna Curry tööle.]
* [https://wiki.itcollege.ee/index.php/Kuldneloojang#Klientrakendusele klientrakenduse retsensioon meeskonna Curry tööle.]
* [https://wiki.itcollege.ee/index.php/Kuldneloojang#XML-ile XML retsensioon meeskonna Curry tööle.]

===[https://wiki.itcollege.ee/index.php/Ophelia Meeskond: Ophelia]===
Liikmed:
* Siim Kallari
* Andres Kepler (loobus)
* Jorma Rebane

[https://www.dropbox.com/s/v63fkbjnd5umqqm/Ophelia.zip?dl=0 Lõpptoote link]

[https://wiki.itcollege.ee/index.php/Ophelia#L.C3.B5pptoote_kasutusjuhend Kasutusjuhend(Kaasas ka lõpptootes)]

[https://wiki.itcollege.ee/index.php/Ophelia#XML_.C3.9Clesanne XML Ülesanne]

===[https://wiki.itcollege.ee/index.php/SharpRestoVRII Meeskond: SharpRestoVRII]===
Liikmed:
* Andres Aava (lahkunud liige)
* Henri Annilo
* Jaan Koolmeister
* Lauri Üksti

Lähtekood: [http://enos.itcollege.ee/~luksti/CSharp/CSharpResto.zip CSharpResto]

XML: [https://wiki.itcollege.ee/index.php/SharpRestoVRII#XML Wikis]

Retsensioonid:

===[https://wiki.itcollege.ee/index.php/BeerPressure Meeskond: BeerPressure]===
Liikmed:
* Sigrid Aasma
* Evelin Jõgi
* Martin Kask
* Marko Nõu
'''Projekt:''' [https://github.com/sikumiku/TaisKohtApi TaisKohtApi]

'''Lõpptoode:''' [https://github.com/sikumiku/TaisKohtApi/archive/61438e187a1a972410c8a3bc6274d69489d00aa6.zip GitHub commit]

'''XML:''' [https://wiki.itcollege.ee/index.php/BeerPressure#XML.2FXSD.2FXSLT Beer Pressure XML/XSD/XSLT]

'''Meie kirjutatud XML failide retsensioon:''' [https://wiki.itcollege.ee/index.php/Talk:MOT#XML_retsensioon_by_meeskond_BeerPressure: Team MOT retsensioon]

'''Meie kirjutatud veebiteenuse retsensioon:''' [https://wiki.itcollege.ee/index.php/Talk:MOT#Veebiteenuse_retsensensioon_by_meeskond_BeerPressure: Team MOT retsensioon]

'''Meie kirjutatud klientrakenduse retsensioon:''' [https://wiki.itcollege.ee/index.php/Talk:Kuldneloojang#Klientrakenduse_retsensensioon_by_meeskond_BeerPressure: Team Kuldneloojang retsensioon]

===[[ Memorize | Meeskond: Memorize]]===
Liikmed:
* Madis Uudam
* Olle Mikk

===[https://wiki.itcollege.ee/index.php/UCanDo Meeskond: UCanDo]===
Liikmed:
* Mart Raus
* Ando Kiidron (loobus)
* Liina Saar

'''Lõpptoode: ''' [https://drive.google.com/drive/folders/1GIgiG5NvmnnKoQYmWWbfV_9Nhs2dezz8?usp=sharing UCanDo] 
'''Veebiteenuse retsensioon: ''' 
'''Klientrakenduse retsensioon: ''' 
'''XML retsensioon: ''' 

===[https://wiki.itcollege.ee/index.php/MOT Meeskond: MOT]===
Liikmed:
* Merike Meizner
* Helen Oppar (loobus)
* Hardi Tiitus

'''Lõpptoode: ''' http://enos.itcollege.ee/~mmeizner/MOT/ 
'''Meie kirjutatud veebiteenuse, klientrakenduse ja XML'i retsensioon:''' [https://docs.google.com/document/d/16WL12wmvQ_TPcY_-4pG_kjwtstQoX5meEYcigE4Febw/edit?usp=sharing: Team Raavo V2]

===[https://wiki.itcollege.ee/index.php/Meeskond:_MealPlanner Meeskond: MealPlanner]===
Liikmed:
*Triin Oja
*Rein Remsu

===[https://wiki.itcollege.ee/index.php/Meeskond:Curry Meeskond: Curry]===
Liikmed:
* Rain Elken
* Peeter Ploom

'''Lõpptoode: ''' [http://enos.itcollege.ee/~pploom/VR2/ link] 
'''XML: ''' [https://wiki.itcollege.ee/index.php/Meeskond:Curry#XML_andmefail link] 
'''XSD: ''' [https://wiki.itcollege.ee/index.php/Meeskond:Curry#XSD_schema_fail link] 
'''XSLT1: ''' [https://wiki.itcollege.ee/index.php/Meeskond:Curry#XSLT_transformatsioon:_XML_-.3E_HTML link] 
'''XSLT2: ''' [https://wiki.itcollege.ee/index.php/Meeskond:Curry#XSLT_transformatsioon:_XML_-.3E_XML link] 

Curry meeskonna veebiteenust, klientrakendust ja XML-i retsenseerib meeskond KuldneLoojang. Curryle kirjutatud retsensioonid [https://wiki.itcollege.ee/index.php/Kuldneloojang#Meie_tehtud_retsensioonid asuvad siin: link]

===[https://wiki.itcollege.ee/index.php/Hammas Meeskond: Hammas]===

Liikmed:
* Sten Lunden

'''Lõpptoode:''' [https://ildtest.azurewebsites.net azure]
 
'''Projekt:''' [https://github.com/lundens/ild-core github]
 
'''XML''' [https://wiki.itcollege.ee/index.php/Hammas#XML wiki]
 
'''Veebiteenuse retsensioon''' meeskonnale [https://wiki.itcollege.ee/index.php/Hammas#Veebiteenuse_retsensioon_meeskonnale_GoFood GoFood]
 
'''Klientrakenduse retsensioon''' meeskonnale [https://wiki.itcollege.ee/index.php/Hammas#Klientrakenduse_retsensioon_meeskonnale_GoFood GoFood]
 
'''XML retsensioon''' meeskonnale [https://wiki.itcollege.ee/index.php/Hammas#XMLi_retsensioon_meeskonnale_MealPlannerSolo MealPlannerSolo]

===[https://wiki.itcollege.ee/index.php/LabLite Meeskond: LabLite]===
Liikmed:
* Alex Kaska

===[https://wiki.itcollege.ee/index.php/AmateurBB Meeskond: AmateurBB]===
Liikmed:
*Taavi Kivimaa
'''Veebiteenus:''' [https://github.com/Tafkinz/AmateurBB/tree/BB-1 GitHub]
 
'''Klientrakendus:''' [https://github.com/Tafkinz/frontend GitHub]
 
'''XML''' [https://wiki.itcollege.ee/index.php/AmateurBB wiki]
 
'''Veebiteenuse retsensioon'''
 
'''Klientrakenduse retsensioon'''
 
'''XML retsensioon'''

===[https://wiki.itcollege.ee/index.php/MealPlannerSolo Meeskond: MealPlannerSolo]===
Liikmed:
*Triin Oja
'''[https://wiki.itcollege.ee/index.php/MealPlannerSolo#XML_andmefail XML]'''
 
'''[http://enos.itcollege.ee/~troja/VRII2018/ Veebiteenus ja klientrakendus]'''

===[https://wiki.itcollege.ee/index.php/NutriCheck Meeskond: NutriCheck]===
Liikmed:
*Artyom Likhachev
'''Project:'''
 [https://www.dropbox.com/s/irgev5w9ofifg5m/vr2_service-v3.zip?dl=0 Veebiteenus]
 [https://www.dropbox.com/s/7kn1u6z2481ligm/WebClient.zip?dl=0 Klientrakendus]
 '''XML:''' TODO
 '''Retsensioon:''' TODO

WatchWinders

2018-06-11T15:15:40Z

Tkuuskma:

= Meeskond =

Toomas Juhkov, toomas.juhkov@gmail.com 
Tiit Kuuskmäe, tiit.kuuskmae@gmail.com 
Kunnar Kukk, Kunnar.kukk@gmail.com 

= Tegevuste logi =

08.02.2018 - meeskonna loomine, kokkuleppe sõlmimine teema osas 
10.02.2018 - õppejõu teavitamine koos esmase andmemudeliga 
15.02.2018 - lõpliku andmemudeli valmimine(versioon 5) 
18.02.2018 - õppejõu kinnitus, et teema ja meeskond kvalifiseeruvad 
22.02.2018 - viki lehe loomine ja analüüsi koostamise alustamine 
26.02.2018 - tiimi lisandus Kunnar Kukk 
01.03.2018 - tiimi sprint koosolek(seoses täiendava tiimiliikme lisandumisega täpsustasime skoopi) 
03.03.2018 - alustasime koodi kirjutamisega (tabelid klassideks ja annotatsioonid peale) 
06.03.2018 - täiendasime andmemudelit olemiga "UserTypeState" (et saaks muuta kasutajatüüpi) 
08.03.2018 - tiimi sprint koosolek 
18.03.2018 - lisasime olemid "Address", "AddressU", "AddressM", "OfferOfUser", "MediaInOffer" 
22.03.2018 - tiimi sprint koosolek, mis oli pühendatud andmemudeli täiendamisele 
23.03.2018 - pikem tiimi hackathon andmemudeli teemal 
29.03.2018 - täiendatud wiki lehte täielikult ringitöötatud andmemudeliga 
30.03.2018 - täiendatud wiki lehte andmemudeli metainfoga 
09.04.2018 - silusime andmemudelit (mõningad ebavajalikud viited olid sisse jäänud) 
06.05.2018 - panime uuendatud andmemudeli projekti wiki lehele üles 
07.05.2018 - osalesime õppejõu Mait Poska korraldatud hackathonil 
08.06.2018 - XML ülesanne, klientrakenduse ja API kood sai wiki lehel avalikuks 

Terve maikuu oli igapäevane suhtlus üle Skype'i ja fleep.io, mida me ei loginud (liiga tihedaks läks!).

= Kasutatavad metoodikad =

WatchWinders projektis plaanime kasutada peamiselt kaht metoodikat:

1. läbiv retsenseerimine (üks paariline teeb midagi valmis ja teine teeb sellele ülevaatuse; üksus lisatakse kui ülevaatus on lõplikult läbitud ning osapoolte vahel on saabunud konsensus) 
2. paaris programmeerimine (istume ühe masina taha maha ja kirjutame kolmekesi)

Tulenevalt kaugõppe formaadist saab ülekaalus olema esimene variant. Teist metoodikat kasutame nende osade kirjutamiseks, mille puhul võib arvata, et nende lahendamine on keeruline või et lahenduskäike võib olla väga erinevaid. Püüame jooksvalt siinses vikis kajastada ka seda, millise metoodika järgi üks või teine osa valmis.

= Projekti osad =

Alljärgnevalt anname ülevaate projekti osadest: 

(1) andmemudel 
(2) veebiteenuse analüüs 
(3) Minimum Viable Product definitsioon 
(4) Inkrement #1 
(5) Inkrement #2 
(6) Inkrement #3 

Projekti osad on meie viki lehel kirjeldatud valmimise järjekorras.

== Andmemudel ==

Andmemudeli koostamisel lähtusime õppejõu ette antud kriteeriumist, mille järgi andmemudelis on vähemalt 6 põhiolemit (tähistatud tumesinise ja lillaga - meie mudelis 11 tk),
mille hulgas ei sisaldu kasutajate tabelit (Person). 
 
Põhiolemid: 
* Watch - kell 
* Person - kasutaja/kollektsionäär või firma esindaja 
* Box - kellakarp 
* Organization - tootjad, edasimüüjad, hooldus 
* Settings - kellakarbi seade 
* Offer - pakkumine kollektsionäärile 
* Media - meediafailid kellade ja karpide kohta 
* Address - kasutaja/organisatsiooni aadress 
* ElectronicContact - elektrooniliste kontaktide loend 
* Log - logi 
* Access - paroolid ja kasutajanimed 
* Error - vead 
 
Type abiolemid: 
* WatchType - kellatüübid 
* PersonType - isikutüübid: admin, kasutaja 
* OrganizationType - organisatsioonitüübid: tootja, hooldaja, edasimüüja jt 
* ActionType - logi tüübid 
* ContactType - elektroonilise kontakti tüüp: skype, email, telefon jt 
 
Olekud: 
* PersonTypeState - isiku rolli kehtivus ajahetkel (isiku ja tüübi vaheline seos) 
* OrganizationTypeState - organisatsiooni olek(ud) ajahetkel 
 
Kuuluvus: 
* PersonWatch - isikute ja kellade vahelised seosed 
* PersonBox - isiku ja karbi vaheline seos 
* PersonAccess - isiku ja autentimisandmete vaheline seos 
* WatchInBox - kella ja karbi vaheline seos 
* ErrorInWatch - vea ja kella vaheline seos 
* SettingsInBox - seade ja karbi vaheline seos 
* WatchInOrganization - kella ja tootja vaheline seos 
* PersonInOrganization - isiku ja ettevõtte/organisatsiooni vaheline seos 
* SettingsOfWatchType - seade ja kellatüübi vaheline seos 
 
Abstraktsioonid: 
* Locator - abstraktsioon erinevate kontaktitüüpide jaoks 
* Party - abstraktsioon erinevate inimeste, organisatsioonide jt jaoks 
 
Kommunikatsioon: 
* OfferToPerson - isikule suunatud pakkumised 
* OfferFromPerson - isikult lähtuv pakkumine 
 
 
 
[[File:ww_andmemudel_06052018.png]]
 

Andmemudel valmis (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

== Veebiteenuse analüüs ==

Alljärgnevalt esitame kellakarpide infosüsteemi analüüsi järgmistes osades:

(1) toote/teenuse kirjeldus 
(2) probleemi kirjeldus 
(3) lahendus 
(4) süsteemi kasutajad 
(5) loodava API võimalused 
(6) funktsionaalsed nõuded 
(7) mittefunktsionaalsed nõuded 

=== Toote/teenuse kirjeldus ===
Teenuse eesmärgiks on lahendada probleem, kuidas jälgida kellakarpide kaudu mehhaaniliste käekellade seisundit ning keerata neid automaatselt üles distantsilt, näiteks juhul, kui kellade kollektsionäär ei asu füüsiliselt igapäevaselt oma kellade juures. Teenus võimaldab ka tootjal uuendada kontaktandmeid, saata personaalseid teateid. Administraatorile annab ülevaate platvormis toimuvast.

=== Probleemi kirjeldus ===
Mehhaaniliste käekellade kollektsionääride huvi kellakarpide vastu on mitmetahuline. Kollektsionääre huvitab arvepidamine – mitu kella, missuguste omaduste ja eripäradega neil kollektsioonis on. Teisalt soov eksponeerida oma kogusid kolleegidele ja sõpradele. Kellakarpidega täidetud sein või riiulid loovad selleks suurepärase võimaluse. Kolmandaks praktiline vajadus tagada kellavedrude õige vinnastatuse aste. Kaasaja mehhaanilised kellamehhanismid (''automatic'') võimaldavad kellakorpuse füüsilisel liigutamisel kellavedru automaatselt vinnastada.

Näiteks piisab kella kinnitamisest käele, et see hakkaks end käe liigutamisel üles keerama. Kuidas keerata aga üles seisvat kella, mis seisab paigal kellakarbis? Selleks on tänapäeva kellakarpides elektrimootor, mis tagab kella liigutamise vastavalt kellatüübile ettenähtud ööpäevase graafiku alusel. Kollektsionääride üheks probleemiks on see, kuidas juhtida sellist karpi ja omada jooksvat ülevaadet kõikidest oma karpidest, nende tehnilisest seadistusest ja kollektsiooni kuuluvatest kelladest olles tööreisil välisriigis?

=== Lahendus ===
Probleemi lahendamiseks ehitame REST + ASP.NET Core + WebAPI koos kliendiga, mis võimaldab kellakollektsionääridel hallata kellasid karpides, administraatoritel saada ülevaate süsteemist ning tootjatele lisada infot kollektsionääridele. Käesoleva projekti käigus '''ei tegeleta''' kahe IoT lahenduse kui terviku seisukohast olulise nüansiga: (i) karbi püsivara (''firmware'') loomisega, (ii) klientrakenduse ''frontend'' lõpliku häälestamisega (ilus .css ja pildid).

=== Süsteemi kasutajad ===
'''Kollektsionäär''' - haldab ja muudab infot oma kellade ning oma kellakarpide kohta. 
'''Administraator''' - haldab süsteemi infot, vajadusel eemaldab probleeme. 
'''Tootja''' - saab saata süsteemi kollektsionääridele mõeldud infot. 
'''Hooldaja''' - saab infot hooldamist vajavate kellade ja -karpide kohta. 

=== Loodava API võimalused ===
Alljärgnevalt vaatame loodava API võimalusi kasutajagruppide kaupa:

'''Kasutajale/kellakollektsionäärile'''
* Saada ülevaade kelladest ja kellakarpidest (lisada, muuta, vaadata).
* Muuta karbis oleva kella kohta käivat informatsiooni (kella nimi, tootja, tootmise aeg, viitenumber, mehhanism, jõureservi jääk (valikuline), foto kellast, kellarihma liik, muu).
* Karpe juhtida (keerata automaatselt üles). Näha ja muuta kella üleskeerava mehhanismi liikumise kiirust ja muid detaile (nt liikumise suund).
* Näha karbi seisundit, kas karp on hetkel wifiga ühendatud või mitte.
* Näha karbilt saabunud veateateid.
* Sisestada infot kella seisundist.
* Suhelda hooldajate ja tootjatega

'''Tootjale'''
* Uuendada kontaktandmeid.
* Saata personaalseid teateid kellakollektsionääridele.

'''Administraatorile'''
* Näha võrku ühendatud karpide arvu.
* Näha karpidesse paigaldatud kellade nimistut (ilma muude kasutajaandmeteta).
* Näha kellade üleskeeramise mehhanismide arvnäitajaid (madalaim kiirus, keskmine kiirus, tippkiirus; samuti liikumise suundade arvnäitajaid).
* IP-aadresside järgi ülevaadet, millistes riikides karpe kasutatakse (üldised arvandmed).
* Veateatega karpide arv süsteemis (üldised arvandmed).

=== Funktsionaalsed nõuded ===
* Kõik tegevused peavad olema autoriseeritud.
* REST + ASP.NET Core + WebAPI tagastab infot valideeritud JSON formaadis.
* API veatöötlus on tehtud, kasutades standardseid veakoode.
* API-le on tehtud 'health check'.
* Kõik kasutajad peavad saama end autoriseerida.
* Kasutaja, tootja ja administraatori tegevused logitakse.
* Logi ei ole muudetav, vaid on kättesaadav.
* Kasutaja ega tootja ei näe teiste kasutajate ega tootjate infot.
* API klient on kohanduv mobiilile, tahvlile ja desktoparvutile.
* Sisendandmed on valideeritud.

=== Mittefunktsionaalsed nõuded ===
* API-le on lisatud Swagger fail.
* Teenus ja tehniline lahendus on dokumenteeritud.
* Süsteemi kood on vabalt ligipääsetav, täiendatav ning allalaetav.

Esitame töö etappidena, kus kõigepealt defineerime ära Minimum Viable Producti [https://en.wikipedia.org/wiki/Minimum_viable_product] ehk selle miinimumi, mis pakub kasutajale maksimaalset väärtust. See tähendab API loomist ning esmase kliendi loomist kõigile MVP-s defineeritud kasutajagruppidele. Seejärel realiseerime projekti inkrementide ehk tootearenduse sammudena, milles lisame uusi funktsionaalsusi. Ideaalis jõuame realiseerida kõik sammud, kuid kuna teeme nimetatud tööd antud ajaraamis ja koosseisus esmakordselt, siis võtame vabaduse ka realiseerida korralikult niipalju, kui jõuame projekti käigus ära teha.

Võimalik, et meie lõpptulemus erineb mõnes osas esitatud analüüsist. Seda olenevalt sellest kui edukalt meil õnnestub plaanitud funktsionaalsusi realiseerida. Erisusi plaanime käsitleda vastavas 'post production' jaotuses, kus loendame ka projektist kogunenud peamised õppetunnid.

Analüüs valmis (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

== Minimum Viable Product definitsioon ==
'''Kasutaja'''
* Kasutaja saab süsteemi logida ning välja logida
* Kasutaja saab lisada uue kellakarbi
* Kasutaja saab lisada uue kella kellakarpi
* Kasutaja saab muuta kella infot kellakarbis
* Kasutaja saab näha ülevaadet oma karpidest
* Kasutaja saab muuta kellakarbi seadeid
* Kasutaja saab kustutada kella karbis
* Kasutaja saab kustutada kellakarbi

'''Administraator'''
* Näeb autoriseeritult logisid

'''Tootja'''
* Saab lisada kontaktandmeid
* Saab kontaktandmeid muuta

== Inkrement #1 ==
'''Kasutaja'''
* Näeb karbilt saabunud veateateid.
* Saab kellakarpe juhtida.

'''Administraator'''
* IP-aadresside järgi ülevaadet, millistes riikides karpe kasutatakse (üldised arvandmed).
* Karpidesse paigaldatud kellade nimistut (ilma muude kasutajaandmeteta).
* Näeb kasutajate statistikat.

'''Tootja'''
* Saata personaalseid teateid kellakollektsionääridele.

== Inkrement #2 ==
'''Kasutaja'''
* Saab saata teate tootjale.
* Näeb tootja vastust.
* Näha karbi seisundit, kas karp on hetkel wifiga ühendatud või mitte.

'''Administraator'''
* Näha kellade üleskeeramise mehhanismide arvnäitajaid (madalaim kiirus, keskmine kiirus, tippkiirus; samuti liikumise suundade arvnäitajaid).
* Näeb tegevuste ajalugu kliendist.

'''Tootja'''
* Saab lugeda kasutaja teadet.
* Saab vastata kasutajale.

'''Hooldaja'''
* Saab info hooldamist vajavate kellade kohta.

== Inkrement #3 ==
'''Kasutaja'''
* On ehitatud keeletugi.

'''Tootja'''
* On ehitatud keeletugi.

'''Hooldaja'''
* On ehitatud keeletugi.

Inkrementid valmisid (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

= XML ülesanne =
Järgnevalt esitame oma XML-ülesande tulemused.

== IT Management Transformation XML To XML ==
<pre>
<?xml version="1.0" encoding="utf-8"?>
<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">
<xsl:output method="xml" indent="yes"/>
<xsl:template match="/">
<unhandledDevices>
<xsl:for-each select="customers/customer/locations/location/items/item[@isInWorkingCondition='false']">
<device>
<name>
<xsl:value-of select="manufacturer"/>
<xsl:text> </xsl:text>
<xsl:value-of select="model"/>
</name>
<ticket>
<xsl:for-each select="tickets/ticket[@isHandled='false']">
<ticket_id>
<xsl:value-of select="@id"/>
</ticket_id>
<issued_in>
<xsl:value-of select="@issuedIn"/>
</issued_in>
<description>
<xsl:value-of select="description"/>
</description>
</xsl:for-each>
</ticket>
</device>
</xsl:for-each>
</unhandledDevices>
</xsl:template>
</xsl:stylesheet>
</pre>

== IT Management Transformation HTML ==

<pre>
<?xml version="1.0" encoding="utf-8"?>
<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">
<xsl:output method="html" indent="yes"/>
<xsl:template match="/">

<html>
<head>
<title>ItManagement Laptops</title>
</head>
<body style="background-color:#F7F7F7">
<h1>Computers</h1>
<xsl:for-each select="/customers/customer/locations/location/items/item[@type='laptopComputer']">
<xsl:sort select="@isActive='false'"/>
<hr />
<div>
<h3>
<xsl:value-of select="manufacturer"/>
</h3>
Model: 
<xsl:value-of select="model"/>
 
Serial number: 
<xsl:value-of select="serialNumber"/>
 
Date of purchase: 
<xsl:value-of select="dateOfPurchase"/>
 
Operating system: 
<xsl:value-of select="operatingSystem"/>
 
Is on active list: 
<xsl:value-of select="@isActive"/>
 
</div>

<div style="background-color:#E3FAEE" >

<xsl:for-each select="tickets/ticket">
<xsl:choose>
<xsl:when test="@isHandled='true'">
<h3>Handled tickets</h3>
<ul>
Issued in: 
<xsl:value-of select="@issuedIn"/>
 
Ticket ID: 
<xsl:value-of select="@id" />
 
Description: 
<xsl:value-of select="description"/>
 
Solution: 
<xsl:value-of select="solution"/>
 
</ul>
</xsl:when>
<xsl:when test="@isHandled='false'">
<div style="background-color:#FDE5E5">
<h3>Unhandled tickets</h3>
<ul>
Issued in: 
<xsl:value-of select="@issuedIn"/>
 
Ticket ID: 
<xsl:value-of select="@id" />
 
Description: 
<xsl:value-of select="description"/>
 
Solution: 
<xsl:value-of select="solution"/>
 
</ul>
</div>
</xsl:when>
</xsl:choose>
</xsl:for-each>

</div>
</xsl:for-each>
</body>
</html>
</xsl:template>
</xsl:stylesheet>
</pre>

== IT Management XSD ==

<pre>
<?xml version="1.0" encoding="utf-8"?>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="customers">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="customer">
<xs:complexType>
<xs:sequence>
<xs:element name="customerName" type="xs:string" />
<xs:element minOccurs="0" name="contactPerson" type="xs:string" />
<xs:element name="e-mail" type="xs:string" />
<xs:element name="phoneNumber" type="xs:string" />
<xs:element name="locations">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="location">
<xs:complexType>
<xs:sequence>
<xs:element name="city" type="xs:string" />
<xs:element name="address" type="xs:string" />
<xs:element name="comment" type="xs:string" />
<xs:element minOccurs="0" name="localContactPerson" type="xs:string" />
<xs:element minOccurs="0" name="localPhone" type="xs:string" />
<xs:element name="items">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="item">
<xs:complexType>
<xs:sequence>
<xs:element name="manufacturer" type="xs:string" />
<xs:element name="model" type="xs:string" />
<xs:element name="serialNumber" type="xs:string" />
<xs:element name="dateOfPurchase" type="xs:date" />
<xs:element minOccurs="0" name="operatingSystem">
<xs:complexType>
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute name="version" type="xs:string" use="required" />
</xs:extension>
</xs:simpleContent>
</xs:complexType>
</xs:element>
<xs:element minOccurs="0" name="tickets">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="ticket">
<xs:complexType>
<xs:sequence>
<xs:element name="description" type="xs:string" />
<xs:element name="solution" type="xs:string" />
</xs:sequence>
<xs:attribute name="id" type="xs:string" use="required" />
<xs:attribute name="issuedIn" type="xs:date" use="required" />
<xs:attribute name="isHandled" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:unsignedInt" use="required" />
<xs:attribute name="type" type="xs:string" use="required" />
<xs:attribute name="isActive" type="xs:boolean" use="required" />
<xs:attribute name="isUnderWarranty" type="xs:boolean" use="required" />
<xs:attribute name="warrantyInMonths" type="xs:unsignedByte" use="required" />
<xs:attribute name="isInWorkingCondition" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="type" type="xs:string" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:unsignedInt" use="required" />
<xs:attribute name="type" type="xs:string" use="required" />
<xs:attribute name="isActive" type="xs:boolean" use="required" />
<xs:attribute name="hasManyLocations" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
</pre>

== IT Management XML ==

<pre>
<?xml version="1.0" encoding="utf-8" ?>
<customers>
<customer id="33" type="company" isActive="true" hasManyLocations="true">
<customerName>Elamustevaba OÜ</customerName>
<contactPerson>Juhan Pühamees</contactPerson>
<e-mail>juhan@evaba.com</e-mail>
<phoneNumber>+37256565656</phoneNumber>
<locations>
<location type="office">
<city>Tallinn</city>
<address><![CDATA[Pikk 7, 56401]]></address>
<comment><![CDATA[3. korrus -> paremat kätt]]></comment>
<localContactPerson>Maiu Piimaauto</localContactPerson>
<localPhone>+3726510510</localPhone>
<items>
<item id="1" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="36" isInWorkingCondition="false">
<manufacturer>Dell</manufacturer>
<model>Inspiron 3558</model>
<serialNumber>6FGH5JN</serialNumber>
<dateOfPurchase>2017-07-22</dateOfPurchase>
<operatingSystem version="1709">Windows 10 Home</operatingSystem>
<tickets>
<ticket id="HWI001" issuedIn="2017-11-21" isHandled="true">
<description><![CDATA[Wi-Fi is not working]]></description>
<solution><![CDATA[Wi-Fi card replaced (Under the warranty)]]></solution>
</ticket>
<ticket id="SWI256" issuedIn="2018-05-05" isHandled="false">
<description><![CDATA[Computer keeps showing login screen]]></description>
<solution></solution>
</ticket>
</tickets>
</item>
<item id="55" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="60" isInWorkingCondition="true">
<manufacturer>Dell</manufacturer>
<model>Latitude E7550</model>
<serialNumber>8JGR78U</serialNumber>
<dateOfPurchase>2016-06-15</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Home</operatingSystem>
</item>
</items>
</location>
<location type="store">
<city>Tallinn</city>
<address><![CDATA[Lai 17, 56401]]></address>
<comment><![CDATA[keldrikorrusel]]></comment>
<localContactPerson>Tanja Õielemb</localContactPerson>
<localPhone>+3726510520</localPhone>
<items>
<item id="83" type="desktopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Lenovo</manufacturer>
<model>ThinkCentre M715</model>
<serialNumber>IO25689AD54KL</serialNumber>
<dateOfPurchase>2017-12-01</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Pro</operatingSystem>
</item>
<item id="12" type="monitor" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>AOC</manufacturer>
<model>L456</model>
<serialNumber>9803987YE54</serialNumber>
<dateOfPurchase>2015-05-03</dateOfPurchase>
<tickets>
<ticket id="HWI126" issuedIn="2016-01-18" isHandled="true">
<description><![CDATA[Doesn't work, no picture.]]></description>
<solution><![CDATA[Wasn't plugged in. Technician did it - works again!]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
<customer id="02" type="private" isActive="true" hasManyLocations="false">
<customerName>Kessu Sisselasi</customerName>
<e-mail>kessu@tripp.org</e-mail>
<phoneNumber>+372555555</phoneNumber>
<locations>
<location type="home">
<city>Saue</city>
<address><![CDATA[Kooli 4-8, 78965]]></address>
<comment><![CDATA[2. korrus. Kitsad koridorid.]]></comment>
<items>
<item id="98" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Acer</manufacturer>
<model>Aspire 5</model>
<serialNumber>475YRT89K4</serialNumber>
<dateOfPurchase>2018-03-25</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Home</operatingSystem>
</item>
<item id="4" type="laptopComputer" isActive="false" isUnderWarranty="false" warrantyInMonths="36" isInWorkingCondition="true">
<manufacturer>Lenovo</manufacturer>
<model>IdeaPad L530</model>
<serialNumber>U89TRY765ME</serialNumber>
<dateOfPurchase>2007-08-14</dateOfPurchase>
<operatingSystem version="">Windows XP</operatingSystem>
<tickets>
<ticket id="SWI069" issuedIn="2010-01-28" isHandled="true">
<description><![CDATA[Blue screen.]]></description>
<solution><![CDATA[Video driver update.]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
<customer id="26" type="company" isActive="true" hasManyLocations="true">
<customerName>Aktsiaselts OÜ</customerName>
<contactPerson>Gunnar Kuningas</contactPerson>
<e-mail>gunnar@kunn.ee</e-mail>
<phoneNumber>+3726985236</phoneNumber>
<locations>
<location type="office">
<city>Loksa</city>
<address><![CDATA[Kalda 14, 78965]]></address>
<comment><![CDATA[Sissepääs Rimi poolt, helesinine uks]]></comment>
<items>
<item id="26" type="laptopComputer" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Apple</manufacturer>
<model>Macbook Air</model>
<serialNumber>258JUY369</serialNumber>
<dateOfPurchase>2017-03-01</dateOfPurchase>
<operatingSystem version="High Sierra">OS X</operatingSystem>
</item>
<item id="59" type="laptopComputer" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="false">
<manufacturer>Acer</manufacturer>
<model>Chromebook 11</model>
<serialNumber>U89TRY765ME</serialNumber>
<dateOfPurchase>2016-04-23</dateOfPurchase>
<operatingSystem version="">Chrome OS</operatingSystem>
<tickets>
<ticket id="HWI046" issuedIn="2010-02-28" isHandled="false">
<description><![CDATA[Stripes on screen]]></description>
<solution><![CDATA[]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
</customers>
</pre>

= Link klientrakendusele ja API-le =
https://drive.google.com/file/d/1FU3XGGVHbn4BNNHAsOs7DQ4CzpEDwZUt/view?usp=sharing (nagu logidest näha lisasime selle lingi 08.06.2018, kuid siin on mõned üleliigsed kataloogid) 
https://drive.google.com/file/d/1A7cxeK15xlWSww_CPxpksSfj0m10qFQV/view?usp=sharing (09.06.2019 laadisime üles paki, kus on kustutatud kaks ebavajalikku kataloogi, mis võivad tekitada segadust)

== Palun loe seda "readme" asemel ==

1. meie rakenduse implementeeritud skoop lähtub siin lehel (ülal), analüüsi osas defineeritud "Minimum viable product" kriteeriumitest 
2. lase API käima, tee andmebaaside migratsioonid ja update-database 
3. implementeeritud on kõik teenused, mis on nähtaval Swaggeris aadressil: "localhost:[pordinumber]/Swagger" 
4. kliendirakendus asub kataloogis 'WatchWindersClient' ja tegemist on solutioniga, mille võiks käivitada teises Visual Studio aknas 
5. klientrakenduse käivitumiseks tuleks muuta App.config failis muuta ära localhost portide numbrid asendades need enda arvutis oleva localhost pordiga ning lisada kehtiv JWT AccessToken, mille saab Postmaniga aadressilt api/Security/getToken "Email" ja "Password" abil pärast seda kui kasutaja on loodud 
6. küsimuste ja raskuste korral kirjuta tiit.kuuskmae@gmail.com (API) ja toomas.juhkov@gmail.com (klient). Vastame esimesel võimalusel.

= Retsensioonid =
1. Veebiteenuse retsensioon grupile "Kuldne Loojang". Kättesaadav: https://drive.google.com/file/d/1OtzOCPiWixsrbHcGCcdHgXIgz3_fsC7h/view

= Kasutatud kirjandus ja allikad =

1. Albahari, Joseph, Albari, Ben 2017. C# 7.0 in A Nutshell. Sebastopol: O’Reilly 
2. MariaDB Foundation. MariaDB. Kättesaadav:https://mariadb.org/ 
3. Martin, Robert 2018. Clean Architecture. Boston: Pearson Education

WatchWinders

2018-06-09T11:16:09Z

Tkuuskma: /* Link klientrakendusele ja API-le */

= Meeskond =

Toomas Juhkov, toomas.juhkov@gmail.com 
Tiit Kuuskmäe, tiit.kuuskmae@gmail.com 
Kunnar Kukk, Kunnar.kukk@gmail.com 

= Tegevuste logi =

08.02.2018 - meeskonna loomine, kokkuleppe sõlmimine teema osas 
10.02.2018 - õppejõu teavitamine koos esmase andmemudeliga 
15.02.2018 - lõpliku andmemudeli valmimine(versioon 5) 
18.02.2018 - õppejõu kinnitus, et teema ja meeskond kvalifiseeruvad 
22.02.2018 - viki lehe loomine ja analüüsi koostamise alustamine 
26.02.2018 - tiimi lisandus Kunnar Kukk 
01.03.2018 - tiimi sprint koosolek(seoses täiendava tiimiliikme lisandumisega täpsustasime skoopi) 
03.03.2018 - alustasime koodi kirjutamisega (tabelid klassideks ja annotatsioonid peale) 
06.03.2018 - täiendasime andmemudelit olemiga "UserTypeState" (et saaks muuta kasutajatüüpi) 
08.03.2018 - tiimi sprint koosolek 
18.03.2018 - lisasime olemid "Address", "AddressU", "AddressM", "OfferOfUser", "MediaInOffer" 
22.03.2018 - tiimi sprint koosolek, mis oli pühendatud andmemudeli täiendamisele 
23.03.2018 - pikem tiimi hackathon andmemudeli teemal 
29.03.2018 - täiendatud wiki lehte täielikult ringitöötatud andmemudeliga 
30.03.2018 - täiendatud wiki lehte andmemudeli metainfoga 
09.04.2018 - silusime andmemudelit (mõningad ebavajalikud viited olid sisse jäänud) 
06.05.2018 - panime uuendatud andmemudeli projekti wiki lehele üles 
07.05.2018 - osalesime õppejõu Mait Poska korraldatud hackathonil 
08.06.2018 - XML ülesanne, klientrakenduse ja API kood sai wiki lehel avalikuks 

Terve maikuu oli igapäevane suhtlus üle Skype'i ja fleep.io, mida me ei loginud (liiga tihedaks läks!).

= Kasutatavad metoodikad =

WatchWinders projektis plaanime kasutada peamiselt kaht metoodikat:

1. läbiv retsenseerimine (üks paariline teeb midagi valmis ja teine teeb sellele ülevaatuse; üksus lisatakse kui ülevaatus on lõplikult läbitud ning osapoolte vahel on saabunud konsensus) 
2. paaris programmeerimine (istume ühe masina taha maha ja kirjutame kolmekesi)

Tulenevalt kaugõppe formaadist saab ülekaalus olema esimene variant. Teist metoodikat kasutame nende osade kirjutamiseks, mille puhul võib arvata, et nende lahendamine on keeruline või et lahenduskäike võib olla väga erinevaid. Püüame jooksvalt siinses vikis kajastada ka seda, millise metoodika järgi üks või teine osa valmis.

= Projekti osad =

Alljärgnevalt anname ülevaate projekti osadest: 

(1) andmemudel 
(2) veebiteenuse analüüs 
(3) Minimum Viable Product definitsioon 
(4) Inkrement #1 
(5) Inkrement #2 
(6) Inkrement #3 

Projekti osad on meie viki lehel kirjeldatud valmimise järjekorras.

== Andmemudel ==

Andmemudeli koostamisel lähtusime õppejõu ette antud kriteeriumist, mille järgi andmemudelis on vähemalt 6 põhiolemit (tähistatud tumesinise ja lillaga - meie mudelis 11 tk),
mille hulgas ei sisaldu kasutajate tabelit (Person). 
 
Põhiolemid: 
* Watch - kell 
* Person - kasutaja/kollektsionäär või firma esindaja 
* Box - kellakarp 
* Organization - tootjad, edasimüüjad, hooldus 
* Settings - kellakarbi seade 
* Offer - pakkumine kollektsionäärile 
* Media - meediafailid kellade ja karpide kohta 
* Address - kasutaja/organisatsiooni aadress 
* ElectronicContact - elektrooniliste kontaktide loend 
* Log - logi 
* Access - paroolid ja kasutajanimed 
* Error - vead 
 
Type abiolemid: 
* WatchType - kellatüübid 
* PersonType - isikutüübid: admin, kasutaja 
* OrganizationType - organisatsioonitüübid: tootja, hooldaja, edasimüüja jt 
* ActionType - logi tüübid 
* ContactType - elektroonilise kontakti tüüp: skype, email, telefon jt 
 
Olekud: 
* PersonTypeState - isiku rolli kehtivus ajahetkel (isiku ja tüübi vaheline seos) 
* OrganizationTypeState - organisatsiooni olek(ud) ajahetkel 
 
Kuuluvus: 
* PersonWatch - isikute ja kellade vahelised seosed 
* PersonBox - isiku ja karbi vaheline seos 
* PersonAccess - isiku ja autentimisandmete vaheline seos 
* WatchInBox - kella ja karbi vaheline seos 
* ErrorInWatch - vea ja kella vaheline seos 
* SettingsInBox - seade ja karbi vaheline seos 
* WatchInOrganization - kella ja tootja vaheline seos 
* PersonInOrganization - isiku ja ettevõtte/organisatsiooni vaheline seos 
* SettingsOfWatchType - seade ja kellatüübi vaheline seos 
 
Abstraktsioonid: 
* Locator - abstraktsioon erinevate kontaktitüüpide jaoks 
* Party - abstraktsioon erinevate inimeste, organisatsioonide jt jaoks 
 
Kommunikatsioon: 
* OfferToPerson - isikule suunatud pakkumised 
* OfferFromPerson - isikult lähtuv pakkumine 
 
 
 
[[File:ww_andmemudel_06052018.png]]
 

Andmemudel valmis (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

== Veebiteenuse analüüs ==

Alljärgnevalt esitame kellakarpide infosüsteemi analüüsi järgmistes osades:

(1) toote/teenuse kirjeldus 
(2) probleemi kirjeldus 
(3) lahendus 
(4) süsteemi kasutajad 
(5) loodava API võimalused 
(6) funktsionaalsed nõuded 
(7) mittefunktsionaalsed nõuded 

=== Toote/teenuse kirjeldus ===
Teenuse eesmärgiks on lahendada probleem, kuidas jälgida kellakarpide kaudu mehhaaniliste käekellade seisundit ning keerata neid automaatselt üles distantsilt, näiteks juhul, kui kellade kollektsionäär ei asu füüsiliselt igapäevaselt oma kellade juures. Teenus võimaldab ka tootjal uuendada kontaktandmeid, saata personaalseid teateid. Administraatorile annab ülevaate platvormis toimuvast.

=== Probleemi kirjeldus ===
Mehhaaniliste käekellade kollektsionääride huvi kellakarpide vastu on mitmetahuline. Kollektsionääre huvitab arvepidamine – mitu kella, missuguste omaduste ja eripäradega neil kollektsioonis on. Teisalt soov eksponeerida oma kogusid kolleegidele ja sõpradele. Kellakarpidega täidetud sein või riiulid loovad selleks suurepärase võimaluse. Kolmandaks praktiline vajadus tagada kellavedrude õige vinnastatuse aste. Kaasaja mehhaanilised kellamehhanismid (''automatic'') võimaldavad kellakorpuse füüsilisel liigutamisel kellavedru automaatselt vinnastada.

Näiteks piisab kella kinnitamisest käele, et see hakkaks end käe liigutamisel üles keerama. Kuidas keerata aga üles seisvat kella, mis seisab paigal kellakarbis? Selleks on tänapäeva kellakarpides elektrimootor, mis tagab kella liigutamise vastavalt kellatüübile ettenähtud ööpäevase graafiku alusel. Kollektsionääride üheks probleemiks on see, kuidas juhtida sellist karpi ja omada jooksvat ülevaadet kõikidest oma karpidest, nende tehnilisest seadistusest ja kollektsiooni kuuluvatest kelladest olles tööreisil välisriigis?

=== Lahendus ===
Probleemi lahendamiseks ehitame REST + ASP.NET Core + WebAPI koos kliendiga, mis võimaldab kellakollektsionääridel hallata kellasid karpides, administraatoritel saada ülevaate süsteemist ning tootjatele lisada infot kollektsionääridele. Käesoleva projekti käigus '''ei tegeleta''' kahe IoT lahenduse kui terviku seisukohast olulise nüansiga: (i) karbi püsivara (''firmware'') loomisega, (ii) klientrakenduse ''frontend'' lõpliku häälestamisega (ilus .css ja pildid).

=== Süsteemi kasutajad ===
'''Kollektsionäär''' - haldab ja muudab infot oma kellade ning oma kellakarpide kohta. 
'''Administraator''' - haldab süsteemi infot, vajadusel eemaldab probleeme. 
'''Tootja''' - saab saata süsteemi kollektsionääridele mõeldud infot. 
'''Hooldaja''' - saab infot hooldamist vajavate kellade ja -karpide kohta. 

=== Loodava API võimalused ===
Alljärgnevalt vaatame loodava API võimalusi kasutajagruppide kaupa:

'''Kasutajale/kellakollektsionäärile'''
* Saada ülevaade kelladest ja kellakarpidest (lisada, muuta, vaadata).
* Muuta karbis oleva kella kohta käivat informatsiooni (kella nimi, tootja, tootmise aeg, viitenumber, mehhanism, jõureservi jääk (valikuline), foto kellast, kellarihma liik, muu).
* Karpe juhtida (keerata automaatselt üles). Näha ja muuta kella üleskeerava mehhanismi liikumise kiirust ja muid detaile (nt liikumise suund).
* Näha karbi seisundit, kas karp on hetkel wifiga ühendatud või mitte.
* Näha karbilt saabunud veateateid.
* Sisestada infot kella seisundist.
* Suhelda hooldajate ja tootjatega

'''Tootjale'''
* Uuendada kontaktandmeid.
* Saata personaalseid teateid kellakollektsionääridele.

'''Administraatorile'''
* Näha võrku ühendatud karpide arvu.
* Näha karpidesse paigaldatud kellade nimistut (ilma muude kasutajaandmeteta).
* Näha kellade üleskeeramise mehhanismide arvnäitajaid (madalaim kiirus, keskmine kiirus, tippkiirus; samuti liikumise suundade arvnäitajaid).
* IP-aadresside järgi ülevaadet, millistes riikides karpe kasutatakse (üldised arvandmed).
* Veateatega karpide arv süsteemis (üldised arvandmed).

=== Funktsionaalsed nõuded ===
* Kõik tegevused peavad olema autoriseeritud.
* REST + ASP.NET Core + WebAPI tagastab infot valideeritud JSON formaadis.
* API veatöötlus on tehtud, kasutades standardseid veakoode.
* API-le on tehtud 'health check'.
* Kõik kasutajad peavad saama end autoriseerida.
* Kasutaja, tootja ja administraatori tegevused logitakse.
* Logi ei ole muudetav, vaid on kättesaadav.
* Kasutaja ega tootja ei näe teiste kasutajate ega tootjate infot.
* API klient on kohanduv mobiilile, tahvlile ja desktoparvutile.
* Sisendandmed on valideeritud.

=== Mittefunktsionaalsed nõuded ===
* API-le on lisatud Swagger fail.
* Teenus ja tehniline lahendus on dokumenteeritud.
* Süsteemi kood on vabalt ligipääsetav, täiendatav ning allalaetav.

Esitame töö etappidena, kus kõigepealt defineerime ära Minimum Viable Producti [https://en.wikipedia.org/wiki/Minimum_viable_product] ehk selle miinimumi, mis pakub kasutajale maksimaalset väärtust. See tähendab API loomist ning esmase kliendi loomist kõigile MVP-s defineeritud kasutajagruppidele. Seejärel realiseerime projekti inkrementide ehk tootearenduse sammudena, milles lisame uusi funktsionaalsusi. Ideaalis jõuame realiseerida kõik sammud, kuid kuna teeme nimetatud tööd antud ajaraamis ja koosseisus esmakordselt, siis võtame vabaduse ka realiseerida korralikult niipalju, kui jõuame projekti käigus ära teha.

Võimalik, et meie lõpptulemus erineb mõnes osas esitatud analüüsist. Seda olenevalt sellest kui edukalt meil õnnestub plaanitud funktsionaalsusi realiseerida. Erisusi plaanime käsitleda vastavas 'post production' jaotuses, kus loendame ka projektist kogunenud peamised õppetunnid.

Analüüs valmis (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

== Minimum Viable Product definitsioon ==
'''Kasutaja'''
* Kasutaja saab süsteemi logida ning välja logida
* Kasutaja saab lisada uue kellakarbi
* Kasutaja saab lisada uue kella kellakarpi
* Kasutaja saab muuta kella infot kellakarbis
* Kasutaja saab näha ülevaadet oma karpidest
* Kasutaja saab muuta kellakarbi seadeid
* Kasutaja saab kustutada kella karbis
* Kasutaja saab kustutada kellakarbi

'''Administraator'''
* Näeb autoriseeritult logisid

'''Tootja'''
* Saab lisada kontaktandmeid
* Saab kontaktandmeid muuta

== Inkrement #1 ==
'''Kasutaja'''
* Näeb karbilt saabunud veateateid.
* Saab kellakarpe juhtida.

'''Administraator'''
* IP-aadresside järgi ülevaadet, millistes riikides karpe kasutatakse (üldised arvandmed).
* Karpidesse paigaldatud kellade nimistut (ilma muude kasutajaandmeteta).
* Näeb kasutajate statistikat.

'''Tootja'''
* Saata personaalseid teateid kellakollektsionääridele.

== Inkrement #2 ==
'''Kasutaja'''
* Saab saata teate tootjale.
* Näeb tootja vastust.
* Näha karbi seisundit, kas karp on hetkel wifiga ühendatud või mitte.

'''Administraator'''
* Näha kellade üleskeeramise mehhanismide arvnäitajaid (madalaim kiirus, keskmine kiirus, tippkiirus; samuti liikumise suundade arvnäitajaid).
* Näeb tegevuste ajalugu kliendist.

'''Tootja'''
* Saab lugeda kasutaja teadet.
* Saab vastata kasutajale.

'''Hooldaja'''
* Saab info hooldamist vajavate kellade kohta.

== Inkrement #3 ==
'''Kasutaja'''
* On ehitatud keeletugi.

'''Tootja'''
* On ehitatud keeletugi.

'''Hooldaja'''
* On ehitatud keeletugi.

Inkrementid valmisid (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

= XML ülesanne =
Järgnevalt esitame oma XML-ülesande tulemused.

== IT Management Transformation XML To XML ==
<pre>
<?xml version="1.0" encoding="utf-8"?>
<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">
<xsl:output method="xml" indent="yes"/>
<xsl:template match="/">
<unhandledDevices>
<xsl:for-each select="customers/customer/locations/location/items/item[@isInWorkingCondition='false']">
<device>
<name>
<xsl:value-of select="manufacturer"/>
<xsl:text> </xsl:text>
<xsl:value-of select="model"/>
</name>
<ticket>
<xsl:for-each select="tickets/ticket[@isHandled='false']">
<ticket_id>
<xsl:value-of select="@id"/>
</ticket_id>
<issued_in>
<xsl:value-of select="@issuedIn"/>
</issued_in>
<description>
<xsl:value-of select="description"/>
</description>
</xsl:for-each>
</ticket>
</device>
</xsl:for-each>
</unhandledDevices>
</xsl:template>
</xsl:stylesheet>
</pre>

== IT Management Transformation HTML ==

<pre>
<?xml version="1.0" encoding="utf-8"?>
<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">
<xsl:output method="html" indent="yes"/>
<xsl:template match="/">

<html>
<head>
<title>ItManagement Laptops</title>
</head>
<body style="background-color:#F7F7F7">
<h1>Computers</h1>
<xsl:for-each select="/customers/customer/locations/location/items/item[@type='laptopComputer']">
<xsl:sort select="@isActive='false'"/>
<hr />
<div>
<h3>
<xsl:value-of select="manufacturer"/>
</h3>
Model: 
<xsl:value-of select="model"/>
 
Serial number: 
<xsl:value-of select="serialNumber"/>
 
Date of purchase: 
<xsl:value-of select="dateOfPurchase"/>
 
Operating system: 
<xsl:value-of select="operatingSystem"/>
 
Is on active list: 
<xsl:value-of select="@isActive"/>
 
</div>

<div style="background-color:#E3FAEE" >

<xsl:for-each select="tickets/ticket">
<xsl:choose>
<xsl:when test="@isHandled='true'">
<h3>Handled tickets</h3>
<ul>
Issued in: 
<xsl:value-of select="@issuedIn"/>
 
Ticket ID: 
<xsl:value-of select="@id" />
 
Description: 
<xsl:value-of select="description"/>
 
Solution: 
<xsl:value-of select="solution"/>
 
</ul>
</xsl:when>
<xsl:when test="@isHandled='false'">
<div style="background-color:#FDE5E5">
<h3>Unhandled tickets</h3>
<ul>
Issued in: 
<xsl:value-of select="@issuedIn"/>
 
Ticket ID: 
<xsl:value-of select="@id" />
 
Description: 
<xsl:value-of select="description"/>
 
Solution: 
<xsl:value-of select="solution"/>
 
</ul>
</div>
</xsl:when>
</xsl:choose>
</xsl:for-each>

</div>
</xsl:for-each>
</body>
</html>
</xsl:template>
</xsl:stylesheet>
</pre>

== IT Management XSD ==

<pre>
<?xml version="1.0" encoding="utf-8"?>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="customers">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="customer">
<xs:complexType>
<xs:sequence>
<xs:element name="customerName" type="xs:string" />
<xs:element minOccurs="0" name="contactPerson" type="xs:string" />
<xs:element name="e-mail" type="xs:string" />
<xs:element name="phoneNumber" type="xs:string" />
<xs:element name="locations">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="location">
<xs:complexType>
<xs:sequence>
<xs:element name="city" type="xs:string" />
<xs:element name="address" type="xs:string" />
<xs:element name="comment" type="xs:string" />
<xs:element minOccurs="0" name="localContactPerson" type="xs:string" />
<xs:element minOccurs="0" name="localPhone" type="xs:string" />
<xs:element name="items">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="item">
<xs:complexType>
<xs:sequence>
<xs:element name="manufacturer" type="xs:string" />
<xs:element name="model" type="xs:string" />
<xs:element name="serialNumber" type="xs:string" />
<xs:element name="dateOfPurchase" type="xs:date" />
<xs:element minOccurs="0" name="operatingSystem">
<xs:complexType>
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute name="version" type="xs:string" use="required" />
</xs:extension>
</xs:simpleContent>
</xs:complexType>
</xs:element>
<xs:element minOccurs="0" name="tickets">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="ticket">
<xs:complexType>
<xs:sequence>
<xs:element name="description" type="xs:string" />
<xs:element name="solution" type="xs:string" />
</xs:sequence>
<xs:attribute name="id" type="xs:string" use="required" />
<xs:attribute name="issuedIn" type="xs:date" use="required" />
<xs:attribute name="isHandled" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:unsignedInt" use="required" />
<xs:attribute name="type" type="xs:string" use="required" />
<xs:attribute name="isActive" type="xs:boolean" use="required" />
<xs:attribute name="isUnderWarranty" type="xs:boolean" use="required" />
<xs:attribute name="warrantyInMonths" type="xs:unsignedByte" use="required" />
<xs:attribute name="isInWorkingCondition" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="type" type="xs:string" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:unsignedInt" use="required" />
<xs:attribute name="type" type="xs:string" use="required" />
<xs:attribute name="isActive" type="xs:boolean" use="required" />
<xs:attribute name="hasManyLocations" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
</pre>

== IT Management XML ==

<pre>
<?xml version="1.0" encoding="utf-8" ?>
<customers>
<customer id="33" type="company" isActive="true" hasManyLocations="true">
<customerName>Elamustevaba OÜ</customerName>
<contactPerson>Juhan Pühamees</contactPerson>
<e-mail>juhan@evaba.com</e-mail>
<phoneNumber>+37256565656</phoneNumber>
<locations>
<location type="office">
<city>Tallinn</city>
<address><![CDATA[Pikk 7, 56401]]></address>
<comment><![CDATA[3. korrus -> paremat kätt]]></comment>
<localContactPerson>Maiu Piimaauto</localContactPerson>
<localPhone>+3726510510</localPhone>
<items>
<item id="1" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="36" isInWorkingCondition="false">
<manufacturer>Dell</manufacturer>
<model>Inspiron 3558</model>
<serialNumber>6FGH5JN</serialNumber>
<dateOfPurchase>2017-07-22</dateOfPurchase>
<operatingSystem version="1709">Windows 10 Home</operatingSystem>
<tickets>
<ticket id="HWI001" issuedIn="2017-11-21" isHandled="true">
<description><![CDATA[Wi-Fi is not working]]></description>
<solution><![CDATA[Wi-Fi card replaced (Under the warranty)]]></solution>
</ticket>
<ticket id="SWI256" issuedIn="2018-05-05" isHandled="false">
<description><![CDATA[Computer keeps showing login screen]]></description>
<solution></solution>
</ticket>
</tickets>
</item>
<item id="55" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="60" isInWorkingCondition="true">
<manufacturer>Dell</manufacturer>
<model>Latitude E7550</model>
<serialNumber>8JGR78U</serialNumber>
<dateOfPurchase>2016-06-15</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Home</operatingSystem>
</item>
</items>
</location>
<location type="store">
<city>Tallinn</city>
<address><![CDATA[Lai 17, 56401]]></address>
<comment><![CDATA[keldrikorrusel]]></comment>
<localContactPerson>Tanja Õielemb</localContactPerson>
<localPhone>+3726510520</localPhone>
<items>
<item id="83" type="desktopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Lenovo</manufacturer>
<model>ThinkCentre M715</model>
<serialNumber>IO25689AD54KL</serialNumber>
<dateOfPurchase>2017-12-01</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Pro</operatingSystem>
</item>
<item id="12" type="monitor" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>AOC</manufacturer>
<model>L456</model>
<serialNumber>9803987YE54</serialNumber>
<dateOfPurchase>2015-05-03</dateOfPurchase>
<tickets>
<ticket id="HWI126" issuedIn="2016-01-18" isHandled="true">
<description><![CDATA[Doesn't work, no picture.]]></description>
<solution><![CDATA[Wasn't plugged in. Technician did it - works again!]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
<customer id="02" type="private" isActive="true" hasManyLocations="false">
<customerName>Kessu Sisselasi</customerName>
<e-mail>kessu@tripp.org</e-mail>
<phoneNumber>+372555555</phoneNumber>
<locations>
<location type="home">
<city>Saue</city>
<address><![CDATA[Kooli 4-8, 78965]]></address>
<comment><![CDATA[2. korrus. Kitsad koridorid.]]></comment>
<items>
<item id="98" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Acer</manufacturer>
<model>Aspire 5</model>
<serialNumber>475YRT89K4</serialNumber>
<dateOfPurchase>2018-03-25</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Home</operatingSystem>
</item>
<item id="4" type="laptopComputer" isActive="false" isUnderWarranty="false" warrantyInMonths="36" isInWorkingCondition="true">
<manufacturer>Lenovo</manufacturer>
<model>IdeaPad L530</model>
<serialNumber>U89TRY765ME</serialNumber>
<dateOfPurchase>2007-08-14</dateOfPurchase>
<operatingSystem version="">Windows XP</operatingSystem>
<tickets>
<ticket id="SWI069" issuedIn="2010-01-28" isHandled="true">
<description><![CDATA[Blue screen.]]></description>
<solution><![CDATA[Video driver update.]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
<customer id="26" type="company" isActive="true" hasManyLocations="true">
<customerName>Aktsiaselts OÜ</customerName>
<contactPerson>Gunnar Kuningas</contactPerson>
<e-mail>gunnar@kunn.ee</e-mail>
<phoneNumber>+3726985236</phoneNumber>
<locations>
<location type="office">
<city>Loksa</city>
<address><![CDATA[Kalda 14, 78965]]></address>
<comment><![CDATA[Sissepääs Rimi poolt, helesinine uks]]></comment>
<items>
<item id="26" type="laptopComputer" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Apple</manufacturer>
<model>Macbook Air</model>
<serialNumber>258JUY369</serialNumber>
<dateOfPurchase>2017-03-01</dateOfPurchase>
<operatingSystem version="High Sierra">OS X</operatingSystem>
</item>
<item id="59" type="laptopComputer" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="false">
<manufacturer>Acer</manufacturer>
<model>Chromebook 11</model>
<serialNumber>U89TRY765ME</serialNumber>
<dateOfPurchase>2016-04-23</dateOfPurchase>
<operatingSystem version="">Chrome OS</operatingSystem>
<tickets>
<ticket id="HWI046" issuedIn="2010-02-28" isHandled="false">
<description><![CDATA[Stripes on screen]]></description>
<solution><![CDATA[]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
</customers>
</pre>

= Link klientrakendusele ja API-le =
https://drive.google.com/file/d/1FU3XGGVHbn4BNNHAsOs7DQ4CzpEDwZUt/view?usp=sharing (nagu logidest näha lisasime selle lingi 08.06.2018, kuid siin on mõned üleliigsed kataloogid) 
https://drive.google.com/file/d/1A7cxeK15xlWSww_CPxpksSfj0m10qFQV/view?usp=sharing (09.06.2019 laadisime üles paki, kus on kustutatud kaks ebavajalikku kataloogi, mis võivad tekitada segadust)

== Palun loe seda "readme" asemel ==

1. meie rakenduse implementeeritud skoop lähtub siin lehel (ülal), analüüsi osas defineeritud "Minimum viable product" kriteeriumitest 
2. lase API käima, tee andmebaaside migratsioonid ja update-database 
3. implementeeritud on kõik teenused, mis on nähtaval Swaggeris aadressil: "localhost:[pordinumber]/Swagger" 
4. kliendirakendus asub kataloogis 'WatchWindersClient' ja tegemist on solutioniga, mille võiks käivitada teises Visual Studio aknas 
5. klientrakenduse käivitumiseks tuleks muuta App.config failis muuta ära localhost portide numbrid asendades need enda arvutis oleva localhost pordiga ning lisada kehtiv JWT AccessToken, mille saab Postmaniga aadressilt api/Security/getToken "Email" ja "Password" abil pärast seda kui kasutaja on loodud 
6. küsimuste ja raskuste korral kirjuta tiit.kuuskmae@gmail.com (API) ja toomas.juhkov@gmail.com (klient). Vastame esimesel võimalusel.

= Kasutatud kirjandus ja allikad =

1. Albahari, Joseph, Albari, Ben 2017. C# 7.0 in A Nutshell. Sebastopol: O’Reilly 
2. MariaDB Foundation. MariaDB. Kättesaadav:https://mariadb.org/ 
3. Martin, Robert 2018. Clean Architecture. Boston: Pearson Education

WatchWinders

2018-06-09T08:30:36Z

Tkuuskma: /* Link klientrakendusele ja API-le */

= Meeskond =

Toomas Juhkov, toomas.juhkov@gmail.com 
Tiit Kuuskmäe, tiit.kuuskmae@gmail.com 
Kunnar Kukk, Kunnar.kukk@gmail.com 

= Tegevuste logi =

08.02.2018 - meeskonna loomine, kokkuleppe sõlmimine teema osas 
10.02.2018 - õppejõu teavitamine koos esmase andmemudeliga 
15.02.2018 - lõpliku andmemudeli valmimine(versioon 5) 
18.02.2018 - õppejõu kinnitus, et teema ja meeskond kvalifiseeruvad 
22.02.2018 - viki lehe loomine ja analüüsi koostamise alustamine 
26.02.2018 - tiimi lisandus Kunnar Kukk 
01.03.2018 - tiimi sprint koosolek(seoses täiendava tiimiliikme lisandumisega täpsustasime skoopi) 
03.03.2018 - alustasime koodi kirjutamisega (tabelid klassideks ja annotatsioonid peale) 
06.03.2018 - täiendasime andmemudelit olemiga "UserTypeState" (et saaks muuta kasutajatüüpi) 
08.03.2018 - tiimi sprint koosolek 
18.03.2018 - lisasime olemid "Address", "AddressU", "AddressM", "OfferOfUser", "MediaInOffer" 
22.03.2018 - tiimi sprint koosolek, mis oli pühendatud andmemudeli täiendamisele 
23.03.2018 - pikem tiimi hackathon andmemudeli teemal 
29.03.2018 - täiendatud wiki lehte täielikult ringitöötatud andmemudeliga 
30.03.2018 - täiendatud wiki lehte andmemudeli metainfoga 
09.04.2018 - silusime andmemudelit (mõningad ebavajalikud viited olid sisse jäänud) 
06.05.2018 - panime uuendatud andmemudeli projekti wiki lehele üles 
07.05.2018 - osalesime õppejõu Mait Poska korraldatud hackathonil 
08.06.2018 - XML ülesanne, klientrakenduse ja API kood sai wiki lehel avalikuks 

Terve maikuu oli igapäevane suhtlus üle Skype'i ja fleep.io, mida me ei loginud (liiga tihedaks läks!).

= Kasutatavad metoodikad =

WatchWinders projektis plaanime kasutada peamiselt kaht metoodikat:

1. läbiv retsenseerimine (üks paariline teeb midagi valmis ja teine teeb sellele ülevaatuse; üksus lisatakse kui ülevaatus on lõplikult läbitud ning osapoolte vahel on saabunud konsensus) 
2. paaris programmeerimine (istume ühe masina taha maha ja kirjutame kolmekesi)

Tulenevalt kaugõppe formaadist saab ülekaalus olema esimene variant. Teist metoodikat kasutame nende osade kirjutamiseks, mille puhul võib arvata, et nende lahendamine on keeruline või et lahenduskäike võib olla väga erinevaid. Püüame jooksvalt siinses vikis kajastada ka seda, millise metoodika järgi üks või teine osa valmis.

= Projekti osad =

Alljärgnevalt anname ülevaate projekti osadest: 

(1) andmemudel 
(2) veebiteenuse analüüs 
(3) Minimum Viable Product definitsioon 
(4) Inkrement #1 
(5) Inkrement #2 
(6) Inkrement #3 

Projekti osad on meie viki lehel kirjeldatud valmimise järjekorras.

== Andmemudel ==

Andmemudeli koostamisel lähtusime õppejõu ette antud kriteeriumist, mille järgi andmemudelis on vähemalt 6 põhiolemit (tähistatud tumesinise ja lillaga - meie mudelis 11 tk),
mille hulgas ei sisaldu kasutajate tabelit (Person). 
 
Põhiolemid: 
* Watch - kell 
* Person - kasutaja/kollektsionäär või firma esindaja 
* Box - kellakarp 
* Organization - tootjad, edasimüüjad, hooldus 
* Settings - kellakarbi seade 
* Offer - pakkumine kollektsionäärile 
* Media - meediafailid kellade ja karpide kohta 
* Address - kasutaja/organisatsiooni aadress 
* ElectronicContact - elektrooniliste kontaktide loend 
* Log - logi 
* Access - paroolid ja kasutajanimed 
* Error - vead 
 
Type abiolemid: 
* WatchType - kellatüübid 
* PersonType - isikutüübid: admin, kasutaja 
* OrganizationType - organisatsioonitüübid: tootja, hooldaja, edasimüüja jt 
* ActionType - logi tüübid 
* ContactType - elektroonilise kontakti tüüp: skype, email, telefon jt 
 
Olekud: 
* PersonTypeState - isiku rolli kehtivus ajahetkel (isiku ja tüübi vaheline seos) 
* OrganizationTypeState - organisatsiooni olek(ud) ajahetkel 
 
Kuuluvus: 
* PersonWatch - isikute ja kellade vahelised seosed 
* PersonBox - isiku ja karbi vaheline seos 
* PersonAccess - isiku ja autentimisandmete vaheline seos 
* WatchInBox - kella ja karbi vaheline seos 
* ErrorInWatch - vea ja kella vaheline seos 
* SettingsInBox - seade ja karbi vaheline seos 
* WatchInOrganization - kella ja tootja vaheline seos 
* PersonInOrganization - isiku ja ettevõtte/organisatsiooni vaheline seos 
* SettingsOfWatchType - seade ja kellatüübi vaheline seos 
 
Abstraktsioonid: 
* Locator - abstraktsioon erinevate kontaktitüüpide jaoks 
* Party - abstraktsioon erinevate inimeste, organisatsioonide jt jaoks 
 
Kommunikatsioon: 
* OfferToPerson - isikule suunatud pakkumised 
* OfferFromPerson - isikult lähtuv pakkumine 
 
 
 
[[File:ww_andmemudel_06052018.png]]
 

Andmemudel valmis (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

== Veebiteenuse analüüs ==

Alljärgnevalt esitame kellakarpide infosüsteemi analüüsi järgmistes osades:

(1) toote/teenuse kirjeldus 
(2) probleemi kirjeldus 
(3) lahendus 
(4) süsteemi kasutajad 
(5) loodava API võimalused 
(6) funktsionaalsed nõuded 
(7) mittefunktsionaalsed nõuded 

=== Toote/teenuse kirjeldus ===
Teenuse eesmärgiks on lahendada probleem, kuidas jälgida kellakarpide kaudu mehhaaniliste käekellade seisundit ning keerata neid automaatselt üles distantsilt, näiteks juhul, kui kellade kollektsionäär ei asu füüsiliselt igapäevaselt oma kellade juures. Teenus võimaldab ka tootjal uuendada kontaktandmeid, saata personaalseid teateid. Administraatorile annab ülevaate platvormis toimuvast.

=== Probleemi kirjeldus ===
Mehhaaniliste käekellade kollektsionääride huvi kellakarpide vastu on mitmetahuline. Kollektsionääre huvitab arvepidamine – mitu kella, missuguste omaduste ja eripäradega neil kollektsioonis on. Teisalt soov eksponeerida oma kogusid kolleegidele ja sõpradele. Kellakarpidega täidetud sein või riiulid loovad selleks suurepärase võimaluse. Kolmandaks praktiline vajadus tagada kellavedrude õige vinnastatuse aste. Kaasaja mehhaanilised kellamehhanismid (''automatic'') võimaldavad kellakorpuse füüsilisel liigutamisel kellavedru automaatselt vinnastada.

Näiteks piisab kella kinnitamisest käele, et see hakkaks end käe liigutamisel üles keerama. Kuidas keerata aga üles seisvat kella, mis seisab paigal kellakarbis? Selleks on tänapäeva kellakarpides elektrimootor, mis tagab kella liigutamise vastavalt kellatüübile ettenähtud ööpäevase graafiku alusel. Kollektsionääride üheks probleemiks on see, kuidas juhtida sellist karpi ja omada jooksvat ülevaadet kõikidest oma karpidest, nende tehnilisest seadistusest ja kollektsiooni kuuluvatest kelladest olles tööreisil välisriigis?

=== Lahendus ===
Probleemi lahendamiseks ehitame REST + ASP.NET Core + WebAPI koos kliendiga, mis võimaldab kellakollektsionääridel hallata kellasid karpides, administraatoritel saada ülevaate süsteemist ning tootjatele lisada infot kollektsionääridele. Käesoleva projekti käigus '''ei tegeleta''' kahe IoT lahenduse kui terviku seisukohast olulise nüansiga: (i) karbi püsivara (''firmware'') loomisega, (ii) klientrakenduse ''frontend'' lõpliku häälestamisega (ilus .css ja pildid).

=== Süsteemi kasutajad ===
'''Kollektsionäär''' - haldab ja muudab infot oma kellade ning oma kellakarpide kohta. 
'''Administraator''' - haldab süsteemi infot, vajadusel eemaldab probleeme. 
'''Tootja''' - saab saata süsteemi kollektsionääridele mõeldud infot. 
'''Hooldaja''' - saab infot hooldamist vajavate kellade ja -karpide kohta. 

=== Loodava API võimalused ===
Alljärgnevalt vaatame loodava API võimalusi kasutajagruppide kaupa:

'''Kasutajale/kellakollektsionäärile'''
* Saada ülevaade kelladest ja kellakarpidest (lisada, muuta, vaadata).
* Muuta karbis oleva kella kohta käivat informatsiooni (kella nimi, tootja, tootmise aeg, viitenumber, mehhanism, jõureservi jääk (valikuline), foto kellast, kellarihma liik, muu).
* Karpe juhtida (keerata automaatselt üles). Näha ja muuta kella üleskeerava mehhanismi liikumise kiirust ja muid detaile (nt liikumise suund).
* Näha karbi seisundit, kas karp on hetkel wifiga ühendatud või mitte.
* Näha karbilt saabunud veateateid.
* Sisestada infot kella seisundist.
* Suhelda hooldajate ja tootjatega

'''Tootjale'''
* Uuendada kontaktandmeid.
* Saata personaalseid teateid kellakollektsionääridele.

'''Administraatorile'''
* Näha võrku ühendatud karpide arvu.
* Näha karpidesse paigaldatud kellade nimistut (ilma muude kasutajaandmeteta).
* Näha kellade üleskeeramise mehhanismide arvnäitajaid (madalaim kiirus, keskmine kiirus, tippkiirus; samuti liikumise suundade arvnäitajaid).
* IP-aadresside järgi ülevaadet, millistes riikides karpe kasutatakse (üldised arvandmed).
* Veateatega karpide arv süsteemis (üldised arvandmed).

=== Funktsionaalsed nõuded ===
* Kõik tegevused peavad olema autoriseeritud.
* REST + ASP.NET Core + WebAPI tagastab infot valideeritud JSON formaadis.
* API veatöötlus on tehtud, kasutades standardseid veakoode.
* API-le on tehtud 'health check'.
* Kõik kasutajad peavad saama end autoriseerida.
* Kasutaja, tootja ja administraatori tegevused logitakse.
* Logi ei ole muudetav, vaid on kättesaadav.
* Kasutaja ega tootja ei näe teiste kasutajate ega tootjate infot.
* API klient on kohanduv mobiilile, tahvlile ja desktoparvutile.
* Sisendandmed on valideeritud.

=== Mittefunktsionaalsed nõuded ===
* API-le on lisatud Swagger fail.
* Teenus ja tehniline lahendus on dokumenteeritud.
* Süsteemi kood on vabalt ligipääsetav, täiendatav ning allalaetav.

Esitame töö etappidena, kus kõigepealt defineerime ära Minimum Viable Producti [https://en.wikipedia.org/wiki/Minimum_viable_product] ehk selle miinimumi, mis pakub kasutajale maksimaalset väärtust. See tähendab API loomist ning esmase kliendi loomist kõigile MVP-s defineeritud kasutajagruppidele. Seejärel realiseerime projekti inkrementide ehk tootearenduse sammudena, milles lisame uusi funktsionaalsusi. Ideaalis jõuame realiseerida kõik sammud, kuid kuna teeme nimetatud tööd antud ajaraamis ja koosseisus esmakordselt, siis võtame vabaduse ka realiseerida korralikult niipalju, kui jõuame projekti käigus ära teha.

Võimalik, et meie lõpptulemus erineb mõnes osas esitatud analüüsist. Seda olenevalt sellest kui edukalt meil õnnestub plaanitud funktsionaalsusi realiseerida. Erisusi plaanime käsitleda vastavas 'post production' jaotuses, kus loendame ka projektist kogunenud peamised õppetunnid.

Analüüs valmis (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

== Minimum Viable Product definitsioon ==
'''Kasutaja'''
* Kasutaja saab süsteemi logida ning välja logida
* Kasutaja saab lisada uue kellakarbi
* Kasutaja saab lisada uue kella kellakarpi
* Kasutaja saab muuta kella infot kellakarbis
* Kasutaja saab näha ülevaadet oma karpidest
* Kasutaja saab muuta kellakarbi seadeid
* Kasutaja saab kustutada kella karbis
* Kasutaja saab kustutada kellakarbi

'''Administraator'''
* Näeb autoriseeritult logisid

'''Tootja'''
* Saab lisada kontaktandmeid
* Saab kontaktandmeid muuta

== Inkrement #1 ==
'''Kasutaja'''
* Näeb karbilt saabunud veateateid.
* Saab kellakarpe juhtida.

'''Administraator'''
* IP-aadresside järgi ülevaadet, millistes riikides karpe kasutatakse (üldised arvandmed).
* Karpidesse paigaldatud kellade nimistut (ilma muude kasutajaandmeteta).
* Näeb kasutajate statistikat.

'''Tootja'''
* Saata personaalseid teateid kellakollektsionääridele.

== Inkrement #2 ==
'''Kasutaja'''
* Saab saata teate tootjale.
* Näeb tootja vastust.
* Näha karbi seisundit, kas karp on hetkel wifiga ühendatud või mitte.

'''Administraator'''
* Näha kellade üleskeeramise mehhanismide arvnäitajaid (madalaim kiirus, keskmine kiirus, tippkiirus; samuti liikumise suundade arvnäitajaid).
* Näeb tegevuste ajalugu kliendist.

'''Tootja'''
* Saab lugeda kasutaja teadet.
* Saab vastata kasutajale.

'''Hooldaja'''
* Saab info hooldamist vajavate kellade kohta.

== Inkrement #3 ==
'''Kasutaja'''
* On ehitatud keeletugi.

'''Tootja'''
* On ehitatud keeletugi.

'''Hooldaja'''
* On ehitatud keeletugi.

Inkrementid valmisid (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

= XML ülesanne =
Järgnevalt esitame oma XML-ülesande tulemused.

== IT Management Transformation XML To XML ==
<pre>
<?xml version="1.0" encoding="utf-8"?>
<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">
<xsl:output method="xml" indent="yes"/>
<xsl:template match="/">
<unhandledDevices>
<xsl:for-each select="customers/customer/locations/location/items/item[@isInWorkingCondition='false']">
<device>
<name>
<xsl:value-of select="manufacturer"/>
<xsl:text> </xsl:text>
<xsl:value-of select="model"/>
</name>
<ticket>
<xsl:for-each select="tickets/ticket[@isHandled='false']">
<ticket_id>
<xsl:value-of select="@id"/>
</ticket_id>
<issued_in>
<xsl:value-of select="@issuedIn"/>
</issued_in>
<description>
<xsl:value-of select="description"/>
</description>
</xsl:for-each>
</ticket>
</device>
</xsl:for-each>
</unhandledDevices>
</xsl:template>
</xsl:stylesheet>
</pre>

== IT Management Transformation HTML ==

<pre>
<?xml version="1.0" encoding="utf-8"?>
<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">
<xsl:output method="html" indent="yes"/>
<xsl:template match="/">

<html>
<head>
<title>ItManagement Laptops</title>
</head>
<body style="background-color:#F7F7F7">
<h1>Computers</h1>
<xsl:for-each select="/customers/customer/locations/location/items/item[@type='laptopComputer']">
<xsl:sort select="@isActive='false'"/>
<hr />
<div>
<h3>
<xsl:value-of select="manufacturer"/>
</h3>
Model: 
<xsl:value-of select="model"/>
 
Serial number: 
<xsl:value-of select="serialNumber"/>
 
Date of purchase: 
<xsl:value-of select="dateOfPurchase"/>
 
Operating system: 
<xsl:value-of select="operatingSystem"/>
 
Is on active list: 
<xsl:value-of select="@isActive"/>
 
</div>

<div style="background-color:#E3FAEE" >

<xsl:for-each select="tickets/ticket">
<xsl:choose>
<xsl:when test="@isHandled='true'">
<h3>Handled tickets</h3>
<ul>
Issued in: 
<xsl:value-of select="@issuedIn"/>
 
Ticket ID: 
<xsl:value-of select="@id" />
 
Description: 
<xsl:value-of select="description"/>
 
Solution: 
<xsl:value-of select="solution"/>
 
</ul>
</xsl:when>
<xsl:when test="@isHandled='false'">
<div style="background-color:#FDE5E5">
<h3>Unhandled tickets</h3>
<ul>
Issued in: 
<xsl:value-of select="@issuedIn"/>
 
Ticket ID: 
<xsl:value-of select="@id" />
 
Description: 
<xsl:value-of select="description"/>
 
Solution: 
<xsl:value-of select="solution"/>
 
</ul>
</div>
</xsl:when>
</xsl:choose>
</xsl:for-each>

</div>
</xsl:for-each>
</body>
</html>
</xsl:template>
</xsl:stylesheet>
</pre>

== IT Management XSD ==

<pre>
<?xml version="1.0" encoding="utf-8"?>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="customers">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="customer">
<xs:complexType>
<xs:sequence>
<xs:element name="customerName" type="xs:string" />
<xs:element minOccurs="0" name="contactPerson" type="xs:string" />
<xs:element name="e-mail" type="xs:string" />
<xs:element name="phoneNumber" type="xs:string" />
<xs:element name="locations">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="location">
<xs:complexType>
<xs:sequence>
<xs:element name="city" type="xs:string" />
<xs:element name="address" type="xs:string" />
<xs:element name="comment" type="xs:string" />
<xs:element minOccurs="0" name="localContactPerson" type="xs:string" />
<xs:element minOccurs="0" name="localPhone" type="xs:string" />
<xs:element name="items">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="item">
<xs:complexType>
<xs:sequence>
<xs:element name="manufacturer" type="xs:string" />
<xs:element name="model" type="xs:string" />
<xs:element name="serialNumber" type="xs:string" />
<xs:element name="dateOfPurchase" type="xs:date" />
<xs:element minOccurs="0" name="operatingSystem">
<xs:complexType>
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute name="version" type="xs:string" use="required" />
</xs:extension>
</xs:simpleContent>
</xs:complexType>
</xs:element>
<xs:element minOccurs="0" name="tickets">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="ticket">
<xs:complexType>
<xs:sequence>
<xs:element name="description" type="xs:string" />
<xs:element name="solution" type="xs:string" />
</xs:sequence>
<xs:attribute name="id" type="xs:string" use="required" />
<xs:attribute name="issuedIn" type="xs:date" use="required" />
<xs:attribute name="isHandled" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:unsignedInt" use="required" />
<xs:attribute name="type" type="xs:string" use="required" />
<xs:attribute name="isActive" type="xs:boolean" use="required" />
<xs:attribute name="isUnderWarranty" type="xs:boolean" use="required" />
<xs:attribute name="warrantyInMonths" type="xs:unsignedByte" use="required" />
<xs:attribute name="isInWorkingCondition" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="type" type="xs:string" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:unsignedInt" use="required" />
<xs:attribute name="type" type="xs:string" use="required" />
<xs:attribute name="isActive" type="xs:boolean" use="required" />
<xs:attribute name="hasManyLocations" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
</pre>

== IT Management XML ==

<pre>
<?xml version="1.0" encoding="utf-8" ?>
<customers>
<customer id="33" type="company" isActive="true" hasManyLocations="true">
<customerName>Elamustevaba OÜ</customerName>
<contactPerson>Juhan Pühamees</contactPerson>
<e-mail>juhan@evaba.com</e-mail>
<phoneNumber>+37256565656</phoneNumber>
<locations>
<location type="office">
<city>Tallinn</city>
<address><![CDATA[Pikk 7, 56401]]></address>
<comment><![CDATA[3. korrus -> paremat kätt]]></comment>
<localContactPerson>Maiu Piimaauto</localContactPerson>
<localPhone>+3726510510</localPhone>
<items>
<item id="1" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="36" isInWorkingCondition="false">
<manufacturer>Dell</manufacturer>
<model>Inspiron 3558</model>
<serialNumber>6FGH5JN</serialNumber>
<dateOfPurchase>2017-07-22</dateOfPurchase>
<operatingSystem version="1709">Windows 10 Home</operatingSystem>
<tickets>
<ticket id="HWI001" issuedIn="2017-11-21" isHandled="true">
<description><![CDATA[Wi-Fi is not working]]></description>
<solution><![CDATA[Wi-Fi card replaced (Under the warranty)]]></solution>
</ticket>
<ticket id="SWI256" issuedIn="2018-05-05" isHandled="false">
<description><![CDATA[Computer keeps showing login screen]]></description>
<solution></solution>
</ticket>
</tickets>
</item>
<item id="55" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="60" isInWorkingCondition="true">
<manufacturer>Dell</manufacturer>
<model>Latitude E7550</model>
<serialNumber>8JGR78U</serialNumber>
<dateOfPurchase>2016-06-15</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Home</operatingSystem>
</item>
</items>
</location>
<location type="store">
<city>Tallinn</city>
<address><![CDATA[Lai 17, 56401]]></address>
<comment><![CDATA[keldrikorrusel]]></comment>
<localContactPerson>Tanja Õielemb</localContactPerson>
<localPhone>+3726510520</localPhone>
<items>
<item id="83" type="desktopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Lenovo</manufacturer>
<model>ThinkCentre M715</model>
<serialNumber>IO25689AD54KL</serialNumber>
<dateOfPurchase>2017-12-01</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Pro</operatingSystem>
</item>
<item id="12" type="monitor" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>AOC</manufacturer>
<model>L456</model>
<serialNumber>9803987YE54</serialNumber>
<dateOfPurchase>2015-05-03</dateOfPurchase>
<tickets>
<ticket id="HWI126" issuedIn="2016-01-18" isHandled="true">
<description><![CDATA[Doesn't work, no picture.]]></description>
<solution><![CDATA[Wasn't plugged in. Technician did it - works again!]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
<customer id="02" type="private" isActive="true" hasManyLocations="false">
<customerName>Kessu Sisselasi</customerName>
<e-mail>kessu@tripp.org</e-mail>
<phoneNumber>+372555555</phoneNumber>
<locations>
<location type="home">
<city>Saue</city>
<address><![CDATA[Kooli 4-8, 78965]]></address>
<comment><![CDATA[2. korrus. Kitsad koridorid.]]></comment>
<items>
<item id="98" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Acer</manufacturer>
<model>Aspire 5</model>
<serialNumber>475YRT89K4</serialNumber>
<dateOfPurchase>2018-03-25</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Home</operatingSystem>
</item>
<item id="4" type="laptopComputer" isActive="false" isUnderWarranty="false" warrantyInMonths="36" isInWorkingCondition="true">
<manufacturer>Lenovo</manufacturer>
<model>IdeaPad L530</model>
<serialNumber>U89TRY765ME</serialNumber>
<dateOfPurchase>2007-08-14</dateOfPurchase>
<operatingSystem version="">Windows XP</operatingSystem>
<tickets>
<ticket id="SWI069" issuedIn="2010-01-28" isHandled="true">
<description><![CDATA[Blue screen.]]></description>
<solution><![CDATA[Video driver update.]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
<customer id="26" type="company" isActive="true" hasManyLocations="true">
<customerName>Aktsiaselts OÜ</customerName>
<contactPerson>Gunnar Kuningas</contactPerson>
<e-mail>gunnar@kunn.ee</e-mail>
<phoneNumber>+3726985236</phoneNumber>
<locations>
<location type="office">
<city>Loksa</city>
<address><![CDATA[Kalda 14, 78965]]></address>
<comment><![CDATA[Sissepääs Rimi poolt, helesinine uks]]></comment>
<items>
<item id="26" type="laptopComputer" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Apple</manufacturer>
<model>Macbook Air</model>
<serialNumber>258JUY369</serialNumber>
<dateOfPurchase>2017-03-01</dateOfPurchase>
<operatingSystem version="High Sierra">OS X</operatingSystem>
</item>
<item id="59" type="laptopComputer" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="false">
<manufacturer>Acer</manufacturer>
<model>Chromebook 11</model>
<serialNumber>U89TRY765ME</serialNumber>
<dateOfPurchase>2016-04-23</dateOfPurchase>
<operatingSystem version="">Chrome OS</operatingSystem>
<tickets>
<ticket id="HWI046" issuedIn="2010-02-28" isHandled="false">
<description><![CDATA[Stripes on screen]]></description>
<solution><![CDATA[]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
</customers>
</pre>

= Link klientrakendusele ja API-le =
https://drive.google.com/file/d/1FU3XGGVHbn4BNNHAsOs7DQ4CzpEDwZUt/view?usp=sharing (nagu logidest näha lisasime selle lingi 08.06.2018, kuid siin on mõned üleliigsed kataloogid) 
https://drive.google.com/file/d/1N4JDyla7yNXmKTvi_WQxRamFQgHlQCi3/view?usp=sharing (09.06.2019 laadisime üles paki, kus on kustutatud kaks ebavajalikku kataloogi, mis võivad tekitada segadust)

== Palun loe seda "readme" asemel ==

1. meie rakenduse implementeeritud skoop lähtub siin lehel (ülal), analüüsi osas defineeritud "Minimum viable product" kriteeriumitest 
2. lase API käima, tee andmebaaside migratsioonid ja update-database 
3. implementeeritud on kõik teenused, mis on nähtaval Swaggeris aadressil: "localhost:[pordinumber]/Swagger" 
4. kliendirakendus asub kataloogis 'WatchWindersClient' ja tegemist on solutioniga, mille võiks käivitada teises Visual Studio aknas 
5. klientrakenduse käivitumiseks tuleks muuta App.config failis muuta ära localhost portide numbrid asendades need enda arvutis oleva localhost pordiga ning lisada kehtiv JWT AccessToken, mille saab Postmaniga aadressilt api/Security/getToken "Email" ja "Password" abil pärast seda kui kasutaja on loodud 
6. küsimuste ja raskuste korral kirjuta tiit.kuuskmae@gmail.com (API) ja toomas.juhkov@gmail.com (klient). Vastame esimesel võimalusel.

= Kasutatud kirjandus ja allikad =

1. Albahari, Joseph, Albari, Ben 2017. C# 7.0 in A Nutshell. Sebastopol: O’Reilly 
2. MariaDB Foundation. MariaDB. Kättesaadav:https://mariadb.org/ 
3. Martin, Robert 2018. Clean Architecture. Boston: Pearson Education

WatchWinders

2018-06-09T08:30:15Z

Tkuuskma:

= Meeskond =

Toomas Juhkov, toomas.juhkov@gmail.com 
Tiit Kuuskmäe, tiit.kuuskmae@gmail.com 
Kunnar Kukk, Kunnar.kukk@gmail.com 

= Tegevuste logi =

08.02.2018 - meeskonna loomine, kokkuleppe sõlmimine teema osas 
10.02.2018 - õppejõu teavitamine koos esmase andmemudeliga 
15.02.2018 - lõpliku andmemudeli valmimine(versioon 5) 
18.02.2018 - õppejõu kinnitus, et teema ja meeskond kvalifiseeruvad 
22.02.2018 - viki lehe loomine ja analüüsi koostamise alustamine 
26.02.2018 - tiimi lisandus Kunnar Kukk 
01.03.2018 - tiimi sprint koosolek(seoses täiendava tiimiliikme lisandumisega täpsustasime skoopi) 
03.03.2018 - alustasime koodi kirjutamisega (tabelid klassideks ja annotatsioonid peale) 
06.03.2018 - täiendasime andmemudelit olemiga "UserTypeState" (et saaks muuta kasutajatüüpi) 
08.03.2018 - tiimi sprint koosolek 
18.03.2018 - lisasime olemid "Address", "AddressU", "AddressM", "OfferOfUser", "MediaInOffer" 
22.03.2018 - tiimi sprint koosolek, mis oli pühendatud andmemudeli täiendamisele 
23.03.2018 - pikem tiimi hackathon andmemudeli teemal 
29.03.2018 - täiendatud wiki lehte täielikult ringitöötatud andmemudeliga 
30.03.2018 - täiendatud wiki lehte andmemudeli metainfoga 
09.04.2018 - silusime andmemudelit (mõningad ebavajalikud viited olid sisse jäänud) 
06.05.2018 - panime uuendatud andmemudeli projekti wiki lehele üles 
07.05.2018 - osalesime õppejõu Mait Poska korraldatud hackathonil 
08.06.2018 - XML ülesanne, klientrakenduse ja API kood sai wiki lehel avalikuks 

Terve maikuu oli igapäevane suhtlus üle Skype'i ja fleep.io, mida me ei loginud (liiga tihedaks läks!).

= Kasutatavad metoodikad =

WatchWinders projektis plaanime kasutada peamiselt kaht metoodikat:

1. läbiv retsenseerimine (üks paariline teeb midagi valmis ja teine teeb sellele ülevaatuse; üksus lisatakse kui ülevaatus on lõplikult läbitud ning osapoolte vahel on saabunud konsensus) 
2. paaris programmeerimine (istume ühe masina taha maha ja kirjutame kolmekesi)

Tulenevalt kaugõppe formaadist saab ülekaalus olema esimene variant. Teist metoodikat kasutame nende osade kirjutamiseks, mille puhul võib arvata, et nende lahendamine on keeruline või et lahenduskäike võib olla väga erinevaid. Püüame jooksvalt siinses vikis kajastada ka seda, millise metoodika järgi üks või teine osa valmis.

= Projekti osad =

Alljärgnevalt anname ülevaate projekti osadest: 

(1) andmemudel 
(2) veebiteenuse analüüs 
(3) Minimum Viable Product definitsioon 
(4) Inkrement #1 
(5) Inkrement #2 
(6) Inkrement #3 

Projekti osad on meie viki lehel kirjeldatud valmimise järjekorras.

== Andmemudel ==

Andmemudeli koostamisel lähtusime õppejõu ette antud kriteeriumist, mille järgi andmemudelis on vähemalt 6 põhiolemit (tähistatud tumesinise ja lillaga - meie mudelis 11 tk),
mille hulgas ei sisaldu kasutajate tabelit (Person). 
 
Põhiolemid: 
* Watch - kell 
* Person - kasutaja/kollektsionäär või firma esindaja 
* Box - kellakarp 
* Organization - tootjad, edasimüüjad, hooldus 
* Settings - kellakarbi seade 
* Offer - pakkumine kollektsionäärile 
* Media - meediafailid kellade ja karpide kohta 
* Address - kasutaja/organisatsiooni aadress 
* ElectronicContact - elektrooniliste kontaktide loend 
* Log - logi 
* Access - paroolid ja kasutajanimed 
* Error - vead 
 
Type abiolemid: 
* WatchType - kellatüübid 
* PersonType - isikutüübid: admin, kasutaja 
* OrganizationType - organisatsioonitüübid: tootja, hooldaja, edasimüüja jt 
* ActionType - logi tüübid 
* ContactType - elektroonilise kontakti tüüp: skype, email, telefon jt 
 
Olekud: 
* PersonTypeState - isiku rolli kehtivus ajahetkel (isiku ja tüübi vaheline seos) 
* OrganizationTypeState - organisatsiooni olek(ud) ajahetkel 
 
Kuuluvus: 
* PersonWatch - isikute ja kellade vahelised seosed 
* PersonBox - isiku ja karbi vaheline seos 
* PersonAccess - isiku ja autentimisandmete vaheline seos 
* WatchInBox - kella ja karbi vaheline seos 
* ErrorInWatch - vea ja kella vaheline seos 
* SettingsInBox - seade ja karbi vaheline seos 
* WatchInOrganization - kella ja tootja vaheline seos 
* PersonInOrganization - isiku ja ettevõtte/organisatsiooni vaheline seos 
* SettingsOfWatchType - seade ja kellatüübi vaheline seos 
 
Abstraktsioonid: 
* Locator - abstraktsioon erinevate kontaktitüüpide jaoks 
* Party - abstraktsioon erinevate inimeste, organisatsioonide jt jaoks 
 
Kommunikatsioon: 
* OfferToPerson - isikule suunatud pakkumised 
* OfferFromPerson - isikult lähtuv pakkumine 
 
 
 
[[File:ww_andmemudel_06052018.png]]
 

Andmemudel valmis (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

== Veebiteenuse analüüs ==

Alljärgnevalt esitame kellakarpide infosüsteemi analüüsi järgmistes osades:

(1) toote/teenuse kirjeldus 
(2) probleemi kirjeldus 
(3) lahendus 
(4) süsteemi kasutajad 
(5) loodava API võimalused 
(6) funktsionaalsed nõuded 
(7) mittefunktsionaalsed nõuded 

=== Toote/teenuse kirjeldus ===
Teenuse eesmärgiks on lahendada probleem, kuidas jälgida kellakarpide kaudu mehhaaniliste käekellade seisundit ning keerata neid automaatselt üles distantsilt, näiteks juhul, kui kellade kollektsionäär ei asu füüsiliselt igapäevaselt oma kellade juures. Teenus võimaldab ka tootjal uuendada kontaktandmeid, saata personaalseid teateid. Administraatorile annab ülevaate platvormis toimuvast.

=== Probleemi kirjeldus ===
Mehhaaniliste käekellade kollektsionääride huvi kellakarpide vastu on mitmetahuline. Kollektsionääre huvitab arvepidamine – mitu kella, missuguste omaduste ja eripäradega neil kollektsioonis on. Teisalt soov eksponeerida oma kogusid kolleegidele ja sõpradele. Kellakarpidega täidetud sein või riiulid loovad selleks suurepärase võimaluse. Kolmandaks praktiline vajadus tagada kellavedrude õige vinnastatuse aste. Kaasaja mehhaanilised kellamehhanismid (''automatic'') võimaldavad kellakorpuse füüsilisel liigutamisel kellavedru automaatselt vinnastada.

Näiteks piisab kella kinnitamisest käele, et see hakkaks end käe liigutamisel üles keerama. Kuidas keerata aga üles seisvat kella, mis seisab paigal kellakarbis? Selleks on tänapäeva kellakarpides elektrimootor, mis tagab kella liigutamise vastavalt kellatüübile ettenähtud ööpäevase graafiku alusel. Kollektsionääride üheks probleemiks on see, kuidas juhtida sellist karpi ja omada jooksvat ülevaadet kõikidest oma karpidest, nende tehnilisest seadistusest ja kollektsiooni kuuluvatest kelladest olles tööreisil välisriigis?

=== Lahendus ===
Probleemi lahendamiseks ehitame REST + ASP.NET Core + WebAPI koos kliendiga, mis võimaldab kellakollektsionääridel hallata kellasid karpides, administraatoritel saada ülevaate süsteemist ning tootjatele lisada infot kollektsionääridele. Käesoleva projekti käigus '''ei tegeleta''' kahe IoT lahenduse kui terviku seisukohast olulise nüansiga: (i) karbi püsivara (''firmware'') loomisega, (ii) klientrakenduse ''frontend'' lõpliku häälestamisega (ilus .css ja pildid).

=== Süsteemi kasutajad ===
'''Kollektsionäär''' - haldab ja muudab infot oma kellade ning oma kellakarpide kohta. 
'''Administraator''' - haldab süsteemi infot, vajadusel eemaldab probleeme. 
'''Tootja''' - saab saata süsteemi kollektsionääridele mõeldud infot. 
'''Hooldaja''' - saab infot hooldamist vajavate kellade ja -karpide kohta. 

=== Loodava API võimalused ===
Alljärgnevalt vaatame loodava API võimalusi kasutajagruppide kaupa:

'''Kasutajale/kellakollektsionäärile'''
* Saada ülevaade kelladest ja kellakarpidest (lisada, muuta, vaadata).
* Muuta karbis oleva kella kohta käivat informatsiooni (kella nimi, tootja, tootmise aeg, viitenumber, mehhanism, jõureservi jääk (valikuline), foto kellast, kellarihma liik, muu).
* Karpe juhtida (keerata automaatselt üles). Näha ja muuta kella üleskeerava mehhanismi liikumise kiirust ja muid detaile (nt liikumise suund).
* Näha karbi seisundit, kas karp on hetkel wifiga ühendatud või mitte.
* Näha karbilt saabunud veateateid.
* Sisestada infot kella seisundist.
* Suhelda hooldajate ja tootjatega

'''Tootjale'''
* Uuendada kontaktandmeid.
* Saata personaalseid teateid kellakollektsionääridele.

'''Administraatorile'''
* Näha võrku ühendatud karpide arvu.
* Näha karpidesse paigaldatud kellade nimistut (ilma muude kasutajaandmeteta).
* Näha kellade üleskeeramise mehhanismide arvnäitajaid (madalaim kiirus, keskmine kiirus, tippkiirus; samuti liikumise suundade arvnäitajaid).
* IP-aadresside järgi ülevaadet, millistes riikides karpe kasutatakse (üldised arvandmed).
* Veateatega karpide arv süsteemis (üldised arvandmed).

=== Funktsionaalsed nõuded ===
* Kõik tegevused peavad olema autoriseeritud.
* REST + ASP.NET Core + WebAPI tagastab infot valideeritud JSON formaadis.
* API veatöötlus on tehtud, kasutades standardseid veakoode.
* API-le on tehtud 'health check'.
* Kõik kasutajad peavad saama end autoriseerida.
* Kasutaja, tootja ja administraatori tegevused logitakse.
* Logi ei ole muudetav, vaid on kättesaadav.
* Kasutaja ega tootja ei näe teiste kasutajate ega tootjate infot.
* API klient on kohanduv mobiilile, tahvlile ja desktoparvutile.
* Sisendandmed on valideeritud.

=== Mittefunktsionaalsed nõuded ===
* API-le on lisatud Swagger fail.
* Teenus ja tehniline lahendus on dokumenteeritud.
* Süsteemi kood on vabalt ligipääsetav, täiendatav ning allalaetav.

Esitame töö etappidena, kus kõigepealt defineerime ära Minimum Viable Producti [https://en.wikipedia.org/wiki/Minimum_viable_product] ehk selle miinimumi, mis pakub kasutajale maksimaalset väärtust. See tähendab API loomist ning esmase kliendi loomist kõigile MVP-s defineeritud kasutajagruppidele. Seejärel realiseerime projekti inkrementide ehk tootearenduse sammudena, milles lisame uusi funktsionaalsusi. Ideaalis jõuame realiseerida kõik sammud, kuid kuna teeme nimetatud tööd antud ajaraamis ja koosseisus esmakordselt, siis võtame vabaduse ka realiseerida korralikult niipalju, kui jõuame projekti käigus ära teha.

Võimalik, et meie lõpptulemus erineb mõnes osas esitatud analüüsist. Seda olenevalt sellest kui edukalt meil õnnestub plaanitud funktsionaalsusi realiseerida. Erisusi plaanime käsitleda vastavas 'post production' jaotuses, kus loendame ka projektist kogunenud peamised õppetunnid.

Analüüs valmis (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

== Minimum Viable Product definitsioon ==
'''Kasutaja'''
* Kasutaja saab süsteemi logida ning välja logida
* Kasutaja saab lisada uue kellakarbi
* Kasutaja saab lisada uue kella kellakarpi
* Kasutaja saab muuta kella infot kellakarbis
* Kasutaja saab näha ülevaadet oma karpidest
* Kasutaja saab muuta kellakarbi seadeid
* Kasutaja saab kustutada kella karbis
* Kasutaja saab kustutada kellakarbi

'''Administraator'''
* Näeb autoriseeritult logisid

'''Tootja'''
* Saab lisada kontaktandmeid
* Saab kontaktandmeid muuta

== Inkrement #1 ==
'''Kasutaja'''
* Näeb karbilt saabunud veateateid.
* Saab kellakarpe juhtida.

'''Administraator'''
* IP-aadresside järgi ülevaadet, millistes riikides karpe kasutatakse (üldised arvandmed).
* Karpidesse paigaldatud kellade nimistut (ilma muude kasutajaandmeteta).
* Näeb kasutajate statistikat.

'''Tootja'''
* Saata personaalseid teateid kellakollektsionääridele.

== Inkrement #2 ==
'''Kasutaja'''
* Saab saata teate tootjale.
* Näeb tootja vastust.
* Näha karbi seisundit, kas karp on hetkel wifiga ühendatud või mitte.

'''Administraator'''
* Näha kellade üleskeeramise mehhanismide arvnäitajaid (madalaim kiirus, keskmine kiirus, tippkiirus; samuti liikumise suundade arvnäitajaid).
* Näeb tegevuste ajalugu kliendist.

'''Tootja'''
* Saab lugeda kasutaja teadet.
* Saab vastata kasutajale.

'''Hooldaja'''
* Saab info hooldamist vajavate kellade kohta.

== Inkrement #3 ==
'''Kasutaja'''
* On ehitatud keeletugi.

'''Tootja'''
* On ehitatud keeletugi.

'''Hooldaja'''
* On ehitatud keeletugi.

Inkrementid valmisid (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

= XML ülesanne =
Järgnevalt esitame oma XML-ülesande tulemused.

== IT Management Transformation XML To XML ==
<pre>
<?xml version="1.0" encoding="utf-8"?>
<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">
<xsl:output method="xml" indent="yes"/>
<xsl:template match="/">
<unhandledDevices>
<xsl:for-each select="customers/customer/locations/location/items/item[@isInWorkingCondition='false']">
<device>
<name>
<xsl:value-of select="manufacturer"/>
<xsl:text> </xsl:text>
<xsl:value-of select="model"/>
</name>
<ticket>
<xsl:for-each select="tickets/ticket[@isHandled='false']">
<ticket_id>
<xsl:value-of select="@id"/>
</ticket_id>
<issued_in>
<xsl:value-of select="@issuedIn"/>
</issued_in>
<description>
<xsl:value-of select="description"/>
</description>
</xsl:for-each>
</ticket>
</device>
</xsl:for-each>
</unhandledDevices>
</xsl:template>
</xsl:stylesheet>
</pre>

== IT Management Transformation HTML ==

<pre>
<?xml version="1.0" encoding="utf-8"?>
<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">
<xsl:output method="html" indent="yes"/>
<xsl:template match="/">

<html>
<head>
<title>ItManagement Laptops</title>
</head>
<body style="background-color:#F7F7F7">
<h1>Computers</h1>
<xsl:for-each select="/customers/customer/locations/location/items/item[@type='laptopComputer']">
<xsl:sort select="@isActive='false'"/>
<hr />
<div>
<h3>
<xsl:value-of select="manufacturer"/>
</h3>
Model: 
<xsl:value-of select="model"/>
 
Serial number: 
<xsl:value-of select="serialNumber"/>
 
Date of purchase: 
<xsl:value-of select="dateOfPurchase"/>
 
Operating system: 
<xsl:value-of select="operatingSystem"/>
 
Is on active list: 
<xsl:value-of select="@isActive"/>
 
</div>

<div style="background-color:#E3FAEE" >

<xsl:for-each select="tickets/ticket">
<xsl:choose>
<xsl:when test="@isHandled='true'">
<h3>Handled tickets</h3>
<ul>
Issued in: 
<xsl:value-of select="@issuedIn"/>
 
Ticket ID: 
<xsl:value-of select="@id" />
 
Description: 
<xsl:value-of select="description"/>
 
Solution: 
<xsl:value-of select="solution"/>
 
</ul>
</xsl:when>
<xsl:when test="@isHandled='false'">
<div style="background-color:#FDE5E5">
<h3>Unhandled tickets</h3>
<ul>
Issued in: 
<xsl:value-of select="@issuedIn"/>
 
Ticket ID: 
<xsl:value-of select="@id" />
 
Description: 
<xsl:value-of select="description"/>
 
Solution: 
<xsl:value-of select="solution"/>
 
</ul>
</div>
</xsl:when>
</xsl:choose>
</xsl:for-each>

</div>
</xsl:for-each>
</body>
</html>
</xsl:template>
</xsl:stylesheet>
</pre>

== IT Management XSD ==

<pre>
<?xml version="1.0" encoding="utf-8"?>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="customers">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="customer">
<xs:complexType>
<xs:sequence>
<xs:element name="customerName" type="xs:string" />
<xs:element minOccurs="0" name="contactPerson" type="xs:string" />
<xs:element name="e-mail" type="xs:string" />
<xs:element name="phoneNumber" type="xs:string" />
<xs:element name="locations">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="location">
<xs:complexType>
<xs:sequence>
<xs:element name="city" type="xs:string" />
<xs:element name="address" type="xs:string" />
<xs:element name="comment" type="xs:string" />
<xs:element minOccurs="0" name="localContactPerson" type="xs:string" />
<xs:element minOccurs="0" name="localPhone" type="xs:string" />
<xs:element name="items">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="item">
<xs:complexType>
<xs:sequence>
<xs:element name="manufacturer" type="xs:string" />
<xs:element name="model" type="xs:string" />
<xs:element name="serialNumber" type="xs:string" />
<xs:element name="dateOfPurchase" type="xs:date" />
<xs:element minOccurs="0" name="operatingSystem">
<xs:complexType>
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute name="version" type="xs:string" use="required" />
</xs:extension>
</xs:simpleContent>
</xs:complexType>
</xs:element>
<xs:element minOccurs="0" name="tickets">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="ticket">
<xs:complexType>
<xs:sequence>
<xs:element name="description" type="xs:string" />
<xs:element name="solution" type="xs:string" />
</xs:sequence>
<xs:attribute name="id" type="xs:string" use="required" />
<xs:attribute name="issuedIn" type="xs:date" use="required" />
<xs:attribute name="isHandled" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:unsignedInt" use="required" />
<xs:attribute name="type" type="xs:string" use="required" />
<xs:attribute name="isActive" type="xs:boolean" use="required" />
<xs:attribute name="isUnderWarranty" type="xs:boolean" use="required" />
<xs:attribute name="warrantyInMonths" type="xs:unsignedByte" use="required" />
<xs:attribute name="isInWorkingCondition" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="type" type="xs:string" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:unsignedInt" use="required" />
<xs:attribute name="type" type="xs:string" use="required" />
<xs:attribute name="isActive" type="xs:boolean" use="required" />
<xs:attribute name="hasManyLocations" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
</pre>

== IT Management XML ==

<pre>
<?xml version="1.0" encoding="utf-8" ?>
<customers>
<customer id="33" type="company" isActive="true" hasManyLocations="true">
<customerName>Elamustevaba OÜ</customerName>
<contactPerson>Juhan Pühamees</contactPerson>
<e-mail>juhan@evaba.com</e-mail>
<phoneNumber>+37256565656</phoneNumber>
<locations>
<location type="office">
<city>Tallinn</city>
<address><![CDATA[Pikk 7, 56401]]></address>
<comment><![CDATA[3. korrus -> paremat kätt]]></comment>
<localContactPerson>Maiu Piimaauto</localContactPerson>
<localPhone>+3726510510</localPhone>
<items>
<item id="1" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="36" isInWorkingCondition="false">
<manufacturer>Dell</manufacturer>
<model>Inspiron 3558</model>
<serialNumber>6FGH5JN</serialNumber>
<dateOfPurchase>2017-07-22</dateOfPurchase>
<operatingSystem version="1709">Windows 10 Home</operatingSystem>
<tickets>
<ticket id="HWI001" issuedIn="2017-11-21" isHandled="true">
<description><![CDATA[Wi-Fi is not working]]></description>
<solution><![CDATA[Wi-Fi card replaced (Under the warranty)]]></solution>
</ticket>
<ticket id="SWI256" issuedIn="2018-05-05" isHandled="false">
<description><![CDATA[Computer keeps showing login screen]]></description>
<solution></solution>
</ticket>
</tickets>
</item>
<item id="55" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="60" isInWorkingCondition="true">
<manufacturer>Dell</manufacturer>
<model>Latitude E7550</model>
<serialNumber>8JGR78U</serialNumber>
<dateOfPurchase>2016-06-15</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Home</operatingSystem>
</item>
</items>
</location>
<location type="store">
<city>Tallinn</city>
<address><![CDATA[Lai 17, 56401]]></address>
<comment><![CDATA[keldrikorrusel]]></comment>
<localContactPerson>Tanja Õielemb</localContactPerson>
<localPhone>+3726510520</localPhone>
<items>
<item id="83" type="desktopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Lenovo</manufacturer>
<model>ThinkCentre M715</model>
<serialNumber>IO25689AD54KL</serialNumber>
<dateOfPurchase>2017-12-01</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Pro</operatingSystem>
</item>
<item id="12" type="monitor" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>AOC</manufacturer>
<model>L456</model>
<serialNumber>9803987YE54</serialNumber>
<dateOfPurchase>2015-05-03</dateOfPurchase>
<tickets>
<ticket id="HWI126" issuedIn="2016-01-18" isHandled="true">
<description><![CDATA[Doesn't work, no picture.]]></description>
<solution><![CDATA[Wasn't plugged in. Technician did it - works again!]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
<customer id="02" type="private" isActive="true" hasManyLocations="false">
<customerName>Kessu Sisselasi</customerName>
<e-mail>kessu@tripp.org</e-mail>
<phoneNumber>+372555555</phoneNumber>
<locations>
<location type="home">
<city>Saue</city>
<address><![CDATA[Kooli 4-8, 78965]]></address>
<comment><![CDATA[2. korrus. Kitsad koridorid.]]></comment>
<items>
<item id="98" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Acer</manufacturer>
<model>Aspire 5</model>
<serialNumber>475YRT89K4</serialNumber>
<dateOfPurchase>2018-03-25</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Home</operatingSystem>
</item>
<item id="4" type="laptopComputer" isActive="false" isUnderWarranty="false" warrantyInMonths="36" isInWorkingCondition="true">
<manufacturer>Lenovo</manufacturer>
<model>IdeaPad L530</model>
<serialNumber>U89TRY765ME</serialNumber>
<dateOfPurchase>2007-08-14</dateOfPurchase>
<operatingSystem version="">Windows XP</operatingSystem>
<tickets>
<ticket id="SWI069" issuedIn="2010-01-28" isHandled="true">
<description><![CDATA[Blue screen.]]></description>
<solution><![CDATA[Video driver update.]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
<customer id="26" type="company" isActive="true" hasManyLocations="true">
<customerName>Aktsiaselts OÜ</customerName>
<contactPerson>Gunnar Kuningas</contactPerson>
<e-mail>gunnar@kunn.ee</e-mail>
<phoneNumber>+3726985236</phoneNumber>
<locations>
<location type="office">
<city>Loksa</city>
<address><![CDATA[Kalda 14, 78965]]></address>
<comment><![CDATA[Sissepääs Rimi poolt, helesinine uks]]></comment>
<items>
<item id="26" type="laptopComputer" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Apple</manufacturer>
<model>Macbook Air</model>
<serialNumber>258JUY369</serialNumber>
<dateOfPurchase>2017-03-01</dateOfPurchase>
<operatingSystem version="High Sierra">OS X</operatingSystem>
</item>
<item id="59" type="laptopComputer" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="false">
<manufacturer>Acer</manufacturer>
<model>Chromebook 11</model>
<serialNumber>U89TRY765ME</serialNumber>
<dateOfPurchase>2016-04-23</dateOfPurchase>
<operatingSystem version="">Chrome OS</operatingSystem>
<tickets>
<ticket id="HWI046" issuedIn="2010-02-28" isHandled="false">
<description><![CDATA[Stripes on screen]]></description>
<solution><![CDATA[]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
</customers>
</pre>

= Link klientrakendusele ja API-le =
https://drive.google.com/file/d/1FU3XGGVHbn4BNNHAsOs7DQ4CzpEDwZUt/view?usp=sharing (nagu logidest näha lisasime selle lingi 08.06.2018, kuid siin on mõned üleliigsed kataloogid)
https://drive.google.com/file/d/1N4JDyla7yNXmKTvi_WQxRamFQgHlQCi3/view?usp=sharing (09.06.2019 laadisime üles paki, kus on kustutatud kaks ebavajalikku kataloogi, mis võivad tekitada segadust)

== Palun loe seda "readme" asemel ==

1. meie rakenduse implementeeritud skoop lähtub siin lehel (ülal), analüüsi osas defineeritud "Minimum viable product" kriteeriumitest 
2. lase API käima, tee andmebaaside migratsioonid ja update-database 
3. implementeeritud on kõik teenused, mis on nähtaval Swaggeris aadressil: "localhost:[pordinumber]/Swagger" 
4. kliendirakendus asub kataloogis 'WatchWindersClient' ja tegemist on solutioniga, mille võiks käivitada teises Visual Studio aknas 
5. klientrakenduse käivitumiseks tuleks muuta App.config failis muuta ära localhost portide numbrid asendades need enda arvutis oleva localhost pordiga ning lisada kehtiv JWT AccessToken, mille saab Postmaniga aadressilt api/Security/getToken "Email" ja "Password" abil pärast seda kui kasutaja on loodud 
6. küsimuste ja raskuste korral kirjuta tiit.kuuskmae@gmail.com (API) ja toomas.juhkov@gmail.com (klient). Vastame esimesel võimalusel.

= Kasutatud kirjandus ja allikad =

1. Albahari, Joseph, Albari, Ben 2017. C# 7.0 in A Nutshell. Sebastopol: O’Reilly 
2. MariaDB Foundation. MariaDB. Kättesaadav:https://mariadb.org/ 
3. Martin, Robert 2018. Clean Architecture. Boston: Pearson Education

Kodutöö aines "Võrgurakendused II: hajussüsteemide ehitamine" 2018

2018-06-09T08:00:39Z

Tkuuskma: /* Meeskond: WatchWinders */

[[Category: Võrgurakendused II: hajussüsteemide ehitamine]]
__NOINDEX__

=Kodutöö aines "Võrgurakendused II: hajussüsteemide ehitamine" 2018=
==Eesmärk==
Saada praktiline kogemus hajussüsteemide ehitamisest XML(SOAP) või Rest veebiteenusel ja sellele klientrakenduse loomise abil ning süvendada meeskonnatööoskust.
*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.
*REST teenuste loomisel tuleks kasutada ASP.NET Web API2/ASP.NET Core 2.0/WCF võimalusi.

Kaugem eesmärk on loomulikult hinne :).

==Reeglid==
''' Kodutöö koosneb kolmest eraldiseisvast ülesandest:'''
* 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)
* Luua veebiteenus, mis võimaldaks pakkuda teenust, eristada kasutajaid ning näidata teenuse kasutamise statistikat kasutajate ja tegevuste lõikes
* Luua klientrakendus

Ü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.

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.

==Tähtajad==

* '''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]
** 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>'''
** Veebiteenus peab olema valmis, esitatud ja ja wikilehel kirjeldatud hiljemalt '''27. mai 2018'''.
** Retsensioonid veebiteenuste kohta peavad tehtud olema '''03. juuni 2018'''.

* '''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]
** Klientrakendused peavad olema valmis, esitatud ja ja wikilehel kirjeldatud hiljemalt '''27. mai 2018'''.
** Retsensioonid klientrakenduste kohta peavad tehtud olema '''03. juuni 2018'''.

* '''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]
** XML fail, stiilifail ja skeemifail peavad olema valmis ja wikilehel kirjeldatud hiljemalt '''01. juuni 2018'''.
** Retsensioonid XML-failide kohta peavad tehtud olema '''05.juuni 2018'''.

==Hindamine==
===Üldised kriteeriumid===

Teostatuks loetakse projekt juhul, kui lähteülesanne on realiseeritud, lahendus on töötav, kuid esineb suuremaid vigu ning piirsituatsioonidega ei ole arvestatud.

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.

'''Maksimumtulemuse annab (vähemalt 4/7):'''

* Majanduslik mõtlemine (kas loodav teenus ja rakendused oleks kasutatav ka ärilistel eesmärkidel)
* Mobiilirakendused/Angularis/reactis loodud klientrakendus
* Kogukondade kaasamine
* Kasutajamugavus
* Läbimõeldud töökorraldus
* Lisavõimaluste realiseerimine (vt näidisteemad)
* Korraliku arhitektuuriga kirjutatud kood

===XML andmefail===
Ü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.

XML-il peab olema vähemalt 4 loogilist dimensiooni.
<dim1>
<dim2>
<dim3>
<dim4>
</dim4>
</dim3>
</dim2>
</dim1>
Lisaks tuleb kasutada 3-el dimensioonil attribuute, mis one enamat, kui lihtsalt ID.

===Veebiteenus===
Loodav veebiteenus peab võimaldama:
* Teenuse pakkumist
* '''Teenuse kasutajate tuvastamist ning haldamist'''
* Teenuse kasutajate ja kasutusstatistika üle arve pidamist kasutajate lõikes
* Teenuse poole pöördumiste arvu piiramist ja piirangute haldamist.

Loodav veebiteenus peab toetama mitme kasutaja võimalust.

Loodav veebiteenus tuleb luua kasutades ''Windows Communication Foundation'' või ASP.NET MVC Web API tehnoloogiat

Andmebaasis peab olema vähemalt 9 olemit ehk andmebaas on eeldus,

Soovitav on luua teenus (FE) ja teenuse seadistamiseks ning kasutajate haldamiseks mõeldud rakendus (BE).

===Klientrakendus===
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)

Variant1: teha klientrakendus enda loodud veebiteenusele

Variant2: teha klientrakendus mõnele levinud veebiteenusele.
Näiteks:
* http://www.bing.com/developer
* http://www.flickr.com/services/api/response.soap.html
* http://developer.ebay.com/developercenter/windows/
* http://apiwiki.twitter.com/Getting-Started

===Retsensioonid===
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.

Retsensioon peab sisaldama minimaalselt...
* XML - ...200 sõna.
* Veebiteenus - ...600 sõna.
* Klientrakendus - ...600 sõna.

Mõnelauselisest arvamusest ei piisa, kuna tegemist on grupi loodavate arvustustega, mitte individuaalsete arvustustega.

==Konsultatsioonid==
Igal projektimeeskonnal on piiramatu õigus saada õppejõu käest konsultatsiooni ja juhendamist oma
töö tegemiseks, kas harjutuste ajal või pärast harjutusi ja loenguid. Eriaegade suhtes saab sõlmida
õppejõuga kokkuleppeid kontaktidel
mait.poska [ät] itcollege.ee või (+372 53 469 734)
(teksti originaalautor Priit Raspel)

==Kaitsmisele registreerumine==
Kaitsmisele tuleks registreerida järjest(st iga järgmine lisab vajaliku 15min ajaakna) ja suvalisis kellaaegasid ei hakka kuhugi vahele kirjutama

'''05.06.2018'''
*15:00 - Miisiks
*15:15 - Maagikud
*15:30 - GoFood
*15:45 - Raavo V2™
*16:00 - LearnToDrive
Sellele päevale rohkem aegu juurde lisada ei saa

Allpool olevate päevadele võib vabalt aegasid juurde lisada 15min sammga. Reegel on, et aegu lisame järjest

'''06.06.2018'''
*17:00 - Raamaturiiul
*17:15 - Pakiraam
*..

'''09.06.2018'''
*16:00 - MealPlannerSolo(Triin Oja)
*16:15 - Beer Pressure
*16:30 - <div>
*16:45 - NutriCheck
*17:00 - JääTuli
*17:15 - Ophelia
*17:30 - Kuldne Loojang
*17:45 - Hammas
*18:00 - VariousArtists
*18:15 - Pillar Of Autumn
*18:30 - Curry
*18:45 - WatchWinders
*19:00 - MOT

=Teemad 2018 kevad=
''' Kodutöö koosneb kolmest eraldiseisvast ülesandest:'''
* 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)
* Luua veebiteenus, mis võimaldaks pakkuda teenust, eristada kasutajaid ning näidata teenuse kasutamise statistikat kasutajate ja tegevuste lõikes
* Luua klientrakendus mõnele olemasolevale või endaloodud veebiteenusele

NB! XML andmefail ja veebiteenus ei pea olema omavahel seotud.

==Näidisteemad==

====Ülesanne====
Luua sobiva alguse järgi nimede pakkumise teenus:
* alates kahetähelisetest algustest pakkuda sobivad nimesid
* luua võimalus kasutajatel nimesid lisada
* luua võimalus administraatoril nimesid muuta/kustutada
* meeste ja naiste nimed peavad olema süsteemis eristatavad
* luua võimalus, mis võimaldab kuvada populaarseid nimesid
* luua võimalus ühele kasutajale (või erinevatele kasutajagruppidele) maksimumpäringute hulga määramiseks
* luua võimalus, et nimi lisatakse baasi alles siis, kui administraatori õigustega inimene on selleks vastava loa andnud

===Külastusstatistika teenus===
Mõte selles, et pakkuda teenust, kus kasutajal on võimalik registreerida külastused ning küsida oma külastusstatistikat.

====Ülesanne====
Luua külastusstatistika teenus:
* kasutaja saab teenuses registreerida külastusi
* kasutaja saab küsida külastusstatistikat päevade/kuude/kogu perioodi lõikes
* luua võimalus ühele kasutajale (või erinevatele kasutajagruppidele) maksimumpäringute hulga määramiseks

Lisavõimalused:
* luua võimalus registreerida alamlehtede külastusstatistikat
* luua võimalus külastusstatistikale lisaparameetrite lisamiseks (ip aadress, sirviku versioon jne)

===Telefoniraamatu teenus===
Mõte selles, et kasutaja saab teenuse abil salvestada kontakte ja nende seast otsida

====Ülesanne====
Luua telefoniraamatu teenus:
* kasutaja saab teenuses kontakte lisada ja kustutada
* kasutaja saab kontaktide nime/telefoninumbri jne abil otsida
* luua võimalus ühele kasutajale (või erinevatele kasutajagruppidele) maksimumpäringute hulga määramiseks
* kasutajaid on võimalik lisada gruppidesse
* kasutajal on võimalik lisada vajalike kontaktandmete liike
* kasutajatel on võimalik jagada omavahel kontakte ja kontaktide grupper

===RSS voogude kogumise ja uudiste kuvamise teenus===
Mõte selles, et kasutaja saab teenuse abil salvestada talle huvipakkuvaid RSS vooge ja nendelt voogudelt uudiseid lugeda

====Ülesanne====
Luua RSS voogude haldusteenus:
* kasutaja saab teenuses RSS vooge lisada ja kustudada
* kasutaja saab pärida talle huvipakkuvate voogude viimaseid uudiseid
* luua võimalus ühele kasutajale (või erinevatele kasutajagruppidele) maksimumpäringute hulga määramiseks
* kasutaja saab RSS vooge vaadata eraldi või grupeeritult
* vooge peab puhverdama, kuna voogude lugemine võtab enamasti üsna palju aega
*

= Meeskonnad 2018=
==Päevaõpe==

===[https://wiki.itcollege.ee/index.php/HairSaloon Meeskond: HairSaloon]===
Liikmed:
* Kaido Henrik Elias
* Arvo Paomees

===[https://wiki.itcollege.ee/index.php/VariousArtists Meeskond: VariousArtists]===
Liikmed:
* Ruudi Vinter
* Madis Roosioks
* Pavel Fleišer

===[https://wiki.itcollege.ee/index.php/Maagikud Meeskond: Maagikud]===
Liikmed:
*Kristina Rästas
*Simo Jaanus
*Artur Tammiste
*Rauno Lõhmus
Lõpptoote [http://enos.itcollege.ee/~sjaanus/c/Airport_solution.zip link]

Veebiteenuse ja klientrakenduse retsensioon tiimile Raavo V2 asub [https://docs.google.com/document/d/1fxmdLa94Do1u5WlmPQjSd4mMmdbDw5WmDne547jqQc4/edit siin]

XML retsensioon tiimile LTD asub [https://docs.google.com/document/d/15rMhpqyG5XHsvOCZJp88ucHkiMa5Non6BbYwBBKT2_Y/edit siin]

===[https://wiki.itcollege.ee/index.php/RaamatuRiiul Meeskond: RaamatuRiiul]===
Liikmed:
* Alo Avi
* Arnika Rästa
* Marite Rammo
'''Meie XML:''' [https://wiki.itcollege.ee/index.php/RaamatuRiiul#XML XML]

'''Meie veebiteenuse, klientrakenduse ja XML retsensioonid meeskonnale Miisiiks:''' [https://wiki.itcollege.ee/index.php/Talk:Miisiiks retsensioonid]

'''Meie veebiteenus ning klientrakendus.''' [https://www.dropbox.com/s/ugbvx4j4zdlbp68/RaamatuRiiul.7z?dl=0 Zip]

===[https://wiki.itcollege.ee/index.php/Autolugu Meeskond: Autolugu]===
Liikmed:
* Margus Põlma
* Karl Erik Õunapuu

===[https://wiki.itcollege.ee/index.php/VRII2018 Meeskond: VRII2018]===
Liikmed:
* Kaspar Kaal
* Teet Adamson
* Rahel Kangur

===[https://wiki.itcollege.ee/index.php/Meeskond_Raavo_V2%E2%84%A2 Meeskond: Raavo V2™]===
Liikmed:
* Peeter Fridolin
* Kristo Leesmann
* Rando Rommot

Projekti retsensioon meeskonnale [https://wiki.itcollege.ee/index.php/Meeskond_Raavo_V2™#Retsentsioonid Maagikud]

===[https://wiki.itcollege.ee/index.php/Pillarofautumn Meeskond: Pillar of Autumn ]===
Liikmed:
* Taavi Põder
* Taavi Vesinurm (Meeskonnast lahkunud)
* Raido Vell
'''Lõpptoode API ja klientrakendus:''' [https://github.com/taavip9/Veebirakendused-II Lõpptoode]

===[https://wiki.itcollege.ee/index.php/jaatuli Meeskond: JääTuli]===
Liikmed:
*Tarmo Luugus
*Leho Kivistik
*Hannes Mäeorg
*Marten Tammeleht

===[https://wiki.itcollege.ee/index.php/JustABot Meeskond: JustABot]===
Liikmed:
*Argo Hansen

===[https://wiki.itcollege.ee/index.php/Meeskond_Pakiraam Meeskond: Pakiraam]===
Liikmed:
*Kristo Naeris
*Indro Kottise

Klientrakendus [https://github.com/knaeris/VR2Klient siin] ja veebiteenus [https://github.com/knaeris/VR2Projekt siin]

Retsensioon meeskonna Raavo v2 klientrakendusele : [https://wiki.itcollege.ee/index.php/Meeskond_Pakiraam#Retsensioonid Retsensioon]

Retsensioon meeskonna Raavo v2 veebiteenusele:

===[https://wiki.itcollege.ee/index.php/GoFood Meeskond: GoFood]===
Liikmed:

* Rando Kurel
* Henrik Prangel
* Markus Mänd
* Edgar Tereping
* Jane Kaldma

Lõpptoode: [https://wiki.itcollege.ee/index.php/GoFood#Projektikood lõpptoote leiab siit]

Meie rühma kirjutatud retsentsioonid rühmale Maagikud:[https://wiki.itcollege.ee/index.php/GoFood#Retsensioon_rühmale_Maagikud Retsensioon]

===[https://wiki.itcollege.ee/index.php/LTD Meeskond: LearnToDrive]===
'''Liikmed:'''
*Eve Ormisson
*Carlos Kirtsi

Projekt [https://wiki.itcollege.ee/index.php/LTD#Kood_ise asub siin, kliendina kasutame JustInCaseWPFi]

Projekti retsensioon meeskonnale [https://wiki.itcollege.ee/index.php/LTD#Projekti_retsensioon Maagikud]

XML osa retsensioon meeskonnale [https://wiki.itcollege.ee/index.php/LTD#XML_retsensioon RaamatuRiiul]

===[https://wiki.itcollege.ee/index.php/Miisiiks Meeskond: Miisiiks]===
Liikmed:
*Christo Aruste
*Heleriin Malkov
*Tõnis Prants

[https://www.dropbox.com/s/e2vu3ukgckyc2x5/MiisiiksWS.zip?dl=0 Veebiteenus]

Veebiteenus v2 (05.06): [https://www.dropbox.com/s/4acyvc9c7h08xl6/MiisiiksWS-v2.rar?dl=0 Veebiteenus]

[https://www.dropbox.com/s/iwtheohp5mn0lek/MiisiiksC.zip?dl=0 Klientrakendus]

Klientrakendus v2 (05.06): [https://www.dropbox.com/s/m6ijv2yyqthebgr/MiisiiksC2-v2.rar?dl=0 Klientrakendus]

[https://wiki.itcollege.ee/index.php/Miisiiks#XML XML]

Retsensioonid meeskonnale Raavo V2™

Veebiteenus: [https://wiki.itcollege.ee/index.php/Miisiiks#Veebiteenuse_retsensioon Retsensioon]

Klientrakendus: [https://wiki.itcollege.ee/index.php/Miisiiks#Klientrakenduse_retsensioon Retsensioon]

XML: [https://wiki.itcollege.ee/index.php/Miisiiks#XML_retsensioon XML]

===[https://wiki.itcollege.ee/index.php/VR2_div Meeskond: <div>]===
Liikmed:
*Kaarel Pärtel
*Marek Juhanson
*Kai Kallastu

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]

==Kaugõpe==

===[https://wiki.itcollege.ee/index.php/BestInShow Meeskond: BestInShow]===
Liikmed:
* Liina Abner
* Marju Pütsepp
* Liisi Taimre

'''Lõpptoode veebiteenus:''' [https://www.dropbox.com/s/j5ixmwmx45kxcyo/BestInShow.zip?dl=0 https://www.dropbox.com/s/j5ixmwmx45kxcyo/BestInShow.zip?dl=0] 
'''Kasutusjuhend:''' [https://wiki.itcollege.ee/index.php/BestInShow#Kasutusjuhend https://wiki.itcollege.ee/index.php/BestInShow#Kasutusjuhend] 
'''Lõpptoode klient:''' [https://bitbucket.org/Marjup/bestinshow/ https://bitbucket.org/Marjup/bestinshow/] 
'''XML failid:''' [https://wiki.itcollege.ee/index.php/BestInShow#XML_failid Schema, XML ja XSLT HTML ja XML transformatsiooniks] 
Retsensioon veebiteenusele: TODO 
Retsensioon klientrakendusele: TODO 
Retsensioon XML-ile: TODO 

===[https://wiki.itcollege.ee/index.php/WatchWinders Meeskond: WatchWinders]===
Liikmed:
* Toomas Juhkov
* Kunnar Kukk
* Tiit Kuuskmäe
[https://wiki.itcollege.ee/index.php/WatchWinders#Link_klientrakendusele_ja_API-le Link klientrakendusele ja API-le]

===[[ Kuldneloojang | Meeskond: Kuldne loojang]]===
'''Liikmed''':
* Andrus Seiman
* Marko Belzetski
* Priit Tiganik
* Kristjan Peterson (loobus)

'''Lõpptoode:'''
algselt üles laetud 02.06.2018, bugide parandusi lisatud 04.06.2018
* .zip fail rakendus ja klient koos: https://www.dropbox.com/s/4h9bvq4k6388fmo/loojang.zip?dl=0
* veebirakenduse repo: https://bitbucket.org/itcollegeprojects/loojang-app
* klientrakenduse repo: https://bitbucket.org/itcollegeprojects/loojang-client
* XML: [https://wiki.itcollege.ee/index.php/Kuldneloojang#XML_.C3.BClesande_kirjeldus link meie Wiki lehele]

'''Retsensioonid:'''
* TODO

===[https://wiki.itcollege.ee/index.php/Ophelia Meeskond: Ophelia]===
Liikmed:
* Siim Kallari
* Andres Kepler (loobus)
* Jorma Rebane

[https://www.dropbox.com/s/v63fkbjnd5umqqm/Ophelia.zip?dl=0 Lõpptoote link]

[https://wiki.itcollege.ee/index.php/Ophelia#L.C3.B5pptoote_kasutusjuhend Kasutusjuhend(Kaasas ka lõpptootes)]

[https://wiki.itcollege.ee/index.php/Ophelia#XML_.C3.9Clesanne XML Ülesanne]

===[https://wiki.itcollege.ee/index.php/SharpRestoVRII Meeskond: SharpRestoVRII]===
Liikmed:
* Andres Aava (lahkunud liige)
* Henri Annilo
* Jaan Koolmeister
* Lauri Üksti

Lähtekood: [http://enos.itcollege.ee/~luksti/CSharp/CSharpResto.zip CSharpResto]

Retsensioonid:

===[https://wiki.itcollege.ee/index.php/BeerPressure Meeskond: BeerPressure]===
Liikmed:
* Sigrid Aasma
* Evelin Jõgi
* Martin Kask
* Marko Nõu
'''Projekt:''' [https://github.com/sikumiku/TaisKohtApi TaisKohtApi]

'''Lõpptoode:''' [https://github.com/sikumiku/TaisKohtApi/archive/61438e187a1a972410c8a3bc6274d69489d00aa6.zip GitHub commit]

'''XML:''' [https://wiki.itcollege.ee/index.php/BeerPressure#XML.2FXSD.2FXSLT Beer Pressure XML/XSD/XSLT]

'''Meie kirjutatud XML failide retsensioon:''' [https://wiki.itcollege.ee/index.php/Talk:MOT#XML_retsensioon_by_meeskond_BeerPressure: Team MOT retsensioon]

'''Meie kirjutatud veebiteenuse retsensioon:''' [https://wiki.itcollege.ee/index.php/Talk:MOT#Veebiteenuse_retsensensioon_by_meeskond_BeerPressure: Team MOT retsensioon]

'''Meie kirjutatud klientrakenduse retsensioon:''' [https://wiki.itcollege.ee/index.php/Talk:Kuldneloojang#Klientrakenduse_retsensensioon_by_meeskond_BeerPressure: Team Kuldneloojang retsensioon]

===[[ Memorize | Meeskond: Memorize]]===
Liikmed:
* Madis Uudam
* Olle Mikk

===[https://wiki.itcollege.ee/index.php/UCanDo Meeskond: UCanDo]===
Liikmed:
* Mart Raus
* Ando Kiidron (loobus)
* Liina Saar

'''Lõpptoode: ''' [https://drive.google.com/drive/folders/1GIgiG5NvmnnKoQYmWWbfV_9Nhs2dezz8?usp=sharing UCanDo] 
'''Veebiteenuse retsensioon: ''' 
'''Klientrakenduse retsensioon: ''' 
'''XML retsensioon: ''' 

===[https://wiki.itcollege.ee/index.php/MOT Meeskond: MOT]===
Liikmed:
* Merike Meizner
* Helen Oppar (loobus)
* Hardi Tiitus

'''Lõpptoode: ''' http://enos.itcollege.ee/~mmeizner/MOT/ 
'''Meie kirjutatud veebiteenuse, klientrakenduse ja XML'i retsensioon:''' [https://docs.google.com/document/d/16WL12wmvQ_TPcY_-4pG_kjwtstQoX5meEYcigE4Febw/edit?usp=sharing: Team Raavo V2]

===[https://wiki.itcollege.ee/index.php/Meeskond:_MealPlanner Meeskond: MealPlanner]===
Liikmed:
*Triin Oja
*Rein Remsu

===[https://wiki.itcollege.ee/index.php/Meeskond:Curry Meeskond: Curry]===
Liikmed:
* Rain Elken
* Peeter Ploom

'''Lõpptoode: ''' [http://enos.itcollege.ee/~pploom/VR2/ link] 

===[https://wiki.itcollege.ee/index.php/Hammas Meeskond: Hammas]===

Liikmed:
* Sten Lunden

'''Lõpptoode:''' [https://ildtest.azurewebsites.net azure]
 
'''Projekt:''' [https://github.com/lundens/ild-core github]
 
'''XML''' [https://wiki.itcollege.ee/index.php/Hammas#XML wiki]
 
'''Veebiteenuse retsensioon''' meeskonnale [https://wiki.itcollege.ee/index.php/Hammas#Veebiteenuse_retsensioon_meeskonnale_GoFood GoFood]
 
'''Klientrakenduse retsensioon''' meeskonnale [https://wiki.itcollege.ee/index.php/Hammas#Klientrakenduse_retsensioon_meeskonnale_GoFood GoFood]
 
'''XML retsensioon''' meeskonnale [https://wiki.itcollege.ee/index.php/Hammas#XMLi_retsensioon_meeskonnale_MealPlannerSolo MealPlannerSolo]

===[https://wiki.itcollege.ee/index.php/LabLite Meeskond: LabLite]===
Liikmed:
* Alex Kaska

===[https://wiki.itcollege.ee/index.php/AmateurBB Meeskond: AmateurBB]===
Liikmed:
*Taavi Kivimaa

===[https://wiki.itcollege.ee/index.php/MealPlannerSolo Meeskond: MealPlannerSolo]===
Liikmed:
*Triin Oja
'''[https://wiki.itcollege.ee/index.php/MealPlannerSolo#XML_andmefail XML]'''
 
'''[http://enos.itcollege.ee/~troja/VRII2018/ Veebiteenus ja klientrakendus]'''

===[https://wiki.itcollege.ee/index.php/NutriCheck Meeskond: NutriCheck]===
Liikmed:
*Artyom Likhachev

Kodutöö aines "Võrgurakendused II: hajussüsteemide ehitamine" 2018

2018-06-09T07:59:52Z

Tkuuskma: /* Kaugõpe */

[[Category: Võrgurakendused II: hajussüsteemide ehitamine]]
__NOINDEX__

=Kodutöö aines "Võrgurakendused II: hajussüsteemide ehitamine" 2018=
==Eesmärk==
Saada praktiline kogemus hajussüsteemide ehitamisest XML(SOAP) või Rest veebiteenusel ja sellele klientrakenduse loomise abil ning süvendada meeskonnatööoskust.
*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.
*REST teenuste loomisel tuleks kasutada ASP.NET Web API2/ASP.NET Core 2.0/WCF võimalusi.

Kaugem eesmärk on loomulikult hinne :).

==Reeglid==
''' Kodutöö koosneb kolmest eraldiseisvast ülesandest:'''
* 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)
* Luua veebiteenus, mis võimaldaks pakkuda teenust, eristada kasutajaid ning näidata teenuse kasutamise statistikat kasutajate ja tegevuste lõikes
* Luua klientrakendus

Ü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.

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.

==Tähtajad==

* '''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]
** 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>'''
** Veebiteenus peab olema valmis, esitatud ja ja wikilehel kirjeldatud hiljemalt '''27. mai 2018'''.
** Retsensioonid veebiteenuste kohta peavad tehtud olema '''03. juuni 2018'''.

* '''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]
** Klientrakendused peavad olema valmis, esitatud ja ja wikilehel kirjeldatud hiljemalt '''27. mai 2018'''.
** Retsensioonid klientrakenduste kohta peavad tehtud olema '''03. juuni 2018'''.

* '''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]
** XML fail, stiilifail ja skeemifail peavad olema valmis ja wikilehel kirjeldatud hiljemalt '''01. juuni 2018'''.
** Retsensioonid XML-failide kohta peavad tehtud olema '''05.juuni 2018'''.

==Hindamine==
===Üldised kriteeriumid===

Teostatuks loetakse projekt juhul, kui lähteülesanne on realiseeritud, lahendus on töötav, kuid esineb suuremaid vigu ning piirsituatsioonidega ei ole arvestatud.

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.

'''Maksimumtulemuse annab (vähemalt 4/7):'''

* Majanduslik mõtlemine (kas loodav teenus ja rakendused oleks kasutatav ka ärilistel eesmärkidel)
* Mobiilirakendused/Angularis/reactis loodud klientrakendus
* Kogukondade kaasamine
* Kasutajamugavus
* Läbimõeldud töökorraldus
* Lisavõimaluste realiseerimine (vt näidisteemad)
* Korraliku arhitektuuriga kirjutatud kood

===XML andmefail===
Ü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.

XML-il peab olema vähemalt 4 loogilist dimensiooni.
<dim1>
<dim2>
<dim3>
<dim4>
</dim4>
</dim3>
</dim2>
</dim1>
Lisaks tuleb kasutada 3-el dimensioonil attribuute, mis one enamat, kui lihtsalt ID.

===Veebiteenus===
Loodav veebiteenus peab võimaldama:
* Teenuse pakkumist
* '''Teenuse kasutajate tuvastamist ning haldamist'''
* Teenuse kasutajate ja kasutusstatistika üle arve pidamist kasutajate lõikes
* Teenuse poole pöördumiste arvu piiramist ja piirangute haldamist.

Loodav veebiteenus peab toetama mitme kasutaja võimalust.

Loodav veebiteenus tuleb luua kasutades ''Windows Communication Foundation'' või ASP.NET MVC Web API tehnoloogiat

Andmebaasis peab olema vähemalt 9 olemit ehk andmebaas on eeldus,

Soovitav on luua teenus (FE) ja teenuse seadistamiseks ning kasutajate haldamiseks mõeldud rakendus (BE).

===Klientrakendus===
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)

Variant1: teha klientrakendus enda loodud veebiteenusele

Variant2: teha klientrakendus mõnele levinud veebiteenusele.
Näiteks:
* http://www.bing.com/developer
* http://www.flickr.com/services/api/response.soap.html
* http://developer.ebay.com/developercenter/windows/
* http://apiwiki.twitter.com/Getting-Started

===Retsensioonid===
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.

Retsensioon peab sisaldama minimaalselt...
* XML - ...200 sõna.
* Veebiteenus - ...600 sõna.
* Klientrakendus - ...600 sõna.

Mõnelauselisest arvamusest ei piisa, kuna tegemist on grupi loodavate arvustustega, mitte individuaalsete arvustustega.

==Konsultatsioonid==
Igal projektimeeskonnal on piiramatu õigus saada õppejõu käest konsultatsiooni ja juhendamist oma
töö tegemiseks, kas harjutuste ajal või pärast harjutusi ja loenguid. Eriaegade suhtes saab sõlmida
õppejõuga kokkuleppeid kontaktidel
mait.poska [ät] itcollege.ee või (+372 53 469 734)
(teksti originaalautor Priit Raspel)

==Kaitsmisele registreerumine==
Kaitsmisele tuleks registreerida järjest(st iga järgmine lisab vajaliku 15min ajaakna) ja suvalisis kellaaegasid ei hakka kuhugi vahele kirjutama

'''05.06.2018'''
*15:00 - Miisiks
*15:15 - Maagikud
*15:30 - GoFood
*15:45 - Raavo V2™
*16:00 - LearnToDrive
Sellele päevale rohkem aegu juurde lisada ei saa

Allpool olevate päevadele võib vabalt aegasid juurde lisada 15min sammga. Reegel on, et aegu lisame järjest

'''06.06.2018'''
*17:00 - Raamaturiiul
*17:15 - Pakiraam
*..

'''09.06.2018'''
*16:00 - MealPlannerSolo(Triin Oja)
*16:15 - Beer Pressure
*16:30 - <div>
*16:45 - NutriCheck
*17:00 - JääTuli
*17:15 - Ophelia
*17:30 - Kuldne Loojang
*17:45 - Hammas
*18:00 - VariousArtists
*18:15 - Pillar Of Autumn
*18:30 - Curry
*18:45 - WatchWinders
*19:00 - MOT

=Teemad 2018 kevad=
''' Kodutöö koosneb kolmest eraldiseisvast ülesandest:'''
* 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)
* Luua veebiteenus, mis võimaldaks pakkuda teenust, eristada kasutajaid ning näidata teenuse kasutamise statistikat kasutajate ja tegevuste lõikes
* Luua klientrakendus mõnele olemasolevale või endaloodud veebiteenusele

NB! XML andmefail ja veebiteenus ei pea olema omavahel seotud.

==Näidisteemad==

====Ülesanne====
Luua sobiva alguse järgi nimede pakkumise teenus:
* alates kahetähelisetest algustest pakkuda sobivad nimesid
* luua võimalus kasutajatel nimesid lisada
* luua võimalus administraatoril nimesid muuta/kustutada
* meeste ja naiste nimed peavad olema süsteemis eristatavad
* luua võimalus, mis võimaldab kuvada populaarseid nimesid
* luua võimalus ühele kasutajale (või erinevatele kasutajagruppidele) maksimumpäringute hulga määramiseks
* luua võimalus, et nimi lisatakse baasi alles siis, kui administraatori õigustega inimene on selleks vastava loa andnud

===Külastusstatistika teenus===
Mõte selles, et pakkuda teenust, kus kasutajal on võimalik registreerida külastused ning küsida oma külastusstatistikat.

====Ülesanne====
Luua külastusstatistika teenus:
* kasutaja saab teenuses registreerida külastusi
* kasutaja saab küsida külastusstatistikat päevade/kuude/kogu perioodi lõikes
* luua võimalus ühele kasutajale (või erinevatele kasutajagruppidele) maksimumpäringute hulga määramiseks

Lisavõimalused:
* luua võimalus registreerida alamlehtede külastusstatistikat
* luua võimalus külastusstatistikale lisaparameetrite lisamiseks (ip aadress, sirviku versioon jne)

===Telefoniraamatu teenus===
Mõte selles, et kasutaja saab teenuse abil salvestada kontakte ja nende seast otsida

====Ülesanne====
Luua telefoniraamatu teenus:
* kasutaja saab teenuses kontakte lisada ja kustutada
* kasutaja saab kontaktide nime/telefoninumbri jne abil otsida
* luua võimalus ühele kasutajale (või erinevatele kasutajagruppidele) maksimumpäringute hulga määramiseks
* kasutajaid on võimalik lisada gruppidesse
* kasutajal on võimalik lisada vajalike kontaktandmete liike
* kasutajatel on võimalik jagada omavahel kontakte ja kontaktide grupper

===RSS voogude kogumise ja uudiste kuvamise teenus===
Mõte selles, et kasutaja saab teenuse abil salvestada talle huvipakkuvaid RSS vooge ja nendelt voogudelt uudiseid lugeda

====Ülesanne====
Luua RSS voogude haldusteenus:
* kasutaja saab teenuses RSS vooge lisada ja kustudada
* kasutaja saab pärida talle huvipakkuvate voogude viimaseid uudiseid
* luua võimalus ühele kasutajale (või erinevatele kasutajagruppidele) maksimumpäringute hulga määramiseks
* kasutaja saab RSS vooge vaadata eraldi või grupeeritult
* vooge peab puhverdama, kuna voogude lugemine võtab enamasti üsna palju aega
*

= Meeskonnad 2018=
==Päevaõpe==

===[https://wiki.itcollege.ee/index.php/HairSaloon Meeskond: HairSaloon]===
Liikmed:
* Kaido Henrik Elias
* Arvo Paomees

===[https://wiki.itcollege.ee/index.php/VariousArtists Meeskond: VariousArtists]===
Liikmed:
* Ruudi Vinter
* Madis Roosioks
* Pavel Fleišer

===[https://wiki.itcollege.ee/index.php/Maagikud Meeskond: Maagikud]===
Liikmed:
*Kristina Rästas
*Simo Jaanus
*Artur Tammiste
*Rauno Lõhmus
Lõpptoote [http://enos.itcollege.ee/~sjaanus/c/Airport_solution.zip link]

Veebiteenuse ja klientrakenduse retsensioon tiimile Raavo V2 asub [https://docs.google.com/document/d/1fxmdLa94Do1u5WlmPQjSd4mMmdbDw5WmDne547jqQc4/edit siin]

XML retsensioon tiimile LTD asub [https://docs.google.com/document/d/15rMhpqyG5XHsvOCZJp88ucHkiMa5Non6BbYwBBKT2_Y/edit siin]

===[https://wiki.itcollege.ee/index.php/RaamatuRiiul Meeskond: RaamatuRiiul]===
Liikmed:
* Alo Avi
* Arnika Rästa
* Marite Rammo
'''Meie XML:''' [https://wiki.itcollege.ee/index.php/RaamatuRiiul#XML XML]

'''Meie veebiteenuse, klientrakenduse ja XML retsensioonid meeskonnale Miisiiks:''' [https://wiki.itcollege.ee/index.php/Talk:Miisiiks retsensioonid]

'''Meie veebiteenus ning klientrakendus.''' [https://www.dropbox.com/s/ugbvx4j4zdlbp68/RaamatuRiiul.7z?dl=0 Zip]

===[https://wiki.itcollege.ee/index.php/Autolugu Meeskond: Autolugu]===
Liikmed:
* Margus Põlma
* Karl Erik Õunapuu

===[https://wiki.itcollege.ee/index.php/VRII2018 Meeskond: VRII2018]===
Liikmed:
* Kaspar Kaal
* Teet Adamson
* Rahel Kangur

===[https://wiki.itcollege.ee/index.php/Meeskond_Raavo_V2%E2%84%A2 Meeskond: Raavo V2™]===
Liikmed:
* Peeter Fridolin
* Kristo Leesmann
* Rando Rommot

Projekti retsensioon meeskonnale [https://wiki.itcollege.ee/index.php/Meeskond_Raavo_V2™#Retsentsioonid Maagikud]

===[https://wiki.itcollege.ee/index.php/Pillarofautumn Meeskond: Pillar of Autumn ]===
Liikmed:
* Taavi Põder
* Taavi Vesinurm (Meeskonnast lahkunud)
* Raido Vell
'''Lõpptoode API ja klientrakendus:''' [https://github.com/taavip9/Veebirakendused-II Lõpptoode]

===[https://wiki.itcollege.ee/index.php/jaatuli Meeskond: JääTuli]===
Liikmed:
*Tarmo Luugus
*Leho Kivistik
*Hannes Mäeorg
*Marten Tammeleht

===[https://wiki.itcollege.ee/index.php/JustABot Meeskond: JustABot]===
Liikmed:
*Argo Hansen

===[https://wiki.itcollege.ee/index.php/Meeskond_Pakiraam Meeskond: Pakiraam]===
Liikmed:
*Kristo Naeris
*Indro Kottise

Klientrakendus [https://github.com/knaeris/VR2Klient siin] ja veebiteenus [https://github.com/knaeris/VR2Projekt siin]

Retsensioon meeskonna Raavo v2 klientrakendusele : [https://wiki.itcollege.ee/index.php/Meeskond_Pakiraam#Retsensioonid Retsensioon]

Retsensioon meeskonna Raavo v2 veebiteenusele:

===[https://wiki.itcollege.ee/index.php/GoFood Meeskond: GoFood]===
Liikmed:

* Rando Kurel
* Henrik Prangel
* Markus Mänd
* Edgar Tereping
* Jane Kaldma

Lõpptoode: [https://wiki.itcollege.ee/index.php/GoFood#Projektikood lõpptoote leiab siit]

Meie rühma kirjutatud retsentsioonid rühmale Maagikud:[https://wiki.itcollege.ee/index.php/GoFood#Retsensioon_rühmale_Maagikud Retsensioon]

===[https://wiki.itcollege.ee/index.php/LTD Meeskond: LearnToDrive]===
'''Liikmed:'''
*Eve Ormisson
*Carlos Kirtsi

Projekt [https://wiki.itcollege.ee/index.php/LTD#Kood_ise asub siin, kliendina kasutame JustInCaseWPFi]

Projekti retsensioon meeskonnale [https://wiki.itcollege.ee/index.php/LTD#Projekti_retsensioon Maagikud]

XML osa retsensioon meeskonnale [https://wiki.itcollege.ee/index.php/LTD#XML_retsensioon RaamatuRiiul]

===[https://wiki.itcollege.ee/index.php/Miisiiks Meeskond: Miisiiks]===
Liikmed:
*Christo Aruste
*Heleriin Malkov
*Tõnis Prants

[https://www.dropbox.com/s/e2vu3ukgckyc2x5/MiisiiksWS.zip?dl=0 Veebiteenus]

Veebiteenus v2 (05.06): [https://www.dropbox.com/s/4acyvc9c7h08xl6/MiisiiksWS-v2.rar?dl=0 Veebiteenus]

[https://www.dropbox.com/s/iwtheohp5mn0lek/MiisiiksC.zip?dl=0 Klientrakendus]

Klientrakendus v2 (05.06): [https://www.dropbox.com/s/m6ijv2yyqthebgr/MiisiiksC2-v2.rar?dl=0 Klientrakendus]

[https://wiki.itcollege.ee/index.php/Miisiiks#XML XML]

Retsensioonid meeskonnale Raavo V2™

Veebiteenus: [https://wiki.itcollege.ee/index.php/Miisiiks#Veebiteenuse_retsensioon Retsensioon]

Klientrakendus: [https://wiki.itcollege.ee/index.php/Miisiiks#Klientrakenduse_retsensioon Retsensioon]

XML: [https://wiki.itcollege.ee/index.php/Miisiiks#XML_retsensioon XML]

===[https://wiki.itcollege.ee/index.php/VR2_div Meeskond: <div>]===
Liikmed:
*Kaarel Pärtel
*Marek Juhanson
*Kai Kallastu

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]

==Kaugõpe==

===[https://wiki.itcollege.ee/index.php/BestInShow Meeskond: BestInShow]===
Liikmed:
* Liina Abner
* Marju Pütsepp
* Liisi Taimre

'''Lõpptoode veebiteenus:''' [https://www.dropbox.com/s/j5ixmwmx45kxcyo/BestInShow.zip?dl=0 https://www.dropbox.com/s/j5ixmwmx45kxcyo/BestInShow.zip?dl=0] 
'''Kasutusjuhend:''' [https://wiki.itcollege.ee/index.php/BestInShow#Kasutusjuhend https://wiki.itcollege.ee/index.php/BestInShow#Kasutusjuhend] 
'''Lõpptoode klient:''' [https://bitbucket.org/Marjup/bestinshow/ https://bitbucket.org/Marjup/bestinshow/] 
'''XML failid:''' [https://wiki.itcollege.ee/index.php/BestInShow#XML_failid Schema, XML ja XSLT HTML ja XML transformatsiooniks] 
Retsensioon veebiteenusele: TODO 
Retsensioon klientrakendusele: TODO 
Retsensioon XML-ile: TODO 

===[https://wiki.itcollege.ee/index.php/WatchWinders Meeskond: WatchWinders]===
Liikmed:
* Toomas Juhkov
* Kunnar Kukk
* Tiit Kuuskmäe
[ https://wiki.itcollege.ee/index.php/WatchWinders#Link_klientrakendusele_ja_API-le Link klientrakendusele ja API-le ]

===[[ Kuldneloojang | Meeskond: Kuldne loojang]]===
'''Liikmed''':
* Andrus Seiman
* Marko Belzetski
* Priit Tiganik
* Kristjan Peterson (loobus)

'''Lõpptoode:'''
algselt üles laetud 02.06.2018, bugide parandusi lisatud 04.06.2018
* .zip fail rakendus ja klient koos: https://www.dropbox.com/s/4h9bvq4k6388fmo/loojang.zip?dl=0
* veebirakenduse repo: https://bitbucket.org/itcollegeprojects/loojang-app
* klientrakenduse repo: https://bitbucket.org/itcollegeprojects/loojang-client
* XML: [https://wiki.itcollege.ee/index.php/Kuldneloojang#XML_.C3.BClesande_kirjeldus link meie Wiki lehele]

'''Retsensioonid:'''
* TODO

===[https://wiki.itcollege.ee/index.php/Ophelia Meeskond: Ophelia]===
Liikmed:
* Siim Kallari
* Andres Kepler (loobus)
* Jorma Rebane

[https://www.dropbox.com/s/v63fkbjnd5umqqm/Ophelia.zip?dl=0 Lõpptoote link]

[https://wiki.itcollege.ee/index.php/Ophelia#L.C3.B5pptoote_kasutusjuhend Kasutusjuhend(Kaasas ka lõpptootes)]

[https://wiki.itcollege.ee/index.php/Ophelia#XML_.C3.9Clesanne XML Ülesanne]

===[https://wiki.itcollege.ee/index.php/SharpRestoVRII Meeskond: SharpRestoVRII]===
Liikmed:
* Andres Aava (lahkunud liige)
* Henri Annilo
* Jaan Koolmeister
* Lauri Üksti

Lähtekood: [http://enos.itcollege.ee/~luksti/CSharp/CSharpResto.zip CSharpResto]

Retsensioonid:

===[https://wiki.itcollege.ee/index.php/BeerPressure Meeskond: BeerPressure]===
Liikmed:
* Sigrid Aasma
* Evelin Jõgi
* Martin Kask
* Marko Nõu
'''Projekt:''' [https://github.com/sikumiku/TaisKohtApi TaisKohtApi]

'''Lõpptoode:''' [https://github.com/sikumiku/TaisKohtApi/archive/61438e187a1a972410c8a3bc6274d69489d00aa6.zip GitHub commit]

'''XML:''' [https://wiki.itcollege.ee/index.php/BeerPressure#XML.2FXSD.2FXSLT Beer Pressure XML/XSD/XSLT]

'''Meie kirjutatud XML failide retsensioon:''' [https://wiki.itcollege.ee/index.php/Talk:MOT#XML_retsensioon_by_meeskond_BeerPressure: Team MOT retsensioon]

'''Meie kirjutatud veebiteenuse retsensioon:''' [https://wiki.itcollege.ee/index.php/Talk:MOT#Veebiteenuse_retsensensioon_by_meeskond_BeerPressure: Team MOT retsensioon]

'''Meie kirjutatud klientrakenduse retsensioon:''' [https://wiki.itcollege.ee/index.php/Talk:Kuldneloojang#Klientrakenduse_retsensensioon_by_meeskond_BeerPressure: Team Kuldneloojang retsensioon]

===[[ Memorize | Meeskond: Memorize]]===
Liikmed:
* Madis Uudam
* Olle Mikk

===[https://wiki.itcollege.ee/index.php/UCanDo Meeskond: UCanDo]===
Liikmed:
* Mart Raus
* Ando Kiidron (loobus)
* Liina Saar

'''Lõpptoode: ''' [https://drive.google.com/drive/folders/1GIgiG5NvmnnKoQYmWWbfV_9Nhs2dezz8?usp=sharing UCanDo] 
'''Veebiteenuse retsensioon: ''' 
'''Klientrakenduse retsensioon: ''' 
'''XML retsensioon: ''' 

===[https://wiki.itcollege.ee/index.php/MOT Meeskond: MOT]===
Liikmed:
* Merike Meizner
* Helen Oppar (loobus)
* Hardi Tiitus

'''Lõpptoode: ''' http://enos.itcollege.ee/~mmeizner/MOT/ 
'''Meie kirjutatud veebiteenuse, klientrakenduse ja XML'i retsensioon:''' [https://docs.google.com/document/d/16WL12wmvQ_TPcY_-4pG_kjwtstQoX5meEYcigE4Febw/edit?usp=sharing: Team Raavo V2]

===[https://wiki.itcollege.ee/index.php/Meeskond:_MealPlanner Meeskond: MealPlanner]===
Liikmed:
*Triin Oja
*Rein Remsu

===[https://wiki.itcollege.ee/index.php/Meeskond:Curry Meeskond: Curry]===
Liikmed:
* Rain Elken
* Peeter Ploom

'''Lõpptoode: ''' [http://enos.itcollege.ee/~pploom/VR2/ link] 

===[https://wiki.itcollege.ee/index.php/Hammas Meeskond: Hammas]===

Liikmed:
* Sten Lunden

'''Lõpptoode:''' [https://ildtest.azurewebsites.net azure]
 
'''Projekt:''' [https://github.com/lundens/ild-core github]
 
'''XML''' [https://wiki.itcollege.ee/index.php/Hammas#XML wiki]
 
'''Veebiteenuse retsensioon''' meeskonnale [https://wiki.itcollege.ee/index.php/Hammas#Veebiteenuse_retsensioon_meeskonnale_GoFood GoFood]
 
'''Klientrakenduse retsensioon''' meeskonnale [https://wiki.itcollege.ee/index.php/Hammas#Klientrakenduse_retsensioon_meeskonnale_GoFood GoFood]
 
'''XML retsensioon''' meeskonnale [https://wiki.itcollege.ee/index.php/Hammas#XMLi_retsensioon_meeskonnale_MealPlannerSolo MealPlannerSolo]

===[https://wiki.itcollege.ee/index.php/LabLite Meeskond: LabLite]===
Liikmed:
* Alex Kaska

===[https://wiki.itcollege.ee/index.php/AmateurBB Meeskond: AmateurBB]===
Liikmed:
*Taavi Kivimaa

===[https://wiki.itcollege.ee/index.php/MealPlannerSolo Meeskond: MealPlannerSolo]===
Liikmed:
*Triin Oja
'''[https://wiki.itcollege.ee/index.php/MealPlannerSolo#XML_andmefail XML]'''
 
'''[http://enos.itcollege.ee/~troja/VRII2018/ Veebiteenus ja klientrakendus]'''

===[https://wiki.itcollege.ee/index.php/NutriCheck Meeskond: NutriCheck]===
Liikmed:
*Artyom Likhachev

WatchWinders

2018-06-08T20:22:30Z

Tkuuskma: /* Palun loe seda readme asemel */

= Meeskond =

Toomas Juhkov, toomas.juhkov@gmail.com 
Tiit Kuuskmäe, tiit.kuuskmae@gmail.com 
Kunnar Kukk, Kunnar.kukk@gmail.com 

= Tegevuste logi =

08.02.2018 - meeskonna loomine, kokkuleppe sõlmimine teema osas 
10.02.2018 - õppejõu teavitamine koos esmase andmemudeliga 
15.02.2018 - lõpliku andmemudeli valmimine(versioon 5) 
18.02.2018 - õppejõu kinnitus, et teema ja meeskond kvalifiseeruvad 
22.02.2018 - viki lehe loomine ja analüüsi koostamise alustamine 
26.02.2018 - tiimi lisandus Kunnar Kukk 
01.03.2018 - tiimi sprint koosolek(seoses täiendava tiimiliikme lisandumisega täpsustasime skoopi) 
03.03.2018 - alustasime koodi kirjutamisega (tabelid klassideks ja annotatsioonid peale) 
06.03.2018 - täiendasime andmemudelit olemiga "UserTypeState" (et saaks muuta kasutajatüüpi) 
08.03.2018 - tiimi sprint koosolek 
18.03.2018 - lisasime olemid "Address", "AddressU", "AddressM", "OfferOfUser", "MediaInOffer" 
22.03.2018 - tiimi sprint koosolek, mis oli pühendatud andmemudeli täiendamisele 
23.03.2018 - pikem tiimi hackathon andmemudeli teemal 
29.03.2018 - täiendatud wiki lehte täielikult ringitöötatud andmemudeliga 
30.03.2018 - täiendatud wiki lehte andmemudeli metainfoga 
09.04.2018 - silusime andmemudelit (mõningad ebavajalikud viited olid sisse jäänud) 
06.05.2018 - panime uuendatud andmemudeli projekti wiki lehele üles 
07.05.2018 - osalesime õppejõu Mait Poska korraldatud hackathonil 
08.06.2018 - XML ülesanne, klientrakenduse ja API kood sai wiki lehel avalikuks 

Terve maikuu oli igapäevane suhtlus üle Skype'i ja fleep.io, mida me ei loginud (liiga tihedaks läks!).

= Kasutatavad metoodikad =

WatchWinders projektis plaanime kasutada peamiselt kaht metoodikat:

1. läbiv retsenseerimine (üks paariline teeb midagi valmis ja teine teeb sellele ülevaatuse; üksus lisatakse kui ülevaatus on lõplikult läbitud ning osapoolte vahel on saabunud konsensus) 
2. paaris programmeerimine (istume ühe masina taha maha ja kirjutame kolmekesi)

Tulenevalt kaugõppe formaadist saab ülekaalus olema esimene variant. Teist metoodikat kasutame nende osade kirjutamiseks, mille puhul võib arvata, et nende lahendamine on keeruline või et lahenduskäike võib olla väga erinevaid. Püüame jooksvalt siinses vikis kajastada ka seda, millise metoodika järgi üks või teine osa valmis.

= Projekti osad =

Alljärgnevalt anname ülevaate projekti osadest: 

(1) andmemudel 
(2) veebiteenuse analüüs 
(3) Minimum Viable Product definitsioon 
(4) Inkrement #1 
(5) Inkrement #2 
(6) Inkrement #3 

Projekti osad on meie viki lehel kirjeldatud valmimise järjekorras.

== Andmemudel ==

Andmemudeli koostamisel lähtusime õppejõu ette antud kriteeriumist, mille järgi andmemudelis on vähemalt 6 põhiolemit (tähistatud tumesinise ja lillaga - meie mudelis 11 tk),
mille hulgas ei sisaldu kasutajate tabelit (Person). 
 
Põhiolemid: 
* Watch - kell 
* Person - kasutaja/kollektsionäär või firma esindaja 
* Box - kellakarp 
* Organization - tootjad, edasimüüjad, hooldus 
* Settings - kellakarbi seade 
* Offer - pakkumine kollektsionäärile 
* Media - meediafailid kellade ja karpide kohta 
* Address - kasutaja/organisatsiooni aadress 
* ElectronicContact - elektrooniliste kontaktide loend 
* Log - logi 
* Access - paroolid ja kasutajanimed 
* Error - vead 
 
Type abiolemid: 
* WatchType - kellatüübid 
* PersonType - isikutüübid: admin, kasutaja 
* OrganizationType - organisatsioonitüübid: tootja, hooldaja, edasimüüja jt 
* ActionType - logi tüübid 
* ContactType - elektroonilise kontakti tüüp: skype, email, telefon jt 
 
Olekud: 
* PersonTypeState - isiku rolli kehtivus ajahetkel (isiku ja tüübi vaheline seos) 
* OrganizationTypeState - organisatsiooni olek(ud) ajahetkel 
 
Kuuluvus: 
* PersonWatch - isikute ja kellade vahelised seosed 
* PersonBox - isiku ja karbi vaheline seos 
* PersonAccess - isiku ja autentimisandmete vaheline seos 
* WatchInBox - kella ja karbi vaheline seos 
* ErrorInWatch - vea ja kella vaheline seos 
* SettingsInBox - seade ja karbi vaheline seos 
* WatchInOrganization - kella ja tootja vaheline seos 
* PersonInOrganization - isiku ja ettevõtte/organisatsiooni vaheline seos 
* SettingsOfWatchType - seade ja kellatüübi vaheline seos 
 
Abstraktsioonid: 
* Locator - abstraktsioon erinevate kontaktitüüpide jaoks 
* Party - abstraktsioon erinevate inimeste, organisatsioonide jt jaoks 
 
Kommunikatsioon: 
* OfferToPerson - isikule suunatud pakkumised 
* OfferFromPerson - isikult lähtuv pakkumine 
 
 
 
[[File:ww_andmemudel_06052018.png]]
 

Andmemudel valmis (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

== Veebiteenuse analüüs ==

Alljärgnevalt esitame kellakarpide infosüsteemi analüüsi järgmistes osades:

(1) toote/teenuse kirjeldus 
(2) probleemi kirjeldus 
(3) lahendus 
(4) süsteemi kasutajad 
(5) loodava API võimalused 
(6) funktsionaalsed nõuded 
(7) mittefunktsionaalsed nõuded 

=== Toote/teenuse kirjeldus ===
Teenuse eesmärgiks on lahendada probleem, kuidas jälgida kellakarpide kaudu mehhaaniliste käekellade seisundit ning keerata neid automaatselt üles distantsilt, näiteks juhul, kui kellade kollektsionäär ei asu füüsiliselt igapäevaselt oma kellade juures. Teenus võimaldab ka tootjal uuendada kontaktandmeid, saata personaalseid teateid. Administraatorile annab ülevaate platvormis toimuvast.

=== Probleemi kirjeldus ===
Mehhaaniliste käekellade kollektsionääride huvi kellakarpide vastu on mitmetahuline. Kollektsionääre huvitab arvepidamine – mitu kella, missuguste omaduste ja eripäradega neil kollektsioonis on. Teisalt soov eksponeerida oma kogusid kolleegidele ja sõpradele. Kellakarpidega täidetud sein või riiulid loovad selleks suurepärase võimaluse. Kolmandaks praktiline vajadus tagada kellavedrude õige vinnastatuse aste. Kaasaja mehhaanilised kellamehhanismid (''automatic'') võimaldavad kellakorpuse füüsilisel liigutamisel kellavedru automaatselt vinnastada.

Näiteks piisab kella kinnitamisest käele, et see hakkaks end käe liigutamisel üles keerama. Kuidas keerata aga üles seisvat kella, mis seisab paigal kellakarbis? Selleks on tänapäeva kellakarpides elektrimootor, mis tagab kella liigutamise vastavalt kellatüübile ettenähtud ööpäevase graafiku alusel. Kollektsionääride üheks probleemiks on see, kuidas juhtida sellist karpi ja omada jooksvat ülevaadet kõikidest oma karpidest, nende tehnilisest seadistusest ja kollektsiooni kuuluvatest kelladest olles tööreisil välisriigis?

=== Lahendus ===
Probleemi lahendamiseks ehitame REST + ASP.NET Core + WebAPI koos kliendiga, mis võimaldab kellakollektsionääridel hallata kellasid karpides, administraatoritel saada ülevaate süsteemist ning tootjatele lisada infot kollektsionääridele. Käesoleva projekti käigus '''ei tegeleta''' kahe IoT lahenduse kui terviku seisukohast olulise nüansiga: (i) karbi püsivara (''firmware'') loomisega, (ii) klientrakenduse ''frontend'' lõpliku häälestamisega (ilus .css ja pildid).

=== Süsteemi kasutajad ===
'''Kollektsionäär''' - haldab ja muudab infot oma kellade ning oma kellakarpide kohta. 
'''Administraator''' - haldab süsteemi infot, vajadusel eemaldab probleeme. 
'''Tootja''' - saab saata süsteemi kollektsionääridele mõeldud infot. 
'''Hooldaja''' - saab infot hooldamist vajavate kellade ja -karpide kohta. 

=== Loodava API võimalused ===
Alljärgnevalt vaatame loodava API võimalusi kasutajagruppide kaupa:

'''Kasutajale/kellakollektsionäärile'''
* Saada ülevaade kelladest ja kellakarpidest (lisada, muuta, vaadata).
* Muuta karbis oleva kella kohta käivat informatsiooni (kella nimi, tootja, tootmise aeg, viitenumber, mehhanism, jõureservi jääk (valikuline), foto kellast, kellarihma liik, muu).
* Karpe juhtida (keerata automaatselt üles). Näha ja muuta kella üleskeerava mehhanismi liikumise kiirust ja muid detaile (nt liikumise suund).
* Näha karbi seisundit, kas karp on hetkel wifiga ühendatud või mitte.
* Näha karbilt saabunud veateateid.
* Sisestada infot kella seisundist.
* Suhelda hooldajate ja tootjatega

'''Tootjale'''
* Uuendada kontaktandmeid.
* Saata personaalseid teateid kellakollektsionääridele.

'''Administraatorile'''
* Näha võrku ühendatud karpide arvu.
* Näha karpidesse paigaldatud kellade nimistut (ilma muude kasutajaandmeteta).
* Näha kellade üleskeeramise mehhanismide arvnäitajaid (madalaim kiirus, keskmine kiirus, tippkiirus; samuti liikumise suundade arvnäitajaid).
* IP-aadresside järgi ülevaadet, millistes riikides karpe kasutatakse (üldised arvandmed).
* Veateatega karpide arv süsteemis (üldised arvandmed).

=== Funktsionaalsed nõuded ===
* Kõik tegevused peavad olema autoriseeritud.
* REST + ASP.NET Core + WebAPI tagastab infot valideeritud JSON formaadis.
* API veatöötlus on tehtud, kasutades standardseid veakoode.
* API-le on tehtud 'health check'.
* Kõik kasutajad peavad saama end autoriseerida.
* Kasutaja, tootja ja administraatori tegevused logitakse.
* Logi ei ole muudetav, vaid on kättesaadav.
* Kasutaja ega tootja ei näe teiste kasutajate ega tootjate infot.
* API klient on kohanduv mobiilile, tahvlile ja desktoparvutile.
* Sisendandmed on valideeritud.

=== Mittefunktsionaalsed nõuded ===
* API-le on lisatud Swagger fail.
* Teenus ja tehniline lahendus on dokumenteeritud.
* Süsteemi kood on vabalt ligipääsetav, täiendatav ning allalaetav.

Esitame töö etappidena, kus kõigepealt defineerime ära Minimum Viable Producti [https://en.wikipedia.org/wiki/Minimum_viable_product] ehk selle miinimumi, mis pakub kasutajale maksimaalset väärtust. See tähendab API loomist ning esmase kliendi loomist kõigile MVP-s defineeritud kasutajagruppidele. Seejärel realiseerime projekti inkrementide ehk tootearenduse sammudena, milles lisame uusi funktsionaalsusi. Ideaalis jõuame realiseerida kõik sammud, kuid kuna teeme nimetatud tööd antud ajaraamis ja koosseisus esmakordselt, siis võtame vabaduse ka realiseerida korralikult niipalju, kui jõuame projekti käigus ära teha.

Võimalik, et meie lõpptulemus erineb mõnes osas esitatud analüüsist. Seda olenevalt sellest kui edukalt meil õnnestub plaanitud funktsionaalsusi realiseerida. Erisusi plaanime käsitleda vastavas 'post production' jaotuses, kus loendame ka projektist kogunenud peamised õppetunnid.

Analüüs valmis (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

== Minimum Viable Product definitsioon ==
'''Kasutaja'''
* Kasutaja saab süsteemi logida ning välja logida
* Kasutaja saab lisada uue kellakarbi
* Kasutaja saab lisada uue kella kellakarpi
* Kasutaja saab muuta kella infot kellakarbis
* Kasutaja saab näha ülevaadet oma karpidest
* Kasutaja saab muuta kellakarbi seadeid
* Kasutaja saab kustutada kella karbis
* Kasutaja saab kustutada kellakarbi

'''Administraator'''
* Näeb autoriseeritult logisid

'''Tootja'''
* Saab lisada kontaktandmeid
* Saab kontaktandmeid muuta

== Inkrement #1 ==
'''Kasutaja'''
* Näeb karbilt saabunud veateateid.
* Saab kellakarpe juhtida.

'''Administraator'''
* IP-aadresside järgi ülevaadet, millistes riikides karpe kasutatakse (üldised arvandmed).
* Karpidesse paigaldatud kellade nimistut (ilma muude kasutajaandmeteta).
* Näeb kasutajate statistikat.

'''Tootja'''
* Saata personaalseid teateid kellakollektsionääridele.

== Inkrement #2 ==
'''Kasutaja'''
* Saab saata teate tootjale.
* Näeb tootja vastust.
* Näha karbi seisundit, kas karp on hetkel wifiga ühendatud või mitte.

'''Administraator'''
* Näha kellade üleskeeramise mehhanismide arvnäitajaid (madalaim kiirus, keskmine kiirus, tippkiirus; samuti liikumise suundade arvnäitajaid).
* Näeb tegevuste ajalugu kliendist.

'''Tootja'''
* Saab lugeda kasutaja teadet.
* Saab vastata kasutajale.

'''Hooldaja'''
* Saab info hooldamist vajavate kellade kohta.

== Inkrement #3 ==
'''Kasutaja'''
* On ehitatud keeletugi.

'''Tootja'''
* On ehitatud keeletugi.

'''Hooldaja'''
* On ehitatud keeletugi.

Inkrementid valmisid (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

= XML ülesanne =
Järgnevalt esitame oma XML-ülesande tulemused.

== IT Management Transformation XML To XML ==
<pre>
<?xml version="1.0" encoding="utf-8"?>
<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">
<xsl:output method="xml" indent="yes"/>
<xsl:template match="/">
<unhandledDevices>
<xsl:for-each select="customers/customer/locations/location/items/item[@isInWorkingCondition='false']">
<device>
<name>
<xsl:value-of select="manufacturer"/>
<xsl:text> </xsl:text>
<xsl:value-of select="model"/>
</name>
<ticket>
<xsl:for-each select="tickets/ticket[@isHandled='false']">
<ticket_id>
<xsl:value-of select="@id"/>
</ticket_id>
<issued_in>
<xsl:value-of select="@issuedIn"/>
</issued_in>
<description>
<xsl:value-of select="description"/>
</description>
</xsl:for-each>
</ticket>
</device>
</xsl:for-each>
</unhandledDevices>
</xsl:template>
</xsl:stylesheet>
</pre>

== IT Management Transformation HTML ==

<pre>
<?xml version="1.0" encoding="utf-8"?>
<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">
<xsl:output method="html" indent="yes"/>
<xsl:template match="/">

<html>
<head>
<title>ItManagement Laptops</title>
</head>
<body style="background-color:#F7F7F7">
<h1>Computers</h1>
<xsl:for-each select="/customers/customer/locations/location/items/item[@type='laptopComputer']">
<xsl:sort select="@isActive='false'"/>
<hr />
<div>
<h3>
<xsl:value-of select="manufacturer"/>
</h3>
Model: 
<xsl:value-of select="model"/>
 
Serial number: 
<xsl:value-of select="serialNumber"/>
 
Date of purchase: 
<xsl:value-of select="dateOfPurchase"/>
 
Operating system: 
<xsl:value-of select="operatingSystem"/>
 
Is on active list: 
<xsl:value-of select="@isActive"/>
 
</div>

<div style="background-color:#E3FAEE" >

<xsl:for-each select="tickets/ticket">
<xsl:choose>
<xsl:when test="@isHandled='true'">
<h3>Handled tickets</h3>
<ul>
Issued in: 
<xsl:value-of select="@issuedIn"/>
 
Ticket ID: 
<xsl:value-of select="@id" />
 
Description: 
<xsl:value-of select="description"/>
 
Solution: 
<xsl:value-of select="solution"/>
 
</ul>
</xsl:when>
<xsl:when test="@isHandled='false'">
<div style="background-color:#FDE5E5">
<h3>Unhandled tickets</h3>
<ul>
Issued in: 
<xsl:value-of select="@issuedIn"/>
 
Ticket ID: 
<xsl:value-of select="@id" />
 
Description: 
<xsl:value-of select="description"/>
 
Solution: 
<xsl:value-of select="solution"/>
 
</ul>
</div>
</xsl:when>
</xsl:choose>
</xsl:for-each>

</div>
</xsl:for-each>
</body>
</html>
</xsl:template>
</xsl:stylesheet>
</pre>

== IT Management XSD ==

<pre>
<?xml version="1.0" encoding="utf-8"?>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="customers">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="customer">
<xs:complexType>
<xs:sequence>
<xs:element name="customerName" type="xs:string" />
<xs:element minOccurs="0" name="contactPerson" type="xs:string" />
<xs:element name="e-mail" type="xs:string" />
<xs:element name="phoneNumber" type="xs:string" />
<xs:element name="locations">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="location">
<xs:complexType>
<xs:sequence>
<xs:element name="city" type="xs:string" />
<xs:element name="address" type="xs:string" />
<xs:element name="comment" type="xs:string" />
<xs:element minOccurs="0" name="localContactPerson" type="xs:string" />
<xs:element minOccurs="0" name="localPhone" type="xs:string" />
<xs:element name="items">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="item">
<xs:complexType>
<xs:sequence>
<xs:element name="manufacturer" type="xs:string" />
<xs:element name="model" type="xs:string" />
<xs:element name="serialNumber" type="xs:string" />
<xs:element name="dateOfPurchase" type="xs:date" />
<xs:element minOccurs="0" name="operatingSystem">
<xs:complexType>
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute name="version" type="xs:string" use="required" />
</xs:extension>
</xs:simpleContent>
</xs:complexType>
</xs:element>
<xs:element minOccurs="0" name="tickets">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="ticket">
<xs:complexType>
<xs:sequence>
<xs:element name="description" type="xs:string" />
<xs:element name="solution" type="xs:string" />
</xs:sequence>
<xs:attribute name="id" type="xs:string" use="required" />
<xs:attribute name="issuedIn" type="xs:date" use="required" />
<xs:attribute name="isHandled" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:unsignedInt" use="required" />
<xs:attribute name="type" type="xs:string" use="required" />
<xs:attribute name="isActive" type="xs:boolean" use="required" />
<xs:attribute name="isUnderWarranty" type="xs:boolean" use="required" />
<xs:attribute name="warrantyInMonths" type="xs:unsignedByte" use="required" />
<xs:attribute name="isInWorkingCondition" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="type" type="xs:string" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:unsignedInt" use="required" />
<xs:attribute name="type" type="xs:string" use="required" />
<xs:attribute name="isActive" type="xs:boolean" use="required" />
<xs:attribute name="hasManyLocations" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
</pre>

== IT Management XML ==

<pre>
<?xml version="1.0" encoding="utf-8" ?>
<customers>
<customer id="33" type="company" isActive="true" hasManyLocations="true">
<customerName>Elamustevaba OÜ</customerName>
<contactPerson>Juhan Pühamees</contactPerson>
<e-mail>juhan@evaba.com</e-mail>
<phoneNumber>+37256565656</phoneNumber>
<locations>
<location type="office">
<city>Tallinn</city>
<address><![CDATA[Pikk 7, 56401]]></address>
<comment><![CDATA[3. korrus -> paremat kätt]]></comment>
<localContactPerson>Maiu Piimaauto</localContactPerson>
<localPhone>+3726510510</localPhone>
<items>
<item id="1" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="36" isInWorkingCondition="false">
<manufacturer>Dell</manufacturer>
<model>Inspiron 3558</model>
<serialNumber>6FGH5JN</serialNumber>
<dateOfPurchase>2017-07-22</dateOfPurchase>
<operatingSystem version="1709">Windows 10 Home</operatingSystem>
<tickets>
<ticket id="HWI001" issuedIn="2017-11-21" isHandled="true">
<description><![CDATA[Wi-Fi is not working]]></description>
<solution><![CDATA[Wi-Fi card replaced (Under the warranty)]]></solution>
</ticket>
<ticket id="SWI256" issuedIn="2018-05-05" isHandled="false">
<description><![CDATA[Computer keeps showing login screen]]></description>
<solution></solution>
</ticket>
</tickets>
</item>
<item id="55" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="60" isInWorkingCondition="true">
<manufacturer>Dell</manufacturer>
<model>Latitude E7550</model>
<serialNumber>8JGR78U</serialNumber>
<dateOfPurchase>2016-06-15</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Home</operatingSystem>
</item>
</items>
</location>
<location type="store">
<city>Tallinn</city>
<address><![CDATA[Lai 17, 56401]]></address>
<comment><![CDATA[keldrikorrusel]]></comment>
<localContactPerson>Tanja Õielemb</localContactPerson>
<localPhone>+3726510520</localPhone>
<items>
<item id="83" type="desktopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Lenovo</manufacturer>
<model>ThinkCentre M715</model>
<serialNumber>IO25689AD54KL</serialNumber>
<dateOfPurchase>2017-12-01</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Pro</operatingSystem>
</item>
<item id="12" type="monitor" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>AOC</manufacturer>
<model>L456</model>
<serialNumber>9803987YE54</serialNumber>
<dateOfPurchase>2015-05-03</dateOfPurchase>
<tickets>
<ticket id="HWI126" issuedIn="2016-01-18" isHandled="true">
<description><![CDATA[Doesn't work, no picture.]]></description>
<solution><![CDATA[Wasn't plugged in. Technician did it - works again!]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
<customer id="02" type="private" isActive="true" hasManyLocations="false">
<customerName>Kessu Sisselasi</customerName>
<e-mail>kessu@tripp.org</e-mail>
<phoneNumber>+372555555</phoneNumber>
<locations>
<location type="home">
<city>Saue</city>
<address><![CDATA[Kooli 4-8, 78965]]></address>
<comment><![CDATA[2. korrus. Kitsad koridorid.]]></comment>
<items>
<item id="98" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Acer</manufacturer>
<model>Aspire 5</model>
<serialNumber>475YRT89K4</serialNumber>
<dateOfPurchase>2018-03-25</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Home</operatingSystem>
</item>
<item id="4" type="laptopComputer" isActive="false" isUnderWarranty="false" warrantyInMonths="36" isInWorkingCondition="true">
<manufacturer>Lenovo</manufacturer>
<model>IdeaPad L530</model>
<serialNumber>U89TRY765ME</serialNumber>
<dateOfPurchase>2007-08-14</dateOfPurchase>
<operatingSystem version="">Windows XP</operatingSystem>
<tickets>
<ticket id="SWI069" issuedIn="2010-01-28" isHandled="true">
<description><![CDATA[Blue screen.]]></description>
<solution><![CDATA[Video driver update.]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
<customer id="26" type="company" isActive="true" hasManyLocations="true">
<customerName>Aktsiaselts OÜ</customerName>
<contactPerson>Gunnar Kuningas</contactPerson>
<e-mail>gunnar@kunn.ee</e-mail>
<phoneNumber>+3726985236</phoneNumber>
<locations>
<location type="office">
<city>Loksa</city>
<address><![CDATA[Kalda 14, 78965]]></address>
<comment><![CDATA[Sissepääs Rimi poolt, helesinine uks]]></comment>
<items>
<item id="26" type="laptopComputer" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Apple</manufacturer>
<model>Macbook Air</model>
<serialNumber>258JUY369</serialNumber>
<dateOfPurchase>2017-03-01</dateOfPurchase>
<operatingSystem version="High Sierra">OS X</operatingSystem>
</item>
<item id="59" type="laptopComputer" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="false">
<manufacturer>Acer</manufacturer>
<model>Chromebook 11</model>
<serialNumber>U89TRY765ME</serialNumber>
<dateOfPurchase>2016-04-23</dateOfPurchase>
<operatingSystem version="">Chrome OS</operatingSystem>
<tickets>
<ticket id="HWI046" issuedIn="2010-02-28" isHandled="false">
<description><![CDATA[Stripes on screen]]></description>
<solution><![CDATA[]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
</customers>
</pre>

= Link klientrakendusele ja API-le =
https://drive.google.com/file/d/1FU3XGGVHbn4BNNHAsOs7DQ4CzpEDwZUt/view?usp=sharing

== Palun loe seda "readme" asemel ==

1. meie rakenduse implementeeritud skoop lähtub siin lehel (ülal), analüüsi osas defineeritud "Minimum viable product" kriteeriumitest 
2. lase API käima, tee andmebaaside migratsioonid ja update-database 
3. implementeeritud on kõik teenused, mis on nähtaval Swaggeris aadressil: "localhost:[pordinumber]/Swagger" 
4. kliendirakendus asub kataloogis 'WatchWindersClient' ja tegemist on solutioniga, mille võiks käivitada teises Visual Studio aknas 
5. klientrakenduse käivitumiseks tuleks muuta App.config failis muuta ära localhost portide numbrid asendades need enda arvutis oleva localhost pordiga ning lisada kehtiv JWT AccessToken, mille saab Postmaniga aadressilt api/Security/getToken "Email" ja "Password" abil pärast seda kui kasutaja on loodud 
6. küsimuste ja raskuste korral kirjuta tiit.kuuskmae@gmail.com (API) ja toomas.juhkov@gmail.com (klient). Vastame esimesel võimalusel.

= Kasutatud kirjandus ja allikad =

1. Albahari, Joseph, Albari, Ben 2017. C# 7.0 in A Nutshell. Sebastopol: O’Reilly 
2. MariaDB Foundation. MariaDB. Kättesaadav:https://mariadb.org/ 
3. Martin, Robert 2018. Clean Architecture. Boston: Pearson Education

WatchWinders

2018-06-08T20:22:20Z

Tkuuskma: /* Readme asemel */

= Meeskond =

Toomas Juhkov, toomas.juhkov@gmail.com 
Tiit Kuuskmäe, tiit.kuuskmae@gmail.com 
Kunnar Kukk, Kunnar.kukk@gmail.com 

= Tegevuste logi =

08.02.2018 - meeskonna loomine, kokkuleppe sõlmimine teema osas 
10.02.2018 - õppejõu teavitamine koos esmase andmemudeliga 
15.02.2018 - lõpliku andmemudeli valmimine(versioon 5) 
18.02.2018 - õppejõu kinnitus, et teema ja meeskond kvalifiseeruvad 
22.02.2018 - viki lehe loomine ja analüüsi koostamise alustamine 
26.02.2018 - tiimi lisandus Kunnar Kukk 
01.03.2018 - tiimi sprint koosolek(seoses täiendava tiimiliikme lisandumisega täpsustasime skoopi) 
03.03.2018 - alustasime koodi kirjutamisega (tabelid klassideks ja annotatsioonid peale) 
06.03.2018 - täiendasime andmemudelit olemiga "UserTypeState" (et saaks muuta kasutajatüüpi) 
08.03.2018 - tiimi sprint koosolek 
18.03.2018 - lisasime olemid "Address", "AddressU", "AddressM", "OfferOfUser", "MediaInOffer" 
22.03.2018 - tiimi sprint koosolek, mis oli pühendatud andmemudeli täiendamisele 
23.03.2018 - pikem tiimi hackathon andmemudeli teemal 
29.03.2018 - täiendatud wiki lehte täielikult ringitöötatud andmemudeliga 
30.03.2018 - täiendatud wiki lehte andmemudeli metainfoga 
09.04.2018 - silusime andmemudelit (mõningad ebavajalikud viited olid sisse jäänud) 
06.05.2018 - panime uuendatud andmemudeli projekti wiki lehele üles 
07.05.2018 - osalesime õppejõu Mait Poska korraldatud hackathonil 
08.06.2018 - XML ülesanne, klientrakenduse ja API kood sai wiki lehel avalikuks 

Terve maikuu oli igapäevane suhtlus üle Skype'i ja fleep.io, mida me ei loginud (liiga tihedaks läks!).

= Kasutatavad metoodikad =

WatchWinders projektis plaanime kasutada peamiselt kaht metoodikat:

1. läbiv retsenseerimine (üks paariline teeb midagi valmis ja teine teeb sellele ülevaatuse; üksus lisatakse kui ülevaatus on lõplikult läbitud ning osapoolte vahel on saabunud konsensus) 
2. paaris programmeerimine (istume ühe masina taha maha ja kirjutame kolmekesi)

Tulenevalt kaugõppe formaadist saab ülekaalus olema esimene variant. Teist metoodikat kasutame nende osade kirjutamiseks, mille puhul võib arvata, et nende lahendamine on keeruline või et lahenduskäike võib olla väga erinevaid. Püüame jooksvalt siinses vikis kajastada ka seda, millise metoodika järgi üks või teine osa valmis.

= Projekti osad =

Alljärgnevalt anname ülevaate projekti osadest: 

(1) andmemudel 
(2) veebiteenuse analüüs 
(3) Minimum Viable Product definitsioon 
(4) Inkrement #1 
(5) Inkrement #2 
(6) Inkrement #3 

Projekti osad on meie viki lehel kirjeldatud valmimise järjekorras.

== Andmemudel ==

Andmemudeli koostamisel lähtusime õppejõu ette antud kriteeriumist, mille järgi andmemudelis on vähemalt 6 põhiolemit (tähistatud tumesinise ja lillaga - meie mudelis 11 tk),
mille hulgas ei sisaldu kasutajate tabelit (Person). 
 
Põhiolemid: 
* Watch - kell 
* Person - kasutaja/kollektsionäär või firma esindaja 
* Box - kellakarp 
* Organization - tootjad, edasimüüjad, hooldus 
* Settings - kellakarbi seade 
* Offer - pakkumine kollektsionäärile 
* Media - meediafailid kellade ja karpide kohta 
* Address - kasutaja/organisatsiooni aadress 
* ElectronicContact - elektrooniliste kontaktide loend 
* Log - logi 
* Access - paroolid ja kasutajanimed 
* Error - vead 
 
Type abiolemid: 
* WatchType - kellatüübid 
* PersonType - isikutüübid: admin, kasutaja 
* OrganizationType - organisatsioonitüübid: tootja, hooldaja, edasimüüja jt 
* ActionType - logi tüübid 
* ContactType - elektroonilise kontakti tüüp: skype, email, telefon jt 
 
Olekud: 
* PersonTypeState - isiku rolli kehtivus ajahetkel (isiku ja tüübi vaheline seos) 
* OrganizationTypeState - organisatsiooni olek(ud) ajahetkel 
 
Kuuluvus: 
* PersonWatch - isikute ja kellade vahelised seosed 
* PersonBox - isiku ja karbi vaheline seos 
* PersonAccess - isiku ja autentimisandmete vaheline seos 
* WatchInBox - kella ja karbi vaheline seos 
* ErrorInWatch - vea ja kella vaheline seos 
* SettingsInBox - seade ja karbi vaheline seos 
* WatchInOrganization - kella ja tootja vaheline seos 
* PersonInOrganization - isiku ja ettevõtte/organisatsiooni vaheline seos 
* SettingsOfWatchType - seade ja kellatüübi vaheline seos 
 
Abstraktsioonid: 
* Locator - abstraktsioon erinevate kontaktitüüpide jaoks 
* Party - abstraktsioon erinevate inimeste, organisatsioonide jt jaoks 
 
Kommunikatsioon: 
* OfferToPerson - isikule suunatud pakkumised 
* OfferFromPerson - isikult lähtuv pakkumine 
 
 
 
[[File:ww_andmemudel_06052018.png]]
 

Andmemudel valmis (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

== Veebiteenuse analüüs ==

Alljärgnevalt esitame kellakarpide infosüsteemi analüüsi järgmistes osades:

(1) toote/teenuse kirjeldus 
(2) probleemi kirjeldus 
(3) lahendus 
(4) süsteemi kasutajad 
(5) loodava API võimalused 
(6) funktsionaalsed nõuded 
(7) mittefunktsionaalsed nõuded 

=== Toote/teenuse kirjeldus ===
Teenuse eesmärgiks on lahendada probleem, kuidas jälgida kellakarpide kaudu mehhaaniliste käekellade seisundit ning keerata neid automaatselt üles distantsilt, näiteks juhul, kui kellade kollektsionäär ei asu füüsiliselt igapäevaselt oma kellade juures. Teenus võimaldab ka tootjal uuendada kontaktandmeid, saata personaalseid teateid. Administraatorile annab ülevaate platvormis toimuvast.

=== Probleemi kirjeldus ===
Mehhaaniliste käekellade kollektsionääride huvi kellakarpide vastu on mitmetahuline. Kollektsionääre huvitab arvepidamine – mitu kella, missuguste omaduste ja eripäradega neil kollektsioonis on. Teisalt soov eksponeerida oma kogusid kolleegidele ja sõpradele. Kellakarpidega täidetud sein või riiulid loovad selleks suurepärase võimaluse. Kolmandaks praktiline vajadus tagada kellavedrude õige vinnastatuse aste. Kaasaja mehhaanilised kellamehhanismid (''automatic'') võimaldavad kellakorpuse füüsilisel liigutamisel kellavedru automaatselt vinnastada.

Näiteks piisab kella kinnitamisest käele, et see hakkaks end käe liigutamisel üles keerama. Kuidas keerata aga üles seisvat kella, mis seisab paigal kellakarbis? Selleks on tänapäeva kellakarpides elektrimootor, mis tagab kella liigutamise vastavalt kellatüübile ettenähtud ööpäevase graafiku alusel. Kollektsionääride üheks probleemiks on see, kuidas juhtida sellist karpi ja omada jooksvat ülevaadet kõikidest oma karpidest, nende tehnilisest seadistusest ja kollektsiooni kuuluvatest kelladest olles tööreisil välisriigis?

=== Lahendus ===
Probleemi lahendamiseks ehitame REST + ASP.NET Core + WebAPI koos kliendiga, mis võimaldab kellakollektsionääridel hallata kellasid karpides, administraatoritel saada ülevaate süsteemist ning tootjatele lisada infot kollektsionääridele. Käesoleva projekti käigus '''ei tegeleta''' kahe IoT lahenduse kui terviku seisukohast olulise nüansiga: (i) karbi püsivara (''firmware'') loomisega, (ii) klientrakenduse ''frontend'' lõpliku häälestamisega (ilus .css ja pildid).

=== Süsteemi kasutajad ===
'''Kollektsionäär''' - haldab ja muudab infot oma kellade ning oma kellakarpide kohta. 
'''Administraator''' - haldab süsteemi infot, vajadusel eemaldab probleeme. 
'''Tootja''' - saab saata süsteemi kollektsionääridele mõeldud infot. 
'''Hooldaja''' - saab infot hooldamist vajavate kellade ja -karpide kohta. 

=== Loodava API võimalused ===
Alljärgnevalt vaatame loodava API võimalusi kasutajagruppide kaupa:

'''Kasutajale/kellakollektsionäärile'''
* Saada ülevaade kelladest ja kellakarpidest (lisada, muuta, vaadata).
* Muuta karbis oleva kella kohta käivat informatsiooni (kella nimi, tootja, tootmise aeg, viitenumber, mehhanism, jõureservi jääk (valikuline), foto kellast, kellarihma liik, muu).
* Karpe juhtida (keerata automaatselt üles). Näha ja muuta kella üleskeerava mehhanismi liikumise kiirust ja muid detaile (nt liikumise suund).
* Näha karbi seisundit, kas karp on hetkel wifiga ühendatud või mitte.
* Näha karbilt saabunud veateateid.
* Sisestada infot kella seisundist.
* Suhelda hooldajate ja tootjatega

'''Tootjale'''
* Uuendada kontaktandmeid.
* Saata personaalseid teateid kellakollektsionääridele.

'''Administraatorile'''
* Näha võrku ühendatud karpide arvu.
* Näha karpidesse paigaldatud kellade nimistut (ilma muude kasutajaandmeteta).
* Näha kellade üleskeeramise mehhanismide arvnäitajaid (madalaim kiirus, keskmine kiirus, tippkiirus; samuti liikumise suundade arvnäitajaid).
* IP-aadresside järgi ülevaadet, millistes riikides karpe kasutatakse (üldised arvandmed).
* Veateatega karpide arv süsteemis (üldised arvandmed).

=== Funktsionaalsed nõuded ===
* Kõik tegevused peavad olema autoriseeritud.
* REST + ASP.NET Core + WebAPI tagastab infot valideeritud JSON formaadis.
* API veatöötlus on tehtud, kasutades standardseid veakoode.
* API-le on tehtud 'health check'.
* Kõik kasutajad peavad saama end autoriseerida.
* Kasutaja, tootja ja administraatori tegevused logitakse.
* Logi ei ole muudetav, vaid on kättesaadav.
* Kasutaja ega tootja ei näe teiste kasutajate ega tootjate infot.
* API klient on kohanduv mobiilile, tahvlile ja desktoparvutile.
* Sisendandmed on valideeritud.

=== Mittefunktsionaalsed nõuded ===
* API-le on lisatud Swagger fail.
* Teenus ja tehniline lahendus on dokumenteeritud.
* Süsteemi kood on vabalt ligipääsetav, täiendatav ning allalaetav.

Esitame töö etappidena, kus kõigepealt defineerime ära Minimum Viable Producti [https://en.wikipedia.org/wiki/Minimum_viable_product] ehk selle miinimumi, mis pakub kasutajale maksimaalset väärtust. See tähendab API loomist ning esmase kliendi loomist kõigile MVP-s defineeritud kasutajagruppidele. Seejärel realiseerime projekti inkrementide ehk tootearenduse sammudena, milles lisame uusi funktsionaalsusi. Ideaalis jõuame realiseerida kõik sammud, kuid kuna teeme nimetatud tööd antud ajaraamis ja koosseisus esmakordselt, siis võtame vabaduse ka realiseerida korralikult niipalju, kui jõuame projekti käigus ära teha.

Võimalik, et meie lõpptulemus erineb mõnes osas esitatud analüüsist. Seda olenevalt sellest kui edukalt meil õnnestub plaanitud funktsionaalsusi realiseerida. Erisusi plaanime käsitleda vastavas 'post production' jaotuses, kus loendame ka projektist kogunenud peamised õppetunnid.

Analüüs valmis (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

== Minimum Viable Product definitsioon ==
'''Kasutaja'''
* Kasutaja saab süsteemi logida ning välja logida
* Kasutaja saab lisada uue kellakarbi
* Kasutaja saab lisada uue kella kellakarpi
* Kasutaja saab muuta kella infot kellakarbis
* Kasutaja saab näha ülevaadet oma karpidest
* Kasutaja saab muuta kellakarbi seadeid
* Kasutaja saab kustutada kella karbis
* Kasutaja saab kustutada kellakarbi

'''Administraator'''
* Näeb autoriseeritult logisid

'''Tootja'''
* Saab lisada kontaktandmeid
* Saab kontaktandmeid muuta

== Inkrement #1 ==
'''Kasutaja'''
* Näeb karbilt saabunud veateateid.
* Saab kellakarpe juhtida.

'''Administraator'''
* IP-aadresside järgi ülevaadet, millistes riikides karpe kasutatakse (üldised arvandmed).
* Karpidesse paigaldatud kellade nimistut (ilma muude kasutajaandmeteta).
* Näeb kasutajate statistikat.

'''Tootja'''
* Saata personaalseid teateid kellakollektsionääridele.

== Inkrement #2 ==
'''Kasutaja'''
* Saab saata teate tootjale.
* Näeb tootja vastust.
* Näha karbi seisundit, kas karp on hetkel wifiga ühendatud või mitte.

'''Administraator'''
* Näha kellade üleskeeramise mehhanismide arvnäitajaid (madalaim kiirus, keskmine kiirus, tippkiirus; samuti liikumise suundade arvnäitajaid).
* Näeb tegevuste ajalugu kliendist.

'''Tootja'''
* Saab lugeda kasutaja teadet.
* Saab vastata kasutajale.

'''Hooldaja'''
* Saab info hooldamist vajavate kellade kohta.

== Inkrement #3 ==
'''Kasutaja'''
* On ehitatud keeletugi.

'''Tootja'''
* On ehitatud keeletugi.

'''Hooldaja'''
* On ehitatud keeletugi.

Inkrementid valmisid (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

= XML ülesanne =
Järgnevalt esitame oma XML-ülesande tulemused.

== IT Management Transformation XML To XML ==
<pre>
<?xml version="1.0" encoding="utf-8"?>
<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">
<xsl:output method="xml" indent="yes"/>
<xsl:template match="/">
<unhandledDevices>
<xsl:for-each select="customers/customer/locations/location/items/item[@isInWorkingCondition='false']">
<device>
<name>
<xsl:value-of select="manufacturer"/>
<xsl:text> </xsl:text>
<xsl:value-of select="model"/>
</name>
<ticket>
<xsl:for-each select="tickets/ticket[@isHandled='false']">
<ticket_id>
<xsl:value-of select="@id"/>
</ticket_id>
<issued_in>
<xsl:value-of select="@issuedIn"/>
</issued_in>
<description>
<xsl:value-of select="description"/>
</description>
</xsl:for-each>
</ticket>
</device>
</xsl:for-each>
</unhandledDevices>
</xsl:template>
</xsl:stylesheet>
</pre>

== IT Management Transformation HTML ==

<pre>
<?xml version="1.0" encoding="utf-8"?>
<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">
<xsl:output method="html" indent="yes"/>
<xsl:template match="/">

<html>
<head>
<title>ItManagement Laptops</title>
</head>
<body style="background-color:#F7F7F7">
<h1>Computers</h1>
<xsl:for-each select="/customers/customer/locations/location/items/item[@type='laptopComputer']">
<xsl:sort select="@isActive='false'"/>
<hr />
<div>
<h3>
<xsl:value-of select="manufacturer"/>
</h3>
Model: 
<xsl:value-of select="model"/>
 
Serial number: 
<xsl:value-of select="serialNumber"/>
 
Date of purchase: 
<xsl:value-of select="dateOfPurchase"/>
 
Operating system: 
<xsl:value-of select="operatingSystem"/>
 
Is on active list: 
<xsl:value-of select="@isActive"/>
 
</div>

<div style="background-color:#E3FAEE" >

<xsl:for-each select="tickets/ticket">
<xsl:choose>
<xsl:when test="@isHandled='true'">
<h3>Handled tickets</h3>
<ul>
Issued in: 
<xsl:value-of select="@issuedIn"/>
 
Ticket ID: 
<xsl:value-of select="@id" />
 
Description: 
<xsl:value-of select="description"/>
 
Solution: 
<xsl:value-of select="solution"/>
 
</ul>
</xsl:when>
<xsl:when test="@isHandled='false'">
<div style="background-color:#FDE5E5">
<h3>Unhandled tickets</h3>
<ul>
Issued in: 
<xsl:value-of select="@issuedIn"/>
 
Ticket ID: 
<xsl:value-of select="@id" />
 
Description: 
<xsl:value-of select="description"/>
 
Solution: 
<xsl:value-of select="solution"/>
 
</ul>
</div>
</xsl:when>
</xsl:choose>
</xsl:for-each>

</div>
</xsl:for-each>
</body>
</html>
</xsl:template>
</xsl:stylesheet>
</pre>

== IT Management XSD ==

<pre>
<?xml version="1.0" encoding="utf-8"?>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="customers">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="customer">
<xs:complexType>
<xs:sequence>
<xs:element name="customerName" type="xs:string" />
<xs:element minOccurs="0" name="contactPerson" type="xs:string" />
<xs:element name="e-mail" type="xs:string" />
<xs:element name="phoneNumber" type="xs:string" />
<xs:element name="locations">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="location">
<xs:complexType>
<xs:sequence>
<xs:element name="city" type="xs:string" />
<xs:element name="address" type="xs:string" />
<xs:element name="comment" type="xs:string" />
<xs:element minOccurs="0" name="localContactPerson" type="xs:string" />
<xs:element minOccurs="0" name="localPhone" type="xs:string" />
<xs:element name="items">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="item">
<xs:complexType>
<xs:sequence>
<xs:element name="manufacturer" type="xs:string" />
<xs:element name="model" type="xs:string" />
<xs:element name="serialNumber" type="xs:string" />
<xs:element name="dateOfPurchase" type="xs:date" />
<xs:element minOccurs="0" name="operatingSystem">
<xs:complexType>
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute name="version" type="xs:string" use="required" />
</xs:extension>
</xs:simpleContent>
</xs:complexType>
</xs:element>
<xs:element minOccurs="0" name="tickets">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="ticket">
<xs:complexType>
<xs:sequence>
<xs:element name="description" type="xs:string" />
<xs:element name="solution" type="xs:string" />
</xs:sequence>
<xs:attribute name="id" type="xs:string" use="required" />
<xs:attribute name="issuedIn" type="xs:date" use="required" />
<xs:attribute name="isHandled" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:unsignedInt" use="required" />
<xs:attribute name="type" type="xs:string" use="required" />
<xs:attribute name="isActive" type="xs:boolean" use="required" />
<xs:attribute name="isUnderWarranty" type="xs:boolean" use="required" />
<xs:attribute name="warrantyInMonths" type="xs:unsignedByte" use="required" />
<xs:attribute name="isInWorkingCondition" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="type" type="xs:string" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:unsignedInt" use="required" />
<xs:attribute name="type" type="xs:string" use="required" />
<xs:attribute name="isActive" type="xs:boolean" use="required" />
<xs:attribute name="hasManyLocations" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
</pre>

== IT Management XML ==

<pre>
<?xml version="1.0" encoding="utf-8" ?>
<customers>
<customer id="33" type="company" isActive="true" hasManyLocations="true">
<customerName>Elamustevaba OÜ</customerName>
<contactPerson>Juhan Pühamees</contactPerson>
<e-mail>juhan@evaba.com</e-mail>
<phoneNumber>+37256565656</phoneNumber>
<locations>
<location type="office">
<city>Tallinn</city>
<address><![CDATA[Pikk 7, 56401]]></address>
<comment><![CDATA[3. korrus -> paremat kätt]]></comment>
<localContactPerson>Maiu Piimaauto</localContactPerson>
<localPhone>+3726510510</localPhone>
<items>
<item id="1" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="36" isInWorkingCondition="false">
<manufacturer>Dell</manufacturer>
<model>Inspiron 3558</model>
<serialNumber>6FGH5JN</serialNumber>
<dateOfPurchase>2017-07-22</dateOfPurchase>
<operatingSystem version="1709">Windows 10 Home</operatingSystem>
<tickets>
<ticket id="HWI001" issuedIn="2017-11-21" isHandled="true">
<description><![CDATA[Wi-Fi is not working]]></description>
<solution><![CDATA[Wi-Fi card replaced (Under the warranty)]]></solution>
</ticket>
<ticket id="SWI256" issuedIn="2018-05-05" isHandled="false">
<description><![CDATA[Computer keeps showing login screen]]></description>
<solution></solution>
</ticket>
</tickets>
</item>
<item id="55" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="60" isInWorkingCondition="true">
<manufacturer>Dell</manufacturer>
<model>Latitude E7550</model>
<serialNumber>8JGR78U</serialNumber>
<dateOfPurchase>2016-06-15</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Home</operatingSystem>
</item>
</items>
</location>
<location type="store">
<city>Tallinn</city>
<address><![CDATA[Lai 17, 56401]]></address>
<comment><![CDATA[keldrikorrusel]]></comment>
<localContactPerson>Tanja Õielemb</localContactPerson>
<localPhone>+3726510520</localPhone>
<items>
<item id="83" type="desktopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Lenovo</manufacturer>
<model>ThinkCentre M715</model>
<serialNumber>IO25689AD54KL</serialNumber>
<dateOfPurchase>2017-12-01</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Pro</operatingSystem>
</item>
<item id="12" type="monitor" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>AOC</manufacturer>
<model>L456</model>
<serialNumber>9803987YE54</serialNumber>
<dateOfPurchase>2015-05-03</dateOfPurchase>
<tickets>
<ticket id="HWI126" issuedIn="2016-01-18" isHandled="true">
<description><![CDATA[Doesn't work, no picture.]]></description>
<solution><![CDATA[Wasn't plugged in. Technician did it - works again!]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
<customer id="02" type="private" isActive="true" hasManyLocations="false">
<customerName>Kessu Sisselasi</customerName>
<e-mail>kessu@tripp.org</e-mail>
<phoneNumber>+372555555</phoneNumber>
<locations>
<location type="home">
<city>Saue</city>
<address><![CDATA[Kooli 4-8, 78965]]></address>
<comment><![CDATA[2. korrus. Kitsad koridorid.]]></comment>
<items>
<item id="98" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Acer</manufacturer>
<model>Aspire 5</model>
<serialNumber>475YRT89K4</serialNumber>
<dateOfPurchase>2018-03-25</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Home</operatingSystem>
</item>
<item id="4" type="laptopComputer" isActive="false" isUnderWarranty="false" warrantyInMonths="36" isInWorkingCondition="true">
<manufacturer>Lenovo</manufacturer>
<model>IdeaPad L530</model>
<serialNumber>U89TRY765ME</serialNumber>
<dateOfPurchase>2007-08-14</dateOfPurchase>
<operatingSystem version="">Windows XP</operatingSystem>
<tickets>
<ticket id="SWI069" issuedIn="2010-01-28" isHandled="true">
<description><![CDATA[Blue screen.]]></description>
<solution><![CDATA[Video driver update.]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
<customer id="26" type="company" isActive="true" hasManyLocations="true">
<customerName>Aktsiaselts OÜ</customerName>
<contactPerson>Gunnar Kuningas</contactPerson>
<e-mail>gunnar@kunn.ee</e-mail>
<phoneNumber>+3726985236</phoneNumber>
<locations>
<location type="office">
<city>Loksa</city>
<address><![CDATA[Kalda 14, 78965]]></address>
<comment><![CDATA[Sissepääs Rimi poolt, helesinine uks]]></comment>
<items>
<item id="26" type="laptopComputer" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Apple</manufacturer>
<model>Macbook Air</model>
<serialNumber>258JUY369</serialNumber>
<dateOfPurchase>2017-03-01</dateOfPurchase>
<operatingSystem version="High Sierra">OS X</operatingSystem>
</item>
<item id="59" type="laptopComputer" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="false">
<manufacturer>Acer</manufacturer>
<model>Chromebook 11</model>
<serialNumber>U89TRY765ME</serialNumber>
<dateOfPurchase>2016-04-23</dateOfPurchase>
<operatingSystem version="">Chrome OS</operatingSystem>
<tickets>
<ticket id="HWI046" issuedIn="2010-02-28" isHandled="false">
<description><![CDATA[Stripes on screen]]></description>
<solution><![CDATA[]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
</customers>
</pre>

= Link klientrakendusele ja API-le =
https://drive.google.com/file/d/1FU3XGGVHbn4BNNHAsOs7DQ4CzpEDwZUt/view?usp=sharing

== Palun loe seda readme asemel ==

1. meie rakenduse implementeeritud skoop lähtub siin lehel (ülal), analüüsi osas defineeritud "Minimum viable product" kriteeriumitest 
2. lase API käima, tee andmebaaside migratsioonid ja update-database 
3. implementeeritud on kõik teenused, mis on nähtaval Swaggeris aadressil: "localhost:[pordinumber]/Swagger" 
4. kliendirakendus asub kataloogis 'WatchWindersClient' ja tegemist on solutioniga, mille võiks käivitada teises Visual Studio aknas 
5. klientrakenduse käivitumiseks tuleks muuta App.config failis muuta ära localhost portide numbrid asendades need enda arvutis oleva localhost pordiga ning lisada kehtiv JWT AccessToken, mille saab Postmaniga aadressilt api/Security/getToken "Email" ja "Password" abil pärast seda kui kasutaja on loodud 
6. küsimuste ja raskuste korral kirjuta tiit.kuuskmae@gmail.com (API) ja toomas.juhkov@gmail.com (klient). Vastame esimesel võimalusel.

= Kasutatud kirjandus ja allikad =

1. Albahari, Joseph, Albari, Ben 2017. C# 7.0 in A Nutshell. Sebastopol: O’Reilly 
2. MariaDB Foundation. MariaDB. Kättesaadav:https://mariadb.org/ 
3. Martin, Robert 2018. Clean Architecture. Boston: Pearson Education

WatchWinders

2018-06-08T20:19:57Z

Tkuuskma: /* Readme asemel */

= Meeskond =

Toomas Juhkov, toomas.juhkov@gmail.com 
Tiit Kuuskmäe, tiit.kuuskmae@gmail.com 
Kunnar Kukk, Kunnar.kukk@gmail.com 

= Tegevuste logi =

08.02.2018 - meeskonna loomine, kokkuleppe sõlmimine teema osas 
10.02.2018 - õppejõu teavitamine koos esmase andmemudeliga 
15.02.2018 - lõpliku andmemudeli valmimine(versioon 5) 
18.02.2018 - õppejõu kinnitus, et teema ja meeskond kvalifiseeruvad 
22.02.2018 - viki lehe loomine ja analüüsi koostamise alustamine 
26.02.2018 - tiimi lisandus Kunnar Kukk 
01.03.2018 - tiimi sprint koosolek(seoses täiendava tiimiliikme lisandumisega täpsustasime skoopi) 
03.03.2018 - alustasime koodi kirjutamisega (tabelid klassideks ja annotatsioonid peale) 
06.03.2018 - täiendasime andmemudelit olemiga "UserTypeState" (et saaks muuta kasutajatüüpi) 
08.03.2018 - tiimi sprint koosolek 
18.03.2018 - lisasime olemid "Address", "AddressU", "AddressM", "OfferOfUser", "MediaInOffer" 
22.03.2018 - tiimi sprint koosolek, mis oli pühendatud andmemudeli täiendamisele 
23.03.2018 - pikem tiimi hackathon andmemudeli teemal 
29.03.2018 - täiendatud wiki lehte täielikult ringitöötatud andmemudeliga 
30.03.2018 - täiendatud wiki lehte andmemudeli metainfoga 
09.04.2018 - silusime andmemudelit (mõningad ebavajalikud viited olid sisse jäänud) 
06.05.2018 - panime uuendatud andmemudeli projekti wiki lehele üles 
07.05.2018 - osalesime õppejõu Mait Poska korraldatud hackathonil 
08.06.2018 - XML ülesanne, klientrakenduse ja API kood sai wiki lehel avalikuks 

Terve maikuu oli igapäevane suhtlus üle Skype'i ja fleep.io, mida me ei loginud (liiga tihedaks läks!).

= Kasutatavad metoodikad =

WatchWinders projektis plaanime kasutada peamiselt kaht metoodikat:

1. läbiv retsenseerimine (üks paariline teeb midagi valmis ja teine teeb sellele ülevaatuse; üksus lisatakse kui ülevaatus on lõplikult läbitud ning osapoolte vahel on saabunud konsensus) 
2. paaris programmeerimine (istume ühe masina taha maha ja kirjutame kolmekesi)

Tulenevalt kaugõppe formaadist saab ülekaalus olema esimene variant. Teist metoodikat kasutame nende osade kirjutamiseks, mille puhul võib arvata, et nende lahendamine on keeruline või et lahenduskäike võib olla väga erinevaid. Püüame jooksvalt siinses vikis kajastada ka seda, millise metoodika järgi üks või teine osa valmis.

= Projekti osad =

Alljärgnevalt anname ülevaate projekti osadest: 

(1) andmemudel 
(2) veebiteenuse analüüs 
(3) Minimum Viable Product definitsioon 
(4) Inkrement #1 
(5) Inkrement #2 
(6) Inkrement #3 

Projekti osad on meie viki lehel kirjeldatud valmimise järjekorras.

== Andmemudel ==

Andmemudeli koostamisel lähtusime õppejõu ette antud kriteeriumist, mille järgi andmemudelis on vähemalt 6 põhiolemit (tähistatud tumesinise ja lillaga - meie mudelis 11 tk),
mille hulgas ei sisaldu kasutajate tabelit (Person). 
 
Põhiolemid: 
* Watch - kell 
* Person - kasutaja/kollektsionäär või firma esindaja 
* Box - kellakarp 
* Organization - tootjad, edasimüüjad, hooldus 
* Settings - kellakarbi seade 
* Offer - pakkumine kollektsionäärile 
* Media - meediafailid kellade ja karpide kohta 
* Address - kasutaja/organisatsiooni aadress 
* ElectronicContact - elektrooniliste kontaktide loend 
* Log - logi 
* Access - paroolid ja kasutajanimed 
* Error - vead 
 
Type abiolemid: 
* WatchType - kellatüübid 
* PersonType - isikutüübid: admin, kasutaja 
* OrganizationType - organisatsioonitüübid: tootja, hooldaja, edasimüüja jt 
* ActionType - logi tüübid 
* ContactType - elektroonilise kontakti tüüp: skype, email, telefon jt 
 
Olekud: 
* PersonTypeState - isiku rolli kehtivus ajahetkel (isiku ja tüübi vaheline seos) 
* OrganizationTypeState - organisatsiooni olek(ud) ajahetkel 
 
Kuuluvus: 
* PersonWatch - isikute ja kellade vahelised seosed 
* PersonBox - isiku ja karbi vaheline seos 
* PersonAccess - isiku ja autentimisandmete vaheline seos 
* WatchInBox - kella ja karbi vaheline seos 
* ErrorInWatch - vea ja kella vaheline seos 
* SettingsInBox - seade ja karbi vaheline seos 
* WatchInOrganization - kella ja tootja vaheline seos 
* PersonInOrganization - isiku ja ettevõtte/organisatsiooni vaheline seos 
* SettingsOfWatchType - seade ja kellatüübi vaheline seos 
 
Abstraktsioonid: 
* Locator - abstraktsioon erinevate kontaktitüüpide jaoks 
* Party - abstraktsioon erinevate inimeste, organisatsioonide jt jaoks 
 
Kommunikatsioon: 
* OfferToPerson - isikule suunatud pakkumised 
* OfferFromPerson - isikult lähtuv pakkumine 
 
 
 
[[File:ww_andmemudel_06052018.png]]
 

Andmemudel valmis (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

== Veebiteenuse analüüs ==

Alljärgnevalt esitame kellakarpide infosüsteemi analüüsi järgmistes osades:

(1) toote/teenuse kirjeldus 
(2) probleemi kirjeldus 
(3) lahendus 
(4) süsteemi kasutajad 
(5) loodava API võimalused 
(6) funktsionaalsed nõuded 
(7) mittefunktsionaalsed nõuded 

=== Toote/teenuse kirjeldus ===
Teenuse eesmärgiks on lahendada probleem, kuidas jälgida kellakarpide kaudu mehhaaniliste käekellade seisundit ning keerata neid automaatselt üles distantsilt, näiteks juhul, kui kellade kollektsionäär ei asu füüsiliselt igapäevaselt oma kellade juures. Teenus võimaldab ka tootjal uuendada kontaktandmeid, saata personaalseid teateid. Administraatorile annab ülevaate platvormis toimuvast.

=== Probleemi kirjeldus ===
Mehhaaniliste käekellade kollektsionääride huvi kellakarpide vastu on mitmetahuline. Kollektsionääre huvitab arvepidamine – mitu kella, missuguste omaduste ja eripäradega neil kollektsioonis on. Teisalt soov eksponeerida oma kogusid kolleegidele ja sõpradele. Kellakarpidega täidetud sein või riiulid loovad selleks suurepärase võimaluse. Kolmandaks praktiline vajadus tagada kellavedrude õige vinnastatuse aste. Kaasaja mehhaanilised kellamehhanismid (''automatic'') võimaldavad kellakorpuse füüsilisel liigutamisel kellavedru automaatselt vinnastada.

Näiteks piisab kella kinnitamisest käele, et see hakkaks end käe liigutamisel üles keerama. Kuidas keerata aga üles seisvat kella, mis seisab paigal kellakarbis? Selleks on tänapäeva kellakarpides elektrimootor, mis tagab kella liigutamise vastavalt kellatüübile ettenähtud ööpäevase graafiku alusel. Kollektsionääride üheks probleemiks on see, kuidas juhtida sellist karpi ja omada jooksvat ülevaadet kõikidest oma karpidest, nende tehnilisest seadistusest ja kollektsiooni kuuluvatest kelladest olles tööreisil välisriigis?

=== Lahendus ===
Probleemi lahendamiseks ehitame REST + ASP.NET Core + WebAPI koos kliendiga, mis võimaldab kellakollektsionääridel hallata kellasid karpides, administraatoritel saada ülevaate süsteemist ning tootjatele lisada infot kollektsionääridele. Käesoleva projekti käigus '''ei tegeleta''' kahe IoT lahenduse kui terviku seisukohast olulise nüansiga: (i) karbi püsivara (''firmware'') loomisega, (ii) klientrakenduse ''frontend'' lõpliku häälestamisega (ilus .css ja pildid).

=== Süsteemi kasutajad ===
'''Kollektsionäär''' - haldab ja muudab infot oma kellade ning oma kellakarpide kohta. 
'''Administraator''' - haldab süsteemi infot, vajadusel eemaldab probleeme. 
'''Tootja''' - saab saata süsteemi kollektsionääridele mõeldud infot. 
'''Hooldaja''' - saab infot hooldamist vajavate kellade ja -karpide kohta. 

=== Loodava API võimalused ===
Alljärgnevalt vaatame loodava API võimalusi kasutajagruppide kaupa:

'''Kasutajale/kellakollektsionäärile'''
* Saada ülevaade kelladest ja kellakarpidest (lisada, muuta, vaadata).
* Muuta karbis oleva kella kohta käivat informatsiooni (kella nimi, tootja, tootmise aeg, viitenumber, mehhanism, jõureservi jääk (valikuline), foto kellast, kellarihma liik, muu).
* Karpe juhtida (keerata automaatselt üles). Näha ja muuta kella üleskeerava mehhanismi liikumise kiirust ja muid detaile (nt liikumise suund).
* Näha karbi seisundit, kas karp on hetkel wifiga ühendatud või mitte.
* Näha karbilt saabunud veateateid.
* Sisestada infot kella seisundist.
* Suhelda hooldajate ja tootjatega

'''Tootjale'''
* Uuendada kontaktandmeid.
* Saata personaalseid teateid kellakollektsionääridele.

'''Administraatorile'''
* Näha võrku ühendatud karpide arvu.
* Näha karpidesse paigaldatud kellade nimistut (ilma muude kasutajaandmeteta).
* Näha kellade üleskeeramise mehhanismide arvnäitajaid (madalaim kiirus, keskmine kiirus, tippkiirus; samuti liikumise suundade arvnäitajaid).
* IP-aadresside järgi ülevaadet, millistes riikides karpe kasutatakse (üldised arvandmed).
* Veateatega karpide arv süsteemis (üldised arvandmed).

=== Funktsionaalsed nõuded ===
* Kõik tegevused peavad olema autoriseeritud.
* REST + ASP.NET Core + WebAPI tagastab infot valideeritud JSON formaadis.
* API veatöötlus on tehtud, kasutades standardseid veakoode.
* API-le on tehtud 'health check'.
* Kõik kasutajad peavad saama end autoriseerida.
* Kasutaja, tootja ja administraatori tegevused logitakse.
* Logi ei ole muudetav, vaid on kättesaadav.
* Kasutaja ega tootja ei näe teiste kasutajate ega tootjate infot.
* API klient on kohanduv mobiilile, tahvlile ja desktoparvutile.
* Sisendandmed on valideeritud.

=== Mittefunktsionaalsed nõuded ===
* API-le on lisatud Swagger fail.
* Teenus ja tehniline lahendus on dokumenteeritud.
* Süsteemi kood on vabalt ligipääsetav, täiendatav ning allalaetav.

Esitame töö etappidena, kus kõigepealt defineerime ära Minimum Viable Producti [https://en.wikipedia.org/wiki/Minimum_viable_product] ehk selle miinimumi, mis pakub kasutajale maksimaalset väärtust. See tähendab API loomist ning esmase kliendi loomist kõigile MVP-s defineeritud kasutajagruppidele. Seejärel realiseerime projekti inkrementide ehk tootearenduse sammudena, milles lisame uusi funktsionaalsusi. Ideaalis jõuame realiseerida kõik sammud, kuid kuna teeme nimetatud tööd antud ajaraamis ja koosseisus esmakordselt, siis võtame vabaduse ka realiseerida korralikult niipalju, kui jõuame projekti käigus ära teha.

Võimalik, et meie lõpptulemus erineb mõnes osas esitatud analüüsist. Seda olenevalt sellest kui edukalt meil õnnestub plaanitud funktsionaalsusi realiseerida. Erisusi plaanime käsitleda vastavas 'post production' jaotuses, kus loendame ka projektist kogunenud peamised õppetunnid.

Analüüs valmis (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

== Minimum Viable Product definitsioon ==
'''Kasutaja'''
* Kasutaja saab süsteemi logida ning välja logida
* Kasutaja saab lisada uue kellakarbi
* Kasutaja saab lisada uue kella kellakarpi
* Kasutaja saab muuta kella infot kellakarbis
* Kasutaja saab näha ülevaadet oma karpidest
* Kasutaja saab muuta kellakarbi seadeid
* Kasutaja saab kustutada kella karbis
* Kasutaja saab kustutada kellakarbi

'''Administraator'''
* Näeb autoriseeritult logisid

'''Tootja'''
* Saab lisada kontaktandmeid
* Saab kontaktandmeid muuta

== Inkrement #1 ==
'''Kasutaja'''
* Näeb karbilt saabunud veateateid.
* Saab kellakarpe juhtida.

'''Administraator'''
* IP-aadresside järgi ülevaadet, millistes riikides karpe kasutatakse (üldised arvandmed).
* Karpidesse paigaldatud kellade nimistut (ilma muude kasutajaandmeteta).
* Näeb kasutajate statistikat.

'''Tootja'''
* Saata personaalseid teateid kellakollektsionääridele.

== Inkrement #2 ==
'''Kasutaja'''
* Saab saata teate tootjale.
* Näeb tootja vastust.
* Näha karbi seisundit, kas karp on hetkel wifiga ühendatud või mitte.

'''Administraator'''
* Näha kellade üleskeeramise mehhanismide arvnäitajaid (madalaim kiirus, keskmine kiirus, tippkiirus; samuti liikumise suundade arvnäitajaid).
* Näeb tegevuste ajalugu kliendist.

'''Tootja'''
* Saab lugeda kasutaja teadet.
* Saab vastata kasutajale.

'''Hooldaja'''
* Saab info hooldamist vajavate kellade kohta.

== Inkrement #3 ==
'''Kasutaja'''
* On ehitatud keeletugi.

'''Tootja'''
* On ehitatud keeletugi.

'''Hooldaja'''
* On ehitatud keeletugi.

Inkrementid valmisid (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

= XML ülesanne =
Järgnevalt esitame oma XML-ülesande tulemused.

== IT Management Transformation XML To XML ==
<pre>
<?xml version="1.0" encoding="utf-8"?>
<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">
<xsl:output method="xml" indent="yes"/>
<xsl:template match="/">
<unhandledDevices>
<xsl:for-each select="customers/customer/locations/location/items/item[@isInWorkingCondition='false']">
<device>
<name>
<xsl:value-of select="manufacturer"/>
<xsl:text> </xsl:text>
<xsl:value-of select="model"/>
</name>
<ticket>
<xsl:for-each select="tickets/ticket[@isHandled='false']">
<ticket_id>
<xsl:value-of select="@id"/>
</ticket_id>
<issued_in>
<xsl:value-of select="@issuedIn"/>
</issued_in>
<description>
<xsl:value-of select="description"/>
</description>
</xsl:for-each>
</ticket>
</device>
</xsl:for-each>
</unhandledDevices>
</xsl:template>
</xsl:stylesheet>
</pre>

== IT Management Transformation HTML ==

<pre>
<?xml version="1.0" encoding="utf-8"?>
<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">
<xsl:output method="html" indent="yes"/>
<xsl:template match="/">

<html>
<head>
<title>ItManagement Laptops</title>
</head>
<body style="background-color:#F7F7F7">
<h1>Computers</h1>
<xsl:for-each select="/customers/customer/locations/location/items/item[@type='laptopComputer']">
<xsl:sort select="@isActive='false'"/>
<hr />
<div>
<h3>
<xsl:value-of select="manufacturer"/>
</h3>
Model: 
<xsl:value-of select="model"/>
 
Serial number: 
<xsl:value-of select="serialNumber"/>
 
Date of purchase: 
<xsl:value-of select="dateOfPurchase"/>
 
Operating system: 
<xsl:value-of select="operatingSystem"/>
 
Is on active list: 
<xsl:value-of select="@isActive"/>
 
</div>

<div style="background-color:#E3FAEE" >

<xsl:for-each select="tickets/ticket">
<xsl:choose>
<xsl:when test="@isHandled='true'">
<h3>Handled tickets</h3>
<ul>
Issued in: 
<xsl:value-of select="@issuedIn"/>
 
Ticket ID: 
<xsl:value-of select="@id" />
 
Description: 
<xsl:value-of select="description"/>
 
Solution: 
<xsl:value-of select="solution"/>
 
</ul>
</xsl:when>
<xsl:when test="@isHandled='false'">
<div style="background-color:#FDE5E5">
<h3>Unhandled tickets</h3>
<ul>
Issued in: 
<xsl:value-of select="@issuedIn"/>
 
Ticket ID: 
<xsl:value-of select="@id" />
 
Description: 
<xsl:value-of select="description"/>
 
Solution: 
<xsl:value-of select="solution"/>
 
</ul>
</div>
</xsl:when>
</xsl:choose>
</xsl:for-each>

</div>
</xsl:for-each>
</body>
</html>
</xsl:template>
</xsl:stylesheet>
</pre>

== IT Management XSD ==

<pre>
<?xml version="1.0" encoding="utf-8"?>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="customers">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="customer">
<xs:complexType>
<xs:sequence>
<xs:element name="customerName" type="xs:string" />
<xs:element minOccurs="0" name="contactPerson" type="xs:string" />
<xs:element name="e-mail" type="xs:string" />
<xs:element name="phoneNumber" type="xs:string" />
<xs:element name="locations">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="location">
<xs:complexType>
<xs:sequence>
<xs:element name="city" type="xs:string" />
<xs:element name="address" type="xs:string" />
<xs:element name="comment" type="xs:string" />
<xs:element minOccurs="0" name="localContactPerson" type="xs:string" />
<xs:element minOccurs="0" name="localPhone" type="xs:string" />
<xs:element name="items">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="item">
<xs:complexType>
<xs:sequence>
<xs:element name="manufacturer" type="xs:string" />
<xs:element name="model" type="xs:string" />
<xs:element name="serialNumber" type="xs:string" />
<xs:element name="dateOfPurchase" type="xs:date" />
<xs:element minOccurs="0" name="operatingSystem">
<xs:complexType>
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute name="version" type="xs:string" use="required" />
</xs:extension>
</xs:simpleContent>
</xs:complexType>
</xs:element>
<xs:element minOccurs="0" name="tickets">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="ticket">
<xs:complexType>
<xs:sequence>
<xs:element name="description" type="xs:string" />
<xs:element name="solution" type="xs:string" />
</xs:sequence>
<xs:attribute name="id" type="xs:string" use="required" />
<xs:attribute name="issuedIn" type="xs:date" use="required" />
<xs:attribute name="isHandled" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:unsignedInt" use="required" />
<xs:attribute name="type" type="xs:string" use="required" />
<xs:attribute name="isActive" type="xs:boolean" use="required" />
<xs:attribute name="isUnderWarranty" type="xs:boolean" use="required" />
<xs:attribute name="warrantyInMonths" type="xs:unsignedByte" use="required" />
<xs:attribute name="isInWorkingCondition" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="type" type="xs:string" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:unsignedInt" use="required" />
<xs:attribute name="type" type="xs:string" use="required" />
<xs:attribute name="isActive" type="xs:boolean" use="required" />
<xs:attribute name="hasManyLocations" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
</pre>

== IT Management XML ==

<pre>
<?xml version="1.0" encoding="utf-8" ?>
<customers>
<customer id="33" type="company" isActive="true" hasManyLocations="true">
<customerName>Elamustevaba OÜ</customerName>
<contactPerson>Juhan Pühamees</contactPerson>
<e-mail>juhan@evaba.com</e-mail>
<phoneNumber>+37256565656</phoneNumber>
<locations>
<location type="office">
<city>Tallinn</city>
<address><![CDATA[Pikk 7, 56401]]></address>
<comment><![CDATA[3. korrus -> paremat kätt]]></comment>
<localContactPerson>Maiu Piimaauto</localContactPerson>
<localPhone>+3726510510</localPhone>
<items>
<item id="1" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="36" isInWorkingCondition="false">
<manufacturer>Dell</manufacturer>
<model>Inspiron 3558</model>
<serialNumber>6FGH5JN</serialNumber>
<dateOfPurchase>2017-07-22</dateOfPurchase>
<operatingSystem version="1709">Windows 10 Home</operatingSystem>
<tickets>
<ticket id="HWI001" issuedIn="2017-11-21" isHandled="true">
<description><![CDATA[Wi-Fi is not working]]></description>
<solution><![CDATA[Wi-Fi card replaced (Under the warranty)]]></solution>
</ticket>
<ticket id="SWI256" issuedIn="2018-05-05" isHandled="false">
<description><![CDATA[Computer keeps showing login screen]]></description>
<solution></solution>
</ticket>
</tickets>
</item>
<item id="55" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="60" isInWorkingCondition="true">
<manufacturer>Dell</manufacturer>
<model>Latitude E7550</model>
<serialNumber>8JGR78U</serialNumber>
<dateOfPurchase>2016-06-15</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Home</operatingSystem>
</item>
</items>
</location>
<location type="store">
<city>Tallinn</city>
<address><![CDATA[Lai 17, 56401]]></address>
<comment><![CDATA[keldrikorrusel]]></comment>
<localContactPerson>Tanja Õielemb</localContactPerson>
<localPhone>+3726510520</localPhone>
<items>
<item id="83" type="desktopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Lenovo</manufacturer>
<model>ThinkCentre M715</model>
<serialNumber>IO25689AD54KL</serialNumber>
<dateOfPurchase>2017-12-01</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Pro</operatingSystem>
</item>
<item id="12" type="monitor" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>AOC</manufacturer>
<model>L456</model>
<serialNumber>9803987YE54</serialNumber>
<dateOfPurchase>2015-05-03</dateOfPurchase>
<tickets>
<ticket id="HWI126" issuedIn="2016-01-18" isHandled="true">
<description><![CDATA[Doesn't work, no picture.]]></description>
<solution><![CDATA[Wasn't plugged in. Technician did it - works again!]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
<customer id="02" type="private" isActive="true" hasManyLocations="false">
<customerName>Kessu Sisselasi</customerName>
<e-mail>kessu@tripp.org</e-mail>
<phoneNumber>+372555555</phoneNumber>
<locations>
<location type="home">
<city>Saue</city>
<address><![CDATA[Kooli 4-8, 78965]]></address>
<comment><![CDATA[2. korrus. Kitsad koridorid.]]></comment>
<items>
<item id="98" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Acer</manufacturer>
<model>Aspire 5</model>
<serialNumber>475YRT89K4</serialNumber>
<dateOfPurchase>2018-03-25</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Home</operatingSystem>
</item>
<item id="4" type="laptopComputer" isActive="false" isUnderWarranty="false" warrantyInMonths="36" isInWorkingCondition="true">
<manufacturer>Lenovo</manufacturer>
<model>IdeaPad L530</model>
<serialNumber>U89TRY765ME</serialNumber>
<dateOfPurchase>2007-08-14</dateOfPurchase>
<operatingSystem version="">Windows XP</operatingSystem>
<tickets>
<ticket id="SWI069" issuedIn="2010-01-28" isHandled="true">
<description><![CDATA[Blue screen.]]></description>
<solution><![CDATA[Video driver update.]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
<customer id="26" type="company" isActive="true" hasManyLocations="true">
<customerName>Aktsiaselts OÜ</customerName>
<contactPerson>Gunnar Kuningas</contactPerson>
<e-mail>gunnar@kunn.ee</e-mail>
<phoneNumber>+3726985236</phoneNumber>
<locations>
<location type="office">
<city>Loksa</city>
<address><![CDATA[Kalda 14, 78965]]></address>
<comment><![CDATA[Sissepääs Rimi poolt, helesinine uks]]></comment>
<items>
<item id="26" type="laptopComputer" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Apple</manufacturer>
<model>Macbook Air</model>
<serialNumber>258JUY369</serialNumber>
<dateOfPurchase>2017-03-01</dateOfPurchase>
<operatingSystem version="High Sierra">OS X</operatingSystem>
</item>
<item id="59" type="laptopComputer" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="false">
<manufacturer>Acer</manufacturer>
<model>Chromebook 11</model>
<serialNumber>U89TRY765ME</serialNumber>
<dateOfPurchase>2016-04-23</dateOfPurchase>
<operatingSystem version="">Chrome OS</operatingSystem>
<tickets>
<ticket id="HWI046" issuedIn="2010-02-28" isHandled="false">
<description><![CDATA[Stripes on screen]]></description>
<solution><![CDATA[]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
</customers>
</pre>

= Link klientrakendusele ja API-le =
https://drive.google.com/file/d/1FU3XGGVHbn4BNNHAsOs7DQ4CzpEDwZUt/view?usp=sharing

== Readme asemel ==

1. lase API käima, tee andmebaaside migratsioonid ja update-database 
2. implementeeritud on kõik teenused, mis on nähtaval Swaggeris aadressil: "localhost:[pordinumber]/Swagger" 
3. kliendirakendus asub kataloogis 'WatchWindersClient' ja tegemist on solutioniga, mille võiks käivitada teises Visual Studio aknas 
4. klientrakenduse käivitumiseks tuleks muuta App.config failis muuta ära localhost portide numbrid asendades need enda arvutis oleva localhost pordiga ning lisada kehtiv JWT AccessToken, mille saab Postmaniga aadressilt api/Security/getToken "Email" ja "Password" abil pärast seda kui kasutaja on loodud 

= Kasutatud kirjandus ja allikad =

1. Albahari, Joseph, Albari, Ben 2017. C# 7.0 in A Nutshell. Sebastopol: O’Reilly 
2. MariaDB Foundation. MariaDB. Kättesaadav:https://mariadb.org/ 
3. Martin, Robert 2018. Clean Architecture. Boston: Pearson Education

WatchWinders

2018-06-08T20:19:35Z

Tkuuskma: /* Readme asemel */

= Meeskond =

Toomas Juhkov, toomas.juhkov@gmail.com 
Tiit Kuuskmäe, tiit.kuuskmae@gmail.com 
Kunnar Kukk, Kunnar.kukk@gmail.com 

= Tegevuste logi =

08.02.2018 - meeskonna loomine, kokkuleppe sõlmimine teema osas 
10.02.2018 - õppejõu teavitamine koos esmase andmemudeliga 
15.02.2018 - lõpliku andmemudeli valmimine(versioon 5) 
18.02.2018 - õppejõu kinnitus, et teema ja meeskond kvalifiseeruvad 
22.02.2018 - viki lehe loomine ja analüüsi koostamise alustamine 
26.02.2018 - tiimi lisandus Kunnar Kukk 
01.03.2018 - tiimi sprint koosolek(seoses täiendava tiimiliikme lisandumisega täpsustasime skoopi) 
03.03.2018 - alustasime koodi kirjutamisega (tabelid klassideks ja annotatsioonid peale) 
06.03.2018 - täiendasime andmemudelit olemiga "UserTypeState" (et saaks muuta kasutajatüüpi) 
08.03.2018 - tiimi sprint koosolek 
18.03.2018 - lisasime olemid "Address", "AddressU", "AddressM", "OfferOfUser", "MediaInOffer" 
22.03.2018 - tiimi sprint koosolek, mis oli pühendatud andmemudeli täiendamisele 
23.03.2018 - pikem tiimi hackathon andmemudeli teemal 
29.03.2018 - täiendatud wiki lehte täielikult ringitöötatud andmemudeliga 
30.03.2018 - täiendatud wiki lehte andmemudeli metainfoga 
09.04.2018 - silusime andmemudelit (mõningad ebavajalikud viited olid sisse jäänud) 
06.05.2018 - panime uuendatud andmemudeli projekti wiki lehele üles 
07.05.2018 - osalesime õppejõu Mait Poska korraldatud hackathonil 
08.06.2018 - XML ülesanne, klientrakenduse ja API kood sai wiki lehel avalikuks 

Terve maikuu oli igapäevane suhtlus üle Skype'i ja fleep.io, mida me ei loginud (liiga tihedaks läks!).

= Kasutatavad metoodikad =

WatchWinders projektis plaanime kasutada peamiselt kaht metoodikat:

1. läbiv retsenseerimine (üks paariline teeb midagi valmis ja teine teeb sellele ülevaatuse; üksus lisatakse kui ülevaatus on lõplikult läbitud ning osapoolte vahel on saabunud konsensus) 
2. paaris programmeerimine (istume ühe masina taha maha ja kirjutame kolmekesi)

Tulenevalt kaugõppe formaadist saab ülekaalus olema esimene variant. Teist metoodikat kasutame nende osade kirjutamiseks, mille puhul võib arvata, et nende lahendamine on keeruline või et lahenduskäike võib olla väga erinevaid. Püüame jooksvalt siinses vikis kajastada ka seda, millise metoodika järgi üks või teine osa valmis.

= Projekti osad =

Alljärgnevalt anname ülevaate projekti osadest: 

(1) andmemudel 
(2) veebiteenuse analüüs 
(3) Minimum Viable Product definitsioon 
(4) Inkrement #1 
(5) Inkrement #2 
(6) Inkrement #3 

Projekti osad on meie viki lehel kirjeldatud valmimise järjekorras.

== Andmemudel ==

Andmemudeli koostamisel lähtusime õppejõu ette antud kriteeriumist, mille järgi andmemudelis on vähemalt 6 põhiolemit (tähistatud tumesinise ja lillaga - meie mudelis 11 tk),
mille hulgas ei sisaldu kasutajate tabelit (Person). 
 
Põhiolemid: 
* Watch - kell 
* Person - kasutaja/kollektsionäär või firma esindaja 
* Box - kellakarp 
* Organization - tootjad, edasimüüjad, hooldus 
* Settings - kellakarbi seade 
* Offer - pakkumine kollektsionäärile 
* Media - meediafailid kellade ja karpide kohta 
* Address - kasutaja/organisatsiooni aadress 
* ElectronicContact - elektrooniliste kontaktide loend 
* Log - logi 
* Access - paroolid ja kasutajanimed 
* Error - vead 
 
Type abiolemid: 
* WatchType - kellatüübid 
* PersonType - isikutüübid: admin, kasutaja 
* OrganizationType - organisatsioonitüübid: tootja, hooldaja, edasimüüja jt 
* ActionType - logi tüübid 
* ContactType - elektroonilise kontakti tüüp: skype, email, telefon jt 
 
Olekud: 
* PersonTypeState - isiku rolli kehtivus ajahetkel (isiku ja tüübi vaheline seos) 
* OrganizationTypeState - organisatsiooni olek(ud) ajahetkel 
 
Kuuluvus: 
* PersonWatch - isikute ja kellade vahelised seosed 
* PersonBox - isiku ja karbi vaheline seos 
* PersonAccess - isiku ja autentimisandmete vaheline seos 
* WatchInBox - kella ja karbi vaheline seos 
* ErrorInWatch - vea ja kella vaheline seos 
* SettingsInBox - seade ja karbi vaheline seos 
* WatchInOrganization - kella ja tootja vaheline seos 
* PersonInOrganization - isiku ja ettevõtte/organisatsiooni vaheline seos 
* SettingsOfWatchType - seade ja kellatüübi vaheline seos 
 
Abstraktsioonid: 
* Locator - abstraktsioon erinevate kontaktitüüpide jaoks 
* Party - abstraktsioon erinevate inimeste, organisatsioonide jt jaoks 
 
Kommunikatsioon: 
* OfferToPerson - isikule suunatud pakkumised 
* OfferFromPerson - isikult lähtuv pakkumine 
 
 
 
[[File:ww_andmemudel_06052018.png]]
 

Andmemudel valmis (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

== Veebiteenuse analüüs ==

Alljärgnevalt esitame kellakarpide infosüsteemi analüüsi järgmistes osades:

(1) toote/teenuse kirjeldus 
(2) probleemi kirjeldus 
(3) lahendus 
(4) süsteemi kasutajad 
(5) loodava API võimalused 
(6) funktsionaalsed nõuded 
(7) mittefunktsionaalsed nõuded 

=== Toote/teenuse kirjeldus ===
Teenuse eesmärgiks on lahendada probleem, kuidas jälgida kellakarpide kaudu mehhaaniliste käekellade seisundit ning keerata neid automaatselt üles distantsilt, näiteks juhul, kui kellade kollektsionäär ei asu füüsiliselt igapäevaselt oma kellade juures. Teenus võimaldab ka tootjal uuendada kontaktandmeid, saata personaalseid teateid. Administraatorile annab ülevaate platvormis toimuvast.

=== Probleemi kirjeldus ===
Mehhaaniliste käekellade kollektsionääride huvi kellakarpide vastu on mitmetahuline. Kollektsionääre huvitab arvepidamine – mitu kella, missuguste omaduste ja eripäradega neil kollektsioonis on. Teisalt soov eksponeerida oma kogusid kolleegidele ja sõpradele. Kellakarpidega täidetud sein või riiulid loovad selleks suurepärase võimaluse. Kolmandaks praktiline vajadus tagada kellavedrude õige vinnastatuse aste. Kaasaja mehhaanilised kellamehhanismid (''automatic'') võimaldavad kellakorpuse füüsilisel liigutamisel kellavedru automaatselt vinnastada.

Näiteks piisab kella kinnitamisest käele, et see hakkaks end käe liigutamisel üles keerama. Kuidas keerata aga üles seisvat kella, mis seisab paigal kellakarbis? Selleks on tänapäeva kellakarpides elektrimootor, mis tagab kella liigutamise vastavalt kellatüübile ettenähtud ööpäevase graafiku alusel. Kollektsionääride üheks probleemiks on see, kuidas juhtida sellist karpi ja omada jooksvat ülevaadet kõikidest oma karpidest, nende tehnilisest seadistusest ja kollektsiooni kuuluvatest kelladest olles tööreisil välisriigis?

=== Lahendus ===
Probleemi lahendamiseks ehitame REST + ASP.NET Core + WebAPI koos kliendiga, mis võimaldab kellakollektsionääridel hallata kellasid karpides, administraatoritel saada ülevaate süsteemist ning tootjatele lisada infot kollektsionääridele. Käesoleva projekti käigus '''ei tegeleta''' kahe IoT lahenduse kui terviku seisukohast olulise nüansiga: (i) karbi püsivara (''firmware'') loomisega, (ii) klientrakenduse ''frontend'' lõpliku häälestamisega (ilus .css ja pildid).

=== Süsteemi kasutajad ===
'''Kollektsionäär''' - haldab ja muudab infot oma kellade ning oma kellakarpide kohta. 
'''Administraator''' - haldab süsteemi infot, vajadusel eemaldab probleeme. 
'''Tootja''' - saab saata süsteemi kollektsionääridele mõeldud infot. 
'''Hooldaja''' - saab infot hooldamist vajavate kellade ja -karpide kohta. 

=== Loodava API võimalused ===
Alljärgnevalt vaatame loodava API võimalusi kasutajagruppide kaupa:

'''Kasutajale/kellakollektsionäärile'''
* Saada ülevaade kelladest ja kellakarpidest (lisada, muuta, vaadata).
* Muuta karbis oleva kella kohta käivat informatsiooni (kella nimi, tootja, tootmise aeg, viitenumber, mehhanism, jõureservi jääk (valikuline), foto kellast, kellarihma liik, muu).
* Karpe juhtida (keerata automaatselt üles). Näha ja muuta kella üleskeerava mehhanismi liikumise kiirust ja muid detaile (nt liikumise suund).
* Näha karbi seisundit, kas karp on hetkel wifiga ühendatud või mitte.
* Näha karbilt saabunud veateateid.
* Sisestada infot kella seisundist.
* Suhelda hooldajate ja tootjatega

'''Tootjale'''
* Uuendada kontaktandmeid.
* Saata personaalseid teateid kellakollektsionääridele.

'''Administraatorile'''
* Näha võrku ühendatud karpide arvu.
* Näha karpidesse paigaldatud kellade nimistut (ilma muude kasutajaandmeteta).
* Näha kellade üleskeeramise mehhanismide arvnäitajaid (madalaim kiirus, keskmine kiirus, tippkiirus; samuti liikumise suundade arvnäitajaid).
* IP-aadresside järgi ülevaadet, millistes riikides karpe kasutatakse (üldised arvandmed).
* Veateatega karpide arv süsteemis (üldised arvandmed).

=== Funktsionaalsed nõuded ===
* Kõik tegevused peavad olema autoriseeritud.
* REST + ASP.NET Core + WebAPI tagastab infot valideeritud JSON formaadis.
* API veatöötlus on tehtud, kasutades standardseid veakoode.
* API-le on tehtud 'health check'.
* Kõik kasutajad peavad saama end autoriseerida.
* Kasutaja, tootja ja administraatori tegevused logitakse.
* Logi ei ole muudetav, vaid on kättesaadav.
* Kasutaja ega tootja ei näe teiste kasutajate ega tootjate infot.
* API klient on kohanduv mobiilile, tahvlile ja desktoparvutile.
* Sisendandmed on valideeritud.

=== Mittefunktsionaalsed nõuded ===
* API-le on lisatud Swagger fail.
* Teenus ja tehniline lahendus on dokumenteeritud.
* Süsteemi kood on vabalt ligipääsetav, täiendatav ning allalaetav.

Esitame töö etappidena, kus kõigepealt defineerime ära Minimum Viable Producti [https://en.wikipedia.org/wiki/Minimum_viable_product] ehk selle miinimumi, mis pakub kasutajale maksimaalset väärtust. See tähendab API loomist ning esmase kliendi loomist kõigile MVP-s defineeritud kasutajagruppidele. Seejärel realiseerime projekti inkrementide ehk tootearenduse sammudena, milles lisame uusi funktsionaalsusi. Ideaalis jõuame realiseerida kõik sammud, kuid kuna teeme nimetatud tööd antud ajaraamis ja koosseisus esmakordselt, siis võtame vabaduse ka realiseerida korralikult niipalju, kui jõuame projekti käigus ära teha.

Võimalik, et meie lõpptulemus erineb mõnes osas esitatud analüüsist. Seda olenevalt sellest kui edukalt meil õnnestub plaanitud funktsionaalsusi realiseerida. Erisusi plaanime käsitleda vastavas 'post production' jaotuses, kus loendame ka projektist kogunenud peamised õppetunnid.

Analüüs valmis (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

== Minimum Viable Product definitsioon ==
'''Kasutaja'''
* Kasutaja saab süsteemi logida ning välja logida
* Kasutaja saab lisada uue kellakarbi
* Kasutaja saab lisada uue kella kellakarpi
* Kasutaja saab muuta kella infot kellakarbis
* Kasutaja saab näha ülevaadet oma karpidest
* Kasutaja saab muuta kellakarbi seadeid
* Kasutaja saab kustutada kella karbis
* Kasutaja saab kustutada kellakarbi

'''Administraator'''
* Näeb autoriseeritult logisid

'''Tootja'''
* Saab lisada kontaktandmeid
* Saab kontaktandmeid muuta

== Inkrement #1 ==
'''Kasutaja'''
* Näeb karbilt saabunud veateateid.
* Saab kellakarpe juhtida.

'''Administraator'''
* IP-aadresside järgi ülevaadet, millistes riikides karpe kasutatakse (üldised arvandmed).
* Karpidesse paigaldatud kellade nimistut (ilma muude kasutajaandmeteta).
* Näeb kasutajate statistikat.

'''Tootja'''
* Saata personaalseid teateid kellakollektsionääridele.

== Inkrement #2 ==
'''Kasutaja'''
* Saab saata teate tootjale.
* Näeb tootja vastust.
* Näha karbi seisundit, kas karp on hetkel wifiga ühendatud või mitte.

'''Administraator'''
* Näha kellade üleskeeramise mehhanismide arvnäitajaid (madalaim kiirus, keskmine kiirus, tippkiirus; samuti liikumise suundade arvnäitajaid).
* Näeb tegevuste ajalugu kliendist.

'''Tootja'''
* Saab lugeda kasutaja teadet.
* Saab vastata kasutajale.

'''Hooldaja'''
* Saab info hooldamist vajavate kellade kohta.

== Inkrement #3 ==
'''Kasutaja'''
* On ehitatud keeletugi.

'''Tootja'''
* On ehitatud keeletugi.

'''Hooldaja'''
* On ehitatud keeletugi.

Inkrementid valmisid (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

= XML ülesanne =
Järgnevalt esitame oma XML-ülesande tulemused.

== IT Management Transformation XML To XML ==
<pre>
<?xml version="1.0" encoding="utf-8"?>
<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">
<xsl:output method="xml" indent="yes"/>
<xsl:template match="/">
<unhandledDevices>
<xsl:for-each select="customers/customer/locations/location/items/item[@isInWorkingCondition='false']">
<device>
<name>
<xsl:value-of select="manufacturer"/>
<xsl:text> </xsl:text>
<xsl:value-of select="model"/>
</name>
<ticket>
<xsl:for-each select="tickets/ticket[@isHandled='false']">
<ticket_id>
<xsl:value-of select="@id"/>
</ticket_id>
<issued_in>
<xsl:value-of select="@issuedIn"/>
</issued_in>
<description>
<xsl:value-of select="description"/>
</description>
</xsl:for-each>
</ticket>
</device>
</xsl:for-each>
</unhandledDevices>
</xsl:template>
</xsl:stylesheet>
</pre>

== IT Management Transformation HTML ==

<pre>
<?xml version="1.0" encoding="utf-8"?>
<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">
<xsl:output method="html" indent="yes"/>
<xsl:template match="/">

<html>
<head>
<title>ItManagement Laptops</title>
</head>
<body style="background-color:#F7F7F7">
<h1>Computers</h1>
<xsl:for-each select="/customers/customer/locations/location/items/item[@type='laptopComputer']">
<xsl:sort select="@isActive='false'"/>
<hr />
<div>
<h3>
<xsl:value-of select="manufacturer"/>
</h3>
Model: 
<xsl:value-of select="model"/>
 
Serial number: 
<xsl:value-of select="serialNumber"/>
 
Date of purchase: 
<xsl:value-of select="dateOfPurchase"/>
 
Operating system: 
<xsl:value-of select="operatingSystem"/>
 
Is on active list: 
<xsl:value-of select="@isActive"/>
 
</div>

<div style="background-color:#E3FAEE" >

<xsl:for-each select="tickets/ticket">
<xsl:choose>
<xsl:when test="@isHandled='true'">
<h3>Handled tickets</h3>
<ul>
Issued in: 
<xsl:value-of select="@issuedIn"/>
 
Ticket ID: 
<xsl:value-of select="@id" />
 
Description: 
<xsl:value-of select="description"/>
 
Solution: 
<xsl:value-of select="solution"/>
 
</ul>
</xsl:when>
<xsl:when test="@isHandled='false'">
<div style="background-color:#FDE5E5">
<h3>Unhandled tickets</h3>
<ul>
Issued in: 
<xsl:value-of select="@issuedIn"/>
 
Ticket ID: 
<xsl:value-of select="@id" />
 
Description: 
<xsl:value-of select="description"/>
 
Solution: 
<xsl:value-of select="solution"/>
 
</ul>
</div>
</xsl:when>
</xsl:choose>
</xsl:for-each>

</div>
</xsl:for-each>
</body>
</html>
</xsl:template>
</xsl:stylesheet>
</pre>

== IT Management XSD ==

<pre>
<?xml version="1.0" encoding="utf-8"?>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="customers">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="customer">
<xs:complexType>
<xs:sequence>
<xs:element name="customerName" type="xs:string" />
<xs:element minOccurs="0" name="contactPerson" type="xs:string" />
<xs:element name="e-mail" type="xs:string" />
<xs:element name="phoneNumber" type="xs:string" />
<xs:element name="locations">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="location">
<xs:complexType>
<xs:sequence>
<xs:element name="city" type="xs:string" />
<xs:element name="address" type="xs:string" />
<xs:element name="comment" type="xs:string" />
<xs:element minOccurs="0" name="localContactPerson" type="xs:string" />
<xs:element minOccurs="0" name="localPhone" type="xs:string" />
<xs:element name="items">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="item">
<xs:complexType>
<xs:sequence>
<xs:element name="manufacturer" type="xs:string" />
<xs:element name="model" type="xs:string" />
<xs:element name="serialNumber" type="xs:string" />
<xs:element name="dateOfPurchase" type="xs:date" />
<xs:element minOccurs="0" name="operatingSystem">
<xs:complexType>
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute name="version" type="xs:string" use="required" />
</xs:extension>
</xs:simpleContent>
</xs:complexType>
</xs:element>
<xs:element minOccurs="0" name="tickets">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="ticket">
<xs:complexType>
<xs:sequence>
<xs:element name="description" type="xs:string" />
<xs:element name="solution" type="xs:string" />
</xs:sequence>
<xs:attribute name="id" type="xs:string" use="required" />
<xs:attribute name="issuedIn" type="xs:date" use="required" />
<xs:attribute name="isHandled" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:unsignedInt" use="required" />
<xs:attribute name="type" type="xs:string" use="required" />
<xs:attribute name="isActive" type="xs:boolean" use="required" />
<xs:attribute name="isUnderWarranty" type="xs:boolean" use="required" />
<xs:attribute name="warrantyInMonths" type="xs:unsignedByte" use="required" />
<xs:attribute name="isInWorkingCondition" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="type" type="xs:string" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:unsignedInt" use="required" />
<xs:attribute name="type" type="xs:string" use="required" />
<xs:attribute name="isActive" type="xs:boolean" use="required" />
<xs:attribute name="hasManyLocations" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
</pre>

== IT Management XML ==

<pre>
<?xml version="1.0" encoding="utf-8" ?>
<customers>
<customer id="33" type="company" isActive="true" hasManyLocations="true">
<customerName>Elamustevaba OÜ</customerName>
<contactPerson>Juhan Pühamees</contactPerson>
<e-mail>juhan@evaba.com</e-mail>
<phoneNumber>+37256565656</phoneNumber>
<locations>
<location type="office">
<city>Tallinn</city>
<address><![CDATA[Pikk 7, 56401]]></address>
<comment><![CDATA[3. korrus -> paremat kätt]]></comment>
<localContactPerson>Maiu Piimaauto</localContactPerson>
<localPhone>+3726510510</localPhone>
<items>
<item id="1" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="36" isInWorkingCondition="false">
<manufacturer>Dell</manufacturer>
<model>Inspiron 3558</model>
<serialNumber>6FGH5JN</serialNumber>
<dateOfPurchase>2017-07-22</dateOfPurchase>
<operatingSystem version="1709">Windows 10 Home</operatingSystem>
<tickets>
<ticket id="HWI001" issuedIn="2017-11-21" isHandled="true">
<description><![CDATA[Wi-Fi is not working]]></description>
<solution><![CDATA[Wi-Fi card replaced (Under the warranty)]]></solution>
</ticket>
<ticket id="SWI256" issuedIn="2018-05-05" isHandled="false">
<description><![CDATA[Computer keeps showing login screen]]></description>
<solution></solution>
</ticket>
</tickets>
</item>
<item id="55" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="60" isInWorkingCondition="true">
<manufacturer>Dell</manufacturer>
<model>Latitude E7550</model>
<serialNumber>8JGR78U</serialNumber>
<dateOfPurchase>2016-06-15</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Home</operatingSystem>
</item>
</items>
</location>
<location type="store">
<city>Tallinn</city>
<address><![CDATA[Lai 17, 56401]]></address>
<comment><![CDATA[keldrikorrusel]]></comment>
<localContactPerson>Tanja Õielemb</localContactPerson>
<localPhone>+3726510520</localPhone>
<items>
<item id="83" type="desktopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Lenovo</manufacturer>
<model>ThinkCentre M715</model>
<serialNumber>IO25689AD54KL</serialNumber>
<dateOfPurchase>2017-12-01</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Pro</operatingSystem>
</item>
<item id="12" type="monitor" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>AOC</manufacturer>
<model>L456</model>
<serialNumber>9803987YE54</serialNumber>
<dateOfPurchase>2015-05-03</dateOfPurchase>
<tickets>
<ticket id="HWI126" issuedIn="2016-01-18" isHandled="true">
<description><![CDATA[Doesn't work, no picture.]]></description>
<solution><![CDATA[Wasn't plugged in. Technician did it - works again!]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
<customer id="02" type="private" isActive="true" hasManyLocations="false">
<customerName>Kessu Sisselasi</customerName>
<e-mail>kessu@tripp.org</e-mail>
<phoneNumber>+372555555</phoneNumber>
<locations>
<location type="home">
<city>Saue</city>
<address><![CDATA[Kooli 4-8, 78965]]></address>
<comment><![CDATA[2. korrus. Kitsad koridorid.]]></comment>
<items>
<item id="98" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Acer</manufacturer>
<model>Aspire 5</model>
<serialNumber>475YRT89K4</serialNumber>
<dateOfPurchase>2018-03-25</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Home</operatingSystem>
</item>
<item id="4" type="laptopComputer" isActive="false" isUnderWarranty="false" warrantyInMonths="36" isInWorkingCondition="true">
<manufacturer>Lenovo</manufacturer>
<model>IdeaPad L530</model>
<serialNumber>U89TRY765ME</serialNumber>
<dateOfPurchase>2007-08-14</dateOfPurchase>
<operatingSystem version="">Windows XP</operatingSystem>
<tickets>
<ticket id="SWI069" issuedIn="2010-01-28" isHandled="true">
<description><![CDATA[Blue screen.]]></description>
<solution><![CDATA[Video driver update.]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
<customer id="26" type="company" isActive="true" hasManyLocations="true">
<customerName>Aktsiaselts OÜ</customerName>
<contactPerson>Gunnar Kuningas</contactPerson>
<e-mail>gunnar@kunn.ee</e-mail>
<phoneNumber>+3726985236</phoneNumber>
<locations>
<location type="office">
<city>Loksa</city>
<address><![CDATA[Kalda 14, 78965]]></address>
<comment><![CDATA[Sissepääs Rimi poolt, helesinine uks]]></comment>
<items>
<item id="26" type="laptopComputer" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Apple</manufacturer>
<model>Macbook Air</model>
<serialNumber>258JUY369</serialNumber>
<dateOfPurchase>2017-03-01</dateOfPurchase>
<operatingSystem version="High Sierra">OS X</operatingSystem>
</item>
<item id="59" type="laptopComputer" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="false">
<manufacturer>Acer</manufacturer>
<model>Chromebook 11</model>
<serialNumber>U89TRY765ME</serialNumber>
<dateOfPurchase>2016-04-23</dateOfPurchase>
<operatingSystem version="">Chrome OS</operatingSystem>
<tickets>
<ticket id="HWI046" issuedIn="2010-02-28" isHandled="false">
<description><![CDATA[Stripes on screen]]></description>
<solution><![CDATA[]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
</customers>
</pre>

= Link klientrakendusele ja API-le =
https://drive.google.com/file/d/1FU3XGGVHbn4BNNHAsOs7DQ4CzpEDwZUt/view?usp=sharing

== Readme asemel ==

1. lase API käima, tee andmebaaside migratsioonid ja update-database 
2. implementeeritud on kõik teenused, mis on nähtaval Swaggeris aadressil: "http://localhost:[pordinumber]/Swagger" 
3. kliendirakendus asub kataloogis 'WatchWindersClient' ja tegemist on solutioniga, mille võiks käivitada teises Visual Studio aknas 
4. klientrakenduse käivitumiseks tuleks muuta App.config failis muuta ära localhost portide numbrid asendades need enda arvutis oleva localhost pordiga ning lisada kehtiv JWT AccessToken, mille saab Postmaniga aadressilt api/Security/getToken "Email" ja "Password" abil pärast seda kui kasutaja on loodud 

= Kasutatud kirjandus ja allikad =

1. Albahari, Joseph, Albari, Ben 2017. C# 7.0 in A Nutshell. Sebastopol: O’Reilly 
2. MariaDB Foundation. MariaDB. Kättesaadav:https://mariadb.org/ 
3. Martin, Robert 2018. Clean Architecture. Boston: Pearson Education

WatchWinders

2018-06-08T20:18:59Z

Tkuuskma:

= Meeskond =

Toomas Juhkov, toomas.juhkov@gmail.com 
Tiit Kuuskmäe, tiit.kuuskmae@gmail.com 
Kunnar Kukk, Kunnar.kukk@gmail.com 

= Tegevuste logi =

08.02.2018 - meeskonna loomine, kokkuleppe sõlmimine teema osas 
10.02.2018 - õppejõu teavitamine koos esmase andmemudeliga 
15.02.2018 - lõpliku andmemudeli valmimine(versioon 5) 
18.02.2018 - õppejõu kinnitus, et teema ja meeskond kvalifiseeruvad 
22.02.2018 - viki lehe loomine ja analüüsi koostamise alustamine 
26.02.2018 - tiimi lisandus Kunnar Kukk 
01.03.2018 - tiimi sprint koosolek(seoses täiendava tiimiliikme lisandumisega täpsustasime skoopi) 
03.03.2018 - alustasime koodi kirjutamisega (tabelid klassideks ja annotatsioonid peale) 
06.03.2018 - täiendasime andmemudelit olemiga "UserTypeState" (et saaks muuta kasutajatüüpi) 
08.03.2018 - tiimi sprint koosolek 
18.03.2018 - lisasime olemid "Address", "AddressU", "AddressM", "OfferOfUser", "MediaInOffer" 
22.03.2018 - tiimi sprint koosolek, mis oli pühendatud andmemudeli täiendamisele 
23.03.2018 - pikem tiimi hackathon andmemudeli teemal 
29.03.2018 - täiendatud wiki lehte täielikult ringitöötatud andmemudeliga 
30.03.2018 - täiendatud wiki lehte andmemudeli metainfoga 
09.04.2018 - silusime andmemudelit (mõningad ebavajalikud viited olid sisse jäänud) 
06.05.2018 - panime uuendatud andmemudeli projekti wiki lehele üles 
07.05.2018 - osalesime õppejõu Mait Poska korraldatud hackathonil 
08.06.2018 - XML ülesanne, klientrakenduse ja API kood sai wiki lehel avalikuks 

Terve maikuu oli igapäevane suhtlus üle Skype'i ja fleep.io, mida me ei loginud (liiga tihedaks läks!).

= Kasutatavad metoodikad =

WatchWinders projektis plaanime kasutada peamiselt kaht metoodikat:

1. läbiv retsenseerimine (üks paariline teeb midagi valmis ja teine teeb sellele ülevaatuse; üksus lisatakse kui ülevaatus on lõplikult läbitud ning osapoolte vahel on saabunud konsensus) 
2. paaris programmeerimine (istume ühe masina taha maha ja kirjutame kolmekesi)

Tulenevalt kaugõppe formaadist saab ülekaalus olema esimene variant. Teist metoodikat kasutame nende osade kirjutamiseks, mille puhul võib arvata, et nende lahendamine on keeruline või et lahenduskäike võib olla väga erinevaid. Püüame jooksvalt siinses vikis kajastada ka seda, millise metoodika järgi üks või teine osa valmis.

= Projekti osad =

Alljärgnevalt anname ülevaate projekti osadest: 

(1) andmemudel 
(2) veebiteenuse analüüs 
(3) Minimum Viable Product definitsioon 
(4) Inkrement #1 
(5) Inkrement #2 
(6) Inkrement #3 

Projekti osad on meie viki lehel kirjeldatud valmimise järjekorras.

== Andmemudel ==

Andmemudeli koostamisel lähtusime õppejõu ette antud kriteeriumist, mille järgi andmemudelis on vähemalt 6 põhiolemit (tähistatud tumesinise ja lillaga - meie mudelis 11 tk),
mille hulgas ei sisaldu kasutajate tabelit (Person). 
 
Põhiolemid: 
* Watch - kell 
* Person - kasutaja/kollektsionäär või firma esindaja 
* Box - kellakarp 
* Organization - tootjad, edasimüüjad, hooldus 
* Settings - kellakarbi seade 
* Offer - pakkumine kollektsionäärile 
* Media - meediafailid kellade ja karpide kohta 
* Address - kasutaja/organisatsiooni aadress 
* ElectronicContact - elektrooniliste kontaktide loend 
* Log - logi 
* Access - paroolid ja kasutajanimed 
* Error - vead 
 
Type abiolemid: 
* WatchType - kellatüübid 
* PersonType - isikutüübid: admin, kasutaja 
* OrganizationType - organisatsioonitüübid: tootja, hooldaja, edasimüüja jt 
* ActionType - logi tüübid 
* ContactType - elektroonilise kontakti tüüp: skype, email, telefon jt 
 
Olekud: 
* PersonTypeState - isiku rolli kehtivus ajahetkel (isiku ja tüübi vaheline seos) 
* OrganizationTypeState - organisatsiooni olek(ud) ajahetkel 
 
Kuuluvus: 
* PersonWatch - isikute ja kellade vahelised seosed 
* PersonBox - isiku ja karbi vaheline seos 
* PersonAccess - isiku ja autentimisandmete vaheline seos 
* WatchInBox - kella ja karbi vaheline seos 
* ErrorInWatch - vea ja kella vaheline seos 
* SettingsInBox - seade ja karbi vaheline seos 
* WatchInOrganization - kella ja tootja vaheline seos 
* PersonInOrganization - isiku ja ettevõtte/organisatsiooni vaheline seos 
* SettingsOfWatchType - seade ja kellatüübi vaheline seos 
 
Abstraktsioonid: 
* Locator - abstraktsioon erinevate kontaktitüüpide jaoks 
* Party - abstraktsioon erinevate inimeste, organisatsioonide jt jaoks 
 
Kommunikatsioon: 
* OfferToPerson - isikule suunatud pakkumised 
* OfferFromPerson - isikult lähtuv pakkumine 
 
 
 
[[File:ww_andmemudel_06052018.png]]
 

Andmemudel valmis (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

== Veebiteenuse analüüs ==

Alljärgnevalt esitame kellakarpide infosüsteemi analüüsi järgmistes osades:

(1) toote/teenuse kirjeldus 
(2) probleemi kirjeldus 
(3) lahendus 
(4) süsteemi kasutajad 
(5) loodava API võimalused 
(6) funktsionaalsed nõuded 
(7) mittefunktsionaalsed nõuded 

=== Toote/teenuse kirjeldus ===
Teenuse eesmärgiks on lahendada probleem, kuidas jälgida kellakarpide kaudu mehhaaniliste käekellade seisundit ning keerata neid automaatselt üles distantsilt, näiteks juhul, kui kellade kollektsionäär ei asu füüsiliselt igapäevaselt oma kellade juures. Teenus võimaldab ka tootjal uuendada kontaktandmeid, saata personaalseid teateid. Administraatorile annab ülevaate platvormis toimuvast.

=== Probleemi kirjeldus ===
Mehhaaniliste käekellade kollektsionääride huvi kellakarpide vastu on mitmetahuline. Kollektsionääre huvitab arvepidamine – mitu kella, missuguste omaduste ja eripäradega neil kollektsioonis on. Teisalt soov eksponeerida oma kogusid kolleegidele ja sõpradele. Kellakarpidega täidetud sein või riiulid loovad selleks suurepärase võimaluse. Kolmandaks praktiline vajadus tagada kellavedrude õige vinnastatuse aste. Kaasaja mehhaanilised kellamehhanismid (''automatic'') võimaldavad kellakorpuse füüsilisel liigutamisel kellavedru automaatselt vinnastada.

Näiteks piisab kella kinnitamisest käele, et see hakkaks end käe liigutamisel üles keerama. Kuidas keerata aga üles seisvat kella, mis seisab paigal kellakarbis? Selleks on tänapäeva kellakarpides elektrimootor, mis tagab kella liigutamise vastavalt kellatüübile ettenähtud ööpäevase graafiku alusel. Kollektsionääride üheks probleemiks on see, kuidas juhtida sellist karpi ja omada jooksvat ülevaadet kõikidest oma karpidest, nende tehnilisest seadistusest ja kollektsiooni kuuluvatest kelladest olles tööreisil välisriigis?

=== Lahendus ===
Probleemi lahendamiseks ehitame REST + ASP.NET Core + WebAPI koos kliendiga, mis võimaldab kellakollektsionääridel hallata kellasid karpides, administraatoritel saada ülevaate süsteemist ning tootjatele lisada infot kollektsionääridele. Käesoleva projekti käigus '''ei tegeleta''' kahe IoT lahenduse kui terviku seisukohast olulise nüansiga: (i) karbi püsivara (''firmware'') loomisega, (ii) klientrakenduse ''frontend'' lõpliku häälestamisega (ilus .css ja pildid).

=== Süsteemi kasutajad ===
'''Kollektsionäär''' - haldab ja muudab infot oma kellade ning oma kellakarpide kohta. 
'''Administraator''' - haldab süsteemi infot, vajadusel eemaldab probleeme. 
'''Tootja''' - saab saata süsteemi kollektsionääridele mõeldud infot. 
'''Hooldaja''' - saab infot hooldamist vajavate kellade ja -karpide kohta. 

=== Loodava API võimalused ===
Alljärgnevalt vaatame loodava API võimalusi kasutajagruppide kaupa:

'''Kasutajale/kellakollektsionäärile'''
* Saada ülevaade kelladest ja kellakarpidest (lisada, muuta, vaadata).
* Muuta karbis oleva kella kohta käivat informatsiooni (kella nimi, tootja, tootmise aeg, viitenumber, mehhanism, jõureservi jääk (valikuline), foto kellast, kellarihma liik, muu).
* Karpe juhtida (keerata automaatselt üles). Näha ja muuta kella üleskeerava mehhanismi liikumise kiirust ja muid detaile (nt liikumise suund).
* Näha karbi seisundit, kas karp on hetkel wifiga ühendatud või mitte.
* Näha karbilt saabunud veateateid.
* Sisestada infot kella seisundist.
* Suhelda hooldajate ja tootjatega

'''Tootjale'''
* Uuendada kontaktandmeid.
* Saata personaalseid teateid kellakollektsionääridele.

'''Administraatorile'''
* Näha võrku ühendatud karpide arvu.
* Näha karpidesse paigaldatud kellade nimistut (ilma muude kasutajaandmeteta).
* Näha kellade üleskeeramise mehhanismide arvnäitajaid (madalaim kiirus, keskmine kiirus, tippkiirus; samuti liikumise suundade arvnäitajaid).
* IP-aadresside järgi ülevaadet, millistes riikides karpe kasutatakse (üldised arvandmed).
* Veateatega karpide arv süsteemis (üldised arvandmed).

=== Funktsionaalsed nõuded ===
* Kõik tegevused peavad olema autoriseeritud.
* REST + ASP.NET Core + WebAPI tagastab infot valideeritud JSON formaadis.
* API veatöötlus on tehtud, kasutades standardseid veakoode.
* API-le on tehtud 'health check'.
* Kõik kasutajad peavad saama end autoriseerida.
* Kasutaja, tootja ja administraatori tegevused logitakse.
* Logi ei ole muudetav, vaid on kättesaadav.
* Kasutaja ega tootja ei näe teiste kasutajate ega tootjate infot.
* API klient on kohanduv mobiilile, tahvlile ja desktoparvutile.
* Sisendandmed on valideeritud.

=== Mittefunktsionaalsed nõuded ===
* API-le on lisatud Swagger fail.
* Teenus ja tehniline lahendus on dokumenteeritud.
* Süsteemi kood on vabalt ligipääsetav, täiendatav ning allalaetav.

Esitame töö etappidena, kus kõigepealt defineerime ära Minimum Viable Producti [https://en.wikipedia.org/wiki/Minimum_viable_product] ehk selle miinimumi, mis pakub kasutajale maksimaalset väärtust. See tähendab API loomist ning esmase kliendi loomist kõigile MVP-s defineeritud kasutajagruppidele. Seejärel realiseerime projekti inkrementide ehk tootearenduse sammudena, milles lisame uusi funktsionaalsusi. Ideaalis jõuame realiseerida kõik sammud, kuid kuna teeme nimetatud tööd antud ajaraamis ja koosseisus esmakordselt, siis võtame vabaduse ka realiseerida korralikult niipalju, kui jõuame projekti käigus ära teha.

Võimalik, et meie lõpptulemus erineb mõnes osas esitatud analüüsist. Seda olenevalt sellest kui edukalt meil õnnestub plaanitud funktsionaalsusi realiseerida. Erisusi plaanime käsitleda vastavas 'post production' jaotuses, kus loendame ka projektist kogunenud peamised õppetunnid.

Analüüs valmis (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

== Minimum Viable Product definitsioon ==
'''Kasutaja'''
* Kasutaja saab süsteemi logida ning välja logida
* Kasutaja saab lisada uue kellakarbi
* Kasutaja saab lisada uue kella kellakarpi
* Kasutaja saab muuta kella infot kellakarbis
* Kasutaja saab näha ülevaadet oma karpidest
* Kasutaja saab muuta kellakarbi seadeid
* Kasutaja saab kustutada kella karbis
* Kasutaja saab kustutada kellakarbi

'''Administraator'''
* Näeb autoriseeritult logisid

'''Tootja'''
* Saab lisada kontaktandmeid
* Saab kontaktandmeid muuta

== Inkrement #1 ==
'''Kasutaja'''
* Näeb karbilt saabunud veateateid.
* Saab kellakarpe juhtida.

'''Administraator'''
* IP-aadresside järgi ülevaadet, millistes riikides karpe kasutatakse (üldised arvandmed).
* Karpidesse paigaldatud kellade nimistut (ilma muude kasutajaandmeteta).
* Näeb kasutajate statistikat.

'''Tootja'''
* Saata personaalseid teateid kellakollektsionääridele.

== Inkrement #2 ==
'''Kasutaja'''
* Saab saata teate tootjale.
* Näeb tootja vastust.
* Näha karbi seisundit, kas karp on hetkel wifiga ühendatud või mitte.

'''Administraator'''
* Näha kellade üleskeeramise mehhanismide arvnäitajaid (madalaim kiirus, keskmine kiirus, tippkiirus; samuti liikumise suundade arvnäitajaid).
* Näeb tegevuste ajalugu kliendist.

'''Tootja'''
* Saab lugeda kasutaja teadet.
* Saab vastata kasutajale.

'''Hooldaja'''
* Saab info hooldamist vajavate kellade kohta.

== Inkrement #3 ==
'''Kasutaja'''
* On ehitatud keeletugi.

'''Tootja'''
* On ehitatud keeletugi.

'''Hooldaja'''
* On ehitatud keeletugi.

Inkrementid valmisid (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

= XML ülesanne =
Järgnevalt esitame oma XML-ülesande tulemused.

== IT Management Transformation XML To XML ==
<pre>
<?xml version="1.0" encoding="utf-8"?>
<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">
<xsl:output method="xml" indent="yes"/>
<xsl:template match="/">
<unhandledDevices>
<xsl:for-each select="customers/customer/locations/location/items/item[@isInWorkingCondition='false']">
<device>
<name>
<xsl:value-of select="manufacturer"/>
<xsl:text> </xsl:text>
<xsl:value-of select="model"/>
</name>
<ticket>
<xsl:for-each select="tickets/ticket[@isHandled='false']">
<ticket_id>
<xsl:value-of select="@id"/>
</ticket_id>
<issued_in>
<xsl:value-of select="@issuedIn"/>
</issued_in>
<description>
<xsl:value-of select="description"/>
</description>
</xsl:for-each>
</ticket>
</device>
</xsl:for-each>
</unhandledDevices>
</xsl:template>
</xsl:stylesheet>
</pre>

== IT Management Transformation HTML ==

<pre>
<?xml version="1.0" encoding="utf-8"?>
<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">
<xsl:output method="html" indent="yes"/>
<xsl:template match="/">

<html>
<head>
<title>ItManagement Laptops</title>
</head>
<body style="background-color:#F7F7F7">
<h1>Computers</h1>
<xsl:for-each select="/customers/customer/locations/location/items/item[@type='laptopComputer']">
<xsl:sort select="@isActive='false'"/>
<hr />
<div>
<h3>
<xsl:value-of select="manufacturer"/>
</h3>
Model: 
<xsl:value-of select="model"/>
 
Serial number: 
<xsl:value-of select="serialNumber"/>
 
Date of purchase: 
<xsl:value-of select="dateOfPurchase"/>
 
Operating system: 
<xsl:value-of select="operatingSystem"/>
 
Is on active list: 
<xsl:value-of select="@isActive"/>
 
</div>

<div style="background-color:#E3FAEE" >

<xsl:for-each select="tickets/ticket">
<xsl:choose>
<xsl:when test="@isHandled='true'">
<h3>Handled tickets</h3>
<ul>
Issued in: 
<xsl:value-of select="@issuedIn"/>
 
Ticket ID: 
<xsl:value-of select="@id" />
 
Description: 
<xsl:value-of select="description"/>
 
Solution: 
<xsl:value-of select="solution"/>
 
</ul>
</xsl:when>
<xsl:when test="@isHandled='false'">
<div style="background-color:#FDE5E5">
<h3>Unhandled tickets</h3>
<ul>
Issued in: 
<xsl:value-of select="@issuedIn"/>
 
Ticket ID: 
<xsl:value-of select="@id" />
 
Description: 
<xsl:value-of select="description"/>
 
Solution: 
<xsl:value-of select="solution"/>
 
</ul>
</div>
</xsl:when>
</xsl:choose>
</xsl:for-each>

</div>
</xsl:for-each>
</body>
</html>
</xsl:template>
</xsl:stylesheet>
</pre>

== IT Management XSD ==

<pre>
<?xml version="1.0" encoding="utf-8"?>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="customers">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="customer">
<xs:complexType>
<xs:sequence>
<xs:element name="customerName" type="xs:string" />
<xs:element minOccurs="0" name="contactPerson" type="xs:string" />
<xs:element name="e-mail" type="xs:string" />
<xs:element name="phoneNumber" type="xs:string" />
<xs:element name="locations">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="location">
<xs:complexType>
<xs:sequence>
<xs:element name="city" type="xs:string" />
<xs:element name="address" type="xs:string" />
<xs:element name="comment" type="xs:string" />
<xs:element minOccurs="0" name="localContactPerson" type="xs:string" />
<xs:element minOccurs="0" name="localPhone" type="xs:string" />
<xs:element name="items">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="item">
<xs:complexType>
<xs:sequence>
<xs:element name="manufacturer" type="xs:string" />
<xs:element name="model" type="xs:string" />
<xs:element name="serialNumber" type="xs:string" />
<xs:element name="dateOfPurchase" type="xs:date" />
<xs:element minOccurs="0" name="operatingSystem">
<xs:complexType>
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute name="version" type="xs:string" use="required" />
</xs:extension>
</xs:simpleContent>
</xs:complexType>
</xs:element>
<xs:element minOccurs="0" name="tickets">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="ticket">
<xs:complexType>
<xs:sequence>
<xs:element name="description" type="xs:string" />
<xs:element name="solution" type="xs:string" />
</xs:sequence>
<xs:attribute name="id" type="xs:string" use="required" />
<xs:attribute name="issuedIn" type="xs:date" use="required" />
<xs:attribute name="isHandled" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:unsignedInt" use="required" />
<xs:attribute name="type" type="xs:string" use="required" />
<xs:attribute name="isActive" type="xs:boolean" use="required" />
<xs:attribute name="isUnderWarranty" type="xs:boolean" use="required" />
<xs:attribute name="warrantyInMonths" type="xs:unsignedByte" use="required" />
<xs:attribute name="isInWorkingCondition" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="type" type="xs:string" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:unsignedInt" use="required" />
<xs:attribute name="type" type="xs:string" use="required" />
<xs:attribute name="isActive" type="xs:boolean" use="required" />
<xs:attribute name="hasManyLocations" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
</pre>

== IT Management XML ==

<pre>
<?xml version="1.0" encoding="utf-8" ?>
<customers>
<customer id="33" type="company" isActive="true" hasManyLocations="true">
<customerName>Elamustevaba OÜ</customerName>
<contactPerson>Juhan Pühamees</contactPerson>
<e-mail>juhan@evaba.com</e-mail>
<phoneNumber>+37256565656</phoneNumber>
<locations>
<location type="office">
<city>Tallinn</city>
<address><![CDATA[Pikk 7, 56401]]></address>
<comment><![CDATA[3. korrus -> paremat kätt]]></comment>
<localContactPerson>Maiu Piimaauto</localContactPerson>
<localPhone>+3726510510</localPhone>
<items>
<item id="1" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="36" isInWorkingCondition="false">
<manufacturer>Dell</manufacturer>
<model>Inspiron 3558</model>
<serialNumber>6FGH5JN</serialNumber>
<dateOfPurchase>2017-07-22</dateOfPurchase>
<operatingSystem version="1709">Windows 10 Home</operatingSystem>
<tickets>
<ticket id="HWI001" issuedIn="2017-11-21" isHandled="true">
<description><![CDATA[Wi-Fi is not working]]></description>
<solution><![CDATA[Wi-Fi card replaced (Under the warranty)]]></solution>
</ticket>
<ticket id="SWI256" issuedIn="2018-05-05" isHandled="false">
<description><![CDATA[Computer keeps showing login screen]]></description>
<solution></solution>
</ticket>
</tickets>
</item>
<item id="55" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="60" isInWorkingCondition="true">
<manufacturer>Dell</manufacturer>
<model>Latitude E7550</model>
<serialNumber>8JGR78U</serialNumber>
<dateOfPurchase>2016-06-15</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Home</operatingSystem>
</item>
</items>
</location>
<location type="store">
<city>Tallinn</city>
<address><![CDATA[Lai 17, 56401]]></address>
<comment><![CDATA[keldrikorrusel]]></comment>
<localContactPerson>Tanja Õielemb</localContactPerson>
<localPhone>+3726510520</localPhone>
<items>
<item id="83" type="desktopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Lenovo</manufacturer>
<model>ThinkCentre M715</model>
<serialNumber>IO25689AD54KL</serialNumber>
<dateOfPurchase>2017-12-01</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Pro</operatingSystem>
</item>
<item id="12" type="monitor" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>AOC</manufacturer>
<model>L456</model>
<serialNumber>9803987YE54</serialNumber>
<dateOfPurchase>2015-05-03</dateOfPurchase>
<tickets>
<ticket id="HWI126" issuedIn="2016-01-18" isHandled="true">
<description><![CDATA[Doesn't work, no picture.]]></description>
<solution><![CDATA[Wasn't plugged in. Technician did it - works again!]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
<customer id="02" type="private" isActive="true" hasManyLocations="false">
<customerName>Kessu Sisselasi</customerName>
<e-mail>kessu@tripp.org</e-mail>
<phoneNumber>+372555555</phoneNumber>
<locations>
<location type="home">
<city>Saue</city>
<address><![CDATA[Kooli 4-8, 78965]]></address>
<comment><![CDATA[2. korrus. Kitsad koridorid.]]></comment>
<items>
<item id="98" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Acer</manufacturer>
<model>Aspire 5</model>
<serialNumber>475YRT89K4</serialNumber>
<dateOfPurchase>2018-03-25</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Home</operatingSystem>
</item>
<item id="4" type="laptopComputer" isActive="false" isUnderWarranty="false" warrantyInMonths="36" isInWorkingCondition="true">
<manufacturer>Lenovo</manufacturer>
<model>IdeaPad L530</model>
<serialNumber>U89TRY765ME</serialNumber>
<dateOfPurchase>2007-08-14</dateOfPurchase>
<operatingSystem version="">Windows XP</operatingSystem>
<tickets>
<ticket id="SWI069" issuedIn="2010-01-28" isHandled="true">
<description><![CDATA[Blue screen.]]></description>
<solution><![CDATA[Video driver update.]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
<customer id="26" type="company" isActive="true" hasManyLocations="true">
<customerName>Aktsiaselts OÜ</customerName>
<contactPerson>Gunnar Kuningas</contactPerson>
<e-mail>gunnar@kunn.ee</e-mail>
<phoneNumber>+3726985236</phoneNumber>
<locations>
<location type="office">
<city>Loksa</city>
<address><![CDATA[Kalda 14, 78965]]></address>
<comment><![CDATA[Sissepääs Rimi poolt, helesinine uks]]></comment>
<items>
<item id="26" type="laptopComputer" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Apple</manufacturer>
<model>Macbook Air</model>
<serialNumber>258JUY369</serialNumber>
<dateOfPurchase>2017-03-01</dateOfPurchase>
<operatingSystem version="High Sierra">OS X</operatingSystem>
</item>
<item id="59" type="laptopComputer" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="false">
<manufacturer>Acer</manufacturer>
<model>Chromebook 11</model>
<serialNumber>U89TRY765ME</serialNumber>
<dateOfPurchase>2016-04-23</dateOfPurchase>
<operatingSystem version="">Chrome OS</operatingSystem>
<tickets>
<ticket id="HWI046" issuedIn="2010-02-28" isHandled="false">
<description><![CDATA[Stripes on screen]]></description>
<solution><![CDATA[]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
</customers>
</pre>

= Link klientrakendusele ja API-le =
https://drive.google.com/file/d/1FU3XGGVHbn4BNNHAsOs7DQ4CzpEDwZUt/view?usp=sharing

== Readme asemel ==

1. lase API käima, tee andmebaaside migratsioonid ja update-database 
2. implementeeritud on kõik teenused, mis on nähtaval Swaggeris aadressil: http://localhost:[pordinumber]/Swagger 
3. kliendirakendus asub kataloogis 'WatchWindersClient' ja tegemist on solutioniga, mille võiks käivitada teises Visual Studio aknas 
4. klientrakenduse käivitumiseks tuleks muuta App.config failis muuta ära localhost portide numbrid asendades need enda arvutis oleva localhost pordiga ning lisada kehtiv JWT AccessToken, mille saab Postmaniga aadressilt api/Security/getToken "Email" ja "Password" abil pärast seda kui kasutaja on loodud 

= Kasutatud kirjandus ja allikad =

1. Albahari, Joseph, Albari, Ben 2017. C# 7.0 in A Nutshell. Sebastopol: O’Reilly 
2. MariaDB Foundation. MariaDB. Kättesaadav:https://mariadb.org/ 
3. Martin, Robert 2018. Clean Architecture. Boston: Pearson Education

WatchWinders

2018-06-08T20:18:18Z

Tkuuskma:

= Meeskond =

Toomas Juhkov, toomas.juhkov@gmail.com 
Tiit Kuuskmäe, tiit.kuuskmae@gmail.com 
Kunnar Kukk, Kunnar.kukk@gmail.com 

= Tegevuste logi =

08.02.2018 - meeskonna loomine, kokkuleppe sõlmimine teema osas 
10.02.2018 - õppejõu teavitamine koos esmase andmemudeliga 
15.02.2018 - lõpliku andmemudeli valmimine(versioon 5) 
18.02.2018 - õppejõu kinnitus, et teema ja meeskond kvalifiseeruvad 
22.02.2018 - viki lehe loomine ja analüüsi koostamise alustamine 
26.02.2018 - tiimi lisandus Kunnar Kukk 
01.03.2018 - tiimi sprint koosolek(seoses täiendava tiimiliikme lisandumisega täpsustasime skoopi) 
03.03.2018 - alustasime koodi kirjutamisega (tabelid klassideks ja annotatsioonid peale) 
06.03.2018 - täiendasime andmemudelit olemiga "UserTypeState" (et saaks muuta kasutajatüüpi) 
08.03.2018 - tiimi sprint koosolek 
18.03.2018 - lisasime olemid "Address", "AddressU", "AddressM", "OfferOfUser", "MediaInOffer" 
22.03.2018 - tiimi sprint koosolek, mis oli pühendatud andmemudeli täiendamisele 
23.03.2018 - pikem tiimi hackathon andmemudeli teemal 
29.03.2018 - täiendatud wiki lehte täielikult ringitöötatud andmemudeliga 
30.03.2018 - täiendatud wiki lehte andmemudeli metainfoga 
09.04.2018 - silusime andmemudelit (mõningad ebavajalikud viited olid sisse jäänud) 
06.05.2018 - panime uuendatud andmemudeli projekti wiki lehele üles 
07.05.2018 - osalesime õppejõu Mait Poska korraldatud hackathonil 
08.06.2018 - XML ülesanne, klientrakenduse ja API kood sai wiki lehel avalikuks 

Terve maikuu oli igapäevane suhtlus üle Skype'i ja fleep.io, mida me ei loginud (liiga tihedaks läks!).

= Kasutatavad metoodikad =

WatchWinders projektis plaanime kasutada peamiselt kaht metoodikat:

1. läbiv retsenseerimine (üks paariline teeb midagi valmis ja teine teeb sellele ülevaatuse; üksus lisatakse kui ülevaatus on lõplikult läbitud ning osapoolte vahel on saabunud konsensus) 
2. paaris programmeerimine (istume ühe masina taha maha ja kirjutame kolmekesi)

Tulenevalt kaugõppe formaadist saab ülekaalus olema esimene variant. Teist metoodikat kasutame nende osade kirjutamiseks, mille puhul võib arvata, et nende lahendamine on keeruline või et lahenduskäike võib olla väga erinevaid. Püüame jooksvalt siinses vikis kajastada ka seda, millise metoodika järgi üks või teine osa valmis.

= Projekti osad =

Alljärgnevalt anname ülevaate projekti osadest: 

(1) andmemudel 
(2) veebiteenuse analüüs 
(3) Minimum Viable Product definitsioon 
(4) Inkrement #1 
(5) Inkrement #2 
(6) Inkrement #3 

Projekti osad on meie viki lehel kirjeldatud valmimise järjekorras.

== Andmemudel ==

Andmemudeli koostamisel lähtusime õppejõu ette antud kriteeriumist, mille järgi andmemudelis on vähemalt 6 põhiolemit (tähistatud tumesinise ja lillaga - meie mudelis 11 tk),
mille hulgas ei sisaldu kasutajate tabelit (Person). 
 
Põhiolemid: 
* Watch - kell 
* Person - kasutaja/kollektsionäär või firma esindaja 
* Box - kellakarp 
* Organization - tootjad, edasimüüjad, hooldus 
* Settings - kellakarbi seade 
* Offer - pakkumine kollektsionäärile 
* Media - meediafailid kellade ja karpide kohta 
* Address - kasutaja/organisatsiooni aadress 
* ElectronicContact - elektrooniliste kontaktide loend 
* Log - logi 
* Access - paroolid ja kasutajanimed 
* Error - vead 
 
Type abiolemid: 
* WatchType - kellatüübid 
* PersonType - isikutüübid: admin, kasutaja 
* OrganizationType - organisatsioonitüübid: tootja, hooldaja, edasimüüja jt 
* ActionType - logi tüübid 
* ContactType - elektroonilise kontakti tüüp: skype, email, telefon jt 
 
Olekud: 
* PersonTypeState - isiku rolli kehtivus ajahetkel (isiku ja tüübi vaheline seos) 
* OrganizationTypeState - organisatsiooni olek(ud) ajahetkel 
 
Kuuluvus: 
* PersonWatch - isikute ja kellade vahelised seosed 
* PersonBox - isiku ja karbi vaheline seos 
* PersonAccess - isiku ja autentimisandmete vaheline seos 
* WatchInBox - kella ja karbi vaheline seos 
* ErrorInWatch - vea ja kella vaheline seos 
* SettingsInBox - seade ja karbi vaheline seos 
* WatchInOrganization - kella ja tootja vaheline seos 
* PersonInOrganization - isiku ja ettevõtte/organisatsiooni vaheline seos 
* SettingsOfWatchType - seade ja kellatüübi vaheline seos 
 
Abstraktsioonid: 
* Locator - abstraktsioon erinevate kontaktitüüpide jaoks 
* Party - abstraktsioon erinevate inimeste, organisatsioonide jt jaoks 
 
Kommunikatsioon: 
* OfferToPerson - isikule suunatud pakkumised 
* OfferFromPerson - isikult lähtuv pakkumine 
 
 
 
[[File:ww_andmemudel_06052018.png]]
 

Andmemudel valmis (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

== Veebiteenuse analüüs ==

Alljärgnevalt esitame kellakarpide infosüsteemi analüüsi järgmistes osades:

(1) toote/teenuse kirjeldus 
(2) probleemi kirjeldus 
(3) lahendus 
(4) süsteemi kasutajad 
(5) loodava API võimalused 
(6) funktsionaalsed nõuded 
(7) mittefunktsionaalsed nõuded 

=== Toote/teenuse kirjeldus ===
Teenuse eesmärgiks on lahendada probleem, kuidas jälgida kellakarpide kaudu mehhaaniliste käekellade seisundit ning keerata neid automaatselt üles distantsilt, näiteks juhul, kui kellade kollektsionäär ei asu füüsiliselt igapäevaselt oma kellade juures. Teenus võimaldab ka tootjal uuendada kontaktandmeid, saata personaalseid teateid. Administraatorile annab ülevaate platvormis toimuvast.

=== Probleemi kirjeldus ===
Mehhaaniliste käekellade kollektsionääride huvi kellakarpide vastu on mitmetahuline. Kollektsionääre huvitab arvepidamine – mitu kella, missuguste omaduste ja eripäradega neil kollektsioonis on. Teisalt soov eksponeerida oma kogusid kolleegidele ja sõpradele. Kellakarpidega täidetud sein või riiulid loovad selleks suurepärase võimaluse. Kolmandaks praktiline vajadus tagada kellavedrude õige vinnastatuse aste. Kaasaja mehhaanilised kellamehhanismid (''automatic'') võimaldavad kellakorpuse füüsilisel liigutamisel kellavedru automaatselt vinnastada.

Näiteks piisab kella kinnitamisest käele, et see hakkaks end käe liigutamisel üles keerama. Kuidas keerata aga üles seisvat kella, mis seisab paigal kellakarbis? Selleks on tänapäeva kellakarpides elektrimootor, mis tagab kella liigutamise vastavalt kellatüübile ettenähtud ööpäevase graafiku alusel. Kollektsionääride üheks probleemiks on see, kuidas juhtida sellist karpi ja omada jooksvat ülevaadet kõikidest oma karpidest, nende tehnilisest seadistusest ja kollektsiooni kuuluvatest kelladest olles tööreisil välisriigis?

=== Lahendus ===
Probleemi lahendamiseks ehitame REST + ASP.NET Core + WebAPI koos kliendiga, mis võimaldab kellakollektsionääridel hallata kellasid karpides, administraatoritel saada ülevaate süsteemist ning tootjatele lisada infot kollektsionääridele. Käesoleva projekti käigus '''ei tegeleta''' kahe IoT lahenduse kui terviku seisukohast olulise nüansiga: (i) karbi püsivara (''firmware'') loomisega, (ii) klientrakenduse ''frontend'' lõpliku häälestamisega (ilus .css ja pildid).

=== Süsteemi kasutajad ===
'''Kollektsionäär''' - haldab ja muudab infot oma kellade ning oma kellakarpide kohta. 
'''Administraator''' - haldab süsteemi infot, vajadusel eemaldab probleeme. 
'''Tootja''' - saab saata süsteemi kollektsionääridele mõeldud infot. 
'''Hooldaja''' - saab infot hooldamist vajavate kellade ja -karpide kohta. 

=== Loodava API võimalused ===
Alljärgnevalt vaatame loodava API võimalusi kasutajagruppide kaupa:

'''Kasutajale/kellakollektsionäärile'''
* Saada ülevaade kelladest ja kellakarpidest (lisada, muuta, vaadata).
* Muuta karbis oleva kella kohta käivat informatsiooni (kella nimi, tootja, tootmise aeg, viitenumber, mehhanism, jõureservi jääk (valikuline), foto kellast, kellarihma liik, muu).
* Karpe juhtida (keerata automaatselt üles). Näha ja muuta kella üleskeerava mehhanismi liikumise kiirust ja muid detaile (nt liikumise suund).
* Näha karbi seisundit, kas karp on hetkel wifiga ühendatud või mitte.
* Näha karbilt saabunud veateateid.
* Sisestada infot kella seisundist.
* Suhelda hooldajate ja tootjatega

'''Tootjale'''
* Uuendada kontaktandmeid.
* Saata personaalseid teateid kellakollektsionääridele.

'''Administraatorile'''
* Näha võrku ühendatud karpide arvu.
* Näha karpidesse paigaldatud kellade nimistut (ilma muude kasutajaandmeteta).
* Näha kellade üleskeeramise mehhanismide arvnäitajaid (madalaim kiirus, keskmine kiirus, tippkiirus; samuti liikumise suundade arvnäitajaid).
* IP-aadresside järgi ülevaadet, millistes riikides karpe kasutatakse (üldised arvandmed).
* Veateatega karpide arv süsteemis (üldised arvandmed).

=== Funktsionaalsed nõuded ===
* Kõik tegevused peavad olema autoriseeritud.
* REST + ASP.NET Core + WebAPI tagastab infot valideeritud JSON formaadis.
* API veatöötlus on tehtud, kasutades standardseid veakoode.
* API-le on tehtud 'health check'.
* Kõik kasutajad peavad saama end autoriseerida.
* Kasutaja, tootja ja administraatori tegevused logitakse.
* Logi ei ole muudetav, vaid on kättesaadav.
* Kasutaja ega tootja ei näe teiste kasutajate ega tootjate infot.
* API klient on kohanduv mobiilile, tahvlile ja desktoparvutile.
* Sisendandmed on valideeritud.

=== Mittefunktsionaalsed nõuded ===
* API-le on lisatud Swagger fail.
* Teenus ja tehniline lahendus on dokumenteeritud.
* Süsteemi kood on vabalt ligipääsetav, täiendatav ning allalaetav.

Esitame töö etappidena, kus kõigepealt defineerime ära Minimum Viable Producti [https://en.wikipedia.org/wiki/Minimum_viable_product] ehk selle miinimumi, mis pakub kasutajale maksimaalset väärtust. See tähendab API loomist ning esmase kliendi loomist kõigile MVP-s defineeritud kasutajagruppidele. Seejärel realiseerime projekti inkrementide ehk tootearenduse sammudena, milles lisame uusi funktsionaalsusi. Ideaalis jõuame realiseerida kõik sammud, kuid kuna teeme nimetatud tööd antud ajaraamis ja koosseisus esmakordselt, siis võtame vabaduse ka realiseerida korralikult niipalju, kui jõuame projekti käigus ära teha.

Võimalik, et meie lõpptulemus erineb mõnes osas esitatud analüüsist. Seda olenevalt sellest kui edukalt meil õnnestub plaanitud funktsionaalsusi realiseerida. Erisusi plaanime käsitleda vastavas 'post production' jaotuses, kus loendame ka projektist kogunenud peamised õppetunnid.

Analüüs valmis (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

== Minimum Viable Product definitsioon ==
'''Kasutaja'''
* Kasutaja saab süsteemi logida ning välja logida
* Kasutaja saab lisada uue kellakarbi
* Kasutaja saab lisada uue kella kellakarpi
* Kasutaja saab muuta kella infot kellakarbis
* Kasutaja saab näha ülevaadet oma karpidest
* Kasutaja saab muuta kellakarbi seadeid
* Kasutaja saab kustutada kella karbis
* Kasutaja saab kustutada kellakarbi

'''Administraator'''
* Näeb autoriseeritult logisid

'''Tootja'''
* Saab lisada kontaktandmeid
* Saab kontaktandmeid muuta

== Inkrement #1 ==
'''Kasutaja'''
* Näeb karbilt saabunud veateateid.
* Saab kellakarpe juhtida.

'''Administraator'''
* IP-aadresside järgi ülevaadet, millistes riikides karpe kasutatakse (üldised arvandmed).
* Karpidesse paigaldatud kellade nimistut (ilma muude kasutajaandmeteta).
* Näeb kasutajate statistikat.

'''Tootja'''
* Saata personaalseid teateid kellakollektsionääridele.

== Inkrement #2 ==
'''Kasutaja'''
* Saab saata teate tootjale.
* Näeb tootja vastust.
* Näha karbi seisundit, kas karp on hetkel wifiga ühendatud või mitte.

'''Administraator'''
* Näha kellade üleskeeramise mehhanismide arvnäitajaid (madalaim kiirus, keskmine kiirus, tippkiirus; samuti liikumise suundade arvnäitajaid).
* Näeb tegevuste ajalugu kliendist.

'''Tootja'''
* Saab lugeda kasutaja teadet.
* Saab vastata kasutajale.

'''Hooldaja'''
* Saab info hooldamist vajavate kellade kohta.

== Inkrement #3 ==
'''Kasutaja'''
* On ehitatud keeletugi.

'''Tootja'''
* On ehitatud keeletugi.

'''Hooldaja'''
* On ehitatud keeletugi.

Inkrementid valmisid (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

= XML ülesanne =
Järgnevalt esitame oma XML-ülesande tulemused.

== IT Management Transformation XML To XML ==
<pre>
<?xml version="1.0" encoding="utf-8"?>
<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">
<xsl:output method="xml" indent="yes"/>
<xsl:template match="/">
<unhandledDevices>
<xsl:for-each select="customers/customer/locations/location/items/item[@isInWorkingCondition='false']">
<device>
<name>
<xsl:value-of select="manufacturer"/>
<xsl:text> </xsl:text>
<xsl:value-of select="model"/>
</name>
<ticket>
<xsl:for-each select="tickets/ticket[@isHandled='false']">
<ticket_id>
<xsl:value-of select="@id"/>
</ticket_id>
<issued_in>
<xsl:value-of select="@issuedIn"/>
</issued_in>
<description>
<xsl:value-of select="description"/>
</description>
</xsl:for-each>
</ticket>
</device>
</xsl:for-each>
</unhandledDevices>
</xsl:template>
</xsl:stylesheet>
</pre>

== IT Management Transformation HTML ==

<pre>
<?xml version="1.0" encoding="utf-8"?>
<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">
<xsl:output method="html" indent="yes"/>
<xsl:template match="/">

<html>
<head>
<title>ItManagement Laptops</title>
</head>
<body style="background-color:#F7F7F7">
<h1>Computers</h1>
<xsl:for-each select="/customers/customer/locations/location/items/item[@type='laptopComputer']">
<xsl:sort select="@isActive='false'"/>
<hr />
<div>
<h3>
<xsl:value-of select="manufacturer"/>
</h3>
Model: 
<xsl:value-of select="model"/>
 
Serial number: 
<xsl:value-of select="serialNumber"/>
 
Date of purchase: 
<xsl:value-of select="dateOfPurchase"/>
 
Operating system: 
<xsl:value-of select="operatingSystem"/>
 
Is on active list: 
<xsl:value-of select="@isActive"/>
 
</div>

<div style="background-color:#E3FAEE" >

<xsl:for-each select="tickets/ticket">
<xsl:choose>
<xsl:when test="@isHandled='true'">
<h3>Handled tickets</h3>
<ul>
Issued in: 
<xsl:value-of select="@issuedIn"/>
 
Ticket ID: 
<xsl:value-of select="@id" />
 
Description: 
<xsl:value-of select="description"/>
 
Solution: 
<xsl:value-of select="solution"/>
 
</ul>
</xsl:when>
<xsl:when test="@isHandled='false'">
<div style="background-color:#FDE5E5">
<h3>Unhandled tickets</h3>
<ul>
Issued in: 
<xsl:value-of select="@issuedIn"/>
 
Ticket ID: 
<xsl:value-of select="@id" />
 
Description: 
<xsl:value-of select="description"/>
 
Solution: 
<xsl:value-of select="solution"/>
 
</ul>
</div>
</xsl:when>
</xsl:choose>
</xsl:for-each>

</div>
</xsl:for-each>
</body>
</html>
</xsl:template>
</xsl:stylesheet>
</pre>

== IT Management XSD ==

<pre>
<?xml version="1.0" encoding="utf-8"?>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="customers">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="customer">
<xs:complexType>
<xs:sequence>
<xs:element name="customerName" type="xs:string" />
<xs:element minOccurs="0" name="contactPerson" type="xs:string" />
<xs:element name="e-mail" type="xs:string" />
<xs:element name="phoneNumber" type="xs:string" />
<xs:element name="locations">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="location">
<xs:complexType>
<xs:sequence>
<xs:element name="city" type="xs:string" />
<xs:element name="address" type="xs:string" />
<xs:element name="comment" type="xs:string" />
<xs:element minOccurs="0" name="localContactPerson" type="xs:string" />
<xs:element minOccurs="0" name="localPhone" type="xs:string" />
<xs:element name="items">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="item">
<xs:complexType>
<xs:sequence>
<xs:element name="manufacturer" type="xs:string" />
<xs:element name="model" type="xs:string" />
<xs:element name="serialNumber" type="xs:string" />
<xs:element name="dateOfPurchase" type="xs:date" />
<xs:element minOccurs="0" name="operatingSystem">
<xs:complexType>
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute name="version" type="xs:string" use="required" />
</xs:extension>
</xs:simpleContent>
</xs:complexType>
</xs:element>
<xs:element minOccurs="0" name="tickets">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="ticket">
<xs:complexType>
<xs:sequence>
<xs:element name="description" type="xs:string" />
<xs:element name="solution" type="xs:string" />
</xs:sequence>
<xs:attribute name="id" type="xs:string" use="required" />
<xs:attribute name="issuedIn" type="xs:date" use="required" />
<xs:attribute name="isHandled" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:unsignedInt" use="required" />
<xs:attribute name="type" type="xs:string" use="required" />
<xs:attribute name="isActive" type="xs:boolean" use="required" />
<xs:attribute name="isUnderWarranty" type="xs:boolean" use="required" />
<xs:attribute name="warrantyInMonths" type="xs:unsignedByte" use="required" />
<xs:attribute name="isInWorkingCondition" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="type" type="xs:string" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:unsignedInt" use="required" />
<xs:attribute name="type" type="xs:string" use="required" />
<xs:attribute name="isActive" type="xs:boolean" use="required" />
<xs:attribute name="hasManyLocations" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
</pre>

== IT Management XML ==

<pre>
<?xml version="1.0" encoding="utf-8" ?>
<customers>
<customer id="33" type="company" isActive="true" hasManyLocations="true">
<customerName>Elamustevaba OÜ</customerName>
<contactPerson>Juhan Pühamees</contactPerson>
<e-mail>juhan@evaba.com</e-mail>
<phoneNumber>+37256565656</phoneNumber>
<locations>
<location type="office">
<city>Tallinn</city>
<address><![CDATA[Pikk 7, 56401]]></address>
<comment><![CDATA[3. korrus -> paremat kätt]]></comment>
<localContactPerson>Maiu Piimaauto</localContactPerson>
<localPhone>+3726510510</localPhone>
<items>
<item id="1" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="36" isInWorkingCondition="false">
<manufacturer>Dell</manufacturer>
<model>Inspiron 3558</model>
<serialNumber>6FGH5JN</serialNumber>
<dateOfPurchase>2017-07-22</dateOfPurchase>
<operatingSystem version="1709">Windows 10 Home</operatingSystem>
<tickets>
<ticket id="HWI001" issuedIn="2017-11-21" isHandled="true">
<description><![CDATA[Wi-Fi is not working]]></description>
<solution><![CDATA[Wi-Fi card replaced (Under the warranty)]]></solution>
</ticket>
<ticket id="SWI256" issuedIn="2018-05-05" isHandled="false">
<description><![CDATA[Computer keeps showing login screen]]></description>
<solution></solution>
</ticket>
</tickets>
</item>
<item id="55" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="60" isInWorkingCondition="true">
<manufacturer>Dell</manufacturer>
<model>Latitude E7550</model>
<serialNumber>8JGR78U</serialNumber>
<dateOfPurchase>2016-06-15</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Home</operatingSystem>
</item>
</items>
</location>
<location type="store">
<city>Tallinn</city>
<address><![CDATA[Lai 17, 56401]]></address>
<comment><![CDATA[keldrikorrusel]]></comment>
<localContactPerson>Tanja Õielemb</localContactPerson>
<localPhone>+3726510520</localPhone>
<items>
<item id="83" type="desktopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Lenovo</manufacturer>
<model>ThinkCentre M715</model>
<serialNumber>IO25689AD54KL</serialNumber>
<dateOfPurchase>2017-12-01</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Pro</operatingSystem>
</item>
<item id="12" type="monitor" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>AOC</manufacturer>
<model>L456</model>
<serialNumber>9803987YE54</serialNumber>
<dateOfPurchase>2015-05-03</dateOfPurchase>
<tickets>
<ticket id="HWI126" issuedIn="2016-01-18" isHandled="true">
<description><![CDATA[Doesn't work, no picture.]]></description>
<solution><![CDATA[Wasn't plugged in. Technician did it - works again!]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
<customer id="02" type="private" isActive="true" hasManyLocations="false">
<customerName>Kessu Sisselasi</customerName>
<e-mail>kessu@tripp.org</e-mail>
<phoneNumber>+372555555</phoneNumber>
<locations>
<location type="home">
<city>Saue</city>
<address><![CDATA[Kooli 4-8, 78965]]></address>
<comment><![CDATA[2. korrus. Kitsad koridorid.]]></comment>
<items>
<item id="98" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Acer</manufacturer>
<model>Aspire 5</model>
<serialNumber>475YRT89K4</serialNumber>
<dateOfPurchase>2018-03-25</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Home</operatingSystem>
</item>
<item id="4" type="laptopComputer" isActive="false" isUnderWarranty="false" warrantyInMonths="36" isInWorkingCondition="true">
<manufacturer>Lenovo</manufacturer>
<model>IdeaPad L530</model>
<serialNumber>U89TRY765ME</serialNumber>
<dateOfPurchase>2007-08-14</dateOfPurchase>
<operatingSystem version="">Windows XP</operatingSystem>
<tickets>
<ticket id="SWI069" issuedIn="2010-01-28" isHandled="true">
<description><![CDATA[Blue screen.]]></description>
<solution><![CDATA[Video driver update.]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
<customer id="26" type="company" isActive="true" hasManyLocations="true">
<customerName>Aktsiaselts OÜ</customerName>
<contactPerson>Gunnar Kuningas</contactPerson>
<e-mail>gunnar@kunn.ee</e-mail>
<phoneNumber>+3726985236</phoneNumber>
<locations>
<location type="office">
<city>Loksa</city>
<address><![CDATA[Kalda 14, 78965]]></address>
<comment><![CDATA[Sissepääs Rimi poolt, helesinine uks]]></comment>
<items>
<item id="26" type="laptopComputer" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Apple</manufacturer>
<model>Macbook Air</model>
<serialNumber>258JUY369</serialNumber>
<dateOfPurchase>2017-03-01</dateOfPurchase>
<operatingSystem version="High Sierra">OS X</operatingSystem>
</item>
<item id="59" type="laptopComputer" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="false">
<manufacturer>Acer</manufacturer>
<model>Chromebook 11</model>
<serialNumber>U89TRY765ME</serialNumber>
<dateOfPurchase>2016-04-23</dateOfPurchase>
<operatingSystem version="">Chrome OS</operatingSystem>
<tickets>
<ticket id="HWI046" issuedIn="2010-02-28" isHandled="false">
<description><![CDATA[Stripes on screen]]></description>
<solution><![CDATA[]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
</customers>
</pre>

= Link klientrakendusele ja API-le =
https://drive.google.com/file/d/1FU3XGGVHbn4BNNHAsOs7DQ4CzpEDwZUt/view?usp=sharing

== Readme asemel ==

1. lase API käima, tee andmebaaside migratsioonid ja update-database
2. implementeeritud on kõik teenused, mis on nähtaval Swaggeris aadressil: http://localhost:[pordinumber]/Swagger
3. kliendirakendus asub kataloogis 'WatchWindersClient' ja tegemist on solutioniga, mille võiks käivitada teises Visual Studio aknas
4. klientrakenduse käivitumiseks tuleks muuta App.config failis muuta ära localhost portide numbrid asendades need enda arvutis oleva localhost pordiga ning lisada kehtiv JWT AccessToken, mille saab Postmaniga aadressilt api/Security/getToken "Email" ja "Password" abil pärast seda kui kasutaja on loodud

= Kasutatud kirjandus ja allikad =

1. Albahari, Joseph, Albari, Ben 2017. C# 7.0 in A Nutshell. Sebastopol: O’Reilly 
2. MariaDB Foundation. MariaDB. Kättesaadav:https://mariadb.org/ 
3. Martin, Robert 2018. Clean Architecture. Boston: Pearson Education

WatchWinders

2018-06-08T20:11:08Z

Tkuuskma: /* Tegevuste logi */

= Meeskond =

Toomas Juhkov, toomas.juhkov@gmail.com 
Tiit Kuuskmäe, tiit.kuuskmae@gmail.com 
Kunnar Kukk, Kunnar.kukk@gmail.com 

= Tegevuste logi =

08.02.2018 - meeskonna loomine, kokkuleppe sõlmimine teema osas 
10.02.2018 - õppejõu teavitamine koos esmase andmemudeliga 
15.02.2018 - lõpliku andmemudeli valmimine(versioon 5) 
18.02.2018 - õppejõu kinnitus, et teema ja meeskond kvalifiseeruvad 
22.02.2018 - viki lehe loomine ja analüüsi koostamise alustamine 
26.02.2018 - tiimi lisandus Kunnar Kukk 
01.03.2018 - tiimi sprint koosolek(seoses täiendava tiimiliikme lisandumisega täpsustasime skoopi) 
03.03.2018 - alustasime koodi kirjutamisega (tabelid klassideks ja annotatsioonid peale) 
06.03.2018 - täiendasime andmemudelit olemiga "UserTypeState" (et saaks muuta kasutajatüüpi) 
08.03.2018 - tiimi sprint koosolek 
18.03.2018 - lisasime olemid "Address", "AddressU", "AddressM", "OfferOfUser", "MediaInOffer" 
22.03.2018 - tiimi sprint koosolek, mis oli pühendatud andmemudeli täiendamisele 
23.03.2018 - pikem tiimi hackathon andmemudeli teemal 
29.03.2018 - täiendatud wiki lehte täielikult ringitöötatud andmemudeliga 
30.03.2018 - täiendatud wiki lehte andmemudeli metainfoga 
09.04.2018 - silusime andmemudelit (mõningad ebavajalikud viited olid sisse jäänud) 
06.05.2018 - panime uuendatud andmemudeli projekti wiki lehele üles 
07.05.2018 - osalesime õppejõu Mait Poska korraldatud hackathonil 
08.06.2018 - XML ülesanne, klientrakenduse ja API kood sai wiki lehel avalikuks 

= Kasutatavad metoodikad =

WatchWinders projektis plaanime kasutada peamiselt kaht metoodikat:

1. läbiv retsenseerimine (üks paariline teeb midagi valmis ja teine teeb sellele ülevaatuse; üksus lisatakse kui ülevaatus on lõplikult läbitud ning osapoolte vahel on saabunud konsensus) 
2. paaris programmeerimine (istume ühe masina taha maha ja kirjutame kolmekesi)

Tulenevalt kaugõppe formaadist saab ülekaalus olema esimene variant. Teist metoodikat kasutame nende osade kirjutamiseks, mille puhul võib arvata, et nende lahendamine on keeruline või et lahenduskäike võib olla väga erinevaid. Püüame jooksvalt siinses vikis kajastada ka seda, millise metoodika järgi üks või teine osa valmis.

= Projekti osad =

Alljärgnevalt anname ülevaate projekti osadest: 

(1) andmemudel 
(2) veebiteenuse analüüs 
(3) Minimum Viable Product definitsioon 
(4) Inkrement #1 
(5) Inkrement #2 
(6) Inkrement #3 

Projekti osad on meie viki lehel kirjeldatud valmimise järjekorras.

== Andmemudel ==

Andmemudeli koostamisel lähtusime õppejõu ette antud kriteeriumist, mille järgi andmemudelis on vähemalt 6 põhiolemit (tähistatud tumesinise ja lillaga - meie mudelis 11 tk),
mille hulgas ei sisaldu kasutajate tabelit (Person). 
 
Põhiolemid: 
* Watch - kell 
* Person - kasutaja/kollektsionäär või firma esindaja 
* Box - kellakarp 
* Organization - tootjad, edasimüüjad, hooldus 
* Settings - kellakarbi seade 
* Offer - pakkumine kollektsionäärile 
* Media - meediafailid kellade ja karpide kohta 
* Address - kasutaja/organisatsiooni aadress 
* ElectronicContact - elektrooniliste kontaktide loend 
* Log - logi 
* Access - paroolid ja kasutajanimed 
* Error - vead 
 
Type abiolemid: 
* WatchType - kellatüübid 
* PersonType - isikutüübid: admin, kasutaja 
* OrganizationType - organisatsioonitüübid: tootja, hooldaja, edasimüüja jt 
* ActionType - logi tüübid 
* ContactType - elektroonilise kontakti tüüp: skype, email, telefon jt 
 
Olekud: 
* PersonTypeState - isiku rolli kehtivus ajahetkel (isiku ja tüübi vaheline seos) 
* OrganizationTypeState - organisatsiooni olek(ud) ajahetkel 
 
Kuuluvus: 
* PersonWatch - isikute ja kellade vahelised seosed 
* PersonBox - isiku ja karbi vaheline seos 
* PersonAccess - isiku ja autentimisandmete vaheline seos 
* WatchInBox - kella ja karbi vaheline seos 
* ErrorInWatch - vea ja kella vaheline seos 
* SettingsInBox - seade ja karbi vaheline seos 
* WatchInOrganization - kella ja tootja vaheline seos 
* PersonInOrganization - isiku ja ettevõtte/organisatsiooni vaheline seos 
* SettingsOfWatchType - seade ja kellatüübi vaheline seos 
 
Abstraktsioonid: 
* Locator - abstraktsioon erinevate kontaktitüüpide jaoks 
* Party - abstraktsioon erinevate inimeste, organisatsioonide jt jaoks 
 
Kommunikatsioon: 
* OfferToPerson - isikule suunatud pakkumised 
* OfferFromPerson - isikult lähtuv pakkumine 
 
 
 
[[File:ww_andmemudel_06052018.png]]
 

Andmemudel valmis (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

== Veebiteenuse analüüs ==

Alljärgnevalt esitame kellakarpide infosüsteemi analüüsi järgmistes osades:

(1) toote/teenuse kirjeldus 
(2) probleemi kirjeldus 
(3) lahendus 
(4) süsteemi kasutajad 
(5) loodava API võimalused 
(6) funktsionaalsed nõuded 
(7) mittefunktsionaalsed nõuded 

=== Toote/teenuse kirjeldus ===
Teenuse eesmärgiks on lahendada probleem, kuidas jälgida kellakarpide kaudu mehhaaniliste käekellade seisundit ning keerata neid automaatselt üles distantsilt, näiteks juhul, kui kellade kollektsionäär ei asu füüsiliselt igapäevaselt oma kellade juures. Teenus võimaldab ka tootjal uuendada kontaktandmeid, saata personaalseid teateid. Administraatorile annab ülevaate platvormis toimuvast.

=== Probleemi kirjeldus ===
Mehhaaniliste käekellade kollektsionääride huvi kellakarpide vastu on mitmetahuline. Kollektsionääre huvitab arvepidamine – mitu kella, missuguste omaduste ja eripäradega neil kollektsioonis on. Teisalt soov eksponeerida oma kogusid kolleegidele ja sõpradele. Kellakarpidega täidetud sein või riiulid loovad selleks suurepärase võimaluse. Kolmandaks praktiline vajadus tagada kellavedrude õige vinnastatuse aste. Kaasaja mehhaanilised kellamehhanismid (''automatic'') võimaldavad kellakorpuse füüsilisel liigutamisel kellavedru automaatselt vinnastada.

Näiteks piisab kella kinnitamisest käele, et see hakkaks end käe liigutamisel üles keerama. Kuidas keerata aga üles seisvat kella, mis seisab paigal kellakarbis? Selleks on tänapäeva kellakarpides elektrimootor, mis tagab kella liigutamise vastavalt kellatüübile ettenähtud ööpäevase graafiku alusel. Kollektsionääride üheks probleemiks on see, kuidas juhtida sellist karpi ja omada jooksvat ülevaadet kõikidest oma karpidest, nende tehnilisest seadistusest ja kollektsiooni kuuluvatest kelladest olles tööreisil välisriigis?

=== Lahendus ===
Probleemi lahendamiseks ehitame REST + ASP.NET Core + WebAPI koos kliendiga, mis võimaldab kellakollektsionääridel hallata kellasid karpides, administraatoritel saada ülevaate süsteemist ning tootjatele lisada infot kollektsionääridele. Käesoleva projekti käigus '''ei tegeleta''' kahe IoT lahenduse kui terviku seisukohast olulise nüansiga: (i) karbi püsivara (''firmware'') loomisega, (ii) klientrakenduse ''frontend'' lõpliku häälestamisega (ilus .css ja pildid).

=== Süsteemi kasutajad ===
'''Kollektsionäär''' - haldab ja muudab infot oma kellade ning oma kellakarpide kohta. 
'''Administraator''' - haldab süsteemi infot, vajadusel eemaldab probleeme. 
'''Tootja''' - saab saata süsteemi kollektsionääridele mõeldud infot. 
'''Hooldaja''' - saab infot hooldamist vajavate kellade ja -karpide kohta. 

=== Loodava API võimalused ===
Alljärgnevalt vaatame loodava API võimalusi kasutajagruppide kaupa:

'''Kasutajale/kellakollektsionäärile'''
* Saada ülevaade kelladest ja kellakarpidest (lisada, muuta, vaadata).
* Muuta karbis oleva kella kohta käivat informatsiooni (kella nimi, tootja, tootmise aeg, viitenumber, mehhanism, jõureservi jääk (valikuline), foto kellast, kellarihma liik, muu).
* Karpe juhtida (keerata automaatselt üles). Näha ja muuta kella üleskeerava mehhanismi liikumise kiirust ja muid detaile (nt liikumise suund).
* Näha karbi seisundit, kas karp on hetkel wifiga ühendatud või mitte.
* Näha karbilt saabunud veateateid.
* Sisestada infot kella seisundist.
* Suhelda hooldajate ja tootjatega

'''Tootjale'''
* Uuendada kontaktandmeid.
* Saata personaalseid teateid kellakollektsionääridele.

'''Administraatorile'''
* Näha võrku ühendatud karpide arvu.
* Näha karpidesse paigaldatud kellade nimistut (ilma muude kasutajaandmeteta).
* Näha kellade üleskeeramise mehhanismide arvnäitajaid (madalaim kiirus, keskmine kiirus, tippkiirus; samuti liikumise suundade arvnäitajaid).
* IP-aadresside järgi ülevaadet, millistes riikides karpe kasutatakse (üldised arvandmed).
* Veateatega karpide arv süsteemis (üldised arvandmed).

=== Funktsionaalsed nõuded ===
* Kõik tegevused peavad olema autoriseeritud.
* REST + ASP.NET Core + WebAPI tagastab infot valideeritud JSON formaadis.
* API veatöötlus on tehtud, kasutades standardseid veakoode.
* API-le on tehtud 'health check'.
* Kõik kasutajad peavad saama end autoriseerida.
* Kasutaja, tootja ja administraatori tegevused logitakse.
* Logi ei ole muudetav, vaid on kättesaadav.
* Kasutaja ega tootja ei näe teiste kasutajate ega tootjate infot.
* API klient on kohanduv mobiilile, tahvlile ja desktoparvutile.
* Sisendandmed on valideeritud.

=== Mittefunktsionaalsed nõuded ===
* API-le on lisatud Swagger fail.
* Teenus ja tehniline lahendus on dokumenteeritud.
* Süsteemi kood on vabalt ligipääsetav, täiendatav ning allalaetav.

Esitame töö etappidena, kus kõigepealt defineerime ära Minimum Viable Producti [https://en.wikipedia.org/wiki/Minimum_viable_product] ehk selle miinimumi, mis pakub kasutajale maksimaalset väärtust. See tähendab API loomist ning esmase kliendi loomist kõigile MVP-s defineeritud kasutajagruppidele. Seejärel realiseerime projekti inkrementide ehk tootearenduse sammudena, milles lisame uusi funktsionaalsusi. Ideaalis jõuame realiseerida kõik sammud, kuid kuna teeme nimetatud tööd antud ajaraamis ja koosseisus esmakordselt, siis võtame vabaduse ka realiseerida korralikult niipalju, kui jõuame projekti käigus ära teha.

Võimalik, et meie lõpptulemus erineb mõnes osas esitatud analüüsist. Seda olenevalt sellest kui edukalt meil õnnestub plaanitud funktsionaalsusi realiseerida. Erisusi plaanime käsitleda vastavas 'post production' jaotuses, kus loendame ka projektist kogunenud peamised õppetunnid.

Analüüs valmis (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

== Minimum Viable Product definitsioon ==
'''Kasutaja'''
* Kasutaja saab süsteemi logida ning välja logida
* Kasutaja saab lisada uue kellakarbi
* Kasutaja saab lisada uue kella kellakarpi
* Kasutaja saab muuta kella infot kellakarbis
* Kasutaja saab näha ülevaadet oma karpidest
* Kasutaja saab muuta kellakarbi seadeid
* Kasutaja saab kustutada kella karbis
* Kasutaja saab kustutada kellakarbi

'''Administraator'''
* Näeb autoriseeritult logisid

'''Tootja'''
* Saab lisada kontaktandmeid
* Saab kontaktandmeid muuta

== Inkrement #1 ==
'''Kasutaja'''
* Näeb karbilt saabunud veateateid.
* Saab kellakarpe juhtida.

'''Administraator'''
* IP-aadresside järgi ülevaadet, millistes riikides karpe kasutatakse (üldised arvandmed).
* Karpidesse paigaldatud kellade nimistut (ilma muude kasutajaandmeteta).
* Näeb kasutajate statistikat.

'''Tootja'''
* Saata personaalseid teateid kellakollektsionääridele.

== Inkrement #2 ==
'''Kasutaja'''
* Saab saata teate tootjale.
* Näeb tootja vastust.
* Näha karbi seisundit, kas karp on hetkel wifiga ühendatud või mitte.

'''Administraator'''
* Näha kellade üleskeeramise mehhanismide arvnäitajaid (madalaim kiirus, keskmine kiirus, tippkiirus; samuti liikumise suundade arvnäitajaid).
* Näeb tegevuste ajalugu kliendist.

'''Tootja'''
* Saab lugeda kasutaja teadet.
* Saab vastata kasutajale.

'''Hooldaja'''
* Saab info hooldamist vajavate kellade kohta.

== Inkrement #3 ==
'''Kasutaja'''
* On ehitatud keeletugi.

'''Tootja'''
* On ehitatud keeletugi.

'''Hooldaja'''
* On ehitatud keeletugi.

Inkrementid valmisid (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

= XML ülesanne =
Järgnevalt esitame oma XML-ülesande tulemused.

== IT Management Transformation XML To XML ==
<pre>
<?xml version="1.0" encoding="utf-8"?>
<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">
<xsl:output method="xml" indent="yes"/>
<xsl:template match="/">
<unhandledDevices>
<xsl:for-each select="customers/customer/locations/location/items/item[@isInWorkingCondition='false']">
<device>
<name>
<xsl:value-of select="manufacturer"/>
<xsl:text> </xsl:text>
<xsl:value-of select="model"/>
</name>
<ticket>
<xsl:for-each select="tickets/ticket[@isHandled='false']">
<ticket_id>
<xsl:value-of select="@id"/>
</ticket_id>
<issued_in>
<xsl:value-of select="@issuedIn"/>
</issued_in>
<description>
<xsl:value-of select="description"/>
</description>
</xsl:for-each>
</ticket>
</device>
</xsl:for-each>
</unhandledDevices>
</xsl:template>
</xsl:stylesheet>
</pre>

== IT Management Transformation HTML ==

<pre>
<?xml version="1.0" encoding="utf-8"?>
<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">
<xsl:output method="html" indent="yes"/>
<xsl:template match="/">

<html>
<head>
<title>ItManagement Laptops</title>
</head>
<body style="background-color:#F7F7F7">
<h1>Computers</h1>
<xsl:for-each select="/customers/customer/locations/location/items/item[@type='laptopComputer']">
<xsl:sort select="@isActive='false'"/>
<hr />
<div>
<h3>
<xsl:value-of select="manufacturer"/>
</h3>
Model: 
<xsl:value-of select="model"/>
 
Serial number: 
<xsl:value-of select="serialNumber"/>
 
Date of purchase: 
<xsl:value-of select="dateOfPurchase"/>
 
Operating system: 
<xsl:value-of select="operatingSystem"/>
 
Is on active list: 
<xsl:value-of select="@isActive"/>
 
</div>

<div style="background-color:#E3FAEE" >

<xsl:for-each select="tickets/ticket">
<xsl:choose>
<xsl:when test="@isHandled='true'">
<h3>Handled tickets</h3>
<ul>
Issued in: 
<xsl:value-of select="@issuedIn"/>
 
Ticket ID: 
<xsl:value-of select="@id" />
 
Description: 
<xsl:value-of select="description"/>
 
Solution: 
<xsl:value-of select="solution"/>
 
</ul>
</xsl:when>
<xsl:when test="@isHandled='false'">
<div style="background-color:#FDE5E5">
<h3>Unhandled tickets</h3>
<ul>
Issued in: 
<xsl:value-of select="@issuedIn"/>
 
Ticket ID: 
<xsl:value-of select="@id" />
 
Description: 
<xsl:value-of select="description"/>
 
Solution: 
<xsl:value-of select="solution"/>
 
</ul>
</div>
</xsl:when>
</xsl:choose>
</xsl:for-each>

</div>
</xsl:for-each>
</body>
</html>
</xsl:template>
</xsl:stylesheet>
</pre>

== IT Management XSD ==

<pre>
<?xml version="1.0" encoding="utf-8"?>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="customers">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="customer">
<xs:complexType>
<xs:sequence>
<xs:element name="customerName" type="xs:string" />
<xs:element minOccurs="0" name="contactPerson" type="xs:string" />
<xs:element name="e-mail" type="xs:string" />
<xs:element name="phoneNumber" type="xs:string" />
<xs:element name="locations">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="location">
<xs:complexType>
<xs:sequence>
<xs:element name="city" type="xs:string" />
<xs:element name="address" type="xs:string" />
<xs:element name="comment" type="xs:string" />
<xs:element minOccurs="0" name="localContactPerson" type="xs:string" />
<xs:element minOccurs="0" name="localPhone" type="xs:string" />
<xs:element name="items">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="item">
<xs:complexType>
<xs:sequence>
<xs:element name="manufacturer" type="xs:string" />
<xs:element name="model" type="xs:string" />
<xs:element name="serialNumber" type="xs:string" />
<xs:element name="dateOfPurchase" type="xs:date" />
<xs:element minOccurs="0" name="operatingSystem">
<xs:complexType>
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute name="version" type="xs:string" use="required" />
</xs:extension>
</xs:simpleContent>
</xs:complexType>
</xs:element>
<xs:element minOccurs="0" name="tickets">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="ticket">
<xs:complexType>
<xs:sequence>
<xs:element name="description" type="xs:string" />
<xs:element name="solution" type="xs:string" />
</xs:sequence>
<xs:attribute name="id" type="xs:string" use="required" />
<xs:attribute name="issuedIn" type="xs:date" use="required" />
<xs:attribute name="isHandled" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:unsignedInt" use="required" />
<xs:attribute name="type" type="xs:string" use="required" />
<xs:attribute name="isActive" type="xs:boolean" use="required" />
<xs:attribute name="isUnderWarranty" type="xs:boolean" use="required" />
<xs:attribute name="warrantyInMonths" type="xs:unsignedByte" use="required" />
<xs:attribute name="isInWorkingCondition" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="type" type="xs:string" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:unsignedInt" use="required" />
<xs:attribute name="type" type="xs:string" use="required" />
<xs:attribute name="isActive" type="xs:boolean" use="required" />
<xs:attribute name="hasManyLocations" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
</pre>

== IT Management XML ==

<pre>
<?xml version="1.0" encoding="utf-8" ?>
<customers>
<customer id="33" type="company" isActive="true" hasManyLocations="true">
<customerName>Elamustevaba OÜ</customerName>
<contactPerson>Juhan Pühamees</contactPerson>
<e-mail>juhan@evaba.com</e-mail>
<phoneNumber>+37256565656</phoneNumber>
<locations>
<location type="office">
<city>Tallinn</city>
<address><![CDATA[Pikk 7, 56401]]></address>
<comment><![CDATA[3. korrus -> paremat kätt]]></comment>
<localContactPerson>Maiu Piimaauto</localContactPerson>
<localPhone>+3726510510</localPhone>
<items>
<item id="1" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="36" isInWorkingCondition="false">
<manufacturer>Dell</manufacturer>
<model>Inspiron 3558</model>
<serialNumber>6FGH5JN</serialNumber>
<dateOfPurchase>2017-07-22</dateOfPurchase>
<operatingSystem version="1709">Windows 10 Home</operatingSystem>
<tickets>
<ticket id="HWI001" issuedIn="2017-11-21" isHandled="true">
<description><![CDATA[Wi-Fi is not working]]></description>
<solution><![CDATA[Wi-Fi card replaced (Under the warranty)]]></solution>
</ticket>
<ticket id="SWI256" issuedIn="2018-05-05" isHandled="false">
<description><![CDATA[Computer keeps showing login screen]]></description>
<solution></solution>
</ticket>
</tickets>
</item>
<item id="55" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="60" isInWorkingCondition="true">
<manufacturer>Dell</manufacturer>
<model>Latitude E7550</model>
<serialNumber>8JGR78U</serialNumber>
<dateOfPurchase>2016-06-15</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Home</operatingSystem>
</item>
</items>
</location>
<location type="store">
<city>Tallinn</city>
<address><![CDATA[Lai 17, 56401]]></address>
<comment><![CDATA[keldrikorrusel]]></comment>
<localContactPerson>Tanja Õielemb</localContactPerson>
<localPhone>+3726510520</localPhone>
<items>
<item id="83" type="desktopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Lenovo</manufacturer>
<model>ThinkCentre M715</model>
<serialNumber>IO25689AD54KL</serialNumber>
<dateOfPurchase>2017-12-01</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Pro</operatingSystem>
</item>
<item id="12" type="monitor" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>AOC</manufacturer>
<model>L456</model>
<serialNumber>9803987YE54</serialNumber>
<dateOfPurchase>2015-05-03</dateOfPurchase>
<tickets>
<ticket id="HWI126" issuedIn="2016-01-18" isHandled="true">
<description><![CDATA[Doesn't work, no picture.]]></description>
<solution><![CDATA[Wasn't plugged in. Technician did it - works again!]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
<customer id="02" type="private" isActive="true" hasManyLocations="false">
<customerName>Kessu Sisselasi</customerName>
<e-mail>kessu@tripp.org</e-mail>
<phoneNumber>+372555555</phoneNumber>
<locations>
<location type="home">
<city>Saue</city>
<address><![CDATA[Kooli 4-8, 78965]]></address>
<comment><![CDATA[2. korrus. Kitsad koridorid.]]></comment>
<items>
<item id="98" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Acer</manufacturer>
<model>Aspire 5</model>
<serialNumber>475YRT89K4</serialNumber>
<dateOfPurchase>2018-03-25</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Home</operatingSystem>
</item>
<item id="4" type="laptopComputer" isActive="false" isUnderWarranty="false" warrantyInMonths="36" isInWorkingCondition="true">
<manufacturer>Lenovo</manufacturer>
<model>IdeaPad L530</model>
<serialNumber>U89TRY765ME</serialNumber>
<dateOfPurchase>2007-08-14</dateOfPurchase>
<operatingSystem version="">Windows XP</operatingSystem>
<tickets>
<ticket id="SWI069" issuedIn="2010-01-28" isHandled="true">
<description><![CDATA[Blue screen.]]></description>
<solution><![CDATA[Video driver update.]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
<customer id="26" type="company" isActive="true" hasManyLocations="true">
<customerName>Aktsiaselts OÜ</customerName>
<contactPerson>Gunnar Kuningas</contactPerson>
<e-mail>gunnar@kunn.ee</e-mail>
<phoneNumber>+3726985236</phoneNumber>
<locations>
<location type="office">
<city>Loksa</city>
<address><![CDATA[Kalda 14, 78965]]></address>
<comment><![CDATA[Sissepääs Rimi poolt, helesinine uks]]></comment>
<items>
<item id="26" type="laptopComputer" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Apple</manufacturer>
<model>Macbook Air</model>
<serialNumber>258JUY369</serialNumber>
<dateOfPurchase>2017-03-01</dateOfPurchase>
<operatingSystem version="High Sierra">OS X</operatingSystem>
</item>
<item id="59" type="laptopComputer" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="false">
<manufacturer>Acer</manufacturer>
<model>Chromebook 11</model>
<serialNumber>U89TRY765ME</serialNumber>
<dateOfPurchase>2016-04-23</dateOfPurchase>
<operatingSystem version="">Chrome OS</operatingSystem>
<tickets>
<ticket id="HWI046" issuedIn="2010-02-28" isHandled="false">
<description><![CDATA[Stripes on screen]]></description>
<solution><![CDATA[]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
</customers>
</pre>

= Link klientrakendusele ja API-le =
https://drive.google.com/file/d/1FU3XGGVHbn4BNNHAsOs7DQ4CzpEDwZUt/view?usp=sharing

= Kasutatud kirjandus ja allikad =

1. Albahari, Joseph, Albari, Ben 2017. C# 7.0 in A Nutshell. Sebastopol: O’Reilly 
2. MariaDB Foundation. MariaDB. Kättesaadav:https://mariadb.org/ 
3. Martin, Robert 2018. Clean Architecture. Boston: Pearson Education

WatchWinders

2018-06-08T20:06:48Z

Tkuuskma:

= Meeskond =

Toomas Juhkov, toomas.juhkov@gmail.com 
Tiit Kuuskmäe, tiit.kuuskmae@gmail.com 
Kunnar Kukk, Kunnar.kukk@gmail.com 

= Tegevuste logi =

08.02.2018 - meeskonna loomine, kokkuleppe sõlmimine teema osas 
10.02.2018 - õppejõu teavitamine koos esmase andmemudeliga 
15.02.2018 - lõpliku andmemudeli valmimine(versioon 5) 
18.02.2018 - õppejõu kinnitus, et teema ja meeskond kvalifiseeruvad 
22.02.2018 - viki lehe loomine ja analüüsi koostamise alustamine 
26.02.2018 - tiimi lisandus Kunnar Kukk 
01.03.2018 - tiimi sprint koosolek(seoses täiendava tiimiliikme lisandumisega täpsustasime skoopi) 
03.03.2018 - alustasime koodi kirjutamisega (tabelid klassideks ja annotatsioonid peale) 
06.03.2018 - täiendasime andmemudelit olemiga "UserTypeState" (et saaks muuta kasutajatüüpi) 
08.03.2018 - tiimi sprint koosolek 
18.03.2018 - lisasime olemid "Address", "AddressU", "AddressM", "OfferOfUser", "MediaInOffer" 
22.03.2018 - tiimi sprint koosolek, mis oli pühendatud andmemudeli täiendamisele 
23.03.2018 - pikem tiimi hackathon andmemudeli teemal 
29.03.2018 - täiendatud wiki lehte täielikult ringitöötatud andmemudeliga 
30.03.2018 - täiendatud wiki lehte andmemudeli metainfoga 
09.04.2018 - silusime andmemudelit (mõningad ebavajalikud viited olid sisse jäänud) 
06.05.2018 - panime uuendatud andmemudeli projekti wiki lehele üles 

= Kasutatavad metoodikad =

WatchWinders projektis plaanime kasutada peamiselt kaht metoodikat:

1. läbiv retsenseerimine (üks paariline teeb midagi valmis ja teine teeb sellele ülevaatuse; üksus lisatakse kui ülevaatus on lõplikult läbitud ning osapoolte vahel on saabunud konsensus) 
2. paaris programmeerimine (istume ühe masina taha maha ja kirjutame kolmekesi)

Tulenevalt kaugõppe formaadist saab ülekaalus olema esimene variant. Teist metoodikat kasutame nende osade kirjutamiseks, mille puhul võib arvata, et nende lahendamine on keeruline või et lahenduskäike võib olla väga erinevaid. Püüame jooksvalt siinses vikis kajastada ka seda, millise metoodika järgi üks või teine osa valmis.

= Projekti osad =

Alljärgnevalt anname ülevaate projekti osadest: 

(1) andmemudel 
(2) veebiteenuse analüüs 
(3) Minimum Viable Product definitsioon 
(4) Inkrement #1 
(5) Inkrement #2 
(6) Inkrement #3 

Projekti osad on meie viki lehel kirjeldatud valmimise järjekorras.

== Andmemudel ==

Andmemudeli koostamisel lähtusime õppejõu ette antud kriteeriumist, mille järgi andmemudelis on vähemalt 6 põhiolemit (tähistatud tumesinise ja lillaga - meie mudelis 11 tk),
mille hulgas ei sisaldu kasutajate tabelit (Person). 
 
Põhiolemid: 
* Watch - kell 
* Person - kasutaja/kollektsionäär või firma esindaja 
* Box - kellakarp 
* Organization - tootjad, edasimüüjad, hooldus 
* Settings - kellakarbi seade 
* Offer - pakkumine kollektsionäärile 
* Media - meediafailid kellade ja karpide kohta 
* Address - kasutaja/organisatsiooni aadress 
* ElectronicContact - elektrooniliste kontaktide loend 
* Log - logi 
* Access - paroolid ja kasutajanimed 
* Error - vead 
 
Type abiolemid: 
* WatchType - kellatüübid 
* PersonType - isikutüübid: admin, kasutaja 
* OrganizationType - organisatsioonitüübid: tootja, hooldaja, edasimüüja jt 
* ActionType - logi tüübid 
* ContactType - elektroonilise kontakti tüüp: skype, email, telefon jt 
 
Olekud: 
* PersonTypeState - isiku rolli kehtivus ajahetkel (isiku ja tüübi vaheline seos) 
* OrganizationTypeState - organisatsiooni olek(ud) ajahetkel 
 
Kuuluvus: 
* PersonWatch - isikute ja kellade vahelised seosed 
* PersonBox - isiku ja karbi vaheline seos 
* PersonAccess - isiku ja autentimisandmete vaheline seos 
* WatchInBox - kella ja karbi vaheline seos 
* ErrorInWatch - vea ja kella vaheline seos 
* SettingsInBox - seade ja karbi vaheline seos 
* WatchInOrganization - kella ja tootja vaheline seos 
* PersonInOrganization - isiku ja ettevõtte/organisatsiooni vaheline seos 
* SettingsOfWatchType - seade ja kellatüübi vaheline seos 
 
Abstraktsioonid: 
* Locator - abstraktsioon erinevate kontaktitüüpide jaoks 
* Party - abstraktsioon erinevate inimeste, organisatsioonide jt jaoks 
 
Kommunikatsioon: 
* OfferToPerson - isikule suunatud pakkumised 
* OfferFromPerson - isikult lähtuv pakkumine 
 
 
 
[[File:ww_andmemudel_06052018.png]]
 

Andmemudel valmis (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

== Veebiteenuse analüüs ==

Alljärgnevalt esitame kellakarpide infosüsteemi analüüsi järgmistes osades:

(1) toote/teenuse kirjeldus 
(2) probleemi kirjeldus 
(3) lahendus 
(4) süsteemi kasutajad 
(5) loodava API võimalused 
(6) funktsionaalsed nõuded 
(7) mittefunktsionaalsed nõuded 

=== Toote/teenuse kirjeldus ===
Teenuse eesmärgiks on lahendada probleem, kuidas jälgida kellakarpide kaudu mehhaaniliste käekellade seisundit ning keerata neid automaatselt üles distantsilt, näiteks juhul, kui kellade kollektsionäär ei asu füüsiliselt igapäevaselt oma kellade juures. Teenus võimaldab ka tootjal uuendada kontaktandmeid, saata personaalseid teateid. Administraatorile annab ülevaate platvormis toimuvast.

=== Probleemi kirjeldus ===
Mehhaaniliste käekellade kollektsionääride huvi kellakarpide vastu on mitmetahuline. Kollektsionääre huvitab arvepidamine – mitu kella, missuguste omaduste ja eripäradega neil kollektsioonis on. Teisalt soov eksponeerida oma kogusid kolleegidele ja sõpradele. Kellakarpidega täidetud sein või riiulid loovad selleks suurepärase võimaluse. Kolmandaks praktiline vajadus tagada kellavedrude õige vinnastatuse aste. Kaasaja mehhaanilised kellamehhanismid (''automatic'') võimaldavad kellakorpuse füüsilisel liigutamisel kellavedru automaatselt vinnastada.

Näiteks piisab kella kinnitamisest käele, et see hakkaks end käe liigutamisel üles keerama. Kuidas keerata aga üles seisvat kella, mis seisab paigal kellakarbis? Selleks on tänapäeva kellakarpides elektrimootor, mis tagab kella liigutamise vastavalt kellatüübile ettenähtud ööpäevase graafiku alusel. Kollektsionääride üheks probleemiks on see, kuidas juhtida sellist karpi ja omada jooksvat ülevaadet kõikidest oma karpidest, nende tehnilisest seadistusest ja kollektsiooni kuuluvatest kelladest olles tööreisil välisriigis?

=== Lahendus ===
Probleemi lahendamiseks ehitame REST + ASP.NET Core + WebAPI koos kliendiga, mis võimaldab kellakollektsionääridel hallata kellasid karpides, administraatoritel saada ülevaate süsteemist ning tootjatele lisada infot kollektsionääridele. Käesoleva projekti käigus '''ei tegeleta''' kahe IoT lahenduse kui terviku seisukohast olulise nüansiga: (i) karbi püsivara (''firmware'') loomisega, (ii) klientrakenduse ''frontend'' lõpliku häälestamisega (ilus .css ja pildid).

=== Süsteemi kasutajad ===
'''Kollektsionäär''' - haldab ja muudab infot oma kellade ning oma kellakarpide kohta. 
'''Administraator''' - haldab süsteemi infot, vajadusel eemaldab probleeme. 
'''Tootja''' - saab saata süsteemi kollektsionääridele mõeldud infot. 
'''Hooldaja''' - saab infot hooldamist vajavate kellade ja -karpide kohta. 

=== Loodava API võimalused ===
Alljärgnevalt vaatame loodava API võimalusi kasutajagruppide kaupa:

'''Kasutajale/kellakollektsionäärile'''
* Saada ülevaade kelladest ja kellakarpidest (lisada, muuta, vaadata).
* Muuta karbis oleva kella kohta käivat informatsiooni (kella nimi, tootja, tootmise aeg, viitenumber, mehhanism, jõureservi jääk (valikuline), foto kellast, kellarihma liik, muu).
* Karpe juhtida (keerata automaatselt üles). Näha ja muuta kella üleskeerava mehhanismi liikumise kiirust ja muid detaile (nt liikumise suund).
* Näha karbi seisundit, kas karp on hetkel wifiga ühendatud või mitte.
* Näha karbilt saabunud veateateid.
* Sisestada infot kella seisundist.
* Suhelda hooldajate ja tootjatega

'''Tootjale'''
* Uuendada kontaktandmeid.
* Saata personaalseid teateid kellakollektsionääridele.

'''Administraatorile'''
* Näha võrku ühendatud karpide arvu.
* Näha karpidesse paigaldatud kellade nimistut (ilma muude kasutajaandmeteta).
* Näha kellade üleskeeramise mehhanismide arvnäitajaid (madalaim kiirus, keskmine kiirus, tippkiirus; samuti liikumise suundade arvnäitajaid).
* IP-aadresside järgi ülevaadet, millistes riikides karpe kasutatakse (üldised arvandmed).
* Veateatega karpide arv süsteemis (üldised arvandmed).

=== Funktsionaalsed nõuded ===
* Kõik tegevused peavad olema autoriseeritud.
* REST + ASP.NET Core + WebAPI tagastab infot valideeritud JSON formaadis.
* API veatöötlus on tehtud, kasutades standardseid veakoode.
* API-le on tehtud 'health check'.
* Kõik kasutajad peavad saama end autoriseerida.
* Kasutaja, tootja ja administraatori tegevused logitakse.
* Logi ei ole muudetav, vaid on kättesaadav.
* Kasutaja ega tootja ei näe teiste kasutajate ega tootjate infot.
* API klient on kohanduv mobiilile, tahvlile ja desktoparvutile.
* Sisendandmed on valideeritud.

=== Mittefunktsionaalsed nõuded ===
* API-le on lisatud Swagger fail.
* Teenus ja tehniline lahendus on dokumenteeritud.
* Süsteemi kood on vabalt ligipääsetav, täiendatav ning allalaetav.

Esitame töö etappidena, kus kõigepealt defineerime ära Minimum Viable Producti [https://en.wikipedia.org/wiki/Minimum_viable_product] ehk selle miinimumi, mis pakub kasutajale maksimaalset väärtust. See tähendab API loomist ning esmase kliendi loomist kõigile MVP-s defineeritud kasutajagruppidele. Seejärel realiseerime projekti inkrementide ehk tootearenduse sammudena, milles lisame uusi funktsionaalsusi. Ideaalis jõuame realiseerida kõik sammud, kuid kuna teeme nimetatud tööd antud ajaraamis ja koosseisus esmakordselt, siis võtame vabaduse ka realiseerida korralikult niipalju, kui jõuame projekti käigus ära teha.

Võimalik, et meie lõpptulemus erineb mõnes osas esitatud analüüsist. Seda olenevalt sellest kui edukalt meil õnnestub plaanitud funktsionaalsusi realiseerida. Erisusi plaanime käsitleda vastavas 'post production' jaotuses, kus loendame ka projektist kogunenud peamised õppetunnid.

Analüüs valmis (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

== Minimum Viable Product definitsioon ==
'''Kasutaja'''
* Kasutaja saab süsteemi logida ning välja logida
* Kasutaja saab lisada uue kellakarbi
* Kasutaja saab lisada uue kella kellakarpi
* Kasutaja saab muuta kella infot kellakarbis
* Kasutaja saab näha ülevaadet oma karpidest
* Kasutaja saab muuta kellakarbi seadeid
* Kasutaja saab kustutada kella karbis
* Kasutaja saab kustutada kellakarbi

'''Administraator'''
* Näeb autoriseeritult logisid

'''Tootja'''
* Saab lisada kontaktandmeid
* Saab kontaktandmeid muuta

== Inkrement #1 ==
'''Kasutaja'''
* Näeb karbilt saabunud veateateid.
* Saab kellakarpe juhtida.

'''Administraator'''
* IP-aadresside järgi ülevaadet, millistes riikides karpe kasutatakse (üldised arvandmed).
* Karpidesse paigaldatud kellade nimistut (ilma muude kasutajaandmeteta).
* Näeb kasutajate statistikat.

'''Tootja'''
* Saata personaalseid teateid kellakollektsionääridele.

== Inkrement #2 ==
'''Kasutaja'''
* Saab saata teate tootjale.
* Näeb tootja vastust.
* Näha karbi seisundit, kas karp on hetkel wifiga ühendatud või mitte.

'''Administraator'''
* Näha kellade üleskeeramise mehhanismide arvnäitajaid (madalaim kiirus, keskmine kiirus, tippkiirus; samuti liikumise suundade arvnäitajaid).
* Näeb tegevuste ajalugu kliendist.

'''Tootja'''
* Saab lugeda kasutaja teadet.
* Saab vastata kasutajale.

'''Hooldaja'''
* Saab info hooldamist vajavate kellade kohta.

== Inkrement #3 ==
'''Kasutaja'''
* On ehitatud keeletugi.

'''Tootja'''
* On ehitatud keeletugi.

'''Hooldaja'''
* On ehitatud keeletugi.

Inkrementid valmisid (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

= XML ülesanne =
Järgnevalt esitame oma XML-ülesande tulemused.

== IT Management Transformation XML To XML ==
<pre>
<?xml version="1.0" encoding="utf-8"?>
<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">
<xsl:output method="xml" indent="yes"/>
<xsl:template match="/">
<unhandledDevices>
<xsl:for-each select="customers/customer/locations/location/items/item[@isInWorkingCondition='false']">
<device>
<name>
<xsl:value-of select="manufacturer"/>
<xsl:text> </xsl:text>
<xsl:value-of select="model"/>
</name>
<ticket>
<xsl:for-each select="tickets/ticket[@isHandled='false']">
<ticket_id>
<xsl:value-of select="@id"/>
</ticket_id>
<issued_in>
<xsl:value-of select="@issuedIn"/>
</issued_in>
<description>
<xsl:value-of select="description"/>
</description>
</xsl:for-each>
</ticket>
</device>
</xsl:for-each>
</unhandledDevices>
</xsl:template>
</xsl:stylesheet>
</pre>

== IT Management Transformation HTML ==

<pre>
<?xml version="1.0" encoding="utf-8"?>
<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">
<xsl:output method="html" indent="yes"/>
<xsl:template match="/">

<html>
<head>
<title>ItManagement Laptops</title>
</head>
<body style="background-color:#F7F7F7">
<h1>Computers</h1>
<xsl:for-each select="/customers/customer/locations/location/items/item[@type='laptopComputer']">
<xsl:sort select="@isActive='false'"/>
<hr />
<div>
<h3>
<xsl:value-of select="manufacturer"/>
</h3>
Model: 
<xsl:value-of select="model"/>
 
Serial number: 
<xsl:value-of select="serialNumber"/>
 
Date of purchase: 
<xsl:value-of select="dateOfPurchase"/>
 
Operating system: 
<xsl:value-of select="operatingSystem"/>
 
Is on active list: 
<xsl:value-of select="@isActive"/>
 
</div>

<div style="background-color:#E3FAEE" >

<xsl:for-each select="tickets/ticket">
<xsl:choose>
<xsl:when test="@isHandled='true'">
<h3>Handled tickets</h3>
<ul>
Issued in: 
<xsl:value-of select="@issuedIn"/>
 
Ticket ID: 
<xsl:value-of select="@id" />
 
Description: 
<xsl:value-of select="description"/>
 
Solution: 
<xsl:value-of select="solution"/>
 
</ul>
</xsl:when>
<xsl:when test="@isHandled='false'">
<div style="background-color:#FDE5E5">
<h3>Unhandled tickets</h3>
<ul>
Issued in: 
<xsl:value-of select="@issuedIn"/>
 
Ticket ID: 
<xsl:value-of select="@id" />
 
Description: 
<xsl:value-of select="description"/>
 
Solution: 
<xsl:value-of select="solution"/>
 
</ul>
</div>
</xsl:when>
</xsl:choose>
</xsl:for-each>

</div>
</xsl:for-each>
</body>
</html>
</xsl:template>
</xsl:stylesheet>
</pre>

== IT Management XSD ==

<pre>
<?xml version="1.0" encoding="utf-8"?>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="customers">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="customer">
<xs:complexType>
<xs:sequence>
<xs:element name="customerName" type="xs:string" />
<xs:element minOccurs="0" name="contactPerson" type="xs:string" />
<xs:element name="e-mail" type="xs:string" />
<xs:element name="phoneNumber" type="xs:string" />
<xs:element name="locations">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="location">
<xs:complexType>
<xs:sequence>
<xs:element name="city" type="xs:string" />
<xs:element name="address" type="xs:string" />
<xs:element name="comment" type="xs:string" />
<xs:element minOccurs="0" name="localContactPerson" type="xs:string" />
<xs:element minOccurs="0" name="localPhone" type="xs:string" />
<xs:element name="items">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="item">
<xs:complexType>
<xs:sequence>
<xs:element name="manufacturer" type="xs:string" />
<xs:element name="model" type="xs:string" />
<xs:element name="serialNumber" type="xs:string" />
<xs:element name="dateOfPurchase" type="xs:date" />
<xs:element minOccurs="0" name="operatingSystem">
<xs:complexType>
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute name="version" type="xs:string" use="required" />
</xs:extension>
</xs:simpleContent>
</xs:complexType>
</xs:element>
<xs:element minOccurs="0" name="tickets">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="ticket">
<xs:complexType>
<xs:sequence>
<xs:element name="description" type="xs:string" />
<xs:element name="solution" type="xs:string" />
</xs:sequence>
<xs:attribute name="id" type="xs:string" use="required" />
<xs:attribute name="issuedIn" type="xs:date" use="required" />
<xs:attribute name="isHandled" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:unsignedInt" use="required" />
<xs:attribute name="type" type="xs:string" use="required" />
<xs:attribute name="isActive" type="xs:boolean" use="required" />
<xs:attribute name="isUnderWarranty" type="xs:boolean" use="required" />
<xs:attribute name="warrantyInMonths" type="xs:unsignedByte" use="required" />
<xs:attribute name="isInWorkingCondition" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="type" type="xs:string" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:unsignedInt" use="required" />
<xs:attribute name="type" type="xs:string" use="required" />
<xs:attribute name="isActive" type="xs:boolean" use="required" />
<xs:attribute name="hasManyLocations" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
</pre>

== IT Management XML ==

<pre>
<?xml version="1.0" encoding="utf-8" ?>
<customers>
<customer id="33" type="company" isActive="true" hasManyLocations="true">
<customerName>Elamustevaba OÜ</customerName>
<contactPerson>Juhan Pühamees</contactPerson>
<e-mail>juhan@evaba.com</e-mail>
<phoneNumber>+37256565656</phoneNumber>
<locations>
<location type="office">
<city>Tallinn</city>
<address><![CDATA[Pikk 7, 56401]]></address>
<comment><![CDATA[3. korrus -> paremat kätt]]></comment>
<localContactPerson>Maiu Piimaauto</localContactPerson>
<localPhone>+3726510510</localPhone>
<items>
<item id="1" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="36" isInWorkingCondition="false">
<manufacturer>Dell</manufacturer>
<model>Inspiron 3558</model>
<serialNumber>6FGH5JN</serialNumber>
<dateOfPurchase>2017-07-22</dateOfPurchase>
<operatingSystem version="1709">Windows 10 Home</operatingSystem>
<tickets>
<ticket id="HWI001" issuedIn="2017-11-21" isHandled="true">
<description><![CDATA[Wi-Fi is not working]]></description>
<solution><![CDATA[Wi-Fi card replaced (Under the warranty)]]></solution>
</ticket>
<ticket id="SWI256" issuedIn="2018-05-05" isHandled="false">
<description><![CDATA[Computer keeps showing login screen]]></description>
<solution></solution>
</ticket>
</tickets>
</item>
<item id="55" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="60" isInWorkingCondition="true">
<manufacturer>Dell</manufacturer>
<model>Latitude E7550</model>
<serialNumber>8JGR78U</serialNumber>
<dateOfPurchase>2016-06-15</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Home</operatingSystem>
</item>
</items>
</location>
<location type="store">
<city>Tallinn</city>
<address><![CDATA[Lai 17, 56401]]></address>
<comment><![CDATA[keldrikorrusel]]></comment>
<localContactPerson>Tanja Õielemb</localContactPerson>
<localPhone>+3726510520</localPhone>
<items>
<item id="83" type="desktopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Lenovo</manufacturer>
<model>ThinkCentre M715</model>
<serialNumber>IO25689AD54KL</serialNumber>
<dateOfPurchase>2017-12-01</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Pro</operatingSystem>
</item>
<item id="12" type="monitor" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>AOC</manufacturer>
<model>L456</model>
<serialNumber>9803987YE54</serialNumber>
<dateOfPurchase>2015-05-03</dateOfPurchase>
<tickets>
<ticket id="HWI126" issuedIn="2016-01-18" isHandled="true">
<description><![CDATA[Doesn't work, no picture.]]></description>
<solution><![CDATA[Wasn't plugged in. Technician did it - works again!]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
<customer id="02" type="private" isActive="true" hasManyLocations="false">
<customerName>Kessu Sisselasi</customerName>
<e-mail>kessu@tripp.org</e-mail>
<phoneNumber>+372555555</phoneNumber>
<locations>
<location type="home">
<city>Saue</city>
<address><![CDATA[Kooli 4-8, 78965]]></address>
<comment><![CDATA[2. korrus. Kitsad koridorid.]]></comment>
<items>
<item id="98" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Acer</manufacturer>
<model>Aspire 5</model>
<serialNumber>475YRT89K4</serialNumber>
<dateOfPurchase>2018-03-25</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Home</operatingSystem>
</item>
<item id="4" type="laptopComputer" isActive="false" isUnderWarranty="false" warrantyInMonths="36" isInWorkingCondition="true">
<manufacturer>Lenovo</manufacturer>
<model>IdeaPad L530</model>
<serialNumber>U89TRY765ME</serialNumber>
<dateOfPurchase>2007-08-14</dateOfPurchase>
<operatingSystem version="">Windows XP</operatingSystem>
<tickets>
<ticket id="SWI069" issuedIn="2010-01-28" isHandled="true">
<description><![CDATA[Blue screen.]]></description>
<solution><![CDATA[Video driver update.]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
<customer id="26" type="company" isActive="true" hasManyLocations="true">
<customerName>Aktsiaselts OÜ</customerName>
<contactPerson>Gunnar Kuningas</contactPerson>
<e-mail>gunnar@kunn.ee</e-mail>
<phoneNumber>+3726985236</phoneNumber>
<locations>
<location type="office">
<city>Loksa</city>
<address><![CDATA[Kalda 14, 78965]]></address>
<comment><![CDATA[Sissepääs Rimi poolt, helesinine uks]]></comment>
<items>
<item id="26" type="laptopComputer" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Apple</manufacturer>
<model>Macbook Air</model>
<serialNumber>258JUY369</serialNumber>
<dateOfPurchase>2017-03-01</dateOfPurchase>
<operatingSystem version="High Sierra">OS X</operatingSystem>
</item>
<item id="59" type="laptopComputer" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="false">
<manufacturer>Acer</manufacturer>
<model>Chromebook 11</model>
<serialNumber>U89TRY765ME</serialNumber>
<dateOfPurchase>2016-04-23</dateOfPurchase>
<operatingSystem version="">Chrome OS</operatingSystem>
<tickets>
<ticket id="HWI046" issuedIn="2010-02-28" isHandled="false">
<description><![CDATA[Stripes on screen]]></description>
<solution><![CDATA[]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
</customers>
</pre>

= Link klientrakendusele ja API-le =
https://drive.google.com/file/d/1FU3XGGVHbn4BNNHAsOs7DQ4CzpEDwZUt/view?usp=sharing

= Kasutatud kirjandus ja allikad =

1. Albahari, Joseph, Albari, Ben 2017. C# 7.0 in A Nutshell. Sebastopol: O’Reilly 
2. MariaDB Foundation. MariaDB. Kättesaadav:https://mariadb.org/ 
3. Martin, Robert 2018. Clean Architecture. Boston: Pearson Education

WatchWinders

2018-06-08T19:12:25Z

Tkuuskma: /* IT Management Transformation XML To ML */

= Meeskond =

Toomas Juhkov, toomas.juhkov@gmail.com 
Tiit Kuuskmäe, tiit.kuuskmae@gmail.com 
Kunnar Kukk, Kunnar.kukk@gmail.com 

= Tegevuste logi =

08.02.2018 - meeskonna loomine, kokkuleppe sõlmimine teema osas 
10.02.2018 - õppejõu teavitamine koos esmase andmemudeliga 
15.02.2018 - lõpliku andmemudeli valmimine(versioon 5) 
18.02.2018 - õppejõu kinnitus, et teema ja meeskond kvalifiseeruvad 
22.02.2018 - viki lehe loomine ja analüüsi koostamise alustamine 
26.02.2018 - tiimi lisandus Kunnar Kukk 
01.03.2018 - tiimi sprint koosolek(seoses täiendava tiimiliikme lisandumisega täpsustasime skoopi) 
03.03.2018 - alustasime koodi kirjutamisega (tabelid klassideks ja annotatsioonid peale) 
06.03.2018 - täiendasime andmemudelit olemiga "UserTypeState" (et saaks muuta kasutajatüüpi) 
08.03.2018 - tiimi sprint koosolek 
18.03.2018 - lisasime olemid "Address", "AddressU", "AddressM", "OfferOfUser", "MediaInOffer" 
22.03.2018 - tiimi sprint koosolek, mis oli pühendatud andmemudeli täiendamisele 
23.03.2018 - pikem tiimi hackathon andmemudeli teemal 
29.03.2018 - täiendatud wiki lehte täielikult ringitöötatud andmemudeliga 
30.03.2018 - täiendatud wiki lehte andmemudeli metainfoga 
09.04.2018 - silusime andmemudelit (mõningad ebavajalikud viited olid sisse jäänud) 
06.05.2018 - panime uuendatud andmemudeli projekti wiki lehele üles 

= Kasutatavad metoodikad =

WatchWinders projektis plaanime kasutada peamiselt kaht metoodikat:

1. läbiv retsenseerimine (üks paariline teeb midagi valmis ja teine teeb sellele ülevaatuse; üksus lisatakse kui ülevaatus on lõplikult läbitud ning osapoolte vahel on saabunud konsensus) 
2. paaris programmeerimine (istume ühe masina taha maha ja kirjutame kolmekesi)

Tulenevalt kaugõppe formaadist saab ülekaalus olema esimene variant. Teist metoodikat kasutame nende osade kirjutamiseks, mille puhul võib arvata, et nende lahendamine on keeruline või et lahenduskäike võib olla väga erinevaid. Püüame jooksvalt siinses vikis kajastada ka seda, millise metoodika järgi üks või teine osa valmis.

= Projekti osad =

Alljärgnevalt anname ülevaate projekti osadest: 

(1) andmemudel 
(2) veebiteenuse analüüs 
(3) Minimum Viable Product definitsioon 
(4) Inkrement #1 
(5) Inkrement #2 
(6) Inkrement #3 

Projekti osad on meie viki lehel kirjeldatud valmimise järjekorras.

== Andmemudel ==

Andmemudeli koostamisel lähtusime õppejõu ette antud kriteeriumist, mille järgi andmemudelis on vähemalt 6 põhiolemit (tähistatud tumesinise ja lillaga - meie mudelis 11 tk),
mille hulgas ei sisaldu kasutajate tabelit (Person). 
 
Põhiolemid: 
* Watch - kell 
* Person - kasutaja/kollektsionäär või firma esindaja 
* Box - kellakarp 
* Organization - tootjad, edasimüüjad, hooldus 
* Settings - kellakarbi seade 
* Offer - pakkumine kollektsionäärile 
* Media - meediafailid kellade ja karpide kohta 
* Address - kasutaja/organisatsiooni aadress 
* ElectronicContact - elektrooniliste kontaktide loend 
* Log - logi 
* Access - paroolid ja kasutajanimed 
* Error - vead 
 
Type abiolemid: 
* WatchType - kellatüübid 
* PersonType - isikutüübid: admin, kasutaja 
* OrganizationType - organisatsioonitüübid: tootja, hooldaja, edasimüüja jt 
* ActionType - logi tüübid 
* ContactType - elektroonilise kontakti tüüp: skype, email, telefon jt 
 
Olekud: 
* PersonTypeState - isiku rolli kehtivus ajahetkel (isiku ja tüübi vaheline seos) 
* OrganizationTypeState - organisatsiooni olek(ud) ajahetkel 
 
Kuuluvus: 
* PersonWatch - isikute ja kellade vahelised seosed 
* PersonBox - isiku ja karbi vaheline seos 
* PersonAccess - isiku ja autentimisandmete vaheline seos 
* WatchInBox - kella ja karbi vaheline seos 
* ErrorInWatch - vea ja kella vaheline seos 
* SettingsInBox - seade ja karbi vaheline seos 
* WatchInOrganization - kella ja tootja vaheline seos 
* PersonInOrganization - isiku ja ettevõtte/organisatsiooni vaheline seos 
* SettingsOfWatchType - seade ja kellatüübi vaheline seos 
 
Abstraktsioonid: 
* Locator - abstraktsioon erinevate kontaktitüüpide jaoks 
* Party - abstraktsioon erinevate inimeste, organisatsioonide jt jaoks 
 
Kommunikatsioon: 
* OfferToPerson - isikule suunatud pakkumised 
* OfferFromPerson - isikult lähtuv pakkumine 
 
 
 
[[File:ww_andmemudel_06052018.png]]
 

Andmemudel valmis (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

== Veebiteenuse analüüs ==

Alljärgnevalt esitame kellakarpide infosüsteemi analüüsi järgmistes osades:

(1) toote/teenuse kirjeldus 
(2) probleemi kirjeldus 
(3) lahendus 
(4) süsteemi kasutajad 
(5) loodava API võimalused 
(6) funktsionaalsed nõuded 
(7) mittefunktsionaalsed nõuded 

=== Toote/teenuse kirjeldus ===
Teenuse eesmärgiks on lahendada probleem, kuidas jälgida kellakarpide kaudu mehhaaniliste käekellade seisundit ning keerata neid automaatselt üles distantsilt, näiteks juhul, kui kellade kollektsionäär ei asu füüsiliselt igapäevaselt oma kellade juures. Teenus võimaldab ka tootjal uuendada kontaktandmeid, saata personaalseid teateid. Administraatorile annab ülevaate platvormis toimuvast.

=== Probleemi kirjeldus ===
Mehhaaniliste käekellade kollektsionääride huvi kellakarpide vastu on mitmetahuline. Kollektsionääre huvitab arvepidamine – mitu kella, missuguste omaduste ja eripäradega neil kollektsioonis on. Teisalt soov eksponeerida oma kogusid kolleegidele ja sõpradele. Kellakarpidega täidetud sein või riiulid loovad selleks suurepärase võimaluse. Kolmandaks praktiline vajadus tagada kellavedrude õige vinnastatuse aste. Kaasaja mehhaanilised kellamehhanismid (''automatic'') võimaldavad kellakorpuse füüsilisel liigutamisel kellavedru automaatselt vinnastada.

Näiteks piisab kella kinnitamisest käele, et see hakkaks end käe liigutamisel üles keerama. Kuidas keerata aga üles seisvat kella, mis seisab paigal kellakarbis? Selleks on tänapäeva kellakarpides elektrimootor, mis tagab kella liigutamise vastavalt kellatüübile ettenähtud ööpäevase graafiku alusel. Kollektsionääride üheks probleemiks on see, kuidas juhtida sellist karpi ja omada jooksvat ülevaadet kõikidest oma karpidest, nende tehnilisest seadistusest ja kollektsiooni kuuluvatest kelladest olles tööreisil välisriigis?

=== Lahendus ===
Probleemi lahendamiseks ehitame REST + ASP.NET Core + WebAPI koos kliendiga, mis võimaldab kellakollektsionääridel hallata kellasid karpides, administraatoritel saada ülevaate süsteemist ning tootjatele lisada infot kollektsionääridele. Käesoleva projekti käigus '''ei tegeleta''' kahe IoT lahenduse kui terviku seisukohast olulise nüansiga: (i) karbi püsivara (''firmware'') loomisega, (ii) klientrakenduse ''frontend'' lõpliku häälestamisega (ilus .css ja pildid).

=== Süsteemi kasutajad ===
'''Kollektsionäär''' - haldab ja muudab infot oma kellade ning oma kellakarpide kohta. 
'''Administraator''' - haldab süsteemi infot, vajadusel eemaldab probleeme. 
'''Tootja''' - saab saata süsteemi kollektsionääridele mõeldud infot. 
'''Hooldaja''' - saab infot hooldamist vajavate kellade ja -karpide kohta. 

=== Loodava API võimalused ===
Alljärgnevalt vaatame loodava API võimalusi kasutajagruppide kaupa:

'''Kasutajale/kellakollektsionäärile'''
* Saada ülevaade kelladest ja kellakarpidest (lisada, muuta, vaadata).
* Muuta karbis oleva kella kohta käivat informatsiooni (kella nimi, tootja, tootmise aeg, viitenumber, mehhanism, jõureservi jääk (valikuline), foto kellast, kellarihma liik, muu).
* Karpe juhtida (keerata automaatselt üles). Näha ja muuta kella üleskeerava mehhanismi liikumise kiirust ja muid detaile (nt liikumise suund).
* Näha karbi seisundit, kas karp on hetkel wifiga ühendatud või mitte.
* Näha karbilt saabunud veateateid.
* Sisestada infot kella seisundist.
* Suhelda hooldajate ja tootjatega

'''Tootjale'''
* Uuendada kontaktandmeid.
* Saata personaalseid teateid kellakollektsionääridele.

'''Administraatorile'''
* Näha võrku ühendatud karpide arvu.
* Näha karpidesse paigaldatud kellade nimistut (ilma muude kasutajaandmeteta).
* Näha kellade üleskeeramise mehhanismide arvnäitajaid (madalaim kiirus, keskmine kiirus, tippkiirus; samuti liikumise suundade arvnäitajaid).
* IP-aadresside järgi ülevaadet, millistes riikides karpe kasutatakse (üldised arvandmed).
* Veateatega karpide arv süsteemis (üldised arvandmed).

=== Funktsionaalsed nõuded ===
* Kõik tegevused peavad olema autoriseeritud.
* REST + ASP.NET Core + WebAPI tagastab infot valideeritud JSON formaadis.
* API veatöötlus on tehtud, kasutades standardseid veakoode.
* API-le on tehtud 'health check'.
* Kõik kasutajad peavad saama end autoriseerida.
* Kasutaja, tootja ja administraatori tegevused logitakse.
* Logi ei ole muudetav, vaid on kättesaadav.
* Kasutaja ega tootja ei näe teiste kasutajate ega tootjate infot.
* API klient on kohanduv mobiilile, tahvlile ja desktoparvutile.
* Sisendandmed on valideeritud.

=== Mittefunktsionaalsed nõuded ===
* API-le on lisatud Swagger fail.
* Teenus ja tehniline lahendus on dokumenteeritud.
* Süsteemi kood on vabalt ligipääsetav, täiendatav ning allalaetav.

Esitame töö etappidena, kus kõigepealt defineerime ära Minimum Viable Producti [https://en.wikipedia.org/wiki/Minimum_viable_product] ehk selle miinimumi, mis pakub kasutajale maksimaalset väärtust. See tähendab API loomist ning esmase kliendi loomist kõigile MVP-s defineeritud kasutajagruppidele. Seejärel realiseerime projekti inkrementide ehk tootearenduse sammudena, milles lisame uusi funktsionaalsusi. Ideaalis jõuame realiseerida kõik sammud, kuid kuna teeme nimetatud tööd antud ajaraamis ja koosseisus esmakordselt, siis võtame vabaduse ka realiseerida korralikult niipalju, kui jõuame projekti käigus ära teha.

Võimalik, et meie lõpptulemus erineb mõnes osas esitatud analüüsist. Seda olenevalt sellest kui edukalt meil õnnestub plaanitud funktsionaalsusi realiseerida. Erisusi plaanime käsitleda vastavas 'post production' jaotuses, kus loendame ka projektist kogunenud peamised õppetunnid.

Analüüs valmis (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

== Minimum Viable Product definitsioon ==
'''Kasutaja'''
* Kasutaja saab süsteemi logida ning välja logida
* Kasutaja saab lisada uue kellakarbi
* Kasutaja saab lisada uue kella kellakarpi
* Kasutaja saab muuta kella infot kellakarbis
* Kasutaja saab näha ülevaadet oma karpidest
* Kasutaja saab muuta kellakarbi seadeid
* Kasutaja saab kustutada kella karbis
* Kasutaja saab kustutada kellakarbi

'''Administraator'''
* Näeb autoriseeritult logisid

'''Tootja'''
* Saab lisada kontaktandmeid
* Saab kontaktandmeid muuta

== Inkrement #1 ==
'''Kasutaja'''
* Näeb karbilt saabunud veateateid.
* Saab kellakarpe juhtida.

'''Administraator'''
* IP-aadresside järgi ülevaadet, millistes riikides karpe kasutatakse (üldised arvandmed).
* Karpidesse paigaldatud kellade nimistut (ilma muude kasutajaandmeteta).
* Näeb kasutajate statistikat.

'''Tootja'''
* Saata personaalseid teateid kellakollektsionääridele.

== Inkrement #2 ==
'''Kasutaja'''
* Saab saata teate tootjale.
* Näeb tootja vastust.
* Näha karbi seisundit, kas karp on hetkel wifiga ühendatud või mitte.

'''Administraator'''
* Näha kellade üleskeeramise mehhanismide arvnäitajaid (madalaim kiirus, keskmine kiirus, tippkiirus; samuti liikumise suundade arvnäitajaid).
* Näeb tegevuste ajalugu kliendist.

'''Tootja'''
* Saab lugeda kasutaja teadet.
* Saab vastata kasutajale.

'''Hooldaja'''
* Saab info hooldamist vajavate kellade kohta.

== Inkrement #3 ==
'''Kasutaja'''
* On ehitatud keeletugi.

'''Tootja'''
* On ehitatud keeletugi.

'''Hooldaja'''
* On ehitatud keeletugi.

Inkrementid valmisid (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

= XML ülesanne =
Järgnevalt esitame oma XML-ülesande tulemused.

== IT Management Transformation XML To XML ==
<pre>
<?xml version="1.0" encoding="utf-8"?>
<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">
<xsl:output method="xml" indent="yes"/>
<xsl:template match="/">
<unhandledDevices>
<xsl:for-each select="customers/customer/locations/location/items/item[@isInWorkingCondition='false']">
<device>
<name>
<xsl:value-of select="manufacturer"/>
<xsl:text> </xsl:text>
<xsl:value-of select="model"/>
</name>
<ticket>
<xsl:for-each select="tickets/ticket[@isHandled='false']">
<ticket_id>
<xsl:value-of select="@id"/>
</ticket_id>
<issued_in>
<xsl:value-of select="@issuedIn"/>
</issued_in>
<description>
<xsl:value-of select="description"/>
</description>
</xsl:for-each>
</ticket>
</device>
</xsl:for-each>
</unhandledDevices>
</xsl:template>
</xsl:stylesheet>
</pre>

== IT Management Transformation HTML ==

<pre>
<?xml version="1.0" encoding="utf-8"?>
<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">
<xsl:output method="html" indent="yes"/>
<xsl:template match="/">

<html>
<head>
<title>ItManagement Laptops</title>
</head>
<body style="background-color:#F7F7F7">
<h1>Computers</h1>
<xsl:for-each select="/customers/customer/locations/location/items/item[@type='laptopComputer']">
<xsl:sort select="@isActive='false'"/>
<hr />
<div>
<h3>
<xsl:value-of select="manufacturer"/>
</h3>
Model: 
<xsl:value-of select="model"/>
 
Serial number: 
<xsl:value-of select="serialNumber"/>
 
Date of purchase: 
<xsl:value-of select="dateOfPurchase"/>
 
Operating system: 
<xsl:value-of select="operatingSystem"/>
 
Is on active list: 
<xsl:value-of select="@isActive"/>
 
</div>

<div style="background-color:#E3FAEE" >

<xsl:for-each select="tickets/ticket">
<xsl:choose>
<xsl:when test="@isHandled='true'">
<h3>Handled tickets</h3>
<ul>
Issued in: 
<xsl:value-of select="@issuedIn"/>
 
Ticket ID: 
<xsl:value-of select="@id" />
 
Description: 
<xsl:value-of select="description"/>
 
Solution: 
<xsl:value-of select="solution"/>
 
</ul>
</xsl:when>
<xsl:when test="@isHandled='false'">
<div style="background-color:#FDE5E5">
<h3>Unhandled tickets</h3>
<ul>
Issued in: 
<xsl:value-of select="@issuedIn"/>
 
Ticket ID: 
<xsl:value-of select="@id" />
 
Description: 
<xsl:value-of select="description"/>
 
Solution: 
<xsl:value-of select="solution"/>
 
</ul>
</div>
</xsl:when>
</xsl:choose>
</xsl:for-each>

</div>
</xsl:for-each>
</body>
</html>
</xsl:template>
</xsl:stylesheet>
</pre>

== IT Management XSD ==

<pre>
<?xml version="1.0" encoding="utf-8"?>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="customers">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="customer">
<xs:complexType>
<xs:sequence>
<xs:element name="customerName" type="xs:string" />
<xs:element minOccurs="0" name="contactPerson" type="xs:string" />
<xs:element name="e-mail" type="xs:string" />
<xs:element name="phoneNumber" type="xs:string" />
<xs:element name="locations">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="location">
<xs:complexType>
<xs:sequence>
<xs:element name="city" type="xs:string" />
<xs:element name="address" type="xs:string" />
<xs:element name="comment" type="xs:string" />
<xs:element minOccurs="0" name="localContactPerson" type="xs:string" />
<xs:element minOccurs="0" name="localPhone" type="xs:string" />
<xs:element name="items">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="item">
<xs:complexType>
<xs:sequence>
<xs:element name="manufacturer" type="xs:string" />
<xs:element name="model" type="xs:string" />
<xs:element name="serialNumber" type="xs:string" />
<xs:element name="dateOfPurchase" type="xs:date" />
<xs:element minOccurs="0" name="operatingSystem">
<xs:complexType>
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute name="version" type="xs:string" use="required" />
</xs:extension>
</xs:simpleContent>
</xs:complexType>
</xs:element>
<xs:element minOccurs="0" name="tickets">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="ticket">
<xs:complexType>
<xs:sequence>
<xs:element name="description" type="xs:string" />
<xs:element name="solution" type="xs:string" />
</xs:sequence>
<xs:attribute name="id" type="xs:string" use="required" />
<xs:attribute name="issuedIn" type="xs:date" use="required" />
<xs:attribute name="isHandled" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:unsignedInt" use="required" />
<xs:attribute name="type" type="xs:string" use="required" />
<xs:attribute name="isActive" type="xs:boolean" use="required" />
<xs:attribute name="isUnderWarranty" type="xs:boolean" use="required" />
<xs:attribute name="warrantyInMonths" type="xs:unsignedByte" use="required" />
<xs:attribute name="isInWorkingCondition" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="type" type="xs:string" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:unsignedInt" use="required" />
<xs:attribute name="type" type="xs:string" use="required" />
<xs:attribute name="isActive" type="xs:boolean" use="required" />
<xs:attribute name="hasManyLocations" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
</pre>

== IT Management XML ==

<pre>
<?xml version="1.0" encoding="utf-8" ?>
<customers>
<customer id="33" type="company" isActive="true" hasManyLocations="true">
<customerName>Elamustevaba OÜ</customerName>
<contactPerson>Juhan Pühamees</contactPerson>
<e-mail>juhan@evaba.com</e-mail>
<phoneNumber>+37256565656</phoneNumber>
<locations>
<location type="office">
<city>Tallinn</city>
<address><![CDATA[Pikk 7, 56401]]></address>
<comment><![CDATA[3. korrus -> paremat kätt]]></comment>
<localContactPerson>Maiu Piimaauto</localContactPerson>
<localPhone>+3726510510</localPhone>
<items>
<item id="1" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="36" isInWorkingCondition="false">
<manufacturer>Dell</manufacturer>
<model>Inspiron 3558</model>
<serialNumber>6FGH5JN</serialNumber>
<dateOfPurchase>2017-07-22</dateOfPurchase>
<operatingSystem version="1709">Windows 10 Home</operatingSystem>
<tickets>
<ticket id="HWI001" issuedIn="2017-11-21" isHandled="true">
<description><![CDATA[Wi-Fi is not working]]></description>
<solution><![CDATA[Wi-Fi card replaced (Under the warranty)]]></solution>
</ticket>
<ticket id="SWI256" issuedIn="2018-05-05" isHandled="false">
<description><![CDATA[Computer keeps showing login screen]]></description>
<solution></solution>
</ticket>
</tickets>
</item>
<item id="55" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="60" isInWorkingCondition="true">
<manufacturer>Dell</manufacturer>
<model>Latitude E7550</model>
<serialNumber>8JGR78U</serialNumber>
<dateOfPurchase>2016-06-15</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Home</operatingSystem>
</item>
</items>
</location>
<location type="store">
<city>Tallinn</city>
<address><![CDATA[Lai 17, 56401]]></address>
<comment><![CDATA[keldrikorrusel]]></comment>
<localContactPerson>Tanja Õielemb</localContactPerson>
<localPhone>+3726510520</localPhone>
<items>
<item id="83" type="desktopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Lenovo</manufacturer>
<model>ThinkCentre M715</model>
<serialNumber>IO25689AD54KL</serialNumber>
<dateOfPurchase>2017-12-01</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Pro</operatingSystem>
</item>
<item id="12" type="monitor" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>AOC</manufacturer>
<model>L456</model>
<serialNumber>9803987YE54</serialNumber>
<dateOfPurchase>2015-05-03</dateOfPurchase>
<tickets>
<ticket id="HWI126" issuedIn="2016-01-18" isHandled="true">
<description><![CDATA[Doesn't work, no picture.]]></description>
<solution><![CDATA[Wasn't plugged in. Technician did it - works again!]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
<customer id="02" type="private" isActive="true" hasManyLocations="false">
<customerName>Kessu Sisselasi</customerName>
<e-mail>kessu@tripp.org</e-mail>
<phoneNumber>+372555555</phoneNumber>
<locations>
<location type="home">
<city>Saue</city>
<address><![CDATA[Kooli 4-8, 78965]]></address>
<comment><![CDATA[2. korrus. Kitsad koridorid.]]></comment>
<items>
<item id="98" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Acer</manufacturer>
<model>Aspire 5</model>
<serialNumber>475YRT89K4</serialNumber>
<dateOfPurchase>2018-03-25</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Home</operatingSystem>
</item>
<item id="4" type="laptopComputer" isActive="false" isUnderWarranty="false" warrantyInMonths="36" isInWorkingCondition="true">
<manufacturer>Lenovo</manufacturer>
<model>IdeaPad L530</model>
<serialNumber>U89TRY765ME</serialNumber>
<dateOfPurchase>2007-08-14</dateOfPurchase>
<operatingSystem version="">Windows XP</operatingSystem>
<tickets>
<ticket id="SWI069" issuedIn="2010-01-28" isHandled="true">
<description><![CDATA[Blue screen.]]></description>
<solution><![CDATA[Video driver update.]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
<customer id="26" type="company" isActive="true" hasManyLocations="true">
<customerName>Aktsiaselts OÜ</customerName>
<contactPerson>Gunnar Kuningas</contactPerson>
<e-mail>gunnar@kunn.ee</e-mail>
<phoneNumber>+3726985236</phoneNumber>
<locations>
<location type="office">
<city>Loksa</city>
<address><![CDATA[Kalda 14, 78965]]></address>
<comment><![CDATA[Sissepääs Rimi poolt, helesinine uks]]></comment>
<items>
<item id="26" type="laptopComputer" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Apple</manufacturer>
<model>Macbook Air</model>
<serialNumber>258JUY369</serialNumber>
<dateOfPurchase>2017-03-01</dateOfPurchase>
<operatingSystem version="High Sierra">OS X</operatingSystem>
</item>
<item id="59" type="laptopComputer" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="false">
<manufacturer>Acer</manufacturer>
<model>Chromebook 11</model>
<serialNumber>U89TRY765ME</serialNumber>
<dateOfPurchase>2016-04-23</dateOfPurchase>
<operatingSystem version="">Chrome OS</operatingSystem>
<tickets>
<ticket id="HWI046" issuedIn="2010-02-28" isHandled="false">
<description><![CDATA[Stripes on screen]]></description>
<solution><![CDATA[]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
</customers>
</pre>

= Kasutatud kirjandus ja allikad =

1. Albahari, Joseph, Albari, Ben 2017. C# 7.0 in A Nutshell. Sebastopol: O’Reilly 
2. MariaDB Foundation. MariaDB. Kättesaadav:https://mariadb.org/ 
3. Martin, Robert 2018. Clean Architecture. Boston: Pearson Education

WatchWinders

2018-06-08T19:10:50Z

Tkuuskma:

= Meeskond =

Toomas Juhkov, toomas.juhkov@gmail.com 
Tiit Kuuskmäe, tiit.kuuskmae@gmail.com 
Kunnar Kukk, Kunnar.kukk@gmail.com 

= Tegevuste logi =

08.02.2018 - meeskonna loomine, kokkuleppe sõlmimine teema osas 
10.02.2018 - õppejõu teavitamine koos esmase andmemudeliga 
15.02.2018 - lõpliku andmemudeli valmimine(versioon 5) 
18.02.2018 - õppejõu kinnitus, et teema ja meeskond kvalifiseeruvad 
22.02.2018 - viki lehe loomine ja analüüsi koostamise alustamine 
26.02.2018 - tiimi lisandus Kunnar Kukk 
01.03.2018 - tiimi sprint koosolek(seoses täiendava tiimiliikme lisandumisega täpsustasime skoopi) 
03.03.2018 - alustasime koodi kirjutamisega (tabelid klassideks ja annotatsioonid peale) 
06.03.2018 - täiendasime andmemudelit olemiga "UserTypeState" (et saaks muuta kasutajatüüpi) 
08.03.2018 - tiimi sprint koosolek 
18.03.2018 - lisasime olemid "Address", "AddressU", "AddressM", "OfferOfUser", "MediaInOffer" 
22.03.2018 - tiimi sprint koosolek, mis oli pühendatud andmemudeli täiendamisele 
23.03.2018 - pikem tiimi hackathon andmemudeli teemal 
29.03.2018 - täiendatud wiki lehte täielikult ringitöötatud andmemudeliga 
30.03.2018 - täiendatud wiki lehte andmemudeli metainfoga 
09.04.2018 - silusime andmemudelit (mõningad ebavajalikud viited olid sisse jäänud) 
06.05.2018 - panime uuendatud andmemudeli projekti wiki lehele üles 

= Kasutatavad metoodikad =

WatchWinders projektis plaanime kasutada peamiselt kaht metoodikat:

1. läbiv retsenseerimine (üks paariline teeb midagi valmis ja teine teeb sellele ülevaatuse; üksus lisatakse kui ülevaatus on lõplikult läbitud ning osapoolte vahel on saabunud konsensus) 
2. paaris programmeerimine (istume ühe masina taha maha ja kirjutame kolmekesi)

Tulenevalt kaugõppe formaadist saab ülekaalus olema esimene variant. Teist metoodikat kasutame nende osade kirjutamiseks, mille puhul võib arvata, et nende lahendamine on keeruline või et lahenduskäike võib olla väga erinevaid. Püüame jooksvalt siinses vikis kajastada ka seda, millise metoodika järgi üks või teine osa valmis.

= Projekti osad =

Alljärgnevalt anname ülevaate projekti osadest: 

(1) andmemudel 
(2) veebiteenuse analüüs 
(3) Minimum Viable Product definitsioon 
(4) Inkrement #1 
(5) Inkrement #2 
(6) Inkrement #3 

Projekti osad on meie viki lehel kirjeldatud valmimise järjekorras.

== Andmemudel ==

Andmemudeli koostamisel lähtusime õppejõu ette antud kriteeriumist, mille järgi andmemudelis on vähemalt 6 põhiolemit (tähistatud tumesinise ja lillaga - meie mudelis 11 tk),
mille hulgas ei sisaldu kasutajate tabelit (Person). 
 
Põhiolemid: 
* Watch - kell 
* Person - kasutaja/kollektsionäär või firma esindaja 
* Box - kellakarp 
* Organization - tootjad, edasimüüjad, hooldus 
* Settings - kellakarbi seade 
* Offer - pakkumine kollektsionäärile 
* Media - meediafailid kellade ja karpide kohta 
* Address - kasutaja/organisatsiooni aadress 
* ElectronicContact - elektrooniliste kontaktide loend 
* Log - logi 
* Access - paroolid ja kasutajanimed 
* Error - vead 
 
Type abiolemid: 
* WatchType - kellatüübid 
* PersonType - isikutüübid: admin, kasutaja 
* OrganizationType - organisatsioonitüübid: tootja, hooldaja, edasimüüja jt 
* ActionType - logi tüübid 
* ContactType - elektroonilise kontakti tüüp: skype, email, telefon jt 
 
Olekud: 
* PersonTypeState - isiku rolli kehtivus ajahetkel (isiku ja tüübi vaheline seos) 
* OrganizationTypeState - organisatsiooni olek(ud) ajahetkel 
 
Kuuluvus: 
* PersonWatch - isikute ja kellade vahelised seosed 
* PersonBox - isiku ja karbi vaheline seos 
* PersonAccess - isiku ja autentimisandmete vaheline seos 
* WatchInBox - kella ja karbi vaheline seos 
* ErrorInWatch - vea ja kella vaheline seos 
* SettingsInBox - seade ja karbi vaheline seos 
* WatchInOrganization - kella ja tootja vaheline seos 
* PersonInOrganization - isiku ja ettevõtte/organisatsiooni vaheline seos 
* SettingsOfWatchType - seade ja kellatüübi vaheline seos 
 
Abstraktsioonid: 
* Locator - abstraktsioon erinevate kontaktitüüpide jaoks 
* Party - abstraktsioon erinevate inimeste, organisatsioonide jt jaoks 
 
Kommunikatsioon: 
* OfferToPerson - isikule suunatud pakkumised 
* OfferFromPerson - isikult lähtuv pakkumine 
 
 
 
[[File:ww_andmemudel_06052018.png]]
 

Andmemudel valmis (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

== Veebiteenuse analüüs ==

Alljärgnevalt esitame kellakarpide infosüsteemi analüüsi järgmistes osades:

(1) toote/teenuse kirjeldus 
(2) probleemi kirjeldus 
(3) lahendus 
(4) süsteemi kasutajad 
(5) loodava API võimalused 
(6) funktsionaalsed nõuded 
(7) mittefunktsionaalsed nõuded 

=== Toote/teenuse kirjeldus ===
Teenuse eesmärgiks on lahendada probleem, kuidas jälgida kellakarpide kaudu mehhaaniliste käekellade seisundit ning keerata neid automaatselt üles distantsilt, näiteks juhul, kui kellade kollektsionäär ei asu füüsiliselt igapäevaselt oma kellade juures. Teenus võimaldab ka tootjal uuendada kontaktandmeid, saata personaalseid teateid. Administraatorile annab ülevaate platvormis toimuvast.

=== Probleemi kirjeldus ===
Mehhaaniliste käekellade kollektsionääride huvi kellakarpide vastu on mitmetahuline. Kollektsionääre huvitab arvepidamine – mitu kella, missuguste omaduste ja eripäradega neil kollektsioonis on. Teisalt soov eksponeerida oma kogusid kolleegidele ja sõpradele. Kellakarpidega täidetud sein või riiulid loovad selleks suurepärase võimaluse. Kolmandaks praktiline vajadus tagada kellavedrude õige vinnastatuse aste. Kaasaja mehhaanilised kellamehhanismid (''automatic'') võimaldavad kellakorpuse füüsilisel liigutamisel kellavedru automaatselt vinnastada.

Näiteks piisab kella kinnitamisest käele, et see hakkaks end käe liigutamisel üles keerama. Kuidas keerata aga üles seisvat kella, mis seisab paigal kellakarbis? Selleks on tänapäeva kellakarpides elektrimootor, mis tagab kella liigutamise vastavalt kellatüübile ettenähtud ööpäevase graafiku alusel. Kollektsionääride üheks probleemiks on see, kuidas juhtida sellist karpi ja omada jooksvat ülevaadet kõikidest oma karpidest, nende tehnilisest seadistusest ja kollektsiooni kuuluvatest kelladest olles tööreisil välisriigis?

=== Lahendus ===
Probleemi lahendamiseks ehitame REST + ASP.NET Core + WebAPI koos kliendiga, mis võimaldab kellakollektsionääridel hallata kellasid karpides, administraatoritel saada ülevaate süsteemist ning tootjatele lisada infot kollektsionääridele. Käesoleva projekti käigus '''ei tegeleta''' kahe IoT lahenduse kui terviku seisukohast olulise nüansiga: (i) karbi püsivara (''firmware'') loomisega, (ii) klientrakenduse ''frontend'' lõpliku häälestamisega (ilus .css ja pildid).

=== Süsteemi kasutajad ===
'''Kollektsionäär''' - haldab ja muudab infot oma kellade ning oma kellakarpide kohta. 
'''Administraator''' - haldab süsteemi infot, vajadusel eemaldab probleeme. 
'''Tootja''' - saab saata süsteemi kollektsionääridele mõeldud infot. 
'''Hooldaja''' - saab infot hooldamist vajavate kellade ja -karpide kohta. 

=== Loodava API võimalused ===
Alljärgnevalt vaatame loodava API võimalusi kasutajagruppide kaupa:

'''Kasutajale/kellakollektsionäärile'''
* Saada ülevaade kelladest ja kellakarpidest (lisada, muuta, vaadata).
* Muuta karbis oleva kella kohta käivat informatsiooni (kella nimi, tootja, tootmise aeg, viitenumber, mehhanism, jõureservi jääk (valikuline), foto kellast, kellarihma liik, muu).
* Karpe juhtida (keerata automaatselt üles). Näha ja muuta kella üleskeerava mehhanismi liikumise kiirust ja muid detaile (nt liikumise suund).
* Näha karbi seisundit, kas karp on hetkel wifiga ühendatud või mitte.
* Näha karbilt saabunud veateateid.
* Sisestada infot kella seisundist.
* Suhelda hooldajate ja tootjatega

'''Tootjale'''
* Uuendada kontaktandmeid.
* Saata personaalseid teateid kellakollektsionääridele.

'''Administraatorile'''
* Näha võrku ühendatud karpide arvu.
* Näha karpidesse paigaldatud kellade nimistut (ilma muude kasutajaandmeteta).
* Näha kellade üleskeeramise mehhanismide arvnäitajaid (madalaim kiirus, keskmine kiirus, tippkiirus; samuti liikumise suundade arvnäitajaid).
* IP-aadresside järgi ülevaadet, millistes riikides karpe kasutatakse (üldised arvandmed).
* Veateatega karpide arv süsteemis (üldised arvandmed).

=== Funktsionaalsed nõuded ===
* Kõik tegevused peavad olema autoriseeritud.
* REST + ASP.NET Core + WebAPI tagastab infot valideeritud JSON formaadis.
* API veatöötlus on tehtud, kasutades standardseid veakoode.
* API-le on tehtud 'health check'.
* Kõik kasutajad peavad saama end autoriseerida.
* Kasutaja, tootja ja administraatori tegevused logitakse.
* Logi ei ole muudetav, vaid on kättesaadav.
* Kasutaja ega tootja ei näe teiste kasutajate ega tootjate infot.
* API klient on kohanduv mobiilile, tahvlile ja desktoparvutile.
* Sisendandmed on valideeritud.

=== Mittefunktsionaalsed nõuded ===
* API-le on lisatud Swagger fail.
* Teenus ja tehniline lahendus on dokumenteeritud.
* Süsteemi kood on vabalt ligipääsetav, täiendatav ning allalaetav.

Esitame töö etappidena, kus kõigepealt defineerime ära Minimum Viable Producti [https://en.wikipedia.org/wiki/Minimum_viable_product] ehk selle miinimumi, mis pakub kasutajale maksimaalset väärtust. See tähendab API loomist ning esmase kliendi loomist kõigile MVP-s defineeritud kasutajagruppidele. Seejärel realiseerime projekti inkrementide ehk tootearenduse sammudena, milles lisame uusi funktsionaalsusi. Ideaalis jõuame realiseerida kõik sammud, kuid kuna teeme nimetatud tööd antud ajaraamis ja koosseisus esmakordselt, siis võtame vabaduse ka realiseerida korralikult niipalju, kui jõuame projekti käigus ära teha.

Võimalik, et meie lõpptulemus erineb mõnes osas esitatud analüüsist. Seda olenevalt sellest kui edukalt meil õnnestub plaanitud funktsionaalsusi realiseerida. Erisusi plaanime käsitleda vastavas 'post production' jaotuses, kus loendame ka projektist kogunenud peamised õppetunnid.

Analüüs valmis (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

== Minimum Viable Product definitsioon ==
'''Kasutaja'''
* Kasutaja saab süsteemi logida ning välja logida
* Kasutaja saab lisada uue kellakarbi
* Kasutaja saab lisada uue kella kellakarpi
* Kasutaja saab muuta kella infot kellakarbis
* Kasutaja saab näha ülevaadet oma karpidest
* Kasutaja saab muuta kellakarbi seadeid
* Kasutaja saab kustutada kella karbis
* Kasutaja saab kustutada kellakarbi

'''Administraator'''
* Näeb autoriseeritult logisid

'''Tootja'''
* Saab lisada kontaktandmeid
* Saab kontaktandmeid muuta

== Inkrement #1 ==
'''Kasutaja'''
* Näeb karbilt saabunud veateateid.
* Saab kellakarpe juhtida.

'''Administraator'''
* IP-aadresside järgi ülevaadet, millistes riikides karpe kasutatakse (üldised arvandmed).
* Karpidesse paigaldatud kellade nimistut (ilma muude kasutajaandmeteta).
* Näeb kasutajate statistikat.

'''Tootja'''
* Saata personaalseid teateid kellakollektsionääridele.

== Inkrement #2 ==
'''Kasutaja'''
* Saab saata teate tootjale.
* Näeb tootja vastust.
* Näha karbi seisundit, kas karp on hetkel wifiga ühendatud või mitte.

'''Administraator'''
* Näha kellade üleskeeramise mehhanismide arvnäitajaid (madalaim kiirus, keskmine kiirus, tippkiirus; samuti liikumise suundade arvnäitajaid).
* Näeb tegevuste ajalugu kliendist.

'''Tootja'''
* Saab lugeda kasutaja teadet.
* Saab vastata kasutajale.

'''Hooldaja'''
* Saab info hooldamist vajavate kellade kohta.

== Inkrement #3 ==
'''Kasutaja'''
* On ehitatud keeletugi.

'''Tootja'''
* On ehitatud keeletugi.

'''Hooldaja'''
* On ehitatud keeletugi.

Inkrementid valmisid (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

= XML ülesanne =
Järgnevalt esitame oma XML-ülesande tulemused.

== IT Management Transformation XML To ML ==
<pre>
<?xml version="1.0" encoding="utf-8"?>
<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">
<xsl:output method="xml" indent="yes"/>
<xsl:template match="/">
<unhandledDevices>
<xsl:for-each select="customers/customer/locations/location/items/item[@isInWorkingCondition='false']">
<device>
<name>
<xsl:value-of select="manufacturer"/>
<xsl:text> </xsl:text>
<xsl:value-of select="model"/>
</name>
<ticket>
<xsl:for-each select="tickets/ticket[@isHandled='false']">
<ticket_id>
<xsl:value-of select="@id"/>
</ticket_id>
<issued_in>
<xsl:value-of select="@issuedIn"/>
</issued_in>
<description>
<xsl:value-of select="description"/>
</description>
</xsl:for-each>
</ticket>
</device>
</xsl:for-each>
</unhandledDevices>
</xsl:template>
</xsl:stylesheet>
</pre>

== IT Management Transformation HTML ==

<pre>
<?xml version="1.0" encoding="utf-8"?>
<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">
<xsl:output method="html" indent="yes"/>
<xsl:template match="/">

<html>
<head>
<title>ItManagement Laptops</title>
</head>
<body style="background-color:#F7F7F7">
<h1>Computers</h1>
<xsl:for-each select="/customers/customer/locations/location/items/item[@type='laptopComputer']">
<xsl:sort select="@isActive='false'"/>
<hr />
<div>
<h3>
<xsl:value-of select="manufacturer"/>
</h3>
Model: 
<xsl:value-of select="model"/>
 
Serial number: 
<xsl:value-of select="serialNumber"/>
 
Date of purchase: 
<xsl:value-of select="dateOfPurchase"/>
 
Operating system: 
<xsl:value-of select="operatingSystem"/>
 
Is on active list: 
<xsl:value-of select="@isActive"/>
 
</div>

<div style="background-color:#E3FAEE" >

<xsl:for-each select="tickets/ticket">
<xsl:choose>
<xsl:when test="@isHandled='true'">
<h3>Handled tickets</h3>
<ul>
Issued in: 
<xsl:value-of select="@issuedIn"/>
 
Ticket ID: 
<xsl:value-of select="@id" />
 
Description: 
<xsl:value-of select="description"/>
 
Solution: 
<xsl:value-of select="solution"/>
 
</ul>
</xsl:when>
<xsl:when test="@isHandled='false'">
<div style="background-color:#FDE5E5">
<h3>Unhandled tickets</h3>
<ul>
Issued in: 
<xsl:value-of select="@issuedIn"/>
 
Ticket ID: 
<xsl:value-of select="@id" />
 
Description: 
<xsl:value-of select="description"/>
 
Solution: 
<xsl:value-of select="solution"/>
 
</ul>
</div>
</xsl:when>
</xsl:choose>
</xsl:for-each>

</div>
</xsl:for-each>
</body>
</html>
</xsl:template>
</xsl:stylesheet>
</pre>

== IT Management XSD ==

<pre>
<?xml version="1.0" encoding="utf-8"?>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="customers">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="customer">
<xs:complexType>
<xs:sequence>
<xs:element name="customerName" type="xs:string" />
<xs:element minOccurs="0" name="contactPerson" type="xs:string" />
<xs:element name="e-mail" type="xs:string" />
<xs:element name="phoneNumber" type="xs:string" />
<xs:element name="locations">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="location">
<xs:complexType>
<xs:sequence>
<xs:element name="city" type="xs:string" />
<xs:element name="address" type="xs:string" />
<xs:element name="comment" type="xs:string" />
<xs:element minOccurs="0" name="localContactPerson" type="xs:string" />
<xs:element minOccurs="0" name="localPhone" type="xs:string" />
<xs:element name="items">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="item">
<xs:complexType>
<xs:sequence>
<xs:element name="manufacturer" type="xs:string" />
<xs:element name="model" type="xs:string" />
<xs:element name="serialNumber" type="xs:string" />
<xs:element name="dateOfPurchase" type="xs:date" />
<xs:element minOccurs="0" name="operatingSystem">
<xs:complexType>
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute name="version" type="xs:string" use="required" />
</xs:extension>
</xs:simpleContent>
</xs:complexType>
</xs:element>
<xs:element minOccurs="0" name="tickets">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="ticket">
<xs:complexType>
<xs:sequence>
<xs:element name="description" type="xs:string" />
<xs:element name="solution" type="xs:string" />
</xs:sequence>
<xs:attribute name="id" type="xs:string" use="required" />
<xs:attribute name="issuedIn" type="xs:date" use="required" />
<xs:attribute name="isHandled" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:unsignedInt" use="required" />
<xs:attribute name="type" type="xs:string" use="required" />
<xs:attribute name="isActive" type="xs:boolean" use="required" />
<xs:attribute name="isUnderWarranty" type="xs:boolean" use="required" />
<xs:attribute name="warrantyInMonths" type="xs:unsignedByte" use="required" />
<xs:attribute name="isInWorkingCondition" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="type" type="xs:string" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:unsignedInt" use="required" />
<xs:attribute name="type" type="xs:string" use="required" />
<xs:attribute name="isActive" type="xs:boolean" use="required" />
<xs:attribute name="hasManyLocations" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
</pre>

== IT Management XML ==

<pre>
<?xml version="1.0" encoding="utf-8" ?>
<customers>
<customer id="33" type="company" isActive="true" hasManyLocations="true">
<customerName>Elamustevaba OÜ</customerName>
<contactPerson>Juhan Pühamees</contactPerson>
<e-mail>juhan@evaba.com</e-mail>
<phoneNumber>+37256565656</phoneNumber>
<locations>
<location type="office">
<city>Tallinn</city>
<address><![CDATA[Pikk 7, 56401]]></address>
<comment><![CDATA[3. korrus -> paremat kätt]]></comment>
<localContactPerson>Maiu Piimaauto</localContactPerson>
<localPhone>+3726510510</localPhone>
<items>
<item id="1" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="36" isInWorkingCondition="false">
<manufacturer>Dell</manufacturer>
<model>Inspiron 3558</model>
<serialNumber>6FGH5JN</serialNumber>
<dateOfPurchase>2017-07-22</dateOfPurchase>
<operatingSystem version="1709">Windows 10 Home</operatingSystem>
<tickets>
<ticket id="HWI001" issuedIn="2017-11-21" isHandled="true">
<description><![CDATA[Wi-Fi is not working]]></description>
<solution><![CDATA[Wi-Fi card replaced (Under the warranty)]]></solution>
</ticket>
<ticket id="SWI256" issuedIn="2018-05-05" isHandled="false">
<description><![CDATA[Computer keeps showing login screen]]></description>
<solution></solution>
</ticket>
</tickets>
</item>
<item id="55" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="60" isInWorkingCondition="true">
<manufacturer>Dell</manufacturer>
<model>Latitude E7550</model>
<serialNumber>8JGR78U</serialNumber>
<dateOfPurchase>2016-06-15</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Home</operatingSystem>
</item>
</items>
</location>
<location type="store">
<city>Tallinn</city>
<address><![CDATA[Lai 17, 56401]]></address>
<comment><![CDATA[keldrikorrusel]]></comment>
<localContactPerson>Tanja Õielemb</localContactPerson>
<localPhone>+3726510520</localPhone>
<items>
<item id="83" type="desktopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Lenovo</manufacturer>
<model>ThinkCentre M715</model>
<serialNumber>IO25689AD54KL</serialNumber>
<dateOfPurchase>2017-12-01</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Pro</operatingSystem>
</item>
<item id="12" type="monitor" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>AOC</manufacturer>
<model>L456</model>
<serialNumber>9803987YE54</serialNumber>
<dateOfPurchase>2015-05-03</dateOfPurchase>
<tickets>
<ticket id="HWI126" issuedIn="2016-01-18" isHandled="true">
<description><![CDATA[Doesn't work, no picture.]]></description>
<solution><![CDATA[Wasn't plugged in. Technician did it - works again!]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
<customer id="02" type="private" isActive="true" hasManyLocations="false">
<customerName>Kessu Sisselasi</customerName>
<e-mail>kessu@tripp.org</e-mail>
<phoneNumber>+372555555</phoneNumber>
<locations>
<location type="home">
<city>Saue</city>
<address><![CDATA[Kooli 4-8, 78965]]></address>
<comment><![CDATA[2. korrus. Kitsad koridorid.]]></comment>
<items>
<item id="98" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Acer</manufacturer>
<model>Aspire 5</model>
<serialNumber>475YRT89K4</serialNumber>
<dateOfPurchase>2018-03-25</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Home</operatingSystem>
</item>
<item id="4" type="laptopComputer" isActive="false" isUnderWarranty="false" warrantyInMonths="36" isInWorkingCondition="true">
<manufacturer>Lenovo</manufacturer>
<model>IdeaPad L530</model>
<serialNumber>U89TRY765ME</serialNumber>
<dateOfPurchase>2007-08-14</dateOfPurchase>
<operatingSystem version="">Windows XP</operatingSystem>
<tickets>
<ticket id="SWI069" issuedIn="2010-01-28" isHandled="true">
<description><![CDATA[Blue screen.]]></description>
<solution><![CDATA[Video driver update.]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
<customer id="26" type="company" isActive="true" hasManyLocations="true">
<customerName>Aktsiaselts OÜ</customerName>
<contactPerson>Gunnar Kuningas</contactPerson>
<e-mail>gunnar@kunn.ee</e-mail>
<phoneNumber>+3726985236</phoneNumber>
<locations>
<location type="office">
<city>Loksa</city>
<address><![CDATA[Kalda 14, 78965]]></address>
<comment><![CDATA[Sissepääs Rimi poolt, helesinine uks]]></comment>
<items>
<item id="26" type="laptopComputer" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Apple</manufacturer>
<model>Macbook Air</model>
<serialNumber>258JUY369</serialNumber>
<dateOfPurchase>2017-03-01</dateOfPurchase>
<operatingSystem version="High Sierra">OS X</operatingSystem>
</item>
<item id="59" type="laptopComputer" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="false">
<manufacturer>Acer</manufacturer>
<model>Chromebook 11</model>
<serialNumber>U89TRY765ME</serialNumber>
<dateOfPurchase>2016-04-23</dateOfPurchase>
<operatingSystem version="">Chrome OS</operatingSystem>
<tickets>
<ticket id="HWI046" issuedIn="2010-02-28" isHandled="false">
<description><![CDATA[Stripes on screen]]></description>
<solution><![CDATA[]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
</customers>
</pre>

= Kasutatud kirjandus ja allikad =

1. Albahari, Joseph, Albari, Ben 2017. C# 7.0 in A Nutshell. Sebastopol: O’Reilly 
2. MariaDB Foundation. MariaDB. Kättesaadav:https://mariadb.org/ 
3. Martin, Robert 2018. Clean Architecture. Boston: Pearson Education

WatchWinders

2018-06-08T19:06:39Z

Tkuuskma:

= Meeskond =

Toomas Juhkov, toomas.juhkov@gmail.com 
Tiit Kuuskmäe, tiit.kuuskmae@gmail.com 
Kunnar Kukk, Kunnar.kukk@gmail.com 

= Tegevuste logi =

08.02.2018 - meeskonna loomine, kokkuleppe sõlmimine teema osas 
10.02.2018 - õppejõu teavitamine koos esmase andmemudeliga 
15.02.2018 - lõpliku andmemudeli valmimine(versioon 5) 
18.02.2018 - õppejõu kinnitus, et teema ja meeskond kvalifiseeruvad 
22.02.2018 - viki lehe loomine ja analüüsi koostamise alustamine 
26.02.2018 - tiimi lisandus Kunnar Kukk 
01.03.2018 - tiimi sprint koosolek(seoses täiendava tiimiliikme lisandumisega täpsustasime skoopi) 
03.03.2018 - alustasime koodi kirjutamisega (tabelid klassideks ja annotatsioonid peale) 
06.03.2018 - täiendasime andmemudelit olemiga "UserTypeState" (et saaks muuta kasutajatüüpi) 
08.03.2018 - tiimi sprint koosolek 
18.03.2018 - lisasime olemid "Address", "AddressU", "AddressM", "OfferOfUser", "MediaInOffer" 
22.03.2018 - tiimi sprint koosolek, mis oli pühendatud andmemudeli täiendamisele 
23.03.2018 - pikem tiimi hackathon andmemudeli teemal 
29.03.2018 - täiendatud wiki lehte täielikult ringitöötatud andmemudeliga 
30.03.2018 - täiendatud wiki lehte andmemudeli metainfoga 
09.04.2018 - silusime andmemudelit (mõningad ebavajalikud viited olid sisse jäänud) 
06.05.2018 - panime uuendatud andmemudeli projekti wiki lehele üles 

= Kasutatavad metoodikad =

WatchWinders projektis plaanime kasutada peamiselt kaht metoodikat:

1. läbiv retsenseerimine (üks paariline teeb midagi valmis ja teine teeb sellele ülevaatuse; üksus lisatakse kui ülevaatus on lõplikult läbitud ning osapoolte vahel on saabunud konsensus) 
2. paaris programmeerimine (istume ühe masina taha maha ja kirjutame kolmekesi)

Tulenevalt kaugõppe formaadist saab ülekaalus olema esimene variant. Teist metoodikat kasutame nende osade kirjutamiseks, mille puhul võib arvata, et nende lahendamine on keeruline või et lahenduskäike võib olla väga erinevaid. Püüame jooksvalt siinses vikis kajastada ka seda, millise metoodika järgi üks või teine osa valmis.

= Projekti osad =

Alljärgnevalt anname ülevaate projekti osadest: 

(1) andmemudel 
(2) veebiteenuse analüüs 
(3) Minimum Viable Product definitsioon 
(4) Inkrement #1 
(5) Inkrement #2 
(6) Inkrement #3 

Projekti osad on meie viki lehel kirjeldatud valmimise järjekorras.

== Andmemudel ==

Andmemudeli koostamisel lähtusime õppejõu ette antud kriteeriumist, mille järgi andmemudelis on vähemalt 6 põhiolemit (tähistatud tumesinise ja lillaga - meie mudelis 11 tk),
mille hulgas ei sisaldu kasutajate tabelit (Person). 
 
Põhiolemid: 
* Watch - kell 
* Person - kasutaja/kollektsionäär või firma esindaja 
* Box - kellakarp 
* Organization - tootjad, edasimüüjad, hooldus 
* Settings - kellakarbi seade 
* Offer - pakkumine kollektsionäärile 
* Media - meediafailid kellade ja karpide kohta 
* Address - kasutaja/organisatsiooni aadress 
* ElectronicContact - elektrooniliste kontaktide loend 
* Log - logi 
* Access - paroolid ja kasutajanimed 
* Error - vead 
 
Type abiolemid: 
* WatchType - kellatüübid 
* PersonType - isikutüübid: admin, kasutaja 
* OrganizationType - organisatsioonitüübid: tootja, hooldaja, edasimüüja jt 
* ActionType - logi tüübid 
* ContactType - elektroonilise kontakti tüüp: skype, email, telefon jt 
 
Olekud: 
* PersonTypeState - isiku rolli kehtivus ajahetkel (isiku ja tüübi vaheline seos) 
* OrganizationTypeState - organisatsiooni olek(ud) ajahetkel 
 
Kuuluvus: 
* PersonWatch - isikute ja kellade vahelised seosed 
* PersonBox - isiku ja karbi vaheline seos 
* PersonAccess - isiku ja autentimisandmete vaheline seos 
* WatchInBox - kella ja karbi vaheline seos 
* ErrorInWatch - vea ja kella vaheline seos 
* SettingsInBox - seade ja karbi vaheline seos 
* WatchInOrganization - kella ja tootja vaheline seos 
* PersonInOrganization - isiku ja ettevõtte/organisatsiooni vaheline seos 
* SettingsOfWatchType - seade ja kellatüübi vaheline seos 
 
Abstraktsioonid: 
* Locator - abstraktsioon erinevate kontaktitüüpide jaoks 
* Party - abstraktsioon erinevate inimeste, organisatsioonide jt jaoks 
 
Kommunikatsioon: 
* OfferToPerson - isikule suunatud pakkumised 
* OfferFromPerson - isikult lähtuv pakkumine 
 
 
 
[[File:ww_andmemudel_06052018.png]]
 

Andmemudel valmis (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

== Veebiteenuse analüüs ==

Alljärgnevalt esitame kellakarpide infosüsteemi analüüsi järgmistes osades:

(1) toote/teenuse kirjeldus 
(2) probleemi kirjeldus 
(3) lahendus 
(4) süsteemi kasutajad 
(5) loodava API võimalused 
(6) funktsionaalsed nõuded 
(7) mittefunktsionaalsed nõuded 

=== Toote/teenuse kirjeldus ===
Teenuse eesmärgiks on lahendada probleem, kuidas jälgida kellakarpide kaudu mehhaaniliste käekellade seisundit ning keerata neid automaatselt üles distantsilt, näiteks juhul, kui kellade kollektsionäär ei asu füüsiliselt igapäevaselt oma kellade juures. Teenus võimaldab ka tootjal uuendada kontaktandmeid, saata personaalseid teateid. Administraatorile annab ülevaate platvormis toimuvast.

=== Probleemi kirjeldus ===
Mehhaaniliste käekellade kollektsionääride huvi kellakarpide vastu on mitmetahuline. Kollektsionääre huvitab arvepidamine – mitu kella, missuguste omaduste ja eripäradega neil kollektsioonis on. Teisalt soov eksponeerida oma kogusid kolleegidele ja sõpradele. Kellakarpidega täidetud sein või riiulid loovad selleks suurepärase võimaluse. Kolmandaks praktiline vajadus tagada kellavedrude õige vinnastatuse aste. Kaasaja mehhaanilised kellamehhanismid (''automatic'') võimaldavad kellakorpuse füüsilisel liigutamisel kellavedru automaatselt vinnastada.

Näiteks piisab kella kinnitamisest käele, et see hakkaks end käe liigutamisel üles keerama. Kuidas keerata aga üles seisvat kella, mis seisab paigal kellakarbis? Selleks on tänapäeva kellakarpides elektrimootor, mis tagab kella liigutamise vastavalt kellatüübile ettenähtud ööpäevase graafiku alusel. Kollektsionääride üheks probleemiks on see, kuidas juhtida sellist karpi ja omada jooksvat ülevaadet kõikidest oma karpidest, nende tehnilisest seadistusest ja kollektsiooni kuuluvatest kelladest olles tööreisil välisriigis?

=== Lahendus ===
Probleemi lahendamiseks ehitame REST + ASP.NET Core + WebAPI koos kliendiga, mis võimaldab kellakollektsionääridel hallata kellasid karpides, administraatoritel saada ülevaate süsteemist ning tootjatele lisada infot kollektsionääridele. Käesoleva projekti käigus '''ei tegeleta''' kahe IoT lahenduse kui terviku seisukohast olulise nüansiga: (i) karbi püsivara (''firmware'') loomisega, (ii) klientrakenduse ''frontend'' lõpliku häälestamisega (ilus .css ja pildid).

=== Süsteemi kasutajad ===
'''Kollektsionäär''' - haldab ja muudab infot oma kellade ning oma kellakarpide kohta. 
'''Administraator''' - haldab süsteemi infot, vajadusel eemaldab probleeme. 
'''Tootja''' - saab saata süsteemi kollektsionääridele mõeldud infot. 
'''Hooldaja''' - saab infot hooldamist vajavate kellade ja -karpide kohta. 

=== Loodava API võimalused ===
Alljärgnevalt vaatame loodava API võimalusi kasutajagruppide kaupa:

'''Kasutajale/kellakollektsionäärile'''
* Saada ülevaade kelladest ja kellakarpidest (lisada, muuta, vaadata).
* Muuta karbis oleva kella kohta käivat informatsiooni (kella nimi, tootja, tootmise aeg, viitenumber, mehhanism, jõureservi jääk (valikuline), foto kellast, kellarihma liik, muu).
* Karpe juhtida (keerata automaatselt üles). Näha ja muuta kella üleskeerava mehhanismi liikumise kiirust ja muid detaile (nt liikumise suund).
* Näha karbi seisundit, kas karp on hetkel wifiga ühendatud või mitte.
* Näha karbilt saabunud veateateid.
* Sisestada infot kella seisundist.
* Suhelda hooldajate ja tootjatega

'''Tootjale'''
* Uuendada kontaktandmeid.
* Saata personaalseid teateid kellakollektsionääridele.

'''Administraatorile'''
* Näha võrku ühendatud karpide arvu.
* Näha karpidesse paigaldatud kellade nimistut (ilma muude kasutajaandmeteta).
* Näha kellade üleskeeramise mehhanismide arvnäitajaid (madalaim kiirus, keskmine kiirus, tippkiirus; samuti liikumise suundade arvnäitajaid).
* IP-aadresside järgi ülevaadet, millistes riikides karpe kasutatakse (üldised arvandmed).
* Veateatega karpide arv süsteemis (üldised arvandmed).

=== Funktsionaalsed nõuded ===
* Kõik tegevused peavad olema autoriseeritud.
* REST + ASP.NET Core + WebAPI tagastab infot valideeritud JSON formaadis.
* API veatöötlus on tehtud, kasutades standardseid veakoode.
* API-le on tehtud 'health check'.
* Kõik kasutajad peavad saama end autoriseerida.
* Kasutaja, tootja ja administraatori tegevused logitakse.
* Logi ei ole muudetav, vaid on kättesaadav.
* Kasutaja ega tootja ei näe teiste kasutajate ega tootjate infot.
* API klient on kohanduv mobiilile, tahvlile ja desktoparvutile.
* Sisendandmed on valideeritud.

=== Mittefunktsionaalsed nõuded ===
* API-le on lisatud Swagger fail.
* Teenus ja tehniline lahendus on dokumenteeritud.
* Süsteemi kood on vabalt ligipääsetav, täiendatav ning allalaetav.

Esitame töö etappidena, kus kõigepealt defineerime ära Minimum Viable Producti [https://en.wikipedia.org/wiki/Minimum_viable_product] ehk selle miinimumi, mis pakub kasutajale maksimaalset väärtust. See tähendab API loomist ning esmase kliendi loomist kõigile MVP-s defineeritud kasutajagruppidele. Seejärel realiseerime projekti inkrementide ehk tootearenduse sammudena, milles lisame uusi funktsionaalsusi. Ideaalis jõuame realiseerida kõik sammud, kuid kuna teeme nimetatud tööd antud ajaraamis ja koosseisus esmakordselt, siis võtame vabaduse ka realiseerida korralikult niipalju, kui jõuame projekti käigus ära teha.

Võimalik, et meie lõpptulemus erineb mõnes osas esitatud analüüsist. Seda olenevalt sellest kui edukalt meil õnnestub plaanitud funktsionaalsusi realiseerida. Erisusi plaanime käsitleda vastavas 'post production' jaotuses, kus loendame ka projektist kogunenud peamised õppetunnid.

Analüüs valmis (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

== Minimum Viable Product definitsioon ==
'''Kasutaja'''
* Kasutaja saab süsteemi logida ning välja logida
* Kasutaja saab lisada uue kellakarbi
* Kasutaja saab lisada uue kella kellakarpi
* Kasutaja saab muuta kella infot kellakarbis
* Kasutaja saab näha ülevaadet oma karpidest
* Kasutaja saab muuta kellakarbi seadeid
* Kasutaja saab kustutada kella karbis
* Kasutaja saab kustutada kellakarbi

'''Administraator'''
* Näeb autoriseeritult logisid

'''Tootja'''
* Saab lisada kontaktandmeid
* Saab kontaktandmeid muuta

== Inkrement #1 ==
'''Kasutaja'''
* Näeb karbilt saabunud veateateid.
* Saab kellakarpe juhtida.

'''Administraator'''
* IP-aadresside järgi ülevaadet, millistes riikides karpe kasutatakse (üldised arvandmed).
* Karpidesse paigaldatud kellade nimistut (ilma muude kasutajaandmeteta).
* Näeb kasutajate statistikat.

'''Tootja'''
* Saata personaalseid teateid kellakollektsionääridele.

== Inkrement #2 ==
'''Kasutaja'''
* Saab saata teate tootjale.
* Näeb tootja vastust.
* Näha karbi seisundit, kas karp on hetkel wifiga ühendatud või mitte.

'''Administraator'''
* Näha kellade üleskeeramise mehhanismide arvnäitajaid (madalaim kiirus, keskmine kiirus, tippkiirus; samuti liikumise suundade arvnäitajaid).
* Näeb tegevuste ajalugu kliendist.

'''Tootja'''
* Saab lugeda kasutaja teadet.
* Saab vastata kasutajale.

'''Hooldaja'''
* Saab info hooldamist vajavate kellade kohta.

== Inkrement #3 ==
'''Kasutaja'''
* On ehitatud keeletugi.

'''Tootja'''
* On ehitatud keeletugi.

'''Hooldaja'''
* On ehitatud keeletugi.

Inkrementid valmisid (1) metoodika abil, vt lähemalt [[#Kasutatavad metoodikad|projekti metoodikate]] sektsioonist.

= XML ülesanne =
Järgnevalt esitame oma XML-ülesande tulemused.

== IT Management Transformation XML To ML ==

<?xml version="1.0" encoding="utf-8"?>
<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">
<xsl:output method="xml" indent="yes"/>
<xsl:template match="/">
<unhandledDevices>
<xsl:for-each select="customers/customer/locations/location/items/item[@isInWorkingCondition='false']">
<device>
<name>
<xsl:value-of select="manufacturer"/>
<xsl:text> </xsl:text>
<xsl:value-of select="model"/>
</name>
<ticket>
<xsl:for-each select="tickets/ticket[@isHandled='false']">
<ticket_id>
<xsl:value-of select="@id"/>
</ticket_id>
<issued_in>
<xsl:value-of select="@issuedIn"/>
</issued_in>
<description>
<xsl:value-of select="description"/>
</description>
</xsl:for-each>
</ticket>
</device>
</xsl:for-each>
</unhandledDevices>
</xsl:template>
</xsl:stylesheet>

== IT Management Transformation HTML ==

<?xml version="1.0" encoding="utf-8"?>
<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">
<xsl:output method="html" indent="yes"/>
<xsl:template match="/">

<html>
<head>
<title>ItManagement Laptops</title>
</head>
<body style="background-color:#F7F7F7">
<h1>Computers</h1>
<xsl:for-each select="/customers/customer/locations/location/items/item[@type='laptopComputer']">
<xsl:sort select="@isActive='false'"/>
<hr />
<div>
<h3>
<xsl:value-of select="manufacturer"/>
</h3>
Model: 
<xsl:value-of select="model"/>
 
Serial number: 
<xsl:value-of select="serialNumber"/>
 
Date of purchase: 
<xsl:value-of select="dateOfPurchase"/>
 
Operating system: 
<xsl:value-of select="operatingSystem"/>
 
Is on active list: 
<xsl:value-of select="@isActive"/>
 
</div>

<div style="background-color:#E3FAEE" >

<xsl:for-each select="tickets/ticket">
<xsl:choose>
<xsl:when test="@isHandled='true'">
<h3>Handled tickets</h3>
<ul>
Issued in: 
<xsl:value-of select="@issuedIn"/>
 
Ticket ID: 
<xsl:value-of select="@id" />
 
Description: 
<xsl:value-of select="description"/>
 
Solution: 
<xsl:value-of select="solution"/>
 
</ul>
</xsl:when>
<xsl:when test="@isHandled='false'">
<div style="background-color:#FDE5E5">
<h3>Unhandled tickets</h3>
<ul>
Issued in: 
<xsl:value-of select="@issuedIn"/>
 
Ticket ID: 
<xsl:value-of select="@id" />
 
Description: 
<xsl:value-of select="description"/>
 
Solution: 
<xsl:value-of select="solution"/>
 
</ul>
</div>
</xsl:when>
</xsl:choose>
</xsl:for-each>

</div>
</xsl:for-each>
</body>
</html>
</xsl:template>
</xsl:stylesheet>

== IT Management XSD ==

<?xml version="1.0" encoding="utf-8"?>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="customers">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="customer">
<xs:complexType>
<xs:sequence>
<xs:element name="customerName" type="xs:string" />
<xs:element minOccurs="0" name="contactPerson" type="xs:string" />
<xs:element name="e-mail" type="xs:string" />
<xs:element name="phoneNumber" type="xs:string" />
<xs:element name="locations">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="location">
<xs:complexType>
<xs:sequence>
<xs:element name="city" type="xs:string" />
<xs:element name="address" type="xs:string" />
<xs:element name="comment" type="xs:string" />
<xs:element minOccurs="0" name="localContactPerson" type="xs:string" />
<xs:element minOccurs="0" name="localPhone" type="xs:string" />
<xs:element name="items">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="item">
<xs:complexType>
<xs:sequence>
<xs:element name="manufacturer" type="xs:string" />
<xs:element name="model" type="xs:string" />
<xs:element name="serialNumber" type="xs:string" />
<xs:element name="dateOfPurchase" type="xs:date" />
<xs:element minOccurs="0" name="operatingSystem">
<xs:complexType>
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute name="version" type="xs:string" use="required" />
</xs:extension>
</xs:simpleContent>
</xs:complexType>
</xs:element>
<xs:element minOccurs="0" name="tickets">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="ticket">
<xs:complexType>
<xs:sequence>
<xs:element name="description" type="xs:string" />
<xs:element name="solution" type="xs:string" />
</xs:sequence>
<xs:attribute name="id" type="xs:string" use="required" />
<xs:attribute name="issuedIn" type="xs:date" use="required" />
<xs:attribute name="isHandled" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:unsignedInt" use="required" />
<xs:attribute name="type" type="xs:string" use="required" />
<xs:attribute name="isActive" type="xs:boolean" use="required" />
<xs:attribute name="isUnderWarranty" type="xs:boolean" use="required" />
<xs:attribute name="warrantyInMonths" type="xs:unsignedByte" use="required" />
<xs:attribute name="isInWorkingCondition" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="type" type="xs:string" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:unsignedInt" use="required" />
<xs:attribute name="type" type="xs:string" use="required" />
<xs:attribute name="isActive" type="xs:boolean" use="required" />
<xs:attribute name="hasManyLocations" type="xs:boolean" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>

== IT Management XML ==

<?xml version="1.0" encoding="utf-8" ?>
<customers>
<customer id="33" type="company" isActive="true" hasManyLocations="true">
<customerName>Elamustevaba OÜ</customerName>
<contactPerson>Juhan Pühamees</contactPerson>
<e-mail>juhan@evaba.com</e-mail>
<phoneNumber>+37256565656</phoneNumber>
<locations>
<location type="office">
<city>Tallinn</city>
<address><![CDATA[Pikk 7, 56401]]></address>
<comment><![CDATA[3. korrus -> paremat kätt]]></comment>
<localContactPerson>Maiu Piimaauto</localContactPerson>
<localPhone>+3726510510</localPhone>
<items>
<item id="1" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="36" isInWorkingCondition="false">
<manufacturer>Dell</manufacturer>
<model>Inspiron 3558</model>
<serialNumber>6FGH5JN</serialNumber>
<dateOfPurchase>2017-07-22</dateOfPurchase>
<operatingSystem version="1709">Windows 10 Home</operatingSystem>
<tickets>
<ticket id="HWI001" issuedIn="2017-11-21" isHandled="true">
<description><![CDATA[Wi-Fi is not working]]></description>
<solution><![CDATA[Wi-Fi card replaced (Under the warranty)]]></solution>
</ticket>
<ticket id="SWI256" issuedIn="2018-05-05" isHandled="false">
<description><![CDATA[Computer keeps showing login screen]]></description>
<solution></solution>
</ticket>
</tickets>
</item>
<item id="55" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="60" isInWorkingCondition="true">
<manufacturer>Dell</manufacturer>
<model>Latitude E7550</model>
<serialNumber>8JGR78U</serialNumber>
<dateOfPurchase>2016-06-15</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Home</operatingSystem>
</item>
</items>
</location>
<location type="store">
<city>Tallinn</city>
<address><![CDATA[Lai 17, 56401]]></address>
<comment><![CDATA[keldrikorrusel]]></comment>
<localContactPerson>Tanja Õielemb</localContactPerson>
<localPhone>+3726510520</localPhone>
<items>
<item id="83" type="desktopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Lenovo</manufacturer>
<model>ThinkCentre M715</model>
<serialNumber>IO25689AD54KL</serialNumber>
<dateOfPurchase>2017-12-01</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Pro</operatingSystem>
</item>
<item id="12" type="monitor" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>AOC</manufacturer>
<model>L456</model>
<serialNumber>9803987YE54</serialNumber>
<dateOfPurchase>2015-05-03</dateOfPurchase>
<tickets>
<ticket id="HWI126" issuedIn="2016-01-18" isHandled="true">
<description><![CDATA[Doesn't work, no picture.]]></description>
<solution><![CDATA[Wasn't plugged in. Technician did it - works again!]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
<customer id="02" type="private" isActive="true" hasManyLocations="false">
<customerName>Kessu Sisselasi</customerName>
<e-mail>kessu@tripp.org</e-mail>
<phoneNumber>+372555555</phoneNumber>
<locations>
<location type="home">
<city>Saue</city>
<address><![CDATA[Kooli 4-8, 78965]]></address>
<comment><![CDATA[2. korrus. Kitsad koridorid.]]></comment>
<items>
<item id="98" type="laptopComputer" isActive="true" isUnderWarranty="true" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Acer</manufacturer>
<model>Aspire 5</model>
<serialNumber>475YRT89K4</serialNumber>
<dateOfPurchase>2018-03-25</dateOfPurchase>
<operatingSystem version="1803">Windows 10 Home</operatingSystem>
</item>
<item id="4" type="laptopComputer" isActive="false" isUnderWarranty="false" warrantyInMonths="36" isInWorkingCondition="true">
<manufacturer>Lenovo</manufacturer>
<model>IdeaPad L530</model>
<serialNumber>U89TRY765ME</serialNumber>
<dateOfPurchase>2007-08-14</dateOfPurchase>
<operatingSystem version="">Windows XP</operatingSystem>
<tickets>
<ticket id="SWI069" issuedIn="2010-01-28" isHandled="true">
<description><![CDATA[Blue screen.]]></description>
<solution><![CDATA[Video driver update.]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
<customer id="26" type="company" isActive="true" hasManyLocations="true">
<customerName>Aktsiaselts OÜ</customerName>
<contactPerson>Gunnar Kuningas</contactPerson>
<e-mail>gunnar@kunn.ee</e-mail>
<phoneNumber>+3726985236</phoneNumber>
<locations>
<location type="office">
<city>Loksa</city>
<address><![CDATA[Kalda 14, 78965]]></address>
<comment><![CDATA[Sissepääs Rimi poolt, helesinine uks]]></comment>
<items>
<item id="26" type="laptopComputer" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="true">
<manufacturer>Apple</manufacturer>
<model>Macbook Air</model>
<serialNumber>258JUY369</serialNumber>
<dateOfPurchase>2017-03-01</dateOfPurchase>
<operatingSystem version="High Sierra">OS X</operatingSystem>
</item>
<item id="59" type="laptopComputer" isActive="true" isUnderWarranty="false" warrantyInMonths="24" isInWorkingCondition="false">
<manufacturer>Acer</manufacturer>
<model>Chromebook 11</model>
<serialNumber>U89TRY765ME</serialNumber>
<dateOfPurchase>2016-04-23</dateOfPurchase>
<operatingSystem version="">Chrome OS</operatingSystem>
<tickets>
<ticket id="HWI046" issuedIn="2010-02-28" isHandled="false">
<description><![CDATA[Stripes on screen]]></description>
<solution><![CDATA[]]></solution>
</ticket>
</tickets>
</item>
</items>
</location>
</locations>
</customer>
</customers>

= Kasutatud kirjandus ja allikad =

1. Albahari, Joseph, Albari, Ben 2017. C# 7.0 in A Nutshell. Sebastopol: O’Reilly 
2. MariaDB Foundation. MariaDB. Kättesaadav:https://mariadb.org/ 
3. Martin, Robert 2018. Clean Architecture. Boston: Pearson Education

Kodutöö aines "Võrgurakendused II: hajussüsteemide ehitamine" 2018

2018-06-07T11:46:52Z

Tkuuskma: /* Kaitsmisele registreerumine */

[[Category: Võrgurakendused II: hajussüsteemide ehitamine]]
__NOINDEX__

=Kodutöö aines "Võrgurakendused II: hajussüsteemide ehitamine" 2018=
==Eesmärk==
Saada praktiline kogemus hajussüsteemide ehitamisest XML(SOAP) või Rest veebiteenusel ja sellele klientrakenduse loomise abil ning süvendada meeskonnatööoskust.
*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.
*REST teenuste loomisel tuleks kasutada ASP.NET Web API2/ASP.NET Core 2.0/WCF võimalusi.

Kaugem eesmärk on loomulikult hinne :).

==Reeglid==
''' Kodutöö koosneb kolmest eraldiseisvast ülesandest:'''
* 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)
* Luua veebiteenus, mis võimaldaks pakkuda teenust, eristada kasutajaid ning näidata teenuse kasutamise statistikat kasutajate ja tegevuste lõikes
* Luua klientrakendus

Ü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.

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.

==Tähtajad==

* '''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]
** 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>'''
** Veebiteenus peab olema valmis, esitatud ja ja wikilehel kirjeldatud hiljemalt '''27. mai 2018'''.
** Retsensioonid veebiteenuste kohta peavad tehtud olema '''03. juuni 2018'''.

* '''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]
** Klientrakendused peavad olema valmis, esitatud ja ja wikilehel kirjeldatud hiljemalt '''27. mai 2018'''.
** Retsensioonid klientrakenduste kohta peavad tehtud olema '''03. juuni 2018'''.

* '''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]
** XML fail, stiilifail ja skeemifail peavad olema valmis ja wikilehel kirjeldatud hiljemalt '''01. juuni 2018'''.
** Retsensioonid XML-failide kohta peavad tehtud olema '''05.juuni 2018'''.

==Hindamine==
===Üldised kriteeriumid===

Teostatuks loetakse projekt juhul, kui lähteülesanne on realiseeritud, lahendus on töötav, kuid esineb suuremaid vigu ning piirsituatsioonidega ei ole arvestatud.

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.

'''Maksimumtulemuse annab (vähemalt 4/7):'''

* Majanduslik mõtlemine (kas loodav teenus ja rakendused oleks kasutatav ka ärilistel eesmärkidel)
* Mobiilirakendused/Angularis/reactis loodud klientrakendus
* Kogukondade kaasamine
* Kasutajamugavus
* Läbimõeldud töökorraldus
* Lisavõimaluste realiseerimine (vt näidisteemad)
* Korraliku arhitektuuriga kirjutatud kood

===XML andmefail===
Ü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.

XML-il peab olema vähemalt 4 loogilist dimensiooni.
<dim1>
<dim2>
<dim3>
<dim4>
</dim4>
</dim3>
</dim2>
</dim1>
Lisaks tuleb kasutada 3-el dimensioonil attribuute, mis one enamat, kui lihtsalt ID.

===Veebiteenus===
Loodav veebiteenus peab võimaldama:
* Teenuse pakkumist
* '''Teenuse kasutajate tuvastamist ning haldamist'''
* Teenuse kasutajate ja kasutusstatistika üle arve pidamist kasutajate lõikes
* Teenuse poole pöördumiste arvu piiramist ja piirangute haldamist.

Loodav veebiteenus peab toetama mitme kasutaja võimalust.

Loodav veebiteenus tuleb luua kasutades ''Windows Communication Foundation'' või ASP.NET MVC Web API tehnoloogiat

Andmebaasis peab olema vähemalt 9 olemit ehk andmebaas on eeldus,

Soovitav on luua teenus (FE) ja teenuse seadistamiseks ning kasutajate haldamiseks mõeldud rakendus (BE).

===Klientrakendus===
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)

Variant1: teha klientrakendus enda loodud veebiteenusele

Variant2: teha klientrakendus mõnele levinud veebiteenusele.
Näiteks:
* http://www.bing.com/developer
* http://www.flickr.com/services/api/response.soap.html
* http://developer.ebay.com/developercenter/windows/
* http://apiwiki.twitter.com/Getting-Started

===Retsensioonid===
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.

Retsensioon peab sisaldama minimaalselt...
* XML - ...200 sõna.
* Veebiteenus - ...600 sõna.
* Klientrakendus - ...600 sõna.

Mõnelauselisest arvamusest ei piisa, kuna tegemist on grupi loodavate arvustustega, mitte individuaalsete arvustustega.

==Konsultatsioonid==
Igal projektimeeskonnal on piiramatu õigus saada õppejõu käest konsultatsiooni ja juhendamist oma
töö tegemiseks, kas harjutuste ajal või pärast harjutusi ja loenguid. Eriaegade suhtes saab sõlmida
õppejõuga kokkuleppeid kontaktidel
mait.poska [ät] itcollege.ee või (+372 53 469 734)
(teksti originaalautor Priit Raspel)

==Kaitsmisele registreerumine==
Kaitsmisele tuleks registreerida järjest(st iga järgmine lisab vajaliku 15min ajaakna) ja suvalisis kellaaegasid ei hakka kuhugi vahele kirjutama

'''05.06.2018'''
*15:00 - Miisiks
*15:15 - Maagikud
*15:30 - GoFood
*15:45 - Raavo V2™
*16:00 - LearnToDrive
Sellele päevale rohkem aegu juurde lisada ei saa

Allpool olevate päevadele võib vabalt aegasid juurde lisada 15min sammga. Reegel on, et aegu lisame järjest

'''06.06.2018'''
*17:00 - Raamaturiiul
*17:15 - Pakiraam
*..

'''09.06.2018'''
*16:00 - Triin Oja
*16:15 - Beer Pressure
*16:30 - <div>
*16:45 - NutriCheck
*17:00 - JääTuli
*17:15 - Ophelia
*17:30 - Kuldne Loojang
*17:45 - Hammas
*18:00 - VariousArtists
*18:15 - Pillar Of Autumn
*18:30 - Curry
*18:45 - WatchWinders

=Teemad 2018 kevad=
''' Kodutöö koosneb kolmest eraldiseisvast ülesandest:'''
* 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)
* Luua veebiteenus, mis võimaldaks pakkuda teenust, eristada kasutajaid ning näidata teenuse kasutamise statistikat kasutajate ja tegevuste lõikes
* Luua klientrakendus mõnele olemasolevale või endaloodud veebiteenusele

NB! XML andmefail ja veebiteenus ei pea olema omavahel seotud.

==Näidisteemad==

====Ülesanne====
Luua sobiva alguse järgi nimede pakkumise teenus:
* alates kahetähelisetest algustest pakkuda sobivad nimesid
* luua võimalus kasutajatel nimesid lisada
* luua võimalus administraatoril nimesid muuta/kustutada
* meeste ja naiste nimed peavad olema süsteemis eristatavad
* luua võimalus, mis võimaldab kuvada populaarseid nimesid
* luua võimalus ühele kasutajale (või erinevatele kasutajagruppidele) maksimumpäringute hulga määramiseks
* luua võimalus, et nimi lisatakse baasi alles siis, kui administraatori õigustega inimene on selleks vastava loa andnud

===Külastusstatistika teenus===
Mõte selles, et pakkuda teenust, kus kasutajal on võimalik registreerida külastused ning küsida oma külastusstatistikat.

====Ülesanne====
Luua külastusstatistika teenus:
* kasutaja saab teenuses registreerida külastusi
* kasutaja saab küsida külastusstatistikat päevade/kuude/kogu perioodi lõikes
* luua võimalus ühele kasutajale (või erinevatele kasutajagruppidele) maksimumpäringute hulga määramiseks

Lisavõimalused:
* luua võimalus registreerida alamlehtede külastusstatistikat
* luua võimalus külastusstatistikale lisaparameetrite lisamiseks (ip aadress, sirviku versioon jne)

===Telefoniraamatu teenus===
Mõte selles, et kasutaja saab teenuse abil salvestada kontakte ja nende seast otsida

====Ülesanne====
Luua telefoniraamatu teenus:
* kasutaja saab teenuses kontakte lisada ja kustutada
* kasutaja saab kontaktide nime/telefoninumbri jne abil otsida
* luua võimalus ühele kasutajale (või erinevatele kasutajagruppidele) maksimumpäringute hulga määramiseks
* kasutajaid on võimalik lisada gruppidesse
* kasutajal on võimalik lisada vajalike kontaktandmete liike
* kasutajatel on võimalik jagada omavahel kontakte ja kontaktide grupper

===RSS voogude kogumise ja uudiste kuvamise teenus===
Mõte selles, et kasutaja saab teenuse abil salvestada talle huvipakkuvaid RSS vooge ja nendelt voogudelt uudiseid lugeda

====Ülesanne====
Luua RSS voogude haldusteenus:
* kasutaja saab teenuses RSS vooge lisada ja kustudada
* kasutaja saab pärida talle huvipakkuvate voogude viimaseid uudiseid
* luua võimalus ühele kasutajale (või erinevatele kasutajagruppidele) maksimumpäringute hulga määramiseks
* kasutaja saab RSS vooge vaadata eraldi või grupeeritult
* vooge peab puhverdama, kuna voogude lugemine võtab enamasti üsna palju aega
*

= Meeskonnad 2018=
==Päevaõpe==

===[https://wiki.itcollege.ee/index.php/HairSaloon Meeskond: HairSaloon]===
Liikmed:
* Kaido Henrik Elias
* Arvo Paomees

===[https://wiki.itcollege.ee/index.php/VariousArtists Meeskond: VariousArtists]===
Liikmed:
* Ruudi Vinter
* Madis Roosioks
* Pavel Fleišer

===[https://wiki.itcollege.ee/index.php/Maagikud Meeskond: Maagikud]===
Liikmed:
*Kristina Rästas
*Simo Jaanus
*Artur Tammiste
*Rauno Lõhmus
Lõpptoote [http://enos.itcollege.ee/~sjaanus/c/Airport_solution.zip link]

Veebiteenuse ja klientrakenduse retsensioon tiimile Raavo V2 asub [https://docs.google.com/document/d/1fxmdLa94Do1u5WlmPQjSd4mMmdbDw5WmDne547jqQc4/edit siin]

XML retsensioon tiimile LTD asub [https://docs.google.com/document/d/15rMhpqyG5XHsvOCZJp88ucHkiMa5Non6BbYwBBKT2_Y/edit siin]

===[https://wiki.itcollege.ee/index.php/RaamatuRiiul Meeskond: RaamatuRiiul]===
Liikmed:
* Alo Avi
* Arnika Rästa
* Marite Rammo
'''Meie XML:''' [https://wiki.itcollege.ee/index.php/RaamatuRiiul#XML XML]

'''Meie veebiteenuse, klientrakenduse ja XML retsensioonid meeskonnale Miisiiks:''' [https://wiki.itcollege.ee/index.php/Talk:Miisiiks retsensioonid]

'''Meie veebiteenus ning klientrakendus.''' [https://www.dropbox.com/s/ugbvx4j4zdlbp68/RaamatuRiiul.7z?dl=0 Zip]

===[https://wiki.itcollege.ee/index.php/Autolugu Meeskond: Autolugu]===
Liikmed:
* Margus Põlma
* Karl Erik Õunapuu

===[https://wiki.itcollege.ee/index.php/VRII2018 Meeskond: VRII2018]===
Liikmed:
* Kaspar Kaal
* Teet Adamson
* Rahel Kangur

===[https://wiki.itcollege.ee/index.php/Meeskond_Raavo_V2%E2%84%A2 Meeskond: Raavo V2™]===
Liikmed:
* Peeter Fridolin
* Kristo Leesmann
* Rando Rommot

Projekti retsensioon meeskonnale [https://wiki.itcollege.ee/index.php/Meeskond_Raavo_V2™#Retsentsioonid Maagikud]

===[https://wiki.itcollege.ee/index.php/Pillarofautumn Meeskond: Pillar of Autumn ]===
Liikmed:
* Taavi Põder
* Taavi Vesinurm (Meeskonnast lahkunud)
* Raido Vell

===[https://wiki.itcollege.ee/index.php/jaatuli Meeskond: JääTuli]===
Liikmed:
*Tarmo Luugus
*Leho Kivistik
*Hannes Mäeorg
*Marten Tammeleht

===[https://wiki.itcollege.ee/index.php/JustABot Meeskond: JustABot]===
Liikmed:
*Argo Hansen

===[https://wiki.itcollege.ee/index.php/Meeskond_Pakiraam Meeskond: Pakiraam]===
Liikmed:
*Kristo Naeris
*Indro Kottise

Klientrakendus [https://github.com/knaeris/VR2Klient siin] ja veebiteenus [https://github.com/knaeris/VR2Projekt siin]

Retsensioon meeskonna Raavo v2 klientrakendusele : [https://wiki.itcollege.ee/index.php/Meeskond_Pakiraam#Retsensioonid Retsensioon]

Retsensioon meeskonna Raavo v2 veebiteenusele:

===[https://wiki.itcollege.ee/index.php/GoFood Meeskond: GoFood]===
Liikmed:

* Rando Kurel
* Henrik Prangel
* Markus Mänd
* Edgar Tereping
* Jane Kaldma

Lõpptoode: [https://wiki.itcollege.ee/index.php/GoFood#Projektikood lõpptoote leiab siit]

Meie rühma kirjutatud retsentsioonid rühmale Maagikud:[https://wiki.itcollege.ee/index.php/GoFood#Retsensioon_rühmale_Maagikud Retsensioon]

===[https://wiki.itcollege.ee/index.php/LTD Meeskond: LearnToDrive]===
'''Liikmed:'''
*Eve Ormisson
*Carlos Kirtsi

Projekt [https://wiki.itcollege.ee/index.php/LTD#Kood_ise asub siin, kliendina kasutame JustInCaseWPFi]

Projekti retsensioon meeskonnale [https://wiki.itcollege.ee/index.php/LTD#Projekti_retsensioon Maagikud]

XML osa retsensioon meeskonnale [https://wiki.itcollege.ee/index.php/LTD#XML_retsensioon RaamatuRiiul]

===[https://wiki.itcollege.ee/index.php/Miisiiks Meeskond: Miisiiks]===
Liikmed:
*Christo Aruste
*Heleriin Malkov
*Tõnis Prants

[https://www.dropbox.com/s/e2vu3ukgckyc2x5/MiisiiksWS.zip?dl=0 Veebiteenus]

Veebiteenus v2 (05.06): [https://www.dropbox.com/s/4acyvc9c7h08xl6/MiisiiksWS-v2.rar?dl=0 Veebiteenus]

[https://www.dropbox.com/s/iwtheohp5mn0lek/MiisiiksC.zip?dl=0 Klientrakendus]

Klientrakendus v2 (05.06): [https://www.dropbox.com/s/m6ijv2yyqthebgr/MiisiiksC2-v2.rar?dl=0 Klientrakendus]

[https://wiki.itcollege.ee/index.php/Miisiiks#XML XML]

Retsensioonid meeskonnale Raavo V2™

Veebiteenus: [https://wiki.itcollege.ee/index.php/Miisiiks#Veebiteenuse_retsensioon Retsensioon]

Klientrakendus: [https://wiki.itcollege.ee/index.php/Miisiiks#Klientrakenduse_retsensioon Retsensioon]

XML: [https://wiki.itcollege.ee/index.php/Miisiiks#XML_retsensioon XML]

===[https://wiki.itcollege.ee/index.php/VR2_div Meeskond: <div>]===
Liikmed:
*Kaarel Pärtel
*Marek Juhanson
*Kai Kallastu

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]

==Kaugõpe==

===[https://wiki.itcollege.ee/index.php/BestInShow Meeskond: BestInShow]===
Liikmed:
* Liina Abner
* Marju Pütsepp
* Liisi Taimre

Lõpptoode veebiteenus: TODO 
Lõpptoode klient: TODO 
XML failid: [https://wiki.itcollege.ee/index.php/BestInShow#XML_failid Schema, XML ja XSLT HTML ja XML transformatsiooniks] 
Retsensioon veebiteenusele: TODO 
Retsensioon klientrakendusele: TODO 
Retsensioon XML-ile: TODO 

===[https://wiki.itcollege.ee/index.php/WatchWinders Meeskond: WatchWinders]===
Liikmed:
* Toomas Juhkov
* Kunnar Kukk
* Tiit Kuuskmäe

===[[ Kuldneloojang | Meeskond: Kuldne loojang]]===
'''Liikmed''':
* Andrus Seiman
* Marko Belzetski
* Priit Tiganik
* Kristjan Peterson (loobus)

'''Lõpptoode:'''
algselt üles laetud 02.06.2018, bugide parandusi lisatud 04.06.2018
* .zip fail rakendus ja klient koos: https://www.dropbox.com/s/4h9bvq4k6388fmo/loojang.zip?dl=0
* veebirakenduse repo: https://bitbucket.org/itcollegeprojects/loojang-app
* klientrakenduse repo: https://bitbucket.org/itcollegeprojects/loojang-client
* XML: [https://wiki.itcollege.ee/index.php/Kuldneloojang#XML_.C3.BClesande_kirjeldus link meie Wiki lehele]

'''Retsensioonid:'''
* TODO

===[https://wiki.itcollege.ee/index.php/Ophelia Meeskond: Ophelia]===
Liikmed:
* Siim Kallari
* Andres Kepler (loobus)
* Jorma Rebane

[https://www.dropbox.com/s/v63fkbjnd5umqqm/Ophelia.zip?dl=0 Lõpptoote link]

[https://wiki.itcollege.ee/index.php/Ophelia#L.C3.B5pptoote_kasutusjuhend Kasutusjuhend(Kaasas ka lõpptootes)]

[https://wiki.itcollege.ee/index.php/Ophelia#XML_.C3.9Clesanne XML Ülesanne]

===[https://wiki.itcollege.ee/index.php/SharpRestoVRII Meeskond: SharpRestoVRII]===
Liikmed:
* Andres Aava (lahkunud liige)
* Henri Annilo
* Jaan Koolmeister
* Lauri Üksti

Lähtekood: [http://enos.itcollege.ee/~luksti/CSharp/CSharpResto.zip CSharpResto]

Retsensioonid:

===[https://wiki.itcollege.ee/index.php/BeerPressure Meeskond: BeerPressure]===
Liikmed:
* Sigrid Aasma
* Evelin Jõgi
* Martin Kask
* Marko Nõu
'''Projekt:''' [https://github.com/sikumiku/TaisKohtApi TaisKohtApi]

'''Lõpptoode:''' [https://github.com/sikumiku/TaisKohtApi/archive/61438e187a1a972410c8a3bc6274d69489d00aa6.zip GitHub commit]

'''XML:''' [https://wiki.itcollege.ee/index.php/BeerPressure#XML.2FXSD.2FXSLT Beer Pressure XML/XSD/XSLT]

'''Meie kirjutatud XML failide retsensioon:''' [https://wiki.itcollege.ee/index.php/Talk:MOT#XML_retsensioon_by_meeskond_BeerPressure: Team MOT retsensioon]

'''Meie kirjutatud veebiteenuse retsensioon:''' [https://wiki.itcollege.ee/index.php/Talk:MOT#Veebiteenuse_retsensensioon_by_meeskond_BeerPressure: Team MOT retsensioon]

'''Meie kirjutatud klientrakenduse retsensioon:''' [https://wiki.itcollege.ee/index.php/Talk:Kuldneloojang#Klientrakenduse_retsensensioon_by_meeskond_BeerPressure: Team Kuldneloojang retsensioon]

===[[ Memorize | Meeskond: Memorize]]===
Liikmed:
* Madis Uudam
* Olle Mikk

===[https://wiki.itcollege.ee/index.php/UCanDo Meeskond: UCanDo]===
Liikmed:
* Mart Raus
* Ando Kiidron
* Liina Saar

===[https://wiki.itcollege.ee/index.php/MOT Meeskond: MOT]===
Liikmed:
* Merike Meizner
* Helen Oppar (loobus)
* Hardi Tiitus

'''Lõpptoode: ''' http://enos.itcollege.ee/~mmeizner/MOT/ 
'''Meie kirjutatud veebiteenuse, klientrakenduse ja XML'i retsensioon:''' [https://docs.google.com/document/d/16WL12wmvQ_TPcY_-4pG_kjwtstQoX5meEYcigE4Febw/edit?usp=sharing: Team Raavo V2]

===[https://wiki.itcollege.ee/index.php/Meeskond:_MealPlanner Meeskond: MealPlanner]===
Liikmed:
*Triin Oja
*Rein Remsu

===[https://wiki.itcollege.ee/index.php/Meeskond:Curry Meeskond: Curry]===
Liikmed:
* Rain Elken
* Peeter Ploom

===[https://wiki.itcollege.ee/index.php/Hammas Meeskond: Hammas]===

Liikmed:
* Sten Lunden

'''Lõpptoode:''' [https://ildtest.azurewebsites.net azure]
 
'''Projekt:''' [https://github.com/lundens/ild-core github]
 
'''XML''' [https://wiki.itcollege.ee/index.php/Hammas#XML wiki]
 
'''Veebiteenuse retsensioon''' meeskonnale [https://wiki.itcollege.ee/index.php/Hammas#Veebiteenuse_retsensioon_meeskonnale_GoFood GoFood]
 
'''Klientrakenduse retsensioon''' meeskonnale [https://wiki.itcollege.ee/index.php/Hammas#Klientrakenduse_retsensioon_meeskonnale_GoFood GoFood]
 
'''XML retsensioon''' In progress

===[https://wiki.itcollege.ee/index.php/LabLite Meeskond: LabLite]===
Liikmed:
* Alex Kaska

===[https://wiki.itcollege.ee/index.php/AmateurBB Meeskond: AmateurBB]===
Liikmed:
*Taavi Kivimaa

===[https://wiki.itcollege.ee/index.php/MealPlannerSolo Meeskond: MealPlannerSolo]===
Liikmed:
*Triin Oja
'''[https://wiki.itcollege.ee/index.php/MealPlannerSolo#XML_andmefail XML]'''
 
'''[http://enos.itcollege.ee/~troja/VRII2018/ Veebiteenus ja klientrakendus]'''

===[https://wiki.itcollege.ee/index.php/NutriCheck Meeskond: NutriCheck]===
Liikmed:
*Artyom Likhachev

WatchWinders

2018-05-28T16:02:01Z

Tkuuskma: /* Minimum Viable Product definitsioon */

File:Ww andmemudel 06052018.png

2018-05-06T07:30:42Z

Tkuuskma:

WatchWinders

2018-05-06T07:30:28Z

Tkuuskma: /* Andmemudel */

WatchWinders

2018-05-06T07:29:16Z

Tkuuskma: /* Tegevuste logi */

WatchWinders

2018-03-30T07:19:56Z

Tkuuskma: /* Tegevuste logi */

WatchWinders

2018-03-30T07:18:52Z

Tkuuskma: /* Andmemudel */

File:TimeBoxLabDbStructure ver11.2.png

2018-03-29T06:45:55Z

Tkuuskma: Tkuuskma uploaded a new version of File:TimeBoxLabDbStructure ver11.2.png

File:TimeBoxLabDbStructure ver11.2.png

2018-03-29T06:45:05Z

Tkuuskma:

WatchWinders

2018-03-29T06:44:44Z

Tkuuskma: /* Andmemudel */

WatchWinders

2018-03-29T06:44:18Z

Tkuuskma: /* Tegevuste logi */

WatchWinders

2018-03-22T19:36:48Z

Tkuuskma: /* Tegevuste logi */

WatchWinders

2018-03-22T19:36:36Z

Tkuuskma: /* Tegevuste logi */

Kodutöö aines "Võrgurakendused II: hajussüsteemide ehitamine" 2018

2018-03-22T07:28:42Z

Tkuuskma: /* Kaugõpe */

WatchWinders

2018-03-18T16:51:00Z

Tkuuskma: /* Tegevuste logi */

File:Watchwindersdb9.png

2018-03-18T16:48:36Z

Tkuuskma:

WatchWinders

2018-03-18T16:48:06Z

Tkuuskma: /* Andmemudel */

WatchWinders

2018-03-11T10:48:04Z

Tkuuskma: /* Tegevuste logi */

WatchWinders

2018-03-06T19:12:08Z

Tkuuskma: /* Tegevuste logi */

WatchWinders

2018-03-06T19:11:32Z

Tkuuskma: /* Tegevuste logi */

File:WatchWindersdb.png

2018-03-06T07:08:28Z

Tkuuskma:

WatchWinders

2018-03-06T07:08:13Z

Tkuuskma: /* Andmemudel */

WatchWinders

2018-03-06T07:07:48Z

Tkuuskma: /* Tegevuste logi */

WatchWinders

2018-03-02T09:44:14Z

Tkuuskma: /* Minimum Viable Product definitsioon */

WatchWinders

2018-03-02T09:29:02Z

Tkuuskma: /* Lahendus */