# yobo-dance/project-google-hackathon architecture

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

- Interactive diagram: https://gitdiagram.com/yobo-dance/project-google-hackathon
- Repository: https://github.com/yobo-dance/project-google-hackathon

## Overview

Sports Concierge generates personalized training plans through a security review and approval gate. The primary documented flow is the Streamlit dashboard: collect athlete details and context, gather email and drive metadata, scan files, assess risk, pause for human approval when needed, then generate and display a plan with an audit trail. The repository also contains a separate ADK/FastAPI serving surface with A2A and reasoning-engine routes. Its connections are limited to relationships shown in excerpts or the SOURCE INDEX; the README describes some dashboard capabilities whose implementation was not sampled.

Main entry points: [`app.py`](https://github.com/yobo-dance/project-google-hackathon/blob/main/app.py) (Streamlit dashboard), [`sports-concierge/app/fast_api_app.py`](https://github.com/yobo-dance/project-google-hackathon/blob/main/sports-concierge/app/fast_api_app.py) (FastAPI app), [`agents/guard.py`](https://github.com/yobo-dance/project-google-hackathon/blob/main/agents/guard.py) (Guard agent), [`sports-concierge/app/app_utils/reasoning_engine_adapter.py`](https://github.com/yobo-dance/project-google-hackathon/blob/main/sports-concierge/app/app_utils/reasoning_engine_adapter.py) (Reasoning routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_dashboard["Dashboard workflow"]
  node_dashboard_app["Streamlit dashboard<br/>[app.py]"]
  node_plan_result["Training plan"]
end

subgraph group_agents["Agent workflow"]
  node_guard["Guard agent<br/>[guard.py]"]
  node_coach["Coach agent<br/>[coach.py]"]
end

subgraph group_tools["Context and security tools"]
  node_email["Email context<br/>[server_mcp.py]"]
  node_drive["Drive files<br/>[server_mcp.py]"]
  node_mcp_scan["MCP scan tool<br/>[server_mcp.py]"]
  node_scanner["Security scanner<br/>[sandbox.py]"]
end

subgraph group_persistence["Audit persistence"]
  node_audit["Audit trail<br/>[manager.py]"]
end

subgraph group_serving["ADK serving"]
  node_fastapi["FastAPI app<br/>[fast_api_app.py]"]
  node_adk_agent["ADK agent<br/>[agent.py]"]
  node_a2a_routes["A2A routes<br/>[a2a.py]"]
  node_reasoning_routes["Reasoning routes"]
  node_shared_services["Shared services<br/>[services.py]"]
  node_telemetry["Telemetry<br/>[telemetry.py]"]
  node_feedback_model["Feedback schema<br/>[typing.py]"]
end

node_athlete(("Athlete"))
node_plan_model["Plan model"]
node_supabase[("Supabase")]
node_adk_client(("ADK client"))

node_athlete -->|"enters details"| node_dashboard_app
node_dashboard_app -->|"requests assessment"| node_guard
node_guard -->|"gathers context"| node_email
node_guard -->|"gathers context"| node_drive
node_guard -->|"requests scans"| node_mcp_scan
node_mcp_scan -->|"delegates scan"| node_scanner
node_guard -->|"returns risk"| node_dashboard_app
node_athlete -->|"approves or denies"| node_dashboard_app
node_dashboard_app -->|"requests plan"| node_coach
node_coach -->|"generates with"| node_plan_model
node_plan_model -->|"returns plan"| node_dashboard_app
node_dashboard_app -->|"displays and downloads"| node_plan_result
node_dashboard_app -.->|"logs events"| node_audit
node_audit -->|"writes events"| node_supabase
node_adk_client -.->|"calls API"| node_fastapi
node_fastapi -->|"loads agent"| node_adk_agent
node_fastapi -->|"attaches routes"| node_a2a_routes
node_fastapi -->|"attaches routes"| node_reasoning_routes
node_fastapi -->|"uses services"| node_shared_services
node_fastapi -->|"sets up"| node_telemetry
node_fastapi -->|"validates feedback"| node_feedback_model
node_reasoning_routes -->|"dispatches methods"| node_adk_agent
node_reasoning_routes -->|"reuses services"| node_shared_services

click node_dashboard_app "https://github.com/yobo-dance/project-google-hackathon/blob/main/app.py"
click node_guard "https://github.com/yobo-dance/project-google-hackathon/blob/main/agents/guard.py"
click node_coach "https://github.com/yobo-dance/project-google-hackathon/blob/main/agents/coach.py"
click node_email "https://github.com/yobo-dance/project-google-hackathon/blob/main/tools/server_mcp.py"
click node_drive "https://github.com/yobo-dance/project-google-hackathon/blob/main/tools/server_mcp.py"
click node_mcp_scan "https://github.com/yobo-dance/project-google-hackathon/blob/main/tools/server_mcp.py"
click node_scanner "https://github.com/yobo-dance/project-google-hackathon/blob/main/security/sandbox.py"
click node_audit "https://github.com/yobo-dance/project-google-hackathon/blob/main/database/manager.py"
click node_fastapi "https://github.com/yobo-dance/project-google-hackathon/blob/main/sports-concierge/app/fast_api_app.py"
click node_adk_agent "https://github.com/yobo-dance/project-google-hackathon/blob/main/sports-concierge/app/agent.py"
click node_a2a_routes "https://github.com/yobo-dance/project-google-hackathon/blob/main/sports-concierge/app/app_utils/a2a.py"
click node_reasoning_routes "https://github.com/yobo-dance/project-google-hackathon/blob/main/sports-concierge/app/app_utils/reasoning_engine_adapter.py"
click node_shared_services "https://github.com/yobo-dance/project-google-hackathon/blob/main/sports-concierge/app/app_utils/services.py"
click node_telemetry "https://github.com/yobo-dance/project-google-hackathon/blob/main/sports-concierge/app/app_utils/telemetry.py"
click node_feedback_model "https://github.com/yobo-dance/project-google-hackathon/blob/main/sports-concierge/app/app_utils/typing.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_dashboard_app,node_plan_result,node_adk_client toneBlue
class node_guard,node_coach,node_supabase toneAmber
class node_email,node_drive,node_mcp_scan,node_scanner toneMint
class node_audit toneRose
class node_fastapi,node_adk_agent,node_a2a_routes,node_reasoning_routes,node_shared_services,node_telemetry,node_feedback_model,node_athlete,node_plan_model toneIndigo
```

## Components

### Dashboard workflow

- [Streamlit dashboard](https://github.com/yobo-dance/project-google-hackathon/blob/main/app.py): `app.py`
- **Training plan**

### Agent workflow

- [Guard agent](https://github.com/yobo-dance/project-google-hackathon/blob/main/agents/guard.py): `agents/guard.py`
- [Coach agent](https://github.com/yobo-dance/project-google-hackathon/blob/main/agents/coach.py): `agents/coach.py`

### Context and security tools

- [Email context](https://github.com/yobo-dance/project-google-hackathon/blob/main/tools/server_mcp.py): `tools/server_mcp.py`
- [Drive files](https://github.com/yobo-dance/project-google-hackathon/blob/main/tools/server_mcp.py): `tools/server_mcp.py`
- [MCP scan tool](https://github.com/yobo-dance/project-google-hackathon/blob/main/tools/server_mcp.py): `tools/server_mcp.py`
- [Security scanner](https://github.com/yobo-dance/project-google-hackathon/blob/main/security/sandbox.py): `security/sandbox.py`

### Audit persistence

- [Audit trail](https://github.com/yobo-dance/project-google-hackathon/blob/main/database/manager.py): `database/manager.py`

### ADK serving

- [FastAPI app](https://github.com/yobo-dance/project-google-hackathon/blob/main/sports-concierge/app/fast_api_app.py): `sports-concierge/app/fast_api_app.py`
- [ADK agent](https://github.com/yobo-dance/project-google-hackathon/blob/main/sports-concierge/app/agent.py): `sports-concierge/app/agent.py`
- [A2A routes](https://github.com/yobo-dance/project-google-hackathon/blob/main/sports-concierge/app/app_utils/a2a.py): `sports-concierge/app/app_utils/a2a.py`
- [Reasoning routes](https://github.com/yobo-dance/project-google-hackathon/blob/main/sports-concierge/app/app_utils/reasoning_engine_adapter.py): `sports-concierge/app/app_utils/reasoning_engine_adapter.py`
- [Shared services](https://github.com/yobo-dance/project-google-hackathon/blob/main/sports-concierge/app/app_utils/services.py): `sports-concierge/app/app_utils/services.py`
- [Telemetry](https://github.com/yobo-dance/project-google-hackathon/blob/main/sports-concierge/app/app_utils/telemetry.py): `sports-concierge/app/app_utils/telemetry.py`
- [Feedback schema](https://github.com/yobo-dance/project-google-hackathon/blob/main/sports-concierge/app/app_utils/typing.py): `sports-concierge/app/app_utils/typing.py`

### Other components

- **Athlete**
- **Plan model**
- **Supabase**
- **ADK client**

## Connections

- Athlete → Streamlit dashboard: enters details (evidence: `README.md`)
- Streamlit dashboard → Guard agent: requests assessment (evidence: `app.py`)
- Guard agent → Email context: gathers context (evidence: `README.md`)
- Guard agent → Drive files: gathers context (evidence: `README.md`)
- Guard agent → MCP scan tool: requests scans (evidence: `agents/guard.py`)
- MCP scan tool → Security scanner: delegates scan (evidence: `tools/server_mcp.py`)
- Guard agent → Streamlit dashboard: returns risk (evidence: `README.md`)
- Athlete → Streamlit dashboard: approves or denies (evidence: `README.md`)
- Streamlit dashboard → Coach agent: requests plan (evidence: `README.md`)
- Coach agent → Plan model: generates with (evidence: `README.md`)
- Plan model → Streamlit dashboard: returns plan (evidence: `README.md`)
- Streamlit dashboard → Training plan: displays and downloads (evidence: `README.md`)
- Streamlit dashboard → Audit trail: logs events (evidence: `app.py`)
- Audit trail → Supabase: writes events (evidence: `database/manager.py`)
- ADK client → FastAPI app: calls API
- FastAPI app → ADK agent: loads agent (evidence: `sports-concierge/app/fast_api_app.py`)
- FastAPI app → A2A routes: attaches routes (evidence: `sports-concierge/app/fast_api_app.py`)
- FastAPI app → Reasoning routes: attaches routes (evidence: `sports-concierge/app/fast_api_app.py`)
- FastAPI app → Shared services: uses services (evidence: `sports-concierge/app/fast_api_app.py`)
- FastAPI app → Telemetry: sets up (evidence: `sports-concierge/app/fast_api_app.py`)
- FastAPI app → Feedback schema: validates feedback (evidence: `sports-concierge/app/fast_api_app.py`)
- Reasoning routes → ADK agent: dispatches methods (evidence: `sports-concierge/app/app_utils/reasoning_engine_adapter.py`)
- Reasoning routes → Shared services: reuses services (evidence: `sports-concierge/app/app_utils/reasoning_engine_adapter.py`)
