export_docs v0.3.8: sync docs to docs (58 files)

mihailkudravcev
2026-07-29 11:40:37 +03:00
parent 208b194191
commit 56e8ac063a
2 changed files with 265 additions and 0 deletions
+140
@@ -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`.
- [ ] Передать итоговую оценку рисков (низкий/средний/высокий) и план отката.
+125
@@ -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"
]
}