Skip to content

Accounting Service QA Framework

Welcome to the comprehensive documentation for the Accounting Service QA Test Framework.

Quick Navigation

What This Framework Does

✅ Document Import - Validate invoice and credit note imports ✅ Document Retrieval - Verify HTML and JSON document generation ✅ Data Validation - Compare expected vs actual document data ✅ Access Control - Test GDPR group permissions and user access ✅ Multi-Platform - Support for Helios, Xero, NetSuite, Oanda ✅ Multi-Country - Tax calculations for 40+ countries ✅ Multi-Currency - Exchange rates, local currency, crypto ✅ Translation - Arabic translations for AE, SA, OM

Quick Start

Docker Setup

# Create Docker network
docker network ls | grep infra-demo || docker network create infra-demo

# Start container
make run-dev-container

# Run tests
docker exec -it accounting-service-qa behave

Local Setup with Poetry

# Install dependencies
cd qa
poetry install

# Activate environment
poetry shell

# Run regression tests
make run-smoke

Key Features

  • BDD with Gherkin - Human-readable test scenarios
  • Pydantic Models - Type-safe data validation
  • Deep Comparison - DeepDiff for nested structure validation
  • Retry Logic - Handles rate limiting and conflicts automatically
  • Multi-Platform - Platform-specific strategies for Helios/Xero/NetSuite
  • Comprehensive Logging - Debug support with structured logging
  • Parallel Execution - Run tests in parallel for faster feedback

Documentation Structure

docs/
├── DEVELOPER_GUIDE.md          # Complete setup and workflow
├── ARCHITECTURE.md             # Framework design and patterns
├── EXTERNAL_RESOURCES.md       # External links and specs
├── GLOSSARY.MD                 # Abbreviations and terms
└── INVOICE_IMPORT_WITH_PAYMENT_INFO_WALKTHROUGH.md  # E2E flow