# 🤖 AI Assistant Context - NestJS Backend

> Bu dosya, AI asistanların (Claude, GPT, Gemini vb.) projeyi hızlıca anlaması için hazırlanmış bir referans dökümanıdır.

---

## 📚 Projeyi Anlamak İçin Önce Oku

1. **README.md** dosyasını oku - Projenin mimarisi, ADR'ler, teknoloji stack'i ve kurulum adımlarını içerir.

```
README.md
```

---

## 🎯 Referans Klasörü

`.claude/` klasörü best practice'ler, agent tanımları ve yardımcı scriptler içerir. Görev türüne göre ilgili referansları kullan:

### Skills (Beceri Setleri)

| Beceri                     | Konum                                    | Ne Zaman Kullan                 |
| -------------------------- | ---------------------------------------- | ------------------------------- |
| **Senior Backend**         | `.claude/skills/senior-backend/`         | API geliştirme, servis yazarken |
| **Senior Fullstack**       | `.claude/skills/senior-fullstack/`       | End-to-end feature geliştirme   |
| **Code Reviewer**          | `.claude/skills/code-reviewer/`          | Code review yaparken            |
| **Receiving Code Review**  | `.claude/skills/receiving-code-review/`  | Review feedback işlerken        |
| **Senior ML Engineer**     | `.claude/skills/senior-ml-engineer/`     | ML/AI entegrasyonları           |
| **Senior Prompt Engineer** | `.claude/skills/senior-prompt-engineer/` | LLM prompt optimizasyonu        |

### Agents (Roller)

| Agent                  | Konum                                  | Açıklama                    |
| ---------------------- | -------------------------------------- | --------------------------- |
| **TypeScript Pro**     | `.claude/agents/typescript-pro.md`     | TypeScript best practices   |
| **Code Reviewer**      | `.claude/agents/code-reviewer.md`      | Kod review yapma            |
| **Debugger**           | `.claude/agents/debugger.md`           | Hata ayıklama               |
| **Security Engineer**  | `.claude/agents/security-engineer.md`  | Güvenlik analizi            |
| **Database Optimizer** | `.claude/agents/database-optimizer.md` | DB performans optimizasyonu |
| **API Documenter**     | `.claude/agents/api-documenter.md`     | API dokümantasyonu          |
| **API Security Audit** | `.claude/agents/api-security-audit.md` | API güvenlik denetimi       |
| **AI Engineer**        | `.claude/agents/ai-engineer.md`        | AI/ML entegrasyonları       |
| **Data Scientist**     | `.claude/agents/data-scientist.md`     | Veri analizi                |

---

## 🔧 Teknoloji Stack'i (Özet)

- **Framework:** NestJS
- **ORM:** Prisma
- **Database:** PostgreSQL
- **Cache:** Redis
- **Auth:** JWT + RBAC
- **i18n:** nestjs-i18n
- **Language:** TypeScript (Strict Mode)

---

## 🏗️ Proje Yapısı Özeti

```
src/
├── common/           # Shared (BaseService, BaseController, Filters, Interceptors)
├── config/           # App configuration
├── database/         # Prisma service
├── i18n/             # Translation files
└── modules/          # Feature modules (auth, users, admin, health)
```

---

## ✅ Görev Bazlı Referans Kullanımı

**API geliştirirken:**

```
.claude/skills/senior-backend/SKILL.md
.claude/skills/senior-backend/references/
```

**Code review yaparken:**

```
.claude/skills/code-reviewer/SKILL.md
.claude/skills/code-reviewer/references/common_antipatterns.md
```

**Güvenlik denetimi yaparken:**

```
.claude/agents/security-engineer.md
.claude/agents/api-security-audit.md
```

**Database optimizasyonu:**

```
.claude/agents/database-optimizer.md
```

---

## 💡 Örnek Prompt'lar

### Yeni Module Oluşturma

> "`.claude/skills/senior-backend/` referanslarını kullanarak, `notifications` modülü oluştur. BaseService ve BaseController pattern'lerini kullan."

### Code Review

> "`.claude/skills/code-reviewer/references/common_antipatterns.md` dosyasına göre `src/modules/auth/` klasörünü review et."

### Güvenlik Analizi

> "`.claude/agents/api-security-audit.md` rolünü al ve projenin güvenlik açıklarını analiz et."

### Database Optimizasyonu

> "`.claude/agents/database-optimizer.md` rolünü al ve Prisma sorgularını optimize et."

---

**Frontend Projesi:** `../nextjs-boilerplate-full/prompt.md`