---
name: act-processor
description: Обработка и генерация актов КС-2, КС-3 и других закрывающих документов. Используй когда пользователь говорит "обработай акт", "сформируй КС-2", "закрывающие документы", "акт выполненных работ", "справка о стоимости".
---

# Act Processor — Обработка актов выполненных работ

## Назначение

Работа с актами и закрывающими документами:
- Обработка входящих актов КС-2, КС-3
- Генерация актов на основе данных о выполнении
- Проверка соответствия сметам и договору
- Формирование пакета закрывающих документов

## Формы документов

### КС-2 (Акт о приёмке выполненных работ)
Унифицированная форма для фиксации объёмов и стоимости выполненных работ.

### КС-3 (Справка о стоимости выполненных работ)
Сводный документ для оплаты, суммирует данные из КС-2.

### КС-6а (Журнал учёта выполненных работ)
Накопительная ведомость по проекту.

## Структура КС-2

```
┌─────────────────────────────────────────────────────────────┐
│                     АКТ                                     │
│         О ПРИЁМКЕ ВЫПОЛНЕННЫХ РАБОТ                        │
│                     № ___                                   │
├─────────────────────────────────────────────────────────────┤
│ Стройка: ________________________________________________  │
│ Объект: _________________________________________________  │
│ Договор: № ___ от _______                                   │
│ Отчётный период: с ___ по ___                               │
├─────────────────────────────────────────────────────────────┤
│ № │ Наименование │ Ед. │ Кол-во │ Цена │ Стоимость          │
│   │ работ        │ изм │        │      │                    │
├───┼──────────────┼─────┼────────┼──────┼────────────────────┤
│ 1 │ Разработка   │ м³  │ 1000   │ 500  │ 500 000            │
│   │ грунта       │     │        │      │                    │
├───┼──────────────┼─────┼────────┼──────┼────────────────────┤
│   │ ИТОГО:       │     │        │      │ 500 000            │
└───┴──────────────┴─────┴────────┴──────┴────────────────────┘
│ Сдал: Подрядчик          │ Принял: Заказчик                 │
│ _____________            │ _____________                    │
└──────────────────────────┴──────────────────────────────────┘
```

## Workflow

### Режим 1: Обработка входящего акта

**Шаг 1:** Загрузка документа
- Поддерживаемые форматы: PDF, Excel, Word
- Извлечение данных: номер, дата, объёмы, стоимость

**Шаг 2:** Верификация
- Проверка соответствия смете
- Проверка расценок (ФГИС ЦС, договорные)
- Проверка объёмов (не более остатка по договору)
- Арифметическая проверка

**Шаг 3:** Формирование заключения
```
✅ Проверка акта КС-2 № 5 от 25.01.2026

Объёмы: ✓ Соответствуют смете
Расценки: ✓ Соответствуют договору
Арифметика: ✓ Корректна
Остаток по договору: 2 500 000 ₽

Рекомендация: К ПОДПИСАНИЮ
```

### Режим 2: Генерация акта

**Шаг 1:** Сбор данных
- Данные о выполнении из progress-tracker
- Расценки из сметы/договора
- Период отчётности

**Шаг 2:** Формирование акта
- Заполнение шапки (реквизиты, договор, период)
- Заполнение табличной части (работы, объёмы, стоимость)
- Расчёт итогов

**Шаг 3:** Генерация пакета документов
1. КС-2 (Excel)
2. КС-3 (Excel)
3. Сопроводительное письмо (Word)
4. Счёт на оплату (опционально)

## Проверки

### Соответствие смете
```python
# Проверка: объём в акте ≤ объём в смете - ранее закрыто
остаток_по_смете = смета.объём - сумма(ранее_закрыто)
if акт.объём > остаток_по_смете:
    ❌ "Превышение объёма по позиции {название}"
```

### Соответствие расценкам
```python
if акт.расценка != договор.расценка:
    ❌ "Расценка не соответствует договору"
    expected: договор.расценка
    actual: акт.расценка
```

### Арифметика
```python
if акт.объём * акт.расценка != акт.стоимость:
    ❌ "Арифметическая ошибка"
    expected: акт.объём * акт.расценка
    actual: акт.стоимость
```

## Примеры использования

### Пример 1: Проверка входящего акта
```
Пользователь: Проверь акт КС-2 от субподрядчика [прикладывает файл]

Claude:
📋 Проверка акта КС-2 № 12 от 25.01.2026
Субподрядчик: ООО "СтройМонтаж"
Договор: № 45-2025 от 01.06.2025

**Результаты проверки:**

✅ Реквизиты: корректны
✅ Период: 01.01.2026 - 25.01.2026
✅ Объёмы: соответствуют журналу работ

⚠️ Замечания:
1. Позиция 3 "Укладка асфальтобетона":
   - В акте: 1200 м²
   - Остаток по договору: 1000 м²
   - Превышение: 200 м² (требует допсоглашение)

2. Позиция 7 "Монтаж ограждений":
   - Расценка в акте: 1500 ₽/п.м.
   - Расценка по договору: 1400 ₽/п.м.
   - Разница: +100 ₽/п.м.

**Рекомендация:** Вернуть на доработку с замечаниями
```

### Пример 2: Генерация акта
```
Пользователь: Сформируй акт КС-2 по проекту "Мост №5" за январь

Claude:
📝 Формирую акт КС-2...

**Данные из progress-tracker:**
- Проект: Мост №5
- Период: 01.01.2026 - 31.01.2026
- Выполнено работ: 12 позиций
- Общая стоимость: 4 500 000 ₽

**Генерирую документы:**
1. КС-2_Мост5_январь_2026.xlsx
2. КС-3_Мост5_январь_2026.xlsx
3. Сопроводительное_КС_Мост5.docx

**Сводка:**
| Раздел | Стоимость |
|--------|-----------|
| Земляные работы | 1 200 000 |
| Бетонные работы | 2 800 000 |
| Арматурные работы | 500 000 |
| **ИТОГО:** | **4 500 000** |
```

### Пример 3: Накопительный итог
```
Пользователь: Покажи сколько закрыто по договору с начала работ

Claude:
📊 Накопительный итог по договору № 125-2025

**Договор:** 15 000 000 ₽
**Период:** март 2025 - январь 2026

| Месяц | КС-2 № | Сумма | Накопительно | % |
|-------|--------|-------|--------------|---|
| Март | 1 | 1 200 000 | 1 200 000 | 8% |
| Апрель | 2 | 1 800 000 | 3 000 000 | 20% |
| Май | 3 | 2 500 000 | 5 500 000 | 37% |
| ... | ... | ... | ... | ... |
| Январь | 10 | 4 500 000 | 12 000 000 | 80% |

**Остаток:** 3 000 000 ₽ (20%)
**Прогноз закрытия:** февраль 2026
```

## Интеграция

- **progress-tracker** — данные о выполнении работ
- **contract-analyzer** — условия договора, расценки
- **letter-generator** — сопроводительные письма
- **xlsx** — генерация Excel-файлов
- **1С:ERP** — синхронизация с бухгалтерией

## Выходные документы

1. **КС-2_[проект]_[период].xlsx** — акт о приёмке
2. **КС-3_[проект]_[период].xlsx** — справка о стоимости
3. **Сопроводительное_КС_[проект].docx** — письмо
4. **Реестр_актов_[проект].xlsx** — накопительная ведомость