Backbone: Difference between revisions

From ICO wiki
Jump to navigationJump to search
Slumi (talk | contribs)
Slumi (talk | contribs)
Line 347: Line 347:


Veebiteenuse eesmärk on pakkuda teenust eespool kirjeldatud TODO projektile.
Veebiteenuse eesmärk on pakkuda teenust eespool kirjeldatud TODO projektile.
Teenuse loomisel kasutame sobivaid arendusmustreid ning ASP.NET MVC Web API tehnoloogiat.
Teenuse loomisel kasutatakse sobivaid arendusmustreid ning ASP.NET MVC Web API tehnoloogiat.
Teenus implmementeerib meetoid, mis suhtlevad andmebaasiga ning viivad andmetesse sisse äriloogilisi muudatusi.
Teenus implmementeerib meetoid, mis suhtlevad andmebaasiga ning viivad andmetesse sisse äriloogilisi muudatusi.
Võimalikult suur osa äriloogikast baseerub APIs.
Võimalikult suur osa äriloogikast baseerub APIs.


=Veebirakenduse käitumine=
=Veebirakenduse käitumine=

Revision as of 20:46, 28 March 2015

Backbone

Aine koduleht asub Siin!

Meeskonna liikmed

  • Mikk Visnap
  • Silver Lumi

XML-i töö retsensioon meeskonnale "SAVI"

Meeskond "SAVI" XML failide sisu leiab SIIT!


Meeskond "Savi" on koostanud XML skeemi kiirtoidu restorani menüü struktuurist. Esitatud on kõik nõutud failide sisud ja XML struktuur sisaldab vähemalt 4 loogilist dimensioon, seega vastab töö nõuetele.

Eraldi oleks võinud olla esitatud ka failid hõlbsustamaks transformatsioonide käivitamist, kuna transformatsioonide tulemused polnud eraldi väljatoodud.

XML skeem on väga lihtne. Hästi on kasutatud komplekstüüpe, millega on üldistatud hinna- ja suurusetüüpi muutujad. Tekstiliste muutujate puhul võiks kasutada CDATA süntaksit edastamaks sisulist informatsiooni, et vältida võimalikke reserveeritud märkide parsimise vigu.

Transformatsiooni failid annavad hästi edasi XML struktuuris toodud sisu.

Kokkuvõttes saab öelda, et kõik vajalik on olemas ja arusaadav. Hinnang tööle on positiivne.

XML andmefail

Kõik alltoodud XML kodutöö failid saab alla laadida siit


XML fail

