semantics
This commit is contained in:
@@ -61,9 +61,9 @@ class TranslationOrchestrator:
|
||||
|
||||
# region start_run [TYPE Function]
|
||||
# @PURPOSE: Start a new translation run for a job.
|
||||
# @PRE: job_id exists. For manual runs, an accepted preview session must exist.
|
||||
# @POST: TranslationRun is created in PENDING status with hash fields and config snapshot.
|
||||
# @SIDE_EFFECT: DB writes.
|
||||
# @PRE job_id exists. For manual runs, an accepted preview session must exist.
|
||||
# @POST TranslationRun is created in PENDING status with hash fields and config snapshot.
|
||||
# @SIDE_EFFECT DB writes.
|
||||
def start_run(
|
||||
self,
|
||||
job_id: str,
|
||||
@@ -82,9 +82,9 @@ class TranslationOrchestrator:
|
||||
|
||||
# region execute_run [TYPE Function]
|
||||
# @PURPOSE: Execute a translation run: dispatch executor, generate SQL, submit to Superset.
|
||||
# @PRE: run is in PENDING status.
|
||||
# @POST: Run is executed, SQL generated, Superset submission attempted.
|
||||
# @SIDE_EFFECT: LLM calls, DB writes, Superset API calls.
|
||||
# @PRE run is in PENDING status.
|
||||
# @POST Run is executed, SQL generated, Superset submission attempted.
|
||||
# @SIDE_EFFECT LLM calls, DB writes, Superset API calls.
|
||||
def execute_run(
|
||||
self,
|
||||
run: TranslationRun,
|
||||
@@ -119,7 +119,7 @@ class TranslationOrchestrator:
|
||||
|
||||
# region _generate_and_insert_sql [TYPE Function] [SEMANTICS backward-compat wrapper]
|
||||
# @PURPOSE: Backward-compatible delegating wrapper for SQL generation and insert.
|
||||
# @SIDE_EFFECT: Delegates to SQLInsertService. May call Superset API.
|
||||
# @SIDE_EFFECT Delegates to SQLInsertService. May call Superset API.
|
||||
def _generate_and_insert_sql(
|
||||
self,
|
||||
job: Any,
|
||||
@@ -133,7 +133,7 @@ class TranslationOrchestrator:
|
||||
|
||||
# region _update_language_stats [TYPE Function] [SEMANTICS backward-compat wrapper]
|
||||
# @PURPOSE: Backward-compatible delegating wrapper for language stats update.
|
||||
# @SIDE_EFFECT: Delegates to TranslationResultAggregator.update_language_stats.
|
||||
# @SIDE_EFFECT Delegates to TranslationResultAggregator.update_language_stats.
|
||||
def _update_language_stats(
|
||||
self,
|
||||
run_id: str,
|
||||
|
||||
Reference in New Issue
Block a user