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

package/morph-touch/Functions/src/GetRezervationsMapping.csx

@@ -23,14 +23,34 @@ public class GetRezervationsMapping : ScriptBase, IMapping
         var appId = GetConfigValue("DAPR_APP_ID");
         if (!string.IsNullOrEmpty(appId))
             serviceTask.SetAppId(appId);
+        var headers = (Dictionary<string, string>)context.Headers;
+        var advisorId = string.Empty;
+        var userId = string.Empty;
+        var managerId = string.Empty;
+        var touchUser = headers.ContainsKey("touchUser") ? headers["touchUser"] : string.Empty;
+        var userType = headers.ContainsKey("userType") ? headers["userType"] : string.Empty;
+        if (string.IsNullOrWhiteSpace(touchUser) || string.IsNullOrWhiteSpace(userType))
+            throw new InvalidOperationException("Headers 'touchUser' and 'userType' are both required.");
+
+        if (string.Equals(userType, "customer", StringComparison.OrdinalIgnoreCase))
+            userId = touchUser;
+        else if (string.Equals(userType, "manager", StringComparison.OrdinalIgnoreCase))
+            managerId = touchUser;
+        else if (string.Equals(userType, "advisor", StringComparison.OrdinalIgnoreCase))
+            advisorId = touchUser;
+        else if (string.Equals(userType, "admin", StringComparison.OrdinalIgnoreCase))
+        {
 
-        // Read parameters from query string (GET request)
-        var advisorId = context.QueryParameters != null && HasProperty(context.QueryParameters, "advisorId") ? context.QueryParameters?["advisorId"]?.ToString() : string.Empty;
-        var userId = context.QueryParameters != null && HasProperty(context.QueryParameters, "userId") ? context.QueryParameters?["userId"]?.ToString() : string.Empty;
-        var managerId = context.QueryParameters != null && HasProperty(context.QueryParameters, "managerId") ? context.QueryParameters?["managerId"]?.ToString() : string.Empty;
-        var startDate = context.QueryParameters != null && HasProperty(context.QueryParameters, "startDate") ? context.QueryParameters?["startDate"]?.ToString() : string.Empty;
-        var endDate = context.QueryParameters != null && HasProperty(context.QueryParameters, "endDate") ? context.QueryParameters?["endDate"]?.ToString() : string.Empty;
-
+        }
+        else
+        {
+             throw new InvalidOperationException("Invalid user type: " + userType);
+        }
+            // admin: touchUser is always sent; no user/manager/advisor scope filter on the query
+            ;
+        // admin: touchUser is always sent; no user/manager/advisor scope filter on the query
+        var startDate =headers.ContainsKey("startDate")? headers["startDate"] : string.Empty;
+        var endDate =headers.ContainsKey("endDate")? headers["endDate"] : string.Empty;
         // Build filter conditions
         var conditions = new List<string>();
 

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

@@ -1,6 +1,6 @@
 # Morph-touch domain — technical overview
 
-This document summarizes appointment (rezervation), absence, chat room, notification, and transfer flows in the `morph-touch` domain, based on workflow definitions and task mapping behaviour. API examples align with the [postman_collection.json](../../postman_collection.json) collection.
+This document summarizes appointment (rezervation), absence, chat room, notification, and transfer flows in the `morph-touch` domain, based on workflow definitions and task mapping behaviour. HTTP examples use the **`{{BaseUrl}}/morph-touch/...`** template; the [postman_collection.json](../../postman_collection.json) collection may still use variables such as `api/v{{apiVersion}}` — align `baseUrl` and path prefixes with your gateway.
 
 Turkish version: [morph-touch-domain.md](morph-touch-domain.md).
 
@@ -9,7 +9,7 @@ Turkish version: [morph-touch-domain.md](morph-touch-domain.md).
 ## 1. Overview and terminology
 
 - **Domain:** `morph-touch`
-- **Workflow instance:** vNext instance model with `key`, `flow` (`sys-flows`), `domain`, and `version`; started over HTTP at `.../workflows/{flowKey}/instances/...`, transitions at `.../transitions/{transitionKey}`.
+- **Workflow instance:** vNext instance model with `key`, `flow` (`sys-flows`), `domain`, and `version`; started over HTTP at `.../workflows/{flowKey}/instances/...`, transitions at `.../transitions/{transitionKey}`. After `instances/`, the path may use the platform **instance id** (UUID) or the instance **`key`** from the `start` request.
 - **Integrations:**
   - **DAPR / application API:** `api/v{version}/{domain}/...` (paths such as `functions/state`, `functions/data` in mappings).
   - **Matrix:** `MatrixBaseUrl` (secret); room creation, join, invite, kick, history visibility.
@@ -63,6 +63,8 @@ flowchart LR
 
 Records are usually kept in `complete`; updated via `update`, moved to `cancelled` via `cancel`.
 
