# idinadi/basic_docker_kubernetes architecture

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

- Interactive diagram: https://gitdiagram.com/idinadi/basic_docker_kubernetes
- Repository: https://github.com/idinadi/basic_docker_kubernetes

## Overview

The repository contains two FastAPI applications: a product catalog/search API backed by OpenSearch, and a separate minimal greeting API. The catalog workflow accepts product requests, uses a shared OpenSearch client for indexing and retrieval, and returns product or search results; startup also ensures the index exists. Major catalog capabilities include health checks, listing, ID-based retrieval and deletion, and category-filtered text search. The source excerpt supports these runtime relationships; deployment files are not mapped as application components.

Main entry points: [`fastapi_opensearch/main.py`](https://github.com/idinadi/basic_docker_kubernetes/blob/main/fastapi_opensearch/main.py) (Catalog Routes), [`skaffold_learning/main.py`](https://github.com/idinadi/basic_docker_kubernetes/blob/main/skaffold_learning/main.py) (Greeting Endpoints)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_catalog_api["Catalog API"]
  node_catalog_routes["Catalog Routes<br/>[main.py]"]
  node_health_check["Health Check<br/>[main.py]"]
  node_index_lifecycle["Index Lifecycle<br/>[main.py]"]
  node_product_write["Product Creation<br/>[main.py]"]
  node_product_read["Product Retrieval<br/>[main.py]"]
  node_product_listing["Product Listing<br/>[main.py]"]
  node_product_delete["Product Deletion<br/>[main.py]"]
  node_product_search["Product Search<br/>[main.py]"]
end

subgraph group_search_store["Search Store"]
  node_client_factory["Client Factory<br/>[main.py]"]
  node_opensearch[("OpenSearch")]
end

subgraph group_greeting_app["Greeting App"]
  node_greeting_api["Greeting Endpoints<br/>[main.py]"]
end

node_clients(("API Clients"))
node_greeting_clients(("Greeting Clients"))

node_clients -->|"calls routes"| node_catalog_routes
node_catalog_routes -->|"routes health"| node_health_check
node_catalog_routes -->|"routes creation"| node_product_write
node_catalog_routes -->|"routes retrieval"| node_product_read
node_catalog_routes -->|"routes listing"| node_product_listing
node_catalog_routes -->|"routes deletion"| node_product_delete
node_catalog_routes -->|"routes search"| node_product_search
node_index_lifecycle -->|"creates client"| node_client_factory
node_health_check -->|"gets client"| node_client_factory
node_product_write -->|"gets client"| node_client_factory
node_product_read -->|"gets client"| node_client_factory
node_product_listing -->|"gets client"| node_client_factory
node_product_delete -->|"gets client"| node_client_factory
node_product_search -->|"gets client"| node_client_factory
node_client_factory -->|"configures connection"| node_opensearch
node_index_lifecycle -->|"checks and creates index"| node_opensearch
node_health_check -->|"checks reachability"| node_opensearch
node_product_write -->|"indexes product"| node_opensearch
node_product_read -->|"fetches product"| node_opensearch
node_product_listing -->|"searches all"| node_opensearch
node_product_delete -->|"deletes product"| node_opensearch
node_product_search -->|"searches products"| node_opensearch
node_greeting_clients -->|"calls endpoints"| node_greeting_api

click node_catalog_routes "https://github.com/idinadi/basic_docker_kubernetes/blob/main/fastapi_opensearch/main.py"
click node_health_check "https://github.com/idinadi/basic_docker_kubernetes/blob/main/fastapi_opensearch/main.py"
click node_index_lifecycle "https://github.com/idinadi/basic_docker_kubernetes/blob/main/fastapi_opensearch/main.py"
click node_product_write "https://github.com/idinadi/basic_docker_kubernetes/blob/main/fastapi_opensearch/main.py"
click node_product_read "https://github.com/idinadi/basic_docker_kubernetes/blob/main/fastapi_opensearch/main.py"
click node_product_listing "https://github.com/idinadi/basic_docker_kubernetes/blob/main/fastapi_opensearch/main.py"
click node_product_delete "https://github.com/idinadi/basic_docker_kubernetes/blob/main/fastapi_opensearch/main.py"
click node_product_search "https://github.com/idinadi/basic_docker_kubernetes/blob/main/fastapi_opensearch/main.py"
click node_client_factory "https://github.com/idinadi/basic_docker_kubernetes/blob/main/fastapi_opensearch/main.py"
click node_greeting_api "https://github.com/idinadi/basic_docker_kubernetes/blob/main/skaffold_learning/main.py"

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_catalog_routes,node_health_check,node_index_lifecycle,node_product_write,node_product_read,node_product_listing,node_product_delete,node_product_search,node_clients,node_greeting_clients toneBlue
class node_client_factory,node_opensearch toneAmber
class node_greeting_api toneMint
```

## Components

### Catalog API

- [Catalog Routes](https://github.com/idinadi/basic_docker_kubernetes/blob/main/fastapi_opensearch/main.py): `fastapi_opensearch/main.py`
- [Health Check](https://github.com/idinadi/basic_docker_kubernetes/blob/main/fastapi_opensearch/main.py): `fastapi_opensearch/main.py`
- [Index Lifecycle](https://github.com/idinadi/basic_docker_kubernetes/blob/main/fastapi_opensearch/main.py): `fastapi_opensearch/main.py`
- [Product Creation](https://github.com/idinadi/basic_docker_kubernetes/blob/main/fastapi_opensearch/main.py): `fastapi_opensearch/main.py`
- [Product Retrieval](https://github.com/idinadi/basic_docker_kubernetes/blob/main/fastapi_opensearch/main.py): `fastapi_opensearch/main.py`
- [Product Listing](https://github.com/idinadi/basic_docker_kubernetes/blob/main/fastapi_opensearch/main.py): `fastapi_opensearch/main.py`
- [Product Deletion](https://github.com/idinadi/basic_docker_kubernetes/blob/main/fastapi_opensearch/main.py): `fastapi_opensearch/main.py`
- [Product Search](https://github.com/idinadi/basic_docker_kubernetes/blob/main/fastapi_opensearch/main.py): `fastapi_opensearch/main.py`

### Search Store

- [Client Factory](https://github.com/idinadi/basic_docker_kubernetes/blob/main/fastapi_opensearch/main.py): `fastapi_opensearch/main.py`
- **OpenSearch**

### Greeting App

- [Greeting Endpoints](https://github.com/idinadi/basic_docker_kubernetes/blob/main/skaffold_learning/main.py): `skaffold_learning/main.py`

### Other components

- **API Clients**
- **Greeting Clients**

## Connections

- API Clients → Catalog Routes: calls routes (evidence: `fastapi_opensearch/main.py`)
- Catalog Routes → Health Check: routes health (evidence: `fastapi_opensearch/main.py`)
- Catalog Routes → Product Creation: routes creation (evidence: `fastapi_opensearch/main.py`)
- Catalog Routes → Product Retrieval: routes retrieval (evidence: `fastapi_opensearch/main.py`)
- Catalog Routes → Product Listing: routes listing (evidence: `fastapi_opensearch/main.py`)
- Catalog Routes → Product Deletion: routes deletion (evidence: `fastapi_opensearch/main.py`)
- Catalog Routes → Product Search: routes search (evidence: `fastapi_opensearch/main.py`)
- Index Lifecycle → Client Factory: creates client (evidence: `fastapi_opensearch/main.py`)
- Health Check → Client Factory: gets client (evidence: `fastapi_opensearch/main.py`)
- Product Creation → Client Factory: gets client (evidence: `fastapi_opensearch/main.py`)
- Product Retrieval → Client Factory: gets client (evidence: `fastapi_opensearch/main.py`)
- Product Listing → Client Factory: gets client (evidence: `fastapi_opensearch/main.py`)
- Product Deletion → Client Factory: gets client (evidence: `fastapi_opensearch/main.py`)
- Product Search → Client Factory: gets client (evidence: `fastapi_opensearch/main.py`)
- Client Factory → OpenSearch: configures connection (evidence: `fastapi_opensearch/main.py`)
- Index Lifecycle → OpenSearch: checks and creates index (evidence: `fastapi_opensearch/main.py`)
- Health Check → OpenSearch: checks reachability (evidence: `fastapi_opensearch/main.py`)
- Product Creation → OpenSearch: indexes product (evidence: `fastapi_opensearch/main.py`)
- Product Retrieval → OpenSearch: fetches product (evidence: `fastapi_opensearch/main.py`)
- Product Listing → OpenSearch: searches all (evidence: `fastapi_opensearch/main.py`)
- Product Deletion → OpenSearch: deletes product (evidence: `fastapi_opensearch/main.py`)
- Product Search → OpenSearch: searches products (evidence: `fastapi_opensearch/main.py`)
- Greeting Clients → Greeting Endpoints: calls endpoints (evidence: `skaffold_learning/main.py`)
