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/backend/app/cache/__init__.py

@@ -0,0 +1,66 @@
+"""
+Cache module for ROA2WEB
+
+Provides hybrid two-tier caching (Memory L1 + SQLite L2)
+with performance tracking and event-based invalidation.
+
+Usage:
+    # Initialize cache at app startup
+    from app.cache import init_cache
+    from app.cache.config import CacheConfig
+
+    config = CacheConfig.from_env()
+    await init_cache(config)
+
+    # Use @cached decorator in services
+    from app.cache.decorators import cached
+
+    @cached(cache_type='dashboard_summary', key_params=['company', 'username'])
+    async def get_complete_summary(company: str, username: str):
+        # ... Oracle query logic ...
+
+    # Get cache manager for manual operations
+    from app.cache import get_cache
+
+    cache = get_cache()
+    await cache.invalidate(company_id=123)
+"""
+
+from .config import CacheConfig
+from .cache_manager import (
+    init_cache,
+    get_cache,
+    close_cache,
+    CacheManager
+)
+from .decorators import cached
+from .event_monitor import (
+    init_event_monitor,
+    get_event_monitor,
+    toggle_event_monitor,
+    preload_all_schema_mappings
+)
+from .benchmarks import run_baseline_benchmarks
+
+__all__ = [
+    # Configuration
+    'CacheConfig',
+
+    # Cache Manager
+    'init_cache',
+    'get_cache',
+    'close_cache',
+    'CacheManager',
+
+    # Decorators
+    'cached',
+
+    # Event Monitor
+    'init_event_monitor',
+    'get_event_monitor',
+    'toggle_event_monitor',
+    'preload_all_schema_mappings',
+
+    # Benchmarks
+    'run_baseline_benchmarks',
+]