KalendarKeluargaManual pengguna
panduan lengkap,

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

    PenggunaApa yang mereka buatLog masuk
    Pentadbir keluargaMendaftar keluarga sekali sahaja, menyambung Firebase dan Google AI, kemudian menjemput ahli.Emel dan kata laluan di /masuk, untuk panel pentadbir
    Ahli keluargaMelihat 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.

    1. 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.
    2. Akaun pentadbir. Nama, emel dan kata laluan sekurang-kurangnya 8 aksara. Ini untuk panel pentadbir sahaja, bukan untuk kalendar.
    3. Sambung Firebase. Ikut panduan dalam wizard (lihat bahagian Firebase di bawah), tampal firebaseConfig, kemudian tekan Uji.
    4. Google AI. Tampal kunci Gemini dan tekan Uji. Langkah ini boleh dilangkau dan ditambah kemudian.
    5. Semak dan daftar. Tandakan kotak pengesahan dan tekan Daftar keluarga. Anda akan mendapat alamat kalendar keluarga.

    Selepas mendaftar: cipta ruang keluarga

    1. Buka alamat keluarga, contohnya /f/keluarga-rahman/, dan tekan Log masuk dengan Google.
    2. Pilih Cipta keluarga baharu. Aplikasi menjana kod jemputan. Anda menjadi Pemilik keluarga.
    3. 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

    1. Buka console.firebase.google.com, tekan Create a project. Google Analytics tidak diperlukan.
    2. Build → Authentication → Get started → Sign-in method: aktifkan Google.
    3. Masih dalam Authentication, buka Settings → Authorized domains dan tambah domain laman ini (wizard memaparkannya dengan butang salin).
    4. Build → Firestore Database → Create database. Pilih lokasi berhampiran, contohnya asia-southeast1 (Singapura).
    5. Dalam tab Rules Firestore, tampal peraturan yang diberi oleh wizard atau panel pentadbir, kemudian tekan Publish.
    6. Project settings (ikon gear) → Your apps → Web (</>). Daftar aplikasi, kemudian salin blok firebaseConfig dan tampal dalam wizard.

    Google AI (Gemini)

    1. Buka aistudio.google.com/apikey dan log masuk.
    2. 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.

    TabKegunaan
    RingkasanAlamat keluarga, butang WhatsApp dan status persediaan. Tekan Uji semula untuk menyemak Firebase, peraturan dan AI.
    FirebaseTukar nama keluarga, konfigurasi Firebase, dan salin peraturan Firestore terkini.
    Google AIGanti kunci Gemini dan pilih model.
    Cuti tambahanTambah cuti peristiwa yang diumumkan mengejut, untuk keluarga anda sahaja. Pilih tarikh, nama dan negeri.
    PentadbirTambah pentadbir lain (maksimum 10) dengan kata laluan sementara, atau buang mereka.
    Akaun sayaTukar 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.

    1. Buka pautan keluarga, atau di laman utama taip nickname keluarga di ruangan Buka kalendar.
    2. Tekan Log masuk dengan Google dan pilih akaun anda.
    3. Pilih Sertai keluarga, masukkan kod jemputan 6 aksara, dan tekan Sertai.
    4. 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.

    PerananAnggaran tanpa jadual
    Kerja PejabatCuti pada hujung minggu dan cuti umum, bekerja hari lain.
    Kerja SyifTiada anggaran. Perlu jadual dimuat naik atau corak syif.
    Bekerja Sendiri / PeniagaTiada anggaran. Tetapkan corak, contohnya 6 kerja 1 cuti, atau muat naik jadual.
    Suri RumahFree setiap hari. Tandakan hari yang ada urusan secara manual.
    PesaraFree setiap hari.
    Kanak-kanak / BayiFree setiap hari (belum bersekolah, ikut ibu bapa).
    Tadika / PrasekolahCuti pada hujung minggu, cuti umum dan cuti sekolah KPM.
    SekolahCuti pada hujung minggu, cuti umum dan cuti sekolah KPM.
    Universiti / KolejCuti 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)

    1. Tab Muat Naik, atau butang Jadual pada kad ahli.
    2. Pilih ahli dan julat tarikh (butang pantas: bulan ini, bulan depan).
    3. Pilih fail: screenshot, PDF, CSV atau .ics, atau tampal teks jadual.
    4. Tekan Analisis jadual. Hasil dipaparkan sebagai kalendar mini berwarna.
    5. 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.

    1. Tab Keluarga → butang Corak pada kad ahli.
    2. 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).
    3. Pilih tarikh hari pertama (H1) kitaran, contohnya hari pertama syif pagi. Tarikh tamat adalah pilihan.
    4. Tandakan Cuti pada hari cuti umum jika syif anda tidak bekerja pada cuti umum.
    5. 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)

    1. Tab Kalendar → Mod Cat, atau butang + → Tetapkan status beberapa hari.
    2. Pilih ahli dan status di bar atas.
    3. 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

    PaparanSesuai untuk
    BulanMelihat gambaran besar. Makin hijau tarikh, makin ramai ahli cuti.
    MingguGrid ahli × hari. Ketik sel untuk tukar status.
    AgendaSenarai 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/End untuk awal/akhir minggu, Enter untuk membuka hari.

    Cari tarikh terbaik SEMUA

    Jawapan terus kepada soalan "bila semua orang free?".

    1. Halaman Utama → Cari tarikh terbaik, atau ikon carian di tab Kalendar, atau butang + di telefon.
    2. Pilih siapa mesti ada (ketik nama untuk buang atau tambah).
    3. Pilih berapa hari (1–7) dan dalam tempoh (1–12 bulan).
    4. 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.
    5. 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

    1. Tab Acara → Cipta acara, atau pilih templat: Balik Kampung, Makan Malam, Hari Jadi, Percutian, Kenduri, Temujanji Klinik, Hari Sukan.
    2. Isi tajuk, tarikh (dan tarikh tamat untuk acara beberapa hari), masa, lokasi dan nota.
    3. Pilih ahli yang dijemput, ulangan (mingguan, bulanan, tahunan) dan peringatan.
    4. 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 .ics untuk 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.

    TindakanPemilikPentadbirAhliLihat sahaja
    Melihat kalendar dan acaraYaYaYaYa
    Pautkan diri (Ini saya)YaYaYaYa
    Kemas kini jadual, tambah ahli dan acaraYaYaYaTidak
    Padam acara sendiriYaYaYaTidak
    Padam acara orang lain, padam ahliYaYaTidakTidak
    Tukar peranan, keluarkan atau sekat akaunYaYaTidakTidak
    • 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.