certflow.views.bases.datasources.sale_plan module

销售计划数据源（服务端排序 + 分页 + OR 快查）

薄封装 QueryController.query，输出与 QueryDataSource 一致契约。 列定义将在阶段 B 接入 query_view 时与既有显示列对齐；此处先给代表列。

class certflow.views.bases.datasources.sale_plan.SalePlanDataSource(controller, columns=None)

基类：BaseQueryDataSource

销售计划数据源：委托 QueryController 走服务端查询。

_fixed_conditions / _default_order_by 供子类（如 CorrectionDataSource） 参数化覆盖，注入固定查询条件与默认排序列，免去重写 query。

列定义：默认使用 SALE_PLAN_COLUMNS 代表列；from_views_config 可读取 ui.yaml 的默认销售计划视图列（与 query_view 显示列对齐，落实阶段 B 接入）。

参数:

• controller (Any)

• columns (list[tuple[str, str]] | None)

supports_server_sort: bool = True

supports_server_paging: bool = True

quick_search_or: bool = True

editable: bool = False

correction: bool = False

get_columns()

返回类型:

list[tuple[str, str]]

classmethod from_views_config(controller, view_key=None)

从 ui.yaml 的 query_page.views 读取视图列，构造与 query_view 显示列一致的数据源。

参数:

• controller (Any) -- QueryController 实例。

• view_key (str | None) -- 视图标识；缺省取首个视图（即 QueryView 默认视图）。

返回类型:

SalePlanDataSource

query(conditions, page, page_size, order_by=None, order_desc=False, or_filters=None)

参数:

• conditions (dict)

• page (int)

• page_size (int)

• order_by (str | None)

• order_desc (bool)

• or_filters (Any)

返回类型:

dict[str, Any]

export_csv(path)

参数:

path (str)

返回类型:

int