Evergreen farms (pos)

Automated Past-Due & Grace Period Lockout (Dunning)¶

Implemented automated dunning and access management for subscriptions with payment failures:

1. Grace Period Management

• Configured 7-day grace window (`gracePeriodDays: 7`) with automatic `graceEndsAt` calculation upon payment failure.
• Company Profile reflects remaining grace days and lockout warning (`Auto-Suspend`).

2. Background Dunning Automation

• Implemented `processPastDueGraceExpirations` in tenant billing service:
  - Scans hourly for companies in `past_due` status whose `graceEndsAt <= now`.
  - Automatically transitions expired accounts to `suspended`.
  - Records suspension entry in `saasBillingActionHistory`.
  - Dispatches account suspension email with reactivation link.

3. RBAC & Access Enforcement

• Updated `rbac.service.js`:
  - Grants full operational POS access while within active grace window (`new Date() <= graceEndsAt`).
  - Restricts access with HTTP 403 error once grace period has elapsed or when status is `suspended`.

4. Verification on Tenant divya@yopmail.com

• Tested `past_due` status transition on tenant `6ad07533f1752405cfbccf1b`:
  - Status confirmed `past_due`.
  - Grace period calculated correctly (5 days remaining).
  - Stripe action history logged in `saasBillingActionHistory`.
  - Operational access preserved during grace window.