How elizabetheldhose/fraud-forensic-service works
This is a Spring Boot forensic API with two client workflows: submit case-scoped search criteria and receive ranked OpenSearch hits, or request a short-lived S3 upload URL and upload the file directly to S3. Search queries an index described as populated by an upstream Lambda pipeline. The graph shows the controller-owned service calls and the external calls visible in the excerpts; AWS configuration and Lambda internals were not excerpted, so their wiring is not inferred.
Main entry points: ForensicSearchService.java Forensic Search · S3PresignService.java S3 URL Signing · GlobalExceptionHandler.java Error Mapping · ReportController.java Report Endpoint
Components 17
HTTP API
- Report Endpoint
src/main/java/com/ibm/forensic/controller/ReportController.java - Upload Endpoint
src/main/java/com/ibm/forensic/controller/UploadController.java - Error Mapping
src/main/java/com/ibm/forensic/exception/GlobalExceptionHandler.java - Error Payload
src/main/java/com/ibm/forensic/dto/ApiErrorResponse.java - Search Criteria
src/main/java/com/ibm/forensic/dto/ForensicSearchRequest.java - Search Results
src/main/java/com/ibm/forensic/dto/ForensicSearchResponse.java - Upload Metadata
src/main/java/com/ibm/forensic/dto/PresignedUrlRequest.java - Signed URL
src/main/java/com/ibm/forensic/dto/PresignedUrlResponse.java
Forensic Services
- Forensic Search
src/main/java/com/ibm/forensic/service/ForensicSearchService.java - Search Exception
src/main/java/com/ibm/forensic/exception/ForensicSearchException.java - S3 URL Signing
src/main/java/com/ibm/forensic/service/S3PresignService.java - Signing Exception
src/main/java/com/ibm/forensic/exception/PresignedUrlGenerationException.java
AWS Integrations
- AWS Configuration
src/main/java/com/ibm/forensic/config/AwsConfig.java - OpenSearch
- S3 Bucket
- Ingest Lambda
infrastructure/lambda/lambda_function.py
Other components
- API Client
Connections 19
- API Client → Report Endpoint: submits search
src/main/java/com/ibm/forensic/controller/ReportController.java - Report Endpoint → Search Criteria: accepts criteria
src/main/java/com/ibm/forensic/controller/ReportController.java - Report Endpoint → Forensic Search: delegates search
src/main/java/com/ibm/forensic/controller/ReportController.java - Forensic Search → OpenSearch: queries index
src/main/java/com/ibm/forensic/service/ForensicSearchService.java - Forensic Search → Search Results: maps hits
src/main/java/com/ibm/forensic/service/ForensicSearchService.java - Forensic Search → Search Exception: throws on failure
src/main/java/com/ibm/forensic/service/ForensicSearchService.java - Forensic Search → Search Criteria: reads criteria
src/main/java/com/ibm/forensic/service/ForensicSearchService.java - API Client → Upload Endpoint: requests URL
src/main/java/com/ibm/forensic/controller/UploadController.java - Upload Endpoint → Upload Metadata: accepts metadata
src/main/java/com/ibm/forensic/controller/UploadController.java - Upload Endpoint → S3 URL Signing: delegates signing
src/main/java/com/ibm/forensic/controller/UploadController.java - S3 URL Signing → S3 Bucket: presigns PUT
src/main/java/com/ibm/forensic/service/S3PresignService.java - S3 URL Signing → Signed URL: returns URL
src/main/java/com/ibm/forensic/service/S3PresignService.java - S3 URL Signing → Upload Metadata: reads metadata
src/main/java/com/ibm/forensic/service/S3PresignService.java - S3 URL Signing → Signing Exception: throws on failure
src/main/java/com/ibm/forensic/service/S3PresignService.java - API Client → S3 Bucket: uploads directly
- Ingest Lambda → OpenSearch: populates index
- Error Mapping → Error Payload: creates payload
src/main/java/com/ibm/forensic/exception/GlobalExceptionHandler.java - Error Mapping → Search Exception: maps failure
src/main/java/com/ibm/forensic/exception/GlobalExceptionHandler.java - Error Mapping → Signing Exception: maps failure
src/main/java/com/ibm/forensic/exception/GlobalExceptionHandler.java