Skip to content

Instantly share code, notes, and snippets.

@Konyuka
Last active November 28, 2025 05:39
Show Gist options
  • Select an option

  • Save Konyuka/17fa0b694544c8569cb9d01364a2aa73 to your computer and use it in GitHub Desktop.

Select an option

Save Konyuka/17fa0b694544c8569cb9d01364a2aa73 to your computer and use it in GitHub Desktop.
Unit Master - Fintech Platform Documentation

Unit Master - Fintech Platform Documentation

Overview

Unit Master is a comprehensive Unit Trust Management System designed for financial institutions managing investment funds, client portfolios, and agent networks. This platform handles the complete lifecycle of unit trust operations, from client onboarding to transaction processing, compliance management, and reporting.


1. MEMBER MANAGEMENT

1.1 Client Onboarding & Registration

The platform supports multiple member types with comprehensive onboarding workflows:

Member Types:

  • Single Members - Individual investors
  • Joint Members - Co-owned accounts with multiple account holders
  • Group Members - Investment groups with main member and sub-members
  • Trust Fund Members - Trust accounts with trustees and beneficiaries
  • Junior Members - Minor accounts with guardian information
  • Corporate Members - Company/organization accounts

Onboarding Features:

  • Multi-step registration process with data validation
  • Auto-save functionality for incomplete registrations
  • Document upload and management (ID documents, proof of address, bank details, tax certificates)
  • Risk assessment questionnaire for profiling
  • KYC/AML compliance verification
  • Confirmation workflow requiring approval before activation
  • Welcome letter generation and automated email notifications
  • Member screening against watchlists

Personal Information Captured:

  • Salutation, full name, date of birth, gender
  • Identification details (national ID, passport, alien ID with expiry tracking)
  • Nationality and country of birth
  • Marital status and relationship information
  • Contact details (mobile, telephone, email, physical and postal address)
  • Employment information (employer, industry, occupation, income range)
  • Tax information (tax ID, tax exemption status, tax type)
  • Banking details (multiple bank accounts support with default selection)
  • FATCA compliance information for foreign accounts
  • PEP (Politically Exposed Person) status and screening
  • NIRA verification status (National ID verification)

1.2 Member Profile Management

  • View complete member profile with all associated accounts
  • Edit member details with maker-checker approval workflow
  • Member suspension and activation with reason tracking
  • Member type change functionality
  • Member status management (Active, Suspended, Estate Late, UFAA)
  • Next of Kin management
  • Beneficiary management with percentage allocation
  • Joint member/nominee management
  • Signatory management for group and corporate accounts
  • Document repository for each member
  • Member notes system with categorization
  • Transaction history and activity logs
  • Compliance status tracking

1.3 Prospective Members & Compliance

  • Web portal registrations held for compliance review
  • Two-stage approval process (compliance and operations)
  • Rejection workflow with email notification to applicants
  • Risk assessment review and scoring
  • Compliance officer dashboard for pending reviews
  • Missing information tracking and client notification system

2. ACCOUNT MANAGEMENT

2.1 Investment Account Creation

  • Link accounts to registered members
  • Multiple accounts per member across different funds
  • Account categorization (client categories)
  • Agent assignment for commission tracking
  • Default account designation for auto-allocation
  • Account mandate setup (single or multiple signatories)
  • Goal account settings with target amounts and dates
  • Reinvestment preferences (interest and dividends)
  • Distribution account settings for withdrawals
  • Account class selection (for multi-class funds)
  • Tax treatment setup per account

2.2 Account Operations

  • Account balance inquiries with market value calculation
  • Account status management (Active, Inactive, Suspended, Closed)
  • Account suspension workflow with maker-checker approval
  • Lien account management (account freezing for collateral)
  • Lien certificate generation
  • Account closure process with proper documentation
  • Account transfer between agents
  • Change of fund class within same security
  • Account inactivity tracking and reporting

2.3 Special Account Types

  • Suspense Accounts - Temporary holding for unallocated funds
  • Lien Accounts - Frozen accounts used as collateral
  • Goal Accounts - Target-based investment accounts with milestones
  • Locked Fund Accounts - Funds with withdrawal restrictions

3. SECURITIES & FUND MANAGEMENT

3.1 Fund/Security Setup

  • Create and manage multiple investment funds (securities)
  • Fund classification (equity, fixed income, money market, etc.)
  • Fund type designation (Rate-based or NAV-based)
  • Multi-currency support for each fund
  • Active/inactive status control
  • Web portal visibility settings
  • Allow/restrict M-Pesa payments per fund
  • Withholding tax configuration
  • Fund switch charge settings
  • Digital product designation
  • Fund class structure for tiered investments
  • Fund charges configuration (entry, exit, management fees)
  • Color coding for visual representation

3.2 Fund Classes

  • Create multiple classes within a single security
  • Class-specific pricing and rates
  • Class-based NAV tracking
  • Class transfer/change functionality
  • Class-specific commission rates

3.3 Pricing & Rates Management

NAV (Net Asset Value) Management:

  • Daily NAV capture and confirmation
  • Rate-based NAV auto-calculation
  • Income price tracking for income funds
  • NAV history and point-in-time queries
  • Pending NAV confirmations with maker-checker
  • NAV deletion with approval workflow
  • Fund class NAV separate tracking

Interest Rates:

  • Time-based interest rate setup
  • Rate bands configuration
  • Preferential rates for specific members
  • Agent-specific rates for commission calculation
  • Member-specific custom rates
  • Effective date management
  • Rate confirmation workflow
  • Batch upload of interest rates
  • Rate history tracking

