54 lines
1.3 KiB
Markdown
54 lines
1.3 KiB
Markdown
# 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. |