marcel/familienarchiv
1
0
Fork 0
Code Issues 119 Pull Requests 2 Actions Packages Projects Releases Wiki Activity
Files
0780c09bb4b761ec5724fcbfd211bae195581bb5
familienarchiv/docs/architecture/db/db-orm.puml
marcel 0780c09bb4
All checks were successful
CI / Unit & Component Tests (pull_request) Successful in 3m20s
Details
CI / OCR Service Tests (pull_request) Successful in 22s
Details
CI / Backend Unit Tests (pull_request) Successful in 3m48s
Details
CI / fail2ban Regex (pull_request) Successful in 45s
Details
CI / Semgrep Security Scan (pull_request) Successful in 22s
Details
CI / Compose Bucket Idempotency (pull_request) Successful in 1m6s
Details
feat(geschichte): JourneyItem CRUD API — append, updateNote, delete, reorder (#751) (#788) 
## Summary

Implements the backend JourneyItem CRUD API on top of the data model from #750, building towards the full Lesereisen feature (#751).

**Completed in this PR:**
- `jackson-databind-nullable` 0.2.6 + `JacksonConfig` (`@Bean Module`) for three-way PATCH semantics (`JsonNullable`)
- `AuditKind`: `JOURNEY_ITEM_ADDED`, `JOURNEY_ITEM_REMOVED`, `JOURNEY_ITEMS_REORDERED` (last is rollup-eligible)
- `ErrorCode`: `JOURNEY_ITEM_NOT_FOUND`, `JOURNEY_ITEM_POSITION_CONFLICT`
- V73 migration: `UNIQUE (geschichte_id, position) DEFERRABLE INITIALLY DEFERRED` + `CHECK (position > 0)` on `journey_items`
- `JourneyItemConstraintsTest`: verifies deferrable flag via `pg_constraint` query; position check; duplicate position rejection (3 passing tests)
- Read models: `DocumentSummary`, `JourneyItemView`, `GeschichteView` (with `AuthorView` to prevent AppUser email leak)
- `DocumentService.getSummaryById` — lean lookup without tag-color resolution
- `JourneyItemRepository`: extended with `findByGeschichteIdOrderByPosition`, `findByIdAndGeschichteId` (IDOR-safe), `findIdsByGeschichteId`, `findMaxPositionByGeschichteId`, `countByGeschichteId`
- DTOs: `JourneyItemCreateDTO`, `JourneyItemUpdateDTO` (`JsonNullable<String> note`), `JourneyReorderDTO`

**Still in progress (WIP):**
- `JourneyItemService` — `append`, `updateNote`, `delete`, `reorder`, `toSummary`, `toView` (Task 6)
- `GeschichteService.getById` → returns `GeschichteView` (Task 7)
- New endpoints on `GeschichteController` + slice tests (Task 8)
- Frontend error codes + i18n + `npm run generate:api` (Task 9)

## Commits

- `0b177247` feat(config): add jackson-databind-nullable for JsonNullable PATCH DTO support
- `408ae334` feat(audit,error): add JourneyItem AuditKind values and ErrorCodes
- `7b06c3ad` feat(migration): V73 adds UNIQUE DEFERRABLE and CHECK position > 0 on journey_items
- `160ca1c3` feat(geschichte): add DocumentSummary, JourneyItemView, GeschichteView read models
- `2ad5c36e` feat(geschichte): extend JourneyItemRepository and add item DTOs

## Test plan

- [ ] `./mvnw test -Dtest=JourneyItemConstraintsTest` — all 3 constraint tests pass
- [ ] `./mvnw clean package -DskipTests` — builds clean after remaining tasks are merged
- [ ] Frontend: `npm run generate:api` after Task 9 endpoint additions

Co-authored-by: Marcel <marcel@familienarchiv>
Reviewed-on: #788
2026-06-08 22:15:10 +02:00

11 KiB
Raw Blame History

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 NULL «FK»display_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 NULLtype : 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»journey_itemsid : UUID «PK»geschichte_id : UUID «FK»document_id : UUID «FK»position : INTEGER NOT NULL CHECK (position > 0)note : TEXTUNIQUE (geschichte_id, position) DEFERRABLE INITIALLY DEFERREDapp_user_idgroup_idgroup_idapp_user_idcreated_byinvite_token_idgroup_idsender_id (ON DELETE SET NULL)document_idperson_id (ON DELETE CASCADE)document_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_idperson_id (ON DELETE CASCADE)job_iddocument_idtriggered_byperson_idperson_idrecipient_idactor_iddocument_idauthor_idgeschichte_idperson_idgeschichte_id (ON DELETE CASCADE)document_id (ON DELETE SET NULL)
Reference in New Issue View Git Blame Copy Permalink