@burgan-tech/morph-touch-runtime 0.0.6 → 0.0.8

package/morph-touch/doc/morph-touch-domain.md

@@ -1,6 +1,6 @@
 # Morph-touch domain — teknik özet
 
-Bu doküman, `morph-touch` domain’indeki randevu (rezervation), yokluk/absence, sohbet odası, bildirim ve transfer akışlarını; workflow tanımları ve görev mapping’lerindeki davranışa dayanarak özetler. API örnekleri [postman_collection.json](../../postman_collection.json) koleksiyonu ile uyumludur.
+Bu doküman, `morph-touch` domain’indeki randevu (rezervation), yokluk/absence, sohbet odası, bildirim ve transfer akışlarını; workflow tanımları ve görev mapping’lerindeki davranışa dayanarak özetler. HTTP örnekleri **`{{BaseUrl}}/morph-touch/...`** şablonunu kullanır; [postman_collection.json](../../postman_collection.json) farklı değişkenlerle (`api/v{{apiVersion}}` vb.) tanımlı olabilir — ortamınızda `baseUrl` ve yol önekini gateway şemanıza göre hizalayın.
 
 İngilizce sürüm: [morph-touch-domain.en.md](morph-touch-domain.en.md).
 
@@ -9,7 +9,7 @@ Bu doküman, `morph-touch` domain’indeki randevu (rezervation), yokluk/absence
 ## 1. Genel bakış ve terminoloji
 
 - **Domain:** `morph-touch`
-- **Workflow instance:** `key`, `flow` (`sys-flows`), `domain`, `version` ile tanımlı vNext instance modeli; HTTP üzerinden `.../workflows/{flowKey}/instances/...` ile başlatılır ve geçişler `.../transitions/{transitionKey}` ile tetiklenir.
+- **Workflow instance:** `key`, `flow` (`sys-flows`), `domain`, `version` ile tanımlı vNext instance modeli; HTTP üzerinden `.../workflows/{flowKey}/instances/...` ile başlatılır ve geçişler `.../transitions/{transitionKey}` ile tetiklenir. `instances/` sonrası yolda platform **instance id** (UUID) veya `start` isteğinde verilen instance **`key`** kullanılabilir.
 - **Entegrasyonlar:**
   - **DAPR / uygulama API:** `api/v{version}/{domain}/...` (mapping’lerde geçen `functions/state`, `functions/data` yolları).
   - **Matrix:** `MatrixBaseUrl` (secret); oda oluşturma, join, invite, kick, history visibility.
@@ -63,6 +63,8 @@ flowchart LR
 
 Kayıtlar çoğunlukla `complete` durumunda tutulur; `update` ile güncellenir, `cancel` ile `cancelled` olur.
 
+Detaylı istek gövdeleri, anahtar kuralları ve cURL örnekleri için **§14**’e bakın.
+
 ### Randevu transferi ile bağlantı
 
 - Geçiş **`start-transfer`** yalnızca `absenceType == "personal-leave"` iken değerlendirilir (`CanStartTransferMapping` — [Workflows/src/CanStartTransferMapping.csx](../Workflows/src/CanStartTransferMapping.csx)).
