12 Commits

Author SHA1 Message Date
gorbenko.pavel 22e37b6e36 feat: прежняя заявка на оплату открывается в панели справа, а не в новой вкладке
Tests / frontend-test (pull_request) Successful in 1m27s
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-28 10:17:53 +05:00
gorbenko.pavel f654db9bcf docs: заявка на оплату — прежние оплаты через approval-route
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-28 10:01:46 +05:00
gorbenko.pavel 5cfe54f33b feat: прежние оплаты по основанию берутся из approval-route, ссылка — только при правах
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-28 10:01:34 +05:00
gorbenko.pavel 0c0104f6c9 feat: прежние заявки на оплату по основанию открываются по ссылке, видно статус
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-28 09:45:54 +05:00
gorbenko.pavel f664b468a2 fix: черновик заявки на оплату перечитывает прежние оплаты по основанию
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-28 09:42:15 +05:00
gorbenko.pavel 2bf0ad1da7 feat: разряды в полях сумм заявки на оплату
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-28 09:14:17 +05:00
gorbenko.pavel 6460a2a22d fix: счёт на оплату кладётся в библиотеку под латинским именем (OCR терял расширение)
Tests / frontend-test (pull_request) Successful in 1m24s
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-27 14:49:25 +05:00
gorbenko.pavel edd5008120 fix: поля заявки на оплату занимают всю ширину секции
Тело CollapseSection из ui-kit уже сетка в две колонки, а поля были
завёрнуты ещё в один FormGrid и попадали в половину первой колонки.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-27 14:44:46 +05:00
gorbenko.pavel 5107f62e54 fix: таблицы заявки на оплату растягиваются на всю ширину секции
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-27 14:42:22 +05:00
gorbenko.pavel 780d92cd3d docs: заявка на оплату — списки, тип и маршрут заведены
Списки «Заявка на оплату 1 — данные / согласование» созданы провижинингом,
в approval-route заведены тип 24 (раздел «Бухгалтерия») и маршрут 25 с одним
шагом согласования на фиксированного человека.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-27 13:29:01 +05:00
gorbenko.pavel 023c0913f1 fix: заявка на оплату под реальный API справочников и OCR
Tests / frontend-test (pull_request) Successful in 1m32s
Сверено с api-tnsu-portal (DictionaryController, DocumentController):
- статьи ДДС — CashFlowItems?id=<группа> (было groupId, сервер отвечал 400);
- OCR — Document/extractPDFText, текст в file_content пишется до ответа,
  поэтому колонка читается сразу, без опроса;
- договоры и банковские счета — постраничные, поиск на сервере (search),
  иначе находились только первые 50 записей; фильтра по компании у
  договоров нет;
- счета по проекту с откатом на фильтр только по компании: совпадение Id
  проекта из /Project с bank_accounts.project_id не гарантировано;
- Id-фильтры передаются только в формате GUID, иначе API отвечает 400;
- подписи записей по реальным полям (account_number, bank, valuta,
  counterparty_name); разбор вынесен в oneCRecords.ts с тестами;
- код позиции потребности — lineNumber;
- пустой ответ Gemini (200 с error) считается ошибкой.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-27 12:35:53 +05:00
gorbenko.pavel e976b4e8d4 feat: форма «Заявка на оплату» (СТ/потребность, счёт через OCR и ИИ)
Tests / frontend-test (pull_request) Successful in 2m12s
Новая форма acc-payment-request в категории «Бухгалтерия»: основание —
согласованная СТ (сайт СТ) или потребность; из основания подставляются
получатель, раздел, вид работ, условия, общая сумма и позиции. Счёт (PDF)
сохраняется в библиотеку, уходит на OCR, ИИ достаёт реквизиты, суммы и позиции
и сверяет их с СТ. Подсвечиваются чужой получатель в счёте и превышение
общей суммы СТ всеми оплатами. Справочники 1С — общий DictionaryPicker.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-22 15:01:28 +05:00
233 changed files with 4273 additions and 8121 deletions
+1 -1
View File
@@ -1 +1 @@
@tnsu:registry=http://git.tnsu.kz/api/packages/Tansu/npm/
@tnsu:registry=http://git.tnsu.kz/api/packages/timur.gorodetskiy/npm/
+2 -2
View File
@@ -49,10 +49,10 @@
| [`clearance-form`](../src/webparts/requestPortal/forms/Clearance/README.md) | Обходной лист | Отдел кадров | да | нет | да | подаётся HR за увольняемого (People-picker) либо создаётся сам по согласованному «Заявлению на увольнение»; условие «IsManager» резолвится по должности из самой заявки; да/нет-поля (парковка, СКУД); 5 независимых сумм к списанию компактной сеткой (ОС, СИЗ, подотчётная сумма, НМА, ТМЦ — обучение не входит, у него своё поле) — вводит любой активный согласующий, блокируется навсегда после первого ввода; заполнил хоть одну — стандартный комментарий решения (в блоке «Ваше решение») становится обязательным на любое решение, не только возврат/отклонение | ✅ |
| [`hr-dismissal`](../src/webparts/requestPortal/forms/Dismissal/README.md) | Заявление на увольнение | Отдел кадров | да | нет | да | совместители — таблица компаний с удалением строки (снимает и согласующего из матрицы); должность/организация из справочника; **после согласования сам создаёт обходной лист**; печать заблокирована до согласования обходного листа; «Лицо, принимающее ОС/НМА» — заполняет только непосредственный руководитель | ✅ |
| [`hr-skud-explanation`](../src/webparts/requestPortal/forms/SkudExplanation/README.md) | Объяснительная об отсутствии отметок в СКУД | Отдел кадров | да | нет | да | только «на себя»; дни выбираются кликом в календаре «Мой СКУД» (проходы Hikvision текущего пользователя), сохраняются снимком для согласующего; текст записки собирается автоматически, печать — бланк объяснительной | ⏳ код готов, списки/тип/маршрут не заведены |
| [`hr-business-trip`](../src/webparts/requestPortal/forms/BusinessTrip/README.md) | Заявка на командировку | Отдел кадров | да | да | да | можно за другого сотрудника; командирующая организация — выбор из организаций сотрудника; маршрут лентой (точки по Казахстану — город из справочника КАТО на русском и казахском + объект из справочника, за рубежом — страна/город/объект вручную; даты не задним числом, поездка ≤ 40 дней; участки с видом транспорта и временем выезда); суточные (≤ 6 МРП КЗ / ≤ 8 за рубежом) и проживание (ночи сами, ≤ 15 000 ₸ за ночь КЗ) — по точкам; комментарий после итога; задание — список задач; смета: статьи с позициями, привязанными к точкам/участкам (суммой или кол-во × цена — всё вручную), итог с долями и по объектам; обязательство по авансовому отчёту — флажок; печать без шапки адресата | ⏳ код готов, списки/тип/маршрут не заведены |
| [`hr-business-trip`](../src/webparts/requestPortal/forms/BusinessTrip/README.md) | Заявка на командировку | Отдел кадров | да | да | да | можно за другого сотрудника; маршрут лентой (точки = город + объект из справочника + даты, участки с видом транспорта); задание — список задач; смета: статьи с позициями, привязанными к точкам/участкам (суммой или кол-во × цена — всё вручную), итог с долями и по объектам; обязательство по авансовому отчёту — флажок; печать без шапки адресата | ⏳ код готов, списки/тип/маршрут не заведены |
| `hr-transfer` | Перемещение сотрудников | Отдел кадров | — | — | — | — | ⏳ заглушка (плитка есть, форма не сделана) |
| [`hr-contract-change`](../src/webparts/requestPortal/forms/ContractChange/README.md) | Изменение условий трудового договора | Отдел кадров | да | — | да | сотрудник из `Employee/FullBase` (и без учётки M365), снимок в текстовых колонках; маршрут по сотруднику, без учётки — по заявителю; 10 видов изменения (один, данные под несколько), поля по каждому виду по ТЗ кадров (кроме «Продления срока ТД»); инициатор работник/работодатель; подписанные вложения по «Что приложить» | ⏳ код готов (кроме вида 6), списки/тип/маршрут не заведены |
| [`wh-service-request`](../src/webparts/requestPortal/forms/ServiceRequest/README.md) | Заявка на услуги | Склад / Снабжение | да | нет | да | маршрут по проекту (руководитель проекта/ПТО); табличные части «Приложения» и «Смета» (JSON-колонки); сумма по смете считается на лету (qty × цена), итог дублируется числовой колонкой для отчётов | ✅ |
| [`acc-payment-request`](../src/webparts/requestPortal/forms/PaymentRequest/README.md) | Заявка на оплату | Бухгалтерия | да | нет | да | основание — согласованная СТ (сайт СТ) или потребность; счёт PDF → библиотека → OCR → ИИ (реквизиты, суммы, позиции); сверка позиций счёта с СТ; подсветка чужого получателя и превышения общей суммы СТ; справочники 1С | ⏳ списки, библиотека, тип (id 24) и маршрут заведены; не проверена на живых данных |
Легенда: **Согл.** — есть фаза согласования; **Исп.** — есть фаза исполнения;
**Просмотр** — есть режим согласующего (`<Форма>View`).
+4 -4
View File
@@ -17,7 +17,7 @@
"@microsoft/sp-webpart-base": "1.22.1",
"@pnp/sp": "^4.20.0",
"@pnp/spfx-controls-react": "^3.25.0",
"@tnsu/ui-kit": "^0.14.0",
"@tnsu/ui-kit": "^0.12.0",
"jszip": "~3.8.0",
"react": "17.0.1",
"react-dom": "17.0.1",
@@ -9886,9 +9886,9 @@
"license": "0BSD"
},
"node_modules/@tnsu/ui-kit": {
"version": "0.14.0",
"resolved": "http://git.tnsu.kz/api/packages/Tansu/npm/%40tnsu%2Fui-kit/-/0.14.0/ui-kit-0.14.0.tgz",
"integrity": "sha512-Vun9AUM9jL8rttbsbKo5Yh6TUz1srkNqxiO6mmzebrSo1JOASNJqNjJPMTS+8Jt3MTrJPklvh0TbeqGQzw7qxQ==",
"version": "0.12.0",
"resolved": "http://git.tnsu.kz/api/packages/timur.gorodetskiy/npm/%40tnsu%2Fui-kit/-/0.12.0/ui-kit-0.12.0.tgz",
"integrity": "sha512-lJYf2DoYaydrktbSotRNY0umeJlQw8Ekhh6fu1FGB0p+/TXTozpBfAs+TxK/mvOXlS9yYenEuGBi85fd/dRF2A==",
"license": "ISC",
"peerDependencies": {
"@fluentui/react": "^8.106.4",
+1 -1
View File
@@ -21,7 +21,7 @@
"@microsoft/sp-webpart-base": "1.22.1",
"@pnp/sp": "^4.20.0",
"@pnp/spfx-controls-react": "^3.25.0",
"@tnsu/ui-kit": "^0.14.0",
"@tnsu/ui-kit": "^0.12.0",
"jszip": "~3.8.0",
"react": "17.0.1",
"react-dom": "17.0.1",
-68
View File
@@ -1,68 +0,0 @@
<#
.SYNOPSIS
Диагностика: печатает строки маршрута одной заявки из списка «— согласование»
(StepOrder, статус, фаза, кем переназначено, кто создал/менял) и историю версий
строк исполнения — чтобы понять, откуда в маршруте взялся участник и кто
перевёл его в «На исполнении». Только чтение, ничего не меняет.
.EXAMPLE
./Inspect-Route.ps1 -SiteUrl "https://tnsukz.sharepoint.com/sites/requests" `
-ClientId "7459c965-5ed4-4673-8140-0ab8faf9db64" -Tenant "tnsukz.onmicrosoft.com" `
-Thumbprint "224B64C8E0CAB1E09AF373E92B3AF4AC33C1233C" `
-ListTitle "Прием на работу 1 — согласование" -RequestId 68
#>
param(
[Parameter(Mandatory = $true)][string]$SiteUrl,
[Parameter(Mandatory = $true)][string]$ClientId,
[Parameter(Mandatory = $true)][string]$Tenant,
[Parameter(Mandatory = $true)][string]$Thumbprint,
[Parameter(Mandatory = $true)][string]$ListTitle,
[Parameter(Mandatory = $true)][int]$RequestId
)
$ErrorActionPreference = 'Stop'
Connect-PnPOnline -Url $SiteUrl -ClientId $ClientId -Tenant $Tenant -Thumbprint $Thumbprint
$query = "<View><Query><Where><Eq><FieldRef Name='Ticket' LookupId='TRUE'/><Value Type='Lookup'>$RequestId</Value></Eq></Where>" +
"<OrderBy><FieldRef Name='StepOrder'/></OrderBy></Query></View>"
$items = Get-PnPListItem -List $ListTitle -Query $query
function UserText($value) {
if ($null -eq $value) { return '' }
return $value.Email
}
Write-Host "`nМаршрут заявки #$RequestId («$ListTitle»):`n" -ForegroundColor Cyan
$items | ForEach-Object {
[pscustomobject]@{
Id = $_.Id
StepOrder = $_['StepOrder']
Phase = $_['Phase']
Status = $_['ApprovalStatus']
Approver = UserText $_['TansuSiteApprover']
DelegatedBy = UserText $_['DelegatedBy']
Reassign = $_['AllowReassignToOtherApprovers']
Created = $_['Created']
CreatedBy = UserText $_['Author']
Modified = $_['Modified']
ModifiedBy = UserText $_['Editor']
}
} | Format-Table -AutoSize
# История версий — только строки исполнения: там видно, кто и когда менял статус.
$items | Where-Object { $_['Phase'] -eq 'Исполнение' } | ForEach-Object {
Write-Host "`nВерсии строки Id=$($_.Id) ($(UserText $_['TansuSiteApprover'])):" -ForegroundColor Yellow
Get-PnPProperty -ClientObject $_ -Property Versions | Out-Null
$_.Versions | ForEach-Object {
Get-PnPProperty -ClientObject $_ -Property CreatedBy | Out-Null
[pscustomobject]@{
Version = $_.VersionLabel
Created = $_.Created
By = $_.CreatedBy.Email
Status = $_['ApprovalStatus']
StepOrder = $_['StepOrder']
}
} | Format-Table -AutoSize
}
Disconnect-PnPOnline
-99
View File
@@ -1,99 +0,0 @@
<#
.SYNOPSIS
Собирает справочник городов и посёлков РК для выпадающих списков портала из
официального КАТО (Бюро национальной статистики, stat.gov.kz) и пишет его
TS-модулем src/webparts/requestPortal/shared/dictionary/kato/katoCities.ts.
.DESCRIPTION
Берём только города («г.») и посёлки («п.»): ~180 записей, несколько KB в бандле.
Сёла (~10 тыс.) не берём — тяжело для фронта; их вводят вручную в то же поле.
Административные единицы («Г.А.», «п.а.», «г.а.» — администрации, не населённые
пункты) отбрасываются. КАТО обновляется редко: перезапустить скрипт со ссылкой
на свежий файл со страницы https://stat.gov.kz/ru/classifiers/statistical/21/
и закоммитить сгенерированный модуль.
.EXAMPLE
./scripts/Build-KatoCities.ps1
./scripts/Build-KatoCities.ps1 -XlsxUrl "https://stat.gov.kz/upload/iblock/.../КАТО_ДД.ММ.ГГГГ.xlsx"
#>
param(
[string]$XlsxUrl = 'https://stat.gov.kz/upload/iblock/a7d/eqogm92xc0udumlzfzffhcrutk0fjhb4/КАТО_18.09.2026.xlsx',
[string]$OutFile = (Join-Path $PSScriptRoot '..\src\webparts\requestPortal\shared\dictionary\kato\katoCities.ts')
)
$ErrorActionPreference = 'Stop'
$work = Join-Path ([System.IO.Path]::GetTempPath()) "kato-$([guid]::NewGuid())"
New-Item -ItemType Directory -Path $work | Out-Null
try {
# xlsx — это zip: читаем XML листа напрямую, без Excel и сторонних модулей.
$zip = Join-Path $work 'kato.zip'
Invoke-WebRequest -Uri $XlsxUrl -OutFile $zip -UseBasicParsing
Expand-Archive -Path $zip -DestinationPath $work
[xml]$sharedXml = Get-Content -Raw -Encoding UTF8 (Join-Path $work 'xl\sharedStrings.xml')
$shared = @($sharedXml.sst.si | ForEach-Object { $_.InnerText })
[xml]$sheetXml = Get-Content -Raw -Encoding UTF8 (Join-Path $work 'xl\worksheets\sheet1.xml')
# Колонки листа: A — код КАТО, B — код области (ab), C/D/E — нижние уровни, G/H — название на казахском/русском.
$rows = foreach ($row in $sheetXml.worksheet.sheetData.row) {
$cells = @{}
foreach ($c in $row.c) {
$column = $c.r -replace '\d', ''
$value = if ($c.t -eq 's') { $shared[[int]$c.v] } elseif ($c.t -eq 'inlineStr') { $c.is.InnerText } else { $c.v }
$cells[$column] = "$value".Trim()
}
[pscustomobject]@{ Kato = $cells['A']; Region = $cells['B']; Level2 = $cells['C']; Level3 = $cells['D']; Level4 = $cells['E']; Name = $cells['H']; NameKz = $cells['G'] }
}
# Области — строки без нижних уровней. Города республиканского значения (Астана,
# Алматы, Шымкент) сами себе «область» — для них регион не показываем.
$regions = @{}
$rows | Where-Object { $_.Level2 -eq '00' -and $_.Level3 -eq '00' -and $_.Level4 -eq '000' } | ForEach-Object {
$regions[$_.Region] = if ($_.Name -match '^г\.') { '' } else { $_.Name }
}
# «г.Атырау», «п. Асыката» — населённые пункты; «п.а.», «г.а.» — администрации.
$cities = $rows |
Where-Object { $_.Name -match '^(г|п)\.\s*[^\s.]' -and $_.Name -notmatch '^(г|п)\.а\.' } |
ForEach-Object {
[pscustomobject]@{
Kato = $_.Kato
Name = ($_.Name -replace '^(г|п)\.\s*', '')
# «Құлсары қ.» / «Шаған к.» — тип пункта последним словом с точкой (в источнике
# встречается и опечатка «ќ.»), поэтому отрезаем любое такое слово.
NameKz = ($_.NameKz -replace '\s+\S+\.$', '')
Kind = if ($_.Name -match '^г\.') { 'city' } else { 'settlement' }
Region = $regions[$_.Region]
}
} |
Sort-Object Name, Region
$esc = { param($s) $s -replace '\\', '\\' -replace "'", "\'" }
$lines = $cities | ForEach-Object {
" { kato: '$($_.Kato)', name: '$(& $esc $_.Name)', nameKz: '$(& $esc $_.NameKz)', kind: '$($_.Kind)', region: '$(& $esc $_.Region)' },"
}
$source = [System.Uri]::UnescapeDataString(($XlsxUrl -split '/')[-1])
$content = @"
// СГЕНЕРИРОВАНО scripts/Build-KatoCities.ps1 — руками не править, перезапустить скрипт.
// Источник: КАТО, Бюро национальной статистики РК (stat.gov.kz), файл «$source».
import { IKatoCity } from './IKatoCity';
export const KATO_CITIES: ReadonlyArray<IKatoCity> = [
$($lines -join "`n")
];
"@
$outPath = [System.IO.Path]::GetFullPath($OutFile)
New-Item -ItemType Directory -Force -Path (Split-Path $outPath) | Out-Null
# Без BOM и с LF — как остальные исходники репозитория.
[System.IO.File]::WriteAllText($outPath, $content.Replace("`r`n", "`n") + "`n", (New-Object System.Text.UTF8Encoding $false))
$cityCount = @($cities | Where-Object Kind -eq 'city').Count
Write-Host "Готово: $($cities.Count) записей (городов $cityCount, посёлков $($cities.Count - $cityCount)) → $OutFile"
}
finally {
Remove-Item -Recurse -Force $work
}
+6 -8
View File
@@ -42,14 +42,6 @@ export const REQUEST_TYPES: IRequestType[] = [
icon: 'people',
comingSoon: true
},
// Пока только тестировщикам: каркас без полей по видам; тип и маршрут не заведены в админке approval-route.
{
id: 'hr-contract-change',
categoryId: 'hr',
title: 'Изменение условий трудового договора',
icon: 'document',
comingSoon: true
},
// Склад / Снабжение — формы открыты для ознакомления, но приём заявок ещё не
// запущен (маршруты/списки не готовы): кнопки сохранения/отправки в самих
@@ -61,6 +53,12 @@ export const REQUEST_TYPES: IRequestType[] = [
title: 'Заявка на услуги',
icon: 'document'
},
{
id: 'acc-payment-request',
categoryId: 'accounting',
title: 'Заявка на оплату',
icon: 'calculator'
},
{
id: 'wh-concrete-request',
categoryId: 'warehouse',
@@ -43,7 +43,7 @@ import { useStableCallback } from '../../shared/useStableCallback';
import { submitDateOnOpen } from '../../shared/submitDate';
import { FORM_ID, FORM_TITLE, IFormData, EMPTY_DATA, SetField } from './model';
import { draftIssues, submitIssues } from './validation';
import { syncRouteItems } from './estimate';
import { syncPerDiem } from './estimate';
import { saveBusinessTripRequest, businessTripApprovalService } from './submit';
import { loadBusinessTripRequest } from './load';
import { useTripEmployee } from './useTripEmployee';
@@ -86,10 +86,10 @@ const BusinessTripForm: React.FC<IRequestFormProps> = ({
const readOnly = !isEditableStatus(requestStatus);
const set: SetField = (key, value) => setData((prev) => ({ ...prev, [key]: value }));
// Суточные и проживание строятся по маршруту (см. syncRouteItems): секции, проверки и сохранение
// Суточные строятся по маршруту (см. syncPerDiem): секции, проверки и сохранение
// работают со сметой, уже приведённой к текущим точкам и датам.
const formData: IFormData = { ...data, Estimate: syncRouteItems(data.Estimate, data.Route) };
const employee = useTripEmployee(context, editId, data.Employee, setData);
const formData: IFormData = { ...data, Estimate: syncPerDiem(data.Estimate, data.Route) };
const handleEmployeeChange = useTripEmployee(context, editId, setData);
const approval = useMemo(() => businessTripApprovalService(editListId), [editListId]);
const requestTypeIdState = useRequestTypeId(context, requestType.id);
@@ -130,7 +130,7 @@ const BusinessTripForm: React.FC<IRequestFormProps> = ({
// Черновику нужен лишь сотрудник, отправке — все обязательные поля (см. validation.ts).
const draftMissing = draftIssues(formData);
const submitMissing = submitIssues(formData, employee.organizations);
const submitMissing = submitIssues(formData);
const validate = (): string | undefined => {
if (draftMissing.length > 0) return `Заполните обязательные поля: ${issueLabels(draftMissing)}.`;
@@ -204,7 +204,7 @@ const BusinessTripForm: React.FC<IRequestFormProps> = ({
onDeleted: onCancel
});
const sectionProps = { data: formData, set, context, employee };
const sectionProps = { data: formData, set, context, onEmployeeChange: handleEmployeeChange };
return (
<FieldIssuesProvider draftIssues={draftMissing} submitIssues={submitMissing}>
@@ -10,7 +10,6 @@ import {
StatusBadge,
ApprovalHistory,
notifyActiveStep,
notifyInitiatorOfReturn,
useRequestTypeId,
usePhasedRoute
} from '../../shared/approval';
@@ -109,17 +108,14 @@ const BusinessTripView: React.FC<IBusinessTripViewProps> = ({ context, itemId, f
);
}
const notify = (newStatus?: string): void => {
const notify = (): void => {
// Решение уже применено; без requestTypeId просто некого уведомлять — UI не роняем.
if (!requestTypeId) return;
const target = {
notifyActiveStep(context, approval, itemId, {
requestTypeId,
dataListName: listId ? dataListTitleForListId(FORM_ID, listId) : dataListTitle(FORM_ID),
approvalListName: listId ? approvalListTitleForListId(FORM_ID, listId) : approvalListTitle(FORM_ID)
};
notifyActiveStep(context, approval, itemId, target).catch(() => undefined);
// Отклонили или вернули на доработку — письмо инициатору (при других статусах ничего не делает).
if (newStatus) notifyInitiatorOfReturn(context, approval, itemId, target, newStatus).catch(() => undefined);
}).catch(() => undefined);
};
const sectionProps = { data, set: NOOP_SET, context };
@@ -156,7 +152,6 @@ const BusinessTripView: React.FC<IBusinessTripViewProps> = ({ context, itemId, f
{!executors.loading && executors.rows.length > 0 && (
<ApprovalMatrix
editor={executors}
printable={false}
search={searchUsers}
title="Исполнение"
roleLabel="Исполнитель"
@@ -178,7 +173,7 @@ const BusinessTripView: React.FC<IBusinessTripViewProps> = ({ context, itemId, f
onDecided={(newStatus) => {
setStatus(newStatus);
setDecisionSeq((n) => n + 1);
notify(newStatus);
notify();
}}
onDelegated={() => {
setDecisionSeq((n) => n + 1);
@@ -18,46 +18,13 @@
## Особое поведение
- **Можно подать за другого сотрудника.** По умолчанию — сам инициатор; при выборе другого
подтягиваются его должность и организации (`Employee/ByEmail`, `useTripEmployee`).
- **Командирующая организация** (с 10-23, логика — `tripCompany.ts`). Сотрудник может работать
в нескольких компаниях — выбирают, от какой он едет (`Select` «Компания — должность»).
Одна организация — выбирается сама, поле заблокировано. Несколько — обязательна при отправке,
должность пустая до выбора и подставляется из выбранной компании. Сотрудника нет в
справочнике — поля нет, отправку не блокирует. Смена сотрудника сбрасывает выбор. Хранение:
`TripCompany` (название) + `TripCompanyId` (CompanyId — под будущий маршрут по компании);
`Organization` — по-прежнему все организации сотрудника. Заявки до 10-23 в просмотре
показывают прежний список организаций.
- **Маршрут — лента точек** (`components/route`, логика — `route.ts`; гибрид «маршрут + смета»
по образцу Concur/Navan/TripIt). Город отправления → точки (город + объект из `/Project` +
даты прибытия/отъезда) → (возвращение — переключатель). Простая поездка — одна точка;
«+ Добавить точку маршрута» — для поездок по нескольким объектам.
- **Города — из справочника КАТО** (`shared/dictionary/kato`, поле `CityPicker`): 178 городов
и посёлков РК из официального КАТО (stat.gov.kz), сгенерированы `scripts/Build-KatoCities.ps1`.
Поиск по русскому и казахскому названию с учётом раскладки (Құлсары = Кулсары = Кульсары);
набранное целиком однозначное название подставляется само. Выбор сохраняет оба названия и
код КАТО (`city`/`cityKz`/`cityKato`, у города отправления — `origin`/`originKz`/`originKato`,
всё внутри `TripRouteJson`), показывается везде как «Кульсары (Құлсары)» (`cityLabel`), в том
числе в `TripCity`/`TripRoute` и заголовке. Нет в справочнике (село, заграница) — сохраняется
введённый текст без казахского названия.
- **Казахстан / другая страна — у каждой точки** (с 10-23, `SegmentedSwitch` в карточке точки):
признак у точки, а не у поездки — бывают смешанные маршруты (Алматы → Москва → Атырау).
За рубежом — «Страна» и «Город» вручную (`abroad`/`country` в `TripRouteJson`), подпись
«Китай, Пекин» (страна первой). Смена признака: город остаётся, за рубежом сбрасываются казахское название
и код КАТО, у точки по Казахстану — страна (`stopLocationPatch`). Новая точка — в той же
стране, что предыдущая. Город отправления — всегда из справочника (можно и свой текст).
Колонка `TripKind` («По Казахстану» / «Зарубежная»): хотя бы одна точка за рубежом —
зарубежная; пригодится для маршрута согласования и отчётов. Старые заявки — по Казахстану.
- Участки пути не хранятся, а выводятся из точек (`routeLegs`, ключ `откуда>куда`); у
каждого участка — вид транспорта плашками (`legTransport`, `TRANSPORT_TYPES`: авиа, ж/д,
такси, служебный и личный автотранспорт; «Автобус» заменён на «Такси» 10-23), обязателен.
Там же **предпочтительное время выезда** (с 10-23): «Утро / День / Вечер / Ночь»
(`legDepartureTime`, `DEPARTURE_TIMES`), тоже обязательно — нужно тревел-координатору под
билеты. На схеме — только в подсказке плашки транспорта, вёрстку схемы не трогали.
- **Переезд — внутри карточки точки** (с 10-23, `LegFields`): блок «Как добраться: Алматы →
Астана» внизу карточки точки, куда едут; обратный — под переключателем «Возвращение».
Раньше участок был отдельной строкой на линии маршрута — его пропускали при заполнении.
- Объект точки по Казахстану — только выбор из справочника (`projectId`): по объектам
разносят затраты. У зарубежной точки поле «Объект / место назначения» принимает и свой
текст (завод, выставка — в справочнике их нет), обязательно лишь непустое значение.
каждого участка — вид транспорта плашками (`legTransport`, `TRANSPORT_TYPES`), обязателен.
- Объект точки — только выбор из справочника (`projectId`): по объектам разносят затраты.
- **Два вида маршрута** — переключатель «Форма | Схема» (`RouteViewSwitch`). Схема
(`RouteScheme`) — только просмотр, как схема метро: узлы-точки (город, объект, даты, ночи,
расходы по точке из сметы — `stopTotals`), на линиях — вид транспорта, внизу сводка
@@ -66,40 +33,24 @@
узкий — сверху вниз. Сумму под точками Тимур может попросить убрать, если будет громоздко.
- Новая точка начинается с даты отъезда из предыдущей (то, что человек уже ввёл);
прибытие раньше отъезда из предыдущей точки — ошибка.
- **Задним числом нельзя** (с 10-23): прибытие в любую точку — не раньше сегодняшнего дня
(сегодня можно). Прошедшие дни недоступны в календаре (`min`); набранную вручную или
«устаревшую» в черновике дату ловит `validation.ts` при отправке, черновик сохраняется.
- **Не дольше 40 дней** (с 10-23, `MAX_TRIP_DAYS`): от прибытия в первую точку до отъезда из
последней включительно; при отправке подсвечивается отъезд последней точки.
- Хранение: `TripRouteJson`; для отчётов из маршрута пишутся `TripRoute` (текстом),
`TripCity` (города), `Project`/`ProjectId` (объект ПЕРВОЙ точки — колонка у всех форм одна),
`TripProjects` (все объекты), `TripStartDate`/`TripEndDate`/`TripDaysCount` (весь период).
- **Задание** — нумерованный список задач, хранится в `TripTasksJson` (+ читаемая копия
`TripTasks` для представлений SP). Пустые строки не сохраняются.
- **Смета** (`components/estimate`, логика — `estimate.ts`). Всё вводится **вручную**, кроме
суточных и проживания — они строятся по точкам маршрута (`syncRouteItems`, `itemsFromRoute`
в `ESTIMATE_KINDS`), по позиции на точку:
- **Суточные считаются сами** (с 10-09, по просьбе кадров): город и проект — из точки,
суточных:
- **Суточные считаются сами** (с 10-09, по просьбе кадров): по позиции на каждую точку
маршрута (`syncPerDiem`, `itemsFromRoute` в `ESTIMATE_KINDS`), город и проект — из точки,
дни — из её дат включительно, но день переезда считается один раз (`stopPerDiemDays`).
Человек вводит только кол-во МРП в день; ставка = кол-во × `MRP_VALUE` (захардкожен в
model.ts вместе с `MRP_YEAR` — обновлять раз в год). Ставка сохраняется в заявке (`price`),
поэтому просмотр старой заявки не пересчитывается по новому МРП — `syncRouteItems`
применяется только в форме. **Лимит** (с 10-23): не больше 6 МРП в день по Казахстану и 8 за
рубежом (`MAX_MRP_PER_DAY`, по признаку точки) — подпись у поля, ошибка сразу под строкой
и при отправке.
- **Проживание** (с 10-23): ночи — из дат точки (`stopNights`), человек вводит только цену за
ночь. Цена необязательна (в точке могут жить на объекте). **Лимит** — 15 000 ₸ за ночь по
Казахстану; за рубежом `MAX_NIGHT_PRICE.abroad` пока `undefined` (без лимита) — вписать,
когда кадры назовут сумму. Кнопки «+ Ещё гостиница» и ввода «суммой» у проживания больше нет.
- **Дни/ночи можно поправить вручную** (с 10-23, `AutoQuantityField`): карандаш у поля
открывает ввод, число любое (форс-мажор — задержался в точке). Хранится в
`quantityManual` (`''` — по датам); под полем «вручную · по датам: N · вернуть». Даты
потом поменяли — ручное число остаётся, расхождение видно по подписи. В расчёте для
просмотра/печати/колонки SP — пометка «(вручную)».
поэтому просмотр старой заявки не пересчитывается по новому МРП — `syncPerDiem` применяется
только в форме.
- Статьи: основные Суточные / Проезд / Проживание (переключатель «Требуется / Не требуется»,
выключенная печатается «не требуется»), Страховка и Виза (по одной) и «Другой расход»
со своим названием (сколько угодно) — кнопками «+», удаляются корзиной.
- **Внутри статьи — позиции** («+ Ещё участок пути»; у суточных и проживания
- **Внутри статьи — позиции** («+ Ещё гостиница», «+ Ещё участок пути»; у суточных
позиции только из маршрута). Позиция привязана к точке маршрута (суточные, проживание, другой расход) или
к участку пути (проезд); страховка/виза — без привязки. Вариант один — выбор скрыт и
подставляется сам (`resolveLinkId`); точку удалили — позицию нужно привязать заново.
@@ -113,10 +64,7 @@
привязкой, у «Другого расхода» — название, у суточных — кол-во МРП.
- Хранение: `TripEstimateJson` (статьи + total), читаемо — `TripEstimate` (позиция на
строку), итог числом — `TripEstimateTotal`. Просмотр/печать — таблица по статьям.
- **Комментарий** (с 10-23, `TripComment`, Note) — необязательное поле после итога сметы; в
просмотре пустой не показывается.
- **Обязательство и согласие** (так названа секция с 10-23, по требованию кадров) — обязательство
по авансовому отчёту (текст бланка) и флажок согласия, без него не отправить.
- **Обязательство** по авансовому отчёту (текст бланка) — флажок, без него не отправить.
- **Дата подачи** (`SubmitDate`, общий столбец сайта) — ставится сегодняшней, пока заявку
можно править (см. shared/submitDate.ts).
- **Подсветка незаполненных полей** — `FieldIssuesProvider` + правила в `validation.ts`.
@@ -128,8 +76,8 @@
заголовком (см. грабли коллизий internalName).
## Секции формы
EmployeeSection (сотрудник · должность · дата подачи · командирующая организация) → RouteSection (маршрут
лентой; поле «Цель» убрано 10-23, колонка `TripPurpose` в SP осталась от тестовых заявок) → TasksSection (задачи) → EstimateSection (смета + итог) →
EmployeeSection (сотрудник · должность · дата подачи · организация) → RouteSection (маршрут
лентой + цель) → TasksSection (задачи) → EstimateSection (смета + итог) →
ObligationSection (текст обязательства + согласие).
## Точки входа
@@ -1,45 +0,0 @@
import * as React from 'react';
import styles from './ChoiceChips.module.scss';
import { useFormReadOnly } from '../../../shared/ui';
import { DEPARTURE_TIMES } from '../model';
interface Props {
/** Значение из DEPARTURE_TIMES; '' — не указано. */
value: string;
onChange: (value: string) => void;
/** Подпись группы для экранных дикторов, напр. «Время выезда: Алматы → Атырау». */
ariaLabel: string;
}
/**
* Предпочтительное время выезда плашками (обязательно — см. validation.ts).
* Повторный клик по выбранной плашке снимает выбор. В режиме чтения — только
* выбранная плашка.
*/
export const DepartureTimeChips: React.FC<Props> = ({ value, onChange, ariaLabel }) => {
const readOnly = useFormReadOnly();
if (readOnly) {
return <span className={`${styles.chip} ${styles.selected} ${styles.static}`}>{value || 'не указано'}</span>;
}
return (
<div className={styles.chips} role="radiogroup" aria-label={ariaLabel}>
{DEPARTURE_TIMES.map((time) => {
const selected = time === value;
return (
<button
key={time}
type="button"
role="radio"
aria-checked={selected}
className={selected ? `${styles.chip} ${styles.selected}` : styles.chip}
onClick={() => onChange(selected ? '' : time)}
>
{time}
</button>
);
})}
</div>
);
};
@@ -1,36 +0,0 @@
import * as React from 'react';
import styles from './SegmentedSwitch.module.scss';
export interface ISegmentedOption<T extends string> {
value: T;
label: string;
}
interface Props<T extends string> {
value: T;
options: ReadonlyArray<ISegmentedOption<T>>;
onChange: (value: T) => void;
/** Подпись группы для экранных дикторов. */
ariaLabel: string;
className?: string;
}
/** Сегментный переключатель из 2–3 вариантов: «Форма | Схема», «Казахстан | Другая страна». */
export function SegmentedSwitch<T extends string>({ value, options, onChange, ariaLabel, className }: Props<T>): JSX.Element {
return (
<div className={className ? `${styles.switch} ${className}` : styles.switch} role="radiogroup" aria-label={ariaLabel}>
{options.map((option) => (
<button
key={option.value}
type="button"
role="radio"
aria-checked={value === option.value}
className={value === option.value ? `${styles.option} ${styles.active}` : styles.option}
onClick={() => onChange(option.value)}
>
{option.label}
</button>
))}
</div>
);
}
@@ -1,5 +1,4 @@
@import '../../../../../styles/design-tokens';
// Плашки выбора в один клик: вид транспорта (TransportChips) и время выезда (DepartureTimeChips).
.chips {
display: flex;
@@ -1,5 +1,5 @@
import * as React from 'react';
import styles from './ChoiceChips.module.scss';
import styles from './TransportChips.module.scss';
import { useFormReadOnly } from '../../../shared/ui';
import { TRANSPORT_TYPES } from '../model';
import { TransportIcon } from './TransportIcon';
@@ -15,9 +15,8 @@ const PLANE =
'M21 16v-2l-8-5V3.5c0-.83-.67-1.5-1.5-1.5S10 2.67 10 3.5V9l-8 5v2l8-2.5V19l-2 1.5V22l3.5-1 3.5 1v-1.5L13 19v-5.5l8 2.5z';
const TRAIN =
'M12 2c-4 0-8 .5-8 4v9.5C4 17.43 5.57 19 7.5 19L6 20.5v.5h2.23l2-2H14l2 2h2v-.5L16.5 19c1.93 0 3.5-1.57 3.5-3.5V6c0-3.5-3.58-4-8-4zM7.5 17c-.83 0-1.5-.67-1.5-1.5S6.67 14 7.5 14s1.5.67 1.5 1.5S8.33 17 7.5 17zm3.5-7H6V6h5v4zm2 0V6h5v4h-5zm3.5 7c-.83 0-1.5-.67-1.5-1.5s.67-1.5 1.5-1.5 1.5.67 1.5 1.5-.67 1.5-1.5 1.5z';
// local_taxi: та же машина, что CAR, но с шашкой на крыше — чтобы такси отличалось от служебного/личного авто.
const TAXI =
'M18.92 6.01C18.72 5.42 18.16 5 17.5 5H15V3H9v2H6.5c-.66 0-1.21.42-1.42 1.01L3 12v8c0 .55.45 1 1 1h1c.55 0 1-.45 1-1v-1h12v1c0 .55.45 1 1 1h1c.55 0 1-.45 1-1v-8l-2.08-5.99zM6.5 16c-.83 0-1.5-.67-1.5-1.5S5.67 13 6.5 13s1.5.67 1.5 1.5S7.33 16 6.5 16zm11 0c-.83 0-1.5-.67-1.5-1.5s.67-1.5 1.5-1.5 1.5.67 1.5 1.5-.67 1.5-1.5 1.5zM5 11l1.5-4.5h11L19 11H5z';
const BUS =
'M4 16c0 .88.39 1.67 1 2.22V20c0 .55.45 1 1 1h1c.55 0 1-.45 1-1v-1h8v1c0 .55.45 1 1 1h1c.55 0 1-.45 1-1v-1.78c.61-.55 1-1.34 1-2.22V6c0-3.5-3.58-4-8-4s-8 .5-8 4v10zm3.5 1c-.83 0-1.5-.67-1.5-1.5S6.67 14 7.5 14s1.5.67 1.5 1.5S8.33 17 7.5 17zm9 0c-.83 0-1.5-.67-1.5-1.5s.67-1.5 1.5-1.5 1.5.67 1.5 1.5-.67 1.5-1.5 1.5zm1.5-6H6V6h12v5z';
const CAR =
'M18.92 6.01C18.72 5.42 18.16 5 17.5 5h-11c-.66 0-1.21.42-1.42 1.01L3 12v8c0 .55.45 1 1 1h1c.55 0 1-.45 1-1v-1h12v1c0 .55.45 1 1 1h1c.55 0 1-.45 1-1v-8l-2.08-5.99zM6.5 16c-.83 0-1.5-.67-1.5-1.5S5.67 13 6.5 13s1.5.67 1.5 1.5S7.33 16 6.5 16zm11 0c-.83 0-1.5-.67-1.5-1.5s.67-1.5 1.5-1.5 1.5.67 1.5 1.5-.67 1.5-1.5 1.5zM5 11l1.5-4.5h11L19 11H5z';
@@ -25,7 +24,7 @@ const CAR =
const PATH_BY_TYPE: Record<string, string> = {
Авиа: PLANE,
Железнодорожный: TRAIN,
Такси: TAXI,
Автобус: BUS,
'Служебный автотранспорт': CAR,
'Личный автотранспорт': CAR
};
@@ -1,68 +0,0 @@
import * as React from 'react';
import styles from './StopItemFields.module.scss';
import { FormField, MoneyInput } from '../../../../shared/ui';
import { IEstimateItem, IRouteStop } from '../../model';
import { formatAmount, itemAmount, nightPriceLimit } from '../../estimate';
import { stopCityLabel } from '../../route';
import { AutoQuantityField } from './AutoQuantityField';
import { fieldKey } from '../../validation';
interface Props {
item: IEstimateItem;
/** Точка маршрута позиции; проживание строится по точкам (см. syncRouteItems). */
stop: IRouteStop | undefined;
/** Дни/ночи по датам точки (routeItemAutoQuantity) — рядом с ручным значением. */
autoQuantity: string;
onChange: (patch: Partial<IEstimateItem>) => void;
}
/**
* Проживание в одной точке маршрута: ночи — из дат точки (или вручную — карандаш,
* см. AutoQuantityField), человек вводит цену за ночь (не выше лимита — см.
* nightPriceLimit). Цену можно не вводить — в точке могут жить на объекте, тогда
* позиция просто 0.
*/
export const AccommodationFields: React.FC<Props> = ({ item, stop, autoQuantity, onChange }) => {
const hasNights = item.quantity !== '';
const limit = nightPriceLimit(stop);
const isOverLimit = limit !== undefined && Number(item.price) > limit;
const priceLabel = limit === undefined ? 'Цена за ночь' : `Цена за ночь (до ${formatAmount(limit)} ₸)`;
return (
<div className={styles.wrap}>
<div className={styles.place}>
<span className={styles.city}>{(stop && stopCityLabel(stop)) || 'Точка маршрута'}</span>
</div>
<div className={`${styles.calcRow} ${styles.calcRowShort}`}>
<AutoQuantityField
id={fieldKey.itemQuantity(item)}
label="Ночей"
autoValue={autoQuantity}
manualValue={item.quantityManual}
onManualChange={(v) => onChange({ quantityManual: v })}
/>
<span className={styles.sign} aria-hidden>
×
</span>
<FormField label={priceLabel} htmlFor={fieldKey.itemPrice(item)}>
<div className={styles.number}>
<MoneyInput id={fieldKey.itemPrice(item)} value={item.price} onChange={(v) => onChange({ price: v })} />
</div>
</FormField>
<span className={styles.sign} aria-hidden>
=
</span>
<div className={styles.result}>
<span className={styles.resultLabel}>Итого</span>
<span className={styles.resultValue}>{formatAmount(itemAmount(item))} ₸</span>
</div>
</div>
{isOverLimit && limit !== undefined && (
<div className={styles.limitError}>Не больше {formatAmount(limit)} ₸ за ночь по Казахстану.</div>
)}
{!hasNights && <div className={styles.hint}>Укажите даты точки в маршруте — по ним считаются ночи.</div>}
</div>
);
};
@@ -1,75 +0,0 @@
import * as React from 'react';
import { useEffect, useState } from 'react';
import styles from './StopItemFields.module.scss';
import { FormField, Icon, MoneyInput, useFormReadOnly } from '../../../../shared/ui';
interface Props {
id: string;
/** «Дней» / «Ночей». */
label: string;
/** Посчитано по датам точки; '' — даты не заданы. */
autoValue: string;
/** Введено вручную; '' — берём autoValue. */
manualValue: string;
onManualChange: (value: string) => void;
}
/**
* Дни (суточные) или ночи (проживание): по умолчанию считаются по датам точки и
* не редактируются; карандаш открывает ручной ввод — на случай форс-мажора
* (задержался в точке). Ручное число любое; рядом видно, сколько по датам, и
* его можно сбросить обратно к расчёту.
*/
export const AutoQuantityField: React.FC<Props> = ({ id, label, autoValue, manualValue, onManualChange }) => {
const readOnly = useFormReadOnly();
// Отдельно от manualValue: пока человек стёр число и печатает новое, поле не должно схлопываться.
const [editing, setEditing] = useState(false);
const isManual = manualValue !== '';
const showInput = !readOnly && (editing || isManual);
// Карандаш нажали — сразу ставим курсор в поле.
useEffect(() => {
if (editing) document.getElementById(id)?.focus();
}, [editing, id]);
const startEditing = (): void => {
onManualChange(autoValue);
setEditing(true);
};
const resetToAuto = (): void => {
onManualChange('');
setEditing(false);
};
return (
<FormField label={label} htmlFor={id}>
{showInput ? (
<div className={styles.number} onBlur={() => !isManual && setEditing(false)}>
<MoneyInput id={id} value={manualValue} onChange={onManualChange} />
</div>
) : (
<div className={styles.autoValue}>
<div className={styles.readonly} title="Считается по датам точки в маршруте">
{(isManual ? manualValue : autoValue) || '—'}
</div>
{!readOnly && (
<button type="button" className={styles.iconButton} title="Изменить вручную" onClick={startEditing}>
<Icon name="edit" size="sm" />
</button>
)}
</div>
)}
{isManual && (
<span className={styles.manualNote}>
вручную · по датам: {autoValue || '—'}
{!readOnly && (
<button type="button" className={styles.resetButton} onClick={resetToAuto}>
<Icon name="refresh" size="sm" />
вернуть
</button>
)}
</span>
)}
</FormField>
);
};
@@ -3,11 +3,10 @@ import styles from './EstimateItemRow.module.scss';
import { FormField, Icon, Select, TextInput } from '../../../../shared/ui';
import type { ISelectOption } from '../../../../shared/ui';
import { ESTIMATE_KINDS, EstimateKind, IEstimateItem, ITripRoute } from '../../model';
import { linkOptions, resolveLinkId, routeItemAutoQuantity } from '../../estimate';
import { linkOptions, resolveLinkId } from '../../estimate';
import { fieldKey } from '../../validation';
import { AmountFields } from './AmountFields';
import { PerDiemFields } from './PerDiemFields';
import { AccommodationFields } from './AccommodationFields';
interface Props {
kind: EstimateKind;
@@ -22,15 +21,13 @@ interface Props {
* Позиция статьи: к чему относится (точка маршрута / участок пути), сумма и
* пояснение. Выбор «к чему относится» показываем, только когда вариантов
* больше одного — в простой поездке в одну точку выбирать нечего. Суточные
* (и проживание) привязаны к точке раз и навсегда (строятся по маршруту) — у них свои поля.
* привязаны к точке раз и навсегда (строятся по маршруту) — у них свои поля.
*/
export const EstimateItemRow: React.FC<Props> = ({ kind, item, route, onChange, onRemove }) => {
const info = ESTIMATE_KINDS[kind];
const options: ISelectOption[] = linkOptions(kind, route).map((o) => ({ value: o.id, label: o.label }));
const showLink = !info.itemsFromRoute && options.length > 1;
const linkLabel = info.link === 'leg' ? 'Участок пути' : 'Точка маршрута';
const stop = route.stops.find((s) => s.id === item.linkId);
const autoQuantity = routeItemAutoQuantity(kind, route, item.linkId);
return (
<div className={styles.row}>
@@ -56,9 +53,11 @@ export const EstimateItemRow: React.FC<Props> = ({ kind, item, route, onChange,
)}
</div>
)}
{kind === 'perDiem' && <PerDiemFields item={item} stop={stop} autoQuantity={autoQuantity} onChange={onChange} />}
{kind === 'accommodation' && <AccommodationFields item={item} stop={stop} autoQuantity={autoQuantity} onChange={onChange} />}
{!info.itemsFromRoute && <AmountFields kind={kind} item={item} onChange={onChange} />}
{info.itemsFromRoute ? (
<PerDiemFields item={item} stop={route.stops.find((s) => s.id === item.linkId)} onChange={onChange} />
) : (
<AmountFields kind={kind} item={item} onChange={onChange} />
)}
<TextInput
value={item.comment}
onChange={(v) => onChange({ comment: v })}
@@ -1,6 +1,5 @@
@import '../../../../../../styles/design-tokens';
// Общие стили позиций «по точке маршрута»: суточные (PerDiemFields) и проживание (AccommodationFields).
// С этой ширины «дни × МРП × значение = итог» помещается в одну строку.
$calc-inline-breakpoint: 640px;
@@ -116,78 +115,3 @@ $calc-inline-breakpoint: 640px;
padding-bottom: 8px;
}
}
// Превышен лимит (МРП, цена за ночь) — сразу под строкой, не дожидаясь отправки.
.limitError {
font-family: $font-sans;
font-size: $fs-sm;
color: $red-500;
}
// Проживание: «ночи × цена = итог» — на две колонки короче, чем у суточных.
@media (min-width: $calc-inline-breakpoint) {
.calcRowShort {
grid-template-columns: minmax(0, 0.6fr) auto minmax(0, 1fr) auto minmax(120px, auto);
}
}
// Дни/ночи по датам + карандаш «изменить вручную» (AutoQuantityField).
.autoValue {
display: flex;
align-items: center;
gap: $sp-1;
.readonly {
flex: 1;
min-width: 0;
}
}
.iconButton {
display: inline-flex;
align-items: center;
justify-content: center;
flex-shrink: 0;
padding: 6px;
border: 0;
border-radius: $r-sm;
background: transparent;
color: $gray-500;
cursor: pointer;
transition: .18s;
&:hover {
background: $gray-100;
color: $navy-900;
}
&:focus-visible {
outline: 2px solid $gold-500;
outline-offset: 1px;
}
}
// «вручную · по датам: 4 · вернуть» — под полем, мелко: число правили руками.
.manualNote {
display: inline-flex;
flex-wrap: wrap;
align-items: center;
gap: $sp-1 $sp-2;
font-family: $font-sans;
font-size: $fs-caption;
color: $amber-700;
}
.resetButton {
display: inline-flex;
align-items: center;
gap: 4px;
padding: 0;
border: 0;
background: transparent;
color: $navy-700;
font-family: $font-sans;
font-size: $fs-caption;
text-decoration: underline;
cursor: pointer;
}
@@ -1,51 +1,42 @@
import * as React from 'react';
import styles from './StopItemFields.module.scss';
import styles from './PerDiemFields.module.scss';
import { FormField, MoneyInput } from '../../../../shared/ui';
import { IEstimateItem, IRouteStop, MRP_VALUE, MRP_YEAR } from '../../model';
import { formatAmount, itemAmount, mrpLimit } from '../../estimate';
import { stopCityLabel } from '../../route';
import { AutoQuantityField } from './AutoQuantityField';
import { formatAmount, itemAmount } from '../../estimate';
import { fieldKey } from '../../validation';
interface Props {
item: IEstimateItem;
/** Точка маршрута позиции; суточные всегда строятся по точкам (см. syncRouteItems). */
/** Точка маршрута позиции; суточные всегда строятся по точкам (см. syncPerDiem). */
stop: IRouteStop | undefined;
/** Дни/ночи по датам точки (routeItemAutoQuantity) — рядом с ручным значением. */
autoQuantity: string;
onChange: (patch: Partial<IEstimateItem>) => void;
}
/**
* Суточные одной точки маршрута: город и проект — из точки, дни — из её дат (или
* вручную — карандаш, см. AutoQuantityField), человек вводит количество МРП в
* день (не больше лимита — см. mrpLimit). Итог = дни × МРП × MRP_VALUE.
* Суточные одной точки маршрута: город и проект — из точки, дни — из её дат,
* человек вводит только количество МРП в день. Итог = дни × МРП × MRP_VALUE.
*/
export const PerDiemFields: React.FC<Props> = ({ item, stop, autoQuantity, onChange }) => {
export const PerDiemFields: React.FC<Props> = ({ item, stop, onChange }) => {
const hasDays = item.quantity !== '';
const project = stop?.project.trim();
const limit = mrpLimit(stop);
const isOverLimit = Number(item.mrpCount) > limit;
return (
<div className={styles.wrap}>
<div className={styles.place}>
<span className={styles.city}>{(stop && stopCityLabel(stop)) || 'Точка маршрута'}</span>
<span className={styles.city}>{stop?.city.trim() || 'Точка маршрута'}</span>
<span className={styles.project}>Проект: {project || 'не выбран'}</span>
</div>
<div className={styles.calcRow}>
<AutoQuantityField
id={fieldKey.itemQuantity(item)}
label="Дней"
autoValue={autoQuantity}
manualValue={item.quantityManual}
onManualChange={(v) => onChange({ quantityManual: v })}
/>
<FormField label="Дней">
<div className={styles.readonly} title="Считается по датам точки в маршруте">
{hasDays ? item.quantity : '—'}
</div>
</FormField>
<span className={styles.sign} aria-hidden>
×
</span>
<FormField label={`Кол-во МРП в день (до ${limit})`} htmlFor={fieldKey.itemMrpCount(item)}>
<FormField label="Кол-во МРП в день" htmlFor={fieldKey.itemMrpCount(item)}>
<div className={styles.number}>
<MoneyInput id={fieldKey.itemMrpCount(item)} value={item.mrpCount} onChange={(v) => onChange({ mrpCount: v })} />
</div>
@@ -65,11 +56,6 @@ export const PerDiemFields: React.FC<Props> = ({ item, stop, autoQuantity, onCha
</div>
</div>
{isOverLimit && (
<div className={styles.limitError}>
Не больше {limit} МРП в день {stop?.abroad ? 'за рубежом' : 'по Казахстану'}.
</div>
)}
{!hasDays && <div className={styles.hint}>Укажите даты точки в маршруте — по ним считаются дни.</div>}
</div>
);
@@ -1,18 +0,0 @@
@import '../../../../../../styles/design-tokens';
// Переезд внутри карточки точки — отдельная плашка с фоном, чтобы её не пропускали.
.leg {
display: flex;
flex-direction: column;
gap: $sp-3;
padding: $sp-3;
border-radius: $r-sm;
background: $gray-50;
}
.title {
font-family: $font-sans;
font-size: $fs-sm;
font-weight: 600;
color: $navy-900;
}
@@ -1,32 +0,0 @@
import * as React from 'react';
import styles from './LegFields.module.scss';
import { FormField } from '../../../../shared/ui';
import { IRouteLeg, legLabel } from '../../route';
import { fieldKey } from '../../validation';
import { TransportChips } from '../TransportChips';
import { DepartureTimeChips } from '../DepartureTimeChips';
interface Props {
leg: IRouteLeg;
transport: string;
onTransportChange: (value: string) => void;
departureTime: string;
onDepartureTimeChange: (value: string) => void;
}
/**
* Переезд «как добраться»: вид транспорта и время выезда (оба обязательны).
* Живёт внутри карточки точки, куда едут (обратный — в блоке «Возвращение»):
* отдельной строкой на линии маршрута его пропускали при заполнении.
*/
export const LegFields: React.FC<Props> = ({ leg, transport, onTransportChange, departureTime, onDepartureTimeChange }) => (
<div className={styles.leg}>
<span className={styles.title}>Как добраться: {legLabel(leg)}</span>
<FormField label="Вид транспорта" fieldKey={fieldKey.legTransport(leg.id)} required>
<TransportChips value={transport} onChange={onTransportChange} ariaLabel={`Вид транспорта: ${legLabel(leg)}`} />
</FormField>
<FormField label="Время выезда" fieldKey={fieldKey.legDepartureTime(leg.id)} required>
<DepartureTimeChips value={departureTime} onChange={onDepartureTimeChange} ariaLabel={`Время выезда: ${legLabel(leg)}`} />
</FormField>
</div>
);
@@ -108,11 +108,7 @@ $marker-size: 26px;
}
}
// Возвращение: переключатель, а под ним — обратный переезд (транспорт, время выезда).
.end {
display: flex;
flex-direction: column;
gap: $sp-3;
padding-top: $sp-2;
}
@@ -1,13 +1,12 @@
import * as React from 'react';
import type { WebPartContext } from '@microsoft/sp-webpart-base';
import styles from './RouteEditor.module.scss';
import { FormField, Icon, Toggle, useFormReadOnly } from '../../../../shared/ui';
import { CityPicker } from '../../../../shared/dictionary';
import { CITY_PLACEHOLDER, IRouteStop, ITripRoute } from '../../model';
import { IRouteLeg, createStop, originLabel, routeLegs, withoutStopLegs } from '../../route';
import { FormField, Icon, TextInput, Toggle, useFormReadOnly } from '../../../../shared/ui';
import { IRouteStop, ITripRoute } from '../../model';
import { IRouteLeg, createStop, routeLegs } from '../../route';
import { fieldKey } from '../../validation';
import { RouteStopCard } from './RouteStopCard';
import { LegFields } from './LegFields';
import { RouteLegRow } from './RouteLegRow';
interface Props {
route: ITripRoute;
@@ -33,10 +32,9 @@ const TimelineRow: React.FC<{ marker: MarkerKind; label?: string; children: Reac
/**
* Маршрут командировки лентой: город отправления → точки (город + объект +
* даты) → обратно. Переезд (транспорт, время выезда) — внутри карточки точки, куда
* едут, обратный — в блоке «Возвращение»: отдельной строкой на линии его
* пропускали. Участки не хранятся, а выводятся из точек (route.ts/routeLegs).
* Простая поездка — одна точка; «+ Добавить точку» — для поездок по нескольким объектам.
* даты) → обратно. Между точками — участки пути с видом транспорта; участки
* не хранятся, а выводятся из точек (route.ts/routeLegs). Простая поездка — одна
* точка; «+ Добавить точку» — для поездок по нескольким объектам.
*/
export const RouteEditor: React.FC<Props> = ({ route, onChange, context }) => {
const readOnly = useFormReadOnly();
@@ -48,28 +46,24 @@ export const RouteEditor: React.FC<Props> = ({ route, onChange, context }) => {
onChange({ ...route, stops: route.stops.map((s) => (s.id === id ? { ...s, ...patch } : s)) });
const addStop = (): void =>
onChange({ ...route, stops: [...route.stops, createStop(route.stops[route.stops.length - 1])] });
// Транспорт и время выезда участков, которые шли через удалённую точку, больше ни к чему не относятся.
const removeStop = (id: string): void =>
onChange({
...route,
stops: route.stops.filter((s) => s.id !== id),
legTransport: withoutStopLegs(route.legTransport, id),
legDepartureTime: withoutStopLegs(route.legDepartureTime, id)
});
const removeStop = (id: string): void => {
// Виды транспорта участков, которые шли через удалённую точку, больше ни к чему не относятся.
const legTransport: Record<string, string> = {};
Object.keys(route.legTransport)
.filter((key) => key.split('>').indexOf(id) === -1)
.forEach((key) => {
legTransport[key] = route.legTransport[key];
});
onChange({ ...route, stops: route.stops.filter((s) => s.id !== id), legTransport });
};
const setTransport = (id: string, value: string): void =>
onChange({ ...route, legTransport: { ...route.legTransport, [id]: value } });
const setDepartureTime = (id: string, value: string): void =>
onChange({ ...route, legDepartureTime: { ...route.legDepartureTime, [id]: value } });
const legFields = (leg: IRouteLeg | undefined): React.ReactNode =>
const legRow = (leg: IRouteLeg | undefined): React.ReactNode =>
leg && (
<LegFields
leg={leg}
transport={route.legTransport[leg.id] || ''}
onTransportChange={(v) => setTransport(leg.id, v)}
departureTime={route.legDepartureTime[leg.id] || ''}
onDepartureTimeChange={(v) => setDepartureTime(leg.id, v)}
/>
<TimelineRow marker="line">
<RouteLegRow leg={leg} transport={route.legTransport[leg.id] || ''} onTransportChange={(v) => setTransport(leg.id, v)} />
</TimelineRow>
);
return (
@@ -77,27 +71,29 @@ export const RouteEditor: React.FC<Props> = ({ route, onChange, context }) => {
<TimelineRow marker="endpoint">
<div className={styles.origin}>
<FormField label="Откуда (город отправления)" htmlFor={fieldKey.origin} required>
<CityPicker
<TextInput
id={fieldKey.origin}
value={{ name: route.origin, nameKz: route.originKz, kato: route.originKato }}
onChange={(city) => onChange({ ...route, origin: city.name, originKz: city.nameKz, originKato: city.kato })}
placeholder={CITY_PLACEHOLDER}
value={route.origin}
onChange={(v) => onChange({ ...route, origin: v })}
placeholder="Напр.: Алматы"
/>
</FormField>
</div>
</TimelineRow>
{route.stops.map((stop, i) => (
<TimelineRow key={stop.id} marker="stop" label={String(i + 1)}>
<RouteStopCard
stop={stop}
index={i}
context={context}
onChange={(patch) => updateStop(stop.id, patch)}
onRemove={!readOnly && route.stops.length > 1 ? () => removeStop(stop.id) : undefined}
inbound={legFields(legTo(stop.id))}
/>
</TimelineRow>
<React.Fragment key={stop.id}>
{legRow(legTo(stop.id))}
<TimelineRow marker="stop" label={String(i + 1)}>
<RouteStopCard
stop={stop}
index={i}
context={context}
onChange={(patch) => updateStop(stop.id, patch)}
onRemove={!readOnly && route.stops.length > 1 ? () => removeStop(stop.id) : undefined}
/>
</TimelineRow>
</React.Fragment>
))}
{!readOnly && (
@@ -109,21 +105,21 @@ export const RouteEditor: React.FC<Props> = ({ route, onChange, context }) => {
</TimelineRow>
)}
{legRow(returnLeg)}
<TimelineRow marker="endpoint">
<div className={styles.end}>
{readOnly ? (
<span className={styles.endText}>
{route.returnToOrigin ? `Возвращение: ${originLabel(route) || 'город отправления'}` : 'Без возвращения в город отправления'}
{route.returnToOrigin ? `Возвращение: ${route.origin || 'город отправления'}` : 'Без возвращения в город отправления'}
</span>
) : (
<Toggle
checked={route.returnToOrigin}
onChange={(returnToOrigin) => onChange({ ...route, returnToOrigin })}
onLabel={`Возвращение в ${originLabel(route) || 'город отправления'}`}
onLabel={`Возвращение в ${route.origin.trim() || 'город отправления'}`}
/>
)}
{/* Обратный переезд — здесь: своей карточки точки у него нет. */}
{legFields(returnLeg)}
</div>
</TimelineRow>
</div>
@@ -0,0 +1,6 @@
@import '../../../../../../styles/design-tokens';
// Участок — без карточки: это «переезд» между точками, он лежит прямо на линии маршрута.
.leg {
padding-block: $sp-2;
}
@@ -0,0 +1,25 @@
import * as React from 'react';
import styles from './RouteLegRow.module.scss';
import { FormField } from '../../../../shared/ui';
import { IRouteLeg, legLabel } from '../../route';
import { fieldKey } from '../../validation';
import { TransportChips } from '../TransportChips';
interface Props {
leg: IRouteLeg;
transport: string;
onTransportChange: (value: string) => void;
}
/** Участок пути между точками на линии маршрута: «Алматы → Атырау» и вид транспорта. */
export const RouteLegRow: React.FC<Props> = ({ leg, transport, onTransportChange }) => (
<div className={styles.leg}>
<FormField label={legLabel(leg)} fieldKey={fieldKey.legTransport(leg.id)}>
<TransportChips
value={transport}
onChange={onTransportChange}
ariaLabel={`Вид транспорта: ${legLabel(leg)}`}
/>
</FormField>
</div>
);
@@ -1,7 +1,7 @@
import * as React from 'react';
import styles from './RouteScheme.module.scss';
import { IEstimateArticle, ITripRoute } from '../../model';
import { originLabel, routeLegs, routePeriod, routeProjects, stopCityLabel } from '../../route';
import { routeLegs, routePeriod, routeProjects } from '../../route';
import { estimateTotal, formatAmount, stopTotals } from '../../estimate';
import { plural, tripDays } from '../../tripData';
import { ISchemeNode } from './schemeNode';
@@ -18,14 +18,14 @@ interface Props {
/** Узлы схемы по порядку: город отправления → точки → (возвращение). */
function schemeNodes(route: ITripRoute, amounts: Map<string, number>): ISchemeNode[] {
const period = routePeriod(route);
const origin = originLabel(route);
const origin = route.origin.trim();
const withDate = (caption: string, iso: string): string => (iso ? `${caption} ${shortDate(iso)}` : caption);
const nodes: ISchemeNode[] = [
{ key: 'origin', kind: 'endpoint', city: origin, caption: withDate('выезд', period.start), amount: 0 }
];
route.stops.forEach((stop, i) =>
nodes.push({ key: stop.id, kind: 'stop', number: i + 1, stop, city: stopCityLabel(stop), amount: amounts.get(stop.id) || 0 })
nodes.push({ key: stop.id, kind: 'stop', number: i + 1, stop, city: stop.city.trim(), amount: amounts.get(stop.id) || 0 })
);
if (route.returnToOrigin) {
nodes.push({ key: 'return', kind: 'endpoint', city: origin, caption: withDate('возвращение', period.end), amount: 0 });
@@ -56,7 +56,7 @@ export const RouteScheme: React.FC<Props> = ({ route, articles, onSelectStop })
return (
<div className={styles.scheme}>
<SchemeTrack nodes={nodes} legs={legs} legTransport={route.legTransport} legDepartureTime={route.legDepartureTime} onSelectStop={onSelectStop} />
<SchemeTrack nodes={nodes} legs={legs} legTransport={route.legTransport} onSelectStop={onSelectStop} />
<div className={styles.stats}>{stats.join(' · ')}</div>
</div>
);
@@ -1,14 +1,11 @@
import * as React from 'react';
import type { WebPartContext } from '@microsoft/sp-webpart-base';
import styles from './RouteStopCard.module.scss';
import { FormField, Icon, TextInput, useFormReadOnly } from '../../../../shared/ui';
import { FormField, Icon, TextInput } from '../../../../shared/ui';
import { ProjectPicker } from '../../../../shared/dictionary';
import { IRouteStop, PROJECT_PLACEHOLDER } from '../../model';
import { stopLocationPatch, stopNights } from '../../route';
import { ISegmentedOption, SegmentedSwitch } from '../SegmentedSwitch';
import { StopPlaceFields } from './StopPlaceFields';
import { stopNights } from '../../route';
import { plural } from '../../tripData';
import { todaySubmitDate } from '../../../../shared/submitDate';
import { fieldKey } from '../../validation';
interface Props {
@@ -18,8 +15,6 @@ interface Props {
onChange: (patch: Partial<IRouteStop>) => void;
/** Не передан — точку удалить нельзя (она единственная). */
onRemove?: () => void;
/** Переезд в эту точку («Как добраться») — собирает RouteEditor, он знает участки. */
inbound?: React.ReactNode;
}
/** id карточки точки в DOM — к ней прокручивает клик по точке на схеме маршрута. */
@@ -27,20 +22,8 @@ export function stopCardDomId(stopId: string): string {
return `route-stop-${stopId}`;
}
type StopLocation = 'domestic' | 'abroad';
const LOCATIONS: ReadonlyArray<ISegmentedOption<StopLocation>> = [
{ value: 'domestic', label: 'Казахстан' },
{ value: 'abroad', label: 'Другая страна' }
];
/**
* Точка маршрута: Казахстан или другая страна, город, объект из справочника, даты
* пребывания и переезд сюда (транспорт, время выезда). В режиме чтения переключатель
* не нужен — страна видна в полях.
*/
export const RouteStopCard: React.FC<Props> = ({ stop, index, context, onChange, onRemove, inbound }) => {
const readOnly = useFormReadOnly();
/** Точка маршрута: город, объект из справочника и даты пребывания. */
export const RouteStopCard: React.FC<Props> = ({ stop, index, context, onChange, onRemove }) => {
const nights = stopNights(stop);
return (
@@ -56,23 +39,11 @@ export const RouteStopCard: React.FC<Props> = ({ stop, index, context, onChange,
</button>
)}
</div>
{!readOnly && (
<SegmentedSwitch
value={stop.abroad ? 'abroad' : 'domestic'}
options={LOCATIONS}
onChange={(location) => onChange(stopLocationPatch(location === 'abroad'))}
ariaLabel={`Где точка ${index + 1}`}
/>
)}
<div className={styles.grid}>
<StopPlaceFields stop={stop} onChange={onChange} />
{/* За рубежом страна и город занимают строку — объект встаёт на всю ширину следующей. */}
<FormField
label={stop.abroad ? 'Объект / место назначения' : 'Объект'}
htmlFor={fieldKey.stopProject(stop)}
required
full={stop.abroad}
>
<FormField label="Город, населённый пункт" htmlFor={fieldKey.stopCity(stop)} required>
<TextInput id={fieldKey.stopCity(stop)} value={stop.city} onChange={(v) => onChange({ city: v })} />
</FormField>
<FormField label="Объект" htmlFor={fieldKey.stopProject(stop)} required>
<ProjectPicker
id={fieldKey.stopProject(stop)}
context={context}
@@ -87,8 +58,6 @@ export const RouteStopCard: React.FC<Props> = ({ stop, index, context, onChange,
type="date"
value={stop.dateFrom}
onChange={(v) => onChange({ dateFrom: v })}
// Прошедшие дни в календаре недоступны; набранную вручную дату ловит validation.ts.
min={todaySubmitDate()}
/>
</FormField>
<FormField label="Отъезд" htmlFor={fieldKey.stopTo(stop)} required>
@@ -97,12 +66,10 @@ export const RouteStopCard: React.FC<Props> = ({ stop, index, context, onChange,
type="date"
value={stop.dateTo}
onChange={(v) => onChange({ dateTo: v })}
min={stop.dateFrom || todaySubmitDate()}
min={stop.dateFrom || undefined}
/>
</FormField>
</div>
{/* После города и дат — тогда в заголовке переезда уже видно, куда едут. */}
{inbound}
</div>
);
};
@@ -1,6 +1,6 @@
@import '../../../../../styles/design-tokens';
@import '../../../../../../styles/design-tokens';
// Сегментный переключатель — тот же вид, что «Суммой / Кол-во × цена» в смете (AmountFields).
// Сегментный переключатель — тот же вид, что «Суммой / Кол-во × цена» в смете.
.switch {
display: inline-flex;
align-self: flex-start;
@@ -1,5 +1,5 @@
import * as React from 'react';
import { ISegmentedOption, SegmentedSwitch } from '../SegmentedSwitch';
import styles from './RouteViewSwitch.module.scss';
export type RouteViewMode = 'form' | 'scheme';
@@ -8,12 +8,25 @@ interface Props {
onChange: (mode: RouteViewMode) => void;
}
const MODES: ReadonlyArray<ISegmentedOption<RouteViewMode>> = [
{ value: 'form', label: 'Форма' },
{ value: 'scheme', label: 'Схема' }
const MODES: ReadonlyArray<{ mode: RouteViewMode; label: string }> = [
{ mode: 'form', label: 'Форма' },
{ mode: 'scheme', label: 'Схема' }
];
/** Переключатель вида маршрута: поля для заполнения или схема для просмотра. На печати не нужен. */
/** Переключатель вида маршрута: поля для заполнения или схема для просмотра. */
export const RouteViewSwitch: React.FC<Props> = ({ value, onChange }) => (
<SegmentedSwitch value={value} options={MODES} onChange={onChange} ariaLabel="Вид маршрута" className="rp-no-print" />
<div className={`${styles.switch} rp-no-print`} role="radiogroup" aria-label="Вид маршрута">
{MODES.map(({ mode, label }) => (
<button
key={mode}
type="button"
role="radio"
aria-checked={value === mode}
className={value === mode ? `${styles.option} ${styles.active}` : styles.option}
onClick={() => onChange(mode)}
>
{label}
</button>
))}
</div>
);
@@ -39,7 +39,7 @@ export const SchemeNodeLabel: React.FC<Props> = ({ node }) => {
const dates = stopDates(stop);
return (
<span className={styles.text}>
<span className={styles.city}>{node.city || `Город ${NOT_SET}`}</span>
<span className={styles.city}>{stop.city.trim() || `Город ${NOT_SET}`}</span>
{/* Названия объектов в справочнике бывают с полным адресом — режем до 2 строк, полное — в подсказке. */}
<span className={styles.project} title={stop.project.trim() || undefined}>
{stop.project.trim() || 'объект не выбран'}
@@ -10,8 +10,6 @@ interface Props {
/** Участки между соседними узлами: legs[i] — от nodes[i] к nodes[i + 1]. */
legs: IRouteLeg[];
legTransport: Record<string, string>;
/** Время выезда по ключу участка — только в подсказке плашки, вёрстку схемы не меняет. */
legDepartureTime: Record<string, string>;
onSelectStop?: (stopId: string) => void;
}
@@ -79,7 +77,7 @@ const NodeCell: React.FC<{ node: ISchemeNode; onSelectStop?: (stopId: string) =>
};
/** Широкий экран: ветка слева направо — SVG по координатам + сетка подписей с теми же колонками. */
const HorizontalTrack: React.FC<Props> = ({ nodes, legs, legTransport, legDepartureTime, onSelectStop }) => {
const HorizontalTrack: React.FC<Props> = ({ nodes, legs, legTransport, onSelectStop }) => {
const count = nodes.length;
return (
<div className={styles.hTrack} style={{ minWidth: count * MIN_COLUMN_WIDTH }}>
@@ -118,7 +116,7 @@ const HorizontalTrack: React.FC<Props> = ({ nodes, legs, legTransport, legDepart
</svg>
{legs.map((leg, i) => (
<span key={leg.id} className={styles.hBadge} style={{ left: `${((i + 1) / count) * 100}%` }}>
<TransportBadge leg={leg} transport={legTransport[leg.id] || ''} departureTime={legDepartureTime[leg.id] || ''} />
<TransportBadge leg={leg} transport={legTransport[leg.id] || ''} />
</span>
))}
</div>
@@ -132,7 +130,7 @@ const HorizontalTrack: React.FC<Props> = ({ nodes, legs, legTransport, legDepart
};
/** Телефон: ветка сверху вниз; линия — фоном колонки маркеров, без вычислений геометрии. */
const VerticalTrack: React.FC<Props> = ({ nodes, legs, legTransport, legDepartureTime, onSelectStop }) => (
const VerticalTrack: React.FC<Props> = ({ nodes, legs, legTransport, onSelectStop }) => (
<div className={styles.vTrack}>
{nodes.map((node, i) => {
const leg = legs[i];
@@ -153,7 +151,7 @@ const VerticalTrack: React.FC<Props> = ({ nodes, legs, legTransport, legDepartur
<div className={styles.vRow}>
<span className={styles.vRail} />
<span className={styles.vLeg}>
<TransportBadge leg={leg} transport={legTransport[leg.id] || ''} departureTime={legDepartureTime[leg.id] || ''} />
<TransportBadge leg={leg} transport={legTransport[leg.id] || ''} />
</span>
</div>
)}
@@ -1,51 +0,0 @@
import * as React from 'react';
import { FormField, TextInput } from '../../../../shared/ui';
import { CityPicker } from '../../../../shared/dictionary';
import { ABROAD_CITY_PLACEHOLDER, CITY_PLACEHOLDER, COUNTRY_PLACEHOLDER, IRouteStop } from '../../model';
import { fieldKey } from '../../validation';
interface Props {
stop: IRouteStop;
onChange: (patch: Partial<IRouteStop>) => void;
}
/**
* Где находится точка. По Казахстану — город из справочника КАТО (оба языка + код);
* за рубежом — страна и город вручную: справочник только по РК.
* Рендерит ячейки сетки карточки точки (без своей обёртки).
*/
export const StopPlaceFields: React.FC<Props> = ({ stop, onChange }) => {
if (!stop.abroad) {
return (
<FormField label="Город, населённый пункт" htmlFor={fieldKey.stopCity(stop)} required>
<CityPicker
id={fieldKey.stopCity(stop)}
value={{ name: stop.city, nameKz: stop.cityKz, kato: stop.cityKato }}
onChange={(city) => onChange({ city: city.name, cityKz: city.nameKz, cityKato: city.kato })}
placeholder={CITY_PLACEHOLDER}
/>
</FormField>
);
}
return (
<>
<FormField label="Страна" htmlFor={fieldKey.stopCountry(stop)} required>
<TextInput
id={fieldKey.stopCountry(stop)}
value={stop.country}
onChange={(v) => onChange({ country: v })}
placeholder={COUNTRY_PLACEHOLDER}
/>
</FormField>
<FormField label="Город" htmlFor={fieldKey.stopCity(stop)} required>
<TextInput
id={fieldKey.stopCity(stop)}
value={stop.city}
onChange={(v) => onChange({ city: v })}
placeholder={ABROAD_CITY_PLACEHOLDER}
/>
</FormField>
</>
);
};
@@ -7,20 +7,13 @@ import { TransportIcon } from '../TransportIcon';
interface Props {
leg: IRouteLeg;
transport: string;
/** Время выезда; '' — не указано. */
departureTime: string;
}
/**
* Плашка вида транспорта на линии схемы: иконка + короткая подпись; полная и время
* выезда — в подсказке (на линию не помещаются).
*/
export const TransportBadge: React.FC<Props> = ({ leg, transport, departureTime }) => (
/** Плашка вида транспорта на линии схемы: иконка + короткая подпись; полная — в подсказке. */
export const TransportBadge: React.FC<Props> = ({ leg, transport }) => (
<span
className={transport ? styles.transport : `${styles.transport} ${styles.missing}`}
title={[`${leg.from} → ${leg.to}`, transport, departureTime && `выезд: ${departureTime.toLowerCase()}`]
.filter(Boolean)
.join(', ')}
title={`${leg.from} → ${leg.to}${transport ? `: ${transport}` : ''}`}
>
<TransportIcon type={transport} className={styles.transportIcon} />
{transport ? TRANSPORT_SHORT[transport] || transport : 'транспорт?'}
@@ -8,7 +8,7 @@ export interface ISchemeNode {
number?: number;
/** Сама точка — только у точки маршрута. */
stop?: IRouteStop;
/** Город на двух языках (см. route.ts/stopCityLabel): отправления — у endpoint, точки — у stop. */
/** Город отправления — у endpoint. */
city: string;
/** «выезд 02.10» / «возвращение 05.10» — у endpoint. */
caption?: string;
@@ -1,13 +1,4 @@
import {
EMPTY_ESTIMATE,
EMPTY_ROUTE,
IEstimateArticle,
IEstimateItem,
ITripRoute,
MAX_MRP_PER_DAY,
MAX_NIGHT_PRICE,
MRP_VALUE
} from './model';
import { EMPTY_ESTIMATE, EMPTY_ROUTE, IEstimateArticle, IEstimateItem, ITripRoute, MRP_VALUE } from './model';
import {
addItem,
articleAmount,
@@ -16,28 +7,22 @@ import {
estimateTotal,
formatEstimateText,
itemCalculation,
mrpLimit,
nightPriceLimit,
parseEstimate,
projectShares,
resolveLinkId,
routeItemAutoQuantity,
serializeEstimate,
stopTotals,
syncRouteItems
syncPerDiem
} from './estimate';
const ROUTE: ITripRoute = {
origin: 'Алматы',
originKz: '',
originKato: '',
stops: [
{ id: 's1', abroad: false, country: '', city: 'Атырау', cityKz: '', cityKato: '', project: 'Нефтебаза-2', projectId: 'p1', dateFrom: '2026-10-05', dateTo: '2026-10-08' },
{ id: 's2', abroad: false, country: '', city: 'Актау', cityKz: '', cityKato: '', project: 'Порт Курык', projectId: 'p2', dateFrom: '2026-10-08', dateTo: '2026-10-10' }
{ id: 's1', city: 'Атырау', project: 'Нефтебаза-2', projectId: 'p1', dateFrom: '2026-10-05', dateTo: '2026-10-08' },
{ id: 's2', city: 'Актау', project: 'Порт Курык', projectId: 'p2', dateFrom: '2026-10-08', dateTo: '2026-10-10' }
],
returnToOrigin: true,
legTransport: {},
legDepartureTime: {}
legTransport: {}
};
const item = (patch: Partial<IEstimateItem>): IEstimateItem => ({
@@ -49,7 +34,6 @@ const item = (patch: Partial<IEstimateItem>): IEstimateItem => ({
price: '',
comment: '',
mrpCount: '',
quantityManual: '',
...patch
});
@@ -137,7 +121,7 @@ describe('суточные по маршруту', () => {
};
it('по позиции на точку; день переезда считается один раз', () => {
const [synced] = syncRouteItems([perDiem], ROUTE);
const [synced] = syncPerDiem([perDiem], ROUTE);
expect(synced.items.map((i) => [i.linkId, i.quantity])).toEqual([
['s1', '4'],
['s2', '2']
@@ -145,58 +129,32 @@ describe('суточные по маршруту', () => {
});
it('ставка — кол-во МРП × МРП; введённое за точкой сохраняется', () => {
const [synced] = syncRouteItems([perDiem], ROUTE);
const [synced] = syncPerDiem([perDiem], ROUTE);
expect(synced.items[0]).toMatchObject({ id: 'p1', mrpCount: '6', comment: 'объект', price: String(6 * MRP_VALUE) });
expect(articleAmount(synced)).toBe(4 * 6 * MRP_VALUE);
});
it('новая точка — пустая позиция со стабильным id; удалённая точка — позиция уходит', () => {
const [synced] = syncRouteItems([perDiem], ROUTE);
const [synced] = syncPerDiem([perDiem], ROUTE);
expect(synced.items[1]).toMatchObject({ id: 'perDiem-s2', mrpCount: '', price: '' });
const [oneStop] = syncRouteItems([perDiem], { ...ROUTE, stops: [ROUTE.stops[1]] });
const [oneStop] = syncPerDiem([perDiem], { ...ROUTE, stops: [ROUTE.stops[1]] });
expect(oneStop.items.map((i) => i.linkId)).toEqual(['s2']);
});
it('без дат дней нет — и суммы нет', () => {
const noDates = { ...ROUTE, stops: [{ ...ROUTE.stops[0], dateTo: '' }] };
const [synced] = syncRouteItems([perDiem], noDates);
const [synced] = syncPerDiem([perDiem], noDates);
expect(synced.items[0].quantity).toBe('');
expect(articleAmount(synced)).toBe(0);
});
it('статьи с ручными позициями не трогает', () => {
expect(syncRouteItems([travel], ROUTE)[0]).toBe(travel);
});
it('проживание: позиция на точку, ночи из дат, введённая цена сохраняется', () => {
const [synced] = syncRouteItems([hotels], ROUTE);
expect(synced.items.map((i) => [i.linkId, i.quantity, i.price])).toEqual([
['s1', '3', '36000'],
['s2', '2', '35000']
]);
expect(synced.items[0]).toMatchObject({ id: 'h1', mode: 'calc', comment: 'Ренессанс' });
});
it('дни/ночи вручную — любое число поверх расчёта по датам; пусто — снова по датам', () => {
const manual = { ...perDiem, items: [{ ...perDiem.items[0], quantityManual: '7' }] };
const [synced] = syncRouteItems([manual], ROUTE);
expect(synced.items[0].quantity).toBe('7');
expect(articleAmount({ ...synced, items: [synced.items[0]] })).toBe(7 * 6 * MRP_VALUE);
expect(itemCalculation('perDiem', synced.items[0])).toContain('7 дней (вручную)');
const [auto] = syncRouteItems([{ ...manual, items: [{ ...manual.items[0], quantityManual: '' }] }], ROUTE);
expect(auto.items[0].quantity).toBe('4');
expect(routeItemAutoQuantity('accommodation', ROUTE, 's1')).toBe('3');
});
it('лимиты зависят от страны точки', () => {
const abroad = { ...ROUTE.stops[0], abroad: true };
expect([mrpLimit(ROUTE.stops[0]), mrpLimit(abroad)]).toEqual([MAX_MRP_PER_DAY.domestic, MAX_MRP_PER_DAY.abroad]);
expect([nightPriceLimit(ROUTE.stops[0]), nightPriceLimit(abroad)]).toEqual([MAX_NIGHT_PRICE.domestic, MAX_NIGHT_PRICE.abroad]);
it('другие статьи не трогает', () => {
expect(syncPerDiem([hotels], ROUTE)[0]).toBe(hotels);
});
it('расчёт в тексте — с МРП, по сохранённой ставке', () => {
const NBSP = String.fromCharCode(160);
const [synced] = syncRouteItems([perDiem], ROUTE);
const [synced] = syncPerDiem([perDiem], ROUTE);
expect(itemCalculation('perDiem', synced.items[0]).split(NBSP).join(' ')).toBe(
`4 дня × 6 МРП × ${new Intl.NumberFormat('ru-RU').format(MRP_VALUE).split(NBSP).join(' ')} ₸`
);
@@ -6,13 +6,10 @@ import {
EstimateKind,
IEstimateArticle,
IEstimateItem,
IRouteStop,
ITripRoute,
MAX_MRP_PER_DAY,
MAX_NIGHT_PRICE,
MRP_VALUE
} from './model';
import { legLabel, newId, routeLegs, stopLabel, stopNights, stopPerDiemDays } from './route';
import { legLabel, newId, routeLegs, stopLabel, stopPerDiemDays } from './route';
import { plural } from './tripData';
/** Цифры из поля ввода числом: '' или мусор — 0. MoneyInput хранит только цифры. */
@@ -57,15 +54,10 @@ function itemMrpValue(item: IEstimateItem): number {
}
/** Расчёт суточных: «4 дня × 6 МРП × 4 325 ₸»; дни или МРП не заданы — ''. */
/** Пометка у дней/ночей, введённых вручную, — согласующему важно видеть, что их правили. */
function manualMark(item: IEstimateItem): string {
return item.quantityManual ? ' (вручную)' : '';
}
function perDiemCalculation(item: IEstimateItem): string {
if (!item.quantity || !toNumber(item.mrpCount)) return '';
const days = plural(toNumber(item.quantity), ['день', 'дня', 'дней']);
return `${days}${manualMark(item)} × ${item.mrpCount} МРП × ${formatAmount(itemMrpValue(item))} ₸`;
return `${days} × ${item.mrpCount} МРП × ${formatAmount(itemMrpValue(item))} ₸`;
}
/**
@@ -74,9 +66,9 @@ function perDiemCalculation(item: IEstimateItem): string {
* понятно из статьи. Суточные — исключение: там важно показать МРП.
*/
export function itemCalculation(kind: EstimateKind, item: IEstimateItem): string {
if (kind === 'perDiem') return perDiemCalculation(item);
if (ESTIMATE_KINDS[kind].itemsFromRoute) return perDiemCalculation(item);
if (item.mode !== 'calc' || !item.quantity || !item.price) return '';
return `${formatAmount(toNumber(item.quantity))}${manualMark(item)} × ${formatAmount(toNumber(item.price))} ₸`;
return `${formatAmount(toNumber(item.quantity))} × ${formatAmount(toNumber(item.price))} ₸`;
}
// ---------------------------------------------------------------------------
@@ -124,8 +116,7 @@ export function createItem(kind: EstimateKind, linkId: string): IEstimateItem {
quantity: '',
price: '',
comment: '',
mrpCount: '',
quantityManual: ''
mrpCount: ''
};
}
@@ -141,22 +132,9 @@ export function createArticle(kind: EstimateKind, route: ITripRoute): IEstimateA
}
// ---------------------------------------------------------------------------
// Суточные и проживание — строятся по маршруту
// Суточные — строятся по маршруту
// ---------------------------------------------------------------------------
/** Сколько МРП в день можно поставить в точке: по Казахстану и за рубежом лимиты разные. */
export function mrpLimit(stop: IRouteStop | undefined): number {
return stop?.abroad ? MAX_MRP_PER_DAY.abroad : MAX_MRP_PER_DAY.domestic;
}
/** Предельная цена ночи в точке, ₸; undefined — без лимита (за рубежом пока не задан). */
export function nightPriceLimit(stop: IRouteStop | undefined): number | undefined {
return stop?.abroad ? MAX_NIGHT_PRICE.abroad : MAX_NIGHT_PRICE.domestic;
}
/** Число или пустая строка для поля: undefined (дат нет) — ''. */
const countText = (count: number | undefined): string => (count === undefined ? '' : String(count));
/** Ставка суточных в день цифрами: кол-во МРП × МРП. Кол-во не введено — ''. */
function perDiemRate(mrpCount: string): string {
const count = toNumber(mrpCount);
@@ -164,39 +142,26 @@ function perDiemRate(mrpCount: string): string {
}
/**
* Дни/ночи позиции «по маршруту» по датам точки: суточные — дни (день переезда
* один раз), проживание — ночи. '' — даты точки не заданы или точки нет.
*/
export function routeItemAutoQuantity(kind: EstimateKind, route: ITripRoute, stopId: string): string {
const index = route.stops.findIndex((s) => s.id === stopId);
if (index === -1) return '';
return kind === 'accommodation' ? countText(stopNights(route.stops[index])) : countText(stopPerDiemDays(route, index));
}
/**
* Количество и цена позиции «по маршруту»: дни/ночи — введённые вручную, иначе по
* датам точки; цена — суточные: кол-во МРП × MRP_VALUE, проживание: что ввёл человек.
*/
function routeItemFigures(kind: EstimateKind, base: IEstimateItem, route: ITripRoute, stopId: string): Partial<IEstimateItem> {
const quantity = base.quantityManual || routeItemAutoQuantity(kind, route, stopId);
return { quantity, price: kind === 'accommodation' ? base.price : perDiemRate(base.mrpCount) };
}
/**
* Позиции статей «по маршруту» (суточные, проживание) приводятся к маршруту:
* ровно одна позиция на точку, дни/ночи — из дат точки. Человек вводит только
* кол-во МРП или цену за ночь (и пояснение) — они сохраняются за точкой.
* Позиции статей «по маршруту» (суточные) приводятся к маршруту: ровно одна
* позиция на точку, дни — из дат точки, ставка — кол-во МРП × MRP_VALUE.
* Человек вводит только кол-во МРП (и пояснение) — они сохраняются за точкой.
* Применяется в форме при каждом рендере и перед сохранением; просмотр берёт
* сохранённое как есть — чтобы не пересчитать старую заявку по новому МРП.
*/
export function syncRouteItems(articles: IEstimateArticle[], route: ITripRoute): IEstimateArticle[] {
export function syncPerDiem(articles: IEstimateArticle[], route: ITripRoute): IEstimateArticle[] {
return articles.map((article) => {
if (!ESTIMATE_KINDS[article.kind].itemsFromRoute) return article;
const items = route.stops.map((stop): IEstimateItem => {
const items = route.stops.map((stop, index): IEstimateItem => {
const existing = article.items.find((item) => item.linkId === stop.id);
// id от точки, а не случайный: иначе строка пересоздавалась бы на каждом рендере.
const base = existing || { ...createItem(article.kind, stop.id), id: `${article.kind}-${stop.id}` };
return { ...base, mode: 'calc', ...routeItemFigures(article.kind, base, route, stop.id) };
const days = stopPerDiemDays(route, index);
return {
...base,
mode: 'calc',
quantity: days === undefined ? '' : String(days),
price: perDiemRate(base.mrpCount)
};
});
return { ...article, items };
});
@@ -349,8 +314,7 @@ function toItem(value: unknown): IEstimateItem | undefined {
quantity: text(raw.quantity),
price: text(raw.price),
comment: text(raw.comment),
mrpCount: text(raw.mrpCount),
quantityManual: text(raw.quantityManual)
mrpCount: text(raw.mrpCount)
};
}
@@ -28,12 +28,10 @@ export async function loadBusinessTripRequest(itemId: number, listId?: string):
'SubmitDate',
'Position',
'Organization',
'TripCompany',
'TripCompanyId',
'TripRouteJson',
'TripPurpose',
'TripTasksJson',
'TripEstimateJson',
'TripComment',
'TripObligationAccepted',
'RequestStatus',
'RequestUniqueCode',
@@ -49,12 +47,10 @@ export async function loadBusinessTripRequest(itemId: number, listId?: string):
Employee: employee?.EMail || '',
Position: (item.Position as string) || '',
Organization: (item.Organization as string) || '',
TripCompany: (item.TripCompany as string) || '',
TripCompanyId: (item.TripCompanyId as string) || '',
Route: parseRoute(item.TripRouteJson),
TripPurpose: (item.TripPurpose as string) || '',
Tasks: parseTasks(item.TripTasksJson),
Estimate: parseEstimate(item.TripEstimateJson),
TripComment: (item.TripComment as string) || '',
TripObligationAccepted: item.TripObligationAccepted === true
};
@@ -1,7 +1,6 @@
// import type — чтобы тесты (route/estimate/validation) не тянули SPFx-рантайм через модель.
import type { WebPartContext } from '@microsoft/sp-webpart-base';
import type { RequestTypeId } from '../../models/types';
import type { IEmployeeOrganization } from '../../shared/dictionary';
/**
* Тип заявки этой формы — ключ реестра форм (forms/registry.ts). Имена списков
@@ -20,26 +19,10 @@ export const FORM_TITLE = 'Заявка на командировку';
export interface IRouteStop {
/** Стабильный ключ точки: на него ссылаются позиции сметы (IEstimateItem.linkId). */
id: string;
/**
* true — точка за рубежом: страна и город вводятся вручную (справочник КАТО только по РК),
* у суточных и проживания свои лимиты. Признак у точки, а не у поездки: бывают смешанные
* маршруты (Алматы → Москва → Атырау).
*/
abroad: boolean;
/** Страна — только у зарубежной точки; у точки по Казахстану ''. */
country: string;
/** Город на русском — из справочника КАТО (shared/dictionary/kato) или введён вручную. */
city: string;
/** Город на казахском; '' — введён вручную (в справочнике не нашёлся). */
cityKz: string;
/** Код КАТО города; '' — введён вручную. */
cityKato: string;
/** Объект — проект из справочника /Project (см. shared/dictionary/ProjectPicker). */
project: string;
/**
* oid проекта; '' — текст введён вручную без выбора из списка. По Казахстану отправка
* такое не пропустит; за рубежом можно — там объект часто чужой (завод, выставка).
*/
/** oid проекта; '' — текст введён вручную без выбора из списка (отправка не пропустит). */
projectId: string;
/** YYYY-MM-DD — прибытие в точку. */
dateFrom: string;
@@ -54,37 +37,18 @@ export interface IRouteStop {
* участка по его ключу.
*/
export interface ITripRoute {
/** Город отправления (обычно город работы), на русском. */
/** Город отправления (обычно город работы). */
origin: string;
/** Город отправления на казахском; '' — введён вручную. */
originKz: string;
/** Код КАТО города отправления; '' — введён вручную. */
originKato: string;
stops: IRouteStop[];
/** Обратный путь из последней точки в город отправления. */
returnToOrigin: boolean;
/** Вид транспорта по ключу участка (ключ — legId из route.ts). */
legTransport: Record<string, string>;
/** Предпочтительное время выезда по ключу участка (DEPARTURE_TIMES); нет ключа — не указано. */
legDepartureTime: Record<string, string>;
}
/** Предпочтительное время выезда на участке (требования кадров 10-23); необязательно. */
export const DEPARTURE_TIMES: ReadonlyArray<string> = ['Утро', 'День', 'Вечер', 'Ночь'];
/** Ключ «точки» города отправления в ключах участков. */
export const ORIGIN_ID = 'origin';
/**
* Вид поездки — значения Choice-колонки TripKind. Выводится из точек: хотя бы одна
* за рубежом — вся поездка зарубежная (по ней будут маршрут согласования и отчёты).
*/
export const TRIP_KIND = {
domestic: 'По Казахстану',
abroad: 'Зарубежная'
} as const;
export type TripKind = (typeof TRIP_KIND)[keyof typeof TRIP_KIND];
/**
* Вид транспорта участка. Предположение: в бланке список не задан — варианты
* взяты типовые; поправить здесь, если кадры используют другие.
@@ -92,7 +56,7 @@ export type TripKind = (typeof TRIP_KIND)[keyof typeof TRIP_KIND];
export const TRANSPORT_TYPES: ReadonlyArray<string> = [
'Авиа',
'Железнодорожный',
'Такси',
'Автобус',
'Служебный автотранспорт',
'Личный автотранспорт'
];
@@ -101,7 +65,7 @@ export const TRANSPORT_TYPES: ReadonlyArray<string> = [
export const TRANSPORT_SHORT: Record<string, string> = {
Авиа: 'Авиа',
Железнодорожный: 'Ж/д',
Такси: 'Такси',
Автобус: 'Автобус',
'Служебный автотранспорт': 'Служебное авто',
'Личный автотранспорт': 'Личное авто'
};
@@ -137,15 +101,9 @@ export interface IEstimateItem {
/**
* Только у суточных: количество МРП в день (цифры). Из него и MRP_VALUE
* считается ставка (price), дни (quantity) — из дат точки маршрута, см.
* estimate.ts/syncRouteItems. У остальных статей — ''.
* estimate.ts/syncPerDiem. У остальных статей — ''.
*/
mrpCount: string;
/**
* Только у позиций «по маршруту» (суточные, проживание): дни/ночи, введённые
* вручную поверх расчёта по датам — бывает форс-мажор (задержался в точке).
* Любое число, без ограничений. '' — считать по датам точки.
*/
quantityManual: string;
}
/** Статья сметы — заголовок с позициями внутри. */
@@ -172,7 +130,7 @@ export interface IEstimateKindInfo {
link: EstimateLinkTarget;
/**
* true — позиции не добавляются вручную, а строятся по точкам маршрута (по
* одной на точку) и считаются сами — так устроены суточные (дни) и проживание (ночи).
* одной на точку) и считаются сами — так устроены суточные.
*/
itemsFromRoute: boolean;
quantityLabel: string;
@@ -210,8 +168,7 @@ export const ESTIMATE_KINDS: Record<EstimateKind, IEstimateKindInfo> = {
core: true,
defaultMode: 'calc',
link: 'stop',
// Ночи — из дат точки, человек вводит только цену за ночь (с 10-23, по требованию кадров).
itemsFromRoute: true,
itemsFromRoute: false,
quantityLabel: 'Ночей',
priceLabel: 'Цена за ночь',
commentPlaceholder: 'Гостиница, адрес (необязательно)',
@@ -271,21 +228,6 @@ export const ESTIMATE_KIND_ORDER: ReadonlyArray<EstimateKind> = [
export const MRP_VALUE = 4325;
export const MRP_YEAR = 2026;
/** Самая длинная командировка, дней включительно (требования кадров 10-23). */
export const MAX_TRIP_DAYS = 40;
/** Лимит суточных, МРП в день (требования кадров 10-23): за рубежом выше. */
export const MAX_MRP_PER_DAY = { domestic: 6, abroad: 8 } as const;
/**
* Лимит цены проживания за ночь, ₸. За рубежом кадры лимит пока не назвали —
* undefined значит «без лимита»; когда назовут, вписать число сюда.
*/
export const MAX_NIGHT_PRICE: { domestic: number; abroad: number | undefined } = {
domestic: 15000,
abroad: undefined
};
/** Статьи, которые добавляются кнопкой не больше одного раза (другой расход — сколько угодно). */
export const SINGLE_OPTIONAL_KINDS: ReadonlyArray<EstimateKind> = ['insurance', 'visa'];
@@ -311,23 +253,15 @@ export interface IFormData {
Position: string;
/** Организации сотрудника (`\n`-joined «Компания — должность»), read-only, см. OrganizationField. */
Organization: string;
/**
* От какой компании едет сотрудник — одна из его организаций (Employee/ByEmail).
* Сотрудник может работать в нескольких компаниях, а командирует только одна.
*/
TripCompany: string;
/** CompanyId выбранной организации из справочника; '' — не выбрана. */
TripCompanyId: string;
Route: ITripRoute;
TripPurpose: string;
/** Задание на командировку — список задач по порядку. */
Tasks: string[];
/** Смета: основные статьи + добавленные (суммы вводятся вручную). */
Estimate: IEstimateArticle[];
/** Комментарий к заявке — после итога сметы, необязательный. */
TripComment: string;
/** Сотрудник принял обязательство по авансовому отчёту (см. OBLIGATION_TEXT). */
TripObligationAccepted: boolean;
@@ -336,40 +270,28 @@ export interface IFormData {
/** Обновление одного поля формы с сохранением типа значения. */
export type SetField = <K extends keyof IFormData>(key: K, value: IFormData[K]) => void;
/** Сотрудник заявки и выбор организации, от которой он едет (см. useTripEmployee). */
export interface ITripEmployee {
/** Организации текущего сотрудника — варианты «Командирующей организации». */
organizations: IEmployeeOrganization[];
onEmployeeChange: (login: string) => void;
/** key — значение варианта (см. tripCompany.ts/companyKey); '' — сбросить выбор. */
onCompanyChange: (key: string) => void;
}
/** Пропсы секции формы: срез данных + колбэк обновления + контекст (people picker / справочники). */
export interface ISectionProps {
data: IFormData;
set: SetField;
context: WebPartContext;
/**
* Выбор сотрудника и организации подтягивает должность и организации — поэтому
* у этих полей свои обработчики. Не передан (режим чтения) — правка через set.
* Выбор сотрудника подтягивает его должность и организации — поэтому у поля
* отдельный обработчик. Не передан (режим чтения) — правка через set.
*/
employee?: ITripEmployee;
onEmployeeChange?: (login: string) => void;
}
export const DEFAULT_PURPOSE = 'Производственная необходимость';
/** Первая точка новой заявки. id фиксированный: у новой заявки на неё ссылаются позиции сметы. */
export const FIRST_STOP_ID = 'stop-1';
export const EMPTY_ROUTE: ITripRoute = {
origin: '',
originKz: '',
originKato: '',
stops: [
{ id: FIRST_STOP_ID, abroad: false, country: '', city: '', cityKz: '', cityKato: '', project: '', projectId: '', dateFrom: '', dateTo: '' }
],
stops: [{ id: FIRST_STOP_ID, city: '', project: '', projectId: '', dateFrom: '', dateTo: '' }],
returnToOrigin: true,
legTransport: {},
legDepartureTime: {}
legTransport: {}
};
function emptyItem(kind: EstimateKind, linkId: string): IEstimateItem {
@@ -381,8 +303,7 @@ function emptyItem(kind: EstimateKind, linkId: string): IEstimateItem {
quantity: '',
price: '',
comment: '',
mrpCount: '',
quantityManual: ''
mrpCount: ''
};
}
@@ -406,13 +327,11 @@ export const EMPTY_DATA: IFormData = {
Employee: '',
Position: '',
Organization: '',
TripCompany: '',
TripCompanyId: '',
Route: EMPTY_ROUTE,
TripPurpose: DEFAULT_PURPOSE,
// Новая заявка сразу показывает одну пустую строку задачи — понятнее, что заполнять.
Tasks: [''],
Estimate: EMPTY_ESTIMATE,
TripComment: '',
TripObligationAccepted: false
};
@@ -426,7 +345,4 @@ export const OBLIGATION_TEXT =
export const OBLIGATION_LABEL = 'Ознакомлен(а) и согласен(на)';
export const EMPLOYEE_PLACEHOLDER = 'Начните вводить Ф.И.О. сотрудника…';
export const COUNTRY_PLACEHOLDER = 'Напр.: Китай';
export const ABROAD_CITY_PLACEHOLDER = 'Напр.: Пекин';
export const CITY_PLACEHOLDER ='Начните вводить город: Атырау, Құлсары…';
export const PROJECT_PLACEHOLDER ='Начните вводить название или код объекта…';
export const PROJECT_PLACEHOLDER = 'Начните вводить название или код объекта…';
@@ -8,10 +8,7 @@
{ "internalName": "Employee", "title": "Сотрудник", "type": "User", "userSelectionMode": "PeopleOnly", "required": true },
{ "internalName": "Position", "title": "Должность", "type": "Text" },
{ "internalName": "Organization", "title": "Организация", "type": "Note" },
{ "internalName": "TripCompany", "title": "Командирующая организация", "type": "Text" },
{ "internalName": "TripCompanyId", "title": "Id командирующей организации (справочник)", "type": "Text" },
{ "internalName": "TripKind", "title": "Вид командировки", "type": "Choice", "choices": ["По Казахстану", "Зарубежная"] },
{ "internalName": "TripRouteJson", "title": "Маршрут (JSON)", "type": "Note" },
{ "internalName": "TripRoute", "title": "Маршрут", "type": "Note" },
{ "internalName": "TripCity", "title": "Города", "type": "Text" },
@@ -21,6 +18,7 @@
{ "internalName": "TripStartDate", "title": "Командировка с", "type": "DateTime", "dateOnly": true },
{ "internalName": "TripEndDate", "title": "Командировка по", "type": "DateTime", "dateOnly": true },
{ "internalName": "TripDaysCount", "title": "Дней командировки", "type": "Number" },
{ "internalName": "TripPurpose", "title": "Цель командировки", "type": "Note" },
{ "internalName": "TripTasks", "title": "Задание на командировку", "type": "Note" },
{ "internalName": "TripTasksJson", "title": "Задание на командировку (JSON)", "type": "Note" },
@@ -28,7 +26,6 @@
{ "internalName": "TripEstimate", "title": "Смета на командировку", "type": "Note" },
{ "internalName": "TripEstimateJson", "title": "Смета на командировку (JSON)", "type": "Note" },
{ "internalName": "TripEstimateTotal", "title": "Итого по смете, тенге", "type": "Number" },
{ "internalName": "TripComment", "title": "Комментарий", "type": "Note" },
{ "internalName": "TripObligationAccepted", "title": "Обязательство по авансовому отчёту принято", "type": "Boolean" }
]
@@ -1,4 +1,4 @@
import { EMPTY_ROUTE, ITripRoute, TRIP_KIND } from './model';
import { EMPTY_ROUTE, ITripRoute } from './model';
import {
createStop,
legLabel,
@@ -9,23 +9,17 @@ import {
routeProjects,
routeText,
serializeRoute,
stopLocationPatch,
stopNights,
tripKind,
withoutStopLegs
stopNights
} from './route';
const ROUTE: ITripRoute = {
origin: 'Алматы',
originKz: '',
originKato: '',
stops: [
{ id: 's1', abroad: false, country: '', city: 'Атырау', cityKz: '', cityKato: '', project: 'Нефтебаза-2', projectId: 'p1', dateFrom: '2026-10-05', dateTo: '2026-10-08' },
{ id: 's2', abroad: false, country: '', city: 'Актау', cityKz: '', cityKato: '', project: 'Порт Курык', projectId: 'p2', dateFrom: '2026-10-08', dateTo: '2026-10-10' }
{ id: 's1', city: 'Атырау', project: 'Нефтебаза-2', projectId: 'p1', dateFrom: '2026-10-05', dateTo: '2026-10-08' },
{ id: 's2', city: 'Актау', project: 'Порт Курык', projectId: 'p2', dateFrom: '2026-10-08', dateTo: '2026-10-10' }
],
returnToOrigin: true,
legTransport: { 'origin>s1': 'Авиа' },
legDepartureTime: {}
legTransport: { 'origin>s1': 'Авиа' }
};
describe('участки пути', () => {
@@ -54,42 +48,10 @@ describe('сводка маршрута', () => {
);
});
it('город из справочника — на двух языках, если названия различаются', () => {
const route: ITripRoute = {
...ROUTE,
origin: 'Уральск',
originKz: 'Орал',
stops: [{ ...ROUTE.stops[0], city: 'Кульсары', cityKz: 'Құлсары' }, { ...ROUTE.stops[1], cityKz: 'Актау' }],
returnToOrigin: false
};
expect(routeCities(route)).toBe('Кульсары (Құлсары), Актау');
expect(routeLegs(route).map(legLabel)).toEqual(['Уральск (Орал) → Кульсары (Құлсары)', 'Кульсары (Құлсары) → Актау']);
});
it('новая точка начинается с даты отъезда из предыдущей', () => {
expect(createStop(ROUTE.stops[1]).dateFrom).toBe('2026-10-10');
expect(createStop(undefined).dateFrom).toBe('');
});
it('зарубежная точка: страна и город, поездка зарубежная', () => {
const beijing = { ...ROUTE.stops[1], abroad: true, country: 'Китай', city: 'Пекин' };
const route: ITripRoute = { ...ROUTE, stops: [ROUTE.stops[0], beijing] };
expect(routeCities(route)).toBe('Атырау, Китай, Пекин');
expect(tripKind(route)).toBe(TRIP_KIND.abroad);
expect(tripKind(ROUTE)).toBe(TRIP_KIND.domestic);
// Следующая точка — в той же стране, что предыдущая.
expect([createStop(beijing).abroad, createStop(beijing).country]).toEqual([true, 'Китай']);
});
it('удалили точку — транспорт и время выезда её участков уходят', () => {
const times = { 'origin>s1': 'Утро', 's1>s2': 'Вечер', 's2>origin': 'Ночь' };
expect(withoutStopLegs(times, 's2')).toEqual({ 'origin>s1': 'Утро' });
});
it('смена «Казахстан / другая страна» сбрасывает чужие поля, город остаётся', () => {
expect(stopLocationPatch(true)).toEqual({ abroad: true, cityKz: '', cityKato: '' });
expect(stopLocationPatch(false)).toEqual({ abroad: false, country: '' });
});
});
describe('хранение маршрута', () => {
@@ -97,15 +59,6 @@ describe('хранение маршрута', () => {
expect(parseRoute(serializeRoute(ROUTE))).toEqual(ROUTE);
});
it('старая заявка (до КАТО и признака страны) — город как был, точка по Казахстану', () => {
const old = { origin: 'Алматы', stops: [{ id: 's1', city: 'Атырау', project: '', projectId: '', dateFrom: '', dateTo: '' }] };
const route = parseRoute(JSON.stringify(old));
expect([route.originKz, route.stops[0].cityKz, route.stops[0].cityKato]).toEqual(['', '', '']);
expect([route.stops[0].abroad, route.stops[0].country]).toEqual([false, '']);
expect(route.legDepartureTime).toEqual({});
expect(routeCities(route)).toBe('Атырау');
});
it('битый JSON или маршрут без точек — маршрут новой заявки', () => {
expect(parseRoute('{oops')).toEqual(EMPTY_ROUTE);
expect(parseRoute(JSON.stringify({ origin: 'Алматы', stops: [] }))).toEqual(EMPTY_ROUTE);
@@ -1,7 +1,5 @@
import { formatIsoDate } from '../../shared/dateUtils';
// Прямой импорт, не через shared/dictionary: индекс тянет сервисы с sp-http, а route.ts тестируется без SPFx.
import { cityLabel } from '../../shared/dictionary/kato/cityLabel';
import { EMPTY_ROUTE, IRouteStop, ITripRoute, ORIGIN_ID, TRIP_KIND, TripKind } from './model';
import { EMPTY_ROUTE, IRouteStop, ITripRoute, ORIGIN_ID } from './model';
import { tripDays } from './tripData';
/** Участок пути (переезд) между двумя соседними точками маршрута. */
@@ -26,36 +24,8 @@ export function newId(prefix: string): string {
const ORIGIN_FALLBACK = 'Город отправления';
const STOP_FALLBACK = 'Точка маршрута';
/**
* Город точки: по Казахстану — на двух языках «Кульсары (Құлсары)», за рубежом —
* страна и город «Китай, Пекин». '' — не указан.
*/
export function stopCityLabel(stop: IRouteStop): string {
if (!stop.abroad) return cityLabel(stop.city, stop.cityKz);
return [stop.country.trim(), stop.city.trim()].filter(Boolean).join(', ');
}
/**
* Поля точки при смене «Казахстан / другая страна». Введённый город остаётся, но
* за рубежом он уже не из справочника КАТО (казахское название и код сбрасываются),
* а у точки по Казахстану страны нет.
*/
export function stopLocationPatch(abroad: boolean): Partial<IRouteStop> {
return abroad ? { abroad: true, cityKz: '', cityKato: '' } : { abroad: false, country: '' };
}
/** Вид поездки для колонки TripKind: хотя бы одна точка за рубежом — зарубежная. */
export function tripKind(route: ITripRoute): TripKind {
return route.stops.some((s) => s.abroad) ? TRIP_KIND.abroad : TRIP_KIND.domestic;
}
/** Город отправления на двух языках; '' — не указан. */
export function originLabel(route: ITripRoute): string {
return cityLabel(route.origin, route.originKz);
}
function stopCity(stop: IRouteStop): string {
return stopCityLabel(stop) || STOP_FALLBACK;
return stop.city.trim() || STOP_FALLBACK;
}
/** Подпись точки в выпадающих списках сметы: «Атырау · Нефтебаза-2». */
@@ -70,7 +40,7 @@ export function stopLabel(stop: IRouteStop): string {
* участки пересобрались сами.
*/
export function routeLegs(route: ITripRoute): IRouteLeg[] {
const origin = { id: ORIGIN_ID, name: originLabel(route) || ORIGIN_FALLBACK };
const origin = { id: ORIGIN_ID, name: route.origin.trim() || ORIGIN_FALLBACK };
const points = [origin, ...route.stops.map((s) => ({ id: s.id, name: stopCity(s) }))];
if (route.returnToOrigin) points.push(origin);
@@ -121,7 +91,7 @@ const unique = (values: string[]): string[] =>
/** Города точек через запятую — для колонки TripCity и заголовка элемента. */
export function routeCities(route: ITripRoute): string {
return unique(route.stops.map(stopCityLabel)).join(', ');
return unique(route.stops.map((s) => s.city)).join(', ');
}
/** Объекты точек (без повторов) — для колонки TripProjects. */
@@ -136,28 +106,23 @@ function stopDates(stop: IRouteStop): string {
/** Маршрут читаемым текстом для колонки SP: «Алматы → Атырау (Нефтебаза-2, 05.10.2026–08.10.2026) → Алматы». */
export function routeText(route: ITripRoute): string {
const parts: string[] = [originLabel(route) || ORIGIN_FALLBACK];
const parts: string[] = [route.origin.trim() || ORIGIN_FALLBACK];
route.stops.forEach((stop) => {
const details = [stop.project.trim(), stopDates(stop)].filter(Boolean).join(', ');
parts.push(details ? `${stopCity(stop)} (${details})` : stopCity(stop));
});
if (route.returnToOrigin) parts.push(originLabel(route) || ORIGIN_FALLBACK);
if (route.returnToOrigin) parts.push(route.origin.trim() || ORIGIN_FALLBACK);
return parts.join(' → ');
}
/**
* Новая точка после последней. Дата прибытия — дата отъезда из предыдущей точки,
* страна (Казахстан / другая) — как у предыдущей: это не догадка, а то, что
* человек сам уже ввёл; поля остаются редактируемыми.
* Новая точка после последней. Дата прибытия — дата отъезда из предыдущей точки:
* это не догадка, а то, что человек сам уже ввёл; поле остаётся редактируемым.
*/
export function createStop(previous: IRouteStop | undefined): IRouteStop {
return {
id: newId('stop'),
abroad: previous?.abroad ?? false,
country: previous?.abroad ? previous.country : '',
city: '',
cityKz: '',
cityKato: '',
project: '',
projectId: '',
dateFrom: previous?.dateTo || '',
@@ -178,13 +143,7 @@ function toStop(value: unknown): IRouteStop | undefined {
if (!id) return undefined;
return {
id,
// Заявки до признака «другая страна» — все точки по Казахстану.
abroad: raw.abroad === true,
country: text(raw.country),
city: text(raw.city),
// Заявки до справочника КАТО — без этих полей: город остаётся введённым вручную.
cityKz: text(raw.cityKz),
cityKato: text(raw.cityKato),
project: text(raw.project),
projectId: text(raw.projectId),
dateFrom: text(raw.dateFrom),
@@ -192,28 +151,16 @@ function toStop(value: unknown): IRouteStop | undefined {
};
}
/** Словарь «ключ участка → значение» (вид транспорта, время выезда); не строки отбрасываются. */
function toLegRecord(value: unknown): Record<string, string> {
function toTransport(value: unknown): Record<string, string> {
if (!value || typeof value !== 'object') return {};
const result: Record<string, string> = {};
Object.keys(value as object).forEach((key) => {
const entry = (value as Record<string, unknown>)[key];
if (typeof entry === 'string') result[key] = entry;
const type = (value as Record<string, unknown>)[key];
if (typeof type === 'string') result[key] = type;
});
return result;
}
/** Убрать из словаря участков те, что шли через точку stopId (её удалили из маршрута). */
export function withoutStopLegs(record: Record<string, string>, stopId: string): Record<string, string> {
const result: Record<string, string> = {};
Object.keys(record)
.filter((key) => key.split('>').indexOf(stopId) === -1)
.forEach((key) => {
result[key] = record[key];
});
return result;
}
/** Разобрать TripRouteJson. Битый JSON или маршрут без точек — маршрут новой заявки. */
export function parseRoute(raw: unknown): ITripRoute {
let parsed: unknown;
@@ -230,12 +177,8 @@ export function parseRoute(raw: unknown): ITripRoute {
if (stops.length === 0) return EMPTY_ROUTE;
return {
origin: text(rawRoute.origin),
originKz: text(rawRoute.originKz),
originKato: text(rawRoute.originKato),
stops,
returnToOrigin: rawRoute.returnToOrigin !== false,
legTransport: toLegRecord(rawRoute.legTransport),
// Заявки до времени выезда — без этого поля: время просто не указано.
legDepartureTime: toLegRecord(rawRoute.legDepartureTime)
legTransport: toTransport(rawRoute.legTransport)
};
}
@@ -1,49 +1,28 @@
import * as React from 'react';
import { FormGrid, FormField, TextInput, PeopleField, OrganizationField, Select } from '../../../shared/ui';
import { FormGrid, FormField, TextInput, PeopleField, OrganizationField } from '../../../shared/ui';
import { ISectionProps, EMPLOYEE_PLACEHOLDER } from '../model';
import { companyOptions, selectedCompanyKey } from '../tripCompany';
/**
* Командируемый: по умолчанию сам инициатор, но можно выбрать другого
* сотрудника (руководитель оформляет за подчинённого) — должность и
* организации подтянутся по выбранному. Дату подачи ставит форма.
* Сотрудник может работать в нескольких компаниях — тогда выбирают, от какой он едет.
*/
export const EmployeeSection: React.FC<ISectionProps> = ({ data, set, context, employee }) => {
const options = companyOptions(employee?.organizations ?? [], data);
// Заявки, поданные до появления выбора организации, показывают прежний список всех организаций.
const isLegacyRequest = !employee && !data.TripCompany;
return (
<FormGrid>
<FormField label="Сотрудник" htmlFor="Employee" required full>
<PeopleField
context={context}
value={data.Employee}
onChange={employee?.onEmployeeChange ?? ((v) => set('Employee', v))}
placeholder={EMPLOYEE_PLACEHOLDER}
/>
</FormField>
<FormField label="Должность" htmlFor="Position" required>
<TextInput id="Position" value={data.Position} onChange={(v) => set('Position', v)} />
</FormField>
<FormField label="Дата подачи" htmlFor="SubmitDate">
<TextInput id="SubmitDate" type="date" value={data.SubmitDate} onChange={(v) => set('SubmitDate', v)} readOnly />
</FormField>
{isLegacyRequest && <OrganizationField value={data.Organization} />}
{!isLegacyRequest && options.length > 0 && (
<FormField label="Командирующая организация" htmlFor="TripCompany" required full>
<Select
id="TripCompany"
value={selectedCompanyKey(data)}
onChange={(key) => employee?.onCompanyChange(key)}
options={options}
placeholder="Выберите, от какой организации командировка"
// Единственная организация выбрана автоматически — выбирать не из чего.
readOnly={options.length === 1 && !!data.TripCompany}
/>
</FormField>
)}
</FormGrid>
);
};
export const EmployeeSection: React.FC<ISectionProps> = ({ data, set, context, onEmployeeChange }) => (
<FormGrid>
<FormField label="Сотрудник" htmlFor="Employee" required full>
<PeopleField
context={context}
value={data.Employee}
onChange={onEmployeeChange ?? ((v) => set('Employee', v))}
placeholder={EMPLOYEE_PLACEHOLDER}
/>
</FormField>
<FormField label="Должность" htmlFor="Position" required>
<TextInput id="Position" value={data.Position} onChange={(v) => set('Position', v)} />
</FormField>
<FormField label="Дата подачи" htmlFor="SubmitDate">
<TextInput id="SubmitDate" type="date" value={data.SubmitDate} onChange={(v) => set('SubmitDate', v)} readOnly />
</FormField>
<OrganizationField value={data.Organization} />
</FormGrid>
);
@@ -1,6 +1,6 @@
import * as React from 'react';
import styles from './EstimateSection.module.scss';
import { CollapseSection, FormField, TextArea, useFormReadOnly } from '../../../shared/ui';
import { CollapseSection, useFormReadOnly } from '../../../shared/ui';
import { ISectionProps } from '../model';
import { EstimateEditor } from '../components/estimate/EstimateEditor';
import { EstimateTable } from '../components/estimate/EstimateTable';
@@ -9,8 +9,7 @@ import { EstimateSummary } from '../components/estimate/EstimateSummary';
/**
* Смета на командировку. Заполнение — карточками статей с позициями, привязанными
* к точкам и участкам маршрута (EstimateEditor); просмотр и печать — таблицей.
* Итог с долями и разбивкой по объектам — в обоих режимах. После итога —
* необязательный комментарий к заявке.
* Итог с долями и разбивкой по объектам — в обоих режимах.
*/
export const EstimateSection: React.FC<ISectionProps> = ({ data, set }) => {
const readOnly = useFormReadOnly();
@@ -27,12 +26,6 @@ export const EstimateSection: React.FC<ISectionProps> = ({ data, set }) => {
<EstimateEditor data={data} set={set} />
)}
</div>
{/* Пустой комментарий в просмотре не показываем — пустое поле только мешает читать. */}
{(!readOnly || data.TripComment.trim()) && (
<FormField label="Комментарий" htmlFor="TripComment" full>
<TextArea id="TripComment" value={data.TripComment} onChange={(v) => set('TripComment', v)} rows={3} />
</FormField>
)}
</CollapseSection>
);
};
@@ -5,7 +5,7 @@ import { ISectionProps, OBLIGATION_LABEL, OBLIGATION_TEXT } from '../model';
/** Обязательство по авансовому отчёту из бланка — без согласия заявку не отправить. */
export const ObligationSection: React.FC<ISectionProps> = ({ data, set }) => (
<CollapseSection title="Обязательство и согласие" icon="document">
<CollapseSection title="Обязательство" icon="document">
<p className={styles.text}>{OBLIGATION_TEXT}</p>
<FormField label="Подтверждение" htmlFor="TripObligationAccepted" required full>
<Checkbox
@@ -1,7 +1,7 @@
import * as React from 'react';
import { useEffect, useState } from 'react';
import styles from './RouteSection.module.scss';
import { CollapseSection, useFormReadOnly } from '../../../shared/ui';
import { CollapseSection, FormField, TextArea, useFormReadOnly } from '../../../shared/ui';
import { ISectionProps } from '../model';
import { RouteEditor } from '../components/route/RouteEditor';
import { RouteScheme } from '../components/route/RouteScheme';
@@ -9,8 +9,8 @@ import { RouteViewMode, RouteViewSwitch } from '../components/route/RouteViewSwi
import { stopCardDomId } from '../components/route/RouteStopCard';
/**
* Куда едет сотрудник: маршрут (города + объекты + даты) в двух видах — «Форма»
* для заполнения и «Схема» для просмотра. Заявитель
* Куда и зачем: маршрут (города + объекты + даты) и цель командировки. Маршрут —
* в двух видах: «Форма» для заполнения и «Схема» для просмотра. Заявитель
* начинает с формы (он пришёл заполнять), согласующий — со схемы (ему важнее
* увидеть маршрут целиком).
*/
@@ -41,6 +41,9 @@ export const RouteSection: React.FC<ISectionProps> = ({ data, set, context }) =>
<RouteScheme route={data.Route} articles={data.Estimate} onSelectStop={openStopInForm} />
)}
</div>
<FormField label="Цель" htmlFor="TripPurpose" required full>
<TextArea id="TripPurpose" value={data.TripPurpose} onChange={(v) => set('TripPurpose', v)} rows={2} />
</FormField>
</CollapseSection>
);
};
@@ -5,7 +5,7 @@ import { submitDateOnSave } from '../../shared/submitDate';
import { formatIsoDate } from '../../shared/dateUtils';
import { FORM_ID, FORM_TITLE, IFormData } from './model';
import { filledTasks, formatTasks, tripDays } from './tripData';
import { routeCities, routePeriod, routeProjects, routeText, serializeRoute, tripKind } from './route';
import { routeCities, routePeriod, routeProjects, routeText, serializeRoute } from './route';
import { estimateTotal, formatEstimateText, serializeEstimate } from './estimate';
/** Сервис списка согласования этой формы — см. shared/approval/approvalServiceFactory.ts. */
@@ -34,10 +34,7 @@ function buildItem(data: IFormData, status: string, employeeId: number, employee
EmployeeId: employeeId,
Position: data.Position || null,
Organization: data.Organization || null,
TripCompany: data.TripCompany || null,
TripCompanyId: data.TripCompanyId || null,
TripKind: tripKind(route),
TripRouteJson: serializeRoute(route),
TripRoute: routeText(route) || null,
TripCity: routeCities(route) || null,
@@ -47,6 +44,7 @@ function buildItem(data: IFormData, status: string, employeeId: number, employee
TripStartDate: period.start || null,
TripEndDate: period.end || null,
TripDaysCount: tripDays(period.start, period.end) ?? null,
TripPurpose: data.TripPurpose || null,
// Читаемая строка — для представлений списка; источник для формы — JSON.
TripTasks: formatTasks(data.Tasks) || null,
@@ -56,7 +54,6 @@ function buildItem(data: IFormData, status: string, employeeId: number, employee
TripEstimateJson: serializeEstimate(data.Estimate),
// Итог дублируется числовой колонкой — для отчётов и сортировки в SP.
TripEstimateTotal: estimateTotal(data.Estimate),
TripComment: data.TripComment.trim() || null,
TripObligationAccepted: data.TripObligationAccepted
};
@@ -1,57 +0,0 @@
import type { IEmployeeOrganization } from '../../shared/dictionary';
import { EMPTY_DATA, IFormData } from './model';
import { applyCompany, applyEmployeeCompany, companyOptions } from './tripCompany';
const org = (companyId: string, company: string, position: string): IEmployeeOrganization => ({
id: `${companyId}-${position}`,
fio: 'Нурумова Виктория',
email: 'nurumova@tnsu.kz',
iin: '',
company,
companyId,
section: '',
departmentId: '',
position,
mobile: ''
});
const MONTAZHNIK = org('c1', 'ТОО Монтажник-Т', 'Директор');
const ASTEL = org('c2', 'ТОО АСТЕЛ-К', 'Казначей');
describe('tripCompany: варианты', () => {
it('«Компания — должность», дубль компании отбрасывается', () => {
const options = companyOptions([MONTAZHNIK, ASTEL, org('c2', 'ТОО АСТЕЛ-К', 'Бухгалтер')], EMPTY_DATA);
expect(options).toEqual([
{ value: 'c1', label: 'ТОО Монтажник-Т — Директор' },
{ value: 'c2', label: 'ТОО АСТЕЛ-К — Казначей' }
]);
});
it('сохранённая организация видна, даже если справочник её не вернул', () => {
const data: IFormData = { ...EMPTY_DATA, TripCompany: 'ТОО Старая', TripCompanyId: 'old' };
expect(companyOptions([], data)).toEqual([{ value: 'old', label: 'ТОО Старая' }]);
});
});
describe('tripCompany: выбор', () => {
it('выбор организации ставит должность в ней', () => {
const data = applyCompany({ ...EMPTY_DATA, Position: 'Директор' }, ASTEL);
expect([data.TripCompany, data.TripCompanyId, data.Position]).toEqual(['ТОО АСТЕЛ-К', 'c2', 'Казначей']);
});
it('одна организация выбирается сразу', () => {
const data = applyEmployeeCompany(EMPTY_DATA, [MONTAZHNIK]);
expect([data.TripCompanyId, data.Position]).toEqual(['c1', 'Директор']);
});
it('несколько — выбор и должность пустые', () => {
const prev = { ...EMPTY_DATA, TripCompany: 'ТОО Монтажник-Т', TripCompanyId: 'c1', Position: 'Директор' };
const data = applyEmployeeCompany(prev, [MONTAZHNIK, ASTEL]);
expect([data.TripCompanyId, data.Position]).toEqual(['', '']);
});
it('нет в справочнике — должность остаётся (введут руками)', () => {
const data = applyEmployeeCompany({ ...EMPTY_DATA, Position: 'Инженер' }, []);
expect([data.TripCompanyId, data.Position]).toEqual(['', 'Инженер']);
});
});
@@ -1,57 +0,0 @@
// Только типы: модуль чистый и тестируется без SharePoint (сервисы справочника тянут sp-http).
import type { IEmployeeOrganization } from '../../shared/dictionary';
import type { ISelectOption } from '../../shared/ui';
import { IFormData } from './model';
/** Значение варианта в списке: CompanyId из справочника, у записи без id — название. */
export function companyKey(org: IEmployeeOrganization): string {
return org.companyId || org.company;
}
/** Значение выбранной организации в списке ('' — не выбрана). */
export function selectedCompanyKey(data: IFormData): string {
return data.TripCompanyId || data.TripCompany;
}
/**
* Варианты «Командирующей организации» — «Компания — должность». Если в одной
* компании у сотрудника несколько записей, остаётся первая: выбирают компанию,
* а не ставку. Сохранённая организация, которой нет среди вариантов (просмотр
* заявки, справочник недоступен, сотрудник уже ушёл из компании), всё равно
* показывается — иначе поле выглядело бы пустым.
*/
export function companyOptions(organizations: IEmployeeOrganization[], data: IFormData): ISelectOption[] {
const options: ISelectOption[] = [];
organizations.forEach((org) => {
const value = companyKey(org);
if (!value || options.some((o) => o.value === value)) return;
options.push({ value, label: org.position ? `${org.company} — ${org.position}` : org.company });
});
const saved = selectedCompanyKey(data);
if (saved && !options.some((o) => o.value === saved)) {
options.push({ value: saved, label: data.TripCompany });
}
return options;
}
/** Выбрать организацию: компания + должность сотрудника именно в ней. undefined — сбросить выбор. */
export function applyCompany(data: IFormData, org: IEmployeeOrganization | undefined): IFormData {
return {
...data,
TripCompany: org?.company || '',
TripCompanyId: org?.companyId || '',
Position: org?.position || data.Position
};
}
/**
* Организация и должность нового сотрудника заявки. Одна организация —
* выбирается сразу. Несколько — выбор за человеком, а должность пустая до
* выбора: в каждой компании она своя, и угадывать её по первой записи нельзя.
* Сотрудник не найден в справочнике — должность остаётся как была (введут руками).
*/
export function applyEmployeeCompany(data: IFormData, organizations: IEmployeeOrganization[]): IFormData {
if (organizations.length === 1) return applyCompany(data, organizations[0]);
const cleared = applyCompany(data, undefined);
return organizations.length > 1 ? { ...cleared, Position: '' } : cleared;
}
@@ -1,20 +1,22 @@
import * as React from 'react';
import { useEffect, useState } from 'react';
import { useEffect } from 'react';
import type { WebPartContext } from '@microsoft/sp-webpart-base';
import { getEmployeeOrganizations, formatEmployeeOrganizations } from '../../shared/dictionary';
import type { IEmployeeOrganization } from '../../shared/dictionary';
import { todaySubmitDate } from '../../shared/submitDate';
import { IFormData, ITripEmployee } from './model';
import { applyCompany, applyEmployeeCompany, companyKey } from './tripCompany';
import { IFormData } from './model';
type SetData = React.Dispatch<React.SetStateAction<IFormData>>;
/** Подставить организации, командирующую организацию и должность сотрудника из Employee/ByEmail. */
/** Подставить должность и организации сотрудника из Employee/ByEmail (должность — из первой записи). */
function fillProfile(context: WebPartContext, email: string, setData: SetData, isAlive: () => boolean): void {
getEmployeeOrganizations(context, email)
.then((records) => {
if (!isAlive()) return;
setData((prev) => applyEmployeeCompany({ ...prev, Organization: formatEmployeeOrganizations(records) }, records));
setData((prev) => ({
...prev,
Position: records[0]?.position || prev.Position,
Organization: formatEmployeeOrganizations(records)
}));
})
// Справочник недоступен — не страшно: должность введут руками, организация просто не покажется.
.catch(() => undefined);
@@ -22,18 +24,10 @@ function fillProfile(context: WebPartContext, email: string, setData: SetData, i
/**
* Сотрудник заявки. Новая заявка — по умолчанию на себя: текущий пользователь,
* его должность, организации и сегодняшняя дата подачи. Выбор другого сотрудника
* подтягивает профиль выбранного. Список организаций грузится и для открытого
* черновика — но там сохранённые должность и организацию не перезаписываем.
* его должность, организации и сегодняшняя дата подачи. Возвращает обработчик
* выбора другого сотрудника — он подтягивает должность и организации выбранного.
*/
export function useTripEmployee(
context: WebPartContext,
editId: number | undefined,
employee: string,
setData: SetData
): ITripEmployee {
const [organizations, setOrganizations] = useState<IEmployeeOrganization[]>([]);
export function useTripEmployee(context: WebPartContext, editId: number | undefined, setData: SetData): (login: string) => void {
useEffect(() => {
if (editId) return;
let alive = true;
@@ -46,36 +40,8 @@ export function useTripEmployee(
// context — единственный экземпляр WebPartContext на всё время жизни веб-части.
}, [editId, context, setData]);
// Ответ справочника кешируется по e-mail (см. employeeOrganizations.service.ts) — повторного запроса нет.
useEffect(() => {
let alive = true;
const load = employee ? getEmployeeOrganizations(context, employee) : Promise.resolve<IEmployeeOrganization[]>([]);
load
.then((records) => {
if (alive) setOrganizations(records);
})
.catch(() => {
if (alive) setOrganizations([]);
});
return () => {
alive = false;
};
}, [context, employee]);
const onEmployeeChange = (login: string): void => {
if (!login) {
// Сотрудник очищен — его организации и выбранная компания к заявке больше не относятся.
setData((prev) => applyCompany({ ...prev, Employee: '', Organization: '' }, undefined));
return;
}
setData((prev) => ({ ...prev, Employee: login }));
fillProfile(context, login, setData, () => true);
return (login: string): void => {
setData((prev) => ({ ...prev, Employee: login, Organization: login ? prev.Organization : '' }));
if (login) fillProfile(context, login, setData, () => true);
};
const onCompanyChange = (key: string): void => {
const org = organizations.find((o) => companyKey(o) === key);
setData((prev) => applyCompany(prev, org));
};
return { organizations, onEmployeeChange, onCompanyChange };
}
@@ -1,19 +1,14 @@
import { EMPTY_DATA, IEstimateArticle, IFormData, ITripRoute } from './model';
import { createArticle } from './estimate';
import type { IEmployeeOrganization } from '../../shared/dictionary';
import type { IFieldIssue } from '../../shared/ui';
import { draftIssues, submitIssues } from './validation';
const off = (article: IEstimateArticle): IEstimateArticle => ({ ...article, enabled: false });
const ROUTE: ITripRoute = {
origin: 'Алматы',
originKz: '',
originKato: '',
stops: [{ id: 's1', abroad: false, country: '', city: 'Атырау', cityKz: '', cityKato: '', project: 'Нефтебаза-2', projectId: 'p1', dateFrom: '2026-10-05', dateTo: '2026-10-08' }],
stops: [{ id: 's1', city: 'Атырау', project: 'Нефтебаза-2', projectId: 'p1', dateFrom: '2026-10-05', dateTo: '2026-10-08' }],
returnToOrigin: true,
legTransport: { 'origin>s1': 'Авиа', 's1>origin': 'Авиа' },
legDepartureTime: { 'origin>s1': 'Утро', 's1>origin': 'Вечер' }
legTransport: { 'origin>s1': 'Авиа', 's1>origin': 'Авиа' }
};
const FILLED: IFormData = {
@@ -27,74 +22,33 @@ const FILLED: IFormData = {
TripObligationAccepted: true
};
// Фиксированное «сегодня» — раньше дат маршрута в фикстурах, чтобы тесты не зависели от текущей даты.
const TODAY = '2026-10-01';
const submit = (data: IFormData, organizations: IEmployeeOrganization[] = []): IFieldIssue[] => submitIssues(data, organizations, TODAY);
const fields = (issues: { field: string }[]): string[] => issues.map((i) => i.field);
describe('validation: форма', () => {
it('заполненная заявка — без проблем', () => {
expect(submit(FILLED)).toEqual([]);
expect(submitIssues(FILLED)).toEqual([]);
expect(draftIssues(FILLED)).toEqual([]);
});
it('командирующая организация обязательна, только если есть из чего выбрать', () => {
const orgs = [{ id: '1', fio: '', email: '', iin: '', company: 'ТОО А', companyId: 'a', section: '', departmentId: '', position: '', mobile: '' }];
expect(fields(submit(FILLED, orgs))).toEqual(['TripCompany']);
expect(submit({ ...FILLED, TripCompany: 'ТОО А', TripCompanyId: 'a' }, orgs)).toEqual([]);
expect(submit(FILLED, [])).toEqual([]);
});
it('черновику нужен только сотрудник', () => {
expect(fields(draftIssues(EMPTY_DATA))).toEqual(['Employee']);
});
it('пустые задачи и обязательство', () => {
const data = { ...FILLED, Tasks: [' '], TripObligationAccepted: false };
expect(fields(submit(data))).toEqual(['Tasks', 'TripObligationAccepted']);
expect(fields(submitIssues(data))).toEqual(['Tasks', 'TripObligationAccepted']);
});
});
describe('validation: маршрут', () => {
it('объект только из справочника', () => {
const route = { ...ROUTE, stops: [{ ...ROUTE.stops[0], projectId: '' }] };
expect(fields(submit({ ...FILLED, Route: route }))).toEqual(['stop-s1-project']);
});
it('зарубежная точка — нужна страна', () => {
const route = { ...ROUTE, stops: [{ ...ROUTE.stops[0], abroad: true, country: ' ' }] };
expect(fields(submit({ ...FILLED, Route: route }))).toEqual(['stop-s1-country']);
});
it('зарубежная точка — объект можно ввести вручную, но не пустым', () => {
const abroad = { ...ROUTE.stops[0], abroad: true, country: 'Китай', project: 'Завод Китайский', projectId: '' };
expect(submit({ ...FILLED, Route: { ...ROUTE, stops: [abroad] } })).toEqual([]);
const empty = { ...abroad, project: ' ' };
expect(fields(submit({ ...FILLED, Route: { ...ROUTE, stops: [empty] } }))).toEqual(['stop-s1-project']);
expect(fields(submitIssues({ ...FILLED, Route: route }))).toEqual(['stop-s1-project']);
});
it('у каждого участка нужен вид транспорта', () => {
const route = { ...ROUTE, legTransport: { 'origin>s1': 'Авиа' } };
expect(fields(submit({ ...FILLED, Route: route }))).toEqual(['leg-s1>origin']);
});
it('у каждого участка нужно время выезда', () => {
const route = { ...ROUTE, legDepartureTime: { 'origin>s1': 'Утро' } };
expect(fields(submit({ ...FILLED, Route: route }))).toEqual(['leg-s1>origin-time']);
});
it('прибытие задним числом не отправить, сегодня — можно; черновик сохраняется', () => {
expect(fields(submitIssues(FILLED, [], '2026-10-06'))).toEqual(['stop-s1-from']);
expect(submitIssues(FILLED, [], '2026-10-05')).toEqual([]);
expect(draftIssues(FILLED)).toEqual([]);
});
it('командировка не дольше 40 дней включительно', () => {
const until = (dateTo: string): ITripRoute => ({ ...ROUTE, stops: [{ ...ROUTE.stops[0], dateTo }] });
// 05.10 – 13.11 = 40 дней, 05.10 – 14.11 = 41.
expect(submit({ ...FILLED, Route: until('2026-11-13') })).toEqual([]);
expect(fields(submit({ ...FILLED, Route: until('2026-11-14') }))).toEqual(['stop-s1-to']);
expect(fields(submitIssues({ ...FILLED, Route: route }))).toEqual(['leg-s1>origin']);
});
it('отъезд раньше прибытия блокирует даже черновик', () => {
@@ -103,9 +57,9 @@ describe('validation: маршрут', () => {
});
it('прибытие в следующую точку раньше отъезда из предыдущей', () => {
const second = { id: 's2', abroad: false, country: '', city: 'Актау', cityKz: '', cityKato: '', project: 'Порт', projectId: 'p2', dateFrom: '2026-10-06', dateTo: '2026-10-09' };
const route = { ...ROUTE, stops: [...ROUTE.stops, second], legTransport: { 'origin>s1': 'Авиа', 's1>s2': 'Авиа', 's2>origin': 'Авиа' }, legDepartureTime: { 'origin>s1': 'Утро', 's1>s2': 'День', 's2>origin': 'Вечер' } };
expect(fields(submit({ ...FILLED, Route: route }))).toEqual(['stop-s2-from']);
const second = { id: 's2', city: 'Актау', project: 'Порт', projectId: 'p2', dateFrom: '2026-10-06', dateTo: '2026-10-09' };
const route = { ...ROUTE, stops: [...ROUTE.stops, second], legTransport: { 'origin>s1': 'Авиа', 's1>s2': 'Авиа', 's2>origin': 'Авиа' } };
expect(fields(submitIssues({ ...FILLED, Route: route }))).toEqual(['stop-s2-from']);
});
});
@@ -113,46 +67,29 @@ describe('validation: смета', () => {
const [perDiem, travel, accommodation] = EMPTY_DATA.Estimate;
it('включённая статья без суммы — подсвечивается пустое поле', () => {
const tickets = { ...travel, items: [{ ...travel.items[0], linkId: 'origin>s1', mode: 'calc' as const, quantity: '1' }] };
const data = { ...FILLED, Estimate: [off(perDiem), tickets, off(accommodation)] };
expect(fields(submit(data))).toEqual([`item-${travel.items[0].id}-price`]);
});
it('лимит суточных: 6 МРП по Казахстану, 8 за рубежом', () => {
const withMrp = (mrpCount: string): IEstimateArticle => ({ ...perDiem, items: [{ ...perDiem.items[0], linkId: 's1', mrpCount }] });
const estimate = (mrpCount: string): IEstimateArticle[] => [withMrp(mrpCount), off(travel), off(accommodation)];
expect(fields(submit({ ...FILLED, Estimate: estimate('7') }))).toEqual([`item-${perDiem.items[0].id}-mrp`]);
const abroad = { ...ROUTE, stops: [{ ...ROUTE.stops[0], abroad: true, country: 'Китай' }] };
expect(submit({ ...FILLED, Route: abroad, Estimate: estimate('8') })).toEqual([]);
expect(fields(submit({ ...FILLED, Route: abroad, Estimate: estimate('9') }))).toEqual([`item-${perDiem.items[0].id}-mrp`]);
});
it('проживание: цена необязательна, но по Казахстану не больше 15 000 за ночь', () => {
const withPrice = (price: string): IEstimateArticle => ({ ...accommodation, items: [{ ...accommodation.items[0], linkId: 's1', price }] });
const estimate = (price: string): IEstimateArticle[] => [off(perDiem), off(travel), withPrice(price)];
expect(submit({ ...FILLED, Estimate: estimate('') })).toEqual([]);
expect(submit({ ...FILLED, Estimate: estimate('15000') })).toEqual([]);
expect(fields(submit({ ...FILLED, Estimate: estimate('15001') }))).toEqual([`item-${accommodation.items[0].id}-price`]);
const filledQty = { ...accommodation, items: [{ ...accommodation.items[0], linkId: 's1', quantity: '3' }] };
const data = { ...FILLED, Estimate: [off(perDiem), off(travel), filledQty] };
expect(fields(submitIssues(data))).toEqual([`item-${accommodation.items[0].id}-price`]);
});
it('суточные: дни из маршрута, от человека — только кол-во МРП', () => {
const noMrp = { ...perDiem, items: [{ ...perDiem.items[0], linkId: 's1', quantity: '4' }] };
const withMrp = { ...perDiem, items: [{ ...noMrp.items[0], mrpCount: '6' }] };
const estimate = (article: IEstimateArticle): IEstimateArticle[] => [article, off(travel), off(accommodation)];
expect(fields(submit({ ...FILLED, Estimate: estimate(noMrp) }))).toEqual([`item-${perDiem.items[0].id}-mrp`]);
expect(submit({ ...FILLED, Estimate: estimate(withMrp) })).toEqual([]);
expect(fields(submitIssues({ ...FILLED, Estimate: estimate(noMrp) }))).toEqual([`item-${perDiem.items[0].id}-mrp`]);
expect(submitIssues({ ...FILLED, Estimate: estimate(withMrp) })).toEqual([]);
});
it('при нескольких вариантах позицию нужно привязать', () => {
// В маршруте «туда и обратно» у проезда два участка — без привязки не понять, какой оплачен.
const unlinked = { ...travel, items: [{ ...travel.items[0], linkId: '', amount: '50000' }] };
const data = { ...FILLED, Estimate: [off(perDiem), unlinked, off(accommodation)] };
expect(fields(submit(data))).toEqual([`item-${travel.items[0].id}-link`]);
expect(fields(submitIssues(data))).toEqual([`item-${travel.items[0].id}-link`]);
});
it('другой расход требует название и сумму', () => {
const other = createArticle('other', ROUTE);
const data = { ...FILLED, Estimate: [...FILLED.Estimate, other] };
expect(fields(submit(data))).toEqual([`article-${other.id}-title`, `item-${other.items[0].id}-amount`]);
expect(fields(submitIssues(data))).toEqual([`article-${other.id}-title`, `item-${other.items[0].id}-amount`]);
});
});
@@ -1,28 +1,8 @@
import type { IFieldIssue } from '../../shared/ui';
import type { IEmployeeOrganization } from '../../shared/dictionary';
import { todaySubmitDate } from '../../shared/submitDate';
import {
ESTIMATE_KINDS,
EstimateKind,
IEstimateArticle,
IEstimateItem,
IFormData,
IRouteStop,
ITripRoute,
MAX_TRIP_DAYS
} from './model';
import { filledTasks, plural, tripDays } from './tripData';
import { legLabel, routeLegs, routePeriod, stopCityLabel } from './route';
import {
articleTitle,
formatAmount,
itemAmount,
itemLinkLabel,
linkOptions,
mrpLimit,
nightPriceLimit,
resolveLinkId
} from './estimate';
import { ESTIMATE_KINDS, IEstimateArticle, IEstimateItem, IFormData, IRouteStop, ITripRoute } from './model';
import { filledTasks } from './tripData';
import { legLabel, routeLegs } from './route';
import { articleTitle, itemAmount, itemLinkLabel, linkOptions, resolveLinkId } from './estimate';
/**
* Ключи полей маршрута и сметы — те же, что fieldKey/htmlFor у их FormField:
@@ -30,13 +10,11 @@ import {
*/
export const fieldKey = {
origin: 'route-origin',
stopCountry: (stop: IRouteStop): string => `stop-${stop.id}-country`,
stopCity: (stop: IRouteStop): string => `stop-${stop.id}-city`,
stopProject: (stop: IRouteStop): string => `stop-${stop.id}-project`,
stopFrom: (stop: IRouteStop): string => `stop-${stop.id}-from`,
stopTo: (stop: IRouteStop): string => `stop-${stop.id}-to`,
legTransport: (legId: string): string => `leg-${legId}`,
legDepartureTime: (legId: string): string => `leg-${legId}-time`,
articleTitle: (article: IEstimateArticle): string => `article-${article.id}-title`,
itemLink: (item: IEstimateItem): string => `item-${item.id}-link`,
itemAmount: (item: IEstimateItem): string => `item-${item.id}-amount`,
@@ -47,8 +25,7 @@ export const fieldKey = {
/** «Точка 2 (Актау)» — как точку видно в форме. */
function stopName(stop: IRouteStop, index: number): string {
const city = stopCityLabel(stop);
return city ? `Точка ${index + 1} (${city})` : `Точка ${index + 1}`;
return stop.city.trim() ? `Точка ${index + 1} (${stop.city.trim()})` : `Точка ${index + 1}`;
}
/** Дата окончания раньше начала — блокирует даже черновик: такие даты не сохранить осмысленно. */
@@ -63,24 +40,13 @@ function stopDateOrderIssues(route: ITripRoute): IFieldIssue[] {
}
/** Проблемы одной точки маршрута (кроме порядка дат внутри точки — см. stopDateOrderIssues). */
function stopIssues(stop: IRouteStop, index: number, previous: IRouteStop | undefined, today: string): IFieldIssue[] {
function stopIssues(stop: IRouteStop, index: number, previous: IRouteStop | undefined): IFieldIssue[] {
const label = stopName(stop, index);
const issues: IFieldIssue[] = [];
if (stop.abroad && !stop.country.trim()) issues.push({ field: fieldKey.stopCountry(stop), label, message: 'укажите страну' });
if (!stop.city.trim()) issues.push({ field: fieldKey.stopCity(stop), label, message: 'укажите город' });
// По Казахстану объект — именно из справочника (projectId): по нему разносят затраты по проектам.
// За рубежом едут на чужую площадку (завод, выставка) — её в справочнике нет, достаточно текста.
if (stop.abroad && !stop.project.trim()) {
issues.push({ field: fieldKey.stopProject(stop), label, message: 'укажите объект или место назначения' });
}
if (!stop.abroad && !stop.projectId) {
issues.push({ field: fieldKey.stopProject(stop), label, message: 'выберите объект из списка' });
}
// Объект — именно из справочника (projectId): по нему потом разносят затраты по проектам.
if (!stop.projectId) issues.push({ field: fieldKey.stopProject(stop), label, message: 'выберите объект из списка' });
if (!stop.dateFrom) issues.push({ field: fieldKey.stopFrom(stop), label, message: 'укажите дату прибытия' });
// Задним числом командировку не оформляют. Сегодня — можно: выезд в день подачи.
if (stop.dateFrom && stop.dateFrom < today) {
issues.push({ field: fieldKey.stopFrom(stop), label, message: 'дата прибытия уже прошла' });
}
if (!stop.dateTo) issues.push({ field: fieldKey.stopTo(stop), label, message: 'укажите дату отъезда' });
if (previous?.dateTo && stop.dateFrom && stop.dateFrom < previous.dateTo) {
issues.push({ field: fieldKey.stopFrom(stop), label, message: 'прибытие раньше отъезда из предыдущей точки' });
@@ -88,39 +54,15 @@ function stopIssues(stop: IRouteStop, index: number, previous: IRouteStop | unde
return issues;
}
/**
* Вся поездка — не дольше MAX_TRIP_DAYS дней (от прибытия в первую точку до отъезда
* из последней, включительно). Подсвечиваем отъезд последней точки — его обычно и правят.
*/
function tripLengthIssues(route: ITripRoute): IFieldIssue[] {
const period = routePeriod(route);
const days = tripDays(period.start, period.end);
const last = route.stops[route.stops.length - 1];
if (days === undefined || days <= MAX_TRIP_DAYS || !last) return [];
return [
{
field: fieldKey.stopTo(last),
label: 'Маршрут',
message: `командировка — ${plural(days, ['день', 'дня', 'дней'])}, можно не больше ${MAX_TRIP_DAYS}`
}
];
}
/** Маршрут для отправки: город отправления, все точки, вид транспорта и время выезда на каждом участке. */
function routeIssues(route: ITripRoute, today: string): IFieldIssue[] {
/** Маршрут для отправки: город отправления, все точки, вид транспорта на каждом участке. */
function routeIssues(route: ITripRoute): IFieldIssue[] {
const issues: IFieldIssue[] = [];
if (!route.origin.trim()) issues.push({ field: fieldKey.origin, label: 'Маршрут', message: 'укажите город отправления' });
route.stops.forEach((stop, i) => issues.push(...stopIssues(stop, i, route.stops[i - 1], today)));
route.stops.forEach((stop, i) => issues.push(...stopIssues(stop, i, route.stops[i - 1])));
issues.push(...stopDateOrderIssues(route));
issues.push(...tripLengthIssues(route));
routeLegs(route).forEach((leg) => {
const label = `Переезд ${legLabel(leg)}`;
if (!route.legTransport[leg.id]) {
issues.push({ field: fieldKey.legTransport(leg.id), label, message: 'выберите вид транспорта' });
}
// Время выезда нужно тревел-координатору под билеты — без него не отправить.
if (!route.legDepartureTime[leg.id]) {
issues.push({ field: fieldKey.legDepartureTime(leg.id), label, message: 'выберите время выезда' });
issues.push({ field: fieldKey.legTransport(leg.id), label: `Участок ${legLabel(leg)}`, message: 'выберите вид транспорта' });
}
});
return issues;
@@ -133,27 +75,6 @@ function amountIssue(item: IEstimateItem, label: string): IFieldIssue {
return { field: fieldKey.itemPrice(item), label, message: 'укажите цену' };
}
/**
* Позиция «по маршруту» — точку и дни/ночи форма ставит сама (пустые даты подсветит
* маршрут). Суточные: нужно кол-во МРП, не больше лимита (0 дней в день переезда —
* не ошибка). Проживание: цена необязательна — в точке могут жить на объекте, — но
* не выше лимита за ночь.
*/
function routeItemIssues(kind: EstimateKind, item: IEstimateItem, label: string, route: ITripRoute): IFieldIssue[] {
const stop = route.stops.find((s) => s.id === item.linkId);
if (kind === 'accommodation') {
const limit = nightPriceLimit(stop);
if (limit === undefined || Number(item.price) <= limit) return [];
return [{ field: fieldKey.itemPrice(item), label, message: `цена за ночь не больше ${formatAmount(limit)} ₸` }];
}
if (!Number(item.mrpCount)) return [{ field: fieldKey.itemMrpCount(item), label, message: 'укажите количество МРП' }];
const limit = mrpLimit(stop);
if (Number(item.mrpCount) > limit) {
return [{ field: fieldKey.itemMrpCount(item), label, message: `не больше ${limit} МРП в день` }];
}
return [];
}
/**
* Смета. Сама не обязательна — выключенные статьи не проверяются; но у включённой
* или добавленной статьи каждая позиция должна иметь сумму и (если вариантов
@@ -171,8 +92,12 @@ function estimateIssues(articles: IEstimateArticle[], route: ITripRoute): IField
article.items.forEach((item) => {
const where = itemLinkLabel(article.kind, item, route);
const label = where ? `Смета: ${articleTitle(article)} (${where})` : `Смета: ${articleTitle(article)}`;
// Суточные привязаны к точке и считают дни сами (пустые даты подсветит маршрут) —
// от человека нужно только кол-во МРП. 0 дней (точка в день переезда) — не ошибка.
if (ESTIMATE_KINDS[article.kind].itemsFromRoute) {
issues.push(...routeItemIssues(article.kind, item, label, route));
if (!Number(item.mrpCount)) {
issues.push({ field: fieldKey.itemMrpCount(item), label, message: 'укажите количество МРП' });
}
return;
}
if (needsLink && !resolveLinkId(article.kind, item.linkId, route)) {
@@ -191,30 +116,19 @@ export function draftIssues(data: IFormData): IFieldIssue[] {
return [...issues, ...stopDateOrderIssues(data.Route)];
}
/**
* Всё, что мешает отправке на согласование, в порядке формы (пусто — отправлять можно).
* organizations — организации сотрудника (см. useTripEmployee): из них выбирают командирующую.
* today — YYYY-MM-DD; параметром, чтобы тесты не зависели от текущей даты.
*/
export function submitIssues(
data: IFormData,
organizations: IEmployeeOrganization[] = [],
today: string = todaySubmitDate()
): IFieldIssue[] {
/** Всё, что мешает отправке на согласование, в порядке формы (пусто — отправлять можно). */
export function submitIssues(data: IFormData): IFieldIssue[] {
const issues: IFieldIssue[] = [];
if (!data.Employee) issues.push({ field: 'Employee', label: 'Сотрудник' });
if (!data.Position.trim()) issues.push({ field: 'Position', label: 'Должность' });
// Нет организаций (сотрудника нет в справочнике / справочник недоступен) — выбирать не из чего, не блокируем.
if (organizations.length > 0 && !data.TripCompany) {
issues.push({ field: 'TripCompany', label: 'Командирующая организация', message: 'выберите, от какой организации командировка' });
}
issues.push(...routeIssues(data.Route, today));
issues.push(...routeIssues(data.Route));
if (!data.TripPurpose.trim()) issues.push({ field: 'TripPurpose', label: 'Цель' });
if (filledTasks(data.Tasks).length === 0) {
issues.push({ field: 'Tasks', label: 'Задание на командировку', message: 'добавьте хотя бы одну задачу' });
}
issues.push(...estimateIssues(data.Estimate, data.Route));
if (!data.TripObligationAccepted) {
issues.push({ field: 'TripObligationAccepted', label: 'Обязательство и согласие', message: 'подтвердите согласие' });
issues.push({ field: 'TripObligationAccepted', label: 'Обязательство', message: 'подтвердите согласие' });
}
return issues;
}
@@ -11,7 +11,6 @@ import {
ApprovalHistory,
useMatrixEditor,
notifyActiveStep,
notifyInitiatorOfReturn,
useRequestTypeId,
APPROVAL_PHASE
} from '../../shared/approval';
@@ -256,19 +255,16 @@ const ClearanceView: React.FC<IClearanceViewProps> = ({ context, itemId, formKey
printOrgIndex
};
const notify = (newStatus?: string): void => {
const notify = (): void => {
// requestTypeId ещё не резолвился — решение уже применилось (строка списка
// обновлена), просто нечего уведомлять на следующем шаге; не проваливаем
// весь UI ради необязательного оповещения.
if (!requestTypeId) return;
const target = {
notifyActiveStep(context, approval, itemId, {
requestTypeId,
dataListName: listId ? dataListTitleForListId(FORM_ID, listId) : dataListTitle(FORM_ID),
approvalListName: listId ? approvalListTitleForListId(FORM_ID, listId) : approvalListTitle(FORM_ID)
};
notifyActiveStep(context, approval, itemId, target).catch(() => undefined);
// Отклонили или вернули на доработку — письмо инициатору (при других статусах ничего не делает).
if (newStatus) notifyInitiatorOfReturn(context, approval, itemId, target, newStatus).catch(() => undefined);
}).catch(() => undefined);
};
return (
@@ -315,7 +311,6 @@ const ClearanceView: React.FC<IClearanceViewProps> = ({ context, itemId, formKey
{!executors.loading && executors.rows.length > 0 && (
<ApprovalMatrix
editor={executors}
printable={false}
search={(q) => approval.searchUsers(q)}
title="Исполнение"
roleLabel="Исполнитель"
@@ -353,7 +348,7 @@ const ClearanceView: React.FC<IClearanceViewProps> = ({ context, itemId, formKey
onDecided={(newStatus) => {
setStatus(newStatus);
setDecisionSeq((n) => n + 1);
notify(newStatus);
notify();
}}
onDelegated={() => {
setDecisionSeq((n) => n + 1);
@@ -12,7 +12,6 @@ import {
ApprovalHistory,
useMatrixEditor,
notifyActiveStep,
notifyInitiatorOfReturn,
useRequestTypeId,
useViewExecutors,
approvalPhaseRows
@@ -119,19 +118,16 @@ const ConcreteRequestView: React.FC<IConcreteRequestViewProps> = ({ context, ite
const sectionProps = { data, set: NOOP_SET, context, printOrgIndex };
const notify = (newStatus?: string): void => {
const notify = (): void => {
// requestTypeId ещё не резолвился — решение уже применилось (строка списка
// обновлена), просто нечего уведомлять на следующем шаге; не проваливаем
// весь UI ради необязательного оповещения.
if (!requestTypeId) return;
const target = {
notifyActiveStep(context, approval, itemId, {
requestTypeId,
dataListName: listId ? dataListTitleForListId(FORM_ID, listId) : dataListTitle(FORM_ID),
approvalListName: listId ? approvalListTitleForListId(FORM_ID, listId) : approvalListTitle(FORM_ID)
};
notifyActiveStep(context, approval, itemId, target).catch(() => undefined);
// Отклонили или вернули на доработку — письмо инициатору (при других статусах ничего не делает).
if (newStatus) notifyInitiatorOfReturn(context, approval, itemId, target, newStatus).catch(() => undefined);
}).catch(() => undefined);
};
return (
@@ -179,7 +175,7 @@ const ConcreteRequestView: React.FC<IConcreteRequestViewProps> = ({ context, ite
onDecided={(newStatus) => {
setStatus(newStatus);
setDecisionSeq((n) => n + 1);
notify(newStatus);
notify();
}}
onDelegated={() => {
setDecisionSeq((n) => n + 1);
@@ -1,295 +0,0 @@
import * as React from 'react';
import { useState, useMemo, useEffect } from 'react';
import styles from './ContractChangeForm.module.scss';
import {
Alert,
FormCard,
InitiatorLine,
FormModeProvider,
Icon,
RequestNumber,
SubmitActions,
getDraftDeleteHandler,
useRequestSubmit
} from '../../shared/ui';
import {
composeRemoveRowRule,
ApprovalMatrix,
ExecutorsMatrix,
ApprovalHistory,
StatusBadge,
notifyActiveStep,
useRequestTypeId,
REQUEST_STATUS,
isEditableStatus,
unassignedStepMessage,
resolveWriteListId,
executorsToWrite,
initialSubmitStatus
} from '../../shared/approval';
import { effectiveUserEmail } from '../../shared/impersonation';
import { IRequestFormProps } from '../../models/types';
import { friendlyErrorMessage } from '../../shared/diagnostics';
import {
approvalListTitle,
approvalListTitleForListId,
dataListTitle,
dataListTitleForListId
} from '../../shared/listTitles';
import { FORM_ID, IFormData, EMPTY_DATA, SetField, REQUIRED_FIELDS_MESSAGE, routeEmail } from './model';
import { saveContractChangeRequest, contractChangeApprovalService } from './submit';
import { loadContractChangeRequest } from './load';
import { useContractEmployee } from './useContractEmployee';
import { useInitiatorAutofill } from './useInitiatorAutofill';
import { RequestSection } from './sections/RequestSection';
import { ChangeTypeSections } from './byType/ChangeTypeSections';
import { prepareFilesFor } from './byType/attachmentSlots';
import { changeTypeSubmitError } from './byType/submitChecks';
import { useContractRoute, matrixToApprovers } from './useContractRoute';
import { useAttachmentEditor } from '../../shared/attachments/useAttachmentEditor';
import { getAttachments } from '../../shared/attachments/attachments.service';
import { useStableCallback } from '../../shared/useStableCallback';
const ContractChangeForm: React.FC<IRequestFormProps> = ({
requestType,
context,
onCancel,
onSaved,
editId,
editListId,
onCodeLoaded
}) => {
const [data, setData] = useState<IFormData>(EMPTY_DATA);
const [requestId, setRequestId] = useState<number | undefined>(editId);
const [requestStatus, setRequestStatus] = useState<string | undefined>(undefined);
const [requestCode, setRequestCode] = useState<string | undefined>(undefined);
const submit = useRequestSubmit();
// Стабильная обёртка над колбэком родителя — иначе заявка перезапрашивалась бы
// при каждом рендере родителя (см. DismissalForm).
const notifyCode = useStableCallback(onCodeLoaded);
const { setError: setSubmitError } = submit;
const readOnly = !isEditableStatus(requestStatus);
const set: SetField = (key, value) => setData((prev) => ({ ...prev, [key]: value }));
const applicantEmail = effectiveUserEmail(context);
const approval = useMemo(() => contractChangeApprovalService(editListId), [editListId]);
const requestTypeIdState = useRequestTypeId(context, requestType.id);
const requestTypeId = requestTypeIdState.id;
// Вложения (подписанные слоты по ТЗ «Что приложить», см. byType/attachmentSlots).
const dataListRef = editListId || dataListTitle(FORM_ID);
const attachments = useAttachmentEditor(dataListRef, requestId);
const { setItems: setAttachmentItems } = attachments;
// Открыта СВОЯ заявка на редактирование (черновик/возврат) — подгружаем содержимое, статус и вложения.
useEffect(() => {
if (!editId) {
return;
}
let alive = true;
Promise.all([loadContractChangeRequest(editId, editListId), getAttachments(dataListRef, editId)])
.then(([loaded, files]) => {
if (!alive) return;
setData(loaded.data);
setAttachmentItems(files);
setRequestStatus(loaded.status);
setRequestCode(loaded.code || undefined);
if (loaded.code) notifyCode(loaded.code);
})
.catch((e) => {
if (alive) {
setSubmitError(`Не удалось загрузить заявку №${editId}: ${friendlyErrorMessage(e)}`);
}
});
return () => {
alive = false;
};
}, [editId, editListId, dataListRef, notifyCode, setSubmitError, setAttachmentItems]);
// Сотрудник + его организация (как в командировке); новая заявка — по умолчанию на себя.
const employeeControl = useContractEmployee(context, applicantEmail, !editId, data.Employee, (record) =>
set('Employee', record)
);
// Пропсы шапки: сотрудник + инициатор, который следует за сотрудником, пока его не выбрали руками.
const headerProps = useInitiatorAutofill(!!editId, data, set, applicantEmail, employeeControl);
// Маршрут — по сотруднику, без учётной записи — по заявителю (см. routeEmail); при
// переводе в другое подразделение принимающий руководитель — первым шагом.
const { matrix, executors } = useContractRoute({
context,
approval,
requestTypeId,
routeUserEmail: routeEmail(employeeControl.person, applicantEmail),
editId,
requestStatus,
readOnly,
receivingHeadEmail:
!readOnly && data.ChangeTypes.includes('department-transfer') ? data.DepartmentTransferReceivingHead : ''
});
const isValid = !!data.Employee && data.ChangeTypes.length > 0;
const validate = (): string | undefined => {
if (!isValid) return REQUIRED_FIELDS_MESSAGE;
if (requestTypeIdState.error) return `Не удалось определить тип заявки: ${requestTypeIdState.error}`;
if (!requestTypeId) return 'Тип заявки ещё определяется — подождите немного и повторите.';
return undefined;
};
const save = (status: string): (() => Promise<void>) => async (): Promise<void> => {
// validate() уже гарантировал requestTypeId, но TS этого через замыкание не видит.
const rtId = requestTypeId;
if (!rtId) {
throw new Error('Тип заявки не определён — обновите страницу и повторите.');
}
// Новая заявка пишется в ТЕКУЩУЮ партицию — спрашиваем её прямо перед записью.
const writeListId = await resolveWriteListId(context, FORM_ID, rtId, requestId, editListId);
const { id, code } = await saveContractChangeRequest(
requestId,
rtId,
data,
matrixToApprovers(matrix.rows),
executorsToWrite(executors.rows),
status,
writeListId
);
// id фиксируем ДО загрузки файлов: если она упадёт, повторное сохранение
// обновит эту же заявку, а не создаст вторую.
setRequestId(id);
setRequestStatus(status);
if (code) setRequestCode(code);
// Файлы — после записи элемента (нужен его id), с подписью-префиксом слота.
try {
await attachments.uploadPending(prepareFilesFor(data), {
listRef: writeListId || dataListTitle(FORM_ID),
itemId: id
});
} catch (e) {
throw new Error(`Заявка сохранена, но файлы не прикрепились: ${friendlyErrorMessage(e)}. Сохраните ещё раз.`);
}
if (onSaved) onSaved();
// Отправка — уведомляем первый активный шаг; списки той партиции, куда записали.
if (status === REQUEST_STATUS.onApproval || status === REQUEST_STATUS.execution) {
await notifyActiveStep(context, approval, id, {
requestTypeId: rtId,
dataListName: writeListId ? dataListTitleForListId(FORM_ID, writeListId) : dataListTitle(FORM_ID),
approvalListName: writeListId ? approvalListTitleForListId(FORM_ID, writeListId) : approvalListTitle(FORM_ID)
});
}
};
// На отправку маршрут должен быть укомплектован — шаг без человека молча пропал бы при записи.
const validateSubmit = (): string | undefined => {
const formError = validate();
if (formError) return formError;
// Обязательное по виду изменения (документы, принимающий руководитель и т.п.) — только на отправку.
const typeError = changeTypeSubmitError(data, attachments);
if (typeError) return typeError;
if (matrix.error) {
return `Не удалось определить маршрут согласования: ${matrix.error}. Попробуйте ещё раз или обратитесь к администратору.`;
}
const unassignedError = unassignedStepMessage(
matrix.rows,
(r) => `Шаг ${r.order} маршрута согласования («${r.position || 'без должности'}») без назначенного человека — выберите согласующего или удалите шаг.`
);
if (unassignedError) return unassignedError;
return unassignedStepMessage(
executors.rows,
(r) => `Шаг ${r.order} исполнения («${r.position || 'без должности'}») без назначенного человека — обратитесь к администратору маршрута.`
);
};
const handleSaveDraft = (): Promise<void> => submit.run('draft', save(REQUEST_STATUS.draft), validate);
const handleSubmit = (): Promise<void> =>
submit.run(
'submit',
save(
executors.rows.length > 0
? initialSubmitStatus(matrix.rows.length, executors.rows.length)
: REQUEST_STATUS.onApproval
),
validateSubmit
);
const handleDelete = getDraftDeleteHandler({
formKey: FORM_ID,
requestId,
requestStatus,
listId: editListId,
code: requestCode,
submit,
onDeleted: onCancel
});
return (
<div>
<button type="button" className={styles.back} onClick={onCancel}>
<Icon name="arrow-left" size="sm" />
<span>К списку заявок</span>
</button>
<FormCard
title={requestType.title}
subtitle="Категория: Отдел кадров"
belowSubtitle={
<InitiatorLine
listTitle={editListId ? dataListTitleForListId(FORM_ID, editListId) : dataListTitle(FORM_ID)}
itemId={requestId}
/>
}
headerRight={
requestId || requestStatus ? (
<>
{requestStatus && <StatusBadge status={requestStatus} />}
{requestCode && <RequestNumber code={requestCode} />}
</>
) : undefined
}
>
{submit.savedKind && !submit.error && (
<Alert variant="ok">
{submit.savedKind === 'draft' ? 'Черновик сохранён.' : 'Заявка отправлена на согласование.'}
</Alert>
)}
{submit.error && <Alert variant="err">{submit.error}</Alert>}
<FormModeProvider readOnly={readOnly}>
<RequestSection data={data} set={set} context={context} {...headerProps} />
<ChangeTypeSections data={data} set={set} context={context} attachments={attachments} />
</FormModeProvider>
<ApprovalMatrix
editor={matrix}
search={(q) => approval.searchUsers(q)}
canRemoveRow={composeRemoveRowRule(applicantEmail)}
/>
<ExecutorsMatrix editor={executors} search={(q) => approval.searchUsers(q)} />
{/* Автору на доработке важно видеть, почему вернули, — история и в форме. */}
{editId && (
<div className="rp-no-print">
<ApprovalHistory
approval={approval}
dataListRef={editListId || dataListTitle(FORM_ID)}
requestId={editId}
reloadKey={requestStatus}
/>
</div>
)}
<SubmitActions
onDelete={handleDelete}
submit={submit}
isValid={isValid}
readOnly={readOnly}
onCancel={onCancel}
onSaveDraft={handleSaveDraft}
onSubmit={handleSubmit}
submitLabel="Отправить на согласование"
/>
</FormCard>
</div>
);
};
export default ContractChangeForm;
@@ -1,9 +0,0 @@
@import '../../../../styles/design-tokens';
// Заглушка на время загрузки/ошибки — как в остальных просмотрах.
.state {
padding: $sp-8;
color: $gray-500;
font-size: $fs-sm;
text-align: center;
}
@@ -1,171 +0,0 @@
import * as React from 'react';
import { useState, useEffect, useMemo, useCallback } from 'react';
import type { WebPartContext } from '@microsoft/sp-webpart-base';
import styles from './ContractChangeView.module.scss';
import { Alert, FormCard, InitiatorLine, FormModeProvider } from '../../shared/ui';
import {
ApproverService,
DecisionPanel,
StatusBadge,
ApprovalMatrix,
ApprovalHistory,
useMatrixEditor,
useViewExecutors,
ExecutorsMatrix,
approvalPhaseRows,
notifyActiveStep,
useRequestTypeId
} from '../../shared/approval';
import { friendlyErrorMessage } from '../../shared/diagnostics';
import {
approvalListTitle,
approvalListTitleForListId,
dataListTitle,
dataListTitleForListId
} from '../../shared/listTitles';
import { FORM_ID, IFormData, EMPTY_DATA, SetField } from './model';
import { loadContractChangeRequest } from './load';
import { contractChangeApprovalService } from './submit';
import { RequestSection } from './sections/RequestSection';
import { ChangeTypeSections } from './byType/ChangeTypeSections';
import { useAttachmentEditor } from '../../shared/attachments/useAttachmentEditor';
import { getAttachments } from '../../shared/attachments/attachments.service';
import { useStableCallback } from '../../shared/useStableCallback';
interface IContractChangeViewProps {
context: WebPartContext;
itemId: number;
/** pageUrl формы — см. IApprovalViewProps в forms/viewRegistry.ts. */
formKey: string;
/** Партиция, где лежит ЭТА заявка — см. IApprovalViewProps.listId. */
listId?: string;
/** Уведомление о загруженном уникальном коде заявки — см. IApprovalViewProps.onCodeLoaded. */
onCodeLoaded?: (code: string) => void;
}
const VIEW_TITLE = 'Изменение условий трудового договора';
// В режиме чтения поля не редактируются, поэтому обновление — пустышка.
const NOOP_SET: SetField = () => undefined;
/**
* Заявка только для просмотра (режим согласующего): та же секция, что в форме
* подачи, под <FormModeProvider readOnly>, + маршрут, история и панель решения.
* Печати пока нет — бланк кадров ещё не согласован.
*/
const ContractChangeView: React.FC<IContractChangeViewProps> = ({ context, itemId, formKey, listId, onCodeLoaded }) => {
const notifyCode = useStableCallback(onCodeLoaded);
const [data, setData] = useState<IFormData>(EMPTY_DATA);
const [status, setStatus] = useState<string>('');
const [code, setCode] = useState<string>('');
const [loading, setLoading] = useState<boolean>(true);
const [error, setError] = useState<string>('');
const approval = useMemo(() => contractChangeApprovalService(listId), [listId]);
const { id: requestTypeId } = useRequestTypeId(context, formKey);
// listId (url) для архивной партиции, Title текущей — см. ApproverService.dataListRef.
const dataListRef = listId || dataListTitle(FORM_ID);
const approverService = useMemo(() => new ApproverService(approval, dataListRef), [approval, dataListRef]);
// Вложения — только для показа (секции рисуют их под FormModeProvider readOnly).
const attachments = useAttachmentEditor(dataListRef, itemId);
const { setItems: setAttachmentItems } = attachments;
// decisionSeq в reloadKey: после решения строки на сервере меняются — перечитываем матрицу.
const [decisionSeq, setDecisionSeq] = useState<number>(0);
const loadApprovers = useCallback(() => approval.getMatrixForRequest(itemId).then(approvalPhaseRows), [approval, itemId]);
const approvers = useMatrixEditor(loadApprovers, `a-${itemId}-${decisionSeq}`, false, true, (l) =>
approval.getJobTitle(l)
);
const executors = useViewExecutors(context, approval, itemId, decisionSeq);
useEffect(() => {
let alive = true;
setLoading(true);
Promise.all([loadContractChangeRequest(itemId, listId), getAttachments(dataListRef, itemId)])
.then(([loaded, files]) => {
if (!alive) return;
setData(loaded.data);
setAttachmentItems(files);
setStatus(loaded.status);
setCode(loaded.code);
notifyCode(loaded.code);
setError('');
setLoading(false);
})
.catch((e) => {
if (!alive) return;
setError(`Не удалось загрузить заявку №${itemId}: ${friendlyErrorMessage(e)}`);
setLoading(false);
});
return () => {
alive = false;
};
}, [itemId, listId, dataListRef, notifyCode, setAttachmentItems]);
if (loading) {
return <div className={styles.state}>Загрузка заявки…</div>;
}
if (error) {
return (
<div className={styles.state}>
<Alert variant="err">{error}</Alert>
</div>
);
}
const notify = (): void => {
// Тип ещё не резолвился — решение уже применилось, просто некого уведомлять;
// не роняем UI ради необязательного оповещения.
if (!requestTypeId) return;
notifyActiveStep(context, approval, itemId, {
requestTypeId,
dataListName: listId ? dataListTitleForListId(FORM_ID, listId) : dataListTitle(FORM_ID),
approvalListName: listId ? approvalListTitleForListId(FORM_ID, listId) : approvalListTitle(FORM_ID)
}).catch(() => undefined);
};
const handleRouteChanged = (): void => {
setDecisionSeq((n) => n + 1);
notify();
};
return (
<div>
<FormCard
title={VIEW_TITLE}
subtitle={`№${code || itemId}`}
belowSubtitle={
<InitiatorLine
listTitle={listId ? dataListTitleForListId(FORM_ID, listId) : dataListTitle(FORM_ID)}
itemId={itemId}
/>
}
headerRight={status ? <StatusBadge status={status} /> : undefined}
>
<FormModeProvider readOnly>
<RequestSection data={data} set={NOOP_SET} context={context} />
<ChangeTypeSections data={data} set={NOOP_SET} context={context} attachments={attachments} />
</FormModeProvider>
</FormCard>
<ApprovalMatrix editor={approvers} search={(q) => approval.searchUsers(q)} />
<ExecutorsMatrix editor={executors} search={(q) => approval.searchUsers(q)} />
{/* История: маршрут пересохраняется патчем (см. writeRoute), прошлые решения — в версиях строк. */}
<ApprovalHistory approval={approval} dataListRef={dataListRef} requestId={itemId} reloadKey={decisionSeq} />
<DecisionPanel
service={approverService}
requestId={itemId}
search={(q) => approval.searchUsers(q)}
onDecided={(newStatus) => {
setStatus(newStatus);
handleRouteChanged();
}}
onDelegated={handleRouteChanged}
/>
</div>
);
};
export default ContractChangeView;
@@ -1,127 +0,0 @@
# Изменение условий трудового договора (hr-contract-change)
**Назначение:** заявка на изменение условий трудового договора сотрудника (ст. 33 ТК РК) —
повышение оклада, надбавка, перевод, смена режима работы и т. д. (10 видов из ТЗ кадров).
**Категория:** Отдел кадров
**Списки SP:** «Изменение условий трудового договора 1 — данные» / «… 1 — согласование»
**RequestTypeId (внешний API маршрутов):** не хардкодится — резолвится в рантайме по
`pageUrl` («hr-contract-change») через `useRequestTypeId` (см. «Формы больше не хардкодят
RequestTypeId» в `docs/forms.md`). Тип и маршрут в админке approval-route ещё не заведены.
> **Статус (2026-10-29):** поля разобраны по всем видам, кроме 6 «Продление срока ТД»
> (это автоматический запрос, не обычная заявка — отдельно). ТЗ кадров — файл
> «ТЗ_ст33_маршруты_v2» (листы «Виды изменений ст.33» и «Маршрут»); оно общее, в форму
> из него попадает только то, что явно согласовано. Ещё не сделано: передача вида и
> инициатора в маршрут (`fieldValues`: фин. блок — виды 1, 2, 3, 5, 9; маршрут А/Б —
> по инициатору), печатный бланк, заведение типа и маршрутов в админке.
## Маршрут
- Фазы: согласование (+ исполнение, если его заведут в админке — форма поддерживает).
- Маршрут строится по **e-mail сотрудника**, а если его нет (рабочий без учётной
записи M365) — по **e-mail заявителя** (`routeEmail` в `model.ts`); на форме под
сотрудником тогда пометка об этом.
- Матрица редактируема заявителем при новой заявке / черновике / возврате.
- От вида изменения маршрут пока не зависит (`fieldValues` не передаются).
## Особое поведение
- **Сотрудник — из `Employee/FullBase`, а не People-picker** (`EmployeeFullBasePicker`,
`shared/dictionary`): так находятся и рабочие без учётной записи. Ищется по части
Ф.И.О. (от 3 букв), только работающие (`dismissalDate` пустая). Записи FullBase
(одна на место работы) собираются в человека по ИИН — в поиске он одной строкой.
- **Организация — отдельный список под сотрудником**, как «Командирующая организация»
в командировке: места работы человека в виде «Компания — должность — подразделение».
Одно место — выбрано само и заблокировано. Условия меняются в ОДНОМ договоре, поэтому
в заявку пишется только выбранное место работы. Логика — `useContractEmployee`.
⚠️ На 2026-10-28 FullBase отдаёт по человеку одну запись; бэкенд доработают, чтобы
возвращались все места работы — тогда у совместителей появится выбор.
- **Хранение сотрудника — снимок в текстовых колонках `Employee*`** (Ф.И.О., ИИН,
табельный, e-mail, организация, должность, подразделение, id записи), без колонки
People. Справочник со временем меняется, а заявка фиксирует данные на момент подачи.
- **По умолчанию — на себя** (`useContractEmployee`): Ф.И.О. из `Employee/ByEmail` →
поиск в `FullBase` → человек, у которого есть место работы с e-mail текущего
пользователя. Совместителю организацию не выбираем молча — выбирает сам.
- **Черновик/возврат:** список организаций подтягивается заново (поиск по Ф.И.О.,
тот же ИИН); не нашлось — в списке только сохранённая.
- **Маршрут строится по человеку** (его e-mail), а не по месту работы — поэтому
грузится сразу после выбора сотрудника, ещё до выбора организации.
- **Вид изменения** — `ChangeTypes`, MultiChoice в SP, массив в модели. По ТЗ выбор
один (`MAX_CHANGE_TYPES`, обычный `Select`); данные уже рассчитаны на несколько,
чтобы снять ограничение правкой UI, без миграции. В коде вид — ключ
(`ChangeType`), в SP — подпись (`CHANGE_TYPE_LABELS`): подпись = choice колонки,
менять только вместе с `provisioning.json`.
- **Заголовок элемента** (`Title`): `Изменение условий ТД — {ФИО} — дд.мм.гггг`.
## Поля по видам
Каждый вид — своя секция в `byType/<Вид>/`, подключается строкой в
`byType/ChangeTypeSections.tsx`; ключи модели и колонки SP — с префиксом вида.
Колонки невыбранного вида при сохранении очищаются (`null`), чтобы в заявке не
оставалось скрытых значений после смены вида.
| Вид | Секция | Поля (все необязательные, без ограничений) |
| --- | --- | --- |
| Повышение должностного оклада | `SalaryIncrease` | текущий оклад, новый оклад (`MoneyInput`, Number), дата изменения, причина (испытательный срок / расширение функционала / иное), обоснование — при «иное» это и есть текст причины |
| Установление надбавки / доплаты | `Allowance` | основание (а–д: надбавка или доплата видно из пункта), дата начала, дата окончания или «бессрочно» (флажок прячет и очищает дату), размер + переключатель «% / ₸» (`UnitSwitch`, по умолчанию %), обоснование — в т.ч. объём доп. работы при совмещении и текст «иное». Письменное согласие работника на совмещение оформляет кадровик после согласования — не в форме. Вложение **«Результаты аттестации»** — только при основании «г», обязательно |
| Перевод на другую должность (постоянный) | `PositionTransfer` | новая должность (`PositionPicker`: справочник `Dictionary/Positions` + ручной ввод), дата перевода, причина (карьерный рост / вакантная должность / новый объект, перераспределение функций / иное), обоснование. Работника и работодателя не различаем — причины видны всем, работник пишет текст заявления в обоснование. Вложение **«Должностная инструкция»** — всегда, обязательно |
| Перевод в другое подразделение | `DepartmentTransfer` | новое подразделение (`DepartmentPicker`, имя + id), дата перевода, причина (усиление подразделения / перераспределение функций / вакансия / иное), обоснование, **принимающий руководитель** (People, обязателен при отправке) — см. ниже |
| Изменение места работы (другая местность) | `WorkplaceChange` | место работы «было → стало» парой **организация + проект**: текущая организация — из «Организации» сотрудника (только чтение, отдельно не хранится — это `EmployeeCompany`), текущий проект (`ProjectPicker`); новая организация (`Dictionary/Companies`, **обязательна при отправке**, не подставляется) и новый проект; адрес нового места, дата, причина (новый объект / переезд подразделения или работодателя / иное), условия переезда и компенсации; переключатель **«Вахта»** → «График работы» (тот же набор, что в подборе и приёме, «Другое» → ручной ввод; без вахты график очищается); обоснование |
| Продление срока ТД | — | **пропущен** (2026-10-29): по ТЗ это автоматический запрос ОК за месяц до окончания срочного ТД (маршрут В), а не обычная заявка — решать отдельно |
| Изменение режима / графика работы | `ScheduleChange` | по ролям строго по ТЗ. Общее: текущий график + текущее время работы (списки как в подборе/приёме, «Другое» → текст; `OptionWithOtherField`, наборы — `byType/workSchedule.ts`), дата начала, вложение «Новый график» (необязательно). **Работник:** неполный рабочий день (часов) / неполная рабочая неделя (дней) — одно или оба, текст заявления. **Работодатель:** новый режим (вахтовый / сменный / иной + описание), новые график и время работы, причина (специфика объекта / смещение сроков проекта — только из ТЗ), обоснование. Поля другой роли при сохранении очищаются |
| Изменение трудовой функции (без смены должности) | `FunctionChange` | ровно по шаблону ТЗ: дата изменения, «В связи с» (свободный текст — списка причин в ТЗ нет), вложение **«Новая должностная инструкция»** — обязательно. Инициатор — только руководитель |
| Изменение условий труда по инициативе работодателя | `EmployerInitiative` | причина (из названия вида в ТЗ: экономические / технологические / изменения в организации / сокращение объёма работ + «Другое» со своим текстом); «Что меняется» — флажки а) график работы, б) должностной оклад (можно оба, при отправке — хотя бы один); а) текущий → новый график + дата; б) **один новый оклад + доля постоянной части в %** (по умолчанию 75 из ТЗ, 0–100, можно дробную), переменная доля = остаток до 100 %, суммы обеих частей в ₸ считаются сами (`salaryParts.ts`, превысить 100 % нельзя; в SP пишутся при сохранении) + дата; даты **не раньше +15 дней** (уведомление по ТЗ: блок в календаре + проверка при отправке); обоснование — **текстом ИЛИ документом**, одно из двух обязательно при отправке |
| Временный перевод при производственной необходимости / простое | `TemporaryTransfer` | откуда и куда — проект из справочника + работа текстом; дата начала / окончания — **не дольше 3 месяцев** (по ТЗ «до 3 мес. в календарном году»; включительно: с 01.01 по 31.03, `period.ts`; сумму за год проверяет HR-директор); основание (производственная необходимость / простой), обоснование; пометка из шаблона ТЗ «Оплата — не ниже средней заработной платы по прежней работе». Инициатор — только руководитель |
Обязательное по виду при отправке (инициатор, документы, принимающий руководитель,
новая организация) — одна функция `byType/submitChecks.ts`; черновик сохраняется без них.
**Инициатор (работник / работодатель)** — решение 2026-10-29: разделяем строго по
ТЗ, чтобы у кадров не было вопросов. Поле `ChangeInitiator` в шапке — только у
видов, которые по ТЗ может начать и работник (3, 4, 5, 7; `hasInitiatorChoice`).
По умолчанию при выборе вида: подаёт на себя — «Работник», за другого —
«Работодатель» (`defaultInitiatorRole`), под полем подсказка об этом; можно
поменять. Пока инициатора не выбирали руками, он следует за сотрудником: сменили
сотрудника — пересчитался (`useInitiatorAutofill`); после ручного выбора и у
открытого черновика — не трогается. От роли (`byType/InitiatorReasonFields`): работник — только «Текст
заявления» (по ТЗ «От работника: заявление (текст)»), работодатель — причина из
списка + «Обоснование». Текст пишется в ту же колонку `*Justification`; причина у
работника при сохранении очищается. Остальные поля вида — у обеих ролей.
**Принимающий руководитель — временное решение (2026-10-29).** По ТЗ (лист
«Маршрут»: А шаг 2, Б шаг 3 параллельно с непосредственным руководителем) его
согласие — шаг маршрута. Approval-route строит маршрут по сотруднику и найти
руководителя НОВОГО подразделения не умеет, поэтому шаг вставляет форма:
`byType/DepartmentTransfer/receivingHead.ts` (`withReceivingHead`, с тестами) —
первым шагом, с должностью-пометкой «Принимающий руководитель» (по ней шаг
узнаётся у черновика); вызывается из `useContractRoute`. Смена человека/вида
пересобирает маршрут. Ограничения: человек выбирается вручную; шаг всегда первым и
последовательным (для маршрута Б параллельность инициатор может включить в матрице);
SLA и настроек из админки у шага нет. **Правильное решение** — тип шага в
approval-route «руководитель подразделения из заявки» по `departmentId` (его
форма уже хранит в `DepartmentTransferNewDepartmentId`). Когда появится — удалить
поле, `receivingHead.ts` и `receivingHeadEmail` в `useContractRoute`, передать
`departmentId` в резолв.
**Вложения по колонке ТЗ «Что приложить»** (решение 2026-10-28): фиксированные
подписанные слоты по виду (подпись — что за документ); обязательны там, где ТЗ
прямо требует документ (вид 2 «г» — аттестация, вид 3 — ДИ, вид 8 — новая ДИ;
вид 9 — текст ИЛИ файл), «можно приложить» — необязательно (вид 7).
Как устроено: вложения элемента списка данных, подпись — префикс в имени файла
(`shared/attachments/attachmentCategories`, тот же механизм, что в «Приёме»), поле
слота — `AttachmentSlotField`. Какие слоты видны и обязательны — одна функция
`byType/attachmentSlots.ts` (`activeAttachmentSlots`); новый слот = строка там +
`AttachmentSlotField` в секции вида. Файлы грузятся после записи элемента; файлы
скрытого слота (сменили вид/основание) не грузятся. Обязательность проверяется
только при отправке — черновик сохраняется и без файла.
## Открытые вопросы (проверить на тесте)
- Выдаёт ли бэкенд (вебхуки) права на элемент по People-колонке `Employee`? Если да —
сотрудник, за которого подали заявку, её не увидит (такой колонки здесь нет).
- `Employee/FullBase`: ищет ли `Fio` по подстроке; что фильтрует `Status`.
## Секции формы
RequestSection (сотрудник · организация · вид изменения) · ChangeTypeSections (секция выбранного вида, см. «Поля по видам»)
## Точки входа
- rptype: `hr-contract-change`
- Режим согласующего (просмотр): есть (`ContractChangeView`), без печати
- «Создать на основе»: нет
@@ -1,13 +0,0 @@
@import '../../../../../../styles/design-tokens';
// Сумма + переключатель «% / ₸» в одну строку: поле тянется, переключатель — по содержимому.
.amount {
display: flex;
align-items: stretch;
gap: $sp-2;
}
.amountInput {
flex: 1;
min-width: 0;
}
@@ -1,103 +0,0 @@
import * as React from 'react';
import { FormGrid, FormField, MoneyInput, TextInput, TextArea, Select, Checkbox } from '../../../../shared/ui';
import { useFormReadOnly } from '@tnsu/ui-kit';
import { AttachmentSlotField } from '../../../../shared/attachments/AttachmentSlotField';
import { ISectionProps } from '../../model';
import { ALLOWANCE_REASONS, ATTESTATION_ATTACHMENT, requiresAttestation } from './options';
import { UnitSwitch } from './UnitSwitch';
import { sanitizePercentInput, amountForUnit } from './amount';
import styles from './AllowanceSection.module.scss';
/**
* Поля вида «Установление надбавки / доплаты». Состав согласован с Тимуром по ТЗ
* кадров: основание (а–д), срок с/по или бессрочно, размер в % или ₸, обоснование
* (в т.ч. объём доп. работы при совмещении). Поля необязательные; вложение
* «Результаты аттестации» — только при основании «г» и там обязательно (по ТЗ).
*
* Поля — в FormGrid без заголовка: вид уже выбран выше, заголовок его только дублировал.
*/
export const AllowanceSection: React.FC<ISectionProps> = ({ data, set, attachments }) => {
const readOnly = useFormReadOnly();
return (
<FormGrid>
<FormField label="Основание" htmlFor="AllowanceReason" full>
<Select
id="AllowanceReason"
value={data.AllowanceReason}
onChange={(v) => set('AllowanceReason', v)}
options={ALLOWANCE_REASONS}
placeholder="— выберите —"
/>
</FormField>
<FormField label="Дата начала" htmlFor="AllowanceStartDate">
<TextInput
id="AllowanceStartDate"
type="date"
value={data.AllowanceStartDate}
onChange={(v) => set('AllowanceStartDate', v)}
/>
</FormField>
<FormField label="Дата окончания" htmlFor="AllowanceEndDate">
{/* «Бессрочно» прячет дату окончания — и очищает её, чтобы не сохранить скрытое значение. */}
{!data.AllowanceIndefinite && (
<TextInput
id="AllowanceEndDate"
type="date"
value={data.AllowanceEndDate}
onChange={(v) => set('AllowanceEndDate', v)}
/>
)}
<Checkbox
checked={data.AllowanceIndefinite}
onChange={(checked) => {
set('AllowanceIndefinite', checked);
if (checked) set('AllowanceEndDate', '');
}}
label="Бессрочно"
/>
</FormField>
<FormField label="Размер" htmlFor="AllowanceAmount">
<div className={styles.amount}>
<div className={styles.amountInput}>
{/* Проценты бывают дробными (7,5 %), тенге — целые с разделителем тысяч. */}
{data.AllowanceUnit === '%' ? (
<TextInput
id="AllowanceAmount"
value={data.AllowanceAmount}
onChange={(v) => set('AllowanceAmount', sanitizePercentInput(v))}
placeholder="например, 7.5"
/>
) : (
<MoneyInput id="AllowanceAmount" value={data.AllowanceAmount} onChange={(v) => set('AllowanceAmount', v)} />
)}
</div>
<UnitSwitch
value={data.AllowanceUnit}
onChange={(unit) => {
set('AllowanceUnit', unit);
set('AllowanceAmount', amountForUnit(data.AllowanceAmount, unit));
}}
/>
</div>
</FormField>
<FormField label="Обоснование" htmlFor="AllowanceJustification" full>
<TextArea
id="AllowanceJustification"
value={data.AllowanceJustification}
onChange={(v) => set('AllowanceJustification', v)}
/>
</FormField>
{attachments && requiresAttestation(data.AllowanceReason) && (
<AttachmentSlotField
label={ATTESTATION_ATTACHMENT}
editor={attachments}
editable={!readOnly}
groupKey={ATTESTATION_ATTACHMENT}
category={ATTESTATION_ATTACHMENT}
required
/>
)}
</FormGrid>
);
};
@@ -1,40 +0,0 @@
@import '../../../../../../styles/design-tokens';
// Две кнопки впритык, как сегментный контрол; высота — как у полей ввода рядом.
.switch {
display: inline-flex;
flex-shrink: 0;
border: 1px solid $gray-300;
border-radius: $r-sm;
overflow: hidden;
}
.option {
min-width: 44px;
padding: 0 $sp-3;
border: 0;
background: $white;
font-family: $font-sans;
font-size: 13.5px;
color: $gray-700;
cursor: pointer;
transition: .15s;
& + & {
border-left: 1px solid $gray-300;
}
&:hover:not(:disabled) {
background: $gray-100;
}
&:disabled {
cursor: default;
}
}
.active,
.active:hover:not(:disabled) {
background: $navy-700;
color: $white;
}
@@ -1,36 +0,0 @@
import * as React from 'react';
import { useFormReadOnly } from '@tnsu/ui-kit';
import { AllowanceUnit, ALLOWANCE_UNITS } from './options';
import styles from './UnitSwitch.module.scss';
interface Props {
value: AllowanceUnit;
onChange: (unit: AllowanceUnit) => void;
}
/**
* Переключатель единицы размера «% / ₸» рядом с полем суммы. Сегментного
* контрола в ui-kit нет; если понадобится ещё где-то — перенести туда.
* В режиме чтения кнопки неактивны, выбранная остаётся подсвеченной.
*/
export const UnitSwitch: React.FC<Props> = ({ value, onChange }) => {
const readOnly = useFormReadOnly();
return (
<div className={styles.switch} role="radiogroup" aria-label="Единица размера">
{ALLOWANCE_UNITS.map((unit) => (
<button
key={unit}
type="button"
role="radio"
aria-checked={unit === value}
className={unit === value ? `${styles.option} ${styles.active}` : styles.option}
disabled={readOnly}
onClick={() => onChange(unit)}
>
{unit}
</button>
))}
</div>
);
};
@@ -1,33 +0,0 @@
import { sanitizePercentInput, amountForUnit } from './amount';
describe('sanitizePercentInput', () => {
it('оставляет целое как есть', () => {
expect(sanitizePercentInput('10')).toBe('10');
});
it('запятую превращает в точку', () => {
expect(sanitizePercentInput('7,5')).toBe('7.5');
});
it('выбрасывает буквы, пробелы и знак процента', () => {
expect(sanitizePercentInput(' 1a2 %')).toBe('12');
});
it('оставляет только первый разделитель и не больше двух знаков дроби', () => {
expect(sanitizePercentInput('1.2.345')).toBe('1.23');
});
it('разрешает разделитель в конце — человек ещё вводит дробь', () => {
expect(sanitizePercentInput('7,')).toBe('7.');
});
});
describe('amountForUnit', () => {
it('при переходе в тенге отбрасывает дробную часть', () => {
expect(amountForUnit('7.5', '₸')).toBe('7');
});
it('в процентах значение не меняет', () => {
expect(amountForUnit('7.5', '%')).toBe('7.5');
});
});
@@ -1,25 +0,0 @@
import { AllowanceUnit } from './options';
/** Знаков после разделителя у процента (7,25 %). */
const PERCENT_FRACTION_DIGITS = 2;
/**
* Ввод процента → «сырое» число строкой с точкой: «7,5» → «7.5». Пропускаем
* только цифры и один разделитель (запятая или точка), дробь — до 2 знаков.
* Не type=number: у TextInput нет step, и браузер считал бы 7.5 невалидным при шаге 1.
*/
export function sanitizePercentInput(text: string): string {
const normalized = text.replace(/,/g, '.').replace(/[^\d.]/g, '');
const [whole, ...rest] = normalized.split('.');
if (rest.length === 0) return whole;
return `${whole}.${rest.join('').slice(0, PERCENT_FRACTION_DIGITS)}`;
}
/**
* Значение суммы после смены единицы: в тенге сумма целая (MoneyInput),
* поэтому дробную часть процента отбрасываем, а не показываем «75» из «7.5».
*/
export function amountForUnit(amount: string, unit: AllowanceUnit): string {
if (unit === '₸') return amount.split('.')[0];
return amount;
}
@@ -1,41 +0,0 @@
import { ISelectOption } from '../../../../shared/ui';
/**
* Основания надбавки/доплаты — по шаблону текста ТЗ кадров (а–д). Что это —
* надбавка или доплата — видно из самого пункта, отдельного поля нет. Значения
* совпадают с choices колонки AllowanceReason (provisioning.json).
*/
export const ALLOWANCE_REASON_MENTORING = 'Надбавка: наставничество и обучение новых работников';
export const ALLOWANCE_REASON_TRAVEL = 'Надбавка: разъездной характер работы';
export const ALLOWANCE_REASON_COMBINING = 'Доплата: совмещение должностей / расширение зоны обслуживания';
export const ALLOWANCE_REASON_HAZARDOUS = 'Доплата: работа в тяжёлых, вредных и (или) опасных условиях труда';
export const ALLOWANCE_REASON_OTHER = 'Доплата: иное по решению первого руководителя';
export const ALLOWANCE_REASONS: ISelectOption[] = [
ALLOWANCE_REASON_MENTORING,
ALLOWANCE_REASON_TRAVEL,
ALLOWANCE_REASON_COMBINING,
ALLOWANCE_REASON_HAZARDOUS,
ALLOWANCE_REASON_OTHER
].map((reason) => ({ value: reason, label: reason }));
/**
* Вложение «Результаты аттестации» — по ТЗ прикладывается документ при доплате
* за вредные условия (пункт «г»); там же оно обязательно.
*/
export const ATTESTATION_ATTACHMENT = 'Результаты аттестации';
export function requiresAttestation(reason: string): boolean {
return reason === ALLOWANCE_REASON_HAZARDOUS;
}
/** Единица размера; значения = choices колонки AllowanceUnit. */
export type AllowanceUnit = '%' | '₸';
export const ALLOWANCE_UNITS: AllowanceUnit[] = ['%', '₸'];
/** По умолчанию — проценты: пример в ТЗ «Надбавка 10%». */
export const DEFAULT_ALLOWANCE_UNIT: AllowanceUnit = '%';
/** Строка из SP → единица; неизвестное/пустое — единица по умолчанию. */
export function allowanceUnitFromText(text: string): AllowanceUnit {
return ALLOWANCE_UNITS.find((unit) => unit === text) ?? DEFAULT_ALLOWANCE_UNIT;
}
@@ -1,6 +0,0 @@
// Поля вида идут сразу под шапкой (сотрудник · вид · инициатор) отдельной сеткой
// FormGrid. У сетки ui-kit нет внешнего отступа, а расстояние между строками полей —
// 18px (row-gap FormGrid): тот же отступ, чтобы стык двух сеток был не виден.
.typeFields {
margin-top: 18px;
}
@@ -1,47 +0,0 @@
import * as React from 'react';
import { ChangeType } from '../changeTypes';
import { ISectionProps } from '../model';
import { SalaryIncreaseSection } from './SalaryIncrease/SalaryIncreaseSection';
import { AllowanceSection } from './Allowance/AllowanceSection';
import { PositionTransferSection } from './PositionTransfer/PositionTransferSection';
import { DepartmentTransferSection } from './DepartmentTransfer/DepartmentTransferSection';
import { WorkplaceChangeSection } from './WorkplaceChange/WorkplaceChangeSection';
import { ScheduleChangeSection } from './ScheduleChange/ScheduleChangeSection';
import { FunctionChangeSection } from './FunctionChange/FunctionChangeSection';
import { EmployerInitiativeSection } from './EmployerInitiative/EmployerInitiativeSection';
import { TemporaryTransferSection } from './TemporaryTransfer/TemporaryTransferSection';
import styles from './ChangeTypeSections.module.scss';
/**
* Вид изменения → секция с его полями. Partial: поля видов добавляются по мере
* согласования с кадрами; у вида без секции под выбором просто ничего не появится.
* Новый вид = папка byType/<Вид>/ + строка здесь.
*/
const SECTION_BY_TYPE: Partial<Record<ChangeType, React.FC<ISectionProps>>> = {
'salary-increase': SalaryIncreaseSection,
allowance: AllowanceSection,
'position-transfer': PositionTransferSection,
'department-transfer': DepartmentTransferSection,
'workplace-change': WorkplaceChangeSection,
'schedule-change': ScheduleChangeSection,
'function-change': FunctionChangeSection,
'employer-initiative': EmployerInitiativeSection,
'temporary-transfer': TemporaryTransferSection
};
/**
* Секции всех выбранных видов, в порядке выбора (сейчас вид один — см. MAX_CHANGE_TYPES).
* Заголовка у секции нет — вид выбран прямо над ней; обёртка даёт только отступ от шапки.
*/
export const ChangeTypeSections: React.FC<ISectionProps> = (props) => (
<>
{props.data.ChangeTypes.map((type) => {
const Section = SECTION_BY_TYPE[type];
return Section ? (
<div key={type} className={styles.typeFields}>
<Section {...props} />
</div>
) : undefined;
})}
</>
);
@@ -1,62 +0,0 @@
import * as React from 'react';
import { FormGrid, FormField, TextInput, PeopleField } from '../../../../shared/ui';
import { InitiatorReasonFields } from '../InitiatorReasonFields';
import { DepartmentPicker } from '../../../../shared/dictionary';
import { ISectionProps } from '../../model';
import { DEPARTMENT_TRANSFER_REASONS } from './options';
/**
* Поля вида «Перевод в другое подразделение». Состав согласован с Тимуром по ТЗ
* кадров: новое подразделение (справочник), дата, причина (а–г), обоснование и
* принимающий руководитель. Его согласие по ТЗ — шаг маршрута: форма сама ставит
* его первым шагом согласования (см. receivingHead.ts). Обязателен при отправке.
*
* Поля — в FormGrid без заголовка: вид уже выбран выше, заголовок его только дублировал.
*/
export const DepartmentTransferSection: React.FC<ISectionProps> = ({ data, set, context }) => (
<FormGrid>
<FormField label="Новое подразделение" htmlFor="DepartmentTransferNewDepartment">
<DepartmentPicker
context={context}
id="DepartmentTransferNewDepartment"
value={data.DepartmentTransferNewDepartment}
valueId={data.DepartmentTransferNewDepartmentId}
onChange={(name, id) => {
set('DepartmentTransferNewDepartment', name);
set('DepartmentTransferNewDepartmentId', id);
}}
placeholder="Начните вводить название подразделения…"
/>
</FormField>
<FormField label="Дата перевода" htmlFor="DepartmentTransferDate">
<TextInput
id="DepartmentTransferDate"
type="date"
value={data.DepartmentTransferDate}
onChange={(v) => set('DepartmentTransferDate', v)}
/>
</FormField>
<FormField label="Принимающий руководитель" htmlFor="DepartmentTransferReceivingHead" required full>
<PeopleField
context={context}
value={data.DepartmentTransferReceivingHead}
onChange={(v) => set('DepartmentTransferReceivingHead', v)}
placeholder="Начните вводить Ф.И.О. руководителя, который принимает работника…"
/>
</FormField>
<InitiatorReasonFields
initiator={data.ChangeInitiator}
reason={{
id: 'DepartmentTransferReason',
value: data.DepartmentTransferReason,
options: DEPARTMENT_TRANSFER_REASONS,
onChange: (v) => set('DepartmentTransferReason', v)
}}
justification={{
id: 'DepartmentTransferJustification',
value: data.DepartmentTransferJustification,
onChange: (v) => set('DepartmentTransferJustification', v)
}}
/>
</FormGrid>
);
@@ -1,13 +0,0 @@
import { ISelectOption } from '../../../../shared/ui';
/**
* Причины перевода в другое подразделение — по шаблону текста ТЗ кадров (а–г).
* Работника и работодателя не различаем (как в переводе на должность).
* Значения совпадают с choices колонки DepartmentTransferReason (provisioning.json).
*/
export const DEPARTMENT_TRANSFER_REASONS: ISelectOption[] = [
'Усиление подразделения (рост объёма работ / запуск нового объекта)',
'Перераспределение функций между подразделениями',
'Вакансия, соответствующая квалификации работника',
'Иное'
].map((reason) => ({ value: reason, label: reason }));
@@ -1,55 +0,0 @@
import { IMatrixRow } from '../../../../shared/approval';
import { withReceivingHead, RECEIVING_HEAD_POSITION } from './receivingHead';
const row = (order: number, email: string, position = 'Директор'): IMatrixRow => ({
order,
who: email,
email,
position,
status: '—',
date: '',
comment: '',
allowReassign: false
});
const head = { email: 'head@tnsu.kz', name: 'Принимающий Иван' };
describe('withReceivingHead', () => {
it('вставляет принимающего первым шагом и сдвигает остальные', () => {
const result = withReceivingHead([row(1, 'hrd@tnsu.kz'), row(2, 'dir@tnsu.kz')], head);
expect(result.map((r) => [r.order, r.email, r.position])).toEqual([
[1, 'head@tnsu.kz', RECEIVING_HEAD_POSITION],
[2, 'hrd@tnsu.kz', 'Директор'],
[3, 'dir@tnsu.kz', 'Директор']
]);
});
it('сохраняет параллельные шаги параллельными', () => {
const result = withReceivingHead([row(1, 'a@tnsu.kz'), row(1, 'b@tnsu.kz'), row(2, 'c@tnsu.kz')], head);
expect(result.map((r) => r.order)).toEqual([1, 2, 2, 3]);
});
it('без принимающего убирает его шаг и перенумеровывает', () => {
const withHead = withReceivingHead([row(1, 'hrd@tnsu.kz')], head);
expect(withReceivingHead(withHead, undefined).map((r) => [r.order, r.email])).toEqual([[1, 'hrd@tnsu.kz']]);
});
it('при смене человека заменяет шаг, а не добавляет второй', () => {
const withHead = withReceivingHead([row(1, 'hrd@tnsu.kz')], head);
const result = withReceivingHead(withHead, { email: 'new@tnsu.kz', name: 'Новый' });
expect(result.filter((r) => r.position === RECEIVING_HEAD_POSITION).map((r) => r.email)).toEqual(['new@tnsu.kz']);
expect(result).toHaveLength(2);
});
it('тот же человек — строку не трогает (статус и комментарий доработки сохраняются)', () => {
const decided = { ...row(1, 'head@tnsu.kz', RECEIVING_HEAD_POSITION), status: 'Согласовано', comment: 'ок' };
const rows = [decided, row(2, 'hrd@tnsu.kz')];
expect(withReceivingHead(rows, head)).toBe(rows);
});
it('не дублирует человека, который уже есть в маршруте другой ролью', () => {
const result = withReceivingHead([row(1, 'HEAD@tnsu.kz', 'Руководитель')], head);
expect(result).toHaveLength(1);
expect(result[0].position).toBe('Руководитель');
});
});
@@ -1,68 +0,0 @@
import { IMatrixRow } from '../../../../shared/approval';
/**
* Принимающий руководитель в маршруте согласования (вид «Перевод в другое
* подразделение»). По ТЗ (лист «Маршрут», А шаг 2 / Б шаг 3) это отдельный шаг
* согласия. Approval-route строит маршрут по сотруднику и найти руководителя
* НОВОГО подразделения не может — поэтому шаг вставляет сама форма.
*
* Шаг узнаётся по должности-пометке: она сохраняется в строке маршрута (Title
* списка согласования) и читается обратно, поэтому у черновика шаг тоже находится.
*/
export const RECEIVING_HEAD_POSITION = 'Принимающий руководитель';
export interface IReceivingHead {
email: string;
name: string;
}
function isReceivingHeadRow(row: IMatrixRow): boolean {
return row.position === RECEIVING_HEAD_POSITION;
}
function sameEmail(a: string, b: string): boolean {
return !!a && a.toLowerCase() === b.toLowerCase();
}
/**
* Перенумеровать шаги подряд с 1, сохранив параллельность: строки с одинаковым
* order (параллельный шаг) снова получают одинаковый номер.
*/
function renumber(rows: IMatrixRow[]): IMatrixRow[] {
let order = 0;
let prevOrder: number | undefined;
return rows.map((row) => {
if (row.order !== prevOrder) order += 1;
prevOrder = row.order;
return { ...row, order };
});
}
/**
* Маршрут с принимающим руководителем ПЕРВЫМ шагом (сразу после инициатора, как
* в маршруте А). head не задан — шаг убирается (сменили вид или очистили поле).
*
* - Тот же человек уже стоит этим шагом — строку не трогаем: у возвращённой на
* доработку заявки в ней может быть статус и комментарий.
* - Человек уже есть в маршруте другой ролью (напр. он же непосредственный
* руководитель) — второй строкой не добавляем.
*/
export function withReceivingHead(rows: IMatrixRow[], head: IReceivingHead | undefined): IMatrixRow[] {
const existing = rows.find(isReceivingHeadRow);
if (head && existing && sameEmail(existing.email, head.email)) return rows;
const others = rows.filter((row) => !isReceivingHeadRow(row));
if (!head || others.some((row) => sameEmail(row.email, head.email))) return renumber(others);
const headRow: IMatrixRow = {
order: 0, // перенумерует renumber
who: head.name,
email: head.email,
position: RECEIVING_HEAD_POSITION,
status: others[0]?.status || '—',
date: '',
comment: '',
allowReassign: false
};
return renumber([headRow, ...others]);
}
@@ -1,15 +0,0 @@
@import '../../../../../../styles/design-tokens';
// Флажки «что меняется» — в строку, на узком экране переносятся.
.flags {
display: flex;
flex-wrap: wrap;
gap: $sp-2 $sp-6;
}
// Пояснение под датой (срок уведомления работника по ТЗ).
.hint {
margin-top: $sp-1;
font-size: $fs-label;
color: $gray-500;
}
@@ -1,179 +0,0 @@
import * as React from 'react';
import { FormGrid, FormField, TextInput, TextArea, Select, Checkbox, MoneyInput } from '../../../../shared/ui';
import { useFormReadOnly } from '@tnsu/ui-kit';
import { AttachmentSlotField } from '../../../../shared/attachments/AttachmentSlotField';
import { ISectionProps } from '../../model';
import { OptionWithOtherField } from '../OptionWithOtherField';
import { WORK_SCHEDULE_OPTIONS } from '../workSchedule';
import {
EMPLOYER_CHANGE_REASONS,
EMPLOYER_REASON_OTHER,
EMPLOYER_CHANGE_NOTICE_HINT,
EMPLOYER_JUSTIFICATION_ATTACHMENT,
minEmployerChangeDate
} from './options';
import { splitSalary, sanitizeFixedPercent } from './salaryParts';
import styles from './EmployerInitiativeSection.module.scss';
/**
* Поля вида «Изменение условий труда по инициативе работодателя» — по шаблону ТЗ:
* «в связи с ___ (причина) прошу: а) изменить график работы с ___ на ___ с …;
* б) изменить должностной оклад: постоянная часть 75 % — ___, переменная 25 % — ___, с …».
* Что меняется — флажки а/б (можно оба); оклад вводится один, доля постоянной части
* задаётся (по умолчанию 75 %), переменная — остаток до 100 %, суммы считаются сами. Даты — не раньше чем через 15 дней (уведомление работника по ТЗ).
* Обоснование — текстом или документом (одно из двух обязательно при отправке).
*
* Поля — в FormGrid без заголовка: вид уже выбран выше, заголовок его только дублировал.
*/
export const EmployerInitiativeSection: React.FC<ISectionProps> = ({ data, set, attachments }) => {
const readOnly = useFormReadOnly();
const minDate = minEmployerChangeDate();
const parts = splitSalary(data.EmployerChangeNewSalary, data.EmployerChangeFixedPercent);
return (
<FormGrid>
<FormField label="Причина" htmlFor="EmployerChangeReason" full>
<Select
id="EmployerChangeReason"
value={data.EmployerChangeReason}
onChange={(v) => {
set('EmployerChangeReason', v);
if (v !== EMPLOYER_REASON_OTHER) set('EmployerChangeReasonOther', '');
}}
options={EMPLOYER_CHANGE_REASONS}
placeholder="— выберите —"
/>
</FormField>
{data.EmployerChangeReason === EMPLOYER_REASON_OTHER && (
<FormField label="Причина (другое)" htmlFor="EmployerChangeReasonOther" full>
<TextInput
id="EmployerChangeReasonOther"
value={data.EmployerChangeReasonOther}
onChange={(v) => set('EmployerChangeReasonOther', v)}
/>
</FormField>
)}
<FormField label="Что меняется" htmlFor="EmployerChangeSchedule" full>
<div className={styles.flags}>
<Checkbox
checked={data.EmployerChangeSchedule}
onChange={(checked) => set('EmployerChangeSchedule', checked)}
label="График работы"
/>
<Checkbox
checked={data.EmployerChangeSalary}
onChange={(checked) => set('EmployerChangeSalary', checked)}
label="Должностной оклад"
/>
</div>
</FormField>
{data.EmployerChangeSchedule && (
<>
<OptionWithOtherField
label="Текущий график работы"
id="EmployerChangeCurrentSchedule"
value={data.EmployerChangeCurrentSchedule}
otherValue={data.EmployerChangeCurrentScheduleOther}
options={WORK_SCHEDULE_OPTIONS}
onChange={(v) => set('EmployerChangeCurrentSchedule', v)}
onOtherChange={(v) => set('EmployerChangeCurrentScheduleOther', v)}
/>
<OptionWithOtherField
label="Новый график работы"
id="EmployerChangeNewSchedule"
value={data.EmployerChangeNewSchedule}
otherValue={data.EmployerChangeNewScheduleOther}
options={WORK_SCHEDULE_OPTIONS}
onChange={(v) => set('EmployerChangeNewSchedule', v)}
onOtherChange={(v) => set('EmployerChangeNewScheduleOther', v)}
/>
<FormField label="Дата изменения графика" htmlFor="EmployerChangeScheduleDate" full>
<TextInput
id="EmployerChangeScheduleDate"
type="date"
value={data.EmployerChangeScheduleDate}
onChange={(v) => set('EmployerChangeScheduleDate', v)}
min={minDate}
/>
{!readOnly && <div className={styles.hint}>{EMPLOYER_CHANGE_NOTICE_HINT}</div>}
</FormField>
</>
)}
{data.EmployerChangeSalary && (
<>
<FormField label="Новый должностной оклад, ₸" htmlFor="EmployerChangeNewSalary" full>
<MoneyInput
id="EmployerChangeNewSalary"
value={data.EmployerChangeNewSalary}
onChange={(v) => set('EmployerChangeNewSalary', v)}
/>
</FormField>
{/* Задаётся только доля постоянной части; переменная — остаток до 100 %,
суммы считаются из оклада (см. salaryParts.ts) — превысить 100 % нельзя. */}
<FormField label="Постоянная (повременная) часть, %" htmlFor="EmployerChangeFixedPercent">
<TextInput
id="EmployerChangeFixedPercent"
value={data.EmployerChangeFixedPercent}
onChange={(v) => set('EmployerChangeFixedPercent', sanitizeFixedPercent(v))}
placeholder="например, 75"
/>
</FormField>
<FormField label="Переменная часть, %" htmlFor="EmployerChangeVariablePercent">
<TextInput
id="EmployerChangeVariablePercent"
value={parts ? String(parts.variablePercent) : ''}
onChange={() => undefined}
readOnly
/>
</FormField>
<FormField label="Постоянная часть, ₸" htmlFor="EmployerChangeFixedPart">
<MoneyInput
id="EmployerChangeFixedPart"
value={parts ? String(parts.fixed) : ''}
onChange={() => undefined}
readOnly
/>
</FormField>
<FormField label="Переменная часть, ₸" htmlFor="EmployerChangeVariablePart">
<MoneyInput
id="EmployerChangeVariablePart"
value={parts ? String(parts.variable) : ''}
onChange={() => undefined}
readOnly
/>
</FormField>
<FormField label="Дата изменения оклада" htmlFor="EmployerChangeSalaryDate" full>
<TextInput
id="EmployerChangeSalaryDate"
type="date"
value={data.EmployerChangeSalaryDate}
onChange={(v) => set('EmployerChangeSalaryDate', v)}
min={minDate}
/>
{!readOnly && <div className={styles.hint}>{EMPLOYER_CHANGE_NOTICE_HINT}</div>}
</FormField>
</>
)}
<FormField label="Обоснование" htmlFor="EmployerChangeJustification" full>
<TextArea
id="EmployerChangeJustification"
value={data.EmployerChangeJustification}
onChange={(v) => set('EmployerChangeJustification', v)}
/>
</FormField>
{attachments && (
<AttachmentSlotField
label={`${EMPLOYER_JUSTIFICATION_ATTACHMENT} (приказ о реорганизации, сокращении объёма и т. п.)`}
editor={attachments}
editable={!readOnly}
groupKey={EMPLOYER_JUSTIFICATION_ATTACHMENT}
category={EMPLOYER_JUSTIFICATION_ATTACHMENT}
/>
)}
</FormGrid>
);
};
@@ -1,36 +0,0 @@
import { ISelectOption } from '../../../../shared/ui';
import { isoDatePlusDays } from '../../../../shared/dateUtils';
/**
* Вид «Изменение условий труда по инициативе работодателя». Причины — из названия
* вида в ТЗ (экономические, технологические, изменения в организации, сокращение
* объёма работ) + «Другое» со своим текстом (решение Тимура 2026-10-29).
* Значения = choices колонки EmployerChangeReason.
*/
export const EMPLOYER_REASON_OTHER = 'Другое';
export const EMPLOYER_CHANGE_REASONS: ISelectOption[] = [
'Экономические причины',
'Технологические причины',
'Изменения в организации',
'Сокращение объёма работ',
EMPLOYER_REASON_OTHER
].map((reason) => ({ value: reason, label: reason }));
/**
* По ТЗ работника уведомляют не позднее чем за столько календарных дней до даты
* изменений — поэтому раньше дату не даём выбрать (как срок подачи в отпуске).
*/
export const EMPLOYER_CHANGE_NOTICE_DAYS = 15;
export const EMPLOYER_CHANGE_NOTICE_HINT = `Не раньше чем через ${EMPLOYER_CHANGE_NOTICE_DAYS} календарных дней: работника уведомляют за ${EMPLOYER_CHANGE_NOTICE_DAYS} дней до изменений.`;
/** Самая ранняя допустимая дата изменений, YYYY-MM-DD. */
export function minEmployerChangeDate(): string {
return isoDatePlusDays(EMPLOYER_CHANGE_NOTICE_DAYS);
}
/**
* Вложение-обоснование (приказ о реорганизации, сокращении объёма и т.п.). По ТЗ
* «ТЕКСТ ИЛИ ПРИЛОЖИТЬ ДОКУМЕНТ» — сам по себе необязателен, но при отправке
* нужен текст обоснования или этот файл (см. submitChecks).
*/
export const EMPLOYER_JUSTIFICATION_ATTACHMENT = 'Документ-обоснование';
@@ -1,43 +0,0 @@
import { splitSalary, sanitizeFixedPercent } from './salaryParts';
describe('splitSalary', () => {
it('по умолчанию из ТЗ — 75 / 25', () => {
expect(splitSalary('400000', '75')).toEqual({ fixedPercent: 75, variablePercent: 25, fixed: 300000, variable: 100000 });
});
it('своя доля: переменная часть — остаток до 100 %', () => {
expect(splitSalary('400000', '70')).toEqual({ fixedPercent: 70, variablePercent: 30, fixed: 280000, variable: 120000 });
});
it('при округлении сумма частей всё равно равна окладу', () => {
const parts = splitSalary('333333', '75');
expect(parts?.fixed).toBe(250000);
expect((parts?.fixed ?? 0) + (parts?.variable ?? 0)).toBe(333333);
});
it('дробная доля', () => {
expect(splitSalary('200000', '62.5')).toEqual({
fixedPercent: 62.5,
variablePercent: 37.5,
fixed: 125000,
variable: 75000
});
});
it('нет оклада или доли — частей нет', () => {
expect(splitSalary('', '75')).toBeUndefined();
expect(splitSalary('0', '75')).toBeUndefined();
expect(splitSalary('400000', '')).toBeUndefined();
});
});
describe('sanitizeFixedPercent', () => {
it('больше 100 не даёт', () => {
expect(sanitizeFixedPercent('150')).toBe('100');
});
it('пропускает обычные и дробные доли', () => {
expect(sanitizeFixedPercent('75')).toBe('75');
expect(sanitizeFixedPercent('62,5')).toBe('62.5');
});
});
@@ -1,50 +0,0 @@
import { sanitizePercentInput } from '../Allowance/amount';
/**
* Новый оклад делится на постоянную (повременную) и переменную части. В шаблоне ТЗ
* — 75 % / 25 %; по решению Тимура (2026-10-29) долю постоянной части можно задать
* самому, а переменная — всегда остаток до 100 %. Так сумма частей ровно 100 % и
* превысить её нельзя в принципе.
*/
export const DEFAULT_FIXED_PERCENT = '75';
const MAX_PERCENT = 100;
export interface ISalaryParts {
/** Доли в процентах; variablePercent = 100 − fixedPercent. */
fixedPercent: number;
variablePercent: number;
/** Суммы в тенге; variable — остаток, чтобы fixed + variable = оклад. */
fixed: number;
variable: number;
}
/**
* Ввод доли постоянной части → «сырое» число строкой: только цифры и один
* разделитель (как ввод процента надбавки), не больше 100.
*/
export function sanitizeFixedPercent(text: string): string {
const percent = sanitizePercentInput(text);
return Number(percent) > MAX_PERCENT ? String(MAX_PERCENT) : percent;
}
/** Доля постоянной части числом; пусто/некорректно/вне 0–100 — undefined. */
function parsePercent(raw: string): number | undefined {
const percent = Number(raw);
if (raw.trim() === '' || !Number.isFinite(percent) || percent < 0 || percent > MAX_PERCENT) return undefined;
return percent;
}
/**
* Оклад и доля постоянной части → проценты и суммы обеих частей. Постоянная сумма
* округляется до тенге, переменная — остаток (без расхождений от округления).
* Нет оклада или доли — undefined.
*/
export function splitSalary(salaryRaw: string, fixedPercentRaw: string): ISalaryParts | undefined {
const salary = Number(salaryRaw);
const fixedPercent = parsePercent(fixedPercentRaw);
if (salaryRaw.trim() === '' || !Number.isFinite(salary) || salary <= 0 || fixedPercent === undefined) {
return undefined;
}
const fixed = Math.round((salary * fixedPercent) / MAX_PERCENT);
return { fixedPercent, variablePercent: MAX_PERCENT - fixedPercent, fixed, variable: salary - fixed };
}
@@ -1,49 +0,0 @@
import * as React from 'react';
import { FormGrid, FormField, TextInput, TextArea } from '../../../../shared/ui';
import { useFormReadOnly } from '@tnsu/ui-kit';
import { AttachmentSlotField } from '../../../../shared/attachments/AttachmentSlotField';
import { ISectionProps } from '../../model';
import { NEW_JOB_DESCRIPTION_ATTACHMENT } from './options';
/**
* Поля вида «Изменение трудовой функции (без смены должности)». Ровно по шаблону
* ТЗ: «прошу внести изменения в трудовую функцию работника согласно ДИ во
* вложении с __.__.20__ в связи с ___ (текст)» — дата, «в связи с» (свободный
* текст, списка причин в ТЗ нет) и обязательная новая ДИ. Инициатор — только
* руководитель.
*
* Поля — в FormGrid без заголовка: вид уже выбран выше, заголовок его только дублировал.
*/
export const FunctionChangeSection: React.FC<ISectionProps> = ({ data, set, attachments }) => {
const readOnly = useFormReadOnly();
return (
<FormGrid>
<FormField label="Дата изменения" htmlFor="FunctionChangeDate">
<TextInput
id="FunctionChangeDate"
type="date"
value={data.FunctionChangeDate}
onChange={(v) => set('FunctionChangeDate', v)}
/>
</FormField>
<FormField label="В связи с" htmlFor="FunctionChangeReason" full>
<TextArea
id="FunctionChangeReason"
value={data.FunctionChangeReason}
onChange={(v) => set('FunctionChangeReason', v)}
/>
</FormField>
{attachments && (
<AttachmentSlotField
label={NEW_JOB_DESCRIPTION_ATTACHMENT}
editor={attachments}
editable={!readOnly}
groupKey={NEW_JOB_DESCRIPTION_ATTACHMENT}
category={NEW_JOB_DESCRIPTION_ATTACHMENT}
required
/>
)}
</FormGrid>
);
};
@@ -1,5 +0,0 @@
/**
* Вложение «Новая должностная инструкция» — по ТЗ «приложить документ», обязательно.
* Отдельная подпись от «Должностной инструкции» перевода на должность: это разные слоты.
*/
export const NEW_JOB_DESCRIPTION_ATTACHMENT = 'Новая должностная инструкция';
@@ -1,41 +0,0 @@
import * as React from 'react';
import { FormField, Select, TextArea, ISelectOption } from '../../../shared/ui';
import { InitiatorRole, INITIATOR_EMPLOYEE } from '../changeTypes';
import { EMPLOYEE_STATEMENT_LABEL } from '../model';
interface Props {
initiator: InitiatorRole | '';
/** Причина из списка — только у работодателя. */
reason: { id: string; value: string; options: ISelectOption[]; onChange: (value: string) => void };
/** Обоснование работодателя / текст заявления работника — одна и та же колонка вида. */
justification: { id: string; value: string; onChange: (value: string) => void };
}
/**
* Окончание секции вида, где по ТЗ шаблон зависит от инициатора:
* - работник — «заявление (текст)»: только «Текст заявления», без списка причин;
* - работодатель (и пока инициатор не выбран) — «в связи с: а) б) в)»: причина + обоснование.
* Поля кладутся прямо в сетку FormGrid секции (без обёртки) — как и остальные поля вида.
*/
export const InitiatorReasonFields: React.FC<Props> = ({ initiator, reason, justification }) => {
const isEmployee = initiator === INITIATOR_EMPLOYEE;
return (
<>
{!isEmployee && (
<FormField label="Причина" htmlFor={reason.id} full>
<Select
id={reason.id}
value={reason.value}
onChange={reason.onChange}
options={reason.options}
placeholder="— выберите —"
/>
</FormField>
)}
<FormField label={isEmployee ? EMPLOYEE_STATEMENT_LABEL : 'Обоснование'} htmlFor={justification.id} full>
<TextArea id={justification.id} value={justification.value} onChange={justification.onChange} />
</FormField>
</>
);
};
@@ -1,49 +0,0 @@
import * as React from 'react';
import { FormField, Select, TextInput, ISelectOption } from '../../../shared/ui';
import { OPTION_OTHER } from './workSchedule';
interface Props {
label: string;
id: string;
value: string;
/** Текст при «Другое». */
otherValue: string;
options: ISelectOption[];
onChange: (value: string) => void;
onOtherChange: (text: string) => void;
}
/**
* Выбор из списка + ручной ввод при «Другое» (как график/время работы в подборе
* и приёме). Выбрали не «Другое» — ручной текст очищается, чтобы не сохранить
* скрытое значение. Поля кладутся прямо в сетку FormGrid секции.
*/
export const OptionWithOtherField: React.FC<Props> = ({
label,
id,
value,
otherValue,
options,
onChange,
onOtherChange
}) => (
<>
<FormField label={label} htmlFor={id}>
<Select
id={id}
value={value}
onChange={(v) => {
onChange(v);
if (v !== OPTION_OTHER) onOtherChange('');
}}
options={options}
placeholder="— выберите —"
/>
</FormField>
{value === OPTION_OTHER && (
<FormField label={`${label} (другое)`} htmlFor={`${id}Other`}>
<TextInput id={`${id}Other`} value={otherValue} onChange={onOtherChange} />
</FormField>
)}
</>
);
@@ -1,66 +0,0 @@
import * as React from 'react';
import { FormGrid, FormField, TextInput } from '../../../../shared/ui';
import { InitiatorReasonFields } from '../InitiatorReasonFields';
import { useFormReadOnly } from '@tnsu/ui-kit';
import { PositionPicker } from '../../../../shared/dictionary';
import { AttachmentSlotField } from '../../../../shared/attachments/AttachmentSlotField';
import { ISectionProps } from '../../model';
import { POSITION_TRANSFER_REASONS, JOB_DESCRIPTION_ATTACHMENT } from './options';
/**
* Поля вида «Перевод на другую должность (постоянный)». Состав согласован с
* Тимуром по ТЗ кадров: новая должность (справочник с ручным вводом), дата,
* причина (а–г), обоснование и обязательная должностная инструкция. Текущая
* должность уже видна в «Организации» — отдельного «было» нет.
*
* Поля — в FormGrid без заголовка: вид уже выбран выше, заголовок его только дублировал.
*/
export const PositionTransferSection: React.FC<ISectionProps> = ({ data, set, context, attachments }) => {
const readOnly = useFormReadOnly();
return (
<FormGrid>
<FormField label="Новая должность" htmlFor="PositionTransferNewPosition">
<PositionPicker
context={context}
id="PositionTransferNewPosition"
value={data.PositionTransferNewPosition}
onChange={(v) => set('PositionTransferNewPosition', v)}
placeholder="Начните вводить название должности…"
/>
</FormField>
<FormField label="Дата перевода" htmlFor="PositionTransferDate">
<TextInput
id="PositionTransferDate"
type="date"
value={data.PositionTransferDate}
onChange={(v) => set('PositionTransferDate', v)}
/>
</FormField>
<InitiatorReasonFields
initiator={data.ChangeInitiator}
reason={{
id: 'PositionTransferReason',
value: data.PositionTransferReason,
options: POSITION_TRANSFER_REASONS,
onChange: (v) => set('PositionTransferReason', v)
}}
justification={{
id: 'PositionTransferJustification',
value: data.PositionTransferJustification,
onChange: (v) => set('PositionTransferJustification', v)
}}
/>
{attachments && (
<AttachmentSlotField
label={JOB_DESCRIPTION_ATTACHMENT}
editor={attachments}
editable={!readOnly}
groupKey={JOB_DESCRIPTION_ATTACHMENT}
category={JOB_DESCRIPTION_ATTACHMENT}
required
/>
)}
</FormGrid>
);
};
@@ -1,17 +0,0 @@
import { ISelectOption } from '../../../../shared/ui';
/**
* Причины перевода на другую должность — по шаблону текста ТЗ кадров (а–г).
* Работника и работодателя не различаем (решение 2026-10-28): причины видны
* всем, работник при необходимости выбирает «Иное» и пишет текст в обоснование.
* Значения совпадают с choices колонки PositionTransferReason (provisioning.json).
*/
export const POSITION_TRANSFER_REASONS: ISelectOption[] = [
'Карьерный рост (успешное выполнение обязанностей, высокие результаты)',
'Вакантная должность, соответствующая квалификации работника',
'Открытие нового объекта / проекта, перераспределение функций',
'Иное'
].map((reason) => ({ value: reason, label: reason }));
/** Вложение «Должностная инструкция» — по ТЗ ПРИКЛАДЫВАЕТСЯ всегда, обязательно. */
export const JOB_DESCRIPTION_ATTACHMENT = 'Должностная инструкция';
@@ -1,54 +0,0 @@
import * as React from 'react';
import { FormGrid, FormField, MoneyInput, TextInput, TextArea, Select } from '../../../../shared/ui';
import { ISectionProps } from '../../model';
import { SALARY_INCREASE_REASONS } from './reasons';
/**
* Поля вида «Повышение должностного оклада». Состав согласован с Тимуром по ТЗ
* кадров: было/стало, дата, причина (а/б/в) и обоснование. Все необязательные,
* без ограничений — по решению от 2026-10-28.
*
* Поля — в FormGrid без заголовка: вид уже выбран выше, заголовок его только дублировал.
*/
export const SalaryIncreaseSection: React.FC<ISectionProps> = ({ data, set }) => (
<FormGrid>
<FormField label="Текущий оклад, ₸" htmlFor="SalaryIncreaseCurrent">
<MoneyInput
id="SalaryIncreaseCurrent"
value={data.SalaryIncreaseCurrent}
onChange={(v) => set('SalaryIncreaseCurrent', v)}
/>
</FormField>
<FormField label="Новый оклад, ₸" htmlFor="SalaryIncreaseNew">
<MoneyInput
id="SalaryIncreaseNew"
value={data.SalaryIncreaseNew}
onChange={(v) => set('SalaryIncreaseNew', v)}
/>
</FormField>
<FormField label="Дата изменения" htmlFor="SalaryIncreaseDate">
<TextInput
id="SalaryIncreaseDate"
type="date"
value={data.SalaryIncreaseDate}
onChange={(v) => set('SalaryIncreaseDate', v)}
/>
</FormField>
<FormField label="Причина" htmlFor="SalaryIncreaseReason">
<Select
id="SalaryIncreaseReason"
value={data.SalaryIncreaseReason}
onChange={(v) => set('SalaryIncreaseReason', v)}
options={SALARY_INCREASE_REASONS}
placeholder="— выберите —"
/>
</FormField>
<FormField label="Обоснование" htmlFor="SalaryIncreaseJustification" full>
<TextArea
id="SalaryIncreaseJustification"
value={data.SalaryIncreaseJustification}
onChange={(v) => set('SalaryIncreaseJustification', v)}
/>
</FormField>
</FormGrid>
);
@@ -1,16 +0,0 @@
import { ISelectOption } from '../../../../shared/ui';
/**
* Причины повышения оклада — по шаблону текста ТЗ кадров (а/б/в). Значения
* совпадают с choices колонки SalaryIncreaseReason (provisioning.json).
* «Иное» отдельного текста не имеет — его раскрывает поле «Обоснование».
*/
export const SALARY_REASON_PROBATION = 'Успешное прохождение испытательного срока';
export const SALARY_REASON_RESPONSIBILITY = 'Расширение функционала / зоны ответственности';
export const SALARY_REASON_OTHER = 'Иное';
export const SALARY_INCREASE_REASONS: ISelectOption[] = [
{ value: SALARY_REASON_PROBATION, label: SALARY_REASON_PROBATION },
{ value: SALARY_REASON_RESPONSIBILITY, label: SALARY_REASON_RESPONSIBILITY },
{ value: SALARY_REASON_OTHER, label: SALARY_REASON_OTHER }
];
@@ -1,153 +0,0 @@
import * as React from 'react';
import { FormGrid, FormField, TextInput, Select } from '../../../../shared/ui';
import { useFormReadOnly } from '@tnsu/ui-kit';
import { AttachmentSlotField } from '../../../../shared/attachments/AttachmentSlotField';
import { INITIATOR_EMPLOYEE } from '../../changeTypes';
import { ISectionProps } from '../../model';
import { InitiatorReasonFields } from '../InitiatorReasonFields';
import { OptionWithOtherField } from '../OptionWithOtherField';
import { WORK_SCHEDULE_OPTIONS, WORK_HOURS_OPTIONS } from '../workSchedule';
import {
MODE_OTHER,
NEW_SCHEDULE_ATTACHMENT,
SCHEDULE_CHANGE_NEW_MODES,
SCHEDULE_CHANGE_REASONS
} from './options';
/**
* Поля вида «Изменение режима / графика работы» — по ролям, строго по шаблонам ТЗ
* (см. options.ts). Общее: текущий режим (график + время работы), дата начала,
* необязательный документ «Новый график». Работник — неполное рабочее время
* (часов в день / дней в неделю) и текст заявления; работодатель — новый режим,
* новые график и время работы, причина и обоснование. Все поля необязательные.
*
* Поля — в FormGrid без заголовка: вид уже выбран выше, заголовок его только дублировал.
*/
export const ScheduleChangeSection: React.FC<ISectionProps> = ({ data, set, attachments }) => {
const readOnly = useFormReadOnly();
const isEmployee = data.ChangeInitiator === INITIATOR_EMPLOYEE;
return (
<FormGrid>
<OptionWithOtherField
label="Текущий график работы"
id="ScheduleChangeCurrentSchedule"
value={data.ScheduleChangeCurrentSchedule}
otherValue={data.ScheduleChangeCurrentScheduleOther}
options={WORK_SCHEDULE_OPTIONS}
onChange={(v) => set('ScheduleChangeCurrentSchedule', v)}
onOtherChange={(v) => set('ScheduleChangeCurrentScheduleOther', v)}
/>
<OptionWithOtherField
label="Текущее время работы"
id="ScheduleChangeCurrentHours"
value={data.ScheduleChangeCurrentHours}
otherValue={data.ScheduleChangeCurrentHoursOther}
options={WORK_HOURS_OPTIONS}
onChange={(v) => set('ScheduleChangeCurrentHours', v)}
onOtherChange={(v) => set('ScheduleChangeCurrentHoursOther', v)}
/>
<FormField label="Дата начала" htmlFor="ScheduleChangeDate" full>
<TextInput
id="ScheduleChangeDate"
type="date"
value={data.ScheduleChangeDate}
onChange={(v) => set('ScheduleChangeDate', v)}
/>
</FormField>
{isEmployee && (
<>
{/* Термины ТК: неполный рабочий день / неполная рабочая неделя — без них
«часов в день» читалось непонятно к чему. Заполнить можно одно или оба. */}
<FormField label="Неполный рабочий день, часов" htmlFor="ScheduleChangeHoursPerDay">
<TextInput
id="ScheduleChangeHoursPerDay"
type="number"
value={data.ScheduleChangeHoursPerDay}
onChange={(v) => set('ScheduleChangeHoursPerDay', v)}
placeholder="например, 6"
/>
</FormField>
<FormField label="Неполная рабочая неделя, дней" htmlFor="ScheduleChangeDaysPerWeek">
<TextInput
id="ScheduleChangeDaysPerWeek"
type="number"
value={data.ScheduleChangeDaysPerWeek}
onChange={(v) => set('ScheduleChangeDaysPerWeek', v)}
placeholder="например, 4"
/>
</FormField>
</>
)}
{!isEmployee && (
<>
<FormField label="Новый режим" htmlFor="ScheduleChangeNewMode" full>
<Select
id="ScheduleChangeNewMode"
value={data.ScheduleChangeNewMode}
onChange={(v) => {
set('ScheduleChangeNewMode', v);
if (v !== MODE_OTHER) set('ScheduleChangeNewModeOther', '');
}}
options={SCHEDULE_CHANGE_NEW_MODES}
placeholder="— выберите —"
/>
</FormField>
{data.ScheduleChangeNewMode === MODE_OTHER && (
<FormField label="Иной режим (описание)" htmlFor="ScheduleChangeNewModeOther" full>
<TextInput
id="ScheduleChangeNewModeOther"
value={data.ScheduleChangeNewModeOther}
onChange={(v) => set('ScheduleChangeNewModeOther', v)}
/>
</FormField>
)}
<OptionWithOtherField
label="Новый график работы"
id="ScheduleChangeNewSchedule"
value={data.ScheduleChangeNewSchedule}
otherValue={data.ScheduleChangeNewScheduleOther}
options={WORK_SCHEDULE_OPTIONS}
onChange={(v) => set('ScheduleChangeNewSchedule', v)}
onOtherChange={(v) => set('ScheduleChangeNewScheduleOther', v)}
/>
<OptionWithOtherField
label="Новое время работы"
id="ScheduleChangeNewHours"
value={data.ScheduleChangeNewHours}
otherValue={data.ScheduleChangeNewHoursOther}
options={WORK_HOURS_OPTIONS}
onChange={(v) => set('ScheduleChangeNewHours', v)}
onOtherChange={(v) => set('ScheduleChangeNewHoursOther', v)}
/>
</>
)}
<InitiatorReasonFields
initiator={data.ChangeInitiator}
reason={{
id: 'ScheduleChangeReason',
value: data.ScheduleChangeReason,
options: SCHEDULE_CHANGE_REASONS,
onChange: (v) => set('ScheduleChangeReason', v)
}}
justification={{
id: 'ScheduleChangeJustification',
value: data.ScheduleChangeJustification,
onChange: (v) => set('ScheduleChangeJustification', v)
}}
/>
{attachments && (
<AttachmentSlotField
label={NEW_SCHEDULE_ATTACHMENT}
editor={attachments}
editable={!readOnly}
groupKey={NEW_SCHEDULE_ATTACHMENT}
category={NEW_SCHEDULE_ATTACHMENT}
/>
)}
</FormGrid>
);
};
@@ -1,23 +0,0 @@
import { ISelectOption } from '../../../../shared/ui';
/**
* Вид «Изменение режима / графика работы». По ТЗ шаблон зависит от инициатора:
* - работник: «прошу установить неполное рабочее время (___ ч в день / ___ дней
* в неделю) с __.__.20__ (текст)»;
* - работодатель: «прошу перевести работника на а) вахтовый метод; б) сменный
* график; в) иной режим (текст) с __.__.20__ в связи со спецификой объекта /
* смещением сроков проекта».
* Значения = choices колонок ScheduleChangeNewMode / ScheduleChangeReason.
*/
export const MODE_OTHER = 'Иной режим';
export const SCHEDULE_CHANGE_NEW_MODES: ISelectOption[] = ['Вахтовый метод', 'Сменный график', MODE_OTHER].map(
(mode) => ({ value: mode, label: mode })
);
/** Причины работодателя — ровно те, что в шаблоне ТЗ («Иное» в ТЗ нет — не добавляем). */
export const SCHEDULE_CHANGE_REASONS: ISelectOption[] = ['Специфика объекта', 'Смещение сроков проекта'].map(
(reason) => ({ value: reason, label: reason })
);
/** Вложение «Новый график» — по ТЗ «можно приложить документ», необязательно. */
export const NEW_SCHEDULE_ATTACHMENT = 'Новый график';
@@ -1,15 +0,0 @@
@import '../../../../../../styles/design-tokens';
// Пояснение под полем (ограничение периода).
.hint {
margin-top: $sp-1;
font-size: $fs-label;
color: $gray-500;
}
// Гарантия по оплате из шаблона ТЗ — на всю ширину сетки, приглушённо, как пометка.
.payNote {
grid-column: 1 / -1;
font-size: $fs-sm;
color: $gray-500;
}
@@ -1,99 +0,0 @@
import * as React from 'react';
import { FormGrid, FormField, TextInput, TextArea, Select } from '../../../../shared/ui';
import { ProjectPicker } from '../../../../shared/dictionary';
import { ISectionProps } from '../../model';
import { TEMPORARY_TRANSFER_REASONS, TEMPORARY_TRANSFER_PAY_NOTE, TEMPORARY_TRANSFER_PERIOD_HINT } from './options';
import { maxTransferEndDate } from './period';
import styles from './TemporaryTransferSection.module.scss';
const PROJECT_PLACEHOLDER = 'Начните вводить название или код проекта…';
/**
* Поля вида «Временный перевод при производственной необходимости / простое» — по
* шаблону ТЗ: «прошу временно перевести работника с ___ (объект / работа) на ___
* с … по … в связи с ___ (производственная необходимость / простой). Оплата — не
* ниже средней заработной платы по прежней работе». Откуда/куда — проект из
* справочника + работа текстом; период не длиннее 3 месяцев (period.ts).
* Инициатор — только руководитель.
*
* Поля — в FormGrid без заголовка: вид уже выбран выше, заголовок его только дублировал.
*/
export const TemporaryTransferSection: React.FC<ISectionProps> = ({ data, set, context }) => (
<FormGrid>
<FormField label="Откуда: проект / объект" htmlFor="TemporaryTransferFromProject">
<ProjectPicker
context={context}
id="TemporaryTransferFromProject"
value={data.TemporaryTransferFromProject}
onChange={(name, id) => {
set('TemporaryTransferFromProject', name);
set('TemporaryTransferFromProjectId', id);
}}
placeholder={PROJECT_PLACEHOLDER}
/>
</FormField>
<FormField label="Откуда: работа" htmlFor="TemporaryTransferFromWork">
<TextInput
id="TemporaryTransferFromWork"
value={data.TemporaryTransferFromWork}
onChange={(v) => set('TemporaryTransferFromWork', v)}
/>
</FormField>
<FormField label="Куда: проект / объект" htmlFor="TemporaryTransferToProject">
<ProjectPicker
context={context}
id="TemporaryTransferToProject"
value={data.TemporaryTransferToProject}
onChange={(name, id) => {
set('TemporaryTransferToProject', name);
set('TemporaryTransferToProjectId', id);
}}
placeholder={PROJECT_PLACEHOLDER}
/>
</FormField>
<FormField label="Куда: работа" htmlFor="TemporaryTransferToWork">
<TextInput
id="TemporaryTransferToWork"
value={data.TemporaryTransferToWork}
onChange={(v) => set('TemporaryTransferToWork', v)}
/>
</FormField>
<FormField label="Дата начала" htmlFor="TemporaryTransferStartDate">
<TextInput
id="TemporaryTransferStartDate"
type="date"
value={data.TemporaryTransferStartDate}
onChange={(v) => set('TemporaryTransferStartDate', v)}
/>
</FormField>
<FormField label="Дата окончания" htmlFor="TemporaryTransferEndDate">
{/* Не раньше начала и не дольше 3 месяцев — календарь не даст выбрать лишнее. */}
<TextInput
id="TemporaryTransferEndDate"
type="date"
value={data.TemporaryTransferEndDate}
onChange={(v) => set('TemporaryTransferEndDate', v)}
min={data.TemporaryTransferStartDate || undefined}
max={maxTransferEndDate(data.TemporaryTransferStartDate)}
/>
<div className={styles.hint}>{TEMPORARY_TRANSFER_PERIOD_HINT}</div>
</FormField>
<FormField label="Основание" htmlFor="TemporaryTransferReason" full>
<Select
id="TemporaryTransferReason"
value={data.TemporaryTransferReason}
onChange={(v) => set('TemporaryTransferReason', v)}
options={TEMPORARY_TRANSFER_REASONS}
placeholder="— выберите —"
/>
</FormField>
<FormField label="Обоснование" htmlFor="TemporaryTransferJustification" full>
<TextArea
id="TemporaryTransferJustification"
value={data.TemporaryTransferJustification}
onChange={(v) => set('TemporaryTransferJustification', v)}
/>
</FormField>
<div className={styles.payNote}>{TEMPORARY_TRANSFER_PAY_NOTE}</div>
</FormGrid>
);
@@ -1,17 +0,0 @@
import { ISelectOption } from '../../../../shared/ui';
import { MAX_TRANSFER_MONTHS } from './period';
/**
* Основания временного перевода — из шаблона ТЗ («в связи с ___ (производственная
* необходимость / простой)»). Значения = choices колонки TemporaryTransferReason.
*/
export const TEMPORARY_TRANSFER_REASONS: ISelectOption[] = ['Производственная необходимость', 'Простой'].map(
(reason) => ({ value: reason, label: reason })
);
/** Гарантия работнику из шаблона ТЗ — показывается на форме пометкой. */
export const TEMPORARY_TRANSFER_PAY_NOTE = 'Оплата — не ниже средней заработной платы по прежней работе.';
/** Пояснение под датой окончания. */
export const TEMPORARY_TRANSFER_PERIOD_HINT = `Не дольше ${MAX_TRANSFER_MONTHS} месяцев.`;
export const TEMPORARY_TRANSFER_PERIOD_ERROR = `Временный перевод — не дольше ${MAX_TRANSFER_MONTHS} месяцев, и дата окончания не раньше даты начала.`;
@@ -1,23 +0,0 @@
import { maxTransferEndDate } from './period';
describe('maxTransferEndDate', () => {
it('3 месяца включительно: с 01.01 — по 31.03', () => {
expect(maxTransferEndDate('2026-01-01')).toBe('2026-03-31');
});
it('с середины месяца', () => {
expect(maxTransferEndDate('2026-02-15')).toBe('2026-05-14');
});
it('через новый год', () => {
expect(maxTransferEndDate('2026-11-01')).toBe('2027-01-31');
});
it('конец месяца не уезжает в следующий (30.11 + 3 мес. = 28.02)', () => {
expect(maxTransferEndDate('2026-11-30')).toBe('2027-02-27');
});
it('пустая дата — нет ограничения', () => {
expect(maxTransferEndDate('')).toBeUndefined();
});
});
@@ -1,25 +0,0 @@
/**
* Временный перевод — не дольше 3 месяцев (ТЗ: «До 3 месяцев в течение
* календарного года»; сумму за год форма не видит — её проверяет HR-директор).
*/
export const MAX_TRANSFER_MONTHS = 3;
function pad2(n: number): string {
return n < 10 ? `0${n}` : `${n}`;
}
/**
* Последний допустимый день периода, начатого start (YYYY-MM-DD): start + 3 месяца
* − 1 день, оба дня включительно (с 01.01 — по 31.03). К концу месяца прижимаем:
* 30.11 + 3 мес. — это 28.02, а не 02.03. Некорректная дата — undefined.
*/
export function maxTransferEndDate(startIso: string): string | undefined {
const [year, month, day] = startIso.split('-').map(Number);
if (!year || !month || !day) return undefined;
const targetMonthIndex = month - 1 + MAX_TRANSFER_MONTHS;
const lastDayOfTargetMonth = new Date(year, targetMonthIndex + 1, 0).getDate();
const end = new Date(year, targetMonthIndex, Math.min(day, lastDayOfTargetMonth));
end.setDate(end.getDate() - 1);
return `${end.getFullYear()}-${pad2(end.getMonth() + 1)}-${pad2(end.getDate())}`;
}
@@ -1,8 +0,0 @@
@import '../../../../../../styles/design-tokens';
// Ошибка загрузки справочника под полем (не прячем за пустым списком).
.fieldError {
margin-top: $sp-1;
font-size: $fs-label;
color: $red-500;
}
@@ -1,132 +0,0 @@
import * as React from 'react';
import { FormGrid, FormField, TextInput, TextArea, Select, Toggle } from '../../../../shared/ui';
import { ProjectPicker } from '../../../../shared/dictionary';
import { ISectionProps } from '../../model';
import { WORKPLACE_CHANGE_REASONS } from './options';
import { WORK_SCHEDULE_OPTIONS } from '../workSchedule';
import { OptionWithOtherField } from '../OptionWithOtherField';
import { useCompanyOptions } from './useCompanyOptions';
import { InitiatorReasonFields } from '../InitiatorReasonFields';
import styles from './WorkplaceChangeSection.module.scss';
const PROJECT_PLACEHOLDER = 'Начните вводить название или код проекта…';
/**
* Поля вида «Изменение места работы (другая местность)». Состав согласован с
* Тимуром по ТЗ кадров: место работы «было → стало» парой «организация + проект»
* (текущая организация — из выбранной в шапке, новая обязательна), адрес, дата,
* причина (а–в), условия переезда, вахта с графиком работы, обоснование.
*
* Поля — в FormGrid без заголовка: вид уже выбран выше, заголовок его только дублировал.
*/
export const WorkplaceChangeSection: React.FC<ISectionProps> = ({ data, set, context }) => {
const companies = useCompanyOptions(context);
return (
<FormGrid>
<FormField label="Текущая организация" htmlFor="WorkplaceChangeCurrentCompany">
{/* Та же, что выбрана в «Организации» сотрудника, — второй раз не вводим. */}
<TextInput id="WorkplaceChangeCurrentCompany" value={data.Employee?.company || ''} onChange={() => undefined} readOnly />
</FormField>
<FormField label="Текущий проект" htmlFor="WorkplaceChangeCurrentProject">
<ProjectPicker
context={context}
id="WorkplaceChangeCurrentProject"
value={data.WorkplaceChangeCurrentProject}
onChange={(name, id) => {
set('WorkplaceChangeCurrentProject', name);
set('WorkplaceChangeCurrentProjectId', id);
}}
placeholder={PROJECT_PLACEHOLDER}
/>
</FormField>
<FormField label="Новая организация" htmlFor="WorkplaceChangeNewCompanyId" required>
<Select
id="WorkplaceChangeNewCompanyId"
value={data.WorkplaceChangeNewCompanyId}
onChange={(id) => {
set('WorkplaceChangeNewCompanyId', id);
set('WorkplaceChangeNewCompany', companies.byId.get(id)?.Name || '');
}}
options={companies.options}
placeholder={companies.loading ? 'Загрузка…' : '— выберите —'}
/>
{companies.error && <div className={styles.fieldError}>{companies.error}</div>}
</FormField>
<FormField label="Новый проект" htmlFor="WorkplaceChangeNewProject">
<ProjectPicker
context={context}
id="WorkplaceChangeNewProject"
value={data.WorkplaceChangeNewProject}
onChange={(name, id) => {
set('WorkplaceChangeNewProject', name);
set('WorkplaceChangeNewProjectId', id);
}}
placeholder={PROJECT_PLACEHOLDER}
/>
</FormField>
<FormField label="Адрес нового места работы" htmlFor="WorkplaceChangeAddress" full>
<TextInput
id="WorkplaceChangeAddress"
value={data.WorkplaceChangeAddress}
onChange={(v) => set('WorkplaceChangeAddress', v)}
/>
</FormField>
<FormField label="Дата изменения" htmlFor="WorkplaceChangeDate">
<TextInput
id="WorkplaceChangeDate"
type="date"
value={data.WorkplaceChangeDate}
onChange={(v) => set('WorkplaceChangeDate', v)}
/>
</FormField>
<FormField label="Условия переезда и компенсации" htmlFor="WorkplaceChangeRelocation" full>
<TextArea
id="WorkplaceChangeRelocation"
value={data.WorkplaceChangeRelocation}
onChange={(v) => set('WorkplaceChangeRelocation', v)}
/>
</FormField>
<FormField label="Вахта" htmlFor="WorkplaceChangeRotation" full>
<Toggle
id="WorkplaceChangeRotation"
checked={data.WorkplaceChangeRotation}
onChange={(checked) => {
set('WorkplaceChangeRotation', checked);
// Без вахты график не нужен — очищаем, чтобы не сохранить скрытое значение.
if (!checked) {
set('WorkplaceChangeSchedule', '');
set('WorkplaceChangeScheduleOther', '');
}
}}
onLabel="Да"
/>
</FormField>
{data.WorkplaceChangeRotation && (
<OptionWithOtherField
label="График работы"
id="WorkplaceChangeSchedule"
value={data.WorkplaceChangeSchedule}
otherValue={data.WorkplaceChangeScheduleOther}
options={WORK_SCHEDULE_OPTIONS}
onChange={(v) => set('WorkplaceChangeSchedule', v)}
onOtherChange={(v) => set('WorkplaceChangeScheduleOther', v)}
/>
)}
<InitiatorReasonFields
initiator={data.ChangeInitiator}
reason={{
id: 'WorkplaceChangeReason',
value: data.WorkplaceChangeReason,
options: WORKPLACE_CHANGE_REASONS,
onChange: (v) => set('WorkplaceChangeReason', v)
}}
justification={{
id: 'WorkplaceChangeJustification',
value: data.WorkplaceChangeJustification,
onChange: (v) => set('WorkplaceChangeJustification', v)
}}
/>
</FormGrid>
);
};
@@ -1,12 +0,0 @@
import { ISelectOption } from '../../../../shared/ui';
/**
* Причины изменения места работы — по шаблону текста ТЗ кадров (а–в).
* Работника и работодателя не различаем (как в видах 3–4).
* Значения совпадают с choices колонки WorkplaceChangeReason (provisioning.json).
*/
export const WORKPLACE_CHANGE_REASONS: ISelectOption[] = [
'Открытие нового объекта',
'Переезд подразделения / работодателя в другую местность',
'Иное'
].map((reason) => ({ value: reason, label: reason }));
@@ -1,48 +0,0 @@
import { useEffect, useState } from 'react';
import { WebPartContext } from '@microsoft/sp-webpart-base';
import { ISelectOption } from '../../../../shared/ui';
import { ICompany, getCompanies } from '../../../../shared/dictionary';
export interface ICompanyOptions {
options: ISelectOption[];
/** Компании по Id — чтобы по выбранному значению Select получить название. */
byId: Map<string, ICompany>;
loading: boolean;
error: string;
}
/**
* Справочник компаний (GET /Dictionary/Companies) как варианты Select: value — Id,
* label — название. Список кешируется в самом сервисе (localStorage, 4 часа).
* Не загрузился — ошибка видна под полем, не прячем её за пустым списком.
*/
export function useCompanyOptions(context: WebPartContext): ICompanyOptions {
const [companies, setCompanies] = useState<ICompany[]>([]);
const [loading, setLoading] = useState<boolean>(true);
const [error, setError] = useState<string>('');
useEffect(() => {
let alive = true;
getCompanies(context)
.then((list) => {
if (!alive) return;
setCompanies(list);
setLoading(false);
})
.catch(() => {
if (!alive) return;
setError('Не удалось загрузить список организаций. Обновите страницу.');
setLoading(false);
});
return () => {
alive = false;
};
}, [context]);
return {
options: companies.map((c) => ({ value: c.Id, label: c.Name })),
byId: new Map(companies.map((c) => [c.Id, c])),
loading,
error
};
}
@@ -1,64 +0,0 @@
import { PrepareFiles, IAttachmentEditor } from '../../../shared/attachments/useAttachmentEditor';
import { attachmentsOfCategory, prefixFiles } from '../../../shared/attachments/attachmentCategories';
import { IFormData } from '../model';
import { ATTESTATION_ATTACHMENT, requiresAttestation } from './Allowance/options';
import { JOB_DESCRIPTION_ATTACHMENT } from './PositionTransfer/options';
import { NEW_SCHEDULE_ATTACHMENT } from './ScheduleChange/options';
import { NEW_JOB_DESCRIPTION_ATTACHMENT } from './FunctionChange/options';
import { EMPLOYER_JUSTIFICATION_ATTACHMENT } from './EmployerInitiative/options';
/**
* Подписанный слот вложений по колонке ТЗ «Что приложить». Подпись (category)
* одновременно и префикс в имени файла, и ключ группы в editor.pending.
*/
export interface IAttachmentSlot {
category: string;
/** Обязателен там, где ТЗ прямо требует документ. */
required: boolean;
}
/** Слоты, видимые при текущих данных формы. Новый слот вида = строка здесь. */
export function activeAttachmentSlots(data: IFormData): IAttachmentSlot[] {
const slots: IAttachmentSlot[] = [];
if (data.ChangeTypes.includes('allowance') && requiresAttestation(data.AllowanceReason)) {
slots.push({ category: ATTESTATION_ATTACHMENT, required: true });
}
if (data.ChangeTypes.includes('position-transfer')) {
slots.push({ category: JOB_DESCRIPTION_ATTACHMENT, required: true });
}
if (data.ChangeTypes.includes('function-change')) {
slots.push({ category: NEW_JOB_DESCRIPTION_ATTACHMENT, required: true });
}
if (data.ChangeTypes.includes('employer-initiative')) {
// «Текст ИЛИ документ» — сам слот необязателен, правило «одно из двух» — в submitChecks.
slots.push({ category: EMPLOYER_JUSTIFICATION_ATTACHMENT, required: false });
}
if (data.ChangeTypes.includes('schedule-change')) {
// «Можно приложить документ» — необязательно.
slots.push({ category: NEW_SCHEDULE_ATTACHMENT, required: false });
}
return slots;
}
/**
* Подготовка выбранных файлов к загрузке: префикс-подпись в имени. Файлы слота,
* который сейчас скрыт (сменили вид или основание), не загружаем — их не видно.
*/
export function prepareFilesFor(data: IFormData): PrepareFiles {
const visible = activeAttachmentSlots(data).map((slot) => slot.category);
return (groupKey, files) => (visible.indexOf(groupKey) >= 0 ? prefixFiles(files, groupKey) : []);
}
/** Есть ли в слоте файл — уже прикреплённый или выбранный к загрузке. */
export function hasAttachment(editor: IAttachmentEditor, category: string): boolean {
const uploaded = attachmentsOfCategory(editor.items, category).length;
const selected = (editor.pending[category] || []).length;
return uploaded + selected > 0;
}
/** Подписи обязательных слотов, где нет ни прикреплённого, ни выбранного файла. */
export function missingRequiredAttachments(data: IFormData, editor: IAttachmentEditor): string[] {
return activeAttachmentSlots(data)
.filter((slot) => slot.required && !hasAttachment(editor, slot.category))
.map((slot) => slot.category);
}
@@ -1,83 +0,0 @@
import { IAttachmentEditor } from '../../../shared/attachments/useAttachmentEditor';
import { formatIsoDate } from '../../../shared/dateUtils';
import {
IFormData,
INITIATOR_REQUIRED_MESSAGE,
NEW_COMPANY_REQUIRED_MESSAGE,
RECEIVING_HEAD_REQUIRED_MESSAGE,
EMPLOYER_CHANGE_NOTHING_SELECTED_MESSAGE,
EMPLOYER_JUSTIFICATION_REQUIRED_MESSAGE
} from '../model';
import { hasInitiatorChoice } from '../changeTypes';
import { hasAttachment, missingRequiredAttachments } from './attachmentSlots';
import {
EMPLOYER_CHANGE_NOTICE_DAYS,
EMPLOYER_JUSTIFICATION_ATTACHMENT,
minEmployerChangeDate
} from './EmployerInitiative/options';
import { TEMPORARY_TRANSFER_PERIOD_ERROR } from './TemporaryTransfer/options';
import { maxTransferEndDate } from './TemporaryTransfer/period';
/**
* Что обязательно по выбранному виду изменения — проверяется только при ОТПРАВКЕ:
* черновик сохраняется и без этого. Первая найденная проблема — текстом; ничего — undefined.
* Новое обязательное поле вида = строка здесь.
*/
export function changeTypeSubmitError(data: IFormData, attachments: IAttachmentEditor): string | undefined {
if (hasInitiatorChoice(data.ChangeTypes) && !data.ChangeInitiator) return INITIATOR_REQUIRED_MESSAGE;
const missingFiles = missingRequiredAttachments(data, attachments);
if (missingFiles.length > 0) return `Приложите обязательные документы: ${missingFiles.join(', ')}.`;
if (data.ChangeTypes.includes('department-transfer') && !data.DepartmentTransferReceivingHead) {
return RECEIVING_HEAD_REQUIRED_MESSAGE;
}
if (data.ChangeTypes.includes('workplace-change') && !data.WorkplaceChangeNewCompanyId) {
return NEW_COMPANY_REQUIRED_MESSAGE;
}
if (data.ChangeTypes.includes('employer-initiative')) {
return employerInitiativeError(data, attachments);
}
if (data.ChangeTypes.includes('temporary-transfer')) {
return temporaryTransferError(data);
}
return undefined;
}
/**
* Временный перевод: если обе даты заданы — окончание не раньше начала и не дольше
* 3 месяцев. Календарь это уже ограничивает; здесь — на случай, когда дату начала
* сдвинули после выбора окончания.
*/
function temporaryTransferError(data: IFormData): string | undefined {
const start = data.TemporaryTransferStartDate;
const end = data.TemporaryTransferEndDate;
if (!start || !end) return undefined;
const maxEnd = maxTransferEndDate(start);
if (end < start || (maxEnd && end > maxEnd)) return TEMPORARY_TRANSFER_PERIOD_ERROR;
return undefined;
}
/**
* Инициатива работодателя: отмечено, что меняется; обоснование текстом ИЛИ
* документом (ТЗ: «ТЕКСТ ИЛИ ПРИЛОЖИТЬ ДОКУМЕНТ»); даты — не раньше срока
* уведомления. Даты проверяем и здесь, а не только min в календаре: черновик мог
* пролежать, и прежняя дата стала слишком близкой.
*/
function employerInitiativeError(data: IFormData, attachments: IAttachmentEditor): string | undefined {
if (!data.EmployerChangeSchedule && !data.EmployerChangeSalary) return EMPLOYER_CHANGE_NOTHING_SELECTED_MESSAGE;
const hasJustification =
!!data.EmployerChangeJustification.trim() || hasAttachment(attachments, EMPLOYER_JUSTIFICATION_ATTACHMENT);
if (!hasJustification) return EMPLOYER_JUSTIFICATION_REQUIRED_MESSAGE;
const minDate = minEmployerChangeDate();
const dates = [
data.EmployerChangeSchedule ? data.EmployerChangeScheduleDate : '',
data.EmployerChangeSalary ? data.EmployerChangeSalaryDate : ''
];
if (dates.some((date) => date && date < minDate)) {
return `Дата изменений — не раньше ${formatIsoDate(minDate)}: работника уведомляют за ${EMPLOYER_CHANGE_NOTICE_DAYS} календарных дней.`;
}
return undefined;
}
@@ -1,38 +0,0 @@
import { ISelectOption } from '../../../shared/ui';
/**
* Режим работы: «График работы» и «Время работы» — те же наборы, что в «Заявке
* на подбор» и «Заявке на приём» (WORK_SCHEDULE_OPTIONS / WORK_HOURS_OPTIONS там):
* формы независимы, значения продублированы намеренно, как и между ними.
* Общие для видов этой формы (место работы — вахта, режим/график работы).
*/
/** «Другое» в списке — открывает ручной ввод (см. OptionWithOtherField). */
export const OPTION_OTHER = 'Другое';
function toOptions(values: string[]): ISelectOption[] {
return values.map((value) => ({ value, label: value }));
}
export const WORK_SCHEDULE_OPTIONS: ISelectOption[] = toOptions([
'5/2',
'Вахтовый 30/30',
'Вахтовый 20/10',
'Вахтовый 30/15',
'Вахтовый 22/8',
'Вахтовый 15/15',
'6/1',
'1/2',
'2/2',
OPTION_OTHER
]);
/** 24-часовой формат, как в подборе и приёме. */
export const WORK_HOURS_OPTIONS: ISelectOption[] = toOptions([
'08:00-17:00',
'09:00-18:00',
'07:00-19:00',
'08:00-20:00',
'09:00-21:00',
OPTION_OTHER
]);
@@ -1,90 +0,0 @@
import { ISelectOption } from '../../shared/ui';
/**
* Виды изменения условий трудового договора (ст. 33 ТК РК) — по ТЗ кадров.
*
* В коде вид — стабильный ключ (union ниже), в SharePoint — его подпись: колонка
* ChangeTypes (MultiChoice) хранит текст, чтобы кадры видели в списке и отчётах
* понятные значения. Подпись = choice колонки, поэтому менять её можно только
* вместе с choices в provisioning.json (иначе старые заявки перестанут узнаваться).
*/
export type ChangeType =
| 'salary-increase'
| 'allowance'
| 'position-transfer'
| 'department-transfer'
| 'workplace-change'
| 'contract-extension'
| 'schedule-change'
| 'function-change'
| 'employer-initiative'
| 'temporary-transfer';
/** Порядок — как в ТЗ (в нём же показываются в выпадающем списке). */
export const CHANGE_TYPE_LABELS: Record<ChangeType, string> = {
'salary-increase': 'Повышение должностного оклада',
allowance: 'Установление надбавки / доплаты',
'position-transfer': 'Перевод на другую должность (постоянный)',
'department-transfer': 'Перевод в другое подразделение',
'workplace-change': 'Изменение места работы (другая местность)',
'contract-extension': 'Продление срока трудового договора',
// В ТЗ ещё «; неполное рабочее время по просьбе работника» — сокращено по просьбе Тимура
// (неполное время — поля работника внутри вида).
'schedule-change': 'Изменение режима / графика работы по соглашению сторон',
'function-change': 'Изменение трудовой функции (без смены должности)',
// В ТЗ — длинная формулировка с перечнем причин; сокращено по просьбе Тимура (причины — в поле «Причина» вида).
'employer-initiative': 'Изменение условий труда по инициативе работодателя',
'temporary-transfer': 'Временный перевод при производственной необходимости / простое'
};
/**
* Сколько видов можно выбрать в одной заявке. По ТЗ — один; данные (массив
* ChangeTypes + MultiChoice-колонка) уже рассчитаны на несколько, чтобы снять
* ограничение правкой UI, а не миграцией.
*/
export const MAX_CHANGE_TYPES = 1;
export const CHANGE_TYPE_OPTIONS: ISelectOption[] = (Object.keys(CHANGE_TYPE_LABELS) as ChangeType[]).map(
(type) => ({ value: type, label: CHANGE_TYPE_LABELS[type] })
);
/**
* Кто инициирует изменение. Значения = choices колонки ChangeInitiator. По ТЗ у
* части видов шаблон разный: «От работника: заявление (текст). От работодателя:
* прошу… в связи с: а) б) в)» — форма показывает поля той роли, что выбрана.
*/
export type InitiatorRole = 'Работник' | 'Работодатель';
export const INITIATOR_EMPLOYEE: InitiatorRole = 'Работник';
export const INITIATOR_EMPLOYER: InitiatorRole = 'Работодатель';
export const INITIATOR_OPTIONS: ISelectOption[] = [INITIATOR_EMPLOYEE, INITIATOR_EMPLOYER].map((role) => ({
value: role,
label: role
}));
/**
* Виды, которые по ТЗ («Кто инициирует») может начать и руководитель, и сам
* работник. У остальных инициатор — только руководитель, выбора нет.
*/
const TYPES_WITH_INITIATOR_CHOICE: ChangeType[] = [
'position-transfer',
'department-transfer',
'workplace-change',
'schedule-change'
];
export function hasInitiatorChoice(types: ChangeType[]): boolean {
return types.some((type) => TYPES_WITH_INITIATOR_CHOICE.indexOf(type) >= 0);
}
/** Строка из SP → роль; пусто/неизвестное — '' (не выбрана). */
export function initiatorRoleFromText(text: string): InitiatorRole | '' {
return text === INITIATOR_EMPLOYEE || text === INITIATOR_EMPLOYER ? text : '';
}
/** Подпись из SP → ключ вида. Неизвестная подпись (переименовали choice) — undefined. */
export function changeTypeFromLabel(label: string): ChangeType | undefined {
const normalized = label.trim();
return (Object.keys(CHANGE_TYPE_LABELS) as ChangeType[]).find(
(type) => CHANGE_TYPE_LABELS[type] === normalized
);
}
@@ -1,264 +0,0 @@
import { getSP } from '../../shared/pnp/pnpjs';
import { dataListTitle } from '../../shared/listTitles';
import { spDateOnlyToIso } from '../../shared/dateUtils';
import { IEmployeeFullBaseRecord } from '../../shared/dictionary';
import { ChangeType, changeTypeFromLabel, initiatorRoleFromText } from './changeTypes';
import { allowanceUnitFromText } from './byType/Allowance/options';
import { DEFAULT_FIXED_PERCENT } from './byType/EmployerInitiative/salaryParts';
import { FORM_ID, IFormData, EMPTY_DATA } from './model';
export interface ILoadedRequest {
data: IFormData;
status: string;
/** Уникальный код заявки; '' — если запись создана до появления поля. */
code: string;
}
function text(raw: unknown): string {
return typeof raw === 'string' ? raw : '';
}
/** Number-колонка → «сырое» число строкой (для MoneyInput / ввода процента); пусто → ''. */
function numberText(raw: unknown): string {
return typeof raw === 'number' && Number.isFinite(raw) ? String(raw) : '';
}
/**
* Колонки Employee* → запись сотрудника (см. employeeColumns в submit.ts).
* Нет ни id, ни Ф.И.О. — сотрудник не был выбран (черновик) → undefined.
* Даты приёма/увольнения не хранятся — ''; e-mail пустой — у сотрудника нет учётки.
*/
function employeeFromItem(item: Record<string, unknown>): IEmployeeFullBaseRecord | undefined {
const id = text(item.EmployeeRecordId);
const fio = text(item.EmployeeFio);
if (!id && !fio) return undefined;
return {
id,
fio,
iin: text(item.EmployeeIin),
code: text(item.EmployeeCode),
company: text(item.EmployeeCompany),
position: text(item.EmployeePosition),
department: text(item.EmployeeDepartment),
admissionDate: '',
dismissalDate: '',
email: text(item.EmployeeEmail)
};
}
/**
* MultiChoice → ключи видов. Подпись, которой нет в CHANGE_TYPE_LABELS (choice
* переименовали в SP, а код — нет), пропускаем с предупреждением в консоли:
* форма покажет «вид не выбран», и при отправке валидация попросит выбрать заново.
*/
function changeTypesFromItem(raw: unknown): ChangeType[] {
const labels = Array.isArray(raw) ? raw.filter((v): v is string => typeof v === 'string') : [];
const types: ChangeType[] = [];
labels.forEach((label) => {
const type = changeTypeFromLabel(label);
if (type) {
types.push(type);
} else {
console.warn(`[ContractChange] Неизвестный вид изменения «${label}» — нет в CHANGE_TYPE_LABELS`);
}
});
return types;
}
/**
* Прочитать заявку по id: модель формы + статус (правка / просмотр).
*
* listId — партиция, где лежит ИМЕННО эта заявка (см. shared/approval/
* listPartitions.ts). Не задан — читаем из ТЕКУЩЕЙ партиции; задан — идём напрямую
* по url списка.
*/
export async function loadContractChangeRequest(itemId: number, listId?: string): Promise<ILoadedRequest> {
const list = listId ? getSP().web.getList(listId) : getSP().web.lists.getByTitle(dataListTitle(FORM_ID));
const item = (await list.items
.getById(itemId)
.select(
'Id',
'RequestStatus',
'RequestUniqueCode',
'EmployeeRecordId',
'EmployeeFio',
'EmployeeIin',
'EmployeeCode',
'EmployeeEmail',
'EmployeeCompany',
'EmployeePosition',
'EmployeeDepartment',
'ChangeTypes',
'ChangeInitiator',
'SalaryIncreaseCurrent',
'SalaryIncreaseNew',
'SalaryIncreaseDate',
'SalaryIncreaseReason',
'SalaryIncreaseJustification',
'AllowanceReason',
'AllowanceStartDate',
'AllowanceEndDate',
'AllowanceIndefinite',
'AllowanceAmount',
'AllowanceUnit',
'AllowanceJustification',
'PositionTransferNewPosition',
'PositionTransferDate',
'PositionTransferReason',
'PositionTransferJustification',
'DepartmentTransferNewDepartment',
'DepartmentTransferNewDepartmentId',
'DepartmentTransferDate',
'DepartmentTransferReason',
'DepartmentTransferJustification',
'DepartmentTransferReceivingHead/EMail',
'WorkplaceChangeCurrentProject',
'WorkplaceChangeCurrentProjectId',
'WorkplaceChangeNewCompany',
'WorkplaceChangeNewCompanyId',
'WorkplaceChangeNewProject',
'WorkplaceChangeNewProjectId',
'WorkplaceChangeAddress',
'WorkplaceChangeDate',
'WorkplaceChangeReason',
'WorkplaceChangeRelocation',
'WorkplaceChangeRotation',
'WorkplaceChangeSchedule',
'WorkplaceChangeScheduleOther',
'WorkplaceChangeJustification',
'ScheduleChangeCurrentSchedule',
'ScheduleChangeCurrentScheduleOther',
'ScheduleChangeCurrentHours',
'ScheduleChangeCurrentHoursOther',
'ScheduleChangeDate',
'ScheduleChangeHoursPerDay',
'ScheduleChangeDaysPerWeek',
'ScheduleChangeNewMode',
'ScheduleChangeNewModeOther',
'ScheduleChangeNewSchedule',
'ScheduleChangeNewScheduleOther',
'ScheduleChangeNewHours',
'ScheduleChangeNewHoursOther',
'ScheduleChangeReason',
'ScheduleChangeJustification',
'FunctionChangeDate',
'FunctionChangeReason',
'EmployerChangeReason',
'EmployerChangeReasonOther',
'EmployerChangeSchedule',
'EmployerChangeCurrentSchedule',
'EmployerChangeCurrentScheduleOther',
'EmployerChangeNewSchedule',
'EmployerChangeNewScheduleOther',
'EmployerChangeScheduleDate',
'EmployerChangeSalary',
'EmployerChangeNewSalary',
'EmployerChangeFixedPercent',
'EmployerChangeSalaryDate',
'EmployerChangeJustification',
'TemporaryTransferFromProject',
'TemporaryTransferFromProjectId',
'TemporaryTransferFromWork',
'TemporaryTransferToProject',
'TemporaryTransferToProjectId',
'TemporaryTransferToWork',
'TemporaryTransferStartDate',
'TemporaryTransferEndDate',
'TemporaryTransferReason',
'TemporaryTransferJustification'
)
.expand('DepartmentTransferReceivingHead')()) as Record<string, unknown>;
const receivingHead = item.DepartmentTransferReceivingHead as { EMail?: string } | undefined;
const data: IFormData = {
...EMPTY_DATA,
Employee: employeeFromItem(item),
ChangeTypes: changeTypesFromItem(item.ChangeTypes),
ChangeInitiator: initiatorRoleFromText(text(item.ChangeInitiator)),
SalaryIncreaseCurrent: numberText(item.SalaryIncreaseCurrent),
SalaryIncreaseNew: numberText(item.SalaryIncreaseNew),
// Дату только через spDateOnlyToIso — иначе из-за часового пояса уезжает на день назад.
SalaryIncreaseDate: spDateOnlyToIso(text(item.SalaryIncreaseDate)),
SalaryIncreaseReason: text(item.SalaryIncreaseReason),
SalaryIncreaseJustification: text(item.SalaryIncreaseJustification),
AllowanceReason: text(item.AllowanceReason),
AllowanceStartDate: spDateOnlyToIso(text(item.AllowanceStartDate)),
AllowanceEndDate: spDateOnlyToIso(text(item.AllowanceEndDate)),
AllowanceIndefinite: item.AllowanceIndefinite === true,
AllowanceAmount: numberText(item.AllowanceAmount),
AllowanceUnit: allowanceUnitFromText(text(item.AllowanceUnit)),
AllowanceJustification: text(item.AllowanceJustification),
PositionTransferNewPosition: text(item.PositionTransferNewPosition),
PositionTransferDate: spDateOnlyToIso(text(item.PositionTransferDate)),
PositionTransferReason: text(item.PositionTransferReason),
PositionTransferJustification: text(item.PositionTransferJustification),
DepartmentTransferNewDepartment: text(item.DepartmentTransferNewDepartment),
DepartmentTransferNewDepartmentId: text(item.DepartmentTransferNewDepartmentId),
DepartmentTransferDate: spDateOnlyToIso(text(item.DepartmentTransferDate)),
DepartmentTransferReason: text(item.DepartmentTransferReason),
DepartmentTransferJustification: text(item.DepartmentTransferJustification),
DepartmentTransferReceivingHead: receivingHead?.EMail || '',
WorkplaceChangeCurrentProject: text(item.WorkplaceChangeCurrentProject),
WorkplaceChangeCurrentProjectId: text(item.WorkplaceChangeCurrentProjectId),
WorkplaceChangeNewCompany: text(item.WorkplaceChangeNewCompany),
WorkplaceChangeNewCompanyId: text(item.WorkplaceChangeNewCompanyId),
WorkplaceChangeNewProject: text(item.WorkplaceChangeNewProject),
WorkplaceChangeNewProjectId: text(item.WorkplaceChangeNewProjectId),
WorkplaceChangeAddress: text(item.WorkplaceChangeAddress),
WorkplaceChangeDate: spDateOnlyToIso(text(item.WorkplaceChangeDate)),
WorkplaceChangeReason: text(item.WorkplaceChangeReason),
WorkplaceChangeRelocation: text(item.WorkplaceChangeRelocation),
WorkplaceChangeRotation: item.WorkplaceChangeRotation === true,
WorkplaceChangeSchedule: text(item.WorkplaceChangeSchedule),
WorkplaceChangeScheduleOther: text(item.WorkplaceChangeScheduleOther),
WorkplaceChangeJustification: text(item.WorkplaceChangeJustification),
ScheduleChangeCurrentSchedule: text(item.ScheduleChangeCurrentSchedule),
ScheduleChangeCurrentScheduleOther: text(item.ScheduleChangeCurrentScheduleOther),
ScheduleChangeCurrentHours: text(item.ScheduleChangeCurrentHours),
ScheduleChangeCurrentHoursOther: text(item.ScheduleChangeCurrentHoursOther),
ScheduleChangeDate: spDateOnlyToIso(text(item.ScheduleChangeDate)),
ScheduleChangeHoursPerDay: numberText(item.ScheduleChangeHoursPerDay),
ScheduleChangeDaysPerWeek: numberText(item.ScheduleChangeDaysPerWeek),
ScheduleChangeNewMode: text(item.ScheduleChangeNewMode),
ScheduleChangeNewModeOther: text(item.ScheduleChangeNewModeOther),
ScheduleChangeNewSchedule: text(item.ScheduleChangeNewSchedule),
ScheduleChangeNewScheduleOther: text(item.ScheduleChangeNewScheduleOther),
ScheduleChangeNewHours: text(item.ScheduleChangeNewHours),
ScheduleChangeNewHoursOther: text(item.ScheduleChangeNewHoursOther),
ScheduleChangeReason: text(item.ScheduleChangeReason),
ScheduleChangeJustification: text(item.ScheduleChangeJustification),
FunctionChangeDate: spDateOnlyToIso(text(item.FunctionChangeDate)),
FunctionChangeReason: text(item.FunctionChangeReason),
EmployerChangeReason: text(item.EmployerChangeReason),
EmployerChangeReasonOther: text(item.EmployerChangeReasonOther),
EmployerChangeSchedule: item.EmployerChangeSchedule === true,
EmployerChangeCurrentSchedule: text(item.EmployerChangeCurrentSchedule),
EmployerChangeCurrentScheduleOther: text(item.EmployerChangeCurrentScheduleOther),
EmployerChangeNewSchedule: text(item.EmployerChangeNewSchedule),
EmployerChangeNewScheduleOther: text(item.EmployerChangeNewScheduleOther),
EmployerChangeScheduleDate: spDateOnlyToIso(text(item.EmployerChangeScheduleDate)),
EmployerChangeSalary: item.EmployerChangeSalary === true,
// Суммы частей и переменную долю не читаем — они считаются (splitSalary).
EmployerChangeNewSalary: numberText(item.EmployerChangeNewSalary),
// Оклад не меняли (доли не сохранялись) — доля по умолчанию из ТЗ, 75 %.
EmployerChangeFixedPercent: numberText(item.EmployerChangeFixedPercent) || DEFAULT_FIXED_PERCENT,
EmployerChangeSalaryDate: spDateOnlyToIso(text(item.EmployerChangeSalaryDate)),
EmployerChangeJustification: text(item.EmployerChangeJustification),
TemporaryTransferFromProject: text(item.TemporaryTransferFromProject),
TemporaryTransferFromProjectId: text(item.TemporaryTransferFromProjectId),
TemporaryTransferFromWork: text(item.TemporaryTransferFromWork),
TemporaryTransferToProject: text(item.TemporaryTransferToProject),
TemporaryTransferToProjectId: text(item.TemporaryTransferToProjectId),
TemporaryTransferToWork: text(item.TemporaryTransferToWork),
TemporaryTransferStartDate: spDateOnlyToIso(text(item.TemporaryTransferStartDate)),
TemporaryTransferEndDate: spDateOnlyToIso(text(item.TemporaryTransferEndDate)),
TemporaryTransferReason: text(item.TemporaryTransferReason),
TemporaryTransferJustification: text(item.TemporaryTransferJustification)
};
return {
data,
status: text(item.RequestStatus),
code: text(item.RequestUniqueCode)
};
}

Some files were not shown because too many files have changed in this diff Show More