# cobaltcore-dev/aurora-dashboard architecture

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

- Interactive diagram: https://gitdiagram.com/cobaltcore-dev/aurora-dashboard
- Repository: https://github.com/cobaltcore-dev/aurora-dashboard

## Overview

Aurora is a reusable OpenStack cloud-management dashboard: a user navigates project-scoped compute, networking, storage, and identity features in the React client; tRPC requests reach a Fastify BFF, which mediates OpenStack operations. The graph preserves the documented service breadth and the policy and OpenStack-client layers. Some domain modules are represented by their exact source directories because their full implementations were not sampled; those relationships are shown only where documented or visible in the source index.

Main entry points: [`packages/aurora/src/server/routers.ts`](https://github.com/cobaltcore-dev/aurora-dashboard/blob/main/packages/aurora/src/server/routers.ts) (tRPC router), [`packages/aurora/src/client/routeTree.gen.ts`](https://github.com/cobaltcore-dev/aurora-dashboard/blob/main/packages/aurora/src/client/routeTree.gen.ts) (Routes and views), [`packages/aurora/src/client/App.tsx`](https://github.com/cobaltcore-dev/aurora-dashboard/blob/main/packages/aurora/src/client/App.tsx) (React application), [`packages/aurora/src/server/server.ts`](https://github.com/cobaltcore-dev/aurora-dashboard/blob/main/packages/aurora/src/server/server.ts) (Fastify BFF)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Dashboard client"]
  node_clientapp["React application<br/>[App.tsx]"]
  node_router["Routes and views<br/>[routeTree.gen.ts]"]
  node_projectui["Project workflows<br/>[index.tsx]"]
  node_computeui["Compute UI"]
  node_networkui["Networking UI"]
  node_storageui["Storage UI"]
  node_trpcclient["tRPC client<br/>[trpcClient.ts]"]
end

subgraph group_bff["Aurora BFF"]
  node_server["Fastify BFF<br/>[server.ts]"]
  node_rpc["tRPC router<br/>[routers.ts]"]
  node_auth["Session identity<br/>[sessionRouter.ts]"]
  node_projectapi["Project API"]
  node_computeapi["Compute API"]
  node_networkapi["Network API"]
  node_storageapi["Storage API"]
end

subgraph group_cloud["OpenStack integration"]
  node_signal["OpenStack client<br/>[client.ts]"]
end

subgraph group_policy["Authorization engine"]
  node_policyloader["Policy loader"]
  node_policyengine["Policy evaluator<br/>[policyEngine.ts]"]
  node_parser["Rule parser<br/>[parser.ts]"]
end

node_operator(("Cloud user"))
node_openstack{{"OpenStack cloud"}}

node_operator -->|"uses"| node_clientapp
node_clientapp -->|"creates router"| node_router
node_router -.->|"routes to"| node_projectui
node_router -.->|"routes to"| node_computeui
node_router -.->|"routes to"| node_networkui
node_router -.->|"routes to"| node_storageui
node_clientapp -->|"configures endpoint"| node_trpcclient
node_trpcclient -->|"sends tRPC"| node_server
node_server -->|"registers router"| node_rpc
node_rpc -.->|"dispatches"| node_auth
node_rpc -.->|"dispatches"| node_projectapi
node_rpc -.->|"dispatches"| node_computeapi
node_rpc -.->|"dispatches"| node_networkapi
node_rpc -.->|"dispatches"| node_storageapi
node_computeapi -->|"calls"| node_signal
node_storageapi -.->|"calls"| node_signal
node_signal -->|"sends API requests"| node_openstack
node_server -.->|"loads policy"| node_policyloader
node_policyloader -->|"creates evaluator"| node_policyengine
node_policyengine -->|"parses rules"| node_parser

click node_clientapp "https://github.com/cobaltcore-dev/aurora-dashboard/blob/main/packages/aurora/src/client/App.tsx"
click node_router "https://github.com/cobaltcore-dev/aurora-dashboard/blob/main/packages/aurora/src/client/routeTree.gen.ts"
click node_projectui "https://github.com/cobaltcore-dev/aurora-dashboard/blob/main/packages/aurora/src/client/routes/_auth/projects/%24projectId/index.tsx"
click node_computeui "https://github.com/cobaltcore-dev/aurora-dashboard/tree/main/packages/aurora/src/client/routes/_auth/projects/%24projectId/compute"
click node_networkui "https://github.com/cobaltcore-dev/aurora-dashboard/tree/main/packages/aurora/src/client/routes/_auth/projects/%24projectId/network"
click node_storageui "https://github.com/cobaltcore-dev/aurora-dashboard/tree/main/packages/aurora/src/client/routes/_auth/projects/%24projectId/storage"
click node_trpcclient "https://github.com/cobaltcore-dev/aurora-dashboard/blob/main/packages/aurora/src/client/trpcClient.ts"
click node_server "https://github.com/cobaltcore-dev/aurora-dashboard/blob/main/packages/aurora/src/server/server.ts"
click node_rpc "https://github.com/cobaltcore-dev/aurora-dashboard/blob/main/packages/aurora/src/server/routers.ts"
click node_auth "https://github.com/cobaltcore-dev/aurora-dashboard/blob/main/packages/aurora/src/server/Authentication/routers/sessionRouter.ts"
click node_projectapi "https://github.com/cobaltcore-dev/aurora-dashboard/tree/main/packages/aurora/src/server/Project/routers"
click node_computeapi "https://github.com/cobaltcore-dev/aurora-dashboard/tree/main/packages/aurora/src/server/Compute/routers"
click node_networkapi "https://github.com/cobaltcore-dev/aurora-dashboard/tree/main/packages/aurora/src/server/Network/routers"
click node_storageapi "https://github.com/cobaltcore-dev/aurora-dashboard/tree/main/packages/aurora/src/server/Storage/routers"
click node_signal "https://github.com/cobaltcore-dev/aurora-dashboard/blob/main/packages/signal-openstack/src/client.ts"
click node_policyloader "https://github.com/cobaltcore-dev/aurora-dashboard/blob/main/packages/aurora/src/server/policies/policyEngineLoader.ts"
click node_policyengine "https://github.com/cobaltcore-dev/aurora-dashboard/blob/main/packages/policy-engine/src/policyEngine.ts"
click node_parser "https://github.com/cobaltcore-dev/aurora-dashboard/blob/main/packages/policy-engine/src/parser.ts"

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_clientapp,node_router,node_projectui,node_computeui,node_networkui,node_storageui,node_trpcclient,node_operator toneBlue
class node_server,node_rpc,node_auth,node_projectapi,node_computeapi,node_networkapi,node_storageapi toneAmber
class node_signal toneMint
class node_policyloader,node_policyengine,node_parser toneRose
class node_openstack toneIndigo
```

## Components

### Dashboard client

- [React application](https://github.com/cobaltcore-dev/aurora-dashboard/blob/main/packages/aurora/src/client/App.tsx): `packages/aurora/src/client/App.tsx`
- [Routes and views](https://github.com/cobaltcore-dev/aurora-dashboard/blob/main/packages/aurora/src/client/routeTree.gen.ts): `packages/aurora/src/client/routeTree.gen.ts`
- [Project workflows](https://github.com/cobaltcore-dev/aurora-dashboard/blob/main/packages/aurora/src/client/routes/_auth/projects/%24projectId/index.tsx): `packages/aurora/src/client/routes/_auth/projects/$projectId/index.tsx`
- [Compute UI](https://github.com/cobaltcore-dev/aurora-dashboard/tree/main/packages/aurora/src/client/routes/_auth/projects/%24projectId/compute): `packages/aurora/src/client/routes/_auth/projects/$projectId/compute`
- [Networking UI](https://github.com/cobaltcore-dev/aurora-dashboard/tree/main/packages/aurora/src/client/routes/_auth/projects/%24projectId/network): `packages/aurora/src/client/routes/_auth/projects/$projectId/network`
- [Storage UI](https://github.com/cobaltcore-dev/aurora-dashboard/tree/main/packages/aurora/src/client/routes/_auth/projects/%24projectId/storage): `packages/aurora/src/client/routes/_auth/projects/$projectId/storage`
- [tRPC client](https://github.com/cobaltcore-dev/aurora-dashboard/blob/main/packages/aurora/src/client/trpcClient.ts): `packages/aurora/src/client/trpcClient.ts`

### Aurora BFF

- [Fastify BFF](https://github.com/cobaltcore-dev/aurora-dashboard/blob/main/packages/aurora/src/server/server.ts): `packages/aurora/src/server/server.ts`
- [tRPC router](https://github.com/cobaltcore-dev/aurora-dashboard/blob/main/packages/aurora/src/server/routers.ts): `packages/aurora/src/server/routers.ts`
- [Session identity](https://github.com/cobaltcore-dev/aurora-dashboard/blob/main/packages/aurora/src/server/Authentication/routers/sessionRouter.ts): `packages/aurora/src/server/Authentication/routers/sessionRouter.ts`
- [Project API](https://github.com/cobaltcore-dev/aurora-dashboard/tree/main/packages/aurora/src/server/Project/routers): `packages/aurora/src/server/Project/routers`
- [Compute API](https://github.com/cobaltcore-dev/aurora-dashboard/tree/main/packages/aurora/src/server/Compute/routers): `packages/aurora/src/server/Compute/routers`
- [Network API](https://github.com/cobaltcore-dev/aurora-dashboard/tree/main/packages/aurora/src/server/Network/routers): `packages/aurora/src/server/Network/routers`
- [Storage API](https://github.com/cobaltcore-dev/aurora-dashboard/tree/main/packages/aurora/src/server/Storage/routers): `packages/aurora/src/server/Storage/routers`

### OpenStack integration

- [OpenStack client](https://github.com/cobaltcore-dev/aurora-dashboard/blob/main/packages/signal-openstack/src/client.ts): `packages/signal-openstack/src/client.ts`

### Authorization engine

- [Policy loader](https://github.com/cobaltcore-dev/aurora-dashboard/blob/main/packages/aurora/src/server/policies/policyEngineLoader.ts): `packages/aurora/src/server/policies/policyEngineLoader.ts`
- [Policy evaluator](https://github.com/cobaltcore-dev/aurora-dashboard/blob/main/packages/policy-engine/src/policyEngine.ts): `packages/policy-engine/src/policyEngine.ts`
- [Rule parser](https://github.com/cobaltcore-dev/aurora-dashboard/blob/main/packages/policy-engine/src/parser.ts): `packages/policy-engine/src/parser.ts`

### Other components

- **Cloud user**
- **OpenStack cloud**

## Connections

- Cloud user → React application: uses (evidence: `README.md`)
- React application → Routes and views: creates router (evidence: `packages/aurora/src/client/App.tsx`)
- Routes and views → Project workflows: routes to
- Routes and views → Compute UI: routes to
- Routes and views → Networking UI: routes to
- Routes and views → Storage UI: routes to
- React application → tRPC client: configures endpoint (evidence: `packages/aurora/src/client/App.tsx`)
- tRPC client → Fastify BFF: sends tRPC (evidence: `README.md`)
- Fastify BFF → tRPC router: registers router (evidence: `packages/aurora/src/server/server.ts`)
- tRPC router → Session identity: dispatches
- tRPC router → Project API: dispatches
- tRPC router → Compute API: dispatches
- tRPC router → Network API: dispatches
- tRPC router → Storage API: dispatches
- Compute API → OpenStack client: calls (evidence: `packages/aurora/src/server/Compute/routers/imageRouter.ts`)
- Storage API → OpenStack client: calls
- OpenStack client → OpenStack cloud: sends API requests (evidence: `README.md`)
- Fastify BFF → Policy loader: loads policy
- Policy loader → Policy evaluator: creates evaluator (evidence: `packages/aurora/src/server/policies/policyEngineLoader.ts`)
- Policy evaluator → Rule parser: parses rules (evidence: `packages/policy-engine/src/policyEngine.ts`)
