Uçtan Uca Operasyon & API Kılavuzu

Sahne Pro Nasıl Çalışır?

Etkinlik teknolojileri, ses-ışık-görüntü kiralama ve sahne prodüksiyon şirketleri için depodan şantiyeye, mobil barkodlu sevkten RESTful API entegrasyonlarına kadar tüm operasyonel yaşam döngüsü.

Temel Altyapı

1 Sistem Mimarisi & Çok Kiracılı (Multi-Tenant) İzolasyon

Sahne Pro, büyük ölçekli ses/ışık prodüksiyon firmalarının, sahne mekanik kiralama şirketlerinin ve alt yüklenicilerin operasyonlarını tam veri güvenliği ile yürütebilmesi için Logical Multi-Tenant mimarisi ile tasarlanmıştır.

Şirket İçi Veri İzolasyonu

Her kayıt company_id ile indekslenir. SQL sorgularında tenant filtreleme otomatik uygulanır, şirketler arası veri sızıntısı imkansızdır.

Granüler Rol Yetkilendirme

Admin, Operasyon Yöneticisi, Şantiye Şefi, Depo Görevlisi ve Saha Teknisyeni rolleri ile sadece izin verilen menüler ve butonlar açılır.

Hibrit Masaüstü & Mobil Yapı

Ofiste geniş ekran ERP web paneli; depoda ve etkinlik şantiyesinde ise kamera barkod tarayıcılı hızlı Mobil PWA senkronize çalışır.

Sahne Pro — Masaüstü Yönetim Kokpiti (Dashboard)
Sahne Pro Masaüstü Dashboard
Masaüstü Kokpiti: Aylık ciro, aktif işler, kritik envanter durumları ve yaklaşan araç sevkiyatları tek bakışta izlenir.
İlk Kurulum

2 Şirket Profili, Depolar & Lojistik Araç Tanımları

Kayıt olduktan sonra ilk adım ana şirket bilgilerinizi (vergi dairesi, logo, para birimi) tanımlamak ve fiziki depolarınızı sisteme işlemektir.

Çoklu Depo Desteği: Firmanızın birden fazla deposu (Örn: Merkez Depo - Maslak, Anadolu Yakası Antrepo veya Bodrum Şube Deposu) varsa ekipmanların hangi lokasyonda olduğunu anlık stok transferleriyle yönetebilirsiniz.

Depo & Raf Kodlaması

Koridor, raf ve kat kodları tanımlanarak barkod tarama esnasında cihazın depodaki tam fiziki konumu ekranda gösterilir.

Filo & Araç Tanımları

Tır, kamyon ve servis araçlarının plaka, hacim (m3) ve şoför bilgileri kaydedilerek sevkiyat atamalarına hazır hale getirilir.

Envanter Teknolojisi

3 Akıllı Envanter, Kasa (Flight Case) & QR/Barkod Hiyerarşisi

Prodüksiyon sektöründe ekipmanlar tek tek taşınmaz; genellikle 2'li, 4'lü veya 8'li Flight Case (kasa) içinde sevk edilir. Sahne Pro, Türkiye'de ilk defa Parent-Child (Kasa ve Cihaz) barkod hiyerarşisini sunar.

Tek Okutmayla Toplu Sevk: Bir Flight Case barkodu okutulduğunda içindeki tüm DMX robot ışıklar, optik lensler ve kablolar otomatik olarak o araca yüklenmiş sayılır. Teknisyenlerinizin saatlerce tek tek barkod okutmasına gerek kalmaz!
Sahne Pro — Akıllı Envanter & Ekipman Yönetimi
Sahne Pro Envanter Yönetimi
Envanter Modülü: Ses mikserleri, line-array hoparlörler, DMX fixture'lar, trusslar ve kasa içi seri numaralı cihazlar listelenir.
Planlama & Rezervasyon

4 İş (Proje) Oluşturma, Fazlar & Entegre Takvim

Etkinlik talebi geldiğinde sistemde yeni bir İş kaydı açılır: Konser, Festival, Kurumsal Lansman, Düğün veya Fuar. İş oluşturulduğunda ekipmanlar belirlenen tarihler için Rezerve edilir ve çift rezervasyon (çakışma) uyarısı verilir.

Operasyonel Takvim Görünümü
Sahne Pro Takvim

7 Adımlı İş Fazı

Her iş aşağıdaki fazları otomatik olarak takip eder:

  1. Depo Hazırlık & Test: Cihazların bakımı ve kasalanması.
  2. Araç Yükleme (Sevkiyat): Barkod taramasıyla sevk.
  3. Yolda / Transfer: Araç şantiye yolunda.
  4. Kurulum & Soundcheck: Sahne kurulumu ve prova.
  5. Canlı Etkinlik (Show): Gösteri anı.
  6. Söküm (Demontaj): Kasalara geri toplama.
  7. Depo Dönüş & Sayım: Barkodlu geri teslim.
Saha Lojistiği

5 Araç Yükleme, Sevk & Mobil Barkod Okuma

Etkinlik sabahı depo ekibi Sahne Pro Mobil uygulamasını açar. Kamera ile barkod veya QR kodlar tırın kapısında okutulur. Okutulan her ekipman yeşile döner (Yüklendi). Eksik kalan veya yanlış araca yüklenmek istenen kasa anında sesli ve titreşimli ikaz verir.

Masaüstü İş Listesi & Sevk Takibi
Sahne Pro İş Listesi
Mobil Sevk Ekranı
Sahne Pro Mobil Sevk
Resmi Sevk İrsaliyesi & PDF Manifestosu: Yükleme tamamlandığında tek tuşla araç plakasını, şoför TC/telefonunu ve araçtaki tüm ekipmanların seri numaralarını içeren karekodlu resmi sevk manifestosu PDF olarak indirilir.
Canlı Saha Takibi

6 Şantiye & Saha Kurulumu (Checklist & Arıza Bildirimi)

Şantiye şefi sahaya ulaştığında kamyonu boşaltır ve şantiye checklist'ini başlatır: Truss montajı, motor askıları, elektrik panosu beslemesi, DMX sinyal hattı, hoparlör açılandırması.

Dijital Kurulum Kontrol Listesi

Her iş için özelleştirilmiş güvenlik ve kurulum adımları şantiye şefi tarafından mobil ortamda işaretlenerek onaylanır.

Fotoğraflı Sahne Arıza Kaydı

Kabloda kopukluk veya robotta motor arızası varsa teknisyen anında fotoğraf çekip arıza fişi oluşturur; merkez depo hemen ikame ürün organize eder.

Finans & Hakediş

7 Şantiye Masrafları, Yakıt, Otel & Personel Yevmiyeleri

Etkinlik süresince yapılan yakıt, otopark, otel, yemek ve hırdavat harcamaları şantiye şefi tarafından fiş fotoğrafı yüklenerek anında işe masraf olarak yazılır.

Fiş & Fatura OCR Desteği

Benzin istasyonundan alınan fiş mobil kamerayla çekilir; KDV ve tutar işin gerçek maliyetine otomatik olarak işlenir.

Otomatik Yevmiye & Mesai

Teknisyen, tonmaister, ışık operatörü ve roadie'lerin günlük yevmiyeleri ve gece mesaileri iş kartında toplanır.

Demontaj & Sayım

8 Söküm, Depo Dönüşü, Sayım & Hasar Yönetimi

Konser veya festival bittiğinde söküm başlar. Depoya dönen kamyonlar yeniden barkod okutularak boşaltılır.

  • Eğer bir kablo veya mikrofon şantiyede unutulduysa sistem kırmızı uyarı verir: "1 Adet Shure SM58 eksik!"
  • Hasarlı gelen cihazlar tek tıkla Teknik Servis & Bakım modülüne yönlendirilir ve bir sonraki etkinliğe rezerve edilmesi engellenir.
Yönetim Raporu

9 İş Kapanışı, Faturalandırma & Gerçek Karlılık (P&L)

Tüm cihazlar depoya eksiksiz döndüğünde ve masraflar onaylandığında operasyon yöneticisi işi kapatır. Sahne Pro, sektörün en kritik ihtiyacı olan Gerçek Proje Karlılığı grafiğini çizer:

Net Proje Karlılığı = Müşteri Fatura Tutarı — (Kiralık Alt-Yüklenici Maliyetleri + Araç Yakıt/Lojistik + Otel/Yol + Personel Yevmiyeleri + Ekipman Amortismanı)
Developer Portal

