Akıllı Berber Salonu Yönetim Platformu
Admin Dashboard + Tablet Kiosk PWA + Supabase Edge Functions
- Proje Hakkında
- Mimari
- Ekran Görüntüleri
- Özellikler
- Teknoloji Stack
- Kurulum
- Proje Yapısı
- Güvenlik
- Dokümanlar
BarberNet, çok şubeli berber salonları için uçtan uca yönetim platformudur. Üç ana bileşenden oluşur:
| Bileşen | Açıklama | Kullanıcı |
|---|---|---|
| Admin Dashboard | Randevu, berber, gelir/gider yönetimi | Salon sahibi / Yönetici |
| Tablet Kiosk PWA | Tek ekranlı hızlı satış girişi | Berberler (hesap gerektirmez) |
| Edge Functions | Güvenli API katmanı (submit_sale, get_config) | Arka plan servisi |
Berber salonlarında günlük satış takibi genellikle kâğıt defter veya karmaşık POS sistemleriyle yapılır. Berberler yazılım kullanmak istemez, yöneticiler ise detaylı raporlama ister.
- Berberler için: Tek ekran, dev butonlar, 3 dokunuşla satış kaydı — hesap açmaya gerek yok
- Yöneticiler için: Detaylı dashboard, şube bazlı raporlar, RBAC yetkilendirme
- Offline: İnternet kesilse bile satış kaydedilir, bağlantı gelince otomatik gönderilir
┌─────────────────────────────────────────────────────────────────┐
│ SUPABASE CLOUD │
│ ┌──────────────┐ ┌──────────────┐ ┌────────────────────┐ │
│ │ PostgreSQL │ │ Auth │ │ Edge Functions │ │
│ │ + RLS │ │ + RBAC │ │ submit_sale │ │
│ │ + Triggers │ │ │ │ get_config │ │
│ └──────┬───────┘ └──────┬───────┘ └─────────┬──────────┘ │
│ │ │ │ │
└─────────┼─────────────────┼─────────────────────┼──────────────┘
│ │ │
┌─────┴─────┐ ┌────┴────┐ ┌─────┴──────┐
│ Dashboard │ │ Auth │ │ Tablet │
│ (Next.js) │◄────│ Flow │ │ Kiosk PWA │
│ Port 3000 │ │ │ │ Port 3001 │
└────────────┘ └─────────┘ └────────────┘
Admin/Manager Token-based Auth
Email + Şifre PIN + Kiosk Token
8 berber, 6 hizmet paketi, Nakit/POS seçimi, toplam hesaplama — tek ekranda
![]() PIN Doğrulama |
![]() Token Kurulumu |
| Demo | Açıklama |
|---|---|
| Tablet Kiosk Demo | Berber seçimi → Paket → Ödeme → TAMAM |
| Tablet Kurulum Demo | PIN → Token → Kaydet akışı |
| Dashboard Admin Demo | Admin giriş ve panel gezintisi |
| Dashboard Manager Demo | Şube yöneticisi görünümü |
- ✅ Rol tabanlı erişim (Admin / Şube Yöneticisi)
- ✅ Şube bazlı veri filtreleme (RLS)
- ✅ Berber yönetimi (ekleme, düzenleme, aktif/pasif)
- ✅ Hizmet paketi yönetimi
- ✅ Gelir/gider raporları
- ✅ Randevu takibi
- ✅ Supabase Auth entegrasyonu
- ✅ Dark mode, responsive tasarım
- ✅ Tek ekran — navigasyon yok, sidebar yok
- ✅ Dev butonlar — berber 88px+, ödeme 100px+, TAMAM 80px+
- ✅ 3 dokunuş — Berber → Paket → TAMAM
- ✅ Multi-select paketler + otomatik toplam
- ✅ Nakit / POS ödeme seçimi
- ✅ Gider kaydı — opsiyonel modal
- ✅ Offline queue — IndexedDB + exponential backoff
- ✅ Idempotency —
client_tx_idile duplicate koruması - ✅ PWA — tam ekran, ana ekrana eklenebilir
- ✅ Şubeye kilitlenir — bir kez kurulunca tekrar sorulmaz
- ✅
submit_sale— Satış + opsiyonel gider kaydı (atomik) - ✅
get_config— Token ile şube/berber/paket bilgisi - ✅ SHA-256 token hash doğrulama
- ✅ Service role key ile DB yazma
- ✅ Idempotent insert (duplicate handling)
| Katman | Teknoloji |
|---|---|
| Frontend | Next.js 15, React 19, TypeScript 5.7 |
| Backend | Supabase (PostgreSQL + Auth + Edge Functions) |
| Tablet PWA | Next.js 15, idb-keyval, Service Worker |
| Edge Functions | Deno, supabase-js (service role) |
| Güvenlik | RLS, RBAC, SHA-256 token hashing |
| Offline | IndexedDB, exponential backoff retry |
| Styling | Vanilla CSS (dark theme, glassmorphism) |
- Node.js 18+
- Supabase hesabı (veya self-hosted)
git clone https://github.com/YOUR_USERNAME/BarberNet.git
cd BarberNetcd barbershop-dashboard
cp .env.local.example .env.local
# .env.local'ı Supabase bilgilerinle doldur
npm install
npm run dev # → http://localhost:3000cd Tablet
cp .env.local.example .env.local
# NEXT_PUBLIC_EDGE_FUNCTION_BASE_URL ve NEXT_PUBLIC_SETUP_PIN ayarla
npm install
npm run dev # → http://localhost:3001cd supabase
supabase functions deploy submit_sale
supabase functions deploy get_configsupabase db push # Migrations
supabase db seed # Demo verisi (opsiyonel)BarberNet/
├── barbershop-dashboard/ # Admin Dashboard (Next.js)
│ ├── app/ # App Router sayfaları
│ │ ├── (dashboard)/ # Dashboard route group
│ │ └── login/ # Giriş sayfası
│ ├── components/ # React bileşenleri
│ └── lib/ # Auth context, Supabase client
│
├── Tablet/ # Tablet Kiosk PWA (Next.js)
│ ├── app/ # Kiosk + Setup sayfaları
│ ├── lib/ # API, store, offline queue, types
│ └── public/ # manifest.json, sw.js
│
├── supabase/ # Backend
│ ├── functions/ # Edge Functions (Deno)
│ │ ├── submit_sale/ # Satış kayıt endpoint
│ │ ├── get_config/ # Konfig endpoint
│ │ └── _shared/ # Ortak utils
│ ├── migrations/ # DB migrations
│ └── seed.sql # Demo seed data
│
├── _docs/ # Teknik dokümanlar
│ ├── TABLET_CONTRACT.md # Edge Function API sözleşmesi
│ ├── TABLET_SETUP.md # Tablet kurulum rehberi
│ ├── TABLET_OFFLINE.md # Offline queue stratejisi
│ ├── KIOSK_TOKENS.md # Token yönetimi
│ └── DB_SCHEMA.md # Veritabanı şeması
│
└── docs/ # GitHub görselleri
├── barbernet-banner.svg
└── screenshots/
| Katman | Mekanizma |
|---|---|
| Dashboard Auth | Supabase Auth (email/şifre) |
| Dashboard RLS | Row Level Security + SECURITY DEFINER fonksiyonları |
| Dashboard RBAC | admin / branch_manager rol sistemi |
| Tablet Auth | PIN (kurulum) + Kiosk Token (şube kimliği) |
| Token Storage | SHA-256 hash → branch_kiosks tablosu |
| API Güvenlik | Edge Functions + Service Role Key (client'ta yok) |
| Offline | Idempotent write — duplicate satış önleme |
| Dosya | İçerik |
|---|---|
TABLET_CONTRACT.md |
Edge Function API spec |
TABLET_SETUP.md |
Tablet kurulum adımları |
TABLET_OFFLINE.md |
Offline queue & idempotency |
KIOSK_TOKENS.md |
Token oluşturma & rotasyon |
DB_SCHEMA.md |
Veritabanı şeması |
MIT
BarberNet — Berber salonları için tasarlanmış, modern, offline-first yönetim platformu ✂️




