PM: UC: Eesmärgi tööülesande vaatamine

Sisukord

Üldkirjeldus

Kasutaja saab vaadata kõiki tööülesande andmeid, sh tööülesande kohta sisestatud märkmeid.

Tööülesande andmete modaalakna saab avada vaadetest:

• PM: UC: Eesmärkide tegevuste ja ülesannete kirjeldamine (lisamine/muutmine)
• PM: UC: Eesmärkide vaatamine. 

Seotud Jira taskid

NSIL-1126 - Getting issue details... STATUS

NSIL-1174 - Getting issue details... STATUS

NSIL-1148 - Getting issue details... STATUS

Kasutajaliides

Disainid

Tööülesande andmete vaatamise modaalaken: https://www.figma.com/design/mPPdrh04luwBeiX856NQPP/NAPO---TWN?node-id=8783-49954&t=8lfwh9VbRoaWIlQ2-4

Eeltingimused

Kasutaja on sisse loginud ja valinud rolliks:

• Asutus:
  • Kasutajal on seos eesmärgi asutusega ja sama asutuse eesmärkide vaatamise õigus. 
    • Goal.institution.id = kasutaja poolt valitud rolliga seotud asutus
    • Õigust reguleerib privileeg: HSILM_PLANNING_GOAL_VIEW.
• Ametikoht / Arhiiv:
  
  • Kasutaja on eesmärgi omanik.
    • Goal.personalCode = kasutaja isikukood
    • Eraldi privileegi ei ole vaja.
• Planeerimise meeskonna liige:
  • Kasutaja on eesmärgi meeskonnas ja planeerimise meeskonna liikme rollil on eesmärkide vaatamise õigus.
    • Goal.goalScope = INSTITUTIONAL või INDIVIDUAL
    • Goal.teamMembers.id = GoalTeamMember.id, mille personalCode = kasutaja isikukood
    • Õigust reguleerib privileeg: HSILM_PLANNING_GOAL_VIEW.

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

Funktsionaalsus

Selgitused

1. Vaate avamisel:
   1. Kasutajaliides teeb andmete saamiseks järgmised päringud:
      1. Tööülesande andmete saamiseks: PM: API: Goal: GET /planning-api/goals/{goalId}/activities/{goalActivityId}/tasks/{activityTaskId}.
         1. Päringu sisend:
            1. goalId = eesmärgi ID, mille vaates tööülesande vaatamine algatati
            2. goalActivityTaskId = tööülesande ID, mille jaoks vaatamise tegevus algatati
      2. Tööülesande märkmete saamiseks: PM: API: Goal: GET /planning-api/goals/{goalId}/notes.
         1. Päringu sisend:
            1. goalId = eesmärgi ID, mille vaates tööülesande vaatamine algatati
            2. goalActivityTaskId = tööülesande ID, mille jaoks vaatamise tegevus algatati
         2. Selgitus: 
            1. Päringuga tagastatakse kõik tööülesandega seotud märkmed vastavalt neile märgitud nähtavusele.
               1. Kõik märkmed, mille nähtavus "Avalik planeerimiskeskkonnas", tagastatakse alati.
               2. Kõik märkmed, mille nähtavus on "Privaatne (nähtav ainult mulle)", tagastatakse ainult juhul kui andmeid pärib kasutaja, kes märkme lisas.
2. Kasutajale kuvatakse tööülesande vaatamise vorm, kus kõik väljad on eeltäidetud eelnevate päringute andmetega:
   1. Tööülesande rahastuse allikad:
      1. Tabel kuvatakse alati.
      2. Tabel on eeltäidetud päringu PM: API: Goal: GET /planning-api/goals/{goalId}/activities/{goalActivityId}/tasks/{activityTaskId} vastuses tagastatud fundings-objekti kirjetega.
         1. Iga rahastuse allikas kuvatakse eraldi real, aastaid ei gruppeerita. 
      3. Kui rahastuse allikaid pole, kuvatakse tabelis tühi teade.
         1. PM: API: Goal: GET /planning-api/goals/{goalId}/activities/{goalActivityId}/tasks/{activityTaskId}.response.fundings = NULL
      4. Kui vähemalt üks rahastuse allikas on olemas, kuvatakse tabeli lõpus rida "Kokku", kuhu on summeeritud kõigi allikate summad.
         1. PM: API: Goal: GET /planning-api/goals/{goalId}/activities/{goalActivityId}/tasks/{activityTaskId}.response.fundings.amount
   2. Märkmed:
      1. Kuvatakse kõik päringuga saadud märkmed.
      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.
