Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/asimsinan/mekanbul-fullstack
Mekanbul Uygulaması
https://github.com/asimsinan/mekanbul-fullstack
axios expressjs jwt-authentication mocha-chai mongodb mongoose nodejs nodemailer passportjs pugjs rest-api supertest
Last synced: about 1 month ago
JSON representation
Mekanbul Uygulaması
- Host: GitHub
- URL: https://github.com/asimsinan/mekanbul-fullstack
- Owner: asimsinan
- Created: 2022-12-27T08:05:28.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-04-16T16:48:23.000Z (7 months ago)
- Last Synced: 2024-10-01T06:36:26.943Z (about 2 months ago)
- Topics: axios, expressjs, jwt-authentication, mocha-chai, mongodb, mongoose, nodejs, nodemailer, passportjs, pugjs, rest-api, supertest
- Language: JavaScript
- Homepage:
- Size: 3.09 MB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
README
# Mekanbul Full Stack Uygulaması
Mekanbul insanların konumları civarındaki mekanları, sunduğu imkanları görmelerini, mekanlara yorum yapabilmelerini sağlayan bir web uygulamadır. Uygulamanın aynı zamanda bir admin paneli mevcuttur. Admin mekan ekleme, silme, güncelleme, tüm mekanları görme gibi işlemleri yapabilmektedir.
# Uygulama Özellikleri
* **Normal Kullanıcı:** Konuma göre mekan listeleme, mekan detaylarını görebilme
* **Kayıtlı Kullanıcı:** Mekana yorum yapabilme, profil görüntüleme, profil güncelleme, şifre yenileme
* **Admin:** Tüm mekanları listeleme, mekan ekleme, mekan silme, mekan güncelleme
* **Varsayılan Rol:** Kullanıcı. Kullanıcılar koleksiyonuna giderek kayıt olduğunuz kullanıcıyı bulup rolünü "admin olarak değiştirerek admin özelliklerine erişebilirsiniz.
# API Metotları
Tüm koleksiyon API Koleksiyonu.json dosyasında yer almaktadır. Thunder Client aracılığı ile import edilebilir.
* **Mekan Ekleme:** POST "/api/mekanlar". 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". Auth.Bearer Token Girilmeli.
* **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 Güncelle:** PUT "/api/mekanlar/mekanid/yorumlar/:yorumid". 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/girisyap". Auth.Bearer Token Girilmeli. Kullanıcı bilgileri girilmeli. Kullanıcı Bilgileri: eposta, sifre.
* **Kayıt Ol:** POST "/api/kayitol". Auth.Bearer Token Girilmeli. Kullanıcı bilgileri girilmeli. Kullanıcı Bilgileri: adsoyad, eposta, sifre.
* **Profil Görüntüle:** GET "/api/profil". Auth.Bearer Token Girilmeli.
* **Profil Güncelle:** PUT "/api/profilguncelle". Auth.Bearer Token Girilmeli. Kullanıcı bilgileri girilmeli. Kullanıcı Bilgileri: eposta, sifre.
* **Şifre Yenileme İsteği:** POST "/api/sifremiyenile". Eposta gerekli.
* **Yeni Şifre Üretme** POST "/yenisifreuret/:token". Token ve yeni şifre gerekli.
## 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
* **REST API Dokumantasyon Aracı:** Swagger
* **Versiyonlama:** Git
## Kütüphanelerin Yüklenmesi
Çalıştırmadan önce gerekli kütüphanelerin yüklenmesi gerekir. Proje klasörü içindeyken terminalde aşağıdaki komutları kullanarak bu kütüphaneleri yükleyin
### `npm install`
## Uygulamanın Çalıştırılması
Aşağıdaki komut ile uygulamayı çalıştırabilirsiniz.
### `npm start`
## REST API Testi
Aşağıdaki komut ile API testini çalıştırabilirsiniz.
### `npm run test`
* Uygulama [http://localhost:3000](http://localhost:3000) adresinde çalışmaktadır. Anasayfaya erişmek için enlem ve boylam parametreleri verilmelidir. **Örnek:** [http://localhost:3000?enlem=37&boylam=35](http://localhost:3000?enlem=37&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/common/ortakkullanim.js" dosyasındaki apiSecenekleri.sunucu parametresini değiştirilmeli.
* Swagger API Dokumantasyonuna [http://localhost:3000/apidoc](http://localhost:3000/apidoc) adresinden ulaşılabilir.
* [Replit Demo](https://mekanbul-fullstack.asimsinanyuksel.repl.co/?enlem=37.8&boylam=30.5): Admin: Eposta:[email protected] Şifre:1234
# Ekran Görüntüleri
