Eve library

ISIS v2 Character Concept Art Web UI Controls and Validation

Guide

Revision 1

On this page

Generated: 2026-02-24T22:03:34.051Z Checklist: MXA-0011 (ISIS2-00209) Asset Family: character-concept-art Phase: Phase 4 | Milestone: M3 Launch (2026-07-27 to 2026-10-30)

Objective#

Expose character-concept-art workflows in Isis web UI with ergonomic variant-specific controls and deterministic validation aligned to API and SDK typed contracts.

Workflow Coverage#

Workflow ID Covered
character-concept-art-baseline yes
character-concept-art-image-conditioned yes
character-concept-art-control-conditioned yes
character-concept-art-consistency-locked yes

Ergonomic Controls#

  • Character Archetype (required): present
  • Style Preset (required): present
  • Seed (required): present
  • Pose Hint (required): present
  • Style Reference Image (required): present
  • Use Pose Control: present
  • Pose Map: present
  • Use Depth Control: present
  • Depth Map: present
  • Use Segmentation Control: present
  • Segmentation Map: present
  • Continuity Profile ID: present
  • Identity Reference Image (required): present
  • Identity Profile ID (required): present
  • Style Profile ID (required): present

Validation Rules#

  • ✅ Character concept art workflows require generation type text-to-image.
  • ✅ Pose Map is required when pose control is enabled.
  • ✅ Depth Map is required when depth control is enabled.
  • ✅ Segmentation Map is required when segmentation control is enabled.
  • ✅ Style Reference Image is required.
  • ✅ Identity Reference Image is required.
  • ✅ Identity Profile ID is required.
  • ✅ Style Profile ID is required.

Verification Commands#

  • pnpm --filter @isis/web exec vitest run src/pages/character-concept-art-ui-utils.spec.ts src/pages/WorkflowDetailsPage.spec.tsx src/pages/workflow-run-utils.spec.ts
  • pnpm --filter @isis/client exec vitest run src/resources/workflows.character-concept-art.spec.ts src/examples/character-concept-art.spec.ts
  • pnpm nx build @isis/client

Acceptance Criteria#

  • Workflow details page renders ergonomic variant-specific character-concept-art controls for all four workflow IDs.
  • Web UI validation enforces typed contract constraints (generation type lock, required fields, and conditional map requirements).
  • Workflow run dispatch includes explicit generationType/type fields for typed API contract alignment.
  • Web UI tests cover ergonomic form rendering, validation errors, and successful workflow run payload dispatch.

Traceability#

  • Checklist item: MXA-0011
  • Ticket key: ISIS2-00209
  • Source references:
    • docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.json
    • docs/domains/isis/remediation-v2/ISIS_V2_CHARACTER_CONCEPT_ART_REQUIREMENTS_BRIEF.json
    • docs/domains/isis/remediation-v2/ISIS_V2_CHARACTER_CONCEPT_ART_SDK_END_TO_END_EXAMPLES.json
    • apps/isis/web/src/pages/WorkflowDetailsPage.tsx
    • apps/isis/web/src/pages/WorkflowDetailsPage.spec.tsx
    • apps/isis/web/src/pages/character-concept-art-ui-utils.ts
    • apps/isis/web/src/pages/character-concept-art-ui-utils.spec.ts
    • apps/isis/web/src/pages/workflow-run-utils.ts
    • ISIS_TODOS_2.md