Luma-Server

Django REST Framework tabanlı kamera ve flash kontrol sistemi için API sunucusu. Çoklu cihaz yönetimi, proje/collection organizasyonu ve donanım kontrolü sağlar.

📋 İçindekiler

Özellikler
Gereksinimler
Kurulum
Yapılandırma
Kullanım
Dokümantasyon
API Endpoints
Proje Yapısı
Geliştirme

✨ Özellikler

🎥 Kamera Kontrolü: Advantech USB-4751L donanımı ile kamera ve flash tetikleme
📱 Çoklu Cihaz Yönetimi: Raspberry Pi tabanlı cihazlarla HTTP üzerinden iletişim
📁 Proje Yönetimi: Proje ve collection bazlı dosya organizasyonu
⚙️ Ayar Yönetimi: Kamera ve flash ayarlarını merkezi olarak yönetme
📥 Dosya İndirme: Proje ve collection'ları ZIP formatında indirme
🔄 Paralel İşlemler: ThreadPoolExecutor ile eş zamanlı cihaz işlemleri

🔧 Gereksinimler

Python 3.8+
Django 5.2.7
Django REST Framework
django-cors-headers
requests
Advantech BDaq SDK (Windows için - donanım kontrolü için)

📦 Kurulum

Windows Kullanıcıları İçin

Windows'ta ilk kurulum için detaylı kılavuz: Windows Kurulum Kılavuzu

Hızlı Kurulum (Windows):

setup.bat dosyasını çift tıklayın (otomatik kurulum)
Kurulum tamamlandıktan sonra start.bat dosyasını çift tıklayın (sunucuyu başlat)

Manuel Kurulum

1. Projeyi Klonlayın

git clone <repository-url>
cd Luma-Server

2. Virtual Environment Oluşturun

python -m venv venv

# Windows
venv\Scripts\activate

# Linux/Mac
source venv/bin/activate

3. Bağımlılıkları Yükleyin

pip install -r requirements.txt

4. Veritabanını Oluşturun

python manage.py migrate

5. Sunucuyu Başlatın

python manage.py runserver

Sunucu varsayılan olarak http://127.0.0.1:8000/ adresinde çalışacaktır.

Windows'ta: start.bat dosyasını çift tıklayarak da sunucuyu başlatabilirsiniz.

⚙️ Yapılandırma

Ortam Değişkenleri

Production ortamı için .env dosyası oluşturmanız önerilir:

SECRET_KEY=your-secret-key-here
DEBUG=False
ALLOWED_HOSTS=your-domain.com,localhost

Settings.py Ayarları

PROJECT_DIR: Proje dosyalarının saklanacağı klasör (varsayılan: "projects")
ALLOWED_HOSTS: İzin verilen host'lar (production için yapılandırılmalı)
DEBUG: Debug modu (production için False olmalı)

📚 Dokümantasyon

Detaylı dokümantasyon için aşağıdaki dosyalara bakın:

Kurulum Kılavuzları

Windows Kurulum Kılavuzu - Windows'ta sıfırdan kurulumdan dev sunucunun ayağa kaldırılmasına kadar tüm adımlar

Kullanım Kılavuzları

Hızlı Başlangıç Kılavuzu - Sistem açıldığında izlenmesi gereken adımlar ve temel kullanım
API Reference - Tüm endpoint'lerin detaylı referansı, parametreler ve örnekler
Frontend Entegrasyon Kılavuzu - Frontend uygulamalarının API'ye nasıl bağlanacağı

Teknik Dokümantasyon

Sistem Mimarisi - Sistem yapısı, bileşenler ve mimari katmanlar
Sistem Çalışma Mantığı - Veri akışı, işlem süreçleri ve çalışma prensipleri

Dokümantasyon İçerikleri

Hızlı Başlangıç Kılavuzu:

Sistem açıldığında izlenmesi gereken adımlar
Her endpoint için detaylı örnekler
Request/Response formatları
Hata durumları ve çözümleri
Tam işlem akışı

API Reference:

Tüm endpoint'lerin detaylı açıklamaları
Request/Response şemaları
Parametre açıklamaları
Geçerli değerler ve seçenekler
Hata durumları ve mesajları
cURL örnekleri

Frontend Entegrasyon Kılavuzu:

CORS yapılandırması
API bağlantı yöntemleri
React, Vue, Vanilla JavaScript örnekleri
Hata yönetimi
Best practices

Sistem Mimarisi:

Sistem bileşenleri ve katmanlar
Veri akışı diyagramları
Veritabanı şeması
Teknoloji stack
Güvenlik mimarisi

Sistem Çalışma Mantığı:

İşlem akışları
Paralel işlem yönetimi
Donanım kontrolü
Hata yönetimi
Veri senkronizasyonu

🚀 Kullanım

Temel İşlemler

1. Proje Oluşturma

POST /api/create-project/
Content-Type: application/json

{
  "name": "Yeni Proje"
}

2. Cihaz Ekleme

POST /api/add-device
Content-Type: application/json

{
  "name": "Raspberry Pi 1",
  "ip": "192.168.1.100",
  "device_id": "001"
}

3. Kamera Ayarlarını Güncelleme

PATCH /api/update-camera-setting
Content-Type: application/json

{
  "iso_speed": "400",
  "shutter_speed": "1/60",
  "aperture": "8",
  "white_balance": "Auto"
}

4. Kameraları Yeniden Bağlama

POST /api/reconnect-cameras

📡 API Endpoints

Proje Yönetimi

Method	Endpoint	Açıklama
POST	`/api/create-project/`	Yeni proje oluştur
GET	`/api/get-project-list`	Tüm projeleri listele
GET	`/api/get-project-detail/<id>`	Proje detayını getir
PATCH	`/api/update-project/<id>`	Projeyi güncelle
DELETE	`/api/delete-project/<id>`	Projeyi sil
GET	`/api/download-project/<id>`	Projeyi ZIP olarak indir

Collection Yönetimi

Method	Endpoint	Açıklama
POST	`/api/create-collection/<project_id>`	Yeni collection oluştur
GET	`/api/get-collection-list/<project_id>`	Collection listesini getir
GET	`/api/get-collection-detail/<id>`	Collection detayını getir
GET	`/api/download-collection/<id>`	Collection'ı ZIP olarak indir
DELETE	`/api/delete-collection/<id>`	Collection'ı sil

Dosya Yönetimi

Method	Endpoint	Açıklama
GET	`/api/get-file-list/<collection_id>`	Dosya listesini getir
GET	`/api/get-file-detail/<id>`	Dosya detayını getir
GET	`/api/download-file/<id>`	Dosyayı indir

Cihaz Yönetimi

Method	Endpoint	Açıklama
POST	`/api/add-device`	Yeni cihaz ekle
GET	`/api/get-device-list`	Tüm cihazları listele
PATCH	`/api/update-device/<id>`	Cihazı güncelle
DELETE	`/api/delete-device/<id>`	Cihazı sil
POST	`/api/reconnect-cameras`	Tüm cihazlarda kameraları yeniden bağla
DELETE	`/api/delete-all-photos`	Tüm cihazlardan fotoğrafları sil
POST	`/api/reset-devices`	Tüm cihazları resetle

Ayar Yönetimi

Method	Endpoint	Açıklama
GET	`/api/get-camera-setting`	Kamera ayarlarını getir
PATCH	`/api/update-camera-setting`	Kamera ayarlarını güncelle
GET	`/api/get-flash-setting`	Flash ayarlarını getir
PATCH	`/api/update-flash-setting`	Flash ayarlarını güncelle

📂 Proje Yapısı

Luma-Server/
├── api/                    # Ana uygulama
│   ├── models/            # Veritabanı modelleri
│   │   ├── Project.py
│   │   ├── Collection.py
│   │   ├── File.py
│   │   ├── Device.py
│   │   ├── CameraSetting.py
│   │   └── FlashSetting.py
│   ├── serializers/       # DRF serializers
│   ├── views/             # API view'ları
│   │   ├── ProjectViews/
│   │   ├── CollectionViews/
│   │   ├── FileViews/
│   │   ├── DeviceViews/
│   │   └── SettingViews/
│   └── utils/             # Yardımcı fonksiyonlar
│       ├── CamTrigger.py  # Donanım kontrolü
│       └── PiRequests.py  # Cihaz iletişimi
├── LumaServer/            # Django proje ayarları
│   ├── settings.py
│   ├── urls.py
│   └── wsgi.py
├── manage.py
├── requirements.txt
└── README.md

