Skip to Content
Ranlanka CRM documentation — pre-release, subject to change.
Changelog2026-10-11

2026-10-11

  • Finance & Invoicing: Renewed Invoice & Payment Receipt PDF Formats — redesigned invoice-template.html (InvoicePdfService) and receipt-template.html (ReceiptPdfService) under unified “Ranlanka Travel & Visa Consultancy Services” branding. Invoices now strictly present itemized charges, statutory fee sub-notes (Statutory Consular / Embassy Disbursement, Agency Facilitation & Professional Handling Fee, Overdue Passport Safe Vault Custody Charge), tax/discount rows, and the final Total Amount without payment history or exchange rate rows. Payment Receipts use the direct invoiced currency (LKR, USD, etc.), display customer NIC/Passport and residential address, include per-payment notes, and embed Sri Lanka PDPA (Act No. 9 of 2022) and 7-day passport safe custody disclosures. Commented-out statutory registration (BR No., TIN, VAT/SSCL, CAASL/SLTDA) and corporate bank coordinate blocks are pre-wired in both templates and PDF services for future activation.
  • Bookings & Finance: Single-Query Overdue Passport Custody (> 7 Days) for Approved & Rejected Visas — embedded the 7-day overdue custody indicator directly into VisaRequestRepository single-pass LEFT JOIN projections (CAST(v.status AS string) IN ('approved', 'rejected')) to avoid $N+1$ queries. Populates isPassportCustodyOverdue, passportCustodyDaysHeld, and passportCustodyDaysOverdue on VisaResponseDTO, InvoiceResponseDTO, and InvoiceRequestLinkDTO. On the frontend, TaskListView and AdminTaskTable render a compact circular amber Info (i) icon that displays the overdue details on hover, while VisaDetailPanel, InvoiceDetailModal, and EditInvoiceModal surface actionable custody fee notices (LKR 500/week or LKR 100/day).
  • Logging & Monitoring: Clean Single-Line Error & Exception Logging — introduced ErrorLogFormatter.summarize(Throwable) across RepositoryLoggingAspect, GlobalExceptionHandler, ReminderSchedulerService, RanlankaApiApplication’s custom TaskScheduler error handler, and service-level catch blocks, alongside logging.level.org.hibernate.engine.jdbc.spi.SqlExceptionHelper=OFF. Replaces multi-page stack traces and 1,000-character Hibernate SQL dumps with a single concise log line showing [TopException -> RootCauseException] root cause message (at ClassName.method:line).
  • Scheduled Digests: Admin Data → Triggers Page, Protected On-Demand Endpoints & Agency Contact Defaults — added a dedicated Admin Data → Triggers page (/admin/triggers, AdminTriggersPage.tsx) alongside protected admin endpoints (@PreAuthorize("hasAuthority('REMINDER_SETTINGS_MANAGE')")) in ReminderSettingsController to manually re-trigger any scheduled digest for a configurable target date/month if a scheduled cron run is missed or fixed after an error: POST /api/v1/reminder-settings/trigger-weekly-digest, POST /api/v1/reminder-settings/trigger-daily-digest, POST /api/v1/reminder-settings/trigger-approved-visa-digest, POST /api/v1/reminder-settings/trigger-monthly-digest, and POST /api/v1/reminder-settings/run-now. Configured default agency coordinates (app.company.email, app.company.phone, app.company.mobile, app.company.address) in application*.properties and wired them into the Invoice and Receipt PDF headers.
Last updated on