Партнёрская платформа для процедуры банкротства

О заказчике

URITECH — компания, которая ведёт процедуры банкротства физических лиц через сеть партнёров-юристов в регионах. Партнёр приводит клиента (должника), URITECH сопровождает процедуру.

Главный технологический вызов: автоматизировать работу нескольких десятков партнёров с сотнями клиентов одновременно — с разной квалификацией партнёров, разной сложностью процедур, требованиями к compliance в юридической сфере.

Проблема

До запуска кабинета процессы шли в Google Sheets, мессенджерах и личной почте. Это работало на этапе 5–10 партнёров. На 50+ партнёрах система начала ломаться:

• Документы терялись. Каждая процедура — десятки документов с подписями. Партнёры присылали в WhatsApp, теряли, путали версии.
• Финансы считали вручную. Расчёт партнёрского вознаграждения, удержаний, остатков — Excel, ошибки, споры.
• Партнёры не знали статусов. Когда подавать следующий документ, что ждать от клиента — задавали вопросы куратору в чатах. Один куратор тонул в 200+ сообщений в день.
• Обучение новых партнёров — занимало 3–4 недели бесплатного куратора.

Что сделали

Полноценный кабинет с восемью связанными модулями:

Многоролевая модель

• Партнёр работает со своими клиентами.
• Куратор видит партнёров своего региона, помогает.
• Админ видит всё, управляет настройками, тарифами.
• Клиент (должник) — упрощённый кабинет, только свои документы и статусы.

JWT-аутентификация, role-based access на уровне сервисов, soft-delete для всех ключевых сущностей.

Статус-машина процедуры

Каждая процедура банкротства — это последовательность 30+ этапов с условиями перехода. Реализовали её как явную state machine на уровне сервиса: переходы валидируются, история сохраняется, прогресс виден на дашборде.

Финансы и расчёты

Расчёт партнёрского вознаграждения, удержаний, рассрочек, штрафов. Все формулы покрыты unit-тестами на 100% — ошибка в финансах = испорченные отношения с партнёром, поэтому здесь риск нулевой.

Генерация документов

Шаблоны DOCX в S3, заполнение через python-docx, версионирование. Партнёр выбирает шаблон, ассистент-сервис подставляет данные клиента, скачивает готовый файл. Все изменения шаблонов — через админку, без релизов кода.

Real-time чат с куратором

WebSocket-канал между партнёром и куратором по каждому клиенту. История пишется в Postgres, файлы — в S3. Это уменьшило нагрузку на куратора в 3 раза: вместо 200 разрозненных сообщений в день — 30 структурированных тредов.

Уведомления

Centralized notification service: email, push, in-app. Партнёр выбирает каналы. Triggered-уведомления (наступил срок документа) и event-driven (куратор ответил в чате).

Платежи

Интеграция YooKassa для приёма оплат от клиентов и переводов партнёрам. Поддержка СБП, рекуррентных платежей, разделение комиссий.

Обучение партнёров

Курс из 12 уроков с тестами. Без прохождения — ограничен функционал. Это сократило время онбординга нового партнёра с 3 недель до 5 дней.

Стек и инфраструктура

• Backend: Python 3.12, FastAPI 0.115, SQLAlchemy 2.0 (async), Alembic, Celery + Redis, structlog, slowapi (rate limiting), bcrypt + PyJWT (auth)
• Frontend: React 18, TypeScript, Vite, TanStack Query, Radix UI, Tailwind, Zustand, react-hook-form + Zod, Sentry
• Тесты: pytest + pytest-asyncio (backend), Vitest + Testing Library + Playwright (frontend, e2e)
• Хранилище: PostgreSQL (основная БД), Redis (Celery + кеш), S3 (файлы и бэкапы)
• Платежи: YooKassa SDK с поддержкой СБП

Что важно для бизнеса заказчика

• Соответствие 152-ФЗ (персональные данные) и 115-ФЗ (отмывание): отдельный аудит-лог по чувствительным операциям.
• DOCX, не PDF — у юристов привычка править документы, PDF неудобен.
• Soft delete везде — для юр. сферы ничего не должно «исчезать».
• Полное логирование действий пользователей — для разборов спорных ситуаций между партнёром и клиентом.

Что меняется для каждой роли

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

Партнёр-юрист. Кабинет закрывает весь цикл работы с должником: документы, статусы процедуры, расчёт вознаграждения, обучение. Генерация документов по шаблонам DOCX с автоподстановкой данных клиента экономит часы на каждой процедуре. Уведомления приходят туда, где юристу удобно — на почту, push или в кабинет, — а система сама напоминает о сроках подачи, из-за чего пропустить этап становится трудно.

Куратор партнёрской сети. Вместо потока сообщений в мессенджерах — структурированные треды по каждому клиенту, история в системе и файлы, которые не теряются. Это главный источник экономии: нагрузка на куратора падает без потери качества сопровождения, а значит сеть можно растить, не набирая кураторов пропорционально.

Операционный директор. Процедура идёт по статус-машине из 30+ этапов, поэтому в любой момент видно, какой документ и когда подавать. Встроенный курс обучения с тестами снимает с куратора значительную часть онбординга нового партнёра, а ограничение функционала до прохождения обучения удерживает качество сети при росте.

Клиент-должник. В личном кабинете видно, на каком этапе процедура, какие документы готовы и что требуется от него самого. Это снимает основную массу звонков юристу — не потому, что клиенту запретили звонить, а потому что вопрос закрывается до звонка.

IT-директор. Многоролевая модель, где партнёр, куратор, админ и должник видят только своё, плюс JWT-аутентификация, аудит-лог по чувствительным операциям и soft delete — базовый набор для юридической сферы с точки зрения 152-ФЗ. Финансовый модуль покрыт тестами: расчёт вознаграждений, удержаний и рассрочек — то место, где ошибка сразу превращается в спор с партнёром.

Ссылки

Технические детали и подробности — по запросу под NDA. Это рабочий продакшен-проект, развёрнутый на инфраструктуре заказчика.