Merge pull request #3223 from Opetushallitus/tor-2240-amis-siirtynyt-…

…tutkinnon-uusiin-perusteisiin-kentta

TOR-2240: Siirtynyt tutkinnon uusiin perusteisiin -kenttä

src/main/resources/localization/koski-default-texts.json

@@ -2759,5 +2759,7 @@
   "MuksRaportti-example": "Jos haluat tulostaa raportin tietylle päivälle, syötä sekä aikajakson alku- että loppupäivämääräkenttään sama päivämäärä.",
   "raportti-excel-muks-title": "Muu kuin säännelty koulutus",
   "raportti-excel-must-tiedoston-etuliite": "muks_suoritustiedot",
-  "raportti-excel-kolumni-yhteislaajuusKaikkiTuntia": "Yhteislaajuus (tuntia)"
+  "raportti-excel-kolumni-yhteislaajuusKaikkiTuntia": "Yhteislaajuus (tuntia)",
+  "Siirtynyt tutkinnon uusiin perusteisiin" : "Siirtynyt tutkinnon uusiin perusteisiin",
+  "description:Onko opiskeluoikeuden päättymisen syy siirtyminen..." : "Onko opiskeluoikeuden päättymisen syy siirtyminen tutkinnon uusiin perusteisiin."
 }

src/main/scala/fi/oph/koski/fixture/KoskiSpecificDatabaseFixtureCreator.scala

@@ -418,6 +418,33 @@ object AmmatillinenOpiskeluoikeusTestData {
     )
   }
 
+  def katsotaanEronneeksiOpiskeluoikeus(oppilaitosId: String, koulutusKoodi: Int = 351301, diaariNumero: String = "39/011/2014", alkamispäivä: LocalDate = date(2019, 5, 30), päättymispäivä: LocalDate = date(2020, 5, 30)): AmmatillinenOpiskeluoikeus = {
+    val oppilaitos: Oppilaitos = Oppilaitos(oppilaitosId, None, None)
+    val koulutusKoodiViite = Koodistokoodiviite(koulutusKoodi.toString, None, "koulutus", None)
+
+    AmmatillinenOpiskeluoikeus(
+      oppilaitos = Some(oppilaitos),
+      suoritukset = List(AmmatillisenTutkinnonSuoritus(
+        koulutusmoduuli = AmmatillinenTutkintoKoulutus(koulutusKoodiViite, Some(diaariNumero)),
+        toimipiste = oppilaitos,
+        suorituskieli = suomenKieli,
+        suoritustapa = AmmatillinenExampleData.suoritustapaOps,
+        keskiarvo = Some(4.0),
+        osasuoritukset = Some(List(pakollinenTutkinnonOsanSuoritus("101050", "Yritystoiminnan suunnittelu", ammatillisetTutkinnonOsat, k3, 40, alkamispäivä)))
+      )),
+      tila = AmmatillinenOpiskeluoikeudenTila(List(
+        AmmatillinenOpiskeluoikeusjakso(alkamispäivä, ExampleData.opiskeluoikeusLäsnä, Some(ExampleData.valtionosuusRahoitteinen)),
+        AmmatillinenOpiskeluoikeusjakso(päättymispäivä, ExampleData.opiskeluoikeusKatsotaanEronneeksi, Some(ExampleData.valtionosuusRahoitteinen))
+      )),
+      lisätiedot = Some(AmmatillisenOpiskeluoikeudenLisätiedot(
+        hojks = None,
+        erityinenTuki = Some(List(Aikajakso(alkamispäivä, None))),
+        vaikeastiVammainen = Some(List(Aikajakso(alkamispäivä, None))),
+        vankilaopetuksessa = Some(List(Aikajakso(alkamispäivä, None)))
+      )),
+    )
+  }
+
   lazy val lähdejärjestelmällinenOpiskeluoikeus: AmmatillinenOpiskeluoikeus =
     opiskeluoikeus(MockOrganisaatiot.stadinAmmattiopisto, versio = Some(11)).copy(lähdejärjestelmänId = Some(AmmatillinenExampleData.winnovaLähdejärjestelmäId("l-050504")))
 

src/main/scala/fi/oph/koski/http/KoskiErrorCategory.scala

@@ -158,6 +158,7 @@ object KoskiErrorCategory {
         val oppiaineitaEiSallita = subcategory("oppiaineitaEiSallita", "9.vuosiluokan suoritukseen ei voi syöttää oppiaineita, kun sillä on vahvistus, eikä oppilas jää luokalle")
         val tilaMuuttunutLopullisenTilanJälkeen = subcategory("tilaMuuttunutLopullisenTilanJälkeen", "Opiskeluoikeuden tilojen valmistunut, eronnut jälkeen ei voi esiintyä muita tiloja")
         val montaPäättävääTilaa = subcategory("montaPäättävääTilaa", "Opiskeluoikeudella voi olla vain yksi opiskeluoikeuden päättävä tila")
+        val eiPäättävääTilaa = subcategory("eiPäättävääTilaa", "Opiskeluoikeudella pitää olla päättävä tila")
         val alkamispäiväPuuttuu = subcategory("alkamispäiväPuuttuu", "Suoritukselle ei ole merkitty alkamispäivää")
         val valmiiksiMerkityltäPuuttuuOsasuorituksia = subcategory("valmiiksiMerkityltäPuuttuuOsasuorituksia", "Valmiiksi merkityllä päätason suorituksella ei voi olla tyhjä osasuorituslista tai opiskeluoikeuden pitää olla linkitetty")
         val tilaltaPuuttuuRahoitusmuoto = subcategory("tilaltaPuuttuuRahoitusmuoto", "Opiskeluoikeuden tilalta vaaditaan rahoitusmuoto")

src/main/scala/fi/oph/koski/schema/Ammatillinen.scala

@@ -82,7 +82,7 @@ case class AmmatillisenOpiskeluoikeudenLisätiedot(
   vaativanErityisenTuenErityinenTehtävä: Option[List[Aikajakso]] = None,
   ulkomaanjaksot: Option[List[Ulkomaanjakso]] = None,
   @SensitiveData(Set(Rooli.LUOTTAMUKSELLINEN_KAIKKI_TIEDOT))
-  hojks: Option[Hojks],
+  hojks: Option[Hojks] = None,
   @Description("Osallistuuko oppija vaikeasti vammaisille järjestettyyn opetukseen. Lista alku-loppu päivämääräpareja. Rahoituksen laskennassa käytettävä tieto.")
   @Tooltip("Tieto siitä, osallistuuko oppija vaikeasti vammaisille järjestettyyn opetukseen (alku- ja loppupäivä). Voi olla useita erillisiä jaksoja. Rahoituksen laskennassa käytettävä tieto.")
   @SensitiveData(Set(Rooli.LUOTTAMUKSELLINEN_KAIKKI_TIEDOT))
@@ -115,6 +115,8 @@ case class AmmatillisenOpiskeluoikeudenLisätiedot(
   maksuttomuus: Option[List[Maksuttomuus]] = None,
   oikeuttaMaksuttomuuteenPidennetty: Option[List[OikeuttaMaksuttomuuteenPidennetty]] = None,
   jotpaAsianumero: Option[Koodistokoodiviite] = None,
+  @Description("Onko opiskeluoikeuden päättymisen syy siirtyminen tutkinnon uusiin perusteisiin.")
+  siirtynytTutkinnonUusiinPerusteisiin: Option[Boolean] = None,
 ) extends OpiskeluoikeudenLisätiedot
   with Ulkomaanjaksollinen
   with SisäoppilaitosmainenMajoitus

src/main/scala/fi/oph/koski/validation/AmmatillinenValidation.scala

@@ -24,6 +24,7 @@ object AmmatillinenValidation {
           validateAmmatillisenKorotus(ammatillinen),
           validateKorotuksenAlkuperäinenOpiskeluoikeus(ammatillinen, henkilö, koskiOpiskeluoikeudet),
           validateOpiskeluoikeudenArvionnit(ammatillinen),
+          validateTutkinnonUusiinPerusteisiinSiirtyminen(ammatillinen),
         )
       case _ => HttpStatus.ok
     }
@@ -398,4 +399,13 @@ object AmmatillinenValidation {
         KoskiErrorCategory.badRequest.validation.arviointi.epäsopivaArvosana(s"""Suorituksen "$suorituksenNimi" arvosana ei voi olla hylätty""")
       }
     })
+
+  private def validateTutkinnonUusiinPerusteisiinSiirtyminen(oo: AmmatillinenOpiskeluoikeus): HttpStatus = {
+    val siirtynytTutkinnonUusiinPerusteisiin = oo.lisätiedot.exists(_.siirtynytTutkinnonUusiinPerusteisiin.contains(true))
+    val katsotaanEronneeksi = oo.tila.opiskeluoikeusjaksot.exists(_.tila.koodiarvo == "katsotaaneronneeksi")
+
+    HttpStatus.validate(!siirtynytTutkinnonUusiinPerusteisiin || katsotaanEronneeksi) {
+      KoskiErrorCategory.badRequest.validation.tila.eiPäättävääTilaa("Opiskeluoikeudella, jonka lisätiedoissa on merkintä 'siirtynyt tutkinnon uusiin perusteisiin', pitää päättyä tilaan 'katsotaan eronneeksi'.")
+    }
+  }
 }

src/test/scala/fi/oph/koski/api/oppijavalidation/OppijaValidationAmmatillinenSpec.scala

@@ -1487,6 +1487,31 @@ class OppijaValidationAmmatillinenSpec extends TutkinnonPerusteetTest[Ammatillin
         }
       }
     }
