snapshot of https://github.com/twentyhq/twenty.git (main, 2026-09-17; blobs > 131072B omitted)

packages/twenty-docs/l/ja/getting-started/core-concepts/ai.mdx

@@ -0,0 +1,34 @@
+---
+title: AI
+description: Twenty はどのように AI を活用して、CRM の利用体験を向上させるか。
+icon: robot
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+Twenty は AI を CRM に直接統合し、単なる見せかけではなく、あなたのデータモデルと権限システムの中で機能するツールとして提供します。
+
+## AI チャットボット
+
+データについて自然言語で質問できます。 AI チャットボットは CRM のレコードに対してクエリを実行し、情報を要約し、複雑なフィルターを作成しなくても、探しているものを見つけるのを支援します。
+
+<VimeoEmbed videoId="1185511734" title="AI チャットボット" />
+
+## AIエージェント
+
+AI エージェントはチャットにとどまらず、自律的に複数ステップのタスクを実行できます。
+
+* 外部ソースのデータでレコードを充実させる
+* フォローアップメールを下書きして送信する
+* パイプラインの健全性を分析し、リスクの高い案件にフラグを立てる
+* 受信データを処理し、適切なチームへ振り分ける
+
+エージェントは既存のワークフロー内で動作するため、AI を手動承認、条件付きロジック、外部 API コールと組み合わせることができます。
+
+## 権限と安全性
+
+Twenty の AI は、あなたの権限モデルを順守します。 エージェントは、ユーザー（またはロール）に閲覧権限があるオブジェクトとフィールドにしかアクセスできません。 AI が関与している場合でも、機密データは保護されたままです。
+
+<Card title="AI の完全ガイド" icon="arrow-right" href="/l/ja/user-guide/ai/overview">
+  チャットボット、エージェント、権限管理に関する詳細なリファレンス。
+</Card>

packages/twenty-docs/l/ja/getting-started/core-concepts/apps.mdx

@@ -0,0 +1,41 @@
+---
+title: アプリ
+icon: cube
+description: コードで Twenty を拡張しましょう。カスタムオブジェクト、サーバーサイドロジック、UI コンポーネント、AI エージェントをすべて TypeScript パッケージとして追加できます。
+---
+
+ほとんどの CRM は設定パネルを提供します。 Twenty はプラットフォームを提供します。 アプリは、開発者が UI で提供される範囲を超えて Twenty を拡張する方法です。データモデル、サーバーサイドロジック、UI コンポーネント、AI 機能をコードとして定義し、それらを 1 つ以上のワークスペースにデプロイできます。
+
+## アプリが存在する理由
+
+ワークフローはノーコードの自動化を担います。 しかし、コードが必要なものもあります。たとえば、カスタムの料金算出エンジン、独自のエンリッチメントパイプライン、レコードの更新ごとに実行されるコンプライアンスチェック、社内ツールからデータを取得するカスタム UI パネルなどです。
+
+アプリを使えば、これらを一級の拡張機能として構築できます。外部から API と通信する壊れやすいスクリプトではなく、型システム、権限モデル、UI へ完全にアクセスできる、プラットフォーム上で実行されるコードとして実現できます。
+
+## アプリで定義できるもの
+
+アプリは、`twenty-sdk` を使って **エンティティ** を宣言する TypeScript パッケージです。
+
+| エンティティ           | 機能                                                                         |
+| ---------------- | -------------------------------------------------------------------------- |
+| **オブジェクトとフィールド** | 既存オブジェクト上の新しいデータテーブルとフィールド — 組み込みのものと同様に扱われます                              |
+| **ロジック関数**       | HTTP ルート、cron スケジュール、またはデータベースイベントによってトリガーされるサーバーサイドの TypeScript           |
+| **フロントコンポーネント**  | サンドボックス化された React コンポーネントで、Twenty の UI（サイドパネル、ウィジェット、コマンドメニュー）内でレンダリングされます |
+| **スキルとエージェント**   | AI 機能 — 再利用可能な指示と自律型アシスタント                                                 |
+| **ビューとナビゲーション**  | 事前設定済みのリストビューとサイドバーのメニュー項目                                                 |
+
+すべてはビルド時に AST 解析によって検出されます — 設定ファイルも登録用のボイラープレートも不要です。 任意の `.ts` ファイルに `export default defineObject(...)` を記述するだけで、SDK がそれを検出します。
+
+## 実行方式
+
+* **ロジック関数**は、ホストからサンドボックス化された分離された Node.js プロセスで実行されます。 それらは、アプリのロール権限の範囲にスコープされた型付き API クライアントを通じてデータにアクセスします。
+* **フロントコンポーネント**は Remote DOM を用いた Web Workers 内で実行されます—メインページからサンドボックス化されつつ、ネイティブの DOM 要素（iframe ではありません）をレンダリングします。
+* **権限**は API レベルで強制されます。 アプリは自分のロールで許可されたものだけを参照できます。
+
+## 開発者エクスペリエンス
+
+ローカル環境で TypeScript プロジェクトとしてアプリを作成します。 CLI がソースファイルを監視し、実行中の Twenty サーバーとライブ同期します — ファイルを編集すると、1 秒以内に UI に変更が反映されます。 スキーマが変更されると、型付き API クライアントは自動的に再生成されます。 準備ができたら、`yarn twenty app:publish --private` で本番サーバーにプッシュするか、`yarn twenty app:publish` でアプリを npm と Twenty マーケットプレイスに掲載します。
+
+<Card title="最初のアプリを構築する" icon="arrow-right" href="/l/ja/developers/extend/apps/getting-started/quick-start">
+  3 フェーズのウォークスルー — 雛形の作成、ローカルサーバーの実行、変更内容の同期。
+</Card>

