design fixup and docs + api versioning

docs/adr/0008-api-versioning-strategy.md

@@ -364,6 +364,40 @@ The final cleanup task for Phase 2 was completed by updating all integration tes
 - Integration tests: 345/348 passing
 - Unit tests: 3,375/3,391 passing (16 pre-existing failures unrelated to versioning)
 
+### Unit Test Path Fix (2026-01-27)
+
+Following the test path migration, 16 unit test failures were discovered and fixed. These failures were caused by error log messages using hardcoded `/api/` paths instead of versioned `/api/v1/` paths.
+
+**Root Cause**: Error log messages in route handlers used hardcoded path strings like:
+
+```typescript
+// INCORRECT - hardcoded path doesn't reflect actual request URL
+req.log.error({ error }, 'Error in /api/flyers/:id:');
+```
+
+**Solution**: Updated to use `req.originalUrl` for dynamic path logging:
+
+```typescript
+// CORRECT - uses actual request URL including version prefix
+req.log.error({ error }, `Error in ${req.originalUrl.split('?')[0]}:`);
+```
+
+**Files Modified**:
+
+| File                                   | Changes                            |
+| -------------------------------------- | ---------------------------------- |
+| `src/routes/recipe.routes.ts`          | 3 error log statements updated     |
+| `src/routes/stats.routes.ts`           | 1 error log statement updated      |
+| `src/routes/flyer.routes.ts`           | 2 error logs + 2 test expectations |
+| `src/routes/personalization.routes.ts` | 3 error log statements updated     |
+
+**Test Results After Fix**:
+
+- Unit tests: 3,382/3,391 passing (0 failures in fixed files)
+- Remaining 9 failures are pre-existing, unrelated issues (CSS/mocking)
+
+**Best Practice**: See [Error Logging Path Patterns](../development/ERROR-LOGGING-PATHS.md) for guidance on logging request paths in error handlers.
+
 **Migration Documentation**: [Test Path Migration Guide](../development/test-path-migration.md)
 
 ### Phase 3 Tasks (Future)