Autoparandaja

From ICO wiki
Jump to navigationJump to search

Meeskond ja rollid

  • Mihkel Viilveer - Kokk-kondiiter-keevitaja

Idee

Lihtsamat sorti veebirakendus, kuhu on võimalik registreerida ettevõtteid, mis tegelevad autoremondiga. Tegu on broneerimiskeskkonnaga, kuhu ettevõtte omanikud saavad sisestada vabu aegu ning kliendid (saidi külalised) saavad neid broneerida.

Analüüs

Süsteemne teave

Rakendus on ehitatud C# keeles, kasutatakse ASP.NET raamistikku. Kasutajaliides on HTMLis, liikuvad vidinad Javascript(jQuery library) keeles ning stiilitakse CSSiga (kasutatakse Bootstrap 3 raamistikku). Andmeid hoitakse MSSQLis ning päringukeeleks on LinQ. Andmemudeli loomisel kasutatakse CodeFirst lähenemist, ehk enne luuakse andmemudel domeenimudelite näol ning nendest genereerib EntityFramework MSSQLi andmebaasi. Rakenduses on üritatud kasutada nö "best practice" näiteid nagu Solutioni tükeldamine alamprojektideks, andmete pärimine käib repositooriumite kaudu, kasutusel on vaatemudelid ning DTO'd. Kasutajate tugi on lisatud ASP.NET Identity näol kõige "lihtsamal" viisil. Kõik tabelid on auditväljadega (createdAt, createdBy, updatedAt, updatedBy) väljaarvatud ASP.NET raamistikuga kaasas käivad Identity tabelid. Kõiki tegeuvsi logitakse ActionLog tabelisse. Logimiseks on tehtud eraldi tabel ning komponent, mis tabelisse andmeid lisab. Kõikidel toimingutel kuvab rakendus informatiivse flash teavituse (vastavalt õnnestumisele kas rohelist või punast)

Avalik veeb

Avalikus veebis on võimalik külastajatel ettevõtete poolt sisestaud aegu broneerida. Külastajatel pole vaja kontot registreerida. Igale ettevõttele oskab rakendus kuvada detaillehte, kus on kuvatud kogu teadaolev info ettevõtte kohta. Ettevõtte detailvaates on kuvatud kõik antud ettevõtte vabad ajad. Broneerimiseks tuleb klikkida sobiva aja peale. Avaneb vorm:

  • Kliendi nimi: tekstiväli (kliendi nimi)
  • Kliendi email: tekstiväli (kliendi email)
  • Sõidukinimi: tekstiväli (mark, mudel)
  • Märkmed: tekstiväli (autonumber, probleemikirjeldus)
  • Klienditüüp: rippmenüü (era või äriklient)

Peale vormi sisestamist küsitakse kasutajalt kinnitust, kas ollakse kindel, et soovitakse broneerida aega. Mittenõustumisel ei broneeri rakendus aega. Nõustumisel valideeritakse andmed ning seotakse vaba ajaga. Seejärel saadab rakendus kinnituskirja kliendile ning teavituskirja ettevõttele. Teavituskiri läheb emailile, mis on sisestatud ettevõtte lisamisajal. Kliendikiri aga vormis sisestatud e-mailile.

Aegu, mida on juba broneeritud ei saa uuesti broneerida, need ei ilmu ka vabade aegade hulka.

Kasutaja registreerimine

Kasutaja registreerimine on tehtud võimalikult lihtsaks. Et luua endale konto on vaja sisestada saidile ainult kasutajanimi (ei pea olema e-mail) ning parool. Esmases versioonis ei pruugi olla isegi nõudeid paroolile, kuigi turvalisuse eesmärgiks võiks parool sisaldada vähemalt 6 tähemärki. Kasutajanimi peab olema unikaalne. Vigade korral teavitatakse klienti veateadetega.

Kasutajaga sisselogimine

Kui kasutaja on registreeritud, siis on ettevõtte lisamiseks ja haldamiseks (rakenduse põhifunktsionaalsuse kasutamiseks) tuleb sisse logida. Selleks, et sisselogida, tuleb sisestada kasutajanime ning paroolikombinatsioon, millega kasutaja on eelnevalt registreerunud. Kui kontot ei leitud, siis rakendus teavitab sellest klienti.

Ettevõtte haldamine

Ettevõtte loomiseks on vaja sisestada järgnevad andmed:

  • Nimi - tekstiväli (ettevõtte nimi)
  • Email aadress - tekstiväli (email peab valideeruma, siia saadetakse teavituskirju)
  • Aadress - tekstiväli (füüsiline aadress, mittekohustuslik)
  • Kontakt - tekstiväli (telefoninumber, email vms, mittekohustuslik)
  • Kirjeldus - tekstiväli (lühikirjeldus, nt millega ettevõte tegeleb, mittekohustuslik)
  • Töötunni hind - numbriväli (informatiivne väli, kohustuslik)
  • Töötajate arv - numbriväli (informatiivne väli, kohustuslik)

