# PropOrdo — ayrıntılı ürün dökümü

> Emlak ofisleri için çok kiracılı CRM ve işletim sistemi. https://propordo.homes
> Bu dosya, ürünün gerçekten var olan yeteneklerini listeler; pazarlama vaadi
> değil, uygulamadaki modüllerin dökümüdür.

## Ne işe yarar

PropOrdo, bir emlak şirketinin portföyünü, müşterisini, satışını, kirasını,
muhasebesini ve belgelerini tek sistemde toplar. Tasarımın tezi: pazar
daralırken kazanan, en çok ilan giren değil; müşterisini kaybetmeyen ve satış
dışında da gelir üretendir. Bu yüzden ürün yalnız ilan yönetimi değil,
tekrarlayan gelir (kiralama, mülk yönetimi) ve kanal ölçümü de içerir.

Veri modeli üç katmanlıdır: şirket → şube → kullanıcı. Her sorgu şube
kapsamıyla sınırlanır; bir şubenin verisi diğerine görünmez.

## Modüller

### Portföy
- İlanlarım: danışmanın kendi portföyündeki mülkler
- Satış Süreci: üzerinde çalışılan açık dosyalar
- Lead Havuzu: henüz kimsenin üstlenmediği yeni adaylar
- Rakip İlanlar: diğer ofislerin portallardaki ilanları
- Yetki Belgeleri: sözleşmeler ve süre takibi

### Analiz ve raporlar
- Pazar İstihbaratı: bölge fiyatları, harita, fırsat radarı
- Dönüşüm Hunisi: kanal ve danışman kırılımı, kayıp nedenleri
- Satış Tahmini: 30/60/90 gün beklenen satış ve pazar payı
- Şube Raporları, Rapor Oluşturucu (danışman/bölge/durum bazlı özel raporlar)
- Kâr & Zarar: dönemsel gelir tablosu

### Müşteri ilişkileri
- Müşteriler: talepler ve portföy eşleştirme
- Kişi Rehberi: mal sahipleri ve iş ortakları
- Müşteri Değeri: müşteri başına gelir, uyuyan kayıtlar
- Müşteri Yazışmaları: WhatsApp yazışmaları şubenin kaydı olur
- Randevular: gösterim ve görüşme takvimi
- Hatırlatmalar: görevler ve geri arama takibi
- Ekip içi Mesajlar ve Bildirimler
- Sektör Haberleri: emlak ve ekonomi haber akışı (RSS)

### Satış ve teklifler
- Satış Dosyaları: dosya ve komisyon takibi
- Teklifler: çok dilli teklif gönderimi ve karar takibi
- Komisyon Dağıtımı: danışman, şube ve şirket payı hesabı
- Yönlendirme Ortakları: tadilat, mobilya, sigorta yönlendirmeleri ve komisyonu

### Kiralama ve mülk yönetimi
- Kira Sözleşmeleri: kira, depozito, artış ve tahsilat takvimi
- Mülk Yönetimi: yönetim paketleri ve abonelikler
- Hizmet Talepleri: arıza, bakım, temizlik, tadilat

### Muhasebe
- Kasa & Muhasebe: gelir, gider, hesap bakiyeleri
- Cari & Tahsilat: alacak, borç ve vade takibi
- Çek & Senet: vade takibi, tahsilat ve ödeme
- Düzenli Kalemler: maaş, kira gibi tekrarlayan gelir/gider

### Belgeler ve imza
- Belgeler: şube belge arşivi
- İmza Talepleri: e-imza akışı, token ile korunan açık imza bağlantıları

### Yapay zekâ yardımcıları
- Fotoğraf Temizleme ve Görsel Düzenleme
- İlan Metni üretimi
- Vitrin Sayfası oluşturma
- Kullanım kredi havuzu şirket düzeyindedir; şube başına kredi tavanı
  konabilir ve tüketim Yapay Zekâ Kullanımı ekranından izlenir.

### Pazarlama ve yardımcılar
- Fotoğraf İşleme, QR & Etiket, Hesaplayıcılar, Akademi

### Organizasyon ve yönetim
- Şirket, Şubeler & Üyeler, Roller & İzinler, Personel
- Şirket Raporları, Duyurular & Mevzuat
- Abonelik & Ödemeler, Haber Kaynakları
- Çalışma Bölgeleri, Özel Alanlar, İletişim Ayarları, Takip Kuralları,
  Bildirim Tercihleri

### Entegrasyonlar
- WhatsApp yazışma kaydı
- Telegram bildirim kanalı
- Google Drive belge klasörleri (şirket bazlı OAuth)
- PWA: uygulama telefona kurulabilir (manifest + ikonlar)

## Roller

- Danışman (agent): kendi portföyü, kendi müşterileri, kendi dosyaları
- Şube yöneticisi: şubenin tamamı, şube raporları ve hedefleri
- Şirket yöneticisi (company_admin): tüm şubeler, abonelik, roller, personel
- Platform yöneticisi (admin): şirketler, paketler, siparişler, tahsilat, duyurular
- Bayi/ortak (partner): CRM'e erişimi YOKTUR; yalnız kendi hak ediş defterini
  ve başvurularını gördüğü ayrı bir panel kullanır

İzinler `listings.read.self`, `reports.read.branch` gibi ayrık yetkilerden
oluşur ve sunucu tarafında uygulanır; arayüzde gizlemek yeterli sayılmaz.

## Güvenlik

- Parola + oturum çerezi; parola sızıntı listesine karşı kontrol edilir
- İsteğe bağlı TOTP iki adımlı doğrulama (etkinse parola tek başına oturum
  açmaz; beş dakikalık aşama belirteci verilir)
- Kaba kuvvet koruması hesap bazlı sayaçla yapılır, paylaşılan ofis IP'si
  cezalandırılmaz
- Denetim kaydı (audit log) yalnız eklenir; güncelleme veya silme ucu yoktur
- Çöp kutusu: silinen kayıtlar geri alınabilir (soft delete)
- Günlük otomatik yedek: tüm operasyonel tabloların JSON dökümü, ayrıca
  manuel yedek indirme
- Güvenlik başlıkları: HSTS, nosniff, frame-ancestors/DENY, referrer-policy
- Vekâleten giriş (impersonation) denetim kaydında iki kimlikle birlikte durur

## Fiyatlandırma modeli

- Abonelik ŞİRKET düzeyindedir, kullanıcı başına değil
- Para birimi USD; aylık ya da yıllık ödeme, yıllıkta indirim
- Paketler şube sayısı, üye sayısı, depolama (GB) ve aylık ilan adedi ile
  sınırlanır
- 14 günlük ücretsiz deneme; kredi kartı istenmez
- Güncel paketler ve fiyatlar: https://propordo.homes/api/public/plans
  (bu dosyada ve kodda sabit fiyat tutulmaz)
- Ödemesi aksayan abonelikte sistem önce salt okunur moda geçer, sonra erişimi
  kısar; ödeme ve hesap ekranları her zaman açık kalır

## Bayilik (satış ortaklığı)

- Getirilen şirketin ilk 12 ay ödemelerinden %20 komisyon
- Hak ediş her ödemede kendiliğinden deftere düşer
- Ödeme talebi ortak panelinden açılır, kripto (USDT) ile gönderilir
- Ortağın şirket verisine erişimi yoktur
- Başvuru: https://propordo.homes/partner/basvuru

## Diller

Arayüz Türkçe (birincil), İngilizce ve Rusça. Teklif ve vitrin sayfaları da
çok dilli üretilir.

## Açık uçlar

- GET  /api/public/plans — paket ve fiyat listesi (JSON)
- POST /api/partner/basvuru — bayilik başvurusu
- POST /api/auth/kayit — kayıt (yeni şirket ya da davetle katılım)
- POST /api/auth/giris — giriş
- Şema: https://propordo.homes/api/openapi.json

## İletişim

- Genel: bilgi@propordo.homes
- Bayilik: bayi@propordo.homes
- Güvenlik: guvenlik@propordo.homes