DEV Community: Jun

How to test document management software with 20 real files

Jun — Mon, 24 Aug 2026 20:15:34 +0000

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

How to organize client documents as a freelancer

Jun — Tue, 28 Jul 2026 01:43:56 +0000

A working vault: every document in one category, tagged with the questions you will ask about it later.

Ask a freelancer where their client documents live and the honest answer is usually four places at once: a Downloads folder, an email thread, an accounting app, and a phone camera roll. Nothing is lost, exactly. It is just that finding any single thing means remembering which of the four it went into, and when.

Volume is not the problem. Three hundred documents a year is nothing for a computer. The problem is that every one of them arrives at a moment when you are busy, so the filing decision gets made badly or not at all. A system that works is one that makes the decision small enough to make correctly while distracted. This is how to build one. If what you want first is the inventory of what to keep and how long, the freelancer document checklist covers that; this piece is about the structure you put it in.

Why the last system collapsed

Almost every failed filing system fails in one of three ways, and all three are worth naming because the fix for each is different.

It was designed for the client list you had at the time. Three clients justify a folder per project. Thirty do not, and by then you have a hundred and forty folders whose names only made sense the week you created them.
The naming drifted. The first invoice was invoice-acme-march.pdf, the fourth was invoice_final_v2.pdf, and the one you actually sent was called Untitled (3).pdf. Nothing sorts, so nothing is findable except by opening files one at a time.
There was a Misc folder. Every system with an escape hatch ends with most of its documents in the escape hatch, because Misc is always the fastest correct answer in the moment.

The common thread is that each one asks you to make a judgement call at the worst possible time. Good structure removes the judgement: there is one obvious place, the name writes itself, and there is no Misc.

Organize for the question, not for the document

Filing systems get built around what a document is. Retrieval never works that way. You will go looking for a client document in one of four ways, and a structure is good exactly to the degree it answers all four.

By client. Everything for Acme, usually because a new project just started or an old one just went wrong.
By period. Everything from the 2025 tax year, which is what your accountant asks for, once, in a hurry.
By kind. Every signed contract, which is what you need the day you change your rates, your terms, or your insurance.
By a fragment. An invoice number, a project codename, a clause you half remember. This is the one no folder tree has ever answered.

Folders answer the first question well and the other three badly. That is not a reason to abandon folders. It is a reason to stop asking them to do everything, and to let naming, metadata and search carry the rest.

One folder per client, not one per project

The single highest-leverage decision is the level you file at. File per project and the structure grows by one folder every engagement, which is how you get to a hundred and forty. File per client and it grows by one folder every client, which is a number you can hold in your head. Projects become subfolders, where they belong, because a project without a client is not a thing you have.

A client folder holds the same six things every time, and the sameness is the point. You should never have to think about where something goes, only about whether you have it.

The signed service agreement that governs the relationship, plus any non-disclosure agreement with its expiry noted. These sit at the top level because they outlive every individual project.
One subfolder per engagement, holding that project's statement of work, the brief, the change orders, and the delivered files.
Invoices issued to this client, each one paired with its proof of payment. Keeping them together is what turns a chase into a thirty second job.
The onboarding sheet: billing contact, purchase order number, invoicing portal, payment terms, and the quirks of how this client likes to be billed. One page, dull, saves hours.
Correspondence worth keeping. Not the whole mailbox: the approval, the scope change agreed in a thread, the sign-off. If a decision was made in email, that email is a document.
Subcontractor paperwork for anyone you brought in on this client's work, including their independent contractor agreement and their tax form.

Name the file so it sorts itself

A filename is the only piece of metadata that survives every export, every email, and every handover to an accountant who has never heard of your system. Spend the four seconds. The pattern that works is date, then client, then what it is, and the date goes first in ISO order (year, month, day) because that is the one format where alphabetical sorting and chronological sorting are the same thing.

