dev-avatar-servicelisted

# Avatar service A service endpoint that returns a branded avatar for any user: photoreal, illustrated, or pixel, deterministic from a seed (user ID / email hash / initials). Built around a fallback hierarchy — real photo → upload → AI from initials → static default — with caching by seed so you pay once per user. ## When to Use - New user signup where you need an immediate profile image. - Comment systems or forums that default to gravatars. - Team pages, directories, leaderboards without uploaded photos. - Placeholder avatars during onboarding before the user picks one. - Branded alternative to Gravatar / UI Avatars / DiceBear. - Mock data for staging/demo environments. Not for: deepfaking real people from a single photo (wrong tool + wrong ethics), or stylizing an already-great uploaded photo — let users keep their own. ## Prerequisites Before building, ask (one message, 5 questions): 1. **Seed source**: user ID, email hash, username, initials? Is it stable forever? 2. **Style**: photoreal portrait, illustrated (Pixar/Disney-ish), flat vector, pixel art, claymorphic, monogram? 3. **Brand palette**: accent color for backgrounds + monogram fallbacks. 4. **Storage + cache**: S3/CDN + DB column, Picsart Drive URL, or KV key? TTL? 5. **Fallback chain**: photo → AI avatar → initials-on-color → default SVG? Order matters. Skip if the user hands over a detailed brief. ## How to Run 1. **Decide the fallback hierarchy first.** This is the whole service: ``` 1. user.p