PM: UC: Eesmärkide vaatamine

Sisukord

Üldkirjeldus

Kasutajal on võimalik liikuda erinevate eesmärkide vahelehtedele ja vaadata iga eesmärgi koondvaadet.

Kasutaja jõuab eesmärkide vaatamise vaatesse töölaualt, kui:

1. tal on valitud rolliks asutus ja tal on selle asutuse juures eesmärkide vaatamise õigus, kuid puudub eesmärkide lisamise ja muutmise õigus;
2. tal on valitud rolliks Planeerimise meeskonna liige, millel on eesmärkide vaatamise õigus, kuid puudub eesmärkide lisamise ja muutmise õigus;
3. tal on valitud rolliks Arhiiv.

Planeerimise meeskonna liikme rollis kasutaja näeb vaates ainult neid eesmärke, mis kuuluvad asutusele / ametikohale, mille tal on eelnevalt Planeerimise meeskonna liikme töölaualt valinud, ning mille meeskonna liige ta on.

Ametikoha rollis kasutaja seda vaadet ei kasuta, kuna igal kasutajal on õigust hallata enda ametikoha eesmärke. Seetõttu suunatakse ta töölaual lingile "Eesmärgid" vajutamisel alati vaatesse PM: UC: Eesmärkide tegevuste ja ülesannete kirjeldamine (lisamine/muutmine).

Seotud Jira taskid

NSIL-1113 - Getting issue details... STATUS

Kasutajaliides

Jäljerida

Avaleht → Töölaud → Eesmärgid

Disainid

Eesmärkide vaatamise vaade vaikimisi: https://www.figma.com/design/mPPdrh04luwBeiX856NQPP/NAPO---TWN?node-id=8718-12743&t=brUpgCXl0RIt5Dp0-4
Eesmärkide vaatamise vaates mõõdiku akordioni detailide vaatamise näide: https://www.figma.com/design/mPPdrh04luwBeiX856NQPP/NAPO---TWN?node-id=8936-61050&t=brUpgCXl0RIt5Dp0-4
Eesmärkide vaatamise vaate tegevuste kalendris tegevuse või tööülesande detailide vaatamine on analoogne tegevuste ja tööülesannete lisamise/muutmise vaatega: https://www.figma.com/design/mPPdrh04luwBeiX856NQPP/NAPO---TWN?node-id=8725-27746&t=8lfwh9VbRoaWIlQ2-4

Eeltingimused

Kasutaja on sisse loginud ja valinud rolliks:

1. Asutus:
   1. Eesmärgid on asutusepõhised ning seotud kasutaja asutusega. Kasutajal on sama asutuse eesmärkide vaatamise õigus.
      1. Goal.goalScope = INSTITUTIONAL
      2. Goal.institution.id = Kasutaja valitud rolliga seotud asutus
      3. Õigust reguleerib privileeg: HSILM_PLANNING_GOAL_VIEW.
2. Ametikoht / Arhiiv:
   1. Eesmärgid on isikupõhised ning seotud kasutaja isikukoodiga.
      1. Goal.goalScope = INDIVIDUAL
      2. Goal.personalCode = Kasutaja isikukood
   2. Eraldi privileegi ei ole vaja.
3. Planeerimise meeskonna liige:
   1. Kasutaja on eesmärkide meeskonnas ja planeerimise meeskonna liikme rollil on eesmärkide vaatamise õigus.
      1. Goal.goalScope = INSTITUTIONAL või INDIVIDUAL
      2. Goal.teamMembers.id = GoalTeamMember.id, mille personalCode = kasutaja isikukood

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

Funktsionaalsus

Selgitused

1. Vaate avamisel:
   1. Kasutajaliides käivitab päringu eesmärkide nimekirja saamiseks:
      1. Otsitakse ainult kehtivaid eesmärke, st need, mis on staatuses "Pooleliolev" ja "Aktiivne".  
      2. Kui kasutaja rolliks on asutus, käivitatakse päring: PM: API: Goal: GET /planning-api/goals.
         1.  Päringu sisend on:
            1. goalScope = "INSTITUTIONAL"
            2. institutionId = Kasutaja poolt valitud rolliga seotud asutuse ID
            3. statuses = "INCOMPLETE"; "ACTIVE".
      3. Kui kasutaja rolliks on arhiiv, käivitatakse päring: PM: API: Goal: GET /planning-api/goals.
         1. Päringu sisend on:
            1. institutionId = Arhiivi töölaual valitud asutuse ID
            2. jobsite = Arhiivi töölaual valitud ametikoht
            3. statuses = "INCOMPLETE"; "ACTIVE".
      4. Kui kasutaja rolliks on planeerimise meeskonna liige: PM: API: Goal: GET /planning-api/team-member-goals.
         1. Päringu sisend:
            1. goalScope = Kui kasutaja on valinud Planeerimise meeskonna liikme töölaual asutuse, siis "INSTITUTIONAL"; kui ta on valinud teise isiku ametikoha, siis "INDIVIDUAL".
            2. institutionId = Planeerimise meeskonna liikme töölaual valitud asutuse ID
            3. personalCode = Planeerimise meeskonna liikme töölaual valitud isiku isikukood
            4. jobsite = Planeerimise meeskonna liikme töölaual valitud ametikoht
            5. statuses = "INCOMPLETE"; "ACTIVE".
      5. Ametikoha rollis kasutaja seda vaadet ei kasuta, kuna igal kasutajal on õigust hallata enda ametikoha eesmärke. Seetõttu suunatakse ta töölaual lingile "Eesmärgid" vajutamisel alati vaatesse PM: UC: Eesmärkide tegevuste ja ülesannete kirjeldamine (lisamine/muutmine).
   2. Kui päring tagastab rohkem kui ühe eesmärgi, kuvatakse kasutajale eesmärkide karusell.
      1. 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
      2. Eesmärkide karusellis kuvatakse vaikimisi avatuna kõige väiksema järjekorranumbriga eesmärgi vaheleht.
         • PM: API: Goal: GET /planning-api/goals.respose.goals.previousGoalId = NULL
      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.
   3. Kui päring tagastab ainult ühe eesmärki, siis karuselli ega vahelehte ei kuvata.
2. Eesmärgi vahelehe avamisel pärib kasutajaliides eesmärgi andmed, käivitades päringud:
   
   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 saamiseks: PM: API: Goal: GET /planning-api/goals/{goalId}/metrics
   4. Eesmärgi meeskonnakiimete saamiseks: PM: API: Goal: GET /planning-api/goal-team-members/{goalId}
   5. Eesmärgi tegevuste saamiseks: PM: API: Goal: GET /planning-api/goals/{goalId}/activities
   6. Eesmärgi tööülesannete saamiseks: PM: API: Goal: GET /planning-api/goals/{goalId}/tasks
   7. Eesmärgi märkmete saamiseks: PM: API: Goal: GET /planning-api/goals/{goalId}/notes
      1. Päringute sisendiks on karusellis avatud eesmärgi ID.
3. Kasutajaliides kuvab päringutega saadud eesmärgi andmed:
   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. 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. 
      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.
   3. Tegevused:
      1. Tegevuste nimekiri:
         1. Kuvatakse kõik eesmärgi tegevused.
            1. PM: API: Goal: GET /planning-api/goals/{goalId}/activities.response.goalActivities
            2. Kui eesmärgil ei ole veel ühtegi tegevust, kuvatakse tühi teade. 
         2. Tegevused on nimekirjas järjestatud vastavalt neile määratud järjekorrale.
            1. PM: API: Goal: GET /planning-api/goals/{goalId}/activities.response.goalActivities.previousActivityId
         3. Iga tegevuse all kuvatakse selle eest vastutava isiku nimi. 
            1. PM: API: Goal: GET /planning-api/goals/{goalId}/activities.response.goalActivities.goalTeamMemberName
         4. Kui tegevusele on lisatud märge, kuvatakse selle juures vastav ikoon. 
            1. PM: API: Goal: GET /planning-api/goals/{goalId}/notes.response.goalNotes, mille goalActivityId = real kuvatava tegevuse ID
      2. Tegevuste ja tööülesannete kalender:
         1. Kasutajal saab valida järgmiste kalendrivaadete vahel: nädal, kuu, kvartal või aasta. 
         2. Vaikimisi kuvatakse eesmärgi vahelehe avamisel nädala vaade, mille päises on esimesena nähtaval jooksev nädal.
         3. Kalendris kuvatakse eesmärgi tegevused horisontaalsete ribadena, mille peal on kirjas tegevuse nimetus.
            1. PM: API: Goal: GET /planning-api/goals/{goalId}/activities.response.goalActivities.activityName
         4. Iga tegevuse all kuvatakse samuti horisontaalsete ribadena kõik sellega seotud tööülesanded. 
            1. PM: API: Goal: GET /planning-api/goals/{goalId}/tasks.response.goalActivityTasks.taskName, mille goalActivityId = tegevuse ID
         5. Tegevuse/tööülesande riba algab nädalal, kuhu jääb selle alguskuupäev ja lõpeb nädalal, kuhu jääb lõpukuupäev. 
            1. PM: API: Goal: GET /planning-api/goals/{goalId}/activities.response.goalActivities.startDate
            2. PM: API: Goal: GET /planning-api/goals/{goalId}/tasks.response.goalActivityTasks.startDate
            3. PM: API: Goal: GET /planning-api/goals/{goalId}/activities.response.goalActivities.endDate
            4. PM: API: Goal: GET /planning-api/goals/{goalId}/tasks.response.goalActivityTasks.endDate
         6. Tegevuse riba värv määratakse juhuslikult alltoodud värvide hulgast:
            
            1. #14AAAD - teal
            2. #468CDF - sinine
            3. #9467BD - lilla
            4. #E377C2 - roosa
            5. #FF7F0E - oranž
            6. #E6BC05 - kollane
            7. #2CA02C - roheline
            8. #7F7F7F - hall
            9. #8C564B - pruun
            10. #D62728 - punane
            11. #B44FB0 - soe lilla
            12. #1F77B4 - soe sinine
            13. #BCBD22 - soe roheline
            14. #D17805 - ooker
         7. Vaate vahetamisel uuenevad nii kalendri päis kui ka tegevuste ja tööülesannete ribade pikkus vastavalt valitud vaatele.
            • Kalendrivaate muutmisel jääb nähtavale sama nädal, mis oli eelnevas vaates esimesena kuvatud. 
         8. Kasutaja saab liikuda vaates edasi ja tagasi (nädala / kuu / kvartali / aasta kaupa), kus kuvatakse vastava perioodi tegevused ja tööülesanded.
            1. Liikumine on võimalik ainult eesmärgi perioodi piires - alates kõige varasema tegevuse alguskuupäevast kuni kõige hilisema tegevuse lõpukuupäevani. 
         9. Lõpetatud tööülesannete ribadel kuvatakse linnukese ikoon.
            1. PM: API: Goal: GET /planning-api/goals/{goalId}/tasks.response.goalActivityTasks.done
   4. Meeskond:
      1. Kuvatakse eesmärgi meeskonnaliikmete nimekiri. 
         1. PM: API: Goal: GET /planning-api/goals/{goalId}/team-members.response.goalTeamMembers
      2. "Protsessijuht" rolliga meeskonnaliikmed kuvatakse nimekirjas esimesena. Nende juures on vastav ikoon.
      3. Kui protsessijuhte on mitu, järjestatakse nad nime järgi tähestikulises järjekorras.
      4. Samal põhimõttel järjestatakse ka kõik ülejäänud meeskonnaliikmed. 
   5. Märkmed:
      1. Kuvatakse maksimaalselt kolm viimati lisatud märget, mis on seotud eesmärgi, selle tegevuste või tööülesannetega. Kogu nimekirja vaatamiseks tuleb avada eraldi märkmete modaalaken.
         1. PM: API: Goal: GET /planning-api/goals/{goalId}/notes.response.goalNotes
         2. Selgitus: Päring tagastab kõik eesmärgi, selle tegevuste ja tööülesannetega seotud avalikud märkmed (st märkmed, mis on nähtavad kõigile, kellel on ligipääas selle eesmärgile). Privaatsetest märkmetest tagastatakse ainult need, mille kasutaja on ise lisanud.

      2. Märkmed järjestatakse muutmise aja järgi kahanevas järjekorras (uuemad eespool). 

         1. PM: API: Goal: GET /planning-api/goals/{goalId}/notes.response.goalNotes.modifiedAt
      3. Kui märkmed puuduvad, kuvatakse tühi teade.
   6. Tööülesanded:
      1. Kuvatakse kõik eesmärgile lisatud tööülesanded, grupeerituna akordionitesse vastavalt tegevustele, mille alla need kuuluvad.
         1. PM: API: Goal: GET /planning-api/goals/{goalId}/tasks.response.goalActivityTasks
         2. Kui eesmärgile ei ole veel ühtegi tööülesannet lisatud, siis ühtegi tegevuste akordionit ei kuvata. Plokis kuvatakse tühi teade. 
      2. Tegevuste akordionid on järjestatud vastavalt tegevusele määratud järjekorrale.
         1. PM: API: Goal: GET /planning-api/goals/{goalId}/activities.response.goalActivities.previousActivityId
      3. Vaikimisi on kõik tegevuste akordionid suletud.
      4. Iga tööülesande kohta kuvatakse selle nimetus ja vastutava isiku initsiaalid. 
      5. Kui tööülesanne on lõpetatud, kuvatakse see linnutatuna. 
      6. Kui tööülesandele on lisatud märge, kuvatakse selle juures vastav ikoon. 
         1. PM: API: Goal: GET /planning-api/goals/{goalId}/notes.response.goalNotes, mille goalActivityTaskId = real kuvatava tööülesande ID
      7. Tööülesannete kuvamise loogika on täpsemalt kirjeldatud peatükis "Andmed".
4. Kasutajal on võimalik (vastavad nupud on kuvatud / aktiivsed):

   1. Vaadata eesmärgiga seotud väljakutseid:

      1. Kui nupp kuvatakse, on see aktiivne ainult juhul, kui eesmärgile on valitud vähemalt üks väljakutse.
         1. PM: API: Goal: GET /planning-api/goals/{goalId}/assessment-challenges.response.assessmentChallenges != NULL
      2. Nupule vajutamisel avaneb modaalaken eesmärgile valitud väljakutsete nimekirjaga: PM: UC: Eesmärgi väljakutsete vaatamine.
   2. Vaadata eesmärgi mõõdikute andmeid:
      1. Mõõdiku akordioni avamisel kuvatakse kasutajale selle andmed.
      2. Iga uue akordioni avamisel jääb eelmine avatuks. 
   3. Vaadata meeskonnaliikmete andmeid:
      1. Meeskonnaliikme reale vajutamisel avaneb modaalaken kõigi eesmärgi meeskonnaliikmete andmetega: PM: UC: Meeskonnaliikme vaatamine/lisamine/muutmine.
      2. Meeskonnaliikmete andmed kuvatakse mittemuudetavatena. 
   4. Vaadata, milliste teiste eesmärkidega on meeskonnaliikmed seotud:
      1. Vastava nupu vajutamisel kuvab süsteem kasutajale meeskonnaliikmete eesmärkide nimekirja vaate: PM: UC: Meeskonnaliikmete eesmärkide nimekirja kuvamine.
   5. Vaadata tegevuste detailandmeid:
      1. Tegevuste nimekirjas tegevuse rea tekstile vajutamisel kuvab süsteem kasutajale modaalakna tegevuse andmetega: PM: UC: Eesmärgi tegevuse vaatamine.
      2. Tegevuste kalendris tegevuse perioodi ribale vajutamisel avab süsteem eraldi aknas tegevuse detailandmed.
   6. Vaadata tööülesannete detailandmeid:
      1. Tööülesannete nimekirjas tööülesande rea tekstile vajutamisel kuvab süsteeem kasutajale modaalakna tööülesande andmetega: PM: UC: Eesmärgi tööülesande vaatamine. 
      2. Tegevuste kalendris tööülesande perioodi ribale vajutamisel avab süsteem eraldi aknas tööülesande detailandmed. Vaata peatükis "Andmed" ploki"Tegevuse või tööülesande detailandmed". 

   7. Vaadata kõiki eesmärgi, selle tegevuste või tööülesannete kohta lisatud märkmeid:

      1. Vastav nupp on aktiivne ainult juhul, kui eesmärgil, selle tegevusel või tööülesandel, on vähemalt üks märge olemas. 
         1. PM: API: Goal: GET /planning-api/goals/{goalId}/notes.response.goalNotes != NULL
         2. Kui märkmeid ei ole, kuvatakse nuppu mitteaktiivsena. 
      2. Nupule vajutamisel avaneb modaalaken eesmärgi märkmetega: PM: UC: Eesmärgi märkmete vaatamine.

Andmed

Kasutaja tegevused