Agent Skills: 🔧 Backend Core

🔧 Backend Core

Node.js/TypeScript temel prensipler ve proje yapısı.

📋 1. Kapsam

| Alan | Teknoloji | |------|-----------| | Runtime | Node.js 20+ (LTS) | | Dil | TypeScript (Strict) | | Framework | NestJS, Fastify, Express |

⚙️ 2. TypeScript Strict Mode

{
  "compilerOptions": {
    "strict": true,
    "noImplicitAny": true,
    "strictNullChecks": true,
    "noImplicitReturns": true
  }
}

any Yasak

// ❌ YANLIŞ
function process(data: any) { }

// ✅ DOĞRU
function process(data: DataPayload) { }

// Bilinmeyen için unknown kullan
function parse(input: unknown) { }

📁 3. Proje Yapısı (Feature-First)

src/
├── modules/
│   ├── auth/
│   │   ├── auth.controller.ts
│   │   ├── auth.service.ts
│   │   ├── auth.repository.ts
│   │   └── auth.dto.ts
│   └── users/
├── shared/
│   ├── middleware/
│   ├── guards/
│   └── utils/
├── infrastructure/
│   ├── database/
│   ├── cache/
│   └── logger/
├── config/
└── main.ts

🔐 4. Environment Variables

import { z } from 'zod';

const envSchema = z.object({
  NODE_ENV: z.enum(['development', 'production', 'test']),
  PORT: z.string().transform(Number),
  DATABASE_URL: z.string().url(),
  JWT_SECRET: z.string().min(32),
});

export const env = envSchema.parse(process.env);

🔗 İlgili Skill'ler

• backend-api - REST/GraphQL tasarımı
• backend-database - DB patterns, caching

• backend-database - DB patterns, caching

Backend Core v1.2 - Verified

🔄 Workflow

Kaynak: Node.js Best Practices - Project Structure

Aşama 1: Foundation (Structure)

• [ ] Components: Klasörleri teknik role göre değil (controllers, models), bileşene göre ayır (components/user, components/order).
• [ ] Config: dotenv ve envalid (veya Zod) ile ortam değişkenlerini tip güvenli hale getir.
• [ ] Entry: Uygulamayı app.ts (setup) ve server.ts (listen) olarak ayır.

Aşama 2: Core Utilities

• [ ] Logger: console.log yerine winston veya pino kur.
• [ ] Async Wrapper: Promise rejection'ları yakalamak için global handler veya wrapper kullan.
• [ ] Linter: ESLint ve Prettier ayarlarını CI pipeline'a bağla.

Aşama 3: Hardening

• [ ] Graceful Shutdown: SIGTERM/SIGINT sinyallerini dinle ve bağlantıları nazikçe kapat.
• [ ] Health Check: /health endpoint'i ekle.

Kontrol Noktaları

| Aşama | Doğrulama | |-------|-----------| | 1 | Yeni bir özellik eklerken 5 farklı klasöre dokunmak gerekiyor mu? (Gerekmemeli -> Component based) | | 2 | .env dosyası commit edilmiş mi? (Edilmemeli) | | 3 | Uygulama çökünce process otomatik restart oluyor mu? (PM2/Docker) |