How matsuk1/jietng-maimai-dx-bot works
JiETNG is a LINE bot and web service for tracking maimai DX scores, managing player accounts and presenting game data. The main workflow starts with a player request delivered through LINE, passes through the application’s request handling, fetches or reads game data, and returns localized text or generated score imagery. Separate branches cover the web administration and AI operations capabilities documented in the README. Source excerpts and the index support the core data, image, and integration components; some unsampled subsystem connections are therefore left out.
Main entry points: main.py Bot and web app · record_manager.py Score records · records.py Score images · admin_api.py Web administration
Components 23
Player interaction
- Bot and web app
main.py - Message service
modules/messages/service.py - Command routing
modules/commands/command_router.py - Discord bot
discord_bot/jietng_discord_bot/bot.py - Python client SDK
client/src/jietng/client.py
Game data
- SEGA game access
modules/maimai_manager.py - Score records
modules/record_manager.py - User management
modules/user_manager.py - Song data
modules/dxdata_manager.py - Rating calculation
modules/score_calculator.py
Results presentation
- Score images
modules/images/records.py - Song images
modules/images/songs.py - Image renderer
modules/images/renderer.py - Image skins
modules/images/skins.py
Administration and operations
- Web administration
modules/api/admin_api.py - AI operations
modules/monitoring/mcp_server.py - Business metrics
modules/event_tracker.py
Runtime platform
- User database
modules/user_db.py - Localization
modules/i18n.py - Configuration
modules/config_loader.py
Other components
- Players
- LINE platform
- MySQL
Connections 25
- Players → LINE platform: send requests
- LINE platform → Bot and web app: deliver webhook events
- Bot and web app → Command routing: route commands
main.py - Bot and web app → Message service: build replies
main.py - Bot and web app → SEGA game access: fetch game data
main.py - Bot and web app → Score records: read and update
main.py - Bot and web app → User management: manage accounts
main.py - SEGA game access → LINE platform: authenticate externally
modules/maimai_manager.py - Score records → MySQL: read and write scores
modules/record_manager.py - User management → User database: manage user data
- User database → MySQL: read and write users
modules/user_db.py - Score records → Song data: enrich records
modules/record_manager.py - Bot and web app → Song data: update song data
main.py - Score records → Rating calculation: calculate rating
- Bot and web app → Score images: generate score charts
main.py - Bot and web app → Song images: generate song images
modules/images/songs.py - Score images → Image renderer: render templates
modules/images/records.py - Song images → Image renderer: render templates
modules/images/songs.py - Score images → Image skins: apply skin
modules/images/records.py - Message service → Localization: translate messages
modules/messages/service.py - Bot and web app → Web administration: serve admin features
- Web administration → AI operations: offer AI operations
- Web administration → Business metrics: report business metrics
- Bot and web app → Configuration: load settings
modules/config_loader.py - Discord bot → Python client SDK: use client API