connection = $databases->connection( (string) config('upstream_mirrors.connection', 'business_mirror'), ); } /** * @param array $data * @return array */ public function update(int $id, array $data): array { $date = $this->date($data['txn_date'] ?? null); $incomeCents = $this->cents($data['income'] ?? 0); $expenseCents = $this->cents($data['expense'] ?? 0); if (($incomeCents > 0) === ($expenseCents > 0)) { throw ValidationException::withMessages([ 'income' => '收入和支出只能填写一项。', ]); } return $this->connection->transaction(function () use ( $id, $date, $incomeCents, $expenseCents, $data, ): array { $before = $this->localRow($id, true); $now = now(); $values = [ 'txn_date' => $date, 'counterparty_info' => $this->nullableText($data['counterparty_info'] ?? null, 255, 'counterparty_info'), 'detail' => $this->nullableText($data['detail'] ?? null, 4000, 'detail'), 'income' => $incomeCents / 100, 'expense' => $expenseCents / 100, 'balance' => $this->nullableMoney($data['balance'] ?? null), 'approval_no' => $this->nullableText($data['approval_no'] ?? null, 100, 'approval_no'), 'payment_remark' => $this->nullableText($data['payment_remark'] ?? null, 500, 'payment_remark'), 'local_override' => true, 'updated_by' => (string) (user()?->name ?? ''), 'updated_at' => $now, ]; $this->connection->table('fin_transactions')->where('id', $id)->update($values); $after = array_merge($this->rowSnapshot($before), $values); $this->audit('transaction_local_update', (string) $before->row_key, [ 'before' => $this->rowSnapshot($before), 'after' => $after, ]); $this->guard->refreshMappingFor( (string) $before->source, $before->source_value !== null ? (string) $before->source_value : null, ); $this->calculator->recalculate(); return $after; }); } /** * @return array */ public function delete(int $id): array { return $this->connection->transaction(function () use ($id): array { $before = $this->localRow($id, true); $now = now(); $this->connection->table('fin_transactions')->where('id', $id)->update([ 'local_override' => true, 'deleted_at' => $now, 'updated_by' => (string) (user()?->name ?? ''), 'updated_at' => $now, ]); $snapshot = $this->rowSnapshot($before); $this->audit('transaction_local_delete', (string) $before->row_key, [ 'before' => $snapshot, 'after' => null, ]); $this->guard->refreshMappingFor( (string) $before->source, $before->source_value !== null ? (string) $before->source_value : null, ); $this->calculator->recalculate(); return $snapshot; }); } private function localRow(int $id, bool $lock = false): object { $query = $this->connection->table('fin_transactions') ->where('id', $id) ->whereNull('deleted_at'); if ($lock) { $query->lockForUpdate(); } $row = $query->first(); if ($row === null) { throw new NotFoundHttpException('未找到可编辑的动账明细。'); } if ((string) $row->source === FinanceLedgerTransactionWriter::INTERNAL_TRANSFER_SOURCE) { throw ValidationException::withMessages([ 'transaction' => '内部转账需整笔删除,不能单独修改其中一侧。', ]); } if ((string) $row->source === FinanceLedgerTransactionWriter::MANUAL_SOURCE || FinanceLedgerIndependentAccounts::contains($row->account_short)) { throw ValidationException::withMessages([ 'transaction' => '该明细应通过对应的手工或独立账单入口编辑。', ]); } return $row; } /** * @return array */ private function rowSnapshot(object $row): array { return [ 'id' => (int) $row->id, 'row_key' => (string) $row->row_key, 'txn_date' => substr((string) $row->txn_date, 0, 10), 'account_short' => (string) ($row->account_short ?? ''), 'counterparty_info' => $row->counterparty_info !== null ? (string) $row->counterparty_info : null, 'detail' => $row->detail !== null ? (string) $row->detail : null, 'income' => round((float) $row->income, 2), 'expense' => round((float) $row->expense, 2), 'balance' => $row->balance !== null ? round((float) $row->balance, 2) : null, 'approval_no' => $row->approval_no !== null ? (string) $row->approval_no : null, 'payment_remark' => $row->payment_remark !== null ? (string) $row->payment_remark : null, 'source' => (string) $row->source, 'source_value' => $row->source_value !== null ? (string) $row->source_value : null, ]; } /** * @param array $changes */ private function audit(string $entityType, string $rowKey, array $changes): void { $this->connection->table('fin_ledger_edit_events')->insert([ 'entity_type' => $entityType, 'entity_key' => 'transaction|' . $rowKey, 'changes' => json_encode($changes, JSON_UNESCAPED_UNICODE | JSON_THROW_ON_ERROR), 'user_id' => user()?->id, 'user_name' => (string) (user()?->name ?? ''), 'created_at' => now(), ]); } private function date(mixed $value): string { $text = trim((string) $value); $date = CarbonImmutable::createFromFormat('!Y-m-d', $text); if (! $date instanceof CarbonImmutable || $date->format('Y-m-d') !== $text) { throw ValidationException::withMessages([ 'txn_date' => '动账日期必须使用 YYYY-MM-DD 格式。', ]); } return $text; } private function cents(mixed $value): int { return (int) round((float) $value * 100); } private function nullableMoney(mixed $value): ?float { $text = trim((string) ($value ?? '')); return $text === '' ? null : round((float) $text, 2); } private function nullableText(mixed $value, int $length, string $field): ?string { $text = trim((string) ($value ?? '')); if ($text === '') { return null; } $text = preg_replace('/\s+/u', ' ', $text) ?? $text; if (mb_strlen($text) > $length) { throw ValidationException::withMessages([ $field => '字段内容超过允许长度。', ]); } return $text; } }