Тимур Городецкий
8eb5b13985
Цифровая версия бумажной заявки на командировку (отдел кадров). Можно подать за другого сотрудника; маршрут — лентой точек (город + объект из справочника проектов + даты) с видом транспорта на каждом участке и вторым видом «Схема» (SVG, как схема метро). Задание — список задач. Смета — карточками статей (суточные, проезд, проживание, страховка, виза, другие расходы) с позициями, привязанными к точкам и участкам маршрута; суммы только вручную, итог с долями и разбивкой по объектам. Печать — без шапки с адресатом. Плитка пока только для тестировщиков (comingSoon): списки SharePoint не провизионированы, тип заявки и маршрут в админке не заведены. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
58 lines
9.3 KiB
Markdown
58 lines
9.3 KiB
Markdown
# Формы портала заявок — индекс
|
||
|
||
Каждая форма живёт в своей папке `src/webparts/requestPortal/forms/<Форма>/` и имеет
|
||
рядом **`README.md`** — карточку с её **бизнес-поведением** (то, что не видно из кода
|
||
с первого взгляда). Здесь — общий индекс.
|
||
|
||
## Правило (при добавлении формы)
|
||
1. Папка `forms/<Форма>/` + `README.md` по [шаблону](./form-readme-template.md).
|
||
2. Строка в индексе ниже.
|
||
3. Строка в `forms/registry.ts` (ленивая форма) и, если есть режим согласующего,
|
||
в `forms/viewRegistry.ts`.
|
||
4. Плитка в `data/requests.ts`.
|
||
|
||
## Формы больше не хардкодят RequestTypeId
|
||
Числовой id типа заявки во внешнем approval-route API (`GET /api/request-types`)
|
||
выдаётся сервером при регистрации типа в админке и непредсказуем заранее (в
|
||
старой pto-tracker у «отпуска» было 1, при заведении типа в новой админке он
|
||
получил id 11). Раньше каждая форма хардкодила это число константой вида
|
||
`VACATION_REQUEST_TYPE_ID = 11`; теперь — резолвит его в рантайме по своему
|
||
`pageUrl` (тот же rptype, что и `id` в `data/requests.ts`) через
|
||
`useRequestTypeId(context, pageUrl)` (`shared/approval`). Результат кешируется
|
||
на уровне модуля на время сессии (см. `getRequestTypeIdByPageUrl` в
|
||
`approvalRoute.service.ts`) — повторный вызов из другой формы не бьёт по сети заново.
|
||
- Форма подачи знает свой `pageUrl` из пропа `requestType.id`.
|
||
- Режим согласующего (`<Форма>View`) получает его пропом `formKey` (см.
|
||
`IApprovalViewProps` в `forms/viewRegistry.ts` и `ApproveFeature.tsx`).
|
||
|
||
## Что НЕ дублируем в карточке (лежит в других местах)
|
||
- Колонки списков → `forms/<Форма>/provisioning.json`.
|
||
- Параметры ссылок (rptype/rpmode/rpid/rpsource) → [`routing.md`](./routing.md).
|
||
- Особые права (кто что может сверх обычного, по email/должности/группе) → [`permissions.md`](./permissions.md).
|
||
- Как обращаться к спискам SP из кода → [`sp-lists-frontend.md`](./sp-lists-frontend.md).
|
||
- Общий жизненный цикл (черновик/upsert/блокировка/статусы), согласование, исполнение,
|
||
печать — **одинаковы для всех форм** (общие примитивы `shared/ui` и `shared/approval`).
|
||
|
||
Карточка — только про то, чем **эта** форма отличается.
|
||
|
||
---
|
||
|
||
## Индекс форм
|
||
|
||
| Ключ (rptype) | Форма | Категория | Согл. | Исп. | Просмотр | Фишки | Готово |
|
||
| --- | --- | --- | :---: | :---: | :---: | --- | :---: |
|
||
| [`recruiting-selection`](../src/webparts/requestPortal/forms/RecruitingSelection/README.md) | Заявка на подбор | Рекрутинг | нет | нет | нет | много полей (~42), поля-люди (в т.ч. мульти) | ✅ |
|
||
| [`recruiting-hire`](../src/webparts/requestPortal/forms/RecruitingHire/README.md) | Заявка на прием | Рекрутинг | да | да | да | маска телефона, деньги, условное «взамен кого», источник для орг. места | ✅ |
|
||
| [`recruiting-referral`](../src/webparts/requestPortal/forms/Referral/README.md) | Реферальная рекомендация | Рекрутинг | да | да | да | кандидат — внешний (текстовые поля, не People); маршрут по рекомендателю; исполнитель переназначает на реального; условное уточнение «откуда знаете» | ✅ |
|
||
| [`it-workplace-setup`](../src/webparts/requestPortal/forms/WorkplaceSetup/README.md) | Организация рабочего места | IT | да | да | да | префилл из «прием», поля ПО/доступы правит руководитель | ✅ |
|
||
| [`it-1c-ticket`](../src/webparts/requestPortal/forms/Ticket1C/README.md) | Заявка в отдел 1С | IT | да | нет | да | контакты предзаполняются из Graph (/me); вместо фазы исполнения — карточка в Microsoft Planner (согласовано/сразу без согласования — рабочий бакет, отклонено — отдельный бакет) | ✅ |
|
||
| [`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) | Заявка на командировку | Отдел кадров | да | да | да | можно за другого сотрудника; маршрут лентой (точки = город + объект из справочника + даты, участки с видом транспорта); задание — список задач; смета: статьи с позициями, привязанными к точкам/участкам (суммой или кол-во × цена — всё вручную), итог с долями и по объектам; обязательство по авансовому отчёту — флажок; печать без шапки адресата | ⏳ код готов, списки/тип/маршрут не заведены |
|
||
| `hr-transfer` | Перемещение сотрудников | Отдел кадров | — | — | — | — | ⏳ заглушка (плитка есть, форма не сделана) |
|
||
| [`wh-service-request`](../src/webparts/requestPortal/forms/ServiceRequest/README.md) | Заявка на услуги | Склад / Снабжение | да | нет | да | маршрут по проекту (руководитель проекта/ПТО); табличные части «Приложения» и «Смета» (JSON-колонки); сумма по смете считается на лету (qty × цена), итог дублируется числовой колонкой для отчётов | ✅ |
|
||
|
||
Легенда: **Согл.** — есть фаза согласования; **Исп.** — есть фаза исполнения;
|
||
**Просмотр** — есть режим согласующего (`<Форма>View`).
|