Dividend Rates:

  • Dividend rate declaration per fund
  • Ex-dividend date tracking
  • Distribution rate configuration
  • Dividend confirmation workflow
  • Fund class dividend rates

3.4 Fund Valuation

  • Asset valuation computation
  • Fund expense tracking and allocation
  • Expense withdrawal processing
  • Valuation report generation
  • Pending computation confirmations

4. TRANSACTION PROCESSING

4.1 Purchase Transactions (Receipting)

Purchase Methods:

  • Single purchase entry
  • Direct purchase from member profile
  • Batch upload via Excel template
  • M-Pesa mobile money integration
  • Bank transfer recording
  • Standing order automated purchases

Purchase Features:

  • Multiple payment methods (cash, cheque, bank transfer, M-Pesa, EFT)
  • Reference number tracking
  • Transaction date and value date support
  • Unit calculation based on NAV/price
  • Charge application (entry fees, platform fees)
  • Fund source tracking (new money, rollover, etc.)
  • Multi-currency transaction support
  • Duplicate transaction detection
  • Receipt generation and email dispatch
  • Maker-checker approval workflow
  • Locked funds designation with unlock request system

Batch Upload:

  • Excel template download
  • Bulk purchase processing
  • Transaction validation before posting
  • Batch summary view
  • Individual transaction editing before confirmation
  • Failed transaction tracking
  • Batch cancellation functionality

4.2 Withdrawal Transactions (Redemptions)

Withdrawal Types:

  • Full withdrawal (account closure)
  • Partial withdrawal (unit-based or amount-based)
  • Auto-allocation withdrawal across multiple securities
  • Wealth withdrawal (for wealth products)
  • Interest withdrawal
  • Dividend withdrawal
  • Scheduled withdrawals via standing orders

Withdrawal Features:

  • Unit or amount-based withdrawal options
  • Market value validation
  • Withdrawal restriction checking
  • Exit charge application
  • Withdrawal reason capture
  • Payment method selection (bank transfer, cheque, mobile money)
  • Distribution bank account selection
  • Similar transaction detection
  • Redemption payment scheduling
  • EFT file generation for bank posting
  • Withdrawal confirmation workflow
  • Tax withholding on withdrawals

4.3 Fund Transfer & Switch

Fund Switch:

  • Transfer investment between different funds
  • Switch charge application
  • NAV-based conversion calculation
  • Switch reason tracking
  • Group transaction management
  • Confirmation workflow
  • Reversal of switch transactions

Fund Transfer:

  • Transfer funds between accounts
  • Transfer reason documentation
  • Same-day valuation
  • Confirmation process

4.4 Transaction Management

  • View all pending transactions
  • Bulk transaction confirmation
  • Individual transaction confirmation
  • Transaction preview before confirmation
  • Transaction reversal with approval
  • Transaction cancellation with reason
  • Reversed transaction confirmation workflow
  • Cancelled transaction confirmation workflow
  • Transaction receipt printing
  • Receipt resending via email/SMS
  • Transaction search and filtering
  • Transaction restriction rules

4.5 Suspense Account Operations

  • Record unallocated funds to suspense
  • Multiple suspense account support
  • Transfer from suspense to client accounts (single or multiple)
  • Suspense transaction confirmation workflow
  • Bulk suspense transfer processing
  • Interest calculation on suspense balances
  • Suspense reconciliation

5. AGENT & COMMISSION MANAGEMENT

5.1 Agent Network

Agent Types:

  • Direct agents
  • Master agents
  • Sub-agents
  • Branch agents

Agent Management:

  • Agent registration and onboarding
  • Agent categorization by type
  • Commission tier assignment
  • Branch structure management
  • Agent tree hierarchy (parent-child relationships)
  • Agent activation/deactivation
  • Agent confirmation workflow
  • Agent profile with contact information
  • Agent performance tracking

5.2 Agent Tree Structure

  • Multi-level agent hierarchy
  • Tree branch creation
  • Position management within tree
  • Category types for different tree levels
  • Commission type assignment per level
  • Visual tree representation
  • Tree branch editing and reorganization

5.3 Agent Operations

  • Change of agent for members
  • Business change (transfer business between agents)
  • Clawback commission handling for agent changes
  • Single or bulk member agent change
  • Agent statement generation
  • Agent commission statements

5.4 Commission Processing

Commission Calculation:

  • Transaction-based commission
  • Rate-based commission tiers
  • Agent-specific commission rates
  • Fund-specific commission rates
  • Commission tier setup
  • Upfront commission calculation
  • Trail commission processing
  • Commission on purchases and redemptions

Commission Payment:

  • Commission computation processing
  • Commission validation workflow
  • Bulk commission credit to accounts
  • Commission payout file generation (EFT)
  • Commission tax handling
  • Multi-currency commission support
  • Commission reconciliation
  • Commission payment scheduling

6. INTEREST & DIVIDEND MANAGEMENT

6.1 Interest Processing

Interest Computation:

  • Daily balance-based interest calculation
  • Interest rate tier application
  • Preferential rate handling
  • Manual interest calculation
  • Interest computation date range selection
  • Interest preview before crediting
  • Interest validation workflow

Interest Distribution:

  • Bulk interest credit to all eligible accounts
  • Single account interest credit
  • Interest reinvestment options
  • Interest withdrawal to bank accounts
  • Monthly interest payout scheduling
  • Interest payout file generation
  • Tax withholding on interest
  • Interest reversal functionality

Interest Confirmation:

  • Pending interest review
  • Interest confirmation workflow
  • Interest payout confirmation
  • Undistributed interest tracking

6.2 Dividend Management

Dividend Declaration:

  • Dividend rate setup per fund
  • Ex-dividend and payment date specification
  • Dividend rate confirmation

Dividend Distribution:

  • Dividend calculation engine
  • Dividend computation per account
  • Pending dividend confirmation
  • Bulk dividend credit
  • Dividend reinvestment or withdrawal options
  • Dividend payout file generation
  • Tax handling on dividends

6.3 Interest Tax Certificates

  • Generate interest tax certificates for members
  • Tax year filtering
  • Tax amount calculation
  • Certificate PDF generation
  • Bulk certificate generation
  • Excel export of tax data

7. END OF DAY (EOD) PROCESSING

7.1 EOD Operations

  • Daily End of Day process execution
  • EOD computation for specific date range
  • EOD confirmation workflow
  • Transaction cutoff management
  • Fund value computation
  • Interest accrual processing
  • EOD reports generation
  • Trading box functionality
  • Fund value at point-in-time queries

7.2 Trading Box (Eswatini Specific)

  • Liquidation report creation
  • Trading box execution
  • Daily trading summaries
  • Security-wise trading data
  • Automated EOD posting

7.3 Change of Class

  • Account class change processing
  • Units transfer between classes
  • Class change confirmation
  • Historical class tracking

7.4 Group Member EOD

  • Group member-specific EOD processing
  • Sub-member transaction allocation
  • Group interest computation
  • Consolidated group processing

8. PAYMENT & BANK INTEGRATION

8.1 Payment Methods

  • Cash payments
  • Cheque payments
  • Bank transfers (EFT/RTGS)
  • Mobile money (M-Pesa)
  • Standing orders/Direct debits
  • Debit orders
  • Payment method configuration

8.2 Mobile Money Integration (M-Pesa)

M-Pesa Features:

  • Lipa Na M-Pesa Online (STK Push)
  • Customer to Business (C2B) payments
  • Business to Customer (B2C) payments
  • Business to Business (B2B) payments
  • M-Pesa transaction validation
  • M-Pesa confirmation callback
  • Balance inquiry
  • Transaction status query
  • M-Pesa reconciliation with system receipts

Mobile Payment Management:

  • View unreconciled mobile payments
  • Reconcile mobile payment to member account
  • Bulk mobile payment reconciliation
  • Soft delete erroneous mobile payments

8.3 Standing Orders/Periodic Payments

Setup:

  • Create recurring payment schedules
  • Frequency selection (daily, weekly, monthly, quarterly, annually)
  • Start and end date configuration
  • Amount specification
  • Payment method selection (bank debit, M-Pesa)
  • Investment account designation
  • Maker-checker approval for standing orders

Processing:

  • Automated standing order execution
  • Manual standing order trigger
  • Standing order logs and history
  • Failed standing order retry mechanism
  • Standing order modification
  • Standing order cancellation
  • Escalation of failed payments

8.4 Bank Integration & EFT

Payment to Bank:

  • Bank account selection for withdrawals
  • EFT file generation for bulk payments
  • Redemption payment scheduling
  • Interest payout EFT files
  • Commission payout EFT files
  • Dividend payout EFT files
  • Digital product files (Malawi)
  • Debit order files (Eswatini)

CABS Integration (Banking System):

  • Post transactions to CABS banking system
  • Batch posting functionality
  • Posting status tracking
  • Retry failed postings
  • Posting confirmation from bank
  • Reconciliation of posted transactions

8.5 Bank Reconciliation

Reconciliation Module:

  • Upload bank statement CSV files
  • Auto-match bank transactions with system transactions
  • Manual matching interface
  • Mark unmatched items
  • Reconciliation summary report
  • Register balances tracking
  • Unmatched item export
  • Reconciliation report download
  • Historical reconciliation view

8.6 Company Bank Accounts

  • Multiple company bank accounts
  • Bank account per currency
  • Source account designation for different transaction types
  • Bank branch details
  • SWIFT/BIC code tracking
  • Clearing code information
  • Disbursement account setup

9. STATEMENTS & REPORTING

9.1 Client Statements

Statement Types:

  • Individual account statements
  • Consolidated member statements (all accounts)
  • Date range statements
  • As-at-date statements
  • Group member consolidated statements
  • Sub-member statements

Statement Features:

  • PDF generation with company branding
  • Email dispatch to members
  • Statement date selection
  • Transaction detail listing
  • Opening and closing balance
  • Units held and market value
  • Interest and dividend tracking
  • Tax information display
  • Statement customization options
  • Bulk statement generation for all members
  • Statement color scheme configuration

9.2 Agent Statements

  • Agent commission statements
  • Commission earned summary
  • Date range filtering
  • Transaction detail view
  • Email dispatch to agents

9.3 Transaction Receipts

  • Purchase receipt generation
  • Withdrawal receipt generation
  • Receipt preview before final
  • Receipt resending functionality
  • Email and SMS notification
  • Receipt customization with company branding

9.4 Reports Module

The platform includes a comprehensive reporting system organized into categories:

Member Reports:

  • All members listing
  • New member registrations
  • Member demographics
  • PEP members report
  • UFAA members report
  • Risk profiling report
  • Tax-exempt members
  • Missing member information report
  • Client feedback reports

