Vision Trace

Vision Json Parser Tool

Transfusion Immunohematology Results Management Platform | Phl-Soft | v1.0 | May 2026

VisionTrace is a modern, web-based platform designed specifically for transfusion biology laboratories. It provides secure, centralised access to immunohematology results stored in Couchbase from JSON files, with an intuitive browser interface that requires no software installation on end-user workstations.

Built on Delphi XE2 with an embedded HTTP server, VisionTrace combines enterprise-grade reliability with the simplicity of a single-page web application. This document describes its key capabilities for transfusion biologists and laboratory managers evaluating the solution for routine use and regulatory compliance.

1. Clinical Value and Traceability

Vision Trace is designed around the cumulative workflow of transfusion immunohematology. Every test result — ABO/Rh grouping, irregular antibody screening, antibody identification, compatibility testing — is retrieved directly from the Couchbase database by json data files imported by the application from the Vision analyser (external disk).
This ensures:

• Complete traceability from sample to result, with immutable JSON records stored in Couchbase.
• Instant access to historical results for any patient or donor by SID, PID, name, or donor ID. (... and QC)
• Audit-ready export to CSV/XLS with full column visibility for regulatory review (ISO 15189, ANSM).
• Long-term archiving: results are stored in Couchbase with no time limit; the web interface provides access to the full history without data migration. Size optimized pictures are stored by size reduced by 10.
• Cassette lot traceability: each result records the cassette barcode, decoded lot number (e.g. IGC189J), expiry date and cassette type — essential for reagent recall scenarios.
• Reagent traceability: every reagent code is decoded to human-readable format (name, lot, expiry date) — visible directly in the result grid and the printed report.

2. Powerful Search — Three "Magic" Buttons and Five Smart Filters

Finding the right result in a database of tens of thousands of records should take seconds, not minutes. VisionTrace offers three complementary search modes plus five self populated filter dropdowns, and search from a single toolbar.

• The NOK dashboard provides a direct view of all anomalous results for proactive quality monitoring.
• Patient discordance detection: the "Patient Disc." button highlights inconsistencies across multiple results for the same patient.
• Instant report to outline wrong QC results based on Z score detection.

The * wildcard is accepted in all text search fields, significantly reducing time spent locating records with ambiguous or incomplete identifiers.

Five intelligent dropdown filters allow instant refinement by: Profile, Test ID, Assay Reagent (decoded name + lot + expiry), Cassette Lot (decoded, e.g. "ABR401H"), and Instrument. Each dropdown is populated live from the database and triggers the search automatically on selection.

3. Integrated Reporting — One Click to a Print-Ready Document

A single click on any result row opens a fully formatted HTML report in a new browser tab, ready to print or export to PDF. The report is designed for direct use as a laboratory document — no reformatting required.

The report includes:

• Patient demographics: name, PID, date of birth, calculated age (in months if under 1 year), sex, sample type.
• Test context: SID, Test ID, profile, instrument, test date, transmission date, operator, donor SID, JSON file ID.
• Cassette header (decoded): type, ID, lot and expiry date — for each of the two cassette positions.
• Cassette result grid: always 2 cassettes × 6 columns. Each well shows: Assay ID with decoded name, Grade, Interpretation, Read Date, Initial/Edited Grade and Interpretation, and Reagent List (name + lot + expiry).
• Cassette images: side-by-side display with click-to-zoom and print-optimised layout (A4, compact margins).
• PHL-SOFT branded ;-) and automatic report date.

The print CSS ensures clean A4 output at all times.

4. Web-Based Access — Any Workstation, Any Browser

Vision Trace runs entirely in the browser — Chrome, Firefox, or Edge — with no plugins, no Java, no ActiveX. The embedded HTTP server (Indy) serves the single-page application directly from the Windows host.

• Any workstation on the local network accesses the interface via its IP address and port — no installation required on the client.
• Mobile and tablet access supported through responsive layout.
• Session-based authentication with HttpOnly cookies — no plain-text credentials in URLs or local storage.

5. Multilingual — 7 Languages with Hot-Reload

The interface is fully translated in 7 languages: French, English, Dutch, German, Spanish, Portuguese, and Russian.
Every label, column header, dropdown item, report field, error message, and login page is translated.

• Language is configured in VisionTrace.ini (Lang=fr, en, nl, de, es, pt, ru).
• A built-in file watcher detects changes to the INI file and reloads the language automatically within 2 seconds — no restart required.

6. Security and Regulatory Compliance

• Authentication: session cookie with configurable credentials stored as SHA-256 hash in users.ini. No default credentials in production.
• Session integrity: HttpOnly cookies prevent JavaScript access to session tokens (XSS protection).
• Network isolation: the HTTP server binds to the configured port only; external exposure requires explicit network or firewall configuration.
• Licence control: AES-256 encrypted licence file ties the software to hardware fingerprint. Operation is blocked if the licence is absent, expired, or tampered with.
• Query audit log: every N1QL query is logged to json_log.txt (ExportDir) with timestamp, action, duration and result count — supporting operational audit and performance trending.
• No cloud dependency: all data remains strictly on-premises. VisionTrace connects only to the local Couchbase instance. No telemetry, no external calls.

7. Deployment — Under 15 Minutes

VisionTrace is delivered as a single Windows executable. Full deployment requires:

• An auto installer will be deliverd...
• Edit VisionTrace.ini: set Couchbase URL, credentials, HTTP port, language, and paths.
• Place the licence.aes file in the executable folder.

No middleware, no IIS configuration.
Configuration changes (language, Couchbase URL, export path) take effect automatically via the built-in file watcher — no restart required.

Fast and easy Couchbase installation by delivered installer.

8. Technical Summary

For licensing enquiries or technical support, contact Phl-Soft.