ServiceManager (IPC kayıt)
  └── BaseService<T> (iş mantığı + IPC handler)
        └── BaseRepository<T> (veri erişim + CRUD)
              └── Database (singleton SQLite bağlantısı)

Yardımcılar: AppError (hata), Logger (loglama)

// src/main/modules/{modul-adi}/{modul-adi}.repository.ts
import { BaseRepository } from '@main/core/BaseRepository'
import type { YourEntity } from '@shared/types'

export class YourRepository extends BaseRepository<YourEntity> {
  protected getTableName(): string {
    return 'your_table'
  }

  protected override getBooleanColumns(): readonly string[] {
    return ['is_active']  // SQLite 0/1 <-> boolean dönüşümü
  }

  protected getTableSchemas(): readonly string[] {
    return [
      `CREATE TABLE IF NOT EXISTS your_table (
        id INTEGER PRIMARY KEY AUTOINCREMENT,
        title TEXT NOT NULL,
        is_active INTEGER NOT NULL DEFAULT 1 CHECK(is_active IN (0, 1)),
        created_at TEXT NOT NULL DEFAULT (datetime('now', 'localtime')),
        updated_at TEXT NOT NULL DEFAULT (datetime('now', 'localtime'))
      )`
    ]
  }

  // Özel sorgular — her zaman safeExecute içinde
  findByTitle(title: string): YourEntity | null {
    return this.findOneBy('title', title)
  }
}

// src/main/modules/{modul-adi}/{modul-adi}.service.ts
import { BaseService } from '@main/core/BaseService'
import { AppError } from '@main/core/AppError'
import { YourRepository } from './{modul-adi}.repository'
import type { ServiceResponse, YourEntity, CreateYourRequest } from '@shared/types'
import type { ServiceHandlerMap } from '@main/core/types'

export class YourService extends BaseService<YourEntity> {
  protected repository: YourRepository

  constructor() {
    super()
    this.repository = new YourRepository()
  }

  getModuleName(): string {
    return 'YourService'
  }

  getChannelPrefix(): string {
    return 'your-module'  // IPC kanalı: your-module:get-all, your-module:create, vb.
  }

  // Standart CRUD'u override et (validasyon ekle)
  protected override async handleCreate(data: unknown): Promise<ServiceResponse<unknown>> {
    const input = data as CreateYourRequest
    if (!input.title?.trim()) throw AppError.badRequest('Başlık zorunludur')
    const item = this.repository.create({ title: input.title.trim(), is_active: true })
    return this.created(item, 'Kayıt oluşturuldu')
  }

  // Özel IPC kanalları
  protected override getCustomHandlers(): ServiceHandlerMap {
    return {
      'your-module:search': (data) => this.search(data as { query: string }),
    }
  }

  private async search(data: { query: string }): Promise<ServiceResponse<YourEntity[]>> {
    const results = this.repository.findByTitle(data.query)
    return this.ok(results ? [results] : [], 'Arama tamamlandı')
  }
}

// src/main/index.ts — initializeServices() içine ekle
serviceManager.register(new YourService())

// ✅ Her zaman AppError kullan
throw AppError.badRequest('Geçersiz veri')        // 400
throw AppError.unauthorized('Giriş yapılmadı')    // 401
throw AppError.forbidden('Yetkiniz yok')           // 403
throw AppError.notFound('Kayıt bulunamadı')        // 404
throw AppError.conflict('Zaten mevcut')            // 409
throw AppError.internal('Sunucu hatası')           // 500
throw AppError.busy('DB meşgul')                   // 503

// ❌ YASAK
throw new Error('...')
console.error('...')

// Her zaman Logger singleton kullan
this.logger.info('Mesaj', 'KontekstAdı')
this.logger.warn('Uyarı', 'KontekstAdı')
this.logger.error('Hata', errorObj, 'KontekstAdı')
this.logger.debug('Debug bilgisi', 'KontekstAdı')

// ============================================================
// DosyaAdı - Kısa açıklama (Türkçe)
//
// Sorumlulukları:
// 1. ...
// 2. ...
// ============================================================