Update qa_store.py

qa_store.py

@@ -6,14 +6,14 @@ import re
 ENTRIES: List[Dict[str, Any]] = []
 RAW_KNOWLEDGE: str = ""
 
-# QA from textbook JSONL
+# QA from textbook JSONL (auto-generated from textbook)
 AUTO_QA_KNOWLEDGE: List[Dict[str, Any]] = []
 
-# Manual QA managed by teacher
+# Manual QA managed by teacher (manual_qa.jsonl)
 MANUAL_QA_LIST: List[Dict[str, Any]] = []
 MANUAL_QA_INDEX: Dict[str, Dict[str, Any]] = {}
 
-# Combined index for fast lookup
+# Combined index for fast lookup (auto + manual)
 QA_INDEX: Dict[str, str] = {}
 ALL_QA_KNOWLEDGE: List[Dict[str, Any]] = []
 
@@ -21,8 +21,8 @@ ALL_QA_KNOWLEDGE: List[Dict[str, Any]] = []
 NEXT_MANUAL_ID: int = 1
 
 # Embeddings for textbook entries (one vector per ENTRIES item)
-TEXT_EMBEDDINGS = None  # will be a torch.Tensor or None
-
+# Will be set to a torch.Tensor by _build_entry_embeddings() in model_utils.py
+TEXT_EMBEDDINGS = None
 
 
 def normalize_question(q: str) -> str:
@@ -31,6 +31,8 @@ def normalize_question(q: str) -> str:
     Lowercase + remove punctuation + collapse spaces.
     """
     q = (q or "").lower()
+    # remove common punctuation (including Lao/English quotes)
     q = re.sub(r"[?!？！\.\,\:\;\"“”'‘’]", " ", q)
+    # collapse multiple spaces
     q = re.sub(r"\s+", " ", q)
     return q.strip()