packages/twenty-docs/l/ja/getting-started/core-concepts/calendar-and-email.mdx

@@ -0,0 +1,46 @@
+---
+title: カレンダーとメール
+description: メールとカレンダーをTwentyと同期します。
+icon: envelope
+---
+
+Twentyは既存のツールと連携し、手動でデータ入力を行わなくてもCRMが常に最新の状態に保たれるようにします。
+
+## メール同期
+
+**Google Workspace** または **Microsoft 365** のメールボックスを接続します。 接続後:
+
+* メールは、自動的に該当する会社および担当者レコードに関連付けられます
+* 各レコードのタイムラインでメールスレッド全体を確認できます
+* Twentyから直接メールを送信できます
+* 1ユーザーあたり複数のメールボックスに対応しています
+
+インポートする内容を制御できます。日付範囲や送信者でフィルタリングして、不要なメールの取り込みを防げます。
+
+## カレンダー同期
+
+接続したアカウントからカレンダーイベントが自動的に同期されます。 イベントは関連するCRMレコードに表示され、各担当者や会社とのやり取りを完全に把握できます。
+
+## 統合
+
+メールとカレンダーにとどまらず、Twentyは次の方法で外部ツールと連携します。
+
+| メソッド                | ユースケース                                 |
+| ------------------- | -------------------------------------- |
+| **API**             | GraphQL または REST API を使ってカスタム連携を構築できます |
+| **ウェブフック**          | レコードが変更された際に、リアルタイム通知を外部システムへ送信できます    |
+| **Zapier**          | コード不要で5,000以上のアプリと連携できます               |
+| **ワークフローHTTPアクション** | 自動化されたワークフローの一部として、任意の外部APIを呼び出せます     |
+
+## カスタムアプリ
+
+開発者はTwenty上に本格的なアプリを構築し、カスタムUIやサーバーサイドロジック、深い連携機能を追加できます。 アプリはコミュニティ向けに公開することも、非公開のままにすることもできます。
+
+<CardGroup cols={2}>
+  <Card title="カレンダーとメールのガイド" icon="envelope" href="/l/ja/user-guide/calendar-emails/overview">
+    メール同期とカレンダー同期を設定し、問題をトラブルシュートします。
+  </Card>
+  <Card title="APIと拡張機能" icon="plug" href="/l/ja/developers/extend/api">
+    Twenty APIを使ってカスタム連携を構築します。
+  </Card>
+</CardGroup>

packages/twenty-docs/l/ja/getting-started/core-concepts/dashboards.mdx

@@ -0,0 +1,37 @@
+---
+title: ダッシュボード
+description: カスタムダッシュボードを使用してパフォーマンスを追跡し、CRMデータを可視化します。
+icon: chart-bar
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+ダッシュボードを使うと、パイプラインの健全性、チームのパフォーマンス、収益トレンドなど、ビジネス指標をリアルタイムで可視化し、追跡したいあらゆる項目を確認できます。
+
+<VimeoEmbed videoId="1185511768" title="ダッシュボード" />
+
+## ウィジェット
+
+各ダッシュボードはウィジェットで構成されています。 ウィジェットは、CRMデータに紐づいた単一のチャートまたは指標です。 次の項目を設定できます：
+
+* **チャートタイプ** — 棒グラフ、折れ線グラフ、円グラフ、数値など
+* **データソース** — データモデル内の任意のオブジェクト（標準またはカスタム）
+* **フィルター** — 特定のレコード、日付範囲、セグメントに絞り込み
+* **集計** — 任意の数値フィールドに対する件数、合計、平均、最小、最大
+* **グルーピング** — 選択したフィールド、日付、またはリレーション別に内訳表示
+
+## 追跡できる内容
+
+* ステージ別のパイプラインの価値
+* クローズ済み案件数の推移
+* ソース別の平均案件規模
+* タスク完了率
+* 任意のオブジェクトに対するカスタム指標
+
+## 共有
+
+ダッシュボードはワークスペースレベルで管理され、チームの全員が閲覧できます。 ウィジェットをグリッドレイアウト上に配置してサイズを変更し、チームに最適なビューを作成できます。
+
+<Card title="ダッシュボードの詳細ガイド" icon="arrow-right" href="/l/ja/user-guide/dashboards/overview">
+  ダッシュボードの作成、ウィジェットの設定、およびチャート設定に関する詳細なリファレンスです。
+</Card>

packages/twenty-docs/l/ja/getting-started/core-concepts/data-model.mdx

@@ -0,0 +1,47 @@
+---
+title: データモデル
+description: Twenty が、オブジェクト、フィールド、リレーションを使ってデータをどのように構造化するかを理解しましょう。
+icon: database
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+Twenty では、すべてが **オブジェクト** と **フィールド** を中心に構築されています。これらがデータモデルの構成要素です。
+
+## オブジェクト
+
+オブジェクトは、データを保持するテーブルです。 Twenty には標準オブジェクトがあらかじめ用意されています:
+
+* **Companies** — ビジネス上の取引先となる組織
+* **People** — 個々の連絡先
+* **Opportunities** — パイプライン上の商談
+* **Tasks** — チーム向けのアクション項目
+* **Notes** — レコードに紐づけられた自由形式テキスト
+
+また、ビジネスニーズに応じて、プロジェクト、サポートチケット、商品、契約など、あらゆるものに対して **カスタムオブジェクト** を作成できます。
+
+## フィールド
+
+フィールドは、各オブジェクトに属するプロパティです。 Twenty は、幅広いフィールドタイプをサポートしています:
+
+| カテゴリ   | タイプ                                       |
+| ------ | ----------------------------------------- |
+| **基本** | テキスト、数値、ブール値、日付、通貨、評価、選択                  |
+| **複合** | 住所（番地、市区町村、都道府県、郵便番号）、氏名、リンク、電話番号、メールアドレス |
+| **特殊** | リレーション、ファイル添付、JSON、アクター（作成／更新したユーザー）      |
+
+すべてのオブジェクトには、自動的にシステムフィールド `id`、`createdAt`、`updatedAt`、`createdBy`、`position` が付与されます。
+
+## 関連
+
+オブジェクト同士は、リレーションを通じて接続されます。 1 つの Company には多数の People が紐づき、1 つの Opportunity は 1 つの Company に属する、といった形です。 あらゆるオブジェクト間で、カスタムリレーションを作成できます。多対多リレーションも含まれます。
+
+## これが強力な理由
+
+あらかじめ定義されたオブジェクトとフィールドに制限される従来型の CRM とは異なり、Twenty では、ビジネスの実態に合わせて、データを自在にモデリングできます。 カスタムオブジェクトも組み込みオブジェクトと同等の優先度で扱われ、API エンドポイント、ビュー、権限、ワークフロートリガーなどを利用できます。
+
+<Card title="データモデルを詳しく見る" icon="arrow-right" href="/l/ja/user-guide/data-model/overview">
+  オブジェクト、フィールド、リレーション、およびその設定方法に関する完全なリファレンス。
+</Card>
+
+<VimeoEmbed videoId="1185511827" title="データモデル" />