<?xml version="1.0" encoding="utf-8" ?>
<sales>
  <sale id="1000">
    <saleHeader>
      <saleDate>2015-01-04</saleDate>
      <totalAmount>5000</totalAmount>
      <vatAmount percentage="20">4166</vatAmount>
      <salesPerson personId="6"><![CDATA[Silver Lumi]]></salesPerson>
      <client clientId="987"><![CDATA[Federico Garcia Lorca]]></client>    
    </saleHeader>
    <saleRows>
      <saleRow rowNumber="1">
        <product id="12345" unit="kg" quantity="200" value="500" currency="EUR" conversionToEur="1.0"><![CDATA[Ham]]></product>
      </saleRow>
      <saleRow rowNumber="2">
        <product id="54321" unit="kg" quantity="100" value="2500" currency="EUR" conversionToEur="1.0"><![CDATA[Cheese]]></product>
      </saleRow>
      <saleRow rowNumber="3">
        <product id="98521" unit="g" quantity="750" value="55" currency="EUR" conversionToEur="1.0"><![CDATA[Sugar]]></product>
      </saleRow>
      <saleRow rowNumber="4">
        <product id="1112" unit="liter" quantity="47" value="1999" currency="EUR" conversionToEur="1.0"><![CDATA[Olive oil]]></product>
      </saleRow>
    </saleRows>
  </sale>
  <sale id="1001">
    <saleHeader>
        <saleDate>2015-01-04</saleDate>
        <totalAmount>19000</totalAmount>
        <vatAmount percentage="20">15833</vatAmount>
        <salesPerson personId="7"><![CDATA[Mait Poska]]></salesPerson>
        <client clientId="885"><![CDATA[Jose Lopez Añudo]]></client>   
    </saleHeader>
    <saleRows>
      <saleRow rowNumber="1">
        <product id="5147" unit="g" quantity="125" value="19" currency="EUR" conversionToEur="1.0"><![CDATA[Chocolate]]></product>
      </saleRow>
      <saleRow rowNumber="2">
        <product id="5151" unit="kg" quantity="25" value="250" currency="EUR" conversionToEur="1.0"><![CDATA[Butter]]></product>
      </saleRow>
      <saleRow rowNumber="3">
        <product id="1112" unit="liter" quantity="50" value="2050" currency="EUR" conversionToEur="1.0"><![CDATA[Olive oil]]></product>
      </saleRow>
    </saleRows>
  </sale>
  <sale id="1002">
    <saleHeader>
        <saleDate>2015-01-05</saleDate>
        <totalAmount>749</totalAmount>
        <vatAmount percentage="20">624</vatAmount>
        <salesPerson personId="1"><![CDATA[Mati Mäeots]]></salesPerson>
        <client clientId="885"><![CDATA[Mario Vargas Llosa]]></client>   
    </saleHeader>
    <saleRows>
      <saleRow rowNumber="1">
        <product id="4444" unit="kg" quantity="51" value="1" currency="EUR" conversionToEur="1.0"><![CDATA[Sugar]]></product>
      </saleRow>
       <saleRow rowNumber="2">
        <product id="6666" unit="kg" quantity="750" value="2500" currency="EUR" conversionToEur="1.0"><![CDATA[Ketchup]]></product>
      </saleRow>
    </saleRows>
  </sale>
  <sale id="1003">
    <saleHeader>
      <saleDate>2015-01-05</saleDate>
      <totalAmount>749</totalAmount>
      <vatAmount percentage="20">624</vatAmount>
      <salesPerson personId="1"><![CDATA[Mikk Visnap]]></salesPerson>
      <client clientId="885"><![CDATA[Some One]]></client>
    </saleHeader>
    <saleRows>
      <saleRow rowNumber="1">
        <product id="4444" unit="kg" quantity="10" value="10" currency="USD" conversionToEur="1.5"><![CDATA[Sugar]]></product>
      </saleRow>
      <saleRow rowNumber="2">
        <product id="4444" unit="kg" quantity="10" value="10" currency="SEK" conversionToEur="2"><![CDATA[Sugar]]></product>
      </saleRow>
    </saleRows>
  </sale>
</sales>

XML skeemifail

<?xml version="1.0" encoding="utf-8"?>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:element name="sales">
    <xs:complexType>
      <xs:sequence>
        <xs:element maxOccurs="unbounded" name="sale">
          <xs:complexType>
            <xs:sequence>
              <xs:element name="saleHeader">
                <xs:complexType>
                  <xs:sequence>
                    <xs:element name="saleDate" type="xs:date" />
                    <xs:element name="totalAmount" type="xs:decimal" />
                    <xs:element name="vatAmount">
                      <xs:complexType>
                        <xs:simpleContent>
                          <xs:extension base="xs:unsignedShort">
                            <xs:attribute name="percentage" type="xs:unsignedByte" use="required" />
                          </xs:extension>
                        </xs:simpleContent>
                      </xs:complexType>
                    </xs:element>
                    <xs:element name="salesPerson">
                      <xs:complexType>
                        <xs:simpleContent>
                          <xs:extension base="xs:string">
                            <xs:attribute name="personId" type="xs:unsignedInt" use="required" />
                          </xs:extension>
                        </xs:simpleContent>
                      </xs:complexType>
                    </xs:element>
                    <xs:element name="client">
                      <xs:complexType>
                        <xs:simpleContent>
                          <xs:extension base="xs:string">
                            <xs:attribute name="clientId" type="xs:unsignedInt" use="required" />
                          </xs:extension>
                        </xs:simpleContent>
                      </xs:complexType>
                    </xs:element>
                  </xs:sequence>
                </xs:complexType>
              </xs:element>
              <xs:element name="saleRows">
                <xs:complexType>
                  <xs:sequence>
                    <xs:element maxOccurs="unbounded" name="saleRow">
                      <xs:complexType>
                        <xs:sequence>
                          <xs:element name="product">
                            <xs:complexType>
                              <xs:simpleContent>
                                <xs:extension base="xs:string">
                                  <xs:attribute name="id" type="xs:unsignedInt" use="required" />
                                  <xs:attribute name="unit" type="xs:string" use="required" />
                                  <xs:attribute name="quantity" type="xs:decimal" use="required" />
                                  <xs:attribute name="value" type="xs:decimal" use="required" />
                                  <xs:attribute name="currency" type="xs:string" use="required" />
                                  <xs:attribute name="conversionToEur" type="xs:decimal" use="required" />
                                </xs:extension>
                              </xs:simpleContent>
                            </xs:complexType>
                          </xs:element>
                        </xs:sequence>
                        <xs:attribute name="rowNumber" type="xs:unsignedByte" use="required" />
                      </xs:complexType>
                    </xs:element>
                  </xs:sequence>
                </xs:complexType>
              </xs:element>
            </xs:sequence>
            <xs:attribute name="id" type="xs:unsignedShort" use="required" />
          </xs:complexType>
        </xs:element>
      </xs:sequence>
    </xs:complexType>
  </xs:element>
