Add specification for new default match behavior

This commit is contained in:
Tiberiu Ichim 2026-02-22 09:44:11 +02:00
parent d569198e5d
commit c3acd209bd
2 changed files with 22 additions and 0 deletions

View file

@ -0,0 +1,21 @@
# Match Default Behavior Update
## Problem Description
Previously, selecting a match in the Edit Modal's Match tab would open a detailed review screen allowing the user to cherry-pick which specific metadata fields to update. When users know a match is correct, they usually want to apply everything quickly, which took extra clicks.
## Implementation Details
### Updated Components
1. **`BookMatchCard.vue`**:
- The card itself now acts as an immediate trigger to apply the match.
- The `select` event emitted when clicking the card itself represents this "Direct Apply" action.
- Added a new `Review & Edit` button that appears when hovering over the card. This button emits a new `review` event to preserve the old cherry-picking functionality.
2. **`Match.vue` (Edit Modal Tab)**:
- Contains new mapping logic `applyMatch` triggered by the `@select` event on the card.
- Extracts parsing logic into `parseMatchData` for shared mapping of properties like series, tags, and narrators safely.
- `applyMatch` forcefully sets all `selectedMatchUsage` checkbox fields to `true` and triggers `submitMatchUpdate`.
- `submitMatchUpdate` now takes an optional boolean flag `closeOnSuccess` which resolves to closing the modal (emitting `@close` to the parent `EditModal.vue`) entirely instead of redirecting the user back to the 'details' tab.
## Future Considerations
- Allow configuring the default apply behavior in the settings, giving users the choice to swap the direct click action to "Review & Edit" if they prefer being cautious.

View file

@ -24,6 +24,7 @@ This index provides a quick reference for specification and documentation files
| **2026-02-20** | [promote_file_to_book.md](2026-02-20/promote_file_to_book.md) | Specification for "promoting" files from an existing book into a standalone library item, including a "Split Book" wizard. |
| **2026-02-20** | [move_to_library_keyboard_shortcuts.md](2026-02-20/move_to_library_keyboard_shortcuts.md) | Specification for keyboard-shortcut-enabled library buttons in the "Move to Library" dialog. |
| **2026-02-22** | [centralized_keyboard_shortcuts.md](2026-02-22/centralized_keyboard_shortcuts.md) | Specification for centralizing keyboard shortcut definitions into a single configuration file. |
| **2026-02-22** | [match_default_behavior.md](2026-02-22/match_default_behavior.md) | Specification for the new default "Direct Apply" match behavior and Review & Edit button. |
| **General** | [docs/consolidate_feature.md](docs/consolidate_feature.md) | Comprehensive documentation for the "Consolidate" feature, including conflict resolution and technical details. |
| **General** | [docs/item_restructuring_guide.md](docs/item_restructuring_guide.md) | Guide for Moving, Merging, and Splitting (Promoting) library items. |
| **General** | [docs/metadata_management_tools.md](docs/metadata_management_tools.md) | Documentation for Reset Metadata and Batch Reset operations. |