# Deployment Database Production — Penjualan

## Sebelum deployment

1. Buat backup database dan folder `uploads/accounting`.
2. Pastikan seluruh migration sampai `20260906001100` sudah diterapkan.
3. Rekonsiliasi invoice lama, jurnal penjualan, `stock_logs`, `inventory_ledger`, dan status barcode. Tandai khusus invoice legacy yang sudah pernah mengurangi stok.
4. Pastikan mapping akun Penjualan lengkap untuk setiap company.

## Migration

Jalankan berurutan:

- `20260907000100_finalize_sales_invoice_workflow`
- `20260907000200_complete_sales_document_metadata`
- `20260907000300_expand_sales_return_barcode_status`
- `20260907000400_scope_document_numbering_by_company`

Migration bersifat additive dan tidak menghapus kolom/tabel lama. `company_id`, metadata invoice, tabel Surat Jalan, relasi multi-barcode, sumber pembayaran, pengakuan pendapatan, dan retur akan ditambahkan. Enum barcode mempertahankan seluruh status Pembelian/Persediaan yang sudah ada dan menambah `quarantine` serta `damaged`.
Migration keempat mengganti unique index nomor dokumen global menjadi per-company dan membuat sequence atomik per perusahaan. Struktur data transaksi tidak dihapus.

## Setelah deployment

1. Jalankan `php index.php salescheck`.
2. Uji satu invoice Development: pilih barcode → post Surat Jalan → ajukan → approve/post → bayar dengan bukti.
3. Bandingkan saldo invoice dengan akun Piutang dan saldo inventory ledger dengan akun Persediaan/Persediaan Dalam Penjualan.
4. Verifikasi permission per role dan isolasi company.
5. Pastikan folder `uploads/accounting/sales` dapat ditulis PHP tetapi eksekusi script diblokir oleh konfigurasi web server.

## Rollback

Jangan menjalankan `down()` pada data transaksi aktif. Rollback yang aman adalah mengembalikan backup database dan source secara bersamaan. Dokumen yang sudah posted harus direversal melalui workflow, bukan dihapus manual.

## Data yang perlu direkonsiliasi

- Invoice lama tanpa `company_id` yang customer-nya ambigu.
- Invoice dengan `stock_posted_at` tetapi tidak mempunyai inventory ledger yang sepadan.
- Satu barcode legacy pada `invoice_details.barcode_id` yang belum tercermin pada relasi multi-barcode.
- Pembayaran lama tanpa `payment_sources` atau bukti pembayaran.
- Jurnal lama dengan keterangan atau `ref_type/ref_id` yang tidak lengkap.

## Tambahan deployment editor invoice

Terapkan migration `20260907000500_finalize_invoice_editor` setelah `20260907000400`. Migration additive ini menambah idempotency/version header invoice, tipe dan idempotency baris invoice, indeks daftar/detail/pengelompokan Surat Jalan Draft, serta permission `can_submit` pada role terkait.

Lanjutkan dengan `20260907000600_finalize_sales_payment_permissions` untuk memberi `can_post` penerimaan pelanggan kepada role Finance yang memang memiliki hak posting Kas/Bank, sekaligus menambah indeks riwayat pembayaran dan alokasi invoice.

Setelah migration:

1. Jalankan `php index.php salescheck`.
2. Minta pengguna logout/login agar snapshot permission session memuat `can_submit` terbaru.
3. Uji alur singkat: buat header, tambah satu barang atau jasa, post Surat Jalan bila barang, ajukan, approve/post otomatis, lalu bayar dengan bukti.
4. Jangan mengaktifkan kembali mutasi legacy `Invoices::save/add_item/delete_item/bayar`.