Developers

Tests and validation

Backend, frontend, demo and export checks before a release.

Backend

.\.venv\Scripts\python.exe -m unittest discover -s tests -p "test_*.py"

Tests cover checkpoints, cleanup and segmentation, the engine, API, LLM security, text and PDF behavior.

Product frontend

npm --prefix web run build
npm --prefix web run test:e2e

Demo

npm --prefix web run check:demo
npm --prefix web run test:e2e:demo

Manual check

For a parser change:

  1. import a representative file;
  2. translate several segments;
  3. download the partial preview;
  4. complete the project;
  5. download the final export;
  6. open both files in a real reader.

A successful build does not validate mobile rendering, reconstructed-document quality or browser interactions.

Command-line interface

Typer commands available through main.py.

Contributing

Prepare a focused, tested change without private data.