Manual pengguna KalendarKeluarga
Semua yang anda perlu tahu untuk menyediakan dan menggunakan kalendar keluarga. Pilih bahagian yang sesuai dengan anda.
Kandungan
Tiada bahagian yang sepadan. Cuba perkataan lain.
Pengenalan
KalendarKeluarga mengumpul jadual kerja, syif dan sekolah setiap ahli keluarga dalam satu kalendar, kemudian menunjukkan hari yang semua orang cuti.
Dua jenis pengguna
| Pengguna | Apa yang mereka buat | Log masuk |
|---|---|---|
| Pentadbir keluarga | Mendaftar keluarga sekali sahaja, menyambung Firebase dan Google AI, kemudian menjemput ahli. | Emel dan kata laluan di /masuk, untuk panel pentadbir |
| Ahli keluarga | Melihat dan mengemas kini kalendar, acara dan jadual. | Akaun Google di alamat keluarga /f/nickname/ |
Istilah penting
- Nickname keluarga: nama pendek yang menjadi alamat kalendar, contohnya
/f/keluarga-rahman/. - Kod jemputan: 6 aksara (contohnya
K7QM2P) yang diperlukan untuk menyertai keluarga kali pertama. - Ahli (dalam kalendar): orang yang jadualnya dipaparkan, contohnya Ayah, Ibu, Adik. Seorang ahli tidak semestinya ada akaun.
- Akaun: akaun Google yang log masuk ke kalendar. Akaun boleh dipautkan kepada seorang ahli melalui Ini saya.
- Hari Cuti Bersama: hari semua ahli (atau majoriti, ikut tetapan) cuti.
Mahu mencuba dahulu? Buka mod demo. Data contoh disimpan dalam pelayar anda sahaja.
Mendaftar keluarga PENTADBIR
Dilakukan sekali sahaja oleh seorang dalam keluarga. Sediakan 15 hingga 20 minit dan akaun Google.
- Maklumat keluarga. Buka /daftar, isi nama keluarga dan pilih nickname (3–30 aksara, huruf kecil, nombor dan sengkang). Tanda ✓ hijau bermaksud nickname masih kosong. Jika pelayan memerlukan kod pendaftaran, dapatkan daripada pengendali laman.
- Akaun pentadbir. Nama, emel dan kata laluan sekurang-kurangnya 8 aksara. Ini untuk panel pentadbir sahaja, bukan untuk kalendar.
- Sambung Firebase. Ikut panduan dalam wizard (lihat bahagian Firebase di bawah), tampal
firebaseConfig, kemudian tekan Uji. - Google AI. Tampal kunci Gemini dan tekan Uji. Langkah ini boleh dilangkau dan ditambah kemudian.
- Semak dan daftar. Tandakan kotak pengesahan dan tekan Daftar keluarga. Anda akan mendapat alamat kalendar keluarga.
Selepas mendaftar: cipta ruang keluarga
- Buka alamat keluarga, contohnya
/f/keluarga-rahman/, dan tekan Log masuk dengan Google. - Pilih Cipta keluarga baharu. Aplikasi menjana kod jemputan. Anda menjadi Pemilik keluarga.
- Tambah ahli keluarga (lihat Ahli keluarga), kemudian jemput mereka dengan butang Jemput (WhatsApp) atau Salin kod.
Cipta keluarga sekali sahaja. Ahli lain mesti memilih Sertai keluarga, bukan cipta baharu. Jika tidak, mereka akan berada dalam kalendar berasingan.
Menyediakan Firebase dan Google AI PENTADBIR
Firebase menyimpan data kalendar keluarga dalam akaun Google anda sendiri. Pelan percuma (Spark) sudah mencukupi.
Firebase
- Buka console.firebase.google.com, tekan Create a project. Google Analytics tidak diperlukan.
- Build → Authentication → Get started → Sign-in method: aktifkan Google.
- Masih dalam Authentication, buka Settings → Authorized domains dan tambah domain laman ini (wizard memaparkannya dengan butang salin).
- Build → Firestore Database → Create database. Pilih lokasi berhampiran, contohnya
asia-southeast1(Singapura). - Dalam tab Rules Firestore, tampal peraturan yang diberi oleh wizard atau panel pentadbir, kemudian tekan Publish.
- Project settings (ikon gear) → Your apps → Web (</>). Daftar aplikasi, kemudian salin blok
firebaseConfigdan tampal dalam wizard.
Google AI (Gemini)
- Buka aistudio.google.com/apikey dan log masuk.
- Tekan Create API key, salin kunci yang bermula dengan
AIza, dan tampal dalam wizard atau panel pentadbir.
Kunci Gemini disimpan bersulit di pelayan dan tidak pernah dihantar ke telefon ahli. apiKey Firebase pula memang direka untuk didedahkan; data dilindungi oleh peraturan Firestore. Jangan lupa Publish peraturan.
Panel pentadbir PENTADBIR
Log masuk di /masuk dengan emel dan kata laluan pentadbir.
| Tab | Kegunaan |
|---|---|
| Ringkasan | Alamat keluarga, butang WhatsApp dan status persediaan. Tekan Uji semula untuk menyemak Firebase, peraturan dan AI. |
| Firebase | Tukar nama keluarga, konfigurasi Firebase, dan salin peraturan Firestore terkini. |
| Google AI | Ganti kunci Gemini dan pilih model. |
| Cuti tambahan | Tambah cuti peristiwa yang diumumkan mengejut, untuk keluarga anda sahaja. Pilih tarikh, nama dan negeri. |
| Pentadbir | Tambah pentadbir lain (maksimum 10) dengan kata laluan sementara, atau buang mereka. |
| Akaun saya | Tukar kata laluan (sesi lain dilog keluar), atau padam pendaftaran keluarga. Data dalam Firebase tidak dipadam. |
Apabila laman dikemas kini dengan peraturan Firestore baharu, panel memaparkan amaran kuning. Salin peraturan dari tab Firebase dan Publish semula dalam Firebase Console.
Menyertai keluarga SEMUA
Untuk ahli keluarga yang menerima pautan daripada pentadbir.
- Buka pautan keluarga, atau di laman utama taip nickname keluarga di ruangan Buka kalendar.
- Tekan Log masuk dengan Google dan pilih akaun anda.
- Pilih Sertai keluarga, masukkan kod jemputan 6 aksara, dan tekan Sertai.
- Di papan pemuka, jawab "Yang mana satu anda?" dengan menekan nama anda. Lihat Ini saya.
Kod hanya diperlukan sekali. Lain kali, log masuk Google sahaja terus membuka kalendar keluarga.
Pasang seperti aplikasi di telefon
- Android (Chrome): menu ⋮ → Tambah ke skrin utama atau Pasang aplikasi.
- iPhone (Safari): butang Kongsi → Tambah ke Skrin Utama.
Selepas dipasang, kalendar dibuka seperti aplikasi biasa dan masih boleh dilihat tanpa internet. Perubahan semasa luar talian disegerakkan apabila internet kembali.
Ini saya: papan pemuka peribadi SEMUA
Pautkan akaun anda kepada nama anda dalam kalendar.
- Tekan nama anda pada kad "Yang mana satu anda?" di halaman Utama, atau Ini saya pada kad ahli di tab Keluarga.
- Selepas dipautkan, halaman Utama memaparkan Minggu saya (status 7 hari, cuti seterusnya) dan Acara saya.
- Tab Acara ada penapis Untuk saya.
- Notifikasi peringatan hanya dihantar untuk acara yang melibatkan anda.
- Tersalah pilih? Tekan Bukan saya pada kad ahli anda.
Anda hanya boleh memautkan diri sendiri. Pentadbir boleh membuang pautan sesiapa.
Ahli keluarga SEMUA
Tab Keluarga → Tambah. Setiap ahli ada nama, warna dan peranan.
| Peranan | Anggaran tanpa jadual |
|---|---|
| Kerja Pejabat | Cuti pada hujung minggu dan cuti umum, bekerja hari lain. |
| Kerja Syif | Tiada anggaran. Perlu jadual dimuat naik atau corak syif. |
| Bekerja Sendiri / Peniaga | Tiada anggaran. Tetapkan corak, contohnya 6 kerja 1 cuti, atau muat naik jadual. |
| Suri Rumah | Free setiap hari. Tandakan hari yang ada urusan secara manual. |
| Pesara | Free setiap hari. |
| Kanak-kanak / Bayi | Free setiap hari (belum bersekolah, ikut ibu bapa). |
| Tadika / Prasekolah | Cuti pada hujung minggu, cuti umum dan cuti sekolah KPM. |
| Sekolah | Cuti pada hujung minggu, cuti umum dan cuti sekolah KPM. |
| Universiti / Kolej | Cuti pada hujung minggu dan cuti umum. |
Status anggaran dipaparkan dengan garis putus-putus. Status daripada jadual sebenar atau corak dipaparkan dengan garis penuh.
Kad setiap ahli menunjukkan statistik bulan ini, sumber jadual, dan siapa yang terakhir mengemas kininya.
Anggaran boleh dimatikan di Tetapan → Anggarkan status ikut peranan.
Mengisi jadual SEMUA
Empat cara, pilih yang paling mudah untuk anda. Boleh digabungkan.
1. Muat naik jadual (Google AI)
- Tab Muat Naik, atau butang Jadual pada kad ahli.
- Pilih ahli dan julat tarikh (butang pantas: bulan ini, bulan depan).
- Pilih fail: screenshot, PDF, CSV atau .ics, atau tampal teks jadual.
- Tekan Analisis jadual. Hasil dipaparkan sebagai kalendar mini berwarna.
- Ketik mana-mana tarikh untuk membetulkannya. Tarikh yang akan menimpa data sedia ada ditandakan. Tekan Simpan … hari ke kalendar.
Kod syif yang dikenali: OFF, RD, AL, MC, PH = Cuti. M, P, N, Pagi, Malam = Kerja. Jadual waktu mingguan sekolah atau kuliah diulang ke setiap minggu dalam julat tarikh.
2. Corak syif berulang
Untuk syif tetap. Tetapkan sekali, kalendar mengisi semua bulan akan datang.
- Tab Keluarga → butang Corak pada kad ahli.
- Pilih corak sedia: 4 kerja 4 cuti, 3/3, 2/2, pagi–petang–malam, 5/2, 6/1 atau 24 jam. Atau bina sendiri: ketik setiap hari untuk tukar K (kerja) → C (cuti) → S (sekolah), tekan + atau − untuk menukar panjang kitaran (sehingga 42 hari).
- Pilih tarikh hari pertama (H1) kitaran, contohnya hari pertama syif pagi. Tarikh tamat adalah pilihan.
- Tandakan Cuti pada hari cuti umum jika syif anda tidak bekerja pada cuti umum.
- Semak pratonton 4 minggu, kemudian Simpan corak.
Status manual dan hasil muat naik sentiasa mengatasi corak, contohnya cuti tahunan atau tukar syif. Jika jadual lama menghalang corak, tandakan Kosongkan N hari manual semasa menyimpan.
3. Mod Cat (beberapa hari sekaligus)
- Tab Kalendar → Mod Cat, atau butang + → Tetapkan status beberapa hari.
- Pilih ahli dan status di bar atas.
- Ketik atau seret jari pada tarikh. Tekan Buat asal jika tersilap, dan Selesai untuk keluar.
4. Satu hari
Ketik tarikh pada kalendar untuk membuka butiran hari, kemudian pilih status setiap ahli. Set semula mengembalikan hari itu kepada corak atau anggaran. Dalam paparan Minggu, ketik sel untuk menukar status secara bergilir.
Membaca kalendar SEMUA
| Paparan | Sesuai untuk |
|---|---|
| Bulan | Melihat gambaran besar. Makin hijau tarikh, makin ramai ahli cuti. |
| Minggu | Grid ahli × hari. Ketik sel untuk tukar status. |
| Agenda | Senarai harian, paling selesa di telefon. |
- Cuti / Free (huruf C), Bekerja (K), Sekolah / Kuliah (S). Status juga ditunjukkan dengan huruf dan ikon, bukan warna sahaja.
- Dalam paparan Semua, hanya ahli yang cuti dipaparkan pada setiap tarikh. Tekan nama ahli di atas kalendar untuk melihat seorang sahaja.
- Hari Cuti Bersama ditanda khas. Halaman Utama memaparkan kiraan detik ke hari cuti bersama seterusnya.
- Papan kekunci: anak panah untuk bergerak antara tarikh,
Home/Enduntuk awal/akhir minggu,Enteruntuk membuka hari.
Cari tarikh terbaik SEMUA
Jawapan terus kepada soalan "bila semua orang free?".
- Halaman Utama → Cari tarikh terbaik, atau ikon carian di tab Kalendar, atau butang + di telefon.
- Pilih siapa mesti ada (ketik nama untuk buang atau tambah).
- Pilih berapa hari (1–7) dan dalam tempoh (1–12 bulan).
- Lima tarikh terbaik dipaparkan, yang paling baik di atas. Setiap cadangan menunjukkan peratus yang free, siapa bekerja pada hari mana, cuti umum dan acara sedia ada.
- Tekan Cipta acara untuk terus merancang, atau ikon WhatsApp untuk bertanya keluarga.
"Jadual belum ada" bermaksud ahli itu tiada jadual atau anggaran untuk hari tersebut, contohnya pekerja syif tanpa corak. Tetapkan corak syif untuk hasil yang lebih tepat.
Acara keluarga SEMUA
- Tab Acara → Cipta acara, atau pilih templat: Balik Kampung, Makan Malam, Hari Jadi, Percutian, Kenduri, Temujanji Klinik, Hari Sukan.
- Isi tajuk, tarikh (dan tarikh tamat untuk acara beberapa hari), masa, lokasi dan nota.
- Pilih ahli yang dijemput, ulangan (mingguan, bulanan, tahunan) dan peringatan.
- Untuk acara baharu, tulis senarai semak (satu tugasan setiap baris).
Pada kad acara
- Kehadiran: ketik nama ahli untuk bergilir Hadir → Mungkin → Tidak hadir.
- Senarai semak: tandakan tugasan yang siap (dipaparkan "✓ oleh …"), tambah tugasan dan tugaskan kepada seorang ahli.
- Kongsi: Google Calendar, fail
.icsuntuk Apple Calendar (dengan peringatan), atau jemputan WhatsApp.
Notifikasi pelayar hanya dihantar semasa aplikasi dibuka. Untuk peringatan yang pasti sampai, tambah acara ke Google Calendar atau Apple Calendar.
Cuti umum, cuti sekolah dan long weekend SEMUA
- Tab Cuti menyenaraikan cuti umum ikut negeri dan tahun, takwim cuti sekolah KPM (Kumpulan A atau B ikut negeri), dan cuti peristiwa keluarga.
- Cadangan long weekend menunjukkan cuti panjang tanpa perlu ambil cuti, dan cadangan "ambil cuti 1–2 hari, dapat 4 hari". Yang seterusnya diserlahkan.
- Tekan Rancang untuk terus mencipta acara percutian, atau eksport ke kalendar telefon.
- Tukar negeri di Tetapan atau terus di tab Cuti. Kedah, Kelantan dan Terengganu menggunakan hujung minggu Jumaat–Sabtu.
Data cuti dikemas kini oleh pengendali laman dan dimuat secara automatik. Tarikh perayaan Islam tertakluk kepada pengisytiharan rasmi.
Peranan dan kebenaran
Tab Keluarga → Akaun & kebenaran. Hanya pemilik dan pentadbir boleh menukar peranan.
| Tindakan | Pemilik | Pentadbir | Ahli | Lihat sahaja |
|---|---|---|---|---|
| Melihat kalendar dan acara | Ya | Ya | Ya | Ya |
| Pautkan diri (Ini saya) | Ya | Ya | Ya | Ya |
| Kemas kini jadual, tambah ahli dan acara | Ya | Ya | Ya | Tidak |
| Padam acara sendiri | Ya | Ya | Ya | Tidak |
| Padam acara orang lain, padam ahli | Ya | Ya | Tidak | Tidak |
| Tukar peranan, keluarkan atau sekat akaun | Ya | Ya | Tidak | Tidak |
- Keluarkan akaun: ikon ⨯ orang di sebelah akaun. Akaun itu terus hilang akses dan disekat daripada menyertai semula dengan kod, sehingga anda tekan Nyahsekat.
- Lihat sahaja sesuai untuk datuk nenek atau anak kecil. Butang ubah disembunyikan dan lencana kuning dipaparkan di atas.
- Peranan Pemilik (pencipta keluarga) tidak boleh ditukar atau dikeluarkan.
Tetapan SEMUA
Ikon gear di bahagian atas. Tetapan ini disimpan pada peranti anda sahaja.
- Tema: ikut sistem, terang atau gelap.
- Negeri: menentukan cuti umum, hujung minggu dan kumpulan cuti sekolah.
- Tandakan Hari Cuti Bersama bila: semua ahli cuti, atau semua atau majoriti.
- Anggarkan status ikut peranan jika tiada jadual.
- Notifikasi peringatan acara pada peranti ini.
- Kod jemputan, Jemput, Tukar keluarga dan Log keluar juga ada di sini.
Soalan lazim dan penyelesaian masalah
- Popup Google menunjukkan
auth/unauthorized-domain. - Pentadbir perlu menambah domain laman ini dalam Firebase → Authentication → Settings → Authorized domains.
- "Ralat penyegerakan: Missing or insufficient permissions".
- Peraturan Firestore belum diterbitkan atau sudah lama, atau akaun anda belum menyertai keluarga atau telah dikeluarkan. Pentadbir: salin peraturan dari panel dan Publish semula.
- "Kod keluarga tidak dijumpai".
- Semak 6 aksara itu. Kod tidak menggunakan huruf O/I atau nombor 0/1 untuk mengelak kekeliruan.
- "Akaun anda telah dikeluarkan daripada keluarga ini".
- Minta pemilik atau pentadbir menekan Nyahsekat pada akaun anda, kemudian sertai semula dengan kod.
- Analisis AI gagal atau "Kuota habis".
- Gunakan gambar yang lebih jelas dan pastikan tarikh kelihatan. Jika kuota habis, tunggu sebentar atau minta pentadbir menyemak kunci Gemini di panel.
- Ahli syif tidak muncul dalam Hari Cuti Bersama.
- Pekerja syif dan peniaga tiada anggaran automatik. Muat naik jadual atau tetapkan corak.
- Corak syif tidak kelihatan pada sesetengah hari.
- Hari itu ada status manual atau hasil muat naik. Tekan Set semula pada hari itu, atau simpan corak semula dengan pilihan Kosongkan hari manual.
- Saya tukar telefon. Data saya hilang?
- Tidak. Data kalendar disimpan dalam Firebase keluarga. Log masuk dengan akaun Google yang sama. Hanya tetapan peribadi (tema, negeri) perlu ditetapkan semula.
- Saya pentadbir dan terlupa kata laluan panel.
- Minta pentadbir lain dalam keluarga menambah anda semula dengan kata laluan sementara, atau hubungi pengendali laman.