О проекте

Нить — платформа пошаговых инструкций с чек-листами. Люди проходят инструкции шаг за шагом, а авторы видят, на каком шаге их бросают, и исправляют именно его.

Как это работает

Найти
Поиск понимает запрос своими словами, прощает опечатки и сортирует по полезности.
Пройти
Один шаг на экране, чек-лист к каждому шагу, прогресс сохраняется.
Помочь
«Полезно / не полезно», советы к шагу, кнопка «Застрял», правка или форк.
Улучшить
Автор видит воронку по шагам, исправляет проблемные места и сравнивает версии.

Индекс проблемного шага

Каждому шагу считается число от 0 до 100. От 25 шаг помечается, от 45 — считается узким местом.

50%
Доля бросивших на шаге среди дошедших до него
20%
Во сколько раз медианное время больше заявленного
15%
Доля оценок «не полезно»
15%
Как часто нажимают «Застрял»

Поиск

  • Морфология — полнотекстовый поиск PostgreSQL: «справки» находит «справку»
  • Опечатки — триграммы pg_trgm по названию и тегам
  • Смысл — эмбеддинги ru-en-RoSBERTa в pgvector: «не включается комп после сборки» находит сборку ПК

Три списка результатов объединяются через Reciprocal Rank Fusion. Если эмбеддинги недоступны, поиск работает на первых двух.

Совместная работа

Версии
Публикация создаёт неизменяемую версию, прохождения привязаны к ней, поэтому видно, помогла ли правка.
Форки
Можно сделать свою версию чужой инструкции. Шаги сохраняют ключи, форк и оригинал сравниваются.
Правки
Читатель предлагает новую редакцию шага, автор смотрит «было / стало» и принимает в черновик.
Эксперты
Проверяют инструкции в своих категориях. Проверенные получают отметку.

ИИ

Работает на GigaChat. Что умеет:

  • черновик инструкции по теме или из готового текста
  • улучшение шага: проще, подробнее, с чек-листом
  • проверка полноты: пропущенные шаги и неясные места
  • разбор проблемного шага по метрикам и комментариям
  • подсказка, когда человек нажал «Застрял»

Ещё

  • Офлайн — инструкцию можно сохранить и пройти без сети, события отправятся позже
  • PDF — печатная версия с чек-листами и QR-кодом на онлайн-версию
  • Встраивание — виджет через iframe для сайта кафедры или блога

Стек

Фронтенд
Nuxt 4, Vue 3, Tailwind v4, shadcn-vue, Pinia, TipTap, PWA
Бэкенд
FastAPI, SQLAlchemy 2, Alembic, Pydantic
Данные
PostgreSQL 17, pgvector, pg_trgm, S3
ИИ
GigaChat-2-Max (Сбер): ответ в JSON по шаблону, проверка Pydantic. Эмбеддинги — ai-forever/ru-en-RoSBERTa локально