业务视图配置

01 功能介绍：先分清范围、授权与结果

从「平台管理 → 系统设置 → 业务视图配置」进入，也可直接打开业务视图配置。本页用于新建视图、查看筛选详情、编辑名称与条件、启用或停用已有视图。

• 业务视图是供支持页面读取的共用条件，修改后可能影响后续查询或计算的范围。
• 页面临时筛选服务于当前业务查询，不等于修改共用视图；各页面对临时条件的合并或覆盖方式不同，不要假定全部都会继续缩小视图范围。
• 视图数据授权决定哪些用户或角色可使用视图，与本页配置条件是不同操作。
• 业务运行或历史快照保存某次计算结果，不能把本页配置版本当作业务结果版本。

开始前确认当前租户、目标业务页面、需要包含与排除的样本，以及是否已有可复用的视图。只为一次临时查数时，先判断业务页面自身的筛选是否足够，避免新建近似重名配置。

02 查询定位：名称、状态与范围

1. 在「搜索视图名称」输入名称片段，列表即时过滤。搜索只匹配视图名称，不检索条件中的品牌或国家。
2. 选择「全部状态」「启用」或「停用」。名称与状态只过滤已经加载的列表，不额外查询商品，也不是服务端分页。
3. 在「全部范围」中选择「策略」或「清洗器」。范围切换会重新读取列表；选择「策略」时，同时包含全局视图和策略模块视图，并非只显示模块视图。
4. 在「表格」与「卡片」间切换，核对名称、作用域、筛选维度、版本、更新时间与状态。窄屏默认卡片，宽屏默认表格；表格较宽时可横向滚动。
5. 点击「查看筛选详情」对应的维度摘要，查看实际值。摘要中的“品牌(2)”表示选了两个品牌，不是匹配两件商品。

标题数量为当前显示数与已加载总数。出现「暂无匹配视图」时，先清空名称并恢复全部状态、全部范围；「加载中」或错误提示不等于没有配置。需要重新读取列表时点「刷新」；刷新不会同步来源、重算业务结果，也不会清除名称和状态筛选。

03 选择全局或模块视图

「作用域类型」可选「全局可用」或「模块可用」。全局表示可供支持全局视图的页面使用，不表示所有系统页面都会读取，也不表示所有账号自动获得权限。

模块可用时，需要选择「作用模块」。当前界面提供「策略」「清洗器」两个值，不是任意业务菜单名称。清洗器是仍保留的兼容作用域选项，不能据此认定系统仍有可用的清洗器人工业务入口。

新建默认全局可用，并勾选「创建后立即启用」。编辑已有视图时，作用域类型和作用模块只读；需要改变归属时，应核对后新建，再单独安排授权与业务页面切换。本页没有“复制视图”按钮，也不会将旧视图的授权复制给新视图。

列表没有可靠区分“系统内置”和“普通自建”的专用标志，不能只看名称认定归属或安全性。默认、历史或已被业务使用的视图，应先确认用途与负责人；按钮可用不代表已经完成影响检查。

04 配置五个筛选维度

本页提供品牌、分类、国家、区域、平台五个维度的候选选择。支持多选；同一维度多个值是“满足任一项”，不同已配置维度之间是“同时满足”。例如选择两个品牌、美国和 Amazon，含义是这两个品牌之一，并同时满足美国及 Amazon 条件，而不是三个维度任选一个即可。

1. 打开维度下拉，用其中的搜索框缩小候选，再勾选需要的值。候选搜索只帮助找选项，不会把关键词保存为模糊匹配条件。
2. 分类按层级展开选择；勾选父节点会选中当前候选树中的叶子分类。保存的是这些分类标识，不应承诺以后新增的子分类自动被纳入。
3. 选择国家与平台后，再核对区域候选。国家和平台共同约束区域候选，选择区域不会反向自动填写国家。新建时，不再有效的候选值可能被清理；切换后务必重新检查「当前筛选」。
4. 打开「当前筛选」摘要逐项确认。维度内「清空」只清该维度；摘要旁「清空」清全部条件。未保存前只是表单修改。

未选某维度表示没有配置该维度限制，不是查询该字段为空的数据。界面没有“为空”“不等于”“不包含”、数值区间、自定义 AND/OR 分组或自由表达式操作符。也不能在这里配置 SKU、负责人、销售额或日期条件。

保存前会去除空白和重复值，区域与平台代码规范为大写。国家和品牌仍需选实际候选名称，不能把相近名称或编码当作自动别名。无交集的条件可能在业务页返回空结果；本页没有商品匹配数量预览或通用“非法组合”检查，保存成功不证明一定有匹配数据。

05 读懂来源周次、候选数字与旧值

页头「数据源周次」是候选来源信息，不是视图生效日期，也不是当前业务计算日期。本页没有选择历史来源周次的控件。品牌、分类候选来自本地产品及分类来源，国家候选来自店铺来源，区域与平台来自治理配置；这些来源各自取可用数据，不保证都是同一周。

品牌旁数字反映该来源周的产品记录数量，分类数量包括树内汇总，国家旁数字是对应来源中的店铺数；这些数字不能跨维度相加，也不是所选全部条件的交集商品数。国家、平台变化时主要联动区域候选，不代表品牌和分类已按整套条件重算。

编辑历史视图时，原有值即使不在最新候选中，也会保留。分类名称找不到时可能显示「分类#编号」，平台名称缺失时仍显示代码。仅改名称时不要顺手清空这些旧值；先核对来源是否暂缺、已停用或真实退役，再决定是否移除。

若出现「暂无品牌选项」「暂无分类选项」或「暂无区域选项」，先清除下拉搜索，检查来源周次、所选国家与平台及治理数据。加载失败应先处理错误，不能把候选为空当作业务数据全部不存在，也不要在来源未明时扩大范围。

06 新建并核对保存结果

前提：具有业务视图读取与写入权限，已确认使用页面和预期样本。

1. 点击「新建视图」，填写「视图名称」，使用能表达用途与范围的名称；名称不能为空，最多 200 个字符。
2. 确认全局或模块作用域，并在模块模式下选择作用模块。按前述方法配置至少一个筛选维度。
3. 检查「创建后立即启用」，展开当前筛选详情复核实际值，再点击「创建视图」。不准备保存时点「取消」。
4. 看到「已创建视图」提示后核对列表中的名称、作用域、条件、版本和状态；再点「刷新」复核。刚创建的行会加入当前列表，重新按范围查询后应再次确认是否属于目标范围。
5. 到目标业务页面按相同范围核对一个应包含和一个应排除的样本，再安排数据授权。

提示「至少配置一个筛选维度」时补齐条件；未填写名称时先补名称。请求失败会保留编辑面板与草稿；若网络结果不明确，先刷新列表查找是否已存在，不要连续创建同名视图。本页不提供重复名称检查结果作为身份依据，同名不能证明是同一个视图。

创建保存未演示。这里的成功提示只证明配置请求完成，不代表已经创建业务运行、完成授权或同步了数据。

07 编辑、版本与启停维护

1. 在列表核对目标行，点「编辑」打开「编辑业务视图」。名称、条件和「当前视图启用」可以调整，作用域保持不变。
2. 修改前记录原条件与版本，检查是否有其他人员同时维护；核对历史值后点「保存修改」。成功提示为「已更新视图」，随后核对列表并刷新。
3. 名称、条件或启停状态发生真实变更时版本递增；提交相同内容不会仅因点击保存就生成新版本。版本号不是历史版本切换器，本页没有版本回退或变更差异查看入口。
4. 只调整启停时可直接点行内「停用」或「启用」。点击即发起更新，没有先做依赖扫描的确认流程；操作前先确认使用该视图的业务。

