# fiismart/fiismart-backend architecture

> Architecture diagram of the GitHub repository fiismart/fiismart-backend, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/fiismart/fiismart-backend
- Repository: https://github.com/fiismart/fiismart-backend

## Overview

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: [`src/main/java/ro/fiismart/chat/service/GeminiChatService.java`](https://github.com/fiismart/fiismart-backend/blob/main/src/main/java/ro/fiismart/chat/service/GeminiChatService.java) (AI chat), [`src/main/java/ro/fiismart/enrollment/service/EnrollmentService.java`](https://github.com/fiismart/fiismart-backend/blob/main/src/main/java/ro/fiismart/enrollment/service/EnrollmentService.java) (Enrollment service), [`src/main/java/ro/fiismart/quizattempt/service/QuizAttemptService.java`](https://github.com/fiismart/fiismart-backend/blob/main/src/main/java/ro/fiismart/quizattempt/service/QuizAttemptService.java) (Quiz attempts), [`src/main/java/ro/fiismart/review/service/ReviewService.java`](https://github.com/fiismart/fiismart-backend/blob/main/src/main/java/ro/fiismart/review/service/ReviewService.java) (Course reviews)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity and access"]
  node_identity_api["Authentication"]
  node_cognito["Cognito auth"]
end

subgraph group_learning["Learning lifecycle"]
  node_course_api["Course access"]
  node_course_service["Course management"]
  node_enrollment_api["Enrollment"]
  node_enrollment_service["Enrollment service"]
  node_student_dashboard["Student learning"]
  node_quiz["Quiz authoring"]
  node_attempts["Quiz attempts"]
end

subgraph group_authoring["Authoring and AI"]
  node_course_ai["Course generation"]
  node_chat["AI chat"]
  node_chat_tools["Chat tools"]
  node_pdf_ai["PDF assistance<br/>[PdfAiService.java]"]
  node_grading["AI grading"]
end

subgraph group_community["Community and operations"]
  node_reviews["Course reviews<br/>[ReviewService.java]"]
  node_teacher_dashboard["Teacher dashboard"]
  node_admin["Administration<br/>[AdminService.java]"]
end

subgraph group_shared["Shared data"]
  node_course_store[("Course data<br/>[Course.java]")]
  node_enrollment_store[("Enrollment data<br/>[Enrollment.java]")]
  node_user_store[("User data<br/>[User.java]")]
  node_quiz_store[("Quiz data")]
  node_chat_store[("Chat sessions")]
end

node_learner(("Student"))
node_teacher(("Teacher"))
node_gemini{{"Gemini API"}}

node_learner -.->|"authenticates"| node_identity_api
node_teacher -.->|"authenticates"| node_identity_api
node_identity_api -.->|"delegates auth"| node_cognito
node_learner -.->|"browses courses"| node_course_api
node_teacher -.->|"manages courses"| node_course_api
node_course_api -.->|"calls"| node_course_service
node_course_service -->|"reads and writes"| node_course_store
node_learner -.->|"enrolls"| node_enrollment_api
node_enrollment_api -->|"calls"| node_enrollment_service
node_enrollment_service -->|"checks course"| node_course_store
node_enrollment_service -->|"saves enrollment"| node_enrollment_store
node_learner -.->|"views progress"| node_student_dashboard
node_teacher -.->|"authors quizzes"| node_quiz
node_learner -.->|"submits answers"| node_attempts
node_attempts -->|"loads questions"| node_quiz_store
node_attempts -->|"grades free text"| node_grading
node_teacher -.->|"generates content"| node_course_ai
node_course_ai -->|"requests generation"| node_gemini
node_learner -.->|"sends messages"| node_chat
node_chat -->|"streams prompts"| node_gemini
node_chat -->|"dispatches tools"| node_chat_tools
node_chat -->|"persists sessions"| node_chat_store
node_learner -.->|"requests PDF help"| node_pdf_ai
node_learner -.->|"writes reviews"| node_reviews
node_reviews -->|"updates rating"| node_course_store
node_reviews -->|"resolves authors"| node_user_store
node_teacher -.->|"views overview"| node_teacher_dashboard
node_admin -.->|"manages accounts"| node_user_store

click node_identity_api "https://github.com/fiismart/fiismart-backend/blob/main/src/main/java/ro/fiismart/auth/controller/AuthController.java"
click node_cognito "https://github.com/fiismart/fiismart-backend/blob/main/src/main/java/ro/fiismart/auth/service/CognitoAuthService.java"
click node_course_api "https://github.com/fiismart/fiismart-backend/blob/main/src/main/java/ro/fiismart/courses/controller/CourseController.java"
click node_course_service "https://github.com/fiismart/fiismart-backend/blob/main/src/main/java/ro/fiismart/courses/service/CourseManagementService.java"
click node_enrollment_api "https://github.com/fiismart/fiismart-backend/blob/main/src/main/java/ro/fiismart/enrollment/controller/EnrollmentController.java"
click node_enrollment_service "https://github.com/fiismart/fiismart-backend/blob/main/src/main/java/ro/fiismart/enrollment/service/EnrollmentService.java"
click node_student_dashboard "https://github.com/fiismart/fiismart-backend/tree/main/src/main/java/ro/fiismart/dashboard/student"
click node_quiz "https://github.com/fiismart/fiismart-backend/blob/main/src/main/java/ro/fiismart/quiz/service/QuizManagementService.java"
click node_attempts "https://github.com/fiismart/fiismart-backend/blob/main/src/main/java/ro/fiismart/quizattempt/service/QuizAttemptService.java"
click node_course_ai "https://github.com/fiismart/fiismart-backend/blob/main/src/main/java/ro/fiismart/ai/service/CourseContentAiService.java"
click node_chat "https://github.com/fiismart/fiismart-backend/blob/main/src/main/java/ro/fiismart/chat/service/GeminiChatService.java"
click node_chat_tools "https://github.com/fiismart/fiismart-backend/blob/main/src/main/java/ro/fiismart/chat/service/ChatToolHandler.java"
click node_pdf_ai "https://github.com/fiismart/fiismart-backend/blob/main/src/main/java/ro/fiismart/ai/service/PdfAiService.java"
click node_grading "https://github.com/fiismart/fiismart-backend/blob/main/src/main/java/ro/fiismart/ai/service/AiTextGraderService.java"
click node_reviews "https://github.com/fiismart/fiismart-backend/blob/main/src/main/java/ro/fiismart/review/service/ReviewService.java"
click node_teacher_dashboard "https://github.com/fiismart/fiismart-backend/tree/main/src/main/java/ro/fiismart/dashboard/teacher"
click node_admin "https://github.com/fiismart/fiismart-backend/blob/main/src/main/java/ro/fiismart/admin/service/AdminService.java"
click node_course_store "https://github.com/fiismart/fiismart-backend/blob/main/src/main/java/ro/fiismart/common/model/Course.java"
click node_enrollment_store "https://github.com/fiismart/fiismart-backend/blob/main/src/main/java/ro/fiismart/common/model/Enrollment.java"
click node_user_store "https://github.com/fiismart/fiismart-backend/blob/main/src/main/java/ro/fiismart/common/model/User.java"
click node_quiz_store "https://github.com/fiismart/fiismart-backend/blob/main/src/main/java/ro/fiismart/common/repository/ModuleQuizRepository.java"
click node_chat_store "https://github.com/fiismart/fiismart-backend/blob/main/src/main/java/ro/fiismart/chat/repository/ChatSessionRepository.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_identity_api,node_cognito toneBlue
class node_course_api,node_course_service,node_enrollment_api,node_enrollment_service,node_student_dashboard,node_quiz,node_attempts toneAmber
class node_course_ai,node_chat,node_chat_tools,node_pdf_ai,node_grading,node_gemini toneMint
class node_reviews,node_teacher_dashboard,node_admin toneRose
class node_course_store,node_enrollment_store,node_user_store,node_quiz_store,node_chat_store,node_learner,node_teacher toneIndigo
```

## Components

### Identity and access

- [Authentication](https://github.com/fiismart/fiismart-backend/blob/main/src/main/java/ro/fiismart/auth/controller/AuthController.java): `src/main/java/ro/fiismart/auth/controller/AuthController.java`
- [Cognito auth](https://github.com/fiismart/fiismart-backend/blob/main/src/main/java/ro/fiismart/auth/service/CognitoAuthService.java): `src/main/java/ro/fiismart/auth/service/CognitoAuthService.java`

### Learning lifecycle

- [Course access](https://github.com/fiismart/fiismart-backend/blob/main/src/main/java/ro/fiismart/courses/controller/CourseController.java): `src/main/java/ro/fiismart/courses/controller/CourseController.java`
- [Course management](https://github.com/fiismart/fiismart-backend/blob/main/src/main/java/ro/fiismart/courses/service/CourseManagementService.java): `src/main/java/ro/fiismart/courses/service/CourseManagementService.java`
- [Enrollment](https://github.com/fiismart/fiismart-backend/blob/main/src/main/java/ro/fiismart/enrollment/controller/EnrollmentController.java): `src/main/java/ro/fiismart/enrollment/controller/EnrollmentController.java`
- [Enrollment service](https://github.com/fiismart/fiismart-backend/blob/main/src/main/java/ro/fiismart/enrollment/service/EnrollmentService.java): `src/main/java/ro/fiismart/enrollment/service/EnrollmentService.java`
- [Student learning](https://github.com/fiismart/fiismart-backend/tree/main/src/main/java/ro/fiismart/dashboard/student): `src/main/java/ro/fiismart/dashboard/student`
- [Quiz authoring](https://github.com/fiismart/fiismart-backend/blob/main/src/main/java/ro/fiismart/quiz/service/QuizManagementService.java): `src/main/java/ro/fiismart/quiz/service/QuizManagementService.java`
- [Quiz attempts](https://github.com/fiismart/fiismart-backend/blob/main/src/main/java/ro/fiismart/quizattempt/service/QuizAttemptService.java): `src/main/java/ro/fiismart/quizattempt/service/QuizAttemptService.java`

### Authoring and AI

- [Course generation](https://github.com/fiismart/fiismart-backend/blob/main/src/main/java/ro/fiismart/ai/service/CourseContentAiService.java): `src/main/java/ro/fiismart/ai/service/CourseContentAiService.java`
- [AI chat](https://github.com/fiismart/fiismart-backend/blob/main/src/main/java/ro/fiismart/chat/service/GeminiChatService.java): `src/main/java/ro/fiismart/chat/service/GeminiChatService.java`
- [Chat tools](https://github.com/fiismart/fiismart-backend/blob/main/src/main/java/ro/fiismart/chat/service/ChatToolHandler.java): `src/main/java/ro/fiismart/chat/service/ChatToolHandler.java`
- [PDF assistance](https://github.com/fiismart/fiismart-backend/blob/main/src/main/java/ro/fiismart/ai/service/PdfAiService.java): `src/main/java/ro/fiismart/ai/service/PdfAiService.java`
- [AI grading](https://github.com/fiismart/fiismart-backend/blob/main/src/main/java/ro/fiismart/ai/service/AiTextGraderService.java): `src/main/java/ro/fiismart/ai/service/AiTextGraderService.java`

### Community and operations

- [Course reviews](https://github.com/fiismart/fiismart-backend/blob/main/src/main/java/ro/fiismart/review/service/ReviewService.java): `src/main/java/ro/fiismart/review/service/ReviewService.java`
- [Teacher dashboard](https://github.com/fiismart/fiismart-backend/tree/main/src/main/java/ro/fiismart/dashboard/teacher): `src/main/java/ro/fiismart/dashboard/teacher`
- [Administration](https://github.com/fiismart/fiismart-backend/blob/main/src/main/java/ro/fiismart/admin/service/AdminService.java): `src/main/java/ro/fiismart/admin/service/AdminService.java`

### Shared data

- [Course data](https://github.com/fiismart/fiismart-backend/blob/main/src/main/java/ro/fiismart/common/model/Course.java): `src/main/java/ro/fiismart/common/model/Course.java`
- [Enrollment data](https://github.com/fiismart/fiismart-backend/blob/main/src/main/java/ro/fiismart/common/model/Enrollment.java): `src/main/java/ro/fiismart/common/model/Enrollment.java`
- [User data](https://github.com/fiismart/fiismart-backend/blob/main/src/main/java/ro/fiismart/common/model/User.java): `src/main/java/ro/fiismart/common/model/User.java`
- [Quiz data](https://github.com/fiismart/fiismart-backend/blob/main/src/main/java/ro/fiismart/common/repository/ModuleQuizRepository.java): `src/main/java/ro/fiismart/common/repository/ModuleQuizRepository.java`
- [Chat sessions](https://github.com/fiismart/fiismart-backend/blob/main/src/main/java/ro/fiismart/chat/repository/ChatSessionRepository.java): `src/main/java/ro/fiismart/chat/repository/ChatSessionRepository.java`

### Other components

- **Student**
- **Teacher**
- **Gemini API**

## Connections

- 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 (evidence: `src/main/java/ro/fiismart/courses/service/CourseManagementService.java`)
- Student → Enrollment: enrolls
- Enrollment → Enrollment service: calls (evidence: `src/main/java/ro/fiismart/enrollment/controller/EnrollmentController.java`)
- Enrollment service → Course data: checks course (evidence: `src/main/java/ro/fiismart/enrollment/service/EnrollmentService.java`)
- Enrollment service → Enrollment data: saves enrollment (evidence: `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 (evidence: `src/main/java/ro/fiismart/quizattempt/service/QuizAttemptService.java`)
- Quiz attempts → AI grading: grades free text (evidence: `src/main/java/ro/fiismart/quizattempt/service/QuizAttemptService.java`)
- Teacher → Course generation: generates content
- Course generation → Gemini API: requests generation (evidence: `src/main/java/ro/fiismart/ai/service/CourseContentAiService.java`)
- Student → AI chat: sends messages
- AI chat → Gemini API: streams prompts (evidence: `src/main/java/ro/fiismart/chat/service/GeminiChatService.java`)
- AI chat → Chat tools: dispatches tools (evidence: `src/main/java/ro/fiismart/chat/service/GeminiChatService.java`)
- AI chat → Chat sessions: persists sessions (evidence: `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 (evidence: `src/main/java/ro/fiismart/review/service/ReviewService.java`)
- Course reviews → User data: resolves authors (evidence: `src/main/java/ro/fiismart/review/service/ReviewService.java`)
- Teacher → Teacher dashboard: views overview
- Administration → User data: manages accounts (evidence: `src/main/java/ro/fiismart/admin/service/AdminService.java`)
