Poysha End-User Guide

1. Introduction

Poysha is a personal finance web app that keeps your accounts, transactions, recurring payments, budgets, and reports in one place. The interface runs in any modern browser and can also be installed as a Progressive Web App (PWA) so it behaves like a desktop or mobile application, even when you are offline.

Key capabilities:

• Unified dashboard with account balances, budgets, and recent activity.
• Fast transaction entry with templates, split support, and multi-currency handling.
• Planning tools for recurring payments, envelopes, and budgets.
• Analytical reports, including card utilization, category summaries, and predictions.

This guide walks end users through the daily workflow in Poysha, from first sign-in to ongoing tracking.

2. Quick Start Checklist

1. Register or sign in to your Poysha account.
2. Create at least one account (bank, wallet, credit card, loan, etc.).
3. Set up core categories for income and expenses.
4. Record your first transaction or apply a template.
5. Configure budgets or recurring payments if you want proactive tracking.
6. Review the dashboard widgets and reports to monitor your status.

3. Signing In and Managing Access

3.1 Registering a New Account

1. Open Poysha and choose Register here.
2. Provide a username, email, password, preferred currency, and time zone.
3. Submit the form; a loader confirms progress. You’re redirected to the login screen once registration finishes.

3.2 Logging In

1. Enter your registered email and password on the login form.
2. Select Login. A successful login loads the dashboard and greeting in the header.

3.3 Forgot Password

1. On the login card, select Forgot Password?
2. Supply the email linked to your account.
3. Watch for the spinner while a temporary password email is sent.
4. Use the emailed credentials to sign in and reset your password under Settings → Change Your Password.

3.4 Forced Password Change

If an administrator resets your password, a blocking modal appears after sign-in. Provide the current temporary password, enter a new one, confirm it, and save to continue.

3.5 Logging Out

Open Settings from the sidebar and use the Logout button at the bottom of the settings list.

4. Navigating the Interface

4.1 Layout Overview

• Sidebar (left) – Main navigation. Toggle it on narrow screens with the hamburger icon in the header.
• Header (top) – Displays the sidebar toggle, app logo, user greeting, notifications, and quick links.
• Main Content – Changes with the selected view (dashboard, accounts, reports, etc.).

4.2 Sidebar Sections

• Dashboard – Home view with summaries and filters.
• Accounts – Manage bank, card, loan, and cash accounts.
• Categories – Define income/expense buckets and reporting heads.
• Reports – Switch between financial analytics and print them.
• Exchange Rates – Override auto-fetched currency rates.
• Recurring – Maintain recurring or planned payments.
• Templates – Review saved transaction templates.
• Labels – Create and edit reusable text labels.
• Budgets – Track spending goals across categories or accounts.
• Settings – Personalize theme, fonts, date formats, security, and data retention.
• Upgrade Account – Visible when you can request a paid plan.

4.3 Header Controls

• Notification Bell – Shows upcoming reminders (e.g., recurring payment due dates). Use the trash icon to clear all active notices.
• Sidebar Toggle – Collapse or expand the sidebar on smaller displays.
• Theme Logos – The app automatically swaps logos for light/dark modes.

4.4 Selectors and Modals

Many forms use “Select” buttons that open a searchable modal list. Type to filter, click an item, and it populates the related field. Close with × to exit without changes.

5. Dashboard & Daily Workflow

5.1 Account Overview

• Displays each account as a card with balance and status.
• Click a card to open the detail modal with account number, type-specific information, and balances.
• Filter the dashboard by account. When a filter is active, the name appears beside the relevant section heading.

5.2 Budget Progress

• Shows the current period’s budget utilization.
• If no budgets apply, the panel indicates that status.
• Budgets update automatically as transactions are categorized.

5.3 Quick Transactions

• Lists template buttons for common transactions.
• Selecting a template opens the transaction form pre-filled with saved values.

5.4 Transaction Filter

• Use the start/end date pickers (Flatpickr) to limit the data window.
• Preset buttons (This Week/Month/Year) jump to common ranges.
• Arrow buttons (< and >) step backward or forward by the same period.

5.5 Recent Transactions

• Shows the most recent activity in the chosen date range.
• Search the list with the text box (matches description, category, or account).
• Click a transaction to open its detail modal (amount, date, account, category, status, notes).

6. Recording Transactions

6.1 Opening the Form

Choose Add Transaction from the sidebar or select Quick Transactions and pick a template.

6.2 Required Fields

• Account (From) – Source account for the payment or receipt.
• Category – Determines whether the entry is income, expense, or transfer based on category type.
• Amount – Enter the value; use the calculator icon to pop open an inline keypad if supported by your browser.
• Date – Choose the posting date (respects your chosen date format).

6.3 Optional Fields and Helpers

• Transfer to Account – Appears for categories flagged as transfers; choose the destination account.
• Preferred Currency Rate – When your preferred reporting currency differs from the account currency, Poysha auto-fills live rates. Enter a manual rate to override it and see the converted amount preview.
• Multi-Currency Transfer – Transfers across currencies expose conversion-method options (enter a rate or destination amount). The interface displays the calculated results so debits and credits balance.
• Description – Add a note; use the tag icon to attach an existing label quickly.
• Labels – Selection modals let you pick from your label library for tracking projects, clients, or tags.
• Templates – Save the current setup with Save as Template or apply an existing one with Use Template.

6.4 Split Transactions

• After saving a transaction, the Split Transaction panel allows you to divide the total across multiple categories.
• Add row(s) with Add Split, set the amount and select the category, then confirm to update the ledger.
• Remaining balance indicators help you ensure all splits sum to the original total.

6.5 Editing & Reviewing

• Click existing transactions in the list to open their details. Depending on permissions, options appear in the modal or parent view to edit or delete.
• Use the account filter to isolate activity for a specific account before editing.

