# Каталог типов доработок 1С

> Маппинг: тип доработки → выходной артефакт → трудозатраты → риск обновления.
> Использовать при gap-анализе для оценки каждой нетиповой функции,
> а также при проектировании конкретной доработки.
>
> Источник базовой классификации: 1C AI Development Kit (Arman Kudaibergenov), адаптация.

---

## Приоритет выбора подхода

От безопасного к рискованному. Каждый шаг «глубже» = выше стоимость сопровождения
на весь жизненный цикл системы. Всегда выбирать минимально инвазивный подход.

```
1. Типовая настройка (параметры, справочники, доп. реквизиты через УФ)
   ↓ если невозможно
2. Внешний отчёт (ERF) / внешняя обработка (EPF) по существующим регистрам
   ↓ если невозможно
3. Расширение конфигурации (CFE) — перехват событий, доп. формы, модификация
   ↓ если невозможно
4. Дополнительная обработка через механизмы БСП (подключаемые команды, доп. отчёты)
   ↓ если невозможно
5. Изменение конфигурации (снятие с поддержки) — крайний случай
```

---

## Шкала сложности доработки

| Уровень | Объём | Ориентир трудозатрат | Типичные артефакты |
|---------|-------|---------------------|--------------------|
| **S** | Точечное изменение, 1-2 объекта | 4–16 ч | Внешний отчёт, печатная форма, доп. реквизит |
| **M** | Несколько связанных объектов | 16–80 ч | Расширение CFE, новый документ + формы + права |
| **L** | Новая подсистема или интеграция | 80–240 ч | Комплект: документы + регистры + отчёты + роли + тесты |
| **XL** | Архитектурные изменения ядра | 240+ ч | Изменение типовых регистров, переделка логики проведения |

---

## Типы доработок: детальный каталог

### 1. Внешний отчёт (ERF)

**Артефакт:** файл `.erf` — отчёт на базе СКД или произвольный
**Когда:** нужен отчёт, данные для которого уже есть в регистрах, но типового отчёта нет
**Риск обновления:** нулевой — внешний файл, не затрагивает конфигурацию
**Уровень:** обычно S (8–16 ч)

**Примеры:**
- Aging дебиторской задолженности (по регистру взаиморасчётов)
- EBITDA (по регистру доходов и расходов)
- P&L по проектам с рентабельностью (по НД)
- Сводка план/факт в нетиповом разрезе

**Структура артефакта:**
```
ВнешнийОтчёт
├── Макет СКД (схема компоновки данных)
│   ├── Набор данных — запрос к регистрам
│   ├── Вычисляемые поля
│   ├── Ресурсы (итоги)
│   └── Настройки (группировки, отборы, оформление)
└── Форма отчёта (опционально — для доп. параметров)
```

### 2. Внешняя обработка (EPF)

**Артефакт:** файл `.epf` — обработка для массовых операций, загрузок, сервисных задач
**Когда:** нужна автоматизация рутины, не покрытая типовым функционалом
**Риск обновления:** нулевой (внешний файл)
**Уровень:** S–M (8–40 ч)

**Примеры:**
- Массовое заполнение доп. реквизитов
- Загрузка данных из Excel
- Формирование пакета документов по шаблону
- Сверка данных между базами

### 3. Печатная форма (MXL)

**Артефакт:** макет `.mxl` — табличный документ для печати
**Когда:** нужна нестандартная печатная форма для существующего документа
**Риск обновления:** нулевой при подключении через БСП «Дополнительные печатные формы»
**Уровень:** S (4–12 ч)

**Примеры:**
- Нестандартный формат счёта на оплату
- Внутренний акт с доп. реквизитами
- Этикетка / стикер для складского учёта

### 4. Расширение конфигурации (CFE)

**Артефакт:** файл `.cfe` — расширение, подключаемое без снятия с поддержки
**Когда:** нужно изменить поведение типовых объектов, добавить реквизиты, перехватить события
**Риск обновления:** средний — может «отвалиться» при обновлении, если изменены те же модули
**Уровень:** M–L (20–120 ч)

**Что можно:**
- Добавлять реквизиты к типовым документам/справочникам
- Перехватывать события (&Перед / &После)
- Заимствовать и модифицировать типовые формы
- Добавлять новые объекты (документы, справочники, регистры)
- Добавлять подсистемы и команды

**Ограничения:**
- Нельзя удалять типовые объекты или реквизиты
- Конфликты при обновлении, если фирма «1С» изменила тот же модуль
- Перехватчики добавляют накладные расходы на производительность

**Примеры:**
- Добавление поля «Проект» к документу, где его нет
- Автозаполнение реквизитов по бизнес-правилам
- Доп. проверки при проведении документов

### 5. Доп. обработка через БСП

