someday

Suatu hari nanti

Gratis untuk hosting dan open-source cal.com / alternatif calendly yang dibangun di Google-Apps-script untuk pengguna Gmail.

Demo (titik akhir yang diejek)

https://someday-demo.vercel.app/

Apa itu suatu hari nanti?

Suatu hari adalah alat penjadwalan sederhana dan open-source yang dirancang khusus untuk pengguna Gmail. Menggunakan skrip Google Apps untuk meng -host dan genggam untuk dikelola. Dibangun dengan teknologi modern seperti React, TypeScript, Shadcn/UI, dan Vite. Alternatif sederhana untuk aplikasi penjadwalan tradisional seperti Calendly.

Fitur utama

• Sumber gratis dan terbuka : Nikmati semua fitur penjadwalan premium tanpa biaya apa pun. Suatu hari nanti benar -benar bebas digunakan dan dibuka untuk kontribusi.
• Integrasi yang mudah : Dirancang sebagai skrip Google Apps, suatu hari nanti terintegrasi mulus dengan Gmail Anda, membuatnya mudah untuk mengelola jadwal Anda langsung dari kotak masuk Anda.
• Ramah Pengembang : Dibangun dengan teknologi modern yang disukai pengembang, suatu hari nanti mudah disesuaikan dan diperluas untuk memenuhi kebutuhan spesifik Anda.
• Jam kerja yang dapat disesuaikan : Tetapkan ketersediaan Anda dengan presisi, memungkinkan orang lain memesan slot waktu yang sesuai dengan jadwal Anda dengan sempurna.
• Proses Pemesanan Sederhana : Pengguna dapat memilih slot tanggal dan waktu, lalu mengisi formulir langsung dengan nama, email, telepon, dan catatan opsional.
• Privasi Pertama : Tidak Ada Berbagi Data Di luar Google ke aplikasi pihak ke -3

Memulai

Menyesuaikan

Ubah variabel berikut di backend/src/app.ts untuk menyesuaikan pengaturan ketersediaan Anda:

 // backend/src/app.ts
const CALENDAR = "primary" ;
const TIME_ZONE = "America/New_York" ;
const WORKDAYS = [ 1 , 2 , 3 , 4 , 5 ] ;
const WORKHOURS = {
  start : 9 ,
  end : 13 ,
} ;
const TIMESLOT_DURATION = 30 ;

Self host iframe html / hapus spanduk skrip aplikasi google

• Script Google Apps memiliki spanduk yang bertuliskan "Aplikasi ini dibuat oleh pengguna skrip Google Apps", untuk menghapus Anda dapat meng -host file html sendiri dan menyematkan skrip sebagai iframe

• Gunakan file hosted-iframe-example.html , halaman github adalah pilihan yang baik untuk ini, tambahkan url skrip Anda ke iframe src

Mengembangkan

• cd ./frontend
• npm install
• npm run dev
• DummyData akan dihasilkan dengan cepat menggunakan fungsi GeneratedummyData ~ Line 42 di frontend/hooks/useGoogleTimeSlots.ts

Memasang

Langkah 1: Siapkan lingkungan Anda

Anda mungkin perlu keluar dari semua akun, dan hanya ke akun target Anda

1. Instal clasp :

   • Pastikan Anda menginstal Node.js.
   • Instal clasp secara global menggunakan NPM:

     npm install -g @google/clasp

2. Masuk dengan clasp :

   • Jalankan perintah berikut untuk masuk:

     clasp login

3. Hapus konfigurasi yang ada (jika perlu):

   • Jika Anda mengalami masalah, hapus file .clasp.json yang ada:

     rm .clasp.json

4. Aktifkan Apps Script API:

   • Kunjungi Pengaturan API Script Google Apps.
   • Aktifkan API Script Apps.
   • Tunggu beberapa menit untuk perubahan menyebar.

Langkah 2: Buat dan gunakan skrip

1. Buat proyek baru:

   • Buat proyek skrip aplikasi baru sebagai aplikasi web:

     clasp create --type webapp

2. Menyebarkan skrip:

   • Gunakan perintah berikut untuk menggunakan skrip Anda:

     npm run deploy

3. Akses Aplikasi Web:

   • Kunjungi URL yang disediakan setelah penempatan.
   • Anda akan melihat pesan "Otorisasi diperlukan untuk melakukan tindakan itu."

4. Otorisasi Aplikasi Web: (!!! Penting !!!)

   • Jalankan clasp open untuk membuka editor
   • Pergi ke dist/app.gs
   • Di drop -down di atas, pilih fetchAvailability kemudian tekan run
   • Modal otorisasi akan muncul, 'Review Izin', pilih akun Anda, Anda akan melihat peringatan, pergi ke Advanced, lalu pergi ke (tidak aman) lalu klik izinkan
   • Jika berhasil, refresh halaman/editor kemudian jalankan fungsi lagi dan harus selesai tanpa masalah.

Lembar Cheat

• npm run deploy - Build and Delpoy

• npm run build - Bangun saja

• undeployall.sh - Underploy semua versi skrip

• deployments.sh - Daftar semua penempatan web -urls

• clasp open - buka editor skrip

Tangkapan layar

Berkontribusi

Buka permintaan tarik atau masalah untuk berkontribusi pada suatu hari nanti. Menyambut semua kontribusi, termasuk perbaikan bug, permintaan fitur, dan peningkatan dokumentasi.

Lisensi

Mit