# dbapplication/kbo architecture

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

- Interactive diagram: https://gitdiagram.com/dbapplication/kbo
- Repository: https://github.com/dbapplication/kbo

## Overview

KBO is a backend service for looking up game results and team/player records; the frontend directory is present but its implementation is not sampled. The intended user flow is an API request for a match, team, or player lookup, followed by domain retrieval and a response, with shared error handling. Controller/service/repository excerpts are limited, so their links are shown as unverified rather than asserted; entity relationships are supported by the sampled JPA mappings.

Main entry points: [`backend/src/main/java/com/dbapplication/kbo/domain/team/entity/Team.java`](https://github.com/dbapplication/kbo/blob/main/backend/src/main/java/com/dbapplication/kbo/domain/team/entity/Team.java) (Teams), [`backend/src/main/java/com/dbapplication/kbo/domain/player/entity/Player.java`](https://github.com/dbapplication/kbo/blob/main/backend/src/main/java/com/dbapplication/kbo/domain/player/entity/Player.java) (Player profiles), [`backend/src/main/java/com/dbapplication/kbo/global/error/GlobalExceptionHandler.java`](https://github.com/dbapplication/kbo/blob/main/backend/src/main/java/com/dbapplication/kbo/global/error/GlobalExceptionHandler.java) (Error handling), [`backend/src/main/java/com/dbapplication/kbo/domain/match/entity/Match.java`](https://github.com/dbapplication/kbo/blob/main/backend/src/main/java/com/dbapplication/kbo/domain/match/entity/Match.java) (Games and highlights)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Lookup API"]
  node_match_api["Match endpoints"]
  node_match_service["Match lookup<br/>[MatchService.java]"]
  node_match_repo["Match queries"]
  node_player_api["Player endpoints"]
  node_player_service["Player lookup<br/>[PlayerService.java]"]
  node_player_repo["Player queries"]
  node_team_api["Team endpoints"]
  node_team_service["Team lookup<br/>[TeamService.java]"]
  node_team_repo["Team queries"]
end

subgraph group_domain["Baseball Domain"]
  node_matches[("Games and highlights<br/>[Match.java]")]
  node_highlight[("Match highlights")]
  node_players[("Player profiles<br/>[Player.java]")]
  node_teams[("Teams<br/>[Team.java]")]
  node_batter_records[("Batting records")]
  node_pitcher_records[("Pitching records")]
end

subgraph group_platform["Backend Platform"]
  node_app["Spring Boot app"]
  node_postgres[("PostgreSQL")]
  node_errors["Error handling"]
  node_business_error["Business errors"]
  node_error_codes["Error codes<br/>[ErrorCode.java]"]
  node_error_response["Error response<br/>[ErrorResponse.java]"]
end

node_user(("API client"))

node_user -->|"requests"| node_match_api
node_user -->|"requests"| node_player_api
node_user -->|"requests"| node_team_api
node_match_api -.->|"delegates to"| node_match_service
node_match_service -.->|"queries"| node_match_repo
node_match_repo -.->|"reads"| node_matches
node_player_api -.->|"delegates to"| node_player_service
node_player_service -.->|"queries"| node_player_repo
node_player_repo -.->|"reads"| node_players
node_team_api -.->|"delegates to"| node_team_service
node_team_service -.->|"queries"| node_team_repo
node_team_repo -.->|"reads"| node_teams
node_matches -->|"references"| node_teams
node_matches -->|"has highlights"| node_highlight
node_players -->|"belongs to"| node_teams
node_players -->|"has seasons"| node_batter_records
node_players -->|"has seasons"| node_pitcher_records
node_batter_records -->|"references"| node_teams
node_pitcher_records -->|"references"| node_teams
node_app -.->|"connects"| node_postgres
node_errors -->|"handles"| node_business_error
node_errors -->|"selects"| node_error_codes
node_errors -->|"builds"| node_error_response
node_business_error -->|"carries"| node_error_codes
node_error_response -->|"formats"| node_error_codes

click node_match_api "https://github.com/dbapplication/kbo/blob/main/backend/src/main/java/com/dbapplication/kbo/domain/match/controller/MatchController.java"
click node_match_service "https://github.com/dbapplication/kbo/blob/main/backend/src/main/java/com/dbapplication/kbo/domain/match/service/MatchService.java"
click node_match_repo "https://github.com/dbapplication/kbo/blob/main/backend/src/main/java/com/dbapplication/kbo/domain/match/repository/MatchRepository.java"
click node_player_api "https://github.com/dbapplication/kbo/blob/main/backend/src/main/java/com/dbapplication/kbo/domain/player/controller/PlayerController.java"
click node_player_service "https://github.com/dbapplication/kbo/blob/main/backend/src/main/java/com/dbapplication/kbo/domain/player/service/PlayerService.java"
click node_player_repo "https://github.com/dbapplication/kbo/blob/main/backend/src/main/java/com/dbapplication/kbo/domain/player/repository/PlayerRepository.java"
click node_team_api "https://github.com/dbapplication/kbo/blob/main/backend/src/main/java/com/dbapplication/kbo/domain/team/controller/TeamController.java"
click node_team_service "https://github.com/dbapplication/kbo/blob/main/backend/src/main/java/com/dbapplication/kbo/domain/team/service/TeamService.java"
click node_team_repo "https://github.com/dbapplication/kbo/blob/main/backend/src/main/java/com/dbapplication/kbo/domain/team/repository/TeamRepository.java"
click node_matches "https://github.com/dbapplication/kbo/blob/main/backend/src/main/java/com/dbapplication/kbo/domain/match/entity/Match.java"
click node_highlight "https://github.com/dbapplication/kbo/blob/main/backend/src/main/java/com/dbapplication/kbo/domain/match/entity/MatchHighlight.java"
click node_players "https://github.com/dbapplication/kbo/blob/main/backend/src/main/java/com/dbapplication/kbo/domain/player/entity/Player.java"
click node_teams "https://github.com/dbapplication/kbo/blob/main/backend/src/main/java/com/dbapplication/kbo/domain/team/entity/Team.java"
click node_batter_records "https://github.com/dbapplication/kbo/blob/main/backend/src/main/java/com/dbapplication/kbo/domain/record/entity/BatterSeasonRecord.java"
click node_pitcher_records "https://github.com/dbapplication/kbo/blob/main/backend/src/main/java/com/dbapplication/kbo/domain/record/entity/PitcherSeasonRecord.java"
click node_app "https://github.com/dbapplication/kbo/blob/main/backend/src/main/java/com/dbapplication/kbo/KboApplication.java"
click node_errors "https://github.com/dbapplication/kbo/blob/main/backend/src/main/java/com/dbapplication/kbo/global/error/GlobalExceptionHandler.java"
click node_business_error "https://github.com/dbapplication/kbo/blob/main/backend/src/main/java/com/dbapplication/kbo/global/error/BusinessException.java"
click node_error_codes "https://github.com/dbapplication/kbo/blob/main/backend/src/main/java/com/dbapplication/kbo/global/error/ErrorCode.java"
click node_error_response "https://github.com/dbapplication/kbo/blob/main/backend/src/main/java/com/dbapplication/kbo/global/error/ErrorResponse.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_match_api,node_match_service,node_match_repo,node_player_api,node_player_service,node_player_repo,node_team_api,node_team_service,node_team_repo,node_user toneBlue
class node_matches,node_highlight,node_players,node_teams,node_batter_records,node_pitcher_records toneAmber
class node_app,node_postgres,node_errors,node_business_error,node_error_codes,node_error_response toneMint
```

## Components

### Lookup API

- [Match endpoints](https://github.com/dbapplication/kbo/blob/main/backend/src/main/java/com/dbapplication/kbo/domain/match/controller/MatchController.java): `backend/src/main/java/com/dbapplication/kbo/domain/match/controller/MatchController.java`
- [Match lookup](https://github.com/dbapplication/kbo/blob/main/backend/src/main/java/com/dbapplication/kbo/domain/match/service/MatchService.java): `backend/src/main/java/com/dbapplication/kbo/domain/match/service/MatchService.java`
- [Match queries](https://github.com/dbapplication/kbo/blob/main/backend/src/main/java/com/dbapplication/kbo/domain/match/repository/MatchRepository.java): `backend/src/main/java/com/dbapplication/kbo/domain/match/repository/MatchRepository.java`
- [Player endpoints](https://github.com/dbapplication/kbo/blob/main/backend/src/main/java/com/dbapplication/kbo/domain/player/controller/PlayerController.java): `backend/src/main/java/com/dbapplication/kbo/domain/player/controller/PlayerController.java`
- [Player lookup](https://github.com/dbapplication/kbo/blob/main/backend/src/main/java/com/dbapplication/kbo/domain/player/service/PlayerService.java): `backend/src/main/java/com/dbapplication/kbo/domain/player/service/PlayerService.java`
- [Player queries](https://github.com/dbapplication/kbo/blob/main/backend/src/main/java/com/dbapplication/kbo/domain/player/repository/PlayerRepository.java): `backend/src/main/java/com/dbapplication/kbo/domain/player/repository/PlayerRepository.java`
- [Team endpoints](https://github.com/dbapplication/kbo/blob/main/backend/src/main/java/com/dbapplication/kbo/domain/team/controller/TeamController.java): `backend/src/main/java/com/dbapplication/kbo/domain/team/controller/TeamController.java`
- [Team lookup](https://github.com/dbapplication/kbo/blob/main/backend/src/main/java/com/dbapplication/kbo/domain/team/service/TeamService.java): `backend/src/main/java/com/dbapplication/kbo/domain/team/service/TeamService.java`
- [Team queries](https://github.com/dbapplication/kbo/blob/main/backend/src/main/java/com/dbapplication/kbo/domain/team/repository/TeamRepository.java): `backend/src/main/java/com/dbapplication/kbo/domain/team/repository/TeamRepository.java`

### Baseball Domain

- [Games and highlights](https://github.com/dbapplication/kbo/blob/main/backend/src/main/java/com/dbapplication/kbo/domain/match/entity/Match.java): `backend/src/main/java/com/dbapplication/kbo/domain/match/entity/Match.java`
- [Match highlights](https://github.com/dbapplication/kbo/blob/main/backend/src/main/java/com/dbapplication/kbo/domain/match/entity/MatchHighlight.java): `backend/src/main/java/com/dbapplication/kbo/domain/match/entity/MatchHighlight.java`
- [Player profiles](https://github.com/dbapplication/kbo/blob/main/backend/src/main/java/com/dbapplication/kbo/domain/player/entity/Player.java): `backend/src/main/java/com/dbapplication/kbo/domain/player/entity/Player.java`
- [Teams](https://github.com/dbapplication/kbo/blob/main/backend/src/main/java/com/dbapplication/kbo/domain/team/entity/Team.java): `backend/src/main/java/com/dbapplication/kbo/domain/team/entity/Team.java`
- [Batting records](https://github.com/dbapplication/kbo/blob/main/backend/src/main/java/com/dbapplication/kbo/domain/record/entity/BatterSeasonRecord.java): `backend/src/main/java/com/dbapplication/kbo/domain/record/entity/BatterSeasonRecord.java`
- [Pitching records](https://github.com/dbapplication/kbo/blob/main/backend/src/main/java/com/dbapplication/kbo/domain/record/entity/PitcherSeasonRecord.java): `backend/src/main/java/com/dbapplication/kbo/domain/record/entity/PitcherSeasonRecord.java`

### Backend Platform

- [Spring Boot app](https://github.com/dbapplication/kbo/blob/main/backend/src/main/java/com/dbapplication/kbo/KboApplication.java): `backend/src/main/java/com/dbapplication/kbo/KboApplication.java`
- **PostgreSQL**
- [Error handling](https://github.com/dbapplication/kbo/blob/main/backend/src/main/java/com/dbapplication/kbo/global/error/GlobalExceptionHandler.java): `backend/src/main/java/com/dbapplication/kbo/global/error/GlobalExceptionHandler.java`
- [Business errors](https://github.com/dbapplication/kbo/blob/main/backend/src/main/java/com/dbapplication/kbo/global/error/BusinessException.java): `backend/src/main/java/com/dbapplication/kbo/global/error/BusinessException.java`
- [Error codes](https://github.com/dbapplication/kbo/blob/main/backend/src/main/java/com/dbapplication/kbo/global/error/ErrorCode.java): `backend/src/main/java/com/dbapplication/kbo/global/error/ErrorCode.java`
- [Error response](https://github.com/dbapplication/kbo/blob/main/backend/src/main/java/com/dbapplication/kbo/global/error/ErrorResponse.java): `backend/src/main/java/com/dbapplication/kbo/global/error/ErrorResponse.java`

### Other components

- **API client**

## Connections

- API client → Match endpoints: requests (evidence: `README.md`)
- API client → Player endpoints: requests (evidence: `README.md`)
- API client → Team endpoints: requests (evidence: `README.md`)
- Match endpoints → Match lookup: delegates to
- Match lookup → Match queries: queries
- Match queries → Games and highlights: reads
- Player endpoints → Player lookup: delegates to
- Player lookup → Player queries: queries
- Player queries → Player profiles: reads
- Team endpoints → Team lookup: delegates to
- Team lookup → Team queries: queries
- Team queries → Teams: reads
- Games and highlights → Teams: references (evidence: `backend/src/main/java/com/dbapplication/kbo/domain/match/entity/Match.java`)
- Games and highlights → Match highlights: has highlights (evidence: `backend/src/main/java/com/dbapplication/kbo/domain/match/entity/Match.java`)
- Player profiles → Teams: belongs to (evidence: `backend/src/main/java/com/dbapplication/kbo/domain/player/entity/Player.java`)
- Player profiles → Batting records: has seasons (evidence: `backend/src/main/java/com/dbapplication/kbo/domain/player/entity/Player.java`)
- Player profiles → Pitching records: has seasons (evidence: `backend/src/main/java/com/dbapplication/kbo/domain/player/entity/Player.java`)
- Batting records → Teams: references (evidence: `backend/src/main/java/com/dbapplication/kbo/domain/record/entity/BatterSeasonRecord.java`)
- Pitching records → Teams: references (evidence: `backend/src/main/java/com/dbapplication/kbo/domain/record/entity/PitcherSeasonRecord.java`)
- Spring Boot app → PostgreSQL: connects
- Error handling → Business errors: handles (evidence: `backend/src/main/java/com/dbapplication/kbo/global/error/GlobalExceptionHandler.java`)
- Error handling → Error codes: selects (evidence: `backend/src/main/java/com/dbapplication/kbo/global/error/GlobalExceptionHandler.java`)
- Error handling → Error response: builds (evidence: `backend/src/main/java/com/dbapplication/kbo/global/error/GlobalExceptionHandler.java`)
- Business errors → Error codes: carries (evidence: `backend/src/main/java/com/dbapplication/kbo/global/error/BusinessException.java`)
- Error response → Error codes: formats (evidence: `backend/src/main/java/com/dbapplication/kbo/global/error/ErrorResponse.java`)
