BACKEND - Closing declared lost loan (Lost and paid status) for actual cost

Updates on February 7: Holly was asked to split scenarios 1-6 from UIU-1605 into a separate backend story, This is the BE story.

Purpose: Close the loan for a declared lost item with a lost item fee policy stipulating actual cost. Reflect the closed loan in the loan details and user's loan history.

Two potential triggers for closing the loan are described in this story:

• User pays actual cost (and lost item processing fee, if applicable), and there is neither an open actual cost fee nor an open lost item processing fee associated with the loan (see scenarios 1-2)
• Enough time elapses after the item has been declared lost without the actual cost fee being charged (see scenarios 5-6)
  • This trigger should be ignored if there is still an open lost item processing fee associated with the loan, or if the actual cost fee has in fact been charged (see scenarios 3-4)

Scenarios

1. Scenario
   • Given a loan for a declared lost item with the following qualities:
     • Lost item fee policy:
       • charge amount set to Actual cost
       • “For lost items not charged a fee/fine” interval X
       • lost item processing fee = 0 or not charged for declared lost items
     • actual cost fee has been charged and is open
   • When the actual cost fee is paid
   • Then:
     • close the loan
     • change the item status to lost and paid
2. Scenario
   • Given a loan for a declared lost item with the following qualities:
     • Lost item fee policy:
       • charge amount set to Actual cost
       • “For lost items not charged a fee/fine” interval X
       • lost item processing fee > 0
     • actual cost fee has been charged and is open
   • When both the actual cost fee and lost item processing fee are closed
   • Then
     • close the loan
     • change the item status to lost and paid
3. Scenario
   • Given a loan for a declared lost item with the following qualities:
     • Lost item fee policy:
       • charge amount set to Actual cost
       • “For lost items not charged a fee/fine” interval X
       • lost item processing fee = 0 or not charged for declared lost items
     • actual cost fee has been charged and is open
   • When time X elapses
   • Then:
     • do not close the loan
     • do not change the item status to lost and paid
4. Scenario
   • Given a loan for a declared lost item with the following qualities:
     • Lost item fee policy:
       • charge amount set to Actual cost
       • “For lost items not charged a fee/fine” interval X
       • lost item processing fee > 0
     • the actual cost fee, the lost item processing fee, or both are open
   • When time X elapses
   • Then:
     • do not close the loan
     • do not change the item status to lost and paid
5. Scenario
   • Given a loan for a declared lost item with the following qualities:
     • Lost item fee policy:
       • charge amount set to Actual cost
       • “For lost items not charged a fee/fine” interval X
       • lost item processing fee > 0
     • lost item processing fee is closed
     • not actual cost fee has been charged
   • When time X elapses
   • Then:
     • close the loan
     • change the item status to lost and paid
6. Scenario
   • Given a loan for a declared lost item with the following qualities:
     • Lost item fee policy:
       • charge amount set to Actual cost
       • “For lost items not charged a fee/fine” interval X
       • lost item processing fee = 0 or not charged for declared lost items
     • actual cost fee has not been charged
   • When time X elapses
   • Then:
     • close the loan
     • change the item status to lost and paid

Notes:

• If the Actual cost fee has not been charged to the patron yet, but is expected according to the fee/fine policy, the loan should not be closed.
• Whether or not an Actual cost fee is owed should be determined when the item is declared lost. If some aspect determining the circulation rule/lost item fee policy changes between when the item was declared lost and when the fees were charged or paid, adhere to the lost item fee policy in place when the item was declared lost.
• Other fees or fines may exist on the loan that are not related to its being declared lost. These should not block the loan from closing once all lost item fees are paid.