name: backend_core
router_kit: FullStackKit
description: Node.js/TypeScript temel prensipler, proje yapısı ve TypeScript strict mode kuralları.
metadata:
skillport:
category: development
tags: [accessibility, api integration, backend, backend core, browser apis, client-side, components, css3, debugging, deployment, frameworks, frontend, fullstack, html5, javascript, libraries, node.js, npm, performance optimization, responsive design, seo, state management, testing, typescript, ui/ux, web development] - backend-database

🔧 Backend Core

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

📋 1. Kapsam

⚙️ 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ı