Документ «Сверка с документами воинского учета»

1. Назначение и место в учёте

Документ «Сверка с документами воинского учета» регистрирует факт сверки сведений воинского учёта, хранящихся в информационной базе, с подлинными документами воинского учёта сотрудников (в отличие от парного документа «Сверка с военным комиссариатом», который фиксирует сверку с учётным органом). В документе указывается организация, перечень сверенных физических лиц и сотрудник, проводивший сверку. Использует его специалист, ответственный за воинский учёт (кадровик); нумерация годовая (тип номера — строка, длина 11, периодичность Year). Воинский учёт в РК ведётся, поэтому документ применим в казахстанской практике; сам объект — наследие российской типовой конфигурации ЗУП (помечаем как RU-наследие в составе «Зарплата и управление персоналом для Казахстана 3.1»). Результат проведения — запись данных сверки в специализированный регистр сведений.

2. Структура объекта

2.1 Реквизиты шапки

Все реквизиты из metadata.attributes перечислены, без пропусков.

2.2 Табличные части

ТЧ Сотрудники (синоним «Сотрудники») — перечень физических лиц, чьи учётные данные сверены с их документами воинского учёта:

Единственная колонка — в отличие от документа «Сверка с военным комиссариатом» здесь нет колонки «Номер списка».

ТЧ ДополнительныеРеквизиты (синоним «Дополнительные реквизиты») — стандартный механизм дополнительных реквизитов и сведений:

2.3 Формы

(не определено) — в JSON-карте список форм пуст (forms: []); собственных управляемых форм не зафиксировано, используются формы, генерируемые платформой по метаданным.

3. Сценарии работы

3.1 Сценарий: «Регистрация сверки учётных данных с документами сотрудников» (Create)

• Когда применяется: после фактической проверки данных воинского учёта в базе на соответствие подлинникам документов воинского учёта сотрудников — чтобы зафиксировать дату, состав и исполнителя сверки.
• Шаги пользователя: 1. Создать новый документ «Сверка с документами воинского учета». 2. Указать Организация (обязательно). 3. Указать СверкуПровел — физическое лицо, проводившее сверку (обязательно). 4. Заполнить ТЧ Сотрудники: построчно ФизическоеЛицо — все сверенные сотрудники. 5. При необходимости заполнить Комментарий и Ответственный. 6. Провести документ.
• На что обратить внимание: номер формируется автоматически (строка длиной 11, нумерация в пределах года) — вручную не задавать; в строке ТЧ заполняется только сотрудник, других колонок нет.
• Какие проверки сработают: платформенная проверка заполнения — пустые Организация или СверкуПровел остановят проведение с ошибкой (ShowError).
• Что произойдёт после «Провести»: документ запишет движения в регистр сведений ДанныеСверкиСДокументамиВоинскогоУчета — факт сверки станет учётным.

3.2 Сценарий: «Просмотр истории сверок» (Read)

• Когда применяется: нужно установить, когда в последний раз данные конкретного сотрудника сверялись с его документами воинского учёта и кто проводил сверку.
• Шаги пользователя: 1. Открыть список документов «Сверка с документами воинского учета». 2. Ориентироваться по дате, номеру и текстовой сводке состава (реквизит КраткийСоставДокумента, подпись «Сотрудники»). 3. Открыть документ и просмотреть ТЧ Сотрудники.
• Проверки: не выполняются (чтение).

3.3 Сценарий: «Корректировка ранее введённой сверки» (Update)

• Когда применяется: в проведённом документе обнаружена ошибка — лишний/пропущенный сотрудник, неверно указан проводивший сверку.
• Шаги пользователя: 1. Открыть проведённый документ. 2. Исправить строки ТЧ Сотрудники или реквизиты шапки (СверкуПровел, Комментарий). 3. Перепровести документ.
• Что произойдёт: записи регистра сведений ДанныеСверкиСДокументамиВоинскогоУчета переформируются по новым данным.
• Проверки: обязательность Организация и СверкуПровел (ShowError).

3.4 Сценарий: «Отмена ошибочно введённой сверки»

• Когда применяется: документ создан ошибочно (не та организация, дублирование).
• Шаги пользователя: 1. Открыть документ, выполнить «Отмена проведения» (либо пометить на удаление).
• Что произойдёт: движения по регистру ДанныеСверкиСДокументамиВоинскогоУчета будут удалены, история сверок очистится.

3.5 Сценарий: «Учёт дополнительных сведений по сверке»

• Когда применяется: для этого вида документов настроены дополнительные реквизиты (механизм «Дополнительные реквизиты и сведения»).
• Шаги пользователя: 1. Заполнить значения дополнительных свойств (хранятся в ТЧ ДополнительныеРеквизиты: Свойство, Значение, ТекстоваяСтрока). 2. Записать/провести документ.
• На что обратить внимание: состав доступных свойств определяется настройкой плана видов характеристик ДополнительныеРеквизитыИСведения.

4. Per-field reference

В JSON-карте нет BSL-модулей (bsl_static: [], bsl_summaries: []) — обработчики ПриИзменении и программные валидации не определены; справка по метаданным:

• Организация (CatalogRef.Организации): организация, по которой регистрируется сверка. Обязательна (fill_value_required = ShowError) — без неё документ не пройдёт проверку заполнения. Влияние на другие поля — (не определено).
• СверкуПровел (CatalogRef.ФизическиеЛица): физическое лицо, проводившее сверку. Обязателен (ShowError). Тип — справочник «Физические лица», не «Пользователи».
• КраткийСоставДокумента (xs:string, синоним «Сотрудники»): служебная строка-представление состава документа для списков; DontCheck, вручную заполнять не требуется.
• Ответственный (CatalogRef.Пользователи): пользователь-ответственный; необязателен (DontCheck). Типичное значение — текущий пользователь.
• Комментарий (xs:string): произвольный текст; необязателен (DontCheck).
• Сотрудники.ФизическоеЛицо (CatalogRef.ФизическоеЛица, синоним «Сотрудник»): сверяемый сотрудник; единственная и ключевая колонка ТЧ.
• ДополнительныеРеквизиты.Свойство / Значение / ТекстоваяСтрока: стандартные поля механизма доп. реквизитов; заполняются только при настроенных свойствах.

5. Бизнес-логика

• Обработчики событий: (не определено) — BSL-модули и их сводки в карте отсутствуют.
• Проводки/движения: документ пишет в регистр сведений ДанныеСверкиСДокументамиВоинскогоУчета (metadata.register_records); логика формирования записей в выгрузке не раскрыта.
• Валидации: программная ОбработкаПроверкиЗаполнения — (не определено); действуют декларативные проверки метаданных: Организация и СверкуПровел обязательны (ShowError), остальные не проверяются (DontCheck).
• Зависимости от других модулей: (не определено).

6. Связи с другими объектами

6.1 Документы-основания

(не определено) — metadata.based_on пуст: документ не вводится на основании других объектов.

6.2 Кто создаётся на основании этого

(не определено) — metadata.inverse_based_on пуст: на основании этого документа другие документы не вводятся.

6.3 Регистры движения

• InformationRegister.ДанныеСверкиСДокументамиВоинскогоУчета — регистр сведений с данными проведённых сверок; единственный регистр движений документа.

7. Заметки для ИИ-агента

1. Обязательных полей два: Организация и СверкуПровел (оба ShowError) — заполнить до проведения; остальные поля опциональны.
2. СверкуПровел — ссылка на справочник ФизическиеЛица, Ответственный — на Пользователи; не путать типы при подборе.
3. ТЧ Сотрудники содержит единственную колонку ФизическоеЛицо (подпись «Сотрудник») — в отличие от документа СверкаСВоеннымКомиссариатом здесь НЕТ колонки НомерСписка; не искать её в форме.
4. Поле с подписью «Сотрудники» в шапке/списке — строковый служебный реквизит КраткийСоставДокумента; реальный состав вводится только в табличную часть.
5. Номер — строка длиной 11 с годовой периодичностью; формируется платформой автоматически, вручную не задавать.
6. Документ проводимый: данные сверки попадают в регистр сведений ДанныеСверкиСДокументамиВоинскогоУчета только после проведения; исправления требуют перепроведения.
7. Собственных форм и команд в карте нет — UI стандартный платформенный. Не путать с парным документом СверкаСВоеннымКомиссариатом (сверка с учётным органом): этот документ — о сверке с документами самих сотрудников. Объект — RU-наследие типовой ЗУП; воинский учёт в РК ведётся, документ применим.