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>

packages/twenty-docs/l/ja/getting-started/introduction.mdx

@@ -0,0 +1,53 @@
+---
+title: なぜ Twenty なのか
+icon: heart
+---
+
+import { CardTitle } from "/snippets/card-title.mdx"
+
+あなたはこれまで、導入は簡単だが変更がほぼ不可能なソフトウェアか、高い柔軟性はあるもののセットアップに数カ月かかるソフトウェアか、そのどちらかを選ばざるをえませんでした。 Twenty は第3の選択肢です。**本番環境ですぐ使える、使いながら自在に作り替えられる CRM。**
+
+## Twenty が特別な理由
+
+Twenty は「設定して使うプロダクト」ではなく、「その上に構築できるプラットフォーム」です。
+
+<CardGroup cols={2}>
+  <Card img="/images/user-guide/halftone/ai.png">
+    <CardTitle>エージェントのために構築</CardTitle>
+    エージェントは、適切な権限であなたのデータモデル内で動作します。 スキル、ツール、MCP。
+  </Card>
+  <Card img="/images/user-guide/halftone/permissions.png">
+    <CardTitle>セキュアな拡張性</CardTitle>
+    セキュアな基盤の上で、vibe-coded なツールと同等の柔軟性を実現します。
+  </Card>
+  <Card img="/images/user-guide/halftone/dev-api.png">
+    <CardTitle>モダンなスタック</CardTitle>
+    React、TypeScript。 あなたのチームは、すでに Twenty を拡張する方法を知っています。 独自仕様の言語も、ゲートキーピングもありません。
+  </Card>
+  <Card img="/images/user-guide/halftone/dev-self-host.png">
+    <CardTitle>ロックインなし</CardTitle>
+    オープンソースのコア、セルフホスト可能、いつでもデータをエクスポートできます。
+  </Card>
+</CardGroup>
+
+## Twenty は誰のためのものか
+
+* **Salesforce を置き換えたい大企業** — チームはツールを活用するよりも、その制約と戦うことに多くの時間を費やしています。
+  ロックインされていると感じ、コストは上がり続けています。
+* **技術系ファウンダーが率いるスタートアップ** — スプレッドシートや Notion では、すでに限界を迎えています。 大きな野心を持ち、それに合わせてスケールできる CRM を求めています。
+* **優位性を求める GTM チーム** — 独自のリードスコアリングや独自のエンリッチメント、独自のアウトバウンドワークフローを構築したいチーム。
+* **プライバシーを重視する組織** — セルフホストし、データを最初から最後まで自分たちで保有する必要があります。 それが規制上の理由であれ、契約上の理由であれ、あるいは単なる信念であれ。
+* **Salesforce パートナー** —
+  あなたの開発者は、クライアントにライセンス費用の値上げを説明することにうんざりしています。
+  より良い DX を実現し、クライアント向けプロジェクトを、より低いライセンスコストで、より速く提供したいと考えています。
+* **Web 開発代理店** — チームは TypeScript、React、PostgreSQL に精通しています。 Twenty は、APEX を学んだり独自の認定を取得したりすることなく、CRM 市場への扉を開きます。
+
+## Twenty が向かない場合
+
+* **一切気にせずに済む CRM を求めるチーム。** Twenty は、自分たちのツールに常に向き合い、時間をかけて作り込んでいくチームにこそ報いるプロダクトです。 完全マネージドなものを望むのであれば、Pipedrive や HubSpot の方が適しているでしょう。
+* **今すぐ何百もの事前構築済み連携が必要な企業。** Twenty のエコシステムは急速に成長していますが、Salesforce や HubSpot ほどの広がりには、まだ達していません。 足りない部分を自分で構築することに抵抗がなければ、きっと気に入っていただけます。 そうでなければ、もう 1 年お待ちください。
+* **ツールを実際に使う現場ではなく、役員会でツールが選定される組織。** 私たちは高級ディナーやエグゼクティブ向けブリーフィングは行いません。 自分たちのツールを自分たちで選ぶ権限を持つチームとともに勝ちたいと考えています。
+
+<Card title="準備はできましたか？" icon="rocket" href="/l/ja/getting-started/quickstart">
+  クラウド環境でもセルフホスト環境でも、5 分以内に Twenty をセットアップしましょう。
+</Card>

packages/twenty-docs/l/ja/getting-started/key-features.mdx