</xs:schema>

XSLT failid

Kuvab kõik XML failis toodud müügid ning müügiarve read

<?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>All Sales</title>
      </head>
      <body>
        <h1>All Sales</h1>
        <xsl:for-each select="sales/sale">
            <h2>Client: 
              <xsl:value-of select="saleHeader/client"/>
            </h2>
            <h3>Sales rep: 
              <xsl:value-of select="saleHeader/salesPerson"/>
            </h3>
            <ol>
              <xsl:for-each select="saleRows/saleRow">
                <li>
                  <xsl:text>Sale of </xsl:text>
                  <xsl:value-of select="product/@quantity"/>
                  <xsl:text> </xsl:text>
                  <xsl:value-of select="product/@unit"/>
                  <xsl:text> of </xsl:text>
                  <xsl:value-of select="product"/>
                  <xsl:text> @ </xsl:text>
                  <xsl:value-of select="product/@value"/>
                  <xsl:text> </xsl:text>
                  <xsl:value-of select="product/@currency"/>
                  <xsl:text>/</xsl:text>
                  <xsl:value-of select="product/@unit"/>
                  <xsl:text>. Sale value </xsl:text>
                  <xsl:value-of select="product/@value * product/@quantity"/>
                  <xsl:text> </xsl:text>
                  <xsl:value-of select="product/@currency"/>
                  <xsl:text>.</xsl:text>
                </li>
              </xsl:for-each>
              <br />
              <br />
            </ol>
        </xsl:for-each>
      </body>
    </html>
  </xsl:template>
</xsl:stylesheet>



Otsib XML'ist välja need müügid, milles esines toode "SUGAR" ja kuvab need müügid

<?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>SEARCH RESULTS</title>
          <style type="text/css">
           table {
            text-align: left;
            }            
          </style>
        </head>
        <body>
          <table>
            <tr>
              <th colspan="2" style="color:blue">SEARCH RESULTS</th>              
            </tr>
            <tr>
              <th colspan="2" style="border-bottom:1px dotted black">showing all the sales where SUGAR was one of the components</th>
            </tr>
            <tr>
              <th colspan="2"> </th>
            </tr>
                <xsl:for-each select="sales/sale[saleRows/saleRow/product[string(.)='Sugar']]">

                  <tr>
                    <th>Sales Date</th>
                    <td><xsl:value-of select="saleHeader/saleDate"/></td>                    
                  </tr>
                  <tr>
                    <th>Salesperson</th>
                    <td>
                      <xsl:value-of select="saleHeader/salesPerson"/>
                    </td>
                  </tr>
                  <tr>
                    <th>Client</th>
                    <td>
                      <xsl:value-of select="saleHeader/client"/>
                    </td>
                  </tr>
                  
                  <xsl:for-each select="saleRows/saleRow">
                    <tr>
                      <th>Product <xsl:value-of select="@rowNumber"/>
                    </th>
                      <td><xsl:value-of select="product"/></td>
                    </tr>                    
                  </xsl:for-each>
                  <tr>
                    <th colspan="2" style="background-color:red"></th>
                  </tr>
                  <tr>
                    <th colspan="2"> </th>
                  </tr>
                </xsl:for-each>             
          </table>          
        </body>
      </html>
    </xsl:template>
</xsl:stylesheet>

Veebiteenuse analüüs

Teostatava projekti kirjeldus

Projekti eesmärgiks on luua rakendus, mis tuletab töötajatele meelde tähelepanu vajavaid tööülesandeid.


Tööülesanded on vastava rolli poolt konfigureeritavad läbi järgmiste dimensioonide:

  1. Prioriteet
  2. Kategooria
  3. Asukoht
  4. Korduse intervall
  5. Kellaaegade vahemik
  6. Nädalapäevad

Tööülesandeid kuvatakse töötajatele nö TODO vaates, kus näidatakse hetkel aktiivsed (tegemata) ülesanded, reastatuna prioriteedi ning hilinemise mahu järgi (täitmiseks jäänud aeg). Tööülesande teostamise järel märgib töötaja ülesande teostatuks, valides ülesande juures olevast nimekirjast oma nime. Rakenduses implementeeritakse kasutajate ning rollide haldus. Kasutajale saab määrata 0--* rolli. Rollid määravad ära ligipääsuõigused rakenduse eri osadele.

Veebirakenduse kirjeldus


Veebiteenuse eesmärk on pakkuda teenust eespool kirjeldatud TODO projektile. Teenuse loomisel kasutatakse sobivaid arendusmustreid ning ASP.NET MVC Web API tehnoloogiat. Teenus implmementeerib meetoid, mis suhtlevad andmebaasiga ning viivad andmetesse sisse äriloogilisi muudatusi. Võimalikult suur osa äriloogikast baseerub APIs.

Veebirakenduse käitumine

Klientrakendus teeb regulaarseid päringuid, et hoida kuvatav informatsioon värskena. Regulaarsete päringute lubatud tihedus on piiratud veebirakenduse poolt, kuid tegelik päringute tihedus on määratletud klientrakenduses.

Regulaarsete päringute puhul rakendab API puhverdamist, vältimaks üleliigseid uuesti arvutustegevusi, kui see pole vajalik.

Veebirakenduse poole pöördudes peab pöördumises sisalduma API võti mille alusel kasutaja indentifitseeritakse ning statistikat luuakse.

Veebiteenuse võimalused

Teenuse konfigureerimsieks ning statistika jälgimiseks loome API-le BE(Back End-i) ning ka lihtsa FE(Front End-i) hõlbsustamaks API kasutamist ning kasutajate BE-le ligipääsu võimaldamiseks.

FE võimaldab järgnevat:

  1. Erinevate kasutajate autentimist ja rollide järgi BE toimingute lubamist
  2. Kuvab avalikke API meetodeid ja kirjeldab nende kasutamist

BE võimaldab:

  1. Teenuse kasutajate(API poole pöördujate) tuvastamist ning haldamist
  2. Teenuse kasutajate ja kasutusstatistika üle arve pidamist kasutajate lõikes
  3. Teenuse poole pöördumiste arvu piiramist ja piirangute haldamist

Veebiteenuses implementeeritavad meetodid

MUST HAVE meetodid on need, mis tagavad meie klientrakenduse core funktsionaalsuse. Klientrakenduse ADMIN rollis kasutajad pöörduvad API poole:

  1. addReminderTemplate()
  2. updateReminderTemplate()
  3. addPriority()
  4. updatePriority()
  5. addLocation()
  6. updateLocation()
  7. addSchedule()
  8. updateSchedule()
  9. addReminder()
  10. updateReminder()


USER

  • getActiveReminders()
    • arvutab uuesti aktiivsete reminderite nimekirja ning lisab vajadusel uued reminderid
    • tagastab aktiivsete reminderite nimekirja


  • markReminderCompleted()
    • märgib valitud reminderi teostatuks, lisaks salvestab valitud töötaja ja tegevuse toimumise aja


BACKBONE API andmebaasi äriloogiline struktuur

BACKBONE andmebaasi struktuur

Veebiteenus

Klientrankendus

To-do