Account Reports:

  • Account listing by fund
  • Account balances report
  • Account investment summary
  • Inactive accounts
  • Closed accounts
  • Account inactivity tracking
  • Client investment counts by fund

Transaction Reports:

  • Purchases report
  • Withdrawals report
  • Transaction register
  • Transaction by date range
  • Transaction by member
  • Transaction by fund
  • Failed batch withdrawals
  • Locked funds report
  • Unlocked funds history

Agent Reports:

  • Agent listing
  • Agent performance
  • Agent commission reports
  • Business by agent
  • Change of agent tracking
  • Agent tree reports

Financial Reports:

  • Assets Under Management (AUM)
  • Fund performance reports
  • Account investment summary
  • Sales by category
  • NAV history reports
  • Rate details
  • Interest summary reports
  • Dividend distribution reports
  • Tax reports and certificates

EOD Reports:

  • Trading box reports
  • Liquidation creation reports
  • Daily EOD summaries
  • Fund valuation reports

Audit Reports:

  • Activity logs
  • User activity tracking
  • Transaction audit trail
  • Member edit history
  • System access logs
  • Failed login attempts

9.5 Report Builder

  • Dynamic report tree structure
  • Custom report generation
  • Date range filtering
  • Export to Excel, PDF, CSV
  • Email report scheduling
  • Role-based report access

10. COMMUNICATION SYSTEM

10.1 Email Management

Email Features:

  • Single email composition and sending
  • Bulk email to member groups
  • Email templates management
  • Template variables for personalization
  • Email queue system
  • Email sending history
  • Email status tracking (sent, failed)
  • Attachment support

Automated Emails:

  • Welcome letters on member approval
  • Transaction receipts
  • Statement dispatch
  • Interest/dividend notifications
  • Commission statements to agents
  • Password reset emails
  • Account activation emails
  • Rejection notification for declined applications
  • Missing information requests

10.2 SMS Management

SMS Features:

  • Single SMS sending
  • Bulk SMS to communication groups
  • SMS templates
  • SMS history and logs
  • SMS status tracking
  • Character count monitoring

Automated SMS:

  • Transaction confirmations
  • Account balance notifications
  • Payment reminders
  • Standing order execution confirmations

10.3 Communication Groups

  • Create member segmentation groups
  • Group-based bulk communications
  • Dynamic group criteria
  • Group management and editing

10.4 Customer Feedback

  • Feedback submission from web portal
  • Feedback viewing and management
  • Response system for feedback
  • Feedback categorization
  • Customer review and enquiry tracking

11. USER & SECURITY MANAGEMENT

11.1 User Management

User Administration:

  • Create system users (staff accounts)
  • Link users to employee records
  • Role assignment
  • User activation/deactivation
  • Password management with history
  • Multi-factor authentication setup
  • Password expiry policies
  • Password complexity requirements
  • User confirmation workflow

User Features:

  • Azure AD integration for SSO
  • Local authentication fallback
  • Session management with auto-logout
  • User profile management
  • Access token management

11.2 Employee Management

  • Employee registration
  • Department assignment
  • Employee confirmation workflow
  • Employee-to-user linking
  • Employee profile with passport photo
  • Non-user staff tracking

11.3 Roles & Permissions

Role Management:

  • Create and manage roles
  • Role confirmation workflow
  • Role deletion with safeguards
  • Company-specific roles

Permission System:

  • Module-based permissions
  • Custom permission creation
  • Permission assignment to roles
  • Child menu access control
  • Access level configuration
  • Maker-checker permissions
  • Transaction confirmation permissions

11.4 Module Management

  • System module creation
  • Module hierarchy (parent-child)
  • Module visibility control
  • Module assignment to roles
  • Sub-module and menu child management

11.5 Access Control

  • Login activity tracking
  • Failed login monitoring
  • User login history
  • Activity logs with Spatie Activity Log
  • Audit logs for critical changes
  • Web activity tracking
  • IP address logging

11.6 Security Features

  • Password security questions
  • Password history tracking (prevent reuse)
  • Account lockout after failed attempts
  • Session timeout configuration
  • Two-factor authentication
  • Azure AD SSO integration
  • Role-based access control (RBAC)
  • Maker-checker workflow for critical operations

12. COMPLIANCE & RISK MANAGEMENT

12.1 KYC/AML Compliance

Member Verification:

  • Identity document verification
  • NIRA integration for national ID verification
  • Address verification
  • Bank account verification
  • Employment verification
  • Source of funds tracking

Risk Assessment:

  • Risk profiling questionnaire
  • Automated risk scoring
  • Risk category assignment (Low, Medium, High)
  • Risk answers tracking and review
  • Custom risk questions administration
  • Risk question choices management

12.2 Screening & Monitoring

PEP Screening:

  • PEP status declaration
  • PEP reason capture
  • PEP member reporting
  • Enhanced due diligence for PEPs

Sanctions Screening:

  • Member screening status tracking
  • Screening result recording
  • Continuous monitoring

FATCA Compliance:

  • US person identification
  • FATCA declaration capture
  • W-9 form tracking
  • FATCA reporting

12.3 Tax Compliance

Tax Information:

  • Tax ID validation
  • Tax exemption tracking
  • Tax-exempt certificate upload
  • Tax-exempt member reporting
  • Tax type categorization
  • Withholding tax application
  • Tax year tracking

Tax Reporting:

  • Interest tax certificates
  • Dividend tax tracking
  • Tax liability calculations
  • Annual tax summaries

