From 56e8ac063aef7fab5caf316f1a9256590bc145b9 Mon Sep 17 00:00:00 2001 From: mihailkudravcev Date: Wed, 29 Jul 2026 11:40:37 +0300 Subject: [PATCH] export_docs v0.3.8: sync docs to docs (58 files) --- docs | 140 +++++++++++++++++++++++++++++ manifest.export_docs.71ab8b6a.json | 125 ++++++++++++++++++++++++++ 2 files changed, 265 insertions(+) create mode 100644 docs create mode 100644 manifest.export_docs.71ab8b6a.json diff --git a/docs b/docs new file mode 100644 index 0000000..3777949 --- /dev/null +++ b/docs @@ -0,0 +1,140 @@ +--- +title: Чек-лист внедрения графы 5б в УПД +version: 1.0 +date_created: 2026-04-21 +date_modified: 2026-04-21 +author: Руководитель отдела ИТ Кудрявцев М.А. (kma@rhana.com) +description: Рабочий чек-лист для разработки и приемки реализации графы 5б в УПД с приоритетом изменений через расширение crm3-dev.rhana. +status: К выполнению +based_on: ТЗ_минимальная_реализация_графы_5б_УПД_2026-04-21.md +based_on_title: Техническое задание - минимальная реализация графы 5б в УПД (через расширение) +based_on_version: 1.1 +show_metadata_block: true +show_index_link: true +show_toc: true +--- + +# Рабочий чек-лист внедрения + +## Ссылки на ТЗ + +- Базовый документ: [ТЗ по графе 5б](docs) +- Архитектурный принцип: см. раздел `2` ТЗ. +- Карта объектов: см. раздел `4` ТЗ. +- Детализация реализации: см. раздел `5` ТЗ. +- Шаблоны кода: см. раздел `6` ТЗ. +- Правила разработки: см. раздел `7` ТЗ. +- План работ: см. раздел `8` ТЗ. +- Критерии приемки: см. раздел `9` ТЗ. + +## 1. Подготовка + +- [ ] Подтвердить ветку разработки и стенд внедрения (см. разделы `1`, `2` ТЗ). +- [ ] Зафиксировать версии: + - `crm3-dev` + - `crm3-dev.rhana` + - текущий рабочий макет УПД. +- [ ] Создать резервные копии объектов: + - `Documents/СчетФактураВыданный` + - `DataProcessors/ПечатьОбщихФорм` + - макет УПД в расширении. +- [ ] Проверить, что правила `&ИзменениеИКонтроль` применимы для целевых методов (см. раздел `7` ТЗ). + +## 2. Реализация в расширении документа `СчетФактураВыданный` + +Файл: `crm3-dev.rhana/src/Documents/СчетФактураВыданный/Ext/ManagerModule.bsl` (см. разделы `4.1`, `5.1`, `6.1`, `6.2`, `6.3`, `6.4` ТЗ) + +### 2.1. Функция формирования строки 5б +- [ ] Добавить `упд5б_СтрокаАвансовыеСчетаФактуры(ПлатежноРасчетныеДокументы) Экспорт` (шаблон: раздел `6.1` ТЗ). +- [ ] Проверить формат вывода: + - `№ %1 от %2, исправление № %3 от %4` + - разделитель нескольких значений: `; `. + +### 2.2. Временная таблица платежно-расчетных документов +- [ ] Расширить `ПоместитьВременнуюТаблицуПлатежноРасчетныхДокументов(...)` (цельный блок с директивами, раздел `6.2` ТЗ). +- [ ] Добавить колонку `СтрокаАвансовыеСчетаФактуры` (раздел `6.2` ТЗ). +- [ ] Заполнять колонку через `упд5б_СтрокаАвансовыеСчетаФактуры(...)` (раздел `6.2` ТЗ). + +### 2.3. Запрос данных по оплатам/авансовым СФ +- [ ] Расширить `ТекстЗапросаПолученияНомеровИДатПлатежноРасчетныхДокументов()` (цельный блок с директивами, раздел `6.3` ТЗ). +- [ ] Добавить получение полей: + - `НомерСчетаФактурыНаАванс` + - `ДатаСчетаФактурыНаАванс` + - `НомерИсправленияСчетаФактурыНаАванс` + - `ДатаИсправленияСчетаФактурыНаАванс`. +- [ ] Проверить, что используются связи с `Документ.СчетФактураВыданныйАванс`. + +### 2.4. Прокидывание в данные печати +- [ ] Добавить в запрос шапки поле `ПредставлениеАвансовыеСчетаФактуры` (раздел `6.4` ТЗ). +- [ ] Реализовать через `ЕСТЬNULL(...)` (ВТ/данные документа) (раздел `6.4` ТЗ). + +## 3. Реализация в расширении печати УПД + +Файл: `crm3-dev.rhana/src/DataProcessors/ПечатьОбщихФорм/Ext/ManagerModule.bsl` (см. разделы `4.1`, `5.2`, `6.5` ТЗ) + +### 3.1. Вставка в `р_ЗаполнитьТабличныйДокументУПД(...)` +- [ ] Добавить получение `ДанныеПечати.ПредставлениеАвансовыеСчетаФактуры` (раздел `6.5` ТЗ). +- [ ] Добавить fallback: + - `№ -- от --, исправление № -- от --`. +- [ ] Заполнить параметр: + - `ОбластьШапка.Параметры.АвансовыеСчетаФактуры` (раздел `6.5` ТЗ). + +### 3.2. Контроль совместимости +- [ ] Проверить, что при отсутствии поля/значения печать не падает. +- [ ] Проверить, что прочие поля УПД не изменили поведение. + +## 4. Изменение макета УПД (в расширении) + +См. разделы `4.1`, `5.3`, `8` ТЗ. + +- [ ] Добавить параметр `АвансовыеСчетаФактуры` в область `Шапка` (строка 5б). +- [ ] Проверить совпадение имени параметра в макете и коде. +- [ ] Проверить перенос длинной строки в шапке. + +## 5. Стандарты и контроль качества кода + +См. раздел `7` ТЗ. + +- [ ] Все изменения в перехватываемых методах оформлены через `&ИзменениеИКонтроль`. +- [ ] Новые блоки оформлены в `#Вставка` / `#Удаление`. +- [ ] В `#Удаление` нет комментариев и нового текста. +- [ ] Новые методы расширения имеют префикс `упд5б_`. +- [ ] Проверка `check_ext` выполнена без критических несоответствий. + +## 6. Тестовые сценарии (минимум) + +См. разделы `8` и `9` ТЗ. + +### 6.1. Позитивные +- [ ] Реализация с одним авансовым СФ -> 5б заполнена корректно. +- [ ] Реализация с несколькими авансовыми СФ -> значения через `; `. +- [ ] Реализация с исправленным авансовым СФ -> отображаются номер/дата исправления. + +### 6.2. Негативные и граничные +- [ ] Нет авансовых СФ -> вывод fallback. +- [ ] Старые документы без данных 5б печатаются без ошибок. +- [ ] Пустые/частично заполненные значения не ломают формат строки. + +### 6.3. Регрессия +- [ ] УПД без авансов печатается как до внедрения. +- [ ] Графы 5а/6/7/8 работают корректно. +- [ ] Печать из `РеализацияТоваровУслуг` без ошибок. + +## 7. Критерии готовности (Definition of Done) + +См. раздел `9` ТЗ. + +- [ ] В графе 5б выводятся авансовые СФ для закрываемой реализацией оплаты. +- [ ] При отсутствии данных применяется fallback. +- [ ] Изменения выполнены преимущественно в `crm3-dev.rhana`. +- [ ] Протокол тестирования заполнен и подписан. +- [ ] Подготовлен список фактически измененных объектов. + +## 8. Протокол сдачи + +См. разделы `10` и `11` ТЗ. + +- [ ] Передать перечень измененных объектов (файл/метод/тип изменения). +- [ ] Передать скриншоты УПД по 3 ключевым кейсам (1 СФ, несколько СФ, fallback). +- [ ] Передать результаты `check_ext`. +- [ ] Передать итоговую оценку рисков (низкий/средний/высокий) и план отката. diff --git a/manifest.export_docs.71ab8b6a.json b/manifest.export_docs.71ab8b6a.json new file mode 100644 index 0000000..7828aa5 --- /dev/null +++ b/manifest.export_docs.71ab8b6a.json @@ -0,0 +1,125 @@ +{ + "tool": "export_docs", + "version": "0.3.8", + "folder": "docs", + "files": [ + "docs", + "docs", + "docs", + "docs", + "docs", + "docs", + "docs", + "docs", + "docs", + "docs", + "docs", + "docs", + "docs", + "docs", + "docs", + "docs", + "docs", + "docs", + "docs", + "docs", + "docs", + "docs", + "docs", + "docs", + "docs", + "docs", + "docs", + "docs", + "docs", + "docs", + "docs", + "docs", + "docs", + "docs", + "docs", + "docs", + "docs", + "docs", + "docs", + "docs", + "docs", + "docs", + "docs", + "docs", + "docs", + "docs", + "docs", + "docs", + "docs", + "docs", + "docs", + "docs", + "docs", + "docs", + "docs", + "docs", + "docs", + "docs" + ], + "sources": [ + "/Users/mihailkudravcev/projects/crm3-26/docs/Checklist_5b_UPD_2026-04-21.md", + "/Users/mihailkudravcev/projects/crm3-26/docs/INDEX.md", + "/Users/mihailkudravcev/projects/crm3-26/docs/PROJECT_CONTEXT.md", + "/Users/mihailkudravcev/projects/crm3-26/docs/README_md_to_html.md", + "/Users/mihailkudravcev/projects/crm3-26/docs/TZ2_full_UPD_migration_2026-04-21.md", + "/Users/mihailkudravcev/projects/crm3-26/docs/TZ_min_5b_UPD_2026-04-21.md", + "/Users/mihailkudravcev/projects/crm3-26/docs/diadoc_answer_2026-05-08.md", + "/Users/mihailkudravcev/projects/crm3-26/docs/instructions_filter_access_groups.md", + "/Users/mihailkudravcev/projects/crm3-26/docs/Анализ_доработок_синхронизации_ЗаказКлиента.md", + "/Users/mihailkudravcev/projects/crm3-26/docs/Анализ_доработок_синхронизации_РеализацияТоваровУслуг.md", + "/Users/mihailkudravcev/projects/crm3-26/docs/Анализ_доработок_складского_учета_и_печати_документов.md", + "/Users/mihailkudravcev/projects/crm3-26/docs/Анализ_доработок_формы_приемки_УправлениеПоступлением.md", + "/Users/mihailkudravcev/projects/crm3-26/docs/Анализ_механизма_перезаполнения_CRM_ЖурналДокументов.md", + "/Users/mihailkudravcev/projects/crm3-26/docs/Анализ_обмена_НДС_22_с_Бухгалтерией_КОРП.md", + "/Users/mihailkudravcev/projects/crm3-26/docs/Анализ_обработчиков_обновления_НДС_22.md", + "/Users/mihailkudravcev/projects/crm3-26/docs/Анализ_ошибок_обновления.md", + "/Users/mihailkudravcev/projects/crm3-26/docs/Анализ_переноса_обработки_КредитНотаЗаПериод.md", + "/Users/mihailkudravcev/projects/crm3-26/docs/Анализ_печати_пакета_документов_и_складского_учета (v3.0).md", + "/Users/mihailkudravcev/projects/crm3-26/docs/Анализ_привязок_серий_номенклатур_к_видам_номенклатур.md", + "/Users/mihailkudravcev/projects/crm3-26/docs/Анализ_применения_КредитНота (v1.1).md", + "/Users/mihailkudravcev/projects/crm3-26/docs/Анализ_применения_КредитНота.md", + "/Users/mihailkudravcev/projects/crm3-26/docs/Анализ_применения_реквизита_Купон (v1.0).md", + "/Users/mihailkudravcev/projects/crm3-26/docs/Анализ_применения_реквизита_Купон.md", + "/Users/mihailkudravcev/projects/crm3-26/docs/Анализ_различий_crm3-26-test_vs_crm3-dev.md", + "/Users/mihailkudravcev/projects/crm3-26/docs/Анализ_рисков_неуникальности_CRM_ЖурналДокументов.md", + "/Users/mihailkudravcev/projects/crm3-26/docs/Быстрое_решение.md", + "/Users/mihailkudravcev/projects/crm3-26/docs/Выводы_сравнения_конфигураций.md", + "/Users/mihailkudravcev/projects/crm3-26/docs/Глубинный_анализ_регистров.md", + "/Users/mihailkudravcev/projects/crm3-26/docs/Дорожная_карта_миграции_CRM3_v0.1.md", + "/Users/mihailkudravcev/projects/crm3-26/docs/Инструкция_добавления_ролей_в_профиль.md", + "/Users/mihailkudravcev/projects/crm3-26/docs/Инструкция_по_запуску_md_convert.md", + "/Users/mihailkudravcev/projects/crm3-26/docs/Инструкция_по_исправлению.md", + "/Users/mihailkudravcev/projects/crm3-26/docs/Итоговый_отчет_анализа_регистров.md", + "/Users/mihailkudravcev/projects/crm3-26/docs/Отчет_о_конвертации.md", + "/Users/mihailkudravcev/projects/crm3-26/docs/Оценка_правок_для_переноса_НДС_22.md", + "/Users/mihailkudravcev/projects/crm3-26/docs/Оценка_правок_для_переноса_НДС_22_(v1.1).md", + "/Users/mihailkudravcev/projects/crm3-26/docs/Перечень_констант_crm3-26-test.md", + "/Users/mihailkudravcev/projects/crm3-26/docs/Перечень_констант_crm3-dev.md", + "/Users/mihailkudravcev/projects/crm3-26/docs/Проблема_неуникальности_регистра_CRM_ЖурналДокументов.md", + "/Users/mihailkudravcev/projects/crm3-26/docs/Проверка_ставки_НДС_22.md", + "/Users/mihailkudravcev/projects/crm3-26/docs/РЕЗУЛЬТАТЫ_КОНВЕРТАЦИИ.md", + "/Users/mihailkudravcev/projects/crm3-26/docs/Реализация_переноса_НДС_22.md", + "/Users/mihailkudravcev/projects/crm3-26/docs/Роли_для_включения_в_новой_системе.md", + "/Users/mihailkudravcev/projects/crm3-26/docs/Роли_для_отметки_ДА_осталось.md", + "/Users/mihailkudravcev/projects/crm3-26/docs/Сверка_ролей_профиля.md", + "/Users/mihailkudravcev/projects/crm3-26/docs/Сверка_ролей_с_учетом_переименований.md", + "/Users/mihailkudravcev/projects/crm3-26/docs/Сводка_переноса_и_настройки_актуальной_формы_УПД.md", + "/Users/mihailkudravcev/projects/crm3-26/docs/Сводка_рисков_неуникальности.md", + "/Users/mihailkudravcev/projects/crm3-26/docs/Список_объектов_для_удаления_из_подсистем.md", + "/Users/mihailkudravcev/projects/crm3-26/docs/Список_ролей_для_отметки_ДА.md", + "/Users/mihailkudravcev/projects/crm3-26/docs/Сравнение_констант_crm3-dev_vs_crm3-26-test.md", + "/Users/mihailkudravcev/projects/crm3-26/docs/ТЗ_2_полный_перенос_логики_УПД_из_crm3-26-promo_в_crm3-dev_2026-04-21.md", + "/Users/mihailkudravcev/projects/crm3-26/docs/ТЗ_3_Внедрение_формы_УПД_в_текущую_рабочую_базу_2026-05-05.md", + "/Users/mihailkudravcev/projects/crm3-26/docs/ТЗ_минимальная_реализация_графы_5б_УПД_2026-04-21.md", + "/Users/mihailkudravcev/projects/crm3-26/docs/Улучшения_скрипта_проверки.md", + "/Users/mihailkudravcev/projects/crm3-26/docs/ФИНАЛЬНЫЙ_ОТЧЕТ_Анализ_регистров.md", + "/Users/mihailkudravcev/projects/crm3-26/docs/ФИНАЛЬНЫЙ_СПИСОК_РОЛЕЙ_ДЛЯ_ВКЛЮЧЕНИЯ.md", + "/Users/mihailkudravcev/projects/crm3-26/docs/Чеклист_внедрения_графы_5б_УПД_2026-04-21.md" + ] +}