nhcarrigan/library
9
0
Fork 0
generated from nhcarrigan/template
Code Issues Pull Requests 54 Actions Releases 3 Activity

[FEATURE] - Time Tracking #57

New Issue
Closed
opened 2026-02-19 16:42:50 -08:00 by naomi · 0 comments
naomi commented 2026-02-19 16:42:50 -08:00
Owner
Copy Link
Copy Source

Attestations

  • I have read and agree to the Code of Conduct
  • I have read and agree to the Community Guidelines.
  • I have confirmed that the issue I am opening is unique, and has not already been reported (whether closed or not).
  • I have reviewed the Security Policy and have determined that this is not a security vulnerability.
  • This is not a feature request or bug report that I am mis-filing to avoid the issue template.

Share your thoughts:

Add time tracking functionality to record how long was spent on each media item (reading a book, playing a game, watching a show, etc.).

Implementation Approach

Manual Time Entry

  • Add optional timeSpent field (stored in minutes or hours)
  • Allow users to manually input time when editing items
  • Support multiple time entries (session-based tracking)

Time Entry Options

  • Single Total: One field for total time spent (simplest)
  • Session-Based: Log multiple sessions with dates (more detailed)

Database Design

Option 1: Single Total Field

  • Add timeSpent (integer, minutes) to each media model
  • Simple to implement and display

Option 2: Session-Based Tracking

  • Create TimeSession table:
    • id, userId, entityType, entityId, duration, sessionDate, notes
  • Allows detailed tracking of individual sessions
  • Can calculate totals on demand

API Changes

  • Add timeSpent field to Create and Update DTOs
  • If session-based: Add endpoints for managing time sessions
    • POST /api/{type}/{id}/time - Log a time session
    • GET /api/{type}/{id}/time - Get time sessions for an item
    • PUT /api/{type}/{id}/time/{sessionId} - Update a session
    • DELETE /api/{type}/{id}/time/{sessionId} - Delete a session

Frontend Changes

Input Fields

  • Add time input to "Add New" and "Edit" forms
  • Support different time units (hours, minutes)
  • Calculate and display total time for session-based tracking

Display

  • Show time spent on item cards
  • Add time statistics to user profiles
  • Display time trends (time spent per month/year)
  • Show average time per media type

Time Entry UI

If session-based:

  • "Log Time" button on item cards
  • Modal/form with: date, duration, optional notes
  • Display session history per item
  • Edit/delete individual sessions

Statistics & Insights

  • Total time spent across all media
  • Time breakdown by media type
  • Most time spent on a single item
  • Average time per item
  • Time trends over months/years
  • Compare time spent vs items completed

Use Cases

  • Books: Track reading time, see how long books take
  • Games: Track play time (hours invested)
  • Shows: Calculate total watch time for series
  • Music: Track listening time for albums
  • Manga: Track reading sessions

UI Considerations

  • Format time display nicely (e.g., "15h 30m", "3 hours", "45 minutes")
  • Add time picker component (hours and minutes)
  • Show time statistics on profile pages
  • Optional: Add charts/graphs for time visualization

✨ This issue was created with help from Hikari~ 🌸

### Attestations - [x] I have read and agree to the [Code of Conduct](https://docs.nhcarrigan.com/community/coc/) - [x] I have read and agree to the [Community Guidelines](https://docs.nhcarrigan.com/community/guide/). - [x] I have confirmed that the issue I am opening is unique, and has not already been reported (whether closed or not). - [x] I have reviewed the [Security Policy](https://docs.nhcarrigan.com/legal/security/) and have determined that this is not a security vulnerability. - [x] This is not a feature request or bug report that I am mis-filing to avoid the issue template. ### Share your thoughts: Add time tracking functionality to record how long was spent on each media item (reading a book, playing a game, watching a show, etc.). ## Implementation Approach ### Manual Time Entry - Add optional `timeSpent` field (stored in minutes or hours) - Allow users to manually input time when editing items - Support multiple time entries (session-based tracking) ### Time Entry Options - **Single Total**: One field for total time spent (simplest) - **Session-Based**: Log multiple sessions with dates (more detailed) ## Database Design ### Option 1: Single Total Field - Add `timeSpent` (integer, minutes) to each media model - Simple to implement and display ### Option 2: Session-Based Tracking - Create `TimeSession` table: - `id`, `userId`, `entityType`, `entityId`, `duration`, `sessionDate`, `notes` - Allows detailed tracking of individual sessions - Can calculate totals on demand ## API Changes - Add `timeSpent` field to Create and Update DTOs - If session-based: Add endpoints for managing time sessions - `POST /api/{type}/{id}/time` - Log a time session - `GET /api/{type}/{id}/time` - Get time sessions for an item - `PUT /api/{type}/{id}/time/{sessionId}` - Update a session - `DELETE /api/{type}/{id}/time/{sessionId}` - Delete a session ## Frontend Changes ### Input Fields - Add time input to "Add New" and "Edit" forms - Support different time units (hours, minutes) - Calculate and display total time for session-based tracking ### Display - Show time spent on item cards - Add time statistics to user profiles - Display time trends (time spent per month/year) - Show average time per media type ### Time Entry UI If session-based: - "Log Time" button on item cards - Modal/form with: date, duration, optional notes - Display session history per item - Edit/delete individual sessions ## Statistics & Insights - Total time spent across all media - Time breakdown by media type - Most time spent on a single item - Average time per item - Time trends over months/years - Compare time spent vs items completed ## Use Cases - **Books**: Track reading time, see how long books take - **Games**: Track play time (hours invested) - **Shows**: Calculate total watch time for series - **Music**: Track listening time for albums - **Manga**: Track reading sessions ## UI Considerations - Format time display nicely (e.g., "15h 30m", "3 hours", "45 minutes") - Add time picker component (hours and minutes) - Show time statistics on profile pages - Optional: Add charts/graphs for time visualization ✨ This issue was created with help from Hikari~ 🌸
naomi closed this issue 2026-02-20 01:51:25 -08:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
aspect
code
Concerns the software code in the repository
aspect
dx
Concerns developers' experience with the codebase
aspect
interface
Concerns end-users' experience with the software
aspect
text
Concerns the documentation material in the repository
contribute
good first issue
A great opportunity for a team member to learn a new codebase
contribute
help wanted
Open for anyone on our team to grab.
contribute
staff only
Restricted to our executive leadership.
goal
addition
Addition of new feature
goal
fix
Bug fix
goal
improvement
Improvement to an existing feature
points
1
Very simple issue requiring minimal effort and complexity.
points
13
Extremely complex issue representing major undertakings. Should be broken down into smaller pieces.
points
2
Simple issue that requires a bit more thought or investigation.
points
3
Moderate complexity issue requiring more substantial work.
points
5
Complex issue requiring significant effort and expertise.
points
8
Very complex issue requiring extensive work and deep expertise.
priority
critical
1
Must be fixed ASAP
priority
high
2
Stalls work on the project or its dependents
priority
low
4
Low priority and doesn't need to be rushed
priority
medium
3
Not blocking but should be fixed soon
priority
none
5
No priority, should only be performed when a developer is available
status
awaiting triage
Has not been triaged & therefore, not ready for work
status
blocked
Blocked and therefore not ready for work
status
discarded
Will not be worked on
status
discontinued
Not suitable for work as repo is in maintenance
status
label work required
Needs proper labelling before it can be worked on
status
ready for dev
Ready for work
status
ticket work required
Needs more details before it can be worked on
talk
discussion
Open for discussions and feedback
talk
question
Can be resolved with an answer
time
1 day
Approximately one full day of development work.
time
1-2 weeks
One to two weeks of focused development effort.
time
2-3 days
Two to three days of development effort.
time
4-5 days
Approximately one week of development work.
time
<1 day
Less than one day of focused work. Quick fixes or simple tasks.
time
>2 weeks
More than two weeks of development work. Must be broken down into smaller pieces.
No Label
Milestone
No items
No Milestone
Assignees
Clear assignees
gurkirat hanna (Hanna Rose) hikari (Hikari) minori (Minori) naomi (Naomi Carrigan) rain teklu tim
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: nhcarrigan/library#57
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?