Veritabanı Sözlüğü

Karabağlar Belediyesi El Emeği Pazaryeri Projesi Teknik Dokümantasyonu.

Proje Amacı

Bu proje, Karabağlar ilçesinde ikamet eden ve evde üretim yapan (el emeği göz nuru ürünler) hanımların, ürünlerini dijital bir pazaryeri platformu üzerinden güvenle satabilmelerini sağlamak amacıyla geliştirilmektedir. Belediye güvencesiyle hanımların aile ekonomisine katkıda bulunmaları hedeflenmektedir.

Hedef Kitle

Sistemin birincil kullanıcıları (satıcılar) 40-50 yaş üzeri, teknoloji kullanımı kısıtlı, genel olarak ilk ve ortaokul mezunu ev hanımlarıdır. Bu sebeple tüm teknolojik altyapı ve arayüzler, "en basit" ve "sıfır hata" odaklı kurgulanmıştır. Cep telefonu numarası ve güvenli şifre ile giriş temel prensiptir.

sellers / Satıcı Hanımlar
Üretici Bilgileri
Kullanım Amacı: Ev hanımlarının tüm sistem kimliğini yönetir. Cep telefonu numarası ve şifre ile giriş yapısını desteklemek üzere optimize edilmiştir.
idBenzersiz kimlik numarası.
phoneSisteme giriş için kullanılan benzersiz cep telefonu numarası.
passwordHesap güvenliği için kullanılan şifrelenmiş veri.
first_nameHanımın adı.
last_nameHanımın soyadı.
profile_photoProfil resmi yolu (Görünürlük ve güven için).
bioHanımın el emeği üretim hikayesi (Pazarlama odaklı).
addressÜrünlerin teslim alınacağı ev adresi.
ibanHakedişlerin yatırılacağı TR formatlı banka hesabı.
statusHesabın durumu: Beklemede, Aktif veya Askıda.
is_verifiedBelediyenin hanımı ve üretim yerini onayladığı mühür.
created_atKayıt tarihi.
categories / Kategoriler
Hiyerarşi
Kullanım Amacı: Ürünlerin kolay bulunması için ağaç yapısında (Tree) bir hiyerarşi oluşturur.
idKategori benzersiz ID.
parent_idÜst kategori ID (Alt kategoriler için).
nameKategori başlığı (Örn: Örgü İşleri).
slugURL dostu isim (Örn: orgu-isleri).
sort_orderSitedeki görünüm sırası.
products / Ürünler
Envanter
Kullanım Amacı: Hanımların yüklediği tüm el emeği ürünleri saklar. Her ürün belediye onayına tabidir.
idÜrün benzersiz ID.
seller_idÜrünü hangi hanımın yaptığı (sellers tablosuna bağlı).
category_idÜrünün ait olduğu kategori.
titleÜrün adı.
descriptionDetaylı ürün açıklaması ve materyal bilgisi.
priceBirim satış fiyatı.
stockEldeki güncel adet (Stok biterse satışa kapanır).
cover_imageAna görsel yolu.
statusOnay bekliyor, Yayında, Tükendi veya Pasif.
created_atYükleme tarihi.
orders / Ana Sipariş
Kritik
Kullanım Amacı: Müşterinin sepetini tek bir ana kayıt altında toplar. Müşteri bilgilerini ve ödeme öncesi/sonrası durumu yönetir.
idSipariş ID.
order_noMüşteriye ve bankaya iletilen takip numarası.
total_priceSepetteki tüm ürünlerin toplam tutarı.
statusGenel durum: Ödeme Bekliyor, Hazırlanıyor, Kargolandı vb.
customer_nameAlıcı adı.
customer_phoneAlıcı iletişim numarası.
customer_emailAlıcı e-posta (Fatura için).
shipping_addressÜrünün gideceği açık adres.
created_atSipariş saati.
order_items / Sipariş Parçaları
Pazaryeri Mantığı
Kullanım Amacı: Bir siparişi satıcılara göre böler. Her hanım bu tablo üzerinden sadece kendi ürününü görür ve hazırlar.
idBenzersiz satır ID.
order_idBağlı olduğu ana sipariş.
seller_idÜrünü hazırlayacak hanımın ID'si.
product_idSatılan ürün ID.
product_titleSatış anındaki ürün adı (Geçmiş için yedekli).
quantityKaç adet alındı?
priceSatış anındaki birim fiyat (Maliyet raporu için kritik).
sub_statusSadece bu ürünün hazırlık durumu (Bekliyor, Hazır, Teslim Edildi).
payments / Ödeme Logları
Güvenlik
Kullanım Amacı: Banka veya PayTR ile yapılan trafiği en ince ayrıntısına kadar saklar.
idİşlem kayıt ID.
order_idHangi sipariş için ödeme yapıldı?
providerÖdeme kuruluşu (Örn: paytr, iyzico).
transaction_idBankadan dönen resmi işlem numarası.
amountTahsil edilen toplam tutar.
statusBaşarılı, Hatalı veya Onay Bekliyor.
raw_responseBankadan gelen tüm JSON cevabı (Her türlü teknik detay burada).
error_messageHata oluştuysa bankanın verdiği Türkçe açıklama.
created_atÖdeme denemesi saati.
collection_requests / Lojistik Toplama
Belediye İşlemi
Kullanım Amacı: Hanımların hazırladığı ürünleri belediye kuryelerinin evden alıp merkeze getirme sürecini yönetir.
idToplama talep ID.
order_idİlgili sipariş.
seller_idÜrünü alınacak olan hanım.
statusKurye atandı, Ürün alındı, Merkeze ulaştı.
courier_notesKuryenin notları (Örn: Evde yoktu, paket hasarlıydı).
request_dateTalebin oluşturulma anı.
payouts / Hakediş Takibi
Finans
Kullanım Amacı: Komisyonlar düşüldükten sonra hanımların cebine girecek net paranın banka transfer sürecini izler.
idÖdeme talep ID.
order_idHangi siparişin hakedişi?
seller_idParayı alacak olan hanım.
amountÖdenecek net TL tutarı.
statusBekliyor, İşleniyor, Ödendi veya İptal.
transaction_referenceBelediyenin banka dekont no / referansı.
paid_atParanın hesaba geçtiği an.
Teknik Altyapı ve Veritabanı Mimari Dokümantasyonu
Tüm hakları saklıdır.