Coding Standards

// PASS: İYİ: Açıklayıcı isimlerconst marketSearchQuery = 'election'const isUserAuthenticated = trueconst totalRevenue = 1000
// FAIL: KÖTÜ: Belirsiz isimlerconst q = 'election'const flag = trueconst x = 1000

// PASS: İYİ: Fiil-isim kalıbıasync function fetchMarketData(marketId: string) { }function calculateSimilarity(a: number[], b: number[]) { }function isValidEmail(email: string): boolean { }
// FAIL: KÖTÜ: Belirsiz veya sadece isimasync function market(id: string) { }function similarity(a, b) { }function email(e) { }

// PASS: HER ZAMAN spread operatörü kullanınconst updatedUser = {  ...user,  name: 'New Name'}
const updatedArray = [...items, newItem]
// FAIL: ASLA doğrudan mutasyon yapmayınuser.name = 'New Name'  // KÖTÜitems.push(newItem)     // KÖTÜ

// PASS: İYİ: Kapsamlı hata yönetimiasync function fetchData(url: string) {  try {    const response = await fetch(url)
    if (!response.ok) {      throw new Error(`HTTP ${response.status}: ${response.statusText}`)    }
    return await response.json()  } catch (error) {    console.error('Fetch failed:', error)    throw new Error('Failed to fetch data')  }}
// FAIL: KÖTÜ: Hata yönetimi yokasync function fetchData(url) {  const response = await fetch(url)  return response.json()}

// PASS: İYİ: Mümkün olduğunda paralel yürütmeconst [users, markets, stats] = await Promise.all([  fetchUsers(),  fetchMarkets(),  fetchStats()])
// FAIL: KÖTÜ: Gereksiz yere sıralıconst users = await fetchUsers()const markets = await fetchMarkets()const stats = await fetchStats()

// PASS: İYİ: Doğru tiplerinterface Market {  id: string  name: string  status: 'active' | 'resolved' | 'closed'  created_at: Date}
function getMarket(id: string): Promise<Market> {  // Implementation}
// FAIL: KÖTÜ: 'any' kullanımıfunction getMarket(id: any): Promise<any> {  // Implementation}

// PASS: İYİ: Tiplerle fonksiyonel bileşeninterface ButtonProps {  children: React.ReactNode  onClick: () => void  disabled?: boolean  variant?: 'primary' | 'secondary'}
export function Button({  children,  onClick,  disabled = false,  variant = 'primary'}: ButtonProps) {  return (    <button      onClick={onClick}      disabled={disabled}      className={`btn btn-${variant}`}    >      {children}    </button>  )}
// FAIL: KÖTÜ: Tip yok, belirsiz yapıexport function Button(props) {  return <button onClick={props.onClick}>{props.children}</button>}

// PASS: İYİ: Yeniden kullanılabilir özel hookexport function useDebounce<T>(value: T, delay: number): T {  const [debouncedValue, setDebouncedValue] = useState<T>(value)
  useEffect(() => {    const handler = setTimeout(() => {      setDebouncedValue(value)    }, delay)
    return () => clearTimeout(handler)  }, [value, delay])
  return debouncedValue}
// Kullanımconst debouncedQuery = useDebounce(searchQuery, 500)

// PASS: İYİ: Doğru state güncellemelericonst [count, setCount] = useState(0)
// Önceki state'e dayalı fonksiyonel güncellemesetCount(prev => prev + 1)
// FAIL: KÖTÜ: Doğrudan state referansısetCount(count + 1)  // Async senaryolarda eski olabilir

// PASS: İYİ: Açık koşullu render{isLoading && <Spinner />}{error && <ErrorMessage error={error} />}{data && <DataDisplay data={data} />}
// FAIL: KÖTÜ: Ternary cehennemi{isLoading ? <Spinner /> : error ? <ErrorMessage error={error} /> : data ? <DataDisplay data={data} /> : null}

// PASS: İYİ: Tutarlı response yapısıinterface ApiResponse<T> {  success: boolean  data?: T  error?: string  meta?: {    total: number    page: number    limit: number  }}
// Başarılı responsereturn NextResponse.json({  success: true,  data: markets,  meta: { total: 100, page: 1, limit: 10 }})
// Hata responsereturn NextResponse.json({  success: false,  error: 'Invalid request'}, { status: 400 })

import { z } from 'zod'
// PASS: İYİ: Schema doğrulamaconst CreateMarketSchema = z.object({  name: z.string().min(1).max(200),  description: z.string().min(1).max(2000),  endDate: z.string().datetime(),  categories: z.array(z.string()).min(1)})
export async function POST(request: Request) {  const body = await request.json()
  try {    const validated = CreateMarketSchema.parse(body)    // Doğrulanmış veriyle devam et  } catch (error) {    if (error instanceof z.ZodError) {      return NextResponse.json({        success: false,        error: 'Validation failed',        details: error.errors      }, { status: 400 })    }  }}

// PASS: İYİ: NİÇİN'i açıklayın, NE'yi değil// Kesintiler sırasında API'yi aşırı yüklemekten kaçınmak için exponential backoff kullanconst delay = Math.min(1000 * Math.pow(2, retryCount), 30000)
// Büyük dizilerle performans için burada kasıtlı olarak mutasyon kullanılıyoritems.push(newItem)
// FAIL: KÖTÜ: Açık olanı belirtmek// Sayacı 1 artırcount++
// İsmi kullanıcının ismine ayarlaname = user.name

/** * Semantik benzerlik kullanarak market arar. * * @param query - Doğal dil arama sorgusu * @param limit - Maksimum sonuç sayısı (varsayılan: 10) * @returns Benzerlik skoruna göre sıralanmış market dizisi * @throws {Error} OpenAI API başarısız olursa veya Redis kullanılamazsa * * @example * ```typescript * const results = await searchMarkets('election', 5) * console.log(results[0].name) // "Trump vs Biden" * ``` */export async function searchMarkets(  query: string,  limit: number = 10): Promise<Market[]> {  // Implementation}

import { useMemo, useCallback } from 'react'
// PASS: İYİ: Pahalı hesaplamaları memoize etconst sortedMarkets = useMemo(() => {  return markets.sort((a, b) => b.volume - a.volume)}, [markets])
// PASS: İYİ: Callback'leri memoize etconst handleSearch = useCallback((query: string) => {  setSearchQuery(query)}, [])

import { lazy, Suspense } from 'react'
// PASS: İYİ: Ağır bileşenleri lazy yükleconst HeavyChart = lazy(() => import('./HeavyChart'))
export function Dashboard() {  return (    <Suspense fallback={<Spinner />}>      <HeavyChart />    </Suspense>  )}

// PASS: İYİ: Sadece gerekli sütunları seçconst { data } = await supabase  .from('markets')  .select('id, name, status')  .limit(10)
// FAIL: KÖTÜ: Her şeyi seçconst { data } = await supabase  .from('markets')  .select('*')

test('benzerliği doğru hesaplar', () => {  // Arrange (Hazırla)  const vector1 = [1, 0, 0]  const vector2 = [0, 1, 0]
  // Act (İşle)  const similarity = calculateCosineSimilarity(vector1, vector2)
  // Assert (Doğrula)  expect(similarity).toBe(0)})

// PASS: İYİ: Açıklayıcı test isimleritest('sorguya uygun market bulunamadığında boş dizi döndürür', () => { })test('OpenAI API anahtarı eksikse hata fırlatır', () => { })test('Redis kullanılamazsa substring aramaya geri döner', () => { })
// FAIL: KÖTÜ: Belirsiz test isimleritest('çalışır', () => { })test('arama testi', () => { })

// FAIL: KÖTÜ: 50 satırdan uzun fonksiyonfunction processMarketData() {  // 100 satır kod}
// PASS: İYİ: Küçük fonksiyonlara bölfunction processMarketData() {  const validated = validateData()  const transformed = transformData(validated)  return saveData(transformed)}

// FAIL: KÖTÜ: 5+ seviye iç içe geçmeif (user) {  if (user.isAdmin) {    if (market) {      if (market.isActive) {        if (hasPermission) {          // Bir şeyler yap        }      }    }  }}
// PASS: İYİ: Erken dönüşlerif (!user) returnif (!user.isAdmin) returnif (!market) returnif (!market.isActive) returnif (!hasPermission) return
// Bir şeyler yap

// FAIL: KÖTÜ: Açıklanmamış sayılarif (retryCount > 3) { }setTimeout(callback, 500)
// PASS: İYİ: İsimlendirilmiş sabitlerconst MAX_RETRIES = 3const DEBOUNCE_DELAY_MS = 500
if (retryCount > MAX_RETRIES) { }setTimeout(callback, DEBOUNCE_DELAY_MS)