NSILM

Sisukord

Üldkirjeldus

Kasutajal on võimalik sõnastada uus eesmärk ning valida sellega seotud väljakutsed, mõõdikud ja meeskonnaliikmed. Samuti saab ta muuta varem lisatud poolelioleva või aktiivse eesmärgi andmeid. 

Kasutaja jõuab eesmärgi lisamise/muutmise vaatesse:

Seotud Jira taskid

NSIL-889 - Getting issue details... STATUS

NSIL-890 - Getting issue details... STATUS

NSIL-957 - Getting issue details... STATUS

NSIL-958 - Getting issue details... STATUS

NSIL-891 - Getting issue details... STATUS

NSIL-892 - Getting issue details... STATUS

NSIL-1131 - Getting issue details... STATUS

NSIL-1150 - Getting issue details... STATUS

Kasutajaliides

Jäljerida

Avaleht → Töölaud → Väljakutsed → Eesmärgi lisamine

Avaleht → Töölaud → Eesmärgid → Eesmärgi lisamine

Disainid

Eeltingimused

Kasutaja on sisse loginud ja valinud rolliks:

  1. Asutus: 
    1. Väljakutsed ja eesmärgid on asutusepõhised ning seotud kasutaja asutusega. Kasutajal on sama asutuse eesmärkide lisamise ja muutmise õigus.   
      1. AssessmentChallenge.assessment.assessmentScope = INSTITUTIONAL
      2. AssessmentChallenge.assessment.institution.id = Kasutaja poolt valitud rolliga seotud asutus
      3. Goal.goalScope = INSTITUTIONAL
      4. Goal.institution.id = Kasutaja poolt valitud rolliga seotud asutus
      5. Õigust reguleerib privileeg: HSILM_PLANNING_GOAL_MANAGE.
  2. Ametikoht:
    1. Väljakutsed ja eesmärgid on isikupõhised ning seotud kasutaja isikukoodi, valitud ametikoha ja asutusega.
      1. AssessmentChallenge.assessment.assessmentScope = INDIVIDUAL
      2. AssessmentChallenge.assessment.personalCode = Päringu käivitanud kasutaja isikukood
      3. AssessmentChallenge.assessment.jobsite = Kasutaja poolt valitud rolliga seotud ametikoht
      4. AssessmentChallenge.assessment.institution.id = Kasutaja poolt valitud rolliga seotud asutus
      5. Goal.goalScope = INDIVIDUAL
      6. Goal.personalCode = Päringu käivitanud kasutaja isikukood
      7. Goal.jobsite = Kasutaja poolt valitud rolliga seotud ametikoht
      8. Goal.institution.id = Kasutaja poolt valitud rolliga seotud asutus
    2. Eraldi privileegi ei ole vaja.
  3. Eesmärgid ei ole arhiveeritud - arhiveeritud eesmärkide andmeid ei saa muuta.
    1. Goal.archived = false

Arhiivi ja meeskonnaliikme rolli valinud kasutajal ei ole antud vaatele ligipääsu. 

Planeerimise mooduli kasutusrollide ja õiguste kohta saab täpsemalt infot leida lehelt Kasutusõigused ja rollid.

