# lucalmz/scoutingpro27 architecture

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

- Interactive diagram: https://gitdiagram.com/lucalmz/scoutingpro27
- Repository: https://github.com/lucalmz/scoutingpro27

## Overview

ScoutingPro27 is an offline-capable FTC scouting and team-coordination product. Scouts join a host-run event, collect pit and match observations, synchronize across peers, and use the resulting data for schedules, rankings, and tactical decisions. The graph combines documented product capabilities with source-index relationships and sampled calls; several frontend and route-to-storage links are documented or implied by the README rather than verified from their unsampled implementations.

Main entry points: [`frontend/src/views/EventView.vue`](https://github.com/lucalmz/scoutingpro27/blob/master/frontend/src/views/EventView.vue) (Event Workspace), [`Backend/src/main/java/com/bear27570/app/routes/RecordRoutes.java`](https://github.com/lucalmz/scoutingpro27/blob/master/Backend/src/main/java/com/bear27570/app/routes/RecordRoutes.java) (Record API), [`Backend/src/main/java/com/bear27570/app/routes/ApiRoutes.java`](https://github.com/lucalmz/scoutingpro27/blob/master/Backend/src/main/java/com/bear27570/app/routes/ApiRoutes.java) (Authentication And API), [`frontend/src/services/webrtc/clientSession.ts`](https://github.com/lucalmz/scoutingpro27/blob/master/frontend/src/services/webrtc/clientSession.ts) (WebRTC Peer Sessions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Scouting Client"]
  node_app["Vue Application<br/>[App.vue]"]
end

subgraph group_coordination["Peer Coordination"]
  node_webclient["WebRTC Peer Sessions<br/>[clientSession.ts]"]
  node_peers["Peer Connection Manager<br/>[peerManager.ts]"]
end

subgraph group_scouting["Scouting Operations"]
  node_events["Event Workspace<br/>[EventView.vue]"]
  node_pitform["Pit Scouting<br/>[PitScoutView.vue]"]
  node_matchform["Match Scouting<br/>[ScoutingForm.vue]"]
  node_schedule["Schedule Management"]
  node_customfields["Custom Fields"]
end

subgraph group_analysis["Analysis And Assistance"]
  node_analysis["Rankings And Audit<br/>[rankings.ts]"]
  node_aiui["AI Chat<br/>[AiChatView.vue]"]
end

subgraph group_backend["Local Backend"]
  node_records["Record API<br/>[RecordRoutes.java]"]
  node_pitapi["Pit API"]
  node_eventapi["Event API<br/>[EventRoutes.java]"]
  node_scheduleapi["Schedule API"]
  node_customapi["Custom Field API"]
  node_ftc["FTC Event Data<br/>[FtcApiClient.java]"]
  node_aiapi["AI Routes<br/>[AiRoutes.java]"]
  node_aiclient["AI Provider Client<br/>[AiClient.java]"]
  node_signaling["Signaling Routes"]
  node_auth["Authentication And API<br/>[ApiRoutes.java]"]
  node_runtime["Desktop Host Runtime<br/>[Main.java]"]
  node_database[("Embedded H2 Data<br/>[AppConfig.java]")]
  node_eventdao["Event Persistence<br/>[EventDao.java]"]
  node_recorddao["Record Persistence<br/>[RecordDao.java]"]
  node_userdao["User Persistence<br/>[UserDao.java]"]
end

node_scout(("Scout Or Host"))
node_externalftc{{"FTC Services"}}
node_ai_provider{{"AI Provider"}}
node_ice{{"STUN And TURN"}}

node_scout -->|"uses"| node_app
node_app -->|"opens"| node_events
node_events -->|"records pit data"| node_pitform
node_events -->|"records match data"| node_matchform
node_events -->|"manages assignments"| node_schedule
node_events -->|"configures fields"| node_customfields
node_pitform -->|"submits pit records"| node_pitapi
node_matchform -->|"submits scouting records"| node_records
node_schedule -->|"syncs assignments"| node_scheduleapi
node_customfields -->|"manages definitions"| node_customapi
node_events -->|"joins and syncs events"| node_eventapi
node_eventapi -->|"queries events"| node_eventdao
node_records -->|"reads and writes"| node_recorddao
node_pitapi -->|"checks membership"| node_eventdao
node_runtime -->|"registers routes"| node_auth
node_auth -->|"registers routes"| node_eventapi
node_auth -->|"registers routes"| node_records
node_auth -->|"registers routes"| node_aiapi
node_eventdao -->|"persists events"| node_database
node_recorddao -->|"persists records"| node_database
node_userdao -->|"persists users"| node_database
node_eventapi -->|"requests event data"| node_ftc
node_ftc -->|"fetches official data"| node_externalftc
node_records -->|"supplies scouting data"| node_analysis
node_analysis -->|"shows rankings"| node_scout
node_aiui -->|"requests chat"| node_aiapi
node_aiapi -->|"sends prompts"| node_aiclient
node_aiclient -->|"calls provider"| node_ai_provider
node_scout -->|"joins event"| node_webclient
node_webclient -->|"establishes peer links"| node_peers
node_peers -->|"exchanges signaling"| node_signaling
node_signaling -->|"relays connection setup"| node_webclient
node_peers -->|"probes connectivity"| node_ice
node_webclient -.->|"syncs scouting data"| node_records

click node_app "https://github.com/lucalmz/scoutingpro27/blob/master/frontend/src/App.vue"
click node_events "https://github.com/lucalmz/scoutingpro27/blob/master/frontend/src/views/EventView.vue"
click node_pitform "https://github.com/lucalmz/scoutingpro27/blob/master/frontend/src/components/pit/PitScoutView.vue"
click node_matchform "https://github.com/lucalmz/scoutingpro27/blob/master/frontend/src/components/scouting/ScoutingForm.vue"
click node_schedule "https://github.com/lucalmz/scoutingpro27/blob/master/frontend/src/components/schedule/ScheduleManager.vue"
click node_customfields "https://github.com/lucalmz/scoutingpro27/blob/master/frontend/src/components/customFields/CustomFieldsManagerModal.vue"
click node_records "https://github.com/lucalmz/scoutingpro27/blob/master/Backend/src/main/java/com/bear27570/app/routes/RecordRoutes.java"
click node_pitapi "https://github.com/lucalmz/scoutingpro27/blob/master/Backend/src/main/java/com/bear27570/app/routes/PitScoutRoutes.java"
click node_eventapi "https://github.com/lucalmz/scoutingpro27/blob/master/Backend/src/main/java/com/bear27570/app/routes/EventRoutes.java"
click node_scheduleapi "https://github.com/lucalmz/scoutingpro27/blob/master/Backend/src/main/java/com/bear27570/app/routes/ScheduleRoutes.java"
click node_customapi "https://github.com/lucalmz/scoutingpro27/blob/master/Backend/src/main/java/com/bear27570/app/routes/CustomFieldRoutes.java"
click node_ftc "https://github.com/lucalmz/scoutingpro27/blob/master/Backend/src/main/java/com/bear27570/app/util/FtcApiClient.java"
click node_analysis "https://github.com/lucalmz/scoutingpro27/blob/master/frontend/src/utils/analytics/rankings.ts"
click node_aiui "https://github.com/lucalmz/scoutingpro27/blob/master/frontend/src/components/ai/AiChatView.vue"
click node_aiapi "https://github.com/lucalmz/scoutingpro27/blob/master/Backend/src/main/java/com/bear27570/app/routes/AiRoutes.java"
click node_aiclient "https://github.com/lucalmz/scoutingpro27/blob/master/Backend/src/main/java/com/bear27570/app/util/AiClient.java"
click node_webclient "https://github.com/lucalmz/scoutingpro27/blob/master/frontend/src/services/webrtc/clientSession.ts"
click node_peers "https://github.com/lucalmz/scoutingpro27/blob/master/frontend/src/services/webrtc/peerManager.ts"
click node_signaling "https://github.com/lucalmz/scoutingpro27/blob/master/Backend/src/main/java/com/bear27570/app/routes/SignalingRoutes.java"
click node_auth "https://github.com/lucalmz/scoutingpro27/blob/master/Backend/src/main/java/com/bear27570/app/routes/ApiRoutes.java"
click node_runtime "https://github.com/lucalmz/scoutingpro27/blob/master/Backend/src/main/java/com/bear27570/app/Main.java"
click node_database "https://github.com/lucalmz/scoutingpro27/blob/master/Backend/src/main/java/com/bear27570/app/db/AppConfig.java"
click node_eventdao "https://github.com/lucalmz/scoutingpro27/blob/master/Backend/src/main/java/com/bear27570/app/dao/EventDao.java"
click node_recorddao "https://github.com/lucalmz/scoutingpro27/blob/master/Backend/src/main/java/com/bear27570/app/dao/RecordDao.java"
click node_userdao "https://github.com/lucalmz/scoutingpro27/blob/master/Backend/src/main/java/com/bear27570/app/dao/UserDao.java"

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_app toneBlue
class node_webclient,node_peers toneAmber
class node_events,node_pitform,node_matchform,node_schedule,node_customfields toneMint
class node_analysis,node_aiui toneRose
class node_records,node_pitapi,node_eventapi,node_scheduleapi,node_customapi,node_ftc,node_aiapi,node_aiclient,node_signaling,node_auth,node_runtime,node_database,node_eventdao,node_recorddao,node_userdao,node_scout,node_externalftc,node_ai_provider,node_ice toneIndigo
```

## Components

### Scouting Client

- [Vue Application](https://github.com/lucalmz/scoutingpro27/blob/master/frontend/src/App.vue): `frontend/src/App.vue`

### Peer Coordination

- [WebRTC Peer Sessions](https://github.com/lucalmz/scoutingpro27/blob/master/frontend/src/services/webrtc/clientSession.ts): `frontend/src/services/webrtc/clientSession.ts`
- [Peer Connection Manager](https://github.com/lucalmz/scoutingpro27/blob/master/frontend/src/services/webrtc/peerManager.ts): `frontend/src/services/webrtc/peerManager.ts`

### Scouting Operations

- [Event Workspace](https://github.com/lucalmz/scoutingpro27/blob/master/frontend/src/views/EventView.vue): `frontend/src/views/EventView.vue`
- [Pit Scouting](https://github.com/lucalmz/scoutingpro27/blob/master/frontend/src/components/pit/PitScoutView.vue): `frontend/src/components/pit/PitScoutView.vue`
- [Match Scouting](https://github.com/lucalmz/scoutingpro27/blob/master/frontend/src/components/scouting/ScoutingForm.vue): `frontend/src/components/scouting/ScoutingForm.vue`
- [Schedule Management](https://github.com/lucalmz/scoutingpro27/blob/master/frontend/src/components/schedule/ScheduleManager.vue): `frontend/src/components/schedule/ScheduleManager.vue`
- [Custom Fields](https://github.com/lucalmz/scoutingpro27/blob/master/frontend/src/components/customFields/CustomFieldsManagerModal.vue): `frontend/src/components/customFields/CustomFieldsManagerModal.vue`

### Analysis And Assistance

- [Rankings And Audit](https://github.com/lucalmz/scoutingpro27/blob/master/frontend/src/utils/analytics/rankings.ts): `frontend/src/utils/analytics/rankings.ts`
- [AI Chat](https://github.com/lucalmz/scoutingpro27/blob/master/frontend/src/components/ai/AiChatView.vue): `frontend/src/components/ai/AiChatView.vue`

### Local Backend

- [Record API](https://github.com/lucalmz/scoutingpro27/blob/master/Backend/src/main/java/com/bear27570/app/routes/RecordRoutes.java): `Backend/src/main/java/com/bear27570/app/routes/RecordRoutes.java`
- [Pit API](https://github.com/lucalmz/scoutingpro27/blob/master/Backend/src/main/java/com/bear27570/app/routes/PitScoutRoutes.java): `Backend/src/main/java/com/bear27570/app/routes/PitScoutRoutes.java`
- [Event API](https://github.com/lucalmz/scoutingpro27/blob/master/Backend/src/main/java/com/bear27570/app/routes/EventRoutes.java): `Backend/src/main/java/com/bear27570/app/routes/EventRoutes.java`
- [Schedule API](https://github.com/lucalmz/scoutingpro27/blob/master/Backend/src/main/java/com/bear27570/app/routes/ScheduleRoutes.java): `Backend/src/main/java/com/bear27570/app/routes/ScheduleRoutes.java`
- [Custom Field API](https://github.com/lucalmz/scoutingpro27/blob/master/Backend/src/main/java/com/bear27570/app/routes/CustomFieldRoutes.java): `Backend/src/main/java/com/bear27570/app/routes/CustomFieldRoutes.java`
- [FTC Event Data](https://github.com/lucalmz/scoutingpro27/blob/master/Backend/src/main/java/com/bear27570/app/util/FtcApiClient.java): `Backend/src/main/java/com/bear27570/app/util/FtcApiClient.java`
- [AI Routes](https://github.com/lucalmz/scoutingpro27/blob/master/Backend/src/main/java/com/bear27570/app/routes/AiRoutes.java): `Backend/src/main/java/com/bear27570/app/routes/AiRoutes.java`
- [AI Provider Client](https://github.com/lucalmz/scoutingpro27/blob/master/Backend/src/main/java/com/bear27570/app/util/AiClient.java): `Backend/src/main/java/com/bear27570/app/util/AiClient.java`
- [Signaling Routes](https://github.com/lucalmz/scoutingpro27/blob/master/Backend/src/main/java/com/bear27570/app/routes/SignalingRoutes.java): `Backend/src/main/java/com/bear27570/app/routes/SignalingRoutes.java`
- [Authentication And API](https://github.com/lucalmz/scoutingpro27/blob/master/Backend/src/main/java/com/bear27570/app/routes/ApiRoutes.java): `Backend/src/main/java/com/bear27570/app/routes/ApiRoutes.java`
- [Desktop Host Runtime](https://github.com/lucalmz/scoutingpro27/blob/master/Backend/src/main/java/com/bear27570/app/Main.java): `Backend/src/main/java/com/bear27570/app/Main.java`
- [Embedded H2 Data](https://github.com/lucalmz/scoutingpro27/blob/master/Backend/src/main/java/com/bear27570/app/db/AppConfig.java): `Backend/src/main/java/com/bear27570/app/db/AppConfig.java`
- [Event Persistence](https://github.com/lucalmz/scoutingpro27/blob/master/Backend/src/main/java/com/bear27570/app/dao/EventDao.java): `Backend/src/main/java/com/bear27570/app/dao/EventDao.java`
- [Record Persistence](https://github.com/lucalmz/scoutingpro27/blob/master/Backend/src/main/java/com/bear27570/app/dao/RecordDao.java): `Backend/src/main/java/com/bear27570/app/dao/RecordDao.java`
- [User Persistence](https://github.com/lucalmz/scoutingpro27/blob/master/Backend/src/main/java/com/bear27570/app/dao/UserDao.java): `Backend/src/main/java/com/bear27570/app/dao/UserDao.java`

### Other components

- **Scout Or Host**
- **FTC Services**
- **AI Provider**
- **STUN And TURN**

## Connections

- Scout Or Host → Vue Application: uses (evidence: `README.md`)
- Vue Application → Event Workspace: opens (evidence: `README.md`)
- Event Workspace → Pit Scouting: records pit data (evidence: `README.md`)
- Event Workspace → Match Scouting: records match data (evidence: `README.md`)
- Event Workspace → Schedule Management: manages assignments (evidence: `README.md`)
- Event Workspace → Custom Fields: configures fields (evidence: `README.md`)
- Pit Scouting → Pit API: submits pit records (evidence: `README.md`)
- Match Scouting → Record API: submits scouting records (evidence: `README.md`)
- Schedule Management → Schedule API: syncs assignments (evidence: `README.md`)
- Custom Fields → Custom Field API: manages definitions (evidence: `README.md`)
- Event Workspace → Event API: joins and syncs events (evidence: `Backend/src/main/java/com/bear27570/app/routes/EventRoutes.java`)
- Event API → Event Persistence: queries events (evidence: `Backend/src/main/java/com/bear27570/app/routes/EventRoutes.java`)
- Record API → Record Persistence: reads and writes (evidence: `Backend/src/main/java/com/bear27570/app/routes/RecordRoutes.java`)
- Pit API → Event Persistence: checks membership (evidence: `Backend/src/main/java/com/bear27570/app/routes/PitScoutRoutes.java`)
- Desktop Host Runtime → Authentication And API: registers routes (evidence: `Backend/src/main/java/com/bear27570/app/Main.java`)
- Authentication And API → Event API: registers routes (evidence: `Backend/src/main/java/com/bear27570/app/routes/ApiRoutes.java`)
- Authentication And API → Record API: registers routes (evidence: `Backend/src/main/java/com/bear27570/app/routes/ApiRoutes.java`)
- Authentication And API → AI Routes: registers routes (evidence: `Backend/src/main/java/com/bear27570/app/routes/ApiRoutes.java`)
- Event Persistence → Embedded H2 Data: persists events (evidence: `Backend/src/main/java/com/bear27570/app/dao/EventDao.java`)
- Record Persistence → Embedded H2 Data: persists records (evidence: `README.md`)
- User Persistence → Embedded H2 Data: persists users (evidence: `README.md`)
- Event API → FTC Event Data: requests event data (evidence: `Backend/src/main/java/com/bear27570/app/routes/EventRoutes.java`)
- FTC Event Data → FTC Services: fetches official data (evidence: `README.md`)
- Record API → Rankings And Audit: supplies scouting data (evidence: `README.md`)
- Rankings And Audit → Scout Or Host: shows rankings (evidence: `README.md`)
- AI Chat → AI Routes: requests chat (evidence: `README.md`)
- AI Routes → AI Provider Client: sends prompts (evidence: `Backend/src/main/java/com/bear27570/app/routes/AiRoutes.java`)
- AI Provider Client → AI Provider: calls provider (evidence: `Backend/src/main/java/com/bear27570/app/util/AiClient.java`)
- Scout Or Host → WebRTC Peer Sessions: joins event (evidence: `README.md`)
- WebRTC Peer Sessions → Peer Connection Manager: establishes peer links (evidence: `frontend/src/services/webrtc/clientSession.ts`)
- Peer Connection Manager → Signaling Routes: exchanges signaling (evidence: `frontend/src/services/webrtc/peerManager.ts`)
- Signaling Routes → WebRTC Peer Sessions: relays connection setup (evidence: `README.md`)
- Peer Connection Manager → STUN And TURN: probes connectivity (evidence: `README.md`)
- WebRTC Peer Sessions → Record API: syncs scouting data
