import { Injectable, NotFoundException } from "@nestjs/common"; import { Prisma } from "@jorgecuadros/database"; import { PrismaService } from "../prisma/prisma.service"; import { CreateCustomerDto } from "./create-customer.dto"; import { UpdateCustomerDto } from "./update-customer.dto"; import { BALANCE_FORWARD_TYPE, notCashJournal, PERIOD_TABLE_PREFIX, } from "../billing/billing.service"; /** * Keeps an imported prior period out of the *current* period, NULL-safely. * * A closed year is imported as its own tagged copy (`datos2@2025`). Below the * year start it is history and counts — for the one customer whose newest * BALANCE FORWARD lives inside an archive it is the only carry there is, and * dropping it understated NUMid 295 by his entire 2025 closing balance. At or * above the year start it must go: the archives spill a couple of rows into the * following January, and those already sit inside the next year's BALANCE * FORWARD, which is the sum of the whole archive. * * Spelled as a positive OR because `NOT (col LIKE ... AND ...)` evaluates to * NULL for an app-captured row (no legacySourceTable), dropping every one. */ const archiveIsHistory = ( yearStart: Date, ): Prisma.TransactionWhereInput => ({ OR: [ { legacySourceTable: null }, { legacySourceTable: { not: { startsWith: PERIOD_TABLE_PREFIX } } }, { transactionDate: { lt: yearStart } }, ], }); export interface ListParams { query?: string; page: number; pageSize: number; line?: "utility" | "insurance" | "both"; includeArchived?: boolean; } /** Parse an optional ISO date string to a Date (or null to clear it). */ function toDate(v?: string): Date | null | undefined { if (v === undefined) return undefined; if (v === "" || v === null) return null; const d = new Date(v); return isNaN(d.getTime()) ? undefined : d; } @Injectable() export class CustomersService { constructor(private readonly prisma: PrismaService) {} /** Unified customer list with search + business-line filter, paginated. */ async list({ query, page, pageSize, line, includeArchived }: ListParams) { const where: Prisma.CustomerWhereInput = {}; if (!includeArchived) where.archivedAt = null; if (query && query.trim()) { const q = query.trim(); where.OR = [ { name: { contains: q } }, { email: { contains: q } }, { phone: { contains: q } }, { mobile: { contains: q } }, { city: { contains: q } }, { legacyRefs: { some: { legacyId: { contains: q } } } }, ]; } if (line === "utility") where.properties = { some: {} }; if (line === "insurance") where.policies = { some: {} }; if (line === "both") { where.properties = { some: {} }; where.policies = { some: {} }; } const [total, rows] = await this.prisma.$transaction([ this.prisma.customer.count({ where }), this.prisma.customer.findMany({ where, skip: (page - 1) * pageSize, take: pageSize, // Nameless records last: ordering by name alone floats every // "(SIN NOMBRE)" to the top, since "(" sorts before every letter. orderBy: [{ nameMissing: "asc" }, { name: "asc" }], select: { id: true, name: true, nameSource: true, city: true, state: true, email: true, phone: true, mobile: true, status: true, archivedAt: true, _count: { select: { properties: true, policies: true, transactions: true } }, }, }), ]); const items = rows.map((r) => ({ id: r.id, name: r.name, nameSource: r.nameSource, city: r.city, state: r.state, email: r.email, phone: r.phone, mobile: r.mobile, status: r.status, archived: r.archivedAt != null, propertyCount: r._count.properties, policyCount: r._count.policies, transactionCount: r._count.transactions, hasUtilities: r._count.properties > 0, hasInsurance: r._count.policies > 0, })); return { items, total, page, pageSize, pageCount: Math.ceil(total / pageSize) }; } /** Full unified customer view: identity + both business lines + ledger. */ async detail(id: string) { // The movement list on the customer file is the same statement the office // prints, so it follows the same rule as BillingService.statement: this // calendar year, oldest-first. No `take` any more — the cap used to hide // the end of a busy customer's year once the order flipped, and a single // year is small (365 rows for the heaviest customer in the book). const yearStart = new Date(Date.UTC(new Date().getUTCFullYear(), 0, 1)); const customer = await this.prisma.customer.findUnique({ where: { id }, include: { legacyRefs: true, properties: { include: { services: true, trustAccount: true, documents: true }, }, policies: { orderBy: { policyFrom: "desc" }, include: { policyType: true, insuranceProvider: true, installments: { orderBy: { sequence: "asc" } }, vehicles: true, insuredDrivers: true, beneficiaries: true, claims: true, documents: true, }, }, transactions: { // Archives are excluded by tag, not by date. They are not cleanly // bounded — datos2@2024 carries rows dated 2022, 2023, 2025 and one // in 2026, datos2@2025 two more — so a date test alone would surface // a closed year's rows in the current year's list, duplicating the // live ledger's own copy of them for three customers. // Archives are kept out by tag, not by date. They are not cleanly // bounded — datos2@2025 carries rows dated into 2026 — so a date test // alone would surface a closed year's rows in the current year's // list. Nothing below yearStart reaches this list anyway, so the // window rule reduces to a plain exclusion here. where: { transactionDate: { gte: yearStart }, ...archiveIsHistory(yearStart), }, orderBy: [{ transactionDate: "asc" }, { id: "asc" }], include: { type: true }, }, }, }); if (!customer) { throw new NotFoundException(`Customer ${id} not found`); } // Ledger totals per domain + currency (the "one statement across both // business lines" payoff), computed in the DB rather than in JS. // // These have to answer the same question BillingService.statement answers, // because this card is titled "Estado de cuenta" and links straight to it — // two screens quoting one customer two different balances is worse than // either number alone. So it takes the same three rules the statement uses: // the balance floor, the cash-source exclusion, and dropping outstanding // rows the office has not paid yet. // // Without the floor these were a raw lifetime sum, double-counting the // pre-cutover history each BALANCE FORWARD row already absorbs. Importing // prior periods made that visibly worse: for NUMid 501 the tiles read // -7,119.29 before the archives landed and -15,270.59 after, against a true // -10,715.29 — the difference being exactly the 2024 and 2025 closing // balances, added a second time on top of the opening row that contains // them. const floor = await this.prisma.transaction.findFirst({ where: { customerId: id, voidedAt: null, type: { nameEn: BALANCE_FORWARD_TYPE }, }, orderBy: { transactionDate: "desc" }, select: { transactionDate: true }, }); const summary = await this.prisma.transaction.groupBy({ by: ["domain", "currency"], where: { customerId: id, voidedAt: null, outstanding: false, ...(floor ? { transactionDate: { gte: floor.transactionDate } } : {}), // The floor alone does not settle the archives: a customer floored by // an archive clears it with every row of that archive, and the rows // archives spill into the following January clear any floor. AND: [archiveIsHistory(yearStart), notCashJournal()], }, _sum: { amount: true }, _count: { _all: true }, }); return { ...customer, /** Calendar year the movement list covers. */ transactionYear: yearStart.getUTCFullYear(), transactionSummary: summary.map((s) => ({ domain: s.domain, currency: s.currency, total: s._sum.amount, count: s._count._all, })), }; } // --- writes --------------------------------------------------------------- private toData(dto: CreateCustomerDto | UpdateCustomerDto) { // Whitelisted by the DTO already; map the date strings to Date objects. const { identificationExpiration, customerSince, ...rest } = dto; return { ...rest, ...(identificationExpiration !== undefined && { identificationExpiration: toDate(identificationExpiration), }), ...(customerSince !== undefined && { customerSince: toDate(customerSince) }), }; } async create(dto: CreateCustomerDto) { return this.prisma.customer.create({ // App-created rows: nameMissing false (name is required), no legacy // provenance — those columns stay null, marking a native record. data: { ...this.toData(dto), name: dto.name, nameMissing: false }, }); } async update(id: string, dto: UpdateCustomerDto) { await this.ensureExists(id); return this.prisma.customer.update({ where: { id }, data: this.toData(dto) }); } /** Soft-delete: hide from default lists, keep the row + provenance. */ async archive(id: string) { await this.ensureExists(id); return this.prisma.customer.update({ where: { id }, data: { archivedAt: new Date() }, }); } async restore(id: string) { await this.ensureExists(id); return this.prisma.customer.update({ where: { id }, data: { archivedAt: null }, }); } private async ensureExists(id: string) { const found = await this.prisma.customer.findUnique({ where: { id }, select: { id: true }, }); if (!found) throw new NotFoundException(`Customer ${id} not found`); } /** Top-line counts for a dashboard header. */ async stats() { const [customers, withUtilities, withInsurance, policies, properties, transactions] = await this.prisma.$transaction([ this.prisma.customer.count(), this.prisma.customer.count({ where: { properties: { some: {} } } }), this.prisma.customer.count({ where: { policies: { some: {} } } }), this.prisma.policy.count(), this.prisma.property.count(), this.prisma.transaction.count(), ]); const bothLines = await this.prisma.customer.count({ where: { properties: { some: {} }, policies: { some: {} } }, }); return { customers, withUtilities, withInsurance, bothLines, policies, properties, transactions }; } }