ginimageApi/yap.md

GinImageAPI Kisa Teknik Ozet

Proje Dizini (aktif)

ginimageApi/
├── main.go
├── go.mod
├── app/
│   ├── accounts/
│   │   ├── handlers/user.go
│   │   └── models/{accounts,token}.go
│   └── middleware/{auth,security}.go
├── configs/{db,redis}.go
├── routers/router.go
├── docs/{docs.go,swagger.json,swagger.yaml}
├── app/images/{handlers,models}
└── pkg/images/processor.go

Uygulama Baslangic Akisi

1. .env yuklenir (godotenv).
2. JWT_SECRET kontrol edilir; bos ise uygulama fail-fast kapanir.
3. configs.ConnectDB() ile DB baglantisi acilir.
4. configs.RunAutoMigrate() modelleri uygular.
5. configs.SeedSecurityDefaults() calisir.
6. configs.ConnectRedis() ile Redis baglanir.
7. Gin middleware zinciri calisir:
   • DynamicCORS()
   • DynamicRateLimit()
8. routers.Setup(r) ile endpointler yuklenir.

Auth ve Yetki Kurallari

• Access token formati: standart JWT (HS256)
• Zorunlu claim kontrolleri: iss, aud, nbf, exp
• Authorization header formati zorunludur: Bearer <access_token>
• Legacy access token formatlari desteklenmez
• AuthRequired() context'e sunlari yazar: user_id, email, username
• AdminRequired() mutating methodlarda (POST/PUT/PATCH/DELETE) users.is_admin kontrolu yapar

Route Gruplari

• Public auth: /api/v1/auth/register, /api/v1/auth/login, /api/v1/auth/refresh
• Auth gerekli: /api/v1/me
• Auth gerekli: /api/v1/images/process
• Auth gerekli: /api/v1/images
• Auth gerekli: /api/v1/images/{id}
• Admin gerekli: /api/v1/users/{id}/admin
• Swagger UI: /swagger/index.html

Resim Isleme

• Endpoint: POST /api/v1/images/process (multipart/form-data)
• Dosya alani: file (zorunlu)
• Opsiyonel alanlar: width, height, format, quality, cover
• Varsayilanlar:
  • format: avif
  • quality: 90
  • width/height verilmezse boyutlar orijinal kalir (sifir deger)
• Desteklenen formatlar: avif, webp, png, jpg/jpeg
• Islenmis dosya fiziksel olarak uploads/processed/ altina yazilir
• DB'ye images tablosunda kayit atilir (public_path, format, size, width, height, quality)
• Response JSON olarak file_name, public_path ve url bilgilerini doner

Swagger

• Uretim komutu:
  • swag init -g main.go -o docs
• UI:
  • http://localhost:8080/swagger/index.html