Funktsionaalsus ja selgitused

  1. Vaate avamisel:
    1. Eesmärkide karuselli kuvamine:
      1. Kasutajaliides teeb päringu eesmärkide karuselli kuvamiseks: PM: API: Goal: GET /planning-api/goals.
        1. Eesmärgid filtreeritakse kasutaja rolli alusel. 
        2. Otsitakse ainult kehtivaid eesmärke, st need, mis on staatuses "Pooleliolev" ja "Aktiivne".  
          1. Kui kasutaja rolliks on asutus, siis päringu sisendiks on:
            1. goalScope = "INSTITUTIONAL"
            2. institutionId = Kasutaja poolt valitud rolliga seotud asutuse ID
            3. staatuses = "INCOMPLETE"; "ACTIVE" 
          2. Kui kasutaja rolliks on ametikoht, siis päringu sisendiks on:
            1. goalScope = "INDIVIDUAL"
            2. institutionId = Kasutaja poolt valitud rolliga seotud asutuse ID
            3. jobsite = Kasutaja poolt valitud rolliga seotud ametikoht
            4. staatuses = "INCOMPLETE"; "ACTIVE". 
      2. Eesmärgid järjestatakse karusellis järjekorranumbri järgi, mis määratakse eesmärgile previousGoalId parameetri alusel.
        1. PM: API: Goal: GET /planning-api/goals.response.goals.previousGoalId
      3. Kui eesmärk on staatuses "Pooleliolev" (vt. PM Eesmärgi staatused tööprotsessis), kuvatakse vahelehe sildil hüüumärgi ikoon koos tooltip-iga: "Eesmärgi kirjeldus on pooleli. Lisage vähemalt üks tegevus.".
        1. PM: API: Goal: GET /planning-api/goals.response.goals.statusType
      4. Kui kasutaja kerib lehte allapoole, liigub karuselli vahelehtede pealkiri vaatega kaasa.
      5. Kui vaates kuvatakse Uue eesmärgi lisamise vorm ja PM: API: Goal: GET /planning-api/goals päring ei tagasta ühtegi eesmärki, siis karuselli ja vahelehti ei kuvata.
        1. Kui vähemalt üks eesmärk on tagastatud, siis kuvatakse.  
      6. Kui vaates ei kuvata Uue eesmärgi lisamise vormi ja päring tagastab ainult ühe eesmärki, siis samuti ei kuvata karuselli ega vahelehti.
        1. Kui päring tagastab rohkem kui ühe eesmärgi, siis karusell kuvatakse.
    2. Uue eesmärgi lisamise vormi kuvamine karusellis:
      1. Kui kasutaja jõuab sellesse vaatesse (eesmärgi lisamise voo 2. sammu):
        1. Vaatest PM: UC: Väljakutsete eesmärgile lisamine/muutmine (voo 1. sammust):
          1. Vaikimisi kuvatakse avatuna Uue eesmärgi lisamise vormi vaheleht.
          2. Kui vaates on eesmärkide karusell, asub see vaheleht alati esimesel positsioonil.
          3. Vormil ei ole ükski väli eeltäidetud, v.a. väljakutsed, kui neid valiti 1. sammus.
        2. Vaatest PM: UC: Eesmärkide tegevuste ja ülesannete kirjeldamine (lisamine/muutmine) (voo 3. sammust):
          1. Kuvatakse avatuna selle eesmärgi vaheleht, mida ta viimati vaatas voo 3. sammus.
            1. Tehniline selgitus:
              1. Kuni kasutaja viibib eesmärgi lisamise voos (samm 2 või 3), hoiab kasutajaliides meeles viimati kuvatud eesmärgi ID-d.
              2. Kui kasutaja lahkub voost (vajutades nupule "Tagasi töölauale") või naaseb voo 1.sammu, unustab süsteem viimati kuvatud eesmärgi ID
          2. Kui kasutaja ei ole pärast viimast eesmärgi lisamise alustamist (eesmärgi lisamise voo 1. sammus) veel uut eesmärki loonud:
            1. Eesmärkide karusellis kuvatakse PM: API: Goal: GET /planning-api/goals päringuga tagastatud eesmärkide kõrval ka Uue eesmärgi lisamise vorm;
            2. Vormil kuvatakse eelvalituna väljakutsed, mida kasutaja viimati valis voo 1. või 2. sammus.
      2. Kui kasutaja liigub PM: UC: Eesmärkide kirjeldamine (lisamine/muutmine) vaates teisele vahelehele, siis kehtib punktides 1.b.i.2.a ja 1.b.i.2.b kirjeldatud reeglid.
  2. Kasutaja saab lehe päises ja jaluses kuvatavate sammude kaudu liikuda erinevate eesmärgi lisamise voo sammude vahel.
    1. Visuaalselt on eristatud samm, milles kasutaja hetkel asub.
    2. Kui asutusel ei ole ühtegi aktiivset eesmärki, pole kasutajal võimalust liikuda 3. sammu.
      1.  PM: API: Goal: GET /planning-api/goals.response.goals = NULL
  3. Kui vaate avamisel kuvatakse vaikimisi Uue eesmärgi lisamise vorm või kasutaja valib selle karusellis (s.t vaates (vahelehel) kuvatava eesmärgi ID ei ole veel teada), siis:
    1. Vahelehe pealkirjaks kuvatakse "Uus eesmärk".
    2. Andmete kuvamine:
      1. "Valitud väljakutsed" plokk:
        1. Kuvatakse väljakutsed, mis on viimati valitud kas käesolevas vaates või eesmärgi lisamise voo 1. sammus (veel salvestamata ning süsteemi mälus hoitud), (rakendub ka punktis 1.b.i.2.b. kirjeldatud loogika).
        2. Kui väljakutseid ei ole valitud, kuvatakse teade: "Väljakutsed puuduvad". 
      2. "Meeskond" plokk:
        1. Kuvatakse teade: "Meeskonnaliikmed puuduvad". 
      3. "Mõõdikud" plokk:
        1. Kuvatakse teade: "Mõõdikud puuduvad". 
    3. Kasutaja peab eesmärgi lisamiseks sisestama kas eesmärgi nimetuse või kirjelduse.
      1. Eesmärgi nimetuse või kirjelduse väljale tähemärgi lisamine käivitab uue eesmärgi lisamise päringuPM: API: Goal: POST /planning-api/goals.
      2. Sõltuvalt kasutaja valitud rollist (asutus või ametikoht) luuakse vastavalt kas asutusepõhine või isikupõhine eesmärk.
        1. Päringu sisend:
          1. Kui kasutaja rolliks on asutus:
            1. goalScope = "INSTITUTIONAL"
            2. institutionId = Kasutaja poolt valitud rolliga seotud asutuse ID
            3. institutionName = Asutuse nimetus
          2. Kui kasutaja rolliks on ametikoht:
            1. goalScope = "INDIVIDUAL"
            2. institutionId = Kasutaja poolt valitud rolliga seotud asutuse ID
            3. jobsite = Kasutaja poolt valitud rolliga seotud ametikoht
          3. name = "Vahelehe pealkiri" väljasse sisestatud väärtus
          4. description = "Eesmärk" väljasse sisestatud väärtus
          5. assessmentChallengeIdseesmärgi lisamise voo 1. sammus (PM: UC: Väljakutsete eesmärgile lisamine/muutmine) valitud väljakutsed
        2. Selgitus: Päring lisab eesmärgi loojat vaikimisi eesmärgi meeskonnaliikmeks protsessijuhi (TEAM_LEAD) rollis. 
      3. Edasi jätkub protsess sammust 5.
    4. Kuni eesmärk ei ole loodud, ei ole kasutajal õimalik (vastavad nupud kuvatakse mitteaktiivsetena):
      1. Lisada eesmärgile meeskonnaliikmeid.
      2. Lisada eesmärgile mõõdikuid.
      3. Pärida ChatGPT eesmärgi kirjelduse näidist (akordion on suletud).
      4. Pärida eesmärgi ChatGPT SMART-hinnangut eesmärgi kirjeldusele.
    5. Kasutajal on võimalik muuta väljakutsete nimekirja, mida seotakse loodava eesmärgiga:
      1. Vastava nupu vajutamisel avatakse modaalaken: PM: UC: Väljakutsete eesmärgile lisamine/muutmine.
        1. Modaalakanasse edastatakse eelnevalt valitud väljakutsete ID-d, mis on kas valitud käesolevas vaates või eesmärgi lisamise voo 1. sammus (veel salvestamata ning süsteemi mälus hoitud). 
  4. Kui kasutaja on just loonud uue eesmärgi või valib karusellis varem lisatud eesmärgi (st et avatud vahelehel kuvatava eesmärgi ID on teada): 
    1. Kui kasutaja on just loonud uue eesmärgi (punkt 3.d):
      1. Kasutaja näeb vaates avatud vahelehel just loodud eesmärgi andmed. 
      2. Kui vaates on eesmärkide karusell, siis uue eesmärgi vahelehe pealkiri jääb endiselt "Uus eesmärk", ja see asub esimesel positsioonil.
        1. Eesmärk võtab oma õige positsiooni eesmärkide järjekorras alles siis, kui kasutaja liigub 1. või 3. sammu ja seejärel naaseb tagasi 2. sammu. Siis määratakse vahelehe pealkiri peatükis 'Andmed' toodud reeglite järgi. 
      3. Tühja uue eesmärgi lisamise vormi karusellis enam ei kuvata:
        1. See ilmub uuesti ainult siis, kui kasutaja liigub 2. sammust tagasi 1. sammu ja seejärel uuesti 2. sammu (vt. punkt 1.b).
    2. Kui kasutaja valib eesmärkide karusellis varem lisatud eesmärgi:
      1. Kasutajaliides pärib valitud eesmärgi andmed, käivitades päringud (sisendiks on karusellis valitud eesmärgi ID):
        1. Eesmärgi põhiandmete saamiseks: PM: API: Goal: GET /planning-api/goals/{goalId}.
        2. Eesmärgiga seotud väljakutsete nimekirja saamiseks: PM: API: Goal: GET /planning-api/goals/{goalId}/assessment-challenges
        3. Eesmärgi mõõdikute nimekirja saamiseks: PM: API: Goal: GET /planning-api/goals/{goalId}/metrics 
        4. Eesmärgi meeskonnakiimete nimekirja saamiseks: PM: API: Goal: GET /planning-api/goals/{goalId}/team-members
    3. Kasutajaliides salvestab enda mällu viimati kuvatud eesmärgi ID.
    4. Eesmärgi andmete kuvamine:
      1. Kirjeldus ja mõõdikud:
        1. Kuvatakse eesmärgi pealkiri ja kirjeldus. 
          1. PM: API: Goal: GET /planning-api/goals/{goalId}.response.name
          2. PM: API: Goal: GET /planning-api/goals/{goalId}.response.description
        2. Kui eesmärgil on ChatGPT eesmärgi kirjelduse näidis (aiDescription != 0), siis akordion on avatud. Kui sellist kirjeldust pole, on akordion suletud.
      2. Valitud väljakutsed:
        1. Kuvatakse eesmärgiga seotud väljakutsed.
          1. PM: API: Goal: GET /planning-api/goals/{goalId}/assessment-challenges.response.assessmentChallenges
          2. Kui eesmärgiga pole seotud ühtegi väljakutset, kuvatakse tühi teade - "Väljakutsed puuduvad". 
        2. Väljakutsed on järjestatud olulisuse alusel kahanevalt.
        3. Sama olulisusega väljakutsed järjestatakse nimetuse järgi tähestilikulises järjekorras.
      3. Mõõdikud:
        1. Kuvatakse eesmärgi mõõdikute nimekiri.
          1. PM: API: Goal: GET /planning-api/goals/{goalId}/metrics.response.goalMetrics 
          2. Kui eesmärgil ei ole ühtegi mõõdikut, kuvatakse tühi teade - "Mõõdikud puuduvad". 
        2. Mõõdikud on järejstatud kirjelduse teksti järgi tähestikulises järjekorras. 
          1. PM: API: Goal: GET /planning-api/goals/{goalId}/metrics.response.goalMetrics.description
        3. Mõõdikute akordionid on vaikimisi kinni.
        4. Mõõdiku näitajad kuvatakse kõrvuti, kuni kolm näitajat ühel real. 
      4. Meeskond:
        1. Kuvatakse eesmärgi meeskonnaliikmete nimekiri.
          1. PM: API: Goal: GET /planning-api/goals/{goalId}/team-members.response.goalTeamMembers
          2. Selgitus: Eesmärgil ei saa esineda olukorda, kus meeskonnaliikmete nimekiri on tühi, kuna eesmärgi lisaja lisatakse vaikimisi meeskonda. Viimast meeskonnaliiget ei ole võimalik eesmärgilt eemaldada. 
        2. "Protsessijuht" rolliga meeskonnaliikmed kuvatakse meeskonnaliikmete nimekirjas esimesena, nende juures on vastav ikoon.
        3. Kui protsessijuhte on mitu, järjestatakse nad nime järgi tähestikulises järjekorras.
        4. Samamoodi järjestatakse ka ülejäänud meeskonnaliikmed. 
    5. Kasutajal on võimalik (vastavad nupud on kuvatud / aktiivsed):
      1. Eesmärgi põhiandmed:
        1. Muuta eesmärgi nimetust ja kirjeldust:
          1. Ühe tähemärgi lisamine või eemaldamine nimetuse või kirjelduse väljal käivitab eesmärgi andmete salvestamise päringu: PM: API: Goal: PUT /planning-api/goals/{goalId}.
            1. Päringu sisend:
              1. goalId = avatud vahelehel kuvatava eesmärgi ID
              2. name = "Vahelehe pealkiri" väljasse sisestatud väärtus
              3. description = "Eesmärk" väljasse sisestatud väärtus
            2. Selgitus: Kui kasutaja muudab eesmärgi kirjelduse teksti, kustutatakse päringu käivitamisel andmebaasist eelmisele tekstiversioonile vastav ChatGPT hinnang.
        2. Muuta eesmärgi positsiooni eesmärkide karusellis, s.t. asutuse / ametikoha pooleliolevate ja aktiivsete eesmärkide järjekorras.
          1. Seda tegevust saab teha ainult kasutaja, kellel on valitud rolliks asutus või ametikoht.
          2. Eesmärgi uue järjekorranumbri salvestamiseks kasutatakse päringut: PM: API: Goal: PATCH /planning-api/goals/{goalId}/move.
            1. Päringu sisend:
              1. goalId = eesmärgi ID, mille positsiooni muudetakse
              2. targetGoalId = eesmärgi ID, millega liigutatav eesmärk vahetab asukohta
        3. Pärida valitud väljakutsete põhjal ChatGPT eesmärgi kirjelduse näidist:
          1. Vastav nupp on aktiivne ainult siis, kui:
            1. Eesmärgiga on seotud vähemalt üks väljakutse
              1. PM: API: Goal: GET /planning-api/goals/{goalId}.response.assessmentChallengeIds != null
            2. Eesmärgil pole ChatGPT poolt pakutud eesmärgi kirjeldust
              1. PM: API: Goal: GET /planning-api/goals/{goalId}.response.aiDescription = null
            3. Eesmärk pole arhiveeritud:
              1. PM: API: Goal: GET /planning-api/goals/{goalId}.response.archive = false
          2. Nupule vajutamisel käivitatakse päring: PM: API: Goal: PATCH /planning-api/goals/{goalId}/ai-description.
            1. Päringu sisend:
              1. goalId = esmärgi ID
        4. Pärida ChatGPT SMART-skoori hinnang eesmärgi kirjelduse jaoks: 
          1. Vastav nupp on aktiivne ainult siis, kui eesmärgil on kirjeldus: 
              1. PM: API: Goal: POST /planning-api/goals.response.aiDescription
              2. PM: API: Goal: PUT /planning-api/goals/{goalId}.response.aiDescription
          2. Nupule vajutamisel käivitatakse päring: PM: API: Goal: PATCH /planning-api/goals/{goalId}/ai-smart-score.
            1. Päringu sisend:
              1. goalId = eesmärgi ID
            2. Selgitus:
              1. Päritakse hinnangut eesmärgi SMART põhimõtetele vastavuse kohta 5 punkti skaalal.
              2. ChatGPT poolt tagastatud SMART skoori hinnangut salvestatakse eesmärgi juurde. 
      2. Väljakutsed:
        1. Muuta eesmärgile lisatud väljakutse olulisust:
          1. Kasutajaliides käivitab väljakutse olulisuse salvestamiseks päringu: PM: API: AssessmentChallenge: PATCH /planning-api/assessment-challenges/{assessmentChallengeId}/elements/{elementId}/selected-scale-value.
            1. Päringu sisend:
              1. assessmentChallengeId = väljakutse ID, mille olulisuse hinnangut muudetakse
                1. PM: API: Goal: GET /planning-api/goals/{goalId}/assessment-challenges.response.assessmentChallenges.id
              2. elementId = väljakutse elemendi ID, milles hoitakse olulisuse hinnangut
                1. PM: API: Goal: GET /planning-api/goals/{goalId}/assessment-challenges.response.assessmentChallenges.elements.id, mille assessmentChallenges.id = valitud väljakutse ID ja elements.code = "IMPORTANCE"
              3. selectedValue = kasutaja poolt valitud väljakutse olulisuse uus väärtus
        2. Lisada ja eemaldada eesmärgilt väljakutseid:
          1. Väljakutse lisamise tegevuse valimisel kuvab süsteem kasutajale modaalakna PM: UC: Väljakutsete eesmärgile lisamine/muutmine.
          2. Väljakutse kustutamise tegevuse valimisel käivitab süsteem päringu: PM: API: Goal: DELETE /planning-api/goals/{goalId}/assessment-challenges/{assessmentChallengeId}.
            1. Päringu sisend:
              1. assessmentChallengeId = eemaldatava väljakutse ID
              2. goalId = eesmärgi ID 
            2. Selgitus: Päringuga kustutatakse eesmärgi seos väljakutsega, mitte väljakutse ise.
          3. Selgitus:
            1. Iga väljakutse lisamisel ja eemaldamisel kustutatakse andmebaasist varem päritud ChatGPT eesmärgi kirjelduse näidis.
              1. PM: API: Goal: DELETE /planning-api/goals/{goalId}/assessment-challenges/{assessmentChallengeId}.response.aiDescription = NULL
              2. PM: API: Goal: POST /planning-api/goals/{goalId}/assessment-challenges.response.aiDescription = NULL
            2. Uuendatud vaates kuvatakse "ChatGPT eesmärgi kirjelduse näidis" akordion suletuna. 
      3. Meeskonnaliikmed:
        1. Lisada eesmärgile uus meeskonnaliige ja kustutada olemasolev meeskonnaliige.
          1. Vastavad nupud on kuvatud ainult juhul, kui on täidetud üks järgmistest tingimustest:
            1. Tegemist on asutusepõhise eesmärgiga ja kasutajal on rollis valitud asutuse juures meeskonnaliikmete haldamise õigus.
              1. Goal.goalScope = INSTITUTIONAL
              2. Õigust reguleerib privileeg: HSILM_PLANNING_TEAM_MEMBER_MANAGE.
            2. VÕI tegemist on isikupõhise eesmärgiga ja kasutaja on eesmärgi omanik.
              1. Goal.goalScope = INDIVIDUAL  
              2. Goal.personalCode = Kasutaja isikukood
              3. Eraldi privileegi ei ole vaja.
            3. VÕI kasutaja on eesmärgi meeskonnas ja planeerimise meeskonna liikme rollil on meeskonnaliikmete haldamise õigus.
              1. Goal.goalScope = INSTITUTIONAL või INDIVIDUAL 
              2. Goal.teamMembers.id = GoalTeamMember.id, mille personalCode = Kasutaja isikukood 
          2. Meeskonnaliikme lisamise tegevuse valimisel kuvab süsteem kasutajale meeskonnaliikme lisamise modaalakna: PM: UC: Meeskonnaliikme vaatamine/lisamine/muutmine.
          3. Meeskonnaliikme juures kustutamise nupule vajutamisel käivitab süsteem päringu: PM: API: Goal: DELETE /planning-api/team-members/{teamMemberId}.
            1. Päringu sisend:
              1. teamMemberId = eesmärgilt eemaldatava meeskonnaliikme ID
              2. goalId = eesmärgi ID, mille vaates tegevus algatati 
        2. Vaadata kõigi meeskonnaliikmete andmeid ning muuta kas ainult enda andmeid ja vastava õiguse olemasolul ka teiste meeskonnaliikmete andmeid:
          1. Meeskonnaliikme reale vajutamisel avaneb modaalaken kõigi eesmärgi meeskonnaliikmete andmetega, kus vaikimisi on avatud valitud meeskonnaliikme akordion: PM: UC: Meeskonnaliikme vaatamine/lisamine/muutmine.
            1. Selgitus:
              1. Kui kasutaja vajutab enda isikukoodiga meeskonnaliikme reale, kuvatakse tema andmed avanenud meeskonnaliikmete modaalaknas muudetavatena. 
              2. Kui vajutatakse mõnda teise meeskonnaliikme reale, saab tema ja ka teise meeskonnaliikmete andmed muuta ainult juhul, kui kasutajal on samad õigused, mis on vajalikud meeskonnaliikme lisamiseks ja kustutamiseks. 
        3. Vaadata, milliste teiste eesmärkidega on eesmärgi meeskonnaliikmed seotud:
          1. Vastava nupu vajutamisel kuvab süsteem kasutajale meeskonnaliikmete eesmärkide nimekirja vaate: PM: UC: Meeskonnaliikmete eesmärkide nimekirja kuvamine.
      4. Mõõdikud:
        1. Lisada eesmärgile uus mõõdik:
          1. Vastava nupu vajutamisel kuvab süsteem kasutajale modaalakna PM: UC: Eesmärgi mõõdiku lisamine/muutmine.
            1. Modaalaknale antakse kaasa eesmärgi ID.
            2. Maksimaalselt on võimalik lisada 8 mõõdikut. 
        2. Muuta ja kustutada olemasolevaid mõõdikuid: 
          1. Mõõdiku tegevuste menüüst muutmise tegevuse valimisel kuvab süsteem kasutajale modaalakna PM: UC: Eesmärgi mõõdiku lisamine/muutmine.
            1. Modaalaknale antakse kaasa eesmärgi ID ja muudetava mõõdiku ID. 
          2. Mõõdiku kustutamise valimisel käivitab süsteem päringu: PM: API: Goal: DELETE /planning-api/goals/{goalId}/metrics/{goalMetricsId}
            1. Päringu sisend:
              1. goalMetricsId = kustutava mõõdiku ID
              2. goalId = eesmärgi ID
        3. Vaadata eesmärgi mõõdikute andmeid:
          1. Mõõdiku akordioni avamisel kuvatakse kasutajale selle andmed.
          2. Iga uue akordioni avamisel jääb eelmine avatuks. 