12.4 Document Management

Document Types:

  • Identity documents (ID, passport, driver's license)
  • Proof of address (utility bills, bank statements)
  • Bank statements
  • Tax certificates
  • Incorporation documents (for corporate clients)
  • Trust deeds
  • Powers of attorney
  • KYC documents
  • Compliance certificates

Document Features:

  • Document upload and storage
  • Document type categorization
  • Document viewing and download
  • Document soft delete
  • Document expiry tracking
  • Document version control

12.5 EDMS Integration

  • Electronic Document Management System integration
  • Document request workflow
  • Request status tracking (pending, processing, completed)
  • Integration with member confirmation process
  • Document retrieval automation

13. SYSTEM ADMINISTRATION

13.1 System Configuration

System Controls:

  • System-wide settings management
  • Control categories (General, Financial, Communication, etc.)
  • Control precedence management
  • Company-specific controls
  • Feature toggles

Settings:

  • Logo configuration per company
  • Statement color schemes
  • EDMS integration toggle
  • Company profile information
  • Multi-company support
  • Country-specific configurations

13.2 Reference Data Management

Geographic Data:

  • Countries management
  • States/counties management
  • Cities/towns management
  • Postal codes
  • County-town relationships

Financial Data:

  • Banks listing
  • Bank branches
  • Currency management
  • Currency exchange rates
  • Exchange rate confirmation

Classification Data:

  • Client categories
  • Agent categories
  • Agent types
  • Account types
  • Marital status
  • Salutations
  • Relationships
  • Occupations
  • Industries
  • Fund sources
  • Withdrawal reasons
  • Withdrawal conditions
  • Fund switch reasons
  • Fund transfer reasons
  • Reversal reasons
  • Document types
  • Member institution types
  • Beneficiary relationships
  • Income ranges
  • Client types
  • Gender types
  • Identification types
  • Tax types
  • Note types

13.3 Calendar & Holidays

  • Public holiday management
  • Holiday date ranges
  • Working day calculation
  • Business day adjustment

13.4 Company Management

Company Setup:

  • Multi-company support
  • Company profile creation
  • Company branding (logo, colors)
  • Company bank accounts
  • Company branches
  • Company contact information
  • Country code configuration
  • Website URL

Company Branches:

  • Branch creation and management
  • Branch contact details
  • Branch-specific operations
  • Soft delete for branches

13.5 Chart of Accounts

  • GL account management for accounting integration
  • Account code structure
  • Account description
  • Account type categorization

13.6 Goal Account Settings

  • Goal parameters configuration
  • Target amount and date settings
  • Goal achievement tracking
  • Goal progress reporting

14. ADVANCED FEATURES

14.1 Batch Processing

Batch Upload Support:

  • Purchase batch upload via Excel
  • Withdrawal batch upload
  • Historical batch upload tracking
  • Batch summary view with statistics
  • Batch item editing before confirmation
  • Batch cancellation
  • Failed batch retry mechanism
  • Batch confirmation workflow
  • Download batch upload templates

Batch Operations:

  • Bulk transaction confirmation
  • Bulk interest credit
  • Bulk dividend distribution
  • Bulk commission payment
  • Bulk statement dispatch
  • Bulk agent change

14.2 Locked Funds Management

  • Mark transactions as locked during processing
  • Lock duration tracking
  • Unlock request workflow
  • Confirm unlock transactions
  • Locked funds reporting
  • Unlock history
  • Excel and PDF export of locked/unlocked funds

14.3 Restrictions Management

  • Define withdrawal restrictions per member/account
  • Restriction reason documentation
  • Restriction date ranges
  • Restriction activation/deactivation
  • Restriction checking during withdrawals

14.4 Account Mandate System

  • Define signatory requirements
  • Single or multiple signatories
  • Number of signatories needed
  • Mandate documentation
  • Mandate change tracking
  • Historical mandate records

14.5 Lien Accounts

  • Create lien (freeze) on accounts
  • Lien reason and amount
  • Lien certificate generation
  • Lien confirmation workflow
  • Lien revocation process
  • Lien expiry tracking

14.6 Wealth Product Management

  • Specialized wealth product transactions
  • Wealth purchase processing
  • Wealth withdrawal with restrictions
  • Wealth rollover functionality
  • Wealth alerts system
  • Separate NAV tracking for wealth products

14.7 Interest Calculator

  • Manual interest calculation tool
  • Rate and period input
  • Interest projection
  • Compound interest calculation
  • Interest at maturity estimation

14.8 Charge Management

Transaction Charges:

  • Entry charges on purchases
  • Exit charges on redemptions
  • Management fees
  • Platform fees
  • Fund switch charges
  • Charge percentage or fixed amount
  • Security-specific charges
  • Charge confirmation workflow
  • Charge reversal functionality

Security Charges:

  • Fund-level charge configuration
  • Charge groups
  • Multiple charge types per fund
  • Charge effective dates

14.9 Debit Order Management (Eswatini)

  • Debit order bank setup
  • Debit order file generation
  • Debit order processing
  • Debit order bank reconciliation
  • Bank-specific formatting

14.10 Digital Products (Malawi)

  • Digital product file generation
  • Automated payout processing
  • Product distribution date tracking
  • File download for bank submission

14.11 Multi-Currency Support

  • Multiple currencies setup
  • Currency exchange rates
  • Exchange rate confirmation workflow
  • Multi-currency transactions
  • Multi-currency accounts
  • Currency conversion on fund switch
  • Foreign currency fund designation
  • USD/local currency dual tracking

14.12 Web Portal Management

  • Portal access control
  • Member self-service features
  • Portal registration workflow
  • Portal compliance review
  • Portal feature toggles
  • Terms and conditions acceptance
  • Two-stage portal approval

15. WORKFLOW & APPROVAL SYSTEM

15.1 Maker-Checker Workflow

The platform implements maker-checker controls on critical operations:

Pending Confirmations:

  • Member registrations
  • Employee creation
  • User creation
  • Agent registration
  • Role creation
  • Control category setup
  • NAV entries
  • Interest rates
  • Dividend rates
  • Fund rates
  • Agent rates
  • Member rates
  • Currency exchange rates
  • Fund class rates
  • Fund class NAVs
  • Fund class dividends
  • Transactions (purchases and withdrawals)
  • Interest distribution
  • Dividend distribution
  • Commission payment
  • Fund expense withdrawals
  • Fund valuations
  • Lien accounts
  • Standing orders
  • Account suspensions
  • Account mandates
  • Interest payouts

Confirmation Views:

  • Dedicated confirmation pages per module
  • Detailed preview before approval
  • Reject with reason functionality
  • Bulk confirmation support
  • Confirmation history tracking
  • Maker-checker audit trail

15.2 Transaction Reversal & Cancellation

Reversal Workflow:

  • Reversal request by authorized users
  • Reversal reason capture
  • Pending reversal confirmation
  • Reversal approval by different user
  • Reversal audit trail
  • Automated accounting entries reversal

Cancellation Workflow:

  • Transaction cancellation request
  • Cancellation reason mandatory
  • Pending cancellation confirmation
  • Batch cancellation support
  • Cancelled transaction reporting

15.3 Rejection Workflow

  • Reject pending items with reasons
  • Email notification to relevant parties
  • Rejection history tracking
  • Re-submission after rejection

16. NOTIFICATION SYSTEM

16.1 System Notifications

  • In-app notification center
  • Notification badge counts
  • Read/unread status
  • Notification categories:
    • Pending approvals
    • System alerts
    • Transaction notifications
    • Failed processes
    • User activity alerts
  • Role-based notification routing
  • Notification read tracking

16.2 User Notifications

  • Welcome letter dispatch notifications
  • Receipt sending confirmations
  • Statement dispatch confirmations
  • Failed email/SMS alerts
  • Notification preferences per user

17. ANALYTICS & DASHBOARDS

17.1 Home Dashboard

  • Summary statistics (members, accounts, transactions)
  • Recent activity feed
  • Pending approval counts
  • Quick action shortcuts
  • Performance metrics
  • AUM snapshot
  • Recent transactions
  • Alerts and warnings

17.2 Member Analytics

  • Member growth trends
  • Member demographics breakdown
  • Member by category
  • Member by agent
  • Registration source analysis
  • Risk profile distribution

17.3 Transaction Analytics

  • Daily transaction volumes
  • Purchase vs withdrawal trends
  • Transaction by fund
  • Transaction by agent
  • Transaction by payment method
  • Failed transaction analysis

17.4 Financial Analytics

  • AUM trends over time
  • Fund performance metrics
  • Interest paid analysis
  • Dividend distribution analysis
  • Commission paid analysis
  • Fee income tracking

17.5 Agent Performance

  • Agent-wise business volumes
  • Commission earned
  • Member acquisition by agent
  • Agent productivity metrics
  • Agent hierarchy performance

18. DATA IMPORT/EXPORT

18.1 Import Capabilities

  • Batch transaction upload (Excel)
  • Interest rate batch upload
  • Bank statement upload (CSV)
  • Mobile payment reconciliation import
  • Group member bulk upload
  • Historical data migration support

18.2 Export Capabilities

Report Exports:

  • Excel export for all reports
  • PDF export for statements and certificates
  • CSV export for data analysis

File Generation:

  • EFT files for bank payments
  • Debit order files
  • Interest payout files
  • Commission payout files
  • Dividend payout files
  • Digital product files
  • Reconciliation reports

Templates:

  • Batch upload templates
  • Transaction import templates
  • Report templates customization

19. ERROR HANDLING & MONITORING

19.1 Error Logging

  • Comprehensive error logging
  • Error log viewing and filtering
  • Stack trace capture
  • User context in errors
  • Error notification to administrators

19.2 Activity Logging

  • User activity tracking with Spatie Activity Log
  • Model change tracking
  • Before/after values capture
  • Activity log filtering and search
  • Export activity logs

19.3 Audit Trails

  • Comprehensive audit logging
  • Audit log table for critical operations
  • User, action, and timestamp tracking
  • Old and new value comparison
  • IP address logging
  • Company-specific audit trails

19.4 Failed Process Tracking

  • Failed batch withdrawals tracking
  • Failed standing order executions
  • Failed bank postings
  • Failed email/SMS
  • Retry mechanisms
  • Failure reason capture

20. INTEGRATION CAPABILITIES

20.1 Banking Integration

  • CABS banking system integration
  • EFT file generation and posting
  • Bank statement reconciliation
  • Real-time balance updates
  • Payment status webhooks

20.2 Mobile Money Integration

  • M-Pesa STK Push
  • M-Pesa C2B
  • M-Pesa B2C
  • M-Pesa B2B
  • Transaction callbacks
  • Balance inquiry APIs

20.3 EDMS Integration

  • Document management system connectivity
  • Document request workflow
  • Status synchronization
  • Automated document retrieval

20.4 Azure AD Integration

  • Single Sign-On (SSO)
  • Azure Active Directory authentication
  • User provisioning from Azure AD
  • Fallback to local authentication

20.5 Third-Party APIs

  • NIRA verification API (National ID)
  • SMS gateway integration
  • Email service providers
  • Payment gateway integration

21. REGULATORY COMPLIANCE FEATURES

21.1 KYC Compliance

  • Customer identification program
  • Enhanced due diligence for high-risk clients
  • Ongoing monitoring
  • Document expiry tracking
  • Periodic KYC renewal

21.2 AML Compliance

  • Source of funds tracking
  • Large transaction reporting
  • Suspicious activity monitoring
  • PEP screening
  • Sanctions list screening
  • Risk-based approach implementation

21.3 Tax Compliance

  • Withholding tax application
  • Tax certificate generation
  • Tax reporting
  • FATCA compliance tracking
  • Tax-exempt status management

21.4 Regulatory Reporting

  • Regulatory report templates
  • Automated report generation
  • Audit trail for regulatory submissions
  • Data retention policies

22. SEARCH & FILTER CAPABILITIES

22.1 Advanced Search

  • Member search (by name, ID, account, mobile, email)
  • Account search
  • Transaction search
  • Agent search
  • Global search functionality
  • Autocomplete suggestions

22.2 Filtering

  • Date range filters across all modules
  • Status filters (pending, confirmed, cancelled, etc.)
  • Fund/security filters
  • Agent filters
  • Category filters
  • Custom filter combinations
  • Save filter preferences

23. CUSTOMER SELF-SERVICE (Web Portal)

23.1 Member Portal Features

  • Online registration/onboarding
  • Account opening requests
  • View account balances and statements
  • Transaction history viewing
  • Download statements
  • Update profile information
  • Upload documents
  • Submit feedback and enquiries
  • Risk assessment completion
  • Accept terms and conditions

23.2 Agent Portal Features (if implemented)

  • Agent login
  • View assigned members
  • Commission statements
  • Performance reports
  • Member registration assistance

24. OPERATIONAL FEATURES

24.1 Calendar Management

  • Public holiday setup
  • Working day calculation
  • EOD scheduling consideration
  • Transaction cutoff times

24.2 Interest Calculator

  • Standalone interest calculation tool
  • Rate and term input
  • Interest projection
  • Maturity value calculation

24.3 Charge Calculation

  • Automated charge application
  • Charge computation preview
  • Charge reversal when needed
  • Charge reporting

24.4 Market Value Calculation

  • Real-time market value computation
  • Historical market value queries
  • Market value at specific date
  • Multi-account consolidated market value

24.5 Transaction Validation

  • Balance sufficiency checks
  • Withdrawal restriction validation
  • Account status validation
  • Lien account blocking
  • Duplicate transaction detection
  • NAV availability validation
  • Business day validation

25. PERFORMANCE & OPTIMIZATION

25.1 Data Management

  • Soft delete implementation for data retention
  • Archive old transactions
  • Data pruning configurations
  • Historical data access

25.2 Caching

  • Cache implementation for performance
  • NAV caching
  • Rate caching
  • Session caching

25.3 Background Processing

  • Queue system for long-running tasks (Laravel Jobs)
  • Background email sending
  • Background SMS sending
  • Background statement generation
  • Background batch processing
  • Background report generation

25.4 Pagination

  • Large dataset pagination
  • Configurable page sizes
  • Lazy loading for performance

26. BACKUP & RECOVERY

26.1 Data Backup

  • Database backup schedules
  • Document storage backup
  • Configuration backup
  • Backup retention policies

26.2 Data Recovery

  • Point-in-time recovery capability
  • Transaction reversal for error correction
  • Soft delete recovery
  • Audit trail for reconstruction

27. CUSTOMIZATION & CONFIGURATION

27.1 Company Branding

  • Logo upload
  • Color scheme configuration
  • Statement customization
  • Email template branding
  • Report header/footer customization

27.2 System Configuration

  • Feature flags for country-specific features
  • Workflow configuration
  • Approval level configuration
  • Notification preferences
  • Email/SMS template customization
  • Report customization

27.3 Multi-Tenancy

  • Company-based data isolation
  • Company-specific users
  • Company-specific configurations
  • Company-specific branding
  • Shared reference data with company filtering

28. SPECIAL COUNTRY-SPECIFIC FEATURES

28.1 Kenya Features

  • M-Pesa integration
  • KRA PIN tracking (tax ID)
  • NIRA verification
  • Shilling currency handling

28.2 Eswatini Features

  • Debit order processing
  • EFT file generation (specific format)
  • Trading box functionality
  • Liquidation reports

28.3 Malawi Features

  • Digital products payout files
  • Malawi-specific bank formats
  • Kwacha currency support

28.4 Zimbabwe Features

  • Multi-currency handling (USD, ZWL)
  • Client type categorization
  • Tax type management
  • Interest summary reports (Zim format)

29. QUALITY CONTROL FEATURES

29.1 Validation Rules

  • Data validation on input
  • Business rule validation
  • Referential integrity checks
  • Duplicate prevention
  • Mandatory field enforcement

29.2 Confirmation Workflows

  • Two-person approval for critical operations
  • Hierarchical approval chains
  • Approval notifications
  • Approval history

29.3 Audit Requirements

  • Complete audit trail
  • Who did what and when
  • Before and after values
  • IP address logging
  • Company context logging

30. HELP & SUPPORT FEATURES

30.1 Help Center

  • Articles management
  • Help documentation
  • FAQs
  • User guides
  • Video tutorials (if implemented)

30.2 Customer Support

  • Feedback system
  • Enquiry management
  • Review tracking
  • Support ticket system
  • Response tracking

30.3 System Alerts

  • System maintenance notifications
  • Scheduled downtime alerts
  • Feature announcement
  • Critical alerts for staff

TECHNICAL INFRASTRUCTURE

Technology Stack

  • Framework: Laravel PHP Framework
  • Database: MySQL/PostgreSQL
  • Frontend: Blade templates, JavaScript, jQuery, Bootstrap
  • Authentication: Laravel Auth + Azure AD SSO
  • API: RESTful APIs for integrations
  • Queue System: Laravel Queue for background jobs
  • Activity Logging: Spatie Activity Log
  • Notifications: Laravel Notifications
  • PDF Generation: PDF libraries for statements and reports
  • Excel Import/Export: Laravel Excel/Maatwebsite
  • Multi-Tenancy: Company-based scoping

Key Architectural Patterns

  • MVC (Model-View-Controller) architecture
  • Service layer for business logic
  • Repository pattern for data access
  • Observer pattern for model events
  • Job queues for asynchronous processing
  • Soft delete for data retention
  • Maker-checker workflow
  • Global scopes for multi-tenancy
  • Event-driven notifications

SECURITY FEATURES SUMMARY

  1. Role-based access control (RBAC)
  2. Multi-factor authentication
  3. Password policies with history
  4. Session timeout and auto-logout
  5. Azure AD SSO integration
  6. IP address logging
  7. Failed login tracking
  8. Maker-checker approval workflows
  9. Audit trails for all critical operations
  10. Data encryption for sensitive information
  11. Secure API endpoints
  12. CSRF protection
  13. SQL injection prevention
  14. XSS protection
  15. Soft delete with audit trail

COMPLIANCE FEATURES SUMMARY

  1. KYC/AML documentation and tracking
  2. PEP screening and enhanced due diligence
  3. FATCA compliance
  4. Tax compliance and withholding
  5. Sanctions screening
  6. Document expiry tracking
  7. Risk profiling and assessment
  8. Regulatory reporting capabilities
  9. Audit trails for compliance review
  10. Data retention policies
  11. EDMS integration for document management
  12. Continuous monitoring

KEY WORKFLOWS SUMMARY

Member Onboarding: Prospect Registration → Compliance Review → Operations Approval → Member Activation → Welcome Letter

Transaction Processing: Transaction Entry → Validation → Maker Review → Checker Approval → Posting → Receipt Generation → Client Notification

Interest Distribution: Interest Computation → Validation → Review → Confirmation → Bulk Credit → Statement Update → Client Notification

Agent Commission: Commission Calculation → Validation → Approval → Credit to Account → Statement Generation → Agent Notification

EOD Processing: EOD Initiation → Transaction Cutoff → NAV Confirmation → Interest Accrual → Commission Calculation → Report Generation → Confirmation


REPORTING SUMMARY

The platform provides over 50+ standard reports across:

  • Member management
  • Account management
  • Transactions (purchases, withdrawals, switches, transfers)
  • Agents and commissions
  • Interest and dividends
  • NAV and rates
  • Financial analytics and AUM
  • Tax reporting
  • Audit and compliance
  • EOD and trading box
  • Fund performance
  • Custom ad-hoc reports

All reports support:

  • Date range filtering
  • Multi-format export (Excel, PDF, CSV)
  • Email scheduling
  • Role-based access
  • Company-specific data

CONCLUSION

Unit Master is a comprehensive, enterprise-grade unit trust management system designed to handle the complete lifecycle of investment fund operations. The platform combines robust transaction processing, comprehensive compliance management, extensive reporting capabilities, and flexible workflows to meet the needs of fund managers, compliance officers, agents, and investors.

Key strengths include:

  • Complete Feature Coverage: From client onboarding to transaction processing to regulatory compliance
  • Maker-Checker Controls: Ensuring accuracy and preventing fraud through approval workflows
  • Multi-Company Support: Scalable architecture supporting multiple companies/entities
  • Country-Specific Features: Tailored functionality for different regulatory environments
  • Integration Ready: APIs and integration points for banking, mobile money, and document management systems
  • Comprehensive Audit Trail: Complete tracking of all system activities for compliance and troubleshooting
  • Flexible Reporting: Extensive built-in reports with custom report builder capabilities
  • User-Friendly Interface: Intuitive navigation and workflows for different user roles
  • Security First: Multiple layers of security including RBAC, SSO, and audit logging
  • Scalable Architecture: Designed to handle growing transaction volumes and user bases

The platform serves the needs of various stakeholders:

  • Fund Managers: Complete control over funds, pricing, and operations
  • Operations Staff: Efficient transaction processing and confirmation workflows
  • Compliance Officers: Tools for KYC/AML, risk management, and regulatory reporting
  • Agents: Commission tracking and member management
  • Investors/Members: Self-service portal and comprehensive statements
  • Management: Analytics, dashboards, and strategic reporting
  • IT Administrators: System configuration, user management, and integration tools

Unit Master represents a mature, battle-tested solution for unit trust operations with continuous enhancements to meet evolving regulatory requirements and business needs.


Document Version: 1.0
Last Updated: November 25, 2025
Platform Name: Unit Master
Developed By: WizGlobal Ltd

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment