aureuserp-test-case-builder

Build and refactor Pest feature tests for AureusERP plugin APIs with reusable helpers, policy-permission auth setup, factory-first payloads, stable JSON assertions, and plugin-install bootstrap strategy. Use when creating or updating API tests under `plugins/*/*/tests`. This skill is structured to support a future Filament test-case track without changing current API behavior.

AureusERP Test Case Builder

Use this skill to build plugin API tests with Pest using test-only fixes and reusable helpers.

Scope Tracks

API test-case track (active now)

Follow references/api.md for end-to-end workflow, helper boundaries, assertions, and guardrails.

Filament test-case track (reserved for future)

Do not invent Filament-specific testing rules in this skill yet.
Keep API conventions unchanged.
When Filament guidance is added later, it should be added as separate references (for example references/filament-*.md) and selected explicitly by task type.

Core Rules

Use Pest feature tests for API endpoints (getJson, postJson, patchJson, deleteJson).
Prefer factories for setup and payload creation.
Keep helper responsibility split strict:

SecurityHelper for auth/permissions/guards.
TestBootstrapHelper for non-security bootstrap and plugin installation.

Do not use RefreshDatabase or LazilyRefreshDatabase in test files; use global DatabaseTransactions wiring.
Prefer test/helper fixes before app code edits.
Do not use skip-as-solution.

Quick Routing

API controller endpoint tests (index/store/show/update/destroy, auth, validation, restore/force-delete): use references/api.md.
API refactor/bugfix with helper cleanup: use references/api.md.
Template generation for a new plugin API test file: use references/api.md.

Output Expectations

Keep tests plugin-scoped and reusable.
Keep assertions deterministic and aligned with JSON resources.
Keep payloads factory-first with targeted overrides only.
Keep install/bootstrap non-interactive and environment-safe.