https://github.com/byte5digital/live-assessment-byte5
https://github.com/byte5digital/live-assessment-byte5
Last synced: 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/byte5digital/live-assessment-byte5
- Owner: byte5digital
- Created: 2025-01-24T11:05:55.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-09-30T10:15:00.000Z (9 months ago)
- Last Synced: 2025-09-30T12:16:37.873Z (9 months ago)
- Language: PHP
- Size: 104 KB
- Stars: 0
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# byte5 Live Assessment: CandyBar API
## 📌 Projektübersicht
Für unser Office benötigen wir eine API zur Verwaltung unserer beliebten **CandyBar**
Deine Aufgabe ist es, das vorbereitete Projekt fertigzustellen und einen Controller für die CandyBar API zu entwickeln.
Dafür soll die Methode des [Test-Driven-Developments](https://martinfowler.com/bliki/TestDrivenDevelopment.html) genutzt werden.
---
## 🎯 Aufgabenstellung
### **Ziel:**
1. Schreibe **Feature-Tests**, um die Funktionalität der API-Endpunkte zu testen.
2. Erstelle nach und nach die benötigten Funktionen der API
3. Alle Tests sollen mit PEST geschrieben werden
### **Hilfsmittel:**
1. Es sind alle Hilfsmittel erlaubt die dir beim Arbeitsablauf helfen (Dokumentation, Chatbots, Packages etc.)
2. Solltest du etwas spezielles benötigen lass es mich vorher wissen, dass ich mich darum kümmern kann.
---
## 🛠️ Setup (Sail)
1. **Vorbereitung**
```
Docker muss installiert und gestartet sein
```
2. **Projekt installieren**
```bash
composer install
cp .env.example .env
./vendor/bin/sail up -d
./vendor/bin/sail artisan key:generate
```
3. **Datenbank einrichten**
```bash
./vendor/bin/sail artisan migrate
./vendor/bin/sail artisan db:seed
```
4. **Tests ausführen**
```bash
./vendor/bin/sail artisan test
```
## 🛠️ Setup (Herd)
1. **Vorbereitung**
```
Herd muss installiert und gestartet sein
```
2. **Projekt installieren**
```bash
composer install
cp .env.example .env
php artisan key:generate
```
3. **Datenbank einrichten**
```bash
php artisan migrate
php artisan db:seed
```
4. **Tests ausführen**
```bash
php artisan test
```
## 📚 Ressourcen
### **Laravel-Dokumentation**
- [HTTP-Tests](https://laravel.com/docs/http-tests)
- [Validation](https://laravel.com/docs/validation)
- [Testing](https://laravel.com/docs/testing)
- [Hands-On-Beispiel Video](https://www.youtube.com/watch?v=UHnP7ThzLpE&ab_channel=LaravelDaily)
### **Hilfreiche Konzepte**
- API Controller
- Testing mit PEST
---
## ⏱️ Vorbereitung
- Stelle sicher, dass du mit **Laravel-Testing-Grundlagen** vertraut bist.
- Überlege, welche Testfälle für CRUD-APIs relevant sind (z. B. fehlerhafte Eingaben).
- Zum eigenen Testen & Vorbereiten gibt es auch eine Postman Collection (live-assessment-byte5.postman_collection.json)
**Viel Erfolg!** 🚀
Bei technischen Fragen: ykupferschmidt@byte5.de