Przejdź do treści
Biblioteka skilli
Programowanie · Integracja z narzędziem

data-mapping

/data-mapping

Tłumaczy między modelem danych zewnętrznej usługi a własnym, jawnie obsługując niezgodności, nulle i dryf enumów, przy integracji usługi o innym modelu.

Repozytorium
AI-SKILLS ↗
Licencja
MIT
Ostatnia zmiana repozytorium
05.09.2026

Ocena i bezpieczeństwo

90/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść25 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 05.09.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Tłumaczy między modelem danych zewnętrznej usługi a własnym, jawnie obsługując niezgodności, nulle i dryf enumów, przy integracji usługi o innym modelu.

Oryginalny opis (EN)

Translate between an external service's data model and your own, handling mismatches, nulls, and enum drift explicitly. Use when integrating a service whose model differs from yours.

Jak działa

  1. Method
  2. Boundaries
Sekcje z nagłówków SKILL.md, w oryginale · 35 linii, 237 słów
Podgląd SKILL.md
---
name: data-mapping
description: Translate between an external service's data model and your own, handling mismatches, nulls, and enum drift explicitly. Use when integrating a service whose model differs from yours.
---

# Data mapping

Two systems rarely agree on shape, naming, or what a field means. The
mapping layer is where those disagreements are resolved, and doing it
implicitly is how wrong data enters your system quietly.

## Method

1. **Map explicitly at the boundary.** One translation layer between
   their model and yours, so the rest of your code never sees their
   shape (see third-party-integration).
2. **Never store their identifiers as your primary keys.** Their
   identifier is a foreign reference, and coupling your keys to it makes
   provider migration nearly impossible.
3. **Handle unknown enum values without failing.** Providers add values,
   and a strict parser turns a routine provider change into an outage.
4. **Distinguish absent from null from empty.** These mean different
   things and providers use them inconsistently, so decide the mapping
   deliberately (see null-semantics).
5. **Validate on the way in.** Their data is untrusted input regardless
   of the provider's reputation (see input-validation).
6. **Record the raw payload alongside the mapped result.** When a
   mapping bug is found, the original is what allows reprocessing (see
   change-data-capture).
7. **Version the mapping.** Provider changes mean the mapping evolves,
   and knowing which version produced a record aids debugging.

## Boundaries

Mapping resolves structure, not semantics: two systems can both call
something status and mean unrelated things. Lossy mappings discard data
that a later requirement needs, which is why raw payloads are worth
keeping. Bidirectional sync multiplies the difficulty (see offline-sync).

Wersje

W bazie nie ma innych skilli o nazwie data-mapping.

Migawka bazy z 13.11.2026 · wersja paczki 43e3ff214faa (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100service-registry
    Rejestruje zewnętrzne usługi z kontrolami zdrowia, centralną konfiguracją i ujednoliconym wykonywaniem, przy integracji wielu usług wymagających koordynacji.
  • 100add-service
    Tworzy szkielet nowej integracji usługi: zewnętrzne API albo wielokrotnego użytku moduł domenowy z własną inicjalizacją i stanem.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.