> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flextell.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Aktivite Logları API

> Sistemdeki kritik modeller üzerinde yapılan ekleme, güncelleme ve silme işlemlerinin tarihçesini sorgulamak için kullanılan endpoint'ler.

<Warning>
  Bu API tamamen **salt okunur (read-only)** bir servistir. Log kayıtları sistem tarafından otomatik olarak oluşturulur; API üzerinden yeni log eklenemez, mevcut loglar güncellenemez veya silinemez.
</Warning>

<Note>
  Tüm isteklerde `X-Tenant` header'ı **zorunludur** ve sadece ilgili tenant'a ait loglar döndürülür.
</Note>

## Endpoint özeti

| Metot | Endpoint                     | Açıklama                                    |
| ----- | ---------------------------- | ------------------------------------------- |
| `GET` | `/api/v1/activity-logs`      | Aktivite loglarını filtreli olarak listeler |
| `GET` | `/api/v1/activity-logs/{id}` | Tek bir log kaydının detaylarını getirir    |

<Tip>
  Tüm parametreler, alanlar ve örnek istek/yanıtlar için **[API Referansı](/api-reference)** sekmesine bakın.
</Tip>

## Aktivite logu kavramı

Aktivite logları, sistemdeki kritik modeller (hastalar, randevular, odalar vb.) üzerinde yapılan **ekleme**, **güncelleme** ve **silme** işlemlerinin tarihçesini tutar.

Bir log kaydı; işlemin **ne zaman** yapıldığını, **kim tarafından** yapıldığını (`causer`), **hangi kayıt** üzerinde yapıldığını (`subject`) ve veri değişikliklerinin detaylarını (`properties` içinde eski ve yeni değerler olarak) barındırır.

<Tip>
  **`causer` filtresi:** `causer=system` ile yalnızca otomatik sistem işlemleri, `causer=12` gibi bir kullanıcı ID'si ile belirli bir personelin yaptığı değişiklikler filtrelenebilir.
</Tip>

## Yetkilendirme

### Uygulama izinleri (permissions)

| İşlem                | Permission            |
| -------------------- | --------------------- |
| Listeleme            | `ViewAny:ActivityLog` |
| Detay / Tek gösterme | `View:ActivityLog`    |

### Token scope'ları (Passport)

| İşlem                   | Scope                |
| ----------------------- | -------------------- |
| Okuma (`index`, `show`) | `activity_logs:read` |