Add cross-links from the production deployment guide and Docker Compose
examples README to the main troubleshooting guide and diagnostic playbook.
This completes the cross-linking requirement for P11.5.
Changes:
- docs/onboarding/production.md: Add cross-link to troubleshooting guide
- examples/README.md: Add cross-link to troubleshooting guide
Closes: miroir-uyx.5
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Additions:
- Standalone Meilisearch instance on port 7704 in docker-compose-dev.yml
for API compatibility testing against plain Meilisearch
- Cross-compatibility test script (run_cross_compat_tests.sh) that runs
each SDK smoke test against both Miroir and plain Meilisearch
- Documentation of intentional API differences (X-Miroir-* headers,
Miroir-specific error codes, admin endpoints)
Fixes:
- Clone state.query_planner and state.metrics before moving into async
closure in multi_search.rs to fix compilation error
- Add catch-all pattern in error_response.rs MiroirError match to
handle non-exhaustive enum variants
Closes: miroir-89x.3
Implement integration test suite for Miroir with docker-compose:
- Updated docker-compose-dev.yml to use Meilisearch v1.37.0
- Created tests/integration.rs with comprehensive test coverage:
* Document round-trip (1000 docs)
* Search coverage across all shards (unique-keyword test)
* Facet aggregation (3 colors, sum = 100)
* Offset/limit paging
* Settings broadcast
* Task polling
* Health check
* Node failure test with RF=2
- Created docker-compose-dev-rf2.yml for RF=2/HA testing (6 nodes)
- Created dev-config-rf2.yaml for RF=2 configuration
- Created tests/README.md with documentation
Tests run against real Docker Compose stack:
cargo test --test integration -- --test-threads=1
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
