| Функция | Вызывается из | Момент |
|---|---|---|
| `createPendingDelegation` | `submitApproval` | сразу после создания `Approval` и сохранения файлов, до создания `ApprovalStep` |
| `activatePendingDelegation` | `processNextStepOrComplete` | в ветке финального `approved` (НЕ в ветке передачи следующему шагу) |
| `deactivatePendingDelegation` | `performActualRevoke` | между `UpdateApprovalDB` (статус → `revoked`) и `handleRevokeCancellationTask` |
| Функция | Назначение |
|---|---|
| `HandleMyTasks` | Список pending-задач текущего исполнителя (проверка роли через `IsExecutorDB`) |
| `sendTaskCard` | Карточка одной задачи: инициатор, тема, текст заявки, дата, текст задачи, прикреплённые именно к этой задаче файлы (`TaskID` совпадает), секция комментариев |
| `HandleCompleteTask` | Проверка `RequireFile` (если файл обязателен и не прикреплён — блокирует завершение, просит прикрепить), `Status → "completed"`, `CompletedAt = now`, `activateNextTask`, уведомление инициатору (включая текст самой задачи — 🩹 см. §22 последняя строка) |
| `activateNextTask` | Следующая задача этой же заявки с `StepOrder = завершённая.StepOrder + 1` и статусом `waiting` → переводит в `pending`, уведомляет её исполнителя |
| `handleRevokeCancellationTask` | Вызывается при отзыве заявки: отменяет pending/waiting `ApprovalStep`/`ApprovalAdditionalApprover`; по каждой задаче — если `completed` → `createReversalTask`, если `pending` → `askExecutorAboutChanges`, если `waiting` → просто `cancelled` с уведомлением |
| `createReversalTask` | Новая задача «Обратить изменения по заявке #N», тот же исполнитель, `Status = pending` сразу |
| `askExecutorAboutChanges` | Вопрос исполнителю Да/Нет «вносили ли уже изменения» через `BuildRevokeTaskConfirmation` |
| `HandleRevokeTaskNoChanges` / `HandleRevokeTaskHasChanges` | Обработка ответа: первое — просто `cancelled`; второе — создаёт reversal-задачу (§ выше) |
| `HandleExecutorAttachStart` | Начало сессии прикрепления файла к задаче (`state.AttachmentSession`) |
| \# | Кому | Когда | Откуда |
|---|---|---|---|
| 1 | Согласующему первой группы (или его делегату) | Заявка создана | `submitApproval` |
| 2 | Инициатору | Заявка отправлена (подтверждение) | `submitApproval` |
| 3 | Контролёрам категории | Заявка создана | `submitApproval` |
| 4 | Следующему согласующему (или делегату) | Предыдущий шаг одобрен, есть следующий | `processNextStepOrComplete` |
| 5 | Инициатору | Заявка полностью одобрена | `processNextStepOrComplete` |
| 6 | Директорам, подписанным на категорию | Заявка полностью одобрена | `processNextStepOrComplete` |
| 7 | Наблюдателям | Заявка полностью одобрена | `processNextStepOrComplete` |
| 8 | Инициатору, наблюдателям, директорам | Заявка отклонена | `handleDecision` (rejected-ветки) |
| 9 | Остальным согласующим той же any\_of-группы | Их участие больше не требуется | `handleDecision` |
| 10 | Исполнителю следующей задачи | Предыдущая задача выполнена | `activateNextTask` |
| 11 | Инициатору | Исполнитель завершил задачу (включая текст задачи) | `HandleCompleteTask` |
| 12 | Исполнителю | Заявка отозвана — просьба обратить/подтвердить изменения | `handleRevokeCancellationTask` |
| 13 | Инициатору, директорам, согласующим, наблюдателям | Заявка отозвана | `performActualRevoke` |
| Префикс/формат | Обработчик | Назначение |
|---|---|---|
| `appr:{topicCode}:{nodeKey}` | `HandleCallback` | Переход по дереву |
| `appr_back:{topicCode}` | `HandleBackCallback` | Кнопка «Назад» |
| `appr_decision:{approvalID}:1|0` | `handleDecision` (через диспетчер) | Одобрить/отклонить |
| `appr_approver_sel:{userID}` | `HandleApproverSelectionCallback` | Выбор согласующего вручную |
| `appr_approver_pg:{page}` | `HandleApproverSelectionPageCallback` | Пагинация списка согласующих |
| `appr_obs_toggle:{userID}` | `HandleObserverToggleCallback` | Toggle наблюдателя |
| `appr_obs_pg:{page}` | `HandleObserverPageCallback` | Пагинация наблюдателей |
| `appr_obs_confirm` | `HandleObserverConfirmCallback` | Подтверждение выбора наблюдателей |
| `appr_deleg_yes` / `appr_deleg_no` | `HandleDelegationChoiceCallback` | 🆕 Да/Нет делегирования |
| `appr_deleg_sel:{userID}` | `HandleDelegateSelectionCallback` | 🆕 Выбор делегата |
| `appr_deleg_pg:{page}` | `HandleDelegateSelectionPageCallback` | 🆕 Пагинация делегатов |
| `add_appr_to_approval:{approvalID}` | `HandleAddApproverFromApproval` | Добавление доп. согласующего (кнопка сейчас закомментирована) |
| `revoke_task_no_changes:{taskID}:{approvalID}` | `HandleRevokeTaskNoChanges` | Подтверждение отсутствия изменений при отзыве |
| `revoke_task_has_changes:{taskID}:{approvalID}` | `HandleRevokeTaskHasChanges` | Подтверждение наличия изменений |
| Ключ | Формат/TTL | Назначение |
|---|---|---|
| `approval_flow:{telegramID}` | JSON `ApprovalFlowState`, TTL 30 мин | Состояние диалога создания заявки |
| `approval_flow:version` | Произвольное значение, без TTL | Триггер перезагрузки `Registry` (опрос раз в 5 сек) |
| `appr_approve_comment_pending:{telegramID}` | `approvalID` строкой | Ожидание обязательного комментария к одобрению |
| (без точного имени) — `AddApproverFlowState`, `AttachmentSession`, comment-flow состояния | JSON, управляются через `StateManager` | Прочие второстепенные диалоговые состояния (§4.2) |