🔨 Geliştirme

Veritabanı Migrations

Yeni model değişikliklerinden sonra:

python manage.py makemigrations
python manage.py migrate

Test Çalıştırma

python manage.py test

Donanım Kontrolü

CamTrigger.py modülü Advantech USB-4751L cihazını kontrol eder. Windows ortamında BDaq SDK'nın yüklü olması gerekir.

Cihaz İletişimi

Raspberry Pi cihazlarının aşağıdaki endpoint'leri desteklemesi beklenir:

GET /api/get-device-data - Cihaz bilgilerini getir
GET /api/get-photo-list - Fotoğraf listesini getir
POST /api/set-device-settings - Kamera ayarlarını gönder
DELETE /api/delete-all-photos - Tüm fotoğrafları sil
GET /api/disconnect-all - Tüm kameraları bağlantıyı kes
GET /api/connect-all - Tüm kameraları bağla
GET /api/reset-camera - Kamerayı resetle

⚠️ Önemli Notlar

Güvenlik: Production ortamında SECRET_KEY ve DEBUG ayarlarını mutlaka yapılandırın.
Donanım: USB-4751L kontrolü sadece Windows ortamında çalışır.
Cihazlar: Raspberry Pi cihazlarının aynı ağda olması ve API endpoint'lerini desteklemesi gerekir.
Dosya Yönetimi: Proje dosyaları projects/ klasöründe saklanır (gitignore'da).

📝 Lisans

Bu proje özel kullanım içindir.

🤝 Katkıda Bulunma

Fork edin
Feature branch oluşturun (git checkout -b feature/amazing-feature)
Commit edin (git commit -m 'Add some amazing feature')
Push edin (git push origin feature/amazing-feature)
Pull Request açın

📧 İletişim

Sorularınız için issue açabilirsiniz.

Name		Name	Last commit message	Last commit date
Latest commit History 8 Commits
LumaServer		LumaServer
api		api
docs		docs
.gitignore		.gitignore
LumaServer API.postman_collection.json		LumaServer API.postman_collection.json
README.md		README.md
XNavi.exe		XNavi.exe
manage.py		manage.py
postman_collection.json		postman_collection.json
requirements.txt		requirements.txt
setup.bat		setup.bat
start.bat		start.bat

Folders and files

Latest commit

History

Repository files navigation

Luma-Server

📋 İçindekiler

✨ Özellikler

🔧 Gereksinimler

📦 Kurulum

Windows Kullanıcıları İçin

Manuel Kurulum

1. Projeyi Klonlayın

2. Virtual Environment Oluşturun

3. Bağımlılıkları Yükleyin

4. Veritabanını Oluşturun

5. Sunucuyu Başlatın

⚙️ Yapılandırma

Ortam Değişkenleri

Settings.py Ayarları

📚 Dokümantasyon

Kurulum Kılavuzları

Kullanım Kılavuzları

Teknik Dokümantasyon

Dokümantasyon İçerikleri

🚀 Kullanım

Temel İşlemler

1. Proje Oluşturma

2. Cihaz Ekleme

3. Kamera Ayarlarını Güncelleme

4. Kameraları Yeniden Bağlama

📡 API Endpoints

Proje Yönetimi

Collection Yönetimi

Dosya Yönetimi

Cihaz Yönetimi

Ayar Yönetimi

📂 Proje Yapısı

🔨 Geliştirme

Veritabanı Migrations

Test Çalıştırma

Donanım Kontrolü

Cihaz İletişimi

⚠️ Önemli Notlar

📝 Lisans

🤝 Katkıda Bulunma

📧 İletişim

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Uh oh!

Contributors

Uh oh!

Languages

Packages