🍽️

Fidyah

Modern Meal Redemption System

Client Muhammadiyah Association
Project Manager Muhammad Elham Nazif bin Mohamad Eznillah

Why Fidyah?

Transforming manual processes into a seamless digital experience

πŸ“‹

Traditional Challenges

  • Paper coupon management is error-prone
  • Manual reconciliation is time-consuming
  • Lack of real-time visibility
  • Difficult to audit and prevent fraud
✨

Fidyah Solution

  • Digital Credit System (Direct SGD Balance)
  • Instant Redemption via QR codes
  • Real-time Monitoring dashboard
  • Automated Auditing & fraud blocking

System Architecture

Three interconnected portals for complete ecosystem management

πŸ‘€

Beneficiary Portal

Check balance, view history, manage settings.

Public AccessPIN Auth
πŸͺ

Vendor Portal

Scan QRs, process redemptions, track daily sales.

AuthenticatedPWA
βš™οΈ

Admin Dashboard

Manage users, disbursements, settlements, fraud.

ProtectedFull Access
Key Advantage
No App Store Required Progressive Web App (PWA) technology allows users to install the app directly from the browser.

Tech Stack

Built on modern, scalable, and type-safe foundations

⚑
SvelteKit
Full-stack Framework
πŸ—„οΈ
Supabase
Database & Auth
🎨
DaisyUI
Components
πŸ“±
PWA
Installable Web App
πŸ—ΊοΈ
PostGIS
Geospatial
πŸ””
Web Push
Notifications
πŸ”
RLS
Row-Level Security
πŸ“˜
TypeScript
Type Safety
πŸ‘€

Beneficiary Portal

Empowering beneficiaries with dignity and ease of access

Balance Check

Instant access via personal QR code

πŸ“·
Scan QR
➝
πŸ’°
View Balance
➝
πŸ“œ
History
  • Public QR Scanner on landing page
  • Manual ID Entry fallback supported
  • Shows Available Balance instantly
  • Account validity status indicator
9:41
Scan & Check

Secure Authentication

Simple PIN-based login with robust security

πŸ”

Security Features

  • Login with QR ID + 4-digit PIN
  • Brute Force Protection: 5 fails = 15m lock
  • "Remember Me" session persistence
  • Auto-logout for shared devices
Design Choice: We chose PIN over passwords to ensure accessibility for elderly beneficiaries.
9:41
Login Screen

Profile & Activity

Transparency in funds usage and history

πŸ“Š

Dashboard Overview

Beneficiaries can track every cent. The profile shows a consolidated view of incoming disbursements and outgoing redemptions.

  • Current Balance & Status
  • Infinite Scroll Transaction History
  • Detailed Transaction Receipts
9:41
Profile Dashboard

Multi-Channel Notifications

Keeping users informed wherever they are

πŸ“±

In-App

Persistent notifications center with unread badges and history.

πŸ“§

Email

Rich HTML receipts, top-up alerts, and monthly summaries.

πŸ””

Web Push

Real-time alerts on mobile/desktop via Service Workers (VAPID).

Triggers: Transaction Success β€’ Funds Received β€’ Low Balance β€’ Account Changes
πŸͺ

Vendor Portal

Fast, efficient redemption tools for restaurant partners

Redemption Workflow

Optimized for speed in busy hawker environments

Workflow Steps

πŸ“·
1. Scan QR
πŸ’΅
2. Input
πŸ“Έ
3. Receipt
βœ…
4. Success

System Safeguards

  • Instant Validation: Real-time balance & eligibility check
  • Fraud Detection: Automatic flagging of suspicious patterns
  • Receipt Audit: Mandatory photo capture for every txn
9:41
Vendor Scanner

Vendor Dashboard

Business insights at a glance

πŸ“ˆ

Performance Metrics

  • Today's Total Sales
  • Weekly Redemption Summary
  • Recent Transaction Log

Export Data

Vendors can export their transaction history to CSV for their own accounting needs.

9:41
Vendor Dashboard

Vendor Map

Geospatial discovery for beneficiaries

πŸ—ΊοΈ

PostGIS Integration

"Find vendors near me" functionality powered by PostGIS geography types and spatial queries.

  • Interactive Map Interface
  • Distance Calculation
  • Vendor Details & Directions
9:41
Map Interface
βš™οΈ

Admin Dashboard

Centralized command center for operations

Beneficiary Management

Scale operations with bulk tools

πŸ‘₯

Management Tools

  • CRUD Operations for Beneficiaries
  • Groups organization system
  • CSV Bulk Import wizard
  • Balance adjustments & status control
https://admin.fidyah.com/beneficiaries
Beneficiary List

Vendor Management

Onboarding and location management

πŸͺ

Partner Controls

  • Vendor Profile Management
  • Stall ID & PIN Reset
  • Lat/Long Location Editor
  • Performance Monitoring
https://admin.fidyah.com/vendors
Vendor List

Fund Disbursements

Flexible allocation strategies

πŸ‘‡

Manual

Top-up individual beneficiaries instantly for ad-hoc assistance.

πŸ“¦

Bulk Import

Process hundreds of disbursements via CSV upload in one go.

πŸ“…

Scheduled

Group-based recurring top-ups for entire segments.

https://admin.fidyah.com/disbursements
Disbursement Tools

Transaction Monitoring

Real-time oversight of system activity

πŸ“‹

Live Logs

Watch transactions happen in real-time. Filter by vendor, beneficiary, or status.

SuccessPendingFRAUD FLAGGED
https://admin.fidyah.com/transactions
Transaction Logs

Settlements

Streamlined vendor payouts

πŸ’³

Payout Workflow

  • Accumulate daily transactions
  • Review Pending amounts
  • Flag/Exclude suspicious txns
  • Process Settlement Payout
https://admin.fidyah.com/settlements
Settlement Manager

Audit Logging

Immutable record of all system changes

πŸ“

Complete Accountability

Every CREATE, UPDATE, DELETE action is logged with user attribution and timestamp.

JSON Diff View

Admins can see exactly what changed (Before vs. After) for sensitive records.

https://admin.fidyah.com/audit-logs
Audit Log Viewer

System Settings

Granular control over fraud parameters

πŸ€–

Automated Guardrails

  • Max Transaction Cap: Prevent fat-finger errors
  • Velocity Limits: Throttle rapid scanning
  • Flag Thresholds: Auto-alert amounts
https://admin.fidyah.com/settings
Settings Panel

Security & Fraud Prevention

Defense-in-depth strategy

πŸ”’

Identity

Strict RLS policies. RPCs use security definer. Rate limiting & brute-force protection.

πŸ›‘οΈ

Fraud

Velocity checks. Receipt auditing. Anomaly detection. Rapid depletion alerts.

πŸ‘οΈ

Visibility

Immutable audit logs. Real-time transaction monitoring. Vendor geography tracking.

Roadmap

Upcoming features for enhanced auditing and analytics

πŸ“Έ

OCR Integration

Automated receipt scanning to detect discrepancies between declared amounts and physical evidence.

  • Text Recognition via Tesseract/Cloud Vision
  • Auto-Verification of date & total
  • Flag Mismatches for admin review
πŸ“Š

Data Analysis

Deeper insights into beneficiary spending habits and vendor performance.

  • Spending Heatmaps by location
  • Category Tagging for dietary tracking
  • Anomaly Detection for unusual spikes
🍽️

Thank You

Ready for Q&A and Deployment

Client Muhammadiyah Association
Built By Muhammad Elham Nazif bin Mohamad Eznillah