Digital Sales API Test Data Generator

A web-based tool for generating valid JSON test data for Digital Sales API testing, specifically focused on streamlining QA workflows for applicant configurations.

🎯 Project Overview

This tool helps QA engineers generate realistic, UK-compliant JSON payloads for the Digital Sales API without manually crafting test data. It features a form-based interface for configuring applicant details, real-time JSON preview, and export capabilities.

🚀 Quick Start

1. Install Dependencies

   cd backend
   pip install -r requirements.txt

2. Run the Application

   cd backend
   python app.py

3. Access the Tool Open your browser to http://localhost:5000

📋 Project Status

This project is currently in development. See the Issues for current tasks and progress.

MVP Features

• ✅ Generate Valid Applicant JSON
• ✅ UK-Valid Randomization
• ✅ JSON Preview Panel
• ✅ Static Defaults for Non-Applicant Data
• ✅ History of Generated Payloads
• ✅ Export JSON to CSV

Technical Implementation

• ✅ Basic Web UI (HTML + JS)
• ✅ Backend Generator (Python)
• ✅ Generate JSON Button
• ✅ Project Boilerplate
• ✅ README with Instructions

📚 Documentation

• Product Requirements Document - Detailed project requirements and specifications
• Issues - Implementation tasks and user stories

🛠 Tech Stack

• Backend: Python (Flask)
• Frontend: Plain HTML/JS (minimal dependencies)
• Libraries: Faker, random, json, csv
• Data Generation: UK-focused synthetic data

📋 Features

Core Functionality

• Form-based Configuration: Easy-to-use interface for applicant setup
• UK Data Validation: Realistic postcodes, phone numbers, bank details
• Real-time Preview: Live JSON updates as you type
• Export Options: Copy individual payloads or download CSV batches
• Session History: Keep track of previously generated test data

Target Users

• Primary: QA Engineers performing manual API testing
• Secondary: Developers needing test data for Digital Sales API

💻 Usage

1. Configure applicant settings in the left panel
2. Click "Generate JSON" to create test data
3. Use the preview panel to review the generated JSON
4. Copy or export the JSON for use in your API tests

📁 Project Structure

digital-sales-api-test-generator/
├── backend/
│   ├── app.py              # Flask application
│   └── requirements.txt    # Python dependencies
├── frontend/
│   ├── templates/
│   │   └── index.html      # Main HTML template
│   └── static/
│       ├── css/
│       │   └── style.css   # Styling
│       └── js/
│           └── app.js      # Frontend logic
└── README.md

📝 Contributing

This project follows a GitHub Issues workflow. Each feature is tracked as a user story with clear acceptance criteria. Check the Issues tab to see current work and contribute.

Issue Labels

• mvp - Core MVP features
• post-mvp - Future enhancements
• frontend - UI-related tasks
• backend - Server-side tasks
• setup - Project infrastructure
• documentation - Docs and guides

---

This project is designed to streamline manual testing workflows and eliminate the tedious process of crafting valid test data for API endpoints.