How ragz743/team_15_capstone_project works
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: _embedding_base.py Embedding interface · daily_loader.py Daily loader · live_loader.py Live loader · forecast_loader.py Forecast loader
Components 22
User experience
- Chat interface
code_/frontend/components/ChatWorkspace.tsx - Frontend app
code_/frontend/src/App.tsx
Weather answering
- Backend API
code_/backend/api.py - Weather retriever
code_/backend/retriever.py - Vector search
code_/backend/vector_store.py - pgvector connection
code_/backend/databases/pgvector.py
Data ingestion
- Data workflow
code_/backend/workflow/workflow.py - Daily loader
code_/backend/loaders/daily_loader.py - Live loader
code_/backend/loaders/live_loader.py - Forecast loader
code_/backend/loaders/forecast_loader.py - Station metadata
code_/backend/loaders/_common.py - AWN connection base
code_/backend/databases/_awn_connection_base.py - Daily database
code_/backend/databases/awn_daily_connection.py - Live database
code_/backend/databases/awn_main_connection.py - Forecast database
code_/backend/databases/awn_fc_connection.py
Model integrations
- Model factory
code_/backend/model_factory.py - Embedding interface
code_/backend/models/_embedding_base.py - OpenRouter embeddings
code_/backend/models/embedding_openrouter.py - Chatbot interface
code_/backend/models/_chatbot_base.py - Chatbot providers
code_/backend/models/chatbot_openrouter.py
Other components
- Weather user
- OpenRouter service
Connections 31
- Weather user → Chat interface: asks weather
- Chat interface → Frontend app: renders
- Frontend app → Backend API: sends requests
- Backend API → Weather retriever: imports
code_/backend/api.py - Backend API → Vector search: imports
code_/backend/api.py - Weather retriever → Vector search: searches
code_/backend/retriever.py - Weather retriever → Chatbot interface: invokes
code_/backend/retriever.py - Vector search → pgvector connection: queries
code_/backend/vector_store.py - Data workflow → Model factory: references
code_/backend/workflow/workflow.py - Daily loader → Station metadata: queries stations
code_/backend/loaders/daily_loader.py - Live loader → Station metadata: queries stations
code_/backend/loaders/live_loader.py - Forecast loader → Station metadata: queries stations
code_/backend/loaders/forecast_loader.py - Station metadata → Live database: queries metadata
code_/backend/loaders/_common.py - Daily loader → Daily database: queries
code_/backend/loaders/daily_loader.py - Live loader → Live database: queries
code_/backend/loaders/live_loader.py - Forecast loader → Forecast database: queries
code_/backend/loaders/forecast_loader.py - Daily database → AWN connection base: extends
code_/backend/databases/awn_daily_connection.py - Live database → AWN connection base: extends
code_/backend/databases/awn_main_connection.py - Forecast database → AWN connection base: extends
code_/backend/databases/awn_fc_connection.py - Daily loader → Embedding interface: embeds documents
code_/backend/loaders/daily_loader.py - Live loader → Embedding interface: embeds documents
code_/backend/loaders/live_loader.py - Forecast loader → Embedding interface: embeds documents
code_/backend/loaders/forecast_loader.py - Daily loader → pgvector connection: stores records
code_/backend/loaders/daily_loader.py - Live loader → pgvector connection: stores records
code_/backend/loaders/live_loader.py - Forecast loader → pgvector connection: stores records
code_/backend/loaders/forecast_loader.py - Model factory → Embedding interface: creates
code_/backend/model_factory.py - Model factory → Chatbot interface: creates
code_/backend/model_factory.py - OpenRouter embeddings → Embedding interface: implements
code_/backend/models/embedding_openrouter.py - Chatbot providers → Chatbot interface: implements
code_/backend/models/chatbot_openrouter.py - OpenRouter embeddings → OpenRouter service: calls
- Chatbot providers → OpenRouter service: calls