Ana içeriğe geç

User Auth Context Cache

Bu sayfa, user:{user_id}:auth-context key ailesinin Qapu içindeki işletim sözleşmesini tanımlar.

Bu key ailesi, kullanıcı temel auth bağlamını tek sorguda çözmek için kullanılır.

Key Pattern​

  • user:{user_id}:auth-context

Örnek:

  • user:123:auth-context

Redis DB Alanı​

  • Önerilen DB: 0

Owner Service​

  • Primary writer: API Servisi / Auth modülü
  • Primary readers: API Servisi ve auth middleware
  • Secondary writer: kullanıcı durum/rol güncelleyen yönetim servisleri

Authoritative Source​

  • users
  • user_roles

Kanonik Yapı​

{
  "user_id": 123,
  "status_id": 202,
  "role_id": 31,
  "role_name": "corporate_operator",
  "is_deleted": false,
  "auth_version": 7,
  "last_login_time": "2026-04-16T11:55:00Z"
}

Kullanım Amacı​

Bu key ile şu sorular hızlı çözülür:

  • kullanıcı aktif mi?
  • rolü ne?
  • soft delete edilmiş mi?
  • auth_version güncel mi?

TTL ve Invalidation​

  • TTL: 10m - 30m

Invalidation tetikleri:

  1. users.role_id değişirse
  2. users.status_id değişirse
  3. users.is_deleted değişirse
  4. kullanıcı login/logout akışı last_login_time güncellerse
  5. auth_version artarsa

Çapraz Referanslar​

  • /projects/qapu/services/api/jwt-auth-flow
  • /projects/qapu/services/redis/keyspace/auth-session
  • /projects/qapu/services/redis/keyspace/device-user-authz