TFAST FinCore v7.0.0 Enterprise 100% Clean • Zero Telemetry

Enterprise Financial Operating System

Official system handbook, architecture blueprint, multi-persona user manuals, and live customer demo testing instructions.

Built and designed by TFAST Digital Agency Lead Developer: Kalyango Brian Default Currency: UGX (USh)
Live Demo Quick Launch
Launch Live System

Public Demo Access Credentials

This system is deployed in full interactive preview. Anyone can log in with any role to test end-to-end features.

Platform Core Specifications

Enterprise Grade

TFAST FinCore v7.0.0 is an institutional-grade financial operating platform designed for Savings and Credit Cooperative Societies (SACCOs), Microfinance Institutions (MFIs), Commercial Money Lenders, and Cooperatives across Africa and emerging markets.

Architectural Pillars
Modular Monolith Architecture

Domain modules (Loans, Savings, Members, SACCO Shares, Accounting, Reports) operate under contract-driven interfaces with dependency resolution. Modules can be enabled or disabled per institution profile without breaking core services.

Double-Entry General Ledger

Strict balance invariants. Every deposit, withdrawal, and transfer executes balanced debit and credit entries wrapped in atomic database transactions (DB::beginTransaction()) with automatic rollback on error.

Zero External Telemetry

100% clean and sovereign execution. All legacy third-party phone-home tracking scripts, remote licenses (remote license validation), and hidden backdoors have been permanently excised.

Ugandan & Regional Localization

Built-in compliance with Ugandan Microfinance Regulatory Authority (UMRA Tier 4) and URSB SIMPO asset security registries. Default currency set to UGX (USh) with active multi-currency conversion.

Loan Calculation & Amortization Formulas

Audited in app/Utilities/LoanCalculator.php with automated unit tests:

1. Flat Rate: Interest is calculated once on the initial principal for the entire loan duration:
Formula: Total Interest = (Principal * Interest Rate * Periods) / 100
2. Reducing Amount (Equal Installments): Principal decreases with each payment, calculating interest only on remaining balance.
3. Mortgage Amortization: Equalized monthly payments where the interest component decreases and principal increases:
Formula: PMT = P * (r / (1 - (1 + r)^-n))
4. Fixed Rate: Constant interest charged per periodic installment.
5. One-Time Payment: Entire principal and accrued interest paid as a lump sum at maturity.

Technology Stack

Framework Laravel 11.10.0
PHP Runtime PHP 8.4.26
Database MySQL 8.0+ (InnoDB)
Frontend Blade, Bootstrap 4, Vite
Analytics Chart.js 2.9+
Tables Engine jQuery DataTables AJAX
Mail Delivery Gmail TLS SMTP (Port 587)
Automated Tests 48 Tests / 235 Assertions
Tested and optimized for deployment on cPanel, Cloud VPS, and Docker containers.

Security Profile

  • 256-Bit SSL/TLS Strict Transport
  • Protected Cloaked Developer Account
  • Role-Based Access Control (RBAC)
  • CSRF Token Protection on all POST/PUT
  • Parameterized SQL Queries (Zero SQLi)

Administrator & Executive Back-Office Guide

Login as Admin

The Executive Back-Office provides full governance, credit underwriting, portfolio risk metrics, regulatory configuration, and institutional controls.

1. Portfolio Intelligence & Risk Desk

Located directly on the Administrative Dashboard (/dashboard), this desk tracks institutional solvency in real-time:

  • Gross Disbursed Capital: Cumulative loan principal released across all branches.
  • Total Collections: Real-time sum of repaid principal, interest, and late fees.
  • Portfolio at Risk (PAR > 30 Days): The critical microfinance health ratio calculated as (Principal in Arrears > 30d / Total Active Principal) * 100. Flagged in danger red when exceeding regulatory thresholds.
  • Member Liquidity Pool: Aggregate savings held across regular, fixed, and emergency accounts.
2. Institutional Profile & One-Click Templates

Under System Settings → FinCore Modules & Profile, administrators can select the active organization structure:

Profile Key Features Preset Product Templates
SACCO Share Capital, Dividends, Guarantors, Savings Multiplier Member Development Loan, School Fees Advance, Emergency Relief, Boda Boda Asset Finance
Microfinance (MFI) Group Lending (VSLA), Weekly Repayments, Field Collections Group Solidarity Loan, SME Working Capital
Money Lender Collateralized Short-Term Credit, Fast Processing Quick 30-Day Emergency Micro-Loan, Salary Advance
Cooperative Agricultural Inputs, Seasonal Harvesting Loans Seasonal Crop Advance, Agro-Processing Equipment Loan
3. Loan Approval & Repayment Schedule Generation

When a loan application is submitted, the credit officer navigates to Loans → Loan Applications:

  1. Review member KYC, credit source, and savings balance.
  2. Click Approve. FinCore will validate starting loan ID, deduct initial application/processing fees, generate the periodic installment schedule, and disburse principal to the member's savings account.
4. SACCO Share Capital & Dividend Distribution

Navigate to SACCO Shares → Share Products. Define nominal share values (e.g. 50,000 UGX/share). Members can purchase shares directly debited from their savings accounts. At end of financial year, use Dividends to input a surplus dividend pool; FinCore automatically calculates and credits dividends pro-rata based on member shareholdings.

Operations Staff & Cashier Guide

Login as Staff