7. Managing Accounts

1. Navigate to Accounts.
2. Complete the form:

• Account Name and optional Account No.
• Account Type – Bank, cash, credit card, loan, deposit, etc.
• Credit Card Options – Due date, credit limit, and whether dashboard cards show outstanding or available balance.
• Loan Options – Installment schedule, amount, and maturity dates for installment vs. non-installment loans.
• Deposit Options – Maturity date for fixed deposits.
• Initial Balance – Sets the opening figure (changing it later adjusts the current balance).
• Currency and Status (active, closed, etc.).

1. Submit to save.
2. Existing accounts appear below the form; drag to reorder their display or click a row to edit.
3. Select an account card from the dashboard to open the detail modal anytime.

8. Managing Categories

1. Go to Categories.
2. Provide a name and select the category type (Income, Expense, Transfer, Reporting Head).
3. Optionally map income/expense categories to a reporting head for grouped reports.
4. Save the entry; it appears in the list, where you can edit or delete as needed.

9. Recurring & Planned Payments

• Open Recurring to create automated or reminder-based entries.
• Define description, amount, source account, category, optional destination account, and notes/labels.
• Set the frequency (daily, weekly, monthly, yearly, custom interval) and choose start/end dates.
• Pick a status (active, paused, ended) and an execution mode:
• Manual – Poysha reminds you but leaves posting to you.
• Automatic – Poysha logs the transaction on the due date.
• Existing recurring items list below the form; edit or cancel them from there.

10. Templates & Quick Transactions

• Save any transaction form configuration as a template with Save as Template.
• Access saved templates under Templates → Your Templates for editing or removal.
• Templates appear on the dashboard’s Quick Transactions strip for one-click reuse; fill in any remaining fields and submit.

11. Labels

• Visit Labels to manage reusable tags with optional colors.
• Apply labels from transaction and recurring forms via the tag icon next to notes/description fields.
• Labels help you filter or identify transactions within notes and reports.

12. Budgets

• Choose Budgets to set spending or saving goals.
• Supply a budget name, pick a type (category-level, account-level, or overall, based on configuration), enter the target amount, and select the period (weekly, monthly, quarterly, yearly, custom).
• Selecting any date in the desired period anchors the budget.
• For category-based budgets, pick one or multiple categories via the multi-select container.
• Saved budgets show progress bars on the dashboard and appear in the Your Budgets list for editing.

13. Exchange Rates

• Poysha fetches live FX rates automatically.
• Use Exchange Rates to manually override a rate when you need a specific value (e.g., bank statement rate or unsupported currency).
• Choose a source currency, target currency, and supply the conversion. The form lets you enter either “1 SRC = X TGT” or the inverse.
• Saved custom rates take precedence over live data until you delete or update them.

14. Reports

• Open Reports to access analytics. Use the preset buttons at the top to switch between report types:
• Income/Expense – Trend and totals for your chosen window.
• Card Utilization – Credit usage versus limits across card accounts.
• Category Summary – Bar chart and totals for income or expense categories (toggle at the top).
• Expense Prediction – Forecasts upcoming spending based on historical patterns.
• Excluded Account – Surfaces transactions kept out of standard totals for reconciliation.
• Each report honors the global transaction date filters.
• Use the Print buttons to generate printer-friendly output for documentation or sharing.

15. Notifications & Reminders

• The bell icon in the header lists upcoming reminders, such as due recurring payments or other alerts generated by the system.
• A badge shows the number of pending notices.
• Open the dropdown to read details, follow related links, or clear all reminders with the trash icon.

16. Settings and Personalization

• Theme Toggle – Switch between light and dark modes.
• Font Size Controls – Adjust UI text size for readability.
• Font Style Selector – Pick from available font families.
• Date Format – Choose the format that matches your region.
• Timezone – Update the timezone; this affects date pickers and reports.
• Rate Display Format – Flip between “1 SRC = X TGT” and the inverse.
• Privacy Policy – Opens the privacy policy in a new tab.
• Logout – Sign out safely from this screen.

16.1 Password Management

1. Use the Change Your Password form to update credentials.
2. After submitting, check for a verification code sent to your email and complete the second step if prompted.

16.2 Danger Zone

• Delete All User Data – Removes accounts, categories, transactions, recurring items, and templates but leaves your login intact.
• Delete Account – Permanently deletes your user profile and all associated data; you are logged out immediately.
• Both actions are irreversible—proceed with care.

17. Upgrade Requests

• When the Upgrade Account option appears in the sidebar, follow it to submit plan details and payment confirmation (e.g., bKash transaction ID).
• Completed submissions route to admins for approval. Watch notifications or email for the status.

18. Offline and PWA Usage

• Add Poysha to your device’s home screen or desktop using your browser’s “Install” or “Add to Home Screen” option.
• The app caches interface assets and keeps a local replica of your data so you can browse recent information without connectivity.
• Perform updates while offline when possible; reconnect periodically so Poysha can sync changes with the server.

19. Troubleshooting & Tips

• Cannot find an option? Use the search box inside selection modals or the transaction list search to narrow results quickly.
• Date filters seem off? Confirm your timezone and date format settings.
• Live rates look stale? Revisit the Exchange Rates view to remove overrides or refresh the page with an active connection.
• Cluttered notifications? Use the clear-all button in the notification dropdown.
• Need more contrast? Toggle the theme or adjust font size from Settings to suit your environment.
• Data housekeeping – Review recurring payments and budgets each period so templates and reports stay aligned with your real-world finances.

If you encounter an issue not covered here, contact support or your administrator with as much detail as possible (browser, steps taken, any visible error message).

Need more help? Email us at poyshaonline@gmail.com.