Create Loan Workflow Acceptance Criteria

Owned by Kay Chau
Last updated: Apr 08, 2011Version comment
8 min read

General

  • All steps of the workflow, the headings should remain the same throughout the workflow. Noticed currently that the first step is called Select customer, but then changes to Select Client/Group when user is in the 2nd step. Use the headings below for the real headings of the workflow.
  • Localization - update all strings to follow L10n guidelines - see here ->
    • Sentences should always have a period at the end
    • Watch Capitalization - Workflow steps - sentence capitalization.  Same with labels of dropdowns, etc.  Headings should be capitalized though.
    • Remove unused strings - tech debt
  • Currently if you created another loan previously, and then you enter this pipeline again, it pre-populates w/ the previous values - we should not be doing this
  • http://mifosforge.jira.com/wiki/display/MIFOS/FreeMarker+Developer+Testing+Checklist must also be verified
  • Currently you can hit back button on your browser to go back in the flow ... see if this is still the same
  • There was a bug that Collateral Notes were not saved - ensure that this works after this workflow is redone

First Step: Select customer

  • Workflow step changes to Select Client/Group instead of Select customer.  Leave as Select customer.
  • 2 links to still reach this step from: "Open new loan account" from home page left bar, and "Create loan account" from Clients & Accounts page's left bar.
  • Text at the top changes to the following (keep same fonts) -

    Create Loan Account - Select Customer

    Enter a Client or Group name and click Search. Click Cancel to return to Clients & Accounts without submitting information.

  • Name box remains the same, with same width, same allowable characters, and same # of characters
  • If user clicks Search with nothing entered into the Name box, same error message is displayed - Please specify customer name to be searched.
  • Search and Cancel buttons remain the same - colors, etc
  • If user clicks Cancel, user is returned to Clients & Accounts page - even if they enter workflow from Homepage
  • When Search term is entered, only active clients and groups are returned.  Search only searches client and group names.  If the client and/or group is in any other state (pending approval, on hold, closed, ...) then it is not returned
  • If the search term matches multiple results (both clients and groups), all results are returned
  • Results are sorted the same as they are now?
  • Additional notes in Search Acceptance Criteria

Second Step: Loan account information

Select Loan Product

  • 2 possible places to reach this step from: the above first step, or directly from a client's or group's details page "Open new account: Loan"
  • Text changes to the following (keep same fonts) - sometimes I see it says Continue, sometimes it says Preview - it should say Continue.

    Create Loan Account  -  Enter Loan Account Information

    Select a Loan Product.  Then click Continue. Click Cancel to return to Clients & Accounts without submitting information.
    *Fields marked with an asterisk are required.

  • Account Owner: leave string, but also put client or group name selected after it.  IE: Account Owner: Jenny Apelo
  • Loan instance name: -> rename to Loan product.  Keep red asterisk.
  • If user clicks Cancel, user is returned to Clients & Accounts page
  • Continue and Cancel buttons remain the same
  • If user clicks Continue with selecting a loan product, error message appears rename to - Please select a loan product.
  • Loan products that are populated
    • Only active loan products are available.  State is determined by status of loan product only.  (Start and End dates of loan products will be removed).
    • If this account is for a client, only loan products applicable to clients are available.  Same for groups
    • Currently, if LSIM is not on, loan products with variable loan installments is not allowed.  If we keep LSIM for now, this constraint remains
    • Right now, only loan products that match frequency of client's meeting are shown - keep this right now, but when we refactor this will change.

Loan Product Summary

  • After loan product is selected, the same details should appear except "Principal due on last installment: No".  This needs to be removed (functionality has been removed)

