HajjLedger

Run Hajj and Umrah accounts without spreadsheet chaos.

HajjLedger is a lightweight accounting and finance management app for Hajj and Umrah agencies that need one place to track bookings, supplier costs, payments, refunds, and profits. It helps agency owners and account staff replace scattered spreadsheets and manual follow-ups with a clear, auditable system for daily operations and month-end reporting.

Business Goals

  • Reduce monthly accounting reconciliation time by 50% within 3 months of launch.
  • Increase invoice and payment collection completion from 70% to 90% within 6 months.
  • Cut manual spreadsheet usage by 80% within 90 days for pilot agencies.
  • Achieve 95%+ weekly active usage among account staff in active agencies within 60 days.
  • Reach 20 paying agencies or 100 active users within 6 months of first release.

User Goals

  • Create and track Hajj and Umrah customer accounts in one system.
  • See outstanding balances, received payments, and due dates at a glance.
  • Record supplier and operational expenses against each trip or package.
  • Generate profit summaries and month-end statements quickly.
  • Export clean reports for management, auditors, or external accountants.

Non-Goals

  • Not a full travel booking engine or visa processing system.
  • Not a general ERP for unrelated business lines.
  • Not a consumer-facing pilgrim app in the first release.
  • Not a bank payment processor; it records and reconciles payments rather than moving money.

Agency Owner Ahmed, 41 - Owns a small Hajj and Umrah agency and needs clear visibility into cash flow, unpaid balances, and overall trip profitability. He currently depends on spreadsheets and verbal updates from staff.

Agency Owner Ahmed, 41

  • As an agency owner, I want to see daily cash in, cash out, and outstanding receivables, so that I can know whether the business is healthy.
  • As an agency owner, I want to compare profit by package or departure group, so that I can make pricing decisions confidently.
  • As an agency owner, I want audit-friendly reports, so that I can share accurate numbers with partners or accountants.

Account Officer Sara, 29 - Handles customer invoices, receipts, supplier bills, and reconciliation across multiple groups. She needs speed, accuracy, and fewer repetitive manual tasks.

Account Officer Sara, 29

  • As an account officer, I want to record payments against a specific customer and booking, so that balances stay accurate.
  • As an account officer, I want automatic receipt numbering and due-date reminders, so that I can reduce missed collections.
  • As an account officer, I want to upload supporting files for transactions, so that I can keep evidence attached to each entry.

Operations Manager Bilal, 35 - Coordinates package costs, hotel/vendor invoices, and trip-level expenses. He needs a simple way to understand costs without opening multiple files.

Operations Manager Bilal, 35

  • As an operations manager, I want to log supplier invoices and trip expenses, so that I can track true package cost.
  • As an operations manager, I want to filter by trip, destination, or departure month, so that I can review operational performance quickly.
  • As an operations manager, I want alerts for over-budget trips, so that I can act before profit is reduced.

Customer Accounts and Ledger · High priority

  • Create a single customer account record per pilgrim group or booking and maintain a running financial ledger for each account.
  • Support customer profile fields such as name, phone, passport number, package, departure date, and assigned agent.
  • Maintain balance calculations from invoice amounts, payments, discounts, refunds, and adjustments.
  • Allow linking one booking to multiple travelers if the agency sells group packages.
  • Prevent duplicate accounts by checking phone number, passport number, and booking reference.
  • Support status labels such as Draft, Active, Fully Paid, Refunded, and Closed.

Payments and Receipts · High priority

  • Record all incoming money with traceable references, receipt numbers, and allocation to specific invoices or balances.
  • Support cash, bank transfer, card, and offline payment types.
  • Generate unique receipt numbers with agency prefix and date-based sequencing.
  • Allow partial payments and split allocations across multiple invoices.
  • Capture payment date, entered-by user, and attachment such as bank slip or receipt image.
  • Flag unmatched payments and require manual reconciliation before closing the account.

Expenses and Supplier Bills · High priority

  • Track direct and indirect costs related to packages, trips, and suppliers to calculate gross and net profit accurately.
  • Log supplier bills with vendor name, invoice number, amount, currency, due date, and attached file.
  • Assign expenses to a trip, package, or generic overhead category.
  • Support approved, pending, and paid statuses for bills.
  • Include tax and fee fields where applicable for regional accounting needs.
  • Show cost breakdown by hotel, transport, visas, admin, and marketing.

Reporting and Reconciliation · High priority

  • Provide operational and financial reports that help owners and accountants review performance without spreadsheet exports.
  • Offer daily cash summary, aged receivables, unpaid invoices, and profit by trip/package.
  • Generate month-end statements filtered by date range, branch, and agent.
  • Enable CSV and PDF export for all key reports.
  • Show ledger entries in chronological order with search and filters.
  • Support reconciliation between expected balances and recorded payments.

Roles, Audit, and Controls · Medium priority

  • Protect financial data with permission-based access and a full audit trail of edits and deletions.
  • Support at least Owner, Accountant, and Operations roles with configurable permissions.
  • Record who created, edited, approved, or deleted every financial entry.
  • Soft-delete financial records instead of permanent deletion.
  • Require approval for edits to finalized receipts or closed-period transactions.
  • Provide login history and recent activity logs for accountability.

