front-end-dev-standards 1.0.0 → 1.1.0

package/standards//360/237/247/252 testing.md"

@@ -0,0 +1,399 @@
+# Testing Standards
+
+Version: 1.0
+Framework: Angular 20+
+Test Runner: Vitest
+Goal: Reliable, Maintainable, Fast Tests
+
+---
+
+# 1. Testing Principles
+
+## Core Principles
+
+1. Test Behavior, Not Implementation
+2. Fast Feedback
+3. Deterministic Tests
+4. Independent Tests
+5. Readable Tests
+6. High Value Coverage
+
+---
+
+# 2. Testing Pyramid
+
+```text
+            E2E
+           /   \
+      Integration
+      /         \
+    Unit Tests
+```
+
+Target Distribution:
+
+* Unit Tests: 70%
+* Integration Tests: 20%
+* E2E Tests: 10%
+
+---
+
+# 3. Test Stack
+
+| Tool                | Purpose           |
+| ------------------- | ----------------- |
+| Vitest              | Test Runner       |
+| Angular TestBed     | Integration       |
+| Testing Library     | User Interactions |
+| Playwright          | E2E               |
+| Mock Service Worker | API Mocking       |
+
+---
+
+# 4. File Naming
+
+```text
+employee.service.spec.ts
+
+employee-list.page.spec.ts
+
+timesheet-calendar.component.spec.ts
+```
+
+Tests live beside source files.
+
+---
+
+# 5. Test Structure
+
+Use AAA Pattern.
+
+```typescript
+it('should calculate weekly hours', () => {
+  // Arrange
+
+  // Act
+
+  // Assert
+});
+```
+
+---
+
+# 6. Unit Testing Standards
+
+Test:
+
+✓ Services
+
+✓ Guards
+
+✓ Pipes
+
+✓ Validators
+
+✓ Utility Functions
+
+✓ Signal Computations
+
+---
+
+# 7. Component Testing Standards
+
+Focus on:
+
+* Rendered Output
+* User Actions
+* State Changes
+
+Avoid testing:
+
+* Private Methods
+* Internal Variables
+
+---
+
+# 8. Service Testing Standards
+
+Every service must test:
+
+* Success Path
+* Error Path
+* Edge Cases
+* Retry Logic
+
+Coverage Target:
+
+```text
+90%
+```
+
+---
+
+# 9. Signal Testing
+
+Preferred:
+
+```typescript
+component.loading.set(true);
+
+expect(
+  component.loading()
+).toBe(true);
+```
+
+Test public signals only.
+
+---
+
+# 10. Form Testing
+
+Verify:
+
+✓ Required Validation
+
+✓ Custom Validation
+
+✓ Submission
+
+✓ Error Messages
+
+✓ Disabled States
+
+---
+
+# 11. HTTP Testing
+
+Use:
+
+```typescript
+HttpTestingController
+```
+
+Never call real APIs.
+
+Verify:
+
+* Method
+* URL
+* Headers
+* Request Body
+
+---
+
+# 12. Guard Testing
+
+Must verify:
+
+* Authorized User
+* Unauthorized User
+* Redirect Logic
+
+Coverage:
+
+```text
+100%
+```
+
+---
+
+# 13. Interceptor Testing
+
+Must verify:
+
+* Header Injection
+* Error Handling
+* Token Refresh
+
+Coverage:
+
+```text
+100%
+```
+
+---
+
+# 14. Integration Testing
+
+Test interactions between:
+
+* Components
+* Services
+* Routing
+* Forms
+
+Focus on workflows.
+
+---
+
+# 15. E2E Testing
+
+Critical Flows:
+
+✓ Login
+
+✓ Logout
+
+✓ Timesheet Submission
+
+✓ Attendance
+
+✓ Payroll Access
+
+✓ Leave Request
+
+Use Playwright.
+
+---
+
+# 16. Mocking Standards
+
+Mock:
+
+* HTTP Calls
+* External APIs
+* Browser APIs
+
+Do Not Mock:
+
+* Business Logic Under Test
+
+---
+
+# 17. Test Data Standards
+
+Use factories.
+
+```typescript
+createEmployee()
+
+createPayroll()
+
+createTimesheet()
+```
+
+Avoid inline mock duplication.
+
+---
+
+# 18. Coverage Requirements
+
+| Layer          | Coverage |
+| -------------- | -------- |
+| Services       | 90%      |
+| Guards         | 100%     |
+| Interceptors   | 100%     |
+| Utilities      | 95%      |
+| Components     | 80%      |
+| Critical Logic | 95%      |
+
+---
+
+# 19. Performance Testing
+
+Measure:
+
+* Initial Load
+* Route Navigation
+* API Response Handling
+
+Performance regressions block releases.
+
+---
+
+# 20. Accessibility Testing
+
+Verify:
+
+✓ Keyboard Navigation
+
+✓ Focus States
+
+✓ Screen Readers
+
+✓ ARIA Labels
+
+Accessibility defects are bugs.
+
+---
+
+# 21. Snapshot Testing
+
+Allowed only for:
+
+* Design System Components
+* Shared UI Components
+
+Avoid large page snapshots.
+
+---
+
+# 22. Flaky Test Policy
+
+A flaky test:
+
+* Must be fixed immediately
+* Must not be ignored
+* Must not be retried indefinitely
+
+---
+
+# 23. CI Quality Gates
+
+Required before merge:
+
+✓ Lint Pass
+
+✓ Unit Tests Pass
+
+✓ Integration Tests Pass
+
+✓ Coverage Threshold Met
+
+✓ Security Scan Pass
+
+---
+
+# 24. AI Generated Test Standards
+
+AI-generated tests must:
+
+✓ Test real behavior
+
+✓ Use factories
+
+✓ Cover success and failure paths
+
+✓ Avoid implementation details
+
+Reject tests that:
+
+✗ Test private methods
+
+✗ Assert internal state unnecessarily
+
+✗ Use arbitrary delays
+
+✗ Depend on execution order
+
+---
+
+# 25. Definition of Test Quality
+
+Tests are considered production-ready when:
+
+✓ Reliable
+
+✓ Fast
+
+✓ Deterministic
+
+✓ Maintainable
+
+✓ Readable
+
+✓ Independent
+
+✓ High Value
+
+✓ CI Verified