CaiWuXiTong/app/Business/KukaPostingBase/KukaPostingMaterialRepairImporter.php
chenxi a1783bf0eb feat(顾家过账): 支持按整表物料源修正发货明细 (#1271)
整表物料源逐行修正有效物料、成本和发货金额,#N/A 行保持原样,页面优先使用修正物料。

验证:导入器 5 个测试、53 条断言;页面 9 个测试、112 条断言;生产审计 8,837 行有效、5,112 行 #N/A。
2026-11-19 15:32:05 +08:00

1035 lines
35 KiB
PHP

<?php
namespace App\Business\KukaPostingBase;
use App\Business\XlsxSheetReader;
use Illuminate\Database\ConnectionInterface;
use Illuminate\Database\DatabaseManager;
use Illuminate\Support\Facades\Schema;
use InvalidArgumentException;
use RuntimeException;
class KukaPostingMaterialRepairImporter
{
private const IDENTITY_FIELDS = [
'发货日期',
'线上订单号',
'商品编码',
'订单状态',
'发货仓',
'店铺',
'款式编码',
'实发数量',
'过账标签',
];
private const MATERIAL_NUMBER_FIELD = '物料编号';
private const MATERIAL_DESCRIPTION_SOURCE_FIELD = '物料描述';
private const MATERIAL_DESCRIPTION_DATABASE_FIELD = '型号';
private const COST_FIELD = '成本';
private const SHIPPING_AMOUNT_FIELD = '发货金额';
private const REPAIR_MARKER_FIELD = '物料信息修正';
private const MISSING_VALUES = ['', '—', '-'];
private const UPDATE_CHUNK = 500;
public function __construct(
private readonly DatabaseManager $databases,
private readonly XlsxSheetReader $reader,
) {
}
/**
* @return array{
* period: string,
* dry_run: bool,
* rows: int,
* valid_rows: int,
* skipped_unmapped_rows: int,
* materials: int,
* stores: array<string, int>,
* updated: int,
* unchanged: int,
* file_sha256: string
* }
*/
public function importSource(
string $mappingPath,
string $period,
?string $sheetName = null,
int $companyId = 1,
bool $dryRun = false,
): array {
if (preg_match('/^\d{4}-(0[1-9]|1[0-2])$/', $period) !== 1) {
throw new InvalidArgumentException('账期格式必须为 YYYY-MM。');
}
if (! is_file($mappingPath) || ! is_readable($mappingPath)) {
throw new InvalidArgumentException('物料源文件不存在或不可读:' . $mappingPath);
}
$connection = $this->connection();
if (! Schema::connection($this->connectionName())->hasTable('kuka_posting_base_rows')) {
throw new RuntimeException('顾家过账基础数据表尚未建立,请先执行数据库迁移。');
}
$allowedStores = array_values(array_filter(array_map(
static fn (mixed $store): string => trim((string) $store),
(array) config('kuka_posting.stores', []),
)));
if ($allowedStores === []) {
throw new RuntimeException('顾家过账基础数据店铺范围未配置。');
}
$sheetName = trim((string) ($sheetName ?? ''));
if ($sheetName === '') {
$sheetName = 'Sheet1';
}
$fileHash = hash_file('sha256', $mappingPath);
if (! is_string($fileHash)) {
throw new RuntimeException('无法计算物料源文件摘要。');
}
$sourceRows = $this->readSourceRows($mappingPath, $sheetName, $allowedStores);
$validMaterials = [];
foreach ($sourceRows as $row) {
if ($row['material_number'] !== '') {
$validMaterials[$row['material_number']] = true;
}
}
$quotations = $this->loadQuotations(
$connection,
$companyId,
array_keys($validMaterials),
);
if ($dryRun) {
$collected = $this->collectSourceTargets(
$connection,
$sourceRows,
$quotations,
$period,
$companyId,
false,
);
$result = $collected['result'];
} else {
$result = [];
$connection->transaction(function () use (
&$result,
$connection,
$sourceRows,
$quotations,
$period,
$companyId,
): void {
$targets = $this->collectSourceTargets(
$connection,
$sourceRows,
$quotations,
$period,
$companyId,
true,
);
$result = $targets['result'];
$this->applyMaterials($connection, $targets['targets'], $period, $companyId);
});
}
return $result + [
'period' => $period,
'dry_run' => $dryRun,
'file_sha256' => strtolower($fileHash),
];
}
/**
* @return array{
* period: string,
* dry_run: bool,
* rows: int,
* identities: int,
* material_pairs: int,
* stores: array<string, int>,
* updated: int,
* unchanged: int,
* abnormal_file_sha256: string,
* mapping_file_sha256: string
* }
*/
public function import(
string $abnormalPath,
string $mappingPath,
string $period,
?string $sheetName = null,
int $companyId = 1,
bool $dryRun = false,
): array {
if (preg_match('/^\d{4}-(0[1-9]|1[0-2])$/', $period) !== 1) {
throw new InvalidArgumentException('账期格式必须为 YYYY-MM。');
}
foreach ([$abnormalPath, $mappingPath] as $path) {
if (! is_file($path) || ! is_readable($path)) {
throw new InvalidArgumentException('物料修正文件不存在或不可读:' . $path);
}
}
$connection = $this->connection();
if (! Schema::connection($this->connectionName())->hasTable('kuka_posting_base_rows')) {
throw new RuntimeException('顾家过账基础数据表尚未建立,请先执行数据库迁移。');
}
$allowedStores = array_values(array_filter(array_map(
static fn (mixed $store): string => trim((string) $store),
(array) config('kuka_posting.stores', []),
)));
if ($allowedStores === []) {
throw new RuntimeException('顾家过账基础数据店铺范围未配置。');
}
$sheetName = trim((string) ($sheetName ?? ''));
if ($sheetName === '') {
$sheetName = 'Sheet1';
}
$abnormalHash = hash_file('sha256', $abnormalPath);
$mappingHash = hash_file('sha256', $mappingPath);
if (! is_string($abnormalHash) || ! is_string($mappingHash)) {
throw new RuntimeException('无法计算物料修正文件摘要。');
}
$materials = $this->readMaterialMapping($mappingPath, $sheetName);
$records = $this->readAbnormalRows(
$abnormalPath,
$sheetName,
$materials,
$allowedStores,
);
$quotations = $this->loadQuotations(
$connection,
$companyId,
array_values(array_unique(array_column($records, 'material_number'))),
);
if ($dryRun) {
$collected = $this->collectTargets(
$connection,
$records,
$quotations,
$period,
$companyId,
false,
);
$result = $collected['result'];
} else {
$result = [];
$connection->transaction(function () use (
&$result,
$connection,
$records,
$quotations,
$period,
$companyId,
): void {
$targets = $this->collectTargets(
$connection,
$records,
$quotations,
$period,
$companyId,
true,
);
$result = $targets['result'];
$this->applyMaterials($connection, $targets['targets'], $period, $companyId);
});
}
return $result + [
'period' => $period,
'dry_run' => $dryRun,
'abnormal_file_sha256' => strtolower($abnormalHash),
'mapping_file_sha256' => strtolower($mappingHash),
];
}
/**
* @return array<string, array{material_number: string, description: string}>
*/
private function readMaterialMapping(string $path, string $sheetName): array
{
$materials = [];
$rows = 0;
foreach ($this->reader->rows(
$path,
array_merge(self::IDENTITY_FIELDS, [
self::MATERIAL_NUMBER_FIELD,
self::MATERIAL_DESCRIPTION_SOURCE_FIELD,
]),
[],
$sheetName,
) as $values) {
$rows++;
$materialNumber = trim((string) ($values[self::MATERIAL_NUMBER_FIELD] ?? ''));
$description = trim((string) ($values[self::MATERIAL_DESCRIPTION_SOURCE_FIELD] ?? ''));
if ($this->isMissingMaterialValue($materialNumber)
|| $this->isMissingMaterialValue($description)) {
throw new RuntimeException(sprintf(
'表二第 %d 行的物料编号或物料描述为空。',
$rows + 1,
));
}
$key = $this->identityKey($values);
$pair = [
'material_number' => $materialNumber,
'description' => $description,
];
if (isset($materials[$key]) && $materials[$key] !== $pair) {
throw new RuntimeException(sprintf(
'表二第 %d 行对应的业务记录存在多个物料编号/物料描述组合。',
$rows + 1,
));
}
$materials[$key] = $pair;
}
if ($materials === []) {
throw new RuntimeException('表二没有可用于匹配的物料数据。');
}
return $materials;
}
/**
* @param array<string, array{material_number: string, description: string}> $materials
* @param list<string> $allowedStores
* @return list<array{excel_row_number: int, key: string, material_number: string, description: string}>
*/
private function readAbnormalRows(
string $path,
string $sheetName,
array $materials,
array $allowedStores,
): array {
$records = [];
$excelRowNumber = 1;
foreach ($this->reader->rows(
$path,
array_merge(self::IDENTITY_FIELDS, [
self::MATERIAL_NUMBER_FIELD,
self::MATERIAL_DESCRIPTION_SOURCE_FIELD,
]),
[],
$sheetName,
) as $values) {
$excelRowNumber++;
$currentMaterial = trim((string) ($values[self::MATERIAL_NUMBER_FIELD] ?? ''));
$currentDescription = trim((string) (
$values[self::MATERIAL_DESCRIPTION_SOURCE_FIELD] ?? ''
));
if (! $this->isMissingMaterialValue($currentMaterial)
|| ! $this->isMissingMaterialValue($currentDescription)) {
throw new RuntimeException(sprintf(
'表一第 %d 行不是缺少物料信息的异常数据。',
$excelRowNumber,
));
}
$store = trim((string) ($values['店铺'] ?? ''));
if (! in_array($store, $allowedStores, true)) {
throw new RuntimeException(sprintf(
'表一第 %d 行的店铺“%s”不在顾家过账基础数据范围内。',
$excelRowNumber,
$store,
));
}
$key = $this->identityKey($values);
$material = $materials[$key] ?? null;
if ($material === null) {
throw new RuntimeException(sprintf(
'表一第 %d 行在表二中找不到唯一物料信息。',
$excelRowNumber,
));
}
$records[] = [
'excel_row_number' => $excelRowNumber,
'key' => $key,
'material_number' => $material['material_number'],
'description' => $material['description'],
];
}
if ($records === []) {
throw new RuntimeException('表一没有可修正的异常数据。');
}
return $records;
}
/**
* @param list<string> $allowedStores
* @return list<array{
* excel_row_number: int,
* key: string,
* quantity: string,
* material_number: string,
* description: string
* }>
*/
private function readSourceRows(
string $path,
string $sheetName,
array $allowedStores,
): array {
$records = [];
$excelRowNumber = 1;
foreach ($this->reader->rows(
$path,
array_merge(self::IDENTITY_FIELDS, [
self::MATERIAL_NUMBER_FIELD,
self::MATERIAL_DESCRIPTION_SOURCE_FIELD,
]),
[],
$sheetName,
) as $values) {
$excelRowNumber++;
$store = trim((string) ($values['店铺'] ?? ''));
if (! in_array($store, $allowedStores, true)) {
throw new RuntimeException(sprintf(
'表二第 %d 行的店铺“%s”不在顾家过账基础数据范围内。',
$excelRowNumber,
$store,
));
}
$quantity = $this->normalizeDecimal($values['实发数量'] ?? '');
if ($quantity === null) {
throw new RuntimeException(sprintf(
'表二第 %d 行的实发数量格式无效。',
$excelRowNumber,
));
}
if ($quantity === '') {
$quantity = '0';
}
$materialNumber = trim((string) ($values[self::MATERIAL_NUMBER_FIELD] ?? ''));
$description = trim((string) (
$values[self::MATERIAL_DESCRIPTION_SOURCE_FIELD] ?? ''
));
$materialMissing = $this->isUnmappedMaterialValue($materialNumber);
$descriptionMissing = $this->isUnmappedMaterialValue($description);
if ($materialMissing !== $descriptionMissing) {
throw new RuntimeException(sprintf(
'表二第 %d 行的物料编号和物料描述一个有效、一个无效。',
$excelRowNumber,
));
}
if ($materialMissing) {
$materialNumber = '';
$description = '';
}
$records[] = [
'excel_row_number' => $excelRowNumber,
'key' => $this->sourceIdentityKey($values, $quantity),
'quantity' => $quantity,
'material_number' => $materialNumber,
'description' => $description,
];
}
if ($records === []) {
throw new RuntimeException('表二没有发货明细数据。');
}
return $records;
}
/**
* @param list<array{
* excel_row_number: int,
* key: string,
* quantity: string,
* material_number: string,
* description: string
* }> $sourceRows
* @param array<string, array{price: string, description: string}> $quotations
* @return array{
* result: array{
* rows: int,
* valid_rows: int,
* skipped_unmapped_rows: int,
* materials: int,
* stores: array<string, int>,
* updated: int,
* unchanged: int
* },
* targets: list<array<string, mixed>>
* }
*/
private function collectSourceTargets(
ConnectionInterface $connection,
array $sourceRows,
array $quotations,
string $period,
int $companyId,
bool $lockRows,
): array {
$databaseRows = $this->baseRowsQuery($connection, $period, $companyId)->count();
if ($databaseRows !== count($sourceRows)) {
throw new RuntimeException(sprintf(
'表二有 %s 行,但共享镜像 %s 有 %s 行,行数不一致,未写入任何物料信息。',
number_format(count($sourceRows)),
$period,
number_format($databaseRows),
));
}
$query = $this->baseRowsQuery($connection, $period, $companyId)
->orderBy('source_row_number');
if ($lockRows) {
$query->lockForUpdate();
}
$targets = [];
$stores = [];
$materials = [];
$updated = 0;
$unchanged = 0;
$validRows = 0;
$skippedRows = 0;
$index = 0;
foreach ($query->cursor() as $row) {
$source = $sourceRows[$index] ?? null;
if ($source === null) {
throw new RuntimeException('共享镜像行数多于表二,未写入任何物料信息。');
}
$values = $this->decodeSourceValues($row);
$databaseQuantity = $this->normalizeDecimal($values['实发数量'] ?? '');
$databaseQuantity = $databaseQuantity === null || $databaseQuantity === ''
? '0'
: $databaseQuantity;
if ($this->sourceIdentityKey($values, $databaseQuantity) !== $source['key']) {
throw new RuntimeException(sprintf(
'表二第 %d 行与共享镜像 source_row_number=%d 的业务字段不一致,未写入任何物料信息。',
$source['excel_row_number'],
(int) $row->source_row_number,
));
}
$index++;
if ($source['material_number'] === '') {
$skippedRows++;
continue;
}
$validRows++;
$materials[$source['material_number']] = true;
$quote = $quotations[$source['material_number']];
$expectedCost = $quote['price'];
$expectedAmount = $this->multiplyDecimal($expectedCost, $source['quantity']);
$currentMaterial = trim((string) (
$values[self::MATERIAL_NUMBER_FIELD] ?? ''
));
$currentDescription = trim((string) (
$values[self::MATERIAL_DESCRIPTION_DATABASE_FIELD] ?? ''
));
$currentCost = trim((string) ($values[self::COST_FIELD] ?? ''));
$currentAmount = trim((string) (
$values[self::SHIPPING_AMOUNT_FIELD] ?? ''
));
$isMarked = trim((string) ($values[self::REPAIR_MARKER_FIELD] ?? '')) === '是';
$materialMatches = $currentMaterial === $source['material_number']
&& $currentDescription === $source['description'];
$financialMatches = $this->decimalEquals($currentCost, $expectedCost)
&& $this->decimalEquals($currentAmount, $expectedAmount);
$changed = ! $materialMatches || ! $isMarked || ! $financialMatches;
$store = $source['material_number'] === ''
? ''
: trim((string) ($values['店铺'] ?? ''));
if ($store !== '') {
$stores[$store] = ($stores[$store] ?? 0) + 1;
}
if ($changed) {
$updated++;
} else {
$unchanged++;
}
$targets[] = [
'row' => $row,
'values' => $values,
'material_number' => $source['material_number'],
'description' => $source['description'],
'cost' => $expectedCost,
'shipping_amount' => $expectedAmount,
'changed' => $changed,
];
}
if ($index !== count($sourceRows)) {
throw new RuntimeException('共享镜像行数少于表二,未写入任何物料信息。');
}
ksort($stores);
return [
'result' => [
'rows' => count($sourceRows),
'valid_rows' => $validRows,
'skipped_unmapped_rows' => $skippedRows,
'materials' => count($materials),
'stores' => $stores,
'updated' => $updated,
'unchanged' => $unchanged,
],
'targets' => $targets,
];
}
/**
* @param list<string> $materialNumbers
* @return array<string, array{price: string, description: string}>
*/
private function loadQuotations(
ConnectionInterface $connection,
int $companyId,
array $materialNumbers,
): array {
if (! Schema::connection($this->connectionName())->hasTable('kuka_posting_quotation_rows')) {
throw new RuntimeException('顾家报价单表尚未建立,无法计算成本和发货金额。');
}
$quotations = [];
$rows = $connection->table('kuka_posting_quotation_rows')
->where('company_id', $companyId)
->where('record_status', '生效')
->whereIn('material_number', $materialNumbers)
->orderBy('material_number')
->get(['material_number', 'material_desc', 'price_including_tax']);
foreach ($rows as $row) {
$materialNumber = trim((string) $row->material_number);
if (isset($quotations[$materialNumber])) {
throw new RuntimeException(sprintf(
'物料编号 %s 存在多条生效报价,无法确定唯一成本。',
$materialNumber,
));
}
$price = $this->normalizeDecimal($row->price_including_tax);
if ($price === null) {
throw new RuntimeException(sprintf(
'物料编号 %s 的生效报价含税价为空或格式无效。',
$materialNumber,
));
}
$price = $this->formatDecimal($price);
$quotations[$materialNumber] = [
'price' => $price,
'description' => trim((string) ($row->material_desc ?? '')),
];
}
foreach ($materialNumbers as $materialNumber) {
if (! isset($quotations[$materialNumber])) {
throw new RuntimeException(sprintf(
'物料编号 %s 没有生效报价,无法计算成本和发货金额。',
$materialNumber,
));
}
}
return $quotations;
}
/**
* @param list<array{excel_row_number: int, key: string, material_number: string, description: string}> $records
* @param array<string, array{price: string, description: string}> $quotations
* @return array{
* result: array{
* rows: int,
* identities: int,
* material_pairs: int,
* stores: array<string, int>,
* updated: int,
* unchanged: int
* },
* targets: list<array<string, mixed>>
* }
*/
private function collectTargets(
ConnectionInterface $connection,
array $records,
array $quotations,
string $period,
int $companyId,
bool $lockRows,
): array {
$expectedCounts = [];
$expectedMaterials = [];
$pairs = [];
foreach ($records as $record) {
$expectedCounts[$record['key']] = ($expectedCounts[$record['key']] ?? 0) + 1;
$expectedMaterials[$record['key']] = [
'material_number' => $record['material_number'],
'description' => $record['description'],
];
$pairs[$record['material_number']."\x1F".$record['description']] = true;
}
$foundCounts = [];
$targets = [];
$stores = [];
$updated = 0;
$unchanged = 0;
$query = $this->baseRowsQuery($connection, $period, $companyId)
->orderBy('source_row_number');
if ($lockRows) {
$query->lockForUpdate();
}
foreach ($query->cursor() as $row) {
$values = $this->decodeSourceValues($row);
$key = $this->identityKey($values);
if (! isset($expectedCounts[$key])) {
continue;
}
$foundCounts[$key] = ($foundCounts[$key] ?? 0) + 1;
if ($foundCounts[$key] > $expectedCounts[$key]) {
throw new RuntimeException(
'共享镜像中同一业务记录出现多条与异常清单不匹配的数据,未写入任何物料信息。',
);
}
$currentMaterial = trim((string) ($values[self::MATERIAL_NUMBER_FIELD] ?? ''));
$currentDescription = trim((string) (
$values[self::MATERIAL_DESCRIPTION_DATABASE_FIELD] ?? ''
));
$currentCost = trim((string) ($values[self::COST_FIELD] ?? ''));
$currentAmount = trim((string) ($values[self::SHIPPING_AMOUNT_FIELD] ?? ''));
$isMarked = trim((string) ($values[self::REPAIR_MARKER_FIELD] ?? '')) === '是';
$expected = $expectedMaterials[$key];
$currentIsBlank = $this->isMissingMaterialValue($currentMaterial)
&& $this->isMissingMaterialValue($currentDescription);
$currentMatches = $currentMaterial === $expected['material_number']
&& $currentDescription === $expected['description'];
if (! $currentIsBlank && ! $currentMatches) {
throw new RuntimeException(sprintf(
'共享镜像 source_row_number=%d 已有不同物料信息,拒绝覆盖。',
(int) $row->source_row_number,
));
}
$quotation = $quotations[$expected['material_number']];
$quantity = $this->normalizeDecimal($values['实发数量'] ?? null);
if ($quantity === null) {
throw new RuntimeException(sprintf(
'共享镜像 source_row_number=%d 的实发数量无效,无法计算发货金额。',
(int) $row->source_row_number,
));
}
$expectedCost = $quotation['price'];
$expectedAmount = $this->multiplyDecimal($expectedCost, $quantity);
$financialMatches = $this->decimalEquals($currentCost, $expectedCost)
&& $this->decimalEquals($currentAmount, $expectedAmount);
$store = trim((string) ($values['店铺'] ?? ''));
$stores[$store] = ($stores[$store] ?? 0) + 1;
if ($currentMatches && $isMarked && $financialMatches) {
$unchanged++;
} else {
$updated++;
}
$targets[] = [
'row' => $row,
'values' => $values,
'material_number' => $expected['material_number'],
'description' => $expected['description'],
'cost' => $expectedCost,
'shipping_amount' => $expectedAmount,
'changed' => ! $currentMatches || ! $isMarked || ! $financialMatches,
];
}
foreach ($expectedCounts as $key => $expectedCount) {
if (($foundCounts[$key] ?? 0) !== $expectedCount) {
throw new RuntimeException('共享镜像与表一异常数据的逐行数量不一致,未写入任何物料信息。');
}
}
ksort($stores);
return [
'result' => [
'rows' => count($records),
'identities' => count($expectedCounts),
'material_pairs' => count($pairs),
'stores' => $stores,
'updated' => $updated,
'unchanged' => $unchanged,
],
'targets' => $targets,
];
}
/**
* @param list<array<string, mixed>> $targets
*/
private function applyMaterials(
ConnectionInterface $connection,
array $targets,
string $period,
int $companyId,
): void {
$batch = [];
$flush = static function () use (&$batch, $connection): void {
if ($batch === []) {
return;
}
$connection->table('kuka_posting_base_rows')->upsert(
$batch,
['company_id', 'period', 'source_row_number'],
['source_values', 'row_hash'],
);
$batch = [];
};
foreach ($targets as $target) {
if (! $target['changed']) {
continue;
}
$row = $target['row'];
$values = $target['values'];
$values[self::MATERIAL_NUMBER_FIELD] = $target['material_number'];
$values[self::MATERIAL_DESCRIPTION_DATABASE_FIELD] = $target['description'];
$values[self::COST_FIELD] = $target['cost'];
$values[self::SHIPPING_AMOUNT_FIELD] = $target['shipping_amount'];
$values[self::REPAIR_MARKER_FIELD] = '是';
$encoded = json_encode(
$values,
JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES | JSON_THROW_ON_ERROR,
);
$batch[] = [
'company_id' => $companyId,
'period' => $period,
'source_row_number' => (int) $row->source_row_number,
'store_name' => $row->store_name,
'internal_order_no' => $row->internal_order_no,
'online_order_no' => $row->online_order_no,
'product_code' => $row->product_code,
'source_values' => $encoded,
'row_hash' => hash('sha256', $encoded),
'imported_at' => $row->imported_at,
];
if (count($batch) >= self::UPDATE_CHUNK) {
$flush();
}
}
$flush();
}
/**
* @param array<string, mixed> $values
*/
private function identityKey(array $values): string
{
$parts = [];
foreach (self::IDENTITY_FIELDS as $field) {
$value = trim((string) ($values[$field] ?? ''));
if ($field === '发货日期') {
$value = $this->normalizeDate($value);
}
$parts[] = $value;
}
return implode("\x1F", $parts);
}
/**
* @param array<string, mixed> $values
*/
private function sourceIdentityKey(array $values, string $quantity): string
{
$parts = [];
foreach (self::IDENTITY_FIELDS as $field) {
if ($field === '实发数量') {
$parts[] = $quantity;
continue;
}
$value = trim((string) ($values[$field] ?? ''));
$parts[] = $field === '发货日期'
? $this->normalizeDateTime($value)
: $value;
}
return implode("\x1F", $parts);
}
private function normalizeDateTime(string $value): string
{
if (is_numeric($value) && (float) $value > 20000 && (float) $value < 90000) {
return gmdate('Y-m-d H:i:s', (int) round(((float) $value - 25569) * 86400));
}
if (preg_match(
'/^(\d{4})[\/-](\d{1,2})[\/-](\d{1,2})[ T](\d{1,2}):(\d{2}):(\d{2})/',
$value,
$matches,
) === 1) {
return sprintf(
'%04d-%02d-%02d %02d:%s:%s',
(int) $matches[1],
(int) $matches[2],
(int) $matches[3],
(int) $matches[4],
$matches[5],
$matches[6],
);
}
return $this->normalizeDate($value);
}
private function normalizeDate(string $value): string
{
if (is_numeric($value) && (float) $value > 20000 && (float) $value < 90000) {
return gmdate('Y-m-d', (int) round(((float) $value - 25569) * 86400));
}
if (preg_match('/^(\d{4})[\/-](\d{1,2})[\/-](\d{1,2})/', $value, $matches) === 1) {
return sprintf(
'%04d-%02d-%02d',
(int) $matches[1],
(int) $matches[2],
(int) $matches[3],
);
}
return $value;
}
private function isMissingMaterialValue(string $value): bool
{
return in_array(trim($value), self::MISSING_VALUES, true);
}
private function isUnmappedMaterialValue(string $value): bool
{
return $this->isMissingMaterialValue($value)
|| in_array(
strtoupper(trim($value)),
['#N/A', '#REF!', '#VALUE!', '#NAME?', '#NUM!'],
true,
);
}
private function normalizeDecimal(mixed $value): ?string
{
$normalized = str_replace(',', '', trim((string) $value));
return $normalized !== '' && is_numeric($normalized) ? $normalized : null;
}
private function multiplyDecimal(string $left, string $right): string
{
if (function_exists('bcmul')) {
return bcmul($left, $right, 4);
}
return number_format((float) $left * (float) $right, 4, '.', '');
}
private function formatDecimal(string $value): string
{
if (function_exists('bcadd')) {
return bcadd($value, '0', 4);
}
return number_format((float) $value, 4, '.', '');
}
private function decimalEquals(string $left, string $right): bool
{
if ($left === '' || $right === '') {
return false;
}
if (function_exists('bccomp')) {
return bccomp($left, $right, 4) === 0;
}
return abs((float) $left - (float) $right) < 0.00005;
}
/**
* @return array<string, mixed>
*/
private function decodeSourceValues(object $row): array
{
$values = json_decode(
(string) $row->source_values,
true,
512,
JSON_THROW_ON_ERROR,
);
if (! is_array($values)) {
throw new RuntimeException(sprintf(
'共享镜像 source_row_number=%d 的源数据不是有效对象。',
(int) $row->source_row_number,
));
}
return $values;
}
private function baseRowsQuery(
ConnectionInterface $connection,
string $period,
int $companyId,
) {
return $connection->table('kuka_posting_base_rows')
->where('company_id', $companyId)
->where('period', $period)
->select([
'id',
'source_row_number',
'store_name',
'internal_order_no',
'online_order_no',
'product_code',
'source_values',
'imported_at',
]);
}
private function connection(): ConnectionInterface
{
return $this->databases->connection($this->connectionName());
}
private function connectionName(): string
{
return (string) config('upstream_mirrors.connection', 'business_mirror');
}
}