Technical guide · Overview

Page status: HistoricalHistory group: Updates

Backend translation publish guard

This update documents the backend compatibility API guard for ramideltoro/nutsnews-backend#263.

Visual overview

Primary diagram

System map

This update documents the backend compatibility API guard for ramideltoro/nutsnews-backend#263.

Render the repository-owned system map when you need it.

Diagram is not rendered yet.

View as text

Backend translation publish guard

This update documents the backend compatibility API guard for ramideltoro/nutsnews-backend#263.

flowchart TB
  accTitle: Backend translation publish guard
  accDescr {
    This update documents the backend compatibility API guard for ramideltoro/nutsnews-backend#263.
  }
  A["Backend translation publish guard"] --> B["updates/README_BACKEND_TRANSLATION_PUBLISH_GUARD.md"]
  B --> C["Auto-generated placeholder diagram"]

Backend translation publish guard

This update documents the backend compatibility API guard for ramideltoro/nutsnews-backend#263.

What changed

Backend-primary Worker writes can no longer insert accepted articles as already published.
publish-articles-batch now requires enabled summary languageCodes before publishing.
The backend checks public.article_summaries for every requested article/language pair.
Missing rows leave articles hidden and return structured missingTranslations details.
Recovery reads include both published and translation_pending articles.

Worker boundary

The Worker repo must pass its enabled languages to publish-articles-batch, treat ok=false as a recoverable translation gap, and log the returned article URL/language pairs through worker.translation.* diagnostics.

Validation

Backend validation:

python3 -m unittest tests.test_worker_db_api
python3 scripts/validate_backend_api_compatibility_contract.py
python3 scripts/backend_postgres_smoke_tests.py --offline
python3 scripts/backend_app_db_api_smoke.py --offline
python3 -m unittest discover -s tests
python3 scripts/validate_no_secret_files.py
git diff --check