Programming exercises: Enhance filtering and sorting for error analysis
#9315
Conversation
github-actions
bot
added
tests
server
WalkthroughThe changes in this pull request introduce a new feedback filtering feature within a programming exercise application. This includes the creation of two new Angular components: Changes
Possibly related PRs
Suggested labels
Suggested reviewers
Thank you for using CodeRabbit. We offer it for free to the OSS community and would appreciate your support in helping us grow. If you find it useful, would you consider giving us a shout-out on your favorite social media? 🪧 TipsChatThere are 3 ways to chat with CodeRabbit:
Note: Be mindful of the bot's finite context window. It's strongly recommended to break down tasks such as reading entire modules into smaller chunks. For a focused discussion, use review comments to chat about specific files and their changes, instead of using the PR comments. CodeRabbit Commands (Invoked using PR comments)
Other keywords and placeholders
Documentation and Community
|
…d-add-filtering-for-erroranalysis
![coderabbitai[bot]](https://avatars.githubusercontent.com/in/347564?s=60&v=4){kind=small}
There was a problem hiding this comment.
Actionable comments posted: 7
Review details
Configuration used: .coderabbit.yaml
Review profile: ASSERTIVE
Files selected for processing (15)
- src/main/java/de/tum/cit/aet/artemis/assessment/dto/FeedbackAnalysisResponseDTO.java (1 hunks)
- src/main/java/de/tum/cit/aet/artemis/assessment/service/ResultService.java (4 hunks)
- src/main/java/de/tum/cit/aet/artemis/assessment/web/ResultResource.java (2 hunks)
- src/main/webapp/app/exercises/programming/manage/grading/feedback-analysis/Modal/feedback-modal.component.html (1 hunks)
- src/main/webapp/app/exercises/programming/manage/grading/feedback-analysis/Modal/feedback-modal.component.scss (1 hunks)
- src/main/webapp/app/exercises/programming/manage/grading/feedback-analysis/Modal/feedback-modal.component.ts (1 hunks)
- src/main/webapp/app/exercises/programming/manage/grading/feedback-analysis/feedback-analysis.component.html (1 hunks)
- src/main/webapp/app/exercises/programming/manage/grading/feedback-analysis/feedback-analysis.component.scss (1 hunks)
- src/main/webapp/app/exercises/programming/manage/grading/feedback-analysis/feedback-analysis.component.ts (1 hunks)
- src/main/webapp/app/exercises/programming/manage/grading/feedback-analysis/feedback-analysis.service.ts (2 hunks)
- src/main/webapp/i18n/de/programmingExercise.json (1 hunks)
- src/main/webapp/i18n/en/programmingExercise.json (1 hunks)
- src/test/java/de/tum/cit/aet/artemis/assessment/ResultServiceIntegrationTest.java (5 hunks)
- src/test/javascript/spec/component/programming-exercise/feedback-analysis/feedback-analysis.component.spec.ts (2 hunks)
- src/test/javascript/spec/component/programming-exercise/feedback-analysis/feedback-analysis.service.spec.ts (3 hunks)
Additional context used
Path-based instructions (12)
src/main/java/de/tum/cit/aet/artemis/assessment/dto/FeedbackAnalysisResponseDTO.java (1)
Pattern
src/main/java/**/*.java: naming:CamelCase; principles:{single_responsibility,small_methods,no_duplication}; db:{perf_queries,datetime_not_timestamp}; rest:{stateless,singleton,delegate_logic,http_only,minimal_dtos}; dtos:{java_records,no_entities,min_data,single_resp}; di:constructor_injection; kiss:simple_code; file_handling:os_indep_paths; practices:{least_access,avoid_transactions,code_reuse,static_member_ref,prefer_primitives}; sql:{param_annotation,uppercase,avoid_subqueries};java:avoid_star_importssrc/main/webapp/app/exercises/programming/manage/grading/feedback-analysis/Modal/feedback-modal.component.ts (1)
src/main/webapp/app/exercises/programming/manage/grading/feedback-analysis/feedback-analysis.service.ts (1)
src/main/webapp/app/exercises/programming/manage/grading/feedback-analysis/Modal/feedback-modal.component.html (1)
Pattern
src/main/webapp/**/*.html: @if and @for are new and valid Angular syntax replacing *ngIf and *ngFor. They should always be used over the old style.src/test/javascript/spec/component/programming-exercise/feedback-analysis/feedback-analysis.service.spec.ts (1)
Pattern
src/test/javascript/spec/**/*.ts: jest: true; mock: NgMocks; bad_practices: avoid_full_module_import; perf_improvements: mock_irrelevant_deps; service_testing: mock_http_for_logic; no_schema: avoid_NO_ERRORS_SCHEMA; expectation_specificity: true; solutions: {boolean: toBeTrue/False, reference: toBe, existence: toBeNull/NotNull, undefined: toBeUndefined, class_obj: toContainEntries/toEqual, spy_calls: {not_called: not.toHaveBeenCalled, once: toHaveBeenCalledOnce, with_value: toHaveBeenCalledWith|toHaveBeenCalledExactlyOnceWith}}src/main/webapp/app/exercises/programming/manage/grading/feedback-analysis/feedback-analysis.component.ts (1)
src/main/webapp/app/exercises/programming/manage/grading/feedback-analysis/feedback-analysis.component.html (1)
Pattern
src/main/webapp/**/*.html: @if and @for are new and valid Angular syntax replacing *ngIf and *ngFor. They should always be used over the old style.src/test/javascript/spec/component/programming-exercise/feedback-analysis/feedback-analysis.component.spec.ts (1)
Pattern
src/test/javascript/spec/**/*.ts: jest: true; mock: NgMocks; bad_practices: avoid_full_module_import; perf_improvements: mock_irrelevant_deps; service_testing: mock_http_for_logic; no_schema: avoid_NO_ERRORS_SCHEMA; expectation_specificity: true; solutions: {boolean: toBeTrue/False, reference: toBe, existence: toBeNull/NotNull, undefined: toBeUndefined, class_obj: toContainEntries/toEqual, spy_calls: {not_called: not.toHaveBeenCalled, once: toHaveBeenCalledOnce, with_value: toHaveBeenCalledWith|toHaveBeenCalledExactlyOnceWith}}src/main/java/de/tum/cit/aet/artemis/assessment/web/ResultResource.java (1)
Pattern
src/main/java/**/*.java: naming:CamelCase; principles:{single_responsibility,small_methods,no_duplication}; db:{perf_queries,datetime_not_timestamp}; rest:{stateless,singleton,delegate_logic,http_only,minimal_dtos}; dtos:{java_records,no_entities,min_data,single_resp}; di:constructor_injection; kiss:simple_code; file_handling:os_indep_paths; practices:{least_access,avoid_transactions,code_reuse,static_member_ref,prefer_primitives}; sql:{param_annotation,uppercase,avoid_subqueries};java:avoid_star_importssrc/main/java/de/tum/cit/aet/artemis/assessment/service/ResultService.java (1)
Pattern
src/main/java/**/*.java: naming:CamelCase; principles:{single_responsibility,small_methods,no_duplication}; db:{perf_queries,datetime_not_timestamp}; rest:{stateless,singleton,delegate_logic,http_only,minimal_dtos}; dtos:{java_records,no_entities,min_data,single_resp}; di:constructor_injection; kiss:simple_code; file_handling:os_indep_paths; practices:{least_access,avoid_transactions,code_reuse,static_member_ref,prefer_primitives}; sql:{param_annotation,uppercase,avoid_subqueries};java:avoid_star_importssrc/test/java/de/tum/cit/aet/artemis/assessment/ResultServiceIntegrationTest.java (1)
Pattern
src/test/java/**/*.java: test_naming: descriptive; test_size: small_specific; fixed_data: true; junit5_features: true; assert_use: assertThat; assert_specificity: true; archunit_use: enforce_package_rules; db_query_count_tests: track_performance; util_service_factory_pattern: true; avoid_db_access: true; mock_strategy: static_mocks; context_restart_minimize: truesrc/main/webapp/i18n/de/programmingExercise.json (1)
Pattern
src/main/webapp/i18n/de/**/*.json: German language translations should be informal (dutzen) and should never be formal (sietzen). So the user should always be addressed with "du/dein" and never with "sie/ihr".
Biome
src/main/webapp/app/exercises/programming/manage/grading/feedback-analysis/feedback-analysis.service.ts
[error] 20-22: This constructor is unnecessary.
Unsafe fix: Remove the unnecessary constructor.
(lint/complexity/noUselessConstructor)
GitHub Check: client-tests-selected
src/test/javascript/spec/component/programming-exercise/feedback-analysis/feedback-analysis.service.spec.ts
[failure] 38-38:
Argument of type '{ page: number; pageSize: number; searchTerm: string; sortingOrder: string; sortedColumn: string; }' is not assignable to parameter of type 'SearchTermPageableSearch'.
GitHub Check: client-tests
src/test/javascript/spec/component/programming-exercise/feedback-analysis/feedback-analysis.service.spec.ts
[failure] 38-38:
Argument of type '{ page: number; pageSize: number; searchTerm: string; sortingOrder: string; sortedColumn: string; }' is not assignable to parameter of type 'SearchTermPageableSearch'.
Additional comments not posted (60)
src/main/webapp/app/exercises/programming/manage/grading/feedback-analysis/feedback-analysis.component.scss (3)
1-3: LGTM!The
.small-textclass is implemented correctly and follows best practices:
- The class name is semantic and describes its purpose.
- The font size is specified in a relative unit (rem), which is a good practice for responsive design.
5-7: LGTM!The
.position-relativeclass is implemented correctly and follows best practices:
- The class name is semantic and describes its purpose.
- Setting the position to relative allows for absolute positioning of child elements without affecting the layout of surrounding elements.
9-13: LGTM!The
.search-iconclass is implemented correctly and follows best practices:
- The class name is semantic and describes its purpose.
- Setting the position to absolute allows for precise placement of the icon within a relative container.
- Setting pointer-events to none ensures that the icon does not interfere with mouse events, allowing clicks to pass through to underlying elements.
src/main/java/de/tum/cit/aet/artemis/assessment/dto/FeedbackAnalysisResponseDTO.java (1)
1-9: LGTM!The
FeedbackAnalysisResponseDTOclass follows the best practices for defining DTOs:
- It is a Java record, which is a concise way to define immutable data classes.
- It has a single responsibility of representing the response of a feedback analysis operation.
- It uses the
@JsonIncludeannotation to exclude empty fields from JSON serialization, which helps in reducing the payload size.- It follows the naming convention of using the
DTOsuffix for data transfer objects.- It is in the appropriate package for DTOs.
- It does not have any methods, which is expected for a DTO.
- It does not have any dependencies on entities, which is a good practice for DTOs.
- It uses constructor injection, which is a recommended practice for dependency injection.
Great job!
src/main/webapp/app/exercises/programming/manage/grading/feedback-analysis/Modal/feedback-modal.component.scss (6)
1-3: LGTM!The
.modal-bodyclass correctly adds padding to the modal body. The implementation follows best practices.
5-7: LGTM!The
.modal-labelclass correctly makes the text bold. The implementation follows best practices.
9-15: LGTM!The
.borderclass correctly adds a border and padding to an element. The implementation follows best practices.
17-21: LGTM!The
.modal-headerclass correctly removes the bottom border and adds padding to the modal header. The implementation follows best practices.
23-25: LGTM!The
.modal-body pclass correctly removes the bottom margin from paragraphs inside the modal body. The implementation follows best practices.
27-29: LGTM!The
.modal-footerclass correctly removes the top border from the modal footer. The implementation follows best practices.src/main/webapp/app/exercises/programming/manage/grading/feedback-analysis/Modal/feedback-modal.component.ts (1)
6-17: LGTM!The
FeedbackModalComponentfollows the Angular style guide and best practices:
- The component is correctly defined using the
Componentdecorator with the appropriate metadata.- The component is marked as standalone, which aligns with the Angular best practices for code reuse and modularity.
- The component imports and uses the
NgbActiveModalservice to manage the modal's active state.- The component defines the input property
feedbackDetailwith the appropriate type.- The component constructor correctly injects the
NgbActiveModalservice.The implementation looks good and adheres to the Angular coding standards.
src/main/webapp/app/exercises/programming/manage/grading/feedback-analysis/feedback-analysis.service.ts (2)
5-8: LGTM!The new
FeedbackAnalysisResponseinterface provides a clear structure for the response from the feedback analysis service. UsingSearchResultforfeedbackDetailsindicates that the results will be paginated, which is a good practice for handling large datasets. ThetotalItemsproperty is also useful for displaying the total count of feedback details.
24-26: LGTM!The new
searchmethod in theFeedbackAnalysisServiceclass is well-designed and follows the best practices:
- The method signature is clear and follows the naming conventions.
- Using a POST request allows for more complex queries and better handling of large datasets compared to a GET request.
- The method returns a promise of
FeedbackAnalysisResponse, which provides a structured response format.Great job!
src/main/webapp/app/exercises/programming/manage/grading/feedback-analysis/Modal/feedback-modal.component.html (2)
1-3: LGTM!The modal header is well-structured and uses the
jhiTranslatedirective correctly for the title, following the localization best practices.
5-22: Great usage of flex layout and Angular directives!The flex layout enhances the readability and visual separation of the feedback details. The
jhiTranslatedirective is used correctly for translating the labels, and the interpolation syntax is used correctly to display the dynamic feedback details.src/test/javascript/spec/component/programming-exercise/feedback-analysis/feedback-analysis.service.spec.ts (3)
3-3: LGTM!The import statement is correct and necessary for using the
FeedbackAnalysisResponseandFeedbackDetailinterfaces in the test file.
14-17: LGTM!The
feedbackResponseMockobject is correctly defined and matches the structure ofFeedbackAnalysisResponseinterface. It will be used to test thesearchmethod of the service.
38-45: LGTM!The test case is correctly defined and tests the
searchmethod of the service. The expectations are correctly defined and match thefeedbackResponseMockobject.Tools
GitHub Check: client-tests-selected
[failure] 38-38:
Argument of type '{ page: number; pageSize: number; searchTerm: string; sortingOrder: string; sortedColumn: string; }' is not assignable to parameter of type 'SearchTermPageableSearch'.GitHub Check: client-tests
[failure] 38-38:
Argument of type '{ page: number; pageSize: number; searchTerm: string; sortingOrder: string; sortedColumn: string; }' is not assignable to parameter of type 'SearchTermPageableSearch'.src/main/webapp/app/exercises/programming/manage/grading/feedback-analysis/feedback-analysis.component.ts (8)
1-8: LGTM!The import statements are well-organized and follow the Angular style guide. They import the necessary modules and components required for the
FeedbackAnalysisComponent.
13-16: LGTM!The
@Componentdecorator is correctly configured for theFeedbackAnalysisComponent. It follows the Angular style guide and sets the necessary properties for a standalone component. The imported module and provided service are appropriate for the component's functionality.
19-20: LGTM!The input signals
exerciseTitleandexerciseIdare correctly declared using theInputSignaltype and marked as required. This ensures that the component receives the necessary input data for its functionality. The naming of the input signals follows the camelCase convention, adhering to the Angular style guide.
22-30: LGTM!The signals and computed property are correctly declared and initialized with appropriate default values. The naming of the signals and computed property follows the camelCase convention, adhering to the Angular style guide. The types of the signals are correctly specified, ensuring type safety. The
collectionsSizecomputed property provides a convenient way to calculate the total number of items based on the current state ofcontentandpageSize.
32-34: LGTM!The injected services
feedbackAnalysisService,alertService, andmodalServiceare correctly declared as private properties using theinjectfunction. This ensures that the services are properly injected and available for use within the component. The naming of the properties follows the camelCase convention, adhering to the Angular style guide.
36-41: LGTM!The font awesome icon constants
faSort,faSortUp,faSortDown,faMagnifyingGlass, andfaMagnifyingGlassPlusare correctly declared as readonly properties. This ensures that their values cannot be modified after initialization. The naming of the icon constants follows the camelCase convention, adhering to the Angular style guide. Declaring the icon constants as readonly properties improves code readability and maintainability. TheSortingOrderenum is also correctly declared as a readonly property.
43-47: LGTM!The constructor correctly sets up an
effectthat calls theloadDatamethod whenever the component's state changes. This ensures that the component's data is loaded and updated based on the current state of the signals. Theeffectis a clean and reactive way to handle data loading in the component.
67-90: LGTM!The
setPage,setSortedColumn, andsearchmethods correctly update the respective signals based on the provided input and trigger theloadDatamethod to fetch the updated data. This ensures that the component's state is properly updated and the data is refreshed when the pagination, sorting, or search parameters change.The
openFeedbackModalmethod appropriately opens theFeedbackModalComponentusing theNgbModalservice and passes thefeedbackDetailto the modal instance. This allows the user to view the detailed feedback information in a modal dialogsrc/main/webapp/app/exercises/programming/manage/grading/feedback-analysis/feedback-analysis.component.html (5)
1-12: Great use ofng-templateand structural directives!The introduction of the
headerTemplateusingng-templateand structural directives aligns with Angular best practices. It improves code modularity and reusability by creating a dynamic and reusable header structure.The clickable headers with sorting icons enhance the user experience by allowing users to sort the table based on different columns.
Overall, the code segment is well-structured and follows Angular coding conventions.
15-15: Improved title accuracy.Updating the title to use the
exerciseTitle()function instead of directly accessing the variable ensures that the title always reflects the current exercise title accurately.This change improves the reliability and correctness of the displayed title.
17-20: Enhanced interactivity with search functionality.The addition of the search input field bound to the
searchTermvariable and triggering the search function on input changes enhances the interactivity and usability of the component.Users can now filter feedback in real-time based on their search terms, improving the overall user experience.
The code segment follows Angular best practices for two-way data binding and event handling.
25-42: Improved maintainability with reusable header template.Modifying the table structure to utilize the
headerTemplatefor defining columns improves maintainability and readability by centralizing the header structure in a reusable template.The use of the
*ngTemplateOutletdirective allows for dynamic rendering of the header template with different context values, enabling flexibility in defining column-specific properties.The code segment follows Angular best practices for template composition and reusability.
46-59: Improved data management and visual presentation.Iterating the feedback details from
content().resultsOnPageinstead offeedbackDetailsindicates a shift in how data is sourced for display, potentially improving data management and consistency.Truncating long feedback detail texts to 100 characters, followed by an ellipsis, enhances the visual presentation and readability of the table while indicating the presence of additional content.
The code segment follows Angular best practices for data binding and conditional rendering.
src/test/javascript/spec/component/programming-exercise/feedback-analysis/feedback-analysis.component.spec.ts (13)
6-9: LGTM!The imports are necessary for the test suite and follow the best practices.
15-15: LGTM!The variable declaration is necessary for the test suite and follows the best practices.
22-25: LGTM!The constant declaration is necessary for the test suite and follows the best practices.
42-43: LGTM!The spy setup is necessary for the test suite and follows the best practices.
44-45: LGTM!The assignments are necessary for the test suite and follow the best practices.
47-47: LGTM!The method call is necessary for the test suite and follows the best practices.
50-52: LGTM!The
afterEachblock is necessary for the test suite and follows the best practices.
54-59: LGTM!The test case is necessary for the test suite and follows the best practices.
63-80: LGTM!The test cases are necessary for the test suite and follow the best practices.
83-91: LGTM!The test case is necessary for the test suite and follows the best practices.
93-106: LGTM!The test case is necessary for the test suite and follows the best practices.
108-117: LGTM!The test case is necessary for the test suite and follows the best practices.
119-129: LGTM!The test case is necessary for the test suite and follows the best practices.
src/main/java/de/tum/cit/aet/artemis/assessment/web/ResultResource.java (3)
30-30: LGTM!The import statement for
FeedbackAnalysisResponseDTOis necessary and correctly added.
36-36: LGTM!The import statement for
SearchTermPageableSearchDTOis necessary and correctly added.
284-299: Excellent work on implementing the new endpoint!The
getFeedbackDetailsPagedendpoint follows the best practices and is implemented correctly:
- It uses the appropriate HTTP method (
POST) and URL (/exercises/{exerciseId}/feedback-details-paged).- It is properly annotated with
@PostMappingand@EnforceAtLeastEditorInExerciseto ensure that only users with editor role can access it.- It accepts
exerciseIdandSearchTermPageableSearchDTOas parameters to support pagination and filtering of feedback details.- It delegates the business logic to
resultService.getFeedbackDetailsOnPagemethod, which is a good practice.- It returns an appropriate response type
FeedbackAnalysisResponseDTOwrapped in aResponseEntity.Great job!
src/main/java/de/tum/cit/aet/artemis/assessment/service/ResultService.java (2)
556-594: The method implementation looks good and aligns with the provided context.The
getFeedbackDetailsOnPagemethod correctly implements the requirements mentioned in the AI-generated summary. It supports pagination, filtering, and sorting of aggregated feedback details. The method also calculates relative counts and assigns task numbers based on the associated test case names.
556-594: The method changes are consistent with the provided list of alterations.The list of alterations mentions that the method
findAggregatedFeedbackByExerciseIdhas been modified and renamed togetFeedbackDetailsOnPagein theResultServiceclass. It also mentions the change in the method signature to accept aSearchTermPageableSearchDTOparameter.The reviewed code confirms these changes. The method has been renamed and now accepts the
SearchTermPageableSearchDTOparameter to support pagination, filtering, and sorting.src/test/java/de/tum/cit/aet/artemis/assessment/ResultServiceIntegrationTest.java (8)
34-34: LGTM!The import statement for
FeedbackAnalysisResponseDTOis correct.
41-42: LGTM!The import statements for
SortingOrderandSearchTermPageableSearchDTOare correct.
746-750: LGTM!The code correctly creates and configures a
SearchTermPageableSearchDTOobject for performing a paginated search with sorting. The chosen property values are reasonable for testing purposes.
752-762: LGTM!The code correctly sends a POST request to the feedback details endpoint with the appropriate request body and expected response type. The assertions verify that the response contains the expected feedback details with the correct property values.
763-763: LGTM!The assertion correctly verifies that the total number of feedback items in the response is 1, which is consistent with the test setup.
Line range hint
770-794: LGTM!The code correctly sets up a test scenario with multiple student participations, results, and feedback objects. The feedback objects have different detail texts to test the handling of multiple unique feedback items. The setup is suitable for testing the feedback analysis functionality.
Line range hint
795-824: LGTM!The code correctly configures the
SearchTermPageableSearchDTOobject for sorting and pagination. The assertions verify that the response contains the expected number of feedback details with the correct property values. The code properly handles the case of multiple unique feedback items and verifies their properties.
832-843: LGTM!The code correctly configures the
SearchTermPageableSearchDTOobject for sorting and pagination. The assertions verify that the response contains no feedback details and the total number of items is 0 when there are no participations. The code properly handles the case when there are no participations and verifies the expected response.src/main/webapp/i18n/en/programmingExercise.json (1)
334-338: LGTM!The addition of the
feedbackModalobject withheaderandfeedbackTitleproperties enhances the user experience by providing clearer context and organization for error messages related to test case feedback. The property names and values use clear and concise language. This change aligns well with the motivation to improve the quality of feedback given to students.src/main/webapp/i18n/de/programmingExercise.json (2)
332-332: LGTM!The German translation for the error message is accurate.
333-336: Sieht gut aus!Die deutschen Übersetzungen für den Feedback-Modal sind korrekt und verwenden wie gefordert informelles Deutsch. Die Änderungen stimmen mit der KI-generierten Zusammenfassung überein.
...bapp/app/exercises/programming/manage/grading/feedback-analysis/feedback-analysis.service.ts
Outdated
Show resolved
Hide resolved
...p/exercises/programming/manage/grading/feedback-analysis/Modal/feedback-modal.component.html
Outdated
Show resolved
Hide resolved
...p/exercises/programming/manage/grading/feedback-analysis/Modal/feedback-modal.component.html
Outdated
Show resolved
Hide resolved
...ript/spec/component/programming-exercise/feedback-analysis/feedback-analysis.service.spec.ts
Outdated
Show resolved
Hide resolved
...pp/app/exercises/programming/manage/grading/feedback-analysis/feedback-analysis.component.ts
Outdated
Show resolved
Hide resolved
...pt/spec/component/programming-exercise/feedback-analysis/feedback-analysis.component.spec.ts
Show resolved
Hide resolved
src/main/java/de/tum/cit/aet/artemis/assessment/service/ResultService.java
Outdated
Show resolved
Hide resolved
…d-add-filtering-for-erroranalysis
There was a problem hiding this comment.
Actionable comments posted: 2
Review details
Configuration used: .coderabbit.yaml
Review profile: ASSERTIVE
Files selected for processing (8)
- src/main/java/de/tum/cit/aet/artemis/assessment/service/ResultService.java (4 hunks)
- src/main/java/de/tum/cit/aet/artemis/assessment/web/ResultResource.java (2 hunks)
- src/main/webapp/app/exercises/programming/manage/grading/feedback-analysis/Modal/feedback-modal.component.html (1 hunks)
- src/main/webapp/app/exercises/programming/manage/grading/feedback-analysis/feedback-analysis.service.ts (2 hunks)
- src/main/webapp/i18n/de/programmingExercise.json (1 hunks)
- src/main/webapp/i18n/en/programmingExercise.json (1 hunks)
- src/test/javascript/spec/component/programming-exercise/feedback-analysis/feedback-analysis.component.spec.ts (2 hunks)
- src/test/javascript/spec/component/programming-exercise/feedback-analysis/feedback-analysis.service.spec.ts (3 hunks)
Additional context used
Path-based instructions (7)
src/main/webapp/app/exercises/programming/manage/grading/feedback-analysis/feedback-analysis.service.ts (1)
src/main/webapp/app/exercises/programming/manage/grading/feedback-analysis/Modal/feedback-modal.component.html (1)
Pattern
src/main/webapp/**/*.html: @if and @for are new and valid Angular syntax replacing *ngIf and *ngFor. They should always be used over the old style.src/test/javascript/spec/component/programming-exercise/feedback-analysis/feedback-analysis.service.spec.ts (1)
Pattern
src/test/javascript/spec/**/*.ts: jest: true; mock: NgMocks; bad_practices: avoid_full_module_import; perf_improvements: mock_irrelevant_deps; service_testing: mock_http_for_logic; no_schema: avoid_NO_ERRORS_SCHEMA; expectation_specificity: true; solutions: {boolean: toBeTrue/False, reference: toBe, existence: toBeNull/NotNull, undefined: toBeUndefined, class_obj: toContainEntries/toEqual, spy_calls: {not_called: not.toHaveBeenCalled, once: toHaveBeenCalledOnce, with_value: toHaveBeenCalledWith|toHaveBeenCalledExactlyOnceWith}}src/test/javascript/spec/component/programming-exercise/feedback-analysis/feedback-analysis.component.spec.ts (1)
Pattern
src/test/javascript/spec/**/*.ts: jest: true; mock: NgMocks; bad_practices: avoid_full_module_import; perf_improvements: mock_irrelevant_deps; service_testing: mock_http_for_logic; no_schema: avoid_NO_ERRORS_SCHEMA; expectation_specificity: true; solutions: {boolean: toBeTrue/False, reference: toBe, existence: toBeNull/NotNull, undefined: toBeUndefined, class_obj: toContainEntries/toEqual, spy_calls: {not_called: not.toHaveBeenCalled, once: toHaveBeenCalledOnce, with_value: toHaveBeenCalledWith|toHaveBeenCalledExactlyOnceWith}}src/main/java/de/tum/cit/aet/artemis/assessment/web/ResultResource.java (1)
Pattern
src/main/java/**/*.java: naming:CamelCase; principles:{single_responsibility,small_methods,no_duplication}; db:{perf_queries,datetime_not_timestamp}; rest:{stateless,singleton,delegate_logic,http_only,minimal_dtos}; dtos:{java_records,no_entities,min_data,single_resp}; di:constructor_injection; kiss:simple_code; file_handling:os_indep_paths; practices:{least_access,avoid_transactions,code_reuse,static_member_ref,prefer_primitives}; sql:{param_annotation,uppercase,avoid_subqueries};java:avoid_star_importssrc/main/java/de/tum/cit/aet/artemis/assessment/service/ResultService.java (1)
Pattern
src/main/java/**/*.java: naming:CamelCase; principles:{single_responsibility,small_methods,no_duplication}; db:{perf_queries,datetime_not_timestamp}; rest:{stateless,singleton,delegate_logic,http_only,minimal_dtos}; dtos:{java_records,no_entities,min_data,single_resp}; di:constructor_injection; kiss:simple_code; file_handling:os_indep_paths; practices:{least_access,avoid_transactions,code_reuse,static_member_ref,prefer_primitives}; sql:{param_annotation,uppercase,avoid_subqueries};java:avoid_star_importssrc/main/webapp/i18n/de/programmingExercise.json (1)
Pattern
src/main/webapp/i18n/de/**/*.json: German language translations should be informal (dutzen) and should never be formal (sietzen). So the user should always be addressed with "du/dein" and never with "sie/ihr".
Biome
src/main/webapp/app/exercises/programming/manage/grading/feedback-analysis/feedback-analysis.service.ts
[error] 20-22: This constructor is unnecessary.
Unsafe fix: Remove the unnecessary constructor.
(lint/complexity/noUselessConstructor)
Additional comments not posted (27)
src/main/webapp/app/exercises/programming/manage/grading/feedback-analysis/feedback-analysis.service.ts (4)
5-8: LGTM!The new
FeedbackAnalysisResponseinterface provides a clear structure for the response returned by the service. It improves the clarity and organization of the data. The interface name and property names follow the naming conventions.
24-25: LGTM!The new
searchmethod in theFeedbackAnalysisServiceclass allows for better handling of large datasets and potentially more intricate search criteria. The method name and parameter names follow the naming conventions. The method returns a promise of typeFeedbackAnalysisResponse, which is the new interface defined earlier.
2-2: LGTM!The import statement for
SearchResultandSearchTermPageableSearchis necessary for using these types in the file.
20-22: Remove the unnecessary constructor.The constructor in the
FeedbackAnalysisServiceclass is unnecessary as it only calls the superclass constructor without any additional logic. Please remove the constructor to simplify the code.Apply this diff to remove the constructor:
@Injectable() export class FeedbackAnalysisService extends BaseApiHttpService { - constructor() { - super(); - } search(pageable: SearchTermPageableSearch, options: { exerciseId: number }): Promise<FeedbackAnalysisResponse> { return this.post<FeedbackAnalysisResponse>(`exercises/${options.exerciseId}/feedback-details-paged`, pageable); } }Tools
Biome
[error] 20-22: This constructor is unnecessary.
Unsafe fix: Remove the unnecessary constructor.
(lint/complexity/noUselessConstructor)
src/main/webapp/app/exercises/programming/manage/grading/feedback-analysis/Modal/feedback-modal.component.html (3)
1-34: LGTM!The modal dialog is well-structured and follows best practices. The use of
jhiTranslatedirective for localization is consistent with the rest of the application.
28-33: Translate the button text.To maintain consistency with the rest of the modal and follow the localization best practices, consider translating the button text using the
jhiTranslatedirective.- <button - type="button" - class="btn btn-outline-primary" - jhiTranslate="artemisApp.programmingExercise.configureGrading.feedbackAnalysis.feedbackModal.ok" - (click)="activeModal.close('Close click')" - ></button> + <button + type="button" + class="btn btn-outline-primary" + (click)="activeModal.close('Close click')" + jhiTranslate="artemisApp.programmingExercise.configureGrading.feedbackAnalysis.feedbackModal.closeButton" + ></button>
20-20: Consider using a dynamic value for the error category.If the error category information is available in the
feedbackDetailobject, consider using a dynamic value instead of hardcoding it as "Student Error".- <p>Student Error</p> + <p>{{ feedbackDetail.errorCategory }}</p>src/test/javascript/spec/component/programming-exercise/feedback-analysis/feedback-analysis.service.spec.ts (3)
3-4: LGTM!The import changes are consistent with the list of alterations and are necessary for the updated test suite.
15-19: LGTM!The
feedbackResponseMockobject is consistent with the list of alterations and is necessary for testing the updatedsearchmethod.
34-54: LGTM!The
searchtest case accurately tests the updatedsearchmethod with the following changes:
- Uses a
SearchTermPageableSearchobject for thepageableparameter.- Uses a POST request instead of a GET request.
- Expects a
FeedbackAnalysisResponseobject in the response.The test case is consistent with the list of alterations and correctly asserts the response.
src/test/javascript/spec/component/programming-exercise/feedback-analysis/feedback-analysis.component.spec.ts (13)
6-9: LGTM!The imports are correctly added and necessary for the test suite.
15-15: LGTM!The spy variable is correctly declared for mocking the service method in the tests.
22-25: LGTM!The mock response object is correctly defined for simulating the service response in the tests.
41-41: LGTM!The spy is correctly set up and the mock return value is correctly assigned for the
searchmethod ofFeedbackAnalysisService.
43-44: LGTM!The
exerciseIdandexerciseTitleproperties are correctly set using Angular'ssignalfor reactive state management.
46-46: LGTM!Triggering change detection is necessary to ensure the component updates correctly after setting the properties.
49-51: LGTM!Restoring mocks after each test is a good practice to ensure test isolation and avoid side effects.
53-59: LGTM!The test case correctly verifies that the service method is called, and the component state is updated with the mock data on initialization.
62-79: LGTM!The test cases correctly verify the behavior of the
loadDatamethod in both success and error scenarios, ensuring that the component state is updated correctly and errors are handled.
82-90: LGTM!The test case correctly verifies the behavior of the
setPagemethod, ensuring that the page is updated and the data is reloaded.
92-105: LGTM!The test case correctly verifies the behavior of the
setSortedColumnmethod, ensuring that thesortedColumnandsortingOrderproperties are updated correctly and the data is reloaded.
107-116: LGTM!The test case correctly verifies the behavior of the
searchmethod, ensuring that the page is reset and the data is loaded when searching.
118-128: LGTM!The test case correctly verifies the behavior of the
openFeedbackModalmethod, ensuring that the modal is opened with the correct feedback detail.src/main/java/de/tum/cit/aet/artemis/assessment/web/ResultResource.java (1)
284-299: LGTM!The
getFeedbackDetailsPagedfunction is well-designed and follows best practices:
- The function signature and Javadoc provide clear information about the purpose, parameters, and return type of the function.
- The function delegates the actual retrieval of feedback details to the service layer, keeping the controller layer thin.
- The function adheres to the REST API design principles by using appropriate HTTP methods and response codes.
- The function uses constructor injection for dependency injection.
- The function uses the
@EnforceAtLeastEditorInExerciseannotation for authorization checks.src/main/java/de/tum/cit/aet/artemis/assessment/service/ResultService.java (1)
556-571: ThegetFeedbackDetailsOnPagemethod implementation looks good!The method correctly retrieves paginated and filtered aggregated feedback details for a given exercise, with support for searching, sorting, and pagination. The code is well-structured and follows the specified requirements.
src/main/webapp/i18n/en/programmingExercise.json (1)
334-339: LGTM!The addition of the
feedbackModalobject enhances the structure and organization of error messages related to test case feedback. It provides clearer context and improves the user experience when encountering errors while loading feedback.src/main/webapp/i18n/de/programmingExercise.json (1)
333-337: Die Übersetzungen für das Feedback-Modal sehen gut aus!Die hinzugefügten Übersetzungen für Header, Titel und OK-Button des neuen Feedback-Modals sind angemessen formuliert, verwenden die informelle Ansprache und fügen sich gut in den bestehenden Übersetzungs-JSON ein.
src/main/java/de/tum/cit/aet/artemis/assessment/service/ResultService.java
Outdated
Show resolved
Hide resolved
src/main/java/de/tum/cit/aet/artemis/assessment/service/ResultService.java
Outdated
Show resolved
Hide resolved
src/main/java/de/tum/cit/aet/artemis/assessment/service/ResultService.java
Outdated
Show resolved
Hide resolved
...p/exercises/programming/manage/grading/feedback-analysis/Modal/feedback-modal.component.html
Outdated
Show resolved
Hide resolved
...app/exercises/programming/manage/grading/feedback-analysis/Modal/feedback-modal.component.ts
Outdated
Show resolved
Hide resolved
...app/exercises/programming/manage/grading/feedback-analysis/Modal/feedback-modal.component.ts
Outdated
Show resolved
Hide resolved
.../app/exercises/programming/manage/grading/feedback-analysis/feedback-analysis.component.html
Outdated
Show resolved
Hide resolved
...pt/spec/component/programming-exercise/feedback-analysis/feedback-analysis.component.spec.ts
Outdated
Show resolved
Hide resolved
...pt/spec/component/programming-exercise/feedback-analysis/feedback-analysis.component.spec.ts
Outdated
Show resolved
Hide resolved
...pt/spec/component/programming-exercise/feedback-analysis/feedback-analysis.component.spec.ts
Outdated
Show resolved
Hide resolved
...pt/spec/component/programming-exercise/feedback-analysis/feedback-analysis.component.spec.ts
Outdated
Show resolved
Hide resolved
...pt/spec/component/programming-exercise/feedback-analysis/feedback-analysis.component.spec.ts
Outdated
Show resolved
Hide resolved
…factor-and-add-filtering-for-erroranalysis' into feature/programming-exercises/refactor-and-add-filtering-for-erroranalysis
There was a problem hiding this comment.
Actionable comments posted: 1
Review details
Configuration used: .coderabbit.yaml
Review profile: ASSERTIVE
Files selected for processing (8)
- src/main/webapp/app/exercises/programming/manage/grading/feedback-analysis/Modal/feedback-modal.component.html (1 hunks)
- src/main/webapp/app/exercises/programming/manage/grading/feedback-analysis/Modal/feedback-modal.component.ts (1 hunks)
- src/main/webapp/app/exercises/programming/manage/grading/feedback-analysis/feedback-analysis.component.html (1 hunks)
- src/main/webapp/app/exercises/programming/manage/grading/feedback-analysis/feedback-analysis.component.ts (1 hunks)
- src/main/webapp/app/exercises/programming/manage/grading/feedback-analysis/feedback-analysis.service.ts (2 hunks)
- src/main/webapp/i18n/de/programmingExercise.json (1 hunks)
- src/main/webapp/i18n/en/programmingExercise.json (1 hunks)
- src/test/javascript/spec/component/programming-exercise/feedback-analysis/feedback-analysis.component.spec.ts (2 hunks)
Additional context used
Path-based instructions (7)
src/main/webapp/app/exercises/programming/manage/grading/feedback-analysis/Modal/feedback-modal.component.ts (1)
src/main/webapp/app/exercises/programming/manage/grading/feedback-analysis/feedback-analysis.service.ts (1)
src/main/webapp/app/exercises/programming/manage/grading/feedback-analysis/Modal/feedback-modal.component.html (1)
Pattern
src/main/webapp/**/*.html: @if and @for are new and valid Angular syntax replacing *ngIf and *ngFor. They should always be used over the old style.src/main/webapp/app/exercises/programming/manage/grading/feedback-analysis/feedback-analysis.component.html (1)
Pattern
src/main/webapp/**/*.html: @if and @for are new and valid Angular syntax replacing *ngIf and *ngFor. They should always be used over the old style.src/main/webapp/app/exercises/programming/manage/grading/feedback-analysis/feedback-analysis.component.ts (1)
src/test/javascript/spec/component/programming-exercise/feedback-analysis/feedback-analysis.component.spec.ts (1)
Pattern
src/test/javascript/spec/**/*.ts: jest: true; mock: NgMocks; bad_practices: avoid_full_module_import; perf_improvements: mock_irrelevant_deps; service_testing: mock_http_for_logic; no_schema: avoid_NO_ERRORS_SCHEMA; expectation_specificity: true; solutions: {boolean: toBeTrue/False, reference: toBe, existence: toBeNull/NotNull, undefined: toBeUndefined, class_obj: toContainEntries/toEqual, spy_calls: {not_called: not.toHaveBeenCalled, once: toHaveBeenCalledOnce, with_value: toHaveBeenCalledWith|toHaveBeenCalledExactlyOnceWith}}src/main/webapp/i18n/de/programmingExercise.json (1)
Pattern
src/main/webapp/i18n/de/**/*.json: German language translations should be informal (dutzen) and should never be formal (sietzen). So the user should always be addressed with "du/dein" and never with "sie/ihr".
Additional comments not posted (32)
src/main/webapp/app/exercises/programming/manage/grading/feedback-analysis/Modal/feedback-modal.component.ts (2)
1-5: LGTM!The import statements are correctly used, follow the Angular style guide, and adhere to the project's directory structure. The imports are also alphabetically ordered and the line lengths are within the acceptable limit.
6-12: LGTM!The component decorator is correctly used and follows the Angular style guide. The component selector prefix
jhiis consistently used across the project. The component template and styles are linked using relative paths, which is a good practice. The component importsArtemisSharedCommonModule, which is likely a shared module containing common dependencies. The component is also marked as standalone, which aligns with the Angular's standalone components feature.src/main/webapp/app/exercises/programming/manage/grading/feedback-analysis/feedback-analysis.service.ts (3)
5-8: LGTM!The
FeedbackAnalysisResponseinterface provides a clear and structured format for the response returned by the feedback analysis service. The use ofSearchResult<FeedbackDetail>for thefeedbackDetailsproperty indicates that the response will include paginated results, and thetotalItemsproperty is useful for handling pagination. This interface improves the clarity and organization of the data returned by the service.
20-21: LGTM!The
searchmethod in theFeedbackAnalysisServiceclass is a significant improvement over the previousgetFeedbackDetailsForExercisemethod. It allows for more complex querying and handling of large datasets through pagination by accepting aSearchTermPageableSearchobject and an options object containingexerciseId. The method performs a POST request to fetch paginated feedback details for a specific exercise and returns a promise of typeFeedbackAnalysisResponse, which provides a structured format for the response data. The method name accurately describes its functionality.
20-22: Remove the unnecessary constructor.The constructor in the
FeedbackAnalysisServiceclass is unnecessary as it only calls the superclass constructor without any additional logic. Please remove the constructor to simplify the code.Apply this diff to remove the constructor:
@Injectable({ providedIn: 'root' }) export class FeedbackAnalysisService extends BaseApiHttpService { - constructor() { - super(); - } search(pageable: SearchTermPageableSearch, options: { exerciseId: number }): Promise<FeedbackAnalysisResponse> { return this.post<FeedbackAnalysisResponse>(`exercises/${options.exerciseId}/feedback-details-paged`, pageable); } }src/main/webapp/app/exercises/programming/manage/grading/feedback-analysis/Modal/feedback-modal.component.html (2)
1-34: LGTM! The modal structure and translations are well-implemented.The modal follows the standard header, body, and footer layout, and the translations are correctly used for the header, labels, and button text. The feedback details are displayed using appropriate bindings to the
feedbackDetailobject.
20-20: Consider using a dynamic value for the error category.If the error category information is available in the
feedbackDetailobject, consider using a dynamic value instead of hardcoding it as "Student Error".src/main/webapp/app/exercises/programming/manage/grading/feedback-analysis/feedback-analysis.component.html (4)
1-8: LGTM!The new
headerTemplateis a great addition for creating a modular and reusable structure for table headers. It effectively leverages Angular's structural directives and allows for dynamic sorting capabilities, enhancing the user experience.
11-11: LGTM!Updating the title to utilize the
exerciseTitle()function is a great change. It ensures that the displayed title always reflects the most current exercise title, enhancing the accuracy and dynamism of the interface.
13-23: Address the localization of the placeholder text.The addition of the search input field is a great feature for improving the component's interactivity and usability. Binding the input to the
searchTermvariable and triggering a search function on changes is the correct approach.However, as mentioned in a previous review comment, the placeholder text should be localized using
artemisTranslatefor a better user experience.
28-45: LGTM!Revising the table structure to use the new
headerTemplatefor defining columns is an excellent change. It enhances the maintainability and readability of the code. The*ngTemplateOutletdirective is used correctly to apply the template to each column header, resulting in a more organized and readable structure.src/main/webapp/app/exercises/programming/manage/grading/feedback-analysis/feedback-analysis.component.ts (6)
1-8: LGTM!The import statements are well-structured, follow the Angular style guide, and include all the necessary dependencies for the component's functionality. The import paths are correct and point to the expected locations.
13-16: Component metadata looks good!The component is correctly configured as a standalone component, which aligns with Angular's best practices. The
ArtemisSharedCommonModuleis imported, promoting code reuse. TheFeedbackAnalysisServiceis provided, ensuring that the component has access to the necessary service for fetching feedback details.
19-20: Input properties are well-defined!The use of
InputSignalforexerciseTitleandexerciseIdaligns with Angular's reactive programming paradigm. Theinput.requiredensures that the component receives the necessary data. The types of the input properties are correctly specified asstringandnumber, providing type safety.
22-30: Signals and computed property are effectively used!The use of signals for managing the component's state, such as pagination, sorting, and search term, aligns with Angular's reactive programming principles. The naming of the signals is clear and descriptive, making the code more readable. The computed property
collectionsSizeis correctly derived fromcontentandpageSize, ensuring that it stays up to date with any changes in the dependent signals.
45-50: Constructor and effect are properly implemented!The use of
effectin the constructor aligns with Angular's reactive programming principles for handling side effects. Theeffectis triggered whenever the component's state changes, ensuring that the data is always up to date. Calling theloadDatamethod within theeffectis a good practice for fetching the feedback details based on the current state.
69-92: Methods for pagination, sorting, and opening the feedback modal are implemented correctly!The
setPage,setSortedColumn, andsearchmethods correctly update the respective signals based on the user's actions. Triggering theloadDatamethod after updating the signals ensures that the data is fetched with the updated state, keeping the component's data in sync with the user's actions.The
openFeedbackModalmethod properly opens theFeedbackModalComponentwith the selectedfeedbackDetail, allowing users to view the detailed feedback information in a modal.Overall, these methods enhance the user experience by providing pagination, sorting, and detailed feedback viewing capabilities.
src/test/javascript/spec/component/programming-exercise/feedback-analysis/feedback-analysis.component.spec.ts (12)
6-8: LGTM!The additional imports are necessary for the updated test suite and look good.
14-14: LGTM!The
searchSpyvariable declaration looks good and is used appropriately in the test suite.
21-25: LGTM!The
feedbackResponseMockconstant declaration looks good and is used appropriately in the test suite.
40-41: LGTM!The
searchSpysetup looks good and is used appropriately in the test suite.
42-44: LGTM!Setting the
exerciseIdandexerciseTitleinputs looks good and is necessary for the updated test suite.
48-50: LGTM!Restoring mocks in the
afterEachblock is a good practice and looks good.
52-59: LGTM!The test case for component initialization looks good and covers the necessary scenarios.
61-79: LGTM!The test cases for the
loadDatamethod look good and cover the necessary scenarios, including the error handling scenario.
81-89: LGTM!The test case for the
setPagemethod looks good and covers the necessary scenario.
91-104: LGTM!The test case for the
setSortedColumnmethod looks good and covers the necessary scenarios, including the toggling of thesortingOrder.
106-115: LGTM!The test case for the
searchmethod looks good and covers the necessary scenario.
117-127: LGTM!The test case for the
openFeedbackModalmethod looks good and covers the necessary scenario.src/main/webapp/i18n/en/programmingExercise.json (2)
335-335: LGTM!The
searchkey with the value "Search ..." looks good for a search placeholder.
336-340: The newfeedbackModalobject looks good!The
header,feedbackTitleandokkeys provide a clear structure for displaying error details about test case feedback in a modal. The chosen values are appropriate.src/main/webapp/i18n/de/programmingExercise.json (1)
332-338: LGTM!The newly added translation keys for the feedback analysis modal are clear and consistent:
feedbackModal.headercorrectly translates to "Fehler Details" (Error Details).feedbackModal.feedbackTitlecorrectly translates to "Testfall Feedback" (Test Case Feedback).feedbackModal.okis simply labeled "Ok".The informal tone (dutzen) is used appropriately. The translations adhere to the existing conventions in the file.
.../app/exercises/programming/manage/grading/feedback-analysis/feedback-analysis.component.html
Outdated
Show resolved
Hide resolved
…factor-and-add-filtering-for-erroranalysis' into feature/programming-exercises/refactor-and-add-filtering-for-erroranalysis
az108
dismissed stale reviews from krusche, Malekos74, raffifasaro, JohannesStoehr, pzdr7, JohannesWt, and coderabbitai[bot]
via
c9182c8
There was a problem hiding this comment.
Actionable comments posted: 2
🧹 Outside diff range and nitpick comments (2)
src/main/java/de/tum/cit/aet/artemis/assessment/service/ResultService.java (2)
545-570: Enhance method documentation for better clarity.The Javadoc is well-structured but could be improved in the following areas:
- Add
@throwsdocumentation for potential exceptions (NumberFormatException, BadRequestAlertException).- Clarify that task filtering is done by task numbers, not task names as currently documented.
/** * Retrieves paginated and filtered aggregated feedback details for a given exercise. * <br> * For each feedback detail: * 1. The relative count is calculated as a percentage of the total number of distinct results for the exercise. * 2. The task numbers are assigned based on the associated test case names. A mapping between test cases and tasks is created using the set of tasks retrieved from the * database. * <br> * Filtering: * - **Search term**: Filters feedback details by the search term (case-insensitive). * - **Test case names**: Filters feedback based on specific test case names (if provided). - * - **Task names**: Maps provided task numbers to task names and filters feedback based on the test cases associated with those tasks. + * - **Task numbers**: Maps provided task numbers (1-based indices) to task names and filters feedback based on the test cases associated with those tasks. * - **Occurrences**: Filters feedback where the number of occurrences (COUNT) is between the provided minimum and maximum values (inclusive). * <br> * Pagination and sorting: * - Sorting is applied based on the specified column and order (ascending or descending). * - The result is paginated based on the provided page number and page size. * * @param exerciseId The ID of the exercise for which feedback details should be retrieved. * @param data The {@link FeedbackPageableDTO} containing page number, page size, search term, sorting options, and filtering parameters (task names, test cases, * occurrence range). + * @throws NumberFormatException if the provided task numbers or occurrence range values are not valid numbers + * @throws BadRequestAlertException if the exercise is not found * @return A {@link FeedbackAnalysisResponseDTO} object containing: * - A {@link SearchResultPageDTO} of paginated feedback details. * - The total number of distinct results for the exercise. * - The total number of tasks associated with the feedback. * - A list of test case names included in the feedback. */
571-612: Consider splitting the feedback analysis logic into a separate service.The
getFeedbackDetailsOnPagemethod handles complex feedback analysis logic that could be better managed in a dedicated service. This would improve maintainability and follow the Single Responsibility Principle more closely.Consider creating a new
FeedbackAnalysisServicethat would:
- Handle all feedback analysis-related operations
- Encapsulate the filtering, mapping, and processing logic
- Make the code more testable and maintainable
Example structure:
@Service public class FeedbackAnalysisService { private final StudentParticipationRepository studentParticipationRepository; private final ProgrammingExerciseRepository programmingExerciseRepository; private final ProgrammingExerciseTaskService programmingExerciseTaskService; // Move the feedback analysis methods here public FeedbackAnalysisResponseDTO getFeedbackDetailsOnPage(long exerciseId, FeedbackPageableDTO data) { // Current implementation } public long getMaxCountForExercise(long exerciseId) { // Current implementation } // Extract helper methods private List<String> generateFilterTaskNames(List<String> taskIndices, List<ProgrammingExerciseTask> tasks) { // Task filtering logic } private List<FeedbackDetailDTO> processFeedbackDetails(Page<FeedbackDetailDTO> page, List<ProgrammingExerciseTask> tasks, long distinctResultCount) { // Feedback processing logic } }
📜 Review details
Configuration used: .coderabbit.yaml
Review profile: CHILL
📒 Files selected for processing (1)
- src/main/java/de/tum/cit/aet/artemis/assessment/service/ResultService.java (7 hunks)
🧰 Additional context used
📓 Path-based instructions (1)
src/main/java/de/tum/cit/aet/artemis/assessment/service/ResultService.java (1)
Pattern
src/main/java/**/*.java: naming:CamelCase; principles:{single_responsibility,small_methods,no_duplication}; db:{perf_queries,datetime_not_timestamp}; rest:{stateless,singleton,delegate_logic,http_only,minimal_dtos}; dtos:{java_records,no_entities,min_data,single_resp}; di:constructor_injection; kiss:simple_code; file_handling:os_indep_paths; practices:{least_access,avoid_transactions,code_reuse,static_member_ref,prefer_primitives}; sql:{param_annotation,uppercase,avoid_subqueries};java:avoid_star_imports
src/main/java/de/tum/cit/aet/artemis/assessment/service/ResultService.java
Show resolved
Hide resolved
src/main/java/de/tum/cit/aet/artemis/assessment/service/ResultService.java
Show resolved
Hide resolved
…d-add-filtering-for-erroranalysis
Cathy0123456789
temporarily deployed
to
artemis-test1.artemis.cit.tum.de
GitHub Actions
Inactive
krusche
deleted the
feature/programming-exercises/refactor-and-add-filtering-for-erroranalysis
branch
Checklist
General
Client
authoritiesto all new routes and checked the course groups for displaying navigation elements (links, buttons).Motivation and Context
Instructors should have clear insights into why specific tests are failing. Such insights facilitate a
deeper understanding of both internal errors and student mistakes, empowering instructors to rectify errors in exercises.
Having a deeper understanding of such errors leads to high-quality feedback, enabling students to identify faulty portions
of their code and understand why certain parts do not work as expected. As a result, a smoother and more intuitive workflow, enhancing the learning experience for both instructors and students. Creating an easy-to-access visualization of common mistakes made by students, organized by occurrence, helps instructors identify misunderstandings and refine their teaching methods.
Description
This is a follow-up to #9213, where filtering, sorting, and pagination were added to the table. Long feedback texts are now truncated, with an option to view the full details in a modal. You can sort the table by clicking on column headers (except task and error category), toggle between ascending and descending order, use the search bar to filter results, and navigate through pages using pagination. Additionally a filter modal was added which allows the instructor to filter according to task, testcase or set a specific occurrence.
Additionally, the code has been refactored to align with the latest Angular guidelines, now using signals.
This PR was tested on a Course with 1500 test students and no performance issues were found.
By using the BaseAPIService class we also ensure that while using the search functionality we do not directly send a request to the server but rather wait a short decay. This ensures that we do not overwhelm the server if we spam type.
Before:
After:
Steps for Testing
Prerequisites:
Testserver States
Note
These badges show the state of the test servers.
Green = Currently available, Red = Currently locked
Click on the badges to get to the test servers.
Review Progress
Performance Review
Code Review
Manual Tests
Test Coverage
Summary by CodeRabbit
Release Notes
New Features
Enhancements
Bug Fixes