import-mapping-review-gate

What problem does it solve?

This pattern provides a gated import workflow where column mappings can be reviewed, unknown materials resolved, and new library materials created only after explicit validation.

Core Features & Use Cases

• Separate the obvious-default path from the rescue-mapping path to keep imports fast when unambiguous.
• Require a preview-before-commit contract to auto-resolve or explicitly map all required fields and materials.
• Treat material resolution as canonicalization, avoiding silent remapping or fuzzy-matching behind the user.
• Treat create-new-material as a real library mutation, making new materials immediately available and persisted.
• Keep failure surfaces distinct (file errors, mapping gaps, unresolved materials, and create failures) and prevent final import until all required mappings are resolved.

Quick Start

Preview and map source columns before committing an import to ensure all required fields and materials are resolved.