Objective:
Enable users to provide structured feedback on websites within Agency Handy, with robust version control for annotations and screenshots, ensuring accurate tracking of updates and revisions over time.
Business Need:
Streamline Feedback Processes: Providing clients and teams a structured way to give feedback on live websites reduces back-and-forth and misunderstandings, enabling faster resolution of issues. Enhance Client Collaboration: Offering a comprehensive, visual feedback mechanism strengthens client trust and satisfaction by showing a clear, actionable process for addressing concerns. Improve Team Productivity: Version control eliminates confusion about feedback iterations, ensuring that team members work with the most updated and accurate information. Advanced feedback tools position Agency Handy as a leading solution for agencies managing multiple clients, boosting retention and acquisition rates. User Stories:
As a user, I want to input a website URL in a task and preview it for quick review. As a user, I want to browse and interact with a live website within the app. As a user, I want to annotate screenshots in a comment mode to provide detailed feedback. As a user, I want to track and manage versions of feedback for iterative website updates. As a user, I want to navigate directly to a specific comment and its related screenshot for efficient review. Functional Requirements:
File feedback and its associated features (file versioning) will only be available from tasks. From ticket , files, orders and any other attachment view option will have only view mode. (added 2-19-2025) Task URL Integration:
Users can input a valid website URL into a task. The system fetches and displays a live preview of the URL. Website Viewing Modes:
Renders the website as a fully functional browser window within the app. Change the view mode (desktop 1920*1080, Mobile (iPhone 14 pro max) 932*430, Tablet (iPad Air)1180*820) Supports all native website interactions (clicks, scrolls, forms, etc.). Captures a screenshot of the current viewport. Provides tools for annotation, including drawing, highlighting, and adding text. Allows users to leave comments linked to specific annotations. Version Control for Feedback:
Adding file in another version is allowed Each set of annotations and comments is saved in a file version. Users can view a timeline of versions with timestamps and changes. Previous versions are preserved for comparison and reference. Users can create a new version when updating comments or annotations. A clear distinction is made between the current version and archived versions. Users can navigate between versions to view differences. Highlight changes between two versions (e.g., added/removed comments or annotations). Comment Navigation:
Opens the corresponding screenshot. Highlights the annotation. Automatically switches to Comment Mode for editing or review. Future Scope:
Enable real-time collaborative annotations with team members. Display concurrent edits and comments from multiple users. Dynamic Website Handling: Add tools to handle feedback on dynamic or single-page applications (SPAs). Acceptance Criteria:
Task URL Integration:
Users can successfully input valid website URLs. Invalid URLs trigger an appropriate error message. show file feedback only from tasks section Website Modes:
Displays the website as a fully functional browser window. Captures screenshots and allows annotations. Comments link accurately to annotations. Version Control:
Each saved annotation set creates a new version. Users can navigate between versions and highlight changes. All version data is stored and retrieved efficiently. Comment Navigation:
Clicking a comment redirects users to the associated screenshot and annotation. Automatically switches to Comment Mode for seamless review. Dependencies:
Web Rendering Engine: To render websites accurately. Annotation Tools: For capturing and editing screenshots. Database: To store and manage version control data efficiently. This feature elevates website feedback functionality within Agency Handy, offering advanced annotation tools, robust version control, and seamless integration to support collaborative and iterative workflows.
V2 Enhancements from V1:
Page Numbers for Documents and PDFs: Display page numbers for document and PDF files within the feedback interface. Allow users to navigate directly to a specific page using the page number field. Sort and Filter Options for File Feedback: Time of feedback (Newest to Oldest, Oldest to Newest). Reviewer name (Alphabetical order). Status (Resolved, Unresolved). Feedback Status: Resolved, Unresolved. Reviewer: Select specific reviewers. Time Range: Filter feedback by specific dates or date ranges. Make the square shape more intuitive. Right click box creation Allow users to select a section to comment, and if clicked by mistake allow to delete or select another more easily. (comment icon selected> clicked on the file> comment highlight/popup> if no comment and clicked on another section of the file> allow commenting on the new section without throwing error ) Suggestions from QA
Need multiple notifications for file feedback. Such as: If uploads a new version of a file text: a new version of the file “file_name” for task “task name” has been uploaded If resolves a comment/feedback your comment was resolved by “resolver name” for file “file name”
AgencyHandy
V2 File Feedback Support (to be developed)