@@ -0,0 +1,70 @@
+---
+title: 主な機能
+description: Twenty が実現できるすべてのことを紹介します — カスタムデータモデルから AI を活用した自動化まで。
+icon: star
+---
+
+import { CardTitle } from "/snippets/card-title.mdx"
+
+Twenty は、フル機能を備えた CRM プラットフォームです。 それを使って、次のようなものを構築できます。
+
+<CardGroup cols={2}>
+  <Card href="/l/ja/user-guide/data-model/overview" img="/images/user-guide/halftone/data-model.png">
+    <CardTitle>カスタムデータモデル</CardTitle>
+    ビジネスに必要なデータ構造を、正確に定義できます。
+    <br />カスタムオブジェクトを作成し、20 を超えるフィールドタイプでカスタムフィールドを追加し、任意のオブジェクト同士の関係を構築できます。
+  </Card>
+
+  <Card href="/l/ja/user-guide/views-pipelines/overview" img="/images/user-guide/halftone/layout.png">
+    <CardTitle>ビューとパイプライン</CardTitle>
+    テーブルビュー、かんばんボード、カレンダービューを切り替えて利用できます。
+    <br />AND/OR ロジックでフィルターし、複数フィールドでソートし、レコードをグループ化して、カスタムビューとして保存できます。
+  </Card>
+
+  <Card href="/l/ja/user-guide/workflows/overview" img="/images/user-guide/halftone/workflows.png">
+    <CardTitle>ワークフローと自動化</CardTitle>
+    コードを書かずに、あらゆるビジネスプロセスを自動化できます。
+    <br />レコードの変更、スケジュール、手動アクション、受信 Webhook をトリガーにしてワークフローを実行できます。
+  </Card>
+
+  <Card href="/l/ja/user-guide/calendar-emails/overview" img="/images/user-guide/halftone/calendar-emails.png">
+    <CardTitle>カレンダーとメールの同期</CardTitle>
+    Google Workspace または Microsoft 365 アカウントを接続できます。
+    <br />メールとカレンダーイベントは、関連する CRM レコード上に自動で表示されます。
+  </Card>
+
+  <Card href="/l/ja/user-guide/ai/overview" img="/images/user-guide/halftone/ai.png">
+    <CardTitle>AI</CardTitle>
+    CRM 内で自律的に動作する AI エージェントが、質問への回答、レコードの拡充、権限モデルに基づく複数ステップのタスクの実行を行います。
+  </Card>
+
+  <Card href="/l/ja/user-guide/dashboards/overview" img="/images/user-guide/halftone/dashboards.png">
+    <CardTitle>ダッシュボードとレポート</CardTitle>
+    リアルタイムウィジェットでカスタムダッシュボードを構築できます。
+    <br />設定可能なチャートとフィルターにより、パイプラインの指標、チームのパフォーマンス、ビジネスの KPI を追跡できます。
+  </Card>
+
+  <Card href="/l/ja/user-guide/permissions-access/overview" img="/images/user-guide/halftone/permissions.png">
+    <CardTitle>権限とアクセス制御</CardTitle>
+    オブジェクト、フィールド、個々のレコードなど、あらゆるレベルでロールベースのアクセス制御を行えます。
+    <br />SAML または OIDC を使って SSO を構成できます。 監査ログで、誰が何をしたかを追跡できます。
+  </Card>
+
+  <Card href="/l/ja/developers/extend/api" img="/images/user-guide/halftone/dev-api.png">
+    <CardTitle>API と拡張性</CardTitle>
+    カスタムデータモデルに適応する、開発者優先の API を提供します。
+    <br />GraphQL と REST の両方のエンドポイントを備え、ワークスペースごとに自動生成されたドキュメントが用意されています。
+  </Card>
+
+  <Card href="/l/ja/user-guide/data-migration/overview" img="/images/user-guide/halftone/data-migration.png">
+    <CardTitle>データのインポートとエクスポート</CardTitle>
+    CSV ファイルまたは API 経由でデータをインポートできます。
+    <br />フィールドマッピング、重複検出、エラーハンドリングが組み込まれています。 必要なときにいつでもデータをエクスポートでき、ロックインはありません。
+  </Card>
+
+  <Card href="/l/ja/developers/self-host/self-host" img="/images/user-guide/halftone/dev-self-host.png">
+    <CardTitle>セルフホスティング</CardTitle>
+    単一の Docker Compose コマンドで、独自のインフラ上に Twenty を実行できます。
+    <br />データを完全に制御でき、アップデートも自社のスケジュールで行えます。
+  </Card>
+</CardGroup>

