# commercient-datalake-datahub/dlake-cli architecture

> Architecture diagram of the GitHub repository commercient-datalake-datahub/dlake-cli, 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/commercient-datalake-datahub/dlake-cli
- Repository: https://github.com/commercient-datalake-datahub/dlake-cli

## Overview

This repository distributes the `dlake` CLI and includes agent skill guides; it does not publish the CLI’s source code. The documented user flow is registration or login, then driving tenant data and admin operations through CLI commands. The graph captures major documented platform capabilities, not their internal implementation: README statements establish the relationships, while source-level call paths and ownership cannot be verified. Skill guides cover product-specific integration knowledge but are not runtime components.

Main entry points: [`README.md`](https://github.com/commercient-datalake-datahub/dlake-cli/blob/main/README.md) (SYNC and file ingest), [`skills`](https://github.com/commercient-datalake-datahub/dlake-cli/tree/main/skills) (System connectors)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["CLI access"]
  node_dlake["dlake CLI"]
  node_registration["Registration and login<br/>[README.md]"]
  node_query["Query and export<br/>[README.md]"]
  node_admin["Admin tools<br/>[README.md]"]
  node_s3["S3 operations<br/>[README.md]"]
end

subgraph group_data["Data platform"]
  node_tenant["Tenant data platform"]
  node_sql[("Managed SQL Server")]
  node_schema["Schema builder<br/>[README.md]"]
  node_dataapi["REST and GraphQL API"]
  node_mcp["MCP access"]
  node_events["Events and time travel"]
end

subgraph group_integration["Data integration"]
  node_ingest["SYNC and file ingest<br/>[README.md]"]
  node_connectors["System connectors"]
  node_odbc["ODBC push agent<br/>[README.md]"]
end

subgraph group_governance["Governance and extensions"]
  node_permissions["Keys and permissions<br/>[README.md]"]
  node_audit["Audit and quality<br/>[README.md]"]
  node_storage["Object storage<br/>[README.md]"]
end

node_user(("User or CI"))
node_external["External systems"]
node_bucket[("S3 bucket")]

node_user -->|"runs commands"| node_dlake
node_dlake -->|"registers or authenticates"| node_registration
node_dlake -->|"queries and exports"| node_query
node_dlake -->|"invokes tools"| node_admin
node_registration -->|"provisions access"| node_tenant
node_query -->|"queries data"| node_sql
node_admin -->|"manages"| node_tenant
node_tenant -->|"built on"| node_sql
node_schema -->|"shapes"| node_sql
node_dataapi -->|"serves entities"| node_sql
node_mcp -->|"exposes access"| node_tenant
node_events -->|"provides change access"| node_sql
node_external -->|"supplies data"| node_ingest
node_ingest -->|"syncs data"| node_sql
node_connectors -.->|"documents integrations"| node_external
node_odbc -->|"pushes source data"| node_ingest
node_permissions -->|"enforces scopes"| node_sql
node_audit -->|"governs data"| node_tenant
node_storage -->|"attaches or exports"| node_sql
node_dlake -->|"runs storage commands"| node_s3
node_s3 -->|"browses and transfers"| node_bucket

click node_registration "https://github.com/commercient-datalake-datahub/dlake-cli/blob/main/README.md"
click node_query "https://github.com/commercient-datalake-datahub/dlake-cli/blob/main/README.md"
click node_admin "https://github.com/commercient-datalake-datahub/dlake-cli/blob/main/README.md"
click node_schema "https://github.com/commercient-datalake-datahub/dlake-cli/blob/main/README.md"
click node_ingest "https://github.com/commercient-datalake-datahub/dlake-cli/blob/main/README.md"
click node_connectors "https://github.com/commercient-datalake-datahub/dlake-cli/tree/main/skills"
click node_odbc "https://github.com/commercient-datalake-datahub/dlake-cli/blob/main/README.md"
click node_permissions "https://github.com/commercient-datalake-datahub/dlake-cli/blob/main/README.md"
click node_audit "https://github.com/commercient-datalake-datahub/dlake-cli/blob/main/README.md"
click node_storage "https://github.com/commercient-datalake-datahub/dlake-cli/blob/main/README.md"
click node_s3 "https://github.com/commercient-datalake-datahub/dlake-cli/blob/main/README.md"

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_dlake,node_registration,node_query,node_admin,node_s3,node_user toneBlue
class node_tenant,node_sql,node_schema,node_dataapi,node_mcp,node_events,node_bucket toneAmber
class node_ingest,node_connectors,node_odbc toneMint
class node_permissions,node_audit,node_storage toneRose
class node_external toneIndigo
```

## Components

### CLI access

- **dlake CLI**
- [Registration and login](https://github.com/commercient-datalake-datahub/dlake-cli/blob/main/README.md): `README.md`
- [Query and export](https://github.com/commercient-datalake-datahub/dlake-cli/blob/main/README.md): `README.md`
- [Admin tools](https://github.com/commercient-datalake-datahub/dlake-cli/blob/main/README.md): `README.md`
- [S3 operations](https://github.com/commercient-datalake-datahub/dlake-cli/blob/main/README.md): `README.md`

### Data platform

- **Tenant data platform**
- **Managed SQL Server**
- [Schema builder](https://github.com/commercient-datalake-datahub/dlake-cli/blob/main/README.md): `README.md`
- **REST and GraphQL API**
- **MCP access**
- **Events and time travel**

### Data integration

- [SYNC and file ingest](https://github.com/commercient-datalake-datahub/dlake-cli/blob/main/README.md): `README.md`
- [System connectors](https://github.com/commercient-datalake-datahub/dlake-cli/tree/main/skills): `skills`
- [ODBC push agent](https://github.com/commercient-datalake-datahub/dlake-cli/blob/main/README.md): `README.md`

### Governance and extensions

- [Keys and permissions](https://github.com/commercient-datalake-datahub/dlake-cli/blob/main/README.md): `README.md`
- [Audit and quality](https://github.com/commercient-datalake-datahub/dlake-cli/blob/main/README.md): `README.md`
- [Object storage](https://github.com/commercient-datalake-datahub/dlake-cli/blob/main/README.md): `README.md`

### Other components

- **User or CI**
- **External systems**
- **S3 bucket**

## Connections

- User or CI → dlake CLI: runs commands (evidence: `README.md`)
- dlake CLI → Registration and login: registers or authenticates (evidence: `README.md`)
- dlake CLI → Query and export: queries and exports (evidence: `README.md`)
- dlake CLI → Admin tools: invokes tools (evidence: `README.md`)
- Registration and login → Tenant data platform: provisions access (evidence: `README.md`)
- Query and export → Managed SQL Server: queries data (evidence: `README.md`)
- Admin tools → Tenant data platform: manages (evidence: `README.md`)
- Tenant data platform → Managed SQL Server: built on (evidence: `README.md`)
- Schema builder → Managed SQL Server: shapes (evidence: `README.md`)
- REST and GraphQL API → Managed SQL Server: serves entities (evidence: `README.md`)
- MCP access → Tenant data platform: exposes access (evidence: `README.md`)
- Events and time travel → Managed SQL Server: provides change access (evidence: `README.md`)
- External systems → SYNC and file ingest: supplies data (evidence: `README.md`)
- SYNC and file ingest → Managed SQL Server: syncs data (evidence: `README.md`)
- System connectors → External systems: documents integrations
- ODBC push agent → SYNC and file ingest: pushes source data (evidence: `README.md`)
- Keys and permissions → Managed SQL Server: enforces scopes (evidence: `README.md`)
- Audit and quality → Tenant data platform: governs data (evidence: `README.md`)
- Object storage → Managed SQL Server: attaches or exports (evidence: `README.md`)
- dlake CLI → S3 operations: runs storage commands (evidence: `README.md`)
- S3 operations → S3 bucket: browses and transfers (evidence: `README.md`)
