# PANDUAN INDUK AI & PELAN TINDAKAN SISTEM (AI MASTER CONTEXT & ROADMAP)
## PROJEK: NEXAFINANCE ADVISORY & AKADEMI PERAKAUNAN MALAYSIA

> **PANDUAN UNTUK MANA-MANA AI / LLM / PEMBANGUN SISTEM:**  
> Dokumen ini dicipta khas sebagai **Konteks Utama (Master System Prompt & Blueprint)**. Mana-mana AI (seperti Gemini, Claude, GPT, atau DeepSeek) yang membaca dokumen ini boleh **terus memahami keseluruhan visi perniagaan, struktur fail, formula perakaunan tempatan, dan menyambung kerja pembangunan tanpa sebarang kekeliruan.**

---

## 1. RINGKASAN EKOSISTEM PERNIAGAAN (BUSINESS OVERVIEW)

Perniagaan ini merangkumi **DUA CABANG UTAMA (TWO CORE BUSINESS UNITS)** yang saling menyokong antara satu sama lain:

```mermaid
graph TD
    A["NexaFinance Ecosystem (ROR Enterprise)"] --> B["CABANG 1: FIRMA PERUNDINGAN KEWANGAN PKS (B2B)"]
    A --> C["CABANG 2: AKADEMI CELIK AKAUN SPM (B2C EdTech)"]
    
    B --> B1["Tier 1: Starter SME (Template & Asas)"]
    B --> B2["Tier 2: Growth Sdn Bhd (Rescue & Management Accounts)"]
    B --> B3["Tier 3: Corporate Fractional CFO & Pre-Audit"]
    B --> B4["Free Tools Hub & E-Invois LHDN Validator"]
    
    C --> C1["Kelas Mingguan Online Tingkatan 4 & 5"]
    C --> C2["Bengkel Intensif Cuti Sekolah (Mastery A+)"]
    C --> C3["Personal Coaching 1-on-1 (Pemulihan Pelajar Lemah)"]
    C --> C4["Formula Visual 'ALBEK' Tanpa Hafal Buta"]
```

### Cabang 1: Firma Perundingan Senibina Kewangan, Perakaunan & Percukaian (B2B)
* **Konsep:** Bukan sekadar jurutaip data (data entry), tetapi **Arkitek Kewangan Luar (Outsourced Financial Architect & Fractional CFO)** untuk perniagaan Enterprise hingga Sdn Bhd.
* **Masalah Pasaran Yang Diselesaikan:**
  1. *Sales Juta, Duit Bank Kosong:* Menghentikan kebocoran tunai dan kos tersembunyi.
  2. *Akaun Kotak Kasut / Resit Pudar:* Membersihkan akaun tertunggak 1-3 tahun (Accounting Rescue).
  3. *Mandat E-Invois LHDN:* Menstrukturkan SOP kutipan data, B2C Consolidated, dan muat naik pukal Portal MyInvois.
  4. *Pinjaman Bank Ditolak:* Menstrukturkan penyata kewangan agar memenuhi pemarkahan kredit (DSR / Debt Service Ratio).
  5. *Penjimatan Cukai Sah:* Mengelakkan penalti CP204 (Seksyen 107C) dan memaksimumkan Elaun Modal serta Zakat Perniagaan.

### Cabang 2: Akademi Online Prinsip Perakaunan SPM (B2C EdTech)
* **Konsep:** Akademi bimbingan tuisyen dalam talian khusus untuk **pelajar sekolah menengah (Tingkatan 4 & 5 SPM) yang lemah atau gagal subjek Akaun**.
* **Kaedah Unik (USP):** Menggunakan **Formula Visual 'ALBEK'** (Aset, Liabiliti, Belanja, Ekuiti, Keuntungan) untuk menguasai Debit/Kredit tanpa hafal format buta.

---

## 2. TAKSONOMI & STRUKTUR FOLDER PROJEK

Semua fail projek telah disusun mengikut folder modular yang bersih:

```
Financial-business/
│
├── 00_AI_AND_SYSTEM_DOCS/                    <-- Panduan Master AI, Arkitektur & Prompt Sambungan
│   ├── AI_MASTER_CONTEXT_AND_ROADMAP.md      <-- [FAIL INI] Konteks Master untuk AI
│   ├── SYSTEM_ARCHITECTURE_AND_TAXONOMY.md   <-- Pemetaan teknologi & spesifikasi data
│   └── PROMPTS_FOR_FUTURE_AI_TASKS.md        <-- Template prompt sedia guna untuk tugasan seterusnya
│
├── 01_BUSINESS_PROPOSAL_AND_RESEARCH/        <-- Kertas Cadangan Rasmi & Kajian Pasaran
│   ├── business_proposal_financial_consulting.md   <-- Dokumen proposal lengkap (Markdown)
│   ├── business_proposal_financial_consulting.pdf  <-- Fail PDF rasmi sedia cetak / edar
│   ├── generate_pdf.py                             <-- Skrip ReportLab penjana PDF
│   └── market_research_scanner.py                  <-- Skrip kata kunci carian media sosial & inisiatif kerajaan
│
├── 02_MARKETING_AND_SALES_ENGINE/            <-- Skrip Pemasaran & Copywriting Berimpak Tinggi
│   ├── marketing_strategy_guide.md           <-- Strategi Funnel, Avatar Pelanggan & Metrik Penukaran
│   ├── whatsapp_copywriting.md               <-- Skrip mesej WhatsApp (Cold, Follow-up, CP204 Urgency, Banker)
│   ├── facebook_copywriting.md               <-- Iklan FB Ads, Post Edukasi Organik, Skrip Video TikTok/Reels
│   └── email_copywriting.md                  <-- B2B Cold Email, 4-Part Nurture Sequence & Tax Reminders
│
├── 03_WEBSITES_AND_WEB_APPS/                 <-- Platform Laman Web & Aplikasi Interaktif
│   ├── Website Main Financial/
│   │   ├── index.html                        <-- Laman web korporat utama (Landing Page + Diagnostik + Pakej)
│   │   └── tools_hub.html                    <-- Hub Web App Percuma (5 Kalkulator Cukai/Loan + Direktori Kerajaan)
│   └── Financial App/
│       └── index.html                        <-- Portal SaaS Pelanggan (Chart.js + E-Invois 55 Fields + Rescue Tracker)
│
├── 04_KELAS_ONLINE_AKAUN_MENENGAH/           <-- Cabang Pendidikan SPM (Tingkatan 4 & 5)
│   ├── pelan_perniagaan_kelas_akaun.md       <-- Model perniagaan tuisyen, yuran, unjuran kewangan
│   ├── modul_dan_kurikulum_spm.md            <-- Silibus penuh KSSM, Formula ALBEK, Pelarasan & 12-Minggu Fast Track
│   ├── marketing_dan_copywriting_kelas.md    <-- WhatsApp, FB Ads Ibu Bapa, TikTok Pelajar & Emel
│   └── sample_teaching_materials.md          <-- Nota Poket 1-Muka-Surat, 10 Analisis Urus Niaga & Latihan
│
└── README.md                                 <-- Navigasi Pantas & Peta Projek
```

---

## 3. LOGIK, PERATURAN & FORMULA UTAMA (MALAYSIAN FINANCIAL ENGINE RULES)

Mana-mana AI yang membina ciri tambahan perlu mematuhi logik perundangan kewangan dan percukaian Malaysia berikut:

### A. Kadar Cukai Syarikat PKS Malaysia 2026 (Sdn Bhd Berbayar Modal < RM2.5 Juta):
* **RM 150,000 Pertama:** Dikenakan kadar **15%**.
* **RM 150,001 hingga RM 600,000 (RM 450k seterusnya):** Dikenakan kadar **17%**.
* **Baki Melebihi RM 600,000:** Dikenakan kadar **24%**.

### B. Peraturan Penalti Anggaran Cukai CP204 (Seksyen 107C Akta Cukai Pendapatan 1967):
* Jika **Cukai Sebenar > Anggaran CP204** melebihi **30%**:
  $$\text{Amaun Terkurang Kena Penalti} = (\text{Cukai Sebenar} - \text{Anggaran CP204}) - (0.30 \times \text{Cukai Sebenar})$$
  $$\text{Penalti Automatik 10\%} = 0.10 \times \text{Amaun Terkurang Kena Penalti}$$

### C. Formula Skor Kelulusan Pinjaman Bank (Debt Service Ratio - DSR):
$$\text{DSR (\%)} = \frac{\text{Komitmen Ansuran Pinjaman Bulanan Sedia Ada} + \text{Ansuran Pinjaman Baharu}}{\text{Purata Untung Bersih Bulanan}} \times 100$$
* $\text{DSR} \le 60\%$: Zon Selamat (Peluang kelulusan bank tinggi).
* $\text{DSR} > 60\% - 70\%$: Zon Ketat (Memerlukan cagaran/penjamin atau pengukuhan untung bersih beraudit).

### D. Formula Sistem Catatan Bergu Visual (ALBEK) untuk Pelajar Sekolah:
* **Geng DEBIT (Rumah Asal):** **A** (Aset) dan **B** (Belanja). Bertambah $\rightarrow$ DEBIT, Berkurang $\rightarrow$ KREDIT.
* **Geng KREDIT (Rumah Asal):** **L** (Liabiliti), **E** (Ekuiti), **K** (Keuntungan/Hasil). Bertambah $\rightarrow$ KREDIT, Berkurang $\rightarrow$ DEBIT.

---

## 4. ARAHAN KEPADA AI UNTUK MENYAMBUNG KERJA (HOW TO CONTINUE WORK)

Jika pengguna meminta mana-mana AI meneruskan pembangunan projek ini, ikuti garis panduan berikut mengikut kategori tugas:

1. **Jika Menambah Fungsi Web / Kod Frontend:**
   * Semua laman web menggunakan **Tailwind CSS CDN** dan vanilla JavaScript interaktif.
   * Kekalkan reka bentuk bertaraf korporat dengan skema warna rasmi:
     - Primary Navy: `#0F172A` / `#1E3A8A`
     - Accent Teal: `#0D9488`
     - Emerald Green: `#059669`
     - Card Dark: `#1E293B`
   * Pastikan butang CTA sentiasa bersambung ke integrasi WhatsApp atau modal penukaran prospek.

2. **Jika Menambah Modul Backend / Pangkalan Data:**
   * Backend yang disyorkan: Node.js (Express / Fastify) atau Python (FastAPI).
   * Pangkalan data: PostgreSQL / Supabase / SQLite.
   * Model data utama yang diperlukan: `Users`, `Clients (SMEs)`, `Transactions`, `EInvoices`, `TaxReturns`, `Students`, `Enrollments`.

3. **Jika Menambah Kandungan Pemasaran & Iklan:**
   * Sentiasa fokus kepada **Masalah Sebenar (Pain Points)** usahawan Malaysia: E-Invois LHDN, Resit Pudar, Penyata Ditolak Bank, Duit Campur.
   * Gunakan laras bahasa Malaysia perniagaan kontemporari yang mesra, berwibawa, dan mudah difahami.

---

## 5. PELAN TINDAKAN MASA DEPAN (NEXT PHASES ROADMAP)

* [x] **Fasa 1: Kajian Pasaran, Proposal PDF, Copywriting & Web Prototaip** (Selesai).
* [ ] **Fasa 2: Integrasi Gerbang Pembayaran Tempatan (Payment Gateway):**
  - Sambungkan FPX / ToyyibPay / SenangPay / Stripe untuk langganan pakej tuisyen dan bayaran deposit konsultasi.
* [ ] **Fasa 3: Pembangunan API Backend Portal Pelanggan:**
  - Bina sistem log masuk pelanggan (Client Portal Authentication) untuk memuat naik dokumen PDF/resit ke Google Drive/S3 secara automatik.
* [ ] **Fasa 4: Bot Automasi WhatsApp (WhatsApp Business API):**
  - Pasang webhook untuk membalas mesej prospek secara automatik dan menjadualkan sesi Google Meet ke Google Calendar.