| name | lms-grades |
| description | LMS gradebook system for LT/IT (English Language Arts) and KCFS (Kang Chiao Future Skill) courses. Use this skill when implementing grade calculation, gradebook features, expectations system, or assessment title management. |
LMS Grades - Gradebook System
Quick Reference
| System |
Score Range |
Formula |
| LT/IT |
0-100 |
Weighted avg: FA 15%, SA 20%, Final 10% |
| KCFS |
0-5 (→50-100) |
Base 50 + weighted categories |
Two Calculation Engines
| Engine |
File |
Final Code |
Use Case |
| Core Grade |
lib/grade/calculations.ts |
FINAL |
Historical reports |
| Formula Engine |
lib/gradebook/FormulaEngine.ts |
MID |
Live gradebook |
LT/IT Grades (English)
Assessment Codes (14 total)
- FA1-FA8: Formative Assessments (15% total, 0.0188 each)
- SA1-SA4: Summative Assessments (20% total, 0.05 each)
- FINAL/MID: Final/Midterm Exam (10%)
Formula
Semester = (FA_avg × 0.15 + SA_avg × 0.20 + FINAL × 0.10) ÷ 0.45
Rules:
- Only scores >0 included
- All zeros → null
→ See: references/lt-it-formula.md
KCFS Grades (Future Skills)
Formula
Term Grade = 50 + Σ(category_score × weight)
Categories by Grade
| Grade |
Categories |
Weight |
| G1-2 |
COMM, COLLAB, SD, CT |
2.5 |
| G3-4 |
+ BW (5 total) |
2.0 |
| G5-6 |
+ PORT, PRES (6 total) |
5/3 |
Rules:
- Scores 0-5 (0.5 increments)
- Zero counts (lowers grade)
- Blank/Absent excluded
→ See: references/kcfs-formula.md
Key Files
| Purpose |
Location |
| Core Calculations |
lib/grade/calculations.ts |
| KCFS Calculations |
lib/grade/kcfs-calculations.ts |
| Formula Engine |
lib/gradebook/FormulaEngine.ts |
| Gradebook Page |
app/(lms)/class/[classId]/gradebook/ |
| Spreadsheet |
components/gradebook/Spreadsheet.tsx |
| Expectations |
components/gradebook/ExpectationsManager.tsx |
Features
Gradebook Expectations (v1.52.0)
- Head Teachers set completion targets
- Track teacher progress by grade/course
- Status: on_track / behind / not_started
Assessment Title Override
- Priority: Class > Grade×Track > Default
- Affects display only, not calculation
References