# balamuruganl/aabics-ai-learning architecture

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

- Interactive diagram: https://gitdiagram.com/balamuruganl/aabics-ai-learning
- Repository: https://github.com/balamuruganl/aabics-ai-learning

## Overview

This is a learning repository with small Python/API examples and two Agent Development Kit (ADK) agent applications. The clearest product workflows are financial guidance, including investment research, and ecommerce ordering, from customer details through product selection to checkout. The API example separately demonstrates welcome, profile lookup, and in-memory user creation. The Python notebooks are present in the tree, but their contents were not sampled, so their behavior and connections are not represented. The graph reflects documented agent delegation; unsampled runtime wiring is omitted.

Main entry points: [`03-adk/agent01-finance-assistant/finance_assistant_agent/agent.py`](https://github.com/balamuruganl/aabics-ai-learning/blob/main/03-adk/agent01-finance-assistant/finance_assistant_agent/agent.py) (Finance assistant), [`03-adk/agent02-ecommerce/ecommerce_agent/agent.py`](https://github.com/balamuruganl/aabics-ai-learning/blob/main/03-adk/agent02-ecommerce/ecommerce_agent/agent.py) (Ecommerce assistant), [`03-adk/agent02-ecommerce/catalog_agent/agent.py`](https://github.com/balamuruganl/aabics-ai-learning/blob/main/03-adk/agent02-ecommerce/catalog_agent/agent.py) (Product catalog), [`02-api/api.py`](https://github.com/balamuruganl/aabics-ai-learning/blob/main/02-api/api.py) (FastAPI routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API example"]
  node_api_app["FastAPI routes<br/>[api.py]"]
  node_api_users[("User list<br/>[api.py]")]
end

subgraph group_finance["Finance assistant"]
  node_finance_agent["Finance assistant<br/>[agent.py]"]
  node_finance_details["Finance details<br/>[agent.py]"]
  node_investment_agent["Investment planner<br/>[agent.py]"]
end

subgraph group_ecommerce["Ecommerce ordering"]
  node_ecommerce_agent["Ecommerce assistant<br/>[agent.py]"]
  node_customer_details["Customer details<br/>[agent.py]"]
  node_catalog_agent["Product catalog<br/>[agent.py]"]
  node_cart_details["Cart details<br/>[agent.py]"]
  node_checkout_agent["Checkout<br/>[agent.py]"]
  node_shipping_details["Shipping address<br/>[agent.py]"]
end

node_user(("User"))
node_google_search["Google Search"]

node_user -->|"calls routes"| node_api_app
node_api_app -->|"appends user"| node_api_users
node_user -.->|"requests advice"| node_finance_agent
node_finance_agent -->|"gets details"| node_finance_details
node_finance_agent -->|"uses tool"| node_investment_agent
node_investment_agent -->|"searches"| node_google_search
node_user -.->|"starts order"| node_ecommerce_agent
node_ecommerce_agent -->|"saves details"| node_customer_details
node_ecommerce_agent -->|"delegates to"| node_catalog_agent
node_catalog_agent -->|"saves cart"| node_cart_details
node_catalog_agent -->|"delegates to"| node_checkout_agent
node_checkout_agent -->|"saves address"| node_shipping_details

click node_api_app "https://github.com/balamuruganl/aabics-ai-learning/blob/main/02-api/api.py"
click node_api_users "https://github.com/balamuruganl/aabics-ai-learning/blob/main/02-api/api.py"
click node_finance_agent "https://github.com/balamuruganl/aabics-ai-learning/blob/main/03-adk/agent01-finance-assistant/finance_assistant_agent/agent.py"
click node_finance_details "https://github.com/balamuruganl/aabics-ai-learning/blob/main/03-adk/agent01-finance-assistant/finance_assistant_agent/agent.py"
click node_investment_agent "https://github.com/balamuruganl/aabics-ai-learning/blob/main/03-adk/agent01-finance-assistant/investment_plan_agent/agent.py"
click node_ecommerce_agent "https://github.com/balamuruganl/aabics-ai-learning/blob/main/03-adk/agent02-ecommerce/ecommerce_agent/agent.py"
click node_customer_details "https://github.com/balamuruganl/aabics-ai-learning/blob/main/03-adk/agent02-ecommerce/ecommerce_agent/agent.py"
click node_catalog_agent "https://github.com/balamuruganl/aabics-ai-learning/blob/main/03-adk/agent02-ecommerce/catalog_agent/agent.py"
click node_cart_details "https://github.com/balamuruganl/aabics-ai-learning/blob/main/03-adk/agent02-ecommerce/catalog_agent/agent.py"
click node_checkout_agent "https://github.com/balamuruganl/aabics-ai-learning/blob/main/03-adk/agent02-ecommerce/checkout_agent/agent.py"
click node_shipping_details "https://github.com/balamuruganl/aabics-ai-learning/blob/main/03-adk/agent02-ecommerce/checkout_agent/agent.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_api_app,node_api_users,node_user toneBlue
class node_finance_agent,node_finance_details,node_investment_agent toneAmber
class node_ecommerce_agent,node_customer_details,node_catalog_agent,node_cart_details,node_checkout_agent,node_shipping_details toneMint
class node_google_search toneIndigo
```

## Components

### API example

- [FastAPI routes](https://github.com/balamuruganl/aabics-ai-learning/blob/main/02-api/api.py): `02-api/api.py`
- [User list](https://github.com/balamuruganl/aabics-ai-learning/blob/main/02-api/api.py): `02-api/api.py`

### Finance assistant

- [Finance assistant](https://github.com/balamuruganl/aabics-ai-learning/blob/main/03-adk/agent01-finance-assistant/finance_assistant_agent/agent.py): `03-adk/agent01-finance-assistant/finance_assistant_agent/agent.py`
- [Finance details](https://github.com/balamuruganl/aabics-ai-learning/blob/main/03-adk/agent01-finance-assistant/finance_assistant_agent/agent.py): `03-adk/agent01-finance-assistant/finance_assistant_agent/agent.py`
- [Investment planner](https://github.com/balamuruganl/aabics-ai-learning/blob/main/03-adk/agent01-finance-assistant/investment_plan_agent/agent.py): `03-adk/agent01-finance-assistant/investment_plan_agent/agent.py`

### Ecommerce ordering

- [Ecommerce assistant](https://github.com/balamuruganl/aabics-ai-learning/blob/main/03-adk/agent02-ecommerce/ecommerce_agent/agent.py): `03-adk/agent02-ecommerce/ecommerce_agent/agent.py`
- [Customer details](https://github.com/balamuruganl/aabics-ai-learning/blob/main/03-adk/agent02-ecommerce/ecommerce_agent/agent.py): `03-adk/agent02-ecommerce/ecommerce_agent/agent.py`
- [Product catalog](https://github.com/balamuruganl/aabics-ai-learning/blob/main/03-adk/agent02-ecommerce/catalog_agent/agent.py): `03-adk/agent02-ecommerce/catalog_agent/agent.py`
- [Cart details](https://github.com/balamuruganl/aabics-ai-learning/blob/main/03-adk/agent02-ecommerce/catalog_agent/agent.py): `03-adk/agent02-ecommerce/catalog_agent/agent.py`
- [Checkout](https://github.com/balamuruganl/aabics-ai-learning/blob/main/03-adk/agent02-ecommerce/checkout_agent/agent.py): `03-adk/agent02-ecommerce/checkout_agent/agent.py`
- [Shipping address](https://github.com/balamuruganl/aabics-ai-learning/blob/main/03-adk/agent02-ecommerce/checkout_agent/agent.py): `03-adk/agent02-ecommerce/checkout_agent/agent.py`

### Other components

- **User**
- **Google Search**

## Connections

- User → FastAPI routes: calls routes (evidence: `02-api/api.py`)
- FastAPI routes → User list: appends user (evidence: `02-api/api.py`)
- User → Finance assistant: requests advice
- Finance assistant → Finance details: gets details (evidence: `03-adk/agent01-finance-assistant/finance_assistant_agent/agent.py`)
- Finance assistant → Investment planner: uses tool (evidence: `03-adk/agent01-finance-assistant/finance_assistant_agent/agent.py`)
- Investment planner → Google Search: searches (evidence: `03-adk/agent01-finance-assistant/investment_plan_agent/agent.py`)
- User → Ecommerce assistant: starts order
- Ecommerce assistant → Customer details: saves details (evidence: `03-adk/agent02-ecommerce/ecommerce_agent/agent.py`)
- Ecommerce assistant → Product catalog: delegates to (evidence: `03-adk/agent02-ecommerce/ecommerce_agent/agent.py`)
- Product catalog → Cart details: saves cart (evidence: `03-adk/agent02-ecommerce/catalog_agent/agent.py`)
- Product catalog → Checkout: delegates to (evidence: `03-adk/agent02-ecommerce/catalog_agent/agent.py`)
- Checkout → Shipping address: saves address (evidence: `03-adk/agent02-ecommerce/checkout_agent/agent.py`)
