marcel/familienarchiv
1
0
Fork 0
Code Issues 111 Pull Requests Actions Packages Projects Releases Wiki Activity
Files
421d7ffd3790290339b043b9efc773af7ca19ee3
familienarchiv/docs/architecture/c4/l3-backend-3b-document-management.puml

3.3 KiB
Raw Blame History

Component Diagram: API Backend — Document Management & ImportComponent Diagram: API Backend — Document Management & ImportAPI Backend (Spring Boot)[system]«component»DocumentController[Spring MVC â€”/api/documents] CRUD for documents:search, get by ID, updatemetadata, upload/downloadfile, conversation thread,and batch metadataupdates.«component»AdminController[Spring MVC â€” /api/admin] Triggers asynchronousExcel/ODS mass import(requires ADMINpermission). Reports importstate(IDLE/RUNNING/DONE/FAILED).«component»DocumentService[Spring Service] Core document businesslogic: store, update, search.Resolves persons and tags,delegates file I/O toFileService, builds dynamicJPA Specifications, andintegrates with auditlogging.«component»FileService[Spring Service] Wraps AWS SDK v2S3Client. Uploads files withUUID-keyed paths,computes SHA-256 hash,downloads withcontent-type detection, andgenerates presigned URLsfor OCR access.«component»MassImportService[Spring Service â€” @Async] Reads Excel/ODS files from/import mount. Tracksimport state(IDLE/RUNNING/DONE/FAILED)and delegates toExcelService. Returnsimmediately; processingruns asynchronously.«component»ExcelService[Spring Service] Parses Excel/ODSworkbooks (Apache POI).Column indices configurablevia application.properties.Creates/updates documentrecords per row.«component»MinioConfig[Spring @Configuration] Creates the S3Client andS3Presigner beans withpath-style access for MinIO.Validates MinIO connectivityon startup.«component»DocumentRepository[Spring Data JPA] Queries documents withSpecification-baseddynamic search,bidirectional conversationthread queries, full-textsearch with ranking andmatch highlighting, andtranscription pipeline queueprojections.«component»DocumentSpecifications[JPA Criteria API] Factory for composablepredicates: hasText(full-text), hasSender,hasReceiver, isBetween(date range), hasTags(subquery AND/OR logic).«container»Web Frontend[SvelteKit]«container»PostgreSQL[PostgreSQL 16]«container»Object Storage[MinIO (S3-compatible)]«component»PersonService[Spring Service] See diagram 3e. Called byDocumentService to resolvesender / receiver personsby ID.«component»TagService[Spring Service] See diagram 3d. Called byDocumentService to find orcreate tags by name.Document requests[HTTP / JSON]Trigger import[HTTP / JSON]Delegates toTriggersUpload / downloadfilesReads / writesdocumentsBuilds searchpredicatesResolves sender /receiversFinds or creates tagsParses Excel/ODS fileCreates / updatesdocumentsProvides S3Client andS3Presigner beansPUT / GET / presignedURL objects[S3 API / HTTP]SQL queries[JDBC]
Reference in New Issue View Git Blame Copy Permalink