Andmed

Elemendi nimetusSelgitus/Näide
Lehe päis
-
  • Progressiribal kuvatakse eesmärkide seadmise sammud:
    • 1 Väli väljakutsed
    • 2 Sõnasta eesmärk
    • 3 Kirjelda tegevused ja ülesanded
  • Teine samm on tähistatud tumesinise värviga valituks, ülejäänud sammud on hallid.
Vahelehed

Vahelehtedena kuvatakse PM: API: Goal: GET /planning-api/goals päringuga saadud eesmärgid. Täpsem päringu loogika on kirjeldatud peatükis "Selgitused" punktis 1.

  • Eesmärgid järjestatakse järjekorranumbri järgi, mis määratakse eesmärgile previousGoalId parameetri alusel.
  • Andmeallikas: 
-
  1. Vahelehe pealkirjaks kuvatakse:
    1. esimesel real: tekst "Eesmärk +[järjekorra number]"
      1. Eesmärgi järjekorranumer määratakse previousGoalId parameetri alusel:
    2. teisel real: eesmärgi nimetuse esimesed 20 tähemärki.
      1. PM: API: Goal: GET /planning-api/goals.response.goals.name

      2. Kui nimetus puudub, kuvatakse eesmärgi kirjelduse esimesed 20 tähemärki. 
      3. Kui nimetus või kirjeldus on pikem kui 23 tähemärki, kuvatakse esimesed 20 tähemärki ja '...'.
      4. nt. 'Eesmärk 1

        Luua tõhus keskkond'

    3. Mittemuudetav.
  2. Uue eesmärgi lisamise vormi vahelehe pealkirjaks kuvatakse "Uus eesmärk".
Eesmärgiga seotud väljakutsete andmed

Väljakutsed on plokis järjestatud olulisuse alusel kahanevalt. Sama olulisusega väljakutsed järjestatakse nimetuse järgi tähestilikulises järjekorras. 


-

Väljakutse nimetus

-

Väljakutse olulisus

Seotud

Kuvatakse mitme eesmärgiga väljakutse seotud on.

nt. "Seotud 3".

Seotud eesmärkide nimekirja andmed

-

Modaalakna pealkirjaks kuvatakse 'Seotud eesmärgiga' ja sulgudes arv, kui palju eesmärke on valitud väljakutsega seotud.

nt. "Seotud eesmärgiga (3)"

-
  • Kuvatakse eesmärgi nimetuse esimesed 20 tähemärki. 
  • Kui see puudub, siis esimesed 20 tähemärki eesmärgi kirjeldusest.
  • Kui eesmärgi nimetus või kirjeldus on pikem kui 23 tähemärki, siis kuvatakse esimesed 20 tähemärki ja '...'.

nt. 'Ütle iga päev peegli ees endale midagi positiivset või kiitvat.'

Mittemuudetav.

Eesmärgi kohta kuvatavad andmed
Vahelehe pealkiri

Eesmärgi nimetus.

Eesmärk

