NIK Checker Premium

Aplikasi CLI untuk memvalidasi dan menampilkan informasi lengkap dari Nomor Induk Kependudukan (NIK) KTP Indonesia. Pengguna memasukkan NIK, dan program menampilkan data kependudukan dalam format tabel.

Fitur

• Input interaktif: NIK 16 digit dimasukkan langsung melalui terminal.
• Validasi ketat: pemeriksaan panjang input, format digit, rentang bulan (01 sampai 12), serta validitas tanggal lahir (maksimal 31, aturan bulan 30 hari, Februari maksimal 29).
• Koreksi otomatis: apabila kode tanggal lebih besar dari 40, jenis kelamin ditetapkan perempuan dan tanggal lahir dikurangi 40.
• Lookup wilayah offline: kode provinsi, kabupaten/kota, kecamatan, dan kode pos diambil dari data.json.
• Output tabel ringkas: seluruh informasi kependudukan ditampilkan dalam format tabel yang terstruktur.

Struktur Proyek

nik-checker/
├── cmd/nik-checker/main.go      Titik masuk program
├── internal/
│   ├── data/loader.go           Pemuat dan pencari data wilayah
│   ├── nik/parser.go            Validasi dan parsing NIK
│   └── output/formatter.go      Render tabel (dan JSON opsional)
├── data.json                    Data wilayah lengkap
├── go.mod
├── go.sum
├── LICENSE
└── README.md

Instalasi

git clone https://github.com/andikaputradev/nik-checker.git
cd nik-checker
go build -o nik-checker ./cmd/nik-checker/

Penggunaan

Jalankan program, kemudian masukkan NIK saat diminta.

./nik-checker
Input NIK: 3273014106960002

Program akan menampilkan output sebagaimana contoh berikut.

Contoh Output

Input NIK: 3273014106960002
--------------------------------------------------
NIK                  : 3273014106960002
Tanggal Lahir        : 1/06/96
Jenis Kelamin        : PEREMPUAN
Provinsi             : JAWA BARAT
Kab/Kota             : KOTA BANDUNG
Kecamatan            : SUKASARI
Kode Pos             : 40151
Uniqcode             : 0002
--------------------------------------------------

Detail Teknis

Koreksi gender dan tanggal lahir Digit ke-7 dan ke-8 NIK merepresentasikan tanggal (DD). Apabila nilai DD lebih besar dari 40, jenis kelamin ditetapkan perempuan dan tanggal lahir sebenarnya dihitung sebagai DD dikurangi 40. Contoh: nilai 41 diinterpretasikan sebagai perempuan dengan tanggal lahir 1.

Validasi kalender Bulan harus berada pada rentang 01 sampai 12. Hari tidak boleh melebihi batas bulan terkait (April, Juni, September, dan November maksimal 30 hari; Februari maksimal 29 hari).

Lookup wilayah tanpa alokasi besar Data wilayah disimpan sebagai byte slice mentah. Pencarian menggunakan jsonparser.GetString tanpa membentuk map penuh, sehingga penggunaan memori tetap rendah.

Lisensi

Proyek ini dilisensikan di bawah MIT License. Data wilayah (data.json) bersumber dari data publik pemerintah Indonesia untuk keperluan edukasi.

Kontak

Dipersembahkan oleh Wahyu Andika Putra.