Codegen Add QT Entity

When you need to add Qt desktop UI for a new entity in ores.qt. Prerequisites: the domain type must exist (domain-type-creator) and the server-side handlers must be implemented. See Entity lifecycle for the full layer ordering. If real-time updates are needed, the eventing infrastructure must also be in place.

Codegen (--profile qt) is the primary path — always try it first.

1. Generate with codegen (preferred): cd projects/ores.codegen && ./run_generator.sh models/{component}/{entity}_domain_entity.json --profile qt Then go directly to Phase 4 (controller wiring).
2. If manual creation is needed, work through four phases:
   • Phase 1 — ClientModel + list window (PR: [qt] Add {Entity} model and list window): async model with pagination + QAbstractTableModel; list window with toolbar, sort/filter proxy, table view.
   • Phase 2 — detail dialog (PR: [qt] Add {Entity} detail dialog): form editors, async save, accepted=/=rejected signals.
   • Phase 3 — history dialog (PR: [qt] Add {Entity} history dialog): read-only versioned view via a separate history model.
   • Phase 4 — controller + integration (PR: [qt] Integrate {Entity} controller and update diagrams): register in MainWindow.cpp; update class diagrams; add recipe docs.
3. Select an icon for toolbar actions using icon-guidelines.

Use feature-branch-manager between phases and pr-manager to open each PR. Build after every step: cmake --build --preset linux-clang-debug-ninja --target ores.qt.lib.

• How do I create Qt UI for a new entity? — codegen and manual phase-by-phase walkthrough.

• Qt entity patterns — ClientModel layout, async fetch, recency highlighting, dialog shapes, file locations.
• ORE Studio Codegen — --profile qt details and template catalogue.
• Qt plugin architecture — plugin lifecycle and menu registration.
• icon-guidelines — icon selection for toolbar actions.
• Entity lifecycle — layer ordering overview.

Runs via --profile qt (12 templates). Full output paths are in Qt entity patterns§"Templates". Read the template directly for the authoritative implementation — do not reproduce it here.