# simbo1905/spring-bigtable-graphql architecture

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

- Interactive diagram: https://gitdiagram.com/simbo1905/spring-bigtable-graphql
- Repository: https://github.com/simbo1905/spring-bigtable-graphql

## Overview

This repository is a Spring Boot GraphQL service that resolves GraphQL fields from Google Cloud Bigtable. A client query is handled by the GraphQL runtime built by GraphQLProvider; schema fields are wired from wirings.json to BigtableDataFetchers, which delegates reads to BigtableRunner. The README also documents deploying the service on Knative. The sampled source shows schema construction and the Bigtable read path, but not an HTTP request handler; the query-to-runtime link is therefore documented rather than traced through a handler.

Main entry points: [`src/main/java/com/github/simbo1905/bigtablegraphql/GraphQLProvider.java`](https://github.com/simbo1905/spring-bigtable-graphql/blob/master/src/main/java/com/github/simbo1905/bigtablegraphql/GraphQLProvider.java) (GraphQL provider), [`src/main/java/com/github/simbo1905/bigtablegraphql/BigtableDataFetchers.java`](https://github.com/simbo1905/spring-bigtable-graphql/blob/master/src/main/java/com/github/simbo1905/bigtablegraphql/BigtableDataFetchers.java) (Field wiring), [`src/main/java/com/github/simbo1905/bigtablegraphql/BigtableRunner.java`](https://github.com/simbo1905/spring-bigtable-graphql/blob/master/src/main/java/com/github/simbo1905/bigtablegraphql/BigtableRunner.java) (Bigtable runner), [`src/main/java/com/github/simbo1905/bigtablegraphql/BigtableGraphQLApplication.java`](https://github.com/simbo1905/spring-bigtable-graphql/blob/master/src/main/java/com/github/simbo1905/bigtablegraphql/BigtableGraphQLApplication.java) (Spring Boot app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Application entry"]
  node_app["Spring Boot app"]
end

subgraph group_graphql["GraphQL runtime"]
  node_provider["GraphQL provider"]
  node_schema["GraphQL schema<br/>[schema.graphqls]"]
  node_fetchers["Field wiring"]
  node_wiring["Wiring metadata<br/>[wirings.json]"]
end

subgraph group_data["Bigtable access"]
  node_runner["Bigtable runner"]
  node_bigtable[("Cloud Bigtable")]
end

subgraph group_deployment["Deployment"]
  node_knative["Knative Serving"]
  node_knative_config["Knative service config"]
end

node_client(("GraphQL client"))

node_app -->|"starts context"| node_provider
node_provider -->|"loads schema"| node_schema
node_provider -->|"builds wiring"| node_fetchers
node_fetchers -->|"loads mappings"| node_wiring
node_fetchers -->|"creates fetchers"| node_runner
node_runner -->|"reads rows"| node_bigtable
node_client -.->|"submits query"| node_provider
node_knative -.->|"uses config"| node_knative_config

click node_app "https://github.com/simbo1905/spring-bigtable-graphql/blob/master/src/main/java/com/github/simbo1905/bigtablegraphql/BigtableGraphQLApplication.java"
click node_provider "https://github.com/simbo1905/spring-bigtable-graphql/blob/master/src/main/java/com/github/simbo1905/bigtablegraphql/GraphQLProvider.java"
click node_schema "https://github.com/simbo1905/spring-bigtable-graphql/blob/master/src/main/resources/schema.graphqls"
click node_fetchers "https://github.com/simbo1905/spring-bigtable-graphql/blob/master/src/main/java/com/github/simbo1905/bigtablegraphql/BigtableDataFetchers.java"
click node_wiring "https://github.com/simbo1905/spring-bigtable-graphql/blob/master/src/main/resources/wirings.json"
click node_runner "https://github.com/simbo1905/spring-bigtable-graphql/blob/master/src/main/java/com/github/simbo1905/bigtablegraphql/BigtableRunner.java"
click node_knative_config "https://github.com/simbo1905/spring-bigtable-graphql/blob/master/bigtable-graphql/templates/knative-service.yaml"

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_client toneBlue
class node_provider,node_schema,node_fetchers,node_wiring toneAmber
class node_runner,node_bigtable toneMint
class node_knative,node_knative_config toneRose
```

## Components

### Application entry

- [Spring Boot app](https://github.com/simbo1905/spring-bigtable-graphql/blob/master/src/main/java/com/github/simbo1905/bigtablegraphql/BigtableGraphQLApplication.java): `src/main/java/com/github/simbo1905/bigtablegraphql/BigtableGraphQLApplication.java`

### GraphQL runtime

- [GraphQL provider](https://github.com/simbo1905/spring-bigtable-graphql/blob/master/src/main/java/com/github/simbo1905/bigtablegraphql/GraphQLProvider.java): `src/main/java/com/github/simbo1905/bigtablegraphql/GraphQLProvider.java`
- [GraphQL schema](https://github.com/simbo1905/spring-bigtable-graphql/blob/master/src/main/resources/schema.graphqls): `src/main/resources/schema.graphqls`
- [Field wiring](https://github.com/simbo1905/spring-bigtable-graphql/blob/master/src/main/java/com/github/simbo1905/bigtablegraphql/BigtableDataFetchers.java): `src/main/java/com/github/simbo1905/bigtablegraphql/BigtableDataFetchers.java`
- [Wiring metadata](https://github.com/simbo1905/spring-bigtable-graphql/blob/master/src/main/resources/wirings.json): `src/main/resources/wirings.json`

### Bigtable access

- [Bigtable runner](https://github.com/simbo1905/spring-bigtable-graphql/blob/master/src/main/java/com/github/simbo1905/bigtablegraphql/BigtableRunner.java): `src/main/java/com/github/simbo1905/bigtablegraphql/BigtableRunner.java`
- **Cloud Bigtable**

### Deployment

- **Knative Serving**
- [Knative service config](https://github.com/simbo1905/spring-bigtable-graphql/blob/master/bigtable-graphql/templates/knative-service.yaml): `bigtable-graphql/templates/knative-service.yaml`

### Other components

- **GraphQL client**

## Connections

- Spring Boot app → GraphQL provider: starts context (evidence: `src/main/java/com/github/simbo1905/bigtablegraphql/BigtableGraphQLApplication.java`)
- GraphQL provider → GraphQL schema: loads schema (evidence: `src/main/java/com/github/simbo1905/bigtablegraphql/GraphQLProvider.java`)
- GraphQL provider → Field wiring: builds wiring (evidence: `src/main/java/com/github/simbo1905/bigtablegraphql/GraphQLProvider.java`)
- Field wiring → Wiring metadata: loads mappings (evidence: `src/main/java/com/github/simbo1905/bigtablegraphql/BigtableDataFetchers.java`)
- Field wiring → Bigtable runner: creates fetchers (evidence: `src/main/java/com/github/simbo1905/bigtablegraphql/BigtableDataFetchers.java`)
- Bigtable runner → Cloud Bigtable: reads rows (evidence: `src/main/java/com/github/simbo1905/bigtablegraphql/BigtableRunner.java`)
- GraphQL client → GraphQL provider: submits query (evidence: `README.md`)
- Knative Serving → Knative service config: uses config (evidence: `README.md`)
