Files
familienarchiv/docs/architecture/db/db-orm.puml
Marcel d959cb54f1
Some checks failed
CI / Unit & Component Tests (pull_request) Successful in 3m59s
CI / OCR Service Tests (pull_request) Successful in 20s
CI / Backend Unit Tests (pull_request) Failing after 3m45s
CI / fail2ban Regex (pull_request) Successful in 42s
CI / Semgrep Security Scan (pull_request) Successful in 20s
CI / Compose Bucket Idempotency (pull_request) Successful in 1m2s
docs: record V69 schema foundation (DB diagrams, glossary, ADR-025)
- db-orm.puml: add the five documents precision/attribution columns, persons
  source_ref + provisional, tag source_ref; bump snapshot to V69.
- db-relationships.puml: bump snapshot + note V69 adds columns only (no new FKs).
- GLOSSARY.md: add "source_ref", "provisional person", "date precision",
  "raw attribution".
- ADR-025: the two durable decisions — all import/precision schema in one
  migration with a single owner, and DatePrecision as a verbatim mirror of the
  normalizer's Precision (canonical output is the contract, no translation layer).
  Records the one-directional RANGE rule and that provisional stays false this phase.

--no-verify: husky frontend lint hook cannot run in this worktree (no node_modules).

Closes #671

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-27 09:21:57 +02:00

11 KiB

