CaiWuXiTong/modules/EcommerceFinance/Services/SupplierSummaryConfirmation.php
苏木 770ddea8a9 feat(供应商对账): 增加免登录送货确认链接 (#1180)
Co-authored-by: 苏木 <594326199@qq.com>
Co-committed-by: 苏木 <594326199@qq.com>
2026-11-15 11:36:27 +08:00

211 lines
6.5 KiB
PHP

<?php
namespace Modules\EcommerceFinance\Services;
use InvalidArgumentException;
/**
* 月度货款对账汇总的厂家确认记录。
*
* 同一账期和推送口径可以多次发送,最新一次推送用于财务端展示;每次卡片
* 都保留独立记录和钉钉用户回传信息,历史确认不会被后续重发改写。
*/
class SupplierSummaryConfirmation
{
public const DATASET = 'supplier-summary-confirmations';
public const STATUS_SENDING = 'sending';
public const STATUS_PENDING = 'pending';
public const STATUS_CONFIRMED = 'confirmed';
public const STATUS_FAILED = 'failed';
public function __construct(
private readonly SupplierPayableOverrideStore $store,
) {
}
public function create(
string $outTrackId,
string $supplier,
string $month,
string $pushBasis,
float $qty,
float $amount,
int $companyId,
?int $requestedBy,
): array {
$this->store->save(self::DATASET, $outTrackId, [
'supplier' => $supplier,
'month' => $month,
'push_basis' => $pushBasis,
'qty' => round($qty, 4),
'amount' => round($amount, 2),
'status' => self::STATUS_SENDING,
'requested_by' => $requestedBy,
'requested_at' => $this->timestamp(),
], $companyId, $requestedBy, 'dingtalk_card_request');
return $this->find($outTrackId, $companyId) ?? [];
}
public function markSent(string $outTrackId, int $companyId): void
{
$this->merge($outTrackId, $companyId, [
'status' => self::STATUS_PENDING,
'sent_at' => $this->timestamp(),
'send_error' => null,
], 'dingtalk_card_sent');
}
public function markFailed(string $outTrackId, int $companyId, string $message): void
{
$this->merge($outTrackId, $companyId, [
'status' => self::STATUS_FAILED,
'failed_at' => $this->timestamp(),
'send_error' => mb_strimwidth($message, 0, 500, '…', 'UTF-8'),
], 'dingtalk_card_failed');
}
/** @return array{record:array<string,mixed>,newly_confirmed:bool} */
public function confirm(
string $outTrackId,
int $companyId,
?string $dingTalkUserId,
string $corpId = '',
string $source = 'dingtalk_card',
): array {
$record = $this->find($outTrackId, $companyId);
if ($record === null) {
throw new InvalidArgumentException('确认卡片不存在。');
}
if (($record['status'] ?? '') === self::STATUS_CONFIRMED) {
return ['record' => $record, 'newly_confirmed' => false];
}
$changes = [
'status' => self::STATUS_CONFIRMED,
'confirmed_at' => $this->timestamp(),
'confirmed_source' => $source,
];
if ($dingTalkUserId !== null && trim($dingTalkUserId) !== '') {
$changes['confirmed_by_dingtalk_user_id'] = trim($dingTalkUserId);
}
if ($corpId !== '') {
$changes['dingtalk_corp_id'] = $corpId;
}
$confirmed = array_merge($record, $changes);
unset($confirmed['_action_key']);
$this->store->save(
self::DATASET,
$outTrackId,
$confirmed,
$companyId,
null,
'dingtalk_card_callback',
);
return [
'record' => $this->find($outTrackId, $companyId) ?? $confirmed,
'newly_confirmed' => true,
];
}
/** @return array<string,mixed>|null */
public function find(string $outTrackId, int $companyId): ?array
{
return $this->store->findRow(self::DATASET, $outTrackId, $companyId);
}
/** @return array<string,mixed>|null */
public function latest(
string $supplier,
string $month,
string $pushBasis,
int $companyId,
): ?array {
return $this->store->findLatestRow(self::DATASET, [
'supplier' => $supplier,
'month' => $month,
'push_basis' => $pushBasis,
], $companyId);
}
public function companyIdFromOutTrackId(string $outTrackId): ?int
{
if (preg_match('/^supplier-summary-c(\d+)-[a-f0-9]{16,128}$/', strtolower($outTrackId), $matches) !== 1) {
return null;
}
$companyId = (int) $matches[1];
return $companyId > 0 ? $companyId : null;
}
/** @return array<string,mixed> */
public function statusPayload(?array $record): array
{
$status = trim((string) ($record['status'] ?? ''));
if (! in_array($status, [
self::STATUS_SENDING,
self::STATUS_PENDING,
self::STATUS_CONFIRMED,
self::STATUS_FAILED,
], true)) {
return [
'status' => 'none',
'label' => '当前账期尚未推送确认卡片',
'sent_at' => '',
'confirmed_at' => '',
'qty' => null,
'amount' => null,
'push_basis' => '',
];
}
$labels = [
self::STATUS_SENDING => '确认卡片正在推送',
self::STATUS_PENDING => '等待厂家确认',
self::STATUS_CONFIRMED => '厂家已确认',
self::STATUS_FAILED => '确认卡片推送失败',
];
return [
'status' => $status,
'label' => $labels[$status],
'sent_at' => (string) ($record['sent_at'] ?? ''),
'confirmed_at' => (string) ($record['confirmed_at'] ?? ''),
'qty' => isset($record['qty']) ? (float) $record['qty'] : null,
'amount' => isset($record['amount']) ? (float) $record['amount'] : null,
'push_basis' => (string) ($record['push_basis'] ?? ''),
];
}
private function merge(
string $outTrackId,
int $companyId,
array $changes,
string $source,
): void {
$record = $this->find($outTrackId, $companyId);
if ($record === null) {
return;
}
$record = array_merge($record, $changes);
unset($record['_action_key']);
$this->store->save(self::DATASET, $outTrackId, $record, $companyId, null, $source);
}
private function timestamp(): string
{
$timezone = trim((string) config('app.platform_timezone', ''));
return now($timezone !== '' ? $timezone : 'Asia/Shanghai')->format('Y-m-d H:i:s');
}
}