Przejdź do treści
Biblioteka skilli
Programowanie · Budowanie i kod

indonesian-data-forms

/indonesian-data-forms

Pomaga budować formularze dla użytkowników z Indonezji: walidację NIK i NPWP, adresy administracyjne, numery telefonów i format rupii.

Licencja
MIT
Ostatnia zmiana repozytorium
08.11.2026

Ocena i bezpieczeństwo

100/ 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ść35 / 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
7
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 08.11.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

Pomaga budować formularze dla użytkowników z Indonezji: walidację NIK i NPWP, adresy administracyjne, numery telefonów i format rupii.

Wyzwalacze z opisu

validasi NIKvalidasi NPWPdropdown provinsiformat nomor HP Indonesiaongkir RajaOngkirformat Rupiahkode pos Indonesia
Oryginalny opis (EN)

Use when building forms, validation, or data handling for Indonesian users - wilayah administratif (provinsi/kota/kecamatan/kelurahan), NIK & NPWP validation, phone number formatting (+62), shipping cost (RajaOngkir, Biteship), and Rupiah currency. Triggers on "validasi NIK", "validasi NPWP", "dropdown provinsi", "format nomor HP Indonesia", "ongkir RajaOngkir", "format Rupiah", "kode pos Indonesia", "waktu Indonesia

Jak działa

  1. Overview
  2. When to Use
  3. Router
  4. Core Principles
  5. Workflow
  6. Anti-Patterns
  7. Verification
  8. References
  9. Related Skills
Sekcje z nagłówków SKILL.md, w oryginale · 104 linii, 842 słów
Podgląd SKILL.md
---
name: indonesian-data-forms
description: Use when building forms, validation, or data handling for Indonesian users - wilayah administratif (provinsi/kota/kecamatan/kelurahan), NIK & NPWP validation, phone number formatting (+62), shipping cost (RajaOngkir, Biteship), and Rupiah currency. Triggers on "validasi NIK", "validasi NPWP", "dropdown provinsi", "format nomor HP Indonesia", "ongkir RajaOngkir", "format Rupiah", "kode pos Indonesia", "waktu Indonesia"
---

# Indonesian Data & Forms

## Overview

Menangani data khas Indonesia di form dan API: wilayah administratif, validasi identitas (NIK/NPWP), nomor HP, ongkir, Rupiah, dan zona waktu. Prinsipnya: validasi dan normalisasi di boundary, simpan dalam bentuk canonical, format saat render.

## When to Use

- Form alamat dengan dropdown wilayah (provinsi → kelurahan): "dropdown provinsi", "kode pos Indonesia"
- Validasi NIK (KTP) atau NPWP (tax ID): "validasi NIK", "validasi NPWP"
- Normalisasi nomor HP Indonesia (+62, 08xx): "format nomor HP Indonesia"
- Integrasi ongkir (RajaOngkir, Biteship): "ongkir RajaOngkir"
- Format atau parsing Rupiah: "format Rupiah"
- Konversi waktu ke WIB/WITA/WIT: "waktu Indonesia"

**Jangan pakai kalau:** form internasional saja (tanpa data Indonesia), atau data sudah validated dan tersimpan canonical (cuma read).

## Router

| Topik / tugas | Berkas |
| --- | --- |
| Strategi & implementasi wilayah administratif (API, local dataset, seeded DB, cascading dropdown) | `references/wilayah-administratif.md` |
| Validasi NIK & NPWP, Zod schema, PII handling | `references/nik-npwp-validation.md` |
| Normalisasi & format nomor HP, WhatsApp link, landline | `references/phone-formatting.md` |
| Integrasi ongkir RajaOngkir/Biteship, abstraction, caching, berat volumetrik | `references/ongkir-integration.md` |
| Format & parsing Rupiah, PPN, diskon, storage integer | `references/rupiah-formatting.md` |
| WIB/WITA/WIT, UTC storage, cron timezone, business hours | `references/timezone-indonesia.md` |

## Core Principles

1. **Canonical form untuk storage.** Simpan nomor HP sebagai E.164, NIK/NPWP sebagai digit saja, dan uang sebagai integer rupiah. Format hanya saat render.

   ```typescript
   // Bad: Simpan as-is (formatted)
   db.user.phone = "+62 812-3456-7890"  // Inconsistent, hard to query
   db.user.nik = "3201 2345 6789 0001"  // With spaces

   // Good: Canonical form
   db.user.phone = "+6281234567890"     // E.164 format
   db.user.nik = "3201234567890001"     // 16 digits, no spaces
   db.user.amount = 100000              // Integer (in smallest unit), not string
   ```

2. **Validasi di boundary input.** Validasi ketat saat input — server-side juga, bukan cuma client — lalu percaya data internal.
3. **Jangan hardcode data wilayah.** Data wilayah berubah karena pemekaran; ambil dari dataset/API yang maintained dan refresh berkala.
4. **Uang tidak pernah float.** Rupiah praktis tanpa sub-unit; simpan integer dan bulatkan eksplisit.

## Workflow

Buka referensi sesuai Router, lalu ikuti langkah berikut:

