Deposit Hub

Deposit Hub

Component File: src/features/deposits/components/DepositHub.tsx Route / navigation: Path /fund-accounting, Zustand accountingTool = deposits (opens DepositHub sub-flow). See 00-ACCOUNTING-HUB.md. Access Level: Parent Org and Fund Users with Accounting access (position-based) Last Updated: April 9, 2026

Overview

The Deposit Hub is a sub-navigation page within the Accounting section. When users click "Deposits" from the Accounting Hub, this component displays three deposit tools: Regular Deposit (for manual entry), Check Deposit (for OCR scanning), and Deposit History (for viewing/searching past deposits). It includes a back button to return to the Accounting Hub.

Batch UX consistency: Regular Deposit and Check Deposit both use a working batch reviewed on a Complete step before posting. Regular Deposit’s primary staging control is Add to batch, which sends the user to that review step (see 10-REGULAR-DEPOSIT-MANAGER.md); check deposit follows Capture → Review → Complete (see 08-CHECK-DEPOSIT-MANAGER.md). The pattern parallels reimbursements/expense receipt intake (staged items, then commit).

Prerequisite (both deposit tools): Each fund needs an effective Donation Revenue mapping under Administration → Chart of Accounts → Account Defaults before deposit lines can be added or batches submitted. Funds can use an explicit override or inherit the parent organization’s default (see Developer Playbook → Account Defaults → deposit intake bullet).

Calculator amount entry: The live fund-accounting rollout includes both deposit tools. Users can enter arithmetic such as 152.48+157.82 directly in the amount field on Regular Deposit and Check Deposit; the expression is committed to a numeric amount on blur or Enter.

UI Features

Tool Cards (3 tools)

1. Regular Deposit - Record income deposits without physical checks 2. Check Deposit - Scan and deposit checks with OCR processing 3. Deposit History - View and search previously submitted deposits

Features

• Grid layout (responsive: 1/2/3 columns)
• Icon-based tool cards
• Hover effects
• Back to Accounting Hub button
• Tool descriptions
• Click to navigate

Navigation Mapping

| Tool ID | Routes To | Component |

|---------|-----------|-----------|

| `regular` | Deposit → Regular | RegularDepositManager |

| `check` | Deposit → Check | CheckDepositManager |

| `history` | Deposit → History | DepositHistory |

State Management

Local State

None - pure navigation component

Global State (AppContext)

None required

Related Documentation

• ../accounting/08-CHECK-DEPOSIT-MANAGER.md
• ../accounting/10-REGULAR-DEPOSIT-MANAGER.md
• ../accounting/17-DEPOSIT-HISTORY.md
• 01-fund-accounting.md

Synced from IFMmvp-Frontend documentation: pages/accounting/01-DEPOSIT-HUB.md