wip

src/main/java/no/nav/veilarbvedtaksstotte/controller/dto/LagUtkastDTO.java

@@ -7,6 +7,6 @@
 @Data
 public class LagUtkastDTO {
 
-    @Schema(description = "Fødselsnummeret til brukeren vedtaksutkastet skal knyttes til")
+    @Schema(description = "Fødselsnummeret til en oppfølgingsbruker")
     Fnr fnr;
 }

src/main/java/no/nav/veilarbvedtaksstotte/controller/v2/Siste14aVedtakV2Controller.kt

@@ -1,5 +1,10 @@
 package no.nav.veilarbvedtaksstotte.controller.v2
 
+import io.swagger.v3.oas.annotations.Operation
+import io.swagger.v3.oas.annotations.media.Content
+import io.swagger.v3.oas.annotations.media.Schema
+import io.swagger.v3.oas.annotations.responses.ApiResponse
+import io.swagger.v3.oas.annotations.tags.Tag
 import no.nav.common.types.identer.Fnr
 import no.nav.veilarbvedtaksstotte.controller.dto.Siste14aVedtakDTO
 import no.nav.veilarbvedtaksstotte.controller.v2.dto.Siste14aVedtakRequest
@@ -14,12 +19,27 @@ import org.springframework.web.server.ResponseStatusException
 
 @RestController
 @RequestMapping("/api/v2")
+@Tag(name = "Siste § 14 a-vedtak V2", description = "Funksjonalitet knyttet til siste § 14 a-vedtak.")
 class Siste14aVedtakV2Controller(
     val authService: AuthService,
     val siste14aVedtakService: Siste14aVedtakService
 ) {
 
     @PostMapping("/hent-siste-14a-vedtak")
+    @Operation(
+        summary = "Hent siste 14a vedtak",
+        description = "Henter det siste registrerte § 14 a-vedtaket for den spesifiserte brukeren.",
+        responses = [
+            ApiResponse(
+                responseCode = "200",
+                content = [Content(schema = Schema(implementation = Siste14aVedtakDTO::class))]
+            ),
+            ApiResponse(
+                responseCode = "403",
+                content = [Content(schema = Schema(hidden = true))]
+            )
+        ]
+    )
     fun hentSiste14aVedtak(@RequestBody siste14aVedtakRequest: Siste14aVedtakRequest): Siste14aVedtakDTO? {
         sjekkTilgang(siste14aVedtakRequest.fnr)
 
@@ -34,8 +54,7 @@ class Siste14aVedtakV2Controller(
             }
         } else if (authService.erEksternBruker()) {
             authService.sjekkEksternbrukerTilgangTilBruker(fnr)
-        }
-        else {
+        } else {
             authService.sjekkVeilederTilgangTilBruker(fnr)
         }
     }

src/main/java/no/nav/veilarbvedtaksstotte/controller/v2/UtrullingV2Controller.kt

@@ -1,5 +1,10 @@
 package no.nav.veilarbvedtaksstotte.controller.v2
 
+import io.swagger.v3.oas.annotations.Operation
+import io.swagger.v3.oas.annotations.media.Content
+import io.swagger.v3.oas.annotations.media.Schema
+import io.swagger.v3.oas.annotations.responses.ApiResponse
+import io.swagger.v3.oas.annotations.tags.Tag
 import no.nav.veilarbvedtaksstotte.controller.v2.dto.UtrullingRequest
 import no.nav.veilarbvedtaksstotte.service.UtrullingService
 import org.springframework.web.bind.annotation.PostMapping
@@ -9,10 +14,25 @@ import org.springframework.web.bind.annotation.RestController
 
 @RestController
 @RequestMapping("/api/v2/utrulling")
