- 店铺维度报表按期初数据+系统主体+爬虫新主体生成主体期间,一行一期间,修复流程历史重复行 - 变更日当天归新主体、老主体失效显示变更日前一天;关店和其他非正常状态两列显示 - - 新增店铺维度报表逻辑配置页(R1-R8)、主体商标数据逻辑配置页和预警页面 - 爬虫店铺主体按税号归一,首次抓到的新主体写入期间变更表并自动生成新期间 - 店铺基础信息、商标展示按爬虫优先;新增爬虫数据质量检查与预警处理
121 lines
5.6 KiB
PHP
121 lines
5.6 KiB
PHP
<?php
|
||
|
||
namespace Modules\EcommerceFinance\Services;
|
||
|
||
/**
|
||
* 「店铺主体商标数据逻辑配置」页面展示的规则目录。
|
||
*
|
||
* 这里集中维护运行逻辑的事实描述,页面只负责渲染;新增或调整规则时
|
||
* 同步修改本目录和实际实现,避免页面说明与系统行为不一致。
|
||
*/
|
||
class ShopEntityTrademarkLogic
|
||
{
|
||
public const CRAWL_COMPANY_DATASET = 'operations_replica.rpt.crawl_shop_company';
|
||
|
||
public const CRAWL_TRADEMARK_DATASET = 'operations_replica.rpt.crawl_shop_trademark';
|
||
|
||
/**
|
||
* 页面规则目录:类别 => 规则列表。
|
||
*
|
||
* @return array<string, list<array<string, string>>>
|
||
*/
|
||
public static function rules(): array
|
||
{
|
||
return [
|
||
'数据来源与优先级' => [
|
||
[
|
||
'code' => 'R1',
|
||
'object' => '店铺主体、店铺商标',
|
||
'logic' => '优先使用每天从店铺后台抓取的数据;爬虫没有覆盖的店铺回退到财务系统流程数据(统一社会信用代码关联主体、商标号关联商标)。',
|
||
'source' => 'crawl_shop_company / crawl_shop_trademark(爬虫)',
|
||
'priority' => '爬虫优先,流程数据兜底',
|
||
],
|
||
[
|
||
'code' => 'R2',
|
||
'object' => '店铺匹配与主体归一键',
|
||
'logic' => '爬虫 shop_name 与店铺基础信息 erpShopName 精确匹配;主体按 tax_no 解析工商主体名称后再关联,保证与主体维度经营报表的合并键一致。',
|
||
'source' => 'crawl_shop_company + fys_shopInfo + fys_companyInfo',
|
||
'priority' => '精确匹配,不做模糊匹配',
|
||
],
|
||
[
|
||
'code' => 'R3',
|
||
'object' => '多商标展示',
|
||
'logic' => '同一店铺存在多个商标时,商标名称和商标号都按同一顺序用「、」串联,两个字段一一对应。',
|
||
'source' => 'crawl_shop_trademark',
|
||
'priority' => '名称与号码同源、同顺序',
|
||
],
|
||
[
|
||
'code' => 'R4',
|
||
'object' => '商标号展示与查询',
|
||
'logic' => '商标号和商标名同时切换数据来源,展示、筛选、排序、导出四处使用同一口径。',
|
||
'source' => 'crawl_shop_trademark 优先,原商标号链路兜底',
|
||
'priority' => '同源同口径',
|
||
],
|
||
],
|
||
'期间切割与冲突处理' => [
|
||
[
|
||
'code' => 'R5',
|
||
'object' => '店铺主体生效期间',
|
||
'logic' => '爬虫最新一次抓取的主体与当前存续期间不一致时,以抓到变化的 crawl_date 作为新主体生效日;老主体到同一天 00:00 结束,收入按左闭右开区间归集。',
|
||
'source' => 'crawl_shop_company + store_report_lifecycle_rows',
|
||
'priority' => '爬虫驱动期间新增',
|
||
],
|
||
[
|
||
'code' => 'R6',
|
||
'object' => '同日主体冲突',
|
||
'logic' => '流程表与爬虫同一天给出不同主体时,以爬虫为准直接调整期间,同时生成预警并指派责任人人工复审;复审驳回后改回流程主体并重算该店铺期间和收入归属。',
|
||
'source' => 'crawl_shop_company + fys_shopInfo_flow',
|
||
'priority' => '爬虫强制覆盖 + 人工复审',
|
||
],
|
||
],
|
||
'数据质量监控' => [
|
||
[
|
||
'code' => 'R7',
|
||
'object' => '爬虫更新检测',
|
||
'logic' => '最新抓取日期距今超过 1 天,或数据更新时间停止前进时生成预警。',
|
||
'source' => 'crawl_shop_company / crawl_shop_trademark 的 crawl_date、update_time',
|
||
'priority' => '每天检查',
|
||
],
|
||
[
|
||
'code' => 'R8',
|
||
'object' => '主体名称一致性',
|
||
'logic' => '爬虫公司名与 tax_no 对应工商主体名不一致时生成预警,保留人工核对。',
|
||
'source' => 'crawl_shop_company + fys_companyInfo',
|
||
'priority' => '每天检查',
|
||
],
|
||
[
|
||
'code' => 'R9',
|
||
'object' => '关联完整性',
|
||
'logic' => '主体期间重复存续、期间断档或重叠,以及爬虫主体/商标在财务系统查不到对应资料时生成预警。',
|
||
'source' => 'store_report_lifecycle_rows + fys_companyInfo + fys_TrademarkInfo',
|
||
'priority' => '每天检查',
|
||
],
|
||
],
|
||
];
|
||
}
|
||
|
||
/**
|
||
* 扁平规则行,供页面表格渲染。
|
||
*
|
||
* @return list<array<string, string>>
|
||
*/
|
||
public static function rows(): array
|
||
{
|
||
$rows = [];
|
||
foreach (self::rules() as $category => $rules) {
|
||
foreach ($rules as $rule) {
|
||
$rows[] = [
|
||
'rule_code' => $rule['code'],
|
||
'rule_category' => $category,
|
||
'rule_object' => $rule['object'],
|
||
'rule_logic' => $rule['logic'],
|
||
'data_source' => $rule['source'],
|
||
'priority_note' => $rule['priority'],
|
||
];
|
||
}
|
||
}
|
||
|
||
return $rows;
|
||
}
|
||
}
|