Cursor rule

1---
2description: Testing patterns and practices
3globs: web/src/**/__tests__/**/*.test.ts
4alwaysApply: false
5---
6 
7# Testing
8 
9## Setup
10 
11- Framework: Vitest 4 with V8 coverage
12- Convention: `__tests__/ClassName.test.ts` alongside the source code
13- `@/` alias available in tests
14 
15## Test Structure
16 
17```typescript
18describe('Money', () => {
19  describe('add', () => {
20    it('should sum amounts with same currency', () => {
21      const a = new Money(100, 'USD');
22      const b = new Money(50, 'USD');
23      expect(a.add(b).amount).toBe(150);
24    });
25 
26    it('should throw on currency mismatch', () => {
27      const usd = new Money(100, 'USD');
28      const brl = new Money(50, 'BRL');
29      expect(() => usd.add(brl)).toThrow('Currency mismatch');
30    });
31  });
32});
33```
34 
35## Testing Priorities
36 
371. **Domain entities and services**: maximum coverage (business logic)
382. **Use cases**: test orchestration with mocked interfaces
393. **Infrastructure**: test parsing and integration in isolation
404. **Presentation**: test formatters; builders are visual (lower priority)
41 
42## Best Practices
43 
44- Independent tests — no shared state between `it()` blocks
45- Descriptive names: "should calculate average cost when multiple vestings exist"
46- Use factories or builders to create test data
47- Mock interfaces (`IOperationRepository`) — never concrete implementations
48- No `any` in tests
49