Nettdetektivene Backend

This is the backend for Nettdetektivene. It is a Kotlin + Spring Boot application that provides the API used by the frontend.

To run this properly, check out the full nettdetektivene repository. Tests and local development are expected to be run from the main repo, together with Docker.

Architecture

The backend is organized by feature.

app and app/config: application setup and shared Spring configuration
iam: authentication, registration, JWT, and security-related logic
classroom: classroom management for teachers and pupils
game: game flow, map stops, tasks, and pupil progress
mystery: mystery content and teacher mystery management
notification: inbox, delivery, and notification events
notebook, leaderboard, medals, moderation, users, xp: feature-specific domains and APIs
shared: shared utilities and events

Features follow the same structure:

api: controllers and request/response DTOs
application: service-layer logic
domain: entities and core domain models
infrastructure: repositories and persistence details

Tests

Run backend tests from the main nettdetektivene setup with Docker, not from this folder in isolation.

The backend has a mix of:

unit and service-level tests for business logic
integration tests for controllers, persistence, and API behavior
Spring Boot test coverage for full application flows

The test suite uses JUnit 5 with Spring Boot test support. There is also JaCoCo coverage reporting configured in Gradle.

Formatting

Formatting is enforced through Spotless.

spotlessCheck: checks that Kotlin and Gradle files follow the project format
spotlessApply: applies the project format automatically

Formatting is also part of the Gradle check flow, so CI will fail if the code style does not match.

idatt2106-v26-04/backend

About

Topics

Resources

Stars

Watchers

Forks

Releases

Contributors 7

Languages