first commit

docs/mcp-tools/MCP.md

@@ -0,0 +1,54 @@
+# MCP Service Guide
+
+Bu proje için MCP servis kullanım rehberi.
+
+## Proje Bilgisi
+- Proje adı: ginimageApi
+- Dil: Go
+- Framework: Gin
+- ORM: Gorm
+
+## Amaç
+Bu MCP dokümanı, Copilot ve diğer agent'ların proje yapısını doğru anlaması ve admin user management endpointlerini tutarlı şekilde üretmesi için hazırlanmıştır.
+
+## Klasör Yapısı
+- `main.go` uygulama giriş noktası
+- `app/` iş mantığı modülleri
+- `config/` veritabanı ve redis ayarları
+- `router/router.go` route tanımları
+
+## Ana Modüller
+### accounts
+Kullanıcı işlemleri ve auth ile ilgili alanlar.
+
+### settings
+Uygulama ayarları.
+
+### shop
+Ürün ve sepet işlemleri.
+
+### blog
+Blog işlemleri.
+
+## MCP Kullanım Notları
+- Yeni endpoint eklerken mevcut yapı korunmalı.
+- Handler logic sade tutulmalı.
+- Model, handler ve router ayrımı bozulmamalı.
+- Admin işlemler için ayrıca yetkilendirme düşünülmeli.
+
+## Admin User Management
+Beklenen admin endpointleri:
+- `GET /admin/users`
+- `GET /admin/users/:id`
+- `POST /admin/users`
+- `PUT /admin/users/:id`
+- `PATCH /admin/users/:id/status`
+- `DELETE /admin/users/:id`
+
+## Güvenlik
+- Password hash zorunlu.
+- Role-based access önerilir.
+- Response içinde hassas alan dönülmemeli.
+
+## Not
+Bu servis dosyası, MCP uyumlu otomasyon ve Copilot yönlendirmesi için referans dokümandır.