Update seatmap and add cron job for payment status

apps/edr-passenger-api/src/modules/tasks/tasks.module.ts

@@ -0,0 +1,10 @@
+import { Module } from '@nestjs/common';
+import { PrismaModule } from '../../common/prisma.module';
+import { NotificationsModule } from '../notifications/notifications.module';
+import { TasksService } from './tasks.service';
+
+@Module({
+  imports: [PrismaModule, NotificationsModule],
+  providers: [TasksService],
+})
+export class TasksModule {}

apps/edr-passenger-api/src/modules/tasks/tasks.service.ts

@@ -0,0 +1,205 @@
+import { Injectable, Logger } from '@nestjs/common';
+import { Cron } from '@nestjs/schedule';
+import { PrismaService } from '../../common/prisma.service';
+import { SmsClientService } from '../notifications/sms-client.service';
+
+/** Minutes before departure at which each action fires. */
+const REMINDER_MINUTES = 3 * 60;   // 3 h → send payment reminder SMS
+const DEADLINE_MINUTES  = 2 * 60;  // 2 h → cancel unpaid booking
+
+/** Half-width of the reminder detection window (cron runs every 2 min). */
+const REMINDER_WINDOW_MINUTES = 2;
+
+function fmtTime(d: Date): string {
+  return d.toLocaleTimeString('en-GB', {
+    hour: '2-digit',
+    minute: '2-digit',
+    timeZone: 'Africa/Addis_Ababa',
+  });
+}
+
+@Injectable()
+export class TasksService {
+  private readonly logger = new Logger(TasksService.name);
+
+  constructor(
+    private readonly prisma: PrismaService,
+    private readonly sms: SmsClientService,
+  ) {}
+
+  // ─────────────────────────────────────────────────────────────────────────
+  // Every 2 min: advance TrainSchedule statuses (departure / arrival).
+  // ─────────────────────────────────────────────────────────────────────────
+  @Cron('*/2 * * * *')
+  async syncScheduleStatuses() {
+    const now = new Date();
+
+    const [departed, arrived] = await Promise.all([
+      this.prisma.trainSchedule.updateMany({
+        where: { status: 'SCHEDULED', departureAt: { lte: now } },
+        data: { status: 'EN_ROUTE' },
+      }),
+      this.prisma.trainSchedule.updateMany({
+        where: { status: { in: ['EN_ROUTE', 'BOARDING'] }, arrivalAt: { lte: now } },
+        data: { status: 'ARRIVED' },
+      }),
+    ]);
+
+    if (departed.count > 0 || arrived.count > 0) {
+      this.logger.log(
+        `Schedule sync: ${departed.count} → EN_ROUTE, ${arrived.count} → ARRIVED`,
+      );
+    }
+  }
+
+  // ─────────────────────────────────────────────────────────────────────────
+  // Every 2 min: payment deadline enforcement.
+  //
+  //   • 3 h before departure → send one SMS reminder to complete payment.
+  //   • 2 h before departure → cancel booking if payment is still pending
+  //                            and notify the passenger by SMS.
+  //
+  // Example: train departs 08:00
+  //   05:00  → reminder SMS sent  ("pay before 06:00 or booking is cancelled")
+  //   06:00  → booking auto-cancelled, cancellation SMS sent
+  // ─────────────────────────────────────────────────────────────────────────
+  @Cron('*/2 * * * *')
+  async enforcePaymentDeadlines() {
+    const now = new Date();
+
+    await Promise.all([
+      this.sendPaymentReminders(now),
+      this.cancelExpiredPendingBookings(now),
+    ]);
+  }
+
+  // ── 3-hour reminder ───────────────────────────────────────────────────────
+  private async sendPaymentReminders(now: Date) {
+    // Narrow 4-minute window (±2 min around the 3-hour mark) so each booking
+    // is caught by exactly one cron tick and paymentReminderSentAt guards re-sends.
+    const windowMs = REMINDER_WINDOW_MINUTES * 60 * 1000;
+    const reminderMs = REMINDER_MINUTES * 60 * 1000;
+
+    const windowStart = new Date(now.getTime() + reminderMs - windowMs);
+    const windowEnd   = new Date(now.getTime() + reminderMs + windowMs);
+
+    const bookings = await this.prisma.booking.findMany({
+      where: {
+        status: 'PENDING_PAYMENT',
+        paymentReminderSentAt: null,
+        schedule: { departureAt: { gte: windowStart, lte: windowEnd } },
+      } as any,
+      include: {
+        schedule: {
+          include: {
+            originStation:      { select: { name: true } },
+            destinationStation: { select: { name: true } },
+          },
+        },
+      },
+    });
+
+    for (const booking of bookings) {
+      try {
+        const dep      = booking.schedule.departureAt as Date;
+        const deadline = new Date(dep.getTime() - DEADLINE_MINUTES * 60 * 1000);
+        const origin   = booking.schedule.originStation?.name ?? '';
+        const dest     = booking.schedule.destinationStation?.name ?? '';
+
+        const message =
+          `EDR: Your booking ${booking.bookingRef} ` +
+          `(${origin} → ${dest}) departs at ${fmtTime(dep)}. ` +
+          `Complete payment by ${fmtTime(deadline)} or your booking will be cancelled.`;
+
+        if (booking.contactPhone) {
+          await this.sms.sendSms({ to: booking.contactPhone, message }).catch(() => null);
+        }
+
+        await this.prisma.booking.update({
+          where: { id: booking.id },
+          data: { paymentReminderSentAt: now } as any,
+        });
+
+        this.logger.log(
+          `Payment reminder sent: ${booking.bookingRef} (departs ${fmtTime(dep)}, deadline ${fmtTime(deadline)})`,
+        );
+      } catch (err) {
+        this.logger.error(
+          `Reminder failed for ${booking.bookingRef}: ${err instanceof Error ? err.message : String(err)}`,
+        );
+      }
+    }
+  }
+
+  // ── 2-hour auto-cancel ────────────────────────────────────────────────────
+  private async cancelExpiredPendingBookings(now: Date) {
+    const cutoff = new Date(now.getTime() + DEADLINE_MINUTES * 60 * 1000); // now + 2 h
+
+    const expiredBookings = await this.prisma.booking.findMany({
+      where: {
+        status: 'PENDING_PAYMENT',
+        schedule: { departureAt: { lte: cutoff } },
+      },
+      include: {
+        schedule: {
+          include: {
+            originStation:      { select: { name: true } },
+            destinationStation: { select: { name: true } },
+          },
+        },
+        paymentIntent: { select: { method: true } },
+      },
+    });
+
+    for (const booking of expiredBookings) {
+      try {
+        // 1. Release held seats (Journey rows are the occupancy source of truth)
+        await this.prisma.journey.deleteMany({ where: { bookingId: booking.id } as any });
+
+        // 2. Audit record (no refund — payment was never completed)
+        await this.prisma.bookingCancellation.create({
+          data: {
+            bookingId:    booking.id,
+            cancelledBy:  'SYSTEM',
+            reason:       'Payment not completed before departure deadline',
+            refundAmount: 0,
+            refundMethod: booking.paymentIntent?.method ?? 'NONE',
+            refundStatus: 'NOT_APPLICABLE',
+          },
+        }).catch(() => null); // booking may already have a cancellation record
+
+        // 3. Mark cancelled
+        await this.prisma.booking.update({
+          where: { id: booking.id },
+          data: { status: 'CANCELLED' },
+        });
+
+        // 4. Notify passenger
+        const dep    = booking.schedule.departureAt as Date;
+        const origin = booking.schedule.originStation?.name ?? '';
+        const dest   = booking.schedule.destinationStation?.name ?? '';
+
+        const message =
+          `EDR: Your booking ${booking.bookingRef} ` +
+          `(${origin} → ${dest}, departs ${fmtTime(dep)}) has been cancelled ` +
+          `because payment was not completed before the deadline.`;
+
+        if (booking.contactPhone) {
+          await this.sms.sendSms({ to: booking.contactPhone, message }).catch(() => null);
+        }
+
+        this.logger.log(
+          `Auto-cancelled: ${booking.bookingRef} (payment deadline expired, departs ${fmtTime(dep)})`,
+        );
+      } catch (err) {
+        this.logger.error(
+          `Auto-cancel failed for ${booking.bookingRef}: ${err instanceof Error ? err.message : String(err)}`,
+        );
+      }
+    }
+
+    if (expiredBookings.length > 0) {
+      this.logger.log(`Auto-cancelled ${expiredBookings.length} expired pending booking(s)`);
+    }
+  }
+}