Backend implementation for timeline page

[ildyria]

This pull request introduces a comprehensive implementation of a new "Timeline" feature for photo albums, including backend logic, API endpoints, and supporting structures. The changes span multiple files and focus on enabling granular timeline views, handling requests, and providing configuration options. Below is a summary of the most important changes grouped by theme:

Timeline Feature Implementation

• app/Actions/Photo/Timeline.php: Added a new Timeline class that provides methods to query photos by timeline granularity, count photos younger than a given date or photo, and retrieve distinct timeline dates. This class integrates with configurations and policies to apply filters and sorting.

• app/Http/Controllers/Gallery/TimelineController.php: Introduced a new controller to handle timeline-related API requests, including fetching photos, initializing the timeline, and retrieving timeline dates.

• app/Http/Requests/Timeline/IdOrDatedTimelineRequest.php and app/Http/Requests/Timeline/GetTimelineRequest.php: Added request validation classes to handle timeline-specific parameters such as photo IDs and dates, ensuring proper authorization and validation. [1] [2]

Timeline Granularity and Formatting

• app/Enum/TimelinePhotoGranularity.php and app/Enum/TimelineAlbumGranularity.php: Extended enums to include a format() method for returning ISO date formats based on granularity (e.g., year, month, day, hour). These changes support the dynamic formatting of timeline data. [1] [2]

• app/Exceptions/Internal/TimelineGranularityException.php: Added a custom exception to handle invalid timeline granularities, ensuring robust error handling for unsupported configurations.

Configuration and Initialization

• app/Http/Resources/GalleryConfigs/InitConfig.php: Updated the initialization resource to include timeline-specific configurations, such as the default homepage and whether the timeline page is enabled. [1] [2]

• app/Http/Resources/Timeline/InitResource.php: Added a new resource to initialize the timeline view, providing layout configurations and user rights.

Utility and Middleware Updates

• app/Http/Resources/Models/Utils/TimelineData.php: Enhanced the utility class to include methods for generating timeline data from dates and photos, supporting multiple granularities.

• app/Http/Middleware/ConfigIntegrity.php: Added new configuration keys for timeline quick access date formats, ensuring integrity checks for these settings.

Minor Enhancements

• app/Contracts/Http/Requests/RequestAttribute.php: Added a new constant DATE_ATTRIBUTE to standardize the handling of date attributes in requests.

• app/Http/Controllers/VueController.php: Introduced a new method viewNoArgs() for rendering the Vue app without arguments, likely for timeline-related views.

[codecov]

Codecov Report

Attention: Patch coverage is 69.32515% with 50 lines in your changes missing coverage. Please review.

Project coverage is 86.44%. Comparing base (75749e6) to head (08bf005).

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[ildyria]

Will need to be parked until refactoring of link between photos and albums, otherwise we are spammed by duplicates in the timeline...