Інтеграція Productboard для пріоритизації фіч на сайті

Інтеграція Productboard для пріоритизації функцій

Productboard — інструмент управління продуктом: збір інсайтів з різних джерел, пріоритизація за допомогою фреймворків оцінювання (RICE, Value/Effort), побудова дорожної карти та надання публічних порталів для користувачів.

Вбудовування портала клієнта

Productboard надає публічний портал з голосуванням за функції. Він може бути вбудований через iframe або користувальницький домен:

<!-- Портал через iframe -->
<iframe
  src="https://portal.productboard.com/YOUR_TOKEN"
  frameborder="0"
  width="100%"
  height="800px">
</iframe>

Для SSO-ідентифікації користувачів використовуйте користувальницьку кнопку з JWT:

// ProductboardTokenController
public function token(): JsonResponse
{
    $user = auth()->user();

    $payload = [
        'iss'   => config('services.productboard.api_key'),
        'iat'   => time(),
        'exp'   => time() + 3600,
        'email' => $user->email,
        'name'  => $user->name,
    ];

    $token = \Firebase\JWT\JWT::encode($payload, config('services.productboard.secret'), 'HS256');

    return response()->json([
        'token'      => $token,
        'portal_url' => 'https://portal.productboard.com/YOUR_TOKEN?jwt=' . $token,
    ]);
}

REST API: Створення нотатки (інсайту)

class ProductboardService
{
    private const BASE = 'https://api.productboard.com';

    public function createNote(string $content, string $userEmail, array $tags = []): array
    {
        return Http::withToken(config('services.productboard.token'))
            ->withHeaders(['X-Version' => '1'])
            ->post(self::BASE . '/notes', [
                'title'   => substr($content, 0, 100),
                'content' => $content,
                'user'    => ['email' => $userEmail],
                'tags'    => array_map(fn($t) => ['name' => $t], $tags),
                'source'  => ['origin' => 'website_feedback'],
            ])
            ->json();
    }
}

// Автоматично створюємо нотатку при отриманні зворотного зв'язку
public function handleFeedback(FeedbackSubmitted $event): void
{
    $tags = [];
    if ($event->score <= 3) $tags[] = 'low-satisfaction';
    if (str_contains(strtolower($event->comment), 'повільн')) $tags[] = 'performance';

    app(ProductboardService::class)->createNote(
        $event->comment,
        $event->user->email,
        $tags
    );
}

Webhook для оновлення дорожної карти

Route::post('/webhooks/productboard', function (Request $request) {
    // Перевірка підпису
    $computed = hash_hmac('sha256', $request->getContent(), config('services.productboard.webhook_secret'));
    if (!hash_equals($computed, $request->header('X-Productboard-Signature'))) abort(401);

    $data = $request->json();

    if ($data['data']['type'] === 'feature.status.updated') {
        $feature = $data['data']['feature'];
        // Оновлюємо публічну дорожну карту на сайті
        Cache::forget('public_roadmap');
        Log::info("Функція оновлена: {$feature['name']} → {$feature['status']}");
    }

    return response('ok');
});

Терміни

Вбудовування портала клієнта, REST API для інсайтів нотаток та синхронізація webhook: 2 робочих дні.