mirror of
https://github.com/MBombeck/HealthLog.git
synced 2026-11-17 07:42:23 +00:00
feat(documents): build the Documents library UI
Evolve the inbound-documents screen into a real document library on top of the store-first backend. - Upload stays store-only and always works: the form now files a document with an optional title, category, and document date in one step. Extraction is a separate, explicit action. - List becomes an organized library: documents grouped by date, with a title (filename fallback), category and status badges, and pending/fact counts. A toolbar adds title/filename search, a category filter, and a sort control (document date / date added / title, asc/desc). Keyset pagination loads more via the returned cursor through useInfiniteQuery. - Detail panel: view or download the original, edit metadata (rename, recategorise, set the document date), optionally run extraction, then the existing review-then-confirm flow. When no scan provider is configured, extraction surfaces a calm inline note instead of a hard error; the stored document is untouched. Discard stays. - Add a parameterised list key to the query-key factory so each filter/sort combination keeps its own cache bucket while staying under the documents prefix for invalidation. - Rename the surface to "Documents" across all six locales (title, subtitle, module label/description) and add the new toolbar, edit, extract, and date-group strings. Route, model, and module key stay internal. Add component and unit coverage for the grouped list, the detail/review surface, the metadata edit form, the provider-unsupported note, and the search-param/grouping/error-classification helpers.
This commit is contained in:
1 parent
02df0d1f0e
commit
c6a7de8f2a
11 files changed
+1606
-284
No files matched your search
@@ -1,12 +1,42 @@
|
||||
/**
|
||||
* Query keys — inbound clinical documents (v1.25, W-DOCS-IN): the document
|
||||
* list and a single document's review detail (document + staged facts).
|
||||
* Part of the centralized factory; aggregated in `./index.ts`. Any inbound
|
||||
* write (upload / edit / confirm / discard) invalidates the `["documents"]`
|
||||
* prefix so the list and the open review repaint in lockstep.
|
||||
* Query keys — clinical documents library (v1.25, W-DOCS-IN): the browsable
|
||||
* document list (search / category filter / sort, keyset-paginated) and a
|
||||
* single document's detail (document + staged facts). Part of the centralized
|
||||
* factory; aggregated in `./index.ts`. Any document write (upload / edit /
|
||||
* extract / confirm / discard) invalidates the `["documents"]` prefix so the
|
||||
* list and the open detail repaint in lockstep.
|
||||
*/
|
||||
import type {
|
||||
DocumentListSort,
|
||||
InboundDocumentKindValue,
|
||||
} from "@/lib/validations/inbound-documents";
|
||||
|
||||
/**
|
||||
* The parameter set that distinguishes one library list view from another.
|
||||
* Lives in the key so two different filter/sort combinations never share a
|
||||
* cache bucket. `undefined` fields are dropped by TanStack's stable hash, so a
|
||||
* bare `{ sort, order }` and `{ q: undefined, kind: undefined, sort, order }`
|
||||
* resolve to the same key.
|
||||
*/
|
||||
export interface DocumentListParams {
|
||||
q?: string;
|
||||
kind?: InboundDocumentKindValue;
|
||||
from?: string;
|
||||
to?: string;
|
||||
sort: DocumentListSort;
|
||||
order: "asc" | "desc";
|
||||
}
|
||||
|
||||
export const documentKeys = {
|
||||
documents: () => ["documents"] as const,
|
||||
inboundDocuments: () => ["documents", "inbound"] as const,
|
||||
/**
|
||||
* The parameterised library list (keyset-paginated via `useInfiniteQuery`).
|
||||
* The literal `"list"` segment keeps it distinct from a single-document key
|
||||
* (`inboundDocument(id)`); cuid ids never collide with it. Stays under the
|
||||
* `["documents", "inbound"]` prefix so prefix invalidation still reaches it.
|
||||
*/
|
||||
inboundDocumentList: (params: DocumentListParams) =>
|
||||
["documents", "inbound", "list", params] as const,
|
||||
inboundDocument: (id: string) => ["documents", "inbound", id] as const,
|
||||
};
|
||||
Reference in new issue
Block a user