# Genimi (AI) Kuralları
- **Dil:** Her zaman (kod blokları hariç) Türkçe cevap vermelisin.

# Go Backend Guidelines — JWT + OAuth + RBAC & Security
# Go Next Js Guidelines
Bu doküman Next frontend'e hizmet edecek Go (backend) uygulaması için güncel proje ve mimari rehberidir.

## Proje Backend Durumu ve Özellikler

- **Go Sürümü:** 1.25.6
- **Veritabanı:** PostgreSQL
- **Web Framework:** Gin
- **Mimari:** RESTful API

## Proje Frontend Durumu ve Özellikler

- **Next js:** 16.1.6
- **Next-auth":** 4.24.13
- **Radix-ui":** 1.4.3 
- **Shadcn/ui":** Latest
- **Sweetalert2":** 11.26.18
- **Ioredis":** 5.9.2
- **Redux":** 1.4.3
- **Redux Toolkit":** 1.4.3
- **Zod":** 4.3.6
- **Tailwindcss":** 4
- **Tailwind-merge":** 3.4.0
- **Lucide-react":** 0.563.0
- **Tw-animate-css":** 1.4.0
- **server side rendering:** true

## API Uç Noktaları

-- Register Yeni Kullanıcı
POST
http://localhost:8080/v1/auth/register
-- Gönderrilen JSON
{
    "email":"beyhanod@beyhan.dev",
    "password":"1923btO**",
    "username":"test yaptim"
}
-- Cevap
{
    "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJmMDVlZTc0Zi1hYjgzLTQxNzEtYjI3Ny1mZGM0NDZhNjA3YjciLCJlbWFpbCI6ImJleHlzc2hhbm9kQGJleWhhbi5kZXYiLCJwZXJtaXNzaW9ucyI6WyJ1c2VyOnJlYWQiXSwiaXNzIjoiZ2F1dGgtY2VudHJhbCIsImV4cCI6MTc3MDEzMDQ2OCwiaWF0IjoxNzcwMTI5NTY4fQ.Qc5EnE2r-In7hm6-NjP6WX2TKm3MyuM68SwsHYUNJbI",
    "email": "bexysshanod@beyhan.dev",
    "message": "User created successfully",
    "refresh_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJmMDVlZTc0Zi1hYjgzLTQxNzEtYjI3Ny1mZGM0NDZhNjA3YjciLCJlbWFpbCI6ImJleHlzc2hhbm9kQGJleWhhbi5kZXYiLCJpc3MiOiJnYXV0aC1jZW50cmFsIiwiZXhwIjoxNzcwNzM0MzY4LCJpYXQiOjE3NzAxMjk1Njh9.JE2UZ6jJti2N2jbExx_TTY5VPSfXKvc2ZGB-Nw_toLQ",
    "roles": [
        {
            "id": 2,
            "name": "user",
            "description": "Default user role",
            "permissions": [
                {
                    "id": 1,
                    "name": "user:read",
                    "description": "Can read user data"
                }
            ]
        }
    ],
    "user_id": "f05ee74f-ab83-4171-b277-fdc446a607b7",
    "username": "test yaptim"
}

-- Login Yeni Kullanıcı
POST
http://localhost:8080/v1/auth/login
-- Gönderrilen JSON
{
    "email":"beyhanod@beyhan.dev",
    "password":"1923btO**"
}
-- Cevap
{
    "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiI5MWNmMDg2OC1kZjI0LTRiOGYtYjQ5MS03MGQ5ZWI3YTQzNzMiLCJlbWFpbCI6ImJleWhhbm9AYmV5aGFuLmRldiIsInBlcm1pc3Npb25zIjpbInVzZXI6cmVhZCJdLCJpc3MiOiJnYXV0aC1jZW50cmFsIiwiZXhwIjoxNzcwMTMwNjU3LCJpYXQiOjE3NzAxMjk3NTd9.QbsRFn5fr7L4Wc7HCxOs0_zOWWhuceWzPmt20TV5lNI",
    "email": "beyhano@beyhan.dev",
    "refresh_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiI5MWNmMDg2OC1kZjI0LTRiOGYtYjQ5MS03MGQ5ZWI3YTQzNzMiLCJlbWFpbCI6ImJleWhhbm9AYmV5aGFuLmRldiIsImlzcyI6ImdhdXRoLWNlbnRyYWwiLCJleHAiOjE3NzA3MzQ1NTcsImlhdCI6MTc3MDEyOTc1N30.wBML1pT9S9i9FtAw3PKmJBMdcobZexWVBTRV5remb_s",
    "roles": [
        {
            "id": 2,
            "name": "user",
            "description": "Default user role",
            "permissions": [
                {
                    "id": 1,
                    "name": "user:read",
                    "description": "Can read user data"
                }
            ]
        }
    ],
    "user_id": "91cf0868-df24-4b8f-b491-70d9eb7a4373",
    "username": "user_91cf0868"
}

