PM: UC: Arengukava kehtivate jagamiste vaatamine ja kustutamine

Sisukord

Üldkirjeldus

Kasutajal on võimalik vaadata genereeritud arengukava PDF- ja URL-versioonide nimekirja. Iga versiooni puhul saab selle avada vastava URL-i kaudu või alla laadida PDF-failina. Vajadusel on kasutajal võimalik versioon kustutada.

Kasutaja saab kehtivate jagamiste modaalakna avada vaates PM: UC: Arengukava lisamine/muutmine.

Asutusepõhise arengukava puhul peab kasutajal olema vastava asutuse arengukava lisamise ja muutmise õigus.
Isikupõhise arengukava puhul annab kasutajale õiguse enda kehtivate ja lõppenud ametikohtadega seotud arengukava versioonide vaatamiseks, allalaadimiseks ja kustutamiseks tema isikukood.

Seotud Jira taskid

NSIL-1049 - Getting issue details... STATUS

Kasutajaliides

Disainid

Kehtivate jagamiste modaalaken: https://www.figma.com/design/mPPdrh04luwBeiX856NQPP/NAPO---TWN?node-id=9037-24760&t=bPEd5qlJLWyKWicN-4

Eeltingimused

Kasutaja on sisse loginud ja valinud sobiva rolli:

Kui tegemist on asutusepõhise arengukavaga (DevelopmentPlan.developmentPlanScope = "INSTITUTIONAL"):
- Arengukava peab olema muudetav ja sellele peab olema määratud periood.
  - DevelopmentPlan.editable = TRUE,
  - DevelopmentPlan.startDate != NULL,
  - DevelopmentPlan.endDate != NULL.
- Kasutajal peab olema seos arengukava asutusega ning selle asutuse arengukava lisamise ja muutmise õigus.
  - DevelopmentPlan.institution.id = kasutaja valitud rolliga seotud asutus,
  - Õigust reguleerib privileeg: HSILM_PLANNING_DEV_PLAN_MANAGE.
Kui tegemist on isikupõhise arengukavaga (DevelopmentPlan.developmentPlanScope = "INDIVIDUAL"):
- Arengukava peab olema muudetav ja sellele peab olema määratud periood.
- Kasutaja peab olema arengukava omanik.
  - DevelopmentPlan.personalCode = kasutaja isikukood.
- Eraldi privileegi ei ole vaja - õiguse annab kasutaja isikukood.
Planeerimise meeskonnaliikme rolli kasutajatel puudub ligipääs arengukavadele ja nende versioonidele.

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

Funktsionaalsus

Selgitused

Vaate avamisel:
1. Kasutajaliides teeb kehtivate jagamiste saamiseks päringu: PM: API: DevelopmentPlan: GET /planning-api/development-plans/{developmentPlanId}/versions.
  1. Päringu sisend:
    1. developmentPlanId = muudetava arengukava ID, mille vaates jagamiste vaatamine algatati
      1. PM: API: DevelopmentPlan: GET /planning-api/development-plans.response.id
      2. PM: API: DevelopmentPlan: POST /planning-api/development-plans.response.id
2. Avanenud modaalaknas kuvatakse eraldi nimekirjades genereeritud PDF- ja URL-versioonid.
  1. PM: API: DevelopmentPlan: GET /planning-api/development-plans/{developmentPlanId}/versions.response.developmentPlanVersions
  2. PDF-failina genereeritud versioonidel on päringu vastuses: versionType = "PDF"
  3. URL-iga jagatud versioonidel on päringu vastuses: versionType = "URL"
3. Mõlemad nimekirjad on järjestatud genereerimise aja alusel kasvavalt.
  1. PM: API: DevelopmentPlan: GET /planning-api/development-plans/{developmentPlanId}/versions.response.developmentPlanVersions.validFrom
Kasutajal on võimalik:
1. Filtreerida URL-versioonide nimekirja, et kuvaks ainult avalikud URL-versioonid.
  1. PM: API: DevelopmentPlan: GET /planning-api/development-plans/{developmentPlanId}/versions.response.developmentPlanVersions, mille urlPublic = true
2. Laadida alla arengukava PDF-versiooni faili:
  1. Nupule vajutamisel käivitatakse päring: PM: API: DevelopmentPlan: GET /planning-api/development-plans/{developmentPlanId}/versions/{versionId}/files/{fileId}/download
    1. Päringu sisend:
      1. developmentPlanId = muudetava arengukava ID, mille PDF-versiooniga on tegemist
        PM: API: DevelopmentPlan: GET /planning-api/development-plans.response.id
        PM: API: DevelopmentPlan: POST /planning-api/development-plans.response.id
      2. versionId = arengukava versiooni ID, mille PDF-faili soovitakse alla laadida
        PM: API: DevelopmentPlan: GET /planning-api/development-plans/{developmentPlanId}/versions.response.developmentPlanVersions.id
      3. fileId = allalaetava faili ID
        PM: API: DevelopmentPlan: GET /planning-api/development-plans/{developmentPlanId}/versions.response.developmentPlanVersions.fileId
3. Kustutada versiooni:
  1. Nupule vajutamisel käivitatakse päring: PM: API: DevelopmentPlan: DELETE /planning-api/development-plans/{developmentPlanId}/versions/{versionId}.
  2. Päringu sisend:
    1. developmentPlanId = muudetava arengukava ID, mille versiooni kustutatakse
      1. PM: API: DevelopmentPlan: GET /planning-api/development-plans.response.id
      2. PM: API: DevelopmentPlan: POST /planning-api/development-plans.response.id
    2. versionId = kustutava versiooni ID
      1. PM: API: DevelopmentPlan: GET /planning-api/development-plans/{developmentPlanId}/versions.response.developmentPlanVersions.id
4. Avada URL-versiooni eraldi brauseriaknas või kopeerida link lõikepuhvrisse:
  1. Nupu vajutamisel koostab süsteem lingi vastavalt versiooni andmetele. Lingi genereerimise loogika on kirjeldatud lehel PM: UC: Arengukava URL-versiooni loomine.

Andmed

Elemendi nimetus	Selgitus/Näide
Kehtivad PDF versioonid	Sektsioonis kuvatakse kõik genereeritud arengukava PDF-versioonid. Kui arengukavast ei ole veel ühtegi PDF-versiooni loodud, siis seda sektsiooni ei kuvata. Kui on loodud 20 PDF-versiooni, kuvatakse infoteade: "PDF-versioonide piirarv on saavutatud. Uue versiooni genereerimiseks eemaldage eelnevalt üks olemasolevatest." (vt. näidist Figmas).
-	Arengukava PDF-versiooni jagamise kuupäev. PM: API: DevelopmentPlan: GET /planning-api/development-plans/{developmentPlanId}/versions.response.developmentPlanVersions.validFrom, mille id = real kuvatava versiooni ID
-	Arengukava perioodi algus- ja lõpukuupäevad. PM: API: DevelopmentPlan: GET /planning-api/development-plans/{developmentPlanId}/versions.response.developmentPlanVersions.developmentPlan.startDate, mille id = real kuvatava versiooni ID PM: API: DevelopmentPlan: GET /planning-api/development-plans/{developmentPlanId}/versions.response.developmentPlanVersions.developmentPlan.endDate, mille id = real kuvatava versiooni ID
Jagaja initsiaalid	Arenguakava PDF-versiooni loonud kasutaja ees- ja perenime initsiaalid. PM: API: DevelopmentPlan: GET /planning-api/development-plans/{developmentPlanId}/versions.response.developmentPlanVersions.generator.firstName, mille id = real kuvatava versiooni ID PM: API: DevelopmentPlan: GET /planning-api/development-plans/{developmentPlanId}/versions.response.developmentPlanVersions.generator.lastName, mille id = real kuvatava versiooni ID
Kehtivad URL-versioonid	Sektsioonis kuvatakse kõik genereeritud arengukava URL-versioonid. Kui arengukavast ei ole veel loodud ühtegi URL-versiooni, siis seda sektsiooni ei kuvata. Kui on loodud 20 URL-versiooni, kuvatakse infoteade: "URL-versioonide piirarv on saavutatud. Uue versiooni genereerimiseks eemaldage eelnevalt üks olemasolevatest." (vt. näidist Figmas).
-	Arengukava URL-versiooni jagamise kuupäev. PM: API: DevelopmentPlan: GET /planning-api/development-plans/{developmentPlanId}/versions.response.developmentPlanVersions.validFrom, mille id = real kuvatava versiooni ID
-	Arengukava perioodi algus- ja lõpukuupäevad. PM: API: DevelopmentPlan: GET /planning-api/development-plans/{developmentPlanId}/versions.response.developmentPlanVersions.developmentPlan.startDate, mille id = real kuvatava versiooni ID PM: API: DevelopmentPlan: GET /planning-api/development-plans/{developmentPlanId}/versions.response.developmentPlanVersions.developmentPlan.endDate, mille id = real kuvatava versiooni ID
Silt "AVALIK"	Versioon märgitakse sõnaga "AVALIK", kui vastav genereeritud URL on avalikkusele kättesaadav. PM: API: DevelopmentPlan: GET /planning-api/development-plans/{developmentPlanId}/versions.response.developmentPlanVersions.urlPublic = true
Jagaja initsiaalid	Kehtiva arenguakava URL-versiooni loonud kasutaja ees- ja perenime initsiaalid. PM: API: DevelopmentPlan: GET /planning-api/development-plans/{developmentPlanId}/versions.response.developmentPlanVersions.generator.firstName, mille id = real kuvatava versiooni ID PM: API: DevelopmentPlan: GET /planning-api/development-plans/{developmentPlanId}/versions.response.developmentPlanVersions.generator.lastName, mille id = real kuvatava versiooni ID

Kasutaja tegevused

Tegevuse nimetus	Selgitus
Valik "Näita ainult avalikke" märkimine	Märkeruudu märkimisel kuvatakse nimekirjas "Kehtivad URL-versioonid" ainult need jagamised, mis on määratud avalikuks. PM: API: DevelopmentPlan: GET /planning-api/development-plans/{developmentPlanId}/versions.response.developmentPlanVersions.urlPublic = true
PDF-versioonide nimekirjas allalaadimise ikooni vajutamine	Nupule vajutamisel algatab süsteem vastava versiooni PDF-faili allalaadimise kasutaja arvutisse, käivitades päringut: PM: API: DevelopmentPlan: GET /planning-api/development-plans/{developmentPlanId}/versions/{versionId}/files/{fileId}/download
URL-versioonide nimekirjas suunamise ikooni vajutamine	Nupule vajutamisel genereerib süsteem vastava versiooni jaoks lingi ja avab selle veebilehitsejas eraldi aknas. Avatav URL viib vaatesse PM: UC: Arengukava vaatamine, kus kuvatakse valitud versiooni andmed.
URL-versioonide nimekirjas lingi ikooni vajutamine	Nupule vajutamisel genereerib süsteem vastava versioni jaoks URL-i ja salvestab selle arvuti lõikepuhvrisse.
PDF- või URL-versioonide nimekirjas prügikasti ikooni vajutamine	Nupule vajutamisel: Süsteem küsib kinnitust versiooni kustutamiseks. Kui kasutaja vajutab "X" või "Katkesta": Versiooni ei kustutata ja kinnitusaken suletakse. "Kehtivad jagamised" modaalaken jääb avatuks. Kui kasutaja kinnitab kustutamise: Süsteem käivitab päringu: PM: API: DevelopmentPlan: DELETE /planning-api/development-plans/{developmentPlanId}/versions/{versionId}. Kui kustutamine õnnestub: Kasutajale kuvatakse uuendatud kujul versioonide nimekiri koos eduteatega. Kui kustutatakse viimane allesjäänud versioon, sulgub "Kehtivad jagamised" modaalaken automaatselt.