packages/twenty-docs/l/ja/getting-started/core-concepts/glossary.mdx

@@ -0,0 +1,105 @@
+---
+title: 用語集
+icon: book
+description: Twenty 全体を通して使用される主要な用語。
+---
+
+## API
+
+API（アプリケーションプログラミングインターフェース）は、Twentyを他のソフトウェアシステムと接続し、カスタム統合を構築することを可能にします。
+
+## アプリ
+
+アプリは、データモデルやロジック関数を定義できる、コードとして構築されたカスタム拡張機能です。 これにより、開発者は複数のワークスペースにデプロイ可能な再利用可能なカスタマイズを作成できます。
+
+## コードアクション
+
+コードアクションは、データの変換、計算、組み込みアクションでは実現できない複雑なロジックの実行のために、カスタムの JavaScript を記述できるワークフローのステップです。
+
+## コマンドメニュー
+
+コマンドメニューは、`Cmd + K`（Macの場合）、`Ctrl + K`（Windowsの場合）で開くことができるクイックアクセスインターフェースであり、操作を実行したり、レコードを作成したり、ワークスペースを効率的に移動したりすることを可能にします。
+
+## Company と People
+
+CRMには基本的な2つの種類のレコードがあります：
+
+* `Company`は企業や組織を表します。
+* `People`はあなたの企業の現在および潜在的な顧客を表します。
+
+## カスタムフィールド
+
+カスタムフィールドは、ビジネスのニーズとプロセスに特化した情報をキャプチャするために作成されたデータフィールドです。
+
+## データモデル
+
+データモデルとは、CRMで情報がどのように編成されているかを定義する構造であり、どのオブジェクトが存在するか、それらのプロパティ（フィールド）、およびそれらがどのように関連しているかを含みます。
+
+## お気に入り
+
+お気に入りとは、すぐにアクセスできるようにマークされたレコードであり、サイドバーに表示され、重要なデータへの即時ナビゲーションを可能にします。
+
+## フィールド
+
+フィールドとは、エンティティに特定のデータが保存される特定の領域を指します。
+
+## イテレータ
+
+イテレータは、アイテムの配列をループし、リスト内の各アイテムに対して後続のアクションを実行するワークフローアクションです。
+
+## カンバン
+
+`Kanban`は、カードと列を使ってビジネスプロセスを視覚的に追跡する方法です。 各列はプロセスの各ステージ（例：新規、進行中、成約、失注）を表し、進行に応じてレコードをこれらのステージへ移動します。
+
+## オブジェクト
+
+オブジェクトは、CRMで特定の種類のエンティティを表すデータ構造です（例：People、Companies、Opportunities）。 オブジェクトには、標準（ビルトイン）とカスタム（ユーザー作成）があります。
+
+## 商談
+
+Twenty CRMの商談は、アカウントや連絡先との潜在的な取引や販売を指します。
+
+## レコード
+
+レコードとは、特定のオブジェクトのインスタンスを示します。例：特定のアカウントまたは連絡先。
+
+## リレーションフィールド
+
+リレーションフィールドは異なるオブジェクト間の接続を作成し、レコード同士をリンクできます（例：人を会社に関連付ける）。
+
+## 標準フィールド
+
+標準フィールドは、デフォルトでオブジェクトに付属する事前に構築されたデータフィールドであり、すべてのワークスペースで共通の機能を提供します。
+
+## タスク
+
+Twenty CRMのタスクは、連絡先、アカウント、または商談に関連する、担当者に割り当てられるアクティビティです。
+
+## トリガー
+
+トリガーはワークフローの開始点、すなわち自動化を開始するイベントまたは条件です。 例としては、レコードの作成、レコードの更新、ウェブフック、スケジュールされた時刻などがあります。
+
+## ビュー
+
+ビューを使用してレコードの表示をカスタマイズし、フィルター、レイアウト、並べ替えオプションを各ビューに設定することができます。
+
+## アップサート
+
+アップサートは「update」と「insert」を組み合わせた操作で、一致が見つかった場合は既存のレコードを更新し、一致が存在しない場合は新しいレコードを作成します。
+
+## ウェブフック
+
+ウェブフックは、特定のイベントが発生したときにTwentyから他のアプリケーションへ送信される自動メッセージで、リアルタイムのデータ同期を可能にします。
+
+## ワークフロー
+
+ワークフローは特定の条件に基づいてアクションをトリガーする自動プロセスであり、繰り返しのタスクやビジネスプロセスを自動化するのに役立ちます。
+
+## ワークスペース
+
+`Workspace`は通常、Twentyを使用している企業を表します。 そこには、あなたやチームメンバーがTwentyに追加したすべてのレコードとデータが保存されます。
+ワークスペースには、通常、従業員のメールアドレスに使われる会社のドメイン名が1つ設定されています。
+
+## ワークスペースメンバー
+
+ワークスペースメンバーは、ワークスペースにアクセスできるあなたのチームのTwentyユーザーです。 レコードの所有者または担当者として割り当てることができます。

packages/twenty-docs/l/ja/getting-started/core-concepts/layout.mdx

@@ -0,0 +1,74 @@
+---
+title: レイアウト
+description: Twentyでのレコードのナビゲーション、閲覧、表示方法。
+icon: table-columns
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## メインレイアウト
+
+画面の中央は、あなたのレコードが存在する場所です。人物、企業、商談、タスク、メモ、ダッシュボード、ワークフロー、および任意のカスタムオブジェクトがここにあります。 ここでレコードを表示、編集、削除でき、新しいビューを作成できます。
+
+<img src="/images/user-guide/home/main-layout.png" style={{width:'100%'}} />
+
+## ナビゲーションバー
+
+左のサイドバーには、次のものがあります。
+
+* **ワークスペース切り替え** — ワークスペースを切り替えるか、新しいワークスペースを作成します（上部のドロップダウン）
+* **検索** — `/` を押してすぐにフォーカスし、すべてのオブジェクトを横断して検索します
+* **設定** — 左上からアクセス
+* **お気に入り** — 固定されたビュー。ユーザーごとに固有
+* **オブジェクトショートカット** — 人物、企業、商談 などへのクイックアクセス
+* **ワークフロー** — 自動化を作成
+
+ドラッグして項目の順序を変更し、関連するオブジェクトをグループ化するフォルダーを作成し、使用しないものは非表示にします。
+
+<img src="/images/user-guide/home/navigation-bar.png" style={{width:'100%'}} />
+
+## コマンドメニュー
+
+`Cmd+K`（Mac）または `Ctrl+K`（Windows）を押すか、右上の三点リーダーをクリックします。 ここから次のことができます：
+
+* 新しいレコードを作成
+* CSVでデータをインポートおよびエクスポート
+* 新しいビューを作成
+* 削除されたレコードにアクセスできます（Twenty はソフト削除とハード削除をサポートしています）
+* ワークスペースをナビゲートするためのキーボードショートカットを確認
+
+<img src="/images/user-guide/home/command-menu.png" style={{width:'100%'}} />
+
+## 検索
+
+コマンドメニュー、ナビゲーションバー上部、または `/` を押すことでアクセスできます。 検索はすべてのオブジェクトを横断して機能します。
+
+<img src="/images/user-guide/home/search-bar.png" style={{width:'100%'}} />
+
+## サイドパネル
+
+レコードをクリックすると、右側にサイドパネルが開きます。現在のページから離れることなく、レコードの主要な情報をすばやく概観できます。 **Open** をクリックして完全なレコードページに移動します。
+
+<img src="/images/user-guide/home/side-panel.png" style={{width:'100%'}} />
+
+## ビュー
+
+すべてのオブジェクトで複数のビューをサポートしており、オブジェクトごとに無制限に作成できます。 左上のドロップダウンを使用してビューを切り替えます。
+
+* **テーブル** — 表計算シート形式の行と列。グループ化、インライン編集、列のカスタマイズが可能
+* **カンバン** — 選択フィールド別に整理されたカードをドラッグ＆ドロップで操作。パイプラインに最適
+* **カレンダー** — 日付フィールドに基づいてレコードをプロットし、時間軸に沿った計画が可能
+
+各ビューは、フィルター、並べ替え、フィールドの可視性を個別に保存します。 ビューをワークスペースで共有することも、非公開のままにすることもできます。 ビューをお気に入りに登録して、サイドバーからすばやくアクセスできます。
+
+<img src="/images/user-guide/home/view-menu.png" style={{width:'100%'}} />
+
+## レコードページ
+
+レコードを開くと、詳細ページは設定可能な**タブ**と**ウィジェット**で構成されます。 グリッド上でウィジェットを追加、削除、並べ替え、サイズ変更できます。フィールド、関連レコード、メール、タイムライン、タスク、ノート、ファイル、チャート、iframe などがあります。 各オブジェクトタイプには固有のレイアウトがあります。
+
+<Card title="レイアウトの完全ガイド" icon="arrow-right" href="/l/ja/user-guide/layout/overview">
+  ナビゲーション、ビュー、レコードページについての詳細なリファレンスとハウツー。
+</Card>
+
+<VimeoEmbed videoId="1185511790" title="レイアウト" />

packages/twenty-docs/l/ja/getting-started/core-concepts/workflows.mdx

@@ -0,0 +1,55 @@
+---
+title: ワークフロー
+description: Twenty のビジュアルワークフロービルダーで、ビジネスプロセスを自動化しましょう。
+icon: bolt
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+ワークフローを使うと、繰り返しの作業を自動化し、コードを書くことなく（もちろん、必要であればコードを書くこともできます）Twenty を外部ツールと連携できます。
+
+<VimeoEmbed videoId="1185511711" title="ワークフロー" />
+
+## ワークフローの仕組み
+
+すべてのワークフローは、次の 3 つの要素で構成されます。
+
+1. **トリガー** — ワークフローを開始する条件
+2. **ステップ** — 次に行われる処理（1 つ以上のアクションの連続）
+3. **変数** — ステップ間を流れるデータ
+
+## トリガー
+
+| トリガー         | 実行タイミング                                   |
+| ------------ | ----------------------------------------- |
+| **レコードイベント** | レコードが作成、更新、削除、またはアップサートされたとき              |
+| **手動**       | ユーザーがボタンをクリックしたとき（単一レコード、複数レコード、またはグローバル） |
+| **スケジュール**   | 一定間隔での実行（cron 構文）                         |
+| **ウェブフック**   | 外部システムが HTTP POST を送信したとき                 |
+
+## アクション
+
+ワークフローでは、次のあらゆる組み合わせを連結できます。
+
+* **レコード操作** — レコードの作成、更新、検索、削除、またはアップサート
+* **メール送信** — 接続済みアカウントからメールを送信または下書き保存
+* **HTTP request** — 任意の外部 API を呼び出す
+* **Code** — 複雑なロジックのためにカスタム JavaScript を実行
+* **ブランチ** — if/else 条件でワークフローのパスを分岐
+* **Iterator** — データ配列をループ処理
+* **AI Agent** — AI エージェントにデータ処理を自律的に実行させる
+* **遅延** — 続行する前に待機
+* **フォーム** — ワークフローの途中でユーザー入力を収集
+
+## 構築できるもの
+
+* 案件が特定のステージに到達したときに Slack アラートを送信
+* 新しいコンタクトに外部 API のデータを自動で付加
+* 停滞している商談を検知して担当者に通知
+* Twenty と課金システム間でデータを同期
+* レコードデータから PDF や請求書を生成
+* 特定の条件に一致する受信メールに自動返信
+
+<Card title="ワークフローの完全ガイド" icon="arrow-right" href="/l/ja/user-guide/workflows/overview">
+  トリガー、アクション、変数、および実際の自動化レシピに関する詳細なリファレンス。
+</Card>