Account Details

  • Capitalize Details
  • Same fields remain, and default to amounts set in Loan product defaults for the ones that have values from loan products
  • Source of Funds and Purpose of Loan can be made mandatory by the MFI in "Hidden/Mandatory fields" - ensure that this remains the same
  • All mandatory fields still have red asterisk, and error messages appear if they are not filled in
  • For all fields - display no error messages about string conversion errors
  • There are error messages if mandatory fields are not filled in, or they are not within the range specified by loan product, or the wrong character is entered (like letters where we expect numbers).  The same error message (to specify a valid xxx) should be displayed for all types of errors
  • Amount field
    • Currently 2 error messages appear if it is not filled in.
      • Please specify valid Amount. Amount should be a value between 100 and 10,000, inclusive.
      • The Amount is invalid because string conversion error
    • Only the first one is needed. The values in the string are from the loan product.
    • If you enter in a non-number then the first error message should still be displayed.  Change error message to Please specify valid loan amount. Amount allowed is between 100 and 10,000. 
    • If you enter in a value with more than the digits after decimal allowed, change error message to
      • Loan amount is invalid because number of digits after the decimal entered is greater than 1.
  • Interest rate
    • Same as Amount field, only display the following error message - Please specify valid interest rate. Interest rate allowed is between 24 and 30.
    • Change current error message for digits after decimal to - Interest rate is invalid because number of digits after the decimal entered is greater than 5.
  • No. of installments field - rename to Number of installments
    • Currently the user is not allowed to enter in anything other than a number for this field, move this validation to server-side.
    • Display changed error message if No. of Installments is not within range - Please specify valid number of installments. Allowed number of installments is between 2 and 24.
  • Disbursal Date is defaulted to the next available disbursal date** Logic for Disbursal Date - is this in the backend?  Keep all logic the same for determining valid disbursal date (next meeting, holidays)** If disbursal date is not filled in, display same error message - Please specify a valid disbursal date.** Change to date picker
  • Repayment day box remains the same - same frequency is available, while the other is grayed out - GK wants to be able to change this
    • If the Recur every <blank> field is not filled in, display same error message - Please specify a repayment day.
    • Currently if you have months, there's 2 options for months - with number of months grayed out.  All this behavior remains, and also if you try to change one option that that option is automatically selected.
    • Change "If months, select between the following:" to "Select between the following:"
  • Grace period for repayments - field remains the same, and grayed out, defaulted to what was set in the loan product
  • Rename Source of fund to Source of funds (Mifos-2668).
    • If this is not selected and is mandatory, change error message to Please specify source of funds.
  • Purpose of loan - rename to Loan Purpose
    • If this is not selected and is mandatory, change error message to Please specify loan purpose.
  • Collateral type, Collateral notes, and External ID boxes stay the same - just change capitalization

Administrative Set Fees

  • Change wordings to "Frequency: One Time" or "Frequency: 1 week(s)", etc.
  • Continue to allow to edit one-time fees, and if edited, is updated to new numbers
    • Continue to validate for digits after decimal for loan fees, change error message to "<Name of Fee> amount is invalid because number of digits after the decimal is greater than <1>."
  • Continue to allow removal, and if so, fees are removed from this loan
  • Currently if you clear out an amount of a default one-time fee, and also click the "Check to Remove" box, an error is thrown.  Instead, the Check to Remove box should override this and allow the user to continue, while removing the fee.

Apply Additional Fees

  • Continue to allow applying additional loan fees
  • Only active loan fees that match the frequency for this loan are displayed
  • If a user enters in a value without selecting a fee, right now it throws a stacktrace, it should throw an error to say "Please select an additional fee or remove amount entered."

(Optional) page: QG's

  • Keep QG's under Loan Account Information step
  • Display all QG questions within workflow box like other steps of this workflow
  • Move Continue and Cancel buttons to the same place in page as other pages
  • No left nav bar

Third Step: Review installments

Keep everything the same except..

  • Big gap between Account Owner and Loan Amount?
  • Standardize strings here again with capitalization.  It should be Loan amount:
  • Due Date should be two words
  • change Amount due to Amount Due in Installments table
  • Add Fees heading above Fees - same font as Installments
  • Align "Amount" to same line - example below
  • Periodic Loan Fee            Amount: 1.0
    Loan Application Fee        Amount: 55

Special Case: Variable Loan Installments

  • TBD

Special Case: Cash Flow, GLIM, LSIM, Multi-Currency Loan

  • TBD

Fourth Step: Review & submit

  • Continue to display all information except
    • Principal due on last installment : No <- don't need this anymore
    • Instance information ->  remove this subheading
  • The headings for each section should be - Loan Account Information, Installments, Additional Information. Currently QG has no heading, and Loan Account Information isn't capitalized. Also each heading has different fonts and sizes - stay consistent - use the same as Loan account information
  • I find it odd to have a button that says "Edit loan schedule information" after Installments when all it does is take me to the Review Installments page - I assume this is only needed for Variable Loan Installments? Maybe remove this button if it's not needed - also might be necessary in Redo Loan but not here.
  • Under Additional Information - everything is bolded - only bold Section headings, and unbold other text
  • Keep same buttons at the bottom - Save For Later, Submit for Approval, Cancel
  • change from Loan instance name to Loan product
  • Remove interest deducted at disbursement
  • Rename to Source of funds
  • Rename to Loan purpose
  • Follow sentence capitalization