@burgan-tech/morph-touch-runtime 0.0.5 → 0.0.7

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

@@ -0,0 +1,745 @@
+# 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. 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).
+
+---
+
+## 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. `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.
+  - **MessagingGateway:** SMS ve push bildirimleri ([notification-sender](../Workflows/notification-sender.json)).
+
+### Yüksek seviye ilişki
+
+```mermaid
+flowchart LR
+  subgraph absence [absence-entry]
+    A1[complete]
+    A2[complete-with-transfer]
+  end
+  subgraph rez [rezervation]
+    R1[validating]
+    R2[appointment-form]
+    R3[active]
+    R4[in-meet]
+  end
+  subgraph transfer [rezervation-transfer]
+    T1[awaiting-assignment]
+  end
+  subgraph notify [notification-sender]
+    N1[pending to complete]
+  end
+  subgraph room [chat-room]
+    C1[permanent or reservation room]
+  end
+  R1 --> R2 --> R3
+  R3 --> N1
+  R3 --> absence
+  R3 --> R4
+  R4 --> room
+  A1 -->|start-transfer personal-leave| transfer
+  startChat[start-chat] --> room
+  resStart[rezervation-start] --> room
+  resStart --> R4
+```
+
+---
+
+## 2. absence-entry
+
+**Dosya:** [Workflows/absence-entry.json](../Workflows/absence-entry.json)
+
+### Amaç
+
+- Kişisel izin, müşteri toplantısı vb. **yokluk** kayıtları.
+- **Resmi tatil** (`public-holiday`).
+- **Şirket çalışma saatleri** ve **danışmana özel çalışma saati** (`working-hours-change` — advisor’lı veya şirket geneli).
+
+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)).
+- Koşullar sağlanırsa `start-transfer-from-absence-entry` görevi **`rezervation-transfer`** alt akışını başlatır (`StartTransferFromAbsenceEntryMapping`).
+  - `endDateTime` **dolu** ise transfer tipi **yıllık izin** (`annual-leave`).
+  - `endDateTime` **boş** ise **işten çıkış / termination** (`termination`).
+  - Instance verisinde **`advisor`**, **`advisorType`**, **`startDateTime`** zorunludur; aksi halde transfer görevi atlanır (`skipped` + reason).
+
+Son durum: `complete-with-transfer` (transfer başlatıldı).
+
+---
+
+## 3. rezervation-transfer
+
+**Dosya:** [Workflows/rezervation-transfer.json](../Workflows/rezervation-transfer.json)
+
+### Amaç
+
+Kaynak danışmanın belirli tarih aralığındaki randevularını, uygun hedef danışmanlara aktarmak; kalıcı sohbet odalarında gerekli Matrix işlemlerini (transfer / update planına göre) yürütmek.
+
+### Başlangıç görevleri (özet)
+
+1. **Transfer tipi:** `endDate` yoksa `termination` ve varsayılan uzun uç tarih; varsa `annual-leave`.
+2. **Kaynak rezervasyonlar:** `get-rezervations` benzeri sorgu (`FetchRezervationsForTransferMapping`).
+3. **Danışman listesi:** Aktif instance’lar, `advisorType` / kaynak id ile workflow anahtarı çözümü (`FetchAdvisorsForTransferMapping`).
+4. **Absence kayıtları:** Tamamlanmış `public-holiday`, `working-hours-change`, `personal-leave` (`FetchAbsenceEntriesForTransferMapping`).
+5. **Zenginleştirme:** Tüm aktif randevular + slot uygunluğu (tatil, çalışma saati, kişisel izin, çakışma) — `EnrichRezervationsForTransferMapping`.
+
+### Önemli kontroller
+
+- **`confirm-transfer`:** `validate-transfer-availability` — hedef danışmanın ilgili rezervasyon zamanında başka **active / in-meet** çakışması var mı diye kontrol edilir; `validationResult.allValid` / `details` üretilir.
+- **`transferPlan`:** Postman’da örnek: her satırda `rezervationKey` + `targetAdvisor` ([postman_collection.json](../../postman_collection.json) — “Confirm Transfer”).
+- Kalıcı odalar için **`permanentRoomPlan`** (oda `roomId` + `newAdvisorId`) ile devam eden adımlar koleksiyon açıklamasında anlatılır.
+
+---
+
+## 4. rezervation
+
+**Dosya:** [Workflows/rezervation.json](../Workflows/rezervation.json)
+
+### Durum özeti (ana hat)
+
+`validating` → `appointment-form` veya `slot-unavailable` → `active` → `in-meet` → `meet-completed`  
+İptaller: `user-cancelled`, `advisor-cancelled`, `timeout` vb.
+
+### Kontroller
+
+| Konu | Kaynak | Açıklama |
+|------|--------|----------|
+| En fazla 2 rezervasyon | `check-duplicate-rezervation` | Aynı kullanıcı için belirli onaylı durumlarda en fazla **2** aktif rezervasyon; **zaman çakışması** yok. |
+| Slot uygunluğu | `validate-slot-for-rezervation` | `get-available-slots` çıktısında seçilen aralık yoksa `slot-unavailable`; **`appointment-form-retry`** ile yeni tarih/saat gönderilip tekrar doğrulanır. |
+| Tarih | `validate-date-for-rezervation` | Geçmiş veya geçersiz tarih reddedilir. |
+| Kullanıcı | `set-user-from-headers-for-rezervation` | İstek **`sub`** header’ından kullanıcıyı instance’a yazar. |
+| Onay → active | `create-appointment` / onay zinciri | Önceki danışman bilgisi, kullanıcı bilgisi (`get-user-info-for-rezervation`), **`notification-sender`** başlatma, **`absence-entry`** (rezervasyon kaydı) oluşturma sırası workflow’ta tanımlıdır. |
+
+### Bildirim (randevu oluşunca)
+
+`notification-sender` alt akışı, rezervasyon onayı sırasında başlatılır. **Danışman** için SMS/push içeriği (özet):
+
+`Sayın " + (advisorName ?? "Danisman") + ", " + formattedDate + " tarihli randevunuz olusturulmustur."`
+
+**Müşteri** için farklı metin kullanılır (`SendSmsNotificationMapping` / `SendPushNotificationMapping` — [Workflows/src/SendSmsNotificationMapping.csx](../Workflows/src/SendSmsNotificationMapping.csx), [Workflows/src/SendPushNotificationMapping.csx](../Workflows/src/SendPushNotificationMapping.csx)). Kanal seçimi ve durum geçişleri için **notification-sender** bölümüne (bu dokümanda 5) bakın.
+
+### Paylaşımlı geçişler
+
+- **`user-cancel` / `advisor-cancel` (active):** İlgili **`absence-entry`** üzerinde `cancel` tetiklenir; danışman iptalinde ek olarak **iptal bildirimi** gönderilir.
+- **`add-invited-participant`**, **`video-call-url-update`:** Davetli listesi ve video URL listesi birleştirme.
+
+---
+
+## 5. notification-sender
+
+**Dosya:** [Workflows/notification-sender.json](../Workflows/notification-sender.json)
+
+Alt süreç (subflow): randevu onayı ve diğer tetikleyicilerden senkron başlatılır. **MessagingGateway** üzerinden SMS (`/Messaging/sms/message/string`) ve push (`/Messaging/push-notification/message`) çağrıları mapping’lerde `MessagingBaseUrl` secret’ına göre kurulur.
+
+### Durumlar ve otomatik geçişler
+
+| Kaynak | Geçiş | Hedef | Koşul (özet) |
+|--------|--------|-------|----------------|
+| `pending` | `to-sms-sending` | `sms-sending` | `channels.sms == true` |
+| `pending` | `to-push-sending-from-pending` | `push-sending` | SMS istenmiyor, `channels.push == true`, `hasRegisteredDevice == true` |
+| `pending` | `to-complete-from-pending` | `complete` | Uygulanabilir kanal yok (push istenmiş ama cihaz yok, veya hiç kanal yok) |
+| `sms-sending` | (onEntry) | — | `send-sms-notification` görevi; `recipient.phone` (countryCode, prefix, number) zorunlu |
+| `sms-sending` | `to-push-sending-from-sms` | `push-sending` | `channels.push == true` ve `hasRegisteredDevice == true` |
+| `sms-sending` | `to-complete-from-sms` | `complete` | Push istenmiyor veya kayıtlı cihaz yok |
+| `push-sending` | (onEntry) | — | `send-push-notification`; `recipient` içinde `citizenshipNo` / `customerNo` kullanımı |
+| `push-sending` | `to-complete-from-push` | `complete` | Push sonrası her zaman |
+
+**İçerik:** `userType == "advisor"` için danışman SMS/push metni; `user` için müşteri metni (mapping özetleri yukarıdaki CSX dosyalarında).
+
+Postman: klasör **Notification Sender Subprocess** — SMS only, push only, kanal yok, cihaz yok senaryoları.
+
+---
+
+## 6. rezervation-start
+
+**Dosya:** [Workflows/rezervation-start.json](../Workflows/rezervation-start.json)
+
+Hem müşteri hem danışman görüşmeyi başlatabilir; **ilk başlatan** rezervasyon odasını oluşturma yoluna girer, diğer taraf **join** eder.
+
+### Zorunlu / kontroller
+
+- **`randevuKey`** zorunlu; state ve data DAPR üzerinden okunur (`GetRezervationStateMapping`, `GetRezervationDataMapping`).
+- **Davetli:** `participantType == "invited"` ve `invitedUserId`, rezervasyondaki `invitedUser` listesinde değilse → **`not-allowed`**.
+- Rezervasyon state **`active`** veya **`in-meet`** değilse → **`meet-not-active`**.
+- **Zaman penceresi (`check-randevu-time`):** Randevu başlangıcına en fazla **15 dakika** kala başlatılabilir (script’te saat dilimi `UtcNow + 3` ile karşılaştırma); aksi halde `MEET_NOT_STARTED` benzeri hata.
+- **Davetli ve henüz in-meet değilse:** `meet-not-started` dalı.
+
+### Oda ve in-meet
+
+- State **`active`** ise: **`create-room-and-trigger`** — senkron **`chat-room`** başlatılır (`roomType: rezervation`), oda verisi alınır, ana **`rezervation`** üzerinde **`to-in-meet`** tetiklenir.
+- State zaten **`in-meet`** ise: **`join-room`** — Matrix `join`, `x-matrix-user` katılımcı tipine göre (user / advisor / invited).
+
+### Bitiş
+
+`end` state’inde **`start-video-call`** alt akışı (LiveKit vb.) çalışır.
+
+---
+
+## 7. chat-room
+
+**Dosya:** [Workflows/chat-room.json](../Workflows/chat-room.json)
+
+### Amaç
+
+- **Kalıcı oda** (`roomType: permanent`): kullanıcı + danışman tipi + danışman ile tekilleştirilmiş Matrix odası.
+- **Randevu odası** (`roomType: rezervation`): rezervasyon anahtarı ile ilişkili geçici süreç odası.
+
+### Davranış özeti
+
+- Oluşturma: Matrix `createRoom`, davet, `join-user-to-room`.
+- **`activated`:** üye ekleme (`update`), üye çıkarma (`remove`), danışman **`transfer`** (kick + invite + join).
+- **`deactivate` / `activate`** durumları.
+- Kalıcı oda için aynı **user + advisorType + activated** ile ikinci oda oluşturma engeli (`ALREADY_COMPLETED`).
+
+### Domain fonksiyonları (workflow üzerinden)
+
+`get-chat-rooms`, `get-room-messages`, `send-room-message`, `get-matrix-sync` ([chat-room.json](../Workflows/chat-room.json) `attributes.functions`).
+
+---
+
+## 8. start-chat
+
+**Dosya:** [Workflows/start-chat.json](../Workflows/start-chat.json)
+
+### Amaç
+
+Kalıcı danışman sohbetini açmak: oda yoksa oluştur, varsa doğrudan sohbete geç.
+
+### Akış
+
+1. **`check-existing-permanent-chat-room`:** Kullanıcının aynı `advisorType` için kalıcı odası var mı; `advisorId` eşleşmesi ayrı bayrakta tutulur.
+2. **Mevcut oda + aynı danışman** → **`in-chat`** (`open-existing-room`).
+3. **Mevcut oda + farklı danışman** → **`to-change-advisor`:** `chat-room` üzerinde **`transfer`** tetiklenir, sonra **`in-chat`**.
+4. **Oda yok** → **`start-permanent-chat-room`** ile **`chat-room`** senkron başlatılır, sonra **`in-chat`**.
+
+---
+
+## 9. add-participant-to-rezervation
+
+**Dosya:** [Workflows/add-participant-to-rezervation.json](../Workflows/add-participant-to-rezervation.json)
+
+### Önkoşul
+
+Rezervasyon state **`active`** veya **`in-meet`**; aksi halde **`state-not-valid`**.
+
+### Dallar
+
+- **`in-meet`:** `chat-room` üzerinde **update** (yeni üye) + `rezervation` üzerinde **`add-invited-participant`** tetikleri + **`start-video-call`** alt akışı (davetli müşteri gibi).
+- **`active`:** **`update-invited`** → **`end`** (davetli güncelleme).
+
+`newUserId` / `randevuKey` görev mapping’lerinde zorunludur.
+
+---
+
+## 10. Domain fonksiyonları (özet)
+
+| Fonksiyon | Dosya | Amaç / not |
+|-----------|--------|------------|
+| `check-livekit-room-access` | [Functions/check-livekit-room-access.1.0.0.json](../Functions/check-livekit-room-access.1.0.0.json) | Query `access_token` (JWT veya `prefix:roomName:participantName`). Tek eşleşen **active/in-meet** rezervasyonda katılımcı doğrulaması; çoklu eşleşmede hata. |
+| `get-absence-entry` | [Functions/get-absence-entry.1.0.0.json](../Functions/get-absence-entry.1.0.0.json) | Zorunlu `absenceType`: `public-holiday`, `personal-leave`, `working-hours-change`, `rezervation`. Opsiyonel `advisor`, `startDate`, `endDate`, `pageSize`. |
+| `get-advisor-stats` | [Functions/get-advisor-stats.1.0.0.json](../Functions/get-advisor-stats.1.0.0.json) | Danışman presence (Matrix: online, offline, busy, away). |
+| `get-available-slots` | [Functions/get-available-slots.1.0.0.json](../Functions/get-available-slots.1.0.0.json) | `advisorId`, `date`, isteğe bağlı `duration` (dakika). |
+| `get-chat-rooms` | [Functions/get-chat-rooms.1.0.0.json](../Functions/get-chat-rooms.1.0.0.json) | **`user` VEYA `advisor`** (birbirini dışlar). |
+| `get-customer-info` | [Functions/get-customer-info.1.0.0.json](../Functions/get-customer-info.1.0.0.json) | Müşteri bilgisi. |
+| `get-matrix-sync` | [Functions/get-matrix-sync.1.0.0.json](../Functions/get-matrix-sync.1.0.0.json) | Matrix sync yanıtı. |
+| `get-rezervations` | [Functions/get-rezervations.1.0.0.json](../Functions/get-rezervations.1.0.0.json) | Filtreli rezervasyon listesi. |
+| `get-room-messages` | [Functions/get-room-messages.1.0.0.json](../Functions/get-room-messages.1.0.0.json) | Oda mesajları. |
+| `send-room-message` | [Functions/send-room-message.1.0.0.json](../Functions/send-room-message.1.0.0.json) | Matrix’e mesaj gönderimi. |
+
+Detaylı HTTP örnekleri için [Functions/get-room-messages.http](../Functions/get-room-messages.http) dosyasına bakılabilir.
+
+---
+
+## 11. Postman koleksiyonu
+
+**Dosya:** [postman_collection.json](../../postman_collection.json) (workspace kökü)  
+**Koleksiyon adı:** vNext Touch Domain
+
+### Ortak değişkenler (varsayılanlar)
+
+| Değişken | Örnek değer |
+|----------|-------------|
+| `baseUrl` | `http://localhost:4201` |
+| `apiVersion` | `1` |
+| `domain` | `morph-touch` |
+| `instanceKey` / `user` | `core.user.user-001` |
+| `advisor` / `advisorId` | `morph-touch.portfolio-manager.pm-001` |
+
+### Workflow API şablonları
+
+- **Instance başlat:**  
+  `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 {{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 {{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)
+
+| Klasör / istek | Metod | Not |
+|----------------|-------|-----|
+| **Reservation Workflow → Start Rezervation** | POST | `sub` header; body’de `user`, `advisor`, `startDateTime`, `endDateTime`. |
+| **Confirm Selection** | PATCH | `transitions/confirm-selection` — slot doğrulama adımı. |
+| **Appointment Form Retry** | PATCH | `appointment-form-retry` + yeni `startDateTime` / `endDateTime`. |
+| **Create Appointment** | PATCH | `create-appointment` → `active`. |
+| **Rezervation Start Workflow** | POST | `randevuKey`, `participantType` (advisor / customer / invited). |
+| **Chat Room Workflow** | POST / PATCH | Kalıcı PM/IA başlatma; `update`, `remove`, `transfer`. |
+| **Start Chat Workflow** | POST | Kalıcı oda yoksa oluşturur, varsa `in-chat`. |
+| **Rezervation Transfer** | POST + PATCH | `startDate`/`endDate`; `confirm-transfer` ile `transferPlan`. |
+| **Get Absence Entry Function** | GET | `.../functions/get-absence-entry?absenceType=...` |
+| **Get Available Slots** | GET | `advisorId`, `date`, `duration`. |
+| **Get Chat Rooms** | GET | `user=...` veya `advisor=...` |
+| **Matrix Synapse API** | çeşitli | `http://localhost:9080/...` — presence, createRoom (manuel test). |
+| **Notification Sender Subprocess** | POST | `workflows/notification-sender/instances/start` — kanal bayrakları ve recipient yapısı örnekleri. |
+
+Koleksiyon içi açıklamalar: instance filtreleme ve görev tipleri için [vNext dokümantasyonu](https://github.com/burgan-tech/vnext-runtime/tree/main/doc/en) referans verilir.
+
+---
+
+## 12. Ek kontroller ve kenar durumları
+
+- **Rezervasyon iptali:** `absence-entry` iptali tetiklenir; eski instance’larda `absenceEntryKey` yoksa cancel no-op olabilir.
+- **Çoklu davetli / video URL:** `merge-invited-user`, `merge-video-call-urls` ile liste birleştirme.
+- **check-livekit-room-access:** Token formatı JWT veya `room:participant`; birden fazla eşleşmede anlamlı olmayan sonuç döner.
+- **notification-sender:** SMS için telefon yapısı zorunlu; push için `citizenshipNo` / `customerNo` ve kayıtlı cihaz bayrağı.
+- **chat-room:** Matrix `M_ROOM_IN_USE`; history visibility için izin verilen değerler (`shared`, `invited`, `joined`, `world_readable`) mapping’de sınırlı.
+
+---
+
+## 13. İlgili kaynak dosyalar
+
+- Workflow JSON: [Workflows/](../Workflows/)
+- C# mapping’ler: [Workflows/src/](../Workflows/src/)
+- Fonksiyon tanımları: [Functions/](../Functions/)
+- Proje kuralları: [.cursorrules](../../.cursorrules)
+
+---
+
+## 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>`:** Erişim jetonu **ortama göre** verilir (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 alın; ö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.*