How dbapplication/kbo works
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: Team.java Teams · Player.java Player profiles · GlobalExceptionHandler.java Error handling · Match.java Games and highlights
Components 22
Lookup API
- Match endpoints
backend/src/main/java/com/dbapplication/kbo/domain/match/controller/MatchController.java - Match lookup
backend/src/main/java/com/dbapplication/kbo/domain/match/service/MatchService.java - Match queries
backend/src/main/java/com/dbapplication/kbo/domain/match/repository/MatchRepository.java - Player endpoints
backend/src/main/java/com/dbapplication/kbo/domain/player/controller/PlayerController.java - Player lookup
backend/src/main/java/com/dbapplication/kbo/domain/player/service/PlayerService.java - Player queries
backend/src/main/java/com/dbapplication/kbo/domain/player/repository/PlayerRepository.java - Team endpoints
backend/src/main/java/com/dbapplication/kbo/domain/team/controller/TeamController.java - Team lookup
backend/src/main/java/com/dbapplication/kbo/domain/team/service/TeamService.java - Team queries
backend/src/main/java/com/dbapplication/kbo/domain/team/repository/TeamRepository.java
Baseball Domain
- Games and highlights
backend/src/main/java/com/dbapplication/kbo/domain/match/entity/Match.java - Match highlights
backend/src/main/java/com/dbapplication/kbo/domain/match/entity/MatchHighlight.java - Player profiles
backend/src/main/java/com/dbapplication/kbo/domain/player/entity/Player.java - Teams
backend/src/main/java/com/dbapplication/kbo/domain/team/entity/Team.java - Batting records
backend/src/main/java/com/dbapplication/kbo/domain/record/entity/BatterSeasonRecord.java - Pitching records
backend/src/main/java/com/dbapplication/kbo/domain/record/entity/PitcherSeasonRecord.java
Backend Platform
- Spring Boot app
backend/src/main/java/com/dbapplication/kbo/KboApplication.java - PostgreSQL
- Error handling
backend/src/main/java/com/dbapplication/kbo/global/error/GlobalExceptionHandler.java - Business errors
backend/src/main/java/com/dbapplication/kbo/global/error/BusinessException.java - Error codes
backend/src/main/java/com/dbapplication/kbo/global/error/ErrorCode.java - Error response
backend/src/main/java/com/dbapplication/kbo/global/error/ErrorResponse.java
Other components
- API client
Connections 25
- API client → Match endpoints: requests
README.md - API client → Player endpoints: requests
README.md - API client → Team endpoints: requests
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
backend/src/main/java/com/dbapplication/kbo/domain/match/entity/Match.java - Games and highlights → Match highlights: has highlights
backend/src/main/java/com/dbapplication/kbo/domain/match/entity/Match.java - Player profiles → Teams: belongs to
backend/src/main/java/com/dbapplication/kbo/domain/player/entity/Player.java - Player profiles → Batting records: has seasons
backend/src/main/java/com/dbapplication/kbo/domain/player/entity/Player.java - Player profiles → Pitching records: has seasons
backend/src/main/java/com/dbapplication/kbo/domain/player/entity/Player.java - Batting records → Teams: references
backend/src/main/java/com/dbapplication/kbo/domain/record/entity/BatterSeasonRecord.java - Pitching records → Teams: references
backend/src/main/java/com/dbapplication/kbo/domain/record/entity/PitcherSeasonRecord.java - Spring Boot app → PostgreSQL: connects
- Error handling → Business errors: handles
backend/src/main/java/com/dbapplication/kbo/global/error/GlobalExceptionHandler.java - Error handling → Error codes: selects
backend/src/main/java/com/dbapplication/kbo/global/error/GlobalExceptionHandler.java - Error handling → Error response: builds
backend/src/main/java/com/dbapplication/kbo/global/error/GlobalExceptionHandler.java - Business errors → Error codes: carries
backend/src/main/java/com/dbapplication/kbo/global/error/BusinessException.java - Error response → Error codes: formats
backend/src/main/java/com/dbapplication/kbo/global/error/ErrorResponse.java