==================================================
  LKS GENERATOR SERVER (UNTUK MAC & LINUX)
==================================================

PANDUAN UNTUK macOS:
--------------------
1. Pastikan Python 3 sudah dipasang di Mac anda (dari https://www.python.org/downloads/ atau Homebrew: brew install python).
2. 'Double-click' fail: run_mac.command
   (Jika macOS sekat fail, buka Terminal, pergi ke folder ini dan taip:
    chmod +x run_mac.command
    ./run_mac.command )
3. Terminal akan buka dan automatik siapkan server.
4. Buka pelayar web (Safari / Chrome) dan layari:
   https://lks-generator-bumi.web.app

PANDUAN UNTUK LINUX (Ubuntu, Debian, Fedora, Arch, dll):
--------------------------------------------------------
1. Pastikan python3, python3-venv, dan python3-pip telah dipasang.
   Contoh di Ubuntu/Debian:
   sudo apt update ; sudo apt install python3 python3-venv python3-pip
2. Buka Terminal dalam folder ini dan jalankan:
   chmod +x run_linux.sh
   ./run_linux.sh
3. Buka pelayar web (Chrome / Firefox) dan layari:
   https://lks-generator-bumi.web.app

NOTA PENTING:
- Jangan tutup tetingkap Terminal semasa anda menjana laporan di laman web.
- Fail laporan Excel akan disimpan dalam folder Documents anda:
  Documents/LKS Dashboard/output
