This commit introduces a "More options" dropdown menu for each teacher and student listed in the class details screen.
The menu currently provides placeholder options for "Remove from class" and "Manage enrollments."
Key changes: - An `IconButton` with a `MoreVert` icon is added as the trailing content for each user `ListItem`. - A `DropdownMenu` is implemented to show actions when the icon is clicked. - User display names now use the `fullName()` extension function for consistency. - New string resources for the menu items (`remove_from_class`, `manage_enrollments`) have been added.
refactor: Extract Person list item with action menu
This commit introduces a new `PersonListItemWithMenu` composable to encapsulate the display of a person in a list, including their avatar, name, and an action menu.
This commit updates the Android Gradle Plugin version from 8.12.3 to 8.13.0.
Additionally, it introduces the foundational components for enrollment management: - Adds placeholder screens for `EnrollmentList` and `EnrollmentEdit`. - Creates the corresponding `EnrollmentListViewModel` and `EnrollmentEditViewModel`. - Defines new navigation routes (`EnrollmentList`, `EnrollmentEdit`). - Registers the new ViewModels for dependency injection.
feat: Navigate to enrollment list from class details
This commit introduces the ability to navigate from the class details screen to a new enrollment list screen for a specific person.
When a user clicks the "Manage enrollments" option in the user action menu, they are now navigated to a view showing all enrollments for that person within the current class.
Key changes: - Added `EnrollmentListScreen` to display a person's enrollments. - Implemented `EnrollmentListViewModel` to fetch and provide enrollment data. - Updated `ClazzDetailViewModel` to handle the navigation to `EnrollmentList`, passing the person's details and class title. - The `EnrollmentList` navigation route now accepts `personGuid`, `personName`, `role`, and `clazzTitle` to construct the new screen. - Added new string resources for the enrollment list title.
This commit introduces a "More options" dropdown menu for each item in the enrollment list screen, providing placeholder actions for "Edit" and "Delete."
Additionally, it refactors the hardcoded "More options" content description in the class details screen to use a string resource for better localization and consistency.
Key changes: - Added an `IconButton` with a `MoreVert` icon as the `trailingContent` for each `ListItem` in `EnrollmentListScreen`. - Implemented a `DropdownMenu` with "Edit" and "Delete" options. - Added new string resources for `edit` and `delete`. - Updated `ClazzDetailScreen` to use the `more_options` string resource for the menu's content description.
refactor: Simplify navigation to EnrollmentList screen
This commit refactors the navigation from the class details screen to the enrollment list screen. It simplifies the `EnrollmentList` route parameters by removing `personName` and `clazzTitle`, replacing the latter with `clazzGuid`.
Key changes: - Updated the `EnrollmentList` navigation route to use `clazzGuid` instead of `clazzTitle` and removed the redundant `personName`. - Modified `ClazzDetailViewModel` to pass `person.guid`, `role.name`, and `route.guid` (class GUID) when navigating. - Removed the local `clazzTitle` property from `ClazzDetailViewModel`. - Simplified `EnrollmentListViewModel` by removing the logic that constructed the app bar title and instead passing list parameters directly to the data source.
This commit introduces a new screen for creating and editing enrollments. It includes the `EnrollmentEditScreen` composable, its corresponding `EnrollmentEditViewModel`, and the necessary navigation setup.
The `EnrollmentEdit` screen displays basic enrollment information and includes a "Save" button in the action bar. The ViewModel is initialized to either load an existing enrollment by its UID or prepare a new enrollment based on the navigation parameters.
Key changes: - Created `EnrollmentEditScreen.kt` and its `EnrollmentEditViewModel`. - Added the `EnrollmentEdit` destination to `AppNavHost.kt`. - Updated the `EnrollmentEdit` navigation route in `AppRoutes.kt` to accept parameters (`uid`, `personGuid`, `role`, `clazzGuid`). - In `EnrollmentListScreen`, the "Edit" menu item now navigates to the new `EnrollmentEdit` screen. - Removed the redundant `roleLabel` parameter from the `PersonListItemWithMenu` composable, as it was unused.
feat: Implement field validation and state restoration in EnrollmentEdit screen
This commit introduces field validation and state restoration on the enrollment edit screen. When creating a new enrollment, the start and end dates are now validated as required fields before saving.
Additionally, the screen's state is now preserved and restored, for instance, after a screen rotation. This is achieved by debouncing entity changes and saving them to the `SavedStateHandle`.
Key changes: - Added `beginDateError` and `endDateError` with validation logic to `EnrollmentEditUiState`. - Implemented `onEntityChanged` in the `EnrollmentEditViewModel` to update the UI state and persist the `Enrollment` entity to the `SavedStateHandle` using a `LaunchDebouncer`. - Simplified the `EnrollmentEdit` navigation route to only require a `uid`. - Passed the `onEntityChanged` callback from the `EnrollmentEditViewModel` to the `EnrollmentEditScreen`.
feat: Implement enrollment start and end date editing
This commit builds out the `EnrollmentEditScreen` to allow editing the start and end dates of an enrollment.
The `EnrollmentEdit` navigation route has been updated to include `role`, `personGuid`, and `clazzGuid`. These parameters are now used to correctly initialize and save enrollment data. When a new enrollment is created, it now correctly pops back to the previous screen upon saving.
Key changes: - `EnrollmentEditScreen` now contains `RespectLocalDateField` inputs for `beginDate` and `endDate`. - The `EnrollmentEdit` route now requires `role`, `personGuid`, and `clazzGuid` parameters. - `EnrollmentListViewModel` now passes the required parameters when navigating to the edit screen. - `EnrollmentEditViewModel` correctly initializes new enrollments using the route parameters. - Successfully saving an enrollment now triggers a `NavCommand.PopUp()` to return to the prior screen.
refactor: Improve navigation after new enrollment creation
This commit refactors the navigation logic after creating a new enrollment. Instead of just popping the current screen, it now navigates to the `EnrollmentList` screen, replacing the `EnrollmentEdit` screen in the back stack. This ensures a more intuitive user flow when creating multiple enrollments.
For existing enrollments, the behavior remains the same, popping back to the previous screen upon saving.
Minor code formatting and cleanup have also been applied to `EnrollmentEditScreen.kt`, `AppKoinModule.kt`, and `EnrollmentEditViewModel.kt`.
fix: Improve DOB display and enrollment navigation
This commit introduces a few small fixes and improvements related to enrollment management and data display.
In the `ClazzDetailScreen`, the display for a person's date of birth (DOB) now correctly handles null values by showing a dash ("-") instead of crashing.
The `EnrollmentListViewModel` now sets the screen title based on the role from the navigation route.
Finally, the navigation logic in `EnrollmentEditViewModel` has been cleaned up, removing unnecessary parameters when creating a new enrollment, while preserving the pop-up behavior.
Key changes: - `ClazzDetailScreen` now displays "-" for a null date of birth. - `EnrollmentListViewModel` sets the screen title using the role from the route. - Simplified the `Navigate` command in `EnrollmentEditViewModel` for new enrollments.
This commit introduces date formatting on the enrollment list screen, changing the display from the `yyyy-MM-dd` format to a localized `dd/MM/yyyy` format.
A new extension function, `toLocalizedDate`, has been created to handle the conversion. The `EnrollmentListViewModel` now provides an `onDateFormatted` function, which is called by the `EnrollmentListScreen` to display the formatted start and end dates for each enrollment.
Key changes: - Added `toLocalizedDate` string extension in `respect-lib-shared`. - Implemented `onDateFormatted` in `EnrollmentListViewModel` to wrap the new extension. - Updated `EnrollmentListScreen` to use the formatted begin and end dates in the `ListItem`.
refactor: Ensure only one enrollment item's menu can be expanded at a time
This commit refactors the state management for the dropdown menu in the `EnrollmentListScreen`.
Previously, a single boolean `expanded` state was shared across all list items, causing all menus to open simultaneously. This has been replaced with `expandedItemUid`, which stores the UID of the currently expanded item.
This change ensures that clicking the "More" icon on one list item only opens the menu for that specific item.
feat: Add validation for enrollment start and end dates
This commit introduces validation to ensure the start date of an enrollment is not later than the end date.
An error message will now be displayed on the `EnrollmentEditScreen` if the start date is set after the end date.
Key changes: - Added a new string resource `date_later` for the validation error message. - Updated `EnrollmentEditViewModel` to include logic that compares `beginDate` and `endDate`.
refactor: Conditionally display gender and DOB in ClazzDetailScreen
This commit refactors the `ClazzDetailScreen` to conditionally display a person's gender and date of birth (DOB) only if these values are not null or blank.
Previously, the labels for "Gender" and "Date of Birth" would always be shown, even if the corresponding data was missing, leading to awkward formatting like "Gender: , Date of Birth:".
The logic has been updated to build a list of details and then join them, ensuring that an item is only added to the display string if its value is present. This prevents empty data points from appearing in the UI.
feat: Display person and class names in EnrollmentEdit screen
This commit updates the `EnrollmentEditViewModel` to fetch and display the person's full name and the class's title.
Previously, the `init` block only configured the "Save" action bar button. Now, it asynchronously fetches the `Person` and `Clazz` entities using the `personGuid` and `clazzGuid` from the route. Although the fetched names (`personName` and `clazzName`) are stored in local variables, they are not yet used in the UI state. This change prepares the ViewModel for displaying more context on the enrollment editing screen.
refactor: Rename person management functions in ClazzDetail screen
This commit renames functions related to person management within the class detail screen for improved clarity and consistency.
The `onClickRemovePerson` and `onClickManagePerson` functions have been renamed to `onClickRemovePersonFromClass` and `onClickManageEnrollments` respectively. This change is reflected in the `ClazzDetailScreen`, `ClazzDetailContent`, and `ClazzDetailViewModel` to more accurately describe their actions.
Key changes: - Renamed `onClickRemovePerson` to `onClickRemovePersonFromClass` in the `ClazzDetailScreen` and `ClazzDetailViewModel`. - Renamed `onClickManagePerson` to `onClickManageEnrollments` in the `ClazzDetailScreen` and `ClazzDetailViewModel`. - Updated the call sites for these functions within the `ClazzDetailContent` composable. - The `onClickManageEnrollments` function now navigates to the `EnrollmentList` screen.
Adds the functionality to delete an enrollment record. This includes: - Adding `deleteEnrollment` functions to the `EnrollmentDataSource` interface and its various implementations (HTTP, DB, repository). - Implementing the database deletion logic in `EnrollmentEntityDao` with a new SQL `DELETE` query. - Adding a `DELETE` request to the HTTP data source. - Queuing the deletion for remote write in the repository. - Calling the new `deleteEnrollment` function from the `EnrollmentListViewModel` and invalidating the paging source to refresh the list.
Make app route class use type Use locale based date formatting Use flow in detail screen so that local first data loads and displays immediately Use string resource on enrollments list to show role
