Свой шаблон дамовы ў Word: загрузка і пераменныя

Навошта свой шаблон

У кожнай школы свой тэкст дамовы — выверанны юрыстам, звыклы дырэктару, узгоднены з мясцовымі патрабаваннямі. Канструктар дакументаў дае загрузіць гэты ж ваш Word-файл у Drivli і аўтаматычна падстаўляць у яго дадзеныя вучня, дамовы і рэквізітаў школы пры кожным фарміраванні. Ніякіх сістэмных PDF з чужым тэкстам — толькі ваш бланк.

Як зрабіць свой шаблон

1. Адкрыйце ў Word вашу бягучую дамову аказання паслуг.
2. Знайдзіце месцы, дзе павінны быць «жывыя» дадзеныя (ФІО вучня, нумар дамовы, сума, рэквізіты школы) і замяніце іх на placeholder'ы ў двайных фігурных дужках:

ДОГОВОР № {{ contract.number }}
от {{ today }}

Автошкола «{{ school.name }}» (ИНН {{ school.inn }}, юридический адрес: {{ school.legal_address }}),
в лице директора {{ school.director_full_name }} (далее — Школа), и

{{ student.full_name }}, паспорт {{ student.passport }} (далее — Ученик),
заключили настоящий договор:

1. Стоимость обучения: {{ contract.total_rub }} ₽ ({{ contract.total_rub_words }}).

1. Захавайце як .docx (Файл → Захаваць як → Word Document).

Як загрузіць

1. У Drivli адкрыйце 📄 Дакументы у сайдбары (раздзел дырэктара).
2. Націсніце «Загрузіць новы шаблон» → выберыце файл, катэгорыю (Дамова / Згода / Заява / Квітанцыя / Дамова з інструктарам / Дамова з супрацоўнікам / Свабодны дакумент / Справаздача), назву.
3. Апцыянальна — адзначце «Зрабіць шаблонам па змаўчанні для гэтай катэгорыі».

Як выкарыстоўваць

Пасля загрузкі кнопка «📄 Сфарміраваць» з’яўляецца ў трох месцах:

• У /finance/contracts: форма «Новая дамова» мае абавязковы селектар шаблона. Пасля стварэння дамовы аўтаматычна спампоўваецца DOCX/PDF з падстаўленымі данымі.
• У /instructors і /employees: форма стварэння — апцыянальны селектар шаблона + поле «Нумар дамовы». Калі выбралі — пасля стварэння інструктара/супрацоўніка спампуецца дамова.
• У картцы вучня — кнопка «📄 Дакумент па шаблоне» фарміруе згоды, заявы, квітанцыі на канкрэтнага вучня.
• У /reports — секцыя «📄 Кастамныя справаздачы па шаблонах» з пікерам перыяду.

Даведнік пераменных

У кожнай катэгорыі даступныя розныя палі. У раздзеле «Дакументы» побач з катэгорыяй ёсць кнопка з яе назвай — адкрывае «Даведнік пераменных», дзе відаць увесь спіс з прыкладамі. Самыя частыя:

• Школа: {{ school.name }}, {{ school.legal_name }}, {{ school.inn }}, {{ school.ogrn }}, {{ school.legal_address }}, {{ school.license_number }}, {{ school.director_full_name }}, {{ school.phone }}
• Вучань: {{ student.full_name }}, {{ student.passport }}, {{ student.address }}, {{ student.category }}, {{ student.medical_cert_number }}
• Дамова: {{ contract.number }}, {{ contract.signed_on }}, {{ contract.total_rub }}, {{ contract.total_rub_words }} (сума прапісам), {{ contract.paid_rub }}, {{ contract.debt_rub }}
• Інструктар: {{ instructor.full_name }}, {{ instructor.categories }}, {{ instructor.hourly_rate_rub }}, {{ instructor.hourly_rate_words }}
• Супрацоўнік: {{ employee.full_name }}, {{ employee.email }}, {{ employee.role_label }} (на рускай)
• Сёння: {{ today }} (11.05.2026), {{ today_long }} (11 мая 2026 г.)

Цыклы для справаздач

У шаблонах катэгорыі «Справаздача» даступныя калекцыі з Jinja-цыкламі:

УЧЕНИКИ С ЗАДОЛЖЕННОСТЬЮ:
{% for s in students %}{% if s.debt_rub %}
  • {{ s.full_name }} ({{ s.category }}) — долг {{ s.debt_rub }} ₽
{% endif %}{% endfor %}

ИНСТРУКТОРЫ И ИХ ЧАСЫ ЗА ПЕРИОД:
{% for i in instructors %}
{{ loop.index }}. {{ i.full_name }} — {{ i.hours }} ч, к выплате {{ i.payout_rub }} ₽
{% endfor %}

Даступныя калекцыі: students, instructors, payments, lessons, плюс вынікі ў totals.* і перыяд period_from / period_to.

Ліміты па тарыфах

• Стандарт: 3 шаблоны
• Профи: 5 шаблонаў
• VIP: безліміт

Рэгулятарныя дакументы (журнал уліку ваджэння для ГИБДД, чэк-ліст Ростехнадзора) застаюцца сістэмнымі — школа іх не мяняе, каб не зламаць фармат, які чакае інспектар.

Калі нешта не падставілася

Самая частая прычына — памылка ў імені пераменнай. {{ stuent.full_name }} (без літары «d») не ўпадзе, але і не падставіцца. Drivli пры загрузцы шаблона валідуе толькі што файл адкрываецца як .docx; імёны пераменных ён правярае ў момант рэндэра. Калі ў шаблоне невядомая пераменная — убачыце 400 з дэталёвым паведамленнем «Невалідная пераменная ў шаблоне: …».