From c709f99746bbd0773a66e031d5191ece77c109c5 Mon Sep 17 00:00:00 2001 From: Claude Date: Sat, 10 Oct 2026 20:36:46 +0000 Subject: [PATCH 1/3] docs(skills): point yemot-integration at v2 files, flag v1 as legacy Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01WhKqWQTBUpM1iambUHayry --- .github/skills/yemot-integration/SKILL.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/.github/skills/yemot-integration/SKILL.md b/.github/skills/yemot-integration/SKILL.md index 6727fd47..450fdf12 100644 --- a/.github/skills/yemot-integration/SKILL.md +++ b/.github/skills/yemot-integration/SKILL.md @@ -14,7 +14,8 @@ description: Use when working on Yemot (Israeli IVR phone) call flows in any NRA Shared code lives in `server/shared/utils/yemot/` (`nra-server`); each project subclasses it. - **v2 (current) — subclass `BaseYemotHandlerService`.** Each project defines `server/src/yemot-handler.service.ts` extending it and overriding `processCall()`. Inside, `this.call`, `this.user`, `this.logger` are available; branch on `hasPermission(this.user, '')` to route to the right flow. See `react-admin-nestjs/server/src/yemot-handler.service.ts`. -- The shared router/service (`v2/yemot-router.service.ts`, `yemot.service.ts`) owns call lifecycle: active-call map, step saving, hangup handling, `getUserByDidPhone()`. +- The shared router (`v2/yemot-router.service.ts`) and call tracker (`v2/yemot-call-tracking.service.ts`) own call lifecycle: active-call map, step saving, hangup handling, `getUserByDidPhone()`. +- **v1 (legacy, unused) — do not use.** `yemot.module.ts`, `yemot.service.ts`, `chain.interface.ts`, `yemot.util.ts`, `yemot.exception.ts` and the `YemotProcessor`/`YemotRequest`/`YemotResponse` classes in `yemot.interface.ts` are the old chain-based flow. No project wires them; only `FormatString` from `yemot.interface.ts` is still imported. New phone code goes through v2 only. - **Permissions:** phone flows are gated by permission keys (e.g. `seminarAttendanceYemot`, `yemotSimulator`). Adding/gating a flow → also use `manage-permissions`. ## Common tasks @@ -23,7 +24,7 @@ Shared code lives in `server/shared/utils/yemot/` (`nra-server`); each project s **Menu texts** live in DB (`YemotCall`/yemot-texts) and are updated via migrations — see the `UpdateYemotTexts*` migrations in `react-admin-nestjs/server/src/migrations/`. Use `generate-migration` for schema/text changes. -**File upload/download to Yemot:** paths must carry the `ivr2:` scheme prefix (a past bug shipped without it). `deleteFile`/`downloadFile` live in the shared yemot util — reuse them, mind the auth and path prefix. +**File upload/download to Yemot:** paths must carry the `ivr2:` scheme prefix (a past bug shipped without it). `uploadFile`/`downloadFile`/`deleteFile` live in `utils/phone/yemot-api.service.ts` — reuse them, mind the auth and path prefix. ## Test with the scenario harness (no live phone) From 359761627b2fdf2bfbcded3cbe72179cb476b6ab Mon Sep 17 00:00:00 2001 From: Claude Date: Sat, 10 Oct 2026 20:58:51 +0000 Subject: [PATCH 2/3] docs(skills): yemot-integration points at v2 only, v1 removed from nra-server Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01WhKqWQTBUpM1iambUHayry --- .github/skills/yemot-integration/SKILL.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/skills/yemot-integration/SKILL.md b/.github/skills/yemot-integration/SKILL.md index 450fdf12..517e16c1 100644 --- a/.github/skills/yemot-integration/SKILL.md +++ b/.github/skills/yemot-integration/SKILL.md @@ -15,7 +15,7 @@ Shared code lives in `server/shared/utils/yemot/` (`nra-server`); each project s - **v2 (current) — subclass `BaseYemotHandlerService`.** Each project defines `server/src/yemot-handler.service.ts` extending it and overriding `processCall()`. Inside, `this.call`, `this.user`, `this.logger` are available; branch on `hasPermission(this.user, '')` to route to the right flow. See `react-admin-nestjs/server/src/yemot-handler.service.ts`. - The shared router (`v2/yemot-router.service.ts`) and call tracker (`v2/yemot-call-tracking.service.ts`) own call lifecycle: active-call map, step saving, hangup handling, `getUserByDidPhone()`. -- **v1 (legacy, unused) — do not use.** `yemot.module.ts`, `yemot.service.ts`, `chain.interface.ts`, `yemot.util.ts`, `yemot.exception.ts` and the `YemotProcessor`/`YemotRequest`/`YemotResponse` classes in `yemot.interface.ts` are the old chain-based flow. No project wires them; only `FormatString` from `yemot.interface.ts` is still imported. New phone code goes through v2 only. +- **v1 (old chain-based `YemotModule`/`YemotService`/`Chain`) — removed from `nra-server`, do not reintroduce.** `yemot.interface.ts` now holds only `FormatString`. All phone code goes through v2. - **Permissions:** phone flows are gated by permission keys (e.g. `seminarAttendanceYemot`, `yemotSimulator`). Adding/gating a flow → also use `manage-permissions`. ## Common tasks From db612a027b88925a17e44f89082832ccb6a857eb Mon Sep 17 00:00:00 2001 From: Claude Date: Sun, 11 Oct 2026 20:39:41 +0000 Subject: [PATCH 3/3] chore: bump server/shared to nra-server main (v1 Yemot flow removed) Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01WhKqWQTBUpM1iambUHayry --- server/shared | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/server/shared b/server/shared index 946441b7..b4080577 160000 --- a/server/shared +++ b/server/shared @@ -1 +1 @@ -Subproject commit 946441b7e9aca0ea7f483428ef5108259dc49c71 +Subproject commit b4080577c729d15ec16ce8ca68dec5e7b18a5e16