MOD-ACT-GENERATION — Акты выполненных работ

Лицензия: Платный

Модуль выпускает акт выполненных работ по источнику — проекту и спринту или явной ссылке. Генерация идемпотентна: повторный вызов по тому же источнику возвращает уже созданный акт, а не второй. Сумма считается по основанию и хранится в копейках, поэтому результат разбирается смежным MOD-DEV-PROJECT без округления. Изменять можно только черновик; рендер, отправка заказчику, аннулирование и удаление требуют явного подтверждения. Рендер и согласование идут через MOD-DOCS, отправка — через ЭДО; при недоступности смежного модуля модуль честно деградирует и идентификатор не выдумывает.

Возможности

Идемпотентная генерация акта по проекту и спринту или по явной ссылке на источник
Расчёт суммы по основанию без создания акта; предпросмотр номера и суммы без записи
Сумма в копейках — результат разбирается MOD-DEV-PROJECT без потери точности
Изменение и удаление только для черновиков; аннулирование акта с подтверждением
Рендер и повторный рендер акта через MOD-DOCS; повторный рендер требует подтверждения
Отправка заказчику с идемпотентностью по ключу; честная деградация ЭДО
Запуск согласования акта через MOD-DOCS и запрос статуса подписи
Шаблоны актов: список активных, создание или обновление, мягкое удаление с подтверждением
Таймлайн событий акта и сводный отчёт с числом строк и статусом подписи

Основные MCP-инструменты

Инструмент	Назначение
`act-generation__describe_entities`	Метаданные сущностей модуля без данных
`act-generation__describe_blocks`	Блоки холста модуля для библиотеки MOD-CANVAS
`act-generation__get_roles`	Ролевая модель модуля
`act-generation__get_canvas_presets`	Готовые холсты модуля по роли
`act-generation__subscribe_events`	Каналы live-событий модуля и путь SSE-потока
`act-generation__act.generate`	Создать или получить акт идемпотентно по проекту и спринту либо по ссылке на источник
`act-generation__act.request`	Запросить акт — синоним генерации с честной деградацией
`act-generation__act.calculate`	Рассчитать сумму по основанию без создания акта
`act-generation__act.preview`	Предпросмотр номера и суммы акта без записи
`act-generation__act.get`	Получить акт по идентификатору
`act-generation__act.list`	Список актов с фильтрами
`act-generation__act.update`	Изменить черновой акт: заказчик, период, дата акта
`act-generation__act.render`	Отрендерить или перерендерить акт через MOD-DOCS; повтор требует подтверждения
`act-generation__act.send_to_customer`	Отправить акт заказчику; идемпотентно по ключу, требует подтверждения
`act-generation__act.void`	Аннулировать акт (требует подтверждения)
`act-generation__act.delete`	Мягко удалить черновой акт (требует подтверждения)
`act-generation__act.start_approval`	Запустить согласование акта через MOD-DOCS
`act-generation__act.sign_status`	Статус подписи акта
`act-generation__template.list`	Список активных шаблонов актов
`act-generation__template.upsert`	Создать или обновить шаблон акта
`act-generation__template.delete`	Мягко удалить шаблон акта (требует подтверждения)
`act-generation__timeline.get`	Таймлайн событий акта
`act-generation__act.report`	Сводный отчёт по актам с числом строк и статусом подписи

Блоки холста

act-card — карточка акта выполненных работ
act-field — одно поле акта
template-card — карточка шаблона акта
template-field — одно поле шаблона акта