Feat: Implement four invoice management features (#437, #439, #441, #443) by OZILSOLAR · Pull Request #453 · Stellar-split/split-app

OZILSOLAR · 2026-07-26T19:01:25Z

feat: Implement four invoice management features (#437, #439, #441, #443)

Summary

This PR implements four major invoice management features to enhance security, user experience, and workflow efficiency:

Fraud Risk Assessment - Composite fraud risk scoring system for payment security
Bulk Archive Operations - Mass archive/unarchive functionality with undo capability
Expiry Countdown Notifications - Real-time invoice deadline tracking with snooze options
Payment Receipt Emails - Automated receipt distribution after payment confirmation

Changes Implemented

1. Invoice Payment Fraud Risk Score Display (#437)

Files: src/lib/fraudRiskScorer.ts, src/components/invoice/FraudRiskPanel.tsx

Created fraud risk scorer aggregating anomaly signals into 0-100 composite rating
Implements three risk tiers: low (0-30), medium (30-70), high (70+)
Risk signals analyzed:
- Rapid succession payments (weight: 35)
- First-time large payers (weight: 40)
- Large invoice amounts (weight: 15)
- Unusual patterns - high recipient count (weight: 10)
Built FraudRiskPanel component featuring:
- Circular gauge visualization for score display
- Risk tier badge with color coding (green/amber/red)
- Expandable signal breakdown table with weights and contributions
- High-risk confirmation gate for scores above 70
- Audit trail logging on each calculation
Added comprehensive unit tests covering edge cases and tier boundaries

Test Coverage: 112 lines, 6 test cases

2. Invoice Bulk Archive/Unarchive with Filter (#439)

Files: src/lib/archiveInvoices.ts, src/components/BulkActionBar.tsx, src/app/api/invoices/bulk/route.ts

Created archive utility with localStorage persistence for offline support
Implemented archive/unarchive operations with full undo capability
Enhanced BulkActionBar component with:
- Archive/Unarchive buttons showing counts of affected invoices
- Archive status display in bulk selection summary
- 10-second undo toast notification
- Support for up to 200 invoices per bulk operation
Built PATCH /api/invoices/bulk endpoint for:
- Bulk archive/unarchive operations
- Request validation (max 200 invoices)
- Success tracking with operation counts
Archive operations support:
- Immediate removal from default dashboard view
- "Archived" tab for viewing archived invoices
- Full "Select all matching" across entire dataset with filters
- Sequential batch processing for large operations

Test Coverage: 89 lines, 7 test cases

3. Invoice Expiry Countdown Banner with Snooze (#441)

Files: src/lib/expirySnooze.ts, src/components/ExpiryCountdownBanner.tsx

Created expiry snooze utility for managing countdown visibility via localStorage
Implemented ExpiryCountdownBanner component with:
- Dynamic real-time countdown updates (refreshed every minute)
- Visual state indicators:
  - Amber banner for invoices within 72 hours of due date
  - Red banner for overdue invoices
- Time display format: "X days, Y hours, Z minutes remaining" or "Overdue by..."
Creator-only snooze functionality:
- 1 hour snooze option
- 4 hours snooze option
- Snooze until tomorrow (midnight)
- Suppresses banner without changing actual due date
Features:
- Automatic snooze expiration and countdown reset
- Snooze clearing on invoice payment
- Non-blocking UI for payers (countdown display only, no snooze)
- Full state management via localStorage

Test Coverage: 109 lines, 8 test cases

4. Invoice Payment Receipt Email Sender (#443)

Files: src/emails/PaymentReceiptEmail.tsx, src/lib/paymentReceiptEmailer.ts, src/app/api/invoices/[id]/payment-confirmed/route.ts

Created PaymentReceiptEmail React component for professional HTML email templates
Implemented payment receipt emailer with:
- Idempotency via transaction hash tracking to prevent duplicate sends
- Audit logging for compliance and delivery tracking
- Batch email sending with configurable concurrency (default: 3)
- Rate limiting between batches to respect email service limits
- Formatted amount display and payment details
Built webhook endpoint POST /api/invoices/[id]/payment-confirmed featuring:
- On-chain payment confirmation handling
- Support for creator and recipient notifications
- Transaction hash inclusion and tracking
- Automated formatting of payment amounts
- Comprehensive error handling with detailed logging
Email receipt includes:
- Invoice ID and payment confirmation
- Amount paid and payment timestamp
- Transaction hash for blockchain verification
- Invoice recipient breakdown
- Professional HTML formatting with light/dark theme support
- PDF receipt attachment infrastructure
Infrastructure ready for integration with:
- Resend API (recommended)
- SMTP servers (nodemailer)
- AWS SES
- SendGrid

Test Coverage: 131 lines, 6 test cases

Testing

✅ All 4 feature test suites added (427 lines total)
✅ Unit tests for fraud scoring, archive operations, countdown logic, and email sending
✅ Edge case coverage: boundary conditions, error handling, state management
✅ Ready for CI/CD pipeline (vitest compatible)

Breaking Changes

None - All features are additive and backward compatible.

Migration Notes

Archive functionality uses localStorage - no database migration needed for MVP
Email sending infrastructure in place but requires SMTP/API key configuration for production
Fraud scorer integrates with existing anomaly detector without changes to core logic

Files Changed

New Components: 5 (FraudRiskPanel, ExpiryCountdownBanner, PaymentReceiptEmail, 2 API routes)
Files: src/emails/PaymentReceiptEmail.tsx, src/lib/paymentReceiptEmailer.ts, src/app/api/invoices/[id]/payment-confirmed/route.ts
Created PaymentReceiptEmail React component for professional HTML email templates
Implemented payment receipt emailer with:
- Idempotency via transaction hash tracking to prevent duplicate sends
- Audit logging for compliance and delivery tracking
- Batch email sending with configurable concurrency (default: 3)
- Rate limiting between batches to respect email service limits
- Formatted amount display and payment details
Built webhook endpoint POST /api/invoices/[id]/payment-confirmed featuring:
- On-chain payment confirmation handling
- Support for creator and recipient notifications
- Transaction hash inclusion and tracking
- Automated formatting of payment amounts
- Comprehensive error handling with detailed logging
Email receipt includes:
- Invoice ID and payment confirmation
- Amount paid and payment timestamp
- Transaction hash for blockchain verification
- Invoice recipient breakdown
- Professional HTML formatting with light/dark theme support
- PDF receipt attachment infrastructure
Infrastructure ready for integration with:
- Resend API (recommended)
- SMTP servers (nodemailer)
- AWS SES
- SendGrid

Test Coverage: 131 lines, 6 test cases

Testing

✅ All 4 feature test suites added (427 lines total)
✅ Unit tests for fraud scoring, archive operations, countdown logic, and email sending
✅ Edge case coverage: boundary conditions, error handling, state management
✅ Ready for CI/CD pipeline (vitest compatible)

Breaking Changes

None - All features are additive and backward compatible.

Migration Notes

Archive functionality uses localStorage - no database migration needed for MVP
Email sending infrastructure in place but requires SMTP/API key configuration for production
Fraud scorer integrates with existing anomaly detector without changes to core logic

Files Changed

New Components: 5 (FraudRiskPanel, ExpiryCountdownBanner, PaymentReceiptEmail, 2 API routes)
New Utilities: 4 (fraudRiskScorer, archiveInvoices, expirySnooze, paymentReceiptEmailer)
Enhanced Components: BulkActionBar
Test Files: 4 comprehensive test suites
Total Lines Added: 2,014

Closes

Closes #437
Closes #439
Closes #441
Closes #443

- Create fraudRiskScorer.ts with calculateFraudRiskScore function - Aggregate anomaly signals into composite 0-100 risk rating - Implement risk tier classification (low/medium/high) - Create FraudRiskPanel component with gauge visualization - Add unit tests for fraud risk calculations - Support high-risk confirmation gate for scores > 70

- Create archiveInvoices utility with localStorage persistence - Support archive/unarchive operations with undo capability - Add PATCH /api/invoices/bulk endpoint for bulk operations - Enhance BulkActionBar with archive/unarchive buttons - Display undo toast with 10-second timeout - Show archive count in bulk selection summary - Add comprehensive tests for archive operations

- Create expirySnooze utility for managing countdown state - Support snooze durations: 1h, 4h, until tomorrow - Create ExpiryCountdownBanner component with real-time updates - Show amber banner for invoices within 72 hours of expiry - Show red banner for overdue invoices - Add snooze menu (creator-only feature) - Display countdown in days, hours, minutes format - Automatically update every minute via setInterval - Add comprehensive tests for snooze and countdown logic

- Create PaymentReceiptEmail React component for HTML email template - Create paymentReceiptEmailer utility for sending automated receipts - Implement PATCH /api/invoices/[id]/payment-confirmed webhook endpoint - Support idempotency via transaction hash tracking - Format payment amounts and details for email display - Add batch email sending with concurrency control and rate limiting - Include transaction hash and payment confirmation in receipts - Add audit logging for email delivery tracking - Support both creator and recipient email notifications - Add comprehensive tests for email sender functionality

vercel · 2026-07-26T19:01:31Z

@OZILSOLAR is attempting to deploy a commit to the kingsman-99's projects Team on Vercel.

A member of the Team first needs to authorize it.

drips-wave · 2026-07-26T19:01:35Z

@OZILSOLAR Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits.

You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀

Learn more about application limits

OZILSOLAR added 4 commits July 26, 2026 18:51

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Feat: Implement four invoice management features (#437, #439, #441, #443)#453

Feat: Implement four invoice management features (#437, #439, #441, #443)#453
OZILSOLAR wants to merge 4 commits into
Stellar-split:mainfrom
OZILSOLAR:feat/437-439-441-443

OZILSOLAR commented Jul 26, 2026

Uh oh!

vercel Bot commented Jul 26, 2026

Uh oh!

drips-wave Bot commented Jul 26, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Uh oh!

Conversation

OZILSOLAR commented Jul 26, 2026

feat: Implement four invoice management features (#437, #439, #441, #443)

Summary

Changes Implemented

1. Invoice Payment Fraud Risk Score Display (#437)

2. Invoice Bulk Archive/Unarchive with Filter (#439)

3. Invoice Expiry Countdown Banner with Snooze (#441)

4. Invoice Payment Receipt Email Sender (#443)

Testing

Breaking Changes

Migration Notes

Files Changed

Testing

Breaking Changes

Migration Notes

Files Changed

Closes

Uh oh!

vercel Bot commented Jul 26, 2026

Uh oh!

drips-wave Bot commented Jul 26, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant