Lewati ke isi

02 โ€” Kamus Data & Glosarium ("Batu Rosetta")

Dibaca oleh: semua orang. Ini dokumen paling penting untuk menjawab ketakutan utama: "saya takut hanya saya yang bisa baca".

Aturan pakai: setiap kali Anda melihat nama singkat di database lama yang tidak Anda mengerti, cari di sini dulu sebelum bertanya ke siapa pun.

Kamus ini juga menjadi jembatan penamaan: kolom kiri = nama lama (apa adanya di DB), kolom kanan = nama baru yang disepakati untuk skema PostgreSQL (Dokumen 03).


1. Singkatan Dasar (pola penamaan pembuat asli)

Pembuat memakai singkatan Bahasa Indonesia/Inggris campur. Polanya:

Singkatan Asal kata Arti
t transaksi header transaksi
d detail detail/baris transaksi
s stok stok realtime
j jurnal baris jurnal akuntansi
brg barang produk/item
ktk kontak pelanggan/supplier/pegawai
kd kode awalan "kode ..."
id id kunci numerik
no nomor awalan "nomor ..."
rek rekening akun (chart of accounts)
pc (per) cabang/klien kode klien
gol golongan klasifikasi barang
dk datakode master jenis transaksi
tr trigger awalan nama trigger
bi/bu/bd/ai/au/ad before/after insert/update/delete akhiran nama trigger
v_ view tabel virtual/laporan
temp_ / _temp temporary tabel kerja sementara
_draft draft transaksi belum final
_lite / mini ringan versi ringkas (cache/tampilan)
a_ (awalan prosedur internal) prosedur sistem/akuntansi

2. Kamus Tabel Inti (lama โ†’ baru)

Nama lama Arti sebenarnya Nama baru (usulan)
t Header semua transaksi transaksi
d Detail/baris semua transaksi transaksi_detail
datakode Master & konfigurasi jenis transaksi jenis_transaksi
s Stok realtime per barang per lokasi (cache) stok
fifo Lapisan persediaan masuk untuk HPP FIFO fifo_lapisan
fifokeluar Konsumsi lapisan FIFO saat barang keluar fifo_konsumsi
fifom Map keluar โ†’ hpp (audit FIFO) fifo_hpp_audit
j Buku besar / baris jurnal jurnal
kas Buku kas, piutang & hutang kas
brg Master barang barang
brggolongan Golongan barang โ†’ pemetaan akun jurnal barang_golongan
brgkategori/brgjenis/brgmerk/brgkelompok Klasifikasi barang barang_kategori/_jenis/_merk/_kelompok
brgsatuan Satuan & konversi barang barang_satuan
ktk Master kontak. Flag: c=customer, s=supplier, p=pegawai โ€” bisa lebih dari satu sekaligus (mis. pegawai yang juga supplier) โ†’ di skema baru jadi 3 boolean terpisah kontak
ktkalamat Alamat kontak kontak_alamat
ktkkontak Nomor kontak (telp/wa) kontak_telepon
ktktipe Tipe kontak kontak_tipe
rekening Bagan akun (Chart of Accounts) akun
lokasi Gudang/lokasi lokasi
devisi Dulu: pembeda multi-perusahaan dalam 1 DB (iddevisi di-hardcode). Baru: jadi cabang (sub-entitas dalam tenant) cabang (lihat Dokumen 08 ยง5)
klien Kode perangkat (kdpc) anti-bentrok nomor transaksi antar aplikasi dipensiunkan dari kunci โ†’ metadata sumber_perangkat (Dokumen 08 ยง1)
operator User login aplikasi (desktop). Mobile pakai inet login global pusat.pengguna (Dokumen 08 ยง3)
inet User login dari mobile (paralel dengan operator) dilebur ke pusat.pengguna
inet_tipe Tipe pengguna mobile: 0=None, 1=Sales, 2=Gudang, 3=Admin, 4=Direksi, 5=Customer, 6=Umum pusat.tipe_pengguna (kode: none/sales/gudang/admin/direksi/customer/umum)
v_inet UNION semua inet dari seluruh tenant (pusat, sparepart, leontech, dll.) sumber ETL pusat.pengguna โ€” dipakai saat onboarding user lama
wilayah_provinsi / wilayah_kabupaten / wilayah_kecamatan / wilayah_desa Referensi wilayah nasional pusat.wilayah_provinsi / pusat.wilayah_kabupaten / pusat.wilayah_kecamatan / pusat.wilayah_desa (terpusat, bukan per tenant)
harta / harta_penyusutan / hartagol Aset tetap & penyusutan aset / aset_penyusutan / aset_golongan
termin Termin pembayaran termin
harga Daftar tingkat harga jual (jual1..jual5) harga_tingkat
permintaan / permintaan_detail Permintaan barang permintaan / permintaan_detail
pesan / pesand Pemesanan (order) pesanan / pesanan_detail
t_po / t_pod Purchase Order po / po_detail
t_pr / t_prd Purchase Request pr / pr_detail
t_grn / t_grnd Goods Receipt Note (barang datang) penerimaan / penerimaan_detail
akseslaporan/aksesmenu Hak akses laporan/menu akses_laporan/akses_menu
error_log / a_log Log error / audit log_error / log_audit

