Documentation & User Manual

Dashboard Suite · Child View 1
Mobile APK & PWA

App Dashboard (Mobile Experience)

The App Dashboard is tailored specifically for smartphones and tablets. It provides ultra-fast one-handed navigation, instant transaction recording, offline balance viewing, and biometric security based on our comprehensive 5-part specification.

1. Header & Quick Actions

• Brand & User Identity: Displays the app title (RaCash) with an active live status dot and the authenticated user's name (e.g. MD Rahad Abbas).

• Top Utility Bar: Quick-action buttons including Reminders/Alarm, Calculator/CalcNotes, Notification bell, Wallet switch, and Profile avatar with user initials.

• Quick Entry Bar: Two prominent pill buttons at the top: ⚡ Quick Add Expenses (Soft red highlight) to log expenses in seconds, and ⚡ Quick Add Earnings (Soft green highlight) to log income immediately.

2. Main Navigation Feature Grid (3x3)

A nine-tile action launcher grouped by core features with pastel background tints and icons:

↑ Expense: Manage and log detailed operational & personal costs.

↓ Earning: Manage incoming revenue, salary, or client payments.

🤝 Lend: Track debt, money given/received from others, and partial repayments.

💳 Wallet: Manage multiple payment sources (Cash, bKash, Nagad, Bank accounts).

👥 Customer: Directory of counterparty contacts, debtors, and clients.

🔺 Categories: Configure custom categories and auto-classification rules.

📈 Analytics: Deep-dive charts, category share, and month-over-month trends.

🧮 CalcNote: Scratchpad with an embedded calculation parser.

📑 Report: Generate and download statement sheets and printable PDF exports.

3. Financial Overview (Interactive Summary)

• Toggle Segment: Switch between Expense (active red fill) and Earning (active green fill). Recalculates all figures across the 4 summary cards below.

• Metric Cards (2x2 Grid): This week (weekly total e.g. ৳ 70.00), This month (current monthly total e.g. ৳ 35.00), This year (year-to-date total e.g. ৳ 70.00), and All time (cumulative lifetime balance e.g. ৳ 70.00).

4. Cash Flow Analytics (Interactive Bar Chart)

• Header & Controls: Title "Cash Flow Analytics" with "Monthly Breakdown" and a Year dropdown selector (default: current year e.g. 2026).

• 12-Month Bar Chart: Grouped monthly bar chart across Jan–Dec with Green for Earnings and Red for Expenses. Empty bars indicate zero transactions recorded.

5. Recent Transactions Feed

• Section Title: "Recent Transactions" with a right-aligned "See all" tap link.

• List Items: Display transaction label/note, transaction type indicator, date stamp, and right-aligned amount with dynamic coloring (+ in green for credits/inflows; - in red for debits/outflows).

Dashboard Suite · Child View 2
Route: /dashboard

Web Dashboard (Desktop & Tablet Control Room)

The Web Dashboard serves as the central command cockpit for comprehensive financial management. It unites high-level multi-wallet balances, 12-month visual trends, dynamic summary cards, monthly flow health indicators, and printable reports on a single unified canvas.

Section 1

1. Header Area

• Greeting: Dynamic time-aware greeting (e.g., "Good evening 👋", "Good morning 👋", "Good afternoon 👋") paired with the localized current date (e.g., "Wednesday, 2 Sep 2026").

• Action Button: Top-right Reports button linking directly to the comprehensive reporting section.

Section 2

2. Overview Bar Chart (Monthly Overview)

• Chart Type: Dual-bar or grouped monthly bar chart across 12 full months (Jan – Dec).

• Color Code:

  • Green: Earnings / Income bars.
  • Red: Expenses spending bars.

• Controls:

  • A Year Selector dropdown in the top-right corner of the card (e.g., 2026) to dynamically reload data for the selected year.
  • Interactive Legend showing active categories (Earnings vs. Expenses) with hover value chips.
Section 3

3. Dynamic Summary Section (Summary Cards)

• Toggle Controls: Top-right pill buttons switching between Expenses and Earnings.

• Interactivity:

  • Clicking Expenses updates the title to "Expense Summary" and populates the 4 cards below with expense totals.
  • Clicking Earnings updates the title to "Earnings Summary" and dynamically swaps the 4 cards with income totals.

• Card Breakdown (4 Metric Cards):

This Week

৳70

With icon badge

This Month

৳0

▼ 100% vs last month

This Year

৳70

Cumulative YTD

All Time

৳70

Lifetime total
Section 4

