first commit

mpc/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.

mpc/docs/admin-user-api.md

@@ -0,0 +1,28 @@
+# Admin User Management API
+
+Bu doküman admin panel için kullanıcı yönetimi endpointlerini açıklar.
+
+## Base Path
+`/admin/users`
+
+## Endpointler
+
+### 1. Kullanıcı Listesi
+`GET /admin/users`
+
+#### Query Params
+- `page` (optional)
+- `limit` (optional)
+- `search` (optional)
+- `status` (optional)
+
+#### Response
+```json
+{
+  "data": [],
+  "pagination": {
+    "page": 1,
+    "limit": 10,
+    "total": 0
+  }
+}

mpc/docs/mcp-usage.md

@@ -0,0 +1,24 @@
+# MCP Usage
+
+## Bu dosyanın amacı
+Copilot veya başka bir agent'ın bu repo için görev alırken izlemesi gereken kullanım rehberi.
+
+## Çalışma Prensibi
+- Önce mevcut klasör yapısını analiz et.
+- Sonra ilgili modülün handler ve model dosyalarını incele.
+- Yeni kod eklerken mevcut naming convention’a uy.
+- Değişiklikleri minimum etkiyle yap.
+
+## Admin User Endpoint Beklentisi
+- Listeleme
+- Detay
+- Oluşturma
+- Güncelleme
+- Durum değiştirme
+- Silme
+
+## Çıkış Kuralları
+- Hassas bilgi döndürme.
+- Validation ekle.
+- Hata kodlarını doğru kullan.
+- Router’ı güncelle.

mpc/docs/project-structure.md

@@ -0,0 +1,27 @@
+# Project Structure
+
+## Root
+- `main.go` uygulama başlangıcı
+- `.env` ortam değişkenleri
+
+## app
+Uygulama modülleri burada bulunur.
+
+### accounts
+Kullanıcı ve hesap yönetimi.
+
+### settings
+Site ayarları ve yapılandırmalar.
+
+### shop
+Ürün ve sepet yönetimi.
+
+### blog
+Blog yönetimi.
+
+## config
+- `db.go` veritabanı bağlantısı
+- `redis.go` redis bağlantısı
+
+## router
+- `router.go` tüm route tanımları