Source map

Trang này là bản curated để biết module nào chịu trách nhiệm. Khi cần mở file cụ thể theo tình huống sửa code, dùng Vị trí file code. Full index nằm ở Full File CodeMap.

Số liệu đọc từ source

Khu vực	Hiện trạng
Backend Java	708 file trong `backend/src/main/java/com/example/lms`
Backend controller	57 controller
Backend use case	114 use case
Backend JPA entity	68 entity
Frontend app	763 file TS/HTML/SCSS trong `fe/src/app`
Angular component TS	251 component
Angular service TS	76 service

Backend module map

Module	Vai trò	File nên mở trước
`identity`	Auth, JWT, Google OAuth, invite, user, organization	`AuthControllerV3`, `JwtService`, `RegisterUserUseCaseV2`, `GoogleOAuthRedirectController`
`course_authoring`	Course, chapter, lesson, section, publication, review	`CourseAuthoringControllerV3`, `TeacherCoursesControllerV3`, `CoursePublicationService`, `CourseEditorStore`
`learning_delivery`	Enrollment, class, progress, video, certificate, offline-related API	`SelfEnrollUseCase`, `AdaptiveVideoPlaybackService`, `VideoAssetIngestService`, `LearningActivityControllerV3`
`assessment`	Quiz, question bank, assignment, submission, rubric, grading	`QuizControllerV3`, `QuestionControllerV3`, `AssignmentControllerV3`, `GradeSubmissionUseCase`
`communication`	Message, conversation, notification	`ConversationControllerV3`, `MessageUseCase`
`ai_assistant`	AI chat proxy, token exchange, Wiii adapter	`AiAssistantControllerV3`, `AiTokenControllerV3`, `WiiiChatAdapter`, `WiiiTokenExchangeAdapter`
`competency_mapping`	STCW/SOLAS/COLREGs/MARPOL mapping	`CompetencyMappingController`, `GetCourseCompetencyMapUseCase`
`shared`	File, upload, payment, admin settings, Wiii service auth	`PresignedUploadUseCase`, `PaymentControllerV3`, `WiiiServiceAuthFilter`

Frontend feature map

Feature	Vai trò	File nên mở trước
`features/teacher`	Teacher portal, course editor, quiz, grading, revenue	`teacher.routes.ts`, `course-editor.routes.ts`, `CourseEditorStore`
`features/student`	Student dashboard, learning, messages, profile	`student.routes.ts`, `course-learning.component.ts`
`features/learning`	Runtime học bài/quiz/player	`course-learning.component.ts`, `adaptive-video-player.component.ts`
`features/ai-chat`	Wiii iframe, chat panel, Pointy, preview/apply dialog	`wiii-context.service.ts`, `chat-panel.component.ts`
`features/admin`	Admin/org-admin dashboard, users, courses, settings	`admin.routes.ts`, `admin-dashboard.component.ts`
`features/payment`	Checkout, callback, history, refund policy	`payment.service.ts`, `payment.routes.ts`
`core`	Auth, guards, interceptors, offline services, upload utilities	`auth.service.ts`, `role.guard.ts`, `course-download.service.ts`
`api`	Type-safe client, endpoint constants, DTO types	`api-client.ts`, `endpoints`, `types`

Khi sửa code

Sửa UI nhỏ: tìm component trong fe/src/app/features/..., sửa .html và .scss.
Sửa state/form flow: mở component .ts, service feature, store nếu có.
Sửa API call: mở fe/src/app/api và service feature gọi API đó.
Sửa nghiệp vụ backend: mở controller để tìm endpoint, rồi nhảy vào use case.
Sửa database: tạo migration mới trong backend/src/main/resources/db/migration, không sửa migration cũ đã chạy.