3. Kasutajal on võimalik tööülesande ja selle märkmetega toimetada järgmiselt:
   
   1. Üldtingimused:
      1. Allpool kirjeldatud tegevused on võimalikud (tegevuste menüüd /nupud on nähtavad), kui:
         1. Kasutaja valitud roll EI OLE "Arhiiv" - lõppenud ametikohtadega seotud planeerimise andmeid ei ole lubatud muuta.
         2. Eesmärk ei ole arhiveeritud.
            1. PM: API: Goal: GET /planning-api/goals/{goalId}.response.archived = false
         3. Kasutajal on õigus muuta eesmärkide andmeid:
            1. Kui tegemist on asutusepõhise eesmärgiga (Goal.goalScope = INSTITUTIONAL):
               • Kasutajal on sama asutuse eesmärkide lisamise ja muutmise õigus. 
                 • Õigust reguleerib privileeg: HSILM_PLANNING_GOAL_MANAGE.
            2. Kui tegemist on isikupõhise eesmärgiga (Goal.goalScope = INDIVIDUAL):
               •  Kasutaja on eesmärgi omanik ja tal on seos eesmärgi asutuse ja ametikohaga.
                 • Goal.personalCode = Kasutaja isikukood
                 • Goal.institution.id = Kasutaja poolt valitud rolliga seotud asutus
                 • Goal.jobsite = Kasutaja poolt valitud rolliga seotud ametikoht
               • Eraldi privileegi ei ole vaja.
            3. Või kasutaja on eesmärgi meeskonnas ja planeerimise meeskonna liikme rollil on eesmärkide lisamise ja muutmise õigus. 
   2. Tööülesande kustutamine:
      1. Vastava nupu vajutamisel käivitatakse päring: PM: API: Goal: DELETE /planning-api/goals/{goalId}/activities/{goalActivityId}/tasks/{activityTaskId}.
         1. Päringu sisend:
            1. goalActivityTaskId = tööülesande ID, mille andmed vaates kuvatakse
            2. goalActivityId = tegevuse ID, mille alla tööülesanne kuulub
            3. goalId = eesmärgi ID, mille vaates tööülesande vaatamine algatati
   3. Järgmised tegevused on lubatud ainult siis, kui:
      1. Ülaltoodud tingimused on täidetud.
      2. Tööülesanne ei ole lõpetatud:
         1. PM: API: Goal: GET /planning-api/goals/{goalId}/activities/{goalActivityId}/tasks/{activityTaskId}.response.done = false 
      3. Tööülesande lõpetatuks märkimine:
         1. Kui tööülesanne on lõpetamata, siis vastav nupp kuvatakse aktiivsena. 
            1. Kui tööülesanne on lõpetatud, siis see ikka kuvatakse, kuid mitteaktiivsena. 
         2. Kui nupp on aktiivne ja kasutaja vajutab sellele, käivitatakse päring: PM: API: Goal: PATCH /planning-api/goals/{goalId}/activities/{goalActivityId}/tasks/{activityTaskId}/done.
            1. Päringu sisend:
               1. goalActivityTaskId = tööülesande ID, mille andmed vaates kuvatakse
               2. goalActivityId = tegevuse ID, mille alla tööülesanne kuulub
               3. goalId = eesmärgi ID, mille vaates tööülesande vaatamine algatati
               4. done = true
            2. Selgitus: 
               1. Selle päringuga märgitakse tööülesanne lõpetatuks (GoalActivityTask.done = true).
               2. Kui tööülesande lõpu kuupäev (GoalActivityTask.endDate) on tulevikus, kirjutatakse see üle jooksva kuupäevaga.
               3. Kui lõppkuupäev on minevikus või täna, jääb see muutmata.
      4. Märkme juurest saab avada tegevuste menüü ning valida ühe järgmistest tegevustest:
         1. Märkme muutmine: 
            1. Märkme kirjelduse muudetud teksti salvestamiseks kasutatakse päringut: PM: API: Goal: PUT /planning-api/goals/{goalId}/notes/{goalNoteId}.
               1. Päringu sisend:
                  1. goalNoteId = muudetava märkme ID
                  2. goalId = eesmärgi ID, millega tööülesanne on seotud
                  3. description = väljal "Märkme kirjeldus" sisestatud väärtus
         2. Märkme kustutamine: 
            1. Märkme kustutamiseks kasutatakse päringut: PM: API: Goal: DELETE /planning-api/goals/{goalId}/notes/{goalNoteId}.
               1. Päringu sisend:
                  1. goalNoteId = kustutava märkme ID
                  2. goalId = eesmärgi ID, millega tööülesanne on seotud
            2. Kui kustutamine õnnestub, uuendatakse märkmete nimekirja.
               1. Kui see oli viimane märge, kuvatakse Märkmete plokis tühi teade.
   4. Tegevuste täpsem loogika on kirjeldatud peatükis "Kasutaja tegevused".

Andmed

Kasutaja tegevused