Fast Agency Onboarding

  • Sign up the agency and create the first branch or office.
  • Set currency, fiscal year, receipt prefix, and default payment methods.
  • Import customers, bookings, or opening balances from Excel or CSV.
  • Create the first package or trip record with expected costs and target revenue.
  • Record a first invoice and payment within 10 minutes of setup.
  • See an instant dashboard showing receivables, collected cash, and outstanding expenses.

1. Create the customer or booking account

  • The user enters a pilgrim or group booking and the system creates a financial account shell for that trip or customer.
  • Validate required fields like name, phone, and package before saving.
  • Detect duplicates using phone, passport, and booking reference.
  • Let the user save as draft if all trip details are not yet available.

2. Issue invoice and schedule collection

  • The user adds invoice lines for package price, visa fee, transport, and other charges, then sets due dates.
  • Support deposits, installment plans, and final settlement dates.
  • Show outstanding amount immediately after invoice creation.
  • Warn if the invoice total does not match package pricing rules.

3. Record payments and attach proof

  • As payments come in, the account officer records them and attaches supporting evidence when needed.
  • Allow partial and overpayment handling with explicit reconciliation status.
  • Auto-generate receipt number and timestamp on save.
  • If payment amount exceeds balance, require user confirmation or hold as credit.

4. Capture supplier and operational costs

  • The team adds vendor bills and trip expenses to calculate true profitability for each package or group.
  • Require expense category and assignment to trip/package or overhead.
  • Support upload of invoice PDFs and images.
  • Highlight unpaid or overdue vendor bills on the dashboard.

5. Review balances and close the account

  • When a booking or trip is complete, the user reviews the ledger and closes the file after confirming all settlements.
  • Show closing checklist for unpaid customer balances and outstanding supplier invoices.
  • Lock finalized records after close, with approved correction workflow if needed.
  • Provide printable summary statements for archival and audit.

Power Features and Edge Cases

  • Multi-branch support with separate receipt numbering and reporting by office.
  • Foreign currency handling for USD, SAR, and local currency with stored exchange rate at transaction time.
  • Bulk import of legacy Excel accounts with field mapping and duplicate detection.
  • Approval workflow for credit notes, refunds, and period-close adjustments.
  • Advanced filters for Hajj season, Umrah season, destination, and departure month.
  • Offline-first mobile-friendly mode for field staff with sync when connection returns.

Clear, Fast, Audit-Friendly UI

  • Dashboard-first layout with receivables, cash received, overdue items, and profit snapshot.
  • Large readable tables with sticky totals, search, and filter chips for fast accounting work.
  • Accessible color contrast and icon-plus-text status indicators for paid, pending, overdue, and closed.
  • Quick-action buttons for invoice, payment, expense, and export.
  • Responsive design optimized for desktop accounting use and mobile field entry.
  • Performance target of sub-2 second page loads for common list views.

Ahmed runs a Hajj and Umrah agency and spends every month chasing spreadsheets, WhatsApp messages, and paper receipts. He knows money is coming in, but he cannot quickly tell which customers still owe, which trips are profitable, or which supplier bills are overdue.

With HajjLedger, Ahmed’s accountant creates customer accounts, issues invoices, and records payments in one place. Every receipt, expense, and adjustment is tied to a booking, so the agency can see the exact balance and profit for each package without rebuilding formulas in Excel.

By the end of the first month, Ahmed has a clean dashboard, faster reconciliation, and exportable reports for management. His team spends less time searching for documents and more time collecting payments, improving margins, and serving pilgrims.

User-Centric Metrics

  • Average time to create a customer account and first invoice under 10 minutes.
  • Reduce month-end reconciliation time from 2 days to under 1 day.
  • At least 90% of payments linked to the correct booking or invoice within 24 hours.
  • Reduce manual data entry errors by 60% within 90 days.
  • User task completion rate for common workflows above 95%.

Business Metrics

  • 40% reduction in churn among pilot agencies after 90 days.
  • 25% increase in invoice settlement rate within 6 months.
  • 50% of new customers activated without support intervention.
  • At least 20 paying agencies or 100 active users in the first 6 months.

Technical Metrics

  • 99.9% monthly uptime.
  • P95 list and dashboard response time under 2 seconds.
  • Zero critical security incidents and all sensitive fields encrypted at rest.
  • Backup recovery point objective under 15 minutes and recovery time objective under 2 hours.

Tracking Plan

  • Track agency_signup_completed with branch, currency, and role.
  • Track customer_account_created with source, branch, and duplicate warning flag.
  • Track invoice_issued with invoice total, package type, and due date.
  • Track payment_recorded with method, amount, and matched_balance status.
  • Track expense_added with category, trip assignment, and approval status.
  • Track report_exported with report type, date range, and export format.
  • Track account_closed with outstanding balance and unresolved items count.

