/gezinti

Getir & BiTaksi Hackathon

Primary LanguageJava

gezinti

Getir & BiTaksi Hackathon Bu repo, getir-bitaksi hackathon 2017 süresince gerçekleştirilmiş Gezinti ekibinin backend, frontend ve android/ios uygulamalarını içerir. Subfolderlar halinde tüm projeler bu repo içerisinde toplanmıştır.

Ekip Üyeleri

  • Eren Utku
  • Necil Albayrak
  • Yasin Arslan

İçindekiler

Commit Standart

[platform][branch][feature][commit message] şeklindedir. Geliştirme branch'i dev branch'idir. Ana branch master branch'idir.

Backend

NodeJs ve MongoDB, ve Mongoose kullanılarak REST API geliştirildi.

Teknolojiler;

  • NodeJS
  • MongoDB
  • ExpressJs
  • Mongoose

Gerçekleştirilenler;

Genel tasklar:

  • Error handling
  • Promise kullanımı

Etkinlik taskları:

  • Etkinlik oluşturulması
  • Kullanıcıların etkinlie katılabilmeleri ve çıkabilmeleri
  • Etkinliklerin tek olarak görüntülenebilmesi
  • Etkinlik aramasında yakınlığa göre etkinliklerin seçilmesi
  • Etkinliklerin oluşturan kullanıcı tarafından silinebilmesi
  • Etkinliklere yorum yapılması
  • Yapılan yorumların yapan kişi tarafından silinebilmesi

Kullanıcı taskları

  • Kullanıcıların bilgilerinin görüntülenebilmesi
  • Kullanıcı kaydetme
  • Kullanıcının profil bilgisini görüntüleme
  • Kullanıcıyı seçmek

API Reference

-Title: Select user by ID Endpoint: /api/user/:userId/select Type: POST Parameters: - userId(String) Id of user object

-Title: Create user Endpoint: /api/user/register Type: POST Parameters: - name(String) Name of user - password(String) Password of user - tel(String) Telephone number of user Response: created user

-Title: Select user Endpoint: /api/user TYPE: GET Response: list of all users

-Title: Get user profile information Endpoint: /api/user/:userId Type: GET Response: user information or 5XX

-Title: Register event Endpoint: /api/event/register Type: POST Parameters: -title(String) Title of event -owner(String) Owner Id of event -desc(String) Event description -members([user]) Users that are joined to event -location([coordinate]) Coordinates that event includes -eventType(Number) Event type parameter -eventTime(Numver) Event time parameter returns: Created event, 405 on bad request, and 500 on internal server error

-Title: Get events by coordinate Endpoint: api/event/search Method: POST Parameters: lat(String) lattitude parameter for search lon(String) longitude parameter for search eventType(Number) Event type parameter eventTime(Number) Event time parameter returns: list of matched events, 4XX on bad request, 5XX on internal server error

-Title: Remove event Endpoint: /api/event/:eventId/remove Method: GET returns: 200 if ok parameters: eventId(String) Id of event -Title: Join event Endpoint:/api/event/:eventId/:userId/join Method: GET

Frontend

AngularJs ve NodeJs tabanlı single page application geliştirildi.

Teknolojiler;

  • AngularJs
  • NodeJs
  • Material Design Lite
  • Jquery
  • Material Select
  • Material Icons

Gerçekleştirilenler;

  • Kullanıcının bulunduğu konumun alınması
  • Bu konuma göre arama yapılması
  • Etkinliklerin tek tek görüntülenmesi
  • Etkinlik oluşturma
  • Harita üstünden seçilen bir noktadan etkinliğe gitme
  • Etkinliğe katılma
  • Etkinlikten Çıkma

Android

Android hakkındaki gerçekler

Kütüphaneler

    compile 'com.android.support:design:25.3.0'
    compile 'com.android.support:recyclerview-v7:25.3.0'
    compile 'com.android.volley:volley:1.0.0'
    compile 'com.google.code.gson:gson:2.7'
    compile 'com.google.android.gms:play-services-maps:10.2.0'
    compile 'com.google.android.gms:play-services-location:10.2.0'
    compile 'com.google.android.gms:play-services-places:10.2.0'

Servis Çağrıları

Tek class üzerinden gerçekleşir. Jenerik sınıflar ile dönüş response tipi bilinir ve cast edilmesine gerek kalmaz. Request kendi responsunun tipine sahip olur. get ve post methodları birer tane fakat içerisine aldıklarını abstract BaseRequest sayesinde response tipini belirtmek zorunda olur. SuccessListener<T> şeklinde jenerik bir sınıf alır. Bu sınıf override edilip dönen onSuccess methodunun dönüş tipini belirler. Örnek

yourInstance.post("yourUrl", request, new SuccessListener<EventCreateResponse>() {
    @Override
    public void onSuccess(EventCreateResponse response) {
    ...
    }
 },
 new Response.ErrorListener() {
    @Override
    public void onErrorResponse(VolleyError error) {
    ...
    }
});

Hata yorumlamaları

Volley ile dönen VolleyError türündeki objeler türüne göre bir mesaj türetilerek, UI 'a paslanır. Base sınıf hata türüne göre generate edilmiş hatayı kullanıcıya gösterir.

View - Interactor

Çok fazla servis çağrısı olmadığı için presenter yapısı araya koyulması gereksiz görüldü. Interactor -> servis çağrısı yapar ve sonucu UI'lara interfaceler ile paslar. Çağıran sınıf interface tanımlamaları yaptıkları için çağırdıkları yerde ya da instance oluşturarak gelen cevaplar ile UI update işlemlerini yapabilir. BaseActivity , dialog gösterir ve error gösterme işlerini yapar. Böylelikle her fragment/activity içerisinde kod tekrarı yapılmaz.

Kullanıcı etkileşimi

Ana fonksiyonun harita üzerinde olmasından dolayı, harita açık iken yapılacak etkileşimleri alttan açılan menu şeklinde BottomSheet kullanılarak yapıldı. Bu sayede kullanıcı haritayı görmek istediğinde UX problemi çekmeden haritaya ulaşabilir, etkileşime geçmek istediğinde haritadan kopmadan devam edebilir.

Google Maps & Places

Google Developer Console'dan alınan API_KEY ile uygulamaya Maps ve Places özelliği eklendi.

Maps işlemleri;
  • Geçerli konum bulma ve odaklanma
  • Görüntülenen harita ekranında belirli bir alanda arama özelliği
  • Etkinlik türüne göre harita üzerine tek nokta veya poligon olarak görüntüleme
  • Belirlenen arama kriterlerine göre filtreleme ve harita yenileme
  • Etkinlik oluştururken tek veya çoklu konum seçme, çoklu seçimde işlemi geri alma özelliği
Places işlemleri;
  • Konum veya mekan arama özelliği
  • Arama sonucu otomatik odaklanma ve etraftaki etkinlikleri görüntüleme