iistwin/FIELD_TYPES.md

Реестр типов полей iistwin

Единый источник правды: shared/field-types.ts
Дата актуализации: 2026-05-18

---

Сводная таблица всех типов

#	ID	Название	Иконка (Lucide)	Опции	Формы	Глобальные	Таблицы
1	text	Текстовое поле	Type	❌	✅	✅	✅
2	number	Числовое поле	Hash	❌	✅	✅	✅
3	date	Дата	Calendar	❌	✅	✅	✅
4	datetime	Дата и время	Clock	❌	✅	✅	✅
5	select	Выпадающий список	ChevronDown	✅	✅	✅	✅
6	checkbox	Чекбокс	CheckSquare	❌	✅	✅	✅
7	toggle	Переключатель	ToggleLeft	❌	✅	✅	✅
8	button	Кнопка	MousePointer	❌	✅	❌	❌
9	user	Выбор пользователя	Users	❌	✅	✅	✅
10	file	Загрузка файлов	Paperclip	❌	✅	✅	✅
11	textarea	Многострочный текст	AlignLeft	❌	✅	✅	✅
12	rich-text	Богатый текстовый редактор	FileText	❌	✅	✅	✅
13	history-number	Числовое поле с историей	History	❌	❌	❌	✅
14	table	Выбор из таблицы	Table	❌	❌	❌	✅
15	task	Связь с задачей	Link2	❌	✅	❌	✅
16	company	Организация (DaData)	Building2	❌	✅	✅	✅
17	geo	Адрес с координатами	MapPin	❌	✅	✅	✅
18	formula	Формула	Calculator	❌	❌	❌	✅

Легенда:

• Опции — поддерживает ли тип предустановленный список значений (только select)
• Формы — можно создать поле этого типа в редакторе форм
• Глобальные — можно создать reusable шаблон глобального поля
• Таблицы — можно использовать как тип колонки в справочнике/таблице

---

Использование по контекстам

1. Формы (FORM_FIELD_TYPES) — 17 типов

Файлы:

• client/src/pages/FormEditor.tsx — редактор форм
• client/src/pages/TaskDetail.tsx — карточка задачи
• server/mcp.ts → tool add_form_field

Тип	Особенности
button	Только в формах. Действия: open_url, create_task
task	Связь задача→задача (parent/child). taskRelationType
company	Интеграция DaData (автозаполнение ИНН, названия)
geo	Адрес с координатами, интеграция карт
file	Загрузка в MinIO S3. maxFileCount, maxFileSizeMB
select	Единственный тип с supportsOptions: true

---

2. Глобальные поля (GLOBAL_FIELD_TYPES) — 16 типов

Файлы:

• client/src/pages/GlobalFields.tsx — UI управления
• server/mcp.ts → tool create_global_field

Исключены: button, history-number, formula

Глобальные поля — это reusable шаблоны. Создаются один раз, затем вставляются в любую форму через add_global_field_to_form или add_globals_to_table_tab.

---

3. Таблицы / Справочники (TABLE_FIELD_TYPES) — 16 типов

Файлы:

• client/src/pages/Tables.tsx — страница справочников
• client/src/components/tabs/types.ts — типизация колонок
• server/mcp.ts → tool add_globals_to_table_tab

Исключён: button

Тип	Особенности
history-number	Хранит историю изменений значения (audit trail)
formula	Вычисляемое поле. Движок: client/src/lib/formulaEngine.ts
table	Ссылка на другой справочник (foreign key)

---

4. Пользовательские поля (User Custom Fields) — 6 типов ⚠️

Файлы:

• shared/schema.ts:698
• client/src/pages/Users.tsx

z.enum(["text", "number", "date", "select", "user", "checkbox"])

Проблема: не синхронизирован с shared/field-types.ts. Нет: datetime, toggle, file, textarea, rich-text, company, geo.

---

5. API эндпоинт

GET /api/field-types

Возвращает полный реестр с метаданными:

{
  "success": true,
  "fieldTypes": [
    { "id": "text", "label": "Текстовое поле", "iconName": "Type", "supportsOptions": false, "allowedIn": ["form","global","table"] },
    ...
  ]
}

---

6. MCP Tools

Tool	Допустимые типы
add_form_field	FORM_FIELD_TYPES (17 типов)
create_global_field	GLOBAL_FIELD_TYPES (16 типов)
add_globals_to_table_tab	фильтрует по TABLE_FIELD_TYPES

---

Техдолг и планы

Место	Проблема	Приоритет
User Custom Fields	6 hardcoded типов, не использует shared/field-types.ts	🔴 Высокий
client/src/lib/fieldTypes.ts	Дублирует реестр (React-иконки Lucide). Можно сделать динамический импорт	🟡 Средний
shared/schema.ts:1474	Hardcoded union 'text' | 'number' | ...	🟡 Средний

---

Как добавить новый тип поля

Шаг 1. Реестр

Добавить в shared/field-types.ts:

{ id: "rating", label: "Рейтинг", iconName: "Star", supportsOptions: false, allowedIn: ["form", "global", "table"] }

Шаг 2. Иконка (если нужна на фронте)

Добавить в client/src/lib/fieldTypes.ts:

import { Star } from 'lucide-react';
// ...
{ value: 'rating', label: 'Рейтинг', icon: Star },

Шаг 3. Рендерер (если нужна кастомная логика)

• FormEditor.tsx — UI в редакторе форм
• TaskDetail.tsx — отображение в карточке задачи

Шаг 4. Бэкенд (если нужна кастомная валидация)

• server/services/form.service.ts — валидация значений
• server/services/task.service.ts — обработка при создании/обновлении

Всё остальное (MCP, /api/field-types, GlobalFields.tsx, Tables.tsx, Users.tsx) синхронизируется автоматически.