fix(project): use display fallback (#1129)

* fix(api): include source language targets

Treat the conversation or project source display language as part of the configured content translation target set when scheduling eager translation work. This makes eager scheduling match on-demand translation availability and queues translations such as Russian/Kyrgyz seed opinions into English when English is the conversation display language.

Apply the same target-set rule in the import worker because imported conversations create content translation work directly instead of going through the API scheduler.

Deploy: api, import-worker

* fix(agora): preserve inherited languages

Edit conversations that inherit project language settings now load and save with the same inherited/override model used during conversation creation.

Changes:
- Return language settings source and listed project language metadata from the edit endpoint
- Reuse the project language settings control on the edit page when project metadata is available
- Preserve project_inherited on save unless the user switches to a conversation override
- Keep update request and generated API contract/client types in sync

Deploy: agora, api

* fix(math-updater): compare language enums safely

Avoid comparing display_language_code and spoken_language_code columns directly in AI description translation work queries. PostgreSQL does not define equality between distinct enum types, which caused expired translation work recovery and first-pass resume paths to fail. Build matching display/spoken enum pairs instead, so each SQL predicate compares an enum column with a value of the same enum type. Add a regression test covering the supported eager translation pair mapping.

Deploy: math-updater

* feat(project): add machine translation

Add project pages to the existing content translation flow so listed projects can lazily request and display machine translations when dynamic translation is enabled and the target language is configured.

Product behavior:

- Manual project localizations remain native-quality content and do not show the translation toggle.

- Machine translations expose original and translated variants, defaulting based on whether the viewer understands the source language.

- Missing or failed machine translations can be retried from the project page with Show translation.

- Completed project translation events update the relevant cached project content without refetching the whole project page.

Implementation details:

- Add project as a content translation subject with project localized content DTOs and OpenAPI output.

- Return project body as sanitized-rendered HTML via bodyHtml plus originalContent and optional machineTranslation metadata.

- Queue project content translation work through the existing content translation service and availability checks.

- Add shared SSE topic builders and a project translation topic for realtime updates.

- Use generated content translation client calls from the frontend and patch project page cache on retry or SSE completion.

- Update dev project page fixtures and translation preview subject handling for project subjects.

Verification:

- cd services/agora && pnpm exec vue-tsc --noEmit

- cd services/agora && pnpm lint

- cd services/api && pnpm typecheck

Deploy: agora, api

* fix(project): use display fallback

Resolve project and conversation dynamic content using the user's display-language fallback chain on the backend.

Changes:

- add a shared display-language fallback chain and generic preferred-content resolver

- remove project-specific display-language persistence and API state

- make the project language selector update the global display language while showing all display languages with project-supported options first

- resolve project activity card translations per conversation instead of with a project-level language

- regenerate shared DTOs, OpenAPI clients, and the table-drop migration

Deploy: agora, api

Author: nicobao

services/agora/src/App.vue

@@ -31,6 +31,11 @@ import { isNetworkOffline } from "./composables/useNetworkStatus";
 import { useRealtimeSSE } from "./composables/useRealtimeSSE";
 import { useZupassVerification } from "./composables/zupass/useZupassVerification";
 import PersistentLayout from "./layouts/PersistentLayout.vue";
+import { ZodSupportedDisplayLanguageCodes } from "./shared/languages";
+import {
+  buildContentTranslationTopic,
+  buildProjectContentTranslationTopic,
+} from "./shared/types/dto";
 import { useLanguageStore } from "./stores/language";
 import { useBackendAuthApi } from "./utils/api/auth";
 import { useHtmlNodeCssPatch } from "./utils/css/htmlNodeCssPatch";
@@ -63,14 +68,42 @@ const realtimeConversationSlugId = computed(() => {
 
   return getSingleRouteParam(route.params.postSlugId) || undefined;
 });
+const realtimeProjectSlug = computed(() => {
+  if (String(route.name ?? "") !== "/project/[projectSlug]") {
+    return undefined;
+  }
+
+  if (!("projectSlug" in route.params)) {
+    return undefined;
+  }
+
+  return getSingleRouteParam(route.params.projectSlug) || undefined;
+});
 const realtimeTopics = computed(() => {
-  if (realtimeConversationSlugId.value === undefined) {
-    return [];
+  const topics: string[] = [];
+  if (realtimeConversationSlugId.value !== undefined) {
+    topics.push(
+      buildContentTranslationTopic({
+        conversationSlugId: realtimeConversationSlugId.value,
+        targetLanguageCode: languageStore.displayLanguage,
+      })
+    );
+  }
+
+  const projectSlug = realtimeProjectSlug.value;
+  if (projectSlug !== undefined) {
+    topics.push(
+      ...ZodSupportedDisplayLanguageCodes.options.map(
+        (languageCode) =>
+          buildProjectContentTranslationTopic({
+            projectSlug,
+            targetLanguageCode: languageCode,
+          })
+      )
+    );
   }
 
-  return [
-    `translation:conversation:${realtimeConversationSlugId.value}:target:${languageStore.displayLanguage}`,
-  ];
+  return topics;
 });
 
 // Initialize SSE for real-time events after auth initialization.

services/agora/src/api/.openapi-generator/FILES

@@ -111,7 +111,15 @@ docs/ApiV1ContentTranslationRequestPost200ResponseAnyOf2ContentAnyOf2.md
 docs/ApiV1ContentTranslationRequestPost200ResponseAnyOf2ContentAnyOf2Variants.md
 docs/ApiV1ContentTranslationRequestPost200ResponseAnyOf2ContentAnyOfVariants.md
 docs/ApiV1ContentTranslationRequestPost200ResponseAnyOf3.md
+docs/ApiV1ContentTranslationRequestPost200ResponseAnyOf3Content.md
+docs/ApiV1ContentTranslationRequestPost200ResponseAnyOf3ContentAnyOf.md
+docs/ApiV1ContentTranslationRequestPost200ResponseAnyOf3ContentAnyOf1.md
+docs/ApiV1ContentTranslationRequestPost200ResponseAnyOf3ContentAnyOf1Variants.md
+docs/ApiV1ContentTranslationRequestPost200ResponseAnyOf3ContentAnyOf2.md
+docs/ApiV1ContentTranslationRequestPost200ResponseAnyOf3ContentAnyOf2Variants.md
+docs/ApiV1ContentTranslationRequestPost200ResponseAnyOf3ContentAnyOfVariants.md
 docs/ApiV1ContentTranslationRequestPost200ResponseAnyOf4.md
+docs/ApiV1ContentTranslationRequestPost200ResponseAnyOf5.md
 docs/ApiV1ContentTranslationRequestPost200ResponseAnyOfContent.md
 docs/ApiV1ContentTranslationRequestPost200ResponseAnyOfContentAnyOf.md
 docs/ApiV1ContentTranslationRequestPost200ResponseAnyOfContentAnyOf1.md
@@ -130,6 +138,7 @@ docs/ApiV1ContentTranslationRequestPostRequestSubject.md
 docs/ApiV1ContentTranslationRequestPostRequestSubjectOneOf.md
 docs/ApiV1ContentTranslationRequestPostRequestSubjectOneOf1.md
 docs/ApiV1ContentTranslationRequestPostRequestSubjectOneOf2.md
+docs/ApiV1ContentTranslationRequestPostRequestSubjectOneOf3.md
 docs/ApiV1ConversationClosePost200Response.md
 docs/ApiV1ConversationClosePost200ResponseOneOf.md
 docs/ApiV1ConversationClosePost200ResponseOneOf1.md
@@ -314,9 +323,6 @@ docs/ApiV1ProjectCreateOptionsListPost200ResponseOneOfProjectListInner.md
 docs/ApiV1ProjectCreateOptionsListPost200ResponseOneOfProjectListInnerLanguageSettings.md
 docs/ApiV1ProjectCreateOptionsListPostRequest.md
 docs/ApiV1ProjectPageActivitiesFetchPost200Response.md
-docs/ApiV1ProjectPageActivitiesFetchPostRequest.md
-docs/ApiV1ProjectPageDisplayLanguageUpdatePost200Response.md
-docs/ApiV1ProjectPageDisplayLanguageUpdatePostRequest.md
 docs/ApiV1ProjectPageFetchPost200Response.md
 docs/ApiV1ProjectPageFetchPost200ResponseActivitiesInner.md
 docs/ApiV1ProjectPageFetchPost200ResponseActivitiesInnerStats.md
@@ -325,6 +331,8 @@ docs/ApiV1ProjectPageFetchPost200ResponseNextActivityCursor.md
 docs/ApiV1ProjectPageFetchPost200ResponseProject.md
 docs/ApiV1ProjectPageFetchPost200ResponseProjectAttributionsInner.md
 docs/ApiV1ProjectPageFetchPost200ResponseProjectContact.md
+docs/ApiV1ProjectPageFetchPost200ResponseProjectMachineTranslation.md
+docs/ApiV1ProjectPageFetchPost200ResponseProjectOriginalContent.md
 docs/ApiV1ProjectPageFetchPostRequest.md
 docs/ApiV1ProjectPageFetchPostRequestActivityCursor.md
 docs/ApiV1ReportConversationCreatePostRequest.md