turash/docs/concept/16_testing_strategy.md
Damir Mukimov 000eab4740
Major repository reorganization and missing backend endpoints implementation
Repository Structure:
- Move files from cluttered root directory into organized structure
- Create archive/ for archived data and scraper results
- Create bugulma/ for the complete application (frontend + backend)
- Create data/ for sample datasets and reference materials
- Create docs/ for comprehensive documentation structure
- Create scripts/ for utility scripts and API tools

Backend Implementation:
- Implement 3 missing backend endpoints identified in gap analysis:
  * GET /api/v1/organizations/{id}/matching/direct - Direct symbiosis matches
  * GET /api/v1/users/me/organizations - User organizations
  * POST /api/v1/proposals/{id}/status - Update proposal status
- Add complete proposal domain model, repository, and service layers
- Create database migration for proposals table
- Fix CLI server command registration issue

API Documentation:
- Add comprehensive proposals.md API documentation
- Update README.md with Users and Proposals API sections
- Document all request/response formats, error codes, and business rules

Code Quality:
- Follow existing Go backend architecture patterns
- Add proper error handling and validation
- Match frontend expected response schemas
- Maintain clean separation of concerns (handler -> service -> repository)
2025-11-25 06:01:16 +01:00

51 lines
1.8 KiB
Markdown

## 14. Testing Strategy
**Recommendation**: Comprehensive testing pyramid.
### Testing Layers
1. **Unit Tests** (70% coverage target):
- Business logic functions (100% coverage)
- Matching algorithms (95% coverage, focus on edge cases)
- Economic calculations (100% coverage, ±€0.01 accuracy)
- Data validation (100% coverage, all error paths)
2. **Integration Tests** (20% of test suite):
- API endpoints (200+ test cases, all CRUD operations)
- Database operations (Neo4j + PostgreSQL integration)
- Event processing (Watermill pubsub reliability)
- Service integrations (external APIs, IoT devices)
3. **E2E Tests** (10% of test suite):
- Critical user flows (match discovery → connection → implementation)
- Match discovery and connection flow (85% success rate target)
- Payment processing (Stripe integration, transaction success rate >99.5%)
- Cross-browser compatibility (Chrome, Firefox, Safari, Edge)
### Testing Tools
- **Backend**:
- Built-in `testing` package (Go 1.25 improvements)
- `github.com/stretchr/testify`: Assertions, suites, mocks
- `github.com/golang/mock` or `github.com/vektra/mockery/v2`: Mocking
- **API Testing**:
- `net/http/httptest`: Built-in HTTP testing
- `github.com/go-resty/resty/v2`: For integration tests
- **E2E**: Playwright or Cypress
- **Graph Database Testing**:
- Testcontainers: `github.com/testcontainers/testcontainers-go`
- Neo4j test container setup
- **Load Testing**:
- `k6` (Go-based, recommended)
- `github.com/tsenart/vegeta`: HTTP load testing library
- **Benchmarking**: Built-in `go test -bench`
### Test Data Strategy
- **Fixtures**: Realistic test data generators
- **Test Database**: Isolated test environment
- **Snapshots**: Graph database snapshots for integration tests
- **Mocking**: External APIs (government registries, payment providers)
---