+@Tag(
+    name = "Utrulling V2",
+    description = "Funksjonalitet knyttet til utrulling (hvilke kontorer som har tilgang til løsningen)."
+)
 class UtrullingV2Controller(
     val utrullingService: UtrullingService
 ) {
+
     @PostMapping("/hent-tilhorerBrukerUtrulletKontor")
+    @Operation(
+        summary = "Tilhører utrullet kontor",
+        description = "Sjekker om spesifisert bruker tilhører en NAV-enhet hvor løsningen er rullet ut.",
+        responses = [
+            ApiResponse(
+                responseCode = "200",
+                content = [Content(schema = Schema(implementation = Boolean::class))]
+            ),
+        ]
+    )
     fun tilhorerBrukerUtrulletKontor(@RequestBody utrullingRequest: UtrullingRequest): Boolean {
         return utrullingService.tilhorerBrukerUtrulletKontor(utrullingRequest.fnr)
     }

src/main/java/no/nav/veilarbvedtaksstotte/controller/v2/VedtakV2Controller.kt

@@ -1,5 +1,11 @@
 package no.nav.veilarbvedtaksstotte.controller.v2
 
+import io.swagger.v3.oas.annotations.Operation
+import io.swagger.v3.oas.annotations.media.ArraySchema
+import io.swagger.v3.oas.annotations.media.Content
+import io.swagger.v3.oas.annotations.media.Schema
+import io.swagger.v3.oas.annotations.responses.ApiResponse
+import io.swagger.v3.oas.annotations.tags.Tag
 import no.nav.veilarbvedtaksstotte.controller.v2.dto.VedtakRequest
 import no.nav.veilarbvedtaksstotte.domain.arkiv.ArkivertVedtak
 import no.nav.veilarbvedtaksstotte.domain.vedtak.Vedtak
@@ -12,19 +18,53 @@ import org.springframework.web.bind.annotation.RestController
 
 @RestController
 @RequestMapping("/api/v2/vedtak")
+@Tag(
+    name = "Vedtak V2",
+    description = "Funksjonalitet knyttet til § 14 a-vedtak."
+)
 class VedtakV2Controller(
     val vedtakService: VedtakService,
     val arenaVedtakService: ArenaVedtakService,
 ) {
     @PostMapping("/hent-fattet")
+    @Operation(
+        summary = "Hent fattede § 14 a-vedtak",
+        description = "Henter fattede § 14 a-vedtak for den spesifiserte brukeren.",
+        responses = [
+            ApiResponse(
+                responseCode = "200",
+                content = [Content(array = ArraySchema(schema = Schema(implementation = Vedtak::class)))]
+            ),
+            ApiResponse(
+                responseCode = "403",
+                content = [Content(schema = Schema(hidden = true))]
+            )
+        ]
+    )
     fun hentFattedeVedtak(@RequestBody vedtakRequest: VedtakRequest): List<Vedtak> {
         return vedtakService.hentFattedeVedtak(vedtakRequest.fnr)
     }
 
     @PostMapping("/hent-arena")
+    @Operation(
+        summary = "Hent § 14 a-vedtak fra Arena",
+        description = "Henter § 14 a-vedtak som denne løsningen har mottat fra Arena for den spesifiserte brukeren.",
+        responses = [
+            ApiResponse(
+                responseCode = "200",
+                content = [Content(array = ArraySchema(schema = Schema(implementation = ArkivertVedtak::class)))]
+            ),
+            ApiResponse(
+                responseCode = "403",
+                content = [Content(schema = Schema(hidden = true))]
+            ),
+            ApiResponse(
+                responseCode = "500",
+                content = [Content(schema = Schema(hidden = true))]
+            )
+        ]
+    )
     fun hentVedtakFraArena(@RequestBody vedtakRequest: VedtakRequest): List<ArkivertVedtak> {
         return arenaVedtakService.hentVedtakFraArena(vedtakRequest.fnr)
     }
-
 }
-

src/main/java/no/nav/veilarbvedtaksstotte/controller/v2/dto/Siste14aVedtakRequest.kt

@@ -1,7 +1,9 @@
 package no.nav.veilarbvedtaksstotte.controller.v2.dto
 
+import io.swagger.v3.oas.annotations.media.Schema
 import no.nav.common.types.identer.Fnr
 
 data class Siste14aVedtakRequest(
+    @Schema(description = "Fødselsnummer til brukeren som man ønsker å hente det siste § 14 a-vedtaket til")
     val fnr: Fnr
 )

src/main/java/no/nav/veilarbvedtaksstotte/controller/v2/dto/UtkastRequest.kt

@@ -4,6 +4,6 @@ import io.swagger.v3.oas.annotations.media.Schema
 import no.nav.common.types.identer.Fnr
 
 data class UtkastRequest(
-    @Schema(description = "Fødselsnummeret til brukeren som vedtaksutkastet er knyttet til")
+    @Schema(description = "Fødselsnummeret til en oppfølgingsbruker")
     val fnr: Fnr
 )

src/main/java/no/nav/veilarbvedtaksstotte/controller/v2/dto/UtrullingRequest.kt

@@ -1,7 +1,9 @@
 package no.nav.veilarbvedtaksstotte.controller.v2.dto
 
+import io.swagger.v3.oas.annotations.media.Schema
 import no.nav.common.types.identer.Fnr
 
 data class UtrullingRequest(
+    @Schema(description = "Fødselsnummeret til en oppfølgingsbruker")
     val fnr: Fnr
 )

src/main/java/no/nav/veilarbvedtaksstotte/controller/v2/dto/VedtakRequest.kt

@@ -1,7 +1,9 @@
 package no.nav.veilarbvedtaksstotte.controller.v2.dto
 
+import io.swagger.v3.oas.annotations.media.Schema
 import no.nav.common.types.identer.Fnr
 
 data class VedtakRequest(
+    @Schema(description = "Fødselsnummeret til en oppfølgingsbruker")
     val fnr: Fnr
 )