How chuanyuannotboat/malody_data_studio works
Malody Data Studio is a local Malody data platform: users query and analyze player/chart data, manage collection and database quality, and use a desktop interface or API; a plugin-based CLI is an additional access path. The central API flow is HTTP request → router → domain service or crawler controller → SQLite or external Malody source → response. README capabilities include page parsing, analytics, advanced queries, task management, plugins, and maintenance. Some subsystem links are documented rather than source-verified; those are marked dashed where appropriate.
Main entry points: main.py FastAPI App · database.py SQLite Database · controller.py Crawler Control · rankings.py Rankings Crawler
Components 22
User Interfaces
- Desktop App
desktop/src/App.tsx - Stats CLI
stats_cli/app.py - CLI Plugins
stats_cli/plugins/registry.py
API and Domain
- FastAPI App
app/main.py - Player Queries
core/services/player_service.py - Chart Queries
core/services/chart_service.py - Analytics
core/services/analysis_service.py - Page Parser
routers/page_parser.py - Advanced Query
utils/query_builder.py
Data Collection
- Crawler Control
crawlers/controller.py - Rankings Crawler
crawlers/rankings.py - Profile Crawler
crawlers/player_profile.py - STB Crawler
crawlers/stb.py
Persistence
- SQLite Database
core/database.py
Operations and Extensions
- Quality Checks
core/services/quality_service.py - Task Center
core/services/task_center_service.py - DB Maintenance
core/services/db_maintenance_service.py - Plugin Services
core/services/plugin_service.py - Official API
core/services/official_api_service.py
Other components
- Operator
- HTTP Client
- Malody Services
Connections 34
- Operator → Desktop App: uses
desktop/src/App.tsx - Desktop App → HTTP Client: requests data
- HTTP Client → FastAPI App: sends requests
- FastAPI App → Player Queries: routes player requests
- FastAPI App → Chart Queries: routes chart requests
- FastAPI App → Analytics: routes analysis
- FastAPI App → Page Parser: routes parsing
app/main.py - FastAPI App → Advanced Query: routes query
- Player Queries → SQLite Database: reads
core/services/player_service.py - Chart Queries → SQLite Database: reads
core/services/chart_service.py - Analytics → SQLite Database: reads
core/services/analysis_service.py - Advanced Query → SQLite Database: queries
utils/query_builder.py - Page Parser → SQLite Database: looks up songs
- Operator → Stats CLI: uses
stats_cli/app.py - Stats CLI → CLI Plugins: dispatches commands
stats_cli/app.py - CLI Plugins → SQLite Database: queries data
- Operator → FastAPI App: starts crawler tasks
- FastAPI App → Crawler Control: controls collection
- Crawler Control → Rankings Crawler: dispatches
- Crawler Control → Profile Crawler: dispatches
- Crawler Control → STB Crawler: dispatches
- Rankings Crawler → Malody Services: fetches data
- Profile Crawler → Malody Services: fetches profiles
- STB Crawler → Malody Services: fetches charts
- Rankings Crawler → SQLite Database: stores results
- Profile Crawler → SQLite Database: stores results
- STB Crawler → SQLite Database: stores results
- FastAPI App → Quality Checks: offers quality checks
- FastAPI App → Task Center: manages tasks
- FastAPI App → DB Maintenance: offers maintenance
- FastAPI App → Plugin Services: runs plugins
- FastAPI App → Official API: exposes integration
- Quality Checks → SQLite Database: checks data
core/services/quality_service.py - DB Maintenance → SQLite Database: maintains