Eesmärgi kirjeldus.

ChatGPT SMART skoori hinnang

ChatGPT poolt genereeritud hinnang eesmärgi kirjelduse täpsusele ja selgusele SMART kriteeriumide alusel

  • Kuvatakse kõigi ChatGPT poolt antud hinnangute keskmine.
  • Kui SMART-skoori keskmist hinnangut pole teada, siis kuvatakse 0.
  • Hinnangu väärtus määrab kuvatava numbri taustavärvi:
      • 5 → roheline
      • 3.0-4.9 → kollane.
      • 0-2.9 → punane.
  • Mittemuudetav.
  • Andmeallikas:
ChatGPT eesmärgi kirjelduse näidis

ChatGPT eesmärgi kirjelduse näidis.

Mõõdikute kohta kuvatavad andmed
-

Mõõdiku akordioni pealkirjana kuvatakse mõõdiku kirjelduse tekst.

-

Mõõdiku näitajate nimekirjas kuvatakse mõõdikule valitud näitajate eelvaated.

-

Mõõdiku sihttasemete nimekirjas kuvatakse mõõdikule määratud sihttasemed.

Meeskonnaliikmete kohta kuvatavad andmed
-

Meeskonnaliikme eesnimi, perekonnanimi, profiilivärv ja protsessi juhi märge.

  1. Iga meeskonna liikme real kuvatakse tema initsiaalidega ikoon, mille värv vastab meeskonnaliikme profiilile määratud värvile.
    1. Andmeallikad: 
      1. PM: API: Goal: GET /planning-api/goal-team-members/{goalId}.response.goalTeamMembers.firstName, mille id = real kuvatava meeskonnaliikme ID
      2. PM: API: Goal: GET /planning-api/goal-team-members/{goalId}.response.goalTeamMembers.lastName, mille id = real kuvatava meeskonnaliikme ID
      3. PM: API: Goal: GET /planning-api/goal-team-members/{goalId}.response.goalTeamMembers.profileColor, mille id = real kuvatava meeskonnaliikme ID
  2. Kui meeskonna liikme rolliks on "Protsessi juht", kuvatakse nime järgi vastav ikoon.
    1. PM: API: Goal: GET /planning-api/goal-team-members/{goalId}.response.goalTeamMembers.roleType = "TEAM_LEAD", mille id = real kuvatava meeskonnaliikme ID

Mittemuudetav.

-

Meeskonnaliikme asutuse nimetus ja ametikoht kuvatakse sidekriipsuga eraldatuna.

nt "Pärnu Noorte Vabaajakeskus - Arendusjuht"

Kasutaja tegevused

Tegevuse nimetusSelgitus
Lehe päises või jaluses vastavale sammule vajutamine

Sammule vajutamisel kuvatakse kasutajale vastav vaade:

  1. Samm 1 ("Vali väljakutsed")
    1. Avatakse vaade PM: UC: Väljakutsete eesmärgile lisamine/muutmine.
    2. Kui kasutaja ei ole pärast viimast eesmärgi lisamise alustamist (eesmärgi lisamise voo 1. sammus) veel uut eesmärki loonud, siis kuvatakse vaates eelvalituna samad väljakutsed, mida ta viimati valis voo 1. või 2. sammus. 
    3. Kui eelmine eesmärk on juba loodud ja kasutaja ei jätka poolelijäänud lisamist, siis vaates ei ole eelvalitud väljakutseid - kasutaja alustab uue eesmärgi loomist nullist.
  2.  Samm 3 ("Kirjelda tegevused ja ülesanded" / "Tegevused ja üelsanded")
    1. Kui asutusel / ametikohal ei ole ühtegi pooleliolevat või aktiivset eesmärki, ei ole kasutajal võimalust sellesse sammu liikuda. 
      1. Sammule vajutamisel kuvatakse teade: "Eesmärgid puuduvad. Lisage vähemalt üks eesmärk."
    2.  Kui vähemalt üks eesmärk on olemas, siis sammule vajutamisel:
      1. Avatakse vaade PM: UC: Eesmärkide tegevuste ja ülesannete kirjeldamine (lisamine/muutmine).
      2. Vaates kuvatakse avatuna selle eesmärgi vaheleht, mida kasutaja viimati vaatas voo 2. sammus. 
        1. Tehniline selgitus: 
          1. Kuni kasutaja viibib eesmärgi lisamise voos (samm 2 või 3), hoiab kasutajaliides meeles viimati kuvatud eesmärgi ID-d.
          2. Kui kasutaja lahkub voost (vajutades nupule "Tagasi töölauale") või naaseb voo 1. sammu, unustab süsteem viimati kuvatud eesmärgi ID
      3. Kui voo 2. sammus oli viimati avatud Uue eesmärgi lisamise vorm, kuid kasutaja ei ole veel uut eesmärki loonud (pärast viimast eesmärgi lisamise alustamist voo 1. sammus), siis:
        1. Karusellis kuvatakse vaikimisi avatuna kõige väiksema järjekorranumbriga eesmärgi vaheleht.
          1. PM: API: Goal: GET /planning-api/goals, vastuseväli: goals.previousGoalId = NULL
