Аудит маркетплейса PlanForge

Актуально на: 2026-05-26

Дата анализа: 15 апреля 2026
Проанализированы все файлы: страницы, API, компоненты, модели данных, уведомления, навигация

1. Текущая архитектура (что есть)

Модель данных

Страницы и навигация

API endpoints (13 шт.)

• Публичные: listings (GET), filters (GET), listing detail (GET)
• Покупка: purchase (POST)
• Продавец: my-listings (GET), listing details (GET), archive (POST), resubmit (POST), reviews history (GET)
• Ревьюер: очередь /api/reviews/plans (GET), заявка /api/plans/[id]/review (GET/PATCH — решение по публикации), пометки /api/plans/[id]/review/notes
• Покупатель: my-purchases (GET)

2. Детальный разбор механик: что работает и что нет

2.1. Публикация листинга

Поток: Страница проектов → иконка «Опубликовать» → /projects/[id]/publish → выбор типа/цены/превью-полей → POST /api/plans/[id]/listings → статус PENDING_REVIEW

Что работает:

• Выбор типа продажи (Копия / Эксклюзив)
• Ввод цены (валидация > 0 и <= 10 000 000)
• Выбор превью-полей (checkbox-и: название, компания, отрасль, регион, сценарий, срок)
• Проверка что у проекта нет активного листинга (race-safe через транзакцию)
• Проверка что пользователь — владелец проекта

Что НЕ работает / отсутствует:

• Нет описания листинга — продавец не может добавить свободный текст, рассказывающий о плане
• Нет предпросмотра — продавец не видит как его листинг будет выглядеть до отправки
• Нет проверки «пустого» плана ✅ — серверная + клиентская валидация: нельзя опубликовать план без продуктов, расходов и сотрудников
• Нет предупреждения для EXCLUSIVE_TRANSFER — при эксклюзиве продавец потеряет план, но на странице публикации нет яркого предупреждения о необратимости
• После публикации редирект на /projects ✅ — заменён на /my-listings
• Нет валидации минимальной цены на клиенте — можно ввести 0.01 RUB

2.2. Ревью листинга ✅ ПЕРЕВЕДЕНО НА ДВИЖОК РЕВЬЮ ПЛАНА

Поток: публикация (или правка описания/обложки/галереи одобренного листинга, или resubmit после отказа) открывает заявку PlanReviewRequest с kind = LISTING и ссылкой на листинг → ревьюер видит её в общей очереди /reviews → открывает сам проект в воркспейсе (read-only через canReviewProject) → оставляет пометки с привязкой к месту в плане → автор закрывает их → ревьюер завершает заявку решением APPROVE / REJECT, что и публикует листинг или возвращает его на доработку.

Что работает:

• Единая очередь: заявки на публикацию и планы «просто на разбор» в одном списке с фильтром по поводу
• Ревьюер работает в реальном плане: расчёты, графики, все разделы — а не readonly-выгрузка
• Пометки по разделам с якорем на элемент, снимком среза и диффом «что изменил автор»
• Коммерческая карточка листинга (цена, тип, тираж, обложка, галерея, previewFields) — в панели ревью
• Одобрение с незакрытыми пометками требует подтверждения (force)
• Отклонение требует причину — она уходит в rejectionComment и в уведомление автору
• История решений остаётся в ListingReview, её читают «Мои листинги»
• Отзыв заявки автором снимает листинг с публикации (архив); архивация листинга закрывает заявку

Что осталось:

1. Нет чеклиста / критериев ревью — ревьюер не имеет гайдлайнов, на что обращать внимание

2. PlanAccess REVIEW по-прежнему не используется — доступ ревьюера даёт canReviewProject (активная заявка + глобальная роль), а уровень REVIEW в PlanAccess и API /api/plans/[id]/reviewers живут отдельно и не привязаны к UI

3. Нет промежуточного статуса «нужны правки» — вместо него пометки: заявка остаётся IN_PROGRESS, пока автор их не закроет

2.3. Копирование проекта при покупке (COPY)

Поток: Покупатель нажимает «Купить» → подтверждение → POST /api/purchase/[listingId] → loadWorkspaceStateFromDb → создание нового проекта → saveWorkspaceStateToDb → ответ с projectId

