Rencana pengembangan grup tagihan (2/6): model data
Model data dibuat sekecil mungkin: dua tabel baru dan dua kolom tambahan. Semua perubahan bersifat menambah, sehingga kode lama tetap berjalan sebelum dan sesudah migrasi.
Kenapa bukan Owner->Lokasi
Tabel pelanggan sudah punya hierarki Owner->Lokasi warisan sistem lama, dan itu kandidat pertama yang diperiksa. Datanya di produksi berbicara lain: hierarki itu adalah akun orang, bukan kelompok tagihan.
- Satu akun staf memegang tiga bisnis yang tak berhubungan: kantor sendiri, satu mal, dan satu perusahaan energi.
- Satu pemilik perorangan memegang dua merek usaha yang ditagih terpisah.
- Satu akun memegang beberapa SPBU sekaligus.
Kalau angka uang dijumlah per owner, bisnis-bisnis berbeda itu langsung tercampur. Lokasi yang hendak dimasukkan ke grup tagihan juga harus "direbut" dari owner lamanya. Karena itu grup tagihan dibuat sebagai konsep sendiri, dan Owner->Lokasi tidak disentuh.
Tabel baru
grup_tagihan, satu baris per grup.| Kolom | Tipe | Aturan | Isi |
|---|---|---|---|
id | serial | kunci utama | nomor grup |
nama | text | wajib, tak boleh kosong | nama grup, awalnya nama dari Accurate |
dibuat_oleh | integer | rujukan ke pengguna | siapa yang membuat |
dibuat_at | timestamptz | bawaan sekarang | kapan dibuat |
grup_tagihan_anggota, satu baris per lokasi.| Kolom | Tipe | Aturan | Isi |
|---|---|---|---|
customer_id | integer | kunci utama, rujukan ke pelanggan | lokasi |
grup_id | integer | wajib, rujukan ke grup, berindeks | grup tempat lokasi bernaung |
oleh | integer | rujukan ke pengguna | siapa yang memasukkan |
at | timestamptz | bawaan sekarang | kapan dimasukkan |
alasan | text | - | tanda asal, misalnya kurasi #81 |
customer_id adalah cara basis data menjamin aturan "satu lokasi, maksimal satu grup". Aturan ini tidak bergantung pada kode yang selalu benar: dua jawaban bersamaan yang memasukkan lokasi yang sama ke dua grup, salah satunya pasti gagal.Kolom baru di jawaban kurasi
sumber_kurasi_jawaban.| Kolom | Tipe | Isi |
|---|---|---|
grup_id | integer, rujukan ke grup | grup yang dipakai jawaban ini |
anggota_baru | integer[], bawaan kosong | lokasi yang dimasukkan oleh jawaban ini, bukan yang sudah anggota sebelumnya |
anggota_baru adalah kunci pembatalan yang benar: hanya lokasi di daftar ini yang dikeluarkan saat jawaban dibatalkan.
- Daftar jawaban sah menjadi
pelanggan,grup,baru,bukan,catatan. - Aturan baru: jawaban
grupwajib punyagrup_id, dan jawaban lain tidak boleh punya. - Aturan lama tetap: jawaban
pelangganwajib punya pelanggan; jawabangruptidak mengisi kolom pelanggan.
Tautan nama luar tetap satu-ke-satu
manual.- Tabel tautan tak berubah bentuk, jadi pencocok harian, penyambung leads, dan semua pembaca lain tak perlu disentuh.
- Anggota terkecil dipilih supaya pasti, bukan bergantung urutan centang.
- Anggota mana pun yang dipakai tidak mengubah angka, karena layar uang menjumlah per grup (halaman 4).
Migrasi
20261005_grup_tagihan.sql sebelum kode baru dirilis.- Aman diulang:
CREATE ... IF NOT EXISTS,ADD COLUMN IF NOT EXISTS, danDROP CONSTRAINT IF EXISTSsebelum aturan dibuat ulang. - Tak mengubah satu baris pun yang sudah ada.
- Hak akses aplikasi pada tabel baru mengikuti hak bawaan skema; diperiksa sesudah migrasi.
- Tersimpan di repo bersama kodenya, sehingga riwayat skema terbaca di git.