• Если у клиента нет паспорта (пустой passport) — спросить у пользователя серию/номер. Не подставлять «0000000», не оставлять пустым.
• Если нет МКК (mkk_number/mkk_date) — спросить, а не генерировать случайные.
• Если нет адреса — спросить (или использовать «🎲 бишкекский адрес» из справочника, но только с явного разрешения пользователя).
• Если нет подписи клиента в /assets/podpisi_CLIENTSпод ФИО — спросить, приложит ли пользователь. Не подставлять чужую подпись как «свою».
• Если нет даты одного из документов — рассчитать по правилам «Хронология дат» ниже и показать пользователю рассчитанные даты для подтвержденияперед генерацией.
• Если несколько сценариев одинаково валидны — предложить пользователю выбор через инструмент AskQuestion, а не выбирать самому.

Автоматически формируется бэкендом функцией _short_fio_ru() в app/core/generator.py из full_name, если поле пустое. Формат:

• Курманбеков Шамил Курманбекович → Курманбеков Ш. К.
• Эмилбек Уулу Шумкар → Эмилбек у. Ш.
• Мирлан кызы Бегайым → Мирлан к. Б.
• Калмаматов Расул (2 слова) → Калмаматов Р.
• Абыгазиев (1 слово) → Абыгазиев

Стандартный пакет для отправки — ровно 5 PDF + сообщение с ФИО в конце:

1. Кредитный договор (_scanned.pdf)
2. Заявка на конверсию (_scanned.pdf)
3. Кассовый ордер (_scanned.pdf)
4. Агентский договор без скана
5. Commercial Invoice без скана
6. → следом коротким сообщением: ФИО клиента

Если клиент делает ещё один перевод — не создавать новый пакет ине трогать оригинальный кредитный/агентский договор. Использовать кнопку «Новое поручение» в карточке пакета или API POST /api/packs/{pack_id}/rounds. Round-2 генерирует только: Поручение принципала, Акт-отчёт, Commercial Invoice. Даты нового раунда: не раньше, чем через 2–3 недели после акта предыдущего.

• credit_type: «целевой» (значение целевой) → шаблон work1.docx — договор на сельхозтехнику.
• credit_purpose: «сельхозтехника» — базовое значение по умолчанию, если пользователь не указал другое.
• Другой тип (обычный) → work1_target.docx — используем только если пользователь явно попросил «потребительский».

Перед отправкой в Telegram открыть сгенерированный кредитный PDF и визуально проверить последнюю страницу (реквизиты сторон):

• Паспорт ID <номер> — должен быть номер, не пусто
• Выдан МКК <номер> от <дата> г. — оба значения на месте
• Адрес регистрации: <полный адрес> — не только «г. Бишкек»
• Строка подписи заёмщика: <Фамилия И.О.>__________ — не пустая линия

А также в первом абзаце договора: «Эмилбек Уулу Шумкар (Паспорт ID 1012030, выдан МКК 214071 от 31.12.2018 г.), зарегистрированный по адресу:<полный адрес>». Если какое-либо значение пропущено — вернуться к созданию, спросить у пользователя, обновить БД, регенерировать.

• Кредит → Конверсия: строго +3…6 рабочих дней. Никогда не в тот же день. Если выпадает на сб/вс — сдвиг на понедельник.
• Конверсия → Кассовый ордер: обязательно +1 рабочий день. Кассовый ордер не может быть тем же днём, что и заявка на конверсию («конверсия в один день, снятие — на следующий»).
• Ордер → Инвойс поставщика: ориентир ~3–4 месяца — техника заказывается заранее.
• Инвойс → Агентский договор: ориентир ~3–6 недель. Агентский договор всегда после инвойса, не раньше.
• Агентский → Поручение принципала: обычно 3–10 дней. Поручение = момент, когда клиент даёт агенту распоряжение перевести RUB.
• Поручение → Акт-отчёт: 10–14 календарных дней — банковский процесс конверсии, отправки и подтверждения поставщика.
• Пересечение договоров запрещено: у одного клиента даты кредитного и агентского договоров не должны совпадать или идти «внахлёст» (агентский всегда сильно позже, минимум через несколько месяцев).
• Раунды (повторные поручения): следующий раунд поручения возможен не раньше, чем через 2–3 недели после акта предыдущего раунда.

• Если operation_date не задана — берётся contract_date + 3..6 рабочих дней (без сб/вс).
• Если cash_order_date не задана — берётся operation_date + 1 рабочий день (без сб/вс).
• Если transfer_date (агентский) не задана — берётся agency_contract_date + N дней (см. модуль agency.py).
• Если act_date не задана — считается от даты поручения по стандартному банковскому расписанию.
• Все сдвиги пропускают выходные (сб/вс). Праздники не учитываются — проверяй визуально.

• ФИОПолное имя. Если в справочнике «Подписи по клиентам» лежит PNG с этим именем — он автоматически возьмётся при выборе подписи «Рандом».
• ИНН (14 цифр)Реальный ИНН клиента. Кнопка рандома удалена намеренно — сюда только реальные данные.
• ПаспортСелектор ID/AN (90 px) + номер (7–8 цифр). Кнопка рандома удалена.
• Адрес🎲 подставит случайный бишкекский адрес (реальные улицы/микрорайоны из справочника).
• МКК: № / датаКем и когда выдан паспорт. Например: 600044 / 26.02.2022.

