# chirayuagrawal-dev/cloud-native-microservice-pipeline architecture

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

- Interactive diagram: https://gitdiagram.com/chirayuagrawal-dev/cloud-native-microservice-pipeline
- Repository: https://github.com/chirayuagrawal-dev/cloud-native-microservice-pipeline

## Overview

Aurora AI lets a user ask a question through the frontend; the Express API validates it, retrieves matching document chunks from ChromaDB, builds a context-limited prompt, and asks Ollama to generate an answer. A separate ingestion workflow loads project and folder documents, chunks them, and indexes them in the same collection using the shared embedding function. The README also documents Kubernetes workloads for these services. Frontend and deployment details are not sampled here, so those links rely on README statements; no CI/CD internals are included.

Main entry points: [`k8s-deployment.yaml`](https://github.com/chirayuagrawal-dev/cloud-native-microservice-pipeline/blob/main/k8s-deployment.yaml) (Kubernetes workloads), [`ingest.js`](https://github.com/chirayuagrawal-dev/cloud-native-microservice-pipeline/blob/main/ingest.js) (Collection indexing), [`server.js`](https://github.com/chirayuagrawal-dev/cloud-native-microservice-pipeline/blob/main/server.js) (Context retrieval), [`frontend`](https://github.com/chirayuagrawal-dev/cloud-native-microservice-pipeline/tree/main/frontend) (Aurora frontend)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User experience"]
  node_frontend["Aurora frontend"]
end

subgraph group_rag["RAG API"]
  node_api["Question API<br/>[server.js]"]
  node_validation["Question validation<br/>[server.js]"]
  node_retrieval["Context retrieval<br/>[server.js]"]
  node_prompt["Prompt assembly<br/>[server.js]"]
  node_embedding["Embedding function<br/>[embeddings.js]"]
end

subgraph group_ingest["Document ingestion"]
  node_source_docs["Source documents"]
  node_loader["Document loading<br/>[ingest.js]"]
  node_chunker["Chunk preparation<br/>[ingest.js]"]
  node_indexer["Collection indexing<br/>[ingest.js]"]
end

subgraph group_runtime["AI and deployment runtime"]
  node_chroma[("ChromaDB")]
  node_ollama["Ollama"]
  node_kubernetes["Kubernetes workloads"]
end

node_user(("User"))

node_user -->|"asks question"| node_frontend
node_frontend -->|"posts question"| node_api
node_api -->|"validates"| node_validation
node_validation -->|"queries"| node_retrieval
node_retrieval -->|"queries collection"| node_chroma
node_retrieval -->|"supplies function"| node_embedding
node_embedding -->|"creates embeddings"| node_ollama
node_retrieval -->|"provides context"| node_prompt
node_prompt -->|"requests generation"| node_ollama
node_api -->|"returns answer"| node_frontend
node_source_docs -->|"loads files"| node_loader
node_loader -->|"prepares text"| node_chunker
node_chunker -->|"provides chunks"| node_indexer
node_indexer -->|"configures function"| node_embedding
node_indexer -->|"checks model"| node_ollama
node_indexer -->|"writes collection"| node_chroma
node_kubernetes -->|"runs workload"| node_frontend
node_kubernetes -->|"runs workload"| node_api
node_kubernetes -->|"runs workload"| node_chroma
node_kubernetes -->|"runs workload"| node_ollama
node_kubernetes -->|"runs job"| node_indexer

click node_frontend "https://github.com/chirayuagrawal-dev/cloud-native-microservice-pipeline/tree/main/frontend"
click node_api "https://github.com/chirayuagrawal-dev/cloud-native-microservice-pipeline/blob/main/server.js"
click node_validation "https://github.com/chirayuagrawal-dev/cloud-native-microservice-pipeline/blob/main/server.js"
click node_retrieval "https://github.com/chirayuagrawal-dev/cloud-native-microservice-pipeline/blob/main/server.js"
click node_prompt "https://github.com/chirayuagrawal-dev/cloud-native-microservice-pipeline/blob/main/server.js"
click node_embedding "https://github.com/chirayuagrawal-dev/cloud-native-microservice-pipeline/blob/main/embeddings.js"
click node_source_docs "https://github.com/chirayuagrawal-dev/cloud-native-microservice-pipeline/tree/main/documents"
click node_loader "https://github.com/chirayuagrawal-dev/cloud-native-microservice-pipeline/blob/main/ingest.js"
click node_chunker "https://github.com/chirayuagrawal-dev/cloud-native-microservice-pipeline/blob/main/ingest.js"
click node_indexer "https://github.com/chirayuagrawal-dev/cloud-native-microservice-pipeline/blob/main/ingest.js"
click node_kubernetes "https://github.com/chirayuagrawal-dev/cloud-native-microservice-pipeline/blob/main/k8s-deployment.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_frontend,node_user toneBlue
class node_api,node_validation,node_retrieval,node_prompt,node_embedding toneAmber
class node_source_docs,node_loader,node_chunker,node_indexer toneMint
class node_chroma,node_ollama,node_kubernetes toneRose
```

## Components

### User experience

- [Aurora frontend](https://github.com/chirayuagrawal-dev/cloud-native-microservice-pipeline/tree/main/frontend): `frontend`

### RAG API

- [Question API](https://github.com/chirayuagrawal-dev/cloud-native-microservice-pipeline/blob/main/server.js): `server.js`
- [Question validation](https://github.com/chirayuagrawal-dev/cloud-native-microservice-pipeline/blob/main/server.js): `server.js`
- [Context retrieval](https://github.com/chirayuagrawal-dev/cloud-native-microservice-pipeline/blob/main/server.js): `server.js`
- [Prompt assembly](https://github.com/chirayuagrawal-dev/cloud-native-microservice-pipeline/blob/main/server.js): `server.js`
- [Embedding function](https://github.com/chirayuagrawal-dev/cloud-native-microservice-pipeline/blob/main/embeddings.js): `embeddings.js`

### Document ingestion

- [Source documents](https://github.com/chirayuagrawal-dev/cloud-native-microservice-pipeline/tree/main/documents): `documents`
- [Document loading](https://github.com/chirayuagrawal-dev/cloud-native-microservice-pipeline/blob/main/ingest.js): `ingest.js`
- [Chunk preparation](https://github.com/chirayuagrawal-dev/cloud-native-microservice-pipeline/blob/main/ingest.js): `ingest.js`
- [Collection indexing](https://github.com/chirayuagrawal-dev/cloud-native-microservice-pipeline/blob/main/ingest.js): `ingest.js`

### AI and deployment runtime

- **ChromaDB**
- **Ollama**
- [Kubernetes workloads](https://github.com/chirayuagrawal-dev/cloud-native-microservice-pipeline/blob/main/k8s-deployment.yaml): `k8s-deployment.yaml`

### Other components

- **User**

## Connections

- User → Aurora frontend: asks question (evidence: `README.md`)
- Aurora frontend → Question API: posts question (evidence: `README.md`)
- Question API → Question validation: validates (evidence: `server.js`)
- Question validation → Context retrieval: queries (evidence: `server.js`)
- Context retrieval → ChromaDB: queries collection (evidence: `server.js`)
- Context retrieval → Embedding function: supplies function (evidence: `server.js`)
- Embedding function → Ollama: creates embeddings (evidence: `embeddings.js`)
- Context retrieval → Prompt assembly: provides context (evidence: `server.js`)
- Prompt assembly → Ollama: requests generation (evidence: `server.js`)
- Question API → Aurora frontend: returns answer (evidence: `README.md`)
- Source documents → Document loading: loads files (evidence: `ingest.js`)
- Document loading → Chunk preparation: prepares text (evidence: `ingest.js`)
- Chunk preparation → Collection indexing: provides chunks (evidence: `ingest.js`)
- Collection indexing → Embedding function: configures function (evidence: `ingest.js`)
- Collection indexing → Ollama: checks model (evidence: `ingest.js`)
- Collection indexing → ChromaDB: writes collection (evidence: `ingest.js`)
- Kubernetes workloads → Aurora frontend: runs workload (evidence: `README.md`)
- Kubernetes workloads → Question API: runs workload (evidence: `README.md`)
- Kubernetes workloads → ChromaDB: runs workload (evidence: `README.md`)
- Kubernetes workloads → Ollama: runs workload (evidence: `README.md`)
- Kubernetes workloads → Collection indexing: runs job (evidence: `README.md`)
