feat(admin): D16 (b)(c) — Excel order-item report, document-confirm SMS, %name in bulk SMS

Finished from a parallel session that expired (owner: «بساز»).

- RPT-01: GET admin/report/order-items — legacy report/order_item's
  32-column Excel (order items, one row per unit, plus financial
  documents), RTL, Jalali dates. The «گزارش تجمیعی» screen gets
  «دریافت فایل اکسل». Review fixes:
  - weight: computedWeightGrams is already one unit's weight; legacy
    divided it by qty again, under-reporting «بدهکار» on multi-unit
    lines. Not repeated.
  - «درصد»: the final percent (wage − discount), as legacy.
  - dates: the end date covers its whole day; a bad date is a 400.
- SMS-01: confirming or rejecting a financial document texts the customer,
  as legacy CashController::toggleConfiremCash.
- SMS-02: bulk SMS substitutes %name per recipient and is actually sent
  through the configured gateway (D26 relay), no longer only logged.
- Docs: 01-ADMIN-MATRIX and D16-BC-GAP-SUMMARY.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
s.esmaeili
2026-10-08 16:34:45 +03:30
co-authored by Claude Opus 5.5
parent fbe4f38e06
commit 2d74f53d0a
12 changed files with 1241 additions and 30 deletions
@@ -3,6 +3,7 @@ import { LedgerCurrency, LedgerDirection, LedgerSourceType, Prisma } from '@pris
import { PrismaService } from '../../prisma/prisma.service';
import { TableService } from '../admin-table/table.service';
import { LedgerService } from '../accounting/ledger.service';
import { SmsService } from '../sms/sms.service';
import type { TableQueryDto } from '../admin-table/table-query.dto';
/**
@@ -62,6 +63,7 @@ export class AdminDocumentsService {
private readonly prisma: PrismaService,
private readonly table: TableService,
private readonly ledger: LedgerService,
private readonly sms: SmsService,
) {}
private static readonly ALLOWED = [
@@ -313,6 +315,7 @@ export class AdminDocumentsService {
if (!e.confirmed) {
await this.ledger.confirmEntry(id, adminUserId);
this.notifyDocumentConfirm(e.customerId, true);
return this.findOne(id);
}
@@ -335,9 +338,24 @@ export class AdminDocumentsService {
});
});
this.notifyDocumentConfirm(e.customerId, false);
return this.findOne(id);
}
// Legacy CashController::toggleConfiremCash sent an SMS on both outcomes.
private notifyDocumentConfirm(customerId: string, confirmed: boolean) {
const text = confirmed
? 'هنزا گلد\nسند مالی شما توسط مدیر سیستم تایید شد.'
: 'هنزا گلد\nسند مالی شما توسط مدیر سیستم رد شد.';
this.prisma.customer
.findUnique({ where: { id: customerId }, select: { mobile: true } })
.then((c) => {
if (c) this.sms.send(c.mobile, text);
})
.catch(() => {});
}
/**
* Legacy `DELETE cash/{id}`.
*