Overview:
This document details the enhanced feedback feature for task attachments in Agency Handy, now including file versioning and the ability to resolve comments. Users will be able to provide and manage feedback on images, PDFs, and videos, with the option for Super admin, Admin, and PM to mark comments as resolved. This update supports file versioning, ensuring feedback can be tracked across different iterations of a file.
User Stories:
As a user, I want to select specific sections of an image or PDF and leave comments, so my feedback is targeted and easy to understand. As a user, I want to pause a video and leave time-stamped comments, ensuring my feedback is precise. As a user, I want the ability to hide the timestamp in video comments for more general feedback. As a user, I want the video to automatically pause when I begin typing feedback to ensure accurate commenting. As a Super admin, Admin, or PM, I want to mark comments as resolved once the feedback has been addressed to streamline task management. As a user, I want to upload new versions of the same file and retain previous feedback, so that I can track changes and updates across different file iterations. As a user, I want to see which comments correspond to which file version to better understand the progression of feedback. Functional Requirements:
Images: JPG, PNG, GIF, etc. Versioning System: Users can upload multiple versions of a file (image, PDF, or video). Each version will have a version number (e.g., Version 1, Version 2). Feedback Retention: Feedback for previous versions will remain accessible. Version Display: Users can switch between file versions to view associated comments. Feedback Transfer: Users can copy feedback to a new version or start fresh with no comments on the new version. Feedback on Images and PDFs: File Upload: Users can upload images or PDFs to tasks. Section Selection: Users can select specific sections of the image or PDF for targeted feedback. A tool for drawing rectangles or predefined shapes over the document. Commenting: Users can attach comments to selected sections. Comment Display: Hovering over the commented section will display the comment. File Upload: Users can upload video files. Pause and Comment: Users can pause the video and add a time-stamped comment at the paused point. Hide Timestamp Option: Users can choose to hide the timestamp if the comment is not time specific. Automatic Pause While Typing: The video will automatically pause when the user begins typing. Resolve Comments: Super admin, Admin, and PM will have the ability to mark comments as resolved. Visibility: Resolved comments will remain visible but will be marked with a "Resolved" tag. Reopen Comments: Any resolved comment can be reopened if further action is needed. Notifications: The original commenter will receive a notification when their comment is resolved. (Notification text: ”Your comment was resolved”) allow user to upload a revised version of a specific file clearly define the history and versions while viewing a old file show that a newer version is available for preview show latest version details When a file is attached, a "Provide Feedback" button will appear, allowing users to initiate the feedback process. For PDFs and images, users will select a region before typing the comment. For videos, users will pause the video at the desired point and type their comment. All comments will be linked to specific file sections or video timestamps. comments can be edited by the commenter comments can be deleted by super admin, admin, commenter. all the comments will be version wise Only users who have access to the file can be mentioned in comment like if client review is off user can’t mention the client assignees who are not in the task can’t be mentioned etc. Feedback Display: All comments will be displayed alongside the file in a feedback panel. Hovering over or clicking on the comments will highlight the associated section of the image/PDF or jump to the video timestamp. Editable Comments: Users can edit or delete their feedback. Version Navigation: A dropdown will allow users to navigate between different file versions and view associated feedback. Comment Resolution Button: Super admin, Admin, and PM will see an option to mark comments as "Resolved" with a single click. Each file will have two mains status Needs Review (onclick send notification and email) Super admin, Admin, PM, and Clients will receive notifications when: Feedback is added.(check if it is team only) Notification text: "Feedback has been added in the file feedback section of [Task Name]." Subject: Feedback Added to [Task Name]
Body:
Dear [User Name],
Feedback has been added in the file feedback section of [Task Name].
Please review it at your earliest convenience.
[View Task Button]
Best regards,
[Company Name]
New file versions are uploaded. Notification Text: “A New File Version is uploaded on task [Task_Name]” Subject: New File Version Uploaded for [Task Name]
Body:
Dear [User Name],
A new version of the file has been uploaded for [Task Name].
Please review the updated version to ensure all changes are aligned.
[View File Button]
Best regards,
[Company Name]
Comments are marked as resolved. Notification Text: “Your feedback on the file feedback section of task [Task_name] has been resolved” Subject: Feedback Resolved for [Task Name]
Body:
Dear [User Name],
Your feedback in the file feedback section of [Task Name] has been marked as resolved.
If further updates are needed, feel free to respond.
[View Feedback Button]
Best regards,
[Company Name]
Notification Text: “[User Name] mentioned you in a comment in the file feedback section of task [Task Name].” Subject: You Were Mentioned in a Comment on [Task Name]
Body:
Dear [User Name],
[Mentioning User Name] has mentioned you in a comment in the file feedback section of [Task Name].
Click below to view and respond to the comment.
[View Comment Button]
Best regards,
[Company Name]
Status change (Needs review, Approved) Notification text: “An Item in the file feedback section of task [Task_name] needs revewed” “An Item in the file feedback section of task [Task_name] Has Been Apporved” Subject (Needs Review): Item Requires Your Review on [Task Name]
Body:
Dear [User Name],
An item in the file feedback section of [Task Name] needs your review.
Click below to view and provide your input.
[Review Now Button]
Subject (Approved): Item Approved on [Task Name]
Body:
Dear [User Name],
An item in the file feedback section of [Task Name] has been approved.
Thank you for your contribution.
[View Details Button]
Acceptance Criteria:
Users can select and comment on sections of images or PDFs. Comments will be attached to the selected section and visible on hover. Users can pause videos and add time-stamped comments. Users can hide the timestamp for general feedback. The video will pause automatically while typing. Users can upload multiple versions of a file, with each version tracked and accessible. Comments for each version are retained and viewable. Super admin, Admin, and PM can mark comments as resolved. Resolved comments are visible but clearly marked and can be reopened if needed. Users receive notifications for new feedback, file versions, and comment resolutions. Users can select and comment on sections of images or PDFs. Comments will be attached to the selected section and visible upon hover. Users can pause videos and add time-stamped comments. Users can hide the timestamp if desired. The video will pause automatically while typing feedback. Task attachments can include images, PDFs, and videos. Comment Visibility and Management: Comments are displayed in the feedback panel, and users can edit or delete their feedback.
Reference:
Use queue, frame.io, Marker.io, Miro, File stage
files:
Q: Who can click on Needs Changes, Approved?
SuperAdmin, Admin, Client, Team members who have can access and click on need changes SuperAdmin, Admin, Client can click approve Notification text “Changes requested for a file” Notification text “changes in file has been approved” Q: When agency clicks on these options, what will happen? If notification, provide notification text.
Q: When client clicks on these options, what will happen? If notification, provide notification text.
Q: who can resolve comments?
Client and SuperAdmin, Admin can resolve comments Q: Are comments version specific?
yes, the comments will be version specific. Q: Can a specific version be deleted? If so, will the comments be deleted as well for that version?
Yes, Only Superadmin and Admin, PM can delete a version. all the comments will be deleted as well Q: If version 1 is deleted will all the later versions be deleted?
no, only version 1 will be deleted Q: Need a list of module where file feedback will be provided.
our whole application. Wherever we allow to see files. This will become our default file Modules such as service, profile image should not have versioning and feedback. that’s why I asked for a list of modules. We will allow file feedback in attachment of tasks and orders Q: According to prd, only superadmin and admin can delete file versions, when deleting order, tasks we have delete all of those files and version, but tasks can be deleted by other roles. what should we do in this case? updated, Superadmin, admin, PM can delete a task, when a task is deleted, all related file will be deleted as well. in the case of client created task Superadmin, Admin, PM and client can delete task if the task is deleted all files in that tasks will be deleted as well
AgencyHandy
V1 File Feedback
