calendso - 絶対にすべての人のためのスケジューリングインフラストラクチャ。

(Scheduling infrastructure for absolutely everyone.)

Created at: 2021-03-22 21:47:42

Language: TypeScript

URL: https://github.com/calendso/calendso

License: MIT

Cal.com(旧カレンソ)

オープンソースのカレンドリーの代替手段。
もっと詳しく知る »

スラック·ウェブサイト·問題点·ロードマップ

プロジェクトについて

絶対にすべての人のためのスケジューリングインフラストラクチャ

オープンソースのカレンダーの代替手段。あなたが担当しています独自のデータ、ワークフロー、外観の。

カレンダーやその他のスケジューリングツールは素晴らしいです。それは私たちの生活を非常に楽にしました。ビジネスミーティング、セミナー、ヨガクラス、さらには家族との電話にも使用しています。ただし、ほとんどのツールは、制御とカスタマイズの点で非常に制限されています。

そこで Cal.com 出番です。自己ホストまたは当社がホストします。デザインによるホワイトラベル。API 駆動型で、独自のドメインにデプロイする準備ができています。イベントとデータを完全に制御します。

今月の製品: 2021 年 4 月

製品ハントで私たちをサポートしてください

で構築

はじめ

ローカルコピーを起動して実行するには、次の簡単な手順に従ってください。

前提条件

Calを実行するために必要なものは次のとおりです。

ノード.js (バージョン: >=15.x <17)
PostgreSQL
糸(推奨)

利用可能な統合のいずれかを有効にする場合は、統合ごとに追加の資格情報を取得することをお勧めします。これに関する詳細は、以下の統合セクションにあります。

発達

セットアップ

リポジトリをパブリック GitHub リポジトリ (またはフォークhttps://github.com/calcom/cal.com/fork) に複製します。コードを配布する場合は、AGPLv3に準拠するためにソースコードを公開してください。プライベートリポジトリにクローンを作成するには、商用ライセンスを取得します)
```
git clone https://github.com/calcom/cal.com.git
```
プロジェクトフォルダに移動します
```
cd cal.com
```
yarn でパッケージをインストールする
```
yarn
```
.env ファイルを設定する
- 複製
```
.env.example
```
```
.env
```
- 使用するキーを生成し、.envファイルの下に追加します。
```
openssl rand -base64 32
```
```
NEXTAUTH_SECRET
```
- 使用するキーを生成し、.envファイルの下に追加します。
```
openssl rand -base64 24
```
```
CALENDSO_ENCRYPTION_KEY
```

クイックスタート

yarn dx

Docker と Docker Compose がインストールされている必要があります

数人のテストユーザーでローカルPostgresインスタンスを起動します-資格情報はコンソールに記録されます

yarn dx

開発のヒント

追加あなたのどこでもtrpcによって駆動されるすべてのクエリとミューテーションのログ情報を取得します。
NEXT_PUBLIC_DEBUG=1
.env

echo 'NEXT_PUBLIC_DEBUG=1' >> .env

手動セットアップ

ファイルで環境変数を構成します。置換,,,適用可能な値で
```
.env
```
```
<user>
```
```
<pass>
```
```
<db-host>
```
```
<db-port>
```
```
DATABASE_URL='postgresql://<user>:<pass>@<db-host>:<db-port>'
```
DATABASE_URLの設定方法がわからない場合は、こちらの手順に従って、Heroku を使用してクイック DB を作成してください。
1. Heroku で無料アカウントを作成します。
2. 新しいアプリを作成します。
3. 新しいアプリで、に移動します横をクリックしてクリックします。データベースを設定するには、これが必要です。
```
Overview
```
```
Installed add-ons
```
```
Configure Add-ons
```
4. クリックしたら、をクリックします検索します。オプションの1つは、そのオプションをクリックすることです。
```
Configure Add-ons
```
```
Find more add-ons
```
```
postgres
```
```
Heroku Postgres
```
5. ポップアップが表示されたら、クリックプラン名が表示されます。
```
Submit Order Form
```
```
Hobby Dev - Free
```
6. 上記の手順を完了したら、新しく作成したものをクリックしますそしてそれに行きます。
```
Heroku Postgres
```
```
Settings
```
7. で、URIを Cal.com.envファイルにコピーし、それを置き換えます。
```
Settings
```
```
postgresql://<user>:<pass>@<db-host>:<db-port>
```
8. DB を表示するには、Prisma に新しいデータを追加したら、Heroku データエクスプローラーを使用できます。
.envファイルに32文字のランダムな文字列を設定します(次のようなコマンドを使用できます生成します)。
```
CALENDSO_ENCRYPTION_KEY
```
```
openssl rand -base64 24
```
Prisma スキーマを使用してデータベースを設定します (
```
packages/prisma/schema.prisma
```
)
```
yarn workspace @calcom/prisma db-deploy
```
実行 (開発モード)
```
yarn dev
```

最初のユーザーを設定する

Prisma Studioを開いて、データベースの内容を確認または変更します。
```
yarn db-studio
```
クリックしてくださいモデル新しいユーザーレコードを追加します。
```
User
```
フィールドに入力し,,,に設定します空にする(BCryptでパスワードを暗号化することを忘れないでください)をクリックします最初のユーザーを作成します。
```
email
```
```
username
```
```
password
```
```
metadata
```
```
{}
```
```
Save 1 Record
```
新しいユーザーはデフォルトでプランに設定されます。この動作は、ファイル内のニーズに合わせて調整できます。
```
TRIAL
```
```
packages/prisma/schema.prisma
```
ブラウザを開いてhttp://localhost:3000し、作成した最初のユーザーでログインします。

E2E-テスト

環境変数を正しい値に設定してください。ローカルで実行している場合、ドキュメントに記載されているように、値は次のようにする必要があります。

NEXTAUTH_URL

.env.example

http://localhost:3000

# In a terminal just run:
yarn test-e2e

# To open last HTML report run:
yarn playwright show-report test-results/reports/playwright-html-report

以前のバージョンからのアップグレード

現在のバージョンをプルします。
```
git pull
```
依存関係が追加/更新/削除されたかどうかを確認します
```
yarn
```
データベースの移行を適用するには、次のいずれかのコマンドを実行します。

開発環境では、次のコマンドを実行します。
```
yarn workspace @calcom/prisma db-migrate
```
(これにより、場合によっては開発データベースをクリアできます)

運用環境では、次のコマンドを実行します。
```
yarn workspace @calcom/prisma db-deploy
```
変数の変更を確認する
```
.env
```
```
yarn predev
```
サーバーを起動します。開発環境では、次のようにします。
```
yarn dev
```
運用ビルドの場合は、次のように実行します。
```
yarn build
yarn start
```
新しいバージョンをお楽しみください。

配備

港湾労働者

Cal の Docker 構成は、コミュニティ内の人々によって強化された取り組みです。

Dockerリポジトリに貢献する場合は、ここに返信してください。

Docker の構成は、Docker リポジトリにあります。

ドッカーの問題?あなたの答えを見つけるか、ここで新しいディスカッションを開いてコミュニティに尋ねてください。

Cal.com, Inc. は Docker の公式サポートを提供していませんが、修正とドキュメントは受け付けます。自己責任で使用してください。

ヘロク

鉄道

上のボタンを使用して、Calを鉄道に展開できます。Railwayのチームは、プラットフォームへのCalの展開に関する詳細なブログ投稿も持っています。

ヴェルセル

現在、Vercel Pro プランは、無料プランのサーバーレス機能の数に制限があるため、Vercel でこのアプリケーションをデプロイできるようにする必要があります。

ロードマップ

提案された機能 (および既知の問題) の一覧については、ロードマッププロジェクトを参照してください。ビューを変更して、計画されたタグ付きリリースを表示できます。

貢献

寄稿ガイドをご覧ください。

良い最初の問題

比較的限られた範囲を持つ小さな機能やバグを含む、必要なヘルプのリストがあります。これは、開始し、経験を積み、貢献プロセスに慣れるのに最適な場所です。

統合

Google API の認証情報を取得する

Google API Console を開きます。Google Cloud サブスクリプションにプロジェクトがない場合は、先に進む前にプロジェクトを作成する必要があります。[ダッシュボードウィンドウ] で、 [API とサービスを有効にする] を選択します。
検索ボックスに「カレンダー」と入力し、Google カレンダー API の検索結果を選択します。
選択した API を有効にします。
次に、サイドウィンドウからOAuth 同意画面に移動します。アプリの種類 (内部または外部) を選択し、最初のページに基本的なアプリの詳細を入力します。
[スコープ] の 2 番目のページで、[スコープの追加または削除] を選択します。Calendar.event を検索し、スコープ値を持つスコープを選択し、[更新] を選択します。
```
.../auth/calendar.events
```
```
.../auth/calendar.readonly
```
3 ページ目(テストユーザー)で、使用する Google アカウントを追加します。ウィザードの最後のページで詳細が正しいことを確認し、同意画面を構成します。
次に、サイドペインから[資格情報] を選択し、[資格情報の作成] を選択します。[OAuth クライアント ID] オプションを選択します。
[アプリケーションの種類] として [Web アプリケーション] を選択します。
[承認されたリダイレクト URI] で [URI の追加] を選択し、URI を追加し、Cal.com URL をアプリケーションを実行する URI に置き換えます。
```
<Cal.com URL>/api/integrations/googlecalendar/callback
```
```
<Cal.com URL>/api/auth/callback/google
```
キーが作成され、[資格情報] ページにリダイレクトされます。[OAuth 2.0 クライアント ID] で新しく生成されたクライアント ID を選択します。
[JSON のダウンロード] を選択します。このファイルの内容をコピーし、JSON 文字列全体を .env ファイルに GOOGLE_API_CREDENTIALS キーの値として貼り付けます。

Cal.com アプリストアにグーグルカレンダーを追加する

Googleクレデンシャルを追加した後、Googleカレンダーアプリをアプリストアに表示できるようになりました。アプリストアを再設定するには、次のコマンドを実行します。

cd packages/prisma
yarn seed-app-store

Googleカレンダーアプリを有効にするには、さらにいくつかの手順を完了する必要があります。「Google API 認証情報の取得」セクションを必ず完了してください。その後、次

リダイレクト URL を追加する
```
<Cal.com URL>/api/auth/callback/google
```
[OAuth コンセント画面] で [アプリを公開] をクリックします。

Microsoft Graph クライアント ID とシークレットの取得

Open Azure App Registration and select New registration
Name your application
Set Who can use this application or access this API? to Accounts in any organizational directory (Any Azure AD directory - Multitenant)
Set the Web redirect URI to replacing Cal.com URL with the URI at which your application runs.
```
<Cal.com URL>/api/integrations/office365calendar/callback
```
Use Application (client) ID as the MS_GRAPH_CLIENT_ID attribute value in .env
Click Certificates & secrets create a new client secret and use the value as the MS_GRAPH_CLIENT_SECRET attribute

Obtaining Zoom Client ID and Secret

Open Zoom Marketplace and sign in with your Zoom account.
On the upper right, click "Develop" => "Build App".
On "OAuth", select "Create".
Name your App.
Choose "User-managed app" as the app type.
De-select the option to publish the app on the Zoom App Marketplace.
Click "Create".
Now copy the Client ID and Client Secret to your .env file into the and fields.
```
ZOOM_CLIENT_ID
```
```
ZOOM_CLIENT_SECRET
```
Set the Redirect URL for OAuth replacing Cal.com URL with the URI at which your application runs.
```
<Cal.com URL>/api/integrations/zoomvideo/callback
```
Also add the redirect URL given above as a allow list URL and enable "Subdomain check". Make sure, it says "saved" below the form.
You don't need to provide basic information about your app. Instead click at "Scopes" and then at "+ Add Scopes". On the left, click the category "Meeting" and check the scope .
```
meeting:write
```
Click "Done".
You're good to go. Now you can easily add your Zoom integration in the Cal.com settings.

Obtaining Daily API Credentials

Open Daily and sign into your account.
From within your dashboard, go to the developers tab.
Copy your API key.
Now paste the API key to your .env file into the field in your .env file.
```
DAILY_API_KEY
```
If you have the Daily Scale Plan set the variable to in order to use features like video recording.
```
DAILY_SCALE_PLAN
```
```
true
```

Obtaining HubSpot Client ID and Secret

Open HubSpot Developer and sign into your account, or create a new one.
From within the home of the Developer account page, go to "Manage apps".
Click "Create app" button top right.
Fill in any information you want in the "App info" tab
Go to tab "Auth"
Now copy the Client ID and Client Secret to your .env file into the and fields.
```
HUBSPOT_CLIENT_ID
```
```
HUBSPOT_CLIENT_SECRET
```
Set the Redirect URL for OAuth replacing Cal.com URL with the URI at which your application runs.
```
<Cal.com URL>/api/integrations/hubspot/callback
```
In the "Scopes" section at the bottom of the page, make sure you select "Read" and "Write" for scope called
```
crm.objects.contacts
```
Click the "Save" button at the bottom footer.
You're good to go. Now you can see any booking in Cal.com created as a meeting in HubSpot for your contacts.

Obtaining Vital API Keys

Open Vital and click Get API Keys.
Create a team with the team name you desire
Head to the configuration section on the sidebar of the dashboard
Click on API keys and you'll find your sandbox .
```
api_key
```
Copy your to in the .env.appStore file.
```
api_key
```
```
VITAL_API_KEY
```
Open Vital Webhooks and add as webhook for connected applications.
```
<CALCOM BASE URL>/api/integrations/vital/webhook
```
Select all events for the webhook you interested, e.g.
```
sleep_created
```
Copy the webhook secret () to in the .env.appStore file.
```
sec...
```
```
VITAL_WEBHOOK_SECRET
```

Workflows

Setting up SendGrid for Email reminders

Create a SendGrid account (https://signup.sendgrid.com/)
Go to Settings -> API keys and create an API key
Copy API key to your .env file into the SENDGRID_API_KEY field
Go to Settings -> Sender Authentication and verify a single sender
Copy the verified E-Mail to your .env file into the SENDGRID_EMAIL field

Setting up Twilio for SMS reminders

Create a Twilio account (https://www.twilio.com/try-twilio)
Click ‘Get a Twilio phone number’
Copy Account SID to your .env file into the TWILIO_SID field
Copy Auth Token to your .env file into the TWILIO_TOKEN field
Create a messaging service (Develop -> Messaging -> Services)
メッセージングサービスの名前を選択します。
[送信者の追加]をクリックします
送信者の種類として電話番号を選択する
リストされている電話番号を追加する
他のすべてのフィールドはそのままにしておきます
セットアップを完了し、[新しいメッセージングサービスを表示]をクリックします
メッセージングサービス SID を .env ファイルの TWILIO_MESSAGING_SID フィールドにコピーします。

ライセンス

AGPLv3ライセンスの下で配布されています。詳細については、「」を参照してください。

LICENSE

確認

Cal.com 力を助けるこれらの素晴らしいプロジェクトに感謝します:

Cal.com はオープンスタートアップであり、Jitsu(オープンソースのセグメントの代替手段)は、ほとんどの使用状況メトリックを追跡するのに役立ちます。

calendso - 絶対にすべての人のためのスケジューリング インフラストラクチャ。