How aryankb/google-hackathon works
Main Components
A. Core Services Layer:
• Location Intelligence Service (map.py, geocoding.py, highway.py)
• Demand Forecasting Service (tasks.py)
• Customer Experience Service (agents.py)
• Data Scraping Service (scrap.py, selen.py)
B. API Layer:
• FastAPI Application (fastapi_app.py, api.py)
• Schema Definitions (schemas.py)
C. Data Layer:
• Database Service (database.py, tables.py)
• Data Storage (saved.db)
D. Utility Layer:
• Tools and Helpers (tools.py)
• Clustering Logic (cluster.py)
• Crew Management (crew.py)
Component Relationships
[External Services] ←→ [API Layer] ←→ [Core Services] ←→ [Data Layer]
• ↑ ↑ ↑ ↑
• ┴──────────────┴────────────────┘
• [Utility Layer]
Specific Elements
A. External Interfaces:
• Web Scraping Endpoints
• Geocoding Services
• Highway/Road Data Sources
• AI/ML Services (for chatbot)
B. Process Flows:
1. Location Analysis Flow:
• Geocoding → Clustering → Highway Analysis → Location Scoring
2. Demand Forecasting Flow:
• Data Scraping → Sales Analysis → Festive Calendar → AI Processing
3. Customer Experience Flow:
• User Input → Chatbot → Product Search → Recommendations
Important Details to Highlight
A. Integration Points:
• Database Connections
• External API Calls
• AI Agent Interactions
B. Data Flows:
• Location Data Processing
• Sales Data Analysis
• Customer Interaction Paths
C. Key Technologies:
• FastAPI
• SQLite Database
• AI Agents (presumably using Gemini)
• Selenium (for web scraping)
Architectural Patterns to Emphasize
• Modular Design: Show clear separation between different functional modules
• Service-Oriented: Highlight independent services working together
• Data-Driven: Emphasize the role of data processing and analysis