Files
request-portal/docs/forms.md
T
2026-08-06 15:00:06 +05:00

36 lines
3.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Формы портала заявок — индекс
Каждая форма живёт в своей папке `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`.
## Что НЕ дублируем в карточке (лежит в других местах)
- Колонки списков → `forms/<Форма>/provisioning.json`.
- Параметры ссылок (rptype/rpmode/rpid/rpsource) → [`routing.md`](./routing.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) | Заявка на прием | Рекрутинг | да | да | да | маска телефона, деньги, условное «взамен кого», источник для орг. места | ✅ |
| [`it-workplace-setup`](../src/webparts/requestPortal/forms/WorkplaceSetup/README.md) | Организация рабочего места | IT | да | да | да | префилл из «прием», поля ПО/доступы правит руководитель | ✅ |
| `hr-transfer` | Перемещение сотрудников | Отдел кадров | — | — | — | — | ⏳ заглушка (плитка есть, форма не сделана) |
Легенда: **Согл.** — есть фаза согласования; **Исп.** — есть фаза исполнения;
**Просмотр** — есть режим согласующего (`<Форма>View`).