SHOPAR FOR AGENTS · AÇIK BELGELER

Mimari ve İstek Akışları

Shopar araçlarının kullanıcı kimliğini nasıl koruduğunu, istekleri backend'e nasıl ilettiğini ve yetki kontrolünün nerede yapıldığını açıklıyoruz.

Son güncelleme: 2026-10-08Hazır

Bugünkü CLI akışı

Operatör CLI'ı kendi bilgisayarında çalıştırır ve e-posta koduyla kendi Shopar Admin oturumunu açar. CLI, tanımlı gRPC operasyonlarını Shopar backend'e iletir. Backend, geçerli oturumu ve o anki kullanıcı rolünü kontrol eder; iş kuralları ve denetim kayıtları backend'de kalır.

  • Operatör ve CLI aynı Shopar kimliğini kullanır.
  • CLI veritabanına bağlanmaz ve yetki kararı vermez.
  • Her RPC isteğinde backend'in izin ve alan kuralları geçerlidir.

İlerideki ajan akışı

Planlanan MCP akışında uyumlu ajan, operatörün açıkça bağladığı bir Shopar aracına istek gönderir. Araç isteği mevcut Shopar kimliğiyle backend'e aktarır. MCP taşıması ve oturum modeli henüz tasarım aşamasındadır; çizimdeki bu akış geleceği gösterir, bugün kullanılabilir bir özellik değildir.

Yetkili kaynak

Shopar'ın PostgreSQL kaynaklı backend servisleri kullanıcı, katalog, izin ve finansal kayıtlar için yetkili kaynaktır. İstemci veya ajan, kendi kopyasındaki veriyi gerçek kabul etmemeli ve backend doğrulamasını atlamaya çalışmamalıdır.

Ajanların okuyabildiği Markdown
---
title: "Mimari ve İstek Akışları"
summary: "Shopar araçlarının kullanıcı kimliğini nasıl koruduğunu, istekleri backend'e nasıl ilettiğini ve yetki kontrolünün nerede yapıldığını açıklıyoruz."
canonical_url: https://shopar.app/agents/docs/architecture/
status: available
audience: people,agents
language: Türkçe
last_updated: 2026-10-08
---

# Mimari ve İstek Akışları

Shopar araçlarının kullanıcı kimliğini nasıl koruduğunu, istekleri backend'e nasıl ilettiğini ve yetki kontrolünün nerede yapıldığını açıklıyoruz.

## Bugünkü CLI akışı

Operatör CLI'ı kendi bilgisayarında çalıştırır ve e-posta koduyla kendi Shopar Admin oturumunu açar. CLI, tanımlı gRPC operasyonlarını Shopar backend'e iletir. Backend, geçerli oturumu ve o anki kullanıcı rolünü kontrol eder; iş kuralları ve denetim kayıtları backend'de kalır.

- Operatör ve CLI aynı Shopar kimliğini kullanır.
- CLI veritabanına bağlanmaz ve yetki kararı vermez.
- Her RPC isteğinde backend'in izin ve alan kuralları geçerlidir.

## İlerideki ajan akışı

Planlanan MCP akışında uyumlu ajan, operatörün açıkça bağladığı bir Shopar aracına istek gönderir. Araç isteği mevcut Shopar kimliğiyle backend'e aktarır. MCP taşıması ve oturum modeli henüz tasarım aşamasındadır; çizimdeki bu akış geleceği gösterir, bugün kullanılabilir bir özellik değildir.

## Yetkili kaynak

Shopar'ın PostgreSQL kaynaklı backend servisleri kullanıcı, katalog, izin ve finansal kayıtlar için yetkili kaynaktır. İstemci veya ajan, kendi kopyasındaki veriyi gerçek kabul etmemeli ve backend doğrulamasını atlamaya çalışmamalıdır.
← Tüm belgeler