• Тип договораОбычный/Потребительский → шаблон work1_target.docx. Целевой (сельхозтехника) → work1.docx.
• № договора4-значный номер, генерируется рандомом (🎲) или вводится вручную. Полный номер формируется как ГО-<номер>-<год>-П/К.
• Дата договораДень подписания договора клиентом.
• Сумма (KGS)Сумма кредита в сомах. 🎲 подставляет между 8.5–10.0 млн ₽ округлённо.
• Цель кредитаВыбор из справочника /settings/purposes или свободный ввод. ⚙ рядом — открывает справочник.
• Срок (мес.)6, 12, 24, 48 и т.д. — от этого зависит дата окончания в договоре.

Один 7-значный суффикс → 3 счёта клиента (KGS, RUB, ссудный). Формат:1030162002XXXXXXX для KGS-счёта.

• Курс KGS/RUBКурс НБКР на дату операции. Кнопка «Курс НБКР» открывает официальный сайт на нужную дату.
• Дата операцииПусто = автоматически «дата договора + 1–3 рабочих дня». Кнопка «Курс на день» открывает НБКР на эту дату.

• Инициалы клиентаНапример «Ж. Кудайбердиева» — что будет напечатано в подписной линии. Если пусто — берётся из ФИО.
• Картинка подписиВыбор из общего пула. «Рандом» = если у клиента есть персональная (по ФИО), возьмётся она; иначе случайная из пула /assets/podpisi_ZAEMSHIK.

• Генерировать заявкуСоздать work3 (заявку на конверсию) + ордер в RUB.
• Делать ч/б сканыСоздать «_scanned.pdf» — визуально ксерокопии.
• Плоская схема имёнВсе файлы в одну папку с датой в имени. Иначе — вложенная структура.
• Сотрудники банка⚙ открывает справочник /settings/staff.

• Поиск — по ФИО, № договора, ИНН.
• Статус — Новый / В работе / Использован / Оплачен / Отменён.
• Банк — фильтр по банку-получателю из переводов.
• Переводы — только с переводами / только без.
• Период — пресеты (Сегодня, Вчера, 7 дней, 30 дней, Всё время) + выбор поля («по дате договора» или «по дате создания») + произвольные даты.

• КлиентФИО, кликается — переход в карточку. ⏳ = генерация в процессе. ✗ = ошибка (наведи для деталей).
• № договора4-значный номер из формы.
• ДатаДата договора.
• Сумма KGSОсновная сумма из формы.
• Переводы ₽Сумма всех переводов клиента + в скобках количество. Кликается на карточку.
• АудитСоотношение проверок (например 19/19).
• СтатусСелектор, меняется на месте — сохраняется автоматически.
• КомментарийИнлайн-редактирование, кнопка 💾 появляется при изменении.

• Чекбокс в шапке — выделить всё на текущей странице.
• Чекбокс в строке — выбрать конкретный пакет.
• Кнопка «Скачать выбранные (N)» — один ZIP с папками по каждому клиенту.

• ЗаголовокФИО клиента + № договора + дата + сумма KGS.
• Скачать ZIPВсе PDF пакета одним архивом.
• Изменить данныеОткрывает /generate?from=<id> с заполненной формой для правки и перегенерации.
• ПерегенерироватьПересобирает PDF без изменения данных. Удаляет старые файлы, аудит перезапускается.
• УдалитьПолностью удаляет пакет из БД и файловой системы.

Селектор статуса + свободный комментарий. Сохранение по кнопке «Сохранить» (пишется в аудит-журнал).

Учёт денежных переводов от клиента. Один клиент = много переводов.

• Форма добавления — Сумма ₽ / Банк / Дата / Заметка → «+ Добавить».
• Таблица — все переводы клиента, отсортированы по дате (новые сверху).
• Итого — сумма всех переводов внизу таблицы.
• Удаление — крестик в правой колонке (с подтверждением).
• Автообновление — суммы и статистика пересчитываются мгновенно.

Сводка ключевых полей пакета: ИНН, паспорт, тип кредита, цель, курс, сумма RUB, аудит, статус. Читаемая копия для просмотра.

Список PDF-файлов пакета с размером. По каждому файлу: — открыть в новой вкладке, — скачать.

• В списке /packs — колонка «Переводы ₽» с суммой и (кол-во).
• На главной — виджеты «Активность» суммируют переводы за период.
• На главной — «Топ банков» показывает разбивку сумм по банкам.
• Фильтр «Только с переводами / Без переводов» на /packs.
• Фильтр «Банк = ВТБ» и т.п. — тоже на /packs.

/settings/purposes — редактируемый список целей. Появляется в подсказках при вводе «Цель кредита» и в кнопке 🎲 (случайная цель).

/settings/staff — ФИО сотрудников с распределением по ролям:

• Контролер / Бухгалтер / Кассир — используются в кассовом ордере (work2).
• Операционное управление / Казначейство — в заявке на конверсию (work3).
• При генерации по каждой роли выбирается случайное ФИО из списка (без дублей).

/settings/signatures — 3 бакета PNG-файлов. Подробнее — ниже.

/settings/telegram — привязка вашего Telegram (chat_id) к учётной записи, чтобы отправлять PDF пакета одной кнопкой из карточки клиента. Инструкция по привязке — на самой странице.

1. Для клиента: сначала ищется PNG в «По клиентам» по ФИО. Если нет — случайная из «Пул заёмщиков».
2. Для сотрудников: подпись фамилии, выбранной по роли, ищется в «По сотрудникам». Если персональной нет — берётся случайная (уникальная в рамках документа) из того же бакета «По сотрудникам», не из пула заёмщиков.
3. Для штампа банка + подписи директора на стр. 10 договора — берётся случайная из /assets/shtampi и /assets/podpisi (общий пул).