# Implementation Plan

- [x] 1. Add translate_title method to Ollama client
  - Create the `translate_title()` method in `news_crawler/ollama_client.py` that accepts a title string and target language parameter
  - Implement the translation prompt that instructs the model to translate German headlines to English without explanations
  - Configure Ollama API call with temperature=0.3 and num_predict=100 for consistent title-length translations
  - Implement response cleaning logic to remove quotes, extract first line only, and trim whitespace
  - Add error handling for timeout, connection errors, HTTP errors, and empty title input
  - Return a dictionary with success status, translated_title, error message, and duration fields
  - _Requirements: 2.1, 2.2, 2.3, 2.4, 2.5, 4.1, 4.2, 4.3, 4.4, 4.5_

- [x] 2. Integrate translation into crawler service
  - [x] 2.1 Add translation call in crawl_rss_feed function
    - Locate the article processing section in `news_crawler/crawler_service.py` after content extraction
    - Store the original title from article_data or entry
    - Add conditional check for Config.OLLAMA_ENABLED before calling translation
    - Call `ollama_client.translate_title()` with the original title
    - Store the translation_result for later use in article document
    - _Requirements: 1.1, 2.1_
  
  - [x] 2.2 Add console logging for translation status
    - Add "🌐 Translating title..." message before translation call
    - Add success message with duration: "✓ Title translated (X.Xs)"
    - Add failure message with error: "⚠ Translation failed: {error}"
    - _Requirements: 5.1, 5.2, 5.3_
  
  - [x] 2.3 Update article document structure
    - Modify the article_doc dictionary to include `title_en` field with translated title or None
    - Add `translated_at` field set to datetime.utcnow() on success or None on failure
    - Ensure the original `title` field still contains the German title
    - _Requirements: 1.2, 3.5_

- [x] 3. Update newsletter template for bilingual title display
  - Modify `news_sender/newsletter_template.html` to display English title as primary heading when available
  - Add conditional logic to show original German title as subtitle only when English translation exists and differs
  - Style the subtitle with smaller font (13px), gray color (#999999), and italic formatting
  - Ensure fallback to German title when title_en is NULL or missing
  - _Requirements: 1.3, 1.4, 1.5_

- [x] 4. Test the translation feature end-to-end
  - Rebuild the crawler Docker container with the new translation code
  - Clear existing articles from the database for clean testing
  - Trigger a test crawl with max_articles=2 to process fresh articles
  - Verify console output shows translation status messages
  - Check MongoDB to confirm title_en and translated_at fields are populated
  - Send a test newsletter email to verify English titles display correctly with German subtitles
  - _Requirements: 1.1, 1.2, 1.3, 1.4, 5.1, 5.2, 5.4, 5.5_