🎯 osu! Toolkit

Sprint 3 Evaluation · WelcomeToTheJungle

📖 About the Project

osu! Toolkit is a desktop application for the osu! rhythm game community. It provides tools for analyzing beatmap performance, calculating PP (performance points), optimizing mouse sensitivity/tablet area, and integrating with the osu! API to retrieve beatmap data, scores, and player statistics.

Java 21 JavaFX Maven Hibernate H2 osu! API v1+v2

👥 Team Members

Name	GitHub	Sprint 3 Hours (Actual)
Suhar Aristegui	`SuharAristegui`	24.3h
demogice	`demogice`	21.6h
Alain Souto	`AlainSouto`	11.3h
TOTAL		57.3h

📸 Application Screenshot

osu! Toolkit main window — beatmap analysis and performance tools.

🔍 Sprint 3 Observations

Build: ✅ Clean build passes.
Run: ✅ Launches as "osu! Toolkit" (900×628). Starts with a login screen. Requires osu! API key and username in config.properties for full API functionality.
Features visible: Login/authentication, beatmap analysis, PP (performance points) calculator, mouse sensitivity optimizer, and integration with osu! leaderboards.
Database: H2 embedded (v2.2.224) with Hibernate 6.4.4 ORM. Repository pattern for beatmap caching.
Test suite: ✅ 6 tests across 2 test files, all passing: OsuPpCalculator (4 tests) and OsuBeatmap (2 tests). 2 test files
i18n: ✅ Supports 2 languages: Spanish and Basque (messages_es.properties, messages_eu.properties).
External APIs: ✅ Integrates osu! API v1 and v2 using java.net.http.HttpClient. Two separate clients: OsuApiClient (v1) and OsuApiClientV2 (v2 with OAuth). Retrieves beatmaps, scores, and PP data.
Design Patterns: ✅ Repository pattern (CalculatedMapRepository, CachedBeatmapRepository).

💬 Peer Feedback

Domain expertise: One team member brought deep knowledge of the osu! game, taking on significant responsibility to ensure the application delivered real utility. Their involvement drove much of the development process.
Cross-domain learning: The other teammates had no prior experience with osu! but embraced the unfamiliar domain with strong interest and dedication throughout development.
Peer ratings: All members rated each other 9 out of 10, indicating balanced contribution and mutual appreciation.

📊 Final Scores

Member	Score	Rationale
Suhar Aristegui	9/10	24.3h actual. Owned final release testing, bugfixing, test class creation, and mouse sensitivity/tablet area optimizer. Highest hours on the team.
Iker Vicente (demogice)	9/10	21.6h actual. Brought deep osu! domain expertise that drove the application's direction. Integrated osu! API v1 and v2 with OAuth. Took significant responsibility for delivering a useful product.
Alain Souto	8/10	11.3h actual. Embraced the unfamiliar osu! domain with strong interest. Supported development across multiple features. Lower hours but recognized by peers (9/10 rating).

Team baseline: Dual osu! API integration (v1 + v2/OAuth). Repository pattern for beatmap caching. 6/6 tests pass. ⚠️ Several tasks still Todo (35h estimated). High estimate-to-actual gap (116h est vs 57h act).