Что работает:

• Атомарная транзакция для создания проекта, PlanAccess и Order
• Дубль-проверка внутри транзакции (перепроверка статуса)
• Защита от повторной покупки одной и той же копии
• Создание workspace для покупателя если его нет
• Имя проекта с суффиксом «(копия)»
• Откат при неудачном сохранении state

Что потенциально проблемно:

1. saveWorkspaceStateToDb выполняется ВНЕ транзакции — это осознанный выбор (save слишком тяжёлый для транзакции), но откат неатомарен:

   // Откатываем в единой транзакции, чтобы не оставлять сирот
   await prisma.$transaction([...]).catch(() => {});

   Если откат тоже упадёт — останутся Order и Project-сироты.

2. Не копируются настройки проекта — проверено, claim снят. loadWorkspaceStateFromDb загружает все данные (ProjectInfo, ProjectSettings, Products, Personnel, Expenses, Calendar), saveWorkspaceStateToDb их полностью сохраняет. Копирование данных — полное.

3. Нет уведомления покупателю ✅ — добавлено уведомление типа PLAN_PURCHASED для покупателя при COPY и EXCLUSIVE_TRANSFER.

4. Скопированный проект получает статус DRAFT — это ок, но нет объяснения для покупателя что это значит.

5. Нет «происхождения» — в скопированном проекте нигде не указано, что он был куплен на маркетплейсе, от какого продавца.

2.4. Эксклюзивная передача (EXCLUSIVE_TRANSFER)

Что работает:

• FOR UPDATE lock на строке листинга (race condition protection)
• Перенос проекта в workspace покупателя
• Seller получает NO_ACCESS
• Buyer получает OWNER
• Листинг переходит в статус SOLD
• Уведомление продавцу

Что проблемно:

1. Необратимость без предупреждения ✅ — добавлен заметный amber-баннер с иконкой ⚠️ на странице публикации при выборе EXCLUSIVE_TRANSFER
2. Продавец видит «Продан» но не знает кому — в /my-listings нет информации о покупателе
3. Нет проверки workspace переноса — ложный claim, удалён. Вся операция (PlanAccess, workspace transfer, статус SOLD, Order) выполняется внутри одной $transaction. Если любой шаг упадёт — откатится всё. Это сделано правильно.

2.5. Маркетплейс (каталог)

Что работает:

• Поиск (debounced)
• 6 фильтров: тип покупки, отрасль, регион, сценарий, мин/макс цена
• 4 варианта сортировки
• Серверная пагинация (12 на страницу)
• Индикатор «Ваш план» / «Куплено» на карточках
• Модалка с деталями по клику
• Сайдбар фильтров с мобильным toggle

Что НЕ работает / отсутствует:

1. previewFields игнорируются при показе — в API listings/[id]/route.ts (строка 55-70) превью формируется из всех полей ProjectInfo (title, company, industry, region, variant, scenario, durationMonths, startDate), а не из тех полей, которые продавец выбрал в previewFields. Продавец выбирает что показывать, но API это полностью игнорирует и показывает всё. previewFields используется только как fallback если ProjectInfo пуст:

   const previewData = Object.keys(richPreview).length > 0 ? richPreview : listing.previewFields;

2. Счётчик «Состав плана» виден только владельцу/покупателю — другие пользователи не видят даже количество продуктов/сотрудников/расходов. Это снижает привлекательность карточки.

3. Нет информации о дате публикации на карточке — createdAt не отображается.

4. Модалка vs отдельная страница рассинхронизированы:

   • ListingModal использует поля isOwner, isPurchased, purchasedProjectId
   • ListingDetailPage (/marketplace/[id]) использует accessLevel: "full" | "preview" — поле которого нет в API ответе
   • Отдельная страница листинга не показывает кнопки для владельца/покупателя (нет isOwner/isPurchased в типе)
   • Это мёртвый код: страница существует, но никуда не ведёт из основного UI

5. Нет пустого состояния с CTA — «Опубликуйте свой план или зайдите позже» но нет кнопки «Опубликовать»