1. **Wilayah:** pilih strategi (API vs local dataset vs seeded DB); rekomendasi local dataset BPS-based + refresh berkala; dropdown cascade harus reset child saat parent berubah. → detail: `references/wilayah-administratif.md`
2. **NIK:** cek 16 digit, parse DDMMYY (+40 untuk perempuan), validasi tanggal dan kode wilayah. → detail: `references/nik-npwp-validation.md`
3. **NPWP:** normalisasi ke digit; 15 digit legacy atau 16 digit NIK-based (sejak 2024). → detail: `references/nik-npwp-validation.md`
4. **Nomor HP:** normalisasi ke E.164, validasi prefix 8xx dan panjang, format saat display. → detail: `references/phone-formatting.md`
5. **Ongkir:** pakai interface `ShippingProvider` agar bisa switch RajaOngkir ↔ Biteship; cache hasil dengan TTL; hitung berat chargeable. → detail: `references/ongkir-integration.md`
6. **Rupiah:** simpan integer, format dengan `Intl.NumberFormat('id-ID')`, parse sadar separator `.` dan `,`. → detail: `references/rupiah-formatting.md`
7. **Waktu:** simpan UTC, tampilkan sesuai zona user, cron jobs eksplisit timezone. → detail: `references/timezone-indonesia.md`

## Anti-Patterns

- ❌ **Float untuk money** — pakai integer rupiah; decimal library hanya untuk pecahan.
- ❌ **Hardcode daftar wilayah** — pakai dataset/API yang maintained.
- ❌ **Simpan nomor HP dalam format tampilan** — query dan uniqueness jadi sulit.
- ❌ **Validasi hanya di client-side** — bisa di-bypass; validasi juga di server.
- ❌ **Kirim Rupiah sebagai string terformat di API** — kirim integer + `currency: "IDR"`.
- ❌ **Manual offset timezone** — pakai library atau `Intl`, bukan `+7 * 3600 * 1000`.
- ❌ **Hardcode ID destinasi ongkir** — ID berubah antar provider; cari dinamis.
- ❌ **Log NIK/NPWP mentah** — mask atau hash PII.

## Verification

- [ ] Wilayah data source maintained (API atau periodic update)
- [ ] NIK validation check struktur (16 digit, tanggal valid, kode wilayah)
- [ ] NPWP handle both 15 dan 16 digit formats
- [ ] Phone normalization ke E.164 (+62)
- [ ] Ongkir integration dengan provider abstraction
- [ ] Rupiah menggunakan integer (atau decimal library), bukan float
- [ ] Validation di server-side, bukan cuma client
- [ ] Timezone handling correct (WIB/WITA/WIT)
- [ ] Tests untuk edge cases (leap year, invalid date, etc)

## References

- `references/wilayah-administratif.md` — strategi data wilayah, API wilayah.id/emsifa, local dataset, seeding DB, refresh job, cascading dropdown, edge case pemekaran.
- `references/nik-npwp-validation.md` — struktur & algoritma NIK/NPWP, Zod schema, masking/enkripsi PII, testing.
- `references/phone-formatting.md` — normalisasi E.164, prefix operator, format display, WhatsApp link, landline.
- `references/ongkir-integration.md` — interface provider, implementasi RajaOngkir & Biteship, caching, berat volumetrik, API route.
- `references/rupiah-formatting.md` — format/parse Rupiah, compact format, PPN, diskon, storage BIGINT.
- `references/timezone-indonesia.md` — peta WIB/WITA/WIT, konversi UTC, cron, business hours, database.

## Related Skills

- `api-and-interface-design` — untuk design validation interface
- `security-and-hardening` — untuk PII data handling (NIK = sensitive)
- `performance-optimization` — untuk optimize wilayah data loading
- `data-resmi-indonesia` — data resmi & aturan berperiode Indonesia:
  - Hari libur nasional / cuti bersama / hari kerja
  - Kurs BI & JISDOR
  - UMP / upah minimum
  - Aturan pajak (PTKP, PPh 21 TER, PPN) & BPJS
  - Wilayah administratif, kode pos, NIK/NPWP, ongkir, Rupiah, timezone **tetap di skill ini**
Pliki w paczce (7)
  • SKILL.md 7 KB
  • references/nik-npwp-validation.md 13 KB
  • references/ongkir-integration.md 15 KB
  • references/phone-formatting.md 10 KB
  • references/rupiah-formatting.md 10 KB
  • references/timezone-indonesia.md 9 KB
  • references/wilayah-administratif.md 11 KB

Wersje

W bazie nie ma innych skilli o nazwie indonesian-data-forms.

Migawka bazy z 13.11.2026 · wersja paczki ada7097f19fe (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

  • 100admin-audit
    Zapisuje w dzienniku audytu zdarzenie spoza modelu i maskuje dane osobowe, np. NIK, NPWP, telefon, adres lub numer konta.
  • 86indonesia-data
    Podaje dane o Indonezji: trzęsienia ziemi i pogodę z BMKG, regiony, święta, dni robocze, formatowanie rupii i kody QRIS.
  • 100id-formation
    Doradza w zakładaniu i rejestracji firmy w Indonezji: PT, PT Perorangan, PT PMA, UD i CV, rejestracja OSS, NIB, KBLI i Positive Investment List.
  • 100notifikasi-indonesia
    Wysyła powiadomienia przez WhatsApp (Fonnte, Wablas, Meta Cloud API), Telegram lub e-mail SMTP dla użytkowników w Indonezji.

Uwagi i zgłoszenia

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