# ISIS v2 Character Concept Art Web UI Controls and Validation

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`
