Skip to content

docs: ilustracje w README (hero, pokrycie, scoring) - #26

Merged
woladi merged 1 commit into
masterfrom
woladi/readme-illustrations
Aug 25, 2026
Merged

woladi merged 1 commit into
masterfrom
woladi/readme-illustrations

Conversation

@woladi

@woladi woladi commented Aug 25, 2026

Copy link
Copy Markdown
Owner

Summary

Trzy neonowe diagramy w stylu macos-vision-mcp, wygenerowane Gemini 3 Pro Image:

  • hero — PESEL, NIP i IBAN w umowie przechodzą przez lokalne maskowanie, wychodzą jako tokeny [PESEL:1], lecą do chmury i wracają odtworzone
  • coverage — 46 rozpoznawaczy w podziale na PL / UE / US, z zaznaczeniem 24, które weryfikują realną cyfrę kontrolną
  • scoring — gołe cyfry 0.15, to samo trafienie ze słowem kontekstowym 0.50, z sumą kontrolną 0.85, na tle trzech progów --sensitivity

Panel pokrycia jest zgodny z rejestrem reguł: dowód, paszport i księga wieczysta mają znaczek sumy kontrolnej, a KRS, SSN, ITIN i EIN go nie mają — SSN waliduje zakresy, nie cyfrę kontrolną, a pozostałe trzy nie mają żadnej. Pierwszą wersję panelu wygenerowałem z błędnym zestawem znaczków i powtórzyłem generację.

Przy okazji: pierwszy bullet w „What you get" nadal reklamował pokrycie sprzed 0.8 (dwa języki).

Test plan

  • Obrazy obejrzane po wygenerowaniu — tekst czytelny, bez artefaktów, polskie znaki w „DOWÓD" i „KSIĘGA WIECZYSTA" poprawne
  • 1200 px szerokości, JPG, łącznie 632 kB (hero.jpg w macos-vision-mcp ma 248 kB)
  • .github/assets/ poza files w package.json — tak samo jak w macos-vision-mcp; npm rozwiązuje ścieżki względne po polu repository, więc tarball zostaje mały

🤖 Generated with Claude Code

Three neon diagrams in the house style of macos-vision-mcp, generated with
Gemini 3 Pro Image:

- hero: PESEL, NIP and IBAN in a contract going through local masking, leaving
  as [PESEL:1]-style tokens, reaching the cloud, and coming back restored
- coverage: the 46 recognizers by region, marking which 24 verify a check digit
- scoring: bare digits at 0.15, a context word lifting the same match to 0.50,
  a passing checksum to 0.85, against the three sensitivity thresholds

The coverage panel is drawn from the registry, so it names dowód, paszport and
księga wieczysta as checksum-verified and leaves KRS, SSN, ITIN and EIN
unmarked — SSN validates ranges rather than a check digit, and the other three
have none.

Also updates the opening bullet, which still advertised the pre-0.8 coverage of
two languages.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@woladi
woladi merged commit 68f1e18 into master Aug 25, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant