Harden vision vector search and embedding jobs.

Add point search, circuit-breaking, and safer gateway limits so artwork similarity lookups fail closed instead of hanging the request path.
This commit is contained in:
test
2026-09-20 14:49:19 +02:00
parent 455b514d50
commit 62aaa2f704
12 changed files with 903 additions and 64 deletions
@@ -21,15 +21,14 @@ it('persists a normalized embedding and upserts the artwork to the vector gatewa
config()->set('vision.vector_gateway.enabled', true);
config()->set('vision.vector_gateway.base_url', 'https://vision.local');
config()->set('vision.vector_gateway.api_key', 'test-key');
config()->set('vision.vector_gateway.upsert_file_endpoint', '/vectors/upsert/file');
config()->set('vision.vector_gateway.upsert_vector_endpoint', '/vectors/upsert/vector');
config()->set('cdn.files_url', 'https://files.local');
Http::fake([
'https://clip.local/embed' => Http::response([
'embedding' => [3.0, 4.0],
], 200),
'https://files.local/*' => Http::response('fake-image-bytes', 200),
'https://vision.local/vectors/upsert/file' => Http::response([
'https://vision.local/vectors/upsert/vector' => Http::response([
'status' => 'ok',
], 200),
]);
@@ -82,7 +81,7 @@ it('persists a normalized embedding and upserts the artwork to the vector gatewa
return str_contains($request->url(), 'vision.local/vectors/upsert');
});
Http::assertSentCount(3);
Http::assertSentCount(2);
});
it('keeps the local embedding when vector upsert fails', function () {
@@ -93,15 +92,14 @@ it('keeps the local embedding when vector upsert fails', function () {
config()->set('vision.vector_gateway.enabled', true);
config()->set('vision.vector_gateway.base_url', 'https://vision.local');
config()->set('vision.vector_gateway.api_key', 'test-key');
config()->set('vision.vector_gateway.upsert_file_endpoint', '/vectors/upsert/file');
config()->set('vision.vector_gateway.upsert_vector_endpoint', '/vectors/upsert/vector');
config()->set('cdn.files_url', 'https://files.local');
Http::fake([
'https://clip.local/embed' => Http::response([
'embedding' => [1.0, 2.0, 2.0],
], 200),
'https://files.local/*' => Http::response('fake-image-bytes', 200),
'https://vision.local/vectors/upsert/file' => Http::response([
'https://vision.local/vectors/upsert/vector' => Http::response([
'message' => 'gateway error',
], 500),
]);
@@ -122,5 +120,286 @@ it('keeps the local embedding when vector upsert fails', function () {
expect(ArtworkEmbedding::query()->where('artwork_id', $artwork->id)->exists())->toBeTrue()
->and($artwork->last_vector_indexed_at)->toBeNull();
Http::assertSentCount(3);
Http::assertSentCount(2);
});
it('reuses the stored embedding when vector indexing is retried', function () {
config()->set('recommendations.embedding.enabled', true);
config()->set('recommendations.embedding.endpoint', '/embed');
config()->set('recommendations.embedding.min_dim', 2);
config()->set('vision.clip.base_url', 'https://clip.local');
config()->set('vision.clip.api_key', 'clip-key');
config()->set('vision.vector_gateway.enabled', true);
config()->set('vision.vector_gateway.base_url', 'https://vision.local');
config()->set('vision.vector_gateway.api_key', 'test-key');
config()->set(
'vision.vector_gateway.upsert_vector_endpoint',
'/vectors/upsert/vector'
);
config()->set('cdn.files_url', 'https://files.local');
$clipCalls = 0;
$vectorCalls = 0;
Http::fake(function (
\Illuminate\Http\Client\Request $request
) use (&$clipCalls, &$vectorCalls) {
if (
$request->url()
=== 'https://clip.local/embed'
) {
$clipCalls++;
return Http::response([
'vector' => [3.0, 4.0],
], 200);
}
if (
$request->url()
=== 'https://vision.local/vectors/upsert/vector'
) {
$vectorCalls++;
if ($vectorCalls === 1) {
return Http::response([
'message' => 'temporary gateway error',
], 500);
}
return Http::response([
'id' => 123,
'collection' => 'images',
'dim' => 2,
], 200);
}
return Http::response([
'error' => 'unexpected request',
], 500);
});
$artwork = Artwork::factory()->create([
'hash' => '9988776655443322',
'thumb_ext' => 'webp',
'is_public' => true,
'is_approved' => true,
'published_at' => now()->subDay(),
]);
$first = new GenerateArtworkEmbeddingJob(
$artwork->id,
'9988776655443322'
);
app()->call([
$first,
'handle',
]);
$artwork->refresh();
expect(
ArtworkEmbedding::query()
->where('artwork_id', $artwork->id)
->exists()
)->toBeTrue()
->and($artwork->last_vector_indexed_at)
->toBeNull()
->and($clipCalls)
->toBe(1)
->and($vectorCalls)
->toBe(1);
$second = new GenerateArtworkEmbeddingJob(
$artwork->id,
'9988776655443322'
);
app()->call([
$second,
'handle',
]);
$artwork->refresh();
expect($artwork->last_vector_indexed_at)
->not->toBeNull()
->and($clipCalls)
->toBe(1)
->and($vectorCalls)
->toBe(2);
Http::assertSent(function (
\Illuminate\Http\Client\Request $request
): bool {
if (
$request->url()
!== 'https://vision.local/vectors/upsert/vector'
) {
return false;
}
$payload = $request->data();
return isset($payload['vector'])
&& count($payload['vector']) === 2
&& round(
(float) $payload['vector'][0],
4
) === 0.6
&& round(
(float) $payload['vector'][1],
4
) === 0.8;
});
});
it('recovers when the vector marker predates the stored embedding', function () {
config()->set('recommendations.embedding.enabled', true);
config()->set('recommendations.embedding.endpoint', '/embed');
config()->set('recommendations.embedding.min_dim', 2);
config()->set(
'vision.clip.base_url',
'https://clip.local'
);
config()->set(
'vision.clip.api_key',
'clip-key'
);
config()->set(
'vision.vector_gateway.enabled',
true
);
config()->set(
'vision.vector_gateway.base_url',
'https://vision.local'
);
config()->set(
'vision.vector_gateway.api_key',
'test-key'
);
config()->set(
'vision.vector_gateway.upsert_vector_endpoint',
'/vectors/upsert/vector'
);
$clipCalls = 0;
$vectorCalls = 0;
Http::fake(function (
\Illuminate\Http\Client\Request $request
) use (&$clipCalls, &$vectorCalls) {
if (
$request->url()
=== 'https://clip.local/embed'
) {
$clipCalls++;
return Http::response([
'vector' => [9.0, 9.0],
], 200);
}
if (
$request->url()
=== 'https://vision.local/vectors/upsert/vector'
) {
$vectorCalls++;
return Http::response([
'id' => 123,
'collection' => 'images',
'dim' => 2,
], 200);
}
return Http::response([
'error' => 'unexpected request',
], 500);
});
$oldMarker = now()->subMinutes(10);
$embeddingGeneratedAt = now()->subMinute();
$artwork = Artwork::factory()->create([
'hash' => 'aabbccddeeff00112233445566778899aabbccddeeff00112233445566778899',
'thumb_ext' => 'webp',
'is_public' => true,
'is_approved' => true,
'published_at' => now()->subDay(),
'last_vector_indexed_at' => $oldMarker,
]);
ArtworkEmbedding::query()->create([
'artwork_id' => $artwork->id,
'model' => 'clip',
'model_version' => 'v1',
'algo_version' => 'clip-cosine-v1',
'dim' => 2,
'embedding_json' => json_encode(
[0.6, 0.8],
JSON_THROW_ON_ERROR
),
'source_hash' => 'aabbccddeeff00112233445566778899aabbccddeeff00112233445566778899',
'is_normalized' => true,
'generated_at' => $embeddingGeneratedAt,
'meta' => ['source' => 'clip'],
]);
$job = new GenerateArtworkEmbeddingJob(
$artwork->id,
'aabbccddeeff00112233445566778899aabbccddeeff00112233445566778899'
);
app()->call([
$job,
'handle',
]);
$artwork->refresh();
expect($clipCalls)
->toBe(0)
->and($vectorCalls)
->toBe(1)
->and($artwork->last_vector_indexed_at)
->not->toBeNull()
->and(
$artwork->last_vector_indexed_at
->greaterThan($oldMarker)
)
->toBeTrue();
Http::assertSent(function (
\Illuminate\Http\Client\Request $request
): bool {
if (
$request->url()
!== 'https://vision.local/vectors/upsert/vector'
) {
return false;
}
$payload = $request->data();
return isset($payload['vector'])
&& count($payload['vector']) === 2
&& round(
(float) $payload['vector'][0],
4
) === 0.6
&& round(
(float) $payload['vector'][1],
4
) === 0.8;
});
});