ScoringService.php

• Pfad: src/Infrastructure/AI/ScoringService.php
• Namespace: Infrastructure\AI
• Zeilen: 83 | Größe: 2,509 Bytes
• Geändert: 2025-12-27 23:48:28 | Gescannt: 2025-12-31 10:22:15

Code Hygiene Score: 100

• Dependencies: 100 (25%)
• LOC: 100 (20%)
• Methods: 100 (20%)
• Secrets: 100 (15%)
• Classes: 100 (10%)
• Magic Numbers: 100 (10%)

Keine Issues gefunden.

Dependencies 2

• use DateTimeInterface
• use Domain\Constants

Klassen 1

• ScoringService class Zeile 18

Funktionen 3

• calculateScore() public Zeile 38
• calculateRecency() private Zeile 59
• getWeights() public Zeile 74

Verwendet von 4

• ChatService.php constructor
• ChatServiceProvider.php use
• StreamingChatMessageUseCase.php constructor
• StreamingChatMessageUseCase.php use

Versionen 2

• v2 2025-12-27 23:48 | claude-code-hook | modified
  Claude Code Pre-Hook Backup vor Edit-Operation
• v1 2025-12-27 23:47 | claude-code-hook | modified
  Claude Code Pre-Hook Backup vor Edit-Operation

Code

<?php

declare(strict_types=1);

namespace Infrastructure\AI;

// @responsibility: Berechnet gewichtete Scores aus Vector-Similarity, Recency und Authority

use DateTimeInterface;
use Domain\Constants;

/**
 * Calculates weighted scores for RAG search results.
 *
 * Combines vector similarity with recency and authority factors
 * to produce a more nuanced ranking of search results.
 */
final readonly class ScoringService
{
    /** Weight for vector similarity score (cosine) */
    private const WEIGHT_SIMILARITY = 0.7;

    /** Weight for document recency */
    private const WEIGHT_RECENCY = 0.1;

    /** Weight for source authority */
    private const WEIGHT_AUTHORITY = 0.2;

    /**
     * Calculate weighted score combining similarity, recency, and authority.
     *
     * @param float             $vectorScore    The cosine similarity score from vector search (0.0-1.0)
     * @param DateTimeInterface $documentDate   The document's processed/created date
     * @param float             $authorityScore The source authority score (0.0-1.0, default: 0.5)
     *
     * @return float The weighted score (0.0-1.0)
     */
    public function calculateScore(
        float $vectorScore,
        DateTimeInterface $documentDate,
        float $authorityScore = 0.5
    ): float {
        $recencyScore = $this->calculateRecency($documentDate);

        return (self::WEIGHT_SIMILARITY * $vectorScore)
             + (self::WEIGHT_RECENCY * $recencyScore)
             + (self::WEIGHT_AUTHORITY * $authorityScore);
    }

    /**
     * Calculate recency score based on document age.
     *
     * Returns 1.0 for today, linearly decreasing to 0.0 at 365 days old.
     *
     * @param DateTimeInterface $date The document date
     *
     * @return float Recency score (0.0-1.0)
     */
    private function calculateRecency(DateTimeInterface $date): float
    {
        $now = new \DateTime();
        $interval = $now->diff($date);
        $daysOld = $interval->days;

        // Documents older than 1 year get minimum recency score
        return max(0.0, 1.0 - ($daysOld / Constants::DAYS_PER_YEAR));
    }

    /**
     * Get the weight configuration for transparency.
     *
     * @return array{similarity: float, recency: float, authority: float}
     */
    public function getWeights(): array
    {
        return [
            'similarity' => self::WEIGHT_SIMILARITY,
            'recency' => self::WEIGHT_RECENCY,
            'authority' => self::WEIGHT_AUTHORITY,
        ];
    }
}