-- Refresh Token
POST
http://localhost:8080/v1/auth/refresh
-- Gönderilen JSON
{
    "refresh_token":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiI5MWNmMDg2OC1kZjI0LTRiOGYtYjQ5MS03MGQ5ZWI3YTQzNzMiLCJlbWFpbCI6ImJleWhhbm9AYmV5aGFuLmRldiIsImlzcyI6ImdhdXRoLWNlbnRyYWwiLCJleHAiOjE3NzA3MzQ2NDUsImlhdCI6MTc3MDEyOTg0NX0.ACDDM20v1u6yjyNrqBnWafjXnrRAAT1-8CvfqSkjTsE"
} 
-- Cevap
{
    "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiI5MWNmMDg2OC1kZjI0LTRiOGYtYjQ5MS03MGQ5ZWI3YTQzNzMiLCJlbWFpbCI6ImJleWhhbm9AYmV5aGFuLmRldiIsInBlcm1pc3Npb25zIjpbInVzZXI6cmVhZCJdLCJpc3MiOiJnYXV0aC1jZW50cmFsIiwiZXhwIjoxNzcwMTMxMjYwLCJpYXQiOjE3NzAxMzAzNjB9.BKmZBkL6FPo208mYLeBFMkNOqJ2tsmGXJUN_0bdZFHQ",
    "refresh_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiI5MWNmMDg2OC1kZjI0LTRiOGYtYjQ5MS03MGQ5ZWI3YTQzNzMiLCJlbWFpbCI6ImJleWhhbm9AYmV5aGFuLmRldiIsImlzcyI6ImdhdXRoLWNlbnRyYWwiLCJleHAiOjE3NzA3MzUxNjAsImlhdCI6MTc3MDEzMDM2MH0.tkpcbQ6QmVVXK-r0QgP333X_FrAktVOuh1AJhwvV1BQ"
}

-- Me (Kullanıcı Profili)
GET
http://localhost:8080/v1/auth/me
-- Header
Authorization: Bearer ACCESS_TOKEN_BURAYA
-- Body: YOK (GET isteği)
-- Cevap
{
    "id": "91cf0868-df24-4b8f-b491-70d9eb7a4373",
    "username": "user_91cf0868",
    "email": "beyhano@beyhan.dev",
    "created_at": "2026-02-03T17:03:07.863425+03:00",
    "updated_at": "2026-02-03T17:03:07.880923+03:00",
    "social_accounts": null,
    "roles": [
        {
            "id": 2,
            "name": "user",
            "description": "Default user role",
            "permissions": [
                {
                    "id": 1,
                    "name": "user:read",
                    "description": "Can read user data"
                }
            ]
        }
    ]
}

-- Validate Token (Token Doğrulama)
GET
http://localhost:8080/v1/auth/validate
-- Header
Authorization: Bearer ACCESS_TOKEN_BURAYA
-- Body: YOK (GET isteği, body gönderilmez)
-- Cevap
{
    "email": "beyhano@beyhan.dev",
    "message": "Token is valid",
    "user_id": "91cf0868-df24-4b8f-b491-70d9eb7a4373"
}
## Kurulum ve Çalıştırma

1.  `.env.example` dosyasını `.env` olarak kopyalayın ve değerleri düzenleyin.
2.  Docker ile veritabanını ve uygulamayı başlatmak için:
    ```bash
    ./scripts/run.sh
    ```
    _(Bu script Docker konteynerini kontrol eder, yoksa başlatır ve ardından Go sunucusunu çalıştırır)_

## Geliştirme Notları

- **Env Değişkenleri:**
  - `RATE_LIMIT_BLACKLIST_IPS=...`, `RATE_LIMIT_BLACKLIST_DOMAINS=...` ile yasaklama.
  - `RATE_LIMIT_WHITELIST=...`, `RATE_LIMIT_WHITELIST_DOMAINS=...` ile muafiyet.

- **Migration Ekleme:** `internal/db/migrations` klasörüne `00000X_description.up.sql` formatında yeni dosya ekleyin.
- **Admin Kullanıcısı:** Sistem ilk açılışta `admin@example.com` / `admin123` kullanıcısını otomatik oluşturur.
- **Docker Volume:** `/uploads` klasörü `uploads_data` volume'ü ile kalıcı hale getirilmiştir.
- **Image Processing:** WebP desteği için Dockerfile `CGO_ENABLED=1` ve `build-base` içerir.