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
2026-10-07 15:32:19 +02:00
wsp
2026-10-19 22:22:35 +02:00
2026-10-04 17:09:51 +02:00
2026-10-19 23:20:23 +02:00

Einkaufsliste

Repository für das Webapp-Projekt, was eine Einkaufsliste zur Verfügung stellt. Es ist möglich, mehrere Listen anzulegen. In einer Liste kann man Gegenstände und Kategorien erstellen. Gegenständen können, aber müssen nicht Kategorien gehören.

Dokumentation

Entwicklungsverlauf und User Stories

Dieses Projekt hat seine Dokumentation über Gitea vorgenommen. Die Entwicklungshistorie ist über die Commitliste einsehbar, User-Stories, Erweiterungen/Änderungen am Projekt und andere Entwicklungsentscheidungen wurden über Issues abgewickelt. Es wurden auch Meilensteine verwendet um die Issues zu organisieren.

Bugs und Fehler wurden nicht mit Issues dokumentiert, da sie entweder während der Entwicklung auf einem anderen Branch beseitigt worden sind (wenn der Fehler von der Entwicklung des Branches kam) oder spontan gefixt. Die Commits, welche Bugs fixen sind mit bug: bzw. bugfix: gekennzeichnet und in der Commit-Historie auffindbar.

Architektur

Die Seite verfolgt einen hybriden Ansatz. Das Backend schickt dem Browser eine HTML-Datei, welche in Teilen mit Attributen bei Custom Elementen und Daten befüllt sind. Der Client rendert dann die Custom Elemente. 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/

Backend

Für das Backend wurde Spring mit Thymeleaf für das Bereitstellen von Seiten genutzt (src/main/java/de/timaldinger/einkaufsliste). Das Backend ist über eine RESTful-API ansprechbar. Die Datenbank ist H2.

Frontend

Für das Frontend wurde Vanilla-JS und CSS benutzt. Hinweis: Kategorien und Gegenstände können bearbeitet werden indem man auf sie drückt!

API Übersicht

Pfad Zugelassene Methoden Angesprochene Modelle
/api/lists GET, POST, DELETE, PATCH Einkaufslisten
/api/categories GET, POST, DELETE, PATCH Kategorien
/api/items GET, POST, DELETE, PATCH Gegenstände

Die vollständige API-Dokumentation befindet sich unter docs/

Aufsetzen

Auf der Maschine muss Java 25 und Maven installiert sein.

# Repo clonen
git clone https://gitea.von.timaldinger.de/Technoir/einkaufsliste-web.git
# Im Ordner
mvn spring-boot:run

Nun kann man im Browser localhost:8080 aufrufen.

Sonstiges

Weitere Dokumentation

Weitere Dokumentation befindet sich unter 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, 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.

S
Description
No description provided
Readme
699 KiB
0 Stars 1 Watchers 0 Forks
Languages
Java 50.9%
JavaScript 33.8%
CSS 9.1%
HTML 6.2%