# rahulrzn/soho-suite architecture

> Architecture diagram of the GitHub repository rahulrzn/soho-suite, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/rahulrzn/soho-suite
- Repository: https://github.com/rahulrzn/soho-suite

## Overview

SOHO Suite is a small-business workspace with a React client and Spring Boot API. Users sign in through Firebase, then manage business profiles and team access, import and review datasets, and use analytics, expense, inventory, activity, and export features. The README establishes the client/API authentication and persistence boundary; source excerpts and the index show selected service dependencies. Several feature internals are unsampled, so their documented capabilities are represented without inferring unshown call chains.

Main entry points: [`backend/src/main/java/com/sohosuite/backend/BackendApplication.java`](https://github.com/rahulrzn/soho-suite/blob/main/backend/src/main/java/com/sohosuite/backend/BackendApplication.java) (Spring Boot API), [`frontend/src/app/App.tsx`](https://github.com/rahulrzn/soho-suite/blob/main/frontend/src/app/App.tsx) (React workspace), [`backend/src/main/java/com/sohosuite/backend/activity/service/BusinessActivityService.java`](https://github.com/rahulrzn/soho-suite/blob/main/backend/src/main/java/com/sohosuite/backend/activity/service/BusinessActivityService.java) (Business activity), [`backend/src/main/java/com/sohosuite/backend/dataset/service/DatasetService.java`](https://github.com/rahulrzn/soho-suite/blob/main/backend/src/main/java/com/sohosuite/backend/dataset/service/DatasetService.java) (Dataset import)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web workspace"]
  node_web["React workspace<br/>[App.tsx]"]
  node_api_client["API client<br/>[apiClient.ts]"]
end

subgraph group_identity["Identity and access"]
  node_auth["Sign-in flows<br/>[authService.ts]"]
  node_firebase_web["Firebase client<br/>[firebase.ts]"]
end

subgraph group_business["Business operations"]
  node_business_ui["Business and team<br/>[WorkspacePage.tsx]"]
  node_operations_ui["Expenses and stock<br/>[ExpensesPage.tsx]"]
  node_activity_ui["Activity and reports<br/>[ActivityPage.tsx]"]
  node_business_service["Business management"]
  node_collaboration["Invitations and transfer"]
  node_expense_service["Expense tracking"]
  node_inventory_service["Inventory tracking"]
  node_activity_service["Business activity"]
end

subgraph group_data["Data and insights"]
  node_dataset_ui["Dataset review<br/>[DatasetPage.tsx]"]
  node_analytics_ui["Analytics views<br/>[AnalyticsPage.tsx]"]
  node_dataset_service["Dataset import"]
  node_analytics_service["Sales analytics"]
  node_export_service["Report exports"]
end

subgraph group_platform["API and persistence"]
  node_api["Spring Boot API"]
  node_membership_store[("Membership records")]
end

node_user(("Workspace user"))
node_firebase{{"Firebase Authentication"}}
node_postgres[("PostgreSQL")]

node_user -->|"uses"| node_web
node_user -->|"signs in"| node_auth
node_auth -->|"uses"| node_firebase_web
node_firebase_web -->|"authenticates"| node_firebase
node_web -->|"makes API calls"| node_api_client
node_api_client -->|"gets ID tokens"| node_auth
node_api_client -->|"sends bearer token"| node_api
node_web -->|"opens workspace"| node_business_ui
node_web -->|"opens imports"| node_dataset_ui
node_web -->|"opens analytics"| node_analytics_ui
node_web -->|"opens operations"| node_operations_ui
node_web -->|"opens history"| node_activity_ui
node_api -->|"serves business routes"| node_business_service
node_api -->|"serves collaboration"| node_collaboration
node_api -->|"serves dataset routes"| node_dataset_service
node_api -->|"serves analytics"| node_analytics_service
node_api -->|"serves expenses"| node_expense_service
node_api -->|"serves inventory"| node_inventory_service
node_api -->|"serves activity"| node_activity_service
node_api -->|"serves exports"| node_export_service
node_business_service -->|"records events"| node_activity_service
node_collaboration -->|"records events"| node_activity_service
node_dataset_service -->|"records events"| node_activity_service
node_inventory_service -->|"records events"| node_activity_service
node_expense_service -->|"records events"| node_activity_service
node_dataset_service -->|"checks roles"| node_membership_store
node_business_service -->|"manages membership"| node_membership_store
node_api -->|"persists business data"| node_postgres
node_dataset_service -->|"stores dataset rows"| node_postgres
node_analytics_service -->|"analyzes confirmed mappings"| node_dataset_service
node_export_service -->|"exports analytics"| node_analytics_service

click node_web "https://github.com/rahulrzn/soho-suite/blob/main/frontend/src/app/App.tsx"
click node_auth "https://github.com/rahulrzn/soho-suite/blob/main/frontend/src/auth/authService.ts"
click node_firebase_web "https://github.com/rahulrzn/soho-suite/blob/main/frontend/src/firebase.ts"
click node_api_client "https://github.com/rahulrzn/soho-suite/blob/main/frontend/src/api/apiClient.ts"
click node_business_ui "https://github.com/rahulrzn/soho-suite/blob/main/frontend/src/features/WorkspacePage.tsx"
click node_dataset_ui "https://github.com/rahulrzn/soho-suite/blob/main/frontend/src/features/DatasetPage.tsx"
click node_analytics_ui "https://github.com/rahulrzn/soho-suite/blob/main/frontend/src/features/AnalyticsPage.tsx"
click node_operations_ui "https://github.com/rahulrzn/soho-suite/blob/main/frontend/src/features/ExpensesPage.tsx"
click node_activity_ui "https://github.com/rahulrzn/soho-suite/blob/main/frontend/src/features/ActivityPage.tsx"
click node_api "https://github.com/rahulrzn/soho-suite/blob/main/backend/src/main/java/com/sohosuite/backend/BackendApplication.java"
click node_business_service "https://github.com/rahulrzn/soho-suite/blob/main/backend/src/main/java/com/sohosuite/backend/business/service/BusinessService.java"
click node_collaboration "https://github.com/rahulrzn/soho-suite/blob/main/backend/src/main/java/com/sohosuite/backend/collaboration/service/BusinessCollaborationService.java"
click node_dataset_service "https://github.com/rahulrzn/soho-suite/blob/main/backend/src/main/java/com/sohosuite/backend/dataset/service/DatasetService.java"
click node_analytics_service "https://github.com/rahulrzn/soho-suite/blob/main/backend/src/main/java/com/sohosuite/backend/analytics/service/AnalyticsService.java"
click node_expense_service "https://github.com/rahulrzn/soho-suite/blob/main/backend/src/main/java/com/sohosuite/backend/expense/service/ExpenseService.java"
click node_inventory_service "https://github.com/rahulrzn/soho-suite/blob/main/backend/src/main/java/com/sohosuite/backend/inventory/service/InventoryService.java"
click node_activity_service "https://github.com/rahulrzn/soho-suite/blob/main/backend/src/main/java/com/sohosuite/backend/activity/service/BusinessActivityService.java"
click node_export_service "https://github.com/rahulrzn/soho-suite/blob/main/backend/src/main/java/com/sohosuite/backend/report/ReportExportService.java"
click node_membership_store "https://github.com/rahulrzn/soho-suite/blob/main/backend/src/main/java/com/sohosuite/backend/business/repository/BusinessMembershipRepository.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_web,node_api_client,node_user toneBlue
class node_auth,node_firebase_web,node_postgres toneAmber
class node_business_ui,node_operations_ui,node_activity_ui,node_business_service,node_collaboration,node_expense_service,node_inventory_service,node_activity_service toneMint
class node_dataset_ui,node_analytics_ui,node_dataset_service,node_analytics_service,node_export_service toneRose
class node_api,node_membership_store,node_firebase toneIndigo
```

## Components

### Web workspace

- [React workspace](https://github.com/rahulrzn/soho-suite/blob/main/frontend/src/app/App.tsx): `frontend/src/app/App.tsx`
- [API client](https://github.com/rahulrzn/soho-suite/blob/main/frontend/src/api/apiClient.ts): `frontend/src/api/apiClient.ts`

### Identity and access

- [Sign-in flows](https://github.com/rahulrzn/soho-suite/blob/main/frontend/src/auth/authService.ts): `frontend/src/auth/authService.ts`
- [Firebase client](https://github.com/rahulrzn/soho-suite/blob/main/frontend/src/firebase.ts): `frontend/src/firebase.ts`

### Business operations

- [Business and team](https://github.com/rahulrzn/soho-suite/blob/main/frontend/src/features/WorkspacePage.tsx): `frontend/src/features/WorkspacePage.tsx`
- [Expenses and stock](https://github.com/rahulrzn/soho-suite/blob/main/frontend/src/features/ExpensesPage.tsx): `frontend/src/features/ExpensesPage.tsx`
- [Activity and reports](https://github.com/rahulrzn/soho-suite/blob/main/frontend/src/features/ActivityPage.tsx): `frontend/src/features/ActivityPage.tsx`
- [Business management](https://github.com/rahulrzn/soho-suite/blob/main/backend/src/main/java/com/sohosuite/backend/business/service/BusinessService.java): `backend/src/main/java/com/sohosuite/backend/business/service/BusinessService.java`
- [Invitations and transfer](https://github.com/rahulrzn/soho-suite/blob/main/backend/src/main/java/com/sohosuite/backend/collaboration/service/BusinessCollaborationService.java): `backend/src/main/java/com/sohosuite/backend/collaboration/service/BusinessCollaborationService.java`
- [Expense tracking](https://github.com/rahulrzn/soho-suite/blob/main/backend/src/main/java/com/sohosuite/backend/expense/service/ExpenseService.java): `backend/src/main/java/com/sohosuite/backend/expense/service/ExpenseService.java`
- [Inventory tracking](https://github.com/rahulrzn/soho-suite/blob/main/backend/src/main/java/com/sohosuite/backend/inventory/service/InventoryService.java): `backend/src/main/java/com/sohosuite/backend/inventory/service/InventoryService.java`
- [Business activity](https://github.com/rahulrzn/soho-suite/blob/main/backend/src/main/java/com/sohosuite/backend/activity/service/BusinessActivityService.java): `backend/src/main/java/com/sohosuite/backend/activity/service/BusinessActivityService.java`

### Data and insights

- [Dataset review](https://github.com/rahulrzn/soho-suite/blob/main/frontend/src/features/DatasetPage.tsx): `frontend/src/features/DatasetPage.tsx`
- [Analytics views](https://github.com/rahulrzn/soho-suite/blob/main/frontend/src/features/AnalyticsPage.tsx): `frontend/src/features/AnalyticsPage.tsx`
- [Dataset import](https://github.com/rahulrzn/soho-suite/blob/main/backend/src/main/java/com/sohosuite/backend/dataset/service/DatasetService.java): `backend/src/main/java/com/sohosuite/backend/dataset/service/DatasetService.java`
- [Sales analytics](https://github.com/rahulrzn/soho-suite/blob/main/backend/src/main/java/com/sohosuite/backend/analytics/service/AnalyticsService.java): `backend/src/main/java/com/sohosuite/backend/analytics/service/AnalyticsService.java`
- [Report exports](https://github.com/rahulrzn/soho-suite/blob/main/backend/src/main/java/com/sohosuite/backend/report/ReportExportService.java): `backend/src/main/java/com/sohosuite/backend/report/ReportExportService.java`

### API and persistence

- [Spring Boot API](https://github.com/rahulrzn/soho-suite/blob/main/backend/src/main/java/com/sohosuite/backend/BackendApplication.java): `backend/src/main/java/com/sohosuite/backend/BackendApplication.java`
- [Membership records](https://github.com/rahulrzn/soho-suite/blob/main/backend/src/main/java/com/sohosuite/backend/business/repository/BusinessMembershipRepository.java): `backend/src/main/java/com/sohosuite/backend/business/repository/BusinessMembershipRepository.java`

### Other components

- **Workspace user**
- **Firebase Authentication**
- **PostgreSQL**

## Connections

- Workspace user → React workspace: uses (evidence: `README.md`)
- Workspace user → Sign-in flows: signs in (evidence: `README.md`)
- Sign-in flows → Firebase client: uses (evidence: `frontend/src/auth/authService.ts`)
- Firebase client → Firebase Authentication: authenticates (evidence: `README.md`)
- React workspace → API client: makes API calls (evidence: `README.md`)
- API client → Sign-in flows: gets ID tokens (evidence: `frontend/src/api/apiClient.ts`)
- API client → Spring Boot API: sends bearer token (evidence: `README.md`)
- React workspace → Business and team: opens workspace (evidence: `README.md`)
- React workspace → Dataset review: opens imports (evidence: `README.md`)
- React workspace → Analytics views: opens analytics (evidence: `README.md`)
- React workspace → Expenses and stock: opens operations (evidence: `README.md`)
- React workspace → Activity and reports: opens history (evidence: `README.md`)
- Spring Boot API → Business management: serves business routes (evidence: `README.md`)
- Spring Boot API → Invitations and transfer: serves collaboration (evidence: `README.md`)
- Spring Boot API → Dataset import: serves dataset routes (evidence: `README.md`)
- Spring Boot API → Sales analytics: serves analytics (evidence: `README.md`)
- Spring Boot API → Expense tracking: serves expenses (evidence: `README.md`)
- Spring Boot API → Inventory tracking: serves inventory (evidence: `README.md`)
- Spring Boot API → Business activity: serves activity (evidence: `README.md`)
- Spring Boot API → Report exports: serves exports (evidence: `README.md`)
- Business management → Business activity: records events (evidence: `backend/src/main/java/com/sohosuite/backend/business/service/BusinessService.java`)
- Invitations and transfer → Business activity: records events (evidence: `backend/src/main/java/com/sohosuite/backend/collaboration/service/BusinessCollaborationService.java`)
- Dataset import → Business activity: records events (evidence: `backend/src/main/java/com/sohosuite/backend/dataset/service/DatasetService.java`)
- Inventory tracking → Business activity: records events (evidence: `backend/src/main/java/com/sohosuite/backend/inventory/service/InventoryService.java`)
- Expense tracking → Business activity: records events (evidence: `backend/src/main/java/com/sohosuite/backend/expense/service/ExpenseService.java`)
- Dataset import → Membership records: checks roles (evidence: `backend/src/main/java/com/sohosuite/backend/dataset/service/DatasetService.java`)
- Business management → Membership records: manages membership (evidence: `backend/src/main/java/com/sohosuite/backend/business/service/BusinessService.java`)
- Spring Boot API → PostgreSQL: persists business data (evidence: `README.md`)
- Dataset import → PostgreSQL: stores dataset rows (evidence: `README.md`)
- Sales analytics → Dataset import: analyzes confirmed mappings (evidence: `README.md`)
- Report exports → Sales analytics: exports analytics (evidence: `backend/src/main/java/com/sohosuite/backend/report/ReportExportService.java`)
