PM Arengukava lisamine/muutmine

Sisukord

Üldkirjeldus

Kasutajal on võimalik lisada ja muuta arengukava sisu ja muuta arengukava perioodi. Perioodi põhjal kuvatakse arengukavale eesmärgid.

Kasutaja jõuab arengukava lisamise/muutmise vaatesse töölaualt kui tal on planeerimise moodulis arengukava lisamise ja muutmise õigus.

Kasutajaliides

Jäljerida

Avaleht → Töölaud → Arengukava

Disainid

Arengukava vaade vaikimisi, kui asutusele ei ole lisatud ühtegi eesmärki: https://www.figma.com/design/mPPdrh04luwBeiX856NQPP/NAPO---TWN?node-id=6405-51196&t=AiT2LYeEuLJWZMx7-4
Arengukava muutmine: https://www.figma.com/design/mPPdrh04luwBeiX856NQPP/NAPO---TWN?node-id=6415-65423&t=AiT2LYeEuLJWZMx7-4

Eeltingimused

Kasutaja on sisse loginud,
valinud rolli ja
valitud rollil on arengukava lisamise/muutmise õigus (vt. täpsemalt PM Kasutusõigused ja rollid).

Funktsionaalsus

Selgitused

Kasutajaliides teeb arengukava andmete kuvamiseks päringu: PM API Arengukava päring
Arengukava sektsioonid on järjestatud järjekorra numbri alusel.
Eesmärgi mõõdikute akordionid on vaikimisi avatud.
Kui asutusel puudub salvestatud arengukava, siis süsteem pärib arengukavale lisatavate eesmärkide nimekirja: PM API Arengukava eesmärkide päring
1. Kui päring tagastab eesmärgid, siis süsteem algatab vaikimisi arengukava lisamise: PM API Arengukava salvestamine
  1. Vaikimisi salvestatakse arengukava perioodiks aktiivsete eesmärkide varaseim tegevuse algus kuni hiliseim tegevuse lõpp.
  2. Vaikimisi salvestatakse 5 arengukava sektsiooni vastavas järjekorras: Sissejuhtatus, Missioon, Visioon, Põhiväärtused, Riskid.
2. Kui arengukavale lisatavaid eesmärke ei leidunud, siis arengukava lisamist ei algatata.
  1. Arengukava periood jääb tühjaks ning kasutajale kuvatakse teade, et arengukava lisamise alustamiseks on vaja valida periood.
Arengukava perioodi lisamine või muutmine, või logo lisamine käivitab arengukava salvestamise: PM API Arengukava salvestamine
Kui kasutaja lisab/muudab tekstialas vähemalt ühte tähemärki või kasutab vormindamist, siis käivitatakse vormielemendi salvestamine: PM API Vormielemendi salvestamine

Andmed

Kasutatavad andmeolemid: Asutus(Institution), Arengukava(DevelopmentPlan), Arengukavasektsioon(DevelopmentPlanSection), Arengukavavormielement(DevelopmentPlanElement), Eesmärk(Goal), Eesmärgimõõdik(GoalMetrics), Mõõdikuaruanne(GoalMetricsReport), Mõõdikusihttase(GoalMetricsTarget)

Elemendi nimetus	Selgitus/Näide
-	Arengukava asutuse nimetus Mittemuudetav
-	Arengukavale laetud logo pilt
Perioodi algus	Arengukava perioodi algus kuupäev. Valitud kuupäeva alusel kaasatakse arengukavasse eesmärgid, mille periood (varaseima tegevuse algus kuni hiliseima tegevuse lõpp) kattub arengukava perioodiga. Kuupäevaväli Vaikimisi väärtuseks aktiivsete eesmärkide varaseim tegevuse algus Kohustuslik Valiku tegemise järel käivitab süsteem arengukava salvestamise (PM API Arengukava salvestamine) ja värskendab arengukava vaate (sh. kuvab eesmärke, mille periood kattub arengukava uue perioodiga).
Perioodi lõpp	Arengukava perioodi lõpu kuupäev Kuupäevaväli Vaikimisi väärtuseks aktiivsete eesmärkide hiliseim tegevuse lõpp Kohustuslik Valiku tegemise järel käivitab süsteem arengukava salvestamise (PM API Arengukava salvestamine) ja värskendab arengukava vaate (sh. kuvab eesmärke, mille periood kattub arengukava uue perioodiga).
Arengukava sektsioonide andmed
-	Arengukava sektsiooni pealkiri Kuvatakse sektsiooni päises mittemuudetavana.
Peida dokumendis	Näitab kas sektsiooni kuvatakse arenguakava URLiga jagamisel või PDFi genereerimisel. Märkeruut Vaikimisi linnutamata
Arengukava vormielementide andmed
-	Vormielemendi väärtusena kuvatakse vastavalt vormielemendi tüübile kas: tekstiala (pikenev, maks. 2500 tähemärki), pilt või näitaja (PBI aruanne).
Eesmärkide andmed
-	Iga eesmärgi pealkirjana kuvatakse eesmärgi nimetus koos järjekorra numbriga arengukavas. Mittemuudetav
-	Eesmärgi nimetuse all kuvatakse eesmärgi kirjeldus. Mittemuudetav
Eesmärgi mõõdikute kohta kuvatavad andmed
-	Mõõdiku akordioni pealkirjana kuvatakse mõõdiku kirjelduse tekst. Vaikimisi on kõik mõõdikute akordionid avatud. Mittemuudetav
-	Mõõdiku näitajate nimekirjas kuvatakse mõõdikule valitud näitajad. Mittemuudetav
-	Mõõdiku sihttasemete nimekirjas kuvatakse mõõdikule määratud sihttasemed. Iga määratud sihttaseme kohta kuvatakse aasta ja sihttaseme kirjeldus. Mittemuudetav

Arengukava eesmärkide päringu reeglid

Kasutaja peab olema sisse loginud, tal peab olema arenguakava lisamise/muutmise õigus (vt. täpsemalt PM Kasutusõigused ja rollid).
Eesmärke otsitakse arengukavale järgmiste reeglite alusel:
- Eesmärgi seisund on "Aktiivne".
- Eesmärgil on vähemalt üks tegevus.
- Otsitakse eesmärgi perioodi vähemalt osalist sisaldumist arengukava perioodis, st eesmärgi perioodi lõpp (hiliseim tegevuse lõpp) ei tohi olla varasem arengukava perioodi algusest ja eesmärgi perioodi algus (varaseim tegevuse algus) ei tohi olla hilisem arengukava perioodi lõpust.
  - Kui eesmärgi tegevusel ei ole algust märgitud, siis loetakse alguseks lõpukuupäeva, st tegevus lõpukuupäevaga 18.09.2024 loetakse 1 päevaseks tegevuseks vastaval kuupäeval.
Arengukava eesmärkide päring peaks olema kättesaadav eraldi API otspunktina, et oleks selle kaudu KOVil võimalik endale koondvaadet saada.

Arengukava salvestamise reeglid

Kasutaja peab olema sisse loginud, tal peab olema arenguakava lisamise/muutmise õigus (vt. täpsemalt PM Kasutusõigused ja rollid).
Asutusel ei tohi arengukava lisamisel juba olemas olla muudetavat (isEditable = true) arengukava.
Kohustuslikud andmed: startDate, endDate
Süsteemi poolt automaatselt lisatavad väärtused:
- developmentPlanId - süsteem genereerib unikaalse koodi arengukava esmasel salvestamisel
- institutionId - süsteem salvestab viite asutusele, mille kasutaja rollina valinud
- isEditable - süsteem määrab vaikimisi true arengukava esmasel salvestamisel
Mittemuudetavad andmed:
- alati: developmentPlanId, institutionId, isEditable
Vaikimisi salvestatakse esmasel salvestamisel arengukavale 5 sektsiooni vastavas järjekorras: Sissejuhtatus, Missioon, Visioon, Põhiväärtused, Riskid.
- Lisatavatel sektsioonidel on vaikimisi "Peida dokumendis" märkimata (isHidden = false).

Vormielemendi salvestamise reeglid

Kasutaja peab olema sisse loginud, tal peab olema arengukava lisamise/muutmise õigus (vt. täpsemalt PM Kasutusõigused ja rollid).
Vormielemente saab lisada/muuta ainult muudetaval (isEditable = true) arengukaval.
Kohustuslikud andmed: developmentPlanId, developmentPlanSectionId, vormielemendi lisamisel inputTypeCl
Süsteemi poolt automaatselt lisatavad väärtused:
- developmentPlanElementId - süsteem genereerib unikaalse koodi esmasel salvestamisel
- developmentPlanReportId - süsteem genereerib unikaalse koodi esmasel salvestamisel
- elementValue - pildi või näitaja puhul salvestab süsteem viite pildi failile või aruandele/näitajale
Mittemuudetavad andmed:
- alati: developmentPlanElementId, developmentPlanReportId, inputTypeCl
- Pildi või näitaja tüüpi vormielementide andmestikku saab ainult lisada, mitte muuta.
Arengukavale lisatud aruande/näitaja viited salvestatakse arengukava juurde maha.

Kasutaja tegevused

Tegevuse nimetus	Selgitus
Nupu "Laadi logo üles" vajutamine	Nupule vajutamisel avaneb kasutajale arvutist faili üles laadimise aken ning pildi faili valikul käivitab süsteem faili salvestamise arengukavale (PM API Arengukava salvestamine).
Nupu "Laadi logo üles" vajutamine	Pildi salvestamise reeglid Lubatud vormingud: jpg jpeg png svg bmp Faili maksimaalne suurus võib olla kuni 15 MB.
Nupu "Jagamine" vajutamine	Nupule vajutamisel kuvab süsteem kasutajale võimalike tegevuste menüü valikutega "Loo PDF", "Loo URL" ja "Kehtivad jagamised".
	"Loo PDF" vajutamisel käivitab süsteem arengukava PDFi genereerimise (vt. PM Arengukava PDFi genereerimine) ning genereeritud fail laetakse alla kasutaja arvutisse.
	"Loo URL" vajutamisel kuvab süsteem kasutajale modaalakna URL kokkuvõtte loomiseks (vt. PM Arengukava URL versiooni loomine).
	"Kehtivad jagamised" vajutamisel kuvab süsteem kasutajale modaalakna kehtivate jagamistega (vt. PM Arengukava kehtivate jagamiste vaatamine ja kustutamine)
Sektsiooni ees/järgi kuvatav "+" nupp	Nupule vajutamisel kuvab süsteem kasutajale modaalakna sektsiooni lisamiseks (vt. PM Arengukava sektsiooni lisamine/muutmine).
Sektsiooni päises "Peida dokumendis" linnutamine/linnukese eemaldamine	Märkeruudu linnutamisel või linnukese eemaldamisel käivitab süsteem sektsiooni märke muutmise päringu PM API Sektsiooni peitmise märke salvestamine.
	Sektsiooni peitmise märke salvestamise reeglid Kasutaja peab olema sisse loginud, tal peab olema arengukava lisamise/muutmise õigus (vt. täpsemalt PM Kasutusõigused ja rollid). Sektsiooni peitmise märget saab muuta ainult muudetaval (isEditable = true) arengukaval.
Sektsiooni päises kolme punktiga ikooni vajutamine	Kolme punktiga ikoonile vajutamisel kuvab süsteem kasutajale võimalike tegevuste menüü valikutega "Muuda" ja "Kustuta".
	"Muuda" vajutamisel kuvab süsteem kasutajale modaalakna sektsiooni muutmiseks (vt. PM Arengukava sektsiooni lisamine/muutmine).
	"Kustuta" vajutamisel kuvab süsteem kasutajale kustutamise kinnitamise modaalakna. Kui kasutaja kinnitab sektsiooni kustutamise nupu "Kinnita" vajutamisega, siis süsteem käivitav sektsiooni kustutamise (vt. PM API Sektsiooni kustutamine). Kui kasutaja vajutab "X" või "Katkesta", siis sektsiooni ei kustutata ja süsteem sulgeb modaalakna.
	Sektsiooni kustutamise reeglid Kasutaja peab olema sisse loginud, tal peab olema lisamise/muutmise õigus (vt. täpsemalt PM Kasutusõigused ja rollid). Sektsiooni saab kustutada ainult muudetaval (isEditable = true) arengukaval. Sektsiooni kustutamisel kustutatakse sektsioon, selle vormielemendid ja aruande tüüpi vormielemendi väärtuseks märgitud aruanne.
Sektsiooni sees kuvatav "+" nupp	Nupule vajutamisel kuvab süsteem kasutajale võimalike vormielementide tüüpide menüü valikutega "Lisa tekstiala", "Lisa pilt" ja "Lisa näitaja juhtimislaualt".
	"Lisa tekstiala" vajutamisel lisab süsteem vormile nupu asukohta uue tekstiala.
	"Lisa pilt" vajutamisel avaneb kasutajale arvutist faili üles laadimise aken ning pildi faili valikul käivitab süsteem faili salvestamise arengukava vormielemendina (PM API Vormielemendi salvestamine).
	"Lisa näitaja juhtimislaualt" vajutamisel kuvab süsteem kasutajale modaalakna näitaja lisamiseks (vt. PM Arengukava sektsiooni näitaja lisamine).
Vormielemendil prügikasti ikooni vajutamine	Ikooni vajutamisel käivitab süsteem vormielemendi ja selle väärtuse kustutamise (PM API Vormielemendi kustutamine).
Vormielemendil prügikasti ikooni vajutamine	Vormielemendi kustutamise reeglid Kasutaja peab olema sisse loginud, tal peab olema lisamise/muutmise õigus (vt. täpsemalt PM Kasutusõigused ja rollid). Vormielemendi saab kustutada ainult muudetaval (isEditable = true) arengukaval. Kustutamisel kustutatakse vormielement ja aruande tüüpi vormielemendi väärtuseks märgitud aruanne.
Tekstialas vormindamise ikoonidele vajutamine	Kasutajal on võimalik teksti vormindada järgmiselt: võimalik on lülitada sisse/välja rasvast, kaldkirjas ja alljoonitud teksti, võimalik on lisatud nummerdatud ja nummerdamata nimekirju, võimalik on lisada veebilehe linke. Vorminduse muutmine käivitab vormielemendi salvestamise (PM API Vormielemendi salvestamine).
Tekstialas tähemärgi lisamine/eemaldamine	Tähemärgi lisamine/eemaldamine käivitab vormielemendi salvestamise (PM API Vormielemendi salvestamine).
Nupu "Tagasi töölauale" vajutamine	Nupule vajutamisel suunab süsteem kasutaja tagasi töölauale (vt. DT Töölaua vaatamine).
Lingile "Viimati vaadatud" vajutamine	Lingile vajutamisel avaneb modaalaken viimati lehte vaadanud kasutajate nimekirjaga (vt. PM Viimaste vaatamiste nimekirja kuvamine).