# ragz743/team_15_capstone_project architecture

> Architecture diagram of the GitHub repository ragz743/team_15_capstone_project, 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/ragz743/team_15_capstone_project
- Repository: https://github.com/ragz743/team_15_capstone_project

## Overview

This repository implements a weather-data question-answering application: users ask natural-language questions, the backend retrieves indexed AgWeatherNet records, and a chatbot produces a grounded response. Separate ingestion loaders prepare daily, live, and forecast data for vector search. The README also documents configurable embedding and chatbot model implementations. The README’s product summary is unfinished, and frontend-to-API wiring and some workflow behavior are not shown; uncertain links are therefore omitted or marked unverified.

Main entry points: [`code_/backend/models/_embedding_base.py`](https://github.com/ragz743/team_15_capstone_project/blob/main/code_/backend/models/_embedding_base.py) (Embedding interface), [`code_/backend/loaders/daily_loader.py`](https://github.com/ragz743/team_15_capstone_project/blob/main/code_/backend/loaders/daily_loader.py) (Daily loader), [`code_/backend/loaders/live_loader.py`](https://github.com/ragz743/team_15_capstone_project/blob/main/code_/backend/loaders/live_loader.py) (Live loader), [`code_/backend/loaders/forecast_loader.py`](https://github.com/ragz743/team_15_capstone_project/blob/main/code_/backend/loaders/forecast_loader.py) (Forecast loader)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User experience"]
  node_frontend["Chat interface<br/>[ChatWorkspace.tsx]"]
  node_app["Frontend app<br/>[App.tsx]"]
end

subgraph group_answering["Weather answering"]
  node_api["Backend API<br/>[api.py]"]
  node_retriever["Weather retriever<br/>[retriever.py]"]
  node_vectorstore["Vector search<br/>[vector_store.py]"]
  node_pgvector[("pgvector connection<br/>[pgvector.py]")]
end

subgraph group_ingestion["Data ingestion"]
  node_workflow["Data workflow<br/>[workflow.py]"]
  node_daily["Daily loader<br/>[daily_loader.py]"]
  node_live["Live loader<br/>[live_loader.py]"]
  node_forecast["Forecast loader<br/>[forecast_loader.py]"]
  node_metadata["Station metadata<br/>[_common.py]"]
  node_awnbase["AWN connection base"]
  node_awndaily[("Daily database")]
  node_awnmain[("Live database")]
  node_awnforecast[("Forecast database")]
end

subgraph group_models["Model integrations"]
  node_factory["Model factory<br/>[model_factory.py]"]
  node_embedding["Embedding interface<br/>[_embedding_base.py]"]
  node_openrouterembed["OpenRouter embeddings"]
  node_chatbase["Chatbot interface<br/>[_chatbot_base.py]"]
  node_chatproviders["Chatbot providers"]
end

node_user(("Weather user"))
node_openrouter{{"OpenRouter service"}}

node_user -.->|"asks weather"| node_frontend
node_frontend -.->|"renders"| node_app
node_app -.->|"sends requests"| node_api
node_api -->|"imports"| node_retriever
node_api -->|"imports"| node_vectorstore
node_retriever -->|"searches"| node_vectorstore
node_retriever -->|"invokes"| node_chatbase
node_vectorstore -->|"queries"| node_pgvector
node_workflow -->|"references"| node_factory
node_daily -->|"queries stations"| node_metadata
node_live -->|"queries stations"| node_metadata
node_forecast -->|"queries stations"| node_metadata
node_metadata -->|"queries metadata"| node_awnmain
node_daily -->|"queries"| node_awndaily
node_live -->|"queries"| node_awnmain
node_forecast -->|"queries"| node_awnforecast
node_awndaily -->|"extends"| node_awnbase
node_awnmain -->|"extends"| node_awnbase
node_awnforecast -->|"extends"| node_awnbase
node_daily -->|"embeds documents"| node_embedding
node_live -->|"embeds documents"| node_embedding
node_forecast -->|"embeds documents"| node_embedding
node_daily -->|"stores records"| node_pgvector
node_live -->|"stores records"| node_pgvector
node_forecast -->|"stores records"| node_pgvector
node_factory -->|"creates"| node_embedding
node_factory -->|"creates"| node_chatbase
node_openrouterembed -->|"implements"| node_embedding
node_chatproviders -->|"implements"| node_chatbase
node_openrouterembed -.->|"calls"| node_openrouter
node_chatproviders -.->|"calls"| node_openrouter

click node_frontend "https://github.com/ragz743/team_15_capstone_project/blob/main/code_/frontend/components/ChatWorkspace.tsx"
click node_app "https://github.com/ragz743/team_15_capstone_project/blob/main/code_/frontend/src/App.tsx"
click node_api "https://github.com/ragz743/team_15_capstone_project/blob/main/code_/backend/api.py"
click node_retriever "https://github.com/ragz743/team_15_capstone_project/blob/main/code_/backend/retriever.py"
click node_vectorstore "https://github.com/ragz743/team_15_capstone_project/blob/main/code_/backend/vector_store.py"
click node_pgvector "https://github.com/ragz743/team_15_capstone_project/blob/main/code_/backend/databases/pgvector.py"
click node_workflow "https://github.com/ragz743/team_15_capstone_project/blob/main/code_/backend/workflow/workflow.py"
click node_daily "https://github.com/ragz743/team_15_capstone_project/blob/main/code_/backend/loaders/daily_loader.py"
click node_live "https://github.com/ragz743/team_15_capstone_project/blob/main/code_/backend/loaders/live_loader.py"
click node_forecast "https://github.com/ragz743/team_15_capstone_project/blob/main/code_/backend/loaders/forecast_loader.py"
click node_metadata "https://github.com/ragz743/team_15_capstone_project/blob/main/code_/backend/loaders/_common.py"
click node_awnbase "https://github.com/ragz743/team_15_capstone_project/blob/main/code_/backend/databases/_awn_connection_base.py"
click node_awndaily "https://github.com/ragz743/team_15_capstone_project/blob/main/code_/backend/databases/awn_daily_connection.py"
click node_awnmain "https://github.com/ragz743/team_15_capstone_project/blob/main/code_/backend/databases/awn_main_connection.py"
click node_awnforecast "https://github.com/ragz743/team_15_capstone_project/blob/main/code_/backend/databases/awn_fc_connection.py"
click node_factory "https://github.com/ragz743/team_15_capstone_project/blob/main/code_/backend/model_factory.py"
click node_embedding "https://github.com/ragz743/team_15_capstone_project/blob/main/code_/backend/models/_embedding_base.py"
click node_openrouterembed "https://github.com/ragz743/team_15_capstone_project/blob/main/code_/backend/models/embedding_openrouter.py"
click node_chatbase "https://github.com/ragz743/team_15_capstone_project/blob/main/code_/backend/models/_chatbot_base.py"
click node_chatproviders "https://github.com/ragz743/team_15_capstone_project/blob/main/code_/backend/models/chatbot_openrouter.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_frontend,node_app,node_user toneBlue
class node_api,node_retriever,node_vectorstore,node_pgvector toneAmber
class node_workflow,node_daily,node_live,node_forecast,node_metadata,node_awnbase,node_awndaily,node_awnmain,node_awnforecast,node_openrouter toneMint
class node_factory,node_embedding,node_openrouterembed,node_chatbase,node_chatproviders toneRose
```

## Components

### User experience

- [Chat interface](https://github.com/ragz743/team_15_capstone_project/blob/main/code_/frontend/components/ChatWorkspace.tsx): `code_/frontend/components/ChatWorkspace.tsx`
- [Frontend app](https://github.com/ragz743/team_15_capstone_project/blob/main/code_/frontend/src/App.tsx): `code_/frontend/src/App.tsx`

### Weather answering

- [Backend API](https://github.com/ragz743/team_15_capstone_project/blob/main/code_/backend/api.py): `code_/backend/api.py`
- [Weather retriever](https://github.com/ragz743/team_15_capstone_project/blob/main/code_/backend/retriever.py): `code_/backend/retriever.py`
- [Vector search](https://github.com/ragz743/team_15_capstone_project/blob/main/code_/backend/vector_store.py): `code_/backend/vector_store.py`
- [pgvector connection](https://github.com/ragz743/team_15_capstone_project/blob/main/code_/backend/databases/pgvector.py): `code_/backend/databases/pgvector.py`

### Data ingestion

- [Data workflow](https://github.com/ragz743/team_15_capstone_project/blob/main/code_/backend/workflow/workflow.py): `code_/backend/workflow/workflow.py`
- [Daily loader](https://github.com/ragz743/team_15_capstone_project/blob/main/code_/backend/loaders/daily_loader.py): `code_/backend/loaders/daily_loader.py`
- [Live loader](https://github.com/ragz743/team_15_capstone_project/blob/main/code_/backend/loaders/live_loader.py): `code_/backend/loaders/live_loader.py`
- [Forecast loader](https://github.com/ragz743/team_15_capstone_project/blob/main/code_/backend/loaders/forecast_loader.py): `code_/backend/loaders/forecast_loader.py`
- [Station metadata](https://github.com/ragz743/team_15_capstone_project/blob/main/code_/backend/loaders/_common.py): `code_/backend/loaders/_common.py`
- [AWN connection base](https://github.com/ragz743/team_15_capstone_project/blob/main/code_/backend/databases/_awn_connection_base.py): `code_/backend/databases/_awn_connection_base.py`
- [Daily database](https://github.com/ragz743/team_15_capstone_project/blob/main/code_/backend/databases/awn_daily_connection.py): `code_/backend/databases/awn_daily_connection.py`
- [Live database](https://github.com/ragz743/team_15_capstone_project/blob/main/code_/backend/databases/awn_main_connection.py): `code_/backend/databases/awn_main_connection.py`
- [Forecast database](https://github.com/ragz743/team_15_capstone_project/blob/main/code_/backend/databases/awn_fc_connection.py): `code_/backend/databases/awn_fc_connection.py`

### Model integrations

- [Model factory](https://github.com/ragz743/team_15_capstone_project/blob/main/code_/backend/model_factory.py): `code_/backend/model_factory.py`
- [Embedding interface](https://github.com/ragz743/team_15_capstone_project/blob/main/code_/backend/models/_embedding_base.py): `code_/backend/models/_embedding_base.py`
- [OpenRouter embeddings](https://github.com/ragz743/team_15_capstone_project/blob/main/code_/backend/models/embedding_openrouter.py): `code_/backend/models/embedding_openrouter.py`
- [Chatbot interface](https://github.com/ragz743/team_15_capstone_project/blob/main/code_/backend/models/_chatbot_base.py): `code_/backend/models/_chatbot_base.py`
- [Chatbot providers](https://github.com/ragz743/team_15_capstone_project/blob/main/code_/backend/models/chatbot_openrouter.py): `code_/backend/models/chatbot_openrouter.py`

### Other components

- **Weather user**
- **OpenRouter service**

## Connections

- Weather user → Chat interface: asks weather
- Chat interface → Frontend app: renders
- Frontend app → Backend API: sends requests
- Backend API → Weather retriever: imports (evidence: `code_/backend/api.py`)
- Backend API → Vector search: imports (evidence: `code_/backend/api.py`)
- Weather retriever → Vector search: searches (evidence: `code_/backend/retriever.py`)
- Weather retriever → Chatbot interface: invokes (evidence: `code_/backend/retriever.py`)
- Vector search → pgvector connection: queries (evidence: `code_/backend/vector_store.py`)
- Data workflow → Model factory: references (evidence: `code_/backend/workflow/workflow.py`)
- Daily loader → Station metadata: queries stations (evidence: `code_/backend/loaders/daily_loader.py`)
- Live loader → Station metadata: queries stations (evidence: `code_/backend/loaders/live_loader.py`)
- Forecast loader → Station metadata: queries stations (evidence: `code_/backend/loaders/forecast_loader.py`)
- Station metadata → Live database: queries metadata (evidence: `code_/backend/loaders/_common.py`)
- Daily loader → Daily database: queries (evidence: `code_/backend/loaders/daily_loader.py`)
- Live loader → Live database: queries (evidence: `code_/backend/loaders/live_loader.py`)
- Forecast loader → Forecast database: queries (evidence: `code_/backend/loaders/forecast_loader.py`)
- Daily database → AWN connection base: extends (evidence: `code_/backend/databases/awn_daily_connection.py`)
- Live database → AWN connection base: extends (evidence: `code_/backend/databases/awn_main_connection.py`)
- Forecast database → AWN connection base: extends (evidence: `code_/backend/databases/awn_fc_connection.py`)
- Daily loader → Embedding interface: embeds documents (evidence: `code_/backend/loaders/daily_loader.py`)
- Live loader → Embedding interface: embeds documents (evidence: `code_/backend/loaders/live_loader.py`)
- Forecast loader → Embedding interface: embeds documents (evidence: `code_/backend/loaders/forecast_loader.py`)
- Daily loader → pgvector connection: stores records (evidence: `code_/backend/loaders/daily_loader.py`)
- Live loader → pgvector connection: stores records (evidence: `code_/backend/loaders/live_loader.py`)
- Forecast loader → pgvector connection: stores records (evidence: `code_/backend/loaders/forecast_loader.py`)
- Model factory → Embedding interface: creates (evidence: `code_/backend/model_factory.py`)
- Model factory → Chatbot interface: creates (evidence: `code_/backend/model_factory.py`)
- OpenRouter embeddings → Embedding interface: implements (evidence: `code_/backend/models/embedding_openrouter.py`)
- Chatbot providers → Chatbot interface: implements (evidence: `code_/backend/models/chatbot_openrouter.py`)
- OpenRouter embeddings → OpenRouter service: calls
- Chatbot providers → OpenRouter service: calls