@@ -276,13 +278,14 @@ Detaylı HTTP örnekleri için [Functions/get-room-messages.http](../Functions/g
 ### Workflow API şablonları
 
 - **Instance başlat:**  
-  `POST {{baseUrl}}/api/v{{apiVersion}}/{{domain}}/workflows/{flowKey}/instances/start?sync=true`  
+  `POST {{baseUrl}}/morph-touch/workflows/{flowKey}/instances/start?sync=true`  
   Örnek: `rezervation`, `absence-entry`, `rezervation-start`, `chat-room`, `start-chat`, `rezervation-transfer`, `notification-sender` (alt süreç).
 - **Instance oku:**  
-  `GET .../workflows/{flowKey}/instances/{{instanceId}}`
+  `GET {{baseUrl}}/morph-touch/workflows/{flowKey}/instances/{{instanceIdOrKey}}`  
+  Yol segmenti: platform **instance `id`** (UUID) veya `start` isteğinde verilen instance **`key`** (ör. `working-hour`, `rez-...`).
 - **Geçiş:**  
-  `PATCH .../workflows/{flowKey}/instances/{{instanceId}}/transitions/{transitionKey}?sync=true`  
-  Gövde genelde `{ "attributes": { ... } }`.
+  `PATCH {{baseUrl}}/morph-touch/workflows/{flowKey}/instances/{{instanceIdOrKey}}/transitions/{transitionKey}?sync=true`  
+  Aynı şekilde **id** veya **`key`** kullanılabilir. Gövde genelde `{ "attributes": { ... } }`.
 
 ### Örnek istekler (koleksiyon klasörleri)
 
@@ -325,4 +328,418 @@ Koleksiyon içi açıklamalar: instance filtreleme ve görev tipleri için [vNex
 
 ---
 
+## 14. API kullanım kılavuzu (cURL ve alan kuralları)
+
+### 14.1 Ön koşul ve sıra
+
+Randevu ve **get-available-slots** mantığı için önce **şirket çalışma saatleri** kaydının oluşturulması önerilir (`absenceType: working-hours-change`, instance `key: "working-hour"`, tags `working-hours-change` + `company`). Ardından resmi tatiller, danışman izinleri / özel çalışma saatleri ve rezervasyon akışı kullanılabilir.
+
+### 14.2 `{{BaseUrl}}`, yol şablonu ve kimlik doğrulama
+
+- Tüm örneklerde **`{{BaseUrl}}`**, ortamınızdaki API gateway **kökünü** temsil eder (örneğin `https://<host>` veya kurulumunuza göre `https://<host>/ebanking`). Değeri APISIX / ortam dokümantasyonunuza göre ayarlayın; kökün sonunda `/` bırakmayın veya birleştirmede **çift slash** (`//morph-touch`) oluşmamasına dikkat edin.
+- Standart şablon: **`{{BaseUrl}}/morph-touch/workflows/...`** ve **`{{BaseUrl}}/morph-touch/functions/...`** (örnek: `{{BaseUrl}}/morph-touch/workflows/absence-entry/instances/start?sync=true`).
+- Postman koleksiyonundaki `{{baseUrl}}` ile aynı rolde düşünülebilir; isimlendirme dokümanda `{{BaseUrl}}` olarak verilmiştir.
+- **`Authorization: Bearer <access_token>`:** Birçok ortamda bu başlık **zorunludur**; gateway veya güvenlik politikasına göre zorunluluk **ortamdan ortama değişebilir** (yerel geliştirme hariç tutulabilir). Erişim jetonu **ortama göre** alınır (geliştirme, test, üretim). Token’ı ilgili kimlik sağlayıcısından veya ortamınızın (APISIX, API portalı, güvenlik ekibi) verdiği yöntemle edinin; örneklerdeki `<access_token>` yalnızca yer tutucudur. Gerçek token’ları repoya veya paylaşılan dokümana yapıştırmayın.
+- `.../workflows/{flowKey}/instances/<segment>/...` adresindeki `<segment>`: **`{{instanceIdOrKey}}`** — ya platformun döndüğü **instance id** ya da instance **`key`** değeridir.
+
+### 14.3 Şirket çalışma saatleri — `absence-entry` start (tek sefer)
+
+`key` **sabit** `working-hour` olmalıdır. `absenceType` **`working-hours-change`**. `customWorkingHours` altında haftanın günleri (`monday` … `sunday`) tanımlanır; her gün **dizi** olup elemanlar `{ "start": "HH:mm", "end": "HH:mm" }` şeklindedir.
+
+```bash
+curl --location '{{BaseUrl}}/morph-touch/workflows/absence-entry/instances/start?sync=true' \
+  --header 'Content-Type: application/json' \
+  --header 'Accept-Language: tr-TR' \
+  --header 'X-Request-Id: <uuid>' \
+  --header 'Authorization: Bearer <access_token>' \
+  --data '{
+  "key": "working-hour",
+  "tags": ["working-hours-change", "company"],
+  "attributes": {
+    "absenceType": "working-hours-change",
+    "title": "Şirket Çalışma Saatleri",
+    "customWorkingHours": {
+      "monday": [{"start": "09:00", "end": "12:00"}, {"start": "13:30", "end": "18:00"}],
+      "tuesday": [{"start": "09:00", "end": "12:00"}, {"start": "13:30", "end": "18:00"}],
+      "wednesday": [{"start": "09:00", "end": "12:00"}, {"start": "13:30", "end": "18:00"}],
+      "thursday": [{"start": "09:00", "end": "12:00"}, {"start": "13:30", "end": "18:00"}],
+      "friday": [{"start": "09:00", "end": "12:00"}, {"start": "13:30", "end": "17:00"}],
+      "saturday": [],
+      "sunday": []
+    }
+  }
+}'
+```
+
+### 14.4 Şirket çalışma saatleri — sonraki güncellemeler (`update`)
+
+Aynı domainde şirket kaydı genelde **bir kez** `start` ile açılır; sonrasında yalnızca **`PATCH .../transitions/update`** kullanılır. URL’de **`{{instanceIdOrKey}}`** olarak ya yanıttaki **platform instance id** (UUID) ya da şirket kaydı için sabit **`key`** (`working-hour`) kullanılabilir.
+
+```bash
+curl --location --request PATCH '{{BaseUrl}}/morph-touch/workflows/absence-entry/instances/{{instanceIdOrKey}}/transitions/update?sync=true' \
+  --header 'Content-Type: application/json' \
+  --header 'Accept-Language: tr-TR' \
+  --header 'X-Request-Id: <uuid>' \
+  --header 'Authorization: Bearer <access_token>' \
+  --data '{
+  "attributes": {
+    "title": "Şirket Çalışma Saatleri (Güncellendi)",
+    "customWorkingHours": {
+      "monday": [{"start": "08:30", "end": "12:00"}, {"start": "13:00", "end": "17:30"}],
+      "tuesday": [{"start": "08:30", "end": "12:00"}, {"start": "13:00", "end": "17:30"}],
+      "wednesday": [{"start": "08:30", "end": "12:00"}, {"start": "13:00", "end": "17:30"}],
+      "thursday": [{"start": "08:30", "end": "12:00"}, {"start": "13:00", "end": "17:30"}],
+      "friday": [{"start": "08:30", "end": "12:00"}, {"start": "13:00", "end": "16:30"}],
+      "saturday": [],
+      "sunday": []
+    }
+  }
+}'
+```
+
+### 14.5 Resmi tatil (`public-holiday`)
+
+`key` deseni: `public-holiday-{tarih}` (örnek: `public-holiday-2026-04-23`). `absenceType` **`public-holiday`**. Tam veya yarım gün için `startDateTime` / `endDateTime` ihtiyaca göre set edilir.
+
+```bash
+curl --location '{{BaseUrl}}/morph-touch/workflows/absence-entry/instances/start?sync=true' \
+  --header 'Content-Type: application/json' \
+  --header 'Accept-Language: tr-TR' \
+  --header 'X-Request-Id: <uuid>' \
+  --header 'Authorization: Bearer <access_token>' \
+  --data '{
+  "key": "public-holiday-2026-04-23",
+  "tags": ["public-holiday"],
+  "attributes": {
+    "absenceType": "public-holiday",
+    "startDateTime": "2026-04-23T00:00:00",
+    "endDateTime": "2026-04-23T23:59:59",
+    "title": "23 Nisan Ulusal Egemenlik ve Çocuk Bayramı"
+  }
+}'
+```
+
+### 14.6 Kişisel izin (`personal-leave`)
+
+`key` deseni: `personal-leave-{advisorId}-{startDateTime}-{endDateTime}`. `absenceType` **`personal-leave`**. `advisor` izin alan danışmanın benzersiz kimliği (çoğunlukla sicil). `advisorType` ortamda kısaltma (**`PM` / `IA`**) veya tam akış değerleri (**`portfolio-manager` / `investment-advisor`**) olarak kullanılabilir; üretim sözleşmenize göre seçin.
+
+```bash
+curl --location '{{BaseUrl}}/morph-touch/workflows/absence-entry/instances/start?sync=true' \
+  --header 'Content-Type: application/json' \
+  --header 'Accept-Language: tr-TR' \
+  --header 'X-Request-Id: <uuid>' \
+  --header 'sub: <kullanici_sub>' \
+  --header 'Authorization: Bearer <access_token>' \
+  --data '{
+  "key": "personal-leave-<advisorId>-2026-04-07T00:00:00-2026-04-07T12:59:59",
+  "tags": ["personal-leave"],
+  "attributes": {
+    "advisor": "<advisorId>",
+    "advisorType": "PM",
+    "absenceType": "personal-leave",
+    "startDateTime": "2026-04-07T00:00:00",
+    "endDateTime": "2026-04-07T12:59:59",
+    "title": "Müşteri Toplantısı"
+  }
+}'
+```
+
+### 14.7 Danışmana özel çalışma saatleri (`working-hours-change` + advisor)
+
+`key` deseni: `working-hour-{advisorId}`. Tags: `working-hours-change`, `advisor`. `advisor` alanı zorunlu; `customWorkingHours` yapısı §14.3 ile aynıdır.
+
+```bash
+curl --location '{{BaseUrl}}/morph-touch/workflows/absence-entry/instances/start?sync=true' \
+  --header 'Content-Type: application/json' \
+  --header 'Accept-Language: tr-TR' \
+  --header 'X-Request-Id: <uuid>' \
+  --header 'Authorization: Bearer <access_token>' \
+  --data '{
+  "key": "working-hour-<advisorId>",
+  "tags": ["working-hours-change", "advisor"],
+  "attributes": {
+    "advisor": "<advisorId>",
+    "absenceType": "working-hours-change",
+    "title": "Özel Çalışma Saatleri",
+    "customWorkingHours": {
+      "monday": [{"start": "10:00", "end": "12:00"}, {"start": "13:00", "end": "19:00"}],
+      "tuesday": [],
+      "wednesday": [],
+      "thursday": [],
+      "friday": [],
+      "saturday": [],
+      "sunday": []
+    }
+  }
+}'
+```
+
+### 14.8 İptal — `cancel` geçişi
+
+```bash
+curl --location --request PATCH '{{BaseUrl}}/morph-touch/workflows/absence-entry/instances/{{instanceIdOrKey}}/transitions/cancel?sync=true' \
+  --header 'Content-Type: application/json' \
+  --header 'Accept-Language: tr-TR' \
+  --header 'X-Request-Id: <uuid>' \
+  --header 'Authorization: Bearer <access_token>' \
+  --data '{"attributes": {}}'
+```
+
+### 14.9 Yokluk güncelleme — `update` (örnek: izin tarihleri)
+
+```bash
+curl --location --request PATCH '{{BaseUrl}}/morph-touch/workflows/absence-entry/instances/{{instanceIdOrKey}}/transitions/update?sync=true' \
+  --header 'Content-Type: application/json' \
+  --header 'Accept-Language: tr-TR' \
+  --header 'X-Request-Id: <uuid>' \
+  --header 'Authorization: Bearer <access_token>' \
+  --data '{
+  "attributes": {
+    "startDateTime": "2026-01-28T15:00:00",
+    "endDateTime": "2026-01-28T17:00:00",
+    "title": "Müşteri Toplantısı (Güncellendi)"
+  }
+}'
+```
+
+### 14.10 `get-absence-entry` fonksiyonu
+
+`absenceType` zorunlu; şirket çalışma saatleri için yalnız `working-hours-change` gönderildiğinde şirket geneli kayıtlar döner. Tarih aralığı ile resmi tatiller; `advisor` ile danışman çalışma saatleri.
+
+```bash
+# Şirket çalışma saatleri
+curl --location '{{BaseUrl}}/morph-touch/functions/get-absence-entry?absenceType=working-hours-change' \
+  --header 'Accept: application/json' \
+  --header 'Accept-Language: tr-TR' \
+  --header 'X-Request-Id: <uuid>' \
+  --header 'Authorization: Bearer <access_token>'
+
+# Resmi tatiller (tarih aralığı)
+curl --location '{{BaseUrl}}/morph-touch/functions/get-absence-entry?absenceType=public-holiday&startDate=2026-04-01T00:00:00&endDate=2026-04-30T23:59:59' \
+  --header 'Accept: application/json' \
+  --header 'Accept-Language: tr-TR' \
+  --header 'X-Request-Id: <uuid>' \
+  --header 'Authorization: Bearer <access_token>'
+
+# Danışman özel çalışma saatleri
+curl --location '{{BaseUrl}}/morph-touch/functions/get-absence-entry?absenceType=working-hours-change&advisor=<advisorId>' \
+  --header 'Accept: application/json' \
+  --header 'Accept-Language: tr-TR' \
+  --header 'X-Request-Id: <uuid>' \
+  --header 'Authorization: Bearer <access_token>'
+```
+
+### 14.11 `get-available-slots`
+
+Belirtilen `advisorId` ve `date` için o günkü boş slotları döner; `duration` isteğe bağlıdır (dakika).
+
+```bash
+curl --location '{{BaseUrl}}/morph-touch/functions/get-available-slots?advisorId=<advisorId>&date=2026-03-17' \
+  --header 'Accept: application/json' \
+  --header 'Accept-Language: tr-TR' \
+  --header 'X-Request-Id: <uuid>' \
+  --header 'Authorization: Bearer <access_token>'
+```
+
+Örnek gövde:
+
+```json
+{
+  "getAvailableSlots": {
+    "availableSlots": [
+      "09:00-09:30",
+      "09:30-10:00",
+      "10:00-10:30"
+    ]
+  }
+}
+```
+
+### 14.12 Rezervasyon akışı (`rezervation`)
+
+1. **`start`:** `key` her rezervasyon için benzersiz olmalıdır; sonraki adımlarda `randevuKey` olarak bu değer kullanılır. `user`, `advisor`, `startDateTime`, `endDateTime` — slotlarla uyumlu aralık seçin. **`sub`** header’ı token’dan veya açıkça gönderilir (müşteri kimliği).
+2. Geçmiş tarih veya aynı kullanıcı için kurallara aykırı ikinci aktif rezervasyon varsa oluşturma reddedilebilir (bkz. §4 / §12).
+3. State **`slot-unavailable`** ise **`appointment-form-retry`** ile yeni tarih/saat gönderilir.
+4. **`appointment-form`** sonrası **`confirm-selection`** ile kullanıcı girdisi onaylanır.
+5. **`create-appointment`** ile durum **`active`** olur; arka planda bildirim ve kullanıcı bilgisi (`get-user-info-for-rezervation`) çalışır, SMS kayıtlı telefona gider.
+
+Aşağıdaki geçiş çağrılarında `instances/` sonrasına **platform instance id** veya `start` ile verdiğiniz rezervasyon **`key`** (ör. `rez-<unique-suffix>`) yazılabilir (`{{rezervationInstanceIdOrKey}}`).
+
+```bash
+curl --location '{{BaseUrl}}/morph-touch/workflows/rezervation/instances/start?sync=true' \
+  --header 'Content-Type: application/json' \
+  --header 'Accept-Language: tr-TR' \
+  --header 'X-Request-Id: <uuid>' \
+  --header 'sub: <customer_sub>' \
+  --header 'Authorization: Bearer <access_token>' \
+  --data '{
+  "key": "rez-<unique-suffix>",
+  "tags": ["appointment", "randevu"],
+  "attributes": {
+    "user": "<userRef>",
+    "advisor": "<advisorRef>",
+    "startDateTime": "2026-04-17T10:30:00",
+    "endDateTime": "2026-04-17T11:00:00"
+  }
+}'
+```
+
+```bash
+curl --location --request PATCH '{{BaseUrl}}/morph-touch/workflows/rezervation/instances/{{rezervationInstanceIdOrKey}}/transitions/appointment-form-retry?sync=true' \
+  --header 'Content-Type: application/json' \
+  --header 'Accept-Language: tr-TR' \
+  --header 'X-Request-Id: <uuid>' \
+  --header 'Authorization: Bearer <access_token>' \
+  --data '{
+  "attributes": {
+    "startDateTime": "2026-04-17T11:00:00",
+    "endDateTime": "2026-04-17T11:30:00"
+  }
+}'
+```
+
+```bash
+curl --location --request PATCH '{{BaseUrl}}/morph-touch/workflows/rezervation/instances/{{rezervationInstanceIdOrKey}}/transitions/confirm-selection?sync=true' \
+  --header 'Content-Type: application/json' \
+  --header 'Accept-Language: tr-TR' \
+  --header 'X-Request-Id: <uuid>' \
+  --header 'Authorization: Bearer <access_token>' \
+  --data '{"attributes": {}}'
+```
+
+```bash
+curl --location --request PATCH '{{BaseUrl}}/morph-touch/workflows/rezervation/instances/{{rezervationInstanceIdOrKey}}/transitions/create-appointment?sync=true' \
+  --header 'Content-Type: application/json' \
+  --header 'Accept-Language: tr-TR' \
+  --header 'X-Request-Id: <uuid>' \
+  --header 'Authorization: Bearer <access_token>' \
+  --data '{"attributes": {}}'
+```
+
+### 14.13 Görüşme başlatma (`rezervation-start`)
+
+Randevu başlangıcına **en fazla 15 dakika** kala çağrılabilir; daha erken ise **`meet-not-started`** benzeri dala düşer. `randevuKey` ilgili rezervasyonun `key` değeridir. `participantType`: `customer`, `advisor` veya `invited`; **`invited`** ise **`invitedUserId`** zorunludur ve kullanıcı önce **add-participant-to-rezervation** akışı ile rezervasyona eklenmiş olmalıdır. İlk katılımcı Matrix odasını oluşturur ve rezervasyon **`in-meet`** olur; ikinci katılımcı **join** eder ve LiveKit URL’leri rezervasyon datasına yazılır.
+
+```bash
+curl --location '{{BaseUrl}}/morph-touch/workflows/rezervation-start/instances/start?sync=true' \
+  --header 'Content-Type: application/json' \
+  --header 'Accept-Language: tr-TR' \
+  --header 'X-Request-Id: <uuid>' \
+  --header 'Authorization: Bearer <access_token>' \
+  --data '{
+  "key": "randevu-<unique-suffix>",
+  "tags": ["randevu", "meeting"],
+  "attributes": {
+    "randevuKey": "rez-<unique-suffix>",
+    "participantType": "advisor"
+  }
+}'
+```
+
+Davetli örneği: `participantType: "invited"` ve `invitedUserId: "<davetliId>"` ekleyin.
+
+### 14.14 Rezervasyona katılımcı ekleme (`add-participant-to-rezervation`)
+
+```bash
+curl --location '{{BaseUrl}}/morph-touch/workflows/add-participant-to-rezervation/instances/start?sync=true' \
+  --header 'Content-Type: application/json' \
+  --header 'Accept-Language: tr-TR' \
+  --header 'X-Request-Id: <uuid>' \
+  --header 'Authorization: Bearer <access_token>' \
+  --data '{
+  "key": "add-participant-<unique-suffix>",
+  "tags": ["rezervation", "add-participant"],
+  "attributes": {
+    "randevuKey": "rez-<unique-suffix>",
+    "newUserId": "<davetEdilecekSicil>"
+  }
+}'
+```
+
+Önerilen `key` deseni: `add-participant-{advisorId}-{randevuKey}` (benzersizlik için).
+
+### 14.15 Aktif rezervasyon güncelleme (`rezervation-update`)
+
+`randevuKey` güncellenecek rezervasyonun `key` değeridir. `startDateTime`, `endDateTime`, `advisor` ihtiyaca göre gönderilir. **`autoProcess: true`** ise akış doğrulamayı otomatik ilerletebilir; **`false`** ise `start` sonrası güncelleme değerleri **`PATCH .../transitions/to-validate`** ile gönderilir ([rezervation-update.json](../Workflows/rezervation-update.json)).
+
+```bash
+curl --location '{{BaseUrl}}/morph-touch/workflows/rezervation-update/instances/start?sync=true' \
+  --header 'Content-Type: application/json' \
+  --header 'Accept-Language: tr-TR' \
+  --header 'X-Request-Id: <uuid>' \
+  --header 'Authorization: Bearer <access_token>' \
+  --data '{
+  "key": "rezervation-update-<unique-suffix>",
+  "tags": ["rezervation", "randevu", "update"],
+  "attributes": {
+    "randevuKey": "rez-<unique-suffix>",
+    "startDateTime": "2026-02-03T10:00:00",
+    "endDateTime": "2026-02-03T10:30:00",
+    "advisor": "<yeniAdvisorRef>",
+    "autoProcess": true
+  }
+}'
+```
+
+### 14.16 Kalıcı sohbet — `start-chat`
+
+Oda yoksa oluşturulur; varsa doğrudan **`in-chat`**. `user` sohbeti başlatan müşteri; `advisorType` **`PM`** veya **`IA`**; `advisorId` danışmanın benzersiz kimliği (sicil).
+
+```bash
+curl --location '{{BaseUrl}}/morph-touch/workflows/start-chat/instances/start?sync=true' \
+  --header 'Content-Type: application/json' \
+  --header 'Accept-Language: tr-TR' \
+  --header 'X-Request-Id: <uuid>' \
+  --header 'Authorization: Bearer <access_token>' \
+  --data '{
+  "key": "start-chat-<unique-suffix>",
+  "tags": ["chat", "start-chat"],
+  "attributes": {
+    "user": "<userRef>",
+    "advisorType": "IA",
+    "advisorId": "<advisorId>"
+  }
+}'
+```
+
+### 14.17 Sohbet odaları ve mesajlar (domain fonksiyonları)
+
+Canonical yol: **`GET {{BaseUrl}}/morph-touch/functions/get-chat-rooms`** ve **`GET .../functions/get-room-messages`**. Bazı gateway kurulumlarında farklı önek olabilir.
+
+**`get-chat-rooms`:** `user` **veya** `advisor` (ikisi birden değil). İsteğe bağlı `roomType`: `permanent` veya `rezervation`.
+
+**Not:** [GetChatRoomsMapping](../Functions/src/GetChatRoomsMapping.csx) içinde instance sorgusu şu an sabit `pageSize=100` ile yapılabilir; query’de `pageSize` geçmek her zaman etkili olmayabilir.
+
+```bash
+curl --location '{{BaseUrl}}/morph-touch/functions/get-chat-rooms?user=<userRef>&roomType=permanent' \
+  --header 'Accept: application/json' \
+  --header 'Accept-Language: tr-TR' \
+  --header 'X-Request-Id: <uuid>' \
+  --header 'Authorization: Bearer <access_token>'
+```
+
+**`get-room-messages`:** Zorunlu `roomId`, `user`. İsteğe bağlı **`limit`** (varsayılan mapping tarafında 50); sayfalama için `from` token’ı kullanılabilir.
+
+```bash
+curl --location '{{BaseUrl}}/morph-touch/functions/get-room-messages?roomId=<encodedRoomId>&user=<userRef>&limit=20' \
+  --header 'Accept: application/json' \
+  --header 'Accept-Language: tr-TR' \
+  --header 'X-Request-Id: <uuid>' \
+  --header 'Authorization: Bearer <access_token>'
+```
+
+### 14.18 Rezervasyon listesi — `get-rezervations`
+
+Query: `advisorId`, `userId`, `startDate`, `endDate` — tarihler zorunlu değildir; aralık filtrelemek için kullanılır.
+
+```bash
+curl --location '{{BaseUrl}}/morph-touch/functions/get-rezervations?advisorId=<advisorId>&startDate=2026-02-01&endDate=2026-02-28' \
+  --header 'Accept: application/json' \
+  --header 'Accept-Language: tr-TR' \
+  --header 'X-Request-Id: <uuid>' \
+  --header 'Authorization: Bearer <access_token>'
+```
+
+---
+
 *Bu doküman, kod ve workflow tanımlarına göre oluşturulmuştur; çalışma zamanı URL’leri ve auth şeması ortamınıza göre değişebilir.*

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@burgan-tech/morph-touch-runtime",
-  "version": "0.0.6",
+  "version": "0.0.8",
   "description": "morph-touch - Runtime Package for engine deployment",
   "main": "index.js",
   "type": "module",

package/vnext.config.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.0.6",
+  "version": "0.0.8",
   "description": "morph-touch Domain Definition Configuration",
   "domain": "morph-touch",
   "runtimeVersion": "0.0.41",