4. Monthly Flow Indicators

A 3-column row highlighting current month financial health:

Monthly Expense

৳0

Current month spending total with red theme.

Monthly Income

৳0

Current month earnings total with green theme.

Net Cash Flow

৳0

Difference (Income – Expense) with Savings Margin: 0%.

Section 5

5. Wallets & Accounts Strip

• Header: Section title with a right-aligned cumulative balance (Total Funds: ৳0).

• Cards Grid: Horizontal list of linked payment channels (Cash, bKash, Nagad, Rocket, Upay, DBBL) displaying account icon, status indicator, account name, and current available balance in ৳.

Section 6

6. Activity & Analytics Grid (Bottom Section)

Left Column — Recent Activity

View All →

Transaction history table/feed with a direct "View All →" link. Displays an empty-state placeholder:

"No transactions yet / Your recorded wallet activity will appear here"

Right Column — Secondary Cards

Averages & Benchmarks: Displays calculated stats (Monthly Run Rate, Daily Average YTD, and Peak Month amount).

Printable Reports Hub

Printable Reports Hub: Quick action buttons for Expenses, Earnings, Profit & Loss, and a "Calc Notes / Print All" export action.

Fundamentals · Section 1.0

Getting Started with RaCash

RaCash is engineered as an immutable financial control room. Unlike conventional expense loggers, RaCash reconciles both cash inflow, outflow, daily balances, and debts on one single synchronized ledger.

Core Architecture

1. Multi-Wallet Ledger

Every transaction connects to a physical or digital balance pool (bKash, Bank, Cash, etc.).

2. Midnight Capture

Automated daily snapshot freezes your net worth so time-travel auditing is provable.

3. Bi-Directional Lending

Tracks money borrowed and lent with auto-settlement and escalating alerts.

Tip: You can access all shortcuts from anywhere using the top Quick Add Menu or by pressing Alt + Q.
Fundamentals · Section 2.0

Category Engine & Auto-Rules

Organize your finances with infinite nested categories, distinct color palettes, and keyword-based automatic matching rules.

Auto-Classification Rules

When entering transactions, RaCash checks your rule engine to auto-populate category fields instantly:

Keyword Trigger Matched Category Type
Uber, Pathao, Fuel Transport & Travel Expense
Salary, Upwork, Client Freelance / Earnings Income
Electricity, Wifi, Rent Bills & Utilities Expense
Fundamentals · Section 3.0

Multi-Wallet Balances & Daily Snapshots

Never guess your net balance. At 00:00 every night, RaCash captures an immutable snapshot of all wallet balances.

Daily Snapshot Engine

The snapshot cron command automatically records closing totals per wallet. You can scrub through calendar history to view exact balances for any prior date:

php artisan app:capture-wallet-snapshots

Wallet Drift Detection

Highlights when a physical count diverges from calculated transaction totals.

Wallet Reset & Sync

Perform atomic resets with timestamped reset audit notes.

Ledgers & Analytics · Section 4.0

Lending & Borrowing Management

Maintain pristine relationships with automated debt ledgers, partial repayment schedules, and polite automated notifications.

Partial Repayment Workflow

  1. Create a lend record with a designated counterparty contact and due date.
  2. Log partial payments of any amount — the remaining balance and progress percentage update automatically.
  3. When the remaining balance reaches ৳0, the record transitions to Settled.
Ledgers & Analytics · Section 5.0

Deep Analysis, Graphs & Reports

Explore dynamic cash flow trends, month-over-month comparisons, runway estimation, and generate watermarked A4 PDF printouts.

A4 Print Statements

All report views (Expenses, Earnings, Lends) include print-optimized CSS for crisp letterheads, watermarked security stamps, and summary totals ready for physical accounting.

Ledgers & Analytics · Section 6.0

CalcNotes — Financial Scratchpad

CalcNote combines a note-taking canvas with an embedded calculation parser. Type line items with mathematical expressions and see live running totals.

Platform & Apps · Section 7.0

Mobile Apps, PWA & PIN Authentication

Use RaCash on any smartphone or tablet with lightning fast biometric and numeric PIN unlock modes.

Android Standalone APK

Native package with background sync, home widgets, and offline local cache.

iOS & Safari PWA

Tap 'Share' > 'Add to Home Screen' in Safari for full-screen application experience.

Platform & Apps · Section 8.0

Security, Permissions & Data Portability

Enterprise-grade session timeout trackers, role-based admin controls, and one-click data export to CSV and PDF formats.