packages/twenty-docs/l/ja/getting-started/quickstart.mdx

@@ -0,0 +1,73 @@
+---
+title: クイックスタート
+description: クラウド環境でもセルフホスト環境でも、5分以内に Twenty をセットアップして稼働させましょう。
+icon: play
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## サインアップ
+
+<Steps>
+  <Step title="アカウントを作成する">
+    [app.twenty.com](https://app.twenty.com) にアクセスし、Google、Microsoft、またはメールでサインアップします。
+  </Step>
+  <Step title="トライアルを選択">
+    **30日間**（カードあり）または **7日間**（カードなし）から選択します。 どちらもフルアクセスが含まれます — 連絡先は無制限、メール連携、カスタムオブジェクト、API を利用できます。 プランや請求サイクルはいつでも変更できます。
+  </Step>
+  <Step title="ワークスペースの作成">
+    Stripe で支払いが確認されたら、ワークスペース名とユーザープロファイルを設定します。 いつでもキャンセルできます。
+  </Step>
+</Steps>
+
+<VimeoEmbed videoId="1185227242" title="ワークスペースを作成" />
+
+## ワークスペースを構成する
+
+ログインできたら、Twenty を自分用にするための 3 ステップがあります。
+
+### 1. メールボックスを接続する
+
+**Settings → Accounts** に移動し、Google または Microsoft アカウントを接続します。 Twenty がメールとカレンダーの予定をインポートし、やり取りから自動的に連絡先を作成します。 ほかのプロバイダーを利用していますか？ 同じページから、SMTP でメールボックスを、CalDAV でカレンダーを追加できます。
+
+<Note>ここから始めましょう — メールボックスを接続すると、他のカスタマイズを行う前に、実データによる即時の価値をチームにもたらせます。</Note>
+
+<VimeoEmbed videoId="1185416821" title="メールボックスを接続する" />
+
+### 2. データモデルを設計する
+
+**Settings → Data Model** に移動して、カスタムオブジェクトとフィールドを作成します。 知っておくべきこと：
+
+* カスタムオブジェクトとフィールドは **すべてのプランで無制限** です — アップセルはありません。
+* **People、Companies、Opportunities** は、同期されたメールとミーティングが表示されるオブジェクトです。 これらをベースとして使用し、メール履歴が残らない別オブジェクトを作成するのではなく、フィールド（例：`Person Type` フィールド）を追加して分類しましょう。
+* 2 人の People が同じメールアドレスを共有することはできません。 2 つの Companies が同じドメインを共有することはできません。
+* 不要な標準フィールドや標準オブジェクトは無効化でき、削除せずにビューからフィールドを非表示にできます。
+
+[データモデルリファレンス →](/l/ja/user-guide/data-model/overview)
+
+<VimeoEmbed videoId="1185416793" title="データモデルを設計する" />
+
+### 3. データのインポート
+
+Command メニュー（`Cmd+K` / `Ctrl+K`）を使用して、CSV 経由で People、Companies、Opportunities、または任意のカスタムオブジェクトをインポートします。 まずサンプルファイルをダウンロードして、想定される形式を確認してください。 ファイルは 1 万件までに制限し、インポート前にメールアドレスやドメインの重複を削除してください。
+
+[データ移行ガイド →](/l/ja/user-guide/data-migration/overview)
+
+<VimeoEmbed videoId="1185416775" title="データのインポート" />
+
+## 次のステップ
+
+<CardGroup cols={2}>
+  <Card title="レイアウトを理解する" icon="table-columns" href="/l/ja/getting-started/core-concepts/layout">
+    ナビゲーション、ビュー、コマンドメニュー、サイドパネル。
+  </Card>
+  <Card title="ワークフローを構築" icon="bolt" href="/l/ja/user-guide/workflows/overview">
+    ビジネスプロセスを自動化します。
+  </Card>
+  <Card title="ビューを作成" icon="table" href="/l/ja/user-guide/layout/overview">
+    テーブル、かんばん、カレンダー — データをフィルターおよびソートします。
+  </Card>
+  <Card title="API を探索" icon="plug" href="/l/ja/developers/extend/api">
+    テナントごとのスキーマによる REST と GraphQL。
+  </Card>
+</CardGroup>