CaiWuXiTong/modules/EcommerceFinance/Services/FinanceLedgerManualTransactionImporter.php
92451 ceac04e1e0 feat: 动账明细支持手工导入并拆分行操作列 (#1226)
Co-authored-by: 92451 <924518135@qq.com>
Co-committed-by: 92451 <924518135@qq.com>
2026-11-18 10:44:20 +08:00

965 lines
37 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;
use App\Utilities\FinanceLedgerIndependentAccounts;
use Carbon\CarbonImmutable;
use Illuminate\Database\ConnectionInterface;
use Illuminate\Database\DatabaseManager;
use Illuminate\Http\UploadedFile;
use Illuminate\Validation\ValidationException;
use PhpOffice\PhpSpreadsheet\Cell\Coordinate;
use PhpOffice\PhpSpreadsheet\IOFactory;
use PhpOffice\PhpSpreadsheet\Reader\IReadFilter;
use PhpOffice\PhpSpreadsheet\Shared\Date as ExcelDate;
use PhpOffice\PhpSpreadsheet\Spreadsheet;
use PhpOffice\PhpSpreadsheet\Style\Alignment;
use PhpOffice\PhpSpreadsheet\Style\Border;
use PhpOffice\PhpSpreadsheet\Style\Fill;
use PhpOffice\PhpSpreadsheet\Writer\Xlsx;
use Symfony\Component\HttpFoundation\StreamedResponse;
use Throwable;
class FinanceLedgerManualTransactionImporter
{
private const MAX_ROWS = 2000;
private const PREVIEW_ROWS = 200;
private const HEADERS = [
'txn_date' => '日期',
'account_short' => '账户简称',
'counterparty_info' => '对方信息',
'income' => '收入(元)',
'expense' => '支出(元)',
'balance' => '余额(元)',
'payment_remark' => '付款备注',
'detail' => '明细',
'approval_no' => '审批编号/业务单号',
];
private const ALIASES = [
'txn_date' => ['日期', '动账日期', '交易日期', '记账日期'],
'account_short' => ['账户简称', '账户', '账户名称'],
'counterparty_info' => ['对方信息', '对方账户', '对方账户/名称', '对方名称', '交易对方'],
'income' => ['收入', '收入(元)', '收入(元)', '转入金额', '收款金额'],
'expense' => ['支出', '支出(元)', '支出(元)', '转出金额', '付款金额'],
'balance' => ['余额', '余额(元)', '余额(元)', '交易后余额'],
'payment_remark' => ['付款备注', '备注'],
'detail' => ['明细', '交易明细', '摘要', '用途'],
'approval_no' => ['审批编号/业务单号', '审批编号', '业务单号'],
];
private readonly ConnectionInterface $connection;
public function __construct(
DatabaseManager $databases,
private readonly FinanceLedgerCalculator $calculator,
) {
$this->connection = $databases->connection(
(string) config('upstream_mirrors.connection', 'business_mirror'),
);
}
/**
* @return array{
* total:int,
* valid:int,
* duplicate:int,
* invalid:int,
* rows:list<array<string,mixed>>,
* plan:list<array<string,mixed>>,
* source_hash:string,
* file_name:string,
* truncated:bool,
* max_rows:int
* }
*/
public function preview(UploadedFile $file, ?string $fixedAccountShort = null): array
{
$fixedAccountShort = trim((string) $fixedAccountShort);
$accountShortValues = $this->connection->table('fin_accounts')
->whereNotNull('account_short')
->pluck('account_short')
->map(static fn (mixed $value): string => trim((string) $value))
->filter()
->unique()
->values()
->all();
$accountLookup = array_fill_keys($accountShortValues, true);
if ($fixedAccountShort !== '' && ! isset($accountLookup[$fixedAccountShort])) {
throw ValidationException::withMessages([
'import' => '当前页面指定的账户“' . $fixedAccountShort . '”不在账户总表中。',
]);
}
[$headers, $rawRows] = $this->readRows($file, $fixedAccountShort);
$columns = $this->mapHeaders($headers, $fixedAccountShort);
$sourceHash = hash_file('sha256', $file->getRealPath());
if (! is_string($sourceHash) || $sourceHash === '') {
throw ValidationException::withMessages([
'import' => '无法校验导入文件,请重新导出模板后再试。',
]);
}
$openingDate = (string) config('finance_ledger.opening_date', '2026-10-17');
$normalizedRows = [];
foreach ($rawRows as $rawRow) {
$normalized = $this->normalizeRow(
$rawRow,
$columns,
$fixedAccountShort,
$accountLookup,
$openingDate,
$sourceHash,
);
if ($normalized !== null) {
$normalizedRows[] = $normalized;
}
}
if ($normalizedRows === []) {
throw ValidationException::withMessages([
'import' => '文件中没有可读取的动账明细,请按模板填写后再上传。',
]);
}
$existingFingerprints = $this->existingFingerprints(
array_values(array_unique(array_column($normalizedRows, 'txn_date'))),
$fixedAccountShort,
);
$seenInFile = [];
$previewRows = [];
$plan = [];
$duplicateCount = 0;
$invalidCount = 0;
$validCount = 0;
foreach ($normalizedRows as $row) {
$messages = $row['errors'];
$status = 'ready';
if ($messages !== []) {
$status = 'invalid';
$invalidCount++;
} elseif (isset($existingFingerprints[$row['fingerprint']])
|| isset($seenInFile[$row['fingerprint']])) {
$status = 'duplicate';
$messages[] = '系统中或本文件前面已有相同账户、日期、金额和明细,确认导入时将跳过。';
$duplicateCount++;
} else {
$seenInFile[$row['fingerprint']] = true;
$validCount++;
unset($row['errors'], $row['fingerprint']);
$plan[] = $row;
}
$previewRows[] = [
'row_number' => (int) $row['source_row'],
'status' => $status,
'status_label' => match ($status) {
'ready' => '可导入',
'duplicate' => '重复跳过',
default => '需修正',
},
'messages' => $messages,
'display' => [
'txn_date' => (string) $row['txn_date'],
'account_short' => (string) $row['account_short'],
'counterparty_info' => (string) ($row['counterparty_info'] ?? ''),
'income' => $row['income_cents'] > 0 ? $this->money($row['income_cents']) : '',
'expense' => $row['expense_cents'] > 0 ? $this->money($row['expense_cents']) : '',
'balance' => $row['balance_cents'] === null ? '' : $this->money($row['balance_cents']),
'payment_remark' => (string) ($row['payment_remark'] ?? ''),
'detail' => (string) ($row['detail'] ?? ''),
'approval_no' => (string) ($row['approval_no'] ?? ''),
],
];
}
return [
'total' => count($normalizedRows),
'valid' => $validCount,
'duplicate' => $duplicateCount,
'invalid' => $invalidCount,
'rows' => array_slice($previewRows, 0, self::PREVIEW_ROWS),
'plan' => $plan,
'source_hash' => $sourceHash,
'file_name' => (string) $file->getClientOriginalName(),
'truncated' => count($previewRows) > self::PREVIEW_ROWS,
'max_rows' => self::MAX_ROWS,
];
}
/**
* @param list<array<string,mixed>> $plan
* @return array{imported:int,duplicate_skipped:int}
*/
public function commit(array $plan, string $sourceHash, string $fileName): array
{
if ($plan === []) {
throw ValidationException::withMessages([
'import' => '没有可导入的有效明细。',
]);
}
if (count($plan) > self::MAX_ROWS) {
throw ValidationException::withMessages([
'import' => '单次最多导入 ' . number_format(self::MAX_ROWS) . ' 条动账明细。',
]);
}
return $this->connection->transaction(function () use ($plan, $sourceHash, $fileName): array {
$now = now();
$inserted = 0;
$rows = [];
foreach ($plan as $row) {
$rows[] = [
'txn_date' => (string) $row['txn_date'],
'account_short' => (string) $row['account_short'],
'counterparty_info' => ($row['counterparty_info'] ?? null) ?: null,
'detail' => (string) $row['detail'],
'income' => $this->amountFromCents((int) $row['income_cents']),
'expense' => $this->amountFromCents((int) $row['expense_cents']),
'balance' => $row['balance_cents'] === null
? null
: $this->amountFromCents((int) $row['balance_cents']),
'approval_no' => (string) $row['approval_no'],
'payment_remark' => ($row['payment_remark'] ?? null) ?: null,
'source' => FinanceLedgerTransactionWriter::MANUAL_SOURCE,
'source_value' => null,
'process_type' => '手工导入',
'row_key' => (string) $row['row_key'],
'synced_at' => $now,
'created_at' => $now,
'updated_at' => $now,
'created_by' => (string) (user()?->name ?? ''),
'updated_by' => (string) (user()?->name ?? ''),
];
}
foreach (array_chunk($rows, 500) as $chunk) {
$inserted += $this->connection->table('fin_transactions')->insertOrIgnore($chunk);
}
if ($inserted > 0) {
$this->calculator->recalculate();
$this->connection->table('fin_ledger_edit_events')->insert([
'entity_type' => 'manual_transaction_import',
'entity_key' => 'import|' . $sourceHash,
'changes' => json_encode([
'file_name' => $fileName,
'planned' => count($plan),
'imported' => $inserted,
'duplicate_skipped' => count($plan) - $inserted,
], JSON_UNESCAPED_UNICODE | JSON_THROW_ON_ERROR),
'user_id' => user()?->id,
'user_name' => (string) (user()?->name ?? ''),
'created_at' => $now,
]);
}
return [
'imported' => $inserted,
'duplicate_skipped' => count($plan) - $inserted,
];
});
}
public function downloadTemplate(?string $fixedAccountShort = null): StreamedResponse
{
$fixedAccountShort = trim((string) $fixedAccountShort);
return response()->streamDownload(function () use ($fixedAccountShort): void {
$spreadsheet = new Spreadsheet();
$sheet = $spreadsheet->getActiveSheet();
$sheet->setTitle('动账明细');
$headers = array_values(self::HEADERS);
$sheet->fromArray($headers, null, 'A1');
$lastColumn = Coordinate::stringFromColumnIndex(count($headers));
$headerRange = 'A1:' . $lastColumn . '1';
$sheet->getStyle($headerRange)->applyFromArray([
'font' => ['bold' => true, 'color' => ['rgb' => 'FFFFFF']],
'fill' => ['fillType' => Fill::FILL_SOLID, 'startColor' => ['rgb' => '856632']],
'alignment' => [
'horizontal' => Alignment::HORIZONTAL_CENTER,
'vertical' => Alignment::VERTICAL_CENTER,
],
'borders' => [
'allBorders' => [
'borderStyle' => Border::BORDER_THIN,
'color' => ['rgb' => 'D8D2C7'],
],
],
]);
$sheet->getRowDimension(1)->setRowHeight(26);
$sheet->freezePane('A2');
$sheet->setAutoFilter($headerRange);
foreach (array_keys(self::HEADERS) as $index => $field) {
$column = Coordinate::stringFromColumnIndex($index + 1);
$width = match ($field) {
'detail' => 34,
'counterparty_info', 'payment_remark', 'approval_no' => 26,
'account_short' => 20,
default => 16,
};
$sheet->getColumnDimension($column)->setWidth($width);
$sheet->getStyle($column . '2:' . $column . '2001')
->getNumberFormat()
->setFormatCode(in_array($field, ['income', 'expense', 'balance'], true)
? '#,##0.00'
: '@');
}
$sheet->getStyle($headerRange)->getAlignment()->setWrapText(true);
$instructions = $spreadsheet->createSheet();
$instructions->setTitle('填写说明');
$instructions->fromArray([
['项目', '说明'],
['导入范围', $fixedAccountShort !== ''
? '当前页面固定导入账户:' . $fixedAccountShort . ';账户简称列如填写,必须与之一致。'
: '账户简称必须来自财务台账“账户总表”,请勿填写公司名称或银行账号。'],
['日期', '填写 YYYY-MM-DD,例如 2026-11-18。非独立账单日期不得早于台账期初日期。'],
['收入/支出', '每行只能填写收入或支出其中一项,金额最多两位小数。'],
['重复数据', '系统按日期、账户、对方信息、收支金额、余额、付款备注和明细识别重复;重复行在预览中标记并跳过。'],
['错误行', '预览会逐行显示错误;只有“可导入”的行会写入系统,确认前不会修改任何数据。'],
['行数限制', '单个文件最多 ' . number_format(self::MAX_ROWS) . ' 条有效明细。'],
['来源', '导入明细统一标记为“手工录入”,写入后可继续使用行尾的修改、删除操作。'],
], null, 'A1');
$instructions->getStyle('A1:B1')->applyFromArray([
'font' => ['bold' => true, 'color' => ['rgb' => 'FFFFFF']],
'fill' => ['fillType' => Fill::FILL_SOLID, 'startColor' => ['rgb' => '856632']],
]);
$instructions->getColumnDimension('A')->setWidth(18);
$instructions->getColumnDimension('B')->setWidth(72);
$instructions->getStyle('A1:B8')->getAlignment()
->setVertical(Alignment::VERTICAL_CENTER)
->setWrapText(true);
foreach (range(1, 8) as $row) {
$instructions->getRowDimension($row)->setRowHeight($row === 1 ? 24 : 38);
}
$spreadsheet->setActiveSheetIndex(0);
(new Xlsx($spreadsheet))->save('php://output');
$spreadsheet->disconnectWorksheets();
}, '动账明细_手工导入模板_' . now()->format('Ymd') . '.xlsx', [
'Content-Type' => 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
'Cache-Control' => 'private, no-store',
]);
}
/**
* @return array{0:list<string>,1:list<array{row:int,cells:list<mixed>}>}
*/
private function readRows(UploadedFile $file, string $fixedAccountShort): array
{
$extension = mb_strtolower((string) $file->getClientOriginalExtension());
if (! in_array($extension, ['xlsx', 'xls', 'csv'], true)) {
throw ValidationException::withMessages([
'import' => '只支持 xlsx、xls、csv 三种文件格式。',
]);
}
return $extension === 'csv'
? $this->readCsv($file, $fixedAccountShort)
: $this->readSpreadsheet($file, $extension, $fixedAccountShort);
}
/**
* @return array{0:list<string>,1:list<array{row:int,cells:list<mixed>}>}
*/
private function readCsv(UploadedFile $file, string $fixedAccountShort): array
{
$handle = fopen($file->getRealPath(), 'rb');
if ($handle === false) {
throw ValidationException::withMessages([
'import' => '无法读取导入文件。',
]);
}
try {
$firstLine = '';
while (($line = fgets($handle)) !== false) {
$line = $this->normalizeCsvText($line);
if (trim($line) !== '') {
$firstLine = $line;
break;
}
}
if ($firstLine === '') {
throw ValidationException::withMessages([
'import' => '导入文件为空,请填写模板后再上传。',
]);
}
$delimiter = $this->detectDelimiter($firstLine);
rewind($handle);
$header = null;
$headerRow = 0;
$sourceRow = 0;
while (($cells = fgetcsv($handle, 0, $delimiter, '"', '')) !== false) {
$sourceRow++;
$cells = array_map(fn (mixed $value): string => $this->normalizeCsvText($value), $cells);
if ($this->rowIsEmpty($cells)) {
continue;
}
if ($header === null) {
if ($this->headerScore($cells, $fixedAccountShort) === 0) {
continue;
}
$header = array_map(static fn (mixed $value): string => trim((string) $value), $cells);
$headerRow = $sourceRow;
continue;
}
break;
}
if ($header === null) {
throw ValidationException::withMessages([
'import' => '没有找到导入表头,请先下载并使用系统模板。',
]);
}
$rows = [];
if (is_array($cells)) {
$cells = array_map(fn (mixed $value): string => $this->normalizeCsvText($value), $cells);
if (! $this->rowIsEmpty($cells)) {
$rows[] = ['row' => $sourceRow, 'cells' => array_values($cells)];
}
}
while (($cells = fgetcsv($handle, 0, $delimiter, '"', '')) !== false) {
$sourceRow++;
$cells = array_map(fn (mixed $value): string => $this->normalizeCsvText($value), $cells);
if ($this->rowIsEmpty($cells)) {
continue;
}
$rows[] = ['row' => $sourceRow, 'cells' => array_values($cells)];
if (count($rows) > self::MAX_ROWS) {
throw ValidationException::withMessages([
'import' => '单个文件最多导入 ' . number_format(self::MAX_ROWS) . ' 条动账明细。',
]);
}
}
return [$header, $rows];
} finally {
fclose($handle);
}
}
/**
* @return array{0:list<string>,1:list<array{row:int,cells:list<mixed>}>}
*/
private function readSpreadsheet(UploadedFile $file, string $extension, string $fixedAccountShort): array
{
try {
$reader = IOFactory::createReader(ucfirst($extension));
$reader->setReadDataOnly(true);
if (method_exists($reader, 'setReadEmptyCells')) {
$reader->setReadEmptyCells(false);
}
if ($extension === 'xlsx') {
$reader->setReadFilter(new class(self::MAX_ROWS + 30) implements IReadFilter {
public function __construct(private readonly int $lastRow)
{
}
public function readCell($columnAddress, $row, $worksheetName = ''): bool
{
return $row >= 1 && $row <= $this->lastRow;
}
});
}
$spreadsheet = $reader->load($file->getRealPath());
} catch (Throwable) {
throw ValidationException::withMessages([
'import' => '读不出这个文件,请确认是 xlsx、xls 或 csv,且没有损坏。',
]);
}
try {
$sheet = null;
foreach ($spreadsheet->getWorksheetIterator() as $candidate) {
$highestRow = $candidate->getHighestDataRow();
if ($highestRow < 1) {
continue;
}
$lastColumn = $candidate->getHighestDataColumn();
$sample = $candidate->rangeToArray(
'A1:' . $lastColumn . min(30, $highestRow),
null,
false,
true,
false,
);
foreach ($sample as $cells) {
$cells = array_values(array_map(
static fn (mixed $value): string => trim((string) (is_scalar($value) ? $value : '')),
$cells,
));
if (! $this->rowIsEmpty($cells)
&& $this->headerScore($cells, $fixedAccountShort) > 0) {
$sheet = $candidate;
break 2;
}
}
}
if ($sheet === null) {
throw ValidationException::withMessages([
'import' => '导入文件为空,请填写模板后再上传。',
]);
}
$highestRow = $sheet->getHighestDataRow();
if ($highestRow > self::MAX_ROWS + 30) {
throw ValidationException::withMessages([
'import' => '单个文件最多导入 ' . number_format(self::MAX_ROWS) . ' 条动账明细。',
]);
}
$grid = $sheet->toArray(null, false, true, false);
} finally {
$spreadsheet->disconnectWorksheets();
}
$header = null;
$headerIndex = null;
foreach ($grid as $index => $cells) {
$cells = array_values(array_map(
static fn (mixed $value): string => trim((string) (is_scalar($value) ? $value : '')),
$cells,
));
if ($this->rowIsEmpty($cells)) {
continue;
}
if ($this->headerScore($cells, $fixedAccountShort) > 0) {
$header = $cells;
$headerIndex = $index;
break;
}
}
if ($header === null || $headerIndex === null) {
throw ValidationException::withMessages([
'import' => '没有找到导入表头,请先下载并使用系统模板。',
]);
}
$rows = [];
foreach ($grid as $index => $cells) {
if ($index <= $headerIndex) {
continue;
}
$cells = array_values(array_map(
static fn (mixed $value): string => trim((string) (is_scalar($value) ? $value : '')),
$cells,
));
if ($this->rowIsEmpty($cells)) {
continue;
}
$rows[] = ['row' => (int) $index + 1, 'cells' => $cells];
if (count($rows) > self::MAX_ROWS) {
throw ValidationException::withMessages([
'import' => '单个文件最多导入 ' . number_format(self::MAX_ROWS) . ' 条动账明细。',
]);
}
}
return [$header, $rows];
}
/**
* @param list<mixed> $header
* @return array<string,int>
*/
private function mapHeaders(array $header, string $fixedAccountShort): array
{
$normalizedHeaders = array_map(
fn (mixed $value): string => $this->normalizeHeader($value),
$header,
);
$columns = [];
foreach (self::ALIASES as $field => $aliases) {
$index = false;
foreach ($aliases as $alias) {
$index = array_search($this->normalizeHeader($alias), $normalizedHeaders, true);
if ($index !== false) {
break;
}
}
if ($index !== false) {
$columns[$field] = (int) $index;
}
}
$missing = [];
if (! array_key_exists('txn_date', $columns)) {
$missing[] = '日期';
}
if ($fixedAccountShort === '' && ! array_key_exists('account_short', $columns)) {
$missing[] = '账户简称';
}
if (! array_key_exists('detail', $columns)) {
$missing[] = '明细';
}
if (! array_key_exists('income', $columns) && ! array_key_exists('expense', $columns)) {
$missing[] = '收入或支出';
}
if ($missing !== []) {
throw ValidationException::withMessages([
'import' => '模板缺少必要列:' . implode('、', $missing) . '。请重新下载系统模板。',
]);
}
return $columns;
}
/**
* @param array{row:int,cells:list<mixed>} $rawRow
* @param array<string,int> $columns
* @param array<string,true> $accountLookup
* @return array<string,mixed>|null
*/
private function normalizeRow(
array $rawRow,
array $columns,
string $fixedAccountShort,
array $accountLookup,
string $openingDate,
string $sourceHash,
): ?array {
$cells = $rawRow['cells'];
$sourceRow = (int) $rawRow['row'];
$value = static fn (string $field): string => (
isset($columns[$field]) && is_scalar($cells[$columns[$field]] ?? null)
) ? trim((string) $cells[$columns[$field]]) : '';
if ($this->rowIsEmpty($cells)) {
return null;
}
$rowKey = hash(
'sha256',
FinanceLedgerTransactionWriter::MANUAL_SOURCE . ':import:' . $sourceHash . ':' . $sourceRow,
);
$errors = [];
$date = $this->normalizeDate($value('txn_date'));
if ($date === null) {
$errors[] = '日期必须使用 YYYY-MM-DD 格式。';
$date = '';
}
$rawAccount = $this->normalizeText($value('account_short'));
if ($fixedAccountShort !== '') {
if ($rawAccount !== '' && $rawAccount !== $fixedAccountShort) {
$errors[] = '当前页面只能导入账户“' . $fixedAccountShort . '”。';
}
$accountShort = $fixedAccountShort;
} else {
$accountShort = $rawAccount;
if ($accountShort === '') {
$errors[] = '账户简称不能为空。';
} elseif (mb_strlen($accountShort) > 100) {
$errors[] = '账户简称不能超过 100 个字符。';
} elseif (! isset($accountLookup[$accountShort])) {
$errors[] = '账户简称“' . $accountShort . '”不在账户总表中。';
}
}
if ($date !== '' && $fixedAccountShort === ''
&& ! FinanceLedgerIndependentAccounts::contains($accountShort)
&& $date < $openingDate) {
$errors[] = '非独立账单日期不得早于台账期初日期 ' . $openingDate . '。';
} elseif ($date !== '' && $fixedAccountShort !== ''
&& ! FinanceLedgerIndependentAccounts::contains($fixedAccountShort)
&& $date < $openingDate) {
$errors[] = '非独立账单日期不得早于台账期初日期 ' . $openingDate . '。';
}
$counterpartyInfo = $this->normalizeText($value('counterparty_info'));
if (mb_strlen($counterpartyInfo) > 255) {
$errors[] = '对方信息不能超过 255 个字符。';
}
$detail = $this->normalizeText($value('detail'));
if ($detail === '') {
$errors[] = '明细不能为空。';
} elseif (mb_strlen($detail) > 4000) {
$errors[] = '明细不能超过 4000 个字符。';
}
$paymentRemark = $this->normalizeText($value('payment_remark'));
if (mb_strlen($paymentRemark) > 500) {
$errors[] = '付款备注不能超过 500 个字符。';
}
$incomeCents = $this->parseMoney($value('income'));
$expenseCents = $this->parseMoney($value('expense'));
if ($incomeCents === false) {
$errors[] = '收入金额格式不正确。';
$incomeCents = 0;
}
if ($expenseCents === false) {
$errors[] = '支出金额格式不正确。';
$expenseCents = 0;
}
$incomeCents ??= 0;
$expenseCents ??= 0;
if ($incomeCents < 0) {
$errors[] = '收入金额不能为负数。';
}
if ($expenseCents < 0) {
$errors[] = '支出金额不能为负数。';
}
if (($incomeCents > 0) === ($expenseCents > 0)) {
$errors[] = '每行收入和支出必须且只能填写一项。';
}
$balanceRaw = $value('balance');
$balanceCents = $balanceRaw === '' ? null : $this->parseMoney($balanceRaw);
if ($balanceCents === false) {
$errors[] = '余额格式不正确。';
$balanceCents = null;
}
foreach ([
'收入' => $incomeCents,
'支出' => $expenseCents,
'余额' => $balanceCents,
] as $label => $cents) {
if ($cents !== null && abs((int) $cents) > 999999999999999999) {
$errors[] = $label . '金额超出允许范围。';
}
}
$approvalNo = $this->normalizeText($value('approval_no'));
if (mb_strlen($approvalNo) > 100) {
$errors[] = '审批编号/业务单号不能超过 100 个字符。';
}
if ($approvalNo === '') {
$approvalNo = 'IMP-' . str_replace('-', '', $date !== '' ? $date : now()->toDateString())
. '-' . strtoupper(substr($rowKey, 0, 6));
}
$income = $incomeCents / 100;
$expense = $expenseCents / 100;
$balance = $balanceCents === null ? null : $balanceCents / 100;
$fingerprint = $this->fingerprint(
$date,
$accountShort,
$counterpartyInfo,
$incomeCents,
$expenseCents,
$balanceCents,
$paymentRemark,
$detail,
);
return [
'source_row' => $sourceRow,
'row_key' => $rowKey,
'txn_date' => $date,
'account_short' => $accountShort,
'counterparty_info' => $counterpartyInfo !== '' ? $counterpartyInfo : null,
'detail' => $detail,
'income_cents' => $incomeCents,
'expense_cents' => $expenseCents,
'income' => $income,
'expense' => $expense,
'balance_cents' => $balanceCents,
'balance' => $balance,
'approval_no' => $approvalNo,
'payment_remark' => $paymentRemark !== '' ? $paymentRemark : null,
'fingerprint' => $fingerprint,
'errors' => array_values(array_unique($errors)),
];
}
/**
* @param list<string> $dates
* @return array<string,true>
*/
private function existingFingerprints(array $dates, string $fixedAccountShort): array
{
$dates = array_values(array_filter($dates));
if ($dates === []) {
return [];
}
$query = $this->connection->table('fin_transactions')
->whereIn('txn_date', $dates)
->whereNull('deleted_at');
if ($fixedAccountShort !== '') {
$query->where('account_short', $fixedAccountShort);
}
$fingerprints = [];
foreach ($query->get([
'txn_date',
'account_short',
'counterparty_info',
'income',
'expense',
'balance',
'payment_remark',
'detail',
]) as $row) {
$fingerprints[$this->fingerprint(
substr((string) $row->txn_date, 0, 10),
trim((string) ($row->account_short ?? '')),
$this->normalizeText($row->counterparty_info),
(int) round((float) $row->income * 100),
(int) round((float) $row->expense * 100),
$row->balance === null ? null : (int) round((float) $row->balance * 100),
$this->normalizeText($row->payment_remark),
$this->normalizeText($row->detail),
)] = true;
}
return $fingerprints;
}
private function fingerprint(
string $date,
string $accountShort,
string $counterpartyInfo,
int $incomeCents,
int $expenseCents,
?int $balanceCents,
string $paymentRemark,
string $detail,
): string {
return hash('sha256', implode("\0", [
$date,
$accountShort,
$counterpartyInfo,
(string) $incomeCents,
(string) $expenseCents,
$balanceCents === null ? 'null' : (string) $balanceCents,
$paymentRemark,
$detail,
]));
}
private function normalizeDate(mixed $value): ?string
{
$text = trim((string) $value);
if ($text === '') {
return null;
}
if (is_numeric($text) && (float) $text >= 1 && (float) $text <= 2958465) {
try {
return CarbonImmutable::instance(ExcelDate::excelToDateTimeObject((float) $text))
->format('Y-m-d');
} catch (Throwable) {
return null;
}
}
if (preg_match('/^(\d{4})[年\/.-](\d{1,2})[月\/.-](\d{1,2})日?(?:\s|$)/u', $text, $matches) === 1) {
$year = (int) $matches[1];
$month = (int) $matches[2];
$day = (int) $matches[3];
} elseif (preg_match('/^(\d{1,2})\/(\d{1,2})\/(\d{4})(?:\s|$)/', $text, $matches) === 1) {
$month = (int) $matches[1];
$day = (int) $matches[2];
$year = (int) $matches[3];
} else {
return null;
}
if (! checkdate($month, $day, $year)) {
return null;
}
return sprintf('%04d-%02d-%02d', $year, $month, $day);
}
/**
* @return int|false|null
*/
private function parseMoney(mixed $value): int|false|null
{
$text = trim((string) $value);
if ($text === '') {
return null;
}
$negative = str_starts_with($text, '(') && str_ends_with($text, ')');
$text = str_replace(
[',', ',', '¥', '¥', '元', ' ', "\u{00A0}"],
'',
$negative ? substr($text, 1, -1) : $text,
);
if (! is_numeric($text)) {
return false;
}
$amount = (float) $text;
if ($negative) {
$amount *= -1;
}
return (int) round($amount * 100);
}
private function amountFromCents(int $cents): float
{
return round($cents / 100, 2);
}
private function money(int $cents): string
{
return number_format($cents / 100, 2, '.', '');
}
private function normalizeText(mixed $value): string
{
$text = trim((string) ($value ?? ''));
return preg_replace('/\s+/u', ' ', $text) ?? $text;
}
private function normalizeHeader(mixed $value): string
{
$text = $this->normalizeText($value);
$text = str_replace(['(', ')'], ['(', ')'], $text);
return mb_strtolower((string) preg_replace('/[\s::]+/u', '', $text));
}
private function normalizeCsvText(mixed $value): string
{
$text = (string) ($value ?? '');
if (str_starts_with($text, "\xEF\xBB\xBF")) {
$text = substr($text, 3);
}
if (! mb_check_encoding($text, 'UTF-8')) {
$text = mb_convert_encoding($text, 'UTF-8', 'GB18030');
}
return $text;
}
private function detectDelimiter(string $line): string
{
$delimiters = [',' => substr_count($line, ','), "\t" => substr_count($line, "\t"), ';' => substr_count($line, ';')];
arsort($delimiters);
return (string) array_key_first($delimiters);
}
/** @param list<mixed> $cells */
private function rowIsEmpty(array $cells): bool
{
foreach ($cells as $cell) {
if (trim((string) (is_scalar($cell) ? $cell : '')) !== '') {
return false;
}
}
return true;
}
/**
* @param list<mixed> $cells
*/
private function headerScore(array $cells, string $fixedAccountShort): int
{
try {
return count($this->mapHeaders($cells, $fixedAccountShort));
} catch (ValidationException) {
return 0;
}
}
}