2.6. Мои листинги (продавец)

Что работает:

• Таблица с колонками: название, статус, тип, цена, продажи, доход
• Статусные бейджи (PENDING_REVIEW, APPROVED, REJECTED, SOLD, ARCHIVED)
• Причина отклонения при REJECTED
• Архивирование (PENDING/APPROVED → ARCHIVED)
• Повторная отправка (REJECTED → PENDING_REVIEW) с изменением цены/типа/превью
• Модалка детальной информации (продукты, персонал, расходы, инвестиции)
• История ревью (inline)
• Пагинация

Что НЕ работает / отсутствует:

1. Нет редактирования активного листинга ✅ — добавлено изменение цены APPROVED листинга (без повторного ревью, с настраиваемым кулдауном)
2. Нет ссылки «Посмотреть в маркетплейсе» — для APPROVED листингов нет быстрого перехода на его страницу/модалку в маркетплейсе
3. Нет информации о покупателях — продавец видит «3 продажи», но не знает кто купил
4. Нет фильтрации по статусу — если листингов много, нельзя отфильтровать только активные/отклонённые
5. Модалка деталей не закрывается при навигации — query-параметр listing остаётся в URL

2.7. Мои покупки (покупатель)

Что работает:

• Таблица: название, продавец, тип, цена, дата, ссылка на проект
• Пагинация
• ✅ Поиск по названию плана и продавцу (debounced, серверный)
• ✅ Сортировка: по дате (новые/старые), по цене (↑/↓)
• ✅ Суммарная статистика: количество покупок и общая потраченная сумма
• ✅ Filter-aware empty state: «Ничего не найдено» + сброс фильтров

Что НЕ работает / отсутствует:

1. Скудный UI — это самая простая из всех страниц, просто таблица без фильтров, поиска, сортировки ✅
2. Нет статуса проекта — покупатель не видит состояние купленного проекта
3. Нет возможности оставить отзыв — нет CTA для обратной связи
4. Нет группировки — все покупки в одном плоском списке
5. Нет суммарной статистики — общая потраченная сумма, количество покупок ✅

2.8. Админ-панель маркетплейса

Что работает:

• 7 счётчиков: всего листингов, на ревью, активных, продано, всего продаж, сумма продаж, пользователей
• Auto-refresh каждые 5 секунд

Что НЕ работает / отсутствует:

1. Polling каждые 5 секунд — слишком агрессивно, лишняя нагрузка на БД
2. Нет списка листингов — админ видит только числа, не может просмотреть конкретные листинги, модерировать, удалять
3. Нет графиков/трендов — сколько продаж за неделю/месяц, динамика
4. Нет управления пользователями — нельзя заблокировать продавца, изменить роль
5. Нет логов действий — кто когда что одобрил/отклонил/купил

2.9. Уведомления

Что работает:

• Колокольчик в header
• Polling каждые 30 сек
• «Прочитать все»
• Относительное время (только что, N мин назад, N ч назад)
• Ссылки в уведомлениях

Что НЕ работает / отсутствует:

1. 4 типа уведомлений реализованы:

   • LISTING_APPROVED → продавцу (ссылка на /my-listings) ✅ ссылка исправлена
   • LISTING_REJECTED → продавцу (ссылка на /my-listings)
   • PLAN_SOLD → продавцу (ссылка на /my-listings)
   • PLAN_PURCHASED → покупателю (ссылка на /my-purchases) ✅ добавлено

2. Не реализованы уведомления:

   • Покупателю при покупке ✅
   • Ревьюерам о новых листингах
   • Продавцу о просмотрах
   • При изменении цены

3. Нет удаления отдельных уведомлений — только массовое «прочитать все»

4. Нет push-уведомлений — только polling

5. Ссылка в уведомлении LISTING_APPROVED ведёт на мёртвую страницу /marketplace/${listingId} — страница существует но не интегрирована в UI

3. Критические баги и рассинхронизации

3.1. previewFields полностью сломаны ✅ ИСПРАВЛЕНО

