SYSTEM ARCHITECTURE & FEATURES

Built for Absolute Fairness, Stealth & Zero-Flake Reliability

Explore the core algorithms, protection mechanisms, and architectural decisions that make KovertKlaus the premier gift exchange platform.

🔗

Sattolo's Derangement Algorithm

Unlike naive shuffle methods or standard random pairing that can leave leftover participants or reveal chain patterns, KovertKlaus utilizes Sattolo's Algorithm to generate a single, uniformly random cyclic permutation.

  • ✓ Guaranteed 1-to-1 cyclic mapping (A₁ ➔ A₂ ➔ ... ➔ A♙ ➔ A₁)
  • ✓ Zero self-assignment probability
  • ✓ Optimized for groups of 4 or more — provides genuine secrecy, surprising pairings, and intelligent couple filtering without awkward 3-person spoilers
  • ✓ Zero chain predictability — knowing your assignment reveals zero mathematical clues about other pairs
🛡️

Demerit & Reliability Tier Protection

Traditional Secret Santas suffer from non-delivery flakes. KovertKlaus introduces an automated Demerit System to maintain high trust:

  • • 0-2 Demerits: ACTIVE (Full participation privileges)
  • • 3 Demerits: REMOTE_RESTRICTED (Limited to in-person local exchanges)
  • • >3 Demerits: DISABLED (Account suspended)
  • ✓ Carrier Protection Waiver: Submitting a valid carrier tracking number automatically waives penalties if packages are delayed by USPS, FedEx, or UPS.
⚡

Fast-Failover Product Scraper

Paste any store item link (Amazon, Target, MicroCenter, Etsy, etc.) into your wishlist. KovertKlaus automatically scrapes product title, thumbnail, price, and description.

Includes a 2.5s AbortController fast failover: if anti-bot protections block automatic metadata retrieval, a pre-filled manual entry modal instantly appears so you are never stuck waiting.

🎁

Local-Only White Elephant Rules

White Elephant and Yankee Swap exchanges are strictly restricted to local, in-person events (isLocalOnly = true). Digital White Elephant swaps are disabled to preserve authentic community interaction and stealing dynamics.

BUSINESS SOURCE LICENSE 1.1

100% Free Non-Commercial Self-Hosting

KovertKlaus is free for families, friend groups, non-profits, and home labs. On January 1, 2030, the codebase automatically transitions to GPLv3 open source forever.

Try Test Bench Simulation →