📂 カテゴリブロック
カテゴリブロックは、NodeBlocks アプリケーションにおける階層カテゴリ構造の管理のための包括的な機能を提供します。これらのブロックは、親子関係のサポートを使用して、カテゴリの作成、更新、取得、検索操作を処理します。
🎯 概要
カテゴリブロックは次のことを目的として設計されています:
- 親子関係を使用した階層カテゴリを管理する
- 有効化/無効化操作でカテゴリライフサイクルをサポートする
- カテゴリ検索とフィルタリング機能を有効にする
- カテゴリ管理のための CRUD 操作を提供する
- 大規模なカテゴリコレクションのためにページネーションをサポートする
📦 ブロックタイプ
🔍 スキーマ
カテゴリデータ検証のための JSON Schema 定義:
- categorySchema: ベースカテゴリ構造
- createCategorySchema: カテゴリ作成検証
- updateCategorySchema: カテゴリ変更
- getCategorySchema: カテゴリ取得
- deleteCategorySchema: カテゴリ削除
- enableCategorySchema: カテゴリ有効化
- disableCategorySchema: カテゴリ無効化
- findCategoriesSchema: フィルタリングとページネーションを使用したカテゴリ検索
⚙️ ハンドラー
カテゴリ操作のためのコアビジネスロジック:
- createCategory: 階層サポートを使用したカテゴリ作成
- getCategoryById: カテゴリデータ取得
- findCategories: カテゴリ検索とフィルタリング
- updateCategory: カテゴリ変更
- enableCategory: カテゴリ有効化
- disableCategory: カテゴリ無効化
- deleteCategory: クリーンアップを使用したカテゴリ削除
🛣️ ルート
カテゴリ操作のための HTTP エンドポイント定義:
- createCategoryRoute: 作成ハンドラー付きの POST
/categories
- getCategoryRoute: 取得ハンドラー付きの GET
/categories/:categoryId
- findCategoriesRoute: 検索とページネーション付きの GET
/categories
- updateCategoryRoute: 更新ハンドラー付きの PATCH
/categories/:categoryId
- enableCategoryRoute: 有効化ハンドラー付きの POST
/categories/:categoryId/enable
- disableCategoryRoute: 無効化ハンドラー付きの POST
/categories/:categoryId/disable
- deleteCategoryRoute: 削除ハンドラー付きの DELETE
/categories/:categoryId
🚀 機能
スキーマ、ルート、ハンドラーを組み合わせた完全なカテゴリ管理機能:
- createCategoryFeature: 検証とルーティングを使用したカテゴリ作成
- getCategoryFeatures: アクセス制御を使用したカテゴリ取得
- findCategoriesFeatures: フィルタリングとページネーションを使用したカテゴリ検索
- editCategoryFeatures: 検証とアクセス制御を使用したカテゴリ更新
- enableCategoryStatusFeatures: カテゴリ有効化機能
- disableCategoryStatusFeatures: カテゴリ無効化機能
- editCategoryStatusFeatures: 完全なカテゴリステータス管理
- deleteCategoryFeatures: 適切な検証とクリーンアップを使用したカテゴリ削除
✅ バリデーター
カテゴリ操作のための検証関数:
- doesCategoryExist: 操作前にカテゴリの存在を検証
🔗 関連ドキュメント
- カテゴリスクーマブロック - カテゴリデータ検証とコントラクト
- カテゴリハンドラーブロック - ビジネスロジックとカテゴリ操作
- カテゴリルートブロック - HTTP エンドポイント定義
- カテゴリ機能ブロック - 完全なカテゴリ管理機能
- カテゴリバリデーターブロック - カテゴリ検証関数