Catatan: nama seperti barang*, kontak*, transaksilite, stoklite, v_* umumnya VIEW (jendela tampilan, sengaja dibuat, praktik baik) โ€” bukan tabel kembar. View tidak menyimpan data: tidak di-ETL, hanya definisinya ditulis ulang ke PostgreSQL bila masih dipakai. Tabel kerja (temp_*, *_draft, *_temp) = data sementara, tidak dimigrasi sebagai histori. Detail tabel-vs-view ada di Dokumen 01 ยง5.


3. Kamus Kolom โ€” Tabel t (header transaksi) โ†’ transaksi

Kolom paling sering dipakai (bukan semua 60 kolom โ€” sisanya jarang/khusus):

Kolom lama Arti Kolom baru
id ID transaksi (PK) id
notrans Nomor transaksi (kdpc.kdtrans.nobukti) nomor_transaksi (format baru: jenis.nobukti) + nomor_transaksi_lama
kdpc Kode perangkat (anti-bentrok lama) sumber_perangkat (metadata, bukan kunci)
kdtrans Jenis transaksi (FK datakode) jenis_kode
nobukti Nomor urut bukti per jenis nomor_bukti
tanggal Tanggal transaksi tanggal
idkontak Pelanggan/supplier (FK ktk) kontak_id
idpegawai Sales/pegawai (FK ktk) pegawai_id
idpengirim Pengirim (FK ktk) pengirim_id
idlokasi / idlokasi2 Lokasi (asal / tujuan utk pindah) lokasi_id / lokasi_tujuan_id
iddevisi Divisi (lama: pembeda multi-perusahaan, hardcode) cabang_id (Dokumen 08 ยง5)
nilai Subtotal sebelum diskon/biaya subtotal
diskon Diskon nota diskon
biaya Biaya tambahan biaya
pembulatan Pembulatan pembulatan
nilaitotal Total akhir total
bayar Dibayar saat transaksi dibayar
kredit Sisa belum dibayar (piutang/hutang) sisa_kredit
saldo Saldo berjalan saldo
potongnota Potongan nota potongan
pembayaran Akumulasi pelunasan total_pelunasan
hpp Total HPP transaksi hpp_total
qty Total kuantitas qty_total
tempo Jatuh tempo jatuh_tempo
termin Termin (FK termin) termin_kode
norek Akun lawan (FK rekening) akun_kode
rek_kas Akun kas/bank akun_kas_kode
rek_kredit Akun piutang/hutang akun_kredit_kode
jharga Tingkat harga dipakai (jual1..5) harga_tingkat_kode
operator User pembuat dibuat_oleh
status Status transaksi (FK trsts) status_id
keterangan / catatan Keterangan / catatan keterangan / catatan
cek Sinyal kontrol trigger (angka ajaib) dihapus, ganti kolom status eksplisit
created / dibuat / updated Waktu buat/ubah (campur) created_at / updated_at
idcabang / idgudang Cabang/gudang (tambahan baru) cabang_id / gudang_id

4. Kamus Kolom โ€” Tabel d (detail) โ†’ transaksi_detail