原本非空条件的视图不能通过本页清空所有维度；原本为空条件的历史视图可以保留空条件，只修改名称或状态。这是历史兼容规则，不代表所有消费者都接受空范围，例如库存投影读取范围会拒绝空条件。

停用不是删除。停用后，按启用状态筛选的业务入口可能不再列出它，后续请求也可能提示视图不存在或未启用；已有运行或历史记录不能据此当作被删除。本页没有删除、复制或被引用关系检查入口，不要将看不到视图当作引用已经解除。

版本展示不提供并发覆盖保护：当前保存请求不携带“我编辑时的版本”进行冲突校验。多人维护时先协调，保存后刷新比较条件，避免以为版本递增就自动防止覆盖。编辑保存与启停未演示。

08 保存后到真实业务页面核对

配置列表只能证明保存的条件。验证使用效果时，请让实际使用者进入目标页面，选择正确视图、时间和其他筛选，分别核对正反两个样本。

• 在备货策略等策略查询中，后端会读取已启用视图；临时筛选可能有覆盖优先级，不能把其他页面的合并方式套用过来。
• 在库存投影中，视图范围用于读取商品与区域，视图版本、条件和状态进入来源核对。已生成运行及快照仍有各自运行标识；这里保存或刷新配置，不会直接覆写历史轨迹。结果看起来没变时，应核对业务页选中的运行和来源状态，按该页流程判断是否需要后续计算。
• 在利润报表中，支持的视图及来源与其他业务页不完全相同。部分查询对名称为 SKYSPER、FREESOO 的视图有既有兼容处理：当移除国家、区域条件后仍有其他有效范围时，使用品牌等剩余范围核对全部国家。因此不要把这些名称随意复用为普通自建视图名，也不能认为改名只影响显示。涉及此类既有视图时，应先在对应报表核对实际国家范围。

业务结果还依赖产品映射、国家区域治理、来源数据与页面自己的筛选。视图设置不能替代这些前提，更不承诺修改后所有页面即时一致或历史数据自动重算。

09 配置权限与视图授权分别处理

本页读取由业务视图读取权限控制（strategy_filter_view:read），新建、编辑与启停另需写入权限（strategy_filter_view:write）。只有读取权限时显示「只读模式」，可以查询和展开筛选详情，但新建、编辑、启停不可用；没有配置读取权限、但同时具备用户和角色读取权限时，可进入同页的授权列表；两类读取权限都不足时提示无业务视图读取权限。

配置保存不会自动给任何用户或角色授予这个视图。需要授权时在本页选择“详情与授权 → 授权”，按照账号权限与数据可见范围单独维护。授权页签读取需要用户和角色读取权限，保存另需角色写入权限；拥有本页写入权限不能替代这些权限。

授权保存是指定视图的完整主体集合替换，需要保留的用户或角色也要保留。随后由目标账号重新核对业务入口和视图选择；仍看不到时依次检查租户、模块适用范围、启用状态、该业务模块读取权限和数据授权，不要直接把视图扩大为全局来解决授权问题。授权维护未演示。

10 空结果与保存失败的排查顺序

1. 配置列表没有目标：先清名称与状态，恢复全部范围，再刷新；模块过滤会包含全局，但不会包含另一个模块的专属视图。
2. 候选或名称缺失：看来源周次和错误提示，检查国家/平台联动。历史编号或代码仍需核实，不自动视为无效并删除。
3. 保存被拦截：检查名称、至少一维条件与写入权限；保留草稿处理具体错误。未明确成功时先读回，不反复提交。
4. 保存成功但业务空表：核对条件是否有交集、商品分类与品牌映射、国家区域治理、平台来源及业务页时间；本页没有匹配预览，不能仅凭候选数量判断。
5. 业务仍显示旧结果：确认选择的是当前查询、旧运行还是历史快照，再按业务页核对来源。不要把“刷新配置”当“重新计算”。
6. 停用后无法继续查询：确认是否仍被业务使用，协调负责人判断是否恢复启用；不要新建同名视图冒充原有记录。

11 常见问题