Merged in feature/remove-query (pull request #201)

remove query from codebase part 1 * remove query * fix localstack run
2026-01-14 17:59:04 +00:00
parent ebf47c6013
commit 0ddae4f91e
167 changed files with 1059 additions and 20641 deletions
@@ -0,0 +1,78 @@
+# Integration Tests
+
+This directory contains two integration test implementations that test the same core API workflow but serve different purposes.
+
+## Test Files
+
+### `text_extraction_integration_test.go` - Automated CI/CD Testing
+
+**Purpose**: Automated integration testing for CI/CD pipelines.
+
+**How it works**:
+- Self-contained using testcontainers (spins up PostgreSQL, S3 mock, and API server automatically)
+- Uses the generated Go API client for type-safe requests
+- Runs as part of `task test:functional` or `task fullsuite:ci`
+
+**When to use**:
+- Local development verification before committing
+- CI/CD pipeline testing
+- Automated regression testing
+
+**Run with**:
+```bash
+go test -v ./test/... -run TestE2EDocWorkflow
+# Or via task
+task test:functional
+```
+
+---
+
+### `text_extraction_integration_test.sh` - Manual Testing
+
+**Purpose**: Manual end-to-end testing against a running API server.
+
+**How it works**:
+- Uses curl/jq to make REST API calls
+- Requires an external API server already running (auth bypass mode)
+- Creates comprehensive test data with realistic healthcare contract values
+- Demonstrates API usage for UI developers
+
+**When to use**:
+- Testing against local docker-compose stack
+- Testing against AWS dev/UAT deployments
+- Populating a development environment with sample data
+- Demonstrating API endpoints to UI developers
+
+**Run with**:
+```bash
+# Against local stack
+./test/text_extraction_integration_test.sh http://localhost:8080
+
+# Against AWS deployment
+./test/text_extraction_integration_test.sh http://your-alb-url.us-east-2.elb.amazonaws.com
+```
+
+**Requirements**:
+- bash 4.0+
+- curl
+- jq
+- zip
+- Target API must be running in auth bypass mode
+
+---
+
+## Test Coverage
+
+Both tests exercise the same core workflow:
+
+1. **Client Setup**: Create, verify, list, update client
+2. **Document Upload**: Batch ZIP upload, single document upload
+3. **Label Operations**: Apply labels, verify, query by label
+4. **Folder Metrics**: List folders, get metrics per folder
+5. **Field Extractions**: Create, version history, retrieve specific versions
+
+The Go test includes additional scenarios:
+- Deep folder hierarchy (12 levels)
+- Large array field extraction (100 items)
+- Label reapplication history
+- Cross-feature integration (folders + labels + field extractions)