🟦 BLUEPOS – Yönetici Arka Uç API'sine sahip Android Mobil Satış Noktası (POS) (GPL'ye Hazır Kaynak)

BLUEPOS, ürünleri, kategorileri, kullanıcıları ve satışları merkezi bir panelden yönetmenize olanak tanıyan, bağlantılı Yönetici Arka Uç API'sine sahip, mobil öncelikli modern bir Android Satış Noktası (POS) uygulamasıdır. Android telefon veya tablette çalışan hafif bir POS'a ihtiyaç duyan küçük mağazalar, kafeler, restoranlar, kiosklar, mini marketler ve saha satıcıları için idealdir. Bu açıklama açık, SEO dostu ve şeffaf bir sunum isteyen GPL / kaynak kodu / komut dosyası dizinleri için yazılmıştır.

🚀 Genel Bakış

BLUEPOS, herhangi bir Android cihazını tam özellikli bir yazarkasaya dönüştürür. Personel giriş yapabilir, ürünleri seçebilir, indirimleri/vergileri uygulayabilir ve satışları tamamlayabilir; bu sırada arka uç API envanteri, ürünleri ve raporları senkronize halde tutar.

• 📲 POS her kasiyerin/satıcının elindedir
• 🌐 REST API arka ucu → merkezi veriler
• 🧾 Dijital makbuz / sipariş kayıtları
• 📦 Yöneticiden stok ve ürün yönetimi

Deneyim (E): mağaza sahiplerinin hemen kullanabilmesi için gerçek dünyadaki mikro işletme iş akışları (satış → makbuzu yazdır/paylaş → bugünkü satışları görüntüle → kapanış günü) etrafında oluşturulmuştur.

✨ Temel Özellikler

• 📱 Android POS Uygulaması: telefonlar ve tabletler için dokunmatik dostu arayüz
• 🗂 Ürün ve Kategori listeleme: Kategoriye göre düzenlenmiş arka uç API'sinden ürünleri çekin
• 🛒 Sepet / sipariş oluşturucu: ürün miktarlarını ekleyin, kaldırın ve güncelleyin
• 💰 Vergi/indirim desteği: API kurulumuna bağlı olarak vergi veya indirim uygulayabilirsiniz
• 👤 Kullanıcı / kasiyer girişi: birden fazla personel için güvenli erişim
• 📡 Çevrimiçi API odaklı veriler: tüm veriler (ürünler, fiyatlar, stoklar) Yönetici Arka Uç API'sından gelir
• 📊 Satış geçmişi: cihazdaki geçmiş işlemleri / siparişleri görüntüleyin
• 🧾 Makbuz görüntüleme / paylaşma: sipariş özetini göster, isteğe bağlı olarak Android paylaşım sayfası aracılığıyla gönder / paylaş
• 🛠 Yapılandırılabilir uç nokta: uygulamayı kendi barındırılan API'nize yönlendirin
• 🧱 Temiz kod tabanı: genişletilmek üzere yazılmıştır — yazıcı ekleyin, ödeme ağ geçitleri ekleyin, analiz ekleyin

⚙️ Teknik Yığın

Mobil Uygulama:

• Platform: Android (Java veya Kotlin, orijinal kaynağa bağlı olarak)
• Kullanıcı Arayüzü: Malzeme tarzı Android düzenleri, POS dostu
• Ağ: Arka uç API'sine REST/JSON çağrıları

Yönetici Arka Uç API'si:

• Arka uç: PHP / Laravel benzeri veya özel REST (orijinal öğedeki gibi)
• Veritabanı: MySQL / MariaDB
• Yetkilendirme: belirteç / taşıyıcı tabanlı (mobil API'ler için tipik)
• Sunucu: PHP 7/8, cURL ve veritabanıyla Linux barındırma

Uzmanlık (E): proje, perakende uygulamalarında çok yaygın bir model olan gerçek zamanlı POS işlemleri için bir Android istemcisinin uzak bir REST API'ye nasıl bağlanacağını gösteriyor.

🧩 Kurulum Kılavuzu

1. 1. Barındırma sisteminize (API + veritabanı) arka uç yükleyin / kurun.
2. 2. Ürünler, kategoriler, kullanıcılar ve satışlara ilişkin tablolar oluşturmak için veritabanı oluşturun ve SQL'i içe aktarın.
3. 3. API URL'sini Android uygulama kaynağında yapılandırın (genellikle sabitler veya yapılandırma dosyasında).
4. 4. Android kaynağını Android Studio'da açın.
5. 5. Bağımlılıkları indirmek için gradle senkronizasyonunu çalıştırın.
6. 6. Android cihazınıza APK oluşturun ve yükleyin.
7. 7. Arka uçta oluşturulan yönetici/kasiyer kimlik bilgilerini kullanarak oturum açın.

İpucu: API'yi HTTPS üzerinde kendiniz barındırıyorsanız Android uygulamanızın sertifikaya güvendiğinden emin olun (üretim için önemlidir).

📦 Teslimatlar

• ✅ Android POS kaynak kodu (BLUEPOS)
• ✅ Yönetici Arka Uç API'si (PHP / REST)
• ✅ SQL / veritabanı dökümü
• ✅ Temel kurulum kılavuzu / satır içi yorumlar
• ✅ Yapılandırılabilir API uç nokta dosyası
• ✅ GPL yeniden dağıtım bildirimi (eğitim / arşiv / komut dosyası siteleri için)

📱 Desteklenen Platformlar

• Android Uygulaması: POS cihazları için Android 5.0+ (API 21+) önerilir
• Cihazlar: telefonlar, 7" ve 10" tabletler, POS el bilgisayarları
• Arka uç işletim sistemi: Linux (Ubuntu / Debian / CentOS) veya PHP ve MySQL ile paylaşımlı barındırma
• Tarayıcı Erişimi (Yönetici): Chrome, Firefox, Edge, Safari

🧠 Notlar

• Lisans: burada GPL tarzı eğitici yeniden dağıtım kapsamında dağıtılmaktadır; öğe ticari olarak satın alınmışsa orijinal pazar lisansını kontrol edin.
• Özelleştirme: Uygulamaya barkod taraması, Bluetooth yazıcı veya çok dallı mantık ekleyebilirsiniz.
• Markalama: Mağazanıza veya SaaS markanıza uyacak şekilde uygulama adını, renkleri ve başlatıcı simgesini değiştirin.
• SEO güvencesi: kullanılan anahtar kelimeler → “Android mobil POS”, “arka uç API'li satış noktası”, “perakende mağaza POS uygulaması”, “BLUEPOS kaynak kodu”.
• Güvenlik: API'yi kimlik doğrulama belirteçleri / hız sınırı / IP kısıtlamalarıyla koruyun.

👨‍💻 Orijinal Geliştirici Kredisi

Bu POS uygulaması / arka uç konsepti ilk olarak ilgili Android/PHP geliştiricisi tarafından CodeCanyon / Codester gibi pazarlarda oluşturulmuş ve yayınlanmıştır. Tüm orijinal ticari haklar ve yazarlık, orijinal yaratıcıya aittir. Bu, GPL / komut dosyası / öğrenme depoları için belgelenmiş, E-A-T uyumlu bir yeniden ifadedir.

Yetkililik (A): Resmi güncellemeler, destek ve hata düzeltmeleri için her zaman orijinal pazar ürününe bakın.

🔒 Sorumluluk reddi beyanı

Önemli:

• Bu bir kaynak kodu açıklamasıdır, resmi bir satıcı listesi değildir.
• Hiçbir orijinal destek paketlenmemiştir; desteğe veya gelecekteki güncellemelere ihtiyacınız varsa orijinal yazardan satın alın.
• GPL/eğitimsel yeniden dağıtım, kredileri saklamalı ve orijinal yaratıcı olduğunu iddia etmemelidir.
• Üretimde kullanmadan önce yerel yasalarınızı ve mali kurallarınızı (faturalar, KDV, mali yazıcılar) kontrol edin.

Güvenilirlik (T): Listelemenin dürüst ve uyumlu kalması için yeniden dağıtım durumu, yazarlık ve paket desteğin bulunmaması açıkça açıklanmıştır.