Skip to content
saidtunccPublic

About

Barbershop management platform — admin dashboard, offline-first tablet kiosk PWA and Supabase Edge Functions

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

BarberNet

Akıllı Berber Salonu Yönetim Platformu
Admin Dashboard + Tablet Kiosk PWA + Supabase Edge Functions

Next.js Supabase TypeScript PWA React


📋 İçindekiler


🎯 Proje Hakkında

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

Problem

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.

Çözüm

  • 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

🏗 Mimari

┌─────────────────────────────────────────────────────────────────┐
│                        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

📸 Ekran Görüntüleri

Dashboard — Giriş Ekranı

Dashboard Login

Tablet Kiosk — Ana Satış Ekranı

Tablet Kiosk Main

8 berber, 6 hizmet paketi, Nakit/POS seçimi, toplam hesaplama — tek ekranda

Tablet Kiosk — Gider Modal

Expense Modal

Tablet — Kurulum Ekranları

PIN Screen
PIN Doğrulama
Token Setup
Token Kurulumu

🎬 Demo Videoları

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ü

✨ Özellikler

📊 Admin Dashboard

  • ✅ 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

📱 Tablet Kiosk PWA

  • ✅ 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_id ile duplicate koruması
  • ✅ PWA — tam ekran, ana ekrana eklenebilir
  • ✅ Şubeye kilitlenir — bir kez kurulunca tekrar sorulmaz

🔧 Edge Functions (Deno)

  • ✅ 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)

🛠 Teknoloji Stack

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)

🚀 Kurulum

Ön Koşullar

  • Node.js 18+
  • Supabase hesabı (veya self-hosted)

1. Repo'yu Klonla

git clone https://github.com/YOUR_USERNAME/BarberNet.git
cd BarberNet

2. Dashboard

cd barbershop-dashboard
cp .env.local.example .env.local
# .env.local'ı Supabase bilgilerinle doldur
npm install
npm run dev  # → http://localhost:3000

3. Tablet Kiosk

cd 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:3001

4. Edge Functions

cd supabase
supabase functions deploy submit_sale
supabase functions deploy get_config

5. Veritabanı

supabase db push        # Migrations
supabase db seed         # Demo verisi (opsiyonel)

📁 Proje Yapısı

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/

🔒 Güvenlik

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

📄 Dokümanlar

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ı

📄 Lisans

MIT


BarberNet — Berber salonları için tasarlanmış, modern, offline-first yönetim platformu ✂️

About

Barbershop management platform — admin dashboard, offline-first tablet kiosk PWA and Supabase Edge Functions

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages