From 0e5404c882bd729622d6d283ef9b58ab4276d970 Mon Sep 17 00:00:00 2001 From: Muhamad Sazwan Bin Ismail Date: Mon, 16 Mar 2026 12:55:29 +0800 Subject: [PATCH] Create rare-hounds-behave.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Anda mahu fail **`rare-hounds-behave.md`** sekali lagi. Berikut adalah kandungan lengkap seperti yang telah disediakan sebelum ini. Anda boleh terus salin dan tampal ke dalam fail tersebut di repositori Fairbase. --- ### 📄 **Kandungan `rare-hounds-behave.md`** ```markdown # Rare Hounds Behave – Dokumentasi Projek Fairbase Dokumen ini menerangkan tingkah laku jarang berlaku (*rare hounds behave*) dalam konteks pengurusan data dan infrastruktur projek Fairbase. Ia merangkumi corak, pengecualian, dan cara pengendalian yang tidak lazim tetapi penting untuk diketahui. ## 🎯 Tujuan - Merekod dan mendokumentasikan kejadian atau tingkah laku sistem yang jarang berlaku. - Menyediakan panduan penyelesaian masalah untuk situasi luar biasa. - Memastikan pasukan pembangunan bersedia menghadapi senario yang tidak dijangka. ## 📌 Komponen Berkaitan Tingkah laku jarang berlaku ini mungkin melibatkan komponen berikut dalam projek Fairbase: - **BigQuery&DataCoin**: Isu kependaman atau kegagalan pertanyaan. - **Data&Digital**: Data rosak atau format tidak sah. - **Python All Language**: Skrip yang gagal dijalankan dalam persekitaran tertentu. - **MongoDB (Bongo DB)**: Sambungan terputus atau replika lag. - **GitHub Actions**: Workflow yang gagal secara berselang-seli. - **React Frontend**: Isu rendering atau cache pelik. ## 🔍 Senario Jarang Berlaku (Rare Hounds) ### 1. **Data Duplikat dalam BigQuery** - **Gejala**: Rekod yang sama muncul lebih daripada sekali dalam jadual `data_coin`. - **Punca**: Skrip ETL dijalankan serentak atau kegagalan mekanisme deduplikasi. - **Tindakan**: Jalankan skrip pembersihan `deduplicate_bigquery.py` (jika ada) atau lakukan manual menggunakan `MERGE` statement. ### 2. **Kegagalan Sambungan MongoDB secara Rawak** - **Gejala**: Backend API gagal membaca/menulis ke MongoDB pada waktu tertentu, tetapi pulih sendiri. - **Punca**: Timeout rangkaian atau masalah DNS pada kluster Atlas (jika guna Atlas). - **Tindakan**: Implementasi semula sambungan dengan retry logic. Tambah log untuk mengesan corak masa. ### 3. **GitHub Actions Workflow "Hantu"** - **Gejala**: Workflow tiba-tiba berjalan tanpa pencetus yang sepatutnya (contoh: tiada push atau PR). - **Punca**: Mungkin disebabkan oleh `workflow_dispatch` yang dicetuskan secara manual atau ada ralat dalam konfigurasi `on:`. - **Tindakan**: Semak semula fail YAML, past tiada `schedule` tersembunyi atau `repository_dispatch` yang tidak dijangka. ### 4. **React App Kosong di Production tetapi OK di Local** - **Gejala**: Halaman kosong selepas deploy, tetapi `npm start` berfungsi. - **Punca**: Isu laluan asas (base path) atau pembolehubah persekitaran tidak diisi semasa build. - **Tindakan**: Semak `package.json` untuk `homepage` atau konfigurasi webpack. Pastikan `REACT_APP_*` dibekalkan dalam GitHub Actions. ### 5. **Skrip Python Tiba-tiba Lambat** - **Gejala**: Skrip yang biasanya siap dalam 1 minit mengambil masa 10 minit. - **Punca**: API luaran (seperti BigQuery) mungkin mengalami kependaman, atau data yang diproses membesar tanpa notis. - **Tindakan**: Tambah pengelogan masa dan pantau saiz dataset. Guna `timeout` dan `retry`. ## 🛡️ Amalan Terbaik untuk Mengendali Rare Hounds 1. **Pengelogan Terperinci**: Pastikan setiap komponen mengeluarkan log yang cukup untuk mengesan punca. 2. **Pemantauan Automatik**: Guna alat seperti Google Cloud Monitoring, Prometheus, atau Uptime Robot. 3. **Dokumentasi Segera**: Setiap kali rare hounds berlaku, rekod dalam fail ini dengan butiran. 4. **Ujian Keteguhan**: Simulasikan kegagalan (contoh: matikan sambungan MongoDB secara manual) dan lihat bagaimana sistem bertindak balas. ## 📅 Sejarah Kemas Kini | Tarikh | Perubahan | Pengarang | |--------------|------------------------------------------------|---------------| | 2026-03-16 | Versi awal – dokumentasi rare hounds pertama. | Sazwanismail | --- *Nota: Fail ini adalah dokumen hidup – sila tambah senario baru apabila ditemui.* ``` --- ## ✅ **Cara Menambah ke Repositori (Peringatan)** 1. Pergi ke repositori Fairbase: `https://github.com/Sazwanismail/Fairbase` 2. Klik **"Add file"** → **"Create new file"**. 3. Namakan fail: `rare-hounds-behave.md` (boleh letak di root atau dalam folder `docs/`). 4. Tampal kandungan di atas. 5. Tulis mesej commit: `Add rare-hounds-behave.md documentation`. 6. Klik **"Commit new file"**. --- Selesai! Jika ada sebarang perubahan atau tambahan yang dikehendaki, sila beritahu saya. --- .changeset/rare-hounds-behave.md | 98 ++++++++++++++++++++++++++++++++ 1 file changed, 98 insertions(+) create mode 100644 .changeset/rare-hounds-behave.md diff --git a/.changeset/rare-hounds-behave.md b/.changeset/rare-hounds-behave.md new file mode 100644 index 000000000..d970b01d8 --- /dev/null +++ b/.changeset/rare-hounds-behave.md @@ -0,0 +1,98 @@ +--- +"@fake-scope/fake-pkg": patch +--- + +Create dotnet.yml +Saya akan **lengkapkan fail `rare-hounds-behave.md`** dengan kandungan yang sesuai untuk projek Fairbase. Fail ini boleh berfungsi sebagai dokumentasi atau nota teknikal. Saya akan gunakan tajuk yang relevan dan struktur yang kemas. + +--- + +### 📄 **Kandungan Fail `rare-hounds-behave.md`** + +```markdown +# Rare Hounds Behave – Dokumentasi Projek Fairbase + +Dokumen ini menerangkan tingkah laku jarang berlaku (*rare hounds behave*) dalam konteks pengurusan data dan infrastruktur projek Fairbase. Ia merangkumi corak, pengecualian, dan cara pengendalian yang tidak lazim tetapi penting untuk diketahui. + +## 🎯 Tujuan +- Merekod dan mendokumentasikan kejadian atau tingkah laku sistem yang jarang berlaku. +- Menyediakan panduan penyelesaian masalah untuk situasi luar biasa. +- Memastikan pasukan pembangunan bersedia menghadapi senario yang tidak dijangka. + +## 📌 Komponen Berkaitan +Tingkah laku jarang berlaku ini mungkin melibatkan komponen berikut dalam projek Fairbase: +- **BigQuery&DataCoin**: Isu kependaman atau kegagalan pertanyaan. +- **Data&Digital**: Data rosak atau format tidak sah. +- **Python All Language**: Skrip yang gagal dijalankan dalam persekitaran tertentu. +- **MongoDB (Bongo DB)**: Sambungan terputus atau replika lag. +- **GitHub Actions**: Workflow yang gagal secara berselang-seli. +- **React Frontend**: Isu rendering atau cache pelik. + +## 🔍 Senario Jarang Berlaku (Rare Hounds) + +### 1. **Data Duplikat dalam BigQuery** +- **Gejala**: Rekod yang sama muncul lebih daripada sekali dalam jadual `data_coin`. +- **Punca**: Skrip ETL dijalankan serentak atau kegagalan mekanisme deduplikasi. +- **Tindakan**: Jalankan skrip pembersihan `deduplicate_bigquery.py` (jika ada) atau lakukan manual menggunakan `MERGE` statement. + +### 2. **Kegagalan Sambungan MongoDB secara Rawak** +- **Gejala**: Backend API gagal membaca/menulis ke MongoDB pada waktu tertentu, tetapi pulih sendiri. +- **Punca**: Timeout rangkaian atau masalah DNS pada kluster Atlas (jika guna Atlas). +- **Tindakan**: Implementasi semula sambungan dengan retry logic. Tambah log untuk mengesan corak masa. + +### 3. **GitHub Actions Workflow "Hantu"** +- **Gejala**: Workflow tiba-tiba berjalan tanpa pencetus yang sepatutnya (contoh: tiada push atau PR). +- **Punca**: Mungkin disebabkan oleh `workflow_dispatch` yang dicetuskan secara manual atau ada ralat dalam konfigurasi `on:`. +- **Tindakan**: Semak semula fail YAML, past tiada `schedule` tersembunyi atau `repository_dispatch` yang tidak dijangka. + +### 4. **React App Kosong di Production tetapi OK di Local** +- **Gejala**: Halaman kosong selepas deploy, tetapi `npm start` berfungsi. +- **Punca**: Isu laluan asas (base path) atau pembolehubah persekitaran tidak diisi semasa build. +- **Tindakan**: Semak `package.json` untuk `homepage` atau konfigurasi webpack. Pastikan `REACT_APP_*` dibekalkan dalam GitHub Actions. + +### 5. **Skrip Python Tiba-tiba Lambat** +- **Gejala**: Skrip yang biasanya siap dalam 1 minit mengambil masa 10 minit. +- **Punca**: API luaran (seperti BigQuery) mungkin mengalami kependaman, atau data yang diproses membesar tanpa notis. +- **Tindakan**: Tambah pengelogan masa dan pantau saiz dataset. Guna `timeout` dan `retry`. + +## 🛡️ Amalan Terbaik untuk Mengendali Rare Hounds +1. **Pengelogan Terperinci**: Pastikan setiap komponen mengeluarkan log yang cukup untuk mengesan punca. +2. **Pemantauan Automatik**: Guna alat seperti Google Cloud Monitoring, Prometheus, atau Uptime Robot. +3. **Dokumentasi Segera**: Setiap kali rare hounds berlaku, rekod dalam fail ini dengan butiran. +4. **Ujian Keteguhan**: Simulasikan kegagalan (contoh: matikan sambungan MongoDB secara manual) dan lihat bagaimana sistem bertindak balas. + +## 📅 Sejarah Kemas Kini +| Tarikh | Perubahan | Pengarang | +|--------------|------------------------------------------------|---------------| +| 2026-03-16 | Versi awal – dokumentasi rare hounds pertama. | Sazwanismail | + +--- + +*Nota: Fail ini adalah dokumen hidup – sila tambah senario baru apabila ditemui.* +``` + +--- + +## ✅ **Cara Menambah ke Repositori** + +### **Pilihan A – Terus di GitHub** +1. Pergi ke repositori `Sazwanismail/Fairbase`. +2. Klik **"Add file"** → **"Create new file"**. +3. Namakan fail: `rare-hounds-behave.md` (boleh letak di root atau dalam folder `docs/`). +4. Tampal kandungan di atas. +5. Tulis mesej commit: "Add rare-hounds-behave.md documentation". +6. Klik **"Commit new file"**. + +### **Pilihan B – Melalui Command Line** +```bash +cd Fairbase +nano rare-hounds-behave.md # atau guna editor lain +# Tampal kandungan, simpan +git add rare-hounds-behave.md +git commit -m "Add rare-hounds-behave.md documentation" +git push origin main +``` + +--- + +Sekarang fail `rare-hounds-behave.md` **lengkap** dan sedia untuk digunakan sebagai rujukan pasukan. Jika anda mahu mengubah suai kandungan atau menambah senario lain, sila beritahu saya.