Eesmärkide karusellis vahelehe pealkirjale liikumine

Vahelehe pealkirjale liikudes kuvab süsteem kasutajale nooleikoonid, millega kasutajal on võimalik muuta eesmärgi positsiooni järjekorras.

Nooleikoonile vajutamisel:

  1. Süsteem käivitab päringu eesmärgi uue järjekorranumbri salvestamiseks: PM: API: Goal: PATCH /planning-api/goals/{goalId}/move.
  2. Kui päring õnnestub, nihkub eesmärk ühe koha võrra vastavas suunas (paremale või vasakule). 
Eesmärkide karusellis eesmärgi vahelehe pealkirjale vajutamine
  • Vahelehe pealkirjale vajutades värskendab süsteem vaadet ja kuvab avatud vahelehel valitud eesmärgi andmeid.
    • Täpsem loogika on kirjeldatud peatükis "Selgitused".
  • Kasutaja saab eesmärgi andmeid muuta. 
Eesmärkide karusellis Uue eesmärgi lisamise vormi vahelehe valimine
  • Vahelehe pealkirjale vajutades kuvab süsteem Uue eesmärgi lisamise vormi vahelehe, kus väljad on muudetavad.
    • Täpsem loogika on kirjeldatud peatükis "Selgitused".
Väljakutse olulisuse hinnangu numbrile vajutamine

Hinnangu numbrile vajutamisel:

  1. Süsteem kuvab kasutajale eraldi kastis võimalike punktide valiku skaala.
  2. Kui kasutaja valib punktiskaalalt uue väärtuse:
    1. Süsteem käivitab väljakutse olulisuse salvestamise: PM: API: AssessmentChallenge: PATCH /planning-api/assessment-challenges/{assessmentChallengeId}/elements/{elementId}/selected-scale-value.
    2. Tegevuse õnnestumisel uuendatakse väljakutsete nimekirjas väljakutsete järjestust.
  3. Kui kasutaja sulgeb punktiskaala ilma valikut tegemata (klõpsates X nuppu):
    1. Väljakutse olulisust ei muudeta.
