STCW competency map

LMS không chỉ lưu bài học chung chung; hệ thống có module competency mapping để map lesson vào chuẩn hàng hải như STCW, SOLAS, COLREGs, MARPOL.

Luồng sử dụng

Admin/seed tạo standards + competencies
-> Teacher mở course competency map
-> Teacher gắn lesson với competency
-> Student/Admin xem coverage matrix
-> Teacher/Admin export CSV khi cần báo cáo

API chính

Endpoint	Ý nghĩa	Role
`GET /api/v3/standards`	Danh sách standard active	TEACHER, ADMIN, ORG_ADMIN
`GET /api/v3/standards/{standardId}/competencies`	Competency theo standard/category	TEACHER, ADMIN, ORG_ADMIN
`GET /api/v3/courses/{courseId}/competency-map`	Matrix competency của course	STUDENT, TEACHER, ADMIN, ORG_ADMIN nếu có read access
`PUT /api/v3/lessons/{lessonId}/competencies`	Update mapping lesson	TEACHER, ADMIN, ORG_ADMIN
`GET /api/v3/courses/{courseId}/competency-map/export`	Export CSV	TEACHER, ADMIN, ORG_ADMIN

File nguồn

File	Vai trò
`backend/src/main/java/com/example/lms/competency_mapping/infrastructure/web/CompetencyMappingController.java`	REST API
`backend/src/main/resources/db/migration/V130__stcw_competency_mapping.sql`	Schema/seed competency mapping
`fe/src/app/features/teacher/competency-map/competency-map.component.ts`	UI matrix cho teacher
`GetCourseCompetencyMapUseCase`	Tạo matrix course
`UpdateLessonCompetenciesUseCase`	Diff-based upsert mapping

Cách giải thích

standard là bộ chuẩn lớn, ví dụ STCW.
competency là năng lực/chuẩn nhỏ hơn trong bộ chuẩn; bảng thật là standard_competencies.
lesson_competency_mappings nối bài học với năng lực. Endpoint vẫn dùng path /competencies để dễ đọc theo ngôn ngữ nghiệp vụ.
Matrix giúp chứng minh khóa học bao phủ chuẩn đào tạo nào, hữu ích khi báo cáo chất lượng/chương trình.