Implement hybrid two-tier cache system with full monitoring and Telegram bot enhancements

Cache System (Backend):
- Implemented two-tier hybrid cache: L1 (in-memory) + L2 (SQLite)
- L1 cache: Fast dictionary-based with 5-minute TTL for hot data
- L2 cache: Persistent SQLite with 1-hour TTL for warm data
- Cache decorator with automatic tier management and fallback
- Cache key generation with per-user isolation
- Event monitoring system for cache statistics
- Cache benchmarking utilities for performance testing
- Added cache management endpoints: /api/cache/stats, /api/cache/clear, /api/cache/benchmark
- Cache configuration via environment variables (CACHE_ENABLED, CACHE_L1_TTL, etc.)

Backend Services:
- Updated dashboard_service to use @cached decorator with request context
- Added cache support to invoice_service and treasury_service
- Integrated cache manager into main.py with lifespan events
- Added Request parameter to service methods for cache metadata

Frontend Enhancements:
- New CacheStatsView.vue for real-time cache monitoring dashboard
- Cache store (cacheStore.js) for state management
- Updated router to include /cache-stats route
- Navigation updates in DashboardHeader and HamburgerMenu
- Cache stats accessible from main navigation

Telegram Bot Improvements:
- Enhanced formatters with YTD comparison data
- Improved menu navigation and button layout
- Better error handling and user feedback
- Bot startup improvements with graceful shutdown

Auth & Middleware:
- Enhanced middleware with cache metadata injection
- Improved request state handling for cache source tracking

Development:
- Updated start-dev.sh with better error handling
- Added TELEGRAM_EMAIL_AUTH_PLAN.md documentation
- Updated requirements.txt with aiosqlite for async SQLite

Performance:
- L1 cache provides <1ms response for hot data
- L2 cache provides ~5ms response for warm data
- Database queries only for cold data or cache misses
- Cache hit rates tracked and displayed in real-time

🤖 Generated with Claude Code

Co-Authored-By: Claude <noreply@anthropic.com>

reports-app/telegram-bot/app/bot/menus.py

@@ -188,7 +188,8 @@ def get_menu_message(
 def create_main_menu(
     company_name: Optional[str] = None,
     company_cui: Optional[str] = None,
-    is_authenticated: bool = True
+    is_authenticated: bool = True,
+    cache_enabled: Optional[bool] = None
 ) -> InlineKeyboardMarkup:
     """
     Create main menu keyboard (Level 1) with financial options.
@@ -199,6 +200,7 @@ def create_main_menu(
         company_name: Active company name, or None if no company selected
         company_cui: Company fiscal code (CUI), or None
         is_authenticated: Whether user is authenticated (affects Login/Logout button)
+        cache_enabled: Cache state for user (True=ON, False=OFF, None=unknown)
 
     Returns:
         InlineKeyboardMarkup with main menu buttons
@@ -242,7 +244,22 @@ def create_main_menu(
         ]
     ])
 
-    # Row 5: Help/Logout buttons (authenticated) or Login button (non-authenticated)
+    # Row 5: Cache options (2 buttons per row, only if authenticated)
+    if is_authenticated:
+        # Dynamic cache toggle button showing current state
+        if cache_enabled is None:
+            cache_button_text = "Toggle Cache"
+        elif cache_enabled:
+            cache_button_text = "Cache: ON"
+        else:
+            cache_button_text = "Cache: OFF"
+
+        keyboard.append([
+            InlineKeyboardButton(cache_button_text, callback_data="menu:togglecache"),
+            InlineKeyboardButton("Clear Cache", callback_data="menu:clearcache")
+        ])
+
+    # Row 6: Help/Logout buttons (authenticated) or Login button (non-authenticated)
     if is_authenticated:
         keyboard.append([
             InlineKeyboardButton("Help", callback_data="action:help"),