Valitud väljakutsete nimekirja prügikasti ikoonile vajutamine
  • Kui eesmärk on salvestatud:
  • Kui eesmärgi esmakordset salvestamist ei ole veel toimunud:
    • Prügikasti ikoonile vajutamisel eemaldatakse vastav rida väljakutsete nimekirjast.
    • Süsteem uuendab ka oma mälus hoitvat infot loodava eesmärgiga seotud väljakutsetest. 
Väljakutse juures "Seotud" sildile vajutamine
Nupu "Lisa väljakutse" vajutamine
  • Nupule vajutamisel kuvab süsteem kasutajale modaalakna PM: UC: Väljakutsete eesmärgile lisamine/muutmine.
    • Kui kasutaja algatab tegevuse Uue eesmärgi lisamise vormilt, edastab süsteem modaalaknale kaasa mälus hoitavad väljakutsete ID-d, mis on kasutaja poolt viimati valitud käesolevas vaates või voo 1. sammus
    • Kui tegevus algatatakse salvestatud eesmärgi vaatest, edastatakse modaalaknale eesmärgi ID.
Nupu "ChatGPT SMART skoori hinnang" vajutamine
"ChatGPT eesmärgi kirjelduse näidis" akordioni avamine
"ChatGPT eesmärgi kirjelduse näidis" akordioni sulgemine

Kasutajal on võimalik avatud akordion sulgeda, et peita kuvatav näidis.

Mõõdiku akordioni avamine

Kuvatakse valitud mõõdiku detailandmed, mille tagastas päring PM: API: Goal: GET /planning-api/goals/{goalId}/metrics vaate avamisel / värskendamisel.

Iga uue akordioni avamisel jääb eelmine avatuks. 

Mõõdiku akordioni sulgemine

Kasutajal on võimalik avatud akordion sulgeda, et peita kuvatavad mõõdiku detailandmed.

Nupu "Lisa mõõdik" vajutamine
Mõõdiku akordionis kolme punktiga ikooni vajutamine

Kolme punktiga ikoonile vajutamisel kuvab süsteem kasutajale võimalike tegevuste menüü valikutega "Muuda" ja "Kustuta".

"Kustuta" valimisel:

  1. Süsteem küsib kinnitust mõõdiku kustutamiseks.
  2. Kui kasutaja vajutab "X" või "Katkesta":
    1. Mõõdikut ei kustutata ja kinnitusaken suletakse.
  3. Kui kasutaja kinnitab kustutamise:
    1. Süsteem käivitab päringu: PM: API: Goal: DELETE /planning-api/goals/{goalId}/metrics/{goalMetricsId}
    2. Kui mõõdiku kustutamine õnnestub, kuvab süsteem kasutajale uuendatud mõõdikute nimekirja koos vastava eduteatega. 
Nupu "Lisa liige" vajutamine

Nupp kuvatakse ainult juhul, kui kasutajal on täidetud peatükis "Funktsionaalsus. Selgitused" kirjeldatud tingimused. 

Nupule vajutamisel avaneb meeskonnaliikme lisamise modaalaken: PM: UC: Meeskonnaliikme vaatamine/lisamine/muutmine.

Meeskonnaliikmete nimekirjas reale vajutamine

Meeskonnaliikme reale vajutamisel avaneb modaalaken kõigi eesmärgi meeskonnaliikmete andmetega. Vaikimisi on avatuna kuvatud valitud meeskonnaliikme akordion: PM: UC: Meeskonnaliikme vaatamine/lisamine/muutmine.

See, kas meeskonnaliikmete andmed kuvatakse muudetavatena või ainult vaatamiseks, sõltub kasutaja õigustest, mis on kirjeldatud peatükis "Funktsionaalsus. Selgitused".

Meeskonnaliikmete nimekirjas prügikasti ikoonile vajutamine

Prügikasti ikoonid kuvatakse meeskonnaliikmete juures ainult juhul, kui kasutajal on täidetud peatükis "Funktsionaalsus. Selgitused" kirjeldatud tingimused. 

Nupule vajutamisel:

  1. Süsteem küsib kinnitust meeskonnaliikme kustutamiseks.
  2. Kui kasutaja vajutab "X" või "Katkesta":
    1. Meeskonnaliiget ei kustutata ja kinnitusaken suletakse.
  3. Kui kasutaja kinnitab kustutamise:
    1. Süsteem käivitab päringu: PM: API: Goal: DELETE /planning-api/team-members/{teamMemberId}.
    2. Kui kustutamine õnnestub, kuvatakse kasutajale uuendatud meeskonnaliikmete nimekiri koos eduteatega.

Selgitus: Meeskonnaliikme kustutamisel kantakse tema tegevused ja tööülesanded üle meeskonnaliikmele, kes teostas kustutamise.

Nupu "Tagasi töölauale" vajutamineNupule vajutamisel suunab süsteem kasutaja tagasi töölauale. Viimati kuvatud eesmärgi ID unustatakse. 
Nupu "Edasi vormile Tegevused ja ülesanded" vajutamineNupule vajutamisel suunab süsteem kasutaja vaatesse PM: UC: Eesmärkide tegevuste ja ülesannete kirjeldamine (lisamine/muutmine).
Lingile "Viimati vaadatud" vajutamine

Lingile vajutamisel avaneb modaalaken viimati lehte vaadanud kasutajate nimekirjaga (vt. PM: UC: Viimaste vaatamiste nimekirja kuvamine). (arendatakse hilisemas etapis)