| name | dnv-documents |
| description | Заполнение форм и черновиков DNV строго из профиля кейса через реестр полей. fill_forms.py для механической заливки, field_qa.py для самопроверки. Значение поля = значение профиля; нет данных → [ТРЕБУЕТСЯ], не выдумка. |
Заполнение форм и черновиков — инструменты и правила
Когда нужно заполнить формы или подготовить черновики документов, используй
скрипты engine/scripts/ и реестр полей knowledge_base/forms/registry.json.
Все значения — только из user/case-profile.json. Ничего не выдумываешь.
Если профиля ещё нет или он неполный — заполняй то, что можно, и помечай
остальное как [ТРЕБУЕТСЯ]. Не блокируй работу: черновик с пропусками полезнее
пустоты.
Механическая заливка форм (детерминированно)
python engine/scripts/fill_forms.py user/case-profile.json knowledge_base/forms/registry.json --out-dir user/drafts --allowed-root user
Создаёт user/drafts/<форма>.md (лист заполнения: поле → значение) и
user/drafts/drafts.json. Правила, которые гарантирует скрипт:
- значение поля = значение профиля по
profile_key;
- нет значения →
[ТРЕБУЕТСЯ: <поле>] (никогда не подставляется догадка);
- значения доменных полей (напр.
sexo) берутся как есть из профиля —
корректность проверит ревью (field-QA).
Сами официальные формы MI-T/MI-F заполняются человеком на sede по этому листу.
Листы — это «что вписать в каждое поле».
Неприменимые формы
В реестре у них стоит applies_when, поэтому fill_forms.py выводит их со
строкой ⏸️ не применяется, а field_qa.py не считает их [ТРЕБУЕТСЯ]
пропусками. Условие двух родов:
- этап —
EX-17, EX-17-familiar, tasa-790-012
(case.resolution_notified): относятся к этапу после одобрения;
- состав —
MI-F, EX-17-familiar (family.present): у
соло-заявителя семейной формы нет вовсе.
Разница важна в одном месте: форму этапа стоит назвать «пока рано», форму
состава — «к вашему кейсу не относится», иначе соло-заявитель будет ждать этап,
который для него не наступит.
Самопроверка черновиков (field_qa.py)
python engine/scripts/field_qa.py user/case-profile.json knowledge_base/forms/registry.json user/drafts/drafts.json --out-dir user/drafts --allowed-root user
Гарантии: вердикт на КАЖДОЕ поле реестра, корректность не правдоподобие,
контролируемые словари (ловит sexo=indefinido), галлюцинации (профиль пуст,
а в черновике значение → WRONG). Отчёт: user/drafts/field_qa_report.md.
Ненулевой выход = есть WRONG.
Текстовые документы из шаблонов (escritos, queja)
Для свободнотекстовых документов используй templates/:
templates/escrito_*.template.md, templates/queja_defensor.template.md —
подставь {{ПЛЕЙСХОЛДЕРЫ}} из профиля. Плейсхолдеры, которых нет в профиле
(например {{REGAGE_SOLICITUD}} до подачи) — оставь как [ТРЕБУЕТСЯ: …],
не выдумывай REGAGE/expediente.
Пиши результат в user/drafts/<имя>.md (frontmatter A4/2.5cm уже в шаблонах).
Контроль качества
Перед тем как считать черновики готовыми:
- Не осталось ли
{{...}}-плейсхолдеров (должны быть подставлены или помечены
[ТРЕБУЕТСЯ]).
- Все обязательные поля форм либо заполнены, либо явно
[ТРЕБУЕТСЯ].
- Никаких значений «от себя»: каждое значение прослеживается к профилю.
Это черновики, требующие независимой экспертной/официальной проверки.
