- TablePlus (oder ein anderer MySQL-fähiger DB-Client)
- Visual Studio Code
- GitHub Account
- Gitpod Account
- Repo forken
- Postman für das Testen der API Endpunkte
Wir erstellen eine einfache To-Do-App. Das Backend wird hierbei mit Laravel als reines API-Backend geschrieben. Das Frontend wird mit VueJS erstellt.
Für diese Phase ist die offizielle Laravel-Dokumentation euer bester Freund.
Ziel ist es, dass wir ensprechend CRUD (Create, Read, Update, Delete) API Endpunkte haben, um neue CheckLists und CheckListItems zu erstellen. Wichtig ist, dass wir eine Validierung integriert haben, so dass wir sichergehen können, dass alle erforderlichen Parameter korrekt übergeben wurden. Zudem wollen wir JSON Responses haben, also strukturierte Objekte anstelle von HTML Code.
Das zugrundeliegende Datenmodell findet ihr weiter unten. Dieses enthält die wichtigsten Attribute, kann aber auch gerne erweitert werden.
Am Ende der Backend-Phase soll es möglich sein:
- eine CheckList zu erstellen und diese an einen User zu hängen
- eine Checklist zu bearbeiten und zu löschen
- sich eine bestimmte CheckList mit allen Items anzuzeigen
- alle CheckLists eines Users anzeigen zu lassen
- einer CheckList Items hinzuzufügen, Items zu löschen, Items zu editieren und als erledigt zu markieren
- E
Sobald eure Dev-Umgebung läuft, solltet ihr zunächst die schon vorhanden Migrations laufen lassen und ein paar User erstellen. Damit legt Laravel ein paar vordefinierte Tabellen an für die Nutzerverwaltung (users
-Tabelle, Tabellen für Password-Resets usw.). Dazu:
- wechselt in das
monolith
Verzeichnis:cd monolith
(öffnet ggfs. ein neues Terminal vorab) - lasst die Migrations laufen:
sail artisan migrate
- Erstellt ein paar Dummy-User:
sail artisan db:seed
Wer mehr zu den Seedern erfahren will, kann sich diese Bereiche der Doku genauer anschauen: Seeder und Model Factories
Beachte: Das User-Model existiert bereits und muss nicht extra erstellt werden. Hier muss lediglich die Relation im Model hinzugefügt werden.
- Models anlegen (CheckList, CheckListItem) inkl. Migrations, Relationen usw. Siehe dazu diese beiden Bereiche der Doku: Eloquent ORM und Database
- CRUD Endpunkte für CheckList und CheckListItem anlegen (Routes, Controller und Validation)
- Login/Register
- View für Listenerstellung
- View um Items einer Liste hinzuzufügen
- Backend
- Zerlegen der Controller-Logik in Requests, Controller, API Resources
- Paginierung
- Frontend
- ...