MoMo Sandbox

A fictional mobile money and USSD testing simulator inspired by the telecom and mobile-money testing workflows I encountered during my internship.

Disclaimer: MoMo TestLab is an educational and portfolio project. It is not affiliated with, connected to, or endorsed by MTN, Ericsson, or any other telecommunications or financial institution. It does not use real customer data, financial services, or proprietary systems.

Overview

MoMo TestLab simulates a controlled environment for testing mobile-money services and USSD functionality.

The project is designed to demonstrate concepts such as:

• Test number management
• Subscriber, Merchant, and Agent profiles
• PIN reset workflows
• USSD menu testing
• Debug/sandbox environments
• User Acceptance Testing (UAT)
• Test fund allocation
• USSD feature testing
• Activity and audit logging

The goal is to provide a simplified representation of how different components of a mobile-money testing environment can interact.

Current Features

📱 Test Number Management

Simulate the management of registered numbers and their conversion into test numbers.

Test numbers can have different profiles and environments:

• Subscriber
• Merchant
• Agent

🔐 PIN Reset Simulator

Simulates a PIN reset workflow involving:

1. Number identification
2. Database verification
3. PIN reset request
4. PIN entry
5. PIN confirmation
6. Successful reset

📟 USSD Simulator

Provides an interactive phone-style interface for testing fictional USSD services.

Currently simulated:

• *156# — Number identification
• *458# — Debug/Test menu

🧪 UAT Simulator

Simulates the process of preparing a test account for User Acceptance Testing:

1. Enable test/debug access
2. Allocate test funds
3. Access the debug USSD menu
4. Test functionality
5. Record the result

💰 Test Funds

Provides fictional balances for simulated transaction testing without interacting with any real financial system.

📋 Activity Logs

Records simulated actions such as:

• Test number conversion
• PIN resets
• Test fund allocation
• Debug access changes
• UAT activity

Tech Stack

• TanStack Start
• TypeScript
• React
• Tailwind CSS
• Lovable

Development

Clone the repository and install the dependencies:

git clone <this-repository-url>
cd <repository-name>
npm install
npm run dev

The development server will start locally and provide the address for accessing the application.

Project Status

🚧 Early Prototype

The current version focuses primarily on demonstrating the user interface and core simulated workflows.

Future development may include:

• Persistent database storage
• Authentication and role-based access
• More advanced USSD flow building
• Transaction simulation
• Expanded UAT functionality
• Detailed audit trails
• Backend APIs
• More realistic system interactions

Purpose

This project is primarily a learning and portfolio exercise aimed at exploring how software systems can model telecom and mobile-money testing workflows.

It is intentionally designed as a fictional simulation rather than an attempt to reproduce or interact with any proprietary Ericsson or MTN systems.

Roadmap

See ROADMAP.md for planned features and future development.