fix: complete PPI and KaKs reference handoff

2026-08-10 23:13:05 +08:00
parent 39a2c969de
commit 7b7e334213
37 changed files with 4770 additions and 561 deletions
@@ -0,0 +1,25 @@
+# PPI/KaKs Unified Reference Dialogs Design
+
+## Goal
+
+Render the two PPI/KaKs reference-species messages inside the existing stage-confirmation dialog shell so their information is readable and visually consistent with the rest of the application.
+
+## Scope
+
+- Replace the raw STRING reference confirmation message box with a stage-confirmation dialog.
+- Replace the raw reference-data/Ortholog warning alert with a read-only stage-confirmation dialog.
+- Show reference candidates as an ordered list.
+- Group target species, requested stages, required/missing files, current reference species, and Ortholog mapping into the existing PPI reference panel layout.
+- Normalize both topology-candidate and downloaded-reference recommendation field names for display only.
+
+## Non-goals
+
+- No changes to PPI/KaKs download, Ortholog generation, identity, scheduling, API payloads, backend validation, or analysis execution.
+- No changes to which candidate is selected: the first ranked candidate remains the confirmed candidate.
+- No new automatic confirmation behavior.
+
+## Interaction contract
+
+- STRING candidate dialog: `Cancel PPI` resolves false; `Confirm top candidate` resolves true.
+- Reference status dialog: `OK` only acknowledges the message; the preflight remains blocked exactly as before.
+- Both dialogs use the existing queue, modal shell, title, progress header, and Element Plus components.