Initial commit: React frontend (SLP Software) + AIDLC workflow docs

Co-authored-by: Junie <junie@jetbrains.com>
2026-07-20 00:19:44 +02:00
commit e299f1c745
73 changed files with 7275 additions and 0 deletions
@@ -0,0 +1,31 @@
+# Unit Test Execution
+
+## Run Unit Tests
+
+### 1. Execute All Unit Tests
+```bash
+pnpm run test
+```
+Runs Vitest (`vitest run`) with `jsdom` + `@testing-library/react` for component-level tests.
+
+### 2. Review Test Results
+- **Expected**: 9 tests pass across 3 test files, 0 failures
+- **Test Coverage**: No formal coverage threshold configured; tests cover key rendering/interaction behavior of `Hero`, `Nav`, and the anchor-scroll utility
+- **Test Report Location**: Console output from `vitest run` (no HTML report is generated by default)
+
+### 3. Static Analysis (complementary check)
+```bash
+pnpm run lint
+```
+- **Expected**: 0 errors. 2 non-blocking warnings are known and accepted (`react-refresh/only-export-components` in `src/routes/index.tsx` and `src/theme/ThemeProvider.tsx`) — cosmetic Fast Refresh warnings, not correctness issues.
+
+### 4. Fix Failing Tests
+If tests fail:
+1. Review the Vitest console output for the failing test file/assertion
+2. Reproduce locally with `pnpm run test:watch` for fast iteration
+3. Fix the component/utility code or update the test if the expected behavior changed intentionally
+4. Rerun `pnpm run test` until all pass
+
+## Verified Result (this session)
+- `pnpm run test`: 3 test files, 9 tests, all passed.
+- `pnpm run lint`: 0 errors, 2 known non-blocking warnings.