Operations staff (Branch Tellers, Field Loan Officers, KYC Verifiers) have streamlined role-based permissions designed for daily counter and field execution.

1. Member Onboarding & KYC Compliance

Navigate to Members → Add New Member:

  • Enter Full Name, National Identification Number (NIN / National ID), Mobile Phone Number, and Physical Address.
  • Upload KYC documents (scanned National ID copy, passport photo, proof of residency).
  • On submit, FinCore automatically provisions primary savings accounts using configured defaults.
2. Cash Desk Deposits & Withdrawals
  • Deposit: Navigate to Transactions → New Deposit. Select member account, enter cash amount, and confirm payment method (Cash / Bank / Mobile Money). A double-entry credit is posted to the savings ledger.
  • Withdrawal: Select member account and enter withdrawal amount. FinCore performs an automated balance check to guarantee available funds (preventing unauthorized overdrafts).
3. Loan Application Intake

Tellers can submit loan applications on behalf of walk-in members under Loans → New Application. The system automatically computes estimated repayment schedules and checks guarantor requirements before placing the file into the committee approval queue.

Customer Member Digital Wallet Guide

Login as Customer

Members enjoy a modern, responsive digital banking portal accessible from desktop, tablet, or smartphone.

1. Digital Wallet Breakdown

On the Customer Dashboard (/dashboard), members see their true financial position:

Net Available Available for Transfer
Gross Savings Total Liquid Deposits
Locked Liens Guarantor Collateral
Active Debt Outstanding Loans
2. Instant Wallet Transfers
  • Own Account Transfer: Move funds seamlessly between personal savings and target accounts.
  • Other Member Transfer: Transfer funds instantly to peer members using their account number, with real-time balance checks and recipient verification.
3. Quick Loan Application & Self-Service Repayment
  • Apply: Members click Apply New Loan, select a loan product (e.g. Quick 30-Day Emergency Micro-Loan), and view exact installment terms.
  • Repayment: In My Loans, members can click Pay Now to pay individual installments or full balances directly deducted from their savings balance.

Test Credentials & Persona Matrix

Use any of the following accounts to test the live demo system:

Persona Login Email Password Scope & Capabilities Action
Platform Administrator (Full Back-Office) admin@tfast.test admin123456 Executive Portfolio Intelligence, loan product design, interest formula configuration, credit committee approvals, SACCO shares & dividend pools, currency & institutional switching. Test Login
Loan Officer & Cashier (Operations Desk) staff@tfast.test password123 KYC customer onboarding, photo & national ID verification, savings cash deposits, balance-checked withdrawals, loan application appraisal. Test Login
Customer Member (Digital Wallet) member@tfast.test member123456 Self-service customer portal, net available balance, instant wallet transfers, emergency micro-loans, amortization repayment schedule, self-service loan payment. Test Login

Web-Only Access & Enterprise Deployment Policy

Public Download Restricted: The online demo is strictly accessible through your web browser via Login and Register. Direct public downloads of the proprietary source code, database backups, and distribution archives are disabled to protect intellectual property and security invariants.

For licensed enterprise deployments on Hostinger, cPanel, or dedicated VPS servers, authorized clients receive private repository access directly from TFAST Digital Agency (https://tfastdigital.com/).

1. Accessing the Live Web Demo

Any client or evaluator can test the live platform without downloading any files:
• Interactive Web Login: https://fincore.tfastdigital.com/login
• New Member Registration: https://fincore.tfastdigital.com/register
• Pre-configured test accounts (Admin, Staff, Customer) are available on the login page for instant 1-click access.

2. Production Hosting & Server Requirements
  1. Web Server: Nginx or Apache (with mod_rewrite enabled).
  2. PHP Runtime: PHP 8.2 – 8.4 with BCMath, Ctype, cURL, DOM, Fileinfo, JSON, Mbstring, OpenSSL, PCRE, PDO, Tokenizer, XML extensions.
  3. Database: MySQL 8.0+ or MariaDB 10.5+ with InnoDB support.
  4. Document Root: Set document root to the public/ folder or use the included zero-configuration front controller for public_html.
Step 3: Database Creation & Import
  1. In cPanel, open MySQL Databases and create a new database (e.g. tfast_fincore_demo).
  2. Create a database user and assign ALL PRIVILEGES to the database.
  3. Open phpMyAdmin, select your new database, and click Import.
  4. Choose the provided database SQL file: database_backup/demo_database.sql (or database_backup/fincore_database.sql) and click Go.
Step 4: Configure Environment (.env)

Edit the .env file in your root folder with your live credentials:

APP_NAME="TFAST FinCore" APP_ENV=production APP_KEY=base64:3vV2r61Jq7OomJ51q3P6KqK5bXm8P2f8z+r5KqK5bXk= APP_DEBUG=false APP_URL=https://demo.tfastdigital.com DB_CONNECTION=mysql DB_HOST=127.0.0.1 DB_PORT=3306 DB_DATABASE=your_database_name DB_USERNAME=your_database_user DB_PASSWORD=your_database_password FINCORE_DEMO_MODE=true APP_INSTALLED=true
Step 5: Set Directory Permissions

Ensure the web server has write access to the caching and storage directories:

chmod -R 775 storage chmod -R 775 bootstrap/cache
Step 6: Live Verification

Navigate to your domain in any browser:
https://demo.tfastdigital.com/login
The demo login buttons will appear immediately, allowing clients and visitors to test the platform.