153_CB-OUO_Parent-Payments/docs/ПЛАН. Остатки взаиморасчётов с детьми в садах (БГУ 2.0).md

# ПЛАН. Остатки взаиморасчётов с детьми в садах (БГУ 2.0)

**Ветка:** `feature/ostatki-v-sadah`
**Основание:** `docs/ЗАДАЧА. Остатки взаиморасчётов с детьми в садах (БГУ 2.0).md`
**Дата:** 14.10.2026
**Статус:** черновик плана — шаги согласовать до начала правок

---

## 0. Ревизия выполнена

Проведён разбор обоих документов и их связей. Ниже — что именно затронет работа.

**Документы и их текущая роль:**

| Роль сейчас | Объект | Проводка | Движения по регистрам |
|---|---|---|---|
| ЦБ принимает задолженность | `ПС_ПринятиеЗадолженностиОтУчреждения` | Дт 205.31 — Кт 304.04 | Журнал проводок **и** регистр взаиморасчётов (приход) |
| Сад передаёт задолженность | `ПС_ПередачаЗадолженностиВЦБ` | Дт 304.04 — Кт 205.31 | только Журнал проводок |

**Цепочка «ввод на основании»:** «Начисление родительской платы» → `ПС_ПередачаЗадолженностиВЦБ` (через `basedOn`) → `ПС_ПринятиеЗадолженностиОтУчреждения` (командой формы).

**Ссылки, которые надо пройти при переименовании:**

1. `Configuration.mdo` — состав документов.
2. `Roles\ПС_ОсновнаяРоль\Rights.rights` — два блока прав.
3. Подсистема `РодительскаяПлата.mdo` — состав содержимого.
4. `НачислениеРодительскойПлаты.mdo` — свойство `basedOn`.
5. Типы реквизитов `ДокументПередачи`: в `.mdo` ЦБ-документа и в регистре `ПС_ВзаиморасчетыПоРодительскойПлате`.
6. Код: `Тип("ДокументСсылка.…")`, тексты запросов `Документ.…`, `Документы.….СформироватьПечатныеФормыИзвещений`, `Документы.….ПолучитьМакет`, `ОткрытьФорму("Документ.….Форма.ФормаДокумента")` — в обоих документах, в общем модуле `ПС_УчетРодительскойПлаты`, в пульте, в форме «Начисления родительской платы».
7. Ключи параметров печати в `ПС_УчетРодительскойПлаты` (`ПАРАМЕТРЫ_ПЕЧАТИ_…`).
8. Типы в `.form`: `DocumentObject.…` в формах документов, `DocumentRef.…` в форме пульта.
9. Модули объектов и форм, модули менеджеров обоих документов, макеты печатных форм.

**Не затрагивается:** `ПС_РаботаСКонтрагентами`, `ПС_РазборПлатежейПоРодительскойПлате`, отчёт `ПС_ВедомостьЦБПоРодительскойПлате` (работает с регистром, а не с документами), интерфейс подсистемы, определяемые типы, подписки на события.

---

## 1. Переименование документов

| Сейчас | Стало |
|---|---|
| `ПС_ПринятиеЗадолженностиОтУчреждения` | `ПС_ПередачаПоступившихПлатежейВУчреждения` |
| `ПС_ПередачаЗадолженностиВЦБ` | `ПС_ПринятиеПоступившихПлатежейИзЦБ` |

Порядок работ: сначала переименование в метаданных, затем проход по цепочке ссылок из п. 0, затем код. Перед началом — переключить EDT на ветку и убедиться, что проект собирается.

---

## 2. Смена ролей и логики заполнения

- **ЦБ-документ** (`ПС_ПередачаПоступившихПлатежейВУчреждения`) — теперь источник: собирает поступившие суммы с кредита 205.31 и заполняет ими табличную часть для передачи в сады.
- **Сад-документы** (`ПС_ПринятиеПоступившихПлатежейИзЦБ`) — вводятся **на основании** ЦБ-документа, **по одному на сад** (в выписке ЦБ за день платежи идут в адрес нескольких садов).
- Перестроить цепочку «ввод на основании»: снять у «Начисления родительской платы» основание на сад-документ (сейчас `basedOn` указывает именно на него), настроить основание ЦБ-документ → сад-документы.
- Проверить и поправить автозаполнение реквизитов при вводе на основании: организация, учреждение, ИФО, КФО, суммы.

---

## 3. Снятие режима «Начальное сальдо»

Убирается полностью:

- **Сад-документ:** реквизит `ПередачаСальдо`, команда `ЗаполнитьПоОстаткам20531` и её обработчик `ЗаполнитьПоОстаткам20531НаСервере`, процедуры `ОбновитьВидимостьРеквизитовРежимаСальдо` и `ПередачаСальдоПриИзменении`, связанные элементы формы.
- **ЦБ-документ:** реквизит `ПередачаСальдо` и ветка `ВидОперации = НачальноеСальдо` при формировании движений.
- **Перечисление** `ПС_ВидыОперацийПоВзаиморасчетам` — решить, убирать ли значение «Начальное сальдо».

---

## 4. Проводки и печать — без изменений

- Проводки сохраняются буквально: у ЦБ Дт 205.31 — Кт 304.04, у сада Дт 304.04 — Кт 205.31. В ЦБ сторону уходила дебиторская задолженность, обратно возвращается кредиторская.
- Извещение ф. 0504805 — у обоих документов, как и было. Макеты и их имена не меняются.

---

## 5. Регистры и отчёты — не трогаем

- Структура регистра `ПС_ВзаиморасчетыПоРодительскойПлате` и отчёт `ПС_ВедомостьЦБПоРодительскойПлате` остаются как есть.
- Проверить, что движения регистра по-прежнему формирует ЦБ-документ (сейчас их пишет он, у сад-документа движений нет) и что после переименований измерения заполняются корректно.
- Критерий для отчёта: при полной передаче платежей в сады остатки нулевые.

---

## 6. Пульт — не трогаем

- В форме пульта четыре запроса и типы реквизитов ссылаются на документы. После переименования их надо поправить механически, логику не менять.

---

## 7. Проверка

- Переработать приёмочные сценарии под новую схему: загрузка реестра → ЦБ собирает поступившие суммы → передача в сады → приём в каждом саду → нулевые остатки у ЦБ.
- Прогнать проверку маркеров EDT по изменённым объектам.

---

## 8. Документация

- **Убрать «Начальное сальдо»** из памятки (раздел 4) и руководства пользователя (п. 3.2) — режима больше нет.
- Переписать схему в руководстве пользователя и руководстве по эксплуатации под новую модель, переименовать документы во всех упоминаниях.
- Обновлять шар и `docs/` синхронно, после стабилизации результата.

---

## Открытые вопросы к плану

1. **Из чего заполняется ЦБ-документ** — собирать суммы из расшифровки «Кассового поступления» автоматически (по команде или при записи) или заполнять вручную?
2. **Движения регистра взаиморасчётов** — остаются за ЦБ-документом или переезжают на сад-документ? От этого зависит, где видны остатки в нашем отчёте.
3. **Значение «Начальное сальдо»** в перечислении видов операций — убирать или оставлять как историческое.
4. **`basedOn` у «Начисления родительской платы»** — снимать ли полностью: в новой схеме начисление не является основанием для сад-документа.