Files
familienarchiv/docs/architecture/db/db-orm.puml
Marcel 39276b179d
Some checks failed
CI / Unit & Component Tests (pull_request) Failing after 2m52s
CI / OCR Service Tests (pull_request) Successful in 21s
CI / Backend Unit Tests (pull_request) Successful in 4m7s
CI / fail2ban Regex (pull_request) Successful in 43s
CI / Semgrep Security Scan (pull_request) Successful in 22s
CI / Compose Bucket Idempotency (pull_request) Successful in 1m3s
docs(stammbaum): document gutter + persons.generation column (#689)
db-orm.puml: persons gains a generation : SMALLINT attribute mirroring
the V70 column. No FK change, so db-relationships.puml is unaffected.

stammbaum-tree-spec.html:
- impl-ref table: replace "Gen label" with "Gutter label" + new
  "Gutter stripe underlay" rows describing the role="text" wrapper,
  un-shifted source-truth value, and below-md hidden state.
- light + dark colour-table rows updated to "Gutter label" /
  "Gutter stripe" with the new var(--c-ink-2) / var(--c-gutter-stripe)
  swatches.
- "Generationen ▾" filter chip mocks removed from desktop and tablet
  layout sections (the filter UI was de-scoped from this PR).

Inline visual mockup SVGs that still show pre-gutter labelling are
out of scope per the issue body — the impl-ref table is the
authoritative source for this PR.

Refs #689

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-28 15:57:54 +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 : INTEGERgeneration : SMALLINTfamily_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