navidocs/docs/testing/README.md

# NaviDocs Testing Documentation

This directory contains comprehensive testing documentation for the NaviDocs project.

## Directory Contents

### Testing Reports

- **[SMOKETEST_REPORT_20251019.md](./SMOKETEST_REPORT_20251019.md)** (807 lines)
  - Comprehensive smoketest report for 2025-10-19
  - Service status verification
  - API endpoint testing results
  - Integration test results
  - Issues found and recommendations
  - Git worktree setup documentation

- **[WORKTREE_SETUP.md](./WORKTREE_SETUP.md)** (400 lines)
  - Complete guide to Git worktree setup
  - Use cases and best practices
  - Troubleshooting guide
  - Advanced worktree management

## Quick Access

### Current Test Environment

| Property | Value |
|----------|-------|
| **Test Date** | 2025-10-19 17:39:20 CEST |
| **Main Branch** | master (commit ff3c306) |
| **Test Branch** | ui-smoketest-20251019 |
| **Test Worktree** | `/home/setup/navidocs-ui-test` |
| **Overall Status** | PASS (85.7% success rate) |

### Service Status Summary

| Service | Port | Status |
|---------|------|--------|
| Redis | 6379 | ✅ RUNNING |
| Meilisearch | 7700 | ✅ RUNNING |
| Backend API | 8001 | ✅ RUNNING |
| OCR Worker | - | ✅ RUNNING |
| Frontend | 5174 | ✅ RUNNING |

### Test Results Summary

| Category | Tests | Passed | Failed | Skipped |
|----------|-------|--------|--------|---------|
| Services | 5 | 5 | 0 | 0 |
| API Endpoints | 4 | 3 | 1 | 0 |
| Integration | 4 | 3 | 0 | 1 |
| UI Components | 1 | 1 | 0 | 0 |
| **TOTAL** | **14** | **12** | **1** | **1** |

**Success Rate:** 85.7% (12/14 tests passed)

## Key Findings

### ✅ Passing Tests

1. **All Services Operational**
   - Redis, Meilisearch, Backend API, OCR Worker, Frontend all running

2. **API Endpoints**
   - Health check: ✅ PASS
   - Token generation: ✅ PASS
   - PDF streaming: ✅ PASS

3. **Integration**
   - Meilisearch index configured: ✅ PASS
   - Database integrity: ✅ PASS (11/15 pages successfully OCR'd)
   - Upload & OCR processing: ✅ PASS

4. **UI**
   - UI polish updates applied: ✅ PASS

### ⚠️ Known Issues

1. **Meilisearch Filterable Attributes** (MEDIUM)
   - Server-side search fails due to missing filterable attributes
   - Fix: Configure `userId` and `organizationId` as filterable
   - Workaround: Use client-side search with tenant tokens

2. **Frontend Interactive Testing** (LOW)
   - Interactive UI functionality not fully validated
   - Recommendation: Complete manual/automated UI testing

## Quick Start

### View Complete Smoketest Report

```bash
cat /home/setup/navidocs/docs/testing/SMOKETEST_REPORT_20251019.md
```

### Access Test Worktree

```bash
cd /home/setup/navidocs-ui-test
git status
```

### Run Services in Test Environment

```bash
cd /home/setup/navidocs-ui-test
./start-all.sh
```

### Verify API Endpoints

```bash
# Health check
curl http://localhost:8001/health

# Generate search token
curl -X POST http://localhost:8001/api/search/token \
  -H "Content-Type: application/json" \
  -d '{"userId":"test-user","organizationId":"test-org"}'

# Test PDF streaming
curl http://localhost:8001/api/documents/7544581b-a0b4-46df-a2ed-ff2e1dc1c9a7/pdf \
  --output test.pdf
```

## Next Steps

### Immediate Actions (High Priority)

1. **Fix Meilisearch Filterable Attributes**
   ```bash
   curl -X PATCH 'http://127.0.0.1:7700/indexes/navidocs-pages/settings' \
     -H 'Authorization: Bearer 5T66jrwQ8F8cOk4dUlFY0Vp59fMnCsIfi4O6JZl9wzU=' \
     -H 'Content-Type: application/json' \
     --data-binary '{
       "filterableAttributes": ["userId", "organizationId", "documentType", "entityType"]
     }'
   ```

2. **Complete Frontend UI Testing**
   - Open http://localhost:5174
   - Test upload flow
   - Test search interface
   - Verify document viewer
   - Test responsive design

3. **Re-process Failed OCR Documents**
   - Identify 4 failed pages
   - Re-queue for processing
   - Verify 100% success rate

### Medium-Term Improvements

4. **Integration Testing Suite**
   - Automate upload + OCR + search workflow
   - Test concurrent processing
   - Verify database integrity

5. **Performance Testing**
   - Large PDF files (50+ pages)
   - Concurrent uploads
   - Search response times

6. **Documentation Updates**
   - API endpoint documentation
   - Production deployment guide
   - Troubleshooting guide

## Document History

| Version | Date | Author | Changes |
|---------|------|--------|---------|
| 1.0 | 2025-10-19 | Testing Agent | Initial smoketest report |
| 1.0 | 2025-10-19 | Testing Agent | Worktree setup guide |
| 1.0 | 2025-10-19 | Testing Agent | Testing directory README |

## Related Documentation

- **Main README:** `/home/setup/navidocs/README.md`
- **Development Guide:** `/home/setup/navidocs/DEVELOPMENT.md`
- **Architecture:** `/home/setup/navidocs/docs/architecture/`
- **UI Changelog:** `/home/setup/navidocs/docs/ui/CHANGELOG_UI.md`

## Support

For questions or issues:
1. Review the [SMOKETEST_REPORT_20251019.md](./SMOKETEST_REPORT_20251019.md)
2. Check the [WORKTREE_SETUP.md](./WORKTREE_SETUP.md) for Git worktree help
3. Consult the main development documentation

---

**Last Updated:** 2025-10-19 17:42:00 CEST
**Status:** All tests completed, reports generated
**Maintainer:** NaviDocs Development Team