Doc Keep — every document you can reach, in one list
Doc Keep is a single long list of every document stored in the compartments
you can reach, with a column for each thing the vault knows about it: the
filename, two dates, the size, the type it was identified as, the
compartments it is filed in, the summary the vault wrote after reading it
and the keywords it drew from that summary. The list is bounded by the
engine and not by the page, so a document filed somewhere you cannot reach
is not hidden on this view — it is not on it.
The two dates are deliberately kept apart, because they are not the same
kind of thing. The ingestion date is when this vault received the file: the
vault recorded it itself and nobody outside can move it. The file date is
the oldest date the document claims about itself, read out of the file's own
metadata, which the person who sent the file chose the contents of. Where a
file claims no date of its own, or claims one the vault refuses as
implausible, the vault keeps the claim empty and records why, so the column
can fall back to the ingestion date and say on the row that this is what it
is showing. A blank cell would say nothing and a borrowed date that does not
admit it is borrowed would say something false.
Sorting, filtering and paging exist so that a long list stays readable. They
are presentation and nothing else: everything a filter can bring into view
was in the list before it was typed, because the vault is never told what
the reader is looking for and offers no way to ask it for more.
An account that belongs to no compartment has nothing to keep
- Given an account that belongs to no compartment
- When the vault builds the Doc Keep listing for them
- Then the listing carries no documents at all
- And the vault records the reading as refused, not as an empty success
A file claiming to have been written in the future is not dated by its claim
- Given a file whose metadata claims it was written years from now
- When the vault decides what date the document claims about itself
- Then the vault holds no claimed date and names the claim it refused
A document that claims no date of its own is dated by the vault instead
- Given a document version whose file claims no date of its own
- When the vault builds the Doc Keep row for it
- Then the row holds no claimed date and says the document claimed nothing
- And the row still carries the date the vault received it
- And the ingestion date has not been copied into the claimed date
Narrowing the list is not a permission
- Given a person whose reach admits more than one document
- When the vault builds the Doc Keep listing for them
- Then the listing carries every document their reach admits
- And the vault was given nothing to search for, narrow by, or page through
Doc Keep lists only the documents a person's compartments admitstack
- Given a running vault with a member and a document filed beyond their reach
- When that member opens Doc Keep
- Then the document filed beyond their reach is not in the list
- And no row names a compartment they cannot reach