Kolom lama Arti Kolom baru
id PK string idtrans.idbarang (rapuh) id (BIGINT identity)
idtrans FK ke t.id transaksi_id
urut Nomor urut baris urut
idbarang FK ke brg.id barang_id
kode Kode barang (snapshot) barang_kode
qtynota Qty pada nota (satuan jual) qty_nota
idsatuan / satuan / isi Satuan & isi konversi satuan_id / satuan / isi_konversi
qty Qty dalam satuan dasar qty
mutasi Pergerakan stok bertanda (ยฑ qty) mutasi_stok
harga Harga satuan harga
hpp HPP satuan (hasil FIFO) hpp
diskon / diskonnota Diskon baris / alokasi diskon nota diskon / diskon_nota
jumlah harga ร— qty jumlah
total jumlah โˆ’ diskon total
idlokasi / idlokasi2 Lokasi asal / tujuan lokasi_id / lokasi_tujuan_id
refid / refidtrans / refnotrans Acuan ke detail/transaksi lain (retur, pelunasan) ref_detail_id / ref_transaksi_id / ref_nomor_transaksi
poin / poin2 Poin & rumus poin poin / poin_rumus
pesan / proses / terpakai / sisa / gagal Status pemenuhan (order/produksi) kolom status eksplisit (lihat Dokumen 03)
cek / dicek Sinyal kontrol trigger dihapus
created_date / updated_date / updated Waktu (campur) created_at / updated_at

5. Kamus Kolom โ€” Tabel datakode โ†’ jenis_transaksi

Ini "panel kendali" akuntansi. Pahami kolom ini = paham mesinnya.

Kolom lama Arti Kolom baru
kode Kode 3 huruf (PK), mis. PJ kode
nama / keterangan Nama & deskripsi nama / deskripsi
tipe / subtipe Klasifikasi (TRANSAKSI/KEUANGAN/...) kategori / sub_kategori
kasdebit Arah: 1 = kas di debit, else kredit kas_di_debit (boolean)
barangdebit Arah stok: 1 = barang masuk(+), else keluar(โˆ’) barang_di_debit (boolean)
hitungstok Apakah memengaruhi stok pengaruh_stok (boolean)
hpp / hppbeli Apakah hitung HPP / pakai harga beli hitung_hpp / hpp_dari_beli (boolean)
rek Akun utama akun_utama_kode
rekkredit Akun lawan (kredit) akun_kredit_kode
rekdiskon Akun diskon akun_diskon_kode
rekbiaya Akun biaya akun_biaya_kode
rekhpp Akun HPP akun_hpp_kode
rek_pembulatan Akun pembulatan akun_pembulatan_kode
master / detail Nama tabel master/detail (SQL-as-data) dihapus, diganti logika eksplisit
sql_biaya Potongan SQL disimpan sbg teks dihapus, jadi fungsi PL/pgSQL
hitungstok/lokasi/lap/sistem Flag perilaku kolom boolean bernama jelas

6. Glosarium Istilah Bisnis

Istilah Penjelasan
HPP Harga Pokok Penjualan โ€” biaya barang yang terjual
FIFO First In First Out โ€” barang yang masuk lebih dulu, dianggap keluar lebih dulu (untuk hitung HPP)
Lapisan FIFO Satu batch pembelian dengan harga tertentu; HPP barang keluar diambil dari lapisan tertua dulu
Mutasi Pergerakan stok bertanda: positif = masuk, negatif = keluar
Jurnal / Buku Besar Catatan akuntansi double-entry (setiap nilai punya pasangan debit & kredit yang seimbang)
Debit / Kredit Dua sisi pencatatan akuntansi; total debit harus selalu = total kredit per transaksi
Bagan Akun (CoA) Daftar akun akuntansi (kas, piutang, persediaan, dst.) โ€” tabel rekening
Posting Proses membuat baris jurnal dari sebuah transaksi
Nomor bukti (nobukti) Nomor urut dokumen per jenis transaksi
Nota Dokumen transaksi (faktur/kwitansi)
Opname Penyesuaian stok agar cocok dengan hitungan fisik
Pelunasan Pembayaran atas piutang/hutang yang sebelumnya tercatat
Tenant Satu klien/bidang usaha = satu schema tenant_<kode> di database erp (lihat Dokumen 04)
Trigger Kode yang otomatis jalan saat baris di-insert/update/delete
Tutup buku Proses akhir periode akuntansi (bulanan/tahunan)

7. Aturan Pemeliharaan Kamus Ini

  1. Kamus ini belum lengkap sampai Tindak Lanjut Dokumen 01 ยง7 selesai (arti cek, pembuktian tabel kanonik, inventaris prosedur). Lengkapi seiring temuan.
  2. Setiap penemuan arti kolom/tabel baru โ†’ langsung catat di sini, jangan di chat atau di kepala. Dokumen ini sumber kebenaran penamaan.
  3. Kolom "nama baru" di sini adalah kontrak dengan Dokumen 03. Jika berubah, ubah di kedua tempat.