Technical Needs

  • Use a modern web app stack such as Next.js with TypeScript for the frontend and NestJS or Node.js API services.
  • Use PostgreSQL for relational accounting data, balances, and audit logs.
  • Use Redis for background jobs, receipt sequencing, and short-lived caching.
  • Store documents and receipt images in object storage such as AWS S3 or compatible storage.
  • Implement role-based access control and server-side authorization checks on all financial actions.
  • Use a job queue such as BullMQ for imports, report generation, and notifications.
  • Provide PDF generation service for receipts, statements, and month-end reports.

Integration Points

  • Google Workspace or Microsoft 365 for account team login if needed.
  • WhatsApp Business API or Twilio for payment reminders and receipt sharing.
  • Stripe or local bank transfer import for future payment reconciliation, where available.
  • CSV and Excel import/export for migration from existing agency spreadsheets.

Data Storage & Privacy

  • Encrypt sensitive personal and financial data at rest and in transit.
  • Store passport numbers and identity documents with strict role-based access and audit logs.
  • Support data retention and deletion policies aligned with GDPR and CCPA-style requests where applicable.
  • Keep immutable audit records for financial changes while allowing soft deletes for operational mistakes.
  • Mask sensitive values like partial passport or bank details in default views and exports.

Scalability & Performance

  • Design for at least 5,000 accounts per agency and 100,000 ledger rows per year per large agency.
  • Use indexed search on booking reference, passport number, phone, and receipt number.
  • Paginate all transaction lists and reports to keep loads fast under heavy data volume.
  • Generate large reports asynchronously and notify users when ready.

Potential Challenges

  • Duplicate customer records from spreadsheet imports; mitigate with fuzzy matching and review queues before merge.
  • Incorrect balance calculations after edits or refunds; mitigate with immutable ledger entries and recalculation tests.
  • Slow report generation at month-end; mitigate with background jobs, cached aggregates, and indexed queries.
  • User resistance to moving from Excel; mitigate with import tooling, familiar table layouts, and training templates.
  • Sensitive financial data exposure; mitigate with strict RBAC, audit logs, and encrypted storage.

Team & resourcing - Small team - 2 engineers, 1 designer, part-time PM, and optional QA support.

Phase 1: MVP accounting core · Weeks 1-4

  • Agency onboarding and login
  • Customer/booking accounts
  • Invoice creation
  • Payment entry with receipt numbers
  • Basic dashboard and balance view
  • CSV import/export for customers and transactions

Phase 2: Expenses and reporting · Weeks 5-8

  • Supplier bills and expense tracking
  • Profit by trip/package reports
  • Aged receivables and daily cash summary
  • PDF export for statements and receipts
  • Role-based access control and audit trail

Phase 3: Reconciliation and workflow automation · Weeks 9-12

  • Partial payments and overpayment handling
  • Refunds and credit notes
  • Approval workflow for edits and period close
  • Notifications for overdue payments and bills
  • Advanced filters by season, branch, and agent

Phase 4: Scale and polish · Weeks 13-16

  • Multi-branch support
  • Foreign currency handling
  • Improved performance and caching
  • Mobile-friendly field entry improvements
  • Pilot onboarding playbook and admin analytics

Paste this into Cursor, Bolt, Lovable, or v0 to start building.

Build a web app called HajjLedger for Hajj and Umrah agencies to manage accounts, invoices, payments, expenses, and profitability in one place.

Core requirements:
Create customer/booking accounts with fields for name, phone, passport number, package, departure date, branch, agent, status, and opening balance.
Allow invoice creation with line items, due dates, installment schedules, and automatic balance calculation.
Allow payment entry with receipt number generation, payment method, amount, date, attachment upload, partial payments, and unmatched payment handling.
Allow supplier bills and trip/overhead expense tracking with categories, due dates, attachments, and approval status.
Provide dashboards and reports: cash collected today, outstanding receivables, overdue invoices, unpaid supplier bills, profit by trip/package, and month-end statements.
Support CSV import/export, PDF receipt and statement generation, search, filters, and audit logs.
Implement RBAC with roles: Owner, Accountant, Operations.

Primary screens:
Auth and agency onboarding
Dashboard
Customers/Bookings list and detail page
Invoice create/edit modal or page
Payment entry modal or page
Expenses and supplier bills
Reports and exports
Audit log and user management

Data model:
Agency, Branch, User, Role, Customer/Booking, Invoice, InvoiceLineItem, Payment, Receipt, Supplier, Expense, Trip/Package, AuditLog, DocumentAttachment
Include relations so a booking can have many invoices, payments, and expenses.
Ledger should be immutable where possible, with soft delete for non-financial records and audited corrections for financial changes.

Tech stack:
Next.js with TypeScript, Tailwind CSS, shadcn/ui, PostgreSQL, Prisma, NextAuth or Auth.js, S3-compatible file storage, Redis/BullMQ for background jobs, and PDF generation for receipts and reports.

Build responsive desktop-first UI with mobile-friendly entry forms, accessible contrast, fast searchable tables, and sub-2-second load times for common views.

Business Idea

i run hajj umrah agency so there have no apps for accounts ,, i am hastle i need to build my acccounts prd

Make My PRD

Design by The Resonance | Powered by GPC – The AI Transformation Company