E-Garson - Dijital Restoran Yönetim Sistemi

E-Garson, restoranların operasyonlarını dijitalleştirmek için tasarlanmış modern bir yönetim sistemidir. Müşteri siparişlerinin alınması, menü yönetimi, masa takibi ve gerçek zamanlı sipariş takibi gibi işlevleri sağlar.

Proje Yapısı

E-Garson/
├── backend/              # Spring Boot RESTful API
│   └── e-garson/        # Kotlin ile yazılmış Ana Uygulama
├── frontend/            # Android Mobil Uygulaması
└── frontend-web/        # React/TypeScript Web Uygulaması

Mimariye Genel Bakış

Backend (e-garson)

• Teknoloji: Kotlin, Spring Boot
• Veritabanı: Spring Data JPA
• İletişim: WebSocket desteği ile gerçek zamanlı güncellemeler
• Build Tool: Gradle

Temel Özellikler:

• Restoran ve masa yönetimi
• Menü ve ürün yönetimi
• Sipariş yönetimi ve takibi
• Kullanıcı kimlik doğrulaması
• Gerçek zamanlı bildirimler (WebSocket)

Frontend (Android)

• Teknoloji: Kotlin, Android Native
• Build Tool: Gradle
• Bileşenler:
  • Hilt (Dependency Injection)
  • Jetpack Compose/Traditional UI
  • Google Services entegrasyonu
• Özellikler:
  • Garson mobil uygulaması
  • Siparış takibi
  • Müşteri müdahalesi

Frontend-Web (React)

• Teknoloji: React, TypeScript, Vite
• Styling: Tailwind CSS, PostCSS
• Build Tool: Vite

Sayfalar:

• Giriş ve Kayıt
• Dashboard
• Menü Yönetimi
• Sipariş Yönetimi
• Masa Yönetimi
• Ayarlar

Hızlı Başlangıç

Backend

Gereksinimler

• Java 11+
• Gradle

Kurulum ve Çalıştırma

cd backend/e-garson

# Gradle wrapper ile build et
./gradlew clean build

# Uygulamayı çalıştır
./gradlew bootRun

API sunucusu şu adreste çalışacaktır: http://localhost:8080

Frontend (Android)

Gereksinimler

• Android Studio
• Android SDK
• Gradle

Kurulum

cd frontend

# Bağımlılıkları yükle ve projeyi build et
./gradlew build

# Emülatörde veya cihazda çalıştır
./gradlew installDebug

Frontend-Web (React)

Gereksinimler

• Node.js 16+
• npm veya yarn

Kurulum

cd frontend-web

# Bağımlılıkları yükle
npm install

# Geliştirme sunucusunu başlat
npm run dev

# Production build yap
npm run build

Güvenlik

• JWT tabanlı authentikasyon
• Rol tabanlı erişim kontrolü (RBAC)
• Şifreler bcrypt ile kodlanmıştır
• CORS konfigürasyonu

Teknoloji Stack'i

Bileşen	Teknoloji
Backend API	Spring Boot (Kotlin)
Frontend Mobil	Android (Kotlin)
Frontend Web	React (TypeScript)
Veritabanı	JPA (Configuration özel)
Gerçek Zamanlı	WebSocket
Stil (Web)	Tailwind CSS
State Management	React Context

Bağımlılıklar

Backend bağımlılıkları backend/e-garson/build.gradle.kts dosyasında belirtilmiştir.

Frontend-Web bağımlılıkları frontend-web/package.json dosyasında belirtilmiştir.

Test Etme

Backend Testleri

cd backend/e-garson
./gradlew test

Frontend-Web Testleri

cd frontend-web
npm test

Konfigürasyon

Backend Konfigürasyonu

backend/e-garson/src/main/resources/application.properties veya application.yml dosyasında:

• Veritabanı bağlantı bilgileri
• Server portu (varsayılan: 8080)
• JWT secret key
• WebSocket ayarları

Frontend-Web Konfigürasyonu

frontend-web/src/api/http.ts dosyasında:

• Backend API URL'si
• İstek timeout'u
• İstek başlıkları

Deployment

Backend

./gradlew bootJar
java -jar build/libs/e-garson-*.jar

Frontend-Web

npm run build
# dist/ klasörünün içeriğini web sunucusunda serve et

Ek Kaynaklar

• Spring Boot Dokümantasyonu
• React Dokümantasyonu
• Android Dokümantasyonu
• Tailwind CSS Dokümantasyonu