Üldkirjeldus

Teenus võimaldab lisada eesmärgile ChatGPT poolt genereeritud ühelauselise eesmärgi kirjelduse näidise, mis järgib SMART põhimõtteid. Kirjelduse näidis luuakse eesmärgiga seotud väljakutsete kirjelduste põhjal.

Seotud andmeobjektid:

Seotud Jira taskid

NSIL-705 - Getting issue details... STATUS

NSIL-903 - Getting issue details... STATUS

Eeltingimused ja kasutusõigused

Kui tegemist on asutusepõhise eesmärgiga (Goal.goalScope = INSTITUTIONAL):
- Kasutajal on seos eesmärgi asutusega ja sama asutuse eesmärkide lisamise ja muutmise õigus.
  - Goal.institution.id = Kasutaja poolt valitud rolliga seotud asutus
  - Õigust reguleerib privileeg: HSILM_PLANNING_GOAL_MANAGE.
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 = Päringu käivitanud kasutaja isikukood.
  - Goal.institution.id = Kasutaja poolt valitud rolliga seotud asutus
  - Goal.jobsite = Kasutaja poolt valitud rolliga seotud ametikoht
  - Eraldi privileegi ei ole vaja.
Või kasutaja on eesmärgi meeskonnas ja planeerimise meeskonna liikme rollil on eesmärkide lisamise ja muutmise õigus.
- Goal.goalScope = INSTITUTIONAL või INDIVIDUAL
- Goal.teamMembers.id = GoalTeamMember.id, mille personalCode = Päringu käivitanud kasutaja isikukood
- Õigust reguleerib privileeg: HSILM_PLANNING_GOAL_MANAGE.

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

Sisendid

Atribuut	Kohustuslikkus, mitmesus	Tüüp	Vaikeväärtus, valideerimine	Kirjeldus, täiendav info
goalId	1	String	Eesmärk peab eksisteerima ja ei tohi olla arhiveeritud. Goal.id = goalId Goal.archived = false Eesmärgil peab olema vähemalt üks väljakutse. Goal.assessmentChallengeIds != null Eesmärgil ei tohi olla AI poolt pakutud eesmärgi kirjeldust. Goal.aiDescription = null	Eesmärgi unikaalne identifikaator, mille jaoks saadakse ChatGPT mudelilt kirjelduse soovitus.

Väljundid

Atribuut	Kohustuslikkus, mitmesus	Tüüp	Kirjeldus, täiendav info
Samad mis teenusel PM: API: Goal: POST /planning-api/goals#V%C3%A4ljundid.

Tegevused

Süsteem kontrollib, kas kasutajal on õigust päringut teostada.
1. Kui kasutajal õigust pole, lõpetatakse päringu töötlemine ja tagastatakse http veakood.
Süsteem kontrollib, kas andmed vastavad nõuetele.
1. Kui andmed ei vasta nõuetele, siis lõpetatakse päringu töötlemine ja tagastatakse http veakood.
Süsteem kontrollib, kas sisendis esitatud eesmärk (goalId) eksisteerib ja kas päringu käivitanud kasutajal on õigus selle andmeid hallata.
1. Kontroll toimub vastavalt üldreeglites kirjeldatud loogikale.
2. Kui eesmärki ei leita või see ei vasta üldreeglitele, lõpetatakse päringu töötlemine ja tagastatakse http veakood.
Süsteem kontrollib, kas eesmärgil puudub AI poolt pakutud kirjeldus ja kas sellega on seotud vähemalt üks väljakutse.
1. Süsteem kontrollib, kas Objektid#Goal objekt, mille id = sisendis esitatud goalId ja archived = false, vastab järgmistele tingimustele:
  1. aiDescription = NULL
  2. assessmentChallengeIds nimekirjas on vähemalt üks id
2. Kui tingimused ei ole täidetud, lõpetatakse päringu töötlemine ja tagastatakse http veakood.
Süsteem otsib eesmärgiga seotud väljakutsete kirjeldused.
1. Süsteem otsib Objektid#AssessmentChallenge objekte, mille:
  1. id = Goal.assessmentChallengeIds, kus id = sisendis esitatud goalId
  2. elements.code = "CHALLENGE"
  3. elements.textAreaValue != NULL
Süsteem saadab OpenAI API kaudu päringu ChatGPT mudelile eesmärgi soovituse saamiseks, edastades leitud väljakutsete kirjeldused (AssessmentChallenge.elements.textAreaValue).
1. OpenAI käsk
  1. Kui päring ebaõnnestub, lõpetatakse päringu töötlemine ja tagastatakse OpenAI veakood.
Süsteem lisab eesmärgile ChatGPT soovitatud kirjelduse.
1. Süsteem uuendab Objektid#Goal objekti andmeid:
  1. aiDescription = OpenAI API päringust saadud eesmärgi kirjelduse soovitus
  2. audit = audit (muutmine)
Süsteem tagastab muudetud andmed.