Резолв маршрута: поле PositionCode (HeadType) в ответе шага

Раньше по ответу резолва нельзя было отличить «руководителя направления» от
«директора Tansu» иначе как парсингом Position (реальной должности из
справочника api.tnsu.kz, свободный текст). PositionCode — это HeadType
самого шага (Chief/DirectionHead/DirectorTansu/ManagingDirectorTansu/
DepartmentHead), null для шагов с исполнителем по email/должности/роли.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

backend/Tnsu.ApprovalRoute.Application/TemplateRoutes/ResolveTemplateRouteDto.cs

@@ -13,6 +13,13 @@ namespace Tnsu.ApprovalRoute.Application.TemplateRoutes;
 /// <param name="AskOverdueReason">
 /// Спрашивать ли причину просрочки — так же с уже применённым наследованием.
 /// </param>
+/// <param name="PositionCode">
+/// HeadType шага (Chief/DirectionHead/DirectorTansu/ManagingDirectorTansu/DepartmentHead),
+/// если исполнитель задан типом руководителя, иначе null. В отличие от <see cref="Position"/>
+/// (реальная должность резолвнутого сотрудника из справочника api.tnsu.kz — свободный
+/// текст), это код роли из самого шага маршрута — чтобы вызывающая сторона могла отличить,
+/// например, «директора Tansu» от «руководителя направления», не разбирая Position текстом.
+/// </param>
 public sealed record ResolvedRouteStepDto(
     int Id,
     int OrderNo,
@@ -21,7 +28,8 @@ public sealed record ResolvedRouteStepDto(
     bool AllowReassignToOtherApprovers,
     string? Warning = null,
     int? SlaHours = null,
-    bool? AskOverdueReason = null);
+    bool? AskOverdueReason = null,
+    HeadType? PositionCode = null);
 
 public sealed record ResolveTemplateRouteResultDto(
     int RouteId,

backend/Tnsu.ApprovalRoute.Application/TemplateRoutes/TemplateRouteService.cs

@@ -340,7 +340,8 @@ public sealed class TemplateRouteService(
             step.AllowReassignToOtherApprovers,
             combinedWarning.Length == 0 ? null : combinedWarning,
             step.SlaHours ?? requestType.SlaHours,
-            step.AskOverdueReason ?? requestType.AskOverdueReason);
+            step.AskOverdueReason ?? requestType.AskOverdueReason,
+            step.HeadType is null or HeadType.None ? null : step.HeadType);
     }
 
     /// <summary>

backend/tests/Tnsu.ApprovalRoute.IntegrationTests/ApplicationServices/TemplateRouteServiceTests.cs

@@ -182,6 +182,8 @@ public sealed class TemplateRouteServiceTests : IClassFixture<PostgresDatabaseFi
         resolved.Value.RouteId.ShouldBe(route.Value.Id);
         resolved.Value.Steps.ShouldHaveSingleItem();
         resolved.Value.Steps[0].ExecutorEmail.ShouldBe("approver@tnsu.kz");
+        // Исполнитель задан email'ом, а не типом руководителя — PositionCode пуст.
+        resolved.Value.Steps[0].PositionCode.ShouldBeNull();
     }
 
     // SLA приезжает в резолв уже с применённым наследованием — это осознанное
@@ -704,6 +706,7 @@ public sealed class TemplateRouteServiceTests : IClassFixture<PostgresDatabaseFi
         resolved.IsSuccess.ShouldBeTrue();
         resolved.Value.Steps.ShouldHaveSingleItem();
         resolved.Value.Steps[0].ExecutorEmail.ShouldBe("chief@tnsu.kz");
+        resolved.Value.Steps[0].PositionCode.ShouldBe(HeadType.Chief);
     }
 
     [Fact(DisplayName = "Резолв шага с типом руководителя DirectorTansu подставляет захардкоженный email из настроек")]

frontend/src/webparts/approvalAdmin/models/resolve.ts

@@ -2,7 +2,7 @@
 // (Application/TemplateRoutes/ResolveTemplateRouteDto.cs).
 /* eslint-disable @rushstack/no-new-null -- поля 1:1 зеркалят nullable JSON-контракт бэкенда */
 
-import { RouteStepStatus } from './enums';
+import { HeadType, RouteStepStatus } from './enums';
 
 /** Значение поля списка SharePoint (field_name шага) для проверки условий шагов. */
 export interface ResolveFieldValue {
@@ -28,6 +28,12 @@ export interface ResolvedRouteStep {
   allowReassignToOtherApprovers: boolean;
   /** Причина, по которой исполнитель шага не определился (текст с бэкенда). */
   warning: string | null;
+  /**
+   * HeadType шага (Chief/DirectionHead/...), если исполнитель задан типом
+   * руководителя, иначе null. В отличие от position (реальная должность
+   * резолвнутого сотрудника из справочника) — это код роли из самого шага.
+   */
+  positionCode: HeadType | null;
 }
 
 export interface ResolveTemplateRouteResult {