CaiWuXiTong/modules/EcommerceFinance/Services/ShopEntityTrademarkLogic.php
WuYongJie 561c42d830 feat: 店铺主体期间与爬虫数据逻辑
- 店铺维度报表按期初数据+系统主体+爬虫新主体生成主体期间,一行一期间,修复流程历史重复行
- 变更日当天归新主体、老主体失效显示变更日前一天;关店和其他非正常状态两列显示 -
- 新增店铺维度报表逻辑配置页(R1-R8)、主体商标数据逻辑配置页和预警页面
- 爬虫店铺主体按税号归一,首次抓到的新主体写入期间变更表并自动生成新期间
- 店铺基础信息、商标展示按爬虫优先;新增爬虫数据质量检查与预警处理
2026-10-03 13:28:08 +08:00

121 lines
5.6 KiB
PHP
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<?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;
}
}