778 lines
34 KiB
PHP
778 lines
34 KiB
PHP
<?php
|
||
|
||
namespace App\Console\Commands;
|
||
|
||
use Illuminate\Console\Command;
|
||
use Illuminate\Support\Carbon;
|
||
use Illuminate\Support\Facades\DB;
|
||
use InvalidArgumentException;
|
||
use Modules\EcommerceFinance\Services\AccountLedgerRemarkMap;
|
||
use Modules\EcommerceFinance\Services\AccountMappingStore;
|
||
use Modules\EcommerceFinance\Services\LedgerRemarkFilter;
|
||
use Modules\EcommerceFinance\Services\UpstreamReadOnlyQueryFactory;
|
||
use Throwable;
|
||
|
||
/**
|
||
* 业绩明细 → 店铺收款匹配订单明细。
|
||
*
|
||
* 以「店铺收款账户账单」为基数（LEFT JOIN 语义，账单每笔收款都保留），
|
||
* 按「店铺 + 订单号」关联订单侧商品金额，输出严格遵循「一个店铺、一个订单号、一个商品金额」。
|
||
*
|
||
* 口径（已与业务确认）：
|
||
* - 账单侧：按「总账备注」筛选（与店铺收款账户账单页同一口径），
|
||
* 再按「店铺 + 清洗后订单号」汇总收入金额与收款笔数
|
||
* - 订单侧：销售全量按「店铺 + 线上订单号」先聚合求和（一单多品/多子订单在此合并），金额取 goods_count > 0 的有效行
|
||
* - 单号清洗：去除日期前缀（如 260630-）、空格、横杠后按核心号匹配
|
||
* - 店铺：账单用「线上真实店铺」优先，订单侧用销售全量店铺名，统一把下划线归一为横杠
|
||
* - 同一店铺同一订单号多笔收款 → 标注「一单多笔」，商品金额只挂一次
|
||
*/
|
||
class SyncStoreReceiptOrderMatches extends Command
|
||
{
|
||
protected $signature = 'store-receipt:order-match:sync
|
||
{month : 账单月份，格式 YYYY-MM}
|
||
{--platform=taobao-alipay : 收款账户，目前支持 taobao-alipay}
|
||
{--chunk=1200 : 单次向上游查询的订单号数量}
|
||
{--limit=0 : 仅处理前 N 笔账单（调试用，0 表示全量）}
|
||
{--amounts-only : 只回填「优惠金额 / 冲减金额」两列，不重跑订单侧匹配}';
|
||
|
||
protected $description = '按店铺收款账户账单匹配订单侧商品金额，生成「业绩明细」核对镜像';
|
||
|
||
/**
|
||
* 收款账户页签 → 账单来源与列映射。
|
||
*
|
||
* 各页签的表结构不一致：淘系/拼多多的订单号列是 online_order_no、金额列是 income_amount；
|
||
* 京东系列与抖音是 order_no / income；得物没有 occurred_at，用 bill_date。
|
||
* 京东账单与京喜账单共用同一张日账单表，用店铺名关键字拆分。
|
||
*/
|
||
private const SOURCES = [
|
||
'taobao-alipay' => [
|
||
'label' => '淘系支付宝', 'table' => 'taobao_alipay_bill_rows',
|
||
'order' => 'online_order_no', 'time' => 'occurred_at', 'amount' => 'income_amount',
|
||
'real_store' => 'online_real_store',
|
||
],
|
||
'taobao-wechat' => [
|
||
'label' => '淘系微信', 'table' => 'taobao_wechat_bill_rows',
|
||
'order' => 'online_order_no', 'time' => 'occurred_at', 'amount' => 'income_amount',
|
||
],
|
||
'pinduoduo' => [
|
||
'label' => '拼多多', 'table' => 'pdd_settlement_bill_rows',
|
||
'order' => 'online_order_no', 'time' => 'occurred_at', 'amount' => 'income_amount',
|
||
],
|
||
'dewu' => [
|
||
'label' => '得物', 'table' => 'dewu_settlement_bill_rows',
|
||
'order' => 'online_order_no', 'time' => 'bill_date', 'amount' => 'income_amount',
|
||
'real_store' => 'online_real_store',
|
||
],
|
||
'jd-wallet' => [
|
||
'label' => '京东网银钱包', 'table' => 'jd_wallet_bill_rows',
|
||
'order' => 'order_no', 'time' => 'occurred_at', 'amount' => 'income',
|
||
'periods' => 'jd_wallet_bill_periods',
|
||
],
|
||
'jd-transactions' => [
|
||
'label' => '京东账单', 'table' => 'jd_daily_bill_rows',
|
||
'order' => 'order_no', 'time' => 'occurred_at', 'amount' => 'income',
|
||
'store_exclude' => '京喜',
|
||
'periods' => 'jd_daily_bill_periods',
|
||
],
|
||
'jingxi' => [
|
||
'label' => '京喜账单', 'table' => 'jd_daily_bill_rows',
|
||
'order' => 'order_no', 'time' => 'occurred_at', 'amount' => 'income',
|
||
'store_include' => '京喜',
|
||
'periods' => 'jd_daily_bill_periods',
|
||
],
|
||
'douyin' => [
|
||
'label' => '抖音', 'table' => 'douyin_authoritative_bills',
|
||
'order' => 'order_no', 'time' => 'occurred_at', 'amount' => 'income',
|
||
'periods' => 'douyin_authoritative_periods',
|
||
],
|
||
];
|
||
|
||
/**
|
||
* 账单侧筛选口径：总账备注命中以下任一取值即计入。
|
||
*
|
||
* 与店铺收款账户账单页的「总账备注」筛选完全一致，账单项目清单由
|
||
* ec_account_ledger_remarks（平台 + 账单项目 → 总账备注）反查得到。
|
||
*/
|
||
private const LEDGER_REMARKS = [
|
||
'订单收入',
|
||
];
|
||
|
||
/**
|
||
* 「优惠金额」列口径：账单的总账备注命中以下取值。
|
||
*
|
||
* 总账备注优先取「财务规则 › 科目映射表」的财务备注（与店铺收款账户账单页一致），
|
||
* 取不到时回落到 ec_account_ledger_remarks。金额不计入收入金额与差额。
|
||
*/
|
||
private const DISCOUNT_REMARKS = [
|
||
'优惠收入',
|
||
];
|
||
|
||
/** 「冲减金额」列口径：账单的总账备注命中以下取值，不参与收入金额与差额计算。 */
|
||
private const OFFSET_REMARKS = [
|
||
'冲减收入',
|
||
];
|
||
|
||
private const TARGET_TABLE = 'store_receipt_order_match_rows';
|
||
|
||
private const STATUS_MATCHED = '已匹配';
|
||
|
||
private const STATUS_UNMATCHED = '未匹配';
|
||
|
||
private const REMARK_EMPTY_NO = '空单号';
|
||
|
||
private const REMARK_BAD_FORMAT = '格式不一致';
|
||
|
||
private const REMARK_NO_ORDER = '订单表无此单';
|
||
|
||
private const REMARK_NO_AMOUNT = '订单无商品金额';
|
||
|
||
private const REMARK_SHOP_DIFF = '店铺不一致';
|
||
|
||
private const REMARK_DUP_ORDER = '订单侧同号多条';
|
||
|
||
private const REMARK_MULTI_PAY = '一单多笔';
|
||
|
||
public function handle(UpstreamReadOnlyQueryFactory $factory): int
|
||
{
|
||
$month = trim((string) $this->argument('month'));
|
||
if (preg_match('/^\d{4}-\d{2}$/', $month) !== 1) {
|
||
throw new InvalidArgumentException('月份格式应为 YYYY-MM，例如 2026-08。');
|
||
}
|
||
|
||
$platform = (string) $this->option('platform');
|
||
if (! isset(self::SOURCES[$platform])) {
|
||
throw new InvalidArgumentException('暂不支持的收款账户：' . $platform);
|
||
}
|
||
|
||
$connection = (string) config('upstream_mirrors.connection', 'business_mirror');
|
||
$source = self::SOURCES[$platform];
|
||
$billTable = (string) $source['table'];
|
||
$orderColumn = (string) $source['order'];
|
||
$timeColumn = (string) $source['time'];
|
||
$amountColumn = (string) $source['amount'];
|
||
$realStoreColumn = (string) ($source['real_store'] ?? '');
|
||
$chunkSize = max(50, (int) $this->option('chunk'));
|
||
$limit = max(0, (int) $this->option('limit'));
|
||
|
||
$start = Carbon::createFromFormat('Y-m-d', $month . '-01')->startOfDay();
|
||
$end = $start->copy()->addMonthNoOverflow();
|
||
$reportMonth = $start->toDateString();
|
||
|
||
$this->info(sprintf(
|
||
'账期 %s（%s ~ %s），收款账户 %s（%s）',
|
||
$month,
|
||
$start->toDateString(),
|
||
$end->copy()->subDay()->toDateString(),
|
||
$source['label'],
|
||
$billTable,
|
||
));
|
||
|
||
// 「总账备注」→ 按平台分组的账单项目集合（淘系页签同页混有淘宝/天猫/阿里巴巴店铺，
|
||
// 必须连店铺名前缀一起过滤，才能与页面按行取到的总账备注一致）。
|
||
// 收入金额只认 LEDGER_REMARKS；优惠/冲减金额各自单独成列，不参与收入与差额。
|
||
$baseGroups = $this->ledgerRemarkGroups($platform);
|
||
$discountGroups = $this->ledgerRemarkGroups($platform, self::DISCOUNT_REMARKS);
|
||
$offsetGroups = $this->ledgerRemarkGroups($platform, self::OFFSET_REMARKS);
|
||
// 总账备注现在优先取科目映射表的财务备注，因此这两列的候选账单项目
|
||
// 也要按科目映射表补一遍，否则「优惠收入 / 冲减收入」永远取不到项目。
|
||
$promoItems = array_values(array_unique(array_merge(
|
||
$this->accountMappingItems($platform, self::DISCOUNT_REMARKS),
|
||
$this->accountMappingItems($platform, self::OFFSET_REMARKS),
|
||
)));
|
||
// 微信账户页签的账单项目带「wx」前缀（wx限时红包代商家垫付扣回 等），
|
||
// 科目映射表用的是不带前缀的名字，这里两种写法都带上。
|
||
$promoItems = $this->withWxVariants($promoItems);
|
||
if ($baseGroups === []) {
|
||
$this->error('「总账备注」映射表没有匹配到任何账单项目，请先导入 ec_account_ledger_remarks。');
|
||
|
||
return self::FAILURE;
|
||
}
|
||
$this->info('总账备注命中平台分组：' . count($baseGroups) . ' 组');
|
||
if ($discountGroups === [] && $offsetGroups === [] && $promoItems === []) {
|
||
$this->warn('「优惠收入」「冲减收入」在科目映射表与总账备注映射里都没有对应账单项目，两列将全部为空。');
|
||
}
|
||
|
||
$select = ['store_name', 'bill_item', $orderColumn, $timeColumn, $amountColumn];
|
||
if ($realStoreColumn !== '') {
|
||
$select[] = $realStoreColumn;
|
||
}
|
||
$billQuery = DB::connection($connection)->table($billTable)
|
||
->select($select)
|
||
->where($timeColumn, '>=', $start->toDateTimeString())
|
||
->where($timeColumn, '<', $end->toDateTimeString());
|
||
if (isset($source['store_include'])) {
|
||
$billQuery->where('store_name', 'like', '%' . $source['store_include'] . '%');
|
||
}
|
||
if (isset($source['store_exclude'])) {
|
||
$billQuery->where('store_name', 'not like', '%' . $source['store_exclude'] . '%');
|
||
}
|
||
// 京东系列与抖音的镜像按代保存历史导入，必须只取与本月重叠的活动代，否则会重复计数。
|
||
$periodsTable = (string) ($source['periods'] ?? '');
|
||
if ($periodsTable !== '') {
|
||
$generations = DB::connection($connection)->table($periodsTable)
|
||
->where('period_start', '<', $end->toDateString())
|
||
->where('period_end', '>', $start->toDateString())
|
||
->pluck('active_generation')
|
||
->filter()
|
||
->unique()
|
||
->values()
|
||
->all();
|
||
if ($generations === []) {
|
||
$this->warn('该账期没有活动代（' . $periodsTable . '），未写入任何数据。');
|
||
|
||
return self::SUCCESS;
|
||
}
|
||
$billQuery->whereIn('generation', $generations);
|
||
$this->info('活动代：' . count($generations) . ' 个');
|
||
}
|
||
$billQuery->where(function ($group) use ($baseGroups, $discountGroups, $offsetGroups, $promoItems): void {
|
||
LedgerRemarkFilter::applyGroups(
|
||
$group,
|
||
array_merge($baseGroups, $discountGroups, $offsetGroups),
|
||
'bill_item',
|
||
static fn ($sub, string $prefix) => $sub->where('store_name', 'like', $prefix . '%'),
|
||
static fn ($sub, string $prefix) => $sub->where('store_name', 'not like', $prefix . '%'),
|
||
);
|
||
if ($promoItems !== []) {
|
||
$group->orWhereIn('bill_item', $promoItems);
|
||
}
|
||
});
|
||
$bills = $billQuery->orderBy($timeColumn)->get();
|
||
|
||
if ($limit > 0) {
|
||
$bills = $bills->take($limit);
|
||
}
|
||
|
||
if ($bills->isEmpty()) {
|
||
$this->warn('该账期没有符合条件的账单记录，未写入任何数据。');
|
||
|
||
return self::SUCCESS;
|
||
}
|
||
|
||
/** @var array<string,array<string,mixed>> $groups 账单侧按「店铺 + 订单号」聚合 */
|
||
$groups = [];
|
||
$paymentTotal = 0;
|
||
$incomeTotal = 0.0;
|
||
$discountTotal = 0.0;
|
||
$offsetTotal = 0.0;
|
||
$remarkMap = app(AccountLedgerRemarkMap::class);
|
||
$tabPlatform = $remarkMap->defaultPlatform($platform);
|
||
$ledgerMap = $remarkMap->map();
|
||
$incomeOverlapRows = 0;
|
||
$incomeOverlapTotal = 0.0;
|
||
foreach ($bills as $bill) {
|
||
$storeName = (string) ($bill->store_name ?? '');
|
||
$billItem = (string) ($bill->bill_item ?? '');
|
||
// 收入金额沿用「总账备注映射」白名单口径，保证既有数字不变；
|
||
// 优惠 / 冲减两列按新口径（科目映射表的财务备注优先）取数。
|
||
$legacyRemark = $ledgerMap[$remarkMap->platform($storeName, $tabPlatform) ?? ''][$billItem] ?? null;
|
||
$remark = $remarkMap->remark($storeName, $tabPlatform, $billItem);
|
||
$isPromoRemark = in_array($remark, self::DISCOUNT_REMARKS, true)
|
||
|| in_array($remark, self::OFFSET_REMARKS, true);
|
||
$isIncomeRemark = in_array($legacyRemark, self::LEDGER_REMARKS, true);
|
||
if ($isIncomeRemark && $isPromoRemark) {
|
||
// 已经在收入金额里的行：不重复计入优惠/冲减列，单独提示金额。
|
||
$incomeOverlapRows++;
|
||
$incomeOverlapTotal += (float) $bill->{$amountColumn};
|
||
}
|
||
$bucket = match (true) {
|
||
$isIncomeRemark => 'income',
|
||
in_array($remark, self::DISCOUNT_REMARKS, true) => 'discount',
|
||
in_array($remark, self::OFFSET_REMARKS, true) => 'offset',
|
||
default => null,
|
||
};
|
||
if ($bucket === null) {
|
||
continue;
|
||
}
|
||
|
||
$rawNo = trim((string) ($bill->{$orderColumn} ?? ''));
|
||
$core = self::cleanOrderNo($rawNo);
|
||
$realStore = $realStoreColumn !== '' ? (string) ($bill->{$realStoreColumn} ?? '') : '';
|
||
$shopKey = self::normalizeShop($realStore !== '' ? $realStore : (string) $bill->store_name);
|
||
$key = $shopKey . '|' . $core;
|
||
|
||
if (! isset($groups[$key])) {
|
||
$groups[$key] = [
|
||
'platform' => (string) $source['label'],
|
||
'store_name' => (string) ($bill->store_name ?? ''),
|
||
'shop_key' => $shopKey,
|
||
'online_order_no' => $rawNo,
|
||
'order_core_no' => $core,
|
||
'occurred_date' => substr((string) $bill->{$timeColumn}, 0, 10),
|
||
'payment_count' => 0,
|
||
'income_amount' => 0.0,
|
||
'discount_amount' => 0.0,
|
||
'discount_seen' => false,
|
||
'offset_amount' => 0.0,
|
||
'offset_seen' => false,
|
||
];
|
||
}
|
||
|
||
$amount = (float) $bill->{$amountColumn};
|
||
if ($bucket === 'income') {
|
||
$groups[$key]['payment_count']++;
|
||
$groups[$key]['income_amount'] += $amount;
|
||
$paymentTotal++;
|
||
$incomeTotal += $amount;
|
||
} elseif ($bucket === 'discount') {
|
||
$groups[$key]['discount_seen'] = true;
|
||
$groups[$key]['discount_amount'] += $amount;
|
||
$discountTotal += $amount;
|
||
} else {
|
||
$groups[$key]['offset_seen'] = true;
|
||
$groups[$key]['offset_amount'] += $amount;
|
||
$offsetTotal += $amount;
|
||
}
|
||
}
|
||
|
||
// 行口径保持不变：仍然是「有收款账单（收入白名单）的店铺 + 订单号」，
|
||
// 只有优惠/冲减、没有收款的订单号不单独成行。
|
||
$groups = array_filter($groups, static fn (array $group): bool => (int) $group['payment_count'] > 0);
|
||
|
||
$this->info('账单收款笔数：' . $paymentTotal . '，按「店铺 + 订单号」聚合后：' . count($groups) . ' 行');
|
||
$this->line(' 优惠金额合计：' . number_format($discountTotal, 2) . '，冲减金额合计：' . number_format($offsetTotal, 2));
|
||
if ($incomeOverlapRows > 0) {
|
||
$this->line(sprintf(
|
||
' 提示：%d 笔（%s 元）按旧口径已计入收入金额，未重复计入优惠/冲减列。',
|
||
$incomeOverlapRows,
|
||
number_format($incomeOverlapTotal, 2),
|
||
));
|
||
}
|
||
|
||
if ((bool) $this->option('amounts-only')) {
|
||
return $this->backfillPromoAmounts($month, $source, $groups, $reportMonth);
|
||
}
|
||
|
||
// 订单侧的单号在不同平台形态不同：淘系/京东是无前缀纯数字，
|
||
// 拼多多等平台带日期前缀（260630-xxx）。这里同时带上原始号与清洗后的
|
||
// 核心号去查订单侧，再统一按核心号聚合，避免漏匹配。
|
||
$cores = [];
|
||
foreach ($groups as $group) {
|
||
foreach ([(string) $group['online_order_no'], (string) $group['order_core_no']] as $candidate) {
|
||
$candidate = trim($candidate);
|
||
if ($candidate !== '') {
|
||
$cores[$candidate] = true;
|
||
}
|
||
}
|
||
}
|
||
|
||
$upstream = $factory->forSource('operations_replica');
|
||
$dwsFrom = $start->copy()->subDays(150)->toDateString();
|
||
$dwsTo = $end->copy()->addDays(7)->toDateString();
|
||
|
||
/** @var array<string,float> $orderAmount 订单侧按「店铺 + 核心单号」聚合的商品金额（仅 goods_count>0 的有效行） */
|
||
$orderAmount = [];
|
||
/** @var array<string,true> $orderSeen 订单侧出现过的「店铺 + 核心单号」（含 0 元行） */
|
||
$orderSeen = [];
|
||
/** @var array<string,array<string,true>> $coresByCore 核心单号 → 出现过的店铺集合 */
|
||
$coresByCore = [];
|
||
/** @var array<string,true> $coreSeen 订单侧出现过的核心单号（含店铺名为空的行） */
|
||
$coreSeen = [];
|
||
$chunks = array_chunk(array_keys($cores), $chunkSize);
|
||
$totalChunks = count($chunks);
|
||
|
||
foreach ($chunks as $index => $chunk) {
|
||
$in = implode(',', array_map(static fn (string $no): string => "'" . str_replace("'", "''", $no) . "'", $chunk));
|
||
|
||
try {
|
||
$rows = $upstream->select(
|
||
"SELECT sourceno, shop_name, sales_amount, goods_count FROM rpt.dws_sn_sales_full_info_di
|
||
WHERE sourceno IN ({$in}) AND stat_date >= '{$dwsFrom}' AND stat_date < '{$dwsTo}'"
|
||
);
|
||
} catch (Throwable $exception) {
|
||
$this->error('订单侧查询失败（第 ' . ($index + 1) . ' 批）：' . $exception->getMessage());
|
||
|
||
return self::FAILURE;
|
||
}
|
||
|
||
foreach ($rows as $row) {
|
||
$core = self::cleanOrderNo((string) $row['sourceno']);
|
||
if ($core === '') {
|
||
continue;
|
||
}
|
||
$shopKey = self::normalizeShop((string) ($row['shop_name'] ?? ''));
|
||
$key = $shopKey . '|' . $core;
|
||
$orderSeen[$key] = true;
|
||
$coreSeen[$core] = true;
|
||
if ($shopKey !== '') {
|
||
$coresByCore[$core][$shopKey] = true;
|
||
}
|
||
if ((int) ($row['goods_count'] ?? 0) <= 0) {
|
||
// 退款/冲减/0 元赠品行不计入商品金额，差额列另行体现。
|
||
continue;
|
||
}
|
||
$orderAmount[$key] = ($orderAmount[$key] ?? 0.0) + (float) $row['sales_amount'];
|
||
}
|
||
|
||
if (($index + 1) % 10 === 0 || $index + 1 === $totalChunks) {
|
||
$this->info(sprintf('订单侧进度 %d/%d 批', $index + 1, $totalChunks));
|
||
}
|
||
}
|
||
|
||
// 只重建「本账期 + 本平台」的数据，避免把同月其它平台的结果一起清掉。
|
||
DB::connection($connection)->table(self::TARGET_TABLE)
|
||
->where('report_month', $reportMonth)
|
||
->where('platform', (string) $source['label'])
|
||
->delete();
|
||
|
||
$target = DB::connection($connection)->table(self::TARGET_TABLE);
|
||
$now = now();
|
||
$buffer = [];
|
||
$imported = 0;
|
||
$stats = ['已匹配' => 0, '未匹配' => 0, '一单多笔' => 0];
|
||
$remarked = [];
|
||
$goodsTotal = 0.0;
|
||
$differenceTotal = 0.0;
|
||
|
||
foreach ($groups as $group) {
|
||
$core = (string) $group['order_core_no'];
|
||
$income = round((float) $group['income_amount'], 2);
|
||
$remark = '';
|
||
$productAmount = null;
|
||
$status = self::STATUS_UNMATCHED;
|
||
|
||
if ($core === '') {
|
||
$remark = self::REMARK_EMPTY_NO;
|
||
} elseif (preg_match('/^\d{8,}$/', $core) !== 1) {
|
||
$remark = self::REMARK_BAD_FORMAT;
|
||
} else {
|
||
$exactKey = $group['shop_key'] . '|' . $core;
|
||
if (isset($orderSeen[$exactKey])) {
|
||
if (isset($orderAmount[$exactKey])) {
|
||
$status = self::STATUS_MATCHED;
|
||
$productAmount = round((float) $orderAmount[$exactKey], 2);
|
||
if (count($coresByCore[$core] ?? []) > 1) {
|
||
$remark = self::REMARK_DUP_ORDER;
|
||
}
|
||
} else {
|
||
// 订单侧有记录，但全是 0 元/退款行：没有商品金额可比对。
|
||
$remark = self::REMARK_NO_AMOUNT;
|
||
}
|
||
} elseif (isset($coreSeen[$core]) && count($coresByCore[$core] ?? []) === 1) {
|
||
// 单号一致但店铺名称对不上：仍然带上金额，标注「店铺不一致」便于复核。
|
||
$onlyShop = array_key_first($coresByCore[$core]);
|
||
$otherKey = $onlyShop . '|' . $core;
|
||
if (isset($orderAmount[$otherKey])) {
|
||
$status = self::STATUS_MATCHED;
|
||
$productAmount = round((float) $orderAmount[$otherKey], 2);
|
||
$remark = self::REMARK_SHOP_DIFF;
|
||
} else {
|
||
$remark = self::REMARK_NO_AMOUNT;
|
||
}
|
||
} elseif (isset($coreSeen[$core]) && count($coresByCore[$core] ?? []) > 1) {
|
||
$sum = 0.0;
|
||
$hasAmount = false;
|
||
foreach (array_keys($coresByCore[$core]) as $shopKey) {
|
||
$key2 = $shopKey . '|' . $core;
|
||
if (isset($orderAmount[$key2])) {
|
||
$sum += (float) $orderAmount[$key2];
|
||
$hasAmount = true;
|
||
}
|
||
}
|
||
if ($hasAmount) {
|
||
$status = self::STATUS_MATCHED;
|
||
$productAmount = round($sum, 2);
|
||
$remark = self::REMARK_DUP_ORDER;
|
||
} else {
|
||
$remark = self::REMARK_NO_AMOUNT;
|
||
}
|
||
} elseif (isset($coreSeen[$core])) {
|
||
// 订单侧只有店铺名为空的记录：按订单号兜底匹配。
|
||
$blankKey = '|' . $core;
|
||
if (isset($orderAmount[$blankKey])) {
|
||
$status = self::STATUS_MATCHED;
|
||
$productAmount = round((float) $orderAmount[$blankKey], 2);
|
||
} else {
|
||
$remark = self::REMARK_NO_AMOUNT;
|
||
}
|
||
} else {
|
||
$remark = self::REMARK_NO_ORDER;
|
||
}
|
||
}
|
||
|
||
if ($status === self::STATUS_MATCHED && (int) $group['payment_count'] > 1 && $remark === '') {
|
||
$remark = self::REMARK_MULTI_PAY;
|
||
}
|
||
|
||
// 差额口径：（收入金额 + 优惠金额 + 冲减金额）− 订单侧商品金额。
|
||
// 优惠/冲减属于同一订单的账单，把它们加回来，差额才只反映真正对不上的部分。
|
||
$promoAmount = round((float) ($group['discount_amount'] ?? 0.0) + (float) ($group['offset_amount'] ?? 0.0), 2);
|
||
$difference = $productAmount === null ? null : round($income + $promoAmount - $productAmount, 2);
|
||
if ($productAmount !== null) {
|
||
$goodsTotal += $productAmount;
|
||
$differenceTotal += (float) $difference;
|
||
}
|
||
|
||
$stats[$status] = ($stats[$status] ?? 0) + 1;
|
||
if ((int) $group['payment_count'] > 1) {
|
||
$stats['一单多笔']++;
|
||
}
|
||
if ($remark !== '') {
|
||
$remarked[$remark] = ($remarked[$remark] ?? 0) + 1;
|
||
}
|
||
|
||
$buffer[] = [
|
||
'report_month' => $reportMonth,
|
||
'platform' => $group['platform'],
|
||
'row_key' => md5($reportMonth . '|' . $group['platform'] . '|' . $group['shop_key'] . '|' . $core),
|
||
'occurred_date' => $group['occurred_date'],
|
||
'store_name' => $group['store_name'],
|
||
'online_order_no' => $group['online_order_no'] !== '' ? $group['online_order_no'] : null,
|
||
'order_core_no' => $core !== '' ? $core : null,
|
||
'payment_count' => (int) $group['payment_count'],
|
||
'income_amount' => $income,
|
||
'discount_amount' => ! empty($group['discount_seen']) ? round((float) $group['discount_amount'], 2) : null,
|
||
'offset_amount' => ! empty($group['offset_seen']) ? round((float) $group['offset_amount'], 2) : null,
|
||
'product_amount' => $productAmount,
|
||
'difference' => $difference,
|
||
'match_status' => $status,
|
||
'remark' => $remark !== '' ? $remark : null,
|
||
'imported_at' => $now,
|
||
];
|
||
|
||
if (count($buffer) >= 500) {
|
||
$target->insertOrIgnore($buffer);
|
||
$imported += count($buffer);
|
||
$buffer = [];
|
||
}
|
||
}
|
||
|
||
if ($buffer !== []) {
|
||
$target->insertOrIgnore($buffer);
|
||
$imported += count($buffer);
|
||
}
|
||
|
||
$this->info('写入完成，共 ' . $imported . ' 行（账单收款 ' . $paymentTotal . ' 笔）。');
|
||
foreach ($stats as $status => $count) {
|
||
$this->line(' ' . $status . '：' . $count);
|
||
}
|
||
foreach ($remarked as $remark => $count) {
|
||
$this->line(' 标注 ' . $remark . '：' . $count);
|
||
}
|
||
$this->line(' 账单收入合计：' . number_format($incomeTotal, 2));
|
||
$this->line(' 订单侧商品金额合计：' . number_format($goodsTotal, 2));
|
||
$this->line(' 差额合计：' . number_format($differenceTotal, 2));
|
||
|
||
return self::SUCCESS;
|
||
}
|
||
|
||
/**
|
||
* 只回填「优惠金额 / 冲减金额」两列：不重建业绩明细、不查订单侧，
|
||
* 先清空该账期该平台的两列，再按 row_key 更新镜像里已存在的行。
|
||
*
|
||
* @param array<string,mixed> $source
|
||
* @param array<string,array<string,mixed>> $groups
|
||
*/
|
||
private function backfillPromoAmounts(string $month, array $source, array $groups, string $reportMonth): int
|
||
{
|
||
$connection = (string) config('upstream_mirrors.connection', 'business_mirror');
|
||
$platform = (string) $source['label'];
|
||
$target = static fn () => DB::connection($connection)->table(self::TARGET_TABLE);
|
||
|
||
$existing = $target()
|
||
->where('report_month', $reportMonth)
|
||
->where('platform', $platform)
|
||
->pluck('row_key')
|
||
->flip()
|
||
->all();
|
||
|
||
$target()
|
||
->where('report_month', $reportMonth)
|
||
->where('platform', $platform)
|
||
->update(['discount_amount' => null, 'offset_amount' => null]);
|
||
|
||
$discounts = [];
|
||
$offsets = [];
|
||
foreach ($groups as $group) {
|
||
if (empty($group['discount_seen']) && empty($group['offset_seen'])) {
|
||
continue;
|
||
}
|
||
|
||
$rowKey = md5($reportMonth . '|' . $platform . '|' . $group['shop_key'] . '|' . $group['order_core_no']);
|
||
if (! isset($existing[$rowKey])) {
|
||
continue;
|
||
}
|
||
|
||
if (! empty($group['discount_seen'])) {
|
||
$discounts[$rowKey] = round((float) $group['discount_amount'], 2);
|
||
}
|
||
if (! empty($group['offset_seen'])) {
|
||
$offsets[$rowKey] = round((float) $group['offset_amount'], 2);
|
||
}
|
||
}
|
||
|
||
$this->updateAmountColumn($connection, $reportMonth, 'discount_amount', $discounts);
|
||
$this->updateAmountColumn($connection, $reportMonth, 'offset_amount', $offsets);
|
||
|
||
$this->info(sprintf(
|
||
'已回填 %s %s：优惠 %d 行（%s）/ 冲减 %d 行（%s），镜像原有 %d 行，未重建业绩明细。',
|
||
$month,
|
||
$platform,
|
||
count($discounts),
|
||
number_format(array_sum($discounts), 2),
|
||
count($offsets),
|
||
number_format(array_sum($offsets), 2),
|
||
count($existing),
|
||
));
|
||
|
||
return self::SUCCESS;
|
||
}
|
||
|
||
/**
|
||
* 按 row_key 批量更新一列金额：只更新镜像里已有的行，不做插入。
|
||
*
|
||
* @param array<string,float> $values row_key => 金额
|
||
*/
|
||
private function updateAmountColumn(string $connection, string $reportMonth, string $column, array $values): void
|
||
{
|
||
if ($values === []) {
|
||
return;
|
||
}
|
||
|
||
foreach (array_chunk($values, 500, true) as $chunk) {
|
||
$cases = '';
|
||
$bindings = [];
|
||
foreach ($chunk as $rowKey => $amount) {
|
||
$cases .= ' WHEN ? THEN ?';
|
||
$bindings[] = (string) $rowKey;
|
||
$bindings[] = $amount;
|
||
}
|
||
|
||
$bindings[] = $reportMonth;
|
||
$bindings = array_merge($bindings, array_map('strval', array_keys($chunk)));
|
||
$placeholders = implode(',', array_fill(0, count($chunk), '?'));
|
||
|
||
DB::connection($connection)->update(
|
||
sprintf(
|
||
'update %s set %s = case row_key%s end where report_month = ? and row_key in (%s)',
|
||
self::TARGET_TABLE,
|
||
$column,
|
||
$cases,
|
||
$placeholders,
|
||
),
|
||
$bindings,
|
||
);
|
||
}
|
||
}
|
||
|
||
/** 单号清洗：去掉日期前缀（如 260630-）、空格、横杠，得到核心号。 */
|
||
public static function cleanOrderNo(string $value): string
|
||
{
|
||
$value = str_replace("\u{3000}", ' ', trim($value));
|
||
if ($value === '') {
|
||
return '';
|
||
}
|
||
|
||
// 日期前缀形如「260630-」：只有明确带 6 位数字 + 横杠时才去除，
|
||
// 避免误伤本身就是纯数字的订单号（如 5126322747312081812）。
|
||
if (preg_match('/^\d{6}\s*[-\x{FF0D}\x{2014}\x{2013}\x{2010}]/u', $value) === 1) {
|
||
$value = preg_replace('/^\d{6}\s*[-\x{FF0D}\x{2014}\x{2013}\x{2010}]/u', '', $value) ?? $value;
|
||
}
|
||
|
||
$value = preg_replace('/[\s\-\x{FF0D}\x{2014}\x{2013}\x{2010}]+/u', '', $value) ?? '';
|
||
|
||
return strtoupper($value);
|
||
}
|
||
|
||
/**
|
||
* 科目映射表里「财务备注命中给定备注」的账单项目（限本页签涉及的平台）。
|
||
*
|
||
* @param list<string> $remarks
|
||
* @return list<string>
|
||
*/
|
||
private function accountMappingItems(string $tab, array $remarks): array
|
||
{
|
||
$map = app(AccountLedgerRemarkMap::class);
|
||
$platforms = $map->platformsForTab($tab);
|
||
$items = [];
|
||
|
||
foreach (app(AccountMappingStore::class)->all() as $rule) {
|
||
if (! is_array($rule)) {
|
||
continue;
|
||
}
|
||
$platform = trim((string) ($rule['platform'] ?? ''));
|
||
$item = trim((string) ($rule['item'] ?? ''));
|
||
$memo = trim((string) ($rule['memo'] ?? ''));
|
||
if ($platform === '' || $item === '' || ! in_array($platform, $platforms, true)) {
|
||
continue;
|
||
}
|
||
if (! in_array($memo, $remarks, true)) {
|
||
continue;
|
||
}
|
||
$items[$item] = true;
|
||
}
|
||
|
||
$list = array_keys($items);
|
||
sort($list);
|
||
|
||
return $list;
|
||
}
|
||
|
||
/**
|
||
* 账单项目名的「wx」前缀变体：科目映射表用不带前缀的名字，
|
||
* 微信账户页签的账单带前缀（反之亦然），两种写法都纳入候选。
|
||
*
|
||
* @param list<string> $items
|
||
* @return list<string>
|
||
*/
|
||
private function withWxVariants(array $items): array
|
||
{
|
||
$candidates = [];
|
||
foreach ($items as $item) {
|
||
$item = trim((string) $item);
|
||
if ($item === '') {
|
||
continue;
|
||
}
|
||
$candidates[$item] = true;
|
||
if (stripos($item, 'wx') === 0) {
|
||
$stripped = ltrim(mb_substr($item, 2));
|
||
if ($stripped !== '') {
|
||
$candidates[$stripped] = true;
|
||
}
|
||
} else {
|
||
$candidates['wx' . $item] = true;
|
||
}
|
||
}
|
||
|
||
$list = array_keys($candidates);
|
||
sort($list);
|
||
|
||
return $list;
|
||
}
|
||
|
||
/**
|
||
* 「总账备注」集合 → 平台分组条件（复用账单页同一份映射与翻译）。
|
||
*
|
||
* @param list<string>|null $remarks 为空时取收入白名单（LEDGER_REMARKS）
|
||
* @return list<array<string,mixed>>
|
||
*/
|
||
private function ledgerRemarkGroups(string $tab, ?array $remarks = null): array
|
||
{
|
||
$map = app(AccountLedgerRemarkMap::class);
|
||
$groups = [];
|
||
$seen = [];
|
||
|
||
foreach ($remarks ?? self::LEDGER_REMARKS as $remark) {
|
||
foreach ($map->billItemGroupsForTab($tab, $remark) as $group) {
|
||
$key = (string) ($group['platform'] ?? '') . '|' . implode(',', (array) ($group['items'] ?? []));
|
||
if (isset($seen[$key])) {
|
||
continue;
|
||
}
|
||
$seen[$key] = true;
|
||
$groups[] = $group;
|
||
}
|
||
}
|
||
|
||
return $groups;
|
||
}
|
||
|
||
/** 店铺名归一：下划线视为横杠，去掉空白。 */
|
||
public static function normalizeShop(string $value): string
|
||
{
|
||
$value = str_replace(["\u{3000}", '_'], [' ', '-'], trim($value));
|
||
$value = preg_replace('/\s+/', '', $value) ?? '';
|
||
|
||
return strtoupper($value);
|
||
}
|
||
}
|