# yeeeengyu/standard_ai architecture

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

- Interactive diagram: https://gitdiagram.com/yeeeengyu/standard_ai
- Repository: https://github.com/yeeeengyu/standard_ai

## Overview

This FastAPI service offers financial-product recommendations, investment recommendations, credit-grade responses, and a personal-finance/youth-policy chatbot with chat history and keyword extraction. The main workflow is a request to an API route, then domain-specific prompt or retrieval logic, then a formatted response. Product and investment recommendations use separate retrieval systems over the bank-products text; the chatbot also persists conversations in MongoDB. The credit calculation helpers are present, but the sampled route calls the LLM-based grading function instead. Connections reflect the sampled code and source index; unsampled wiring is not inferred.

Main entry points: [`app/main.py`](https://github.com/yeeeengyu/standard_ai/blob/main/app/main.py) (API routes), [`app/prodRecom/prodrecom_rag.py`](https://github.com/yeeeengyu/standard_ai/blob/main/app/prodRecom/prodrecom_rag.py) (Product retrieval), [`app/invRecom/invest_recommend.py`](https://github.com/yeeeengyu/standard_ai/blob/main/app/invRecom/invest_recommend.py) (Investment recommender), [`app/invRecom/invRecom_rag.py`](https://github.com/yeeeengyu/standard_ai/blob/main/app/invRecom/invRecom_rag.py) (Investment retrieval)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API"]
  node_routes["API routes<br/>[main.py]"]
  node_request_models["Request schemas<br/>[schemas.py]"]
end

subgraph group_recommendations["Recommendations"]
  node_product_prompt["Product prompt"]
  node_product_rag["Product retrieval<br/>[prodrecom_rag.py]"]
  node_product_parser["JSON parser<br/>[prodrecom_utils.py]"]
  node_invest_service["Investment recommender"]
  node_invest_rag["Investment retrieval<br/>[invRecom_rag.py]"]
  node_bank_text["Bank product text<br/>[은행상품_설명.txt]"]
end

subgraph group_credit["Credit grading"]
  node_credit_prompt["Credit grading prompt<br/>[credRate_prompt.py]"]
  node_credit_helpers["Score helpers<br/>[credRate_cal.py]"]
end

subgraph group_chat["Chat"]
  node_chat_prompt["Chat prompt<br/>[chatbot_prompt.py]"]
  node_chat_keywords["Keyword extraction<br/>[chatbot_keyword.py]"]
  node_chat_store[("Chat MongoDB")]
end

node_user(("API client"))
node_openai{{"OpenAI models"}}
node_embedding_model{{"Embedding model"}}

node_user -->|"calls API"| node_routes
node_routes -->|"validates input"| node_request_models
node_routes -->|"formats query"| node_product_prompt
node_routes -->|"invokes retrieval"| node_product_rag
node_routes -->|"parses result"| node_product_parser
node_product_rag -->|"reads text"| node_bank_text
node_product_rag -->|"calls models"| node_openai
node_routes -->|"requests recommendation"| node_invest_service
node_invest_service -->|"retrieves context"| node_invest_rag
node_invest_rag -->|"reads text"| node_bank_text
node_invest_rag -->|"calls models"| node_openai
node_invest_service -->|"requests completion"| node_openai
node_routes -->|"requests grade"| node_credit_prompt
node_credit_prompt -->|"requests completion"| node_openai
node_routes -->|"builds chat chain"| node_chat_prompt
node_routes -->|"invokes chat model"| node_openai
node_routes -->|"reads and writes"| node_chat_store
node_routes -->|"extracts keywords"| node_chat_keywords
node_chat_keywords -->|"loads encoder"| node_embedding_model
node_routes -->|"stores keywords"| node_chat_store

click node_routes "https://github.com/yeeeengyu/standard_ai/blob/main/app/main.py"
click node_request_models "https://github.com/yeeeengyu/standard_ai/blob/main/app/schemas.py"
click node_product_prompt "https://github.com/yeeeengyu/standard_ai/blob/main/app/prodRecom/prodrecom_fewshot.py"
click node_product_rag "https://github.com/yeeeengyu/standard_ai/blob/main/app/prodRecom/prodrecom_rag.py"
click node_product_parser "https://github.com/yeeeengyu/standard_ai/blob/main/app/prodRecom/prodrecom_utils.py"
click node_invest_service "https://github.com/yeeeengyu/standard_ai/blob/main/app/invRecom/invest_recommend.py"
click node_invest_rag "https://github.com/yeeeengyu/standard_ai/blob/main/app/invRecom/invRecom_rag.py"
click node_bank_text "https://github.com/yeeeengyu/standard_ai/blob/main/rag/%EC%9D%80%ED%96%89%EC%83%81%ED%92%88_%EC%84%A4%EB%AA%85.txt"
click node_credit_prompt "https://github.com/yeeeengyu/standard_ai/blob/main/app/credRate/credRate_prompt.py"
click node_credit_helpers "https://github.com/yeeeengyu/standard_ai/blob/main/app/credRate/credRate_cal.py"
click node_chat_prompt "https://github.com/yeeeengyu/standard_ai/blob/main/app/chatbot/chatbot_prompt.py"
click node_chat_keywords "https://github.com/yeeeengyu/standard_ai/blob/main/app/chatbot/chatbot_keyword.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_routes,node_request_models,node_user toneBlue
class node_product_prompt,node_product_rag,node_product_parser,node_invest_service,node_invest_rag,node_bank_text toneAmber
class node_credit_prompt,node_credit_helpers toneMint
class node_chat_prompt,node_chat_keywords,node_chat_store toneRose
class node_openai,node_embedding_model toneIndigo
```

## Components

### API

- [API routes](https://github.com/yeeeengyu/standard_ai/blob/main/app/main.py): `app/main.py`
- [Request schemas](https://github.com/yeeeengyu/standard_ai/blob/main/app/schemas.py): `app/schemas.py`

### Recommendations

- [Product prompt](https://github.com/yeeeengyu/standard_ai/blob/main/app/prodRecom/prodrecom_fewshot.py): `app/prodRecom/prodrecom_fewshot.py`
- [Product retrieval](https://github.com/yeeeengyu/standard_ai/blob/main/app/prodRecom/prodrecom_rag.py): `app/prodRecom/prodrecom_rag.py`
- [JSON parser](https://github.com/yeeeengyu/standard_ai/blob/main/app/prodRecom/prodrecom_utils.py): `app/prodRecom/prodrecom_utils.py`
- [Investment recommender](https://github.com/yeeeengyu/standard_ai/blob/main/app/invRecom/invest_recommend.py): `app/invRecom/invest_recommend.py`
- [Investment retrieval](https://github.com/yeeeengyu/standard_ai/blob/main/app/invRecom/invRecom_rag.py): `app/invRecom/invRecom_rag.py`
- [Bank product text](https://github.com/yeeeengyu/standard_ai/blob/main/rag/%EC%9D%80%ED%96%89%EC%83%81%ED%92%88_%EC%84%A4%EB%AA%85.txt): `rag/은행상품_설명.txt`

### Credit grading

- [Credit grading prompt](https://github.com/yeeeengyu/standard_ai/blob/main/app/credRate/credRate_prompt.py): `app/credRate/credRate_prompt.py`
- [Score helpers](https://github.com/yeeeengyu/standard_ai/blob/main/app/credRate/credRate_cal.py): `app/credRate/credRate_cal.py`

### Chat

- [Chat prompt](https://github.com/yeeeengyu/standard_ai/blob/main/app/chatbot/chatbot_prompt.py): `app/chatbot/chatbot_prompt.py`
- [Keyword extraction](https://github.com/yeeeengyu/standard_ai/blob/main/app/chatbot/chatbot_keyword.py): `app/chatbot/chatbot_keyword.py`
- **Chat MongoDB**

### Other components

- **API client**
- **OpenAI models**
- **Embedding model**

## Connections

- API client → API routes: calls API (evidence: `app/main.py`)
- API routes → Request schemas: validates input (evidence: `app/main.py`)
- API routes → Product prompt: formats query (evidence: `app/main.py`)
- API routes → Product retrieval: invokes retrieval (evidence: `app/main.py`)
- API routes → JSON parser: parses result (evidence: `app/main.py`)
- Product retrieval → Bank product text: reads text (evidence: `app/prodRecom/prodrecom_rag.py`)
- Product retrieval → OpenAI models: calls models (evidence: `app/prodRecom/prodrecom_rag.py`)
- API routes → Investment recommender: requests recommendation (evidence: `app/main.py`)
- Investment recommender → Investment retrieval: retrieves context (evidence: `app/invRecom/invest_recommend.py`)
- Investment retrieval → Bank product text: reads text (evidence: `app/invRecom/invRecom_rag.py`)
- Investment retrieval → OpenAI models: calls models (evidence: `app/invRecom/invRecom_rag.py`)
- Investment recommender → OpenAI models: requests completion (evidence: `app/invRecom/invest_recommend.py`)
- API routes → Credit grading prompt: requests grade (evidence: `app/main.py`)
- Credit grading prompt → OpenAI models: requests completion (evidence: `app/credRate/credRate_prompt.py`)
- API routes → Chat prompt: builds chat chain (evidence: `app/main.py`)
- API routes → OpenAI models: invokes chat model (evidence: `app/main.py`)
- API routes → Chat MongoDB: reads and writes (evidence: `app/main.py`)
- API routes → Keyword extraction: extracts keywords (evidence: `app/main.py`)
- Keyword extraction → Embedding model: loads encoder (evidence: `app/chatbot/chatbot_keyword.py`)
- API routes → Chat MongoDB: stores keywords (evidence: `app/main.py`)