+
+    "Siirtyminen uudempiin perusteisiin" - {
+      "Tietoa ei voi siirtää, jos opiskeluoikeus ei ole terminaalitilassa" in {
+        val lisätiedot = AmmatillisenOpiskeluoikeudenLisätiedot(siirtynytTutkinnonUusiinPerusteisiin = Some(true))
+        val opiskeluoikeus = defaultOpiskeluoikeus.copy(
+          lisätiedot = Some(lisätiedot),
+          tila = AmmatillinenOpiskeluoikeudenTila(List(
+            AmmatillinenOpiskeluoikeusjakso(LocalDate.of(2000, 1, 2), ExampleData.opiskeluoikeusLäsnä, Some(ExampleData.valtionosuusRahoitteinen)),
+          )),
+        )
+        setupOppijaWithOpiskeluoikeus(opiskeluoikeus) {
+          verifyResponseStatus(400, KoskiErrorCategory.badRequest.validation.tila.eiPäättävääTilaa("Opiskeluoikeudella, jonka lisätiedoissa on merkintä 'siirtynyt tutkinnon uusiin perusteisiin', pitää päättyä tilaan 'katsotaan eronneeksi'."))
+        }
+      }
+
+      "Tiedon voi siirtää, jos opiskeluoikeus on päättynyt 'katsotaan eronneeksi' -tilaan" in {
+        val lisätiedot = AmmatillisenOpiskeluoikeudenLisätiedot(siirtynytTutkinnonUusiinPerusteisiin = Some(true))
+        val opiskeluoikeus = AmmatillinenOpiskeluoikeusTestData.katsotaanEronneeksiOpiskeluoikeus(
+          oppilaitosId = MockOrganisaatiot.stadinAmmattiopisto,
+        )
+        setupOppijaWithOpiskeluoikeus(opiskeluoikeus) {
+          verifyResponseStatusOk()
+        }
+      }
+    }
   }
 
   def vahvistus(date: LocalDate) = {

tiedonsiirtoprotokollan_muutoshistoria.md

@@ -2,6 +2,10 @@
 
 - Lisätty kaikille opiskeluoikeuksille uusi kenttä `lähdejärjestelmäkytkentäPurettu`, joka ilmaisee että opiskeluoikeudelta on poistettu lähdejärjestelmätunniste, jotta sitä voidaan muokata KOSKI-käyttöliittymällä.
 
+## 26.11.2024
+
+- Lisätty ammatillisen opiskeluoikeuden lisätietoihin uusi kenttä `siirtynytTutkinnonUusiinPerusteisiin`, joka ilmaisee opiskeluoikeuden päättymisen syyksi siirtymisen uudempiin perusteisiin.
+
 ## 6.11.2024
 
 - Uskonnon oppimäärä (\*.osasuoritukset[].koulutusmoduuli.uskonnonOppimäärä) on deprekoitu kaikilta lukion ja perusopetuksen opiskeluoikeuksilta,

validaation_muutoshistoria.md

@@ -5,6 +5,10 @@
 - Estetään uuden kaikille opikeluoikeuksille lisätyn kentän `lähdejärjestelmäkytkentäPurettu` lisääminen tai sen sisällön muokkaaminen tiedonsiirron kautta.
 - Estetään opiskeluoikeuden päivitys tiedonsiirron kautta, jos sen lähdejärjestelmäkytkentä on purettu.
 
+## 26.11.2024
+
+- Estetään siirtynytTutkinnonUusiinPerusteisiin -kentän siirto ammatillisen opiskeluoikeuden lisätietoihin, jos opiskeluoikeus ei ole päättyvässä tilassa.
+
 ## 14.11.2024
 
 - Salli ammatillisen koulutuksen korotukset toisessa oppilaitoksessa suoritettuun tutkintoon

web/app/types/fi/oph/koski/schema/AmmatillisenOpiskeluoikeudenLisatiedot.ts

@@ -28,6 +28,7 @@ export type AmmatillisenOpiskeluoikeudenLisätiedot = {
   vankilaopetuksessa?: Array<Aikajakso>
   henkilöstökoulutus: boolean
   erityinenTuki?: Array<Aikajakso>
+  siirtynytTutkinnonUusiinPerusteisiin?: boolean
   koulutusvienti: boolean
   opiskeluvalmiuksiaTukevatOpinnot?: Array<OpiskeluvalmiuksiaTukevienOpintojenJakso>
   jotpaAsianumero?: Koodistokoodiviite<'jotpaasianumero', string>
@@ -50,6 +51,7 @@ export const AmmatillisenOpiskeluoikeudenLisätiedot = (
     vankilaopetuksessa?: Array<Aikajakso>
     henkilöstökoulutus?: boolean
     erityinenTuki?: Array<Aikajakso>
+    siirtynytTutkinnonUusiinPerusteisiin?: boolean
     koulutusvienti?: boolean
     opiskeluvalmiuksiaTukevatOpinnot?: Array<OpiskeluvalmiuksiaTukevienOpintojenJakso>
     jotpaAsianumero?: Koodistokoodiviite<'jotpaasianumero', string>