メインコンテンツまでスキップ
バージョン: 0.5.0 (最新)

🏢 Organization ブロック

Organization ブロックは、NodeBlocks アプリケーションにおける組織管理のための包括的な機能を提供します。これらのブロックは、作成、メンバー管理、ビジネスロジックを含む組織ライフサイクル操作を処理します。


🎯 概要

Organization ブロックは次のことを目的として設計されています:

  • 完全な CRUD 操作で組織を管理
  • メンバー管理と役割割り当てを処理
  • 組織検証とビジネスルールを提供
  • マルチテナントアプリケーションアーキテクチャをサポート
  • 包括的なコントロールで組織管理を有効化

📦 ブロックタイプ

🔍 スキーマ

  • organizationSchema: ベース組織エンティティ構造
  • createOrganizationSchema: 組織作成検証
  • updateOrganizationSchema: 組織更新検証
  • getOrganizationSchema: 組織取得検証
  • deleteOrganizationSchema: 組織削除検証
  • organizationMembersSchema: メンバーの役割割り当て配列
  • upsertOrganizationMembersSchema: メンバー役割アップサートペイロード
  • getOrganizationMemberRoleSchema: メンバー役割取得
  • checkOrganizationMemberExistenceSchema: メンバー存在チェック
  • findOrganizationMembersSchema: メンバー一覧クエリ
  • deleteOrganizationMemberSchema: メンバー削除検証
  • findOrganizationsSchema: フィルタリングとページネーション付き組織検索
  • findOrganizationsForMemberSchema: オプションの役割と継承付きメンバー別組織
  • findOrganizationDescendantsSchema: オプションの深さ付き子孫取得

Organization スキーマブロックを表示 →

🔧 ブロック

  • createOrganization: 組織作成
  • getOrganizationById: 組織データ取得
  • updateOrganization: 組織更新
  • deleteOrganization: 組織削除
  • findOrganizations: 組織検索とフィルタリング
  • calculateDirectMemberRole: メンバーの直接役割を計算
  • checkOrganizationMemberExistence: アイデンティティがメンバーかどうかをチェック
  • findOrganizationMembers: ページネーションメタデータ付きメンバー一覧
  • upsertOrganizationMembers: 既存メンバーとのマージでメンバー追加/更新
  • deleteOrganizationMember: 組織からメンバーを削除
  • findOrganizationsForMember: 特定のアイデンティティの組織一覧
  • calculateChildAncestors: 親から子孫を計算
  • buildDescendantsQuery: 子孫検索用のクエリ構築
  • generateSignedLogoUploadUrl: ロゴアップロード用の署名付き URL 生成

Organization ブロックを表示 →

🧰 ハンドラー

API レスポンスフォーマットのためのターミネーターと正規化ハンドラー:

  • normalizeOrganizationTerminator: 単一組織レスポンスを正規化
  • normalizeOrganizationsListTerminator: 組織リストレスポンスを正規化
  • deleteOrganizationTerminator: 組織削除用の 204 レスポンスをフォーマット
  • normalizeOrganizationMemberRoleTerminator: メンバー役割レスポンスを正規化
  • normalizeOrganizationMemberExistenceTerminator: メンバーシップ存在レスポンスを正規化
  • normalizeOrganizationMembersListTerminator: メンバーリストレスポンスを正規化
  • deleteOrganizationMemberTerminator: メンバー削除用の 204 レスポンスをフォーマット
  • upsertOrganizationMembersTerminator: メンバーアップサート用の 204 レスポンスをフォーマット
  • normalizeOrganizationsForIdentityTerminator: アイデンティティ向け組織レスポンスを正規化

Organization ハンドラーブロックを表示 →

🛣️ ルート

  • 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

Organization ルートブロックを表示 →

🚀 機能

  • createOrganizationFeature: 検証とルーティング付き組織作成
  • getOrganizationFeature: 個別組織を取得
  • findOrganizationsFeature: フィルタリングとページネーション付き組織検索
  • editOrganizationFeatures: 検証とルーティング付き組織更新
  • deleteOrganizationFeatures: 組織を削除
  • getOrganizationMemberFeatures: 組織内のメンバー役割を取得
  • checkOrganizationMemberExistenceFeatures: 組織内のアイデンティティメンバーシップを検証
  • findOrganizationMembersFeatures: ページネーション付き組織メンバーを一覧
  • findOrganizationsForMemberFeatures: 特定のアイデンティティの組織を一覧
  • upsertOrganizationMembersFeature: 検証付き組織メンバーをアップサート
  • deleteOrganizationMemberFeatures: 組織メンバーを削除
  • findOrganizationDescendantsFeatures: 子孫組織を取得
  • getLogoUploadUrlFeature: ロゴアップロード用の署名付き URL を生成

Organization 機能ブロックを表示 →

バリデーター

  • hasOrgRole: 許可された役割と組織 ID に基づいて組織メンバー役割を検証
  • validateOrganizationAccess (非推奨): レガシーアクセス検証関数;hasOrgRole に置き換えられました

Organization バリデーターブロックを表示 →


🔗 関連ドキュメント