prep for reload/raastas part 2

docs/thijooree/20-transfer-flows.md

@@ -35,7 +35,40 @@ The raw "To" field input is normalised first (spaces stripped, `+960`/`960` coun
 
 ## Recipient Lookup
 
-Lookup behaviour depends on the **source account's bank**.
+Lookup behaviour depends on the **source account's bank**, or on there being no source yet.
+
+### Transfer Type picker
+
+When a lookup offers exactly one transfer type, it is picked automatically and no popup is shown. When it offers more than one, a **"Transfer type for <number>"** popup opens straight away. The options are laid out as a grid of tiles, up to three per row (`item_transfer_type.xml`). Each tile shows the type's icon, its label and a subtitle (the recipient name, plus "via Fahipay" for Fahipay services). Fahipay services also show a small Fahipay logo badge on the icon's bottom corner (`TransferType.badgeRes`). Nothing is preselected, and Send stays disabled until the user picks one.
+
+The popup can't be dismissed by tapping outside it or pressing back until a type has been picked. **Cancel** drops the options and brings the "To" field back for editing. Once a type is picked and the lookup offered more than one, tapping the recipient card reopens the popup to change it. Cancel then keeps the current pick.
+
+Each option is a `TransferType` (`ui/home/transfer/TransferType.kt`):
+
+| Type | Label | Icon | Pays from |
+|---|---|---|---|
+| `Favara(info)` | Favara Transfer | `favara_logo` | MIB or BML account |
+| `Fahipay(service, ownerName)` | the service's label, e.g. Raastas | `FahipayService.iconRes`: `ooredoo_logo` / `dhiraagu_logo` | Fahipay wallet |
+
+Picking an option also picks the source (`TransferFragment.applyTransferType`). If the selected source can't pay that type, Thijooree switches it:
+
+- **Favara:** the default account, if it's MIB or BML. Otherwise the source is cleared and the user is asked to pick one.
+- **Fahipay:** the user's Fahipay wallet.
+
+Then the recipient card is filled in. The options, the number they were looked up for and the pick are kept in `TransferDraft`. If the view is recreated while the popup is still unanswered, it opens again.
+
+The options are dropped when the "To" number is edited, the recipient is cleared, a new lookup starts or the form is cleared. If the user changes the source by hand to one that can't pay the picked type, the pick and the recipient card are dropped and the popup opens again for the same number. If that type was the only option, the recipient is cleared instead, so the user can search again with the new source.
+
+### No source selected, phone number
+
+Two lookups run in parallel:
+
+- **Favara / IPS lookup.** Uses any logged-in MIB or BML session. The default account's bank goes first, the other is the fallback.
+- **Carrier lookup** (see Fahipay source below). Only runs when the user has a Fahipay wallet.
+
+Everything that resolves is offered as a transfer type. Favara comes first, then the Fahipay services. If nothing resolves, the Favara lookup's error is shown as a toast.
+
+Any other input with no source selected falls back to the default account as the source, and then the normal lookup for that bank runs.
 
 ### Fahipay source
 
@@ -55,7 +88,7 @@ The result maps to one or more Fahipay services:
 | Ooredoo `PRE` or `HYBRID` | Raastas (prepaid top-up) |
 | Ooredoo `POST` or `HYBRID` | Ooredoo Bill Pay |
 
-If exactly one service matches, it is auto-selected. If multiple match (Ooredoo `HYBRID` gives two), a chip group is shown for the user to choose.
+The matching services are offered in the Transfer Type picker (see above).
 
 ### BML source
 
@@ -155,7 +188,7 @@ The dialog body text is switched based on whether the destination currency was v
 
 ### No source account selected
 
-**Condition:** user taps the lookup button or the transfer button without selecting a "From" account.
+**Condition:** user taps the lookup button without selecting a "From" account, the input isn't a phone number, and there is no default account. For a phone number, the same toast appears when there's no MIB/BML session and no Fahipay wallet.
 
 **Result:** toast: "Please select a source account first."
 
@@ -247,6 +280,7 @@ The transfer button is only enabled when all of the following are true:
 - A source account is selected
 - A recipient is resolved (`resolvedAccountNumber` not blank, or the BML handler's `qrInfo` is set)
 - Amount is greater than `0`
+- If transfer types are on offer, one has been picked
 - No connectivity error for `NO_INTERNET` or for the source bank
 
 ---