Skip to content

Release v1.2.0

Choose a tag to compare

@github-actions github-actions released this 09 Jan 12:44
· 236 commits to main since this release

Release version 1.2.0: Mandate Management System

  • Complete mandate lifecycle management system for SEPA Direct Debit
  • MandateService with full CRUD operations
  • MandateRepository with in-memory implementation
  • MandateStatus enum (ACTIVE, EXPIRED, REVOKED, SUSPENDED)
  • MandateHistory tracking for all changes
  • Enhanced Mandate model with expiration and revocation support
  • Sequence type transition validation
  • Comprehensive test coverage (12 new tests)
  • Demo endpoints for mandate management
  • Backward compatible, no breaking changes

Changelog

Added

  • Mandate Management: Complete mandate lifecycle management system for SEPA Direct Debit
    • MandateService - Service for managing mandate lifecycle (create, suspend, reactivate, revoke)
    • MandateRepositoryInterface and MandateRepository - Repository pattern for mandate storage
    • MandateStatus enum - Status enumeration (ACTIVE, EXPIRED, REVOKED, SUSPENDED)
    • MandateHistory - History tracking for mandate changes
    • Enhanced Mandate model with status, expiration date, and revocation support
    • Mandate expiration date validation (defaults to 36 months after signature date)
    • Mandate sequence type transition validation (FRST → RCUR/FNAL, RCUR → RCUR/FNAL, etc.)
    • Mandate history tracking for all status and sequence type changes
    • createMandate() - Create new mandates
    • updateSequenceType() - Update mandate sequence type with validation
    • revokeMandate() - Revoke mandates with optional reason
    • suspendMandate() - Suspend mandates temporarily
    • reactivateMandate() - Reactivate suspended mandates
    • validateMandateForTransaction() - Validate mandates before use in transactions
    • isValidSequenceTransition() - Check if sequence type transitions are valid
    • findMandatesByDebtorIban() - Find all mandates for a debtor
    • findActiveMandates() - Find all active mandates
    • findExpiredMandates() - Find expired mandates
    • getMandateHistory() - Get complete history for a mandate
    • In-memory repository implementation (can be extended with database-backed implementation)
    • Comprehensive test coverage with 12 test cases
    • Demo endpoints: /demo-mandate-management, /demo-mandate-lifecycle, /demo-mandate-sequence-transitions