🏢 Organization ブロック
Organization ブロックは、NodeBlocks アプリケーションにおける組織管理のための包括的な機能を提供します。これらのブロックは、作成、メンバー管理、ビジネスロジックを含む組織ライフサイクル操作を処理します。
🎯 概要
Organization ブロックは次のことを目的として設計されています:
- 完全な CRUD 操作で組織を管理
- メンバー管理と役割割り当てを処理
- 組織検証とビジネスルールを提供
- マルチテナントアプリケーションアーキテクチャをサポート
- 包括的なコントロールで組織管理を有効化
📦 ブロックタイプ
🔍 スキーマ
- organizationSchema: ベース組織エンティティ構造
- createOrganizationSchema: 組織作成検証
- updateOrganizationSchema: 組織更新検証
- getOrganizationSchema: 組織取得検証
- deleteOrganizationSchema: 組織削除検証
- organizationMembersSchema: メンバーの役割割り当て配列
- upsertOrganizationMembersSchema: メンバー役割アップサートペイロード
- getOrganizationMemberRoleSchema: メンバー役割取得
- checkOrganizationMemberExistenceSchema: メンバー存在チェック
- findOrganizationMembersSchema: メンバー一覧クエリ
- deleteOrganizationMemberSchema: メンバー削除検証
- findOrganizationsSchema: フィルタリングとページネーション付き組織検索
- findOrganizationsForMemberSchema: オプションの役割と継承付きメンバー別組織
- findOrganizationDescendantsSchema: オプションの深さ付き子孫取得
🔧 ブロック
- createOrganization: 組織作成
- getOrganizationById: 組織データ取得
- updateOrganization: 組織更新
- deleteOrganization: 組織削除
- findOrganizations: 組織検索とフィルタリング
- calculateDirectMemberRole: メンバーの直接役割を計算
- checkOrganizationMemberExistence: アイデンティティがメンバーかどうかをチェック
- findOrganizationMembers: ページネーションメタデータ付きメンバー一覧
- upsertOrganizationMembers: 既存メンバーとのマージでメンバー追加/更新
- deleteOrganizationMember: 組織からメンバーを削除
- findOrganizationsForMember: 特定のアイデンティティの組織一覧
- calculateChildAncestors: 親から子孫を計算
- buildDescendantsQuery: 子孫検索用のクエリ構築
- generateSignedLogoUploadUrl: ロゴアップロード用の署名付き URL 生成
🧰 ハンドラー
API レスポンスフォーマットのためのターミネーターと正規化ハンドラー:
- normalizeOrganizationTerminator: 単一組織レスポンスを正規化
- normalizeOrganizationsListTerminator: 組織リストレスポンスを正規化
- deleteOrganizationTerminator: 組織削除用の 204 レスポンスをフォーマット
- normalizeOrganizationMemberRoleTerminator: メンバー役割レスポンスを正規化
- normalizeOrganizationMemberExistenceTerminator: メンバーシップ存在レスポンスを正規化
- normalizeOrganizationMembersListTerminator: メンバーリストレスポンスを正規化
- deleteOrganizationMemberTerminator: メンバー削除用の 204 レスポンスをフォーマット
- upsertOrganizationMembersTerminator: メンバーアップサート用の 204 レスポンスをフォーマット
- normalizeOrganizationsForIdentityTerminator: アイデンティティ向け組織レスポンスを正規化
🛣️ ルート
- createOrganizationRoute: 作成ブロック付き POST
/organizations
- getOrganizationRoute: 取得ブロック付き GET
/organizations/:organizationId
- findOrganizationsRoute: 検索とページネーション付き GET
/organizations
- updateOrganizationRoute: 更新ブロック付き PATCH
/organizations/:organizationId
- deleteOrganizationRoute: 削除ブロック付き DELETE
/organizations/:organizationId
- getOrganizationMemberRoleRoute: 役割取得付き GET
/organizations/:organizationId/members/:identityId/role
- checkOrganizationMemberExistenceRoute: メンバーシップチェック付き GET
/organizations/:organizationId/members/check-existence
- findOrganizationMembersRoute: メンバー一覧付き GET
/organizations/:organizationId/members
- upsertOrganizationMembersRoute: メンバーアップサート付き PATCH
/organizations/:organizationId/members
- deleteOrganizationMemberRoute: メンバー削除付き DELETE
/organizations/:organizationId/members/:identityId
- findOrganizationsForMemberRoute: アイデンティティ組織付き GET
/organizations/members/:identityId
- findOrganizationDescendantsRoute: 子孫一覧付き GET
/organizations/:organizationId/descendants
- getLogoUploadUrlRoute: 署名付き URL 生成付き GET
/organizations/:organizationId/logo-upload-url
🚀 機能
- createOrganizationFeature: 検証とルーティング付き組織作成
- getOrganizationFeature: 個別組織を取得
- findOrganizationsFeature: フィルタリングとページネーション付き組織検索
- editOrganizationFeatures: 検証とルーティング付き組織更新
- deleteOrganizationFeatures: 組織を削除
- getOrganizationMemberFeatures: 組織内のメンバー役割を取得
- checkOrganizationMemberExistenceFeatures: 組織内のアイデンティティメンバーシップを検証
- findOrganizationMembersFeatures: ページネーション付き組織メンバーを一覧
- findOrganizationsForMemberFeatures: 特定のアイデンティティの組織を一覧
- upsertOrganizationMembersFeature: 検証付き組織メンバーをアップサート
- deleteOrganizationMemberFeatures: 組織メンバーを削除
- findOrganizationDescendantsFeatures: 子孫組織を取得
- getLogoUploadUrlFeature: ロゴアップロード用の署名付き URL を生成
✅ バリデーター
- hasOrgRole: 許可された役割と組織 ID に基づいて組織メンバー役割を検証
- validateOrganizationAccess (非推奨): レガシーアクセス検証関数;
hasOrgRole
に置き換えられました
🔗 関連ドキュメント
- Organization スキーマブロック - 組織データ検証とコントラクト
- Organization ハンドラーブロック - 組織ビジネスロジック関数
- Organization ルートブロック - HTTP エンドポイント定義
- Organization 機能ブロック - 完全な組織管理機能
- Organization バリデーターブロック - 組織検証関数