feat: add internal schema support and schema_providers config

- Add internal param to register_schema for business data (zvt_info,
  trader_info, stock_tags, etc.) not tied to external data source
- Mark internal schemas with internal=True, store in zvt_context.internal_db_names
- Update storage_config docs for schema_providers
- Update factor/tag/trader/trading schemas to use internal=True

Author: foolcage

docs/storage_config.md

@@ -9,7 +9,8 @@
   "storage": {
     "base_path": null,
     "path_template": null,
-    "storage_routes": {}
+    "storage_routes": {},
+    "schema_providers": {}
   }
 }
 ```
@@ -21,6 +22,7 @@
 | `base_path` | string \| null | 数据根路径。`null` 时使用 `zvt_env["data_path"]`（即 `zvt_home/data`） |
 | `path_template` | string \| null | 路径模板。占位符：`{base_path}`, `{provider}`, `{db_name}`, `{storage_id}`。`null` 时使用默认规则 |
 | `storage_routes` | object | 路由覆盖。键格式 `"provider\|db_name"`，值为自定义 `storage_id` |
+| `schema_providers` | object | 无 Recorder 的 schema 的 provider 映射。键为 `db_name`，值为 `["provider"]` 数组。用于 fallback 或 internal schema |
 
 ### 默认行为（不配置时）
 
@@ -57,3 +59,7 @@
   }
 }
 ```
+
+## Internal Schema（内部 schema）
+
+业务逻辑类数据（如 `zvt_info`、`trader_info`、`stock_tags`）与外部数据源无关，通过 `register_schema(..., internal=True)` 标记为 internal。Internal schema 只做存储路由，不参与 provider 切换。其 provider（如 `zvt`）在 `schema_providers` 中配置，用于确定存储路径。

src/zvt/contract/context.py

@@ -55,6 +55,9 @@ def __init__(self) -> None:
         #: factor class registry
         self.factor_cls_registry = {}
 
+        #: db_names of internal schemas (business logic data, not tied to external data source)
+        self.internal_db_names = set()
+
         #: Optional StorageBackend; if set, api uses it instead of get_storage_backend()
         self.storage_backend: Optional["StorageBackend"] = None
 

src/zvt/contract/register.py

@@ -96,11 +96,16 @@ def register_schema(
     db_name: str,
     schema_base: DeclarativeMeta,
     entity_type: str = None,
+    internal: bool = False,
 ):
     """
     Register schema. Providers come from Recorder registration (provider_map_recorder).
     Tables/engines are created lazily on first get_db_engine(provider, db_name).
-    For schemas without Recorders (e.g. zvt_info), add to config: storage.schema_providers.
+    For schemas without Recorders, add to config: storage.schema_providers.
+
+    :param internal: If True, schema is business/internal data, not tied to external data source.
+                     Internal schemas only care about storage routing, do not participate in
+                     provider switching (e.g. zvt_info, trader_info, stock_tags).
     """
     schemas = []
     for item in schema_base.registry.mappers:
@@ -111,12 +116,15 @@ def register_schema(
             zvt_context.schemas.append(cls)
             if issubclass(cls, Mixin):
                 cls._zvt_db_name = db_name
+                cls._zvt_internal = internal  # internal=True: business data, no external data source
             if entity_type:
                 add_to_map_list(the_map=zvt_context.entity_map_schemas, key=entity_type, value=cls)
             schemas.append(cls)
 
     zvt_context.dbname_map_schemas[db_name] = schemas
     zvt_context.dbname_map_base[db_name] = schema_base
+    if internal:
+        zvt_context.internal_db_names.add(db_name)
 
 
 # the __all__ is generated

src/zvt/contract/schema.py

@@ -83,6 +83,11 @@ def register_provider(cls, provider):
         if provider not in cls._zvt_providers_override:
             cls._zvt_providers_override.append(provider)
 
+    @classmethod
+    def is_internal(cls) -> bool:
+        """True if schema is internal/business data, not tied to external data source."""
+        return getattr(cls, "_zvt_internal", False)
+
     @classmethod
     def get_providers(cls) -> List[str]:
         """

src/zvt/contract/zvt_info.py

@@ -40,7 +40,7 @@ class FactorState(ZvtInfoBase, StateMixin):
     __tablename__ = "factor_state"
 
 
-register_schema(db_name="zvt_info", schema_base=ZvtInfoBase)
+register_schema(db_name="zvt_info", schema_base=ZvtInfoBase, internal=True)
 
 
 # the __all__ is generated

src/zvt/factors/ma/domain/stock_1d_ma_factor.py

@@ -32,7 +32,7 @@ class Stock1dMaFactor(Stock1dMaFactorBase, Mixin):
     ma250 = Column(Float)
 
 
-register_schema(db_name="stock_1d_ma_factor", schema_base=Stock1dMaFactorBase)
+register_schema(db_name="stock_1d_ma_factor", schema_base=Stock1dMaFactorBase, internal=True)
 
 
 # the __all__ is generated

src/zvt/factors/ma/domain/stock_1d_ma_stats_factor.py

@@ -11,7 +11,7 @@ class Stock1dMaStatsFactor(Stock1dMaStatsFactorBase, MaStatsFactorCommon):
     __tablename__ = "stock_1d_ma_stats_factor"
 
 
-register_schema(db_name="stock_1d_ma_stats_factor", schema_base=Stock1dMaStatsFactorBase)
+register_schema(db_name="stock_1d_ma_stats_factor", schema_base=Stock1dMaStatsFactorBase, internal=True)
 
 
 # the __all__ is generated

src/zvt/factors/top_stocks.py

@@ -54,7 +54,7 @@ class TopStocks(TopStocksBase, Mixin):
     all_stocks_count = Column(Integer)
 
 
-register_schema(db_name="top_stocks", schema_base=TopStocksBase)
+register_schema(db_name="top_stocks", schema_base=TopStocksBase, internal=True)
 
 
 def compute_vol_up_stocks(target_date, provider="em", adjust_type=AdjustType.qfq, stock_type="small", entity_ids=None):

src/zvt/factors/zen/domain/index_1d_zen_factor.py

@@ -11,7 +11,7 @@ class Index1dZenFactor(Index1dZenFactorBase, ZenFactorCommon):
     __tablename__ = "index_1d_zen_factor"
 
 
-register_schema(db_name="index_1d_zen_factor", schema_base=Index1dZenFactorBase, entity_type="index")
+register_schema(db_name="index_1d_zen_factor", schema_base=Index1dZenFactorBase, entity_type="index", internal=True)
 
 
 # the __all__ is generated

src/zvt/factors/zen/domain/stock_1d_zen_factor.py

@@ -11,7 +11,7 @@ class Stock1dZenFactor(Stock1dZenFactorBase, ZenFactorCommon):
     __tablename__ = "stock_1d_zen_factor"
 
 
-register_schema(db_name="stock_1d_zen_factor", schema_base=Stock1dZenFactorBase, entity_type="stock")
+register_schema(db_name="stock_1d_zen_factor", schema_base=Stock1dZenFactorBase, entity_type="stock", internal=True)
 
 
 # the __all__ is generated