Hakkında

Swagger üzerinde görmek için : http://rover.okesmez.com/api/documentation

• Laravel 8 Framework'ü üzerine Php 7.4 ile kodlanmıştır.
• Docker için dockerfile ve docker-compose.yaml dosyaları oluşturulmuştur.
• İçerisinde Restfull servisleri barındırmaktadır.
• Kodlanan servislerin dökümantasyonu https://swagger.io/ altyapısına entegre edilmiştir.
• Proje v1 ve v2 olarak hazırlanmıştır. Her ikisi de Swagger ekranında çalıştırılabilir durumdadır.
• Canlı test için : http://rover.okesmez.com/api/documentation
• Local test için : http://localhost/api/documentation
  

http://rover.okesmez.com/api/v1/auth/login ve http://localhost/api/v1/auth/login servislerini kullanmak için gerekli olan token aşağıdaki bilgiler kullanılarak alınır.

 Email : info@okesmez.com
 Password : 123456
 

Projeyi Docker ile çalıştırma

İlk olarak Framework dizininde bulunan .env.example dosyasının adı .env olarak değiştirilmelidir.

---

• Docker image oluşturmak için Dockerfile'ın bulunduğu dizinde aşağıdaki command çalıştırılmalıdır.
  docker build -t rover-image:v1.1.5 .
• İmage oluşturulduktan sonra Docker-compose.yaml dosyası açılarak dosya içerisine oluşturulan versiyon yazılır.
  
• Aşağıdaki command çalıştırılarak. Docker ortamda proje ayağı kaldırılmış olur.
  docker-compose up -d --build

Yukarıdaki işlemlerden sonra birkaç dakika beklenmelidir. Mysql veritabanın ve Projenin ayağı kalkması biraz zaman alıyor.

Test

• Plateau servisisine ait işlemler için fonksiyonel ve unit testler kodlandı. Test sonucunu görebilmek için aşağıdaki komutu ana dizinde çalıştırınız.
  php /data/www/artisan test
  
• Fonksiyonel Test Class : https://github.com/ofke-yazilim/laravel-rover-movement/blob/main/framework/tests/Feature/v1/PlateauTest.php
  
• Unit Test Class : https://github.com/ofke-yazilim/laravel-rover-movement/blob/main/framework/tests/Unit/v2/PlateauTest.php
  

İşlem local bilgisayarda yapılıyorsa projeye ait linkler aşağıdadır.

Servisler ve Kullanımları : https://localhost/api/documentation (Servisler bu adresten test edilebilir.)
Phpmyadmin: http://localhost:8080/ (username: root password: Z5AajEapuLZuNuv)

• Projenin bulunduğu container içerisine girebilmek için aşağıdaki command çalıştırılmalıdır.
  docker-compose exec web sh

• Yukarıdaki command ile container terminaline girilmiş olur. Proje kodlarının bulunduğu yere isecd data/www dosya yoluna gidilerek ulaşılır.

Postman

• okesmez.com üzerinde çalışan projeyi postman üzerinde test etmek için ise aşağıdaki dosya import edilmelidir.
  https://github.com/ofke-yazilim/laravel-rover-movement/blob/main/rover-okesmez.com.postman_collection.json

Dosyalar

1. Route : https://github.com/ofke-yazilim/laravel-rover-movement/blob/main/framework/routes/web.php
2. Controller : https://github.com/ofke-yazilim/laravel-rover-movement/tree/main/framework/app/Http/Controllers
3. Model : https://github.com/ofke-yazilim/laravel-rover-movement/tree/main/framework/app/Models
4. Seed : https://github.com/ofke-yazilim/laravel-rover-movement/tree/main/framework/database/seeders
5. Migrations : https://github.com/ofke-yazilim/laravel-rover-movement/tree/main/framework/database/migrations
6. Koşturulan artisan ve terminal kodları : https://github.com/ofke-yazilim/laravel-rover-movement/blob/main/configs/recompile.sh