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