10 Sahne Pro RESTful API Entegrasyon Rehberi

Sahne Pro, üçüncü taraf yazılımlarla (muhasebe programları, kurumsal web siteleri, mobil uygulamalar, barkod el terminalleri) çift yönlü entegrasyon için tam teşekküllü bir RESTful API sunar.

1. Kimlik Doğrulama (Authentication)

Tüm istekler HTTP Header içinde standart Authorization: Bearer <token> parametresi taşımalıdır. İlk olarak aşağıdaki endpoint ile token alınır:

POST /api/v1/auth/login
curl -X POST "https://pro.sahne.app/api/v1/auth/login" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "password": "GuvenliSifreniz123"
  }'
200 OK JSON Yanıtı
{
  "success": true,
  "message": "Giriş başarılı",
  "token": "8ed09db2f7bba0ccecbf5f7d162a60a27d5b84edc3278d3f10a77c83062f054f",
  "user": {
    "id": 1,
    "full_name": "Sistem Yöneticisi",
    "roles": ["admin", "manager"],
    "company": {
      "id": 1,
      "name": "Sahne Pro Prodüksiyon A.Ş."
    }
  }
}

2. İşleri & Projeleri Listeleme

Aktif, planlanan veya tamamlanan etkinlik projelerini durum ve tarih filtresiyle çeker:

GET /api/v1/jobs?status=active&limit=10
curl -X GET "https://pro.sahne.app/api/v1/jobs?status=active" \
  -H "Authorization: Bearer 8ed09db2f7bba0ccecbf5f7d162a60a27d5b84edc3278d3f10a77c83062f054f" \
  -H "Accept: application/json"
200 OK Proje Listesi Yanıtı
{
  "success": true,
  "total": 24,
  "data": [
    {
      "id": 104,
      "job_code": "JOB-2026-089",
      "title": "Harbiye Açıkhava Konser Prodüksiyonu",
      "client": "Atlantis Yapım",
      "venue": "Harbiye Cemil Topuzlu Açıkhava Tiyatrosu",
      "start_date": "2026-09-25 10:00:00",
      "end_date": "2026-09-26 02:00:00",
      "phase": "loading",
      "loading_progress": {
        "total_items": 48,
        "scanned_items": 36,
        "percent": 75
      }
    }
  ]
}

3. Mobil Barkod Tarama & Araç Sevk API'si

Kamera veya el terminalinden okunan barkodu anında ilgili araca ve işe eşler:

POST /api/v1/logistics/scan
curl -X POST "https://pro.sahne.app/api/v1/logistics/scan" \
  -H "Authorization: Bearer 8ed09db2f7bba0ccecbf5f7d162a60a27d5b84edc3278d3f10a77c83062f054f" \
  -H "Content-Type: application/json" \
  -d '{
    "job_id": 104,
    "barcode": "FC-SP-0042",
    "vehicle_plate": "34 SP 9901",
    "action": "dispatch_load"
  }'
200 OK Barkod Tarama Yanıtı
{
  "success": true,
  "message": "L-Acoustics K2 Kasa (Barkod: FC-SP-0042) 34 SP 9901 plakalı araca yüklendi.",
  "item": {
    "id": 412,
    "name": "L-Acoustics K2 Line Array Kasa (4'lü)",
    "is_case": true,
    "child_devices_count": 4,
    "status": "loaded"
  },
  "remaining_unloaded": 11
}

4. HTTP Durum Kodları Tablosu

Kod Durum Açıklama
200 OK Başarılı İstek başarıyla işlendi ve veri döndü.
201 Created Oluşturuldu Yeni iş, envanter veya masraf kaydı başarıyla eklendi.
400 Bad Request Geçersiz İstek Zorunlu parametreler eksik veya format hatalı.
401 Unauthorized Yetkisiz Geçersiz veya süresi dolmuş Bearer token.
403 Forbidden Erişim Engellendi Kullanıcı rolünün bu işlem için yetkisi yok veya başka şirketin verisi talep edildi.
404 Not Found Bulunamadı Belirtilen ID veya barkod numarası şirketinize ait değil veya sistemde yok.
Kod panoya kopyalandı!