**Артефакт:** EPF, подключаемая через механизмы Библиотеки стандартных подсистем
**Когда:** нужно интегрировать обработку в интерфейс типовой конфигурации без расширения
**Риск обновления:** низкий — БСП-механизмы стабильны между версиями
**Уровень:** S–M (8–40 ч)

**Механизмы БСП для подключения:**
- Дополнительные отчёты и обработки (регистрация через справочник)
- Подключаемые команды (кнопки на формах типовых документов)
- Дополнительные печатные формы
- Обработки заполнения документов

### 6. Новый объект метаданных (в конфигурации)

**Артефакт:** объекты конфигурации — документы, справочники, регистры, роли
**Когда:** задачу нельзя решить расширением/обработкой
**Риск обновления:** высокий — конфигурация снята с поддержки, обновления через сравнение/объединение
**Уровень:** L–XL (80–300+ ч)

**Типичный комплект для нового бизнес-процесса:**
```
Новая подсистема
├── Справочник(и) — классификаторы
├── Документ(ы) — бизнес-операции
│   ├── Табличные части
│   ├── Формы (документа, списка, выбора)
│   └── Модуль объекта (проведение, проверки)
├── Регистр(ы) накопления / сведений — хранение движений
├── Отчёт(ы) — аналитика по регистрам
├── Роль(и) — разграничение доступа (RLS при необходимости)
└── Подписки на события — интеграция с типовыми объектами
```

**Примеры:**
- Подсистема таймшитов (учёт трудозатрат по проектам)
- Подсистема трансфертного ценообразования между ЦФО
- Нетиповая интеграция с внешней системой

### 7. Изменение типового объекта

**Артефакт:** модификация существующих модулей, форм, макетов типовой конфигурации
**Когда:** задачу нельзя решить **ни одним** из способов выше
**Риск обновления:** критический — каждое обновление = ручное сравнение/объединение
**Уровень:** M–XL

**Правило:** крайний случай. Перед тем как изменять типовой объект, дважды убедиться,
что задачу нельзя решить расширением. Документировать каждое изменение:
что именно изменено, зачем, какой код затронут, кто автор, дата.

---

## Сводная таблица для gap-анализа

| Тип | Артефакт | Риск обновления | Обычный уровень | Стоимость сопровождения |
|-----|----------|-----------------|-----------------|-------------------------|
| Внешний отчёт | .erf | Нулевой | S | Низкая |
| Внешняя обработка | .epf | Нулевой | S–M | Низкая |
| Печатная форма | .mxl через БСП | Нулевой | S | Низкая |
| Через БСП | .epf (подключаемая) | Низкий | S–M | Низкая |
| Расширение | .cfe | Средний | M–L | Средняя |
| Новый объект | Конфигурация | Высокий | L–XL | Высокая |
| Изменение типового | Конфигурация | Критический | M–XL | Очень высокая |

---

## Оценка совокупной стоимости доработки (TCO)

При оценке трудозатрат учитывать не только разработку, но и весь жизненный цикл:

| Компонент | % от общей стоимости (ориентир) |
|-----------|-------------------------------|
| Аналитика и проектирование | 15–25% |
| Разработка | 30–40% |
| Тестирование | 15–20% |
| Документирование | 5–10% |
| Внедрение (обучение, настройка) | 10–15% |
| Сопровождение при обновлениях (в год) | 10–30% от стоимости разработки |

Для доработок с высоким/критическим риском обновления — стоимость сопровождения
превысит стоимость начальной разработки уже через 2–3 года эксплуатации.

---

## Workflow разработки доработки (режим «Код/Отчёт»)

Адаптация 9-фазного pipeline (1C AI Dev Kit → 6 фаз для Claude.ai):

### Фаза 0: Оценка и классификация
- Определить тип доработки по каталогу выше
- Определить уровень сложности (S / M / L / XL)
- Выбрать подход (ERF → EPF → CFE → конфигурация)

### Фаза 1: Требования и уточнения
- Формализовать требования: что должно делать, входы/выходы, ограничения
- Выявить неоднозначности, граничные случаи, зависимости от типовых объектов
- Все вопросы пользователю — ДО начала проектирования

### Фаза 2: Проектирование
- Определить затрагиваемые объекты конфигурации (регистры, справочники)
- Спроектировать структуру данных (реквизиты, табличные части, регистры)
- Спроектировать запросы (для отчётов — текст запроса СКД)
- Спроектировать UI (формы, команды, расположение в интерфейсе)
- Описать права доступа (роли, RLS)

### Фаза 3: Ревью плана → Одобрение пользователем
- Представить план пользователю
- **Не начинать реализацию без одобрения**

### Фаза 4: Реализация
- Писать код BSL с комментариями
- Для СКД — описать схему компоновки (наборы данных, ресурсы, настройки)
- Для форм — описать элементы и обработчики

### Фаза 5: Ревью и документирование
- Проверить код на соответствие стандартам 1С и плану
- Создать описание доработки (для передачи клиенту / другому разработчику)