Package dev.dokimos.server.controller.v1

Class AnnotationController

java.lang.Object

dev.dokimos.server.controller.v1.AnnotationController

@RestController
@RequestMapping("/api/v1/runs/{runId}/items/{itemResultId}/annotation")
public class AnnotationController
extends Object

Endpoints for the single human review annotation on a run item result.

Constructor Summary

Constructors

Constructor	Description
AnnotationController(AnnotationService annotationService)

Method Summary

Modifier and Type	Method	Description
org.springframework.http.ResponseEntity<Void>	delete(UUID runId, UUID itemResultId)	Removes the annotation for the item result.
AnnotationView	get(UUID runId, UUID itemResultId)	Returns the annotation for the item result.
AnnotationView	upsert(UUID runId, UUID itemResultId, @Valid AnnotationRequest request, jakarta.servlet.http.HttpServletRequest http)	Creates or updates the annotation for the item result and returns it.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

AnnotationController

public AnnotationController(AnnotationService annotationService)

Method Details

upsert

@PutMapping
public AnnotationView upsert(@PathVariable
 UUID runId,
 @PathVariable
 UUID itemResultId,
 @Valid @RequestBody
 @Valid AnnotationRequest request,
 jakarta.servlet.http.HttpServletRequest http)

Creates or updates the annotation for the item result and returns it. Responds 200 on success, 404 if the item result does not exist or does not belong to the run, and 400 if the verdict is missing. The created_by field is taken from the authenticated principal when present.

get

@GetMapping
public AnnotationView get(@PathVariable
 UUID runId,
 @PathVariable
 UUID itemResultId)

Returns the annotation for the item result. Responds 200 on success, or 404 if the item result does not belong to the run or has no annotation.

delete

@DeleteMapping
public org.springframework.http.ResponseEntity<Void> delete(@PathVariable
 UUID runId,
 @PathVariable
 UUID itemResultId)

Removes the annotation for the item result. Responds 204 on success, or 404 if the item result does not belong to the run.