backend-testing git:20260921.de5eb9fA

Immutable. This exact content is served forever at /api/v1/blob/9ae85bed176e8611.

---
name: backend-testing
description: Testing and verification evidence rules for backend changes. Load before final validation of any implementation work.
---

# Backend Testing — Canonical

> Canonical testing skill. Detailed rules: `skills/backend/TESTING.md`.
> Requires: `AGENTS.md`, `.agents/skills/backend-core/SKILL.md`.

## When to load

Before final validation of implementation work.

## Rules (summary — binding details in `skills/backend/TESTING.md`)

- Location: `src/test/java/com/bekaku/api/spring/` (`controller/api/`, `serviceImpl/`). JUnit Jupiter + Mockito (`LENIENT`) + AssertJ.
- Controller/service logic: focused unit test incl. failure path + ownership (`findByIdAndCreator` scoping, `verifyNoInteractions` on bypass).
- Auth/routes: HTTP test through the real filter chain (cookie AND Bearer); direct controller construction is insufficient.
- SQL/schema/vector: disposable PostgreSQL + pgvector integration test (H2 is invalid).
- File ops: `@TempDir` containment/ownership/partial-failure tests. RAG/SSE: mock model/vector deps, verify event order/disabled mode/errors.
- Narrowest validation first: focused test → `compileJava` → relevant group → full `test` / `bootJar` only when appropriate.
- Report exact commands + actual results; never claim unexecuted success.