Files
neural-hunt/V4.2.10_ADMIN_DROP_DIVERSITY_FIX.md
groot 47c523dd98
release-tag / release-image (push) Successful in 3m51s
RC-14
2026-08-14 06:17:30 +02:00

44 lines
1.7 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# V4.2.10 – Admin Drop Diversity Fix
## Problem
Admin-generated NFT gifts (`artifact_origin=admin_drop`) could end up visually too close to an already owned winning NFT. In practice this produced near-duplicate collectibles with the same visible theme (for example two very similar `Apex Racer` cards), which weakens the collector value.
## Root cause
The collection prompt already varied by task/winner/seed, but the visible trait selection was still narrow enough that an admin drop could collide with a previously owned card:
- the same high-level theme could be selected again,
- pose and atmosphere could also land close to an earlier card,
- the prompt did not strongly enough enforce cross-card distinctness.
This was not an admin queue problem anymore; it was a *collectible diversity* problem.
## Fix
The artifact generator now adds a collector-aware diversity pass for `admin_drop` items:
1. Before rendering an admin drop, the artifact worker loads up to 128 already-owned ready collectibles for the target owner.
2. Their visible collection traits are re-derived.
3. The new admin drop then deliberately prefers the **least-used** values for:
- theme
- pose
- atmosphere
- camera / staging
- palette story
- scene emphasis
4. The image prompt now includes stronger art-direction sections:
- `CAMERA / STAGING`
- `COLOR STORY`
- `SCENE EMPHASIS`
- `COLLECTOR UNIQUENESS REQUIREMENT`
This makes admin gifts much less likely to repeat a card the account already owns.
## Scope
Only the collection-artifact path changed. No database migration is required.
## Deployment
Rebuild only:
- `Dockerfile.server`
Customer-Service and Worker images do not need changes for this fix.