update docs

2026-05-30 19:33:15 +05:00
parent a5124096d7
commit 86e1e66a20
25 changed files with 1646 additions and 18 deletions
@@ -0,0 +1,65 @@
+# Activities
+
+The activities screen shows a local log of completed transfers initiated within the app, along with receipt viewing and sharing.
+
+---
+
+## Fragment — `ActivitiesFragment`
+
+Displays a chronological `RecyclerView` of locally stored transfer records. These records are written by the app at transfer completion time — they are not fetched from bank APIs.
+
+---
+
+## Activity List
+
+Each row shows:
+- Bank logo
+- Recipient name and account number
+- Transfer amount (hidden as `••••` when hide-amounts is active)
+- Date and time
+- Status badge (Completed / Failed)
+
+Tapping a row opens `TransferReceiptFragment` for that record.
+
+---
+
+## Transfer Receipt — `TransferReceiptFragment`
+
+A full-screen receipt view shown immediately after a successful transfer and accessible later from the activities list.
+
+### Receipt Fields
+
+| Field | Notes |
+|---|---|
+| Bank | Source bank logo and name |
+| From account | Sender account number |
+| To account | Recipient account number |
+| Recipient name | As resolved at transfer time |
+| Amount | Formatted with currency |
+| Remarks | Transfer purpose text |
+| Reference number | Bank-issued transaction reference |
+| Date and time | Transfer timestamp |
+| Status | Completed / Failed |
+
+### Actions
+
+- **Share** — generates a text or image summary of the receipt and opens the system share sheet
+- **Save to Gallery** — renders the receipt as a bitmap and saves it to the device's Pictures folder (requires `WRITE_EXTERNAL_STORAGE` on API < 29, or `MediaStore` on API 29+)
+
+### Screenshot Note
+
+If `FLAG_SECURE` is active (user has enabled the screenshots restriction), the Save to Gallery action uses an off-screen rendering path that bypasses the restriction for the explicit save action only.
+
+---
+
+## Empty State
+
+If no local transfer records exist, an empty-state illustration is shown with a prompt to make a transfer.
+
+---
+
+&nbsp;
+
+---
+
+[← Contacts](08-contacts.md) &nbsp;&nbsp;&nbsp; **Next →** [OTP Screen](10-otp-screen.md)