+For detailed request bodies, key rules, and cURL examples, see **section 14**.
+
 ### Link to appointment transfer
 
 - Transition **`start-transfer`** is evaluated only when `absenceType == "personal-leave"` (`CanStartTransferMapping` — [Workflows/src/CanStartTransferMapping.csx](../Workflows/src/CanStartTransferMapping.csx)).
@@ -276,13 +278,14 @@ See [Functions/get-room-messages.http](../Functions/get-room-messages.http) for
 ### Workflow API templates
 
 - **Start instance:**  
-  `POST {{baseUrl}}/api/v{{apiVersion}}/{{domain}}/workflows/{flowKey}/instances/start?sync=true`  
+  `POST {{baseUrl}}/morph-touch/workflows/{flowKey}/instances/start?sync=true`  
   Examples: `rezervation`, `absence-entry`, `rezervation-start`, `chat-room`, `start-chat`, `rezervation-transfer`, `notification-sender` (subflow).
 - **Get instance:**  
-  `GET .../workflows/{flowKey}/instances/{{instanceId}}`
+  `GET {{baseUrl}}/morph-touch/workflows/{flowKey}/instances/{{instanceIdOrKey}}`  
+  Path segment: platform **instance `id`** (UUID) or the instance **`key`** from the `start` request (e.g. `working-hour`, `rez-...`).
 - **Transition:**  
-  `PATCH .../workflows/{flowKey}/instances/{{instanceId}}/transitions/{transitionKey}?sync=true`  
-  Body is usually `{ "attributes": { ... } }`.
+  `PATCH {{baseUrl}}/morph-touch/workflows/{flowKey}/instances/{{instanceIdOrKey}}/transitions/{transitionKey}?sync=true`  
+  Same: **id** or **`key`**. Body is usually `{ "attributes": { ... } }`.
 
 ### Sample requests (collection folders)
 
