How fiismart/fiismart-backend works
FiiSmart is a learning platform for students, teachers, tutors, and administrators. The main learner workflow is to browse courses, enroll, study lectures, take quizzes, and track progress; teachers can author course and quiz content, while reviews, comments, moderation, and dashboards support the surrounding learning community. Authentication uses Cognito, and the application persists domain data through MongoDB repositories. AI capabilities include generated course content, streamed chat with tool dispatch, PDF assistance, and free-text quiz grading. The README is empty; links beyond the sampled source relationships are left unverified.
Main entry points: GeminiChatService.java AI chat · EnrollmentService.java Enrollment service · QuizAttemptService.java Quiz attempts · ReviewService.java Course reviews
Components 25
Identity and access
- Authentication
src/main/java/ro/fiismart/auth/controller/AuthController.java - Cognito auth
src/main/java/ro/fiismart/auth/service/CognitoAuthService.java
Learning lifecycle
- Course access
src/main/java/ro/fiismart/courses/controller/CourseController.java - Course management
src/main/java/ro/fiismart/courses/service/CourseManagementService.java - Enrollment
src/main/java/ro/fiismart/enrollment/controller/EnrollmentController.java - Enrollment service
src/main/java/ro/fiismart/enrollment/service/EnrollmentService.java - Student learning
src/main/java/ro/fiismart/dashboard/student - Quiz authoring
src/main/java/ro/fiismart/quiz/service/QuizManagementService.java - Quiz attempts
src/main/java/ro/fiismart/quizattempt/service/QuizAttemptService.java
Authoring and AI
- Course generation
src/main/java/ro/fiismart/ai/service/CourseContentAiService.java - AI chat
src/main/java/ro/fiismart/chat/service/GeminiChatService.java - Chat tools
src/main/java/ro/fiismart/chat/service/ChatToolHandler.java - PDF assistance
src/main/java/ro/fiismart/ai/service/PdfAiService.java - AI grading
src/main/java/ro/fiismart/ai/service/AiTextGraderService.java
Community and operations
- Course reviews
src/main/java/ro/fiismart/review/service/ReviewService.java - Teacher dashboard
src/main/java/ro/fiismart/dashboard/teacher - Administration
src/main/java/ro/fiismart/admin/service/AdminService.java
Shared data
- Course data
src/main/java/ro/fiismart/common/model/Course.java - Enrollment data
src/main/java/ro/fiismart/common/model/Enrollment.java - User data
src/main/java/ro/fiismart/common/model/User.java - Quiz data
src/main/java/ro/fiismart/common/repository/ModuleQuizRepository.java - Chat sessions
src/main/java/ro/fiismart/chat/repository/ChatSessionRepository.java
Other components
- Student
- Teacher
- Gemini API
Connections 28
- Student → Authentication: authenticates
- Teacher → Authentication: authenticates
- Authentication → Cognito auth: delegates auth
- Student → Course access: browses courses
- Teacher → Course access: manages courses
- Course access → Course management: calls
- Course management → Course data: reads and writes
src/main/java/ro/fiismart/courses/service/CourseManagementService.java - Student → Enrollment: enrolls
- Enrollment → Enrollment service: calls
src/main/java/ro/fiismart/enrollment/controller/EnrollmentController.java - Enrollment service → Course data: checks course
src/main/java/ro/fiismart/enrollment/service/EnrollmentService.java - Enrollment service → Enrollment data: saves enrollment
src/main/java/ro/fiismart/enrollment/service/EnrollmentService.java - Student → Student learning: views progress
- Teacher → Quiz authoring: authors quizzes
- Student → Quiz attempts: submits answers
- Quiz attempts → Quiz data: loads questions
src/main/java/ro/fiismart/quizattempt/service/QuizAttemptService.java - Quiz attempts → AI grading: grades free text
src/main/java/ro/fiismart/quizattempt/service/QuizAttemptService.java - Teacher → Course generation: generates content
- Course generation → Gemini API: requests generation
src/main/java/ro/fiismart/ai/service/CourseContentAiService.java - Student → AI chat: sends messages
- AI chat → Gemini API: streams prompts
src/main/java/ro/fiismart/chat/service/GeminiChatService.java - AI chat → Chat tools: dispatches tools
src/main/java/ro/fiismart/chat/service/GeminiChatService.java - AI chat → Chat sessions: persists sessions
src/main/java/ro/fiismart/chat/service/GeminiChatService.java - Student → PDF assistance: requests PDF help
- Student → Course reviews: writes reviews
- Course reviews → Course data: updates rating
src/main/java/ro/fiismart/review/service/ReviewService.java - Course reviews → User data: resolves authors
src/main/java/ro/fiismart/review/service/ReviewService.java - Teacher → Teacher dashboard: views overview
- Administration → User data: manages accounts
src/main/java/ro/fiismart/admin/service/AdminService.java