How dieppdiepp/scholarshiprouting works
Scholarship Routing aggregates scholarship information, supports filtered discovery and detailed search, and offers AI consultation and application tracking. The user-facing workflow enters the FastAPI server, which exposes search and other service routes; search uses Elasticsearch. A separate collection workflow researches scholarship names and produces structured reports, while two chatbot implementations provide complementary consultation and RAG paths. The graph preserves README capabilities whose internal implementation was not sampled; those links are omitted or marked unverified rather than inferred from filenames.
Main entry points: app.py FastAPI Server · chatbot_thread1/main.py Intent-and-Tool Chatbot · data_collection/main.py Collection Runner · graph.py Research Graph
Components 26
Application API
- FastAPI Server
src/server/app.py - Firestore Route
src/server/routes/firestore_routes.py - Firestore Service
src/server/services/firestore_svc.py - Application Tracking
src/server/routes/user.py
Scholarship Discovery
- Search Route
src/server/routes/search.py - Elasticsearch Service
src/server/services/es_svc.py - Scholarship Index
- Structured Scholarship Query
src/chatbot_thread1/core/tools/structured_query.py - Scholarship Data Loader
src/chatbot_thread1/core/utils/data_loader.py - Semantic Search
src/chatbot_thread1/core/tools/semantic_search.py
AI Consultation
- Chatbot Route
src/server/routes/chatbot.py - Scholarship Agent
src/server/services/chatbot_thread1/core/agents/scholarship_agent.py - Chatbot Service Entry
src/server/services/chatbot_thread1/main.py - RAG Query Router
src/server/services/chatbot_thread2/rag_pipeline/query_router.py - RAG Retriever
src/server/services/chatbot_thread2/rag_pipeline/retriever.py - Intent-and-Tool Chatbot
src/chatbot_thread1/main.py - Intent Router
src/chatbot_thread1/core/modules/intent_router.py - Response Generator
src/chatbot_thread1/core/modules/response_generator.py - Profile-Based Advice
src/server/services/chatbot_thread1/core/tools/profile_retriever.py
Data Collection
- Collection Runner
src/data_collection/main.py - Research Graph
src/data_collection/agent/graph.py - Research Stages
src/data_collection/agent/nodes.py - Web Research Tools
src/data_collection/agent/tools.py - Research Prompts
src/data_collection/prompts/structuring.py - Structured Reports
src/data_collection/config.py
Other components
- Student
Connections 27
- Student → FastAPI Server: uses platform
- FastAPI Server → Search Route: mounts routes
src/server/app.py - FastAPI Server → Firestore Route: mounts routes
src/server/app.py - FastAPI Server → Chatbot Route: mounts routes
src/server/app.py - FastAPI Server → Application Tracking: mounts routes
src/server/app.py - Search Route → Elasticsearch Service: queries
src/server/routes/search.py - Elasticsearch Service → Scholarship Index: searches index
- Firestore Route → Firestore Service: reads and writes
src/server/routes/firestore_routes.py - Chatbot Route → Chatbot Service Entry: dispatches chat
- Chatbot Service Entry → Scholarship Agent: invokes agent
src/server/services/chatbot_thread1/main.py - RAG Query Router → RAG Retriever: routes retrieval
src/server/services/chatbot_thread2/rag_pipeline/query_router.py - Collection Runner → Research Graph: runs agent
src/data_collection/main.py - Collection Runner → Web Research Tools: creates tool
src/data_collection/main.py - Research Graph → Research Stages: dispatches stages
src/data_collection/agent/graph.py - Research Graph → Web Research Tools: uses tools
src/data_collection/agent/graph.py - Research Stages → Web Research Tools: searches web
src/data_collection/agent/nodes.py - Research Stages → Research Prompts: uses prompts
src/data_collection/agent/nodes.py - Collection Runner → Structured Reports: writes reports
src/data_collection/main.py - Intent-and-Tool Chatbot → Intent Router: classifies intent
src/chatbot_thread1/main.py - Intent-and-Tool Chatbot → Response Generator: generates answer
src/chatbot_thread1/main.py - Intent-and-Tool Chatbot → Structured Scholarship Query: runs search
src/chatbot_thread1/main.py - Intent-and-Tool Chatbot → Semantic Search: runs search
src/chatbot_thread1/main.py - Structured Scholarship Query → Scholarship Data Loader: reads scholarship data
src/chatbot_thread1/core/tools/structured_query.py - Student → Search Route: finds scholarships
- Student → Chatbot Route: asks consultant
- Student → Application Tracking: tracks applications
- Student → Profile-Based Advice: gets personalized advice