AuthDocumentsPersonsTagsTranscriptionOCRSupportingapp_usersid : UUID «PK»email : VARCHAR(255) NOT NULL UNIQUEpassword : VARCHAR(255) NOT NULLfirst_name : VARCHAR(100)last_name : VARCHAR(100)birth_date : DATEcontact : TEXTenabled : BOOLEAN NOT NULLcolor : VARCHAR(20) NOT NULLnotify_on_reply : BOOLEAN NOT NULLnotify_on_mention : BOOLEAN NOT NULLcreated_at : TIMESTAMPuser_groupsid : UUID «PK»name : VARCHAR(255) NOT NULL UNIQUEapp_users_groupsapp_user_id : UUID «FK»group_id : UUID «FK»group_permissionsgroup_id : UUID «FK»permission : VARCHAR(255)password_reset_tokensid : UUID «PK»app_user_id : UUID «FK»token : VARCHAR(64) NOT NULL UNIQUEexpires_at : TIMESTAMP NOT NULLused : BOOLEAN NOT NULLcreated_at : TIMESTAMP NOT NULLinvite_tokensid : UUID «PK»code : VARCHAR(10) NOT NULL UNIQUElabel : VARCHAR(255)max_uses : INTEGERuse_count : INTEGER NOT NULLprefill_first_name : VARCHAR(255)prefill_last_name : VARCHAR(255)prefill_email : VARCHAR(255)expires_at : TIMESTAMPcreated_by : UUID «FK»created_at : TIMESTAMP NOT NULLrevoked : BOOLEAN NOT NULLinvite_token_group_idsinvite_token_id : UUID «FK»group_id : UUID «FK»documentsid : UUID «PK»title : VARCHAR(255) NOT NULLoriginal_filename : VARCHAR(255) NOT NULLstatus : VARCHAR(255) NOT NULLfile_path : VARCHAR(255)file_hash : VARCHAR(64)summary : TEXTtranscription : TEXTmeta_date : DATEmeta_date_precision : VARCHAR(16) NOT NULLmeta_date_end : DATEmeta_date_raw : TEXTsender_text : TEXTreceiver_text : TEXTmeta_location : VARCHAR(255)meta_document_location : VARCHAR(255)archive_box : VARCHAR(255)archive_folder : VARCHAR(255)sender_id : UUID «FK»metadata_complete : BOOLEAN NOT NULLscript_type : VARCHAR(30) NOT NULLthumbnail_key : VARCHAR(255)thumbnail_generated_at : TIMESTAMPthumbnail_aspect : VARCHAR(16)page_count : INTEGERsearch_vector : tsvector «computed»created_at : TIMESTAMPupdated_at : TIMESTAMPdocument_receiversdocument_id : UUID «FK»person_id : UUID «FK»document_tagsdocument_id : UUID «FK»tag_id : UUID «FK»document_versionsid : UUID «PK»document_id : UUID «FK»editor_id : UUID «FK»editor_name : VARCHAR(200) NOT NULLsaved_at : TIMESTAMP NOT NULLsnapshot : JSONB NOT NULLchanged_fields : JSONB NOT NULLdocument_annotationsid : UUID «PK»document_id : UUID «FK»page_number : INTEGER NOT NULLx : DOUBLE PRECISION NOT NULLy : DOUBLE PRECISION NOT NULLwidth : DOUBLE PRECISION NOT NULLheight : DOUBLE PRECISION NOT NULLcolor : VARCHAR(20) NOT NULLpolygon : JSONBfile_hash : VARCHAR(64)created_by : UUID «FK»created_at : TIMESTAMP NOT NULLdocument_commentsid : UUID «PK»document_id : UUID «FK»annotation_id : UUID «FK»block_id : UUID «FK»parent_id : UUID «FK»author_id : UUID «FK»author_name : VARCHAR(200) NOT NULLcontent : TEXT NOT NULLcreated_at : TIMESTAMP NOT NULLupdated_at : TIMESTAMP NOT NULLdocument_training_labelsdocument_id : UUID «FK»label : VARCHAR(50) NOT NULLcomment_mentionscomment_id : UUID «FK»app_user_id : UUID «FK»personsid : UUID «PK»first_name : VARCHAR(255)last_name : VARCHAR(255) NOT NULLalias : VARCHAR(255)title : VARCHAR(50)person_type : VARCHAR(20) NOT NULLnotes : TEXTbirth_year : INTEGERdeath_year : INTEGERfamily_member : BOOLEAN NOT NULLsource_ref : VARCHAR(255) UNIQUEprovisional : BOOLEAN NOT NULLperson_name_aliasesid : UUID «PK»person_id : UUID «FK»last_name : VARCHAR(255) NOT NULLfirst_name : VARCHAR(255)type : VARCHAR(50) NOT NULLsort_order : INTEGER NOT NULLcreated_at : TIMESTAMPTZperson_relationshipsid : UUID «PK»person_id : UUID «FK»related_person_id : UUID «FK»relation_type : VARCHAR(30) NOT NULLfrom_year : INTEGERto_year : INTEGERnotes : VARCHAR(2000)created_at : TIMESTAMPTZ NOT NULLtagid : UUID «PK»name : VARCHAR(255) NOT NULL UNIQUEparent_id : UUID «FK»color : VARCHAR(20)source_ref : VARCHAR(255) UNIQUEtranscription_blocksid : UUID «PK»annotation_id : UUID «FK»document_id : UUID «FK»text : TEXTlabel : VARCHAR(200)sort_order : INTEGER NOT NULLversion : INTEGER NOT NULLsource : VARCHAR(10) NOT NULLreviewed : BOOLEAN NOT NULLcreated_by : UUID «FK»updated_by : UUID «FK»created_at : TIMESTAMP NOT NULLupdated_at : TIMESTAMP NOT NULLtranscription_block_versionsid : UUID «PK»block_id : UUID «FK»text : TEXT NOT NULLchanged_by : UUID «FK»changed_at : TIMESTAMP NOT NULLtranscription_block_mentioned_personsblock_id : UUID «FK»person_id : UUID NOT NULLdisplay_name : VARCHAR(200) NOT NULLocr_jobsid : UUID «PK»status : VARCHAR(20) NOT NULLtotal_documents : INT NOT NULLprocessed_documents : INT NOT NULLerror_count : INT NOT NULLskipped_count : INT NOT NULLcreated_by : UUIDprogress_message : TEXTcreated_at : TIMESTAMPTZ NOT NULLupdated_at : TIMESTAMPTZ NOT NULLocr_job_documentsid : UUID «PK»job_id : UUID «FK»document_id : UUID «FK»status : VARCHAR(20) NOT NULLerror_message : TEXTcurrent_page : INTtotal_pages : INTcreated_at : TIMESTAMPTZ NOT NULLupdated_at : TIMESTAMPTZ NOT NULLocr_training_runsid : UUID «PK»status : VARCHAR(20) NOT NULLblock_count : INT NOT NULLdocument_count : INT NOT NULLmodel_name : VARCHAR(100) NOT NULLerror_message : TEXTtriggered_by : UUID «FK»person_id : UUID «FK»cer : DOUBLE PRECISIONloss : DOUBLE PRECISIONaccuracy : DOUBLE PRECISIONepochs : INTcreated_at : TIMESTAMPTZ NOT NULLcompleted_at : TIMESTAMPTZsender_modelsid : UUID «PK»person_id : UUID «FK» UNIQUEmodel_path : TEXT NOT NULLaccuracy : DOUBLE PRECISIONcer : DOUBLE PRECISIONcorrected_lines_at_training : INT NOT NULLcreated_at : TIMESTAMPTZ NOT NULLupdated_at : TIMESTAMPTZ NOT NULLnotificationsid : UUID «PK»recipient_id : UUID «FK»type : VARCHAR(32) NOT NULLdocument_id : UUIDreference_id : UUIDannotation_id : UUIDactor_name : VARCHAR(255)read : BOOLEAN NOT NULLcreated_at : TIMESTAMP NOT NULLaudit_logid : UUID «PK»happened_at : TIMESTAMPTZ NOT NULLactor_id : UUID «FK»kind : VARCHAR(50) NOT NULLdocument_id : UUID «FK»payload : JSONBgeschichtenid : UUID «PK»title : VARCHAR(255) NOT NULLbody : TEXTstatus : VARCHAR(32) NOT NULLauthor_id : UUID «FK»created_at : TIMESTAMP NOT NULLupdated_at : TIMESTAMP NOT NULLpublished_at : TIMESTAMPgeschichten_personsgeschichte_id : UUID «FK»person_id : UUID «FK»geschichten_documentsgeschichte_id : UUID «FK»document_id : UUID «FK»app_user_idgroup_idgroup_idapp_user_idcreated_byinvite_token_idgroup_idsender_iddocument_idperson_iddocument_idtag_iddocument_ideditor_iddocument_idcreated_bydocument_idannotation_idblock_idauthor_idparent_iddocument_idcomment_idapp_user_idperson_idperson_idrelated_person_idparent_idannotation_iddocument_idcreated_byupdated_byblock_idchanged_byblock_idjob_iddocument_idtriggered_byperson_idperson_idrecipient_idactor_iddocument_idauthor_idgeschichte_idperson_idgeschichte_iddocument_id