mirror of
https://github.com/MBombeck/HealthLog.git
synced 2026-11-16 07:13:29 +00:00
feat(documents): preview thumbnails in the vault overview
Render a small JPEG preview for each stored document and show it at the card's leading edge, falling back to the kind icon when none exists. - Generate previews in the background on upload (new document-thumbnail pg-boss queue) plus a boot-time corpus backfill for existing documents; upload never blocks on or fails because of it. Images are downscaled via @napi-rs/canvas, a PDF's first page is rasterised then downscaled, every other type is skipped. Generation never throws. - Store the preview encrypted at rest in a 1:1 DocumentThumbnail side table (migration 0236) so the list/detail queries that omit the original blob never drag the preview either. Same AES-256-GCM string codec + fail-closed decrypt as the content index; wired into the key-rotation walk. - Serve it through an owner-scoped GET /api/documents/inbound/[id]/thumbnail (auth + module gate + userId-scoped query + fail-closed decrypt), always image/jpeg + nosniff + private, no-store; 404 on miss. The card renders an authed lazy <img>, onError falls back to the icon. - Add hasThumbnail to the document DTO so the card only fetches a preview that exists. Also drop the "search looks inside your documents" caption from the overview (the index-all prompt stays) and the per-card searchable marker; both were noise. Remove the now-unused i18n keys across all six locales.
This commit is contained in:
1 parent
54c78b527e
commit
ee76672798
34 files changed
+1342
-160
No files matched your search
@@ -0,0 +1,50 @@
|
||||
-- Document vault: encrypted preview thumbnails.
|
||||
--
|
||||
-- `document_thumbnails` — a 1:1 sibling of `inbound_documents` holding a small
|
||||
-- JPEG preview (~320px long edge, q70) rendered in the background from the
|
||||
-- original: images are decoded + downscaled, a PDF's first page is rasterised.
|
||||
-- The blob rides `thumbnail_encrypted` in the `encrypt()`-string-as-UTF-8
|
||||
-- BYTEA shape (base64 of the JPEG) `document_content_index.text_encrypted`
|
||||
-- uses — a scanned medical preview is PHI, never stored in the clear or
|
||||
-- logged. The canvas re-encode strips EXIF/GPS from the source, so the
|
||||
-- preview is metadata-free by construction.
|
||||
--
|
||||
-- A SIDE TABLE, not a column on `inbound_documents`, so the list/detail
|
||||
-- queries that `omit` the original blob never drag this blob into the SELECT.
|
||||
--
|
||||
-- Both foreign keys cascade: a deleted document (or user) takes its thumbnail
|
||||
-- with it. Additive; applies clean on a 0234 database and on a fresh database.
|
||||
|
||||
-- CreateTable
|
||||
CREATE TABLE "document_thumbnails" (
|
||||
"id" TEXT NOT NULL,
|
||||
"document_id" TEXT NOT NULL,
|
||||
"user_id" TEXT NOT NULL,
|
||||
"thumbnail_encrypted" BYTEA NOT NULL,
|
||||
"width" INTEGER NOT NULL,
|
||||
"height" INTEGER NOT NULL,
|
||||
"byte_size" INTEGER NOT NULL,
|
||||
"source_mime" TEXT NOT NULL,
|
||||
"created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
|
||||
"updated_at" TIMESTAMP(3) NOT NULL,
|
||||
|
||||
CONSTRAINT "document_thumbnails_pkey" PRIMARY KEY ("id")
|
||||
);
|
||||
|
||||
-- 1:1 with the document.
|
||||
CREATE UNIQUE INDEX "document_thumbnails_document_id_key"
|
||||
ON "document_thumbnails" ("document_id");
|
||||
|
||||
-- Owner-scoped queries (the backfill discovery + list-page existence probe).
|
||||
CREATE INDEX "document_thumbnails_user_id_idx"
|
||||
ON "document_thumbnails" ("user_id");
|
||||
|
||||
ALTER TABLE "document_thumbnails"
|
||||
ADD CONSTRAINT "document_thumbnails_document_id_fkey"
|
||||
FOREIGN KEY ("document_id") REFERENCES "inbound_documents" ("id")
|
||||
ON DELETE CASCADE ON UPDATE CASCADE;
|
||||
|
||||
ALTER TABLE "document_thumbnails"
|
||||
ADD CONSTRAINT "document_thumbnails_user_id_fkey"
|
||||
FOREIGN KEY ("user_id") REFERENCES "users" ("id")
|
||||
ON DELETE CASCADE ON UPDATE CASCADE;
|
||||
@@ -807,6 +807,7 @@ model User {
|
||||
extractedFacts ExtractedFact[]
|
||||
documentConditionLinks DocumentConditionLink[]
|
||||
documentContentIndexes DocumentContentIndex[]
|
||||
documentThumbnails DocumentThumbnail[]
|
||||
// v1.19.0 — full Withings ECG waveform recordings (encrypted at rest).
|
||||
// The paired AFib verdict still lands as an IRREGULAR_RHYTHM_NOTIFICATION
|
||||
// Measurement EVENT row (v1.18.11); this holds the raw signal samples.
|
||||
@@ -5928,6 +5929,11 @@ model InboundDocument {
|
||||
/// 1:1 blind content-search index (encrypted extracted text + HMAC token
|
||||
/// array). Absent until the document is indexed; cascades on delete.
|
||||
contentIndex DocumentContentIndex?
|
||||
/// 1:1 encrypted preview thumbnail (small JPEG, AES-256-GCM at rest).
|
||||
/// Absent until the background thumbnail job runs; a side table (not a
|
||||
/// column) so the list/detail `omit: { contentEncrypted }` queries never
|
||||
/// drag the blob into the SELECT. Cascades on delete.
|
||||
thumbnail DocumentThumbnail?
|
||||
/// v1.27.33 (Document vault P4) — "chat about a document" threads. Each is a
|
||||
/// `CoachConversation` with `documentId` set to this document; cascades on
|
||||
/// delete so a discarded document takes its chats with it.
|
||||
@@ -6079,3 +6085,40 @@ model DocumentContentIndex {
|
||||
@@index([userId])
|
||||
@@map("document_content_index")
|
||||
}
|
||||
|
||||
/// 1:1 encrypted preview thumbnail for a stored document. A small JPEG
|
||||
/// (~320px long edge, q70) rendered in the background from the original —
|
||||
/// images are decoded + downscaled, a PDF's first page is rasterised — then
|
||||
/// stored encrypted at rest. Held in a side table (not a column on
|
||||
/// `InboundDocument`) so the list/detail queries that `omit` the original
|
||||
/// blob never drag this blob either. The re-encode strips EXIF/GPS from the
|
||||
/// source, so the preview is metadata-free by construction. Owner-scoped
|
||||
/// serve route only; cascades on delete.
|
||||
model DocumentThumbnail {
|
||||
id String @id @default(cuid())
|
||||
documentId String @unique @map("document_id")
|
||||
userId String @map("user_id")
|
||||
/// AES-256-GCM ciphertext of the JPEG preview, stored as the
|
||||
/// `encrypt()`-string-as-UTF-8 Bytes shape (base64 of the JPEG), the same
|
||||
/// codec `DocumentContentIndex.textEncrypted` uses so the standard
|
||||
/// key-rotation walk covers it. A scanned medical preview is PHI — never
|
||||
/// stored in the clear or logged. The list query never selects it.
|
||||
thumbnailEncrypted Bytes @map("thumbnail_encrypted")
|
||||
/// Decoded thumbnail dimensions (px) — diagnostic + lets a future consumer
|
||||
/// size the tile without decoding the blob.
|
||||
width Int
|
||||
height Int
|
||||
/// Plaintext byte length of the JPEG (pre-encryption), for `Content-Length`.
|
||||
byteSize Int @map("byte_size")
|
||||
/// Source MIME the preview was rendered from (diagnostic only).
|
||||
sourceMime String @map("source_mime")
|
||||
|
||||
createdAt DateTime @default(now()) @map("created_at")
|
||||
updatedAt DateTime @updatedAt @map("updated_at")
|
||||
|
||||
document InboundDocument @relation(fields: [documentId], references: [id], onDelete: Cascade)
|
||||
user User @relation(fields: [userId], references: [id], onDelete: Cascade)
|
||||
|
||||
@@index([userId])
|
||||
@@map("document_thumbnails")
|
||||
}
|
||||
Reference in new issue
Block a user