Claude ile REST API Oluşturma Promptu

Sen; Node.js (Express/NestJS), Python (FastAPI/Django), Go veya Java (Spring Boot) gibi backend teknolojilerinde uzmanlaşmış, veri güvenliği ve yüksek trafik yönetimi konusunda 10+ yıl deneyimli bir Kıdemli Backend Mimarı ve Veritabanı Uzmanısın.

Seninle birlikte, [BURAYA PROJENİN AMACINI YAZIN. Örn: Bir e-ticaret uygulamasının backend servisleri / Bir mobil ilan platformunun veri akışı] için ölçeklenebilir, güvenli ve performanslı bir REST API altyapısı geliştireceğiz.

Bu API'ın besleyeceği sistemin temel iş mantığı ve gereksinimleri şunlardır:
[SİSTEMİN GEREKSİNİMLERİ: API hangi verilere hizmet edecek, hangi kritik iş akışları (Örn: Sipariş oluşturma, stok kontrolü vb.) backend tarafında dönecek? Detaylıca yazın.]

Tercih ettiğim backend dili/teknolojisi: [İSTEĞE BAĞLI: Örn: Node.js + TypeScript + Express veya FastAPI. Boş bırakırsanız Claude projenize en uygun olanı seçecektir.]

Lütfen bu REST API projesi için bana şu başlıklar altında detaylı bir teknik mimari, klasör yapısı ve kod şablonları hazırla:

1. Katmanlı Mimari (Clean/Layered Architecture) ve Klasör Yapısı:
- Kodun sürdürülebilir olması için projeyi Controller, Service, Repository (veya Data Access Object - DAO) katmanlarına nasıl ayırmalıyız? 
- Projenin temiz ve ölçeklenebilir klasör yapısını (Folder Structure) listele.

2. İstek Doğrulama (Request Validation) ve Data Transfer Objects (DTO):
- API'a gelen hatalı veya kötü niyetli verileri (payload) daha Service katmanına ulaşmadan Controller girişinde nasıl doğrulamalıyız? (Örn: Joi, Zod veya class-validator ile validation mantığı).
- Örnek bir kayıt olma (Register) veya veri ekleme isteği için DTO şeması göster.

3. Merkezi Hata Yönetimi (Global Error Handling):
- API içinde oluşabilecek beklenmedik hataları (500 Internal Error) veya kontrollü hataları (404 Not Found, 400 Bad Request) yakalayıp istemciye (frontend) her zaman aynı standart JSON formatında yanıt dönen bir Global Error Middleware mimarisi nasıl kurulmalı? Örnek kod şablonu paylaş.

4. Kimlik Doğrulama ve Yetkilendirme (Authentication & JWT Flow):
- JWT (JSON Web Token) tabanlı kimlik doğrulama akışı nasıl olmalı? Access Token ve Refresh Token mekanizması veritabanına ve istemciye nasıl yansıtılmalı?
- Belirli API rotalarını korumak için yazılacak olan `AuthMiddleware` yapısını kurgula.

5. API Güvenliği ve Performans (Security & Rate Limiting):
- API'ı DDoS saldırılarından veya brute-force denemelerinden korumak için `Rate Limiting` (İstek sınırlama) mekanizması nasıl entegre edilmeli?
- SQL Injection ve XSS gibi temel açıklardan korunmak için alınması gereken güvenlik önlemleri (Örn: Helmet, CORS ayarları) nelerdir?

6. OpenAPI / Swagger Dökümantasyonu ve MVP Adımları:
- Geliştirilen bu API uç noktalarının frontend ekibi tarafından kolayca test edilebilmesi için Swagger dökümantasyon altyapısı projeye nasıl entegre edilmeli?
- Bu REST API'ı parça parça kodlayıp ayağa kaldırmam için bana 4 adımlı bir yol haritası sun.

Lütfen yanıtını tamamen REST standartlarına (doğru HTTP metotları ve status kodları kullanımı), clean code prensiplerine uygun ve doğrudan backend projesini oluşturup kod yazmaya başlayabileceğim netlikte yapılandır. Hazır olduğunda başlayalım!