docyrus-platform

Docyrus Platform

Docyrus は、B2B の Web／モバイルアプリ、クライアントポータル、社内ツール、AI エージェント、チャットボット、インテグレーションを、バックエンドインフラストラクチャを一から構築することなく開発できる、AI ネイティブな Backend Platform as a Service（BPaaS）です。このスキルはアーキテクチャマップです。構成要素、それらの連携方法、各手順の専用スキルを紹介します。

コア構成要素

このプラットフォームは、アプリを構成する構成要素でできています。

• アプリ — データソース、自動化、エージェント、カスタムクエリをまとめ、デプロイ可能な単位にする最上位のコンテナーです。
• データソース — 型付きスキーマを持つ、構造化されたレコードのコレクションです。種類は、シンプル、アドバンスト、外部（接続先の DB／API）、システム（事前構築済み）の 4 つです。内部・外部を問わず、すべてのデータソースは単一の統合 CRUD エンドポイントを通じて公開されます。
• フィールド — 各データソースのスキーマを定義する 45 種類以上のフィールドタイプです。テキスト、数値、日付、選択肢、リレーション、ファイル、数式、ネストされたデータなどがあります。
• 列挙型 — 選択フィールドで使用する、再利用可能な選択肢セットです（色、アイコン、並び順）。
• カスタムクエリ — 変数の補間、実行時フィルター、複数データベースへの対応を備えた、SQL ベースの分析テンプレートです。
• 自動化 — イベント駆動型ワークフローです。トリガー（レコードの変更、スケジュール、Webhook、メール、Web フォーム、ボタン）から、アクションノードのチェーン（メール、通知、レコード操作、HTTP、AI、スクリプト）を実行します。

構成要素の詳細仕様：references/core-building-blocks.md。

タスク別のスキル

このスキルでは概念を説明します。作業には、各専用スキルを使用してください。

目的	使用するスキル
データソースを設計する（スキーマ、フィールド、リレーション、列挙型、アクセス権）	docyrus-data-source-design
自動化を構築する（トリガー＋アクションノードのグラフ）	docyrus-automation-design
カスタム AI エージェントとそのサブリソースを構築する	docyrus-agent-design
システムのベースエージェント「Docy」が呼び出す AI ツールを作成する	docyrus-app-ai-tools
メールテンプレートを設計する	docyrus-email-template-design
HTML／PDF の印刷・レポートテンプレートを設計する	docyrus-print-pdf-template-design
送信内容をレコードとして収集する公開 Web フォームを構築する	docyrus-webform-design
データソースのレコード作成／編集／表示フォームを設計する（グリッド、セクション、条件ルール）	docyrus-dynamic-form-design
テナントの ACL を設定する（ロール、階層単位、ロールルール）	docyrus-acl-design
サードパーティのインテグレーション／コネクターを検索して呼び出す（docyrus connect）	docyrus-integrations-and-connectors
データのクエリ／CRUD、フィルター／数式の記述、クエリペイロードの構築	docyrus-api-dev
DSQL（論理 SQL）クエリや、自然言語による dsql ask を記述する	docyrus-dsql-query-design
すべての操作をターミナルから実行する（認証、ds、studio、automation、agent など）	docyrus-cli-app
Docyrus 上に React アプリを構築する（コレクション、グリッド、フォーム）	docyrus-app-dev-react, docyrus-data-grid-page-design, docyrus-record-detail-form-design

機能領域（概念）

クエリとデータ操作

統合クエリエンジンでは、列の選択、50 種類以上のフィルター演算子、集計、数式、ピボット、子クエリ、全文検索を利用できます。一括操作、コメント、添付ファイルに対応した完全な CRUD 機能に加え、appSlug.dataSourceSlug テーブルを対象とする読み取り専用の論理 SQL エンドポイント（DSQL）も備えています。概念の概要：references/querying-and-data-operations.md。 → クエリペイロードと数式：docyrus-api-dev。DSQL（論理 SQL、dsql ask）：docyrus-dsql-query-design。ターミナルからのクエリ：docyrus-cli-app。

AI 機能

ツールのバインド、ナレッジベース、MCP サーバー、18 種類以上のモデルプロバイダー、エージェントの連鎖、タスクのスケジュール設定、永続メモリー、チャット連携、評価指標を備えた AI エージェントビルダーです。概念の概要：references/ai-capabilities.md。 → エージェントの構築：docyrus-agent-design。Docy が呼び出すツールの作成：docyrus-app-ai-tools。

自動化とワークフロー

イベント駆動型の自動化エンジンです。トリガーの種類とアクションノードの種類、条件分岐フロー、アクションチェーン、アーカイブに対応しています。概要：references/automation-and-workflows.md。 → 自動化の構築：docyrus-automation-design。

認証とマルチテナント

OAuth2 フロー（PKCE、Client Credentials、Device Code）、スコープベースの権限、テナントの分離、ロールベースおよびレコードレベルの ACL、React 認証ヘルパー、クライアントポータルに対応しています。概要：references/auth-and-multi-tenancy.md。 → ACL の設定：docyrus-acl-design。アプリコードでの OAuth：docyrus-api-dev。

インテグレーションとイベント

HTTP および SQL プロバイダー向けのコネクターフレームワーク、Webhook／イベント管理、コネクターの検出、共同ドキュメント編集、アプリ内メッセージ、通知、メールに対応しています。概要：references/integrations-and-events.md。 → コネクターの検出と使用（docyrus connect）：docyrus-integrations-and-connectors。Webhook／メッセージング CLI：docyrus-cli-app。

プラットフォームサービス

アプリテンプレート、データのインポート／エクスポート、レポートと分析、デプロイとバージョン管理、ローカライズとナビゲーション、監査ログ、請求に対応しています。概要：references/platform-services.md。 → 一般公開のデータ収集用 Web フォームは、独立したスキルです：docyrus-webform-design。

開発者ツール

自動生成される OpenAPI 仕様、MCP サーバー、高機能な CLI、REST API クライアントライブラリ、React 認証プロバイダー、自動生成されるコレクションフックに対応しています。概要：references/developer-tools.md。 → CLI コマンドの完全な一覧：docyrus-cli-app（フラグは docyrus <cmd> --help で確認できます）。REST クライアント、クエリペイロード、数式：docyrus-api-dev。