@@ -325,4 +328,415 @@ Collection descriptions reference [vNext documentation](https://github.com/burga
 
 ---
 
+## 14. API usage guide (cURL and field rules)
+
+### 14.1 Prerequisite order
+
+For appointments and **get-available-slots**, define **company working hours** first (`absenceType: working-hours-change`, instance `key: "working-hour"`, tags `working-hours-change` + `company`). Then use public holidays, advisor leave / custom hours, and the reservation flow.
+
+### 14.2 `{{BaseUrl}}`, path template, and authentication
+
+- In all examples, **`{{BaseUrl}}`** is your API gateway **root** (e.g. `https://<host>` or `https://<host>/ebanking` depending on deployment). Set it per APISIX / environment docs; avoid a trailing slash on the root or you may get **double slashes** (`//morph-touch`) when concatenating.
+- Standard template: **`{{BaseUrl}}/morph-touch/workflows/...`** and **`{{BaseUrl}}/morph-touch/functions/...`** (e.g. `{{BaseUrl}}/morph-touch/workflows/absence-entry/instances/start?sync=true`).
+- This matches the role of Postman’s `{{baseUrl}}`; this doc uses the name **`{{BaseUrl}}`**.
+- **`Authorization: Bearer <access_token>`:** The access token is **environment-specific** (dev, test, production). Obtain it from your identity provider or whatever process your environment documents (APISIX, API portal, security team). `<access_token>` in examples is only a placeholder; never commit real tokens to the repo or shared docs.
+- In `.../workflows/{flowKey}/instances/<segment>/...`, `<segment>` is **`{{instanceIdOrKey}}`**: either the platform **instance id** or the instance **`key`**.
+
+### 14.3 Company working hours — `absence-entry` start (once)
+
+`key` must be **`working-hour`**. `absenceType` is **`working-hours-change`**. Under `customWorkingHours`, weekdays (`monday` … `sunday`) are arrays of `{ "start": "HH:mm", "end": "HH:mm" }`.
+
+```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": "Company working hours",
+    "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 Company working hours — later updates (`update`)
+
+Usually **one** `start` for company-wide record; afterwards use only **`PATCH .../transitions/update`**. In the URL, **`{{instanceIdOrKey}}`** may be the **platform instance id** (UUID) from the response or the fixed company **`key`** (`working-hour`).
+
+```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": "Company working hours (updated)",
+    "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 Public holiday (`public-holiday`)
+
+Key pattern: `public-holiday-{date}`. `absenceType` **`public-holiday`**. Set `startDateTime` / `endDateTime` for full or half day.
+
+```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": "National Sovereignty and Children's Day"
+  }
+}'
+```
+
+### 14.6 Personal leave (`personal-leave`)
+
+Key pattern: `personal-leave-{advisorId}-{startDateTime}-{endDateTime}`. `absenceType` **`personal-leave`**. `advisor` is the advisor unique id (often employee id). `advisorType` may be short (**`PM` / `IA`**) or full workflow values (**`portfolio-manager` / `investment-advisor`**) per your contract.
+
+```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: <user_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": "Customer meeting"
+  }
+}'
+```
+
+### 14.7 Advisor-specific working hours (`working-hours-change` + advisor)
+
+Key pattern: `working-hour-{advisorId}`. Tags: `working-hours-change`, `advisor`. `advisor` required; `customWorkingHours` same shape as §14.3.
+
+```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": "Advisor custom hours",
+    "customWorkingHours": {
+      "monday": [{"start": "10:00", "end": "12:00"}, {"start": "13:00", "end": "19:00"}],
+      "tuesday": [],
+      "wednesday": [],
+      "thursday": [],
+      "friday": [],
+      "saturday": [],
+      "sunday": []
+    }
+  }
+}'
+```
+
+### 14.8 Cancel — `cancel` transition
+
+```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 Absence update — `update` (example: leave times)
+
+```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": "Customer meeting (updated)"
+  }
+}'
+```
+
+### 14.10 `get-absence-entry` function
+
+Required `absenceType`. Company-only: `working-hours-change` alone. Date range for public holidays; `advisor` for advisor working hours.
+
+```bash
+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>'
+
+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>'
+
+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`
+
+Returns free slots for `advisorId` on `date`; optional `duration` (minutes).
+
+```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>'
+```
+
+Example body:
+
+```json
+{
+  "getAvailableSlots": {
+    "availableSlots": [
+      "09:00-09:30",
+      "09:30-10:00",
+      "10:00-10:30"
+    ]
+  }
+}
+```
+
+### 14.12 Reservation flow (`rezervation`)
+
+1. **`start`:** `key` must be unique per reservation; reuse as `randevuKey`. Align `startDateTime` / `endDateTime` with slots. Send **`sub`** (customer identity).
+2. Past date or duplicate active reservation rules may reject creation (see §4 / §12).
+3. If state is **`slot-unavailable`**, call **`appointment-form-retry`** with new times.
+4. After **`appointment-form`**, **`confirm-selection`** confirms user input.
+5. **`create-appointment`** moves to **`active`**; notifications and `get-user-info-for-rezervation` run; SMS to registered phone.
+
+In the transition URLs below, use either the **platform instance id** or the reservation **`key`** from `start` (e.g. `rez-<unique-suffix>`) as `{{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 Start meeting (`rezervation-start`)
+
+Callable up to **15 minutes** before start; earlier yields **`meet-not-started`**. `randevuKey` is the reservation `key`. `participantType`: `customer`, `advisor`, or `invited`. For **`invited`**, send **`invitedUserId`** and add the user via **add-participant-to-rezervation** first. First participant creates the Matrix room and moves reservation to **`in-meet`**; second joins.
+
+```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"
+  }
+}'
+```
+
+For invited: set `participantType: "invited"` and `invitedUserId: "<inviteeId>"`.
+
+### 14.14 Add participant (`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": "<inviteeEmployeeId>"
+  }
+}'
+```
+
+Suggested `key` pattern: `add-participant-{advisorId}-{randevuKey}`.
+
+### 14.15 Active reservation update (`rezervation-update`)
+
+`randevuKey` is the reservation `key`. Send `startDateTime`, `endDateTime`, and/or `advisor` as needed. With **`autoProcess: true`** the flow may auto-validate; with **`false`**, after `start` send updates via **`PATCH .../transitions/to-validate`** ([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": "<newAdvisorRef>",
+    "autoProcess": true
+  }
+}'
+```
+
+### 14.16 Permanent chat — `start-chat`
+
+Creates room if missing; otherwise **`in-chat`**. `user` is the customer; `advisorType` **`PM`** or **`IA`**; `advisorId` unique advisor id.
+
+```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 Chat rooms and messages (domain functions)
+
+Canonical paths: **`GET {{BaseUrl}}/morph-touch/functions/get-chat-rooms`** and **`GET .../functions/get-room-messages`**. Some gateways may use a different prefix.
+
+**`get-chat-rooms`:** `user` **or** `advisor` (not both). Optional `roomType`: `permanent` or `rezervation`.
+
+**Note:** [GetChatRoomsMapping](../Functions/src/GetChatRoomsMapping.csx) may query instances with a fixed internal `pageSize=100`; a query `pageSize` parameter may not always apply.
+
+```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`:** Required `roomId`, `user`. Optional **`limit`** (default 50 in mapping); optional `from` for pagination.
+
+```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 Reservation list — `get-rezervations`
+
+Query: `advisorId`, `userId`, `startDate`, `endDate` — dates optional; filter a range when set.
+
+```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>'
+```
+
+---
+
 *This document is derived from code and workflow definitions; runtime URLs and auth may vary by environment.*

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>`:** 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.*

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@burgan-tech/morph-touch-runtime",
-  "version": "0.0.6",
+  "version": "0.0.7",
   "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.7",
   "description": "morph-touch Domain Definition Configuration",
   "domain": "morph-touch",
   "runtimeVersion": "0.0.41",