Asturnaanta
Service-kan si ula kac ah ayuu u simple yahay, laakiin public avatar API wali wuxuu helaa qaar request data ah si uu u shaqeeyo. Page-kan wuxuu sharxayaa practical baseline-kaas.
Waxa Service-ku Helo
- opaque identifier aad ku geliso request, sida internal id, username, ama one-way hash
- request parameters sida avatar type, style options, size, format, iyo background
- standard HTTP metadata ay handle gareeyaan server, reverse proxy, iyo CDN, sida IP address, user agent, referrer, iyo request timing
Waxa App-ku Store Gareeyo
Application-ku ma baahna user accounts mana set gareeyo application cookies by default. Basic request flow, app-ku avatar on demand ayuu generate gareeyaa wuxuuna return gareeyaa si toos ah.
Haddii object storage support enabled yahay oo signed-link ama persistence route la isticmaalo, generated avatar file iyo object key waxaa lagu store gareyn karaa configured S3-compatible bucket.
Privacy-Preserving Telemetry
Haddii operator enable gareeyo telemetry, app-ku wuxuu emit gareeyaa aggregate OpenTelemetry metrics ee page views, visible page time, repository iyo crate clicks, demo actions, iyo avatar generation counts oo grouped ku ah bounded style choices sida kind, background, accessory, color, expression, shape, iyo size bucket.
Telemetry kuma jiraan raw identifiers, tenant ama style namespace values, IP addresses, user agents, referrers, full URLs, cookies, ama free-form text. Telemetry endpoints waxay aqbalaan allow-listed aggregate labels kaliya.
Logs Iyo Infrastructure
Iyadoo ku xiran deployment, infrastructure components sida nginx, Caddy, Cloudflare, hosting providers, ama S3-compatible storage waxay store gareyn karaan access logs iyo operational metadata. Logs-kan waa qayb ka mid ah socodsiinta public service waxayna ka koobnaan karaan requested identifier haddii uu ku jiro URL.
Waxa Fiican Inaan La Dirin
Email-shaped identifiers waxaa loo aqbalaa compatibility, laakiin URLs waxay ka muuqan karaan infrastructure logs. Dir stable internal id ama one-way application hash haddii aad rabto inaad ka fogaato personal data gudaha request URL.
Repository Iyo Crate
Waxaad implementation-ka ka eegi kartaa public API repository iyo reusable avatar renderer gudaha Rust crate. Repository · Rust Crate
Ogeysiis tarjumaad
Tarjumaadaha bogga waxaa caawiyay AI waxaana loo sameeyay dadaalka ugu fiican. Haddii aad aragto erayo u baahan hagaajin, wax ku biirinta GitHub waa la soo dhaweynayaa. Hagaaji tarjumaadaha