🏠 Overview › 🧩 Components ›🧩 Organization Service

Organization Service

Component Detail

Service Layer medium complexity backend
1
Dependencies
1
Dependents
10
Entities
0
Integrations

Description

Backend service handling organization settings CRUD operations via the REST API endpoint PATCH /api/v1/organizations/:id. Enforces row-level security ensuring only Org Admin or Global Admin roles can modify settings, and wraps changes in PostgreSQL transactions for consistency.

Feature: Organization Settings

organization-service

Responsibilities

  • Process organization settings updates via PATCH endpoint
  • Enforce role-based access control for settings modification
  • Execute settings changes within database transactions
  • Handle logo file storage to object storage with CDN URL generation
  • Propagate settings changes across admin portal and mobile app in real time

Interfaces

getOrganizationSettings(orgId: string): OrganizationSettings
updateOrganizationSettings(orgId: string, data: Partial<OrganizationSettings>): OrganizationSettings
uploadOrganizationLogo(orgId: string, file: File): string
deleteOrganizationLogo(orgId: string): void
validateAdminAccess(userId: string, orgId: string): boolean
getAvailableLanguages(): Language[]
getAvailableRegionalFormats(): RegionalFormat[]

Relationships

Dependencies (1)

Components this component depends on

data Organization Config Store

Dependents (1)

Components that depend on this component

ui Organization Settings Page

Related Data Entities (10)

Data entities managed by this component

Local Association 13 fields core Organization 17 fields core Organization Setting 21 fields configuration Achievement Types 17 fields configuration Certification Types 17 fields configuration External Links 14 fields configuration Local Associations 17 fields core Organization Settings 27 fields configuration Organizations 25 fields core User Roles 13 fields core