アプリテンプレート：フォークできる Helpdesk、HR、Project

フォークできるスターターパッケージ。`helpdesk`、`hr`、`project`。

テンプレートはフォークできるスターターパッケージです。それぞれが本物の形を持ったアプリで、マーケットプレイスからワンクリックでインストールすることも、CLI でクローンして拡張用の TypeScript のコードベースを手に入れることもできます。

テンプレートが存在する理由は 2 つあります。

説明するより見せる：動作する複数オブジェクトのアプリは、ドキュメントより速く読めます。
エンジニアリングチームに出発点を与える：データベース内の AI 生成メタデータだけでなく、コードをソース管理下に置きたいときのためです。

デフォルトカタログに含まれるもの

テンプレート	領域	フォークして作れるもの
`helpdesk`	AI ファーストのカスタマーサポート	チケット + SLA + AI コパイロット
`hr`	名簿、組織図、休暇	人を中心としたアプリ
`project`	プロジェクト / タスク / マイルストーンの管理	プロジェクト管理ツール

ソース：github.com/objectstack-ai/templates。Apache-2.0 です。断りなくフォークしてください。

30 秒でインストール（コードなし）

ObjectOS で：

Marketplace を開き → テンプレートを検索します。
Install をクリックします。
更新します。新しいアプリがナビゲーションに表示されます。

完了です。レコード、ビュー、フロー、権限がすべて稼働します。

コードベースとしてフォークする（エンジニア向け）

npm create objectstack@latest my-app
cd my-app
pnpm install
pnpm dev

スキャフォールダーはすべてのプロジェクトを blank テンプレートから始めます。コンテンツのテンプレートを名前で取得することはもうありません。ObjectStack 17.7 では、--template todo は廃止済みとして拒否されます。

プロジェクトは自己完結した pnpm パッケージです。編集、lint、テスト、コミットできる *.object.ts、*.view.ts、*.flow.ts ファイルです。満足したら：

pnpm build
os package publish   # → your marketplace

あなたのフォークをインストールする顧客は、あなたのブランドとあなたの変更を受け取ります。

すべてのテンプレートには、スコープと厳格な上限を宣言する CHARTER.md が付属します。典型的には、業務オブジェクトは 6 つ以下、src/ 以下は 2,500 行以下、アプリは 1 つ、デフォルトロケールは 1 つです。憲章は、テンプレートが中途半端な製品ではなくテンプレートであり続けるために存在します。フォークがこれらの上限を超えて大きくなったら、既存のものを肥大化させず、新しいテンプレートとして出荷してください。

ファイルの接尾辞のプロトコル（*.object.ts、*.state.ts、*.hook.ts など）、作成の順序（オブジェクト → 状態 → フック → ビュー → フロー → …）、作り直す代わりに再利用すべきポリモーフィックなプラットフォームサービス（sys_comment、sys_attachment、sys_audit_log）については、上流の TEMPLATE_GUIDE.md を参照してください。

出発点を選ぶ

構築しているもの	フォークするもの	理由
AI を使う顧客向けのもの全般	`helpdesk`	エージェント + チケットのコパイロットのパターン
人 / 組織図のアプリ	`hr`	名簿 + レポートライン

AI Builder とテンプレートを一緒に使う

テンプレートをフォークしても、その上で引き続き AI Builder を使えます。helpdesk をインストールしてから、こう伝えます。

「hd_ticket に、範囲 1〜5 の整数フィールド csat_score を追加して、クローズ時に入力を求めて。」

AI はインストールされたパッケージをその場で拡張します。変更はデプロイ内の稼働中のメタデータで、他の AI Builder の変更と同じように承認されます。それ自体でテンプレートのソースリポジトリに戻ることはありません。

次に進む

AI Builder：任意のテンプレートをチャットで拡張する
パッケージ：テンプレートの実体
マーケットプレイス：フォークを配布する
ObjectOS Community をローカルで実行する：開発者向けの道の端から端まで

テンプレート