THE LABS GADGET — OWNER DASHBOARD / BUSINESS PULSE V1.9
======================================================

TUJUAN
- Naik taraf halaman Finance & HR > Overview supaya Owner boleh memantau
  Money In, Money Out, net cash flow, Bank/Cash/E-wallet, PV belum selesai,
  Account Payable, bil akan datang dan kehadiran staff hari ini.
- Paparan Day / Week / Month untuk angka Money In/Out, transaksi & kategori.
- Semua angka menggunakan database Finance HR yang ada, BUKAN data contoh.
- Tarikh opening balance 1 November 2026 dihormati. Jika belum bermula,
  baki akaun kekal kosong/0 mengikut logik sistem.

KESERASIAN
- Khas untuk pemasangan Finance HR dengan fail app/views.php V1.8 standard.
- HR Full Admin V1.8 mesti sudah dipasang.
- Updater akan BERHENTI sekiranya views.php tidak sepadan dengan checksum V1.8.
- Tidak reset database dan tidak ubah schema atau rekod kewangan.
- Hanya file app/views.php yang digantikan, dan assets/owner-dashboard.css ditambah.
- CSV, Payment Voucher PDF, GPS 150m dan Weekly Shifts kekal.

CARA INSTALL YANG SELAMAT
1. Backup database Finance melalui cPanel > phpMyAdmin > Export (SQL).
2. Backup folder financehub, terutama financehub/app/views.php.
   Jangan backup atau ubah database CRM yang lain untuk tujuan upgrade ini.
3. Masuk File Manager ke DOCUMENT ROOT bagi crm.thelabsgadget.com/financehub.
   Pastikan anda nampak index.php, app/ dan assets/ pada aras yang sama.
4. Upload ZIP V1.9 dan Extract di sini. Pastikan ada:
       financehub/upgrade_owner_v1_9.php
       financehub/patch_owner_v1_9/app/views.php
       financehub/patch_owner_v1_9/assets/owner-dashboard.css
5. Jangan copy manual fail di dalam patch_owner_v1_9/app kepada app asal.
6. Login Owner dan buka:
       https://crm.thelabsgadget.com/financehub/upgrade_owner_v1_9.php
7. Semak "Standard V1.8 views.php: OK" dan "Extracted V1.9 files: OK".
8. Klik "Install Owner Dashboard V1.9" sekali sahaja.
9. Buka Overview. Semak butang Day / Week / Month, angka dari ledger,
   Bank & Cash, PV Pending/Approved dan Today's Attendance.
10. Uji di telefon juga. Jika semua betul, padam upgrade_owner_v1_9.php
    dan folder patch_owner_v1_9 melalui File Manager.
    JANGAN delete folder app/ atau assets/ asal.

PENTING
- Balance ialah baki ledger Finance; bukan live bank balance daripada Maybank.
- Money In/Out termasuk transaksi POS hanya jika ia direkod/import ke Finance.
  Integrasi CRM/POS real time belum diaktifkan.
- PV Pending/Approved tidak dikira sebagai Money Out sehingga dibayar.
- Internal transfers tidak menambah Money In/Out.
- 30-day projection ialah anggaran kasar. Bil dan invois supplier boleh bertindih.
- GPS attendance belum berfungsi sehingga titik tengah kedai disahkan.
- Patch tidak mewujudkan transaksi kewangan atau memberitahu staff secara automatik.

CARA RESTORE JIKA DIPERLUKAN
- Updater membuat backup fail lama di dalam financehub/app/owner_v19_backup_.../
  Fail views_v18.php di situ boleh digunakan untuk pemulihan manual
  (selepas download dan backup fail terkini).
- Jika ingin pulih ke V1.8, copy views_v18.php kepada app/views.php
  dan padam assets/owner-dashboard.css (setelah disahkan tidak digunakan).
- Jangan ubah sebarang fail CRM asal.
- Jika updater tulis "files differ", JANGAN force overwrite.

Ujian sebelum diberi:
- PHP 8.4 lint pada fail PHP updater dan views.php: lulus.
- Smoke test HTML untuk Day/Week/Month dengan data simulasi: lulus.
- Semakan responsif untuk desktop 1440px dan mobile 430px: lulus.
- Belum diuji pada database sebenar hosting; backup dan pengesahan selepas
  install tetap diperlukan.
