Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/yusufdagdeviren/mekanbul

MekanBul Projesi
https://github.com/yusufdagdeviren/mekanbul

api apitest axios axios-rest expressjs mekanbul mern mern-stack mocha-chai mocha-tests mongoose mvc mvc-architecture nodejs pug pugjs rest-api restapi restful-api supertest

Last synced: 7 days ago
JSON representation

MekanBul Projesi

Host: GitHub
URL: https://github.com/yusufdagdeviren/mekanbul
Owner: YusufDagdeviren
Created: 2022-10-06T08:27:45.000Z (about 2 years ago)
Default Branch: sonbranch
Last Pushed: 2023-01-22T09:42:32.000Z (almost 2 years ago)
Last Synced: 2024-10-18T01:38:40.335Z (27 days ago)
Topics: api, apitest, axios, axios-rest, expressjs, mekanbul, mern, mern-stack, mocha-chai, mocha-tests, mongoose, mvc, mvc-architecture, nodejs, pug, pugjs, rest-api, restapi, restful-api, supertest
Language: JavaScript
Homepage:
Size: 11.9 MB
Stars: 1
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

README

# Mekanbul Uygulaması
---
- **Mekanbul:** Süleyman Demirel Üniversitesi web teknolojileri ve programlama dersinde yapmış olduğumuz insanların konumları civarındaki mekanları, sunduğu imkanları görmelerini, mekanlara yorum yapabilmelerini sağlayan bir web uygulamasıdır.
- Uygulamanın aynı zamanda bir admin paneli mevcuttur. Admin mekan ekleme, mekan silme, mekan güncelleme, tüm mekanları görme gibi işlemleri yapabilmektedir.
---
## Uygulama Özellikleri

1. Enlem ve Boylama göre mekanların uzaklıklarını belirleme.
2. Giriş yapan kullanıcıların mekanlara yorum yapması ve yıldız vermesi.
3. Adminin mekan ekleme,mekan çıkarma,mekan güncelleme,özelliklerinin olması.
4. Giriş yapma ve kayıt olma pencereleri.
---
## Kullanılan Teknolojiler ve Araçlar
Uygulama ***front-end*** ve ***back-end*** olmak üzere iki kısımdan oluşmaktadır. **MVC** mimarisine uygun bir şekilde tasarlanmıştır.

- Front-end: PugJS, CSS, JQuery
- Back-end: NodeJS, ExpressJS, Javascript
- Veritabanı: MongoDB
- Veri Modelleme: Mongoose
- Kimlik Doğrulama, Güvenlik: PassportJS, JWT
- Haberleşme: REST API, Axios
- Test: Mocha,Mochawesome, Chai, Supertest
- IDE: Visual Studio Code
- REST API Client: Thunder Client
- Versiyonlama: Git
---
### Gerekli Kütüphanelerin Eklenmesi
```
npm install
```
### Uygulamanın Çalıştırılması
```
npm start
```
### Api Testi İçin
```
npm run test
```
- Uygulama http://localhost:3000 adresinde çalışmaktadır. Anasayfaya erişmek için enlem ve boylam parametreleri verilmelidir.
Örnek:http://localhost:3000/?enlem=37.8&boylam=35
- Mongo Cloud benzeri bir veritabanı kullanılacaksa "app_api/models/db.js" dosyasındaki dbURI değiştirilmeli.

- Uygulama localhost yerine domain altında çalışacaksa "app_server/controllers/mekanlar.js" dosyasındaki apiSecenekleri.sunucu parametresini değiştirilmeli.
---
## API Metotları
Tüm koleksiyon thunder-collection_Yusuf Dagdeviren Mekanbul API Testi .json dosyasında yer almaktadır. Thunder Client aracılığı ile import edilebilir.

- ***Mekan Ekleme***: POST "/api/admin/mekan/yeni". Mekan bilgileri girilmeli. Mekan Bilgileri: ad,adres, imkanlar, enlem, boylam, gunler1, acilis1, kapanis1, kapali1, gunler2, acilis2, kapanis2, kapali2.
- ***Konuma Göre Mekan Listeleme***: GET "/api/mekanlar?enlem=37&boylam=35". Enlem ve boylam sorgu parametresi olarak verilmeli.
- ***Tüm Mekanları Listeleme***: GET "/api/admin/mekanlar". Giriş yapılmalı.
- ***Mekan Getir***: GET "/api/mekanlar/:mekanid".
- ***Mekan Güncelle***: PUT "/api/mekanlar/:mekanid". Auth.Bearer Token Girilmeli. Mekan bilgileri girilmeli. Mekan Bilgileri: ad,adres, imkanlar, enlem, boylam, gunler1, acilis1, kapanis1, kapali1, gunler2, acilis2, kapanis2, kapali2.
- ***Mekan Sil***: DELETE "/api/mekanlar/:mekanid". Auth.Bearer Token Girilmeli.
- ***Yorum Getir***: GET "/api/mekanlar/:mekanid/yorumlar/:yorumid".
- ***Yorum Ekle***: POST "/api/mekanlar/:mekanid/yorumlar". Auth.Bearer Token Girilmeli. Yorum bilgileri girilmeli. Yorum Bilgileri: yorumMetni, puan
- ***Yorum Sil***: DELETE "/api/mekanlar/:mekanid/yorumlar/:yorumid". Auth.Bearer Token Girilmeli
- ***Giriş Yap***: POST "api/admin/girisyap". Auth.Bearer Token Girilmeli. Kullanıcı bilgileri girilmeli. Kullanıcı Bilgileri: eposta, sifre.
- ***Kayıt Ol***: POST "api/admin/kayitol". Auth.Bearer Token Girilmeli. Kullanıcı bilgileri girilmeli. Kullanıcı Bilgileri: adsoyad, eposta, sifre.
---
## Ekran Görüntüleri
1. **Anasayfa**
![Anasayfa](photos/anasayfa.png)
2. **Mekan Sayfası**
![MekanSayfasi](photos/mekanSayfasi.png)
3. **Yorum Ekle Sayfası**
![YorumEkleSayfası](photos/yorumEkleSayfasi.png)
4. **Admin Giris Yap Sayfasi**
![AdminGirisYapSayfasi](photos/adminGirisPaneli.png)
5. **Admin Kayıt Olma Sayfası**
![AdminKayıtSayfasi](photos/adminKayitOlPaneli.png)
6. **Admin Ana Sayfası**
![AdminKayıtSayfasi](photos/adminAnasayfa.png)
7. **Admin Mekan Ekleme Sayfası**
![AdminMekanEkleSayfasi](photos/adminMekanEkle.png)
8. **Admin Mekan Güncelle Sayfası**
![AdminMekanGüncelleSayfasi](photos/mekanGuncelleSayfasi.png)
9. **Admin Mekan Silme Sayfası**
![AdminMekanSilmeeSayfasi](photos/adminMekanSilme.png)
10. **Mocha Api Testi**
![MochaApiTest](photos/mocha-api-test.png)
11. **Thunder Api Testi**
![ThunderApiTest](photos/mekanbul-api-testi.png)

#### Dipnot
- Bu proje ders boyunca hocamızın anlatımıyla ve kendi çabamla verilen ödevleri yaparak ilerlememin bir sonucudur eksikler olabilir.
- Projenin tam hali için hocamızın proje linki [Asım Sinan Yüksel Mekanbul Full-Stack](https://github.com/asimsinan/mekanbul-fullstack)