How aglarus/grandstarsuz works
GrandStars is a Telegram-centered digital-goods commerce platform with web/Mini App administration, partner storefronts, payment monitoring, TON wallets, automated fulfillment, and AI-assisted support. The principal documented journey is customer purchase through Telegram or web, payment confirmation, digital delivery, and order notification; available excerpts show several service-to-database and wallet calls but not the main bot/web orchestration. Dashed links mark documented capabilities whose runtime wiring was not shown.
Main entry points: db.py Persistence · notifications.py Notifications · web.py Web And Mini App · wallet_sync.py Wallet Sync
Components 22
Customer Channels
- Bot Shop
main.py - Web And Mini App
web.py
Commerce Operations
- Partner Bots
partner_bot.py - Order Fulfillment
main.py - Gift Delivery
gift_sender.py
Payments And Wallets
- Card Monitoring
monitoring.py - TON Purchases
ton_buyer.py - Wallet Commands
wallet_handlers.py - Wallet Sync
wallet_sync.py
Support And Safety
- Support Tickets
support.py - AI Support And Reports
support_ai.py - AI Assistant
ai_bot.py - Forum Backup
forum_backup.py - Reports
reports.py
Platform Services
- Notifications
notifications.py - Persistence
db.py
Other components
- Customer
- Administrator
- Telegram
- TON And Fragment
- Card Alert Bots
- AI Provider
Connections 27
- Customer → Bot Shop: shops
README.md - Customer → Web And Mini App: uses Mini App
README.md - Bot Shop → Telegram: serves via
README.md - Web And Mini App → Persistence: uses persistence
README.md - Bot Shop → Order Fulfillment: submits orders
README.md - Order Fulfillment → Gift Delivery: fulfills gifts
README.md - Order Fulfillment → Notifications: reports status
README.md - Partner Bots → Persistence: reads partner records
partner_bot.py - Partner Bots → Web And Mini App: links to setup
partner_bot.py - Card Alert Bots → Card Monitoring: send payment alerts
README.md - Card Monitoring → Persistence: records transactions
monitoring.py - Card Monitoring → Administrator: alerts on failure
monitoring.py - TON Purchases → TON And Fragment: queries purchases
ton_buyer.py - Wallet Commands → TON Purchases: validates wallets
wallet_handlers.py - Wallet Commands → Notifications: notifies transfers
wallet_handlers.py - Wallet Sync → Persistence: syncs balances
wallet_sync.py - Wallet Sync → Notifications: notifies deposits
wallet_sync.py - Wallet Sync → TON Purchases: sends withdrawals
wallet_sync.py - Support Tickets → Persistence: reads ticket data
support.py - Support Tickets → Notifications: sends updates
support.py - AI Support And Reports → Persistence: checks reports
support_ai.py - AI Support And Reports → AI Provider: requests AI analysis
README.md - AI Assistant → Persistence: reads AI settings
ai_bot.py - Forum Backup → Persistence: uses persistence
forum_backup.py - Reports → Persistence: reads report records
reports.py - Administrator → Web And Mini App: administers
README.md - Notifications → Telegram: delivers alerts
README.md