Продавец на странице /projects/[id]/publish выбирает checkbox-ами какие поля показывать (title, company, industry…). Эти настройки сохраняются в PlanListing.previewFields как JSON { title: true, industry: true }. Но API в /api/marketplace/listings/[id]/route.ts полностью игнорирует previewFields и всегда показывает ВСЕ заполненные поля из ProjectInfo. Теперь richPreview и project.info фильтруются по ключам из previewFields.

3.2. Отдельная страница листинга /marketplace/[id] рассинхронизирована ✅ ИСПРАВЛЕНО

Страница удалена как мёртвый код. Ссылка в уведомлении LISTING_APPROVED заменена на /my-listings.

3.3. Покупка COPY: дубль-проверка слишком строгая

const existingOrder = await tx.order.findFirst({
  where: { listingId: listing.id, buyerId, purchaseType: "COPY" },
});
if (existingOrder) throw new Error("DUPLICATE_COPY_PURCHASE");

Это значит что покупатель не может купить копию одного плана дважды. Для типа COPY это может быть нежелательно — зачем ограничивать? Если план обновился, покупатель может захотеть новую копию.

4. Создание листинга: нет нормальной точки входа

Единственный способ создать листинг — найти маленькую иконку IconUpload на карточке проекта в /projects. Всё. Больше нигде нет CTA «Продать» или «Создать листинг»:

• /marketplace (пустое состояние) ✅ — добавлена кнопка «Опубликовать план» → /projects
• /my-listings (пустое состояние) ✅ — добавлена кнопка «Опубликовать план» → /projects
• Header — нет кнопки «Продать» / «Создать листинг»
• Проект (workspace) — нет кнопки «Опубликовать» внутри самого редактора проекта

Пользователь, который хочет продать план, должен сам догадаться вернуться на страницу со списком проектов и найти мелкую иконку. Это критическая проблема discoverability — основной revenue-путь маркетплейса спрятан.

Что нужно:

• CTA «Продать план» на /marketplace и /my-listings (хотя бы в пустых состояниях)
• Кнопка «Опубликовать в маркетплейсе» внутри редактора проекта
• Возможно, кнопка «Продать» в header рядом с навигацией

5. Что отсутствует в UI полностью

6. Безопасность и надёжность

5.1. Email продавца виден всем ✅ ИСПРАВЛЕНО

seller.email отдаётся в API и отображается если нет имени. Убрано из публичных API, fallback на «Автор».

5.2. Нет rate limiting

Нет ограничения на API-запросы. Можно спамить покупками и т.д.

5.3. Нет кеширования фильтров

/api/marketplace/filters пересчитывает distinct-значения на каждый запрос.

5.4. Неатомарный откат копирования

saveWorkspaceStateToDb вне транзакции, откат может не сработать.

5.5. Нет audit log

Кто и когда что сделал — не логируется (кроме ListingReview).

7. Задачи по категориям сложности

Задачи из GitHub issues (#82-#90) помечены тегом GH#XX. Issue #82 (сайдбар с фильтрами) — уже реализован (marketplace-sidebar.tsx), можно закрыть.

🟢 Быстрые победы (1-2 часа каждая)

Минимальные изменения, максимальный эффект. Баги, однострочные фиксы, мелкие UI-доработки.

🟡 Средние задачи (3-6 часов каждая)

Новые UI-компоненты, расширение API, изменения в нескольких файлах.

🔴 Сложные задачи (1-3 дня каждая)

Новые модели данных, полноценные фичи, архитектурные изменения.

8. Что сделано хорошо

• Атомарные транзакции — покупка и передача прав через $transaction
• FOR UPDATE lock — защита от двойной покупки эксклюзива
• Debounce цены — фильтры по цене не спамят API
• Ролевая модель — USER / REVIEWER / ADMIN в навигации и API
• Уведомления с polling — рабочий notification bell с 30-сек обновлением
• Аналитика — трекинг всех ключевых событий воронки
• Модалка деталей для продавца — полная информация по проекту с аккордеонами
• Серверная пагинация — с настраиваемым pageSize и подсчётом total
• Мобильный toggle фильтров — сайдбар скрывается на маленьких экранах
• Повторная отправка — отклонённый листинг можно переподать с новыми параметрами