PM: UC: Eesmärgi tegevuse vaatamine

Sisukord

Üldkirjeldus

Kasutaja saab vaadata kõiki tegevuse andmeid, sh tegevuse kohta sisestatud märkmeid.

Tegevuse andmete modaalakna saab avada vaadetest:

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

Seotud Jira taskid

NSIL-1125 - Getting issue details... STATUS

NSIL-1111 - Getting issue details... STATUS

NSIL-881 - Getting issue details... STATUS

NSIL-1174 - Getting issue details... STATUS

NSIL-1148 - Getting issue details... STATUS

Kasutajaliides

Disainid

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.  Tegevuse andmete saamiseks: PM: API: Goal: GET /planning-api/goals/{goalId}/activities/{goalActivityId}
         1. Päringu sisend:
            1. goalId = eesmärgi ID, mille vaates tegevuse vaatamine algatati
            2. goalActivityId = tegevuse ID, mille jaoks vaatamise tegevus algatati
      2. Tööülesannete rahastuse allikate saamiseks: PM: API: Goal: GET /planning-api/goals/{goalId}/tasks.
         1. Päringu sisend: sama, mis eelmisel päringul.
      3. Tegevuse märkmete nimekirja saamiseks: PM: API: Goal: GET /planning-api/goals/{goalId}/notes.
         1. Päringu sisend:
            1. goalId = eesmärgi ID, mille vaates tegevuse vaatamine algatati
            2. goalActivityId = tegevuse ID, mille jaoks vaatamise tegevus algatati
         2. Selgitus: 
            1. Päringuga tagastatakse kõik tegevusega 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 tegevuse vaatamise vorm, kus kõik väljad on eeltäidetud eelnevate päringute andmetega:
   1. Tegevuse rahastuse allikad:
      1. Tabel kuvatakse alati.
      2. Tabel on eeltäidetud päringu PM: API: Goal: GET /planning-api/goals/{goalId}/activities/{goalActivityId} 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}.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}.response.fundings.amount
   2. Tegevuse alla kuuluvate tööülesannete rahastuse allikad: 
      1. Tabel kuvatakse ainult siis, kui tegevusel leidub mõni tööülesanne, millele on lisatud rahastuse allikaid.
         1. PM: API: Goal: GET /planning-api/goals/{goalId}/tasks.response.goalActivityTasks - vähemalt ühe tööülesande fundings != NULL
      2. Rahastuse summad kuvatakse summeerituna aastate kaupa - iga unikaalne aasta kuvatakse tabelis ainult ühe reana.
         1. PM: API: Goal: GET /planning-api/goals/{goalId}/tasks.response.goalActivityTasks.fundings.year
      3. Tabeli lõpus kuvatakse rida "Kokku", kuhu on summeeritud kõigi aastate summad.
   3. 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 tegevuse ja selle märkmetega toimetada järgmiselt:
   
   1. Üldtingimused:
      1. Allpool kirjeldatud tegevused on võimalikud (tegevuste menüüd /nuppud on nähtavad) ainult järgmiste tingimuste täitmisel:
         1. Kasutajal 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ärgi 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. Tegevuse kustutamine:
      1. Vastav nupp on alati aktiivne. 
      2. Nupule vajutamisel käivitatakse päring: PM: API: Goal: DELETE /planning-api/goals/{goalId}/activities/{goalActivityId}.
         1. Päringu sisend:
            1. goalActivityId = tegevuse ID, mille andmed vaates kuvatakse
            2. goalId = eesmärgi ID, millega tegevus on seotud
   3. Tegevuse lõpetatuks märkimine:

      1. Tegevuse lõpetamine on lubatud (vastav nupp kuvatakse aktiivsena) ainult juhul, kui:

         • Tegevuse lõpukuupäev on tulevikus VÕI 
           • PM: API: Goal: GET /planning-api/goals/{goalId}/activities/{goalActivityId}.response.endDate > jooksev kuupäev
         • Vähemalt üks tegevusega seotud tööülesanne on lõpetamata:
           • PM: API: Goal: GET /planning-api/goals/{goalId}/tasks.response.goalActivityTasks.id, mille goalActivityId = tegevuse ID, mille andmed vaates kuvatakse ja done = false.
      2. Kui ülaltoodud tingimused ei ole täidetud, kuvatakse tegevuse lõpetamise nupp mitteaktiivsena. 
      3. Kui nupp on aktiivne ja kasutaja vajutab sellele, käivitatakse päring: PM: API: Goal: PATCH /planning-api/goals/{goalId}/activities/{goalActivityId}/done.
         1. Päringu sisend:
            1. goalActivityId = tegevuse ID, mille andmed vaates kuvatakse
            2. goalId = eesmärgi ID, millega tegevus on seotud
         2. Selgitus:
            1. Kui tegevuse lõpukuupäev on tulevikus, määratakse tegevuse lõpukuupäevaks (GoalActivity.endDate) jooksev kuupäev. 
            2. Kõik tegevusega seotud lõpetamata tööülesanded märgitakse lõpetatuks (GoalActivityTask.done = true).
            3. Kui mõnel lõpetamata tööülesandel on lõpukuupäev (GoalActivityTask.endDate) tulevikus, kirjutatakse see üle jooksva kuupäevaga.
   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 tegevus 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 tegevus on seotud
         2. Kui tegevus õnnestub, uuendatakse märkmete nimekirja.
            1. Kui kustutatati viimane allesjäänud märge, kuvatakse Märkmete plokis tühi teade.
   5. Tegevuste täpsem loogika on kirjeldatud peatükis "Kasutaja tegevused".

Andmed

Kasutaja tegevused