Organization API

Multi-platform organizational resource discovery and traversal for GCP and Git repositories.

What It Does

The Organization API manages and navigates complex organizational hierarchies spanning Google Cloud Platform and Git repositories. It provides unified discovery of cloud infrastructure and application projects with visitor pattern traversal and intelligent filtering.

Key Capabilities

• Multi-Platform Discovery: GCP folders/projects and Git repositories
• Hierarchical Traversal: Navigate organizational structures with visitor pattern
• Intelligent Filtering: Filter by platform, repository, folder, project, app
• GCP Integration: Automatic project discovery from Resource Manager
• Git Repository Scanning: Discover Angular projects in repositories
• Performance Optimization: Folder caching to reduce API calls
• Extensible Visitors: Custom processing via visitor implementations

Main Components

OrganizationService

visitOrganization(organization, visitor, filters?, visitOrder?)

Orchestrates traversal of organizational resources.

GitRepositoryService

• Load repositories from filesystem or remote
• List directories and check file existence
• Support for owner nesting and overrides

Visitor Pattern

interface IOrganizationVisitor {
  visitPlatform(platform)
  visitBackendRepository(repo)
  visitFrontendRepository(repo)
  visitDiscoveredAngularProject(project)
  visitFolder(folder)
  visitDiscoveredGcpProject(project)
  reportFilteredOut*()
  reportUnknown*()
}

Organization Structure

Organization {
  gcpOrganizationId: string
  platforms: Platform[]
}
 
Platform {
  key: string
  git?: {owner, backends[], frontends[]}
  gcp?: {folders: GcpFolder[]}
  domains?: DomainConfig
}

Common Use Cases

• Infrastructure auditing across GCP organization
• Application discovery in mono-repos
• Cross-platform resource management
• Automated documentation generation
• Batch operations across projects
• Service inventory and cataloging

What Customers Don’t Have to Build

• GCP Resource Manager integration
• Folder hierarchy traversal
• Git repository discovery
• Angular project detection
• Visitor pattern infrastructure
• Filtering and reporting logic
• Multi-platform orchestration