feat: migrate server to spring boot by vtotalova · Pull Request #31 · ls1intum/memo

vtotalova · 2026-01-13T23:05:38Z

Description

Complete migration from Node.js/Prisma backend to Spring Boot microservices architecture. This PR replaces the original TypeScript/Prisma backend with a production-ready Spring Boot application featuring PostgreSQL, Keycloak authentication, and Docker Compose orchestration. The frontend has been updated to use TanStack Query with Axios for API communication while preserving the original UI design.

Type of Change

Related Issues

Related to backend migration initiative

Changes Made

Server

New Spring Boot 3.4.1 backend with Java 17
- REST API controllers with OpenAPI/Swagger documentation
- Spring Data JPA with PostgreSQL 16
- Flyway database migrations
- Spring Security with OAuth2/JWT via Keycloak
- Docker Compose orchestration (app, postgres, keycloak)
- Management script (server/server-manage.sh) for common operations
- Gradle 8.11.1 build system

Client

API Integration Layer
- New lib/api/ directory with Axios-based API clients
- TanStack Query (React Query) for server state management
- TypeScript types matching Spring Boot DTOs
- Proper error handling and loading states
Session Page Rewrite
- Migrated from server actions to client-side React Query
- Full CRUD operations for competencies and relationships
- Preserved original UI/UX design
Authentication
- Simplified AuthProvider to guest mode (Keycloak integration ready but not enforced)
- Removed sign-in requirement for demo purposes
Infrastructure
- Added QueryClientProvider to app layout
- Fixed import paths from domain_core to lib/utils
- Updated all UI components for new architecture

Database

PostgreSQL 16 with volume persistence
Flyway migrations in server/src/main/resources/db/migration/
JPA entities for Competency, CompetencyRelationship, LearningResource, User

Removed

Deleted domain_core/ TypeScript backend
Deleted prisma/ directory and schema
Deleted app/actions/ server actions
Removed old database migration files

Other

Updated CLAUDE.md with new architecture documentation
New server/README.md with Spring Boot setup instructions
Docker configuration for multi-container orchestration
Environment files for local development

Testing

Test Cases

Existing functionality still works
New functionality works as expected
Edge cases handled appropriately

Manual Testing

Tested in development environment
- Spring Boot server starts successfully on port 8080
- PostgreSQL running on port 5433 with persistent volumes
- Keycloak running on port 8081 with admin access
- Next.js frontend on port 3000 communicating with backend
Tested core functionality
- Session page loads random competencies from Spring Boot API
- Creating competency relationships via API
- Undo functionality with API delete
- Skip functionality maintaining local state
- Keyboard shortcuts (Space, Enter, Cmd+Shift+Z) working
Tested build processes
- ./server-manage.sh build successfully builds Spring Boot JAR
- npm run build successfully builds Next.js production bundle
- No TypeScript compilation errors
- No ESLint errors

Known Issues Fixed

✅ Gradle version compatibility with Java 25 (downgraded to Java 17)
✅ PostgreSQL 18 volume mount structure
✅ Keycloak healthcheck configuration
✅ Spring Boot dependency conflicts (springdoc-openapi)
✅ QueryClient provider missing from layout
✅ Import path resolution for UI components

Screenshots/Videos

Before

Node.js/TypeScript backend with Prisma ORM
Server actions for data fetching
PostgreSQL via Prisma migrations

After

Spring Boot microservices architecture
TanStack Query with REST API
Flyway migrations with JPA/Hibernate
Docker Compose orchestration
Swagger UI at http://localhost:8080/swagger-ui.html
Keycloak admin console at http://localhost:8081

Deployment Notes

Starting the application:

# Backend (from root)
cd server && ./server-manage.sh up

# Frontend (from root)
npm run dev
Environment requirements:

Java 17+
Node.js 18+
Docker & Docker Compose
8080, 8081, 5433, 3000 ports available
First-time setup:

Database migrations run automatically on startup
Keycloak realm auto-imported with demo users
Default credentials in server/README.md


This PR description accurately reflects all the migration work completed, including the technical changes, testing performed, and deployment instructions.

Copilot

Pull request overview

This PR represents a complete architectural migration from a Node.js/TypeScript backend using Prisma ORM to a Spring Boot microservices architecture with Java 17, PostgreSQL, and Keycloak authentication. The frontend has been updated to use TanStack Query with Axios for API communication, replacing the previous server actions approach.

Changes:

Replaced Node.js/Prisma backend with Spring Boot 3.4.1 application featuring REST APIs, JPA/Hibernate, and Flyway migrations
Migrated frontend data layer from server actions to TanStack Query with Axios-based API clients
Introduced Docker Compose orchestration for PostgreSQL, Keycloak, and the Spring Boot application
Removed all Prisma-related code, domain_core directory, and server actions

Reviewed changes

Copilot reviewed 115 out of 118 changed files in this pull request and generated 8 comments.

Show a summary per file

File	Description
server/build.gradle	Gradle build configuration with Spring Boot 3.4.1, Java 17, and required dependencies
server/src/main/resources/db/migration/V1__init_schema.sql	Flyway migration creating database schema with enums and tables
server/src/main/java/.../entity/*	JPA entities for User, Competency, LearningResource, and relationships
server/src/main/java/.../service/*	Business logic layer with transactional service methods
server/src/main/java/.../controller/*	REST API controllers with OpenAPI documentation
server/src/main/java/.../security/SecurityConfig.java	Spring Security configuration with OAuth2/JWT via Keycloak
server/docker-compose.yml	Multi-container setup for app, PostgreSQL 18.1, and Keycloak 26.4
lib/api/*	TypeScript API clients using Axios with proper typing
lib/auth/*	Keycloak integration and simplified AuthProvider
lib/providers.tsx	QueryClient configuration for TanStack Query
package.json	Updated dependencies removing Prisma, adding TanStack Query, Axios, and Keycloak

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

github-actions · 2026-01-13T23:17:28Z

🔍 Code Quality Report

📊 Code Statistics

🚨 Potential Issues

⚠️ Found console statements - consider removing for production
⚠️ Found 'any' or 'unknown' types - consider using more specific types

github-actions · 2026-01-13T23:18:13Z

🔍 Code Quality Report

📊 Code Statistics

🚨 Potential Issues

⚠️ Found console statements - consider removing for production
⚠️ Found 'any' or 'unknown' types - consider using more specific types

github-actions · 2026-01-13T23:35:48Z

🔍 Code Quality Report

📊 Code Statistics

🚨 Potential Issues

⚠️ Found console statements - consider removing for production
⚠️ Found 'any' or 'unknown' types - consider using more specific types

github-actions · 2026-01-14T13:17:40Z

🔍 Code Quality Report

📊 Code Statistics

🚨 Potential Issues

✅ No console statements found
⚠️ Found 'any' or 'unknown' types - consider using more specific types

github-actions · 2026-01-14T13:29:21Z

🔍 Code Quality Report

📊 Code Statistics

🚨 Potential Issues

⚠️ Found console statements - consider removing for production
⚠️ Found 'any' or 'unknown' types - consider using more specific types

github-actions · 2026-01-14T13:32:37Z

🔍 Code Quality Report

📊 Code Statistics

🚨 Potential Issues

✅ No console statements found
⚠️ Found 'any' or 'unknown' types - consider using more specific types

github-actions · 2026-01-14T13:50:13Z

🔍 Code Quality Report

📊 Code Statistics

🚨 Potential Issues

✅ No console statements found
⚠️ Found 'any' or 'unknown' types - consider using more specific types

MaximilianAnzinger · 2026-01-16T16:38:49Z

Please remember to get rid of Next.js entirely.

github-actions · 2026-01-17T12:25:43Z

🔍 Code Quality Report

📊 Code Statistics

🚨 Potential Issues

✅ No console statements found
⚠️ Found 'any' or 'unknown' types - consider using more specific types

github-actions · 2026-01-17T13:08:36Z

🔍 Code Quality Report

📊 Code Statistics

🚨 Potential Issues

✅ No console statements found
⚠️ Found 'any' or 'unknown' types - consider using more specific types

github-actions · 2026-01-17T13:28:48Z

🔍 Code Quality Report

📊 Code Statistics

🚨 Potential Issues

✅ No console statements found
⚠️ Found 'any' or 'unknown' types - consider using more specific types

github-actions · 2026-01-17T13:37:24Z

🔍 Code Quality Report

📊 Code Statistics

🚨 Potential Issues

✅ No console statements found
⚠️ Found 'any' or 'unknown' types - consider using more specific types

markstockhausen

Functionally, this works. I've tested everything locally and the migration seems successful.

That said, I'm honestly feeling a bit overwhelmed by the sheer size of this PR. It's really hard for me to guarantee I've caught every issue because besides the backend migration it also swaps our frontend from Next.js to Vite. I did spot some UI regressions (colors/fonts), but those can be adjusted in a follow-up PR.

Open to discuss: Did we really mean to remove Next.js from the frontend as well?

github-actions · 2026-01-19T12:02:29Z

🔍 Code Quality Report

📊 Code Statistics

🚨 Potential Issues

✅ No console statements found
⚠️ Found 'any' or 'unknown' types - consider using more specific types

github-actions · 2026-01-19T12:21:27Z

🔍 Code Quality Report

📊 Code Statistics

🚨 Potential Issues

✅ No console statements found
⚠️ Found 'any' or 'unknown' types - consider using more specific types

markstockhausen

Approved with reference to this: #31 (review)

migrate server to spring boot

88f6d3c

vtotalova requested a review from markstockhausen January 13, 2026 23:05

vtotalova self-assigned this Jan 13, 2026

vtotalova requested a review from MaximilianAnzinger as a code owner January 13, 2026 23:05

Copilot AI review requested due to automatic review settings January 13, 2026 23:05

vtotalova linked an issue Jan 13, 2026 that may be closed by this pull request

feat: migrate server-side to spring boot #30

Closed

Copilot started reviewing on behalf of vtotalova January 13, 2026 23:06 View session

vtotalova added security fix Security fix generated by Mend refactor ♻️ Code refactoring server ⚙️ Server-side/API changes dependencies 📦 Dependency updates security 🔒 Security related labels Jan 13, 2026

vtotalova added this to the v0.1.0 milestone Jan 13, 2026

Copilot AI reviewed Jan 13, 2026

View reviewed changes

Merge branch 'main' into feature/migrate-server-side-to-spring-boot

ec82b72

fix merge conflicts

7b9082d

merge conflicts

398f27a

vtotalova changed the title ~~migrate server to spring boot~~ feat: migrate server to spring boot Jan 13, 2026

fix build issues

4e76f82

remove prisma from dockerfile

df64afc

fix build issues

0eb456e

add unrelated as enum on the server side

7813985

markstockhausen requested changes Jan 16, 2026

View reviewed changes

remove next.js entirely

3130eeb

resolve issues

832e7f7

fix build issues

d4a1cb6

fix client side container

5648b97

markstockhausen self-requested a review January 19, 2026 09:40

markstockhausen previously approved these changes Jan 19, 2026

View reviewed changes

MaximilianAnzinger requested changes Jan 19, 2026

View reviewed changes

vtotalova added 2 commits January 19, 2026 12:02

delete not needed files

ec8363b

update gitignore

84127b9

vtotalova dismissed markstockhausen’s stale review via 84127b9 January 19, 2026 11:03

separate use-theme from theme-provider

ae2b2e8

markstockhausen approved these changes Jan 19, 2026

View reviewed changes

MaximilianAnzinger approved these changes Jan 27, 2026

View reviewed changes

MaximilianAnzinger merged commit c861104 into main Jan 27, 2026
12 checks passed

MaximilianAnzinger deleted the feature/migrate-server-side-to-spring-boot branch January 27, 2026 10:30

Uh oh!

Conversation

vtotalova commented Jan 13, 2026 • edited by markstockhausen Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Type of Change

Related Issues

Changes Made

Server

Client

Database

Removed

Other

Testing

Test Cases

Manual Testing

Known Issues Fixed

Screenshots/Videos

Before

After

Deployment Notes

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

github-actions Bot commented Jan 13, 2026

🔍 Code Quality Report

📊 Code Statistics

🚨 Potential Issues

Uh oh!

github-actions Bot commented Jan 13, 2026

🔍 Code Quality Report

📊 Code Statistics

🚨 Potential Issues

Uh oh!

github-actions Bot commented Jan 13, 2026

🔍 Code Quality Report

📊 Code Statistics

🚨 Potential Issues

Uh oh!

github-actions Bot commented Jan 14, 2026

🔍 Code Quality Report

📊 Code Statistics

🚨 Potential Issues

Uh oh!

github-actions Bot commented Jan 14, 2026

🔍 Code Quality Report

📊 Code Statistics

🚨 Potential Issues

Uh oh!

github-actions Bot commented Jan 14, 2026

🔍 Code Quality Report

📊 Code Statistics

🚨 Potential Issues

Uh oh!

github-actions Bot commented Jan 14, 2026

🔍 Code Quality Report

📊 Code Statistics

🚨 Potential Issues

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

MaximilianAnzinger commented Jan 16, 2026

vtotalova commented Jan 13, 2026 •

edited by markstockhausen

Loading

markstockhausen left a comment •

edited

Loading