DEV Community

Jun
Jun

Posted on Originally published at stoatify.com

How to test document management software with 20 real files

Most software evaluations test the happy path. Document systems need a less cooperative fixture set: phone scans, repeated names, signed revisions, office files, and access rules.

Build a test set of 20 synthetic or non-sensitive files:

  • clean PDFs and phone scans;
  • invoices, receipts, agreements, and office documents;
  • repeated client or vendor names;
  • one draft and final pair;
  • two files another test user may access and two they may not.

Do not use customer, employee, medical, financial, or identity records in a vendor demo.

Capture test

Upload from the devices and sources you actually use. Record failed uploads, format errors, duplicate handling, processing states, and manual corrections. “The files arrived” is not enough if you cannot tell which files failed.

Retrieval test

Choose five phrases that appear inside scans or PDFs but not in their filenames. Search for each phrase, then narrow the results with a category, tag, contact, date, or another field you will maintain.

This distinguishes extracted-text retrieval from filename search.

Version test

Use the draft and final pair. Confirm that you can identify the approved or signed version, inspect its history, and recover the original file without guessing from names such as final-v3-really-final.pdf.

Access test

Grant another test user access to two intended files. Verify that the other two remain unavailable, then revoke the grant and confirm the change. Use synthetic records throughout.

Repeatability test

Add five more files without changing the filing method. If the second batch forces a different naming convention or more cleanup, the workflow is unlikely to hold up at archive scale.

Score setup time, capture failures, search misses, corrections, permission mistakes, extra tools, and the monthly price for your real usage.

I build Stoatify, a secure document platform for people and organizations. I turned this method into a free 12-point worksheet that works with any product: https://stoatify.com/s/devto-20doc-20260824

Top comments (0)