docs(match): record term-quality evidence
This commit is contained in:
@@ -329,3 +329,13 @@
|
||||
- **Consequences:** users without a saved scoped choice inherit the explicit anonymous choice, otherwise the documented default is System. Explicit Light/Dark ignore OS changes. The pre-paint script must remain behaviorally aligned with `themePrefs`; tests cover both.
|
||||
- **User approval required:** No; this directly implements the approved UX-002 contract without schema, dependency or production changes.
|
||||
- **Reversible:** Yes. Revert `11734ee`; existing preference values remain unchanged and readable.
|
||||
|
||||
## DEC-034 — Important-term quality stays deterministic and on demand
|
||||
|
||||
- **Date:** 2026-08-09
|
||||
- **Decision:** Harden the existing shared `JobCvMatchService` rather than add a model or stored analysis version. Clean HTML/chrome at the matcher boundary, use bilingual/general filler categories, rank bounded phrase runs before singleton terms, and extend the canonical skill vocabulary for punctuation-sensitive technologies. Rename UI output to “important terms.”
|
||||
- **Reason/evidence:** the complete path proved the reported Norwegian words came from English-only deterministic token ranking. Imported descriptions may be clean, but manual descriptions/notes reach the same matcher. Results are recomputed and the generated learning sync already preserves user decisions, so a cache/schema migration would solve a nonexistent storage problem.
|
||||
- **Alternatives considered:** hardcode the five examples; call Ollama for keywords; add a result table/version column; filter only in the UI; silently delete learning items. These are incomplete, less reliable, duplicate state, leave API consumers dirty or discard user history.
|
||||
- **Consequences:** term changes appear on the next request; obsolete pending generated learning items auto-complete under existing behavior while done/dismissed decisions remain. The curated vocabulary remains intentionally bounded and test-driven.
|
||||
- **User approval required:** No; this is the deterministic-first implementation explicitly required by both programmes.
|
||||
- **Reversible:** Yes. Revert `da1aa8b`; no schema, cache or provider state changes.
|
||||
|
||||
Reference in New Issue
Block a user