kw-flask

Flask + MongoDB + Docker + Session Auth — tek komutla hazır, modüler REST API şablonu.

pip install kw-flask
kw-flask benim-projem

Özellikler

• 🏗️ Blueprint tabanlı modüler yapı — her modül kendi route/service/model/validator'ına sahip
• 🔐 Flask-Login session auth — server-side session, remember me, rol bazlı erişim
• 🍃 MongoEngine ODM — class tabanlı MongoDB modelleri
• 🐳 Docker Compose — app + MongoDB + Mongo Express UI hazır
• ⚙️ Ortam bazlı config — development / production / testing
• 🛡️ Global hata yönetimi — tüm hatalar tutarlı JSON döner
• 🔑 Otomatik SECRET_KEY — her projede benzersiz anahtar üretilir

Hızlı Başlangıç

# Kur
pip install kw-flask

# Proje oluştur
kw-flask siparis-api
cd siparis-api

# Docker ile başlat
docker compose up -d

API http://localhost:5000 adresinde hazır.
Mongo Express UI: http://localhost:8081

Endpoint'ler

Proje Yapısı

app/
├── core/
│   ├── config.py              # Ortam bazlı konfigürasyon
│   ├── database/connection.py # DatabaseManager (MongoEngine)
│   ├── exceptions/            # AppException hiyerarşisi + global handler'lar
│   └── middlewares/
│       ├── session.py         # Flask-Login + @require_roles dekoratörü
│       └── health.py          # /health endpoint'i
├── modules/
│   └── user/
│       ├── models/            # MongoEngine User (UserMixin dahil)
│       ├── services/          # AuthService, UserService (class tabanlı)
│       ├── routes/            # Blueprint'ler
│       └── validators/        # Marshmallow şemaları
└── utils/
    ├── response.py            # success_response / error_response
    ├── validators.py          # validate_request yardımcısı
    └── logger.py              # Yapılandırılmış loglama

Yeni Modül Eklemek

app/modules/
└── urun/
    ├── __init__.py
    ├── models/urun_model.py
    ├── services/urun_service.py
    ├── routes/urun_routes.py
    └── validators/schemas.py

app/__init__.py içindeki _register_blueprints fonksiyonuna blueprint'i kaydet:

from .modules.urun.routes.urun_routes import urun_bp
app.register_blueprint(urun_bp, url_prefix="/api/v1/urunler")

Rol Bazlı Erişim

from app.core.middlewares.session import require_roles

@urun_bp.delete("/<id>")
@login_required
@require_roles("admin")
def delete_urun(id):
    ...

Ortam Değişkenleri

Lisans

MIT