Kui kõik andmed valideeruvad, siis süsteem seob taustal selle ettevõtte kasutajaga. Peale ettevõtte salvestamist saab kasutaja seda igal ajal muuta. Samuti on võimalik lisada endale rohkem, kui 1 ettevõte. Kui ettevõte lõpetab tegevuse on võimalik see kustutada. Kustutamisprotsessi ajal kustutakse rekursiivselt kõik ettevõttega seotud andmed. Niisamuti kliendi broneeringud. Selles etapis aga ei teavitata klienti sellest - see on ettevõtte rida need asjad korda ajada.

Ettevõte saab määrata ära ka millist klienditüüpi ollakse valmis teenindama (Eraklient vs äriklient). Selleks on olemas eraldi haldus, kuhu sisestakse rippmenüüst klienditüüp. Teenindatavaid klienditüüpe saab kustutada ning uuesti lisada vajadusel. Muutmisele selles etapis pole tehnilist lahendust. Klienditüübi lisamise nupp on ettevõtte admin vaates.

Tõstukite haldamine

Tõstukite lisamise nupp on olemas ettevõtte administreerimisvaates. Tõstuki lisamisel tuleb sisestada:

  • Nimi - tekstiväli (tõstuki nimi)
  • Kirjeldus - tekstiväli (tõstuki lühikirjeldus)

Tõstukeid on võimalik lisada, kustutada ning muuta. Kustutamisprotsessi ajal kustutakse sarnaselt ettevõtte kustutamisele kõik seotud andmed rekursiivselt. Tulevikus on võimalik seda käitumist muuta (kuvada hoiatust või mitte lasta kustutada).

Vabade aegade haldamine

Vabu aegu saab lisada tõstuki põhiselt. Nupp vaba aja lisamiseks on iga tõstuki detailvaates. Sisestamisel on vaja määrata algus ning lõppaeg. Andmete sisestamise lihtsustamiseks kuvab rakendus kasutajale kuu ja kellaaja valikut spetsiaalse komponendi abil (DateTimePicker). Kui salvestamine õnnestub, siis süsteem seob selle aja tõstukiga automaatselt. Kustutamisprotsessis kustutakse selle ajaga seotud broneering. Teavitust ei saadeta.

Broneeringute vaatamine

Kui ajale on tehtud broneering ilmub see sisestatud aja detailvaatesse. Sealt on võimalik ettevõttel broneeringut vaadata ning kustutada. Kustutamisel ei saadeta kliendile teavitust.

Rakenduse sisu kokkuvõte

Rakenduses on olemas järgmised võimalused (Must have):

  • Kasutaja saab luua/muuta/kustutada autoparandus ettevõtteid
  • Kasutaja saab luua/muuta/kustutada uusi tõstukeid
  • Kasutaja saab luua/kustutada klienditüüpe, keda ta teenindab (Äri vs era)
  • Kasutaja saab luua/kustutada auto tõstuki broneerimisaegu
  • Klient saab broneerida tõstukite vabu aegu.
  • Kõiki tegevusi logitakse
  • Kasutaja-süsteem, et piirata kes mida näeb

Rakenduses võiksid olla lisavõimalused (Should have):

  • Ilus UI broneerimiseks

Andmebaasiskeem

Workload

27.09.2016

  • Projekti kickoff
  • Loodi andmebaasimudel
  • Vaatemudelid
  • Süsteem logib tegevusi
  • Saab luua/muuta/kustutada/vaadata ettevõtteid

28.09.2016

  • Loodi wiki leht
  • Täiendatud andmebaasi meta väljadega
  • Lisatud metaväljad vaatemudelitesse
  • LIsatud andmebaasi skeem
  • KLienditüübi haldus
  • Autotõstukite haldus
  • Kood VSO's

29.09.2016

  • Täiendatud andmebaasi meta väljadega
  • Tõstukite vabade aegade haldus
  • Broneerimine olemas

02.10.2016

  • Broneerida saab ainult vabu kohti
  • Vaadata tehtud broneeringuid

03.10.2016

  • Broneeringu tegemisel saadetakse nii ettevõttele, kui kliendile kinnitus emailile (kasutatakse SMTP serverit)
  • Seotud andmed on korrektsed ning eraldatud õigete parentite alla

04.10.2016

  • Kuupäeva väljad datetimepickeriga, parandatud default kuupäeva laadimist
  • Veaparandused
  • "Flash" teated tegevuste kohta.

16.10.2016

  • Kasutajad (registreerimine, sisselogimine)

Eelneva sooritamiseks leidsin head õpetused: http://benfoster.io/blog/aspnet-identity-stripped-bare-mvc-part-1 ja http://benfoster.io/blog/aspnet-identity-stripped-bare-mvc-part-2

30.10.2016

  • Tõlked mudelis (osaliselt)
  • Lubatud anonüümne broneerimine
  • Ettevõtted seotud kasutajatega
  • Lisatud nupud sisselogimiseks/registreerimiseks/välja logimiseks

07.11.2016 (PROTO)

  • Kustutamine
  • Õiguste kontrollimine andmete muutmisel

30.11.2016

  • Klienditüübid ENUMites

17.12.2016

  • Broneeringu ajavahemikul kuupäeva/aja kontrollid
  • Korrastasin projekti lisades tõlked, teavitused
  • Muutsin avalehe disaini

16.01.2017

  • Turvaparandused

22.01.2016

  • Tagasiside kommentaaridest innustatud parandused
  • Veel turvaparandusi

25.01.2016 (FINAL)

  • Cleanup