Files
familienarchiv/docs/architecture/c4/l3-frontend-3d-administration.puml
Marcel 0a3d12b9af
All checks were successful
CI / Unit & Component Tests (pull_request) Successful in 3m42s
CI / OCR Service Tests (pull_request) Successful in 23s
CI / Backend Unit Tests (pull_request) Successful in 3m50s
CI / fail2ban Regex (pull_request) Successful in 45s
CI / Semgrep Security Scan (pull_request) Successful in 22s
CI / Compose Bucket Idempotency (pull_request) Successful in 1m3s
docs: drop remaining stale MassImportService/ExcelService references
Replace the legacy raw-spreadsheet importer references left behind after
#674 with the canonical import architecture (CanonicalImportOrchestrator +
four loaders) and document #686 index-based PDF resolution.

- l3-backend-3b: DocumentImporter now resolves PDF by index (importDir/
  <index>.pdf) with index validation + canonical-path containment + %PDF
  magic-byte check (no recursive walk / homoglyph file-path guards)
- c4-diagrams.md: replace massImport/excelSvc components + their rels with
  an importOrch (CanonicalImportOrchestrator) component wired to doc/person/
  tag services; refresh adminCtrl and adminSystem descriptions
- ARCHITECTURE.md: importing package row now describes the orchestrator +
  four loaders consuming canonical artifacts
- TODO-backend.md: remove obsolete "MassImportService provides no status"
  item (service deleted; orchestrator already exposes import-status); update
  stale ExcelService test-coverage suggestion

Refs #686

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-27 22:08:45 +02:00

1.9 KiB

Component Diagram: Web Frontend — Administration & HelpComponent Diagram: Web Frontend — Administration & HelpWeb Frontend (SvelteKit / SSR)[system]«component»/admin/users,/admin/users/[id],/admin/users/new,/admin/invites[SvelteKit Routes] User directory,create/update/delete users,and manage invite codes.Requires ADMIN_USERpermission.«component»/admin/groups,/admin/groups/[id],/admin/groups/new[SvelteKit Routes] Permission groupmanagement: create/editgroups and their permissionsets.«component»/admin/tags and/admin/tags/[id][SvelteKit Routes] Tag administration: edit taghierarchy, merge tags,delete subtrees.«component»/admin/ocr and/admin/ocr/[personId][SvelteKit Routes] Global and per-person OCRconfiguration. Managesscript types and triggerssender model training.«component»/admin/system[SvelteKit Route] System status panel.Triggers the canonicalimport (POST/api/admin/trigger-import).Displays import state.«component»/hilfe/transkription[SvelteKit Route] Static transcription styleguide for Kurrent andSütterlin characterrecognition. No backendcalls.«person»Administrator«person»User«container»API Backend[Spring Boot]Manages users andinvites[HTTPS / Browser]Views transcriptionstyle guide[HTTPS / Browser]GET/POST/DELETE/api/users, POST/api/auth/invite[HTTP / JSON]GET/POST/PUT/DELETE/api/groups[HTTP / JSON]GET/PUT/DELETE/api/tags[HTTP / JSON]GET/POST /api/ocr(global config andsender training)[HTTP / JSON]POST/api/admin/trigger-import,GET/api/admin/import-status[HTTP / JSON]