Merge pull request #6949 from akatsoulas/auto-translate-archived

Create missing tranlsations for enabled locales

Author: akatsoulas

docs/l10n-system.md

@@ -66,10 +66,33 @@ Different content managers handle the publishing workflow:
 
 #### 5. Services (`kitsune/wiki/services.py`)
 
+**TranslationQueryBuilder**
+- Centralized repository for complex translation discovery queries
+- Provides methods to find stale and missing translations
+- Implements document-aware routing logic for AI vs HYBRID flows
+- Key methods:
+  - `get_stale_docs_hybrid()`: Finds non-archived stale translations in HYBRID locales
+  - `get_stale_docs_ai()`: Finds all stale translations for AI flow (all AI docs + archived HYBRID docs)
+  - `get_missing_docs_hybrid()`: Finds non-archived documents without translations in HYBRID locales
+  - `get_missing_docs_ai()`: Finds documents without translations for AI flow
+  - `get_pending_translations()`: Finds unreviewed translations exceeding grace period
+  - `get_obsolete_translations()`: Finds translations that are no longer useful
+
+**BaseTranslationService**
+- Shared processing logic for translation services
+- Handles metadata building and strategy execution
+- Uses TranslationQueryBuilder for document discovery
+
 **StaleTranslationService**
 - Identifies outdated translations that need updates
 - Processes batch updates using appropriate strategies
 - Configurable via `STALE_TRANSLATION_THRESHOLD_DAYS` and `STALE_TRANSLATION_BATCH_SIZE`
+- Method: `process_stale(limit, strategy)` - optionally filters by AI or HYBRID strategy
+
+**MissingTranslationService**
+- Creates initial translations for documents without existing translations
+- Uses document archive status for smart routing
+- Method: `process_missing(limit, strategy)` - creates translations for missing docs
 
 **HybridTranslationService**
 - Manages hybrid workflow automation
@@ -84,6 +107,24 @@ The system responds to several trigger events (`TranslationTrigger`):
 - `MARK_READY_FOR_L10N`: Manual request to mark content for translation
 - `TRANSLATE`: Direct translation request
 - `STALE_TRANSLATION_UPDATE`: Periodic updates of outdated content
+- `INITIAL_TRANSLATION`: Creating new translations for documents without existing translations
+
+### Document-Aware Routing
+
+The system intelligently routes translations based on document status and target locale:
+
+**Archived Documents in HYBRID Locales**
+- Archived knowledge base articles in HYBRID locales automatically use the AI flow
+- This reduces review burden for content that's no longer actively maintained
+- Implemented via `TranslationStrategyFactory.get_method_for_document()`
+
+**Routing Logic:**
+```python
+if locale in HYBRID_ENABLED_LOCALES and document.is_archived:
+    return TranslationMethod.AI  # Skip human review for archived docs
+else:
+    return get_method_for_locale(locale)  # Standard locale-based routing
+```
 
 ## Configuration
 
@@ -163,7 +204,18 @@ graph TD
 python manage.py process_stale_translations --limit 100
 ```
 
-Updates outdated translations across all AI/Hybrid enabled locales.
+Updates outdated translations across all AI/Hybrid enabled locales. The service automatically routes documents based on their archive status and locale configuration.
+
+### Create Missing Translations
+
+```bash
+python manage.py create_missing_translations --limit 50
+```
+
+Creates initial translations for English documents that don't have translations yet. Uses document-aware routing:
+- AI locales: translates all documents (archived and non-archived)
+- HYBRID locales (non-archived docs): creates translations for human review
+- HYBRID locales (archived docs): auto-publishes via AI flow
 
 ### Publish Pending Translations