PCR.AI Software Test Documentation (STD)
Version: 3.0.0 Date: January 2026 Status: Complete
1. Purpose
This Software Test Documentation (STD) set describes the test approach, test infrastructure, and test artifacts for PCR.AI v3. It follows IEEE Std 829-2008 (Standard for Software and System Test Documentation) with tailoring appropriate for a cloud-based SaaS application.
The STD provides complete test coverage for all requirements defined in the SRS, enabling:
- Verification that implementation meets requirements
- Traceability from requirements to test artifacts
- Consistent test method selection across domains
- Regulatory compliance evidence
2. Audience
| Reader | Use Case |
|---|---|
| QA engineers | Test execution, test case reference, automation implementation |
| Developers | Understanding testability requirements, HTML attribute conventions |
| Technical leads | Test coverage review, release readiness assessment |
| Regulatory reviewers | Validation evidence, test traceability to requirements |
3. Coverage Summary
| Metric | Value |
|---|---|
| Total STD Documents | 99 |
| Domain STDs | 29 |
| Rule STDs | 61 |
| Root Documents | 9 |
| Requirements Covered | 405 |
| Test Cases (Domains) | 459 |
| Test Vectors (Rules) | 1,350 |
| Total Test Artifacts | 1,809 |
| Overall Coverage | 100% |
4. Document Index
4.1 Root Documents
| Document | Description |
|---|---|
| std-introduction.md | This document - overview and index |
| std-test-plan.md | Test method selection policy and strategy |
| unified-traceability-matrix.md | Requirements to test case mapping |
| unified-coverage-report.md | Coverage metrics and gap analysis |
| std-ui-testability.md | HTML attribute naming conventions for automation |
4.2 Domain STDs
Test specifications for functional domain requirements (29 documents in domains/):
| Domain | Document | REQs | Test Cases |
|---|---|---|---|
| Analytics | std-analytics.md | 2 | 6 |
| Analyzer | std-analyzer.md | 1 | 4 |
| Audit Log | std-audit-log.md | 4 | 11 |
| Client Config | std-client-config.md | 3 | 13 |
| Comments | std-comments.md | 10 | 19 |
| Config I/O | std-configio.md | 14 | 21 |
| Error Codes | std-errorcodes.md | 11 | 18 |
| File Import | std-fileimport.md | 13 | 23 |
| Filters | std-filters.md | 1 | 10 |
| Global UI | std-globalui.md | 9 | 17 |
| Help | std-help.md | 5 | 15 |
| Introduction (SRS) | std-introduction-srs.md | 0 | 0 |
| Keyboard | std-keyboard.md | 2 | 8 |
| Kit Config | std-kitcfg.md | 28 | 42 |
| Known Issues | std-known-issues.md | 0 | 0 |
| NFR | std-nfr.md | 5 | 12 |
| Notifications | std-notif.md | 5 | 11 |
| std-print.md | 5 | 6 | |
| Progress | std-progress.md | 4 | 11 |
| Reanalyze | std-reanalyze.md | 8 | 16 |
| Reports | std-reports.md | 25 | 35 |
| Runfile List | std-runfile-list.md | 11 | 25 |
| Runfile Report | std-runfile-report.md | 28 | 39 |
| Site | std-site.md | 5 | 9 |
| Tables | std-tables.md | 6 | 18 |
| UI | std-ui.md | 1 | 3 |
| Upload Runs | std-upload-runs.md | 7 | 15 |
| User Management | std-user-management.md | 16 | 36 |
| User Settings | std-user-settings.md | 3 | 8 |
Note: Introduction (SRS) and Known Issues are meta-documents with no testable requirements.
4.3 Rule STDs
Test specifications for analytical rule requirements (61 documents in rules/). Each rule STD contains decision tables with test vectors covering all input combinations.
See unified-coverage-report.md for the complete rule STD listing with coverage metrics.
5. Test Methods
The STD uses four test methods, selected per the Test Plan:
| Method | Code | Description | When Used |
|---|---|---|---|
| API Testing | TM-API | Backend API calls via PHPUnit/Behat | Pure backend logic, rules, data operations |
| UI Testing | TM-UI | Browser automation via Behat/Mink + headless Chrome (CDP) | User-facing features, form interactions |
| Hybrid Testing | TM-HYB | Combined API setup + UI verification | Workflows spanning backend and frontend |
| Manual Testing | TM-MAN | Human verification | Visual/UX validation, edge cases |
6. Relationship to Other Documents
| Document Set | Location | Relationship |
|---|---|---|
| SRS | docs/*.md, docs/rules/*.md | Requirements that tests validate |
| SDS | docs/sds/ | Design decisions informing test approach |
Boundary with SDS
| Content | Location |
|---|---|
| How tests are structured (infrastructure) | SDS |
| What tests exist and how to run them | STD (this document set) |
| HTML testability attributes | STD (std-ui-testability.md) |
7. Version History
| Version | Date | Description |
|---|---|---|
| 3.0.0 | January 2026 | Complete STD with 100% requirement coverage |