feat(admin): transaction management

Sprint 24.

New features/admin/transactions/ module. AdminTransactionsLocalGateway
derives one synthetic transaction per Sprint 23's seeded mock order rather
than a separate dataset, keeping order numbers/totals consistent across
the two mock feature areas.

- list: search, status filter, type filter (payment/refund/qr_payment),
  pagination, CSV export
- retry failed transactions (appends an audit entry)
- fraud flag toggle
- per-transaction audit log (creation/retry/fraud-flag-change), viewed via
  dialog - intentionally separate from the system-wide audit/security log
  planned for Sprint 26 (Monitoring)
- wired into /:lang/backoffice/transactions, replacing the coming-soon
  placeholder

docs/ADMIN.md + docs/BACKEND.md (new item 13) updated.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
sdarbinyan
2026-07-15 10:57:29 +04:00
parent 2d8d6b6dc4
commit 7d65913245
11 changed files with 356 additions and 4 deletions

View File

@@ -0,0 +1,91 @@
import { Injectable } from '@angular/core';
import { Observable, of } from 'rxjs';
import { delay } from 'rxjs/operators';
import { AdminTransaction, AdminTransactionListFilters, AdminTransactionsListResult } from '../models/admin-transaction.model';
import { AdminTransactionsGateway } from './admin-transactions-gateway.interface';
import { AdminOrdersLocalGateway } from '../../orders/services/admin-orders-local.gateway';
const METHODS = ['card', 'qr', 'cash_on_delivery'];
@Injectable({ providedIn: 'root' })
export class AdminTransactionsLocalGateway implements AdminTransactionsGateway {
private cache: AdminTransaction[] | null = null;
constructor(private readonly ordersGateway: AdminOrdersLocalGateway) {}
loadTransactions(filters: AdminTransactionListFilters): Observable<AdminTransactionsListResult> {
return new Observable<AdminTransactionsListResult>(subscriber => {
this.ensureData().then(() => {
const filtered = (this.cache ?? [])
.filter(tx => !filters.search || `${tx.orderNumber} ${tx.method}`.toLowerCase().includes(filters.search.toLowerCase()))
.filter(tx => filters.status === 'all' || tx.status === filters.status)
.filter(tx => filters.type === 'all' || tx.type === filters.type)
.sort((left, right) => right.createdAt.localeCompare(left.createdAt));
const start = (filters.page - 1) * filters.pageSize;
subscriber.next({
items: filtered.slice(start, start + filters.pageSize),
total: filtered.length,
page: filters.page,
pageSize: filters.pageSize,
});
subscriber.complete();
});
}).pipe(delay(50));
}
retryFailed(id: string): Observable<AdminTransaction | null> {
return this.mutate(id, tx => ({
...tx,
status: 'retried',
updatedAt: new Date().toISOString(),
audit: [...tx.audit, { action: 'Retried failed transaction', actor: 'admin', timestamp: new Date().toISOString() }],
}));
}
setFraudFlag(id: string, flagged: boolean): Observable<AdminTransaction | null> {
return this.mutate(id, tx => ({
...tx,
fraudFlag: flagged,
updatedAt: new Date().toISOString(),
audit: [...tx.audit, { action: flagged ? 'Flagged as fraud' : 'Fraud flag cleared', actor: 'admin', timestamp: new Date().toISOString() }],
}));
}
private mutate(id: string, update: (tx: AdminTransaction) => AdminTransaction): Observable<AdminTransaction | null> {
const existing = (this.cache ?? []).find(tx => tx.id === id);
if (!existing) {
return of(null);
}
const updated = update(existing);
this.cache = (this.cache ?? []).map(tx => tx.id === id ? updated : tx);
return of(updated).pipe(delay(50));
}
private async ensureData(): Promise<void> {
if (this.cache) {
return;
}
const orders = await new Promise<{ id: string; orderNumber: string; total: number; currency: string; status: string; createdAt: string }[]>(resolve =>
this.ordersGateway.loadOrders({ search: '', status: 'all', page: 1, pageSize: 1000 }).subscribe(result => resolve(result.items))
);
this.cache = orders.map((order, index) => this.seedTransaction(order, index));
}
private seedTransaction(order: { id: string; orderNumber: string; total: number; currency: string; status: string; createdAt: string }, index: number): AdminTransaction {
const status = order.status === 'cancelled' ? 'failed' : order.status === 'refunded' ? 'success' : index % 7 === 0 ? 'pending' : 'success';
return {
id: `tx-${index + 1}`,
orderId: order.id,
orderNumber: order.orderNumber,
type: order.status === 'refunded' ? 'refund' : index % 3 === 0 ? 'qr_payment' : 'payment',
method: METHODS[index % METHODS.length],
status,
amount: order.total,
currency: order.currency,
fraudFlag: index % 11 === 0,
audit: [{ action: 'Transaction created', actor: 'system', timestamp: order.createdAt }],
createdAt: order.createdAt,
updatedAt: order.createdAt,
};
}
}