Translate all comments to English and create comprehensive documentation

[Copilot]

This PR addresses the need to translate all comments in the repository from Ukrainian/Russian to English and creates comprehensive English documentation with project setup instructions.

Changes Made

Code Comment Translations

• app/services/ai_moderation.py: Translated Ukrainian comments about client initialization, banned word lists, AI verification logic, and reply generation
• app/services/auto_reply.py: Translated Ukrainian comment about preventing auto-replies to post authors
• app/routers/analytics.py: Updated API parameter descriptions from Ukrainian to English
• alembic/env.py: Translated Russian comment about Base metadata import
• app/core/security.py: Translated Ukrainian comment about token-based user retrieval
• Test files: Translated remaining Ukrainian/Russian comments in test cases

Documentation Enhancement

• README.md: Complete rewrite with comprehensive English documentation including:
  • Detailed feature overview (AI moderation, auto-reply, analytics)
  • Technology stack description
  • Step-by-step setup instructions for development and production
  • Environment configuration guide
  • Docker deployment instructions
  • Project structure explanation
  • API endpoint documentation
  • Development workflow (testing, formatting, migrations)

Technical Notes

• AI Functionality Preserved: AI prompts for toxicity detection and reply generation are kept in Ukrainian to maintain optimal performance with Ukrainian text content, but are clearly documented
• No Breaking Changes: All translations are comment-only changes that preserve existing functionality
• Comprehensive Setup: Documentation now includes complete setup instructions for both development and production environments

Example of Translation Quality

Before:

# Ініціалізація клієнта
client = genai.Client(api_key=GOOGLE_API_KEY)

# Список заборонених слів для ручної перевірки
blacklist = ["хуйня", "пизда", "єбать", "хуй", "блядь", "сука"]

After:

# Initialize client
client = genai.Client(api_key=GOOGLE_API_KEY)

# List of banned words for manual checking
blacklist = ["хуйня", "пизда", "єбать", "хуй", "блядь", "сука"]

The documentation now provides clear instructions for setting up the FastAPI blog application with its AI-powered moderation and auto-reply features, making it accessible to English-speaking developers while preserving the application's Ukrainian language functionality.

This pull request was created as a result of the following prompt from Copilot chat.

Пересоздать Pull Request для перевода всех комментариев в репозитории на английский язык и создания документации на английском языке. Документация должна включать инструкции по запуску проекта и его настройке.

---

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.