Skip to content

Data Dictionary · Retention ​

⚙️ Trang này sinh tự động từ source code bằng scripts/gen-reference.mjs — đừng sửa tay, sửa code rồi chạy npm run gen:reference.

Thuộc Data Dictionary. 1 bảng, learner_retention.

learner_retention ​

Migration 0021 — Retention Model (SDD-017 §2, REQ-INT-23, SRC-065) Mastery ≠ Retention: learner_skill_state.mastery KHÔNG decay theo thời gian; trạng thái trí nhớ hiện tại lưu riêng tại đây, cấp node (Q-112).

migration: 0021_learner_retention.sql

CộtKiểuRàng buộc / ghi chú
learner_idTEXTNOT NULL REFERENCES learners(id)
subject_idTEXTNOT NULL
target_typeTEXTNOT NULL DEFAULT 'node'
target_idTEXTNOT NULL
historical_masteryREALNOT NULL DEFAULT 0
current_retentionREALNOT NULL DEFAULT 0
retention_confidenceREALNOT NULL DEFAULT 0
stability_daysREALNOT NULL DEFAULT 6
last_exposure_atTEXT—
last_successful_retrieval_atTEXT—
last_strong_evidence_atTEXT—
retrieval_countINTEGERNOT NULL DEFAULT 0
successful_retrieval_countINTEGERNOT NULL DEFAULT 0
review_urgencyTEXTNOT NULL DEFAULT 'NONE' CHECK (review_urgency IN ('NONE','LOW','MEDIUM','HIGH','CRITICAL'))
next_review_earliestTEXT—
next_review_idealTEXT—
next_review_latestTEXT—
model_versionTEXTNOT NULL DEFAULT 'retention-v1'
updated_atTEXTNOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ','now'))
—table constraintPRIMARY KEY (learner_id, subject_id, target_type, target_id)

Khóa ngoại: learner_id → learners

Index: idx_retention_review(learner_id, subject_id, next_review_ideal)