Pulsify

KOBİ'ler için AI Destekli Operasyon Yönetim Platformu

---

Nedir?

Pulsify, küçük ve orta ölçekli işletmelerin (KOBİ) müşteri iletişimini, sipariş yönetimini, kargo takibini ve operasyon süreçlerini tek ekrandan, yapay zeka destekli olarak yönetmesini sağlayan modern bir platformdur.

Türkçe doğal dil işleme (NLP) ile güçlendirilmiş AI asistanı sayesinde; sipariş durumu sorgulama, kargo gecikmelerini tespit etme, müşteri memnuniyetini analiz etme ve günlük operasyon raporu üretme işlemleri otomatik olarak gerçekleşir.

Proje Tanıtım Videosu: https://youtu.be/aXu3FrLa9jc

Proje Sunumu:

---

Özellikler

Modül	Özellik	Açıklama
Sipariş Yönetimi	CRUD + Durum Takibi	Tüm siparişleri listele, filtrele, güncelle
Kargo Takibi	Anlık Durum + Gecikme Uyarısı	Geciken kargoları otomatik tespit et
Müşteri Paneli	Sadakat Skoru + Duygu Analizi	Mutlu/mutsuz müşterileri AI ile sınıflandır
AI Chatbot	Türkçe NLP	Müşteri mesajlarını anlayan akıllı asistan
Günlük Rapor	AI Özet	Gemini ile otomatik operasyon raporu
Stok Takibi	Kritik Stok Uyarısı	Eşik altına düşen ürünleri anlık gör

---

Ekran Görüntüleri

Projenin arayüzüne ve çalışma mantığına dair görselleri aşağıda bulabilirsiniz:

Dashboard	Sipariş Yönetimi

AI Chatbot	Kargo Takibi

---

Mimari

┌─────────────────────────────────────────────────────────┐
│                    FRONTEND (Vercel)                    │
│          React 18 + TypeScript + TailwindCSS            │
│        Zustand State · React Router v6 · Axios          │
└───────────────────────┬─────────────────────────────────┘
                        │ HTTPS / REST
┌───────────────────────▼─────────────────────────────────┐
│                   BACKEND (Render)                      │
│                FastAPI (Python, Async)                  │
│         Pydantic Validation · APIRouter · Motor         │
└──────┬──────────────────────────┬───────────────────────┘
       │                          │
┌──────▼──────┐          ┌────────▼────────┐
│  MongoDB    │          │  Gemini API     │
│   Atlas     │          │  2.5-flash      │
│  (NoSQL)    │          │  Türkçe NLP     │
└─────────────┘          └─────────────────┘

---

Teknoloji Stack'i

Alan	Kullanılan Teknolojiler
Backend	Python, FastAPI, Uvicorn, Motor, Pydantic v2, Google Generative AI, SlowAPI,
Frontend	React 18, TypeScript 5.6, Vite, TailwindCSS, Zustand, React Router v6, Axios
Altyapı	MongoDB Atlas, Render, Vercel

---

Kurulum

Gereksinimler

• Python 3.11+
• Node.js 18+
• MongoDB Atlas hesabı
• Google Gemini API key (ai.google.dev)

1. Repoyu Klonla

git clone https://github.com/kullanici-adi/pulsify.git
cd pulsify

2. Backend Kurulumu

# Sanal ortam oluştur ve aktif et
python -m venv .venv

# Windows
.venv\Scripts\activate

# macOS / Linux
source .venv/bin/activate

# Bağımlılıkları kur
pip install -r requirements.txt

# Backend ortam değişkenlerini ayarla
cd backend
cp .env.example .env
# .env dosyasını düzenle (MONGO_URI, GEMINI_API_KEY vb.)

# Backend'i başlat
uvicorn main:app --reload
# API Dokümantasyonu: http://localhost:8000/docs

3. Frontend Kurulumu

cd frontend

# Bağımlılıkları kur
npm install

# Ortam değişkenlerini ayarla
cp .env.example .env.local
# VITE_API_BASE_URL=http://localhost:8000

# Geliştirme sunucusunu başlat
npm run dev
# Uygulama: http://localhost:5173

---

Ortam Değişkenleri

Backend (backend/.env)

MONGO_URI=mongodb+srv://<user>:<pass>@cluster.mongodb.net/pulsify
GEMINI_API_KEY=your-gemini-api-key
SECRET_KEY=your-secret-key
CORS_ORIGINS=http://localhost:5173
DEBUG=True

Frontend (frontend/.env.local)

VITE_API_BASE_URL=http://localhost:8000

---

API Dokümantasyonu

Backend çalıştırıldıktan sonra Swagger UI otomatik olarak şu adreste açılır:

http://localhost:8000/docs

Ana Endpoint Grupları

Grup	Prefix	Açıklama
Siparişler	/api/orders	Sipariş CRUD işlemleri
Müşteriler	/api/customers	Müşteri & sadakat yönetimi
Kargo	/api/cargo	Kargo takibi & uyarılar
AI	/api/ai	Chatbot, duygu analizi, raporlar

---

Proje Yapısı

pulsify/
├── backend/
│   ├── app/
│   │   ├── routers/        # API endpoint grupları
│   │   ├── services/       # İş mantığı katmanı
│   │   ├── models/         # Pydantic veri modelleri
│   │   └── utils/          # Logger, response builder
│   ├── tests/
│   ├── main.py
│   └── .env.example
├── frontend/
│   ├── src/
│   │   ├── api/            # API çağrı fonksiyonları
│   │   ├── components/     # Yeniden kullanılabilir bileşenler
│   │   ├── hooks/          # Custom React hooks
│   │   ├── pages/          # Route bazlı sayfalar
│   │   ├── store/          # Zustand global state
│   │   └── types/          # TypeScript tip tanımlamaları
│   └── .env.example
├── docs/
│   └── assets/             # Ekran görüntüleri ve görseller
├── requirements.txt
├── CLAUDE.md               # Proje context dosyası
├── PROGRESS.md             # Geliştirme yol haritası
└── README.md

---

Katkı Sağlama

Katkı sağlamak için lütfen şu adımları izle:

1. Bu repoyu fork'la
2. Yeni bir branch oluştur: git checkout -b feature/ozellik-adi
3. Değişikliklerini commit'le (Conventional Commits formatında):

   feat(orders): geciken sipariş uyarı sistemi eklendi
   

4. Branch'ini push'la: git push origin feature/ozellik-adi
5. Pull Request aç (develop branch'ine)

Detaylı geliştirme kılavuzu için CLAUDE.md dosyasına bak.

---

Pulsify — KOBİ'lerin AI ile büyümesi için