invoice_final_v2.pdf2026-03-14 Acme invoice 0042.pdf
contract (1).pdf2026-01-08 Acme master services agreement signed.pdf
Screenshot 2026-03-02 at 14.11.32.png2026-03-02 Acme receipt Adobe subscription.png
SOW final FINAL.docx2026-02-19 Acme SOW site redesign.docx

Two rules keep it honest. Use the date on the document, not the date you filed it, because that is the date anyone else will look for. And put the word signed in the name of a countersigned copy, so the executed version is never the one you have to open three files to identify.

Folders, categories and tags are three different tools

Most people use these interchangeably and then wonder why the system feels heavy. They answer different questions, and once you separate them the whole thing gets lighter.

A folder is where a document lives. One document, one folder, no exceptions. This is your client structure and nothing else.
A category is what kind of thing it is: a contract, an invoice, a receipt, a tax record. One per document, chosen from a short list you rarely change. This is what answers by kind.
Tags are the questions you expect to ask later: a project codename, unpaid, needs-signature, 2026. Many per document, cheap to add, and they cut sideways through the folders. A contract can be tagged both acme and expiring-soon without being copied anywhere.
Custom fields are the values you want to filter and sort on rather than read: invoice number, amount, renewal date, project. Fields are what let you ask for every unpaid invoice over a thousand rather than just every invoice.

The practical test: if you find yourself wanting to put a document in two folders, you wanted a tag. If you find yourself typing the same word into filenames over and over, you wanted a field.

Correspondent answers who it is from or to, concerning answers what it is about, and re-uploading keeps a new version instead of a second file called v3.

Give every client a lifecycle

The reason an old system feels cluttered is rarely the number of documents. It is that finished work and live work sit at the same level, shouting equally loudly. Give a client folder a state and the noise disappears without anything being thrown away.

Pitching. The proposal, the rate you quoted, the brief they sent. Costs nothing to keep, and it is what tells you what you charged when they resurface fourteen months later.
Active. Contract, statement of work, change orders, invoices, deliverables. The folder you touch weekly, and the only one that should show up in your default view.
Dormant. The work finished, the relationship did not. Nothing changes except that it stops competing for attention.
Closed. The engagement is over. Share links revoked, retention date noted, contract kept.

A tag is enough to carry the state. What matters is that moving a client from active to dormant is one click, because a transition that takes ten minutes is a transition nobody ever performs.

One way in, then one pass a week

Every filing system dies at the intake. Documents arrive by email, by download, by camera, by portal, and each route that ends somewhere different is another place to check later. Collapse them into one inbox and the sorting becomes a single small job rather than four.

Forward it rather than downloading it. An intake address that files mail attachments straight into the vault removes the step where a contract sits in Downloads for a month.
Photograph paper the moment it exists. A receipt in a pocket is a receipt you will reconstruct from a bank line in April, and thermal paper fades to blank within a year or two anyway.
Let everything land unreviewed on purpose. An inbox you trust is better than a filing decision made badly at a client's front desk.
Then clear it once a week. Ten minutes, the whole inbox, a category and a client on each item. Weekly is short enough that you still remember what each document was for, which is the entire reason it beats doing it in April.

One address, forwarded from your mail client, turns every contract and invoice that arrives by email into a filed document you did not have to download.

Four views worth living in

Once documents carry a category, a client and a few tags, the searches you repeat are worth saving. These four cover most of a freelance week, and each one replaces a habit of hunting.

The inbox. Everything arrives there unreviewed and leaves once you have filed it, so the number next to it is simply your backlog. Getting it to zero on a Friday is the whole weekly job.
Unpaid: invoices tagged unpaid, oldest first. Open it every Monday and the awkward chase happens at seven days rather than sixty.
This client, everything: one saved filter per active client, which is what you open the morning a new project starts.
Tax year: every financial document for the year, which is the one thing your accountant will ask for and the one you never have ready.

The fragment search matters as much as the views. Full-text search that reads inside a scan or a PDF is what answers the question folders cannot: you remember the invoice number but not the client, or a phrase from a clause but not which agreement it was in.

File by client, find by filter. The folder is where a document lives; the saved view is how you get back to a set of them.

Sharing without handing over the vault

Sooner or later a client wants copies of their own paperwork, or an accountant wants a year of it. The default move is a zip file in an email, which is the one copy you can never take back and never see again.

Share the saved search, not the folder. A link to a filtered set gives the accountant the whole tax year and nothing else, and it stays current if you add something.
Put an expiry on it from the start. A link that dies on its own is a link you do not have to remember to kill.
Add a password when the contents are worth one, which for a client's contracts and invoices they usually are.
Keep the list of what is open. The point of a share registry is that at any moment you can answer who can still see what, and revoke it in one click.

Every link you have handed out, with its expiry and access count, and one button to take it back.

Closing a client out

The end of an engagement is the moment the filing is either finished or abandoned, and it takes about ten minutes to finish it properly.

Issue the final invoice and record the payment against it, so the client folder does not sit open on your books for a year.
Hand over the deliverables and keep your own copy. What the client has is not a backup, and access to their systems is the first thing you lose.
Revoke the share links for that client. All of them, now, while you remember which they were.
Note when the NDA expires. Confidentiality duties routinely outlive the work by years, and this is the one obligation that quietly follows you.
Mark the folder closed rather than deleting it, and note the retention date. Contracts can be enforced long after delivery, and the retention windows behind that date are worth checking before anything is thrown away.

Thirty minutes to set it up

None of this needs a weekend. The whole structure goes in during one sitting, and the only part that requires discipline afterwards is ten minutes a week.

Make four top-level folders: Clients, Finance, Tax, Business. Five minutes, and this is the last time you think about top-level structure.
Make a folder for each active client. Active only. Dormant clients get one the day they come back.
Decide the filename pattern and write it somewhere you will see it. Date, client, what it is.
Set up one way in and point your email at it, so the next contract files itself.
Save the views you will actually open: unpaid, one per active client, and the tax year.
Put ten minutes in the calendar on a Friday, repeating. This is the only recurring cost of the entire system.

Then let it run. The measure of a filing system is not how good it looks a week after you build it, it is whether a client asking for last year's signed agreement gets an answer in the same conversation instead of a promise to dig it out. That is the whole return, and it compounds every year you keep working. The same argument, applied to the records outside your working life, is in why organizing your documents matters.

Sources

Originally published on the Stoatify blog. Written by the team behind Stoatify, a secure document platform for capturing, organizing, searching, sharing and signing documents.

The freelancer document checklist: what to keep and how long to keep it

Jun — Tue, 28 Jul 2026 01:43:15 +0000

Categories do the filing. Every item on the checklist below has one place it belongs, decided once instead of every time.

Nobody starts freelancing because they wanted to run a filing system. The paperwork arrives anyway, and from every direction at once: a contract in your email, an invoice in your accounting app, a receipt photographed in a restaurant, a tax form in the post in February. None of it is hard on its own. Together, and left for eleven months, it is the reason a Sunday disappears.

This is the list of what to keep, how long to keep it, and a structure that still works when you have thirty clients instead of three. It is general information for independent workers, not tax or legal advice. Retention rules differ by country and by state, and your own circumstances can extend them, so check with your accountant before you delete anything you might need.

The five piles

Everything a freelance business generates falls into one of five groups. Sorting by group first is what stops the list feeling infinite: you are not filing four hundred documents, you are filing five kinds of document, over and over.

Client and contract records: what you agreed to do, for whom, and on what terms.
Money coming in: what you earned, and whether you were actually paid for it.
Money going out: the deductions you can defend.
Tax and filing records: the returns, plus the working papers behind them.
Business identity and cover: proof the business exists and is allowed to operate.

1. Client and contract records

This is the section you reach for when a client disputes scope, timing, or payment, which is exactly the moment you cannot afford to be scrolling an email thread from last spring. Keep one set per client:

The signed contract or master agreement. Keep the fully countersigned copy, not the draft you sent. If you are still working from a template you inherited from someone else, the guide to the freelance service agreement covers the clauses worth having in it.
The statement of work or project brief for each engagement. Scope, deliverables, and dates are what actually settle a disagreement, and they are the part most often left verbal.
Change orders and scope amendments, including the email thread where the client agreed to them. A revision nobody wrote down is a revision you will be arguing about later.
Every non-disclosure agreement you have signed, with its expiry noted. Some outlast the engagement by years and quietly bind you long after the work ends.
The proposal or rate sheet you quoted from, which is what answers a client asking why this project cost more than the last one.
Intellectual property and licensing terms: who owns the work, what the client may reuse, and whether you kept the right to show it in a portfolio.
Subcontractor paperwork, if you hand work to anyone else. Their independent contractor agreement, their NDA, and their tax form belong alongside the client engagement they were hired for.
Client onboarding details: billing contact, purchase order number, invoicing portal, and payment terms. Losing these is the most common reason an invoice sits unpaid for a month.

Send the contract from the same place it is going to live. The sealed copy files itself back next to the draft, with a record of who signed and when.

2. Money coming in

Income records are the first thing an auditor asks for and the first thing you need when chasing a late payer. The test is whether you could reconstruct a full year of revenue from this pile alone.

Every invoice you issued, including the ones you voided or wrote off. A gap in the number sequence is the kind of thing that invites questions.
Proof of payment against each one: remittance advice, the bank statement line, or the payout report from your payment processor.
Monthly statements from Stripe, PayPal, Wise, or any marketplace you bill through, including their fees, which are deductible and routinely forgotten.
Business bank and credit card statements, every month, for every account the business touches. These are what reconcile everything else on this list.
Deposits and retainers, plus the record of what was drawn down and when. Money held against future work is not the same as money earned.
Late fee and collections correspondence, the demand letters and the replies, in case it ever escalates.
The tax forms clients issue to you, such as a 1099-NEC or 1099-K in the US and the equivalents elsewhere. Reconcile them against your own invoice records rather than trusting them.

3. Money going out

A deduction without a receipt is a deduction you may end up handing back. The difficulty is never the filing. It is that a receipt exists for about four seconds before it goes into a pocket.

Receipts for every business expense. Photograph the paper ones the day you get them, because thermal receipts fade to blank within a year or two.
Software, subscription, and tooling invoices. The annual renewals are the easy ones to miss: they arrive once and then never again.
Equipment purchases with their serial numbers and warranties, which you need for depreciation, warranty claims, and insurance.
Home office records: rent or mortgage interest, utilities, and the square footage calculation you based the claim on.
Travel, mileage, and client entertainment, with the business reason attached. The reason is the part everyone forgets and nobody can reconstruct in April.
Subcontractor invoices, the W-9 you collected before paying them, and the 1099 you issued afterwards.
Accountant, lawyer, and bookkeeper invoices, which are usually deductible and usually overlooked.

Capture at the moment, not at the deadline. Every document you defer becomes a document you reconstruct from memory, and memory is not evidence.

4. Tax and filing records

The return is only half the record. What you can prove is the other half, so keep the working papers with the filing they produced rather than in whichever tool generated them.

The version of each return actually filed, with every schedule and attachment, not the draft your software last saved.
Confirmation for each quarterly estimated tax payment. Proving you paid on time is what avoids the penalty.
Sales tax or VAT registrations and returns, plus the evidence behind any exemption you claimed for a client.
Payroll records, if you pay yourself or anyone else: the filings, the deposits, and the individual pay records behind them.
A year-end profit and loss statement for each tax year, matching the return you filed from it.
Correspondence from any tax authority, including letters about matters you have already resolved. A closed matter still needs its paper trail.

5. Business identity and cover

You need these rarely and urgently, which is the worst possible combination to go hunting for. A larger client's procurement team can ask for three of them in a single afternoon.

Formation documents: LLC articles, incorporation certificate, partnership agreement, or your sole trader registration.
Tax identification numbers, such as the EIN letter or a VAT number. Requested constantly during client onboarding.
Professional licenses and certifications, with their renewal dates recorded somewhere that will tell you before they lapse.
Insurance policies and the certificates that go with them: professional indemnity, general liability, and equipment cover. Enterprise clients often ask for the certificate before they will sign.
Business registrations and permits, including local trading permits and DBA filings with annual renewals.
Bank account and loan agreements, with the terms attached to any credit facility.

Anything with a renewal date gets a reminder attached to the document itself, so a lapsed license or an expired certificate of insurance is never something you discover during a client's onboarding.

How long to keep it

The instinct is to keep everything forever, which is how a vault turns into a landfill. In the US, the IRS publishes periods of limitations that set how long your records need to survive. Where two of them apply, the longer one wins.

3 yearsThe ordinary income and expense records behind a filed return. This is the standard assessment window, counted from the date you filed.
4 yearsEmployment tax records, counted from the date the tax becomes due or the date you paid it, whichever is later.
6 yearsEverything, if you failed to report income you should have reported and it came to more than 25 percent of the gross income shown on the return.
7 yearsThe records behind a claim for a bad debt deduction or a loss from worthless securities.
Life of the assetProperty and equipment records, until the limitations period runs out for the year you finally dispose of the asset. You need the purchase record to compute the gain or loss.
IndefinitelyThere is no time limit at all if a return was never filed or was fraudulent. Keep the returns themselves, your contracts, and your formation documents regardless.

Those windows are the US federal floor, not the ceiling. State rules, non-US rules, a lender, an insurer, or a clause in a client contract can all require longer. Contracts are the clearest case: one can be enforced long after the work ends, so keep it for as long as anything inside it could still bite.

A structure that still works at thirty clients

Most filing systems collapse because they were designed for the client list you had when you built them. This one has four top-level folders and grows sideways, so client thirty files exactly like client three.

Clients, one folder per client rather than per project. Projects become subfolders holding the contract, the statement of work, and the deliverables for that engagement.
Finance, split by direction and then by year: invoices, expenses, and statements. This is the split your accountant already thinks in.
Tax, one folder per tax year, holding the return and the working papers behind it.
Business, holding formation, licenses, insurance, and registrations. Small, rarely opened, and needed under pressure.

Then tag across the folders. A document lives in one place but answers to many questions, and the question you actually ask later is rarely the one the folder was named for. Categories and tags cut sideways through the structure, so every contract in the business is one filter away no matter which client folder holds it, and searching the text inside a scan finds the invoice number you half remember. The structure in full, with naming, the client lifecycle and the weekly pass that keeps it true, is in how to organize client documents as a freelancer.

File by client, find by search. The folder is where a document lives; the filters are how you get back to it.

Four habits that keep the list true

The checklist is the easy part. Staying on top of it is what separates a vault from a shoebox.

Capture at the moment, not at the deadline. Photograph the receipt in the restaurant, file the invoice the day it lands, and you never have to reconstruct anything.
File by client, find by search. Folders are for the structure you think in, so you do not need a folder for every question you might ask later.
Keep the signed copy with the draft. Two years on, the countersigned version should not be the thing you go hunting for in an email thread.
Do a fifteen minute close each month. Reconcile invoices against payments, file the month's receipts, check nothing is missing. Twelve short sessions beat one long weekend in April, and gaps surface while you still remember what happened.

The contracts behind the list

Four items above are documents you have to write rather than simply file. Each one has its own guide:

Freelance service agreement: the master terms that govern the relationship, clause by clause.
Statement of work: scope, deliverables, milestones, fees, and a definition of done that both sides approved.
Non-disclosure agreement: what counts as confidential, who may see it, how long the duty lasts, and what happens when the engagement ends.
Independent contractor agreement: the agreement to use when you are the one hiring, and the classification questions behind it.

Work the list once, then keep it as the standard you file against. The point was never tidy folders for their own sake. It is that when a client, an accountant, or an auditor asks for something, you produce it in seconds and get back to the work you actually sell.

Sources

Originally published on the Stoatify blog. Written by the team behind Stoatify, a secure document platform for capturing, organizing, searching, sharing and signing documents.