# u485349-coder/openfoundry architecture

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

- Interactive diagram: https://gitdiagram.com/u485349-coder/openfoundry
- Repository: https://github.com/u485349-coder/openfoundry

## Overview

OpenFoundry is a unified operational data platform: teams connect organizational data, shape it into shared concepts, explore context, and coordinate actions while tracking outcomes. The repository tree shows a web workspace and domain services for data, ontology, analytics, workflows, AI, and governance. README statements support the high-level capability relationships; service internals and most frontend wiring were not sampled, so the graph avoids claiming direct calls between them.

Main entry points: [`services/workflow-service/src`](https://github.com/u485349-coder/openfoundry/tree/main/services/workflow-service/src) (Workflow coordination), [`services/query-service/src`](https://github.com/u485349-coder/openfoundry/tree/main/services/query-service/src) (Data exploration), [`services/ontology-service/src`](https://github.com/u485349-coder/openfoundry/tree/main/services/ontology-service/src) (Shared ontology), [`apps/web/src/lib/components/dashboard`](https://github.com/u485349-coder/openfoundry/tree/main/apps/web/src/lib/components/dashboard) (Operational views)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User experience"]
  node_web["Platform workspace"]
  node_dashboards["Operational views"]
  node_reports["Reporting"]
end

subgraph group_data["Data foundation"]
  node_connectors["Data connectors"]
  node_datasets[("Dataset catalog")]
  node_query["Data exploration"]
  node_ontology[("Shared ontology")]
  node_fusion["Entity resolution"]
  node_pipelines["Data pipelines"]
  node_streaming["Live data"]
  node_geospatial["Geospatial analysis"]
end

subgraph group_operations["Operational tools"]
  node_workflows["Workflow coordination"]
  node_apps["Internal app builder"]
  node_ai["AI assistance"]
  node_ml["Machine learning"]
  node_notebooks["Notebooks"]
  node_code["Code repositories"]
  node_marketplace["Extensions marketplace"]
end

subgraph group_governance["Governance"]
  node_auth["Identity and access"]
  node_audit["Audit and compliance"]
  node_notifications["Alerts and notifications"]
  node_nexus["Secure data sharing"]
end

node_user(("Operations team"))

node_user -->|"works in"| node_web
node_connectors -->|"connect data"| node_datasets
node_datasets -->|"define concepts"| node_ontology
node_ontology -->|"explore context"| node_query
node_query -->|"show insights"| node_dashboards
node_streaming -->|"monitor live"| node_dashboards
node_geospatial -->|"show spatial context"| node_dashboards
node_pipelines -.->|"transform data"| node_datasets
node_fusion -.->|"resolve entities"| node_ontology
node_dashboards -->|"coordinate action"| node_workflows
node_workflows -.->|"alert teams"| node_notifications
node_workflows -->|"track outcomes"| node_reports
node_ontology -->|"build operational apps"| node_apps
node_query -->|"assist investigation"| node_ai
node_ml -->|"operationalize models"| node_workflows
node_notebooks -.->|"analyze data"| node_query
node_code -.->|"extend platform"| node_marketplace
node_auth -->|"protect access"| node_web
node_audit -->|"trace decisions"| node_workflows
node_nexus -->|"share data securely"| node_datasets

click node_web "https://github.com/u485349-coder/openfoundry/tree/main/apps/web/src"
click node_connectors "https://github.com/u485349-coder/openfoundry/tree/main/services/data-connector/src"
click node_datasets "https://github.com/u485349-coder/openfoundry/tree/main/services/dataset-service/src"
click node_query "https://github.com/u485349-coder/openfoundry/tree/main/services/query-service/src"
click node_ontology "https://github.com/u485349-coder/openfoundry/tree/main/services/ontology-service/src"
click node_fusion "https://github.com/u485349-coder/openfoundry/tree/main/services/fusion-service/src"
click node_pipelines "https://github.com/u485349-coder/openfoundry/tree/main/services/pipeline-service/src"
click node_streaming "https://github.com/u485349-coder/openfoundry/tree/main/services/streaming-service/src"
click node_geospatial "https://github.com/u485349-coder/openfoundry/tree/main/services/geospatial-service/src"
click node_dashboards "https://github.com/u485349-coder/openfoundry/tree/main/apps/web/src/lib/components/dashboard"
click node_reports "https://github.com/u485349-coder/openfoundry/tree/main/services/report-service/src"
click node_workflows "https://github.com/u485349-coder/openfoundry/tree/main/services/workflow-service/src"
click node_apps "https://github.com/u485349-coder/openfoundry/tree/main/services/app-builder-service/src"
click node_ai "https://github.com/u485349-coder/openfoundry/tree/main/services/ai-service/src"
click node_ml "https://github.com/u485349-coder/openfoundry/tree/main/services/ml-service/src"
click node_notebooks "https://github.com/u485349-coder/openfoundry/tree/main/services/notebook-service/src"
click node_code "https://github.com/u485349-coder/openfoundry/tree/main/services/code-repo-service/src"
click node_marketplace "https://github.com/u485349-coder/openfoundry/tree/main/services/marketplace-service/src"
click node_auth "https://github.com/u485349-coder/openfoundry/tree/main/services/auth-service/src"
click node_audit "https://github.com/u485349-coder/openfoundry/tree/main/services/audit-service/src"
click node_notifications "https://github.com/u485349-coder/openfoundry/tree/main/services/notification-service/src"
click node_nexus "https://github.com/u485349-coder/openfoundry/tree/main/services/nexus-service/src"

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_dashboards,node_reports toneBlue
class node_connectors,node_datasets,node_query,node_ontology,node_fusion,node_pipelines,node_streaming,node_geospatial toneAmber
class node_workflows,node_apps,node_ai,node_ml,node_notebooks,node_code,node_marketplace toneMint
class node_auth,node_audit,node_notifications,node_nexus toneRose
class node_user toneIndigo
```

## Components

### User experience

- [Platform workspace](https://github.com/u485349-coder/openfoundry/tree/main/apps/web/src): `apps/web/src`
- [Operational views](https://github.com/u485349-coder/openfoundry/tree/main/apps/web/src/lib/components/dashboard): `apps/web/src/lib/components/dashboard`
- [Reporting](https://github.com/u485349-coder/openfoundry/tree/main/services/report-service/src): `services/report-service/src`

### Data foundation

- [Data connectors](https://github.com/u485349-coder/openfoundry/tree/main/services/data-connector/src): `services/data-connector/src`
- [Dataset catalog](https://github.com/u485349-coder/openfoundry/tree/main/services/dataset-service/src): `services/dataset-service/src`
- [Data exploration](https://github.com/u485349-coder/openfoundry/tree/main/services/query-service/src): `services/query-service/src`
- [Shared ontology](https://github.com/u485349-coder/openfoundry/tree/main/services/ontology-service/src): `services/ontology-service/src`
- [Entity resolution](https://github.com/u485349-coder/openfoundry/tree/main/services/fusion-service/src): `services/fusion-service/src`
- [Data pipelines](https://github.com/u485349-coder/openfoundry/tree/main/services/pipeline-service/src): `services/pipeline-service/src`
- [Live data](https://github.com/u485349-coder/openfoundry/tree/main/services/streaming-service/src): `services/streaming-service/src`
- [Geospatial analysis](https://github.com/u485349-coder/openfoundry/tree/main/services/geospatial-service/src): `services/geospatial-service/src`

### Operational tools

- [Workflow coordination](https://github.com/u485349-coder/openfoundry/tree/main/services/workflow-service/src): `services/workflow-service/src`
- [Internal app builder](https://github.com/u485349-coder/openfoundry/tree/main/services/app-builder-service/src): `services/app-builder-service/src`
- [AI assistance](https://github.com/u485349-coder/openfoundry/tree/main/services/ai-service/src): `services/ai-service/src`
- [Machine learning](https://github.com/u485349-coder/openfoundry/tree/main/services/ml-service/src): `services/ml-service/src`
- [Notebooks](https://github.com/u485349-coder/openfoundry/tree/main/services/notebook-service/src): `services/notebook-service/src`
- [Code repositories](https://github.com/u485349-coder/openfoundry/tree/main/services/code-repo-service/src): `services/code-repo-service/src`
- [Extensions marketplace](https://github.com/u485349-coder/openfoundry/tree/main/services/marketplace-service/src): `services/marketplace-service/src`

### Governance

- [Identity and access](https://github.com/u485349-coder/openfoundry/tree/main/services/auth-service/src): `services/auth-service/src`
- [Audit and compliance](https://github.com/u485349-coder/openfoundry/tree/main/services/audit-service/src): `services/audit-service/src`
- [Alerts and notifications](https://github.com/u485349-coder/openfoundry/tree/main/services/notification-service/src): `services/notification-service/src`
- [Secure data sharing](https://github.com/u485349-coder/openfoundry/tree/main/services/nexus-service/src): `services/nexus-service/src`

### Other components

- **Operations team**

## Connections

- Operations team → Platform workspace: works in (evidence: `README.md`)
- Data connectors → Dataset catalog: connect data (evidence: `README.md`)
- Dataset catalog → Shared ontology: define concepts (evidence: `README.md`)
- Shared ontology → Data exploration: explore context (evidence: `README.md`)
- Data exploration → Operational views: show insights (evidence: `README.md`)
- Live data → Operational views: monitor live (evidence: `README.md`)
- Geospatial analysis → Operational views: show spatial context (evidence: `README.md`)
- Data pipelines → Dataset catalog: transform data
- Entity resolution → Shared ontology: resolve entities
- Operational views → Workflow coordination: coordinate action (evidence: `README.md`)
- Workflow coordination → Alerts and notifications: alert teams
- Workflow coordination → Reporting: track outcomes (evidence: `README.md`)
- Shared ontology → Internal app builder: build operational apps (evidence: `README.md`)
- Data exploration → AI assistance: assist investigation (evidence: `README.md`)
- Machine learning → Workflow coordination: operationalize models (evidence: `README.md`)
- Notebooks → Data exploration: analyze data
- Code repositories → Extensions marketplace: extend platform
- Identity and access → Platform workspace: protect access (evidence: `README.md`)
- Audit and compliance → Workflow coordination: trace decisions (evidence: `README.md`)
- Secure data sharing → Dataset catalog: share data securely (evidence: `README.md`)