query-orchestration/internal/document/batch

Document Batch Processing

This directory contains the service layer for managing document batch uploads.

Purpose

The batch service provides a business logic layer between the HTTP API handlers and the database repository for batch upload operations. It handles:

• Model Conversion: Translates between OpenAPI-generated types and internal database models
• Business Logic: Encapsulates batch-specific operations (CRUD, progress tracking)
• Data Validation: Manages UUID conversions, JSONB parsing, and nullable type handling

Architecture

HTTP Request → API Handler → Batch Service → Database Repository → PostgreSQL

The service is stateless and synchronous - it does not run background processes. Actual document processing happens through the existing Runner pipeline (storeEventRunner → docInitRunner → etc.).

Files

• service.go - Main batch service implementation with CRUD operations
• service_test.go - Unit tests using testcontainers for database integration

Usage

The service is instantiated by API handlers in /api/queryAPI/documents.go to manage batch upload metadata, progress tracking, and status updates.