Skip to main content

id: core-features

Core Features

Telegram Bot Interface​

Command System​

  • /start - Initializes user interaction and provides welcome message
  • /help - Displays available commands and their descriptions
  • /tarot - Initiates a tarot reading session
  • /fdd - Returns link to functional design documentation (admin only)
  • /trades - Retrieves trading information (admin only)
  • /daily-arcanum - Provides daily tarot card teaching and insight
  • /about - Shows information about the bot
  • /example - Demonstrates message formatting capabilities
  • /html - Shows HTML formatting example
  • /markdown - Shows Markdown formatting example

Reading Flow​

  1. User initiates reading with /tarot command
  2. System validates user's token balance
  3. Random card selection using TON blockchain entropy
  4. AI-powered interpretation generation
  5. Response delivery with card image and reading

Rate Limiting​

  • Implemented per-user rate limiting
  • Configurable cooldown periods
  • Token-based access control

Tarot Reading System​

Card Selection​

  • Multiple deck support (Visconti, Thoth, etc.)
  • Blockchain-based randomization
  • Card removal tracking for spread consistency

Reading Types​

  • Single card readings
  • Celtic Cross spread
  • Custom spread configurations

Response Generation​

  • AI-powered interpretations
  • Character-specific responses
  • Hashtag integration for categorization
  • Time tracking for performance monitoring

Message Handling​

Format Support​

  • HTML formatting for rich text
  • Markdown support for structured content
  • Image caption integration
  • Character-specific messaging

Error Handling​

  • Graceful error recovery
  • User-friendly error messages
  • Logging and monitoring
  • Rate limit notifications

Admin Features​

System Management​

  • Feature flag control
  • Token management commands
  • System status monitoring
  • Documentation access

Monitoring​

  • User interaction tracking
  • Performance metrics
  • Error logging
  • Usage statistics

Technical Implementation​

Database Integration​

  • PostgreSQL with MikroORM
  • Entity relationship management
  • Migration system
  • Data persistence

Queue Management​

  • BullMQ integration
  • Job processing
  • Queue monitoring
  • Worker module implementation

Health Monitoring​

  • Terminus integration
  • Health check endpoints
  • Status reporting
  • Performance metrics

Security Features​

Access Control​

  • Admin authentication
  • Rate limiting
  • Token validation
  • Command restrictions

Data Protection​

  • Secure storage
  • Encrypted communication
  • Environment-based configuration
  • Sensitive data handling

Message Formatting Examples​

  • HTML formatting demonstrations
  • Markdown syntax examples
  • Format comparison guides
  • Style templates

Daily Arcanum System​

Educational Features​

  • Daily card teaching delivery
  • Spiritual insights generation
  • User engagement tracking
  • Automated distribution

Implementation​

  • Dedicated handler implementation
  • Scheduled content delivery
  • AI-powered content generation
  • User interaction tracking

Technical Components​

  • DailyArcanum handler
  • Scheduled job processing
  • Message formatting
  • Content management

Integration​

  • Telegram command integration
  • AI service utilization
  • Queue system integration
  • User notification system

NEXT_TASK: Implement personalized learning paths in Daily Arcanum system, including user progress tracking, adaptive content selection, and milestone achievements