Merge branch 'temp-detached-fix'

Author: chrootlogin

.gitignore

@@ -5,3 +5,4 @@ slides/_build
 docs/_build
 .venv
 uv.lock
+.DS_Store

README.md

@@ -10,6 +10,24 @@ Der Kurs zeigt, wie relationale Datenbanken in professioneller Softwareentwicklu
 
 Die konkrete Unterrichtstechnologie ist Spring Boot. Die behandelten Prinzipien bleiben aber bewusst übertragbar: Datenmodellierung, ORM, Migrationen, Transaktionen, Query Design, Performance und Tests.
 
+## Starterprojekt
+
+Ab Block 2 wird ein kleines Spring-Boot-4-Starterprojekt verwendet:
+
+```text
+../db-2-app
+```
+
+Das Projekt ist als eigenes Repository beziehungsweise Submodule neben `db-2` eingebunden. Nach der Wiederholung trägt es den ganzen zweiten Block: Die Studierenden klären zuerst, warum ein ORM in der Entwicklung hilft und warum JPA/Hibernate im Java-/Spring-Umfeld verwendet wird. Danach prüfen sie die Spring-Boot-Einrichtung über `pom.xml`, `application.yml`, Entity Mapping und Repositories. Im nächsten Schritt wird Flyway als Migrationswerkzeug im selben Projekt vertieft. Zum Abschluss lesen sie die High-Level-Architektur von `db-2-app` mit Controller, Service, Repository, Mapper, Entity und PostgreSQL.
+
+Der rote Faden von Block 2 lautet:
+
+```text
+Warum ORM? -> Warum JPA/Hibernate? -> Warum Flyway-Migrationen? -> Wie arbeitet db-2-app?
+```
+
+Das Starterprojekt bleibt dabei bewusst unvollständig. Die Studierenden müssen zentrale Datenbanklogik wie Pflichtfelder, Constraints und Repository-Entscheide selbst entwickeln und begründen. Bereits gelaufene Flyway-Migrationen werden nicht nachträglich angepasst; Verbesserungen entstehen als neue Migrationen.
+
 ## Leitfallstudie
 
 Alle Materialien arbeiten mit einem **Ticket-System für internen Support**. Die Fallstudie ist klein genug für Unterrichtslektionen und reich genug für typische Datenbankentwicklungsfragen:

docs/0_intro.md

@@ -37,19 +37,32 @@ Diese Fallstudie ist klein genug, damit du sie im Unterricht überblicken kannst
 
 ## Aufbau des Moduls
 
-Das Modul umfasst neun Blöcke zu je drei Lektionen:
+Nach der Standortbestimmung folgt ein zusammenhängender zweiter Block. Er besteht aus drei Kapiteln, die bewusst aufeinander aufbauen: Zuerst klären wir, warum ein ORM in der Entwicklung eingesetzt wird und warum im Java-/Spring-Umfeld JPA mit Hibernate naheliegt. Danach stabilisieren wir das Datenbankschema mit Flyway-Migrationen. Zum Schluss lesen wir die High-Level-Architektur des Starterprojekts `db-2-app` und verfolgen, wie Spring Boot, JPA/Hibernate, Flyway und PostgreSQL im Request-Ablauf zusammenspielen.
+
+Der rote Faden nach der Wiederholung lautet:
+
+> Warum ORM? → Warum JPA/Hibernate im Java-Umfeld? → Wie entsteht das passende Schema kontrolliert mit Flyway? → Wie greifen die Spring-Boot-Schichten darauf zu?
+
+Block 2 erfüllt damit diese Lernziele:
+
+- Du kannst erklären, warum man ein ORM in der Anwendungsentwicklung einsetzt und wo seine Grenzen liegen.
+- Du kannst begründen, warum JPA mit Hibernate im Java- und Spring-Boot-Umfeld verwendet wird.
+- Du verstehst, wie JPA/Hibernate in Spring Boot über Dependencies, `application.yml`, Entity Mapping und Repository eingerichtet wird.
+- Du kannst erklären, warum Flyway-Migrationen verwendet werden und warum gelaufene Migrationen nicht nachträglich geändert werden.
+- Du verstehst die High-Level-Architektur von `db-2-app`: Controller, Service, Repository, Entity, Mapper, Flyway, Hibernate und PostgreSQL.
+
+Das Modul umfasst acht Themenbereiche zu je drei Lektionen:
 
 | Block | Thema | Schwerpunkt |
 | --- | --- | --- |
 | 1 | Wiederholung und Standortbestimmung | Relevantes Vorwissen aus **Relational Databases** aktivieren |
-| 2 | Spring Boot, PostgreSQL und Datenbankzugriff | Projektstruktur, Konfiguration, Repository- und Service-Layer |
-| 3 | Hibernate/JPA Grundlagen | Entities, Beziehungen, Repositories, CRUD |
-| 4 | Transaktionen und Datenkonsistenz | `@Transactional`, Rollback, Invarianten |
-| 5 | Schema Design für Softwareprojekte | Constraints, IDs, Statusmodellierung, DTO-Abgrenzung |
-| 6 | Flyway und Schema Evolution | Migrationen, Datenmigrationen, sichere Änderungsschritte |
+| 2.1 | Hibernate/JPA Grundlagen | ORM-Grundidee, JPA/Hibernate in Spring Boot einrichten, Entity Mapping, Repositories |
+| 2.2 | Flyway und Schema Evolution | Migrationen, Datenmigrationen, sichere Änderungsschritte |
+| 2.3 | Spring Boot, PostgreSQL und Datenbankzugriff | Projektstruktur, Request-Ablauf, Repository- und Service-Layer |
+| 5 | Transaktionen und Datenkonsistenz | `@Transactional`, Rollback, Invarianten |
+| 6 | Schema Design für Softwareprojekte | Constraints, IDs, Statusmodellierung, DTO-Abgrenzung |
 | 7 | Query Design | Repository Methods, JPQL, native SQL und Reporting |
 | 8 | Performance und ORM-Probleme | N+1, Lazy/Eager Loading, Pagination, `EXPLAIN`, Indexe |
-| 9 | Projektarbeit und Prüfungsvorbereitung | Review, Konsolidierung, Prüfungstraining |
 
 ## Arbeitsweise
 

docs/1_review_orientation/5_conclusion.md

@@ -10,4 +10,4 @@ Die wichtigsten Punkte:
 - Transaktionen sichern fachliche Abläufe, nicht nur technische Statements.
 - Die Ticket-Fallstudie verbindet die kommenden Themen miteinander.
 
-Im nächsten Block schaust du dir an, wie ein Spring-Boot-Backend mit PostgreSQL verbunden wird und wie Controller, Service, Repository und Datenbank zusammenspielen.
+Im nächsten Block folgt der rote Faden von der Entwicklungsfrage zur Architektur: Warum ORM, warum JPA/Hibernate im Java-Umfeld, warum Flyway-Migrationen und wie `db-2-app` mit Controller, Service, Repository, Entity, Mapper und PostgreSQL zusammenspielt.