Skip to content

jeffsenso/prestashop-skills / skills/prestashop-module-development/ps9-core-ai/Component/CQRS/skills/create-cqrs-queries

create-cqrs-queries

Verified

Create the read-side CQRS layer: queries, result DTOs, and query handler interfaces. Covers Get{Domain}ForEditing (single entity for edit form) and optionally Get{Domain}sForListing (grid data source). Trigger: "create queries for {Domain}", "set up read side for {Domain}".

create-cqrs-queries

Read CQRS/CONTEXT.md for conventions (scalar inputs/VO getters, QueryResult scalar-only rule).

1. Get-for-editing query

Create src/Core/Domain/{Domain}/Query/Get{Domain}ForEditing.php:

  • Constructor takes int $id (scalar)
  • Getter returns VO: getId(): {Domain}Id
  • Queries are read-only data objects — no side effects

2. Result DTO

Create src/Core/Domain/{Domain}/QueryResult/Editable{Domain}.php:

  • Constructor parameters: all fields the edit form needs to pre-fill (scalar types only — see CONTEXT.md)
  • Public getter for every field
  • Immutable: no setters, all values set at construction

Reference: src/Core/Domain/Tax/QueryResult/EditableTax.php (simple), src/Core/Domain/Manufacturer/QueryResult/EditableManufacturer.php (with associations)

3. List query (assess first)

Most PS grids use SearchCriteria + grid QueryBuilder directly — no explicit CQRS query class needed.

Check the domain convention before creating a list query:

  • If the domain uses SearchCriteria + QueryBuilder in the grid: skip this step
  • If the domain uses an explicit query: create Get{Domain}sForListing.php with SearchCriteria parameter

Reference: Most domains (Tax, Manufacturer, Category) use the grid QueryBuilder pattern without an explicit list query.

4. Query handler interfaces

Create in src/Core/Domain/{Domain}/QueryHandler/:

  • Get{Domain}ForEditingHandlerInterface with handle(Get{Domain}ForEditing $query): Editable{Domain}
  • If list query exists, create corresponding interface
  • Query handlers always return data (typed DTO or array) — never void

Rules

Conventions (scalar-only DTOs, read-only queries) are in CQRS/CONTEXT.md. Skill-specific reminders:

  • Map ALL editable fields in the DTO — missing fields cause empty form fields on edit
  • Return typed DTOs, not ObjectModel instances
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall