8 Commits
Author SHA1 Message Date
Technoir aef3ead025 refactor zu 9b18eb0f 2026-10-19 23:58:11 +02:00
Technoir 9b18eb0f0f refactor: Shopping...ResponseDTO refactored
Name war nicht eindeutig, Die ResponseDTOs bezogen sich auf die Antwort
die der Server schickt bei einer Post-Request.
2026-10-19 23:57:41 +02:00
Technoir af63723f3c unnötige BEM Klassen entfernt
die modifier wurden kaum benutzt, Relikt aus alten Zeiten
2026-10-19 23:25:53 +02:00
Technoir f122372f5d readme update 2026-10-19 23:20:23 +02:00
Technoir d8b5c64cf7 update docu 2026-10-19 22:22:52 +02:00
Technoir 1d155c25fd Constraint für LÄnge der Eingabe eingefÜgt 2026-10-19 22:22:47 +02:00
Technoir a6e77fc107 wsp 2026-10-19 22:22:35 +02:00
Technoir c9132be067 update d-a.md 2026-10-19 22:22:28 +02:00
23 changed files with 87 additions and 59 deletions

No files matched your search

+5 -3
View File
@@ -30,6 +30,8 @@ Die Webseite selbst ist so ziemlich im Frontend benutzbar.
Ein Neuladen der Seite ist nicht nötig, mit Ausnahme wenn man
zwischen Listen und der Listenübersicht wechselt.
Mehr über die Architektur findet sich unter [`docs/`](docs/DATENMODELL-ARCHITEKTUR.md)
### Backend
Für das Backend wurde Spring mit Thymeleaf für das Bereitstellen von Seiten genutzt (`src/main/java/de/timaldinger/einkaufsliste`).
@@ -48,7 +50,7 @@ Hinweis: Kategorien und Gegenstände können bearbeitet werden indem man auf sie
| `/api/categories` | GET, POST, DELETE, PATCH | Kategorien |
| `/api/items` | GET, POST, DELETE, PATCH | Gegenstände |
Die vollständige API-Dokumentation befindet sich unter [`/docs/`](/docs/API.md)
Die vollständige API-Dokumentation befindet sich unter [`docs/`](/docs/API.md)
## Aufsetzen
@@ -67,11 +69,11 @@ Nun kann man im Browser `localhost:8080` aufrufen.
### Weitere Dokumentation
Weitere Dokumentation befindet sich unter [`/docs/`](/docs)
Weitere Dokumentation befindet sich unter [`docs/`](/docs)
### Nutzung von KI
Es wurde Claude Code Opus 4.8 genutzt. Die KI wurde zum Debuggen,
bei scheinbar nicht erkennbaren Fehlern, großen Refactors und als Nachschlagewerk genutzt.
bei scheinbar nicht erkennbaren Fehlern, großen Refactors, Hilfe beim Stylen der Seite und als Nachschlagewerk genutzt.
Konzept-, Architekturentscheidungen und Umsetzung des Projekts liegen an mir.
Vorschläge von KI wurden geprüft und bewusst übernommen oder verworfen.
+2 -1
View File
@@ -8,7 +8,8 @@ Die API versucht möglichst RESTful zu sein. Es hat:
Die Schnittstelle erfolgt vollständig über JSON.
Es wurde auf Cache-fähigkeit verzichtet aus Zeitgründen. HATEOAS ist auch nicht vorhanden, da Zeitgründe und fragwürdig, ob es für ein Projekt diesen Umfang nötig ist.
Es wurde auf Cache-fähigkeit verzichtet aus Zeitgründen. HATEOAS ist auch nicht vorhanden,
da Zeitgründe und fragwürdig, ob es für ein Projekt diesen Umfangs nötig ist.
## API Pfade
+11 -6
View File
@@ -1,7 +1,7 @@
# Datenmodell und Architektur
Das Projekt nutzt die Modelle `ShoppingList`, `ShoppingItem` und `ShoppingCategory`.
Neben den Spring und Thymeleaf Bibliotheken wurde noch zusätzlich lombok genutzt.
Neben den Spring und Thymeleaf Bibliotheken wurde noch zusätzlich `lombok` genutzt.
Lombok stellt Annotationen bereit um Boilerplatecode zu vermeiden.
## Diagramm
@@ -17,12 +17,12 @@ erDiagram
### ShoppingList
Eine ShoppingList hat beliebige ShoppingCategory und ShoppingItem.
Eine ShoppingList hat beliebig viele ShoppingCategory und ShoppingItem.
Der Name darf nicht leer sein.
### ShoppingCategory
Eine ShoppingCategory hat beliebige ShoppingItem.
Eine ShoppingCategory hat beliebig viele ShoppingItem.
Der Name darf nicht leer sein.
### ShoppingItem
@@ -39,6 +39,7 @@ ausfüllen muss.
### Controller (`Controller/`)
Hier liegen die Controller welche HTTP-Anfragen abwickeln.
`PageController` ist zuständig für das Bereitstellen von den einzelnen Seiten.
Die restlichen Controller sind RESTController, welche die API-Schnittstelle
behandeln. Sie sind nach der betroffenen Ressource aufgeteilt.
@@ -82,7 +83,8 @@ so abgebildet wie sie in der Klasse definiert sind. Auch sind Relationen
der Entities wie sie in der Datenbank seien sollen abgebildet mit
Annotationen wie `@ManyToOne`. Es gibt eine abstrakte Klasse `ShoppingElement`,
von welcher alle anderen Entities erben. Die Klasse hat eine Variable `id`,
welche ihre Unterklassen dann auch haben.
welche ihre Unterklassen dann auch haben. Die Klasse selbst wird nicht
in der Datenbank abgebildet.
### Repository (`Repository/`)
@@ -133,7 +135,8 @@ Hier liegen nötige Javascriptdateien für die Seite `/list/{id}`.
Unter `/api` liegen die API Methoden, unter `/frontend` UI Methoden.
Da die Seite sowohl Kategorien als auch Gegenstände
behandelt sind in den Ordnern jeweils API und UI Dateien für die beiden Elemente.
Diese sind dann in den jeweilen `listUI.js` und `listAPI.js` gebündelt.
Die Imports sind dann in den jeweilen `listUI.js` und `listAPI.js` gebündelt
welche dann in die `list.js` importiert wird.
### Shared Module (`static/js/shared`)
@@ -145,7 +148,9 @@ Zusammen mit `sharedUI.js` bildet sie den Ablauf ab.
Die beiden Dateien sind bewusst getrennt,
da die Funktion `editElement()` eine Mischung aus UI und API Aufrufe hat.
Das Muster, dass API und UI Funktionen in getrennten Dateien leben,
sollte beibehalten werden.
sollte beibehalten werden. Es wurde nur die editElement() Funktion
generalisiert, da die Bearbeitung eines Elementes für alle drei Models
gleich abläuft im Gegensatz zu dem Hinzufügen und Löschen dieser.
#### error.js
@@ -3,7 +3,7 @@ package de.timaldinger.einkaufsliste.Controller;
import de.timaldinger.einkaufsliste.Dto.Get.ShoppingCategoryGetDTO;
import de.timaldinger.einkaufsliste.Dto.Patch.ShoppingCategoryPatchDTO;
import de.timaldinger.einkaufsliste.Dto.Post.ShoppingCategoryPostDTO;
import de.timaldinger.einkaufsliste.Dto.Response.ShoppingCategoryResponseDTO;
import de.timaldinger.einkaufsliste.Dto.Post.Response.ShoppingCategoryPostResponseDTO;
import de.timaldinger.einkaufsliste.Service.ShoppingCategoryService;
import jakarta.validation.Valid;
import org.springframework.beans.factory.annotation.Autowired;
@@ -26,8 +26,8 @@ public class ShoppingCategoryController {
}
@PostMapping("/api/categories")
public ResponseEntity<ShoppingCategoryResponseDTO> addCategory(@Valid @RequestBody ShoppingCategoryPostDTO newCategory){
ShoppingCategoryResponseDTO created = shoppingCategoryService.addCategory(newCategory);
public ResponseEntity<ShoppingCategoryPostResponseDTO> addCategory(@Valid @RequestBody ShoppingCategoryPostDTO newCategory){
ShoppingCategoryPostResponseDTO created = shoppingCategoryService.addCategory(newCategory);
URI location = ServletUriComponentsBuilder
.fromCurrentRequest()
@@ -3,7 +3,7 @@ package de.timaldinger.einkaufsliste.Controller;
import de.timaldinger.einkaufsliste.Dto.Get.ShoppingItemGetDTO;
import de.timaldinger.einkaufsliste.Dto.Patch.ShoppingItemPatchDTO;
import de.timaldinger.einkaufsliste.Dto.Post.ShoppingItemPostDTO;
import de.timaldinger.einkaufsliste.Dto.Response.ShoppingItemResponseDTO;
import de.timaldinger.einkaufsliste.Dto.Post.Response.ShoppingItemPostResponseDTO;
import de.timaldinger.einkaufsliste.Service.ShoppingItemService;
import jakarta.validation.Valid;
import org.springframework.beans.factory.annotation.Autowired;
@@ -26,8 +26,8 @@ public class ShoppingItemController {
}
@PostMapping("/api/items")
public ResponseEntity<ShoppingItemResponseDTO> addItem(@Valid @RequestBody ShoppingItemPostDTO newItem){
ShoppingItemResponseDTO created = shoppingItemService.addItem(newItem);
public ResponseEntity<ShoppingItemPostResponseDTO> addItem(@Valid @RequestBody ShoppingItemPostDTO newItem){
ShoppingItemPostResponseDTO created = shoppingItemService.addItem(newItem);
URI location = ServletUriComponentsBuilder
.fromCurrentRequest()
@@ -4,7 +4,7 @@ import de.timaldinger.einkaufsliste.Dto.Get.ShoppingListGetDTO;
import de.timaldinger.einkaufsliste.Dto.Get.ShoppingListsGetDTO;
import de.timaldinger.einkaufsliste.Dto.Patch.ShoppingListPatchDTO;
import de.timaldinger.einkaufsliste.Dto.Post.ShoppingListPostDTO;
import de.timaldinger.einkaufsliste.Dto.Response.ShoppingListResponseDTO;
import de.timaldinger.einkaufsliste.Dto.Post.Response.ShoppingListPostResponseDTO;
import de.timaldinger.einkaufsliste.Service.ShoppingListService;
import jakarta.validation.Valid;
import org.springframework.beans.factory.annotation.Autowired;
@@ -33,8 +33,8 @@ public class ShoppingListController {
}
@PostMapping("/api/lists")
public ResponseEntity<ShoppingListResponseDTO> addList(@Valid @RequestBody ShoppingListPostDTO newList){
ShoppingListResponseDTO created = shoppingListService.addList(newList);
public ResponseEntity<ShoppingListPostResponseDTO> addList(@Valid @RequestBody ShoppingListPostDTO newList){
ShoppingListPostResponseDTO created = shoppingListService.addList(newList);
URI location = ServletUriComponentsBuilder
.fromCurrentRequest()
@@ -1,6 +1,9 @@
package de.timaldinger.einkaufsliste.Dto.Patch;
import jakarta.validation.constraints.NotBlank;
import jakarta.validation.constraints.Size;
public record ShoppingCategoryPatchDTO(@NotBlank(message = "Kategoriename darf nicht leer sein!") String categoryName) {
public record ShoppingCategoryPatchDTO(@NotBlank(message = "Kategoriename darf nicht leer sein!")
@Size(max = 50, message = "Kategoriename darf nicht länger als 50 Zeichen sein!")
String categoryName) {
}
@@ -1,10 +1,13 @@
package de.timaldinger.einkaufsliste.Dto.Patch;
import jakarta.validation.constraints.AssertTrue;
import jakarta.validation.constraints.Size;
import java.util.UUID;
public record ShoppingItemPatchDTO(String itemName, String itemAmount, Boolean isDone, UUID categoryID) {
public record ShoppingItemPatchDTO(@Size(max = 50, message = "Name darf nicht länger als 50 Zeichen sein!") String itemName,
@Size(max = 50, message = "Menge darf nicht länger als 50 Zeichen sein!") String itemAmount,
Boolean isDone, UUID categoryID) {
@AssertTrue(message = "Wenigstens eines der Felder muss ausgefüllt sein!")
private boolean isAtleastOneNotBlank(){
@@ -1,6 +1,9 @@
package de.timaldinger.einkaufsliste.Dto.Patch;
import jakarta.validation.constraints.NotBlank;
import jakarta.validation.constraints.Size;
public record ShoppingListPatchDTO(@NotBlank(message = "Listenname darf nicht leer sein!") String listName) {
public record ShoppingListPatchDTO(@NotBlank(message = "Listenname darf nicht leer sein!")
@Size(max = 50, message = "Listenname darf nicht länger als 50 Zeichen sein!")
String listName) {
}
@@ -0,0 +1,6 @@
package de.timaldinger.einkaufsliste.Dto.Post.Response;
import java.util.UUID;
public record ShoppingCategoryPostResponseDTO(String categoryName, UUID categoryID){
}
@@ -0,0 +1,6 @@
package de.timaldinger.einkaufsliste.Dto.Post.Response;
import java.util.UUID;
public record ShoppingItemPostResponseDTO(String itemName, String itemAmount, UUID itemID, UUID categoryID) {
}
@@ -0,0 +1,6 @@
package de.timaldinger.einkaufsliste.Dto.Post.Response;
import java.util.UUID;
public record ShoppingListPostResponseDTO(String listName, UUID listID){
}
@@ -1,8 +1,11 @@
package de.timaldinger.einkaufsliste.Dto.Post;
import jakarta.validation.constraints.NotBlank;
import jakarta.validation.constraints.Size;
import java.util.UUID;
public record ShoppingCategoryPostDTO(@NotBlank(message = "Kategoriename darf nicht leer sein!") String categoryName, UUID listID) {
public record ShoppingCategoryPostDTO(@NotBlank(message = "Kategoriename darf nicht leer sein!")
@Size(max = 50, message = "Kategoriename darf nicht länger als 50 Zeichen sein!")
String categoryName, UUID listID) {
}
@@ -2,14 +2,17 @@ package de.timaldinger.einkaufsliste.Dto.Post;
import jakarta.validation.constraints.AssertTrue;
import jakarta.validation.constraints.NotNull;
import jakarta.validation.constraints.Size;
import java.util.UUID;
public record ShoppingItemPostDTO(String itemName,
String itemAmount,
UUID categoryID,
@NotNull(message = "listID must not be empty!")
UUID listID){
public record ShoppingItemPostDTO( @Size(max = 50, message = "Kategoriename darf nicht länger als 50 Zeichen sein!")
String itemName,
@Size(max = 50, message = "Kategoriename darf nicht länger als 50 Zeichen sein!")
String itemAmount,
UUID categoryID,
@NotNull(message = "listID must not be empty!")
UUID listID){
@AssertTrue(message = "Wenigstens eines der Felder muss ausgefüllt sein!")
private boolean isAtleastOneNotBlank(){
@@ -1,6 +1,9 @@
package de.timaldinger.einkaufsliste.Dto.Post;
import jakarta.validation.constraints.NotBlank;
import jakarta.validation.constraints.Size;
public record ShoppingListPostDTO(@NotBlank(message = "Listenname darf nicht leer sein!") String listName) {
public record ShoppingListPostDTO(@NotBlank(message = "Listenname darf nicht leer sein!")
@Size(max = 50, message = "Listenname darf nicht länger als 50 Zeichen sein!")
String listName) {
}
@@ -1,6 +0,0 @@
package de.timaldinger.einkaufsliste.Dto.Response;
import java.util.UUID;
public record ShoppingCategoryResponseDTO (String categoryName, UUID categoryID){
}
@@ -1,6 +0,0 @@
package de.timaldinger.einkaufsliste.Dto.Response;
import java.util.UUID;
public record ShoppingItemResponseDTO(String itemName, String itemAmount, UUID itemID, UUID categoryID) {
}
@@ -1,6 +0,0 @@
package de.timaldinger.einkaufsliste.Dto.Response;
import java.util.UUID;
public record ShoppingListResponseDTO (String listName, UUID listID){
}
@@ -3,7 +3,7 @@ package de.timaldinger.einkaufsliste.Service;
import de.timaldinger.einkaufsliste.Dto.Get.ShoppingCategoryGetDTO;
import de.timaldinger.einkaufsliste.Dto.Patch.ShoppingCategoryPatchDTO;
import de.timaldinger.einkaufsliste.Dto.Post.ShoppingCategoryPostDTO;
import de.timaldinger.einkaufsliste.Dto.Response.ShoppingCategoryResponseDTO;
import de.timaldinger.einkaufsliste.Dto.Post.Response.ShoppingCategoryPostResponseDTO;
import de.timaldinger.einkaufsliste.Exceptions.BadRequestException;
import de.timaldinger.einkaufsliste.Exceptions.ResourceNotFoundException;
import de.timaldinger.einkaufsliste.Mapper.ShoppingCategoryMapper;
@@ -37,13 +37,13 @@ public class ShoppingCategoryService {
return shoppingCategoryMapper.toGetDTO(category);
}
public ShoppingCategoryResponseDTO addCategory(ShoppingCategoryPostDTO newCategory){
public ShoppingCategoryPostResponseDTO addCategory(ShoppingCategoryPostDTO newCategory){
ShoppingList list = shoppingListRepository.findById(newCategory.listID()).orElseThrow(() -> new ResourceNotFoundException("listID", newCategory.listID()));
ShoppingCategory category = new ShoppingCategory(newCategory.categoryName(), List.of(), list);
shoppingCategoryRepository.save(category);
return new ShoppingCategoryResponseDTO(category.getCategoryName(), category.getId());
return new ShoppingCategoryPostResponseDTO(category.getCategoryName(), category.getId());
}
public void editCategory(UUID categoryID, ShoppingCategoryPatchDTO toChange){
@@ -3,7 +3,7 @@ package de.timaldinger.einkaufsliste.Service;
import de.timaldinger.einkaufsliste.Dto.Get.ShoppingItemGetDTO;
import de.timaldinger.einkaufsliste.Dto.Patch.ShoppingItemPatchDTO;
import de.timaldinger.einkaufsliste.Dto.Post.ShoppingItemPostDTO;
import de.timaldinger.einkaufsliste.Dto.Response.ShoppingItemResponseDTO;
import de.timaldinger.einkaufsliste.Dto.Post.Response.ShoppingItemPostResponseDTO;
import de.timaldinger.einkaufsliste.Exceptions.BadRequestException;
import de.timaldinger.einkaufsliste.Exceptions.ResourceNotFoundException;
import de.timaldinger.einkaufsliste.Mapper.ShoppingItemMapper;
@@ -36,7 +36,7 @@ public class ShoppingItemService {
return shoppingItemMapper.toGetDTO(item);
}
public ShoppingItemResponseDTO addItem(ShoppingItemPostDTO newItem){
public ShoppingItemPostResponseDTO addItem(ShoppingItemPostDTO newItem){
ShoppingCategory category = null;
if(newItem.categoryID() != null){
category = shoppingCategoryRepository.findById(newItem.categoryID()).orElseThrow(() -> new ResourceNotFoundException("categoryID", newItem.categoryID()));
@@ -46,7 +46,7 @@ public class ShoppingItemService {
ShoppingItem item = new ShoppingItem(newItem.itemName(), newItem.itemAmount(), false, category, list);
shoppingItemRepository.save(item);
return new ShoppingItemResponseDTO(item.getItemName(), item.getItemAmount(), item.getId(), category != null ? category.getId() : null);
return new ShoppingItemPostResponseDTO(item.getItemName(), item.getItemAmount(), item.getId(), category != null ? category.getId() : null);
}
public void editItem(UUID itemID, ShoppingItemPatchDTO toChange){
@@ -3,7 +3,7 @@ package de.timaldinger.einkaufsliste.Service;
import de.timaldinger.einkaufsliste.Dto.Get.*;
import de.timaldinger.einkaufsliste.Dto.Patch.ShoppingListPatchDTO;
import de.timaldinger.einkaufsliste.Dto.Post.ShoppingListPostDTO;
import de.timaldinger.einkaufsliste.Dto.Response.ShoppingListResponseDTO;
import de.timaldinger.einkaufsliste.Dto.Post.Response.ShoppingListPostResponseDTO;
import de.timaldinger.einkaufsliste.Exceptions.ResourceNotFoundException;
import de.timaldinger.einkaufsliste.Mapper.ShoppingCategoryMapper;
import de.timaldinger.einkaufsliste.Mapper.ShoppingItemMapper;
@@ -47,10 +47,10 @@ public class ShoppingListService {
return new ShoppingListGetDTO(categories, items);
}
public ShoppingListResponseDTO addList(ShoppingListPostDTO newList){
public ShoppingListPostResponseDTO addList(ShoppingListPostDTO newList){
ShoppingList list = new ShoppingList(newList.listName());
shoppingListRepository.save(list);
return new ShoppingListResponseDTO(list.getListName(), list.getId());
return new ShoppingListPostResponseDTO(list.getListName(), list.getId());
}
public void editList(UUID listID, ShoppingListPatchDTO toChange){
+4 -2
View File
@@ -41,8 +41,10 @@ shopping-category {
gap: var(--space-2);
padding: var(--space-2);
}
.category__name--big { font-size: 1.5rem; }
.category__name--bold { font-weight: bold; }
.category__name{
font-size: 1.5rem;
font-weight: bold;
}
.category__deleteButton {
background: var(--c-bg);
@@ -24,7 +24,7 @@ export class ShoppingCategory extends HTMLElement {
categoryHeaderInnerDiv.classList.add("category__innerHeader");
span.textContent = this.getAttribute("category-name");
span.classList.add("category__name", "category__name--bold", "category__name--big");
span.classList.add("category__name");
deleteAllItemsLabel.classList.add("category__deleteAllLabel");
deleteAllItemsLabel.textContent = "Gegenstände mit Kategorie löschen?";