# onecloud-frontend/onecloud architecture

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

- Interactive diagram: https://gitdiagram.com/onecloud-frontend/onecloud
- Repository: https://github.com/onecloud-frontend/onecloud

## Overview

OneCloud is a multi-module enterprise operations platform, with CRM opportunity management as a representative workflow: users browse a sales pipeline, filter opportunities, inspect details, and update stages or owners. The detail page invokes query/mutation hooks, which call a local in-memory pipeline service; this sampled path does not establish how the other listed business modules persist data. Routing also exposes broad ERP, finance, HRMS, administration, portal, workflow, reporting, and integration capabilities. Evidence is limited to the README being absent and the supplied source excerpts and index.

Main entry points: [`src/app/router/index.tsx`](https://github.com/onecloud-frontend/onecloud/blob/main/src/app/router/index.tsx) (Route dispatch), [`src/features/crm/sales-pipeline/pages/SalesPipelinePage.tsx`](https://github.com/onecloud-frontend/onecloud/blob/main/src/features/crm/sales-pipeline/pages/SalesPipelinePage.tsx) (Pipeline workspace), [`src/core/auth/AuthProvider.tsx`](https://github.com/onecloud-frontend/onecloud/blob/main/src/core/auth/AuthProvider.tsx) (Session context), [`src/app/App.tsx`](https://github.com/onecloud-frontend/onecloud/blob/main/src/app/App.tsx) (Application entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application shell"]
  node_app["Application entry<br/>[App.tsx]"]
  node_router["Route dispatch<br/>[index.tsx]"]
  node_layouts["Layouts and navigation<br/>[AppLayout.tsx]"]
  node_apiclient["API client<br/>[apiClient.ts]"]
end

subgraph group_identity["Identity and access"]
  node_authpages["Sign-in and registration<br/>[LoginPage.tsx]"]
  node_authprovider["Session context<br/>[AuthProvider.tsx]"]
  node_authservice["Authentication service<br/>[authService.ts]"]
  node_tokenstorage[("Token storage<br/>[tokenStorage.ts]")]
  node_permissions["Role permissions<br/>[roles.ts]"]
end

subgraph group_crm["CRM sales pipeline"]
  node_crmroute["CRM routes<br/>[index.tsx]"]
  node_pipelinepage["Pipeline workspace"]
  node_pipelinefilters["Opportunity filters"]
  node_pipelineboard["Stage board<br/>[PipelineBoard.tsx]"]
  node_pipelinesummary["Pipeline metrics"]
  node_opportunitydetail["Opportunity details"]
  node_timeline["Activity timeline"]
  node_pipelinehooks["Pipeline queries"]
  node_pipelineservice["Pipeline service<br/>[pipelineService.ts]"]
  node_opportunitydata[("Opportunity records<br/>[pipelineService.ts]")]
  node_pipetypes["Opportunity model<br/>[pipeline.types.ts]"]
end

subgraph group_platform["Enterprise modules"]
  node_platformadmin["Platform administration"]
  node_hrms["HR management"]
  node_erpfinance["ERP and finance"]
  node_portals["Customer and partner portals"]
  node_workflow["Workflow and approvals"]
  node_analytics["Reporting and analytics"]
  node_integrations["Integrations and services"]
  node_othermodules["Other product areas"]
end

node_user(("User"))

node_user -->|"opens"| node_app
node_app -->|"renders"| node_router
node_app -->|"provides context"| node_authprovider
node_router -->|"routes to"| node_authpages
node_authpages -->|"uses auth"| node_authprovider
node_authprovider -.->|"uses service"| node_authservice
node_authprovider -->|"reads and writes"| node_tokenstorage
node_authservice -->|"sends requests"| node_apiclient
node_apiclient -->|"reads token"| node_tokenstorage
node_authprovider -.->|"uses roles"| node_permissions
node_router -->|"routes through"| node_layouts
node_router -->|"dispatches CRM"| node_crmroute
node_crmroute -.->|"routes to"| node_pipelinepage
node_user -.->|"works in"| node_pipelinepage
node_pipelinepage -->|"queries and mutates"| node_pipelinehooks
node_pipelinepage -->|"renders"| node_pipelinefilters
node_pipelinepage -->|"renders"| node_pipelineboard
node_pipelinepage -->|"renders"| node_pipelinesummary
node_pipelinepage -.->|"links to"| node_opportunitydetail
node_opportunitydetail -->|"queries and mutates"| node_pipelinehooks
node_opportunitydetail -->|"renders"| node_timeline
node_pipelinehooks -->|"calls"| node_pipelineservice
node_pipelineservice -->|"reads and updates"| node_opportunitydata
node_pipelineservice -->|"uses model"| node_pipetypes
node_router -.->|"routes to"| node_platformadmin
node_router -.->|"routes to"| node_hrms
node_router -->|"routes to"| node_erpfinance
node_router -.->|"routes to"| node_portals
node_router -.->|"routes to"| node_workflow
node_router -.->|"routes to"| node_analytics
node_router -->|"routes to"| node_integrations
node_router -.->|"routes to"| node_othermodules

click node_app "https://github.com/onecloud-frontend/onecloud/blob/main/src/app/App.tsx"
click node_router "https://github.com/onecloud-frontend/onecloud/blob/main/src/app/router/index.tsx"
click node_layouts "https://github.com/onecloud-frontend/onecloud/blob/main/src/app/layouts/AppLayout.tsx"
click node_authpages "https://github.com/onecloud-frontend/onecloud/blob/main/src/app/auth-pages/LoginPage.tsx"
click node_authprovider "https://github.com/onecloud-frontend/onecloud/blob/main/src/core/auth/AuthProvider.tsx"
click node_authservice "https://github.com/onecloud-frontend/onecloud/blob/main/src/core/auth/authService.ts"
click node_tokenstorage "https://github.com/onecloud-frontend/onecloud/blob/main/src/core/auth/tokenStorage.ts"
click node_permissions "https://github.com/onecloud-frontend/onecloud/blob/main/src/core/permissions/roles.ts"
click node_apiclient "https://github.com/onecloud-frontend/onecloud/blob/main/src/core/api/client/apiClient.ts"
click node_crmroute "https://github.com/onecloud-frontend/onecloud/blob/main/src/app/router/index.tsx"
click node_pipelinepage "https://github.com/onecloud-frontend/onecloud/blob/main/src/features/crm/sales-pipeline/pages/SalesPipelinePage.tsx"
click node_pipelinefilters "https://github.com/onecloud-frontend/onecloud/blob/main/src/features/crm/sales-pipeline/components/PipelineFilters.tsx"
click node_pipelineboard "https://github.com/onecloud-frontend/onecloud/blob/main/src/features/crm/sales-pipeline/components/PipelineBoard.tsx"
click node_pipelinesummary "https://github.com/onecloud-frontend/onecloud/blob/main/src/features/crm/sales-pipeline/components/PipelineSummary.tsx"
click node_opportunitydetail "https://github.com/onecloud-frontend/onecloud/blob/main/src/features/crm/sales-pipeline/pages/PipelineOpportunityDetailsPage.tsx"
click node_timeline "https://github.com/onecloud-frontend/onecloud/blob/main/src/features/crm/sales-pipeline/components/PipelineOpportunityTimeline.tsx"
click node_pipelinehooks "https://github.com/onecloud-frontend/onecloud/blob/main/src/features/crm/sales-pipeline/hooks/useSalesPipeline.ts"
click node_pipelineservice "https://github.com/onecloud-frontend/onecloud/blob/main/src/features/crm/sales-pipeline/services/pipelineService.ts"
click node_opportunitydata "https://github.com/onecloud-frontend/onecloud/blob/main/src/features/crm/sales-pipeline/services/pipelineService.ts"
click node_pipetypes "https://github.com/onecloud-frontend/onecloud/blob/main/src/features/crm/sales-pipeline/types/pipeline.types.ts"
click node_platformadmin "https://github.com/onecloud-frontend/onecloud/tree/main/src/features/platform-admin"
click node_hrms "https://github.com/onecloud-frontend/onecloud/tree/main/src/features/hrms"
click node_erpfinance "https://github.com/onecloud-frontend/onecloud/tree/main/src/features/erp"
click node_portals "https://github.com/onecloud-frontend/onecloud/tree/main/src/features/portals"
click node_workflow "https://github.com/onecloud-frontend/onecloud/tree/main/src/features/workflow"
click node_analytics "https://github.com/onecloud-frontend/onecloud/tree/main/src/features/crm/reports"
click node_integrations "https://github.com/onecloud-frontend/onecloud/tree/main/src/features/integrations"
click node_othermodules "https://github.com/onecloud-frontend/onecloud/tree/main/src/features"

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_app,node_router,node_layouts,node_apiclient,node_user toneBlue
class node_authpages,node_authprovider,node_authservice,node_tokenstorage,node_permissions toneAmber
class node_crmroute,node_pipelinepage,node_pipelinefilters,node_pipelineboard,node_pipelinesummary,node_opportunitydetail,node_timeline,node_pipelinehooks,node_pipelineservice,node_opportunitydata,node_pipetypes toneMint
class node_platformadmin,node_hrms,node_erpfinance,node_portals,node_workflow,node_analytics,node_integrations,node_othermodules toneRose
```

## Components

### Application shell

- [Application entry](https://github.com/onecloud-frontend/onecloud/blob/main/src/app/App.tsx): `src/app/App.tsx`
- [Route dispatch](https://github.com/onecloud-frontend/onecloud/blob/main/src/app/router/index.tsx): `src/app/router/index.tsx`
- [Layouts and navigation](https://github.com/onecloud-frontend/onecloud/blob/main/src/app/layouts/AppLayout.tsx): `src/app/layouts/AppLayout.tsx`
- [API client](https://github.com/onecloud-frontend/onecloud/blob/main/src/core/api/client/apiClient.ts): `src/core/api/client/apiClient.ts`

### Identity and access

- [Sign-in and registration](https://github.com/onecloud-frontend/onecloud/blob/main/src/app/auth-pages/LoginPage.tsx): `src/app/auth-pages/LoginPage.tsx`
- [Session context](https://github.com/onecloud-frontend/onecloud/blob/main/src/core/auth/AuthProvider.tsx): `src/core/auth/AuthProvider.tsx`
- [Authentication service](https://github.com/onecloud-frontend/onecloud/blob/main/src/core/auth/authService.ts): `src/core/auth/authService.ts`
- [Token storage](https://github.com/onecloud-frontend/onecloud/blob/main/src/core/auth/tokenStorage.ts): `src/core/auth/tokenStorage.ts`
- [Role permissions](https://github.com/onecloud-frontend/onecloud/blob/main/src/core/permissions/roles.ts): `src/core/permissions/roles.ts`

### CRM sales pipeline

- [CRM routes](https://github.com/onecloud-frontend/onecloud/blob/main/src/app/router/index.tsx): `src/app/router/index.tsx`
- [Pipeline workspace](https://github.com/onecloud-frontend/onecloud/blob/main/src/features/crm/sales-pipeline/pages/SalesPipelinePage.tsx): `src/features/crm/sales-pipeline/pages/SalesPipelinePage.tsx`
- [Opportunity filters](https://github.com/onecloud-frontend/onecloud/blob/main/src/features/crm/sales-pipeline/components/PipelineFilters.tsx): `src/features/crm/sales-pipeline/components/PipelineFilters.tsx`
- [Stage board](https://github.com/onecloud-frontend/onecloud/blob/main/src/features/crm/sales-pipeline/components/PipelineBoard.tsx): `src/features/crm/sales-pipeline/components/PipelineBoard.tsx`
- [Pipeline metrics](https://github.com/onecloud-frontend/onecloud/blob/main/src/features/crm/sales-pipeline/components/PipelineSummary.tsx): `src/features/crm/sales-pipeline/components/PipelineSummary.tsx`
- [Opportunity details](https://github.com/onecloud-frontend/onecloud/blob/main/src/features/crm/sales-pipeline/pages/PipelineOpportunityDetailsPage.tsx): `src/features/crm/sales-pipeline/pages/PipelineOpportunityDetailsPage.tsx`
- [Activity timeline](https://github.com/onecloud-frontend/onecloud/blob/main/src/features/crm/sales-pipeline/components/PipelineOpportunityTimeline.tsx): `src/features/crm/sales-pipeline/components/PipelineOpportunityTimeline.tsx`
- [Pipeline queries](https://github.com/onecloud-frontend/onecloud/blob/main/src/features/crm/sales-pipeline/hooks/useSalesPipeline.ts): `src/features/crm/sales-pipeline/hooks/useSalesPipeline.ts`
- [Pipeline service](https://github.com/onecloud-frontend/onecloud/blob/main/src/features/crm/sales-pipeline/services/pipelineService.ts): `src/features/crm/sales-pipeline/services/pipelineService.ts`
- [Opportunity records](https://github.com/onecloud-frontend/onecloud/blob/main/src/features/crm/sales-pipeline/services/pipelineService.ts): `src/features/crm/sales-pipeline/services/pipelineService.ts`
- [Opportunity model](https://github.com/onecloud-frontend/onecloud/blob/main/src/features/crm/sales-pipeline/types/pipeline.types.ts): `src/features/crm/sales-pipeline/types/pipeline.types.ts`

### Enterprise modules

- [Platform administration](https://github.com/onecloud-frontend/onecloud/tree/main/src/features/platform-admin): `src/features/platform-admin`
- [HR management](https://github.com/onecloud-frontend/onecloud/tree/main/src/features/hrms): `src/features/hrms`
- [ERP and finance](https://github.com/onecloud-frontend/onecloud/tree/main/src/features/erp): `src/features/erp`
- [Customer and partner portals](https://github.com/onecloud-frontend/onecloud/tree/main/src/features/portals): `src/features/portals`
- [Workflow and approvals](https://github.com/onecloud-frontend/onecloud/tree/main/src/features/workflow): `src/features/workflow`
- [Reporting and analytics](https://github.com/onecloud-frontend/onecloud/tree/main/src/features/crm/reports): `src/features/crm/reports`
- [Integrations and services](https://github.com/onecloud-frontend/onecloud/tree/main/src/features/integrations): `src/features/integrations`
- [Other product areas](https://github.com/onecloud-frontend/onecloud/tree/main/src/features): `src/features`

### Other components

- **User**

## Connections

- User → Application entry: opens (evidence: `src/app/App.tsx`)
- Application entry → Route dispatch: renders (evidence: `src/app/App.tsx`)
- Application entry → Session context: provides context (evidence: `src/app/App.tsx`)
- Route dispatch → Sign-in and registration: routes to (evidence: `src/app/router/index.tsx`)
- Sign-in and registration → Session context: uses auth (evidence: `src/app/auth-pages/LoginPage.tsx`)
- Session context → Authentication service: uses service
- Session context → Token storage: reads and writes (evidence: `src/core/auth/AuthProvider.tsx`)
- Authentication service → API client: sends requests (evidence: `src/core/auth/authService.ts`)
- API client → Token storage: reads token (evidence: `src/core/api/client/apiClient.ts`)
- Session context → Role permissions: uses roles
- Route dispatch → Layouts and navigation: routes through (evidence: `src/app/router/index.tsx`)
- Route dispatch → CRM routes: dispatches CRM (evidence: `src/app/router/index.tsx`)
- CRM routes → Pipeline workspace: routes to
- User → Pipeline workspace: works in
- Pipeline workspace → Pipeline queries: queries and mutates (evidence: `src/features/crm/sales-pipeline/pages/SalesPipelinePage.tsx`)
- Pipeline workspace → Opportunity filters: renders (evidence: `src/features/crm/sales-pipeline/pages/SalesPipelinePage.tsx`)
- Pipeline workspace → Stage board: renders (evidence: `src/features/crm/sales-pipeline/pages/SalesPipelinePage.tsx`)
- Pipeline workspace → Pipeline metrics: renders (evidence: `src/features/crm/sales-pipeline/pages/SalesPipelinePage.tsx`)
- Pipeline workspace → Opportunity details: links to
- Opportunity details → Pipeline queries: queries and mutates (evidence: `src/features/crm/sales-pipeline/pages/PipelineOpportunityDetailsPage.tsx`)
- Opportunity details → Activity timeline: renders (evidence: `src/features/crm/sales-pipeline/pages/PipelineOpportunityDetailsPage.tsx`)
- Pipeline queries → Pipeline service: calls (evidence: `src/features/crm/sales-pipeline/hooks/useSalesPipeline.ts`)
- Pipeline service → Opportunity records: reads and updates (evidence: `src/features/crm/sales-pipeline/services/pipelineService.ts`)
- Pipeline service → Opportunity model: uses model (evidence: `src/features/crm/sales-pipeline/services/pipelineService.ts`)
- Route dispatch → Platform administration: routes to (evidence: `src/app/router/index.tsx`)
- Route dispatch → HR management: routes to (evidence: `src/app/router/index.tsx`)
- Route dispatch → ERP and finance: routes to (evidence: `src/app/router/index.tsx`)
- Route dispatch → Customer and partner portals: routes to
- Route dispatch → Workflow and approvals: routes to
- Route dispatch → Reporting and analytics: routes to
- Route dispatch → Integrations and services: routes to (evidence: `src/app/router/index.tsx`)
- Route dispatch → Other product areas: routes to (evidence: `src/app/router/index.tsx`)
