YehongPan · Oct 26, 2026 · Oct 21, 2026 · Oct 21, 2026 · Oct 21, 2026 · Oct 21, 2026
@@ -2,8 +2,8 @@
 
 Applies to backend/SDK Python configuration changes.
 
-- Define environment reads and defaults only in `backend/consts/const.py`.
-- Backend apps and services import values from `consts.const` or accept explicit parameters. Apps pass configuration through to services.
+- Define environment reads and defaults only in `backend/contracts/constants/environment.py`.
+- Backend apps and services import values from `contracts.constants.environment` or accept explicit parameters. Apps pass configuration through to services.
 - SDK code accepts configuration through constructor/function parameters. Do not add environment reads or `from_env()` methods.
 - Update `deploy/env/.env.example` or the relevant component's tracked example when adding/changing a variable. Do not overwrite local `.env` files.
 - Update affected constructors/callers to pass values to the SDK. Remove superseded direct reads within the changed path.

@@ -93,5 +93,5 @@ The new design standard requires all five audit fields on every new table, inclu
 ## SQL
 
 - Every file named `init.sql` or with `merged_migrations` in its name is already merged into the target branch, which is immutable. Never modify, rename, or delete one.
-- Add a versioned migration under `deploy/sql/migrations/`, following current naming/version conventions. Application version is `APP_VERSION` in `backend/consts/const.py`.
+- Add a versioned migration under `deploy/sql/migrations/`, following current naming/version conventions. Application version is `APP_VERSION` in `backend/contracts/constants/environment.py`.
 - Verify naming/comments, type limits, JSONB validation, audit maintenance, reference/uniqueness behavior, soft deletion/versioning, query indexes, transaction ownership, and migration compatibility as applicable. External database execution requires authorization for that action.
@@ -5,7 +5,7 @@ Applies to `backend/apps/**/*.py`.
 ## Boundary and compatibility
 
 - Parse/validate inputs, invoke services, translate domain errors to HTTP, and return responses. Keep business logic out of apps.
-- Read configuration from `consts.const` or pass explicit parameters. Preserve existing routes, payloads, and response structures.
+- Read configuration from `contracts.constants.environment` or pass explicit parameters. Preserve existing routes, payloads, and response structures.
 - New collections use plural nouns and snake_case path segments; parameters use singular semantic names such as `{agent_id}`. Keep legacy prefixes such as `/agent`.
 - Prefer resource-oriented CRUD routes; use action routes for non-CRUD behavior or compatibility.
 - GET reads/lists; preserve legacy GET actions but introduce no new side-effecting GETs. POST creates, searches, or triggers actions. DELETE is idempotent. Prefer PUT for full updates and PATCH for partial updates while retaining legacy POST update routes.

@@ -6,7 +6,7 @@ Applies to `backend/services/**/*.py`.
 - Return plain domain values; do not return web framework responses, raise `HTTPException`, or translate failures into HTTP status codes.
 - Reuse domain exceptions in `backend/consts/exceptions.py`; declare new domain classes there when needed. Wrap lower-level failures at the appropriate boundary with `raise DomainError(...) from exc`.
 - Existing exceptions include `AgentRunException`, `LimitExceededError`, `UnauthorizedError`, `SignatureValidationError`, and `MemoryPreparationException`. Inspect current definitions before use.
-- Import configuration from `consts.const` or accept parameters, then pass configuration into SDK calls. Do not read environment variables here.
+- Import configuration from `contracts.constants.environment` or accept parameters, then pass configuration into SDK calls. Do not read environment variables here.
 - A service explicitly allowed to continue after database failure may catch an appropriate shared exception. Inspect what the database client actually raises; do not assume it wraps failures in a named custom exception.
 
 Verify orchestration, return values, and domain failure propagation independently of HTTP mapping.
@@ -10,8 +10,8 @@
 
 - Write code comments, docstrings, TODOs, and configuration comments in English. User-facing strings may use supported languages; this does not prescribe conversation language.
 - Every new or modified source file (`.py`, `.sh`, `.sql`, `.ts`, `.tsx`, `.js`, `.jsx`, `.mjs`) must start with the copyright header `Copyright (c) 2025-2026 Huawei Technologies Co., Ltd. All rights reserved.` (the end year tracks the current year, e.g. `2025-2027` in 2027) in the file's comment style (`#` for Python/Shell, `--` for SQL, `//` for TypeScript/JavaScript), placed after shebang/encoding lines. The `Copyright Header Check` CI job rejects changed files missing it; verify or fix locally with `python scripts/check_copyright.py [--fix] <files...>`.
-- In backend/SDK Python code, centralize environment reads in `backend/consts/const.py`. Backend callers import from `consts.const`; SDK code accepts parameters and must not read environment variables or introduce `from_env()` methods.
-- Every SQL file under `deploy/sql/` already merged into the target branch is immutable, including initialization and Supabase SQL. Do not edit, rename, or delete it. Add versioned migrations under `deploy/sql/migrations/`; application version is `APP_VERSION` in `backend/consts/const.py`.
+- In backend/SDK Python code, centralize environment reads in `backend/contracts/constants/environment.py`. Backend callers import from `contracts.constants.environment`; SDK code accepts parameters and must not read environment variables or introduce `from_env()` methods.
+- Every SQL file under `deploy/sql/` already merged into the target branch is immutable, including initialization and Supabase SQL. Do not edit, rename, or delete it. Add versioned migrations under `deploy/sql/migrations/`; application version is `APP_VERSION` in `backend/contracts/constants/environment.py`.
 - Preserve existing HTTP routes, payloads, and response contracts when applying conventions to new code.
 
 ## Load rules for the task

@@ -1,3 +1,5 @@
+# Copyright (c) 2025-2026 Huawei Technologies Co., Ltd. All rights reserved.
+
 """
 openjiuwen SDK adapter for Nexent.
 
@@ -17,7 +19,10 @@
 import os
 import sys
 import types
-from typing import Any, List, Literal, Optional, Tuple
+from typing import TYPE_CHECKING, Any, List, Literal, Optional, Tuple
+
+if TYPE_CHECKING:
+    from openjiuwen.core.foundation.llm.schema.config import ModelClientConfig, ModelRequestConfig
 
 # ----------------------------------------------------------------------
 # MUST install bypasser + stubs before any openjiuwen import.
@@ -312,7 +317,7 @@ def _lazy_import_jiuwen():
 
 def build_jiuwen_model_configs(model_id: int, tenant_id: str):
     """将 nexent 模型配置转换为 Jiuwen 配置对象"""
-    from database.model_management_db import get_model_by_model_id
+    from management.db.model.repository import get_model_by_model_id
     from management.services.model.names import get_model_name_from_config
 
     ModelRequestConfig, ModelClientConfig, ProviderType, _, _, _, _, _ = _lazy_import_jiuwen()