overview glossary

Glossary

These terms appear across the Rust backend, Tauri wrapper, and React frontend.

Term	Meaning	Main source files
File A / File B	The left and right CSV inputs being compared.	`src/data/types.rs`, `frontend/src/types/api.ts`
Session	An in-memory workspace containing loaded CSVs, mappings, results, and the current comparison config.	`src/backend/session.rs`, `src/backend/store.rs`
Row key	One or more columns used to decide whether a row in File A corresponds to a row in File B.	`src/backend/requests.rs`, `src/comparison/rows.rs`
Comparison columns	The ordered columns whose values are compared after rows are matched.	`src/backend/validation.rs`, `frontend/src/components/MappingConfig.tsx`
Column mapping	A File A column paired with a File B column, with mapping kind `exact`, `manual`, or `fuzzy`.	`src/data/types.rs`, `src/comparison/mapping.rs`
Auto-pair	A frontend helper that fills confident comparison-column pairs using backend mapping suggestions.	`frontend/src/features/mapping/autoPair.ts`, `src/comparison/mapping.rs`
Flexible row-key matching	Optional row matching that accepts wildcard-like `**` patterns or isolated shared key tokens.	`src/comparison/engine.rs`, `src/comparison/rows.rs`
Virtual header	A selectable label for a JSON field found inside a physical CSV cell.	`src/data/json_fields.rs`
Cleanup settings	Normalization options for missing values, case, whitespace, numbers, decimal rounding, dates, and flexible keys.	`src/data/types.rs`, `src/comparison/value_compare.rs`, `frontend/src/config/normalization.ts`
Unkeyed row	A row skipped because at least one selected key value normalizes to missing.	`src/comparison/engine.rs`, `src/data/types.rs`
Missing left	A File B row with a usable key that has no matching File A row.	`src/data/types.rs`, `frontend/src/features/results/presentation.ts`
Missing right	A File A row with a usable key that has no matching File B row.	`src/data/types.rs`, `frontend/src/features/results/presentation.ts`
Duplicate	A selected key that appears multiple times on one or both sides.	`src/data/types.rs`, `src/comparison/engine.rs`
Pair-order file	A saved setup file containing selected row keys and comparison-column order. It does not include results.	`src/backend/pair_order.rs`
Comparison snapshot	A saved completed comparison that reloads the result in read-only mode.	`src/backend/comparison_snapshot.rs`, `src/backend/persistence/v1/mod.rs`
Transport parity	The requirement that browser HTTP routes and Tauri command names stay aligned.	`frontend/src/services/apiRoutes.ts`, `frontend/src/services/tauriCommands.ts`, `tests/transport_parity_integration.rs`