test: establish docs-mirrored directory structure for integration tests

Creates database/, resources/, and mqtt/ directories under integrationTests/
as placeholder structure ahead of merging #1207–#1211. Updates the top-level
integrationTests/README.md with a directory map mirroring the Harper v5 docs
and pointing new tests away from the legacy apiTests/ bucket (see #1215).

Author: kriszyp

integrationTests/README.md

@@ -1,5 +1,25 @@
 # Harper Integration Tests
 
+## Directory Structure
+
+Directory structure mirrors the [Harper v5 reference docs](https://docs.harperdb.io/reference/v5):
+
+| Directory | Coverage |
+|---|---|
+| `database/` | Schema types, TTL, blob, scale |
+| `resources/` | Custom resources, REST API patterns |
+| `mqtt/` | MQTT broker, JWT auth, ACL, topic patterns |
+| `server/` | Caching (sourcedFrom, SWR), thread management, crash recovery |
+| `components/` | Component deployment, lifecycle, fixtures |
+| `security/` | TLS, certificates, auth |
+| `operations-api/` | Operations API, CLI commands |
+| `upgrade/` | v4→v5 upgrade / migration tests |
+| `apiTests/` | Legacy bucket — being migrated to the above (see #1215) |
+
+New tests should go in the appropriate subdirectory, not `apiTests/`.
+
+---
+
 This directory contains the integration tests for Harper. They run against the built Harper distribution using the [`@harperfast/integration-testing`](https://github.com/HarperFast/integration-testing-framework) framework and the included Node.js test runner script.
 
 For full background on the testing philosophy, framework APIs, and runner configuration, see the **[`@harperfast/integration-testing` documentation](https://github.com/HarperFast/integration-testing-framework#readme)**. This document covers what is specific to running and writing tests in this repository.

integrationTests/database/README.md

@@ -0,0 +1,6 @@
+# database/
+Integration tests for Harper database features: schema types, TTL/expiration, blob storage, and large-scale data patterns.
+
+Incoming: `ttl.test.ts` from HarperFast/harper#1210.
+
+See also: `unitTests/resources/` for unit-level coverage of the same features.

integrationTests/mqtt/README.md

@@ -0,0 +1,6 @@
+# mqtt/
+Integration tests for the MQTT broker: JWT auth, ACL enforcement, and topic patterns.
+
+Incoming: `mqtt.test.ts` from HarperFast/harper#1211.
+
+See also: `unitTests/` for unit-level coverage of the same features.

integrationTests/resources/README.md

@@ -0,0 +1,6 @@
+# resources/
+Integration tests for custom resources, REST API patterns, and routing.
+
+Incoming: `custom-resources.test.ts` from HarperFast/harper#1209.
+
+See also: `unitTests/resources/` for unit-level coverage of the same features.