frappe-router

Frappe ルーター

タスクに応じて、適切な Frappe スキルに振り分けます。

使用するタイミング

• Frappe 関連の作業を始めるときの最初のステップ
• タスクにどの専門スキルが適しているか判断するとき

手順

0) タスクの種類を特定する

タスク	スキル
プロジェクト構成、バージョン、アプリを把握する	→ frappe-project-triage
新しいアプリ、フック、アーキテクチャ、バックグラウンドジョブを構築する	→ frappe-app-development
DocType、フィールド、コントローラーを作成・変更する	→ frappe-doctype-development
REST/RPC API、Webhook、インテグレーションを構築する	→ frappe-api-development
Desk UI、フォームスクリプト、リストビュー、JS API をカスタマイズする	→ frappe-desk-customization
Frappe UI を使った Vue 3 フロントエンドやポータルを構築する	→ frappe-frontend-development
CRM/Helpdesk/HRMS の UI/UX パターンを利用する	→ frappe-ui-patterns
印刷フォーマット、メールテンプレート、Jinja、PDF を作成する	→ frappe-printing-templates
レポート（Builder、Query、Script）を構築する	→ frappe-reports
データ収集用の公開 Web フォームを作成する	→ frappe-web-forms
テストを作成・実行する	→ frappe-testing
Docker/FM を使って開発環境をセットアップする	→ frappe-manager
CRM/Helpdesk/エンタープライズシステムを構築する	→ frappe-enterprise-patterns

1) まずトリアージを実行する（推奨）

本格的な作業に入る前に、frappe-project-triage を実行して、次の項目を把握します。

• プロジェクトの種類（bench/FM/standalone）
• Frappe のバージョン
• インストール済みアプリ
• 利用可能なツール

2) 必要に応じてスキルを組み合わせる

複雑なタスクでは、複数のスキルが必要になることがあります。

• 新しいアプリ = frappe-app-development + frappe-doctype-development + frappe-api-development + frappe-testing
• UI を伴う機能 = frappe-doctype-development + frappe-desk-customization + frappe-api-development
• カスタムフロントエンド = frappe-frontend-development + frappe-api-development
• ドキュメントのワークフロー = frappe-doctype-development + frappe-printing-templates + frappe-reports
• エンタープライズアプリ = frappe-enterprise-patterns + frappe-doctype-development

クイック判断ツリー

Is this about understanding the project?
  → frappe-project-triage

Is this about creating a new app or app architecture?
  → frappe-app-development

Is this about data models or DocTypes?
  → frappe-doctype-development

Is this about APIs or external access?
  → frappe-api-development

Is this about Desk UI, form scripts, or client-side JS?
  → frappe-desk-customization

Is this about a Vue 3 frontend or portal?
  → frappe-frontend-development

Is this about UI/UX patterns or app design?
  → frappe-ui-patterns

Is this about print formats, PDFs, or Jinja templates?
  → frappe-printing-templates

Is this about reports or data analysis views?
  → frappe-reports

Is this about public web forms?
  → frappe-web-forms

Is this about testing?
  → frappe-testing

Is this about local dev environment?
  → frappe-manager

Is this a complex enterprise system?
  → frappe-enterprise-patterns

ガードレール

• 不明なプロジェクトにコード変更を加える前に、必ず最初にトリアージを実行してください
• 機能を推奨する前に Frappe のバージョンを確認してください（API の利用可否は v13、v14、v15、v16 の間で大きく異なります）
• ERPNext を前提にしないでください。ERPNext を使わず、Frappe Framework のみを使うプロジェクトも多数あります
• サイトのコンテキストを確認してください。bench migrate などのコマンドは特定のサイトに影響します

よくある間違い

間違い	失敗する理由	修正方法
プロジェクトのトリアージを省略する	バージョンに合わないパターンを適用してしまう	必ず最初にトリアージを実行する
Frappe のみを使うプロジェクトで ERPNext 専用のコードを使う	モジュールが見つからないエラーが発生する	まずインストール済みアプリを確認する
タスクに合わないスキルを使う	実装が不完全になる	タスクの種類とスキルを慎重に照合する
バージョンの違いを無視する	非推奨または利用できない API を使ってしまう	スキルのリファレンスでバージョン互換性を確認する
間違ったサイトで作業する	変更が反映されない	必ず --site フラグを指定する
フロントエンドに vanilla JS/jQuery を使う	エコシステムに合わない	frappe-frontend-development を通じて Frappe UI（Vue 3）を使う
CRUD アプリにカスタムのアプリシェルを使う	UX に一貫性がなくなる	frappe-enterprise-patterns を通じて CRM/Helpdesk のパターンに従う