返回 Skill 列表
extension
分类: 开发与工程无需 API Key

aureuserp-test-case-builder

为AureusERP插件API构建和重构Pest功能测试,包括可重用的帮助函数、策略-权限认证设置、优先使用工厂生成的数据负载、稳定的JSON断言以及插件安装引导策略。在`plugins/*/*/tests`下创建或更新API测试时使用。此技能结构旨在支持未来的Filament测试案例轨道,而不会改变当前的API行为。

person作者: jakexiaohubgithub

AureusERP Test Case Builder

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

Scope Tracks

  1. API test-case track (active now)
  • Follow references/api.md for end-to-end workflow, helper boundaries, assertions, and guardrails.
  1. 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

  1. Use Pest feature tests for API endpoints (getJson, postJson, patchJson, deleteJson).
  2. Prefer factories for setup and payload creation.
  3. Keep helper responsibility split strict:
  • SecurityHelper for auth/permissions/guards.
  • TestBootstrapHelper for non-security bootstrap and plugin installation.
  1. Do not use RefreshDatabase or LazilyRefreshDatabase in test files; use global DatabaseTransactions wiring.
  2. Prefer test/helper fixes before app code edits.
  3. Do not use skip-as-solution.

Quick Routing

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

Output Expectations

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