Chunks — 6. Project Details Module

Project header & Tabs

# **Functional Requirements Document (FRD)**

# **Project Details → Project Header**

**Module Name:** Project Details - Project Header  
**Version:** 1.0  
**Last Updated:** January 18, 2026

## **1\. Module Overview**

### **1.1 Module Name**

Project Details - Project Header

### **1.2 Purpose**

The Project Header serves as the primary visual and informational banner displayed at the top of every Project Details page. It provides users with essential project information at a glance, including the project name, dates, status, location, brand identity, and navigation to individual events within the project. Additionally, it alerts solo operators about scheduling conflicts and allows customization of the project's visual appearance through cover image management.

### **1.3 Business Goals**

*   Provide immediate visual context and brand identity for each project through customizable header images and brand logos.
*   Enable quick identification of project status (Active, Archived, Completed) to streamline project management workflows.
*   Alert solo operators about potential scheduling conflicts to prevent double-booking and ensure accurate availability management.
*   Facilitate seamless navigation between the project overview and individual event details through the horizontal event card row.
*   Display critical project metadata (dates, service area, timezone) to support multi-location and multi-timezone event coordination.
*   Maintain consistency in project branding across Agency Portal, Client Portal, and Contractor Portal views.

## **2\. User Roles & Permissions**

**Role**

**View Project Header**

**Edit Header Image**

**Dismiss Warning**

**Access Email Center**

**View Event Cards**

Agency Owner

✅ Yes

✅ Yes

✅ Yes

✅ Yes

✅ Yes

Admin

✅ Yes

✅ Yes

✅ Yes

✅ Yes

✅ Yes

Project Manager

✅ Yes

✅ Yes

✅ Yes

✅ Yes

✅ Yes

Team Member

✅ Yes

❌ No

✅ Yes

✅ Yes (if assigned)

✅ Yes

Contractor

✅ Yes (Contractor Portal)

❌ No

N/A

❌ No

✅ Yes (assigned events only)

Client

✅ Yes (Client Portal)

❌ No

N/A

❌ No

✅ Yes

### **2.1 Role-Specific Notes**

*   The warning banner for scheduling conflicts is only visible to Agency Owner, Admin, and Project Manager roles within the Agency Portal, and only for agencies registered as "Solo Operator" type.
*   Contractors viewing the Contractor Portal see the header image and project information but cannot modify any elements.
*   Clients viewing the Client Portal see the header image and project information relevant to their engagement but cannot modify any elements.
*   The "Emails" button is only visible and accessible within the Agency Portal.

## **3\. User Flow**

**3.1** The user navigates to the Projects module from the left sidebar menu and clicks on any project from the project listing page.

**3.2** The system redirects the user to the Project Details page and loads the Project Header section at the top of the page.

**3.3** The system displays the brand logo in the top-left corner of the header image area, which is inherited from the brand configuration associated with the project.

**3.4** The system displays the customizable header image as the background of the header section, defaulting to the brand's configured header image if no project-specific image has been set.

**3.5** The system displays the project name prominently in the center of the header area.

**3.6** The system displays the project date range showing the first event date through the last event date, or displays "TBD" if event dates have not been confirmed.

**3.7** The system displays the project status tag (Active, Archived, or Completed) next to or below the project dates.

**3.8** The system displays the service area showing the location of the next upcoming event, along with the corresponding timezone.

**3.9** If the agency is registered as a "Solo Operator" and any event date within the current project conflicts with event dates in other projects or leads, the system displays a yellow warning banner above the header image with the message "Heads Up! This date has X other lead(s) and Y booked job(s). Check your availability!" along with a "Dismiss" button.

**3.10** The user clicks the "Check your availability" link in the warning banner to review conflicting dates.

**3.11** The system redirects the user to the Check Availability screen showing all conflicting projects and leads.

**3.12** The user clicks the "Dismiss" button on the warning banner to hide it.

**3.13** The system hides the warning banner for the current session, but the banner will reappear when the user revisits any project with conflicting dates until explicitly dismissed again.

**3.14** The user clicks the camera icon or the header image area to update the cover image.

**3.15** The system opens the "Update Cover Image" modal with two tabs: "Library" and "Upload".

**3.16** The user selects the "Library" tab to choose from pre-set images provided by the system.

**3.17** The system displays a grid of available library images with checkbox selection, showing the currently selected image with a yellow checkbox indicator.

**3.18** The user clicks on a library image to select it and then clicks the "Update" button.

**3.19** The system updates the header image for the current project only, closes the modal, and displays a success message confirming the change.

**3.20** Alternatively, the user selects the "Upload" tab to upload a custom image.

**3.21** The system displays a drag-and-drop upload area with the text "Upload file" and indicates the allowed file types (jpeg, jpg, png) and maximum file size (3.1 MB).

**3.22** The user drags and drops an image file or clicks the upload area to select a file from their device.

**3.23** The system validates the file type and size, uploads the image, and displays it as the selected cover image.

**3.24** The user clicks the "Update" button to confirm the new cover image.

**3.25** The system saves the uploaded image as the project's header image, closes the modal, and displays a success message.

**3.26** The user clicks the "Cancel" button to close the modal without making any changes.

**3.27** The system closes the modal and retains the existing header image.

**3.28** The user clicks the "Emails" button located in the bottom-right corner of the header area.

**3.29** The system redirects the user to the Project's Email Center where all project-related email communications are displayed.

**3.30** The user views the horizontal event card row displayed below the header image, showing the "Overview" tab followed by individual event cards for each event within the project.

**3.31** The system displays each event card with the event name, event date, team member avatars, stage indicator (e.g., "Inquiry"), and a three-dot menu icon.

**3.32** The user scrolls horizontally if there are more event cards than can fit in the visible area.

**3.33** The user clicks on the "Overview" tab to view the project-level overview information.

**3.34** The system highlights the "Overview" tab as selected and displays the corresponding content area below.

**3.35** The user clicks on an individual event card to view event-specific details.

**3.36** The system highlights the selected event card, updates the content area to show event-specific information, and displays the Event Stage dropdown in the right sidebar instead of Project Name.

**3.37** The user clicks the three-dot menu icon on an event card to access event-specific actions.

**3.38** The system displays a dropdown menu with event-related actions (the specific actions are documented in the Event Tabs FRD).

## **4\. Functional Logic**

### **4.1 Warning Banner (Solo Operators Only)**

*   The warning banner is displayed only for agencies that selected "Solo Operator" (not "Studio") during the agency signup process.
*   The system checks all event dates within the current project against event dates in all other projects and leads associated with the same agency.
*   The conflict detection is based on actual event dates, not the overall project date range (start to end), ensuring accurate scheduling conflict identification.
*   If a project spans multiple days (e.g., December 19-21) but only has events on December 19 and December 21, the system does not flag December 20 as a conflict.
*   The warning message dynamically displays the count of conflicting leads and booked jobs, formatted as "This date has X other lead(s) and Y booked job(s)."
*   The "Check your availability" link redirects users to a dedicated Check Availability screen where they can review all conflicting projects and leads.
*   The "Dismiss" button hides the warning banner for the current session only.
*   Once dismissed, the warning banner will not reappear during the same session for any project.
*   When the user starts a new session or logs in again, the warning banner will reappear for all projects with conflicting dates until dismissed again.
*   The warning banner appears at the top of the Project Details page, above the header image, ensuring maximum visibility.
*   The warning banner is not displayed in the Client Portal or Contractor Portal views.

### **4.2 Brand Logo Display**

*   The brand logo is displayed in the top-left corner of the header image area.
*   The logo is automatically pulled from the brand configuration associated with the project.
*   If the project is associated with a brand that has no logo configured, the system displays a default placeholder or the agency name.
*   The brand logo cannot be changed from the Project Header; it must be updated in the Brand Settings module.
*   The brand logo is visible in both the Agency Portal and the Client/Contractor Portals, maintaining brand consistency across all views.

### **4.3 Header Image Display and Customization**

*   The header image serves as the visual background of the header section, creating a branded and personalized project appearance.
*   By default, the header image is inherited from the brand configuration associated with the project.
*   Users with appropriate permissions can override the brand's default header image with a project-specific image.
*   Changes to the header image apply only to the current project and do not affect the brand's default configuration or other projects.
*   The header image is visible in the Agency Portal, Client Portal, and Contractor Portal, ensuring consistent branding across all stakeholder views.
*   Clicking the camera icon or anywhere on the header image area opens the "Update Cover Image" modal.

### **4.4 Update Cover Image Modal - Library Tab**

*   The "Library" tab displays a grid of pre-set images provided by the system.
*   Users can select one image at a time by clicking on it.
*   The currently selected image displays a yellow checkbox indicator in the top-left corner.
*   If a project already has a custom or library-selected image, that image is pre-selected when the modal opens.
*   The "Update" button is disabled until the user selects an image different from the current one.
*   Clicking "Update" saves the selected library image as the project's header image.
*   Clicking "Cancel" closes the modal without saving any changes.

### **4.5 Update Cover Image Modal - Upload Tab**

*   The "Upload" tab displays a drag-and-drop upload area with an upload icon and "Upload file" text.
*   The system displays the allowed file types and size limit below the upload area: "Allowed \*.jpeg, \*.jpg, \*.png, Max size of 3.1 MB".
*   Users can drag and drop an image file directly onto the upload area or click to open a file picker.
*   The system validates the uploaded file against the following criteria: file type must be JPEG, JPG, or PNG; file size must not exceed 3.1 MB.
*   If the file type is invalid, the system displays an error message and does not accept the file.
*   If the file size exceeds 3.1 MB, the system displays an error message indicating the size limit has been exceeded.
*   Upon successful upload, the system displays a preview of the uploaded image within the modal.
*   The "Update" button becomes enabled once a valid image is uploaded.
*   Clicking "Update" saves the uploaded image as the project's header image and closes the modal.
*   The uploaded image is stored in the system and associated specifically with the current project.

### **4.6 Project Name Display**

*   The project name is displayed prominently in the center of the header area, overlaid on the header image.
*   The project name is pulled from the project record and cannot be edited directly from the header.
*   To edit the project name, users must access the "Edit Project" functionality (documented in the Project Management Sidebar FRD).
*   The project name uses a large, readable font with appropriate contrast against the header image background.
*   The project name is visible in all portal views (Agency, Client, Contractor).

### **4.7 Project Dates Display**

*   The project date range is displayed below the project name, showing the first event date through the last event date.
*   The date format follows the pattern: "Day, Mon DD - Day, Mon DD, YYYY" (e.g., "Wed, Dec 19 - Sat, Dec 21, 2024").
*   If all event dates within the project are marked as TBD (To Be Determined), the system displays "TBD" instead of a date range.
*   If some events have confirmed dates and others are TBD, the system displays the range of confirmed dates only.
*   The project dates automatically update when event dates are modified through the Event management functionality.

### **4.8 Project Status Tag**

*   The status tag is displayed near the project dates, indicating the current state of the project.
*   The system supports three project statuses: Active (default), Archived, and Completed.
*   **Active Status:** Applied to all projects that are not archived or completed; displayed with a green or neutral tag style.
*   **Archived Status:** Applied when a user manually archives the project or when automation rules trigger archival; displayed with a gray or muted tag style.
*   **Completed Status:** Applied only when ALL events within the project have been marked as completed or archived; displayed with a distinct completed tag style.
*   The status can be changed manually by users with appropriate permissions or automatically through workflow automation.
*   If a project has three events and only two are completed, the project remains in "Active" status until the third event is also completed or archived.
*   Status changes are logged in the Activity feed for audit purposes.

### **4.9 Service Area and Timezone Display**

*   The service area displays the location of the next upcoming event within the project.
*   If all events have passed, the service area displays the location of the most recent event.
*   The service area is formatted as "City, State/Region, Country" (e.g., "Boston, Massachusetts, USA").
*   The timezone is displayed adjacent to the service area, formatted with the UTC offset (e.g., "Timezone: GMT-4").
*   For multi-state or multi-timezone projects, the service area and timezone adjust based on the next upcoming event.
*   The service area and timezone help users understand the geographical context and ensure accurate scheduling.
*   The service area is displayed as a read-only field in the header; edits must be made through event management.

### **4.10 Emails Button**

*   The "Emails" button is positioned in the bottom-right corner of the header area.
*   Clicking the "Emails" button redirects the user to the Project's Email Center module.
*   The Email Center displays all email communications related to the current project, including sent and received emails.
*   The button may display a notification badge indicating the count of unread or new emails (if applicable, based on Email Center FRD specifications).
*   The "Emails" button is only visible in the Agency Portal and is hidden in Client and Contractor Portal views.

### **4.11 Event Navigation Row**

*   The event navigation row is displayed as a horizontal scrollable section immediately below the header image.
*   The first card in the row is always the "Overview" tab, which displays project-level information across all events.
*   Subsequent cards represent individual events within the project, displayed in chronological order based on event dates.
*   If an event has a TBD date, it is positioned after events with confirmed dates.
*   Each event card displays the following information: event name with a colored dot indicator, event date, team member avatars (showing assigned team members), stage indicator (e.g., "Stage: Inquiry"), and a three-dot menu icon for additional actions.
*   The colored dot indicator on each event card corresponds to the event type or category for visual differentiation.
*   If there are more event cards than can fit in the visible area, users can scroll horizontally to view additional cards.
*   Clicking on the "Overview" tab loads the project-level overview content in the main content area below.
*   Clicking on an individual event card loads event-specific content in the main content area and changes the right sidebar to display event-specific fields (e.g., Event Stage instead of Project Name).
*   The currently selected tab or card is visually highlighted to indicate the active selection.
*   The three-dot menu on each event card provides access to event-specific actions (documented in the Event Tabs FRD).

### **4.12 Cross-Portal Display Behavior**

*   In the **Agency Portal**, all header elements are displayed with full functionality as described above.
*   In the **Client Portal**, the header displays the brand logo, header image, project name, dates, and status, but the "Emails" button, warning banner, and edit capabilities are hidden.
*   In the **Contractor Portal**, the header displays the brand logo, header image, project name, dates, and event cards for events the contractor is assigned to, but the "Emails" button, warning banner, and edit capabilities are hidden.
*   Header image changes made in the Agency Portal are immediately reflected in the Client and Contractor Portal views.

### **4.13 Responsive and UI Behavior**

*   The header section is designed to be responsive and adapts to different screen sizes.
*   On smaller screens, the event navigation row remains horizontally scrollable with touch-friendly swipe gestures.
*   The warning banner (if displayed) remains pinned at the top and does not scroll with the page content.
*   The header image maintains its aspect ratio and may be cropped to fit different viewport widths while keeping the project name and key information visible.

## **5\. Field Details & Validations**

### **5.1 Header Display Fields**

**Field Name**

**Field Type**

**Source**

**Editable from Header**

**Validation Rules**

Brand Logo

Image

Brand Configuration

No

Pulled from associated brand; falls back to placeholder if not configured

Header Image

Image

Brand Default or Project Override

Yes (via modal)

Allowed formats: JPEG, JPG, PNG; Max size: 3.1 MB

Project Name

Text

Project Record

No

Display only; edit via Edit Project

Project Dates

Date Range

Calculated from Events

No

Displays first to last event date; shows "TBD" if no dates confirmed

Status Tag

Enum

Project Record

No

Values: Active, Archived, Completed

Service Area

Text

Next Upcoming Event

No

Displays location of next upcoming event

Timezone

Text

Next Upcoming Event

No

Displays timezone with UTC offset

### **5.2 Update Cover Image Modal - Upload Tab**

**Field Name**

**Field Type**

**Required**

**Validation Rules**

Upload Image

File Input

Yes (to update)

Allowed formats: .jpeg, .jpg, .png; Max size: 3.1 MB

### **5.3 Event Card Display Fields**

**Field Name**

**Field Type**

**Source**

**Description**

Event Name

Text

Event Record

Displayed with colored dot indicator

Event Date

Date

Event Record

Format: Day, Mon DD, YYYY; or "TBD"

Team Members

Avatar Array

Event Assignments

Displays avatars of assigned team members; shows "+N" for overflow

Stage

Enum

Event Record

Current stage of the event (e.g., Inquiry, Booked, Completed)

Three-Dot Menu

Icon Button

N/A

Opens event action dropdown

### **5.4 Warning Banner Fields**

**Field Name**

**Field Type**

**Description**

Warning Message

Dynamic Text

"Heads Up! This date has X other lead(s) and Y booked job(s)."

Check Availability Link

Hyperlink

Redirects to Check Availability screen

Dismiss Button

Button

Hides banner for current session

## **6\. Success Message Handling**

**Action**

**Success Message**

**Post-Success Behavior**

Update Cover Image (Library)

"Cover image updated successfully."

Modal closes; header image refreshes with new image

Update Cover Image (Upload)

"Cover image uploaded and updated successfully."

Modal closes; header image refreshes with uploaded image

Dismiss Warning Banner

No toast message displayed

Banner animates out and is hidden for the session

Navigate to Email Center

No toast message displayed

User is redirected to Email Center module

Select Event Card

No toast message displayed

Content area updates to show event-specific information

## **7\. Error Message Handling**

**Error Scenario**

**Error Message**

**Trigger Condition**

**User Action Required**

Invalid File Type (Upload)

"Invalid file type. Please upload a JPEG, JPG, or PNG image."

User attempts to upload a file that is not JPEG, JPG, or PNG

Select a valid image file

File Size Exceeded (Upload)

"File size exceeds the maximum limit of 3.1 MB. Please upload a smaller image."

User attempts to upload a file larger than 3.1 MB

Compress or select a smaller image file

Upload Failed (Network)

"Failed to upload image. Please check your connection and try again."

Network error during image upload

Retry upload or check internet connection

Image Processing Error

"Unable to process the image. Please try a different file."

System fails to process the uploaded image

Select a different image file

Permission Denied

"You do not have permission to update the cover image."

User without edit permissions attempts to update image

Contact administrator for access

Session Expired

"Your session has expired. Please log in again."

User session times out during image update

Log in again and retry

## **8\. Edge Cases**

**Edge Case**

**System Behavior**

Project has no events

The event navigation row displays only the "Overview" tab; no event cards are shown

All event dates are TBD

Project dates display "TBD"; event cards show "TBD" for dates; service area shows project-level location if available

Single event project

Event navigation row shows "Overview" tab and one event card

More than 5 events

Event navigation row becomes horizontally scrollable; scroll indicators or arrows may appear

Solo operator with no conflicts

Warning banner is not displayed

Solo operator with conflicts on multiple dates

Warning banner displays with aggregated count of all conflicting leads and booked jobs

User dismisses banner then navigates to another conflicting project

Warning banner reappears on the new project (dismiss is per-project within session)

Brand has no logo configured

System displays agency name or default placeholder in logo area

Brand has no default header image

System displays a default system header image

Header image upload interrupted

System discards partial upload; user must retry

User selects same library image as current

"Update" button remains disabled; no change is made

Project status changed to Completed but event reopened

Project status reverts to Active if any event is no longer completed

Extremely long project name

Text truncates with ellipsis; full name shown on hover/tooltip

Event card team members exceed display limit

Additional members shown as "+N" avatar indicator

User clicks header image but has no edit permission

Nothing happens; camera icon is not displayed for users without permission

Client views project in Client Portal

Warning banner, Emails button, and edit capabilities are hidden

Contractor views project in Contractor Portal

Only assigned event cards are visible; warning banner and Emails button are hidden

Timezone differs between events

Timezone display updates based on currently selected event or next upcoming event when on Overview

Project spans multiple timezones

Service area and timezone update dynamically based on event context

Image upload while another upload is in progress

System queues or prevents duplicate uploads; shows loading state

## **9\. Acceptance Criteria**

### **9.1 Warning Banner**

*   AC-1: The warning banner shall only be displayed for agencies registered as "Solo Operator" type.
*   AC-2: The warning banner shall display the correct count of conflicting leads and booked jobs based on actual event dates.
*   AC-3: The "Check your availability" link shall redirect users to the Check Availability screen.
*   AC-4: The "Dismiss" button shall hide the warning banner for the current session.
*   AC-5: The warning banner shall reappear when the user starts a new session and visits a project with conflicting dates.

### **9.2 Brand Logo and Header Image**

*   AC-6: The brand logo shall be displayed in the top-left corner of the header image area.
*   AC-7: The header image shall default to the brand's configured image if no project-specific image is set.
*   AC-8: Changes to the header image shall apply only to the current project.
*   AC-9: The header image shall be visible in Agency Portal, Client Portal, and Contractor Portal.

### **9.3 Update Cover Image Modal**

*   AC-10: The modal shall display two tabs: "Library" and "Upload".
*   AC-11: The Library tab shall display a grid of pre-set images with checkbox selection.
*   AC-12: The Upload tab shall accept only JPEG, JPG, and PNG files up to 3.1 MB.
*   AC-13: Invalid file uploads shall display appropriate error messages.
*   AC-14: The "Update" button shall save the selected or uploaded image as the project header.
*   AC-15: The "Cancel" button shall close the modal without saving changes.

### **9.4 Project Information Display**

*   AC-16: The project name shall be displayed prominently in the header area.
*   AC-17: The project dates shall display the range from first event date to last event date.
*   AC-18: The project dates shall display "TBD" if no event dates are confirmed.
*   AC-19: The status tag shall correctly reflect the project status (Active, Archived, Completed).
*   AC-20: The project shall only show "Completed" status when all events are completed or archived.

### **9.5 Service Area and Timezone**

*   AC-21: The service area shall display the location of the next upcoming event.
*   AC-22: The timezone shall display the correct UTC offset for the next upcoming event.
*   AC-23: For multi-timezone projects, the display shall update based on the selected event.

### **9.6 Emails Button**

*   AC-24: The "Emails" button shall be visible only in the Agency Portal.
*   AC-25: Clicking the "Emails" button shall redirect to the Project's Email Center.

### **9.7 Event Navigation Row**

*   AC-26: The "Overview" tab shall always be the first item in the event navigation row.
*   AC-27: Event cards shall be displayed in chronological order based on event dates.
*   AC-28: Each event card shall display: event name, date, team member avatars, stage, and three-dot menu.
*   AC-29: Clicking an event card shall load event-specific content in the main content area.
*   AC-30: The event navigation row shall be horizontally scrollable when events exceed the visible area.
*   AC-31: The currently selected tab or card shall be visually highlighted.

### **9.8 Cross-Portal Behavior**

*   AC-32: Client Portal shall display header information without edit capabilities or Emails button.
*   AC-33: Contractor Portal shall display only event cards for events the contractor is assigned to.
*   AC-34: Header image changes in Agency Portal shall reflect immediately in Client and Contractor Portals.

## **10\. Manual Test Cases**

Test Case Link-

## **11\. Dependencies**

**Dependency Type**

**Dependency Name**

**Description**

**Impact if Unavailable**

Internal Module

Brand Settings

Provides brand logo and default header image

Header displays fallback placeholder

Internal Module

Project Management

Provides project name, status, and metadata

Header cannot display project information

Internal Module

Event Management

Provides event dates, locations, team assignments

Event cards cannot be displayed; dates show as unavailable

Internal Module

Email Center

Destination for Emails button

Button click results in navigation error

Internal Module

Check Availability

Destination for warning banner link

Link click results in navigation error

Internal Module

User Management

Provides team member avatars and names

Avatars display as default placeholders

Internal Data

Agency Type Configuration

Determines if Solo Operator warning applies

Warning banner may display incorrectly

External Service

File Storage Service

Stores uploaded header images

Image uploads fail

External Service

Image Processing Service

Processes and optimizes uploaded images

Image processing errors

Internal Module

Automation Engine

May trigger status changes

Automated status updates fail

Internal Module

Activity Feed

Logs status changes and updates

Activity logging fails

Portal Integration

Client Portal

Displays header in client view

Client sees broken or missing header

Portal Integration

Contractor Portal

Displays header in contractor view

Contractor sees broken or missing header

## **12\. References**

### **Figma Link-**

Project Overview

✅ Activity Tab

# **Functional Requirements Document (FRD)**

# **Project Details → Activity Tab**

**Module Name:** Project Details - Activity Tab  
**Version:** 1.0  
**Last Updated:** February 19, 2026  
**Status:** Approved

## **1\. Module Overview**

### **1.1 Module Name**

Project Details - Activity Tab

### **1.2 Purpose**

The Activity Tab serves as a comprehensive audit log and activity feed that captures all significant user actions and system events related to a project. It provides users with complete visibility into the project's history, enabling them to track changes, monitor progress, review communications, and maintain accountability across all project activities. The tab displays activities in strict chronological order with timestamps adjusted to each user's timezone preferences.

### **1.3 Business Goals**

*   Provide complete transparency and traceability of all project-related actions for audit and accountability purposes.
*   Enable quick access to related items (emails, invoices, documents, contracts, proposals) directly from the activity feed through contextual CTAs.
*   Reduce the need to navigate between modules by surfacing key actions and events in a centralized timeline.
*   Support team collaboration by showing who performed which actions and when.
*   Facilitate client relationship management by logging all interactions and communications.
*   Enable quick follow-up actions (sending reminders, viewing invoices, replying to emails, countersigning contracts) without leaving the Activity tab.
*   Track the complete proposal lifecycle from creation to client acceptance for improved sales pipeline visibility.

## **2\. User Roles & Permissions**

### **2.1 Permission Matrix**

**Role**

**View Activity Tab**

**View All Activities**

**View Payment Activities**

**Perform CTAs**

**Send Reminders**

Agency Owner

✅ Yes

✅ Yes

✅ Yes

✅ Yes

✅ Yes

Admin

✅ Yes

✅ Yes

✅ Yes

✅ Yes

✅ Yes

Project Manager

✅ Yes

✅ Yes

✅ Yes

✅ Yes

✅ Yes

### **2.2 Role-Specific Notes**

*   **Project Manager** is a dynamic role assigned per project. By default, the user who creates the project becomes the Project Manager. Agency Owner or Admin can reassign the Project Manager role to any user. There can only be one Project Manager per project. Detailed logic for the Project Manager assignment is documented in a separate FRD.
*   **Payment-related activities** (Section A.4 - all 12 types) are only visible to Agency Owner, Admin, and Project Manager roles.
*   The **"Send Reminder" CTA** for overdue invoices and failed payments is restricted to Agency Owner, Admin, and Project Manager roles.
*   All users see timestamps in their own timezone based on their Date & Time Preferences configured in user settings.

### **2.3 Payment Activities Visibility Matrix**

**Activity Type**

**Agency Owner**

**Admin**

**Project Manager**

Invoice sent

✅ Visible

✅ Visible

✅ Visible

Payment received

✅ Visible

✅ Visible

✅ Visible

Automated invoice reminders sent

✅ Visible

✅ Visible

✅ Visible

Automated overdue notice sent

✅ Visible

✅ Visible

✅ Visible

Invoice manually edited

✅ Visible

✅ Visible

✅ Visible

Partial refund issued

✅ Visible

✅ Visible

✅ Visible

Full refund issued

✅ Visible

✅ Visible

✅ Visible

Contractor paid

✅ Visible

✅ Visible

✅ Visible

Failed Payment

✅ Visible

✅ Visible

✅ Visible

Overdue invoice

✅ Visible

✅ Visible

✅ Visible

## **3\. User Flow**

**3.1** The user navigates to the Project Details page by clicking on a project from the project listing or any other entry point.

**3.2** The system loads the Project Details page with the Project Header and the Overview tab selected by default.

**3.3** The user clicks on the "Activity" tab within the Overview section's horizontal tab navigation.

**3.4** The system loads the Activity tab and displays the activity feed with the most recent activities appearing first.

**3.5** The system displays each activity entry with the user avatar (or system icon for automated activities), user name and role, action description, timestamp in the user's timezone, and any applicable CTA buttons.

**3.6** The user scrolls down to view older activities, and the system loads additional activities via infinite scroll as the user approaches the bottom of the current list.

**3.7** The system displays a loading indicator while fetching additional activities during infinite scroll.

**3.8** The user identifies an activity related to an email and clicks the "View Email" CTA button.

**3.9** The system navigates the user to the Email Center with the relevant email thread displayed.

**3.10** The user returns to the Activity tab and identifies an activity showing a file was uploaded.

**3.11** The system displays the file attachment preview below the activity description, showing the file icon, file name, file size, and time since upload.

**3.12** The user clicks the "Download" button on the file attachment preview.

**3.13** The system initiates the file download to the user's device.

**3.14** The user identifies an activity showing a client signed a contract and clicks the "Countersign" CTA.

**3.15** The system navigates the user to the Contract module where they can countersign the contract.

**3.16** The user (with appropriate role) identifies an activity for an overdue invoice and clicks the "View Invoice" CTA.

**3.17** The system navigates the user to the Invoice module with the relevant invoice displayed.

**3.18** The user returns to the Activity tab and clicks the "Send Reminder" CTA on an overdue invoice activity.

**3.19** The system sends a payment reminder to the client and displays a success message confirming the reminder was sent.

**3.20** The system greys out the "Send Reminder" button for that specific activity and displays a tooltip on hover indicating "Reminder sent on \[timestamp\]".

**3.21** After 24 hours have passed since the reminder was sent, the system re-enables the "Send Reminder" button, allowing the user to send another reminder.

**3.22** The user identifies a contractor invoice activity and clicks the "Pay" CTA.

**3.23** The system navigates the user to the contractor payment flow or displays the payment modal.

**3.24** The user clicks the "Reply" CTA on an email-received activity from a client.

**3.25** The system navigates the user to the Email Center with the reply composer open for the relevant email thread.

**3.26** The user identifies a proposal-related activity showing the client accepted a proposal and clicks the "View Proposal" CTA.

**3.27** The system navigates the user to the Proposal module with the relevant proposal displayed.

**3.28** The user identifies an activity showing an event and services were auto-created from a proposal and clicks the "View Event" CTA.

**3.29** The system navigates the user to the Event Details tab for the newly created event.

**3.30** The user continues scrolling through the activity feed until reaching the earliest activity, which is always "Project '\[Project Name\]' was created" with the creator's name and timestamp.

**3.31** The system indicates that no more activities are available to load when the user reaches the end of the activity history.

**3.32** When new activities occur while the user is viewing the Activity tab, the user must manually refresh the page to see the latest entries.

## **4\. Functional Logic**

### **4.1 Activity Feed Display**

*   The Activity tab displays all significant user actions and system events related to the project in a single, unified timeline.
*   Activities are displayed in strict reverse chronological order, with the most recent activities appearing at the top.
*   There is no filtering or sorting functionality; the feed always displays newest activities first.
*   The activity feed uses infinite scroll behavior, loading additional activities as the user scrolls toward the bottom of the current list.
*   The system loads activities in batches (e.g., 20-30 activities per batch) to optimize performance and reduce initial load time.
*   A loading indicator is displayed at the bottom of the feed while additional activities are being fetched.
*   The activity feed is never empty; the first activity is always "Project '\[Project Name\]' was created by \[User Name\]" with the creation timestamp.

### **4.2 Activity Entry Structure**

*   Each activity entry consists of the following components displayed in a consistent format.
*   The user avatar is displayed on the left side of the entry; for automated system activities, a system icon is displayed instead.
*   The user name and role are displayed next to the avatar, identifying who performed the action (e.g., "Mary Jane", "System").
*   The action description provides a clear, concise summary of what occurred, including relevant context such as item names, amounts, or status changes.
*   The timestamp displays the exact date and time of the activity, formatted according to the user's Date & Time Preferences from their settings.
*   Each user sees timestamps converted to their own timezone, ensuring accurate time representation regardless of where the action originated.
*   CTA buttons are displayed below or alongside the action description when applicable, providing quick access to related items or actions.
*   For file-related activities, a file attachment preview is displayed below the description showing the file icon, file name, file size, and time since upload.

### **4.3 Activity Description Format Examples**

*   **Project creation:** "Project 'Jadon & Monica Wedding' was created" with timestamp.
*   **Team member addition:** "\[User Name\] added \[Team Member Name\] to the project."
*   **Project Manager changed:** "\[User Name\] assigned \[New Project Manager Name\] as Project Manager" (Informational).
*   **Project total adjusted:** "\[User Name\] adjusted project total/pricing" with View CTA (redirects to Finances Tab).
*   **File upload:** "\[User Name\] added file to '\[Project Name\]'" with file attachment preview showing file details.
*   **Email sent:** "\[User Name\] sent an email to \[Recipient Name\]" with View Email CTA.
*   **Email received:** "\[Client Name\] (Client) sent you an email" with View Email and Reply CTAs.
*   **Invoice activity:** "\[Client Name\] viewed Invoice #\[Invoice Number\]" with View Invoice CTA.
*   **Contract sent:** "\[User Name\] sent Contract for \[Project Name\] to \[Client Name\]" with View Contract CTA. If sent to multiple clients, display as "\[User Name\] sent Contract for \[Project Name\] to \[Client Name\] +N more" where N is the count of additional recipients.
*   **Contract signed by client:** "Received signed contract from \[Client Name\]" with View Contract and Countersign CTAs.
*   **Contractor signed agreement:** "\[Contractor Name\] signed the service agreement" with View Agreement and Countersign CTAs.
*   **Questionnaire sent:** "\[User Name\] sent Questionnaire for \[Project Name\] to \[Client Name/Contractor Name\]" with View Questionnaire CTA. If sent to multiple recipients, display as "\[User Name\] sent Questionnaire for \[Project Name\] to \[Recipient Name\] +N more" where N is the count of additional recipients.
*   **Proposal sent:** "\[User Name\] sent Proposal for \[Project Name\] to \[Client Name\]" with View Proposal CTA.
*   **Invoice sent:** "\[User Name\] sent Invoice for \[Project Name\] to \[Client Name\]" with View Invoice CTA.
*   **Payment received:** "Payment of $\[Amount\] received from \[Client Name\]" with View Invoice CTA.
*   **Contractor invoice:** "\[Contractor Name\] (Contractor) uploaded invoice \[Invoice Reference\]" with View Invoice and Pay CTAs.
*   **Contractor event price adjusted:** "\[User Name\] adjusted \[Contractor Name\]'s event price: 'Added parking fee due to venue change'" with View Contractor CTA.
*   **Overdue invoice:** "Invoice #\[Invoice Number\] is overdue" with View Invoice and Send Reminder CTAs.
*   **Event venue changed:** "\[User Name\] changed \[Event Name\] venue from \[Old Venue\] to \[New Venue\]" with View Event CTA.
*   **Event hours changed:** "\[User Name\] updated hours of coverage for \[Event Name\] from \[Old Hours\] to \[New Hours\]" with View Event CTA.
*   **Number of shooters changed:** "\[User Name\] changed number of shooters for \[Event Name\] from \[Old Count\] to \[New Count\]" with View Event CTA.
*   **Minimum photos changed:** "\[User Name\] updated minimum photos for \[Event Name\] from \[Old Count\] to \[New Count\]" with View Event CTA.
*   **Service removed:** "\[User Name\] removed \[Service Name\] from the project" with View Services CTA.
*   **Meeting scheduled:** "Meeting '\[Meeting Title\]' scheduled wit

h \[Participant Name\] on \[Date/Time\]" (Informational).
*   **Proposal viewed:** "\[Client Name\] viewed the Proposal" with View Proposal CTA.
*   **Proposal accepted:** "Client accepted Proposal and selected '\[Package Name\]'" with View Proposal CTA.
*   **Proposal expired:** "Proposal for \[Project Name\] has expired" with View Proposal CTA.
*   **Auto-created event:** "Event '\[Event Name\]' and Services were automatically created from Proposal" with View Event and View Services CTAs.

### **4.4 Admin/Studio Actions**

*   The system logs when a project is created, capturing the creator's name and timestamp.
*   The system logs when a team member is added to the project, displaying the added member's name and a "View Team Member" CTA.
*   The system logs when a team member is removed from the project as an informational entry without a CTA.
*   The system logs when a project is archived or unarchived as informational entries without CTAs.
*   The system logs when an event is rescheduled, displaying both the old and new date/time values and a "View Event" CTA.
*   The system logs when an event venue is changed, displaying both the old and new venue and a "View Event" CTA.
*   The system logs when an event's hours of coverage is changed, displaying both the old and new hours and a "View Event" CTA.
*   The system logs when the number of shooters for an event is changed, displaying both the old and new count and a "View Event" CTA.
*   The system logs when the minimum photos requirement for an event is changed, displaying both the old and new count and a "View Event" CTA.
*   The system logs when an event is removed from the project as an informational entry without a CTA.
*   The system logs when a deliverable is added, edited, or removed as informational entries without CTAs.
*   The system logs when a new event is created, displaying the event name and a "View Event" CTA.
*   The system logs when new services are added to the project with a "View Services" CTA.
*   The system logs when a service is removed from the project with a "View Services" CTA.
*   The system logs when the project is edited as an informational entry without a CTA.
*   The system logs when project services are edited with a "View Services" CTA.
*   The system logs when the Project Manager is changed as an informational entry without a CTA, displaying the format "\[User Name\] assigned \[New Project Manager Name\] as Project Manager".
*   The system logs when the project total/pricing is adjusted with a "View" CTA that redirects to the Finances Tab.
*   The system logs when a timeline is uploaded with "View Timeline" and "Download" CTAs.
*   The system logs when an event status is updated, displaying the new status and a "View Event" CTA.
*   The system logs when an email is sent by an agency user with a "View Email" CTA.
*   The system logs when files or documents are manually uploaded with a "Download" CTA and displays the file attachment preview.
*   The system logs when a Contract is sent with a "View Contract" CTA, displaying the format "\[User Name\] sent Contract for \[Project Name\] to \[Client Name\]". If sent to multiple clients, the format is "\[User Name\] sent Contract for \[Project Name\] to \[Client Name\] +N more".
*   The system logs when a Questionnaire is sent with a "View Questionnaire" CTA, displaying the format "\[User Name\] sent Questionnaire for \[Project Name\] to \[Client Name/Contractor Name\]". If sent to multiple recipients, the format is "\[User Name\] sent Questionnaire for \[Project Name\] to \[Recipient Name\] +N more".
*   The system logs when a Proposal is sent with a "View Proposal" CTA, displaying the format "\[User Name\] sent Proposal for \[Projec

t Name\] to \[Client Name\]".
*   The system logs when an Invoice is sent with a "View Invoice" CTA, displaying the format "\[User Name\] sent Invoice for \[Project Name\] to \[Client Name\]".
*   The system logs when a signed contract is received from a client with "View Contract" and "Countersign" CTAs.
*   The system logs when a questionnaire is completed with a "View" CTA linking to the completed questionnaire.
*   The system logs when the primary client is changed with a "View Client" CTA.
*   The system logs when a client is added to the project with a "View Client" CTA.
*   The system logs when a client is removed from the project as an informational entry without a CTA.
*   The system logs when a client views an invoice with a "View Invoice" CTA; clicking this CTA navigates to the invoice which shows the client view indicator in the invoice's activity history.
*   The system logs when a client uploads files with "Download" and "View File" CTAs and displays the file attachment preview.
*   The system logs when an event or project is cancelled as an informational entry without a CTA.
*   The system logs when a SNAPSHOT is sent to a contractor (either from general settings toggle or manually from project details) as an informational entry without a CTA.

### **4.5 Proposal-Related Activities**

*   The system logs when a proposal is sent to a client with a "View Proposal" CTA, displaying the format "\[User Name\] sent Proposal for \[Project Name\] to \[Client Name\]".
*   The system logs when a client views the proposal with a "View Proposal" CTA, displaying the format "\[Client Name\] viewed the Proposal".
*   The system logs when a client fully accepts a proposal (selects package, signs contract, and makes initial payment) with a "View Proposal" CTA, displaying the format "Client accepted Proposal and selected '\[Package Name\]'".
*   The proposal is considered accepted only when all three steps are completed: package selection, contract signing, and initial payment.
*   The system logs when a proposal expires with a "View Proposal" CTA, displaying the format "Proposal for \[Project Name\] has expired".
*   Proposal expiry is logged only when the proposal has an expiration date set, the expiration date has passed, AND the client has not accepted the proposal.
*   If a client accepts the proposal before the expiration date, no expiry activity is logged.

### **4.6 Contractor Actions**

*   The system logs when a contractor is assigned to an event or project with a "View Contractor" CTA.
*   The system logs when a service agreement is sent to a contractor with a "View Agreement" CTA.
*   The system logs when a contractor signs the service agreement with "View Agreement" and "Countersign" CTAs.
*   The system logs when a contractor submits deliverables with a "View Deliverables" CTA.
*   The system logs when a contractor uploads an invoice with "View Invoice" and "Pay" CTAs.
*   The system logs when a contractor marks a task as complete with a "View Task" CTA.
*   The system logs when the agency pays a contractor's invoice with a "View Invoice" CTA.
*   The system logs when manual adjustments are made to contractor pay with a "View Payment" CTA.
*   The system logs when a contractor's event price is adjusted with a "View Contractor" CTA, displaying the format "\[User Name\] adjusted \[Contractor Name\]'s event price: '\[User-provided description\]'".
*   The system logs when a contractor is removed from an event or project as an informational entry without a CTA.

### **4.7 System-Triggered Events**

*   The system logs when new files are uploaded (by any user or system process) with "View" and "Download" CTAs and displays the file attachment preview.
*   The system logs when a new email is received from a client, displaying a one-line summary (not full content) with "View Email" and "Reply" CTAs.
*   The system logs workflow automation triggers as informational entries without CTAs, including event pipeline status changes, automated questionnaires sent, automated emails sent, and automated tasks created.
*   The system logs lead form submissions that initiate project activities with a "View" CTA linking to the lead form submission details.
*   The system logs when an event and services are automatically created from a proposal acceptance with "View Event" and "View Services" CTAs, displaying the format "Event '\[Event Name\]' and Services were automatically created from Proposal".
*   The system logs when a meeting is scheduled via Calendly as an informational entry without a CTA, displaying the format "Meeting '\[Meeting Title\]' scheduled with \[Participant Name\] on \[Date/Time\]".

### **4.8 Payment-Related Updates**

*   Payment-related activities are only visible to Agency Owner, Admin, and Project Manager roles.
*   The system logs when an invoice is sent to a client with a "View Invoice" CTA.
*   The system logs when a payment is received, displaying the amount and a "View Invoice" CTA.
*   The system logs when automated invoice reminders are sent with a "View Invoice" CTA.
*   The system logs when automated emails are sent from automations with a "View Email" CTA.
*   The system logs when automated questionnaires are sent from automations with a "View Questionnaire" CTA.
*   The system logs when an automated overdue notice is sent with a "View Invoice" CTA.
*   The system logs when an invoice is manually edited (line items, amounts, due dates) with a "View Invoice" CTA.
*   The system logs when a partial refund is issued, displaying the refund amount and a "View Invoice" CTA.
*   The system logs when a full refund is issued with a "View Invoice" CTA.
*   The system logs when a contractor is paid with a "View Invoice" CTA.
*   The system logs when a payment fails with "View Invoice" and "Send Reminder" CTAs.
*   The system logs when an invoice becomes overdue with "View Invoice" and "Send Reminder" CTAs.

### **4.9 Send Reminder Functionality**

*   The "Send Reminder" CTA is available for overdue invoice activities and failed payment activities.
*   Only users with Agency Owner, Admin, or Project Manager roles can access the "Send Reminder" functionality.
*   When the user clicks "Send Reminder", the system sends a payment reminder email to the client associated with the invoice.
*   Upon successful reminder delivery, the system displays a success message confirming "Reminder sent successfully."
*   After a reminder is sent, the "Send Reminder" button is immediately greyed out (disabled) for that specific activity entry.
*   When a user hovers over the greyed-out button, a tooltip displays "Reminder sent on \[Date\] at \[Time\]" showing when the last reminder was sent.
*   The "Send Reminder" button remains greyed out for a 24-hour cooldown period from the time the reminder was sent.
*   After 24 hours have elapsed, the "Send Reminder" button automatically becomes active again, allowing the user to send another reminder.
*   The cooldown period is tracked per activity entry, meaning if multiple overdue invoices exist, each has its own independent cooldown timer.
*   If one user sends a reminder, the button is greyed out for all users viewing that activity entry until the 24-hour cooldown expires.
*   The reminder timestamp is stored and displayed consistently across all users, converted to each user's local timezone.

### **4.10 Countersign Functionality**

*   The "Countersign" CTA is displayed alongside "View Contract" or "View Agreement" for contract/agreement signed activities.
*   For client-signed contracts, clicking "Countersign" navigates the agency user to the Contract module where they can add their countersignature.
*   For contractor-signed service agreements, clicking "Countersign" navigates the agency user to the Service Agreement module where they can add their countersignature.
*   Once the contract or agreement has been countersigned, the "Countersign" CTA may be hidden or replaced with a "Signed" indicator (implementation based on Contract module logic).

### **4.11 File Attachment Preview Display**

*   For all file-related activities, a file attachment preview is displayed below the activity description.
*   The preview includes a file type icon that visually represents the file format (e.g., document icon for .doc, spreadsheet icon for .xls, image icon for .png).
*   The file name is displayed in full, truncating with an ellipsis if it exceeds the available width.
*   The file size is displayed in human-readable format (e.g., "1.4 MB", "256 KB").
*   The time since upload is displayed in relative format (e.g., "2 days ago", "5 hours ago", "Just now").
*   A "Download" button is displayed on the file preview, allowing users to download the file directly.
*   For previewable file types (PDF, images), a "Preview" option may also be available.
*   Clicking the file name or icon opens a preview if available, or initiates a download if preview is not supported.

### **4.12 Timestamp and Timezone Handling**

*   All activity timestamps are stored in UTC in the database to ensure consistency.
*   When displaying timestamps to users, the system converts UTC timestamps to the user's local timezone.
*   The user's timezone preference is retrieved from their Date & Time Preferences in user settings.
*   The date and time format follows the user's configured format preferences (e.g., "DD/MM/YYYY" vs "MM/DD/YYYY", "12-hour" vs "24-hour").
*   If a user changes their timezone settings, all timestamps in the Activity tab are immediately re-rendered in the new timezone upon page refresh.
*   The relative time display (e.g., "2 days ago") is also calculated based on the user's local timezone.

### **4.13 Infinite Scroll Behavior**

*   The activity feed initially loads the most recent batch of activities (e.g., 20-30 entries).
*   As the user scrolls down and approaches the bottom of the currently loaded activities, the system automatically fetches the next batch.
*   A loading spinner or skeleton loader is displayed at the bottom of the feed while additional activities are being fetched.
*   The system continues loading additional batches as the user scrolls until all activities have been loaded.
*   When the user reaches the final activity (project creation), the system indicates that no more activities are available.
*   If a network error occurs during infinite scroll loading, the system displays an error message with a "Retry" option.
*   The scroll position is maintained when new activities are loaded, preventing the user from losing their place.

### **4.14 Activity Feed Refresh**

*   The activity feed does not update in real-time; new activities are not automatically displayed while the user is viewing the tab.
*   When new activities occur while the user is viewing the Activity tab, the user must manually refresh the page to see the latest entries.
*   Upon page refresh, the system reloads the activity feed from the beginning, displaying the most recent activities first.
*   There is no "Load new activities" prompt or notification; users are expected to refresh the page manually to see updates.

### **4.15 Activity for Deleted or Inaccessible Items**

*   If an activity references an item that has been deleted (e.g., a file that was later removed), the CTA button is either hidden or displays as disabled with a tooltip indicating "Item no longer available."
*   The activity entry itself remains visible for historical record purposes, even if the linked item is no longer accessible.
*   For activities referencing restricted items (e.g., financial data for users without finance permissions), the CTA may be hidden or display an appropriate access restriction message.

## **5\. Field Details & Validations**

### **5.1 Activity Entry Display Fields**

**Field Name**

**Field Type**

**Source**

**Description**

User Avatar

Image

User Profile

Profile picture of the user who performed the action; system icon for automated activities

User Name

Text

User Profile

Full name of the user who performed the action

User Role

Text

User Profile / Assignment

Role context (e.g., "Contractor", "Admin", "Client") displayed in parentheses when relevant

Action Description

Text

Activity Log

Clear, concise description of the action performed

Timestamp

DateTime

Activity Log (UTC)

Converted to user's timezone and formatted per user preferences

CTA Buttons

Button Array

Activity Type

Dynamic based on activity type; may include multiple CTAs

File Preview

Component

File Storage

Displayed for file-related activities only

### **5.2 File Attachment Preview Fields**

**Field Name**

**Field Type**

**Description**

File Icon

Image/Icon

Visual representation of file type

File Name

Text

Full file name with extension; truncates with ellipsis if too long

File Size

Text

Human-readable size (e.g., "1.4 MB")

Time Since Upload

Text

Relative time (e.g., "2 days ago")

Download Button

Button

Initiates file download

### **5.3 Send Reminder State Fields**

**Field Name**

**Field Type**

**Description**

Last Reminder Sent

DateTime

Timestamp of when the last reminder was sent for this activity

Cooldown Active

Boolean

True if within 24-hour cooldown period

Tooltip Text

Text

"Reminder sent on \[Date\] at \[Time\]" when cooldown is active

## **6\. Success Message Handling**

**Action**

**Success Message**

**Post-Success Behavior**

Send Reminder (Overdue Invoice)

"Reminder sent successfully."

Button greys out; tooltip shows reminder timestamp; 24-hour cooldown begins

Send Reminder (Failed Payment)

"Payment reminder sent successfully."

Button greys out; tooltip shows reminder timestamp; 24-hour cooldown begins

File Download Initiated

No toast message

File download begins in browser

Navigate to Related Item

No toast message

User is redirected to the relevant module/item

Page Refresh

No toast message

Activity feed reloads with latest activities

## **7\. Error Message Handling**

**Error Scenario**

**Error Message**

**Trigger Condition**

**User Action Required**

Send Reminder Failed

"Failed to send reminder. Please try again."

Network error or email service failure when sending reminder

Retry sending the reminder

Reminder Already Sent (Cooldown Active)

"A reminder was already sent recently. Please wait before sending another."

User attempts to send reminder during 24-hour cooldown (edge case if button state fails)

Wait for cooldown period to expire

Infinite Scroll Load Failed

"Unable to load more activities. Please check your connection."

Network error during infinite scroll fetch

Click "Retry" or refresh the page

File Download Failed

"Failed to download file. Please try again."

Network error or file not found during download

Retry download or contact support if file is missing

Item Not Found

"The requested item is no longer available."

User clicks CTA for a deleted item

No action available; item has been removed

Permission Denied

"You do not have permission to access this item."

User clicks CTA for an item they don't have permission to view

Contact administrator for access

Activity Load Failed

"Unable to load activities. Please refresh the page."

Initial activity feed fails to load

Refresh the page

Invalid Client Email (Send Reminder)

"Unable to send reminder. Client email address is invalid."

Client email is invalid or missing when sending reminder

Update client email address and retry

## **8\. Edge Cases**

**Edge Case**

**System Behavior**

Project with only one activity

The activity feed displays only the project creation activity with a message indicating no additional activities

Extremely long activity history (1000+ activities)

Infinite scroll loads activities in batches; performance is optimized through pagination

Activity references a deleted file

CTA button is disabled or hidden; activity entry remains visible with note "File no longer available"

Activity references a deleted user

User name displays as "\[Deleted User\]" or shows the name at the time of the activity

Multiple reminders sent by different users

Only one reminder can be sent per 24-hour period regardless of which user sends it

User changes timezone while viewing Activity tab

Timestamps update to new timezone upon page refresh

Network disconnection during infinite scroll

Error message displayed with "Retry" option; previously loaded activities remain visible

Activity created while user is viewing the tab

User must manually refresh the page to see new activities; no automatic updates

Activity for archived project

Activity tab remains accessible and displays all historical activities

CTA leads to a module user doesn't have access to

Permission denied message is displayed; user is not redirected

Concurrent activity creation

Activities are ordered by exact timestamp; ties are resolved by database insertion order

Activity description contains very long text

Text wraps appropriately; may truncate with "Show more" option if excessively long

File attachment has very long filename

Filename truncates with ellipsis; full name shown on hover

Reminder sent exactly at 24-hour boundary

System uses server timestamp; button enables at or after exactly 24 hours

User without email permissions clicks "View Email"

User is redirected to Email Center with appropriate access level

Automated activity occurs at midnight (timezone edge)

Timestamp correctly reflects the activity time in each user's local timezone

Activity for item that was subsequently edited

Activity shows state at time of action; current item state may differ

Browser back button after CTA navigation

User returns to Activity tab at their previous scroll position (if supported)

Activity log during system maintenance

Graceful degradation with message "Activity temporarily unavailable"

Proposal accepted without all three steps

Proposal acceptance activity is NOT logged until all three steps (package selection, contract signing, initial payment) are completed

Proposal expires after partial completion

Proposal expired activity is logged; partial completion data is retained but proposal is marked as expired

Client accepts proposal on expiration date

If acceptance occurs before midnight on expiration date, no expiry activity is logged

Multiple packages in proposal - client selects one

Activity description shows the specific package name selected by the client

Event auto-created but services fail

Separate error handling; partial success may result in event created without services

Email received from unknown sender

Activity displays sender email address if name is not available

Project Manager is reassigned

New Project Manager gains access to payment activities; previous Project Manager loses access (if they don't have Agency Owner or Admin role)

Contract already countersigned

"Countersign" CTA is hidden or shows "Signed" indicator

User clicks Countersign without signing permissions

Permission denied message is displayed

## **9\. Acceptance Criteria**

### **9.1 Activity Feed Display**

*   AC-1: The Activity tab shall display all project-related activities in reverse chronological order (newest first).
*   AC-2: The activity feed shall never be empty; the project creation activity shall always be present as the first historical entry.
*   AC-3: Each activity entry shall display user avatar, user name, action description, and timestamp.
*   AC-4: Timestamps shall be displayed in the user's local timezone based on their Date & Time Preferences.
*   AC-5: The date and time format shall match the user's configured format preferences.
*   AC-6: The activity feed shall not update in real-time; users must manually refresh to see new activities.

### **9.2 Infinite Scroll**

*   AC-7: The system shall implement infinite scroll to load additional activities as the user scrolls down.
*   AC-8: A loading indicator shall be displayed while fetching additional activities.
*   AC-9: The system shall indicate when no more activities are available to load.
*   AC-10: Scroll position shall be maintained when new activities are loaded.

### **9.3 Activity Types and CTAs**

*   AC-11: All 71 activity types defined in the specification shall be logged appropriately.
*   AC-12: Each activity type shall display the correct CTA buttons as specified.
*   AC-13: Informational activities (without CTAs) shall display without action buttons.
*   AC-14: CTA buttons shall navigate users to the correct related module or item.

### **9.4 File Attachment Preview**

*   AC-15: File-related activities shall display a file attachment preview below the description.
*   AC-16: The file preview shall show file icon, file name, file size, and time since upload.
*   AC-17: The Download button shall initiate file download when clicked.
*   AC-18: Long file names shall truncate with ellipsis and show full name on hover.

### **9.5 Send Reminder Functionality**

*   AC-19: The "Send Reminder" CTA shall be available for overdue invoice and failed payment activities.
*   AC-20: Only Agency Owner, Admin, and Project Manager roles shall be able to send reminders.
*   AC-21: Upon clicking "Send Reminder", the system shall send a payment reminder email to the client.
*   AC-22: A success message shall be displayed upon successful reminder delivery.
*   AC-23: The "Send Reminder" button shall be greyed out immediately after sending.
*   AC-24: A tooltip shall display "Reminder sent on \[timestamp\]" when hovering over the greyed-out button.
*   AC-25: The "Send Reminder" button shall re-enable after exactly 24 hours from the last reminder.
*   AC-26: The cooldown shall apply globally across all users for the same activity entry.

### **9.6 Payment Activities Visibility**

*   AC-27: Payment-related activities (all 12 types) shall only be visible to Agency Owner, Admin, and Project Manager roles.
*   AC-28: The activity count and pagination shall adjust based on the user's role and visible activities.

### **9.7 Contract/Agreement Signing CTAs**

*   AC-29: "Receive signed contract" activity shall display both "View Contract" and "Countersign" CTAs.
*   AC-30: "Contractor signed service agreement" activity shall display both "View Agreement" and "Countersign" CTAs.
*   AC-31: Clicking "Countersign" shall navigate the user to the appropriate module to add their countersignature.
*   AC-32: Once countersigned, the "Countersign" CTA shall be hidden or replaced with a "Signed" indicator.

### **9.8 Activity Types - Admin/Studio Actions**

*   AC-33: Project created, archived, and unarchived activities shall be logged correctly.
*   AC-34: Team member addition and removal activities shall be logged with appropriate CTAs.
*   AC-35: Event-related activities (create, reschedule, venue change, hours change, shooters change, minimum photos change, remove, status update) shall be logged with View Event CTA where applicable.
*   AC-36: File and document upload activities shall display file attachment preview with Download CTA.
*   AC-37: Contract, Questionnaire, Proposal, and Invoice sent activities shall be logged with respective View CTAs.
*   AC-38: Client-related activities shall be logged with appropriate CTAs.
*   AC-39: "Client viewed invoice" activity shall navigate to invoice showing client view indicator in invoice's activity history.
*   AC-40: Service added and removed activities shall be logged with View Services CTA.
*   AC-41: Project Manager changed activity shall be logged as informational without CTA.
*   AC-42: Project total/pricing adjusted activity shall be logged with View CTA that redirects to Finances Tab.

### **9.9 Activity Types - Proposal Activities**

*   AC-43: Proposal sent activity shall be logged when agency sends a proposal to client.
*   AC-44: Proposal viewed activity shall be logged when client opens/views the proposal.
*   AC-45: Proposal accepted activity shall be logged only when all three steps are completed (package selection, contract signing, initial payment).
*   AC-46: Proposal accepted activity description shall include the selected package name.
*   AC-47: Proposal expired activity shall be logged only when expiration date is set, date has passed, and client has not accepted.
*   AC-48: Event and Services auto-created activity shall be logged with View Event and View Services CTAs.

### **9.10 Activity Types - Contractor Actions**

*   AC-49: Contractor assignment and removal activities shall be logged correctly.
*   AC-50: Service agreement activities shall be logged with View Agreement CTA (and Countersign for signed agreements).
*   AC-51: Contractor invoice activities shall display View Invoice and Pay CTAs.
*   AC-52: Task completion and payment activities shall be logged with appropriate CTAs.
*   AC-53: Contractor Event Price adjusted activity shall be logged with View Contractor CTA and include user-provided description.

### **9.11 Activity Types - System-Triggered Events**

*   AC-54: New file uploads shall be logged with View and Download CTAs.
*   AC-55: New email received from client shall be logged with View Email and Reply CTAs.
*   AC-56: Workflow automation triggers (including automated task creation) shall be logged as informational entries.
*   AC-57: Lead form submissions shall be logged with View CTA.
*   AC-58: Meeting scheduled via Calendly shall be logged as informational entry without CTA.

### **9.12 Activity Types - Payment-Related Updates**

*   AC-59: Invoice sent, payment received, and refund activities shall be logged with View Invoice CTA.
*   AC-60: Automated reminder and notice activities shall be logged with View Invoice CTA.
*   AC-61: Failed payment and overdue invoice activities shall be logged with View Invoice and Send Reminder CTAs.

### **9.13 Error Handling**

*   AC-62: Network errors during infinite scroll shall display an error message with Retry option.
*   AC-63: CTAs for deleted items shall be disabled or hidden with appropriate messaging.
*   AC-64: Permission errors shall display appropriate access denied messages.
*   AC-65: Invalid client email errors shall display appropriate messaging when sending reminders.

## **10\. Manual Test Cases**

Test Cases Link: \[Click Here\]

## **11\. Dependencies**

**Dependency Type**

**Dependency Name**

**Description**

**Impact if Unavailable**

Internal Module

Email Center

Destination for email-related CTAs (View Email, Reply)

Email CTAs fail to navigate

Internal Module

Invoice Module

Destination for invoice-related CTAs

Invoice CTAs fail to navigate

Internal Module

Contract Module

Destination for contract-related CTAs and Countersign

Contract CTAs fail to navigate

Internal Module

Service Agreement Module

Destination for agreement-related CTAs and Countersign

Agreement CTAs fail to navigate

Internal Module

Questionnaire Module

Destination for questionnaire-related CTAs

Questionnaire CTAs fail to navigate

Internal Module

Proposal Module

Destination for proposal-related CTAs

Proposal CTAs fail to navigate

Internal Module

File Storage Module

Source for file downloads and previews

File downloads fail

Internal Module

User Management Module

Provides user avatars and names

Avatars display as placeholders

Internal Module

Event Management

Destination for event-related CTAs

Event CTAs fail to navigate

Internal Module

Team Management Module

Destination for team member CTAs

Team member CTAs fail to navigate

Internal Module

Client Management Module

Destination for client-related CTAs

Client CTAs fail to navigate

Internal Module

Contractor Management Module

Destination for contractor-related CTAs

Contractor CTAs fail to navigate

Internal Module

Task Management Module

Destination for task-related CTAs

Task CTAs fail to navigate

Internal Module

Lead Management Module

Destination for lead form submission CTAs

Lead form CTAs fail to navigate

Internal Module

Services Module

Destination for View Services CTA

Services CTAs fail to navigate

Internal Module

Finances Tab

Destination for project pricing View CTA

Pricing CTA fails to navigate

Internal Module

Project Manager Assignment

Determines which user has Project Manager role for payment visibility

Payment visibility may fail

Internal Service

Activity Logging Service

Records all activities to the database

Activities fail to appear in feed

Internal Service

Email Service

Sends reminder emails

Send Reminder functionality fails

External Service

Calendly Integration

Triggers meeting scheduled activities

Meeting activities not logged

External Service

Timezone Service

Converts timestamps to user timezones

Timestamps display in UTC

User Settings

Date & Time Preferences

Provides user's timezone and format preferences

Falls back to system defaults

Internal Module

Automation Engine

Triggers automated activities

Automated activities not logged

Internal Module

Payment Gateway

Processes payments and triggers payment activities

Payment activities not logged

## **12\. References**

### **12.1 Figma Designs**

Link: \[Click Here\]

## **Appendix A: Complete Activity Types Reference (71 Types)**

### **A.1 Admin/Studio Actions (43 Types)**

**#**

**Activity Type**

**CTA(s)**

**Category**

**Description Format**

1

Project created

\---

Informational

"Project '\[Project Name\]' was created"

2

Adding a Team Member to the project

View Team Member

Navigation

"\[User Name\] added \[Team Member Name\] to the project"

3

Removing a Team member from the project

\---

Informational

"\[User Name\] removed \[Team Member Name\] from the project"

4

Project archived

\---

Informational

"\[User Name\] archived the project"

5

Project unarchived

\---

Informational

"\[User Name\] unarchived the project"

6

Event rescheduled

View Event

Navigation

"\[User Name\] rescheduled \[Event Name\] from \[Old Date\] to \[New Date\]"

7

Event venue changed

View Event

Navigation

"\[User Name\] changed \[Event Name\] venue from \[Old Venue\] to \[New Venue\]"

8

Event hours of coverage changed

View Event

Navigation

"\[User Name\] updated hours of coverage for \[Event Name\] from \[Old Hours\] to \[New Hours\]"

9

Number of shooters changed

View Event

Navigation

"\[User Name\] changed number of shooters for \[Event Name\] from \[Old Count\] to \[New Count\]"

10

Minimum photos requirement changed

View Event

Navigation

"\[User Name\] updated minimum photos for \[Event Name\] from \[Old Count\] to \[New Count\]"

11

Event removed from project

\---

Informational

"\[User Name\] removed \[Event Name\] from the project"

12

Deliverable added

\---

Informational

"\[User Name\] added a deliverable to \[Event Name\]"

13

Deliverable edited

\---

Informational

"\[User Name\] edited a deliverable in \[Event Name\]"

14

Deliverable removed

\---

Informational

"\[User Name\] removed a deliverable from \[Event Name\]"

15

Create Event

View Event

Navigation

"\[User Name\] created event '\[Event Name\]'"

16

Adding new services to the project

View Services

Navigation

"\[User Name\] added new services to the project"

17

Service removed from project

View Services

Navigation

"\[User Name\] removed \[Service Name\] from the project"

18

Edit Project

\---

Informational

"\[User Name\] edited the project details"

19

Edit project services

View Services

Navigation

"\[User Name\] edited project services"

20

Project Manager changed

\---

Informational

"\[User Name\] assigned \[New Project Manager Name\] as Project Manager"

21

Project total/pricing adjusted

View

Navigation

"\[User Name\] adjusted project total/pricing" (redirects to Finances Tab)

22

Upload Timeline

View Timeline, Download

Navigation + Action

"\[User Name\] uploaded a timeline"

23

Event status update

View Event

Navigation

"\[User Name\] updated \[Event Name\] status to \[New Status\]"

24

Email sent (by agency user)

View Email

Navigation

"\[User Name\] sent an email to \[Recipient Name\]"

25

Upload files or documents

Download

Action

"\[User Name\] added file to '\[Project Name\]'"

26

Sent Contract

View Contract

Navigation

"\[User Name\] sent Contract for \[Project Name\] to \[Client Name\]" or "\[User Name\] sent Contract for \[Project Name\] to \[Client Name\] +N more"

27

Sent Questionnaire

View Questionnaire

Navigation

"\[User Name\] sent Questionnaire for \[Project Name\] to \[Recipient Name\]" or "\[User Name\] sent Questionnaire for \[Project Name\] to \[Recipient Name\] +N more"

28

Sent Proposal

View Proposal

Navigation

"\[User Name\] sent Proposal for \[Project Name\] to \[Client Name\]"

29

Sent Invoice

View Invoice

Navigation

"\[User Name\] sent Invoice for \[Project Name\] to \[Client Name\]"

30

Receive signed contract

View Contract, Countersign

Navigation + Action

"Received signed contract from \[Client Name\]"

31

Completed Questionnaires

View

Navigation

"\[Client Name\] completed the questionnaire"

32

Primary client changed

View Client

Navigation

"\[User Name\] changed primary client to \[Client Name\]"

33

Client added to the project

View Client

Navigation

"\[User Name\] added \[Client Name\] to the project"

34

Client removed from the project

\---

Informational

"\[User Name\] removed \[Client Name\] from the project"

35

Client viewed invoice

View Invoice

Navigation

"\[Client Name\] viewed Invoice #\[Invoice Number\]"

36

Client uploaded file(s)

Download, View File

Action + Navigation

"\[Client Name\] uploaded file(s)"

37

Event cancelled

\---

Informational

"\[User Name\] cancelled \[Event Name\]"

38

Project cancelled

\---

Informational

"\[User Name\] cancelled the project"

39

SNAPSHOT sent to contractor

\---

Informational

"SNAPSHOT sent to \[Contractor Name\]"

40

Proposal sent to client

View Proposal

Navigation

"\[User Name\] sent Proposal for \[Project Name\] to \[Client Name\]"

41

Proposal viewed by client

View Proposal

Navigation

"\[Client Name\] viewed the Proposal"

42

Proposal accepted

View Proposal

Navigation

"Client accepted Proposal and selected '\[Package Name\]'"

43

Proposal expired

View Proposal

Navigation

"Proposal for \[Project Name\] has expired"

### **A.2 Contractor Actions (10 Types)**

**#**

**Activity Type**

**CTA(s)**

**Category**

**Description Format**

44

Contractor assigned to the event/project

View Contractor

Navigation

"\[Contractor Name\] was assigned to \[Event/Project Name\]"

45

Sent service agreement

View Agreement

Navigation

"Service agreement sent to \[Contractor Name\]"

46

Contractor signed the service agreement

View Agreement, Countersign

Navigation + Action

"\[Contractor Name\] signed the service agreement"

47

Contractor submitted deliverables

View Deliverables

Navigation

"\[Contractor Name\] submitted deliverables for \[Event Name\]"

48

Contractor uploads invoice

View Invoice, Pay

Navigation + Action

"\[Contractor Name\] (Contractor) uploaded invoice \[Invoice Reference\]"

49

Contractor marked task complete

View Task

Navigation

"\[Contractor Name\] marked task '\[Task Name\]' as complete"

50

Agency paid invoice (to contractor)

View Invoice

Navigation

"Paid \[Contractor Name\]'s invoice \[Invoice Reference\]"

51

Manual adjustments to contractor pay

View Payment

Navigation

"\[User Name\] made manual adjustment to \[Contractor Name\]'s pay"

52

Contractor Event Price adjusted

View Contractor

Navigation

"\[User Name\] adjusted \[Contractor Name\]'s event price: '\[User-provided description\]'"

53

Contractor removed from the event/project

\---

Informational

"\[Contractor Name\] was removed from the \[Event/Project Name\]"

### **A.3 System-Triggered Events (6 Types)**

**#**

**Activity Type**

**CTA(s)**

**Category**

**Description Format**

54

New file uploads

View, Download

Navigation + Action

"New file uploaded to '\[Project Name\]'"

55

New email received (from client)

View Email, Reply

Navigation + Action

"\[Client Name\] (Client) sent you an email"

56

Workflow automation triggers

\---

Informational

"\[Automation Name\] triggered: \[Action Description\]"

57

Lead form submissions

View

Navigation

"New lead form submission received"

58

Event and Services created from Proposal

View Event, View Services

Navigation

"Event '\[Event Name\]' and Services were automatically created from Proposal"

59

Meeting scheduled

\---

Informational

"Meeting '\[Meeting Title\]' scheduled with \[Participant Name\] on \[Date/Time\]"

### **A.4 Payment-Related Updates (12 Types) - Visible to Agency Owner, Admin, and Project Manager only**

**#**

**Activity Type**

**CTA(s)**

**Category**

**Description Format**

60

Invoice sent

View Invoice

Navigation

"Invoice #\[Invoice Number\] sent to \[Client Name\]"

61

Payment received

View Invoice

Navigation

"Payment of $\[Amount\] received from \[Client Name\]"

62

Automated invoice reminders sent

View Invoice

Navigation

"Automated reminder sent for Invoice #\[Invoice Number\]"

63

Automated email sent (from automations)

View Email

Navigation

"Automated email sent to \[Recipient Name\]"

64

Automated questionnaire sent

View Questionnaire

Navigation

"Automated questionnaire sent to \[Client Name\]"

65

Automated overdue notice sent

View Invoice

Navigation

"Automated overdue notice sent for Invoice #\[Invoice Number\]"

66

Invoice manually edited

View Invoice

Navigation

"\[User Name\] edited Invoice #\[Invoice Number\]"

67

Partial refund issued

View Invoice

Navigation

"Partial refund of $\[Amount\] issued for Invoice #\[Invoice Number\]"

68

Full refund issued

View Invoice

Navigation

"Full refund issued for Invoice #\[Invoice Number\]"

69

Contractor paid

View Invoice

Navigation

"Payment of $\[Amount\] sent to \[Contractor Name\]"

70

Failed Payment

View Invoice, Send Reminder

Navigation + Action

"Payment failed for Invoice #\[Invoice Number\]"

71

Overdue invoice

View Invoice, Send Reminder

Navigation + Action

"Invoice #\[Invoice Number\] is overdue"

✅ Files/Documents Tab

# **Functional Requirements Document (FRD)**

# **Project Details → Files/Documents Tab**

**Module Name:** Project Details - Files/Documents Tab  
**Version:** 1.2  
**Last Updated:** April 1, 2026  
**Status:** Approved

## **1\. Module Overview**

### **1.1 Module Name**

Project Details - Files/Documents Tab

### **1.2 Purpose**

The Files/Documents Tab serves as a centralized repository for all project-related files and documents. It provides two distinct sections: "Documents & Forms" for system-generated documents created through form builders (contracts, invoices, proposals, questionnaires), and "Uploaded Files" for manually uploaded files by agency users, contractors, and clients. The tab exists at both the Project level and Event level, with specific visibility rules governing cross-level access.

### **1.3 Business Goals**

*   Provide a single location to access all project-related documents and files for improved organization and efficiency.
*   Enable quick creation and sending of smart documents (contracts, proposals, questionnaires, invoices) directly from the project context.
*   Maintain clear separation between system-generated documents and manually uploaded files.
*   Support multi-event projects by maintaining event-level document organization while providing project-level visibility.
*   Ensure appropriate document visibility based on user roles and portal access (Agency, Client, Contractor).
*   Track document lifecycle status (Pending, In Progress, Completed, Expired) for better workflow management.
*   Facilitate collaboration between agency users while maintaining confidentiality from clients and contractors.

### **1.4 Tab Location and Structure**

#### **1.4.1 Tab Location**

The Files/Documents Tab exists at two levels:

**Project Level:**

*   Located within the Project Details page under the horizontal tab navigation
*   Tab order: Activity | **Files/Documents** | Meetings | Finances | Notes | Post Production

**Event Level:**

*   Located within each Event's detail view
*   Tab order: Services | Contractors | Raw Media | **Files/Documents** | Notes | Info

#### **1.4.2 Sub-Tab Structure**

Both Project-level and Event-level Files/Documents tabs contain two sub-tabs:

**Sub-Tab**

**Description**

Documents & Forms

System-generated documents created through form builders

Uploaded Files

Manually uploaded files by users

#### **1.4.3 Default View**

*   Default sub-tab: "Documents & Forms"
*   Default sorting: "Latest" (newest first)
*   Default pagination: 10 rows per page

## **2\. User Roles & Permissions**

### **2.1 Agency Portal Users**

**Role**

**View Files**

**Upload Files**

**Create Smart Files**

**Download**

**Delete Own Files**

**Delete Any File**

Agency Owner

✅ Yes

✅ Yes

✅ Yes

✅ Yes

✅ Yes

✅ Yes

Admin

✅ Yes

✅ Yes

✅ Yes

✅ Yes

✅ Yes

✅ Yes

Project Owner

✅ Yes

✅ Yes

✅ Yes

✅ Yes

✅ Yes

❌ No

Project Manager

✅ Yes

✅ Yes

✅ Yes

✅ Yes

✅ Yes

❌ No

### **2.2 Client Portal Users**

**Action**

**Permission**

View Client Contract

✅ Yes

View Client Questionnaire

✅ Yes

View Proposal

✅ Yes

View Invoice

✅ Yes

View files uploaded by Agency

❌ No

View files uploaded by Contractors

❌ No

View own uploaded files

✅ Yes

Upload files

✅ Yes (Project and Event level)

Download files

✅ Yes (own files and documents sent to them)

Delete files

✅ Yes (own uploaded files only)

### **2.3 Contractor Portal Users**

**Action**

**Permission**

View Service Agreement (for assigned events)

✅ Yes

View Contractor Questionnaire (for assigned events)

✅ Yes

View files uploaded by Agency

❌ No

View files uploaded by Clients

❌ No

View files uploaded by other Contractors

❌ No

View own uploaded files

✅ Yes

Upload files

✅ Yes (Event level only)

Download files

✅ Yes (own files and documents sent to them)

Delete files

✅ Yes (own uploaded files only)

### **2.4 Role-Specific Notes**

*   **Documents & Forms (Smart Documents / System-generated Forms)** refers to documents created through form builders: Contracts (Client Contract, Service Agreement), Proposals, Questionnaires (Client, Contractor), and Invoices.
*   Agency Owner and Admin can delete any file regardless of who uploaded it.
*   Project Owner and Project Manager can only delete files they uploaded themselves.
*   Contractors can only access event-level data; they cannot see project-level documents or files.
*   Files uploaded by agency users are visible only to other agency users (internal files).
*   Files uploaded by contractors are visible only to agency users, not to clients or other contractors.
*   Files uploaded by clients are visible only to agency users, not to contractors.

## **3\. User Flow**

### **3.1 Viewing Documents & Forms**

**3.1.1** The user navigates to the Project Details page and clicks on the "Files/Documents" tab.

**3.1.2** The system displays the Files/Documents tab with "Documents & Forms" sub-tab selected by default.

**3.1.3** The system loads and displays all documents created through form builders in a list view, sorted by latest first.

**3.1.4** Each document entry displays the document icon, document name, event name (if event-level), document type, status badge, created date/time, sent to recipients, and a 3-dot action menu.

**3.1.5** The user clicks on a document row to open the document activity page showing viewers, information collected, and file activity.

**3.1.6** The user clicks the 3-dot menu to access additional actions: View, Download, Copy Link, Delete.

### **3.2 Viewing Uploaded Files**

**3.2.1** The user clicks on the "Uploaded Files" sub-tab.

**3.2.2** The system displays all manually uploaded files in a list view, sorted by latest first.

**3.2.3** Each file entry displays the file icon, file name, event name (if event-level), file type, created date/time, added by (name and role for contractors/clients), and a 3-dot action menu.

**3.2.4** The user clicks on a file row to view the file. For images and PDFs, the file opens in a new browser tab. For Word and Excel files, a modal is displayed with the message "This file can't be previewed. Try downloading it instead." along with a Download button.

**3.2.5** The user clicks the 3-dot menu to access additional actions: View, Download, Delete.

### **3.3 Uploading Files**

**3.3.1** The user clicks the "+" button next to the "Documents" header.

**3.3.2** The system displays the "Add New Document" modal with tabs: Local File, Invoice, Proposal, Contracts, Questionnaire.

**3.3.3** For local file upload, the user selects the "Local File" tab.

**3.3.4** The user drags and drops files into the upload area or clicks to browse and select files.

**3.3.5** The system validates each file for supported type and size (max 15 MB per file, max 15 files per session).

**3.3.6** If validation passes, the user clicks "Upload File" button and the system uploads the files.

**3.3.7** Upon successful upload, the files appear in the "Uploaded Files" sub-tab.

**3.3.8** If validation fails, the system displays an appropriate error message.

### **3.4 Creating Smart Documents**

**3.4.1** The user clicks the "+" button and selects a document type tab (Invoice, Proposal, Contracts, or Questionnaire).

**3.4.2** For Contracts, the user sees two sub-tabs: "Client Contract" and "Service Agreement".

**3.4.3** For Questionnaires, the user sees two sub-tabs: "Client Questionnaires" and "Contractor Questionnaires".

**3.4.4** The user can use the search bar to find specific templates or agreements.

**3.4.5** The system displays available templates for the selected document type.

**3.4.6** The user selects a template and clicks "Review & Send".

**3.4.7** The system opens the form builder for the selected template, allowing the user to customize and send the document.

**3.4.8** Upon sending, the document appears in the "Documents & Forms" sub-tab with status badge "Pending".

### **3.5 Viewing Files**

**3.5.1** The user clicks on a file row or selects "View" from the 3-dot menu.

**3.5.2** For images and PDFs, the system opens the file in a new browser tab.

**3.5.3** For unsupported file types (Word, Excel), the system displays a modal with the file name, "Uploaded On" date, "By" uploader name, the message "This file can't be previewed. Try downloading it instead.", and a Download button.

**3.5.4** The user can download the file directly from the modal by clicking the Download button.

**3.5.5** The user clicks the close button (X) to exit the modal.

### **3.6 Deleting Files**

**3.6.1** The user clicks the 3-dot menu and selects "Delete".

**3.6.2** The system displays a confirmation dialog: "Are you sure you want to delete '\[File Name\]'? This action cannot be undone."

**3.6.3** The user clicks "Delete" to confirm or "Cancel" to abort.

**3.6.4** If confirmed, the system permanently deletes the file and removes it from the list.

**3.6.5** The system displays a success message confirming the deletion.

**3.6.6** Deleted files cannot be recovered.

### **3.7 Copying Document Link**

**3.7.1** The user clicks the 3-dot menu on a document in Documents & Forms and selects "Copy Link".

**3.7.2** The system copies the shareable link to the clipboard.

**3.7.3** The system displays a success message: "Link copied to clipboard."

## **4\. Functional Logic**

### **4.1 Project Level vs Event Level Visibility**

#### **4.1.1 Project-Level Documents & Forms Tab**

*   The system displays all project-level documents (Lead Form, Client Contract, Proposal, Invoice, and Client Questionnaire) when a user navigates to the Documents & Forms tab at the project level.
*   All event-level documents (Service Agreement, Contractor Questionnaire) from every event within the project are also retrieved and displayed at the project level.
*   For event-level documents displayed at the project level, the system shows the event name below the document name to indicate which event the document belongs to.

#### **4.1.2 Project-Level Uploaded Files Tab**

*   The Uploaded Files tab at the project level displays all files uploaded directly at the project level, along with all files uploaded at the event level from every event.
*   Files uploaded by contractors from all events are displayed to agency users at the project level; these files are not visible to clients or other contractors.
*   Files uploaded by clients from both project and event levels are displayed to agency users at the project level; these files are not visible to contractors.
*   Event-level files displayed at the project level show the event name below the file name to indicate their source event.

#### **4.1.3 Event-Level Documents & Forms Tab**

*   The Documents & Forms tab at the event level displays only documents specific to that event, including Service Agreement and Contractor Questionnaire.
*   Project-level documents (Client Contract, Proposal, Invoice, Client Questionnaire, Lead Form) are not displayed at the event level.

#### **4.1.4 Event-Level Uploaded Files Tab**

*   The Uploaded Files tab at the event level displays only files uploaded directly at that specific event.
*   Files uploaded by contractors assigned to that event and files uploaded by clients for that event are included in the event-level view.
*   Project-level uploaded files are not displayed at the event level.

### **4.2 Cross-Level Document Creation**

*   Creating a client-related document (Client Contract, Proposal, Invoice, or Client Questionnaire) from the event level results in the document being created at the project level, since clients are associated with the overall project rather than individual events.
*   Creating a contractor-related document (Service Agreement or Contractor Questionnaire) from the event level results in the document being created at the event level; this document becomes visible at both the event level and the project level.
*   Projects with multiple events require separate service agreements for each event, even if the same contractor is assigned to multiple events.
*   A contractor's signature on a service agreement for one event does not apply to other events; separate signatures are required for each event assignment.

### **4.3 Document Types and Hierarchy**

**Document Type**

**Created At**

**Target Recipient**

**Visible at Project Level**

**Visible at Event Level**

Lead Form

Project (auto)

\---

✅ Yes

❌ No

Client Contract

Project

Client

✅ Yes

❌ No

Client Questionnaire

Project

Client

✅ Yes

❌ No

Proposal

Project

Client

✅ Yes

❌ No

Invoice

Project

Client

✅ Yes

❌ No

Service Agreement

Event

Contractor

✅ Yes

✅ Yes (respective event)

Contractor Questionnaire

Event

Contractor

✅ Yes

✅ Yes (respective event)

### **4.4 Document Status Lifecycle**

*   Documents are assigned a "Pending" status and display a "Pending" badge upon being sent to a client or contractor.
*   The status updates to "In Progress" with an "In Progress" badge once the recipient opens and views the document for the first time.
*   Completing the required action (signing a contract, submitting a questionnaire, or accepting a proposal) triggers a status update to "Completed" with a "Completed" badge.
*   Documents with configured expiration dates automatically transition to "Expired" status with an "Expired" badge if the expiration date passes without recipient completion.
*   The status badge is displayed on the document row in the list view. (Note: This feature requires Figma design update.)

### **4.5 File Upload Rules**

*   Each uploaded file must not exceed 15 MB; files exceeding this limit are rejected with an error message.
*   A maximum of 15 files can be uploaded per session; attempting to upload more than 15 files triggers an error message for the excess files.
*   Supported image formats include .jpeg, .jpg, .webp, and .png; supported document formats include .pdf, .doc, .docx, .xls, and .xlsx.
*   Unsupported file types are rejected with an error message indicating the accepted file formats.
*   Drag-and-drop upload is supported; users can drag files directly into the upload area to initiate the upload process.
*   Duplicate file names are allowed; files with identical names are stored separately without overwriting.
*   No storage limits are enforced per project or per agency; unlimited file storage is permitted.
*   Bulk download functionality is not available in v1; users must download files individually.
*   File renaming functionality is not available; the original file name is retained after upload.

### **4.6 File Visibility Rules (Uploaded Files)**

**Uploaded By**

**Visible to Agency Users**

**Visible to Contractors**

**Visible to Clients**

Agency User

✅ Yes

❌ No

❌ No

Contractor

✅ Yes

❌ No (only uploader sees their own)

❌ No

Client

✅ Yes

❌ No

❌ No (only uploader sees their own)

*   Files uploaded by agency users remain internal and are visible only to other agency users, regardless of whether they are uploaded at the project or event level.
*   Contractor-uploaded files are visible to all agency users and to the uploading contractor only; other contractors and clients cannot view these files.
*   Client-uploaded files are visible to all agency users and to the uploading client only; contractors cannot view these files.
*   Clients accessing the Client Portal can view only the files they have uploaded themselves; agency and contractor uploads are not visible.
*   Contractors accessing the Contractor Portal can view only the files they have uploaded themselves; agency, client, and other contractor uploads are not visible.

### **4.7 Contractor Questionnaire Types**

#### **4.7.1 Post-Event Questionnaires**

*   Post-Event Questionnaires can be configured with an "Automatically send to contractors" toggle, which triggers automatic sending after the event date passes.
*   Contractors receive these questionnaires as part of their post-event workflow, alongside tasks like uploading timelines and files.
*   Detailed sending logic and workflow behavior are documented in the Questionnaires FRD.

#### **4.7.2 General Contractor Questionnaires**

*   General Contractor Questionnaires can be sent manually to contractors at any time, independent of event completion.
*   These questionnaires are not tied to any specific workflow and can be used for any purpose the agency requires.

### **4.8 Add New Document Modal Structure**

#### **4.8.1 Modal Tabs**

*   Clicking the "+" button opens the Add New Document modal with five tabs: Local File, Invoice, Proposal, Contracts, and Questionnaire.
*   The Local File tab displays a file upload area with drag-and-drop support and indicates the maximum file size of 15 MB.
*   The Invoice tab displays available invoice templates created by the agency (e.g., Main Invoice, Client Invoice, Contractor Invoice).
*   The Proposal tab displays available proposal templates created by the agency.
*   The Contracts tab contains two sub-tabs: "Client Contract" for contract templates sent to clients, and "Service Agreement" for agreement templates sent to contractors.
*   The Questionnaire tab contains two sub-tabs: "Client Questionnaires" for questionnaire templates sent to clients, and "Contractor Questionnaires" for templates sent to contractors.
*   The Contractor Questionnaires sub-tab displays two sections: "Post-Event Questionnaires" and "General Contractor Questionnaires".

#### **4.8.2 Search Functionality**

*   A search bar is available in the Contracts and Questionnaire tabs, allowing users to search for specific templates or agreements.
*   Entering a search term filters the displayed list to show only matching templates or agreements.

#### **4.8.3 Template Names**

*   Invoice templates can be given any custom name by the agency (e.g., "Contractor Invoice" is simply a template name).
*   All invoices are sent to clients regardless of their template name; the name does not affect the recipient or document behavior.

### **4.9 Service Agreement Modal Structure**

*   The Service Agreement sub-tab displays agreements grouped by event name, with each event shown as a section header with its name and color indicator.
*   Under each event section, all contractors assigned to that event are listed with their avatar, name, and role (e.g., "Nick Robinson - Photographer").
*   Each contractor entry displays the service agreement name and expiration information (e.g., "Expires in 2 weeks after sending to recipient", "No expiration date", or "Expiration date Aug 17, 2024").
*   A "Review & Send" button is displayed for agreements that have not been sent; clicking this button opens the form builder for review and customization.
*   An "Automatically Sent" badge replaces the "Review & Send" button for agreements that were auto-sent via system settings.
*   Events with no assigned contractors are not displayed in the Service Agreement modal.
*   Search functionality is available within the modal to filter and find specific agreements.

### **4.10 Sorting and Pagination**

*   The default sort order for the Files/Documents tab is "Latest" (newest first).
*   Two sorting options are available via the sort dropdown: "Latest" and "Oldest".
*   Selecting "Oldest" reorders the list to display the oldest items first.
*   The default pagination setting is 10 rows per page.
*   Four pagination options are available: 10, 25, 50, and 100 rows per page.
*   Selecting a different rows-per-page option updates the list accordingly.
*   Search and filter functionality are not available within the Files/Documents tab.

### **4.11 3-Dot Menu Actions**

#### **4.11.1 Documents & Forms Actions**

*   The 3-dot menu on documents provides four actions: View, Download, Copy Link, and Delete.
*   Selecting "View" opens the document activity page, which displays:
    *   Viewer information (who has viewed the document and when)
    *   Information Collected section (form responses if applicable)
    *   File Activity log (creation, sending, viewing events)
    *   "Download PDF" and "View Contract/Document" buttons in the header
*   Selecting "Download" initiates a download of the document to the user's device.
*   Selecting "Copy Link" copies the shareable document link to the clipboard and displays a success confirmation message.
*   Selecting "Delete" triggers a confirmation dialog before proceeding with deletion.

#### **4.11.2 Uploaded Files Actions**

*   The 3-dot menu on uploaded files provides three actions: View, Download, and Delete.
*   Selecting "View" for an image (.jpg, .jpeg, .png, .webp) or PDF opens the file in a new browser tab.
*   Selecting "View" for a Word (.doc, .docx) or Excel (.xls, .xlsx) file displays a modal with the file name, upload date, uploader name, the message "This file can't be previewed. Try downloading it instead.", and a Download button.
*   Selecting "Download" initiates a download of the file to the user's device.
*   Selecting "Delete" triggers a confirmation dialog before proceeding with deletion.

#### **4.11.3 Document Activity Page**

*   The Document Activity Page is displayed when a user selects "View" from the 3-dot menu on a document in the Documents & Forms section, or clicks on a document row.
*   The page header displays:
    *   Back arrow to return to the Files/Documents tab
    *   Document name with status badge (e.g., "In Progress", "Completed", "Pending", "Expired")
    *   "Download PDF" button to download the document
    *   "View \[Document Type\]" button (e.g., "View Contract") to open the full document
*   The page displays a list of viewers showing:
    *   User avatar and name
    *   View status ("Viewed" or "Not viewed")
    *   Last viewed date and time (if viewed) or "N/A" (if not viewed)
*   The "Information Collected" section displays:
    *   Form field responses submitted by the recipient (if applicable)
    *   Empty state message "No information collected yet. Wait until your client complete contract from his side." when no responses exist
*   The "File Activity" section displays a chronological log of events including:
    *   Document creation (e.g., "The contract has been successfully created by \[User Name\]")
    *   Document sending (e.g., "The contract has been successfully sent by \[User Name\]")
    *   Document viewing (e.g., "The contract has been viewed by \[User Name\]")
    *   Document completion/signing (e.g., "The contract has been signed by \[User Name\]")
    *   Each activity entry shows the date and time

### **4.12 File and Document Deletion Logic**

#### **4.12.1 Delete Permissions**

*   Agency Owners and Admins can delete any file or document, regardless of who originally uploaded or created the item.
*   Project Owners and Project Managers can delete only files they uploaded themselves; attempting to delete another user's file results in a permission denied error.
*   Clients can delete only files they uploaded via the Client Portal.
*   Contractors can delete only files they uploaded via the Contractor Portal.

#### **4.12.2 Delete Confirmation**

*   Selecting "Delete" displays a confirmation dialog with the message: "Are you sure you want to delete '\[File/Document Name\]'? This action cannot be undone."
*   Clicking "Delete" in the confirmation dialog proceeds with permanent deletion; clicking "Cancel" closes the dialog without any action.

#### **4.12.3 Permanent Deletion**

*   Deleted files and documents are permanently removed from the database and file storage with no backup copy retained.
*   A success message ("File deleted successfully." or "Document deleted successfully.") is displayed upon successful deletion, and the item is immediately removed from the list view.
*   No recovery option is available because there is no trash or recycle bin feature.

#### **4.12.4 Delete Restrictions (Permission-Based)**

*   Users without sufficient permissions who attempt to delete a file receive an error message: "You do not have permission to delete this file."
*   The Delete option remains visible and clickable in the 3-dot menu for all documents; permission errors are shown upon clicking.

#### **4.12.5 Document-Specific Deletion Restrictions (Status-Based)**

Certain document types have deletion restrictions based on their completion status. These restrictions apply to all users, including Agency Owner and Admin (no role-based override).

**Restricted Documents:**

**Document Type**

**Can Delete**

**Cannot Delete**

**Delete Option Behavior**

Service Agreement

Pending, In Progress

Signed by contractor

Visible; shows restriction dialog

Client Contract

Pending, In Progress

Signed by client

Visible; shows restriction dialog

Proposal

Pending, In Progress

Accepted by client

Visible; shows restriction dialog

Invoice

Pending, In Progress

Any payment received (partial or full)

Visible; shows restriction dialog

Lead Form

—

Never deletable (any status)

Hidden from kebab menu

**Unrestricted Documents:**

**Document Type**

**Deletion Rule**

Client Questionnaire

Always deletable (any status, even if filled/submitted)

Contractor Questionnaire

Always deletable (any status, even if filled/submitted)

**Deletion Restriction Behavior:**

*   The Delete option remains visible and clickable in the 3-dot menu for Service Agreements, Client Contracts, Proposals, and Invoices regardless of their status.
*   When a user clicks Delete on a restricted document (signed/accepted/paid), the system displays a dialog instead of the delete confirmation dialog.
*   The restriction dialog displays:
    *   Message: "This document cannot be deleted as it has already been signed or has payment associated with it."
    *   Close button to dismiss the dialog
*   Clicking the Close button closes the dialog and returns the user to the document list.
*   For Lead Forms, the Delete option is completely hidden from the 3-dot menu; users cannot attempt to delete Lead Forms.
*   This restriction applies to all users including Agency Owner and Admin; no user can override this restriction.

### **4.13 Link Sharing and Expiration**

*   Shareable links can be generated for Documents & Forms via the "Copy Link" action; the link is copied to the clipboard upon selection.
*   Uploaded files do not support link sharing in v1; only smart documents created through form builders can be shared via link.
*   Document expiration is optional and can be enabled via a toggle in the form builder during document creation.
*   Enabling expiration allows the user to set an expiration period (e.g., "2 weeks after sending" or a specific date).
*   Documents automatically transition to "Expired" status once the expiration date passes without recipient completion.
*   Recipients attempting to access an expired document link see the message: "This document has expired. Please contact the sender for a new link."
*   Password protection for shareable links is not available; links are accessible to anyone with the URL.

### **4.14 Empty States**

#### **4.14.1 Documents & Forms - Empty State**

*   An empty Documents & Forms tab displays the message: "No documents yet. Create contracts, invoices, proposals, or questionnaires to share with your clients and contractors."
*   A "+ Create Document" CTA button is displayed, which opens the Add New Document modal when clicked.

#### **4.14.2 Uploaded Files - Empty State**

*   An empty Uploaded Files tab displays the message: "No files uploaded yet. Upload files to keep all your project documents organized in one place."
*   A "+ Upload File" CTA button is displayed, which opens the Add New Document modal with the Local File tab selected when clicked.

### **4.15 File View Behavior**

*   Clicking on an image file (.jpeg, .jpg, .webp, .png) or PDF opens the file in a new browser tab for viewing.
*   Word documents (.doc, .docx) and Excel files (.xls, .xlsx) cannot be viewed directly; selecting "View" displays a modal with the message: "This file can't be previewed. Try downloading it instead."
*   The non-previewable file modal displays:
    *   File name in the top left corner
    *   "Uploaded On \[Date\]" below the file name
    *   "By \[User Name\]" after the upload date
    *   Message: "This file can't be previewed. Try downloading it instead."
    *   A Download button to download the file
    *   A close button (X) in the top right corner
*   Navigation controls to move between files (previous/next) are not available; each file must be viewed individually.
*   Lightbox or gallery view for images is not available; each image opens in a separate browser tab.

### **4.16 Activity Tab Integration**

*   File uploads by any user are logged as activity entries with View and Download CTAs.
*   Document creation (Contract, Questionnaire, Proposal, Invoice) is logged as an activity entry with a View CTA.
*   Sending a document to a client or contractor is logged as an activity entry indicating the document was sent.
*   A recipient viewing a document for the first time is logged as an activity entry indicating the document was viewed.
*   Completing a document action (signing a contract, submitting a questionnaire, accepting a proposal) is logged as an activity entry indicating completion.

### **4.17 Notification Rules**

*   Agency users assigned to a project receive notifications when clients or contractors upload files to that project.
*   Agency users not assigned to the project do not receive upload notifications.
*   Clients receive notifications when an agency user sends them a document (Contract, Questionnaire, Proposal, or Invoice).
*   Contractors receive notifications when an agency user sends them a document (Service Agreement or Contractor Questionnaire).

### **4.18 Data Persistence Rules**

*   Files uploaded by a contractor remain visible to agency users even after the contractor is removed from the event or project.
*   Files uploaded by a client remain visible to agency users even after the client is removed from the project.
*   Files and documents associated with a deleted event are retained at the project level; the event name is replaced with "\[Deleted Event\]" indicator.
*   Deleting an event does not permanently remove event-level files and documents; they remain accessible at the project level.

## **5\. Field Details & Validations**

### **5.1 Documents & Forms - List View Columns**

**Column Name**

**Field Type**

**Description**

Icon

Image

Document type icon (color-coded by type)

Name

Text

Document name; Event name displayed below in smaller text if event-level document

Type

Text

Document type: Invoice, Contract, Proposal, Questionnaire, Survey, Lead Form

Status

Badge

Status indicator: Pending, In Progress, Completed, Expired (Figma update required)

Created

DateTime

Date and time document was created (format: DD MMM YYYY, HH:MM AM/PM)

Sent To

Avatar Group

Avatars of all recipients the document was sent to; "+N" indicator if many recipients

Actions

Menu

3-dot menu with View, Download, Copy Link, Delete

### **5.2 Uploaded Files - List View Columns**

**Column Name**

**Field Type**

**Description**

Icon

Image

File type icon based on extension

Name

Text

File name; Event name displayed below in smaller text if event-level file

Type

Text

File extension in short form (Doc, PDF, JPG, PNG, XLS, etc.)

Created

DateTime

Date and time file was uploaded (format: DD MMM YYYY, HH:MM AM/PM)

Added By

Text + Avatar

User avatar, name, and role; Role displayed in smaller text for Contractor/Client only (not for agency users)

Actions

Menu

3-dot menu with View, Download, Delete

### **5.3 File Upload Validations**

**Field**

**Validation Rule**

**Error Message**

File Type

Must be .jpeg, .jpg, .webp, .png, .pdf, .doc, .docx, .xls, .xlsx

"This file type is not supported. Please upload jpeg, jpg, webp, png, pdf, doc, docx, xls, or xlsx files."

File Size

Must not exceed 15 MB

"File size exceeds the 15 MB limit. Please upload a smaller file."

File Count

Maximum 15 files per upload session

"You can upload a maximum of 15 files at once. Please remove some files and try again."

### **5.4 Non-Previewable File Modal Fields (Word/Excel)**

**Field**

**Position**

**Description**

File Name

Top left

Full name of the file (e.g., "2. Dashboard.docx")

Uploaded On

Below file name

Date the file was uploaded (format: "Uploaded On \[Day\], \[Month\] \[DD\], \[YYYY\]")

By

After upload date

Name of the user who uploaded the file

Message

Center

"This file can't be previewed. Try downloading it instead."

Download Button

Center (below message)

Primary button to download the file

Close Button (X)

Top right corner

Button to close the modal

### **5.5 Add New Document Modal - Local File Tab**

**Field**

**Description**

Upload Area

Drag and drop zone with upload icon and "Upload file" text

Max Size Note

Text below upload area: "Max size of 15 MB"

Cancel Button

Secondary button to close modal

Upload File Button

Primary button to confirm upload

### **5.6 Document Activity Page Fields**

**Section**

**Field**

**Description**

Header

Back Arrow

Returns to Files/Documents tab

Header

Document Name

Name of the document with status badge

Header

Download PDF Button

Downloads the document as PDF

Header

View \[Type\] Button

Opens the full document (e.g., "View Contract")

Viewers List

User Avatar

Profile picture of the viewer

Viewers List

User Name

Name of the viewer (e.g., "Aaron Ramsdale (You)")

Viewers List

View Status

"Viewed" or "Not viewed"

Viewers List

Last Viewed

Date and time of last view, or "N/A"

Information Collected

Form Responses

Responses submitted by recipient (if any)

Information Collected

Empty State

"No information collected yet. Wait until your client complete contract from his side."

File Activity

Activity Entry

Description of activity (e.g., "The contract has been successfully sent by \[User Name\]")

File Activity

Activity Timestamp

Date and time of activity (e.g., "16 Dec 2024 · 1:31 PM")

### **5.7 Deletion Restriction Dialog Fields**

**Field**

**Position**

**Description**

Message

Center

"This document cannot be deleted as it has already been signed or has payment associated with it."

Close Button

Bottom center

Primary button to dismiss the dialog and return to document list

## **6\. Success Message Handling**

**Action**

**Success Message**

**Post-Success Behavior**

Single File Upload

"File uploaded successfully."

File appears in Uploaded Files list

Multiple Files Upload

"\[X\] files uploaded successfully."

Files appear in Uploaded Files list

Document Created

"Document created successfully."

Document appears in Documents & Forms list

Document Sent

"Document sent successfully."

Status changes to "Pending"; recipient notified

File Download

No toast message

File download begins in browser

Link Copied

"Link copied to clipboard."

Link available in clipboard

File Deleted

"File deleted successfully."

File removed from list

Document Deleted

"Document deleted successfully."

Document removed from list

## **7\. Error Message Handling**

**Error Scenario**

**Error Message**

**Trigger Condition**

**User Action Required**

Unsupported File Type

"This file type is not supported. Please upload jpeg, jpg, webp, png, pdf, doc, docx, xls, or xlsx files."

User attempts to upload unsupported file type

Select a supported file type

File Size Exceeded

"File size exceeds the 15 MB limit. Please upload a smaller file."

User attempts to upload file larger than 15 MB

Compress or resize the file

Max Files Exceeded

"You can upload a maximum of 15 files at once. Please remove some files and try again."

User attempts to upload more than 15 files

Reduce number of files

Upload Failed

"Failed to upload file. Please try again."

Network error or server error during upload

Retry the upload

Offline Upload

"You appear to be offline. Please check your connection and try again."

User attempts upload without internet connection

Connect to internet and retry

Large File Timeout

"Upload timed out. Please try again or upload a smaller file."

Upload takes too long due to large file size

Retry or upload smaller file

Corrupted File

"This file appears to be corrupted. Please try uploading a different file."

File is corrupted or invalid

Upload a different file

Preview Not Available

"This file can't be previewed. Try downloading it instead."

User attempts to view Word or Excel file

Download the file to view

Delete Failed

"Failed to delete file. Please try again."

Network error during delete operation

Retry the delete

Permission Denied (Delete)

"You do not have permission to delete this file."

User without delete permission attempts delete

Contact admin if access needed

Document Deletion Restricted

Dialog: "This document cannot be deleted as it has already been signed or has payment associated with it."

User attempts to delete a signed Service Agreement, signed Contract, accepted Proposal, or Invoice with payment

Click Close button to dismiss dialog; document cannot be deleted

Document Expired (Link Access)

"This document has expired. Please contact the sender for a new link."

Recipient accesses expired document link

Contact document sender

Download Failed

"Failed to download file. Please try again."

Network error during download

Retry the download

Copy Link Failed

"Failed to copy link. Please try again."

Clipboard access denied or error

Retry or manually copy URL

## **8\. Edge Cases**

**Edge Case**

**System Behavior**

Duplicate file names uploaded

System auto-renames the new file by appending an incrementing number suffix in parentheses. E.g., if 'Photography' already exists, the new upload is saved as 'Photography(1)'. Subsequent duplicates become 'Photography(2)', etc. Original file remains unchanged; new file stored with suffixed name.

File uploaded while offline

Upload does not proceed; offline error message displayed

Preview requested for Word/Excel file

Modal displayed with "This file can't be previewed. Try downloading it instead." message; user can download

Same contractor assigned to multiple events

Each event has a separate service agreement; all visible at project level; contractor sees each in their portal under respective events

Client uploads file at event level

File visible at both event level and project level for agency users

Contractor uploads file

File created at event level; visible at event level and project level for agency users only

User creates client document from event level

Document is created at project level, not visible at event level

All documents deleted from list

Empty state message displayed with CTA to create document

Maximum pagination reached

Standard pagination behavior; last page indicator shown

User with delete-own-only permission tries to delete others' files

"You do not have permission to delete this file" error displayed

User attempts to delete signed Service Agreement

Restriction dialog displayed with message: "This document cannot be deleted as it has already been signed or has payment associated with it." User clicks Close to dismiss.

User attempts to delete signed Client Contract

Restriction dialog displayed with message: "This document cannot be deleted as it has already been signed or has payment associated with it." User clicks Close to dismiss.

User attempts to delete accepted Proposal

Restriction dialog displayed with message: "This document cannot be deleted as it has already been signed or has payment associated with it." User clicks Close to dismiss.

User attempts to delete Invoice with payment

Restriction dialog displayed with message: "This document cannot be deleted as it has already been signed or has payment associated with it." User clicks Close to dismiss. Applies to both partial and full payments.

User attempts to delete filled Questionnaire

Deletion proceeds normally; questionnaires are always deletable regardless of completion status

Lead Form delete option

Delete option is hidden from the 3-dot menu for Lead Forms; users cannot attempt to delete Lead Forms

Agency Owner/Admin attempts to delete restricted document

Same restriction applies; no role-based override available for signed/paid documents or Lead Forms

Document sent to multiple recipients

All recipient avatars displayed in "Sent To" column with "+N" indicator if overflow

Very long file name

File name truncates with ellipsis; full name shown on hover tooltip

Project has no events

Only project-level documents and files are available; no event-level content

Event has no contractors assigned

Service Agreement tab does not show that event section

Contractor removed from event

Contractor's previously uploaded files remain visible to agency users

Client removed from project

Client's previously uploaded files remain visible to agency users

Event deleted from project

Event-level files/documents remain at project level with "\[Deleted Event\]" shown as event name

Service Agreement auto-sent

"Automatically Sent" badge displayed instead of "Review & Send" button

Expired document in list

"Expired" status badge displayed on the document row

User accesses expired document link

"This document has expired. Please contact the sender for a new link." message displayed

No templates exist for document type

Empty list shown in Add New Document modal for that tab

Search in modal returns no results

"No results found" message displayed in modal

## **9\. Acceptance Criteria**

### **9.1 Tab Structure**

*   AC-1: The Files/Documents tab shall be accessible at both Project level and Event level.
*   AC-2: The tab shall contain two sub-tabs: "Documents & Forms" and "Uploaded Files".
*   AC-3: "Documents & Forms" shall be the default selected sub-tab.
*   AC-4: The list shall be sorted by "Latest" (newest first) by default.

### **9.2 Documents & Forms Display**

*   AC-5: All system-generated documents shall be displayed in the Documents & Forms tab.
*   AC-6: Each document shall display icon, name, type, status badge, created date/time, sent to recipients, and action menu.
*   AC-7: Event-level documents shall display the event name below the document name.
*   AC-8: Document status shall be displayed as a badge (Pending, In Progress, Completed, Expired).

### **9.3 Uploaded Files Display**

*   AC-9: All manually uploaded files shall be displayed in the Uploaded Files tab.
*   AC-10: Each file shall display icon, name, type, created date/time, added by, and action menu.
*   AC-11: "Added By" column shall display user name and role (for Contractor/Client only, not for agency users).
*   AC-12: Event-level files shall display the event name below the file name.

### **9.4 File Upload**

*   AC-13: Users shall be able to upload files up to 15 MB each.
*   AC-14: Users shall be able to upload up to 15 files per upload session.
*   AC-15: Drag and drop upload shall be supported.
*   AC-16: Only supported file types (.jpeg, .jpg, .webp, .png, .pdf, .doc, .docx, .xls, .xlsx) shall be accepted.
*   AC-17: Appropriate error messages shall be displayed for validation failures.
*   AC-18: Duplicate file names shall be allowed.

### **9.5 Smart Document Creation**

*   AC-19: The "Add New Document" modal shall display tabs for Local File, Invoice, Proposal, Contracts, Questionnaire.
*   AC-20: Contracts tab shall have sub-tabs for Client Contract and Service Agreement.
*   AC-21: Questionnaire tab shall have sub-tabs for Client Questionnaires and Contractor Questionnaires.
*   AC-22: Contractor Questionnaires shall have sections for Post-Event and General questionnaires.
*   AC-23: Service Agreement shall be grouped by event with contractors listed under each event.
*   AC-24: Search bar shall be available in Contracts and Questionnaire tabs.
*   AC-25: Creating client documents from event level shall create them at project level.
*   AC-26: Auto-sent service agreements shall display "Automatically Sent" badge instead of "Review & Send" button.

### **9.6 File View**

*   AC-27: Images (.jpeg, .jpg, .webp, .png) and PDFs shall open in a new browser tab when "View" is selected.
*   AC-28: Word and Excel files shall display a modal with "This file can't be previewed. Try downloading it instead." message and a Download button.
*   AC-29: Non-previewable file modal shall display file name, upload date, uploader name, message, Download button, and close button.
*   AC-30: No navigation between files in view mode.

### **9.7 File Actions and Deletion**

*   AC-31: Documents & Forms shall have View, Download, Copy Link, and Delete actions. View action shall open the document activity page.
*   AC-32: Uploaded Files shall have View, Download, and Delete actions.
*   AC-33: Delete action shall require confirmation dialog.
*   AC-34: Agency Owner and Admin shall be able to delete any file.
*   AC-35: Project Owner and Project Manager shall only be able to delete their own uploaded files.
*   AC-36: Deleted files cannot be recovered.
*   AC-37: Users without delete permission shall see "Permission denied" error when attempting to delete others' files.
*   AC-38: Signed Service Agreements shall not be deletable by any user.
*   AC-39: Signed Client Contracts shall not be deletable by any user.
*   AC-40: Accepted Proposals shall not be deletable by any user.
*   AC-41: Invoices with any payment (partial or full) shall not be deletable by any user.
*   AC-42: Client Questionnaires shall be deletable regardless of completion status.
*   AC-43: Contractor Questionnaires shall be deletable regardless of completion status.
*   AC-44: Lead Forms shall not be deletable; Delete option shall be hidden from the kebab menu.
*   AC-45: Delete option shall remain visible and clickable for Service Agreements, Client Contracts, Proposals, and Invoices; restriction dialog shall be shown when attempting to delete restricted documents.
*   AC-46: Restriction dialog shall display message: "This document cannot be deleted as it has already been signed or has payment associated with it." with a Close button.

### **9.8 Project vs Event Level Visibility**

*   AC-47: Project-level tab shall display all project-level and event-level documents and files.
*   AC-48: Event-level tab shall only display documents and files specific to that event.
*   AC-49: Project-level documents shall not appear at event level.
*   AC-50: Event-level documents and files shall be visible at both levels with event name displayed.

### **9.9 Cross-Portal Visibility**

*   AC-51: Agency-uploaded files shall only be visible to agency users.
*   AC-52: Contractor-uploaded files shall only be visible to agency users and the uploading contractor.
*   AC-53: Client-uploaded files shall only be visible to agency users and the uploading client.
*   AC-54: Contractors shall not see files uploaded by clients or other contractors.
*   AC-55: Clients shall not see files uploaded by contractors or agency users.

### **9.10 Data Persistence**

*   AC-56: Files uploaded by removed contractors shall remain visible to agency users.
*   AC-57: Files uploaded by removed clients shall remain visible to agency users.
*   AC-58: Files from deleted events shall remain at project level with "\[Deleted Event\]" indicator.

### **9.11 Pagination and Sorting**

*   AC-59: Default pagination shall be 10 rows per page.
*   AC-60: Pagination options shall include 10, 25, 50, 100.
*   AC-61: Sorting options shall include Latest (default) and Oldest.

### **9.12 Notifications**

*   AC-62: Agency users who are part of the project shall receive notifications when clients or contractors upload files.
*   AC-63: Clients and contractors shall receive notifications when agency sends them documents.

### **9.13 Link Sharing and Expiration**

*   AC-64: Shareable links shall be available for Documents & Forms only (not Uploaded Files).
*   AC-65: Expired document links shall display appropriate expiration message.
*   AC-66: Copy Link action shall copy link to clipboard with success confirmation.

### **9.14 Error Handling**

*   AC-67: Appropriate error messages shall be displayed for all error scenarios as defined in Section 7.
*   AC-68: Offline upload attempts shall be prevented with appropriate messaging.
*   AC-69: Corrupted or invalid files shall be rejected with error message.

## **10\. Manual Test Cases**

Test cases: Click Here

## **11\. Dependencies**

**Dependency Type**

**Dependency Name**

**Description**

**Impact if Unavailable**

Internal Module

Lead Form Module

Source for auto-added lead forms

Lead forms not displayed

Internal Module

Contract Module

Form builder for client contracts

Cannot create client contracts

Internal Module

Service Agreement Module

Form builder for service agreements

Cannot create service agreements

Internal Module

Proposal Module

Form builder for proposals

Cannot create proposals

Internal Module

Invoice Module

Form builder for invoices

Cannot create invoices

Internal Module

Questionnaire Module

Form builder for questionnaires

Cannot create questionnaires

Internal Module

Event Management

Event data for event-level documents

Event association fails

Internal Module

Contractor Management

Contractor data for service agreements

Cannot assign agreements to contractors

Internal Module

Client Management

Client data for client documents

Cannot associate documents with clients

Internal Module

Activity Tab

Logs file-related activities

Activity logging fails

Internal Service

File Storage Service

Stores uploaded files

File upload/download fails

Internal Service

Notification Service

Sends upload/document notifications

Notifications not sent

External Service

Email Service

Sends document links to recipients

Document sending fails

User Settings

Date & Time Preferences

Formats timestamps

Falls back to system defaults

## **12\. References**

*   Figma Link:

## **Appendix A: Document Type Reference**

### **A.1 Client-Facing Documents (Project Level)**

**Document Type**

**Created Via**

**Recipient**

**Visible at Project**

**Visible at Event**

**Status Tracking**

**Expiration**

Lead Form

Auto (Lead submission)

\---

✅ Yes

❌ No

N/A

No

Client Contract

Form Builder

Client

✅ Yes

❌ No

✅ Yes

Optional

Client Questionnaire

Form Builder

Client

✅ Yes

❌ No

✅ Yes

Optional

Proposal

Form Builder

Client

✅ Yes

❌ No

✅ Yes

Optional

Invoice

Form Builder

Client

✅ Yes

❌ No

✅ Yes

No

### **A.2 Contractor-Facing Documents (Event Level)**

**Document Type**

**Created Via**

**Recipient**

**Visible at Project**

**Visible at Event**

**Status Tracking**

**Expiration**

Service Agreement

Form Builder

Contractor

✅ Yes (with event name)

✅ Yes

✅ Yes

Optional

Post-Event Questionnaire

Form Builder (auto-send option)

Contractor

✅ Yes (with event name)

✅ Yes

✅ Yes

Optional

General Contractor Questionnaire

Form Builder

Contractor

✅ Yes (with event name)

✅ Yes

✅ Yes

Optional

### **A.3 Uploaded Files Visibility Matrix**

**Uploaded By**

**Upload Level**

**Visible at Project Level**

**Visible at Event Level**

**Visible to Agency**

**Visible to Client**

**Visible to Contractor**

Agency User

Project

✅ Yes

❌ No

✅ Yes

❌ No

❌ No

Agency User

Event

✅ Yes (with event name)

✅ Yes

✅ Yes

❌ No

❌ No

Client

Project

✅ Yes

❌ No

✅ Yes

✅ Own only

❌ No

Client

Event

✅ Yes (with event name)

✅ Yes

✅ Yes

✅ Own only

❌ No

Contractor

Event

✅ Yes (with event name)

✅ Yes

✅ Yes

❌ No

✅ Own only

☑️ Finance Tab

# **Functional Requirements Document (FRD) Project Overview > Finance Tab**

## **Document Information**

**Attribute**

**Details**

**Module Name**

Project Overview > Finance Tab

**Version**

1.0

**Created Date**

December 24, 2025

## **1\. Module Overview**

### **1.1 Module Name**

Project Overview > Finance Tab

### **1.2 Purpose**

The Finance Tab provides a comprehensive financial dashboard within the Project Details module, displaying all financial information related to a project. It consolidates income (payments received from clients) and expenses (payments made to contractors) into a single view, enabling agency owners and administrators to monitor project profitability, track payment statuses, and manage financial transactions efficiently.

### **1.3 Business Goals**

*   Provide a centralized view of all project-related financial data for agency owners and administrators.
*   Enable real-time tracking of client payments and contractor expenses within a project context.
*   Calculate and display project profitability metrics including total revenue, expenses, and profit margins.
*   Streamline payment management by allowing users to initiate, track, and reconcile payments from a single interface.
*   Improve financial visibility by displaying payment statuses, due dates, and outstanding balances.
*   Support informed decision-making through accurate financial summaries tied to project performance.

## **2\. User Roles & Permissions**

**Role**

**View Finance Tab**

**View Financial Summary**

**View Client Payments**

**View Contractor Payments**

**Create Invoice**

**Mark as Paid**

**Process Refund**

**Make Payment to Contractor**

**Ask for Refund from Contractor**

Agency Owner

✓

✓

✓

✓

✓

✓

✓

✓

✓

Admin

✓

✓

✓

✓

✓

✗

✗

✗

✗

**Note:** Only Agency Owner and Admin roles have access to the Finance Tab. Other roles do not have visibility into project financial data.

## **3\. User Flow**

3.1 The user navigates to the Projects module from the left sidebar menu.

3.2 The system displays the list of all projects available to the user based on their permissions.

3.3 The user clicks on a specific project to open the Project Details page.

3.4 The system loads the Project Details page with the Overview tab selected by default, displaying event cards and tab navigation.

3.5 The user clicks on the "Finances" tab from the tab navigation bar (Activity | Files/Documents | Meetings | Finances | Notes | Post Production).

3.6 The system loads the Finance Tab and displays the Financial Summary section with Total Project Price, Remaining Balance Due, Total Expenses, and Total Margin/Profit.

3.7 The system displays the "Create Invoice" CTA button below the Financial Summary section.

3.8 The system loads and displays the "Payments from Client" section showing all client payment records in a tabular format.

3.9 The system loads and displays the "Payments to Contractors" section showing all contractor payment records with their respective event assignments.

3.10 The user reviews the Financial Summary to understand the overall project financial health.

3.11 The user scrolls down to view detailed payment records from clients and payments to contractors.

3.12 The user clicks on a payment row's kebab menu to access available actions based on the payment status.

3.13 The system displays the appropriate action options based on the selected payment's current status.

3.14 The user performs the desired action (View Invoice, Mark as Paid, Refund, Make Payment, etc.).

3.15 The system processes the action and updates the payment status and financial calculations accordingly.

3.16 The user clicks on "Amount Paid" in the Payments to Contractors section to view the contractor's payment history.

3.17 The system opens the Payment History modal, displaying all payment transactions for the selected contractor.

3.18 The user reviews the payment history details, including issue date, paid date, payment method, amount, and status.

3.19 The user clicks "View Invoice" to view a specific contractor invoice in PDF preview modal.

3.20 The user clicks "Close" button to close the Payment History modal and return to the Finance Tab.

3.21 The user clicks "View All" link in the Payments from Client section to navigate to the Billing > Transactions tab with the project filter applied.

##

##

## **4\. Functional Logic**

### **4.1 Empty States**

#### **4.1.1 No Proposal and No Invoice State**

*   When no proposal has been sent and no invoice has been created for the project, the system displays the Financial Summary section with all values showing $0.00.
*   The system displays an empty state message: "No proposal or invoice has been created for this project yet. Send a proposal or create an invoice to start tracking finances."
*   The empty state includes a "Create Invoice" CTA button and optionally a "Send Proposal" CTA button to guide the user.
*   The "Payments from Client" section displays the message: "No payments scheduled. Create an invoice or send a proposal to set up a payment schedule."
*   The "Payments to Contractors" section displays the message: "No contractors have been assigned yet. Assign a contractor to an event to track payments."

#### **4.1.2 Proposal Sent but Not Signed State**

*   When a proposal has been sent to the client but not yet signed, the system displays the Financial Summary section with values based on the proposal amounts (as projected figures).
*   The system displays a status message: "Awaiting client to sign the proposal contract."
*   The "Payments from Client" section displays the projected payment schedule from the proposal with all statuses showing as "Unpaid."
*   Once the client signs the proposal, the system updates all financial calculations and payment schedules accordingly.

#### **4.1.3 No Contractors Assigned State**

*   When no contractors have been assigned to any event within the project, the "Payments to Contractors" section displays an empty state.
*   The system displays the message: "No contractors have been assigned yet. Assign a contractor to an event to track payments."
*   The Total Expenses in the Financial Summary show $0.00.
*   The Total Margin/Profit equals the Total Project Price when no contractors are assigned.

### **4.2 Financial Summary Section**

#### **4.2.1 Total Project Price Calculation**

*   The Total Project Price represents the total amount the client will pay to the agency for the entire project.
*   If the client has signed a Proposal, the Total Project Price is calculated as the sum of the selected package price and all selected A la carte items price from the signed proposal.
*   If the client has not signed any proposal, the Total Project Price is determined by the sum of all invoices sent by the agency to the client for that project.
*   If multiple invoices exist for a project without a signed proposal, the system calculates the Total Project Price as the sum of all invoice amounts.
*   If an invoice is voided (due to project deletion) or removed/deleted, the corresponding invoice amount is deducted from the Total Project Price.
*   If the client has signed a proposal and the agency sends additional service invoices for services beyond the original proposal scope, the Total Project Price is calculated as: (Price of Selected Package) + (Price of Selected À La Carte Items) + (Sum of All Additional Service Invoices).
*   The Total Project Price updates in real-time whenever new invoices are created, existing invoices are modified, or invoices are voided/deleted.
*   The system displays the Total Project Price in USD currency format with two decimal places.

#### **4.2.2 Remaining Balance Due Calculation**

*   The Remaining Balance Due represents the outstanding amount the client has yet to pay to the agency.
*   The system calculates the Remaining Balance Due using the formula: Total Project Price - Total Amount Paid by Client.
*   The Total Amount Paid by Client is the sum of all successful payment transactions received from the client across all payment schedules.
*   If the client has made multiple partial payments, the system sums all individual payment amounts to determine the total paid.
*   When a refund is processed for a client payment, the refunded amount is added back to the Remaining Balance Due.
*   The Remaining Balance Due cannot be negative; if overpayment occurs, the system tracks it separately for refund processing.
*   The system updates the Remaining Balance Due in real-time after each successful payment or refund transaction.

#### **4.2.3 Total Expenses Calculation**

*   The Total Expenses represent the total expenditure the agency incurs to complete the project successfully.
*   The system calculates Total Expenses as the sum of all contractor fees (Event Prices) for all contractors assigned to all events within the project.
*   For each contractor, the Event Price is the agreed-upon amount the agency committed to pay when assigning the contractor to an event.
*   If a contractor has not been paid yet (Amount Paid = $0), their full Event Price is still counted toward Total Expenses.
*   If a contractor is paid less than their agreed Event Price, the system uses the agreed Event Price (not the actual paid amount) for expense calculation.
*   If a contractor is paid more than their agreed Event Price (overage), the system uses the actual paid amount instead of the original Event Price for expense calculation.
*   When a contractor is unassigned from an event and has not received any payment, the entire Event Price is deducted from Total Expenses.
*   When a contractor is unassigned from an event after receiving partial or full payment without refund, only the actual Amount Paid is retained in Total Expenses.
*   The system recalculates Total Expenses dynamically whenever contractors are assigned, unassigned, or payments are processed.

#### **4.2.4 Total Margin/Profit Calculation**

*   The Total Margin/Profit represents the agency's profit from the project after accounting for all contractor expenses.
*   The system calculates Total Margin/Profit using the formula: Total Project Price - Total Expenses.
*   The Total Margin/Profit can be negative if Total Expenses exceed the Total Project Price.
*   The system displays the Total Margin/Profit in USD currency format with appropriate positive/negative indication.
*   The Total Margin/Profit updates automatically whenever Total Project Price or Total Expenses change.

#### **4.2.5 Create Invoice CTA**

*   The "Create Invoice" button is displayed below the Financial Summary section.
*   When the user clicks the "Create Invoice" button, the system redirects them to the Invoice Builder module.
*   The Invoice Builder is pre-populated with the current project context to streamline invoice creation.
*   The "Create Invoice" button is always visible and enabled for Agency Owner and Admin roles.

### **4.3 Payments from Client Section**

#### **4.3.1 Section Overview**

*   The "Payments from Client" section displays all payment records associated with the project in a tabular format.
*   Payments are derived from the payment schedule defined in the signed Proposal or manually created Invoices.
*   The section displays columns: Status, Payment Date, Due Date, Amount, Action.
*   The default sort order is by Due Date in ascending order (earliest due date first).
*   All columns are sortable except status and action column; users can click on column headers to change the sort order.

#### **4.3.2 Payment Statuses**

*   **Unpaid**: The initial state for all scheduled payments awaiting client action; no payment has been initiated.
*   **Processing**: The payment has been initiated by the client and is awaiting confirmation from the payment gateway.
*   **Paid**: The payment has been successfully completed, and funds have been received.
*   **Overdue**: The payment due date has passed, and the payment status is either Unpaid or Failed; status changes immediately when the due date passes with no grace period.
*   **Failed**: The payment attempt was unsuccessful due to a declined card, insufficient funds, or other payment gateway errors.
*   **Refunded**: A full refund has been processed for the payment; for partial refunds, the status remains "Paid" with a note indicating partial refund details.

#### **4.3.3 Status Visual Indicators**

*   **Unpaid**: Gray badge/text
*   **Processing**: Yellow/amber badge with processing indicator
*   **Paid**: Green badge
*   **Overdue**: Red badge
*   **Failed**: Red badge with error indicator
*   **Refunded**: Purple/gray badge

#### **4.3.4 Kebab Menu Actions by Status**

**Status**

**Available Actions**

Unpaid

View Invoice, Download Invoice, Mark as Paid

Processing

View Invoice, Download Invoice

Paid

View Invoice, Download Invoice, Refund

Overdue

View Invoice, Download Invoice, Mark as Paid

Failed

View Invoice, Download Invoice, Mark as Paid

Refunded

View Invoice, Download Invoice

#### **4.3.5 Action Behaviors**

*   **View Invoice**: Redirects the user to the Invoice Details page for the selected payment's associated invoice.
*   **Download Invoice**: Downloads the invoice as a PDF file to the user's device.
*   **Mark as Paid**: Opens a modal allowing the user to manually mark the payment as paid, requiring selection of payment method and mandatory note entry.
*   **Refund**: For online payments (processed through Stripe), initiates an automatic refund through Stripe; for manual payments, opens a modal to mark as refunded with a mandatory note for the refund reason; updates the Remaining Balance Due by adding back the refunded amount.

#### **4.3.6 Notes Feature**

*   Notes can be added when performing the "Mark as Paid" action to record how the payment was received (e.g., "Paid via check #1234").
*   Notes can be added when performing the "Refund" action to record the reason for the refund (e.g., "Refunding overpayment by customer").
*   Notes are displayed via a tooltip icon on the payment row when a note exists.
*   Users can hover over the note icon to view the full note content.

#### **4.3.7 View All Link**

*   The "View All" link is displayed at the bottom of the Payments from Client section.
*   When clicked, the system redirects the user to the Billing > Transactions tab.
*   The Transactions tab is automatically filtered to show only transactions for the current project.

### **4.4 Payments to Contractors Section**

#### **4.4.1 Section Overview**

*   The "Payments to Contractors" section displays all contractors assigned to events within the project.
*   Each contractor row shows: Contractor Avatar, Contractor Name, Role, Event Name, Event Price, Amount Paid, Status, Action Icons, and Kebab Menu.
*   If the same contractor is assigned to multiple events within the project, they appear as separate line items with their respective event names.
*   The section displays all contractor assignments regardless of payment status.

#### **4.4.2 Column Details**

*   **Contractor**: Displays the contractor's profile avatar, full name, and role (e.g., "Photographer," "Videographer").
*   **Event**: Displays the name of the event the contractor is assigned to (e.g., "Rehearsal Dinner," "Wedding," "Engagement Photoshoot").
*   **Event Price**: Displays the agreed-upon contractor fee for the specific event assignment.
*   **Amount Paid**: Displays the total amount paid to the contractor so far; clicking this field opens the Payment History modal.
*   **Status**: Displays the current payment status for the contractor.
*   **Action Icons**: Three icons indicating invoice upload status, deliverables upload status, and payment status.
*   **Actions**: Kebab menu with available actions based on status.

**4.4.3 Kebab Menu Actions**

The kebab menu (⋮) provides a single action regardless of contractor payment status:

*   **View Invoice History** – Opens a view of all invoices submitted by the contractor.

**4.4.6 Action Behaviors**

*   **View Invoice History:** Opens the Invoice History Modal.

**4.5 Invoice History Modal**

**4.5.1 Modal Trigger**

The Invoice History modal can be opened in two ways:

*   Clicking on the "Amount Paid" value in the Payments to Contractors section.
*   Selecting "View Invoice History" from the kebab menu (⋮) on a contractor row.

The modal displays all invoice transactions for the selected contractor on the specific event assignment.

**4.5.2 Modal Content**

*   **Modal Title:** "Invoice History"
*   **Close Button (X):** Located in the top-right corner; closes the modal immediately and returns to the Finance Tab.
*   **Columns:** Issued, Paid, Payment Method, Amount, Status, Note Icon, and Actions.
*   All columns are sortable except Status and Actions; users can click on column headers to change sort order.

**4.5.3 Column Details**

*   **Issued:** The date when the invoice was issued (format: MMM DD, YYYY).
*   **Paid:** The date when the payment was completed/confirmed (format: MMM DD, YYYY). Blank if unpaid.
*   **Payment Method:** The method used for payment (Bank Transfer, Cash, Check, Zelle, PayPal, Venmo, Google Pay, Apple Pay).
*   **Amount:** The invoice amount in USD.
*   **Status:** The status of the individual invoice transaction — Paid, Failed, Unpaid, or Processing.
*   **Note Icon:** Displays when a note exists for the transaction (e.g., when marked as paid manually); hovering shows the note content.
*   **Actions:** Context-sensitive action buttons that vary based on the invoice status (see 4.5.4).

**4.5.4 Actions by Status**

**Status**

**Available Actions**

Paid

View Invoice, Ask for Refund

Failed

Pay, Mark as Paid, View Invoice

Unpaid

Pay, Mark as Paid, View Invoice

Processing

View Invoice

**4.5.5 Action Behaviors**

*   **View Invoice:** Opens the contractor's uploaded invoice in a PDF preview modal.
*   **Pay:** Redirects the user to the "Pay Contractor" pop-up as displayed in Finance > Contractor Invoices module when the "Pay" button is clicked.
*   **Mark as Paid:** Opens a modal allowing the user to manually mark the invoice as paid, requiring selection of payment method and mandatory note entry.
*   **Ask for Refund:** Sends an email notification and in-app notification to the contractor requesting them to process a refund through their Stripe account.

**4.5.6 Modal Actions**

*   **Close Button:** Yellow button at the bottom-right of the modal; closes the modal and returns to the Finance Tab.

### **4.6 Real-time Updates and Calculations**

*   All financial calculations (Total Project Price, Remaining Balance Due, Total Expenses, Total Margin/Profit) update in real-time when underlying data changes.
*   Payment statuses update automatically based on payment gateway responses and due date comparisons.
*   The Finance Tab reflects the latest data each time it is loaded or when actions are performed.
*   No manual refresh is required to see updated financial information after performing actions.

## **5\. Field Details & Validations**

### **5.1 Financial Summary Fields**

**Field Name**

**Field Type**

**Required**

**Validation Rules**

**Description**

Total Project Price

Currency (Display)

Yes

Positive number or zero; USD format with 2 decimal places

Total amount client will pay for the project

Remaining Balance Due

Currency (Display)

Yes

Non-negative number; USD format with 2 decimal places

Outstanding amount client has yet to pay

Total Expenses

Currency (Display)

Yes

Positive number or zero; USD format with 2 decimal places

Total contractor fees for all assigned contractors

Total Margin/Profit

Currency (Display)

Yes

Can be positive or negative; USD format with 2 decimal places

Calculated profit (Total Project Price - Total Expenses)

### **5.2 Payments from Client Table Fields**

**Field Name**

**Field Type**

**Required**

**Validation Rules**

**Description**

Status

Badge/Tag

Yes

Must be one of: Unpaid, Processing, Paid, Overdue, Failed, Refunded

Current payment status

Payment Date

Date (Display)

Conditional

Format: MM/DD/YY HH:MM AM/PM; displayed only when payment is made

Date and time payment was received

Due Date

Date (Display)

Yes

Format: MM/DD/YY HH:MM AM/PM

Scheduled payment due date

Amount

Currency (Display)

Yes

Positive number; USD format with 2 decimal places

Payment amount

Action

Kebab Menu

Yes

Actions vary by status

Available actions for the payment

###

### **5.3 Payments to Contractors Table Fields**

**Field Name**

**Field Type**

**Required**

**Validation Rules**

**Description**

Contractor Avatar

Image

Yes

Default avatar if not uploaded

Contractor profile picture

Contractor Name

Text (Display)

Yes

Max 100 characters

Full name of contractor

Contractor Role

Text (Display)

Yes

Max 50 characters

Contractor's role/service type

Event

Text (Display)

Yes

Max 100 characters

Name of assigned event

Event Price

Currency (Display)

Yes

Positive number; USD format with 2 decimal places

Agreed contractor fee for the event

Amount Paid

Currency (Clickable)

Yes

Non-negative number; USD format with 2 decimal places

Total amount paid to contractor

Status

Badge/Tag

Yes

Must be one of: Unpaid, Processing, Paid, Overdue, Failed

Contractor payment status

Invoice Icon

Icon (Display)

Yes

Filled or empty state

Indicates if invoice is uploaded

Deliverables Icon

Icon (Display)

Yes

Filled or empty state

Indicates if deliverables are uploaded

Payment Icon

Icon (Display)

Yes

Empty, half-filled, or filled state

Visual payment progress indicator

Action

Kebab Menu

Yes

Actions vary by status

Available actions for the payment

###

### **5.4 Payment History Modal Fields (Payment to Contractors)**

**Field Name**

**Field Type**

**Required**

**Validation Rules**

**Description**

Issued

Date (Display)

Yes

Format: MMM DD, YYYY

Date payment was issued

Paid

Date (Display)

Yes

Format: MMM DD, YYYY

Date payment was completed

Payment Method

Text (Display)

Yes

One of: Bank Transfer, Cash, Check, Zelle, PayPal, Venmo, Google Pay, Apple Pay

Method used for payment

Amount

Currency (Display)

Yes

Positive number; USD format with 2 decimal places

Payment amount

Status

Badge/Tag

Yes

Must be: Paid

Payment status

Note Icon

Icon (Hover)

Conditional

Displayed when note exists

Hover to view note content

View Invoice

Link

Yes

Opens PDF preview modal

Link to view invoice

### **5.5 Mark as Paid Modal Fields**

**Field Name**

**Field Type**

**Required**

**Validation Rules**

**Description**

Payment Method

Dropdown

Yes

Must select one of: Cash, Check, Zelle, PayPal, Venmo, Google Pay, Apple Pay

Method used for offline payment

Note

Text Area

Yes

Min 1 character; Max 500 characters

Description of how payment was received

### **5.6 Refund Modal Fields**

**Field Name**

**Field Type**

**Required**

**Validation Rules**

**Description**

Refund Reason

Text Area

Yes

Min 1 character; Max 500 characters

Reason for processing the refund

## **6\. Success Message Handling**

**Action**

**Success Message**

**Trigger Condition**

**Post-Success Action**

Mark as Paid (Client)

"Payment has been successfully marked as paid."

User submits Mark as Paid form with valid payment method and note

Payment status updates to "Paid"; Remaining Balance Due recalculates; Payment row refreshes

Mark as Paid (Contractor)

"Contractor payment has been successfully marked as paid."

User submits Mark as Paid form with valid payment method and note

Payment status updates to "Paid"; Amount Paid updates; Payment icon fills accordingly

Refund Processed (Online)

"Refund has been successfully processed through Stripe."

Stripe refund API returns success

Payment status updates to "Refunded"; Remaining Balance Due increases; Payment row refreshes

Refund Processed (Manual)

"Payment has been marked as refunded."

User submits refund reason for manual payment

Payment status updates to "Refunded"; Remaining Balance Due increases; Payment row refreshes

Ask for Refund (Contractor)

"Refund request has been sent to the contractor."

System successfully sends email and in-app notification

Notification sent to contractor; No immediate status change

Make Payment (Contractor)

"Payment has been successfully processed."

Payment gateway returns success

Payment status updates; Amount Paid increases; Payment icon updates

Invoice Downloaded

"Invoice downloaded successfully."

PDF file download completes

Invoice PDF saved to user's device

## **7\. Error Message Handling**

**Scenario**

**Error Message**

**Trigger Condition**

**User Action Required**

**System Response**

Refund Failed (Stripe)

"Refund could not be processed. Please try again or contact support."

Stripe API returns error

Retry refund or contact support

Display error; Log error details; Retain original payment status

Payment Processing Failed

"Payment could not be processed. Please verify payment details and try again."

Payment gateway returns decline/error

Verify payment details; Retry payment

Display error; Status changes to "Failed"

Mark as Paid - Missing Payment Method

"Please select a payment method."

User attempts to submit without selecting payment method

Select a payment method

Prevent form submission; Highlight required field

Mark as Paid - Missing Note

"Please enter a note describing the payment."

User attempts to submit without entering note

Enter payment note

Prevent form submission; Highlight required field

Refund - Missing Reason

"Please enter a reason for the refund."

User attempts to submit refund without reason

Enter refund reason

Prevent form submission; Highlight required field

Invoice Not Found

"Invoice not found. The invoice may have been deleted."

User clicks View Invoice for deleted invoice

Contact administrator

Display error; Close action menu

Contractor Invoice Not Uploaded

"Contractor has not uploaded an invoice yet."

User clicks View Invoice when no invoice exists

Wait for contractor to upload invoice

Display informational message

Network Error

"Unable to connect. Please check your internet connection and try again."

API request fails due to network issues

Check connection; Retry action

Display error; Retain current state

Session Expired

"Your session has expired. Please log in again."

User session timeout

Log in again

Redirect to login page

Insufficient Permissions

"You do not have permission to perform this action."

Non-authorized role attempts action

Contact administrator

Display error; Prevent action

Partial Refund Exceeds Paid Amount

"Refund amount cannot exceed the paid amount."

Partial refund amount is greater than payment received

Enter valid refund amount

Prevent refund submission

## **8\. Edge Cases**

**#**

**Edge Case Scenario**

**System Behavior**

**Expected Outcome**

1

Contractor assigned to multiple events in same project

System displays separate line items for each event assignment with respective Event Name, Event Price, and Amount Paid

Each assignment tracked independently

2

Same contractor assigned to same event twice (duplicate)

System prevents duplicate assignment at assignment level

Error message displayed during assignment

3

Contractor unassigned after receiving partial payment, no refund

System retains only the Amount Paid as expense; deducts remaining Event Price from Total Expenses

Total Expenses reflects actual expenditure

4

Contractor unassigned before any payment made

System deducts entire Event Price from Total Expenses

Total Expenses recalculates to exclude unassigned contractor

5

Contractor paid more than Event Price (overage)

System uses actual Amount Paid instead of Event Price for expense calculation

Total Expenses reflects actual overpayment

6

Client makes overpayment

System tracks overpayment; Remaining Balance Due shows $0.00 or negative (credit)

Agency can process refund for excess amount

7

All invoices voided (project deleted)

System sets Total Project Price to $0.00; historical payments retained for audit

Financial Summary shows $0.00; payment history preserved

8

Invoice deleted while payments exist

System deducts invoice amount from Total Project Price; payment records retained

Payments remain visible; Total Project Price decreases

9

Payment status changes to Overdue (due date passes)

System automatically changes status from Unpaid/Failed to Overdue at midnight of due date

Status badge changes to red "Overdue"

10

Partial refund processed

System keeps status as "Paid" and adds note with partial refund details

Remaining Balance Due increases by refund amount

11

Full refund processed

System changes status to "Refunded"

Remaining Balance Due increases by full refund amount

12

Client signs proposal after invoices already sent

System calculates Total Project Price as Proposal amount + Additional Invoices (excluding proposal-generated invoice)

No duplicate counting of proposal invoice

13

Network failure during refund processing

System displays error; retains original status; does not complete refund

User can retry when connection restored

14

User clicks Amount Paid when no payments made ($0)

System opens Payment History modal with empty state message

Modal shows "No payments have been made yet"

15

Multiple payment methods for same invoice

System tracks each transaction separately in Payment History

All payment methods visible in history

16

Contractor invoice deleted after payment

System retains payment records; View Invoice shows "Invoice not found" error

Payment history preserved; invoice inaccessible

17

Currency display for large amounts

System formats with appropriate commas (e.g., $14,200.00)

Currency displayed consistently

18

Project with no events

System shows empty Payments to Contractors section; Total Expenses = $0

"No contractors have been assigned yet" message displayed

19

Simultaneous status update (race condition)

System processes requests sequentially; last write wins

Consistent final state

20

User navigates away during payment processing

System continues processing; updates status on next page load

Payment completes independently of user navigation

## **9\. Acceptance Criteria**

### **9.1 Financial Summary**

*   AC-001: The Finance Tab must display Total Project Price calculated correctly based on signed proposal amounts and/or invoice totals.
*   AC-002: The Remaining Balance Due must accurately reflect Total Project Price minus all successful client payments.
*   AC-003: The Total Expenses must sum all contractor Event Prices, using actual paid amount when overpayment occurs.
*   AC-004: The Total Margin/Profit must display the difference between Total Project Price and Total Expenses.
*   AC-005: All financial values must display in USD format with two decimal places and comma separators for thousands.
*   AC-006: The "Create Invoice" button must redirect users to the Invoice Builder module.

### **9.2 Payments from Client**

*   AC-007: All client payments must display with correct Status, Payment Date, Due Date, and Amount.
*   AC-008: Payment statuses must update immediately when due date passes (Unpaid/Failed → Overdue).
*   AC-009: Kebab menu must display only relevant actions based on current payment status.
*   AC-010: Mark as Paid action must require payment method selection and mandatory note entry.
*   AC-011: Refund action must process through Stripe for online payments and mark as refunded for manual payments.
*   AC-012: View All link must redirect to Billing > Transactions tab with project filter applied.
*   AC-013: Default sort order must be by Due Date in ascending order.

### **9.3 Payments to Contractors**

*   AC-014: All contractor assignments must display with Contractor Name, Role, Event Name, Event Price, Amount Paid, and Status.
*   AC-015: Same contractor assigned to multiple events must appear as separate line items.
*   AC-016: Action icons must correctly indicate invoice upload, deliverables upload, and payment status.
*   AC-017: Amount Paid must be clickable and open Payment History modal.
*   AC-018: Make Payment action must redirect to Pay Contractor pop-up.
*   AC-019: Ask for Refund action must send email and in-app notification to contractor.

### **9.4 Payment History Modal**

*   AC-020: Payment History modal must display all payment transactions for the selected contractor.
*   AC-021: All columns in Payment History must be sortable.
*   AC-022: View Invoice link must open contractor invoice in PDF preview modal.
*   AC-023: Note icon must appear when note exists and display note content on hover.
*   AC-024: Close button must close modal and return to Finance Tab.

### **9.5 Empty States**

*   AC-025: Empty state message must display when no proposal or invoice exists.
*   AC-026: Empty state message must display when awaiting client signature on proposal.
*   AC-027: Empty state message must display when no contractors are assigned.

### **9.6 Access Control**

*   AC-028: Only Agency Owner and Admin roles must have access to the Finance Tab.
*   AC-029: Other roles must not see the Finance Tab in navigation.

### **9.7 Real-time Updates**

*   AC-030: All financial calculations must update in real-time when underlying data changes.
*   AC-031: Payment status updates must reflect immediately after action completion.

## **10\. Manual Test Cases**

Test cases have been documented in a separate Excel file for direct upload to the test management system.

**Link:** [Click Here](https://docs.google.com/spreadsheets/d/1-00iQw8i-l3cLAlR8oIQiktUHuIAUPnq-Sn63el5tkg/edit?usp=drive_link)

##

## **11\. Dependencies**

**Dependency Type**

**Module/Service**

**Dependency Description**

**Impact if Unavailable**

Internal Module

Proposal Module

Provides signed proposal data including package prices and à la carte items for Total Project Price calculation

Total Project Price cannot be calculated from proposal; falls back to invoice-only calculation

Internal Module

Invoice Builder Module

"Create Invoice" CTA redirects to this module; provides invoice data for financial calculations

Cannot create new invoices; existing invoice data still displayed

Internal Module

Billing Module (Invoices Tab)

Provides invoice details and payment schedule data

Invoice details unavailable; payment tracking affected

Internal Module

Billing Module (Transactions Tab)

"View All" link redirects here with project filter

Cannot navigate to detailed transaction view

Internal Module

Finance > Contractor Invoices

"Make Payment" action redirects to Pay Contractor pop-up

Cannot process contractor payments through UI

Internal Module

Contractor Management

Provides contractor assignment data for Payments to Contractors section

Contractor list unavailable; expense calculation affected

Internal Module

Event Management

Provides event names and contractor event assignments

Event context unavailable; cannot differentiate multi-event contractors

Internal Module

Project Details Module

Parent module containing the Finance Tab

Finance Tab inaccessible if Project Details unavailable

External Service

Stripe Payment Gateway

Processes online payments and refunds for client payments

Online payments fail; manual payment marking required

External Service

Stripe Connect

Processes payments to contractors

Contractor payments fail; manual marking required

External Service

Email Service

Sends "Ask for Refund" notifications to contractors

Refund request notifications not delivered

External Service

In-App Notification Service

Delivers in-app notifications for refund requests

Contractors not notified within the application

External Service

PDF Generation Service

Generates downloadable invoice PDFs

Invoice download fails; view-only mode available

Configuration

Currency Settings

USD currency format configuration

Currency display issues

Configuration

Date/Time Format

Date formatting standards (MM/DD/YY, MMM DD, YYYY)

Date display inconsistencies

Configuration

User Permissions

Role-based access control settings

Unauthorized access or restricted functionality

## **12\. References**

Refer- [Click Here](https://www.figma.com/design/ej0kxwP45mDKmZCZfAJ5O8/Pixally?node-id=13409-153746&t=7RQKgcJBUkbtY4aT-0)

Event kebab Menu - Edit and Cancel event

# **Functional Requirements Document (FRD)**

# **Event Kebab Menu - Edit Event & Cancel Event**

**Module Name:** Event Kebab Menu Actions  
**Version:** 1.0  
**Last Updated:** May 27, 2026  
**Status:** Draft

## **1\. Module Overview**

### **1.1 Purpose**

This module defines the functionality for the kebab menu (three-dot menu) options available on individual events within a project. The kebab menu provides quick access to two primary actions: **Edit Event** and **Cancel Event**. These actions allow agency users to modify event details or permanently cancel an event with appropriate handling of financial records, contractor assignments, and notifications.

### **1.2 Scope**

This FRD covers:

*   Edit Event modal and all editable fields
*   Cancel Event flow with decision logic based on event count and primary event status
*   Single Event Confirmation pop-up (project cancellation warning)
*   Primary Event Blocking modal (when invoice exists)
*   Cancel Event modal with invoice handling, notifications, and warnings
*   Post-cancellation behavior for all affected entities
*   Contractor availability check and payment schedule impact on date changes

### **1.3 Module Location**

*   **Primary Access:** Project Details > Events Tab > Event Card > Kebab Menu (⋮)
*   **Alternative Access:** Project Details > Events Horizontal Tab > Kebab Menu on Event Tab

## **2\. User Roles & Permissions**

**Action**

**Agency Owner**

**Admin**

**Project Owner**

**Project Manager**

View Kebab Menu

✅

✅

✅

✅

Edit Event

✅

✅

✅

❌

Cancel Event

✅

✅

✅

❌

Undo Cancellation

❌

❌

❌

❌

Undo Archive

✅

✅

✅

❌

**Note:** Project Managers who are assigned as Project Owner of a specific project can Edit Event but cannot Cancel Event.

## **3\. User Flow**

### **3.1 Accessing Kebab Menu**

1.  User navigates to Project Details.
2.  User locates the event card or event tab.
3.  User clicks the kebab menu (⋮) icon.
4.  System displays dropdown with options: "Edit Event" and "Cancel Event".

### **3.2 Edit Event Flow**

1.  User clicks "Edit Event" from kebab menu.
2.  System displays Edit Event modal with pre-populated data.
3.  User modifies desired fields.
4.  User clicks "Save".
5.  If event date is changed:
    *   System performs contractor availability check (if contractors assigned and date is future/past).
    *   System displays Payment Schedule Impact pop-up (if primary event and unpaid payments).
6.  System saves changes and closes modal.
7.  Success toast: "Event updated successfully."

### **3.3 Cancel Event Flow - Decision Tree**

User clicks "Cancel Event" from kebab menu

│

▼

┌─────────────────────┐

│ How many events │

│ in project? │

└─────────────────────┘

│

┌───────────────┼───────────────┐

▼ ▼ ▼

1 Event 2 Events 3+ Events

│ │ │

▼ │ │

Single Event │ │

Confirmation Is this the Is this the

Pop-up primary event? primary event?

│ │ │

│ ┌────┴────┐ ┌────┴────┐

│ ▼ ▼ ▼ ▼

│ Yes No Yes No

│ │ │ │ │

│ ▼ │ │ │

│ Auto-assign │ │ │

│ other as │ │ │

│ primary + │ Is invoice │

│ info message │ generated? │

│ in Cancel │ │ │

│ Modal │ ┌──┴──┐ │

│ │ │ ▼ ▼ │

│ │ │ Yes No │

│ │ │ │ │ │

│ │ │ ▼ ▼ │

│ │ │ Blocking Auto-assign

│ │ │ Modal another as

│ │ │ (Change primary

│ │ │ Primary) │

│ │ │ │ │

│ ▼ ▼ │ ▼

│ Cancel Event Modal ◄─────────┘

│ │

▼ ▼

Cancel Project Event

Pop-up Cancelled

## **4\. Functional Logic**

### **4.1 Edit Event Modal**

#### **4.1.1 Modal Display**

When user clicks "Edit Event", the system displays a modal with all event details pre-populated and editable.

#### **4.1.2 Warning Message**

A warning message is displayed at the top of the Edit Event modal (below title, above fields) for all users with edit access.

**Element**

**Content**

Style

Yellow warning box

Icon

ℹ️ Info icon

Position

Top of modal, below title, above fields

Visibility

Always visible (not dismissible)

Message

**Warning:** Changes to this event may impact proposals, contracts, invoices, or contractor assignments. Please review before saving. Ignore this warning if no related actions have been taken on this event.

#### **4.1.3 Editable Fields**

**Field**

**Type**

**Required**

**Validation**

Event Type

Dropdown

Yes

Must select one

Services

Multi-select Chips

Yes

At least one service

Event Stage

Dropdown

Yes

Must select one

Event Date

Date Picker

Yes

Can be TBD or actual date

Event Time

Time Picker

Yes (if date set)

Valid time format

Event End Date

Date Picker

No

Must be after start date

Event End Time

Time Picker

No

Must be after start time

Primary Venue

Google Autocomplete

No

Valid address

Event Notes

Textarea

No

Max 2000 characters

#### **4.1.4 Service Removal Logic**

When a service is removed from the event:

*   Contractors assigned to that service type remain visible on agency side.
*   Contractors lose access to the event on their side (hidden).
*   Contractors are immediately marked as available on that date in calendar.
*   Contractors are removed from Do Not Book list for that date.
*   Email notification sent to affected contractors.

#### **4.1.5 Event Stage Change**

*   Event Stage is editable from the Edit Event modal.
*   Changing the stage updates the pipeline position.
*   No restrictions on stage changes.

#### **4.1.6 Date Change - Contractor Availability Check**

When the event date is changed and contractors are assigned:

**Trigger Conditions:**

*   New date is a future date OR past date (not TBD).
*   Contractors are currently assigned to the event.

**Flow:**

1.  System performs availability check for all assigned contractors.
2.  If any contractor is unavailable, Update Event modal is displayed (same as Info Tab flow).
3.  User can keep, remove, or replace contractors.

**Not Triggered When:**

*   Changing from future date to TBD.
*   No contractors assigned.

#### **4.1.7 Date Change - Payment Schedule Impact**

When the event date is changed on the primary event:

**Trigger Conditions:**

*   Event is the primary event.
*   There are unpaid payments on linked invoice(s).
*   Date change is one of: Future → Past, TBD → Past, Future → TBD.

**Flow:**

*   Payment Schedule Impact pop-up is displayed (same logic as Section 4.11 in Events Info Tab FRD).
*   User can choose "No Changes" or "Update Invoice(s)" / "Update to TBD".

**Flow Order:**

1.  User saves date change.
2.  Contractor Availability Modal (if applicable).
3.  Payment Schedule Impact Pop-up (if applicable).
4.  Changes saved.

#### **4.1.8 Internal Notes**

*   Notes added in Edit Event modal are displayed in Event > Info section.
*   Displayed as read-only after save.
*   Visible to agency users only.

### **4.2 Cancel Event - Single Event Confirmation**

#### **4.2.1 Trigger Condition**

Displayed when the project has only **one event** and user attempts to cancel it.

#### **4.2.2 Pop-up Content**

**Element**

**Content**

Title

Cancel Project?

Message

This is the only event in this project. Canceling it will cancel the entire project. Would you like to create a TBD event to keep the project open?

Primary Button

Proceed to Cancel Project

Secondary Button

Create TBD Event

#### **4.2.3 Button Actions**

**Button**

**Action**

Proceed to Cancel Project

Opens Cancel Event modal (becomes Cancel Project flow)

Create TBD Event

Opens Create Event modal with TBD date pre-selected

### **4.3 Cancel Event - Primary Event Blocking Modal**

#### **4.3.1 Trigger Conditions**

Displayed when ALL of the following are true:

*   Project has **3 or more events**.
*   User is attempting to cancel the **primary event**.
*   An **invoice has been generated** for the client.

#### **4.3.2 Pop-up Content**

**Element**

**Content**

Title

Cannot Cancel Primary Event

Message

This event is the primary event linked to the project's invoice payment schedule. Please assign another event as primary before canceling this event.

Primary Button

Change Primary Event

Secondary Button

Cancel

#### **4.3.3 Button Actions**

**Button**

**Action**

Change Primary Event

Opens Edit Project modal to change primary event. After save, returns to Event Details screen. User must manually initiate cancellation again.

Cancel

Closes modal, no action taken.

#### **4.3.4 Non-Blocking Scenarios (3+ Events)**

If user cancels the primary event but **no invoice exists**:

*   System auto-assigns another event as primary.
*   Cancel Event modal opens normally.
*   No blocking.

### **4.4 Cancel Event - Auto Primary Assignment (2 Events)**

#### **4.4.1 Trigger Condition**

When project has exactly **2 events** and user cancels the **primary event**.

#### **4.4.2 Behavior**

*   The remaining event automatically becomes the primary event.
*   Cancel Event modal displays with an informational message about the auto-assignment.

### **4.5 Cancel Event Modal**

#### **4.5.1 Header Section (Always Visible)**

**Field**

**Description**

Event

Event name (e.g., "Engagement Shoot")

Date

Event date (e.g., "Aug 15, 2025")

Part of Project

Project/Package name (e.g., "Smith Wedding Package")

Invoice

Financial summary (see below)

**Invoice Display:**

*   Single Invoice: Total: $8,500 | Paid: $3,000 | Balance: $5,500
*   Multiple Invoices:
    *   Invoice 1: Total: $5,000 | Paid: $2,000 | Balance: $3,000
    *   Invoice 2: Total: $3,500 | Paid: $1,000 | Balance: $2,500

**Note:** Invoice section is hidden if no invoices exist for the project.

#### **4.5.2 Auto-Primary Assignment Message (2 Events Only)**

**Element**

**Content**

Info Box (Blue)

ℹ️ The remaining event "\[Event Name\]" will become the primary event.

**Visibility:** Only shown when canceling the primary event in a 2-event project.

#### **4.5.3 Invoice Handling Section**

**Visibility:** Only shown if invoices exist.

**Element**

**Content**

Section Title

Invoice Handling

Option 1 (Radio)

**No financial changes** — Keep invoice as-is (Package pricing unchanged)

Option 2 (Radio)

**Edit invoice / Adjust balance** — Open invoice editor (Step 2)

**Default Selection:** Option 1 (No financial changes)

**Behavior:**

*   Option 1: Button shows "Confirm"
*   Option 2: Button shows "Next: Edit Invoice" → Redirects to Finance > Billing > Invoices tab with project filter

#### **4.5.4 Notifications Section**

**Element**

**Content**

Section Title

Notifications — Who should be notified about this cancellation?

Toggle 1

Notify team members (Default: ON)

Toggle 2

Notify contractors (Default: ON)

Toggle 3

Notify client (Default: ON)

**Notification Delivery:** Email

#### **4.5.5 Internal Notes Section**

**Element**

**Content**

Label

Internal Notes (Optional)

Placeholder

"Add a reason or note for this cancellation (e.g., Client canceled engagement shoot; package unchanged)."

Character Limit

2000

Visibility After Save

Agency only — displayed in Event > Info section

Display Format

Note text with "Cancelled by: \[User Name\] on \[Date\]"

#### **4.5.6 Tasks Warning (Conditional)**

**Visibility:** Only shown if there are To Do or In Progress tasks.

**Element**

**Content**

Warning Box

⚠️ \[X\] pending task(s) will be deleted upon cancellation. Completed tasks will be retained.

#### **4.5.7 Contractor Payment Warning (Conditional)**

**Visibility:** Only shown if contractors have already been paid.

**Element**

**Content**

Warning Box

⚠️ \[X\] contractor(s) have already been paid. You will need to arrange refunds manually.

#### **4.5.8 Warning & Legal Disclaimer**

**Element**

**Content**

Warning (Yellow Box)

⚠️ **Warning:** Canceling this event will permanently remove the event and all connected services from your project. This action cannot be undone.

Legal Disclaimer

ℹ️ **Legal Disclaimer:** Pixally does not enforce contract terms between you and your clients. Please review your agreement before cancelling or editing an invoice. You are responsible for determining whether additional payments are due.

#### **4.5.9 Modal Buttons**

**Invoice Handling Selection**

**Buttons**

No financial changes

Close | **Confirm**

Edit invoice / Adjust balance

Close | **Next: Edit Invoice**

### **4.6 Post-Cancellation Behavior**

#### **4.6.1 Event Display**

**View**

**Behavior**

Agency Side

Event appears grayed out with "Cancelled" badge. Appears last in event list (before archived). Visible in Events tab with badge.

Contractor Side

Event is hidden. No access.

Client Portal

Event appears grayed out with "Cancelled" badge. Not actionable.

Events Tab List

Event tab is grayed out with "Cancelled" badge.

Global Search

Event does not appear in search results.

#### **4.6.2 Contractor Impact**

**Area**

**Behavior**

Event Access

Contractors lose access to cancelled event immediately.

Calendar Availability

Contractors immediately available on that date.

Unpaid Invoices

Auto-voided. Email notification sent.

Paid Invoices

Remain for record. Agency handles refund manually. Email notification includes refund info.

Payment History

Contractors can still view payment history for audit purposes.

Feedback Forms

Contractors cannot submit feedback for cancelled events.

Do Not Book

Date removed from DNB list.

#### **4.6.3 Financial Records**

**Area**

**Behavior**

Client Invoice

Remains as-is unless user selected "Edit invoice".

Contractor Unpaid Invoices

Auto-voided.

Contractor Paid Invoices

Retained for record.

Expenses

Remain visible in financial reports for bookkeeping/tax purposes.

Payment Overdue Emails

Blocked for cancelled events.

#### **4.6.4 Tasks & To-Dos**

**Task Status**

**Behavior**

To Do

Deleted upon cancellation.

In Progress

Deleted upon cancellation.

Completed

Retained.

#### **4.6.5 Team Members**

*   Team members remain assigned to the event.
*   Event becomes inactive (not in active to-do lists).

#### **4.6.6 IC Agreements**

**Agreement Status**

**Agency Side**

**Contractor Side**

Unsigned

Expired. Viewable with "Expired" tag.

Hidden.

Signed

Remains. Viewable with "Cancelled" tag.

Hidden.

#### **4.6.7 Files & Documents**

*   All uploaded files and photos remain accessible.
*   Useful for legal or payment dispute purposes.

#### **4.6.8 Calendar Integration**

**Calendar**

**Behavior**

Google Calendar (if synced)

Event auto-removed.

Pixally Calendar

Event updated/marked as cancelled.

#### **4.6.9 Automated Communications**

**Communication Type**

**Behavior**

Snapshot Emails

Blocked for cancelled events.

Payment Reminders

Blocked for cancelled events.

Cancellation Notifications

Sent based on toggle selections.

#### **4.6.10 Event Numbering**

*   Event numbering (e.g., Wedding 1, Wedding 2) remains unchanged.
*   No re-sequencing occurs.

#### **4.6.11 Project-Level Impact (Single Event Cancellation)**

When the only event in a project is cancelled:

*   Entire project is cancelled.
*   Project moves to Archive with "Cancelled" tag.
*   All proposals associated with the project get expired.
*   Client portal shows project as grayed out with "Cancelled" status.

## **5\. Field Details & Validations**

### **5.1 Edit Event Modal Fields**

**Field**

**Type**

**Required**

**Max Length**

**Validation Rules**

Warning Message

Display (Yellow Box)

N/A

N/A

Always visible. Not dismissible. Displays at top of modal.

Event Type

Dropdown

Yes

N/A

Must select from predefined list.

Services

Multi-select Chips

Yes

N/A

At least one service must be selected.

Event Stage

Dropdown

Yes

N/A

Must select from pipeline stages.

Event Date

Date Picker

Yes

N/A

Can be TBD or valid date.

Event Time

Time Picker

Conditional

N/A

Required if Event Date is set. Valid time format.

Event End Date

Date Picker

No

N/A

Must be on or after Event Date.

Event End Time

Time Picker

No

N/A

Must be after Event Time if same day.

Primary Venue

Text (Autocomplete)

No

500

Google Places autocomplete.

Event Notes

Textarea

No

2000

Free text.

### **5.2 Cancel Event Modal Fields**

**Field**

**Type**

**Required**

**Max Length**

**Validation Rules**

Invoice Handling

Radio

Yes (if invoice exists)

N/A

Must select one option.

Notify Team Members

Toggle

No

N/A

Default: ON

Notify Contractors

Toggle

No

N/A

Default: ON

Notify Client

Toggle

No

N/A

Default: ON

Internal Notes

Textarea

No

2000

Free text. Agency-only visibility.

## **6\. Success Message Handling**

**Action**

**Message**

**Type**

Edit Event saved

"Event updated successfully."

Toast

Edit Event with service removal

"Event updated successfully. Affected contractors have been notified."

Toast

Event cancelled

"Event cancelled successfully."

Toast

Event cancelled (single event/project)

"Project cancelled and moved to archive."

Toast

TBD Event created

"TBD event created successfully."

Toast

## **7\. Error Message Handling**

**Scenario**

**Message**

**Type**

Network error during save

"Unable to save changes. Please check your connection and try again."

Toast

Server error

"Something went wrong. Please try again later."

Toast

No services selected

"Please select at least one service."

Inline

End date before start date

"End date must be on or after the start date."

Inline

End time before start time (same day)

"End time must be after the start time."

Inline

Notes exceed limit

"Notes cannot exceed 2000 characters."

Inline

## **8\. Edge Cases**

**#**

**Edge Case**

**System Behavior**

1

User cancels primary event with 3+ events and invoice exists

Blocking modal displayed. User must change primary event first.

2

User cancels primary event with 3+ events and no invoice

Auto-assigns another event as primary. Cancel modal opens normally.

3

User cancels primary event with 2 events

Other event auto-becomes primary. Info message shown in Cancel modal.

4

User cancels only event in project

Single Event Confirmation pop-up shown. Can create TBD event or proceed to cancel project.

5

User removes all services from event

Validation error: "Please select at least one service."

6

User changes date on non-primary event with contractors

Contractor availability check triggered. No payment schedule impact.

7

User changes date on primary event with unpaid payments

Both contractor availability check and payment schedule impact triggered.

8

Contractor has both paid and unpaid invoices

Unpaid invoices voided. Paid invoices retained. Warning shown about manual refund.

9

Multiple invoices exist for project

All invoices shown in Cancel modal. User redirected to Billing > Invoices with project filter if editing.

10

User closes browser during invoice edit flow

Cancellation not completed. Event remains active. User must restart cancellation.

11

Two admins attempt cancellation simultaneously

First request processed. Second user sees updated state (already cancelled).

12

Contractor accepts job at moment of cancellation

System processes cancellation. Contractor sees event as cancelled.

13

Client payment completes after cancellation

Payment processed. Agency handles reconciliation manually.

14

Client tries to sign proposal for cancelled event

Proposal shown as expired. Cannot be signed.

15

All events in project cancelled

Project moves to Archive with "Cancelled" tag.

16

Brand access validation in multi-brand agency

System verifies user has access to the brand before allowing cancellation.

## **9\. Acceptance Criteria**

### **9.1 Kebab Menu**

*   AC-01: Kebab menu shall be visible on event cards and event tabs.
*   AC-02: Kebab menu shall display "Edit Event" and "Cancel Event" options.
*   AC-03: Users without permission shall not see Edit Event or Cancel Event options.

### **9.2 Edit Event**

*   AC-04: Edit Event modal shall display warning message at the top (below title, above fields).
*   AC-05: Warning message shall be always visible and not dismissible.
*   AC-06: Edit Event modal shall display all event fields pre-populated.
*   AC-07: All fields shall be editable as per field specifications.
*   AC-08: Saving changes shall display success toast.
*   AC-09: Removing a service shall trigger email notification to affected contractors.
*   AC-10: Changing date shall trigger contractor availability check if contractors assigned.
*   AC-11: Changing date on primary event with unpaid payments shall trigger payment schedule impact pop-up.
*   AC-12: Event Notes shall have 2000 character limit.
*   AC-13: Validation errors shall be displayed inline.

### **9.3 Cancel Event - Single Event**

*   AC-14: Canceling only event in project shall show Single Event Confirmation pop-up.
*   AC-15: "Create TBD Event" shall open Create Event modal with TBD pre-selected.
*   AC-16: "Proceed to Cancel Project" shall open Cancel Event modal for project cancellation.

### **8.4 Cancel Event - Primary Event Blocking**

*   AC-17: Canceling primary event with 3+ events and invoice shall show blocking modal.
*   AC-18: "Change Primary Event" shall open Edit Project modal.
*   AC-19: After changing primary, user must manually re-initiate cancellation.
*   AC-20: Canceling primary event with 3+ events and no invoice shall auto-assign another primary.

### **8.5 Cancel Event - Two Events**

*   AC-21: Canceling primary event with 2 events shall auto-assign other as primary.
*   AC-22: Cancel modal shall display info message about auto-assignment.

### **8.6 Cancel Event Modal**

*   AC-23: Header section shall always display event details.
*   AC-24: Invoice section shall display only if invoices exist.
*   AC-25: Multiple invoices shall display as "Invoice 1", "Invoice 2", etc.
*   AC-26: "No financial changes" selection shall show "Confirm" button.
*   AC-27: "Edit invoice" selection shall show "Next: Edit Invoice" button.
*   AC-28: "Next: Edit Invoice" shall redirect to Finance > Billing > Invoices with project filter.
*   AC-29: Notification toggles shall default to ON.
*   AC-30: Internal Notes shall be optional with 2000 character limit.
*   AC-31: Tasks warning shall display count of pending tasks to be deleted.
*   AC-32: Contractor payment warning shall display count of paid contractors.
*   AC-33: Warning and legal disclaimer shall always be visible.

### **8.7 Post-Cancellation**

*   AC-34: Cancelled event shall be grayed out with "Cancelled" badge on agency side.
*   AC-35: Cancelled event shall be hidden from contractors.
*   AC-36: Cancelled event shall be grayed out and not actionable on client portal.
*   AC-37: Cancelled event shall not appear in global search.
*   AC-38: Contractors shall be immediately available on cancelled event date.
*   AC-39: Unpaid contractor invoices shall be auto-voided.
*   AC-40: Paid contractor invoices shall be retained.
*   AC-41: To Do and In Progress tasks shall be deleted.
*   AC-42: Completed tasks shall be retained.
*   AC-43: Unsigned IC Agreements shall be marked as expired.
*   AC-44: Signed IC Agreements shall be viewable with "Cancelled" tag.
*   AC-45: Files and documents shall remain accessible.
*   AC-46: Google Calendar event shall be auto-removed if synced.
*   AC-47: Snapshot emails shall be blocked for cancelled events.
*   AC-48: Internal Notes shall display with "Cancelled by: \[User Name\] on \[Date\]" in Info section.

### **8.8 Permissions**

*   AC-49: Agency Owner, Admin, and Project Owner shall be able to Edit Event.
*   AC-50: Agency Owner, Admin, and Project Owner shall be able to Cancel Event.
*   AC-51: Project Manager shall not be able to Edit Event or Cancel Event.
*   AC-52: Cancellation cannot be undone.
*   AC-53: Archive can be undone by Agency Owner, Admin, and Project Owner.

## **9\. Notification Email Templates (Placeholders)**

### **9.1 Team Member Notification**

**Field**

**Content**

Subject

\[Event Cancellation\] \[Event Name\] - \[Project Name\]

Body

\[Placeholder - Content to be provided\]

### **9.2 Contractor Notification**

**Field**

**Content**

Subject

\[Event Cancellation\] \[Event Name\] - \[Project Name\]

Body

\[Placeholder - Content to be provided. Include: cancellation info, voided invoice details (if applicable), refund info (if applicable)\]

### **9.3 Client Notification**

**Field**

**Content**

Subject

\[Event Cancellation\] \[Event Name\] - \[Project Name\]

Body

\[Placeholder - Content to be provided\]

### **9.4 Contractor Service Removal Notification**

**Field**

**Content**

Subject

\[Service Update\] \[Event Name\] - \[Project Name\]

Body

\[Placeholder - Content to be provided. Notify contractor that their service has been removed from the event.\]

## **10\. Dependencies**

**#**

**Type**

**Dependency**

**Description**

**Impact if Unavailable**

1

Internal Module

Project Details

Event data and project context.

Cannot access Edit or Cancel functionality.

2

Internal Module

Finance > Billing > Invoices

Invoice editing after cancellation.

User cannot edit invoices during cancellation flow.

3

Internal Module

Edit Project Modal

Change primary event.

Cannot change primary event; blocking modal cannot redirect.

4

Internal Module

Create Event Modal

Create TBD event.

Cannot create TBD event to keep project open.

5

Internal Module

Contractor Availability

Check contractor conflicts on date change.

Availability check may fail; proceed with warning.

6

Internal Module

Payment Schedule

Payment schedule impact on date change.

Payment impact pop-up may not display.

7

External Service

Google Calendar API

Auto-remove cancelled events.

Events must be manually removed from Google Calendar.

8

External Service

Email Service

Send cancellation notifications.

Notifications fail; retry or manual notification required.

9

Internal Module

Activity Tab

Log cancellation activity.

Activity may not be logged; audit trail incomplete.

## **11\. Activity Logging**

**Action**

**Activity Log Entry**

Event Edited

"\[User Name\] edited event \[Event Name\]"

Event Date Changed

"\[User Name\] changed event date from \[Old Date\] to \[New Date\]"

Service Removed

"\[User Name\] removed \[Service Name\] from event \[Event Name\]"

Event Cancelled

"\[User Name\] cancelled event \[Event Name\]"

Project Cancelled

"\[User Name\] cancelled project \[Project Name\]"

Primary Event Changed

"\[User Name\] changed primary event to \[Event Name\]"

Contractor Removed (via cancellation)

"Contractor \[Contractor Name\] removed from event \[Event Name\]"

Contractor Invoice Voided

"Invoice \[Invoice ID\] for \[Contractor Name\] voided due to event cancellation"

## **12\. References**

*   Events Info Tab FRD (Contractor Availability Check, Payment Schedule Impact)
*   Project Details Module FRD
*   Finance Module FRD
*   Notification System Documentation

**Document End**

Events - Services tab

# **Services Management Module**

## **1\. Module Overview**

*   **Module Name**: Services Management Tab
*   **Purpose**: Enable users to configure, manage, and assign contractors for event services, including Photography, Videography, and Content Creation, within the event management
*   **Business Goal**: Streamline service configuration and contractor assignment to ensure proper event coverage and resource allocation

## **2\. User Roles & Permissions**

**Role**

**Description**

**Key Permissions**

Agency Admin

Full event management access

Create, edit, delete services; assign contractors; full configuration access

## **3\. User Flow**

1.  **Service Configuration (Add New Service)**
    *   The user navigates to the Event → Services tab
    *   View existing configured services or the empty state
    *   Clicks the (Services “+”) button to add a new service or the “Edit Service” button to modify an existing service
2.  **Edit Service Management**
    *   Users click on the “Edit Service” button in the respective service to modify an existing service (Photography/Videography/Content Creation)
    *   Configures service details (package, coverage hours, deliverables, roles)
    *   Saves configuration and returns to the services dashboard
3.  **Contractor Assignment**
    *   The user clicks the “Assign Contractors” button
    *   The system validates prerequisites (venue, event date)
    *   Opens contractor assignment pop-up (separate module)

**Critical Path**: Project creation → View Project Details → Events → Services tab

##

## **4\. Field Details & Validations**

### **Services tab Fields**

**Field Name**

**Type**

**Required**

**Validation Rules**

Services +

Button

Yes

Open the “Add New Services” pop-up if any of the Photography, Videography, or Content Creation services have not been selected for the event.

\- “+” button not displayed if all services are already been setup

Services Name

Label

Yes

Auto-populated based on the selected service during project creation

Assign Contractors

Button

Yes

\- Opens the contractor assignment pop-up to assign contractors in the event

\- On clicking "Assign Contractor", show a pop-up if: the venue is not added, the event date is TBD, or both are not configured

Edit Service

Button

Yes

\- Opens the edit services options

\- Opens edit service screen to update:

Package, Coverage hours, Min amount of photos, Roles needed, Service note

Package

Display Card

Yes

\- Display Options: Basic, Intermediate, Advanced

\- Must be one of the predefined package types

\- Display the package selected by the user within the edit service interface

\- By default, show the “Basic” package

Hours Coverage

Display Card (Numeric)

Yes

\- Display the count of hours coverage required for the service  
\- By default display the “--”

\- Display the hours entered by the user within the edit service interface (Min 1 - Max 24)

Min Amount of Photos

Display Card (Numeric)

Yes

Display the minimum amount of photos entered by the user within the edit service interface (Min 1 - Max 5000)

Number of Shooters

Display Card (Numeric)

Yes

\- The default display value is 1 (As Lead shooter is by default selected)

\- The count shows the number of selected checkboxes in Edit Service > "Roles needed for this event

\- System automatically counts selected roles (checkboxes) up to max 4 roles

Roles Needed For This Event

List Display

Yes

Display the name of the role which are selected in the Edit Services: Lead Shooter (By default display), Second Shooter, Drone Operator, and Assistant

\- Role will be displayed as the card in the contractor's tab under the respective service for contractor assignment

Service Note

Text Block

No

Display the service note text entered by the user within the Edit Service interface

Assigned Contractors

Card/Row

Conditional

\- Display the contractor details if a contractor is assigned to the service  
\- Contractor’s details - (Full name, specialization, Role icon, Pay rate, Contractor fee, Service area, and Miles to location - System to calculate miles based on contractor address (from Contractor Portal) and venue location (from Project Management), Average rating of the contractor)

\- If multiple contractors are present, display them stacked vertically (one above the other).

\- On clicking the kebab menu, display the following options: Open Profile, Pay Contractor, Update Event Price, Replace, Remove

##

##

##

## **5\. Error Message Handling**

**Field**

**Validation Scenario**

**Error Message**

Assign Contractors button

Venue not configured

Opens pop-up “Please set the event venue before assigning contractors.”

Assign Contractors button

Event date TBD

“Please set the event date before assigning contractors.”

Assign Contractors button

Both the venue & event date are missing

Opens pop-up “Please configure event venue and date before assigning contractors.”

General

Server timeout

“Something went wrong.”

## **6\. Functional Logic**

*   **Service Type Limitation**: Only three predefined service types are available (Photography, Videography, and Content Creation)
*   **Project Service Selection**: Services are initially selected during the project creation phase and can be added later using the “Services +” button
*   **Service + button logic:** The system will automatically hide the “+” (Add Services) button if all available services have already been added to the event
*   **Role-Based Shooter Calculation**: The number of shooters automatically reflects the count of selected role checkboxes (1-4 range) in the edit service interface
*   **Package Static Assignment**: All services default to the “Basic” package and reflect the package selected in the edit service interface
*   **Contractor Assignment Prerequisites**: The system validates venue and event date configuration before allowing contractor assignment
*   **Service Persistence**: All service configurations are saved to the particular event

## **7\. Test Cases**

Link Here: [Pixally Test cases - 01.04.25](https://docs.google.com/spreadsheets/d/1RNM15mQt_Ax15liD7LeQZTvi_N01Hax4yZXSNIcN2dI/edit?gid=491179721#gid=491179721)

## **8\. Acceptance Criteria**

*   **Service Configuration**: Users can successfully create and configure services for Photography, Videography, and Content Creation, with all required fields validated
*   **Role Management**: The System accurately calculates the number of shooters based on selected role checkboxes with range validation (1-4)
*   **Field Validation**: All form fields properly validate input with appropriate error messages displayed inline
*   **Contractor Assignment Validation**: The system prevents contractor assignment when venue or event date prerequisites are not met
*   **Data Persistence**: All service configurations save successfully and persist across user sessions
*   **Error Handling**: All error scenarios display appropriate messages without system crashes

## **9\. Dependencies**

**Module/System**

**Dependency Type**

**Impact if Unavailable**

Contractor Management

Integration

Cannot assign contractors to services

Contractor Portal

Data Exchange

Contractor information is not accessible

Brand Management

Configuration

Service branding/templates unavailable

Add new services not accessible

Calendar System

Data Validation

Cannot validate event dates for contractor assignment

Project Management

Data Validation

Cannot validate venue configuration for contractor assignment

Project Management

Core Dependency

Cannot access service configuration without an active project

## **10\. References**

Link: [Click Here](https://www.figma.com/design/ej0kxwP45mDKmZCZfAJ5O8/Pixally?node-id=13409-229548&t=VvI2AbzKdZtHK3LI-0)

Edit services

**Edit Services**

*   **Purpose**: Enable users to modify existing service configurations, including package selection, coverage hours, deliverables, role assignments, and service notes

## **1\. User Flow**

1.  **Edit Service Access**
    *   The user navigates to the Event → Services tab
    *   Click the "Edit Service" button on the desired service card
    *   The system opens the edit service form with pre-populated current values
2.  **Service Configuration Update**
    *   User views service type (read-only display)
    *   Modifies package selection, coverage hours, and the Min amount of photos
    *   Configures role assignments and adds service notes
    *   The system validates changes in real-time
3.  **Changes Submission**
    *   The user clicks "Save Changes" to submit modifications
    *   The system validates all required fields and business rules
    *   On success, returns to the services dashboard with updated information
    *   On error, displays inline validation messages

**Critical Path**: Service selection → Parameter modification → Validation → Save → Dashboard return

## **2\. Field Details & Validations**

### **Edit Service Form Fields**

**Field Name**

**Type**

**Required**

**Validation Rules**

Service Type

Display Text

Yes

\- Displays the service name (view only), e.g., Photography, Videography, or Content Creation, for the service being edited.

Package

Dropdown

Yes

\- Options: Basic, Intermediate, Advanced

\- Must be one of the predefined package types

Coverage

Numeric Input

Yes

\- Allows numeric input only, starting from 1

\- Minimum: 1

\- Maximum: 24

Min amount of photos

Numeric Input

Yes

\- Conditional: Only appears if the Service Type is Photography.

\- Allows numeric input only

\- Minimum: 1

\- Maximum: 5,000

Add Custom Field

Button

Yes

Opens the “Add custom field” pop-up

Role Checkboxes

Checkbox Group

Yes

\- Options: Lead Shooter, Second Shooter, Drone Operator, Assistant

\- Displays the number of selected checkboxes (1–4) in “No of Shooters” (Services tab). For example, if one checkbox is selected, “No of Shooters” shows 1

\- Selected role after saving will be displayed as a card in the contractor's tab under the respective service for contractor assignment

Service Note

Text Area

Yes

\- Max 250 characters, plain text only

\- Added note is displayed in the Service Note section under the Services tab

Cancel

Button

No

Closes the edit service interface and returns to the previous services view without saving the change

Save Changes

Button

No

\- On click validates all required fields and input validations. If valid, saves changes and returns to the previous services interface.

\- If validation occurs, displays relevant error messages and prevents submission.

##

## **3\. Success Message Handling**

**Validation Scenario**

**Error Message**

On successfully saving service changes

"Your {Photography/Videography/Content Creation} service has been updated successfully."

##

## **4\. Error Message Handling**

**Field**

**Validation Scenario**

**Error Message**

Package

Not selected

“Please select a package.”

Coverage

Empty

“Please enter the coverage duration.”

Coverage

Coverage > 24

“Coverage must be between 1 and 24 hours.”

Min amount of photos

Empty

“Please enter the minimum amount of photos.”

Min Amount of photos

Min Amount of photos > 5000

“Minimum amount of photos must be between 1 and 5000.”

Roles

Unselected all

“Please select a role.”

Service Note

Exceeds 250 characters

"Service note cannot exceed 250 characters."

General

Save operation failed

"Something went wrong."

## **5\. Functional Logic**

*   **Service Type Heading**: Read-only field showing the type of service being edited (Photography, Videography, or Content Creation)
*   **Coverage:** The Coverage input field only accepts numeric values between 1 and 24 (inclusive)
*   **Conditional Photo Field**: The "Min amount of photos" field appears and becomes mandatory only when editing the Photography service and input allows numeric values between 1 and 5000 (inclusive)
*   **Role Count Calculation**: Selected role checkboxes automatically update the shooter count (Number of Shooters) displayed on the services dashboard (1- 4 range)
*   **Role:** The selected role after saving will be displayed in the contractor's tab in their respective service for contractor assignment
*   **Form Pre-population**: All fields load with current service configuration values
*   **Change Detection**: The System tracks modifications to enable/disable save functionality

## **6\. Edge Cases**

**Scenario**

**Expected Behavior**

The user navigates away without saving changes

Data will not be saved

Multiple users editing the same service simultaneously

Last save wins, display notification of concurrent changes

Session timeout during the edit

Preserve form data, require re-authentication, restore form state

The service was deleted by another user while editing

Display an error message and redirect to the services dashboard

## **7\. Test Cases**

**Link:** [Pixally Test cases - 01.04.25](https://docs.google.com/spreadsheets/d/1RNM15mQt_Ax15liD7LeQZTvi_N01Hax4yZXSNIcN2dI/edit?gid=491179721#gid=491179721)

## **8\. Acceptance Criteria**

*   **Form Pre-population**: Edit service form loads with all current service configuration values correctly displayed
*   **Conditional Field Logic**: The "Min amount of photos" field appears and validates only when editing the Photography service
*   **Service Type Display**: The service type heading is displayed as a read-only field showing which service is being edited
*   **Role Assignment**: Users can select/deselect contractor roles with accurate count reflection on the service tab (Number of Shooters)
*   **Validation Coverage**: All required fields validate with appropriate inline error messages
*   **Save Functionality**: Valid changes save successfully and return the user to the updated services dashboard
*   **Custom field & Delete service Flow Integration**: Custom field and delete service buttons properly navigate to respective workflows

## **9\. Reference**

*   **Figma Link:** [Click here](https://www.figma.com/design/ej0kxwP45mDKmZCZfAJ5O8/Pixally?node-id=13409-232496&t=VvI2AbzKdZtHK3LI-0)

Add New Service

**1\. Add New Services Flow**

*   **Purpose:** Enable users to add new services (Photography, Videography, Content Creation) to existing events within a project through a pop-up interface

## **2\. User Flow**

1.  **Service Addition Initiation**
    *   The user navigates to the Event → Services tab
    *   The “+” (Add Services) button is displayed only when at least one service remains available to add. When clicked, it opens the “Add New Services” pop-up
2.  **Service Configuration**
    *   The user views the current event name (read-only)
    *   Selects one service type from the available options (services already added are grayed out and cannot be selected).
    *   For the selected service pop-up expands and the system dynamically shows relevant fields based on the selected services
3.  **Service Submission**
    *   The user completes all required fields for the selected services
    *   Clicks the "Add new services" button
    *   The system validates and creates a new service, and shows a success toast message
    *   The pop-up closes and returns to the services tab

**Critical Path**: Service selection → Service configuration → Validation → Service creation → Service tab displays additional service (Photography/Videography/Content Creation)

## **3\. Field Details & Validations**

**Field Name**

**Type**

**Required**

**Validation Rules**

Event Name

Text Display (Read-only)

Yes

Automatically populated based on the currently selected event tab

Service Type

Button Toggle

Yes

\- Single select (Allow only one service selection per service (single service per submission)

\- Already added services appear disabled/grayed out

\- Selecting a service expands the pop-up and displays its configuration section, and deselecting collapses the pop-up

Choose Package

Dropdown

Yes

\- Options: Basic, Intermediate, Advanced

Coverage

Text Input

Yes

\- Allows numeric input only, starting from 1

\- Minimum: 1

\- Maximum: 24

Min amount of photos

Numeric Input

Yes

\- Conditional: Only appears if the Service Type is Photography selected

\- Allows numeric input only, starting from 1

\- Minimum: 1

\- Maximum: 5,000

Role Checkboxes

Checkbox Group

Yes

\- Options: Lead Shooter, Second Shooter, Drone Operator, Assistant

\- After the service is added successfully display the number of selected checkboxes (1–4) in “No of Shooters” (Services tab). For example, if one checkbox is selected, “No of Shooters” shows 1 in services tab

Service Note

Text Area

No

\- Max 250 characters, plain text only

\- Added note is displayed in the Service Note section under the services tab of the respective service

Cancel

Button

No

Closes the pop-up without saving changes and returns to the services tab

Add

Button

No

\- The ‘Add’ button remains enabled at all times, and validations occur upon click

\- If no validation occurs service will be added to the respective event with a success toast message

## **4\. Success Message Handling**

**Validation Scenario**

**Error Message**

On successfully saving service changes

"Your {Photography/Videography/Content Creation} service has been added successfully."

## **5\. Error Message Handling**

**Field**

**Validation Scenario**

**Error Message**

Service Type

No service selected

"Please select a service type."

Package

Not selected

“Please select a package.”

Coverage

Empty

“Please enter the coverage duration.”

Coverage

Coverage > 24

“Coverage must be between 1 and 24 hours.”

Min amount of photos

Empty

“Please enter the minimum amount of photos.”

Min amount of Photos

Min amount of photos > 5000

“Minimum amount of photos must be between 1 and 5000.”

Roles

Unselected all

“Please select a role.”

Service Note

Exceeds 250 characters

"Service note cannot exceed 250 characters."

General

Server error

"Something went wrong."

## **6\. Functional Logic**

*   **Service Availability Check**: The system will automatically hide the “+” (Add Services) button if all available services have already been added to the event
*   **Dynamic Service Sections**: Each selected service type expands the pop-up and displays its configuration section
*   **Conditional Field Display**: The "Min amount of photos" field only appears when the Photography service is selected
*   **Service State Management**: Already added services for the current event appear disabled/grayed out in the service type selection
*   **Button State Control**: The "Add new services" button remains enabled. If validations fail, display relevant errors.

##

## **7\. Test Cases**

**Link:** [Pixally Test cases - 01.04.25](https://docs.google.com/spreadsheets/d/1RNM15mQt_Ax15liD7LeQZTvi_N01Hax4yZXSNIcN2dI/edit?gid=491179721#gid=491179721)

## **8\. Acceptance Criteria**

*   **Pop-up Access Control**: The "Services +" button successfully opens the add services pop-up when additional services can be added
*   **Service Addition Prevention:** The System hides the “+” button when all service types are already configured for the event
*   **Service Type Selection**: Users can select a service type that has not yet been added to the event. Already-added service types are disabled and cannot be selected again
*   **Dynamic Configuration**: Selected service expands the pop-up and displays its configuration section with appropriate fields
*   **Conditional Field Logic**: The "Min amount of photos" field appears only when the Photography service is selected
*   **Validation Coverage**: All required fields validate properly with specific error messages
*   **Success Flow**: Successfully added services, displaysthe dynamic service type name for the success message, and returns the user to the services tab

## **9\. References**

*   **Figma Link:** [Click here](https://www.figma.com/design/ej0kxwP45mDKmZCZfAJ5O8/Pixally?node-id=13409-247387&t=i14G6DPzEn8J5SUJ-0)

Snapshot

# **Functional Requirements Document (FRD)**

## **Module: Project Details > Snapshot**

## **1\. Module Overview**

**Module Name:** Snapshot

**Purpose:** The Snapshot module provides a one-page project brief for contractors containing all essential event information in a single, downloadable PDF format. The Snapshot consolidates key project details tailored to each contractor's assigned service and role, eliminating the need for contractors to navigate between multiple tabs and serving as an offline backup during network issues or platform downtime.

**Business Goals:**

*   Improve contractor preparedness by providing a comprehensive, easily accessible summary of event details before the event date.
*   Reduce on-site confusion by ensuring contractors have all critical information (venue, contacts, timeline, assigned services, other team members) available offline.
*   Enhance communication efficiency between agencies and contractors by delivering personalized, role-specific information.
*   Maintain data accuracy through dynamic data fetching that reflects the latest project state at the time of sending.
*   Support timely information delivery through controlled access timing and automated sending capabilities.

## **2\. User Roles & Permissions**

**Role**

**View Snapshot**

**Send Snapshot**

**Download PDFs**

**Configure Auto-Send**

**Access Contractor Portal**

Agency Owner

✓

✓

✓

✓

✗

Agency Admin

✓

✓

✓

✓

✗

Agency Manager

✓

✓

✓

✗

✗

Agency Staff

✓

✓ (based on event access)

✓ (based on event access)

✗

✗

Contractor

✓ (own Snapshot only)

✗

✓ (own Snapshot only, 1 week before event)

✗

✓

## **3\. User Flow**

### **3.1 Agency Portal - Send Snapshot Flow**

3.1.1 The agency user navigates to the Projects section from the left sidebar menu and selects a specific project.

3.1.2 The system loads the Project Details page displaying the project header with cover image, project name, event dates, and location.

3.1.3 The agency user clicks on a specific event card (e.g., "Rehearsal Dinner", "Wedding") to view event details.

3.1.4 The system displays the Event Details page with tabs including Services, Contractors, Raw Media, Files/Documents, Notes, and Info.

3.1.5 The agency user locates the "Send SNAPSHOT" button in the Services tab area.

3.1.6 The agency user hovers over the "Send SNAPSHOT" button and the system displays a tooltip with the following information: "📌 Snapshot - A one-page project brief for contractors. Use Snapshot to: See all key info in one place — no clicking around between tabs. Have an offline backup in case of network issues or Pixally downtime."

3.1.7 The agency user clicks the "Send SNAPSHOT" button to initiate the snapshot sending process.

3.1.8 The system displays the "Send SNAPSHOT" modal containing a list of all contractors assigned to the current event.

3.1.9 The system displays each contractor entry with their profile photo (or initials avatar if no photo), contractor name, service type, role, and a "Select" button.

3.1.10 The system displays contractors who have previously received the Snapshot with a "Sent" status indicator and timestamp showing when it was last sent.

3.1.11 The agency user selects individual contractors by clicking the "Select" button next to each contractor's name, or clicks "Select All" to select all contractors at once.

3.1.12 The system changes the "Select" button to "Selected" with a highlighted state for each selected contractor.

3.1.13 The agency user reviews the selection and chooses one of the available actions: "Download PDFs" or "Send to Contractors".

3.1.14 If the agency user clicks "Send to Contractors", the system sends personalized Snapshot PDFs via email to each selected contractor.

3.1.15 The system displays a green success toast notification stating "SNAPSHOT was successfully sent" for a single contractor or "SNAPSHOT was successfully sent to X contractors" for multiple contractors.

3.1.16 The system updates the contractor cards in the modal to show "Sent" status with the current timestamp.

3.1.17 The system closes the modal and returns the agency user to the Event Details page.

3.1.18 The system changes the button label from "Send SNAPSHOT" to "Resend SNAPSHOT" indicating that at least one contractor has already received the Snapshot.

### **3.2 Agency Portal - Resend Snapshot Flow**

3.2.1 The agency user clicks the "Resend SNAPSHOT" button on the Event Details page.

3.2.2 The system displays a confirmation dialog asking "Are you sure you want to resend the Snapshot? This will send updated information to the selected contractors."

3.2.3 The agency user confirms the resend action by clicking "Confirm" or cancels by clicking "Cancel".

3.2.4 If confirmed, the system displays the Send SNAPSHOT modal with the contractor list showing previous sent timestamps.

3.2.5 The agency user selects contractors and proceeds with sending as per the standard send flow.

3.2.6 The system fetches the latest project data including any changes to event details, contractor assignments, payment values, or notes before generating the Snapshot PDFs.

3.2.7 The system sends the updated Snapshots and displays the success notification.

### **3.3 Agency Portal - Download PDFs Flow**

3.3.1 The agency user opens the Send SNAPSHOT modal and selects one or more contractors.

3.3.2 The agency user clicks the "Download PDFs" button.

3.3.3 The system generates individual PDF Snapshots for each selected contractor with personalized content.

3.3.4 If a single contractor is selected, the system downloads a single PDF file named using the format: Snapshot\_\[ContractorName\]\_\[EventDate\].pdf (e.g., Snapshot\_John\_Doe\_Dec19-2024.pdf).

3.3.5 If multiple contractors are selected, the system downloads a zip file named using the format: Snapshots\_\[ProjectName\]\_\[EventDate\].zip (e.g., Snapshots\_Jadon\_Monika\_Wedding\_Dec19-2024.zip) containing individual PDFs for each contractor.

3.3.6 The system displays a green success toast notification stating "SNAPSHOT downloaded successfully".

3.3.7 The system closes the modal and returns the agency user to the Event Details page.

### **3.4 Contractor Portal - Download Snapshot Flow**

3.4.1 The contractor logs into the Contractor Portal and navigates to the Events section from the left sidebar menu.

3.4.2 The system displays a list of events the contractor is assigned to.

3.4.3 The contractor clicks on a specific event to view the Event Details page.

3.4.4 The system displays the Event Details page with the event header showing brand logo, project name, event date, and location.

3.4.5 The contractor locates the "Download SNAPSHOT" button on the Event Details page.

3.4.6 If the current date is more than one week before the event date, the system displays the "Download SNAPSHOT" button in a disabled/greyed-out state.

3.4.7 The contractor hovers over the disabled button and the system displays a tooltip stating "Snapshot can be downloaded only 1 week before the Event date."

3.4.8 If the current date is within one week of the event date, the system displays the "Download SNAPSHOT" button in an enabled state.

3.4.9 The contractor clicks the enabled "Download SNAPSHOT" button.

3.4.10 The system generates a personalized PDF Snapshot containing the contractor's assigned services, event details, notes shared with contractors, other contractors' contact information (excluding the downloading contractor), and client contacts.

3.4.11 The system downloads the PDF to the contractor's device with the filename format: Snapshot\_\[ContractorName\]\_\[EventDate\].pdf.

3.4.12 The system displays a green success toast notification stating "SNAPSHOT downloaded successfully".

### **3.5 Auto-Send Snapshot Flow (Automated)**

3.5.1 The agency owner or admin navigates to Settings > Notifications > Company Settings in the Agency Portal.

3.5.2 The system displays the Snapshot settings section with an "Send automatically one day before events" toggle.

3.5.3 The agency user toggles the setting to "On" to enable automatic Snapshot sending.

3.5.4 The system saves the setting and displays a success notification "Auto-send settings saved successfully".

3.5.5 The system runs a daily scheduled job to check for events occurring the next day.

3.5.6 For each event occurring the next day with auto-send enabled, the system generates personalized Snapshot PDFs for all assigned contractors.

3.5.7 The system sends emails with PDF attachments to each contractor's registered email address.

3.5.8 The system logs the auto-send action in the audit trail for tracking purposes.

3.5.9 For multi-day events, the system triggers the auto-send one day before the first event date only.

##

##

## **4\. Functional Logic**

### **4.1 Snapshot Content Structure**

*   The Snapshot PDF is organized into distinct sections displayed in a specific order: Header, Event Details, Services, Notes, Contacts, and Contractors.
*   The Header section displays the brand logo in the top area, followed by the project cover image (if uploaded) or a default placeholder image.
*   The Header section includes the full project name (e.g., "Jadon & Monika Wedding"), the event date formatted as a readable date (e.g., "Wed, Dec 19, 2025"), and the service area/city with timezone (e.g., "Boston, Massachusetts, USA • Timezone: GMT-4").
*   The Event Details section displays the event type (e.g., "Rehearsal Dinner"), the specific event date, time (if added), the primary venue name and full address, and the brand name with the brand owner/contact name.
*   If multiple venues exist for the event, the system displays a warning message stating "There may be additional locations, please check your timeline and notes to coordinate."
*   The Services section displays ONLY the services that the specific contractor receiving the Snapshot is assigned to, not all services for the event.
*   Each service in the Services section displays as a card containing the service name header (e.g., "Photography"), quick action buttons for Timeline (if uploaded for the event) and Shooting Guide (if configured in Brand Settings for the service type), and service metrics including role, coverage hours, minimum photo count (for Photography only), and payment amount.
*   The service metrics grid displays the contractor's assigned role (e.g., "Lead Shooter"), the number of coverage hours (e.g., "8 hours"), the minimum amount of photos required (displayed only for Photography service), and the contractor's fee amount formatted as currency (e.g., "$400.00").
*   Custom fields are displayed in the Services section only if they have been configured with visibility set to "visible to contractors" in the system settings.
*   Custom field values are displayed based on their field type: Short Text and Long Text display as plain text, Date Picker displays in formatted date, Number displays as numeric value, Link displays as clickable hyperlink, Single Choice displays the selected option, and Multiple Choice displays selected options as a comma-separated list.
*   If no custom fields are configured for the project, event, or services, or if no custom fields are set to be visible to contractors, the custom fields area remains empty and is not displayed.
*   The Service Note is displayed below the service details only if a note has been added by the agency for that specific service.
*   The Notes section displays only Public notes that have the "Contractors" checkbox selected in the visibility settings.
*   Private notes (visible only to the agency user who created them) are excluded from the Snapshot entirely.
*   Public notes that are shared only with Clients or Team Members (but not Contractors) are excluded from the Snapshot.
*   Each note in the Notes section displays the note headline (if provided) and the full note content.
*   Notes are displayed in chronological order with the newest notes appearing first.
*   The Contacts section displays all client contacts

associated with the event, including their profile photo (or initials avatar if no photo), full name, role/relationship (e.g., "Bride", "Mother of Bride", "Groom"), email address, and phone number.
*   If a contact's information is marked as "Not Available", the system displays an appropriate indicator in place of the missing information.
*   The Contractors section displays ALL contractors assigned to the event EXCEPT the contractor who is receiving the Snapshot.
*   Each contractor entry in the Contractors section displays their profile photo (or initials avatar), full name, service type they are assigned to, their role, location, email address, and phone number.
*   The Snapshot content adapts dynamically based on the recipient to avoid showing redundant information about themselves.

### **4.2 Send SNAPSHOT Modal Logic**

*   The Send SNAPSHOT modal opens as an overlay when the agency user clicks the "Send SNAPSHOT" or "Resend SNAPSHOT" button.
*   The modal displays a header with the title "Send SNAPSHOT" and an X icon button in the top-right corner to close the modal.
*   The modal displays a "Contractors" label as the section header with a "Select All" option aligned to the right.
*   The contractor list displays all contractors currently assigned to the selected event, regardless of their service type.
*   Each contractor row in the list displays the contractor's circular profile photo (or initials avatar if no photo is available), the contractor's full name as primary text, and the service type combined with role as secondary text (e.g., "Photography - Lead Shooter").
*   A star icon indicator is displayed next to contractors who hold lead roles (e.g., Lead Shooter).
*   Each contractor row displays a "Select" button that toggles to "Selected" when clicked.
*   Contractors who have previously received the Snapshot display a "Sent" status indicator with the date and time of the last send (e.g., "Sent: Feb 13, 2026, 2:30 PM").
*   Clicking the "Select All" option selects all contractors in the list and changes their individual buttons to "Selected" state.
*   When all contractors are selected, the "Select All" text changes to "Deselect All" to allow bulk deselection.
*   The modal footer displays three action buttons: "Cancel", "Download PDFs", and "Send to Contractors".
*   The "Cancel" button closes the modal without performing any action.
*   The "Download PDFs" and "Send to Contractors" buttons are disabled (greyed out) when no contractors are selected.
*   The "Download PDFs" and "Send to Contractors" buttons become enabled when at least one contractor is selected.
*   The "Send to Contractors" button is styled as the primary action button with a yellow/gold background color.

### **4.3 PDF Generation Logic**

*   The system generates Snapshot PDFs on-demand at the time of download or send, ensuring the content reflects the most current data.
*   Each PDF is personalized for the specific contractor, showing only their assigned services and excluding themselves from the contractors list.
*   The PDF filename for individual downloads follows the format: Snapshot\_\[FirstName\]_\[LastName\]_\[MonDD\]-\[YYYY\].pdf where spaces in names are replaced with underscores and hyphens are preserved.
*   If a contractor has a middle name, it is included between the first and last name with underscores (e.g., Snapshot\_Mary\_Jane\_Watson-Parker\_Dec19-2024.pdf).
*   The zip file filename for bulk downloads follows the format: Snapshots\_\[ProjectName\]\_\[MonDD\]-\[YYYY\].zip where spaces in the project name are replaced with underscores.
*   The system removes special characters from filenames except for underscores and hyphens to ensure file system compatibility.
*   Each PDF generation pulls fresh data from the database including event details, service configurations, contractor assignments, notes, and contact information.
*   The system does not cache previously generated Snapshots; every generation creates a new PDF with current data.

### **4.4 Email Sending Logic**

*   When the agency user clicks "Send to Contractors", the system generates individual PDF files for each selected contractor.
*   The system sends separate emails to each contractor's registered email address (not as bulk CC/BCC).
*   Each email includes the personalized Snapshot PDF as an attachment.
*   The email subject and body content are configured through the system email templates (to be defined separately).
*   If a contractor does not have a registered email address, the system skips that contractor and displays an error notification.
*   The system tracks successful and failed email deliveries and displays appropriate notifications to the agency user.

### **4.5 Auto-Send Settings Logic**

*   The auto-send toggle is located in Settings > Notifications > Company Settings within the Agency Portal.
*   The toggle label displays "Send automatically one day before events" with Off/On options.
*   The default state of the toggle is "Off" for new agency accounts.
*   When the toggle is turned "On", the system schedules automatic Snapshot sending for all future events.
*   The system runs a scheduled job daily (recommended: early morning based on agency timezone) to identify events occurring the next day.
*   For each qualifying event, the system generates personalized Snapshot PDFs for all assigned contractors and sends them via email.
*   For multi-day events (e.g., Dec 19-21), the auto-send triggers one day before the first event date only (i.e., Dec 18).
*   The auto-send process uses the same PDF generation logic as manual sends, ensuring data freshness.
*   The system logs all auto-send activities in an audit trail for tracking and troubleshooting purposes.
*   If the auto-send fails for any contractor, the system logs the failure and continues processing remaining contractors.

### **4.6 Contractor Portal Download Restriction Logic**

*   The "Download SNAPSHOT" button on the Contractor Portal is subject to a time-based access restriction.
*   The system calculates the number of days between the current date and the event date to determine button availability.
*   If the current date is more than 7 days before the event date, the button is displayed in a disabled/greyed-out state.
*   When the contractor hovers over the disabled button, the system displays a tooltip message: "Snapshot can be downloaded only 1 week before the Event date."
*   If the current date is within 7 days of the event date (including the event date itself), the button is displayed in an enabled state.
*   For multi-day events, the restriction is calculated based on the first event date.
*   The download restriction ensures that contractors receive the most up-to-date information closer to the event date.
*   Once enabled, the download button remains available until the event is completed or archived.

### **4.7 Resend Functionality Logic**

*   After at least one contractor has received the Snapshot, the button label changes from "Send SNAPSHOT" to "Resend SNAPSHOT".
*   The button label change is persistent and based on the send history stored in the system.
*   When the agency user clicks "Resend SNAPSHOT", the system displays a confirmation dialog to prevent accidental resends.
*   The confirmation dialog message asks: "Are you sure you want to resend the Snapshot? This will send updated information to the selected contractors."
*   The dialog provides "Confirm" and "Cancel" buttons for the user to proceed or abort the action.
*   Upon confirmation, the system opens the Send SNAPSHOT modal with updated contractor information.
*   The modal displays the last sent timestamp for each contractor who has previously received the Snapshot.
*   Resending always fetches the latest project data, including any changes to event details, contractor additions/removals, payment values, notes, or custom fields.
*   The resend functionality supports sending to the same contractors again or to a different selection of contractors.
*   After a successful resend, the system updates the sent timestamp for all recipients.

### **4.8 Sent Status Tracking Logic**

*   The system tracks the send status for each contractor at the event level.
*   When a Snapshot is sent to a contractor, the system records the timestamp of the send action.
*   The sent status is displayed on individual contractor cards within the Send SNAPSHOT modal.
*   The sent status format displays as "Sent: \[Date\], \[Time\]" (e.g., "Sent: Feb 13, 2026, 2:30 PM").
*   Contractors who have never received the Snapshot do not display any sent status indicator.
*   The sent status is updated each time a Snapshot is resent to a contractor, showing only the most recent timestamp.
*   The system does not display a count of how many contractors have received the Snapshot.

### **4.9 Tooltip Display Logic**

*   A tooltip is displayed when the user hovers over the "Send SNAPSHOT" or "Download SNAPSHOT" buttons.
*   The tooltip content for the Agency Portal includes: "📌 Snapshot - A one-page project brief for contractors. Use Snapshot to: See all key info in one place — no clicking around between tabs. Have an offline backup in case of network issues or Pixally downtime."
*   The tooltip content for the disabled download button on Contractor Portal states: "Snapshot can be downloaded only 1 week before the Event date."
*   Tooltips appear after a brief hover delay (approximately 500ms) and disappear when the cursor moves away.

### **4.10 Empty State Handling Logic**

*   If no venue address is available for the event, the venue field displays a dash ("—") or is omitted from the Snapshot.
*   If no client contacts are added to the event, the Contacts section displays the section header with no entries below it.
*   If no other contractors are assigned to the event (the recipient is the only contractor), the Contractors section displays the section header with no entries.
*   If no notes are shared with contractors (no Public notes with Contractors checkbox selected), the Notes section displays the section header with no entries.
*   If no timeline document is uploaded for the service, the Timeline button is not displayed in the service card.
*   If no shooting guide is configured in Brand Settings for the service type, the Shooting Guide button is not displayed.
*   If no cover image is uploaded for the project, the system displays a default placeholder image or uses the brand logo as a fallback.
*   If no service note is added for a specific service, the Service Note section is not displayed for that service.
*   If no custom fields are configured or none are visible to contractors, the custom fields area is not displayed.
*   If the minimum photo count is not set or the service is not Photography, the Min Photos field is not displayed.

### **4.11 Data Freshness and Version Control Logic**

*   Snapshot content is not static but reflects the current project state at the time of generation.
*   Every send or download action triggers a fresh data fetch from the database.
*   Changes made to event details, contractor assignments, payment values, notes, or custom fields after a Snapshot has been sent are reflected in subsequent downloads or resends.
*   Previously sent Snapshots retain their original data at the time of sending; the system does not retroactively update sent PDFs.
*   This approach supports ongoing project revisions and ensures contractor trust in the accuracy of received information.
*   The system does not maintain version history of Snapshots; only the most recent send timestamp is tracked.

### **4.12 Clickable Links in PDF Logic**

*   The Timeline button in the PDF, when clicked, opens or downloads the timeline document uploaded by the agency.
*   The Shooting Guide button in the PDF, when clicked, opens or downloads the shooting guide document configured in Brand Settings for the specific service type.
*   Email addresses in the PDF are clickable and open the user's default email client with the address pre-filled in the "To" field.
*   Phone numbers in the PDF are clickable on mobile devices and trigger the phone dialer; on desktop, they remain as selectable text.

## **5\. Field Details & Validations**

### **5.1 Send SNAPSHOT Modal Fields**

**Field Name**

**Field Type**

**Validation Rules**

Contractor Selection

Checkbox/Toggle

At least one contractor must be selected to enable action buttons

Select All

Toggle Button

Toggles selection state for all contractors in the list

### **5.2 Snapshot PDF Content Fields**

**Field Name**

**Field Type**

**Validation Rules**

Brand Logo

Image

Displays brand logo from Brand Settings; falls back to placeholder if not available

Cover Image

Image

Displays project cover image; falls back to brand logo or placeholder if not uploaded

Project Title

Text

Required; displays full project name; truncates with ellipsis if exceeds display width

Event Date

Date

Required; formatted as "Day, Mon DD, YYYY" for single day or "Day, Mon DD - Day, Mon DD, YYYY" for multi-day

Location

Text

Displays as "City, State, Country • Timezone: GMT±X"; shows dash if not available

Event Type

Text

Required; displays event type name (e.g., "Rehearsal Dinner", "Wedding")

Primary Venue

Text

Displays venue name and full address; shows dash if not available

Brand Name

Text

Required; displays brand name from Brand Settings

Brand Contact

Text

Displays brand owner/contact name; optional field

Service Name

Text

Required; displays service type name (e.g., "Photography", "Videography")

Contractor Role

Text

Required; displays assigned role (e.g., "Lead Shooter", "Second Shooter")

Coverage Hours

Number

Required; displays as "X hours" format

Min Photos

Number

Displayed only for Photography service; shows numeric value or dash if not set

Amount

Currency

Required; displays contractor fee formatted as "$X.XX"

Custom Fields - Short Text

Text

Displays only if visibility set to "contractors"; plain text format

Custom Fields - Long Text

Text

Displays only if visibility set to "contractors"; plain text format

Custom Fields - Date Picker

Date

Displays only if visibility set to "contractors"; formatted date

Custom Fields - Number

Number

Displays only if visibility set to "contractors"; numeric value

Custom Fields - Link

URL

Displays only if visibility set to "contractors"; clickable hyperlink

Custom Fields - Single Choice

Dropdown

Displays only if visibility set to "contractors"; selected option text

Custom Fields - Multiple Choice

Multi-select

Displays only if visibility set to "contractors"; comma-separated list of selected options

Service Note

Rich Text

Displayed only if note exists for the service

Note Headline

Text

Optional; displays note title if provided

Note Content

Rich Text

Displays full note body; supports formatting

Contact Name

Text

Required for each contact; displays full name

Contact Role

Text

Displays relationship type (e.g., "Bride", "Groom", "Mother of Bride")

Contact Email

Email

Displays email address; clickable link

Contact Phone

Phone

Displays formatted phone number; clickable on mobile

Contractor Name

Text

Required; displays full name of other contractors

Contractor Service

Text

Displays service type the contractor is assigned to

Contractor Role

Text

Displays contractor's role for the service

Contractor Location

Text

Displays contractor's location/city

Contractor Email

Email

Displays email address; clickable link

Contractor Phone

Phone

Displays formatted phone number

### **5.3 Settings Fields**

**Field Name**

**Field Type**

**Validation Rules**

Auto-send Snapshot Toggle

Toggle (Off/On)

Default: Off; toggles automatic sending 1 day before events

### **5.4 PDF Filename Fields**

**Field Name**

**Field Type**

**Validation Rules**

Contractor Name

Text

Spaces replaced with underscores; hyphens preserved; special characters removed

Project Name

Text

Spaces replaced with underscores; hyphens preserved; special characters removed

Event Date

Date

Formatted as MonDD-YYYY (e.g., Dec19-2024)

## **6\. Success Message Handling**

**Action**

**Success Message**

**Trigger Condition**

**Post-Success Action**

Send to single contractor

"SNAPSHOT was successfully sent"

Snapshot email successfully delivered to one contractor

Update sent status with timestamp; close modal

Send to multiple contractors

"SNAPSHOT was successfully sent to X contractors"

Snapshot emails successfully delivered to multiple contractors

Update sent status for all recipients; close modal

Download single PDF

"SNAPSHOT downloaded successfully"

PDF file successfully generated and downloaded

Close modal; file saved to user's device

Download multiple PDFs (zip)

"SNAPSHOT downloaded successfully"

Zip file successfully generated and downloaded

Close modal; file saved to user's device

Auto-send settings saved

"Auto-send settings saved successfully"

Toggle state successfully saved to database

Settings page remains open; toggle reflects new state

Contractor portal download

"SNAPSHOT downloaded successfully"

PDF file successfully generated and downloaded

File saved to contractor's device

## **7\. Error Message Handling**

**Error Scenario**

**Error Message**

**Trigger Condition**

**Required Action**

No contractors selected

"Please select at least one contractor"

User clicks action button without selecting any contractor

User must select at least one contractor

PDF generation failed

"Failed to generate Snapshot. Please try again."

System error during PDF creation

User should retry; contact support if persistent

Email send failed (single)

"Failed to send Snapshot to \[Contractor Name\]. Please try again."

Email delivery failure for one contractor

User should verify contractor email and retry

Email send failed (partial)

"Snapshot sent to X contractors. Failed to send to: \[Names\]"

Some emails delivered, some failed

User should verify failed contractor emails and retry

Network error during download

"Download failed due to network error. Please check your connection and try again."

Network connectivity issue during download

User should check internet connection and retry

No contractors assigned

"No contractors are assigned to this event"

User opens modal for event with no contractor assignments

User should assign contractors to the event first

Contractor email missing

"Cannot send Snapshot to \[Name\] - email address missing"

Contractor profile lacks email address

Agency should update contractor's email in their profile

File size exceeds limit

"Snapshot file size exceeds limit. Please contact support."

Generated PDF exceeds system file size limit

User should contact support for assistance

Auto-send configuration error

"Unable to save auto-send settings. Please try again."

Database error when saving toggle state

User should retry; contact support if persistent

Download restricted

"Snapshot can be downloaded only 1 week before the Event date."

Contractor attempts download more than 7 days before event

Contractor must wait until within 7 days of event

## **8\. Edge Cases**

**Scenario**

**System Behavior**

**Fallback/Recovery**

Contractor assigned to multiple services in same event

Single PDF generated showing all services the contractor is assigned to in separate sections

N/A - expected behavior

Event spans multiple days

PDF shows full date range; Auto-send triggers 1 day before first date; Download restriction calculated from first date

N/A - expected behavior

Contractor removed after Snapshot sent

No impact on previously sent Snapshot; New generation excludes removed contractor

Previously sent PDF remains unchanged

Service removed after Snapshot sent

No impact on previously sent Snapshot; New generation excludes removed service

Previously sent PDF remains unchanged

Contractor added after initial send

New contractor appears in modal on next access; Not automatically sent a Snapshot

Agency must manually send to new contractor

Large number of contractors (>20)

Modal displays scrollable list; All contractors remain selectable

Pagination may be added for very large lists

Very long project/event name

Text truncates with ellipsis in PDF header; Full name shown where space permits

Tooltip or wrapped text in detailed sections

Special characters in contractor names

Properly encoded in PDF; Filename uses sanitized version (special chars removed except hyphen/underscore)

Original name displayed in PDF, sanitized in filename

Contractor has no profile photo

Display initials avatar using first letter of first and last name

Consistent avatar style across all contacts

Multiple venues for event

Primary venue shown; Warning message displayed about additional locations

User directed to check timeline and notes

Timezone differences

Event times displayed in event's configured timezone

Timezone indicator included in location display

Agency updates event after sending Snapshot

Previously sent Snapshot retains old data; Resend required for updated information

Agency should resend to share updates

Contractor downloads while agency is editing

Snapshot reflects data at moment of download (latest saved state)

Real-time edits not included until saved

Browser blocks PDF download

Standard browser download blocked message displayed

User must allow downloads in browser settings

Email bounces

System logs bounce; No automatic retry; Sent status may show as sent despite bounce

Agency should verify email and resend

Auto-send scheduled but event cancelled

System should check event status before sending; Skip cancelled/archived events

No Snapshot sent for inactive events

Contractor unassigned same day as auto-send

System checks current assignments at send time; Only sends to currently assigned contractors

Unassigned contractors do not receive Snapshot

Event with no services configured

Services section displays header with message "No services configured for this event"

Agency should configure services before sending

All custom fields hidden from contractors

Custom fields section not displayed in Snapshot

N/A - expected privacy behavior

All notes are private

Notes section displays header with no entries

N/A - expected privacy behavior

Contractor is only person assigned to event

Contractors section displays header with no entries (self is excluded)

N/A - expected behavior

Same contractor assigned to multiple service types

All assigned services displayed in Services section with respective details

N/A - expected behavior

No timeline uploaded for service

Timeline button not displayed in service card

N/A - expected behavior

No shooting guide in Brand Settings for service type

Shooting Guide button not displayed in service card

N/A - expected behavior

Download button clicked rapidly multiple times

System prevents duplicate downloads; Shows loading state during generation

Only one download initiated

Session expires during modal interaction

User prompted to re-authenticate; Modal state may be lost

User must reopen modal after login

## **9\. Acceptance Criteria**

### **Functional Requirements**

1.  Agency users must be able to access the "Send SNAPSHOT" button from the Event Details page within the Services tab area.
2.  The Send SNAPSHOT modal must display all contractors assigned to the current event with their profile photo, name, service type, role, and selection button.
3.  Contractors who have previously received the Snapshot must display a "Sent" status with the date and timestamp of the last send.
4.  Users must be able to select individual contractors or use the "Select All" functionality to select all contractors at once.
5.  The "Download PDFs" button must generate correctly named PDF files with personalized content for each selected contractor.
6.  The "Send to Contractors" button must successfully deliver emails with PDF attachments to all selected contractors with valid email addresses.
7.  The button label must change from "Send SNAPSHOT" to "Resend SNAPSHOT" after the first successful send to any contractor.
8.  A confirmation dialog must appear before resending Snapshots to prevent accidental resends.
9.  The Contractor Portal must display the "Download SNAPSHOT" button for contractors assigned to events.
10.  The download button on Contractor Portal must be disabled when the current date is more than 7 days before the event date.
11.  A tooltip must display the download restriction message when hovering over the disabled button.
12.  Contractors must be able to download their personalized Snapshot PDF when within the 7-day window before the event.
13.  The Snapshot PDF must contain all required sections: Header, Event Details, Services, Notes, Contacts, and Contractors.
14.  The PDF must display only the services that the specific contractor is assigned to, not all event services.
15.  The Contractors section must display all other contractors assigned to the event, excluding the recipient contractor.
16.  Only Public notes with the "Contractors" visibility checkbox selected must appear in the Snapshot.
17.  Only custom fields marked as "visible to contractors" must appear in the Snapshot.
18.  Clickable links for Timeline and Shooting Guide must work correctly within the PDF when documents are available.
19.  Empty states must be handled gracefully without breaking the PDF layout or displaying errors.
20.  The Settings page must include the auto-send toggle under Notifications > Company Settings with "Send automatically one day before events" label.
21.  The auto-send feature must trigger correctly one day before the event date when enabled.
22.  For multi-day events, auto-send must trigger one day before the first event date only.
23.  Success and error messages must display appropriately for all user actions as specified.
24.  File naming must follow the specified convention with spaces replaced by underscores and hyphens preserved.
25.  All PDF generation must fetch fresh data from the database to ensure accuracy.

### **Data Consistency Rules**

1.  Resending a Snapshot must always fetch the latest project data including any contractor additions, removals, or data changes.
2.  The sent status timestamp must update each time a Snapshot is resent to a contractor.
3.  Auto-send must use the same data freshness logic as manual sends.
4.  Download restrictions must be calculated based on the first event date for multi-day events.
5.  Contractor assignments must be verified at the time of send/download to ensure accuracy.

## **10\. Manual Test Cases**

Test cases have been documented in a separate Excel file for direct upload to the test management system.

**Test Cases Document:** [FRD\_Snapshot\_Test\_Cases.xlsx](https://claude.ai/chat/FRD_Snapshot_Test_Cases.xlsx)

## **11\. Dependencies**

**Dependency**

**Type**

**Impact if Unavailable**

Event Management Module

Internal Module

Cannot retrieve event details, dates, or venue information for Snapshot generation

Project Management Module

Internal Module

Cannot retrieve project information, cover images, or project-level data

Contractor Management Module

Internal Module

Cannot retrieve contractor list, assignments, contact details, or profile information

Service Configuration Module

Internal Module

Cannot display service details, custom fields, roles, or pricing information

Contact Management Module

Internal Module

Cannot display client contacts or their relationship information

Notes Module

Internal Module

Cannot include notes in Snapshot; Notes section would be empty

Brand Management Module

Internal Module

Cannot display brand logo, brand name, or shooting guide documents

Custom Fields Configuration

Internal Module

Cannot determine field visibility settings or display custom field data

File Storage Service

External Service

Cannot retrieve cover images, timeline documents, or shooting guides

PDF Generation Service

External Service

Cannot create Snapshot PDF files; entire feature non-functional

Email Service

External Service

Cannot send Snapshots to contractors via email; download still functional

Settings Module

Internal Module

Cannot manage auto-send preferences or retrieve notification settings

Authentication Service

External Service

Cannot verify user permissions or contractor identity

Scheduler Service

External Service

Cannot trigger auto-send functionality; manual sends still functional

User Profile Service

Internal Module

Cannot retrieve profile photos or initials for avatar display

Timezone Service

External Service

Cannot display correct timezone information; may show UTC as fallback

## **12\. References**

*   **Design Files:** Figma screenshots provided (5 screenshots covering Snapshot page, Event Details, Send SNAPSHOT modal, success state, and Contractor Portal view)
*   **Settings Screenshot:** Auto-send toggle in Notifications > Company Settings
*   **Notes Visibility Screenshot:** Create new note modal showing visibility options (Private/Public with Clients, Contractors, Team Members checkboxes)
*   **Meeting Transcript:** Snapshot Functionality meeting dated February 13, 2026
*   **Related FRDs:**
    *   Event Management FRD
    *   Contractor Portal FRD
    *   Project Management FRD
    *   Services Configuration FRD
    *   Notes Module FRD
    *   Settings Module FRD
    *   Brand Management FRD
*   **API Documentation:** \[To be added\]
*   **User Stories/Tickets:** \[To be added\]

Events - Contractors Tab

# **Contractors Tab**

## **1\. Module Overview**

*   **Module Name:** Contractors Tab (Event Management)  
    
*   **Purpose:** Enable agency admins to assign, view, manage, and track contractors for specific event roles across different service categories  
    
*   **Business Goal:** Streamline contractor assignment workflow and provide comprehensive visibility into contractor status, compensation, and performance for event execution

## **2\. User Roles & Permissions**

**Role**

**Description**

**Key Permissions**

Agency Admin

Responsible for contractor assignments

Full access: view all contractor details, assign/remove contractors, access financial information, update event prices, manage contractor actions

## **3\. User Flow**

1.  **Navigate to the Contractors Tab** in the event management interface  
    
2.  **Filter by Service Category** (Photography/Videography/Content Creation) tabs to view relevant roles according to the service  
    
3.  **Check availability:** The user may click the Check Availability button to open the availability module before the contractor assignment  
    
4.  **Assign Contractors** using the global "**Assign Contractors**" button, role-specific assignment buttons, or service-specific assignment buttons  
    
5.  **Monitor Assignment Status** - View contractor details, pricing, and other status indicators  
    
6.  **Manage Contractor Actions** via the kebab menu (view contractor profile, pay contractor, update event price, replace or remove contractor)  
    

**Critical Path:** Contractors tab → Service Selection → Contractor Assignment → Status Monitoring

## **4\. Field Details & Validations**

### **4.1 Common (For Both Assigned and Unassigned states)**

**Field Name**

**Type**

**Required**

**Validation Rules**

Check Availability

Button

N/A

On click, redirect the user to the check availability module

Assign Contractors (All services - Global)

Button

N/A

\- "Assign Contractors" is the global button for assigning contractors for all services<br>- On click, opens the suggested contractor pop-up (for more details, refer to the suggested contractor's tab)

Service Type Tabs

Tabbed Filters

Yes

\- Display tabs for services assigned to the event<br>- Tabs displayed in fixed priority order: Photography → Videography → Content Creation<br>- Tabs are visible only for services configured in the Services tab for the event<br>- Tabs dynamically filter the contractor role needed cards for that service

Assign Contractors (Service-specific)

Button

N/A

\- "Assign Contractors" is the Service Specific assign contractor button<br>- On click, opens suggested contractor pop-up (for flow details, refer to the suggested contractor's tab)

### **4.2 Unassigned State (No Contractor Assigned)**

**Field Name**

**Type**

**Required**

**Validation Rules**

Role

Text + Icon

Yes

\- Fetched from the Services Tab (Roles needed for this event) configuration and displayed in the specific service tab<br>- By default, Lead shooter is displayed (until the user edits the service)<br>- Role Display Priority Order: Lead Shooter → Second Shooter → Assistant → Drone Operator

Contractor Avatar

Avatar

Yes

\- Show placeholder icon (?) when no contractor is assigned

Contractor Name

Text

Yes

\- Display text: Unassigned

Assign Contractor (Role Specific)

Button

Yes

\- Display a button labeled "Assign \[Role Name\]" under each contractor role<br>- On click: Opens the "Suggested Contractor" pop-up to select and assign a contractor to the specified role (for flow details, refer to the suggested contractor's tab)

### **4.3 Assigned State (Contractor Assigned)**

**Field Name**

**Type**

**Required**

**Validation Rules**

Role

Text + Icon

Yes

\- Roles displayed are based on roles selected during service configuration in the Services Tab<br>- Only roles that are selected for that specific service type (Photography, Videography, Content Creation) will be displayed<br>- By default, Lead shooter is displayed (until the user edits the service)<br>- Role Display Priority Order: Lead Shooter → Second Shooter → Assistant → Drone Operator

Pending Status

Text + Icon

Conditional

Display only when the contractor is assigned to the role, but the invitation is not yet accepted by the contractor

Rating

Text + Star Icon

Yes

\- Display the calculated average rating of contractors (fetched from the contractor's profile)<br>- Display "No ratings" for new contractors

Kebab Menu

Button

N/A

Options: Open profile, Update event price, Remove

Contractor Avatar

Avatar

Yes

\- Displays the contractor's avatar once assigned; if no avatar is uploaded by the contractor, shows initials from the full name of the contractor (e.g., John Doe → JD)<br>- Default state shows placeholder icon (Question Mark) for unassigned state

Contractor Name

Text

Yes

\- Displays the assigned contractor's full name<br>- The default state shows "Unassigned" if no contractor is assigned

Contractor Specialization

Text

Yes

\- Display contractor's service specialization (Photographer / Videographer / Content Creator)

Contract Icon

Icon

Yes

Displays Active (filled icon) if the contract is signed by the contractor; otherwise, it shows the unfilled icon

Invoice Icon

Icon

Yes

Displays Active (filled icon) if the invoice is generated by the contractor; otherwise, it shows the unfilled icon

Documents/Deliverables Icon

Icon

Yes

Displays Active (filled icon) if any deliverables are uploaded by the contractor; otherwise, it shows the unfilled icon

Payment Icon

Icon

Yes

\- Displays Active (filled icon) if full payment is received by the contractor<br>- Displays half-active (partially filled icon) if partial payment is received by the contractor<br>- Shows an unfilled icon if no payment has been made to the contractor by the agency

Event Price

Currency

Yes

\- Display the price assigned to the contractor for the service role in the event (calculated during assignment)

Amount Paid

Currency

Yes

\- Display the paid amount to the contractor or "$0.00" if unpaid

Location Distance

Text

Yes

\- Show the calculated distance time (Google Maps API) between the contractor's address and the event venue location (e.g., "12m. to location")<br>- Display the contractor's service area. Format: "Boston, USA"

### **4.4 Update Event Price**

_(Refer to Update Event Price section)_

## **5\. Functional Logic**

### **5.1 Service Tab Filtering:**

*   Only display service tabs (Photography, Videography, or Content Creation) that have been assigned to the current event  
    
*   When a service tab is selected, dynamically update the role cards based on the roles needed for the service (Lead Shooter, Second Shooter, Assistant, Drone Operator)

### **5.2 Assign Contractors Button:**

*   Opens "Suggested Contractors" modal showing the list of contractors available.  
    
*   Search contractors field available for manual search  
    
*   Filter tags displayed: Date, Service, Role, Service Area  
    
*   Contractor list columns: Actions (Select), Name, Rate, Fee, Service Area, Rating  
    
*   Contractors already assigned to the event do not appear in the list  
    
*   Right panel filters:  
    *   Services (Photography, Videography)
    *   Role selection
    *   Toggle: Show Invited Contractors (Pending)
    *   Toggle: Show only Backup Shooters
    *   Toggle: Bypass Contractor Travel Limits
    *   Service Area dropdown
*   Cancel and Assign Contractors buttons at bottom

### **5.3 Assignment State Management:**

*   Cards transition from unassigned placeholder to populated contractor details upon assignment  
    
*   When multiple contractors are assigned to a role, cards stack vertically with "Add Another" option

### **5.4 Payment Status Calculation:**

*   Icons reflect completion status — filled (complete), half-filled (partial), empty (not started)

### **5.5 Distance Calculation:**

*   Automatically calculate and display the travel time from the contractor's home address to the event venue location

### **5.6 Rating Display Logic:**

*   Show the average rating of the contractor (fetched from the contractor profile) or display "No ratings" for new contractors

### **5.7 Invitation Status Tracking:**

*   Display a pending indicator when the contractor is assigned but hasn't accepted the invitation

### **5.8 View Contractor Travel Fees Button (Lead/Inquiry Stage):**

*   The view contractor travel fee button is only visible when the event is on the lead stage.  
    
*   Button remains disabled until a venue is added to the event  
    
*   Hover tooltip on disabled state: "Please add the venue details in the event to see the contractor travel fees"  
    
*   Opens alternate version of assign contractor popup that:  
    *   Locks the date setting to event dates
    *   Defaults to service area filtering
    *   Shows available contractors for all roles and services
    *   Displays travel fees calculated for the event venue
    *   No action buttons on contractor cards (view-only)

### **5.9 Check Availability Button (Booked Stage):**

*   Replaces "View Contractor Travel Fees" once event moves to booked stage  
    
*   Redirects to the Check Availability module with filters pre-populated:  
    *   Date, Brand, Events, Service Type, Service Area, Venue, Role
*   Available Contractors list shows:  
    *   Contractor name with rating
    *   Distance to event location
    *   Select button to view details
*   Selected contractor panel displays:  
    *   Profile info (name, role, pay rate, travel fee, service area, rating)
    *   View Profile link
    *   Calendar view with contractor's scheduled events and tasks
    *   Events table (Date, Project, Brand, Service Area)
    *   Tasks table (Due Date, Task, Status)

### **5.10 Remove Contractor:**

*   Selecting "Remove" from the kebab menu opens a confirmation dialog before removing the contractor from the event.  
    
*   The dialog message varies based on the contractor's payment status:  
    

**Payment Status**

**Dialog Title**

**Dialog Message**

**Buttons**

Unpaid (Single or Multiple)

Remove Contractor?

Are you sure you want to remove this contractor from this event?

Cancel | Remove

Processing (Single)

Remove Contractor?

Payment of $\[Amount\] processing. Are you sure you want to remove this contractor from this event?

Cancel | Remove

Processing (Multiple - all processing)

Remove Contractor?

Payment of $\[Total Amount\] processing across \[N\] payments. Are you sure you want to remove this contractor from this event?

Cancel | Remove

Paid (Single)

Remove Contractor?

This contractor has already been paid $\[Amount\]. Are you sure you want to remove them from this event?

Cancel | Remove

Paid (Multiple - all paid)

Remove Contractor?

This contractor has already been paid $\[Total Amount\] across \[N\] payments. Are you sure you want to remove them from this event?

Cancel | Remove

Mixed (Paid + Processing)

Remove Contractor?

This contractor has already been paid $\[Paid Total\]. Are you sure you want to remove them from this event?

Cancel | Remove

**Payment Status Priority Logic:**

*   If ANY payment is **Paid** → Show only the combined paid amount (ignore processing & unpaid amounts)  
    
*   If NO Paid payments but some are **Processing** → Show combined processing amount (ignore unpaid)  
    
*   If ALL payments are **Unpaid** → Show standard unpaid message  
    
*   Payment count ("across \[N\] payments") is shown only for Multiple Paid or Multiple Processing scenarios (not for Mixed)  
    
*   Currency symbol is displayed based on the agency's currency settings (default: USD).  
    
*   Clicking "Cancel" closes the dialog without any changes.  
    
*   Clicking "Remove" removes the contractor from the event and returns the role card to the unassigned state.  
    
*   Payments are handled via Stripe; removing a contractor does not automatically cancel or refund any payments. Any payment discrepancies must be handled internally between the parties.

## **6\. Edge Cases**

**Scenario**

**Expected Behavior**

Google Maps API is unavailable

Display "--" for the distance field without blocking other functionality

The contractor becomes unavailable after the assignment

\- Contractor will be replaced/removed<br>- If removed, the role card returns to the unassigned state with the Assign button visible

The new contractor with no rating history

Display "No ratings" with a star icon

## **7\. Test Cases**

**Link:** [Pixally Test cases - 01.04.25](https://docs.google.com/spreadsheets/d/1RNM15mQt_Ax15liD7LeQZTvi_N01Hax4yZXSNIcN2dI/edit?gid=491179721#gid=491179721)

## **8\. Acceptance Criteria**

*   **Check Availability button:** Redirects successfully to the availability module  
    
*   **Unassigned Role Display:** Roles without assigned contractors show placeholder cards with "Role name", "?" avatar, and "Unassigned" label  
    
*   **Service Category:** Only services tabs that are assigned to the event are visible  
    
*   **Assignment Functionality:** Clicking any assignment button opens the appropriate suggested contractor pop-up  
    
*   **Contractor Card Population:** Assigned contractor cards display all required information: role, name, avatar, location, rating, event price, amount paid  
    
*   **Status Indicators:** Contract, invoice, deliverables, and payment status icons accurately reflect the current state  
    
*   **Pending Status Visibility:** The Pending icon displays only when the contractor is assigned, but the invitation is not accepted  
    
*   **Action Menu Access:** The Kebab menu provides access to all contractor management actions  
    
*   **Rating Interaction:** Clicking the rating opens a detailed rating pop-up  
    
*   **Remove Contractor Dialog:** Displays appropriate confirmation message based on payment status (Unpaid, Processing, Paid, or Mixed). For Mixed status (Paid + Processing), shows only the paid amount. Payment count is shown only for Multiple Paid or Multiple Processing scenarios.

## **9\. Dependencies**

**Module/System**

**Dependency Type**

**Impact if Unavailable**

Project/Events Management

Data dependency

Cannot fetch events and service details

Contractor Database

Data dependency

Cannot load contractor profiles and details

Google Maps API

External service

Cannot calculate how far the contractor's location is from the event venue

Payment Processing System

Data dependency

Payment status icons show the last known state

Event Configuration

Data dependency

Cannot determine which service tabs to display

Assignment Modal/Pop-up

UI dependency

Cannot complete contractor assignments

## **10\. References**

*   **Figma Design**: [Click Here](https://www.figma.com/design/ej0kxwP45mDKmZCZfAJ5O8/Pixally?node-id=15190-330968&t=DT99n0HA3l35de2W-0)

✅ Agency Owner Self-Event Assignment

# 

**Agency Owner Self-Event Assignment**

**Functional Requirement Document**

**BA & Ideation: Dakshraj Jhala**

**Reviewed By: KG (Project Manager)**

**Updated Date: 18 July 2025  
Status: Approved**

**Version 1.0**

#

#

#

#

# **Functional Requirements Document (FRD) - Agency Owner Self Event Assignment**

## **1\. Module Overview**

**Field**

**Details**

**Module Name**

Owner Self-Assignment to Project Events

**Purpose**

Enable studio owners/agency owners to assign themselves to project events as contractors without requiring pay rate configuration or service agreements.

**Business Goal**

Streamline the process for studio owners/agency owners to participate directly in project events while maintaining proper contractor tracking and conflict management.

## **2\. User Roles & Permissions**

**Role**

**Description**

**Key Permissions**

Studio Owner / Agency Owner

Business owner / primary owner of the agency

Full access: assign/unassign self, view/manage all contractors, access all events

Other Roles (Admin, Managers, Contractors, etc.)

Regular users with various access levels

No access: cannot see "Assign Yourself" button or self-assignment functionality

## **3\. User Flow**

### **Critical Path: Successful Self-Assignment**

1.  **Navigation:** Studio owner/agency owner navigates to Project → Event Management → Contractors tab
2.  **Button Access:** "Assign Yourself" button is visible and clickable (only for studio owner/agency owner role)
3.  **Pop-up Display:** Click opens assignment pop-up with Services and Role fields
4.  **Service Selection:** Select the required service from dynamically populated options
5.  **Role Selection:** Select the required role from the predefined options
6.  **Conflict Check:** The system validates that no date conflicts exist
7.  **Assignment:** Click the "Assign" button to complete the assignment
8.  **Confirmation:** The system displays a success message and updates the contractor card
9.  **Activity Log:** Assignment is logged in the project activity tab

### **Alternative Flows**

*   **Conflict Detection:** If a date conflict exists, show a warning pop-up with the project link
*   **Self-Removal:** Owner removes themselves via the three-dot menu with confirmation

## **4\. Functional Logic**

### **4.1 Default State**

*   The Contractors tab always displays the configured role slots (e.g., Lead Shooter, Second Shooter) with an "Unassigned" status and individual "Assign \[Role\]" buttons beneath each slot.
*   The service name (e.g., Photography) is shown as a section header above the role cards.
*   At the top of the Contractors section, two action buttons are displayed side by side: **"Assign Yourself"** (visible only to the studio owner/agency owner) and **"Assign Contractors"**.
*   A **"View Contractor Travel Fees"** button is also available in the header area.
*   At the bottom, a prominent **"Assign Contractors"** CTA button is displayed for bulk assignment.

### **4.2 Date Conflict Detection (Before Assigning)**

*   System checks all events across all projects where the owner is assigned.
*   Validates against the same calendar date (not time-specific).
*   Prevents assignment if a conflict exists and shows a redirect link to the conflicting project.

### **4.3 Service Assignment Logic**

*   Services are dynamically populated based on event configuration.
*   Owner can only assign to one service per event.
*   Assignment appears under the correct service tab (Photography, Videography, Content Creation).

### **4.4 Distance Calculation**

*   Uses Google Maps API to calculate the distance between the brand location and the event venue.
*   Distance is displayed on the contractor card for studio owners/solo operators.
*   Calculation is automatic upon assignment.

### **4.5 Price Display Logic**

*   Event price shows as "–" for self-assigned owners.
*   No pay rate configuration required.
*   No invoice submission is needed.

### **4.6 Raw Media Tab Access**

*   Post the event, the self-assigned owner gains access to upload delivery links in the raw media tab of the specific event.
*   Owners can upload delivery links for the service they were assigned to.

### **4.7 Project Management Event Listing Impact**

*   If the agency owner/studio owner assigns themselves to an event, their name will be displayed with **'You'** shown beside it, and the action icons will be disabled only for that entry.

### **4.8 Activity Logging**

*   All self-assignment actions are logged in the project activity tab.
*   Includes: timestamp, user, action type (assign/unassign), service, and role.

## **5\. Field Details & Validations**

**Field Name**

**Type**

**Required**

**Validation Rules**

Services

Radio Button

Yes

Must select one option from a dynamically populated list based on event configuration

Role

Radio Button

Yes

Must select one option from: Lead Shooter, Second Shooter, Drone Operator, Assistant

Confirm

Button

Yes

On click, if validation passes, assign the owner to the selected role & service in the specific event. If validation fails, display a relevant error message.

Cancel

Button

N/A

On click, close the pop-up

Event Date

System Field

N/A

Used for conflict validation across all projects

Event Status

System Field

N/A

Must not be "Completed" or "Archived" for assignment

## **6\. Success Message Handling**

**Validation Scenario**

**Success Message**

Self-assignment completed

"You have been successfully assigned to this event."

Self-removal completed

"You have been successfully removed from this event."

## **7\. Error Message Handling**

**Field**

**Validation Scenario**

**Error Message**

Services

Not selected

"Please select a service."

Role

Not selected

"Please select a role."

Date Conflict

Already assigned to another event on the same date

"You cannot assign yourself for this event because you already have a \[Project Name\] on this date."

Event Status

The event is completed/archived

"Cannot assign to completed or archived events."

General

Network timeout

"Something went wrong."

## **8\. Edge Cases**

**Scenario**

**Expected Behavior**

Owner assigns to a past event

Allow assignment if the event status is not completed/archived

Owner assigns to an event at maximum contractor capacity

Allow assignment (no restrictions)

Event is canceled after self-assignment

Automatically remove owner assignment and free up the date

Multiple services exist for the same event

Owner can only assign to one service due to a shared date conflict

Owner tries to assign to a completed event

Block assignment and show an appropriate error message

Google Maps API is unavailable

Show distance as "Unable to calculate" but allow assignment

Owner removes themselves during an active event

Allow removal with a confirmation dialog

## **9\. Acceptance Criteria**

**Core Requirements:**

*   Studio owners and agency owners can self-assign to project events.
*   The "Assign Yourself" button is visible only to studio owner/agency owner roles (not to admins or other roles).
*   Pop-up displays dynamically populated services and predefined roles.
*   The system prevents date conflicts across all projects.
*   Contractor card displays the owner with a "You" label and distance calculation.
*   Self-removal requires a confirmation dialog.
*   No pay rate or service agreement required.
*   All actions are logged in the activity tab.

**UI/UX Requirements:**

*   The assignment appears under the correct service tab.
*   Price displays as "–" for self-assigned owners.
*   Distance calculation uses the Google Maps API.
*   Conflict pop-up includes a clickable project name link.
*   The three-dot menu provides a removal option.

**Business Logic Requirements:**

*   One role per event limitation.
*   One service per event limitation (due to date sharing).
*   Automatic removal when the event is cancelled.
*   No assignment restrictions for capacity or past events (unless completed/archived).

## **10\. Dependencies**

**Module/System**

**Dependency Type**

**Impact if Unavailable**

Google Maps API

External Service

Distance calculation shows "Unable to calculate."

Email Module

Internal Module

No email notifications sent for assignments

Activity Logging

Internal Module

Assignment actions not logged

Project Management

Core Module

Cannot access event contractor functionality

User Role Management

Core Module

Cannot validate user permissions

Event Management

Core Module

Cannot access event data for assignments

## **11\. References**

*   **Figma Link:** [Click Here](https://claude.ai/chat/c0aa9367-c889-455b-b1b0-b2edf52d5b95#)
*   **Test Cases Link:** _TBD_

0 dollar assignment

# **Functional Requirements Document (FRD)**

## **Zero-Dollar ($0) Contractor Assignment — Cross-Module Logic Update**

## **1\. Module Overview**

• **Module Name:** Zero-Dollar ($0) Contractor Assignment Logic

• **Purpose:** Enable agencies to assign contractors to events at a $0 event price, supporting use cases such as voluntary work, pro bono engagements, training sessions, complimentary shoots, or internal assignments where no financial compensation is applicable.

• **Business Goal:** Allow $0 as a valid event price across the CRM — from assignment through invoicing, payment processing, financial reporting, and the contractor portal — while maintaining data integrity and preventing broken flows (e.g., Stripe $0 calls, division-by-zero in reports).

• **Scope of Impact:** This is a cross-module logic change affecting multiple areas of the CRM. Each impacted module is documented in Section 4 (Functional Logic).

## **2\. User Roles & Permissions**

**Role**

**Assign $0 Event Price**

**Upload Invoice for $0 Event**

**Review / Authenticate Invoice**

**View $0 in Finance**

**View $0 in Reports**

**View $0 in Portal**

Admin / Agency Owner

✅ Yes

N/A

✅ Yes

✅ Yes

✅ Yes

N/A

Agency Staff

✅ Yes (if has assign permission)

N/A

✅ Yes (if has payment permission)

✅ Yes (based on role)

✅ Yes (based on role)

N/A

Contractor

N/A

✅ Yes

N/A

N/A

N/A

✅ Yes

Client

N/A

N/A

N/A

N/A

N/A

N/A

**Additional Notes:**

*   No new permissions are introduced. Existing role-based access controls apply.
*   Contractors at $0 events have the same portal visibility as any other assigned contractor.
*   Contractors are allowed to upload invoices for $0 events. The agency reviews, authenticates, and processes the invoice on their end.

## **3\. User Flow**

### **Flow 1: Assigning a Contractor at $0**

1.  Agency user navigates to **Project Details → Events Tab → Contractors Tab**
2.  User clicks **"Assign Contractor"** and selects a contractor
3.  The Assign Event Price pop-up opens
4.  If the contractor does not have a pay rate set up, system displays a confirmation popup (see Section 4.1 for popup logic)
5.  User enters **$0.00** in the Amount field (or it defaults to $0 based on the unassigned rate)
6.  System validates: Amount >= $0 → passes validation
7.  User clicks **Save/Assign**
8.  System creates the contractor assignment record with amount = $0
9.  The contractor card displays **$0.00** (not blank, not "--")
10.  All downstream modules (invoices, finance, calendar, portal) reflect the $0 price

### **Flow 2: Contractor Uploads Invoice for $0 Event**

1.  Contractor is assigned at $0 event price
2.  Contractor navigates to **Contractor Portal → Payments**
3.  Contractor sees the event listed with "Event Price: $0.00"
4.  Contractor can upload an invoice for **any amount** — $0, $50 for parking, $100 for additional services, etc. — no permission from the agency is required
5.  Agency reviews the invoice in **Finance → Contractor Invoices**
6.  Agency can Pay or void the invoice.
7.  The invoice is not archived until the agency completes the review process

### **Flow 3: Agency Reviews Contractor's Invoice with Amount > Event Price**

1.  Contractor uploads an invoice for $50 on a $0 event (e.g., for parking fees or additional services)
2.  Agency receives the invoice in **Finance → Contractor Invoices**
3.  Agency reviews the invoice and verifies the charges
4.  If the agency approves, the agency updates the event price via **Update Event Price** to match the invoiced amount
5.  Standard payment flow proceeds for the approved amount
6.  All downstream modules reflect the updated price

### **Flow 4: Agency Reduces Event Price (>$0 → $0)**

1.  Agency navigates to **Update Event Price** and attempts to reduce the price
2.  System enforces the price floor rule — price cannot go below the amount already paid
3.  If no payment has been made, the agency can reduce the price to $0
4.  System sends a notification to the contractor about the price change to $0
5.  If the contractor has already uploaded an invoice, system shows a warning to the agency before proceeding (see Section 4.4 for warning logic)

## **4\. Functional Logic**

### **4.1 Assign Event Price Pop-up — $0 Validation & Contractor Rate Popup**

**Navigation:** Project Details → Events Tab → Contractors Tab → Assign Contractor

**Empty State:**

*   When the system first loads the Assign Event Price pop-up, the Amount field is empty and awaiting input.

**Validation Logic:**

*   Amount field accepts any value >= $0.00
*   Negative values and non-numeric characters are rejected
*   $0 is treated as a valid, intentional assignment — not a null or missing value

**Contractor Rate Not Assigned — Confirmation Popup:**

*   When the agency assigns a contractor who does **not** have a pay rate configured in the system, the following confirmation popup is displayed:  
      
    _"This contractor does not have a pay rate assigned. Proceeding will set the event price to $0. To assign a pay rate, go to Contractors → \[Contractor Name\] → Pay Rates."  
      
    _
*   If agency clicks **"Proceed"** → assignment continues with event price = $0
*   If agency clicks **"Cancel"** → assignment is cancelled; agency can navigate to set the rate first
*   This popup appears **only** when the contractor has no rate assigned — not when the agency intentionally enters $0 for a contractor who already has a rate

**Display Logic:**

*   On save, the contractor card always displays **$0.00** — never blank, never "--"
*   The system always creates a contractor assignment record with amount = 0; the record is never skipped

**Impact:**

*   Price history tab logs the $0 assignment the same as any other price entry
*   All downstream modules (invoices, finance, calendar, portal) reflect the $0 price immediately

### **4.2 Contractors Management — Pay Rates (Setup & Edit)**

**Navigation:** Contractors Management → Set Up User → Step 3/3 | Contractor Profile → Rates Tab → Edit Pay Rates

**Logic:**

*   Pay rate fields already allow $0 as input — no validation change needed
*   Display must render **$0.00** (for Fixed rates) or **$0.00/h** (for Hourly rates)
*   Display must never be blank or show "--" when the rate is zero
*   Existing note "Pay rates will be reflected only for future projects" still applies — no change needed

**Impact:**

*   When a contractor with $0.00/h rate is assigned to an event with 8 coverage hours, the calculated event price = $0.00/h × 8 = $0.00
*   Travel fee still applies on top of the $0 event price separately

### **4.3 Contractor Invoice Lifecycle for $0 Events**

**Navigation:** Finance → Contractor Invoices | Contractor Portal → Payments

**Invoice Upload Logic:**

*   Contractors can upload invoices for $0 events for **any amount** — $0, $50, $100, etc.
*   **No permission from the agency is required** to upload. The contractor has full autonomy to submit an invoice at any time, for any amount, regardless of the assigned event price
*   Common scenarios: contractor incurs parking fees, provides additional services, or wants to charge for extras not originally agreed upon
*   The uploaded invoice goes to the agency for **review and authentication**
*   The agency has full control to approve or void it.
*   The invoice is **not archived** until the agency completes the review process

**Agency Review & Price Adjustment:**

*   If the contractor uploads an invoice with amount > $0 for a $0 event, the agency reviews the charges
*   If the agency agrees with the charges, they update the event price via "Update Event Price" to match the approved amount, then process payment
*   If the agency disagrees, they void the invoice — the contractor is notified of the invoice.

**Price Floor Rule:**

*   The event price **cannot be reduced below the total amount already paid** to the contractor
*   Example: If $25 of $50 has been paid, the minimum allowed price is $25
*   If the agency attempts to reduce below the paid amount, system blocks with error (see Section 6, E6)
*   Refunds are handled **outside the portal** manually by the agency and contractor
*   If no payment has been made, reducing the price to $0 is allowed

**Invoice Warning on Price Change:**

*   When the agency changes the line item price and the contractor has already uploaded an invoice, the system shows a **warning** (not blocking):  
      
    _"The contractor has already uploaded an invoice for this event. Changing the price may create a discrepancy. Do you want to proceed?"  
      
    _
*   Agency confirms → price is updated, contractor is notified
*   Agency cancels → no change

**Impact:**

*   Price changes are logged in the price history tab
*   Contractor receives notification on any price transition ($0 → >$0 or >$0 → $0)
*   All downstream modules update to reflect the new price

### **4.4 Payment Processing Logic for $0**

**Navigation:** Finance → Contractor Invoices → Pay / Mark as Paid

**Stripe $0 Guard:**

*   **Stripe is NOT called** for $0 payment amounts under any circumstance
*   If amount = $0 reaches a Stripe call for any reason, the system bypasses Stripe entirely — this is a fallback safety check
*   Stripe will reject a $0 PaymentIntent, so this guard is critical

**$0 Invoice Approval:**

*   When the agency approves a $0 invoice, the system marks it as complete with the label **"No Payment Required"**
*   This is a **system-assigned label** — it is not a selectable option in the payment method dropdown
*   It appears only when the invoice/event amount = $0
*   No payment record with a monetary amount is created

**Standard Payment (>$0):**

*   When the event price transitions above $0, standard Stripe/manual payment flow applies — no change from existing behavior

**Impact:**

*   No Stripe fee is generated for $0 events
*   No payment transaction ID is created
*   "No Payment Required" label renders in all payment-related views: invoice history, contractor invoices list, payment records

### **4.5 Expenses Module**

**Navigation:** Finance → Expenses (COGS)

**Logic:**

*   When a contractor is assigned at $0 and no payment is made, the system does **not** auto-create a $0 expense entry — a $0 entry adds noise with no financial value
*   If the agency manually creates a $0 expense, it is allowed — the field already accepts $0
*   **QuickBooks Sync:** Do NOT sync $0 contractor payments to QuickBooks — a $0 expense entry in QB creates reconciliation confusion
*   Condition: If payment amount = $0 → skip QB sync entirely

**Impact:**

*   $0 events do not appear in the Expenses module unless manually added by the agency
*   QB remains clean with no $0 line items

### **4.6 Profit & Loss**

**Navigation:** Finance → Profit & Loss

**Logic:**

*   $0 contractor cost = $0 COGS → no impact on Gross Profit calculation
*   $0 contractor costs do not surface as anomalies in the P&L breakdown
*   If a project has one contractor at $0 and another at $500, COGS = $0 + $500 = $500 — no distortion

**Impact:**

*   No logic change needed — only display verification to confirm $0 renders cleanly

### **4.7 Contractor Portal — Payments**

**Navigation:** Contractor Portal → Payments

**Display Logic:**

*   When event price = $0, show the assignment in Payments with event price as **$0.00**
*   Contractor can upload an invoice for **any amount** directly — no restriction, no permission needed
*   If the contractor incurs additional costs (parking, extra services, etc.), they simply upload an invoice with the total charges
*   No payout is initiated for $0 events unless an invoice is uploaded and approved by the agency

**$0 → >$0 Transition:**

*   When the agency updates the event price from $0 to >$0 (after reviewing the contractor's invoice), the contractor receives a notification and standard payment flow resumes

**Multi-Agency Workspace:**

*   Each agency workspace shows its own event price independently — no cross-contamination
*   Agency A shows $0.00, Agency B shows $500.00 for the same contractor

**Impact:**

*   Contractor is always clearly informed about the $0 status — no confusion about missing payment

### **4.8 Reports — Contractors Report**

**Navigation:** Reports → Contractors

**Logic:**

*   $0 payment records are **included** in reports with $0.00 in the Amount Paid column — do not exclude
*   COGS column in P&L Report shows $0 — no anomaly
*   Tax Report (1099-NEC): Contractor row still appears with Total Paid = $0.00 — whether $0 income needs a 1099 is a tax question; the system reports accurately

**Division-by-Zero Guard:**

*   If any percentage or average calculation involves total pay = $0 in the denominator, display **"N/A"** instead of throwing an error
*   The formula "$0 / N = $0" is valid and does not need guarding — only "N / $0" needs the guard

**Impact:**

*   Reports remain accurate and inclusive of all $0 records

### **4.9 Calendar & Check Availability — Payment Icon Logic**

**Navigation:** Calendar → List View | Contractor Profile → Calendar

**Payment Icon States for $0 Events:**

**Scenario**

**Icon**

**Tooltip**

$0 event, no invoice uploaded

Special state (greyed-out / N/A variant)

"No payment required"

$0 event, contractor uploaded invoice, agency approved

Special state (greyed-out / N/A variant)

"No payment required — $0.00"

$0 event price updated to >$0, invoice paid

Filled (fully paid)

"Paid: \[Amount\]"

$0 event + $30 travel fee = $30, paid $15

Half-filled (partial)

Standard partial payment tooltip

True $0 (event price $0 + travel fee $0)

Special state (greyed-out / N/A variant)

"No payment required"

**Impact:**

*   A distinct "No Payment Required" icon state distinguishes $0 events from genuinely unpaid events

### **4.10 Notifications**

**Notification 1: Assignment at $0**

*   When a contractor is assigned to a $0 event, the existing assignment notification includes an additional line:  
      
    **"Event Price: $0.00 — No payment for this event."  
      
    **
*   Channel: Email and in-app notification (if applicable)

**Notification 2: Event Price Updated ($0 → >$0)**

*   When the agency updates the event price from $0 to an amount greater than $0 (e.g., after reviewing contractor's invoice for additional charges):  
      
    **"Your event price for \[Event Name\] has been updated to \[New Amount\]."  
      
    **
*   Trigger: Event price changes from $0 to any amount > $0
*   Recipient: Assigned contractor

**Notification 3: Event Price Reduced to $0 (>$0 → $0)**

*   When the agency reduces the event price from any amount back to $0:  
      
    **"Your event price for \[Event Name\] has been updated to $0.00. No payment is required for this event."  
      
    **
*   Trigger: Event price changes from any amount > $0 to $0
*   Recipient: Assigned contractor

**Impact:**

*   Contractor is always kept informed of price changes, preventing confusion and support requests

### **4.11 Service Agreement**

**Navigation:** Service Agreement templates with smart fields

**Logic:**

*   If rate is $0, smart fields populate with **$0.00** — never leave blank in the agreement
*   If the agency edits the event price from $0 to another amount after the agreement is sent, the system does **not** auto-update the sent document — the agency must resend the agreement with the updated amount

**Impact:**

*   Service agreements always display the correct amount at the time of sending

### **4.12 Event Cancellation**

**Navigation:** Project Details → Events Tab → Cancel Event

**Logic:**

*   When a $0 event is cancelled, the agency handles contractor communication **manually**
*   No special cancellation handling is provided for $0 events
*   If the event was $0 → updated to >$0 → contractor uploaded invoice → event is cancelled, the agency must handle the invoice manually — the system does not auto-void invoices on cancellation
*   Standard cancellation notification is sent — no special $0 messaging needed

**Impact:**

*   Same as any other event cancellation — no additional development required

### **4.13 Contractor Deactivation / Removal**

**Navigation:** Contractors Management → Contractor Profile → Deactivate / Remove

**Logic:**

*   When a contractor assigned to a $0 event is deactivated or removed, the system treats it the **same as any other contractor deactivation**
*   $0 assignment records remain for historical purposes
*   No financial cleanup is needed since no monetary transaction occurred (unless the event price was updated to >$0 and payment was made)

**Impact:**

*   No additional development required — standard deactivation flow applies

### **4.14 Dashboard / Home Page Widgets**

**Navigation:** Agency Dashboard / Home Page

**Logic:**

*   **Pending Payments:** $0 events do not appear — no payment is pending
*   **Outstanding Invoices:** If the contractor uploaded an invoice for a $0 event and it's pending agency review, it **does** appear here (since an invoice exists)
*   **Upcoming Payouts:** $0 events do not appear — no payout is scheduled
*   **Overdue Invoices:** $0 events do not appear unless the contractor uploaded an invoice that went overdue without agency action
*   **Total Revenue / COGS Summary:** $0 assignments contribute $0 to COGS — included in calculation but do not inflate or distort totals

**Impact:**

*   Dashboard remains clean without $0 noise in financial widgets
*   If a $0 event transitions to >$0, it enters relevant widgets at the updated amount

### **4.15 Email Templates**

**Navigation:** System Email Templates

**Logic:**

*   All system email templates that reference financial amounts must handle $0.00 gracefully
*   **Assignment Confirmation Email:** Display $0.00 as the event price with "No payment for this event." — must not show blank or broken formatting
*   **Event Reminder Email:** If the template includes event price, display $0.00
*   **Invoice Submission Reminder:** If contractor has not uploaded an invoice for a $0 event, the reminder should include context: "Event Price: $0.00"
*   **Payment Confirmation Email:** Not applicable for $0 events — if event transitions to >$0 and gets paid, standard confirmation is sent
*   **Price Update Notification Email:** Triggered on $0 → >$0 and >$0 → $0 transitions (see Section 4.10)

**Impact:**

*   All email templates must be tested with $0.00 values to ensure no blank fields, broken formatting, or $NaN/undefined errors

### **4.16 Filters & Search for $0 Assignments**

**Navigation:** Reports | Contractor Management | Calendar

**Logic:**

*   **Reports — Contractors Report:** Add the ability to filter by amount range including $0 — allows agencies to track pro bono work, training sessions, etc.
*   **Contractor Profile → Events/Assignments:** $0 assignments are visible in the contractor's assignment history with "No Payment Required" status
*   **Calendar Filters:** $0 events should be filterable under a "No Payment Required" status option to distinguish from unpaid events
*   **Finance → Contractor Invoices:** If contractor has uploaded an invoice for a $0 event, it appears in the list and is filterable like any other invoice

**Impact:**

*   Agencies gain visibility into complimentary work for operational and reporting purposes

### **4.17 Update Event Price Modal — UI State at $0**

**Navigation:** Project Details → Events Tab → Contractors Tab → Update Event Price

**Logic:**

*   When the event price is $0 and the agency opens the modal:
    *   Base Price Display shows **$0.00** as the current base event price
    *   Line Items Section is empty — no line items exist
    *   "Add Line Item" option is available and functional
*   Adding a positive-value line item recalculates: $0 + $50 = $50
*   Adding a negative line item on $0 base is blocked — error: "Final price cannot be negative"
*   **Price Floor Enforcement:** Agency cannot set the price lower than the amount already paid
*   **Invoice Warning:** If the contractor has already uploaded an invoice and the agency changes the price, system shows the warning dialog (see Section 4.3)
*   On save: if new total > $0 → triggers $0 → >$0 transition logic (contractor notification sent); if total remains $0 → no change
*   All additions and removals are logged in the price history tab

**Impact:**

*   The modal behaves consistently whether the price is $0 or any other amount

## **5\. Field Details & Validations**

### **Assign Event Price Pop-up — Amount Field**

**Field Name**

**Type**

**Required**

**Validation Rules**

Amount / Event Price

Numeric (currency)

Yes

Min: $0.00, Max: system limit, 2 decimal places, format: $X.XX, no negative values, no blank, no non-numeric characters

### **Pay Rates — Rate Field**

**Field Name**

**Type**

**Required**

**Validation Rules**

Pay Rate (Fixed)

Numeric (currency)

Yes

Min: $0.00, display: $0.00 when zero — never blank

Pay Rate (Hourly)

Numeric (currency)

Yes

Min: $0.00, display: $0.00/h when zero — never blank

### **Invoice Upload for $0 Events**

**Field Name**

**Type**

**Required**

**Validation Rules**

Invoice Upload

File upload

No

Allowed for $0 events — goes to agency for review

Agency Review Status

System-assigned

Auto

Not archived until agency completes review

### **Price Modification — Price Floor Rule**

**Field Name**

**Type**

**Required**

**Validation Rules**

Event Price (on update)

Numeric (currency)

Yes

Cannot be lower than total amount already paid. Refunds handled outside the portal. Reduction to $0 allowed only if no payment has been made.

## **6\. Error Message Handling**

**#**

**Field / Trigger**

**Validation Scenario**

**Error Message**

**Display Location**

E1

Amount Field

Negative value entered

"Please enter a valid amount."

Assign Event Price pop-up — inline below field

E2

Amount Field

Non-numeric characters entered

"Please enter a valid amount."

Assign Event Price pop-up — inline below field

E3

Amount Field

Field left empty on save

"Amount is required."

Assign Event Price pop-up — inline below field

E4

Update Event Price

Final price goes negative after adding negative item

"Final price cannot be negative."

Update Event Price modal — inline error

E5

Assign Contractor

Contractor has no pay rate configured

"This contractor does not have a pay rate assigned. Proceeding will set the event price to $0. To assign a pay rate, go to Contractors → \[Contractor Name\] → Pay Rates."

Confirmation popup during assignment

E6

Update Event Price

Agency tries to reduce price below amount already paid

"Event price cannot be lower than the amount already paid ($\[Amount\]). Refunds must be handled outside the portal."

Update Event Price modal — inline error

E7

Update Event Price

Agency changes price when contractor has uploaded invoice

"The contractor has already uploaded an invoice for this event. Changing the price may create a discrepancy. Do you want to proceed?"

Confirmation dialog (warning, not blocking)

E8

Pay (ACH)

Stripe called with $0 amount (guard failure — fallback)

"Payment processing is not required for $0 invoices."

System-level log / toast notification

E9

Reports

Division-by-zero in calculations

"N/A" in affected metric field

Reports — calculated column

## **7\. Edge Cases**

### **Group 1 — Assignment & Pricing**

**#**

**Scenario**

**Expected Behavior**

1

Agency assigns contractor at $0 but contractor's setup pay rate is also $0

No conflict. Both align. Show $0.00 in contractor card, not blank.

2

Agency assigns contractor who has no pay rate configured

Confirmation popup appears. Agency can proceed at $0 or cancel to set rate first.

3

Agency assigns at $0, adds +$50 line item via Update Event Price

Final Price = $50. Logged in price history. Contractor notified.

4

Agency assigns at $0, adds -$50 negative item

Blocked. Error: "Final price cannot be negative."

5

Agency assigns at $0, adds +$50, then removes it

Price reverts to $0. Both addition and removal logged. Contractor notified.

6

Contractor rate $0.00/h, coverage 8 hours

Event Price = $0.00. Travel fee applies on top separately.

7

$0 event price + $30 travel fee

Final Price = $30. NOT a "$0 event" for payment purposes. Normal flow triggers.

8

$0 event price + $0 travel fee

True $0 assignment. All $0 logic applies.

9

Agency edits $0 to $100 after service agreement sent

Agreement had $0.00. Agency must resend with updated amount. System does not auto-update.

10

Agency edits $100 to $0 after $50 already paid

Blocked. Price floor = $50. Refunds handled outside portal.

### **Group 2 — Invoice Upload & Review**

**#**

**Scenario**

**Expected Behavior**

11

Contractor uploads $0 invoice for $0 event

Allowed. Goes to agency for review. Agency can approve or void.

12

Contractor uploads $50 invoice for $0 event (e.g., parking, extra service)

Allowed. No permission needed. Invoice goes to agency for review. Agency verifies charges, adjusts event price if approved, or void.

13

Contractor uploads multiple invoices for $0 event

Follows existing multiple invoice rules. Each goes to agency .

14

$0 event, no invoice uploaded, agency tries to click "Pay"

No invoice exists. Cannot pay without uploaded invoice. Same as any event.

15

Agency changes price while contractor has pending invoice

Warning dialog shown. Agency confirms or cancels.

16

Agency approves $0 invoice, marks as complete

Stripe not called. Marked with "No Payment Required" label.

17

Contractor uploads $50 invoice for $0 event, agency approves and updates event price to $50, pays via ACH

Standard Stripe flow for $50. Agency adjusts event price to match approved invoice, then processes payment normally.

### **Group 3 — Price Floor & Payment**

**#**

**Scenario**

**Expected Behavior**

18

$50 event, $25 paid, agency tries to reduce to $10

Blocked. Floor = $25. Can reduce to $25 minimum.

19

$50 event, $50 fully paid, agency tries to reduce

Blocked. Floor = $50. No refund in portal.

20

$50 event, nothing paid, agency reduces to $0

Allowed. Contractor notified. $0 logic applies.

21

$0 event, contractor uploads $100 invoice for extra services, agency wants to approve

Agency updates event price to $100 via "Update Event Price," then approves the invoice and processes payment.

### **Group 4 — Finance Module**

**#**

**Scenario**

**Expected Behavior**

22

P&L: One contractor at $0, another at $500

COGS = $500. $0 contractor does not distort P&L.

23

$0 contractor — QuickBooks expense entry?

No. Skip QB sync for $0 events.

24

$0 expense auto-created?

No. Only entries with monetary value. Manual $0 expense allowed.

25

$0 event price + $30 travel fee — Total Expenses?

$30. Travel fee makes it > $0; standard flow applies.

26

$0 event, no invoice, no payment — "Amount Paid"?

$0.00. Not blank.

27

Invoices expandable row: expected $0, uploaded $0

Appears in row. Discrepancy = $0. No visual alert.

### **Group 5 — Payment Icon & Status**

**#**

**Scenario**

**Expected Behavior**

28

$0 event, no invoice — icon?

Special state (greyed-out / N/A). Tooltip: "No payment required."

29

$0 updated to $50, paid — icon?

Filled. Tooltip: "Paid: $50.00." Standard.

30

$0 + $30 travel = $30, paid $15 — icon?

Half-filled. Standard partial payment.

31

$0 event, $30 travel fee, travel later waived to $0

Price floor applies. If paid, can't go below paid amount. If unpaid, reverts to $0.

### **Group 6 — Service Agreement & Snapshot**

**#**

**Scenario**

**Expected Behavior**

32

Snapshot sent with $0

PDF shows $0.00 under Services. Not blank.

### **Group 7 — Reports & Tax**

**#**

**Scenario**

**Expected Behavior**

33

Contractor report: $0 paid across multiple events

Included. Total Paid = $0.00. Not excluded.

34

1099-NEC: 5 events all at $0

Total = $0.00. Row still appears. System reports accurately.

35

Division-by-zero in average pay rate

If $0 in denominator → "N/A." "$0 / N = $0" is valid.

### **Group 8 — Contractor Portal**

**#**

**Scenario**

**Expected Behavior**

36

Contractor sees $0.00 event in portal

"Event Price: $0.00" shown clearly. Contractor can still upload an invoice for any amount.

37

Multi-agency: $0 from Agency A, $500 from Agency B

Each workspace independent. No cross-contamination.

### **Group 9 — Automation, Notification & System**

**#**

**Scenario**

**Expected Behavior**

38

Automation "When invoice is paid" — fires for $0?

If agency marks $0 as complete, trigger fires. Configuration question for agency.

39

Stripe called with $0 (guard failure)

Stripe rejects. Guard: skip Stripe if $0.

40

Notification when >$0 changes to $0

Contractor notified: "Event price updated to $0.00. No payment required."

41

Dashboard "Pending Payments" — $0 event?

No — unless uploaded invoice is pending review (appears in Outstanding Invoices).

42

Email template renders $0.00?

Must render correctly. No blank, no $NaN, no undefined.

43

Filter for $0 in Reports

Filterable by amount range including $0.

44

Update Event Price modal on $0 event

Shows $0.00 base, empty line items, "Add Line Item" available. Price floor enforced.

45

Contractor deactivated with $0 assignment

Standard deactivation. Record retained. No financial cleanup.

## **8\. Acceptance Criteria**

• System accepts $0 as a valid event price without errors; contractor card displays $0.00.

• Confirmation popup appears when assigning a contractor with no pay rate configured, warning about $0 event price.

• Contractors can upload invoices for $0 events for any amount without needing agency permission; agency reviews and authenticates before archiving.

• Price floor rule prevents reducing event price below the amount already paid; refunds handled outside portal.

• Warning dialog appears when agency changes price and contractor has already uploaded an invoice.

• Contractor receives notification on $0 → >$0 transition, >$0 → $0 transition, and initial $0 assignment.

• Stripe is never called for $0 amounts; "No Payment Required" label renders for $0 events.

• $0 events do not auto-create expense entries and are not synced to QuickBooks.

• Payment icons show "No Payment Required" special state for $0 events; standard icons for >$0.

• All reports include $0 records with $0.00 values; no division-by-zero errors.

• Dashboard widgets exclude $0 from Pending Payments / Upcoming Payouts; uploaded invoices appear in Outstanding.

• All email templates render $0.00 correctly with no blank or broken values.

• Service agreements and snapshots populate $0.00 in smart fields — never blank.

• Agencies can filter reports by $0 amount for tracking complimentary / pro bono work.

## **9\. Dependencies**

**Dependency**

**Module / System**

**Impact**

Assign Event Price Pop-up

Project Details → Contractors Tab

Validation update, contractor rate popup

Update Event Price Modal

Project Details → Contractors Tab

UI at $0, line item logic, price floor, invoice warning

Contractor Invoices

Finance Module

Invoice upload at $0, agency review, Stripe bypass

Stripe Payment Gateway

External Integration

$0 guard before API calls

QuickBooks Sync

External Integration

Skip sync for $0 events

Expenses Module

Finance Module

Suppress $0 auto-expense

Payment Icon Component

Calendar, Contractor Profile

"No Payment Required" state, tooltips

Service Agreement Templates

Contracts Module

Smart field $0.00 verification

Snapshot PDF Generator

Project Finance Tab

$0.00 rendering verification

Reports Engine

Reports Module

Division-by-zero guard, $0 filter

Notification Service

System-wide

$0 assignment, $0 → >$0, >$0 → $0 notifications

Contractor Portal

External Portal

Invoice upload, "No Payment Required" display

Automation Engine

System-wide

$0 invoice completion triggers

Dashboard Widgets

Agency Dashboard

Exclude $0 from financial widgets

Email Templates

System-wide

$0.00 rendering validation

## **10\. References**

• **Existing FRD — Contractors Management:** Pay Rates section — allows $0 input

• **Existing FRD — Finance Module:** Contractor Invoices, Expenses, P&L logic

• **Existing FRD — Contractor Portal:** Payments section, invoice upload flow

• **Existing FRD — Service Agreement:** Smart fields and template logic

• **Existing FRD — Reports Module:** Contractor reports and tax reports

• **Existing FRD — Email Templates:** System email templates and smart field rendering

• **Existing FRD — Dashboard:** Widget logic for financial summaries

• **Stripe API Documentation:** PaymentIntent minimum amount restrictions

• **QuickBooks API Documentation:** Expense sync conditions

Suggested contractors and Event Pricing

# **Suggested Contractor Assignment & Event Pricing**

## **1\. Module Overview**

*   **Module Name:** Suggested Contractor Pop-Up & Event Pricing
*   **Purpose:** Provide agency administrators with a unified interface to select and assign contractors to event roles, using dynamic filters and availability logic, and then finalize event pricing per role
*   **Business Goal:** Streamline and standardize the contractor assignment and pricing workflow to ensure optimal match‐making, availability checks, and transparent pricing for each service role in an event

## **2\. User Roles & Permissions**

**Role**

**Description**

**Key Permissions**

Agency Admin

Event management staff are responsible for contractor assignments and pricing

\- Open the Suggested Contractors pop-up from four entry points

\- Use all filters & toggles

\- Select and assign contractors

\- Open the Assign Event Price pop-up

\- Adjust and confirm final pricing

\- Bypass all restrictions and travel limits

## **3\. User Flow**

### **3.1 Entry Points (Four Available)**

*   **Service-Specific (Services Tab):** Event → Services → Assign Contractors button
*   **Service-Specific (Contractors Tab):** Event → Contractors → Service Tab → Assign Contractors button
*   **Global (All Services):** Event → Contractors → Assign Contractors button (Global)
*   **Role-Specific:** Event → Contractors → Service Tab → Role Card → Assign {Role} button

### **3.2 Complete User Flow**

1.  **Entry Point Selection:** The user selects one of four entry points based on the assignment scope
2.  **Pre-Validation Check:** Before displaying the "Assign Contractor" pop-up, the system performs a pre-validation check to ensure the event date requirements are met. If the requirements are not met, the system displays a relevant error pop-up.
    *   If **Date TBD** → pop-up: "Please set event date before assigning contractors."
    *   If the **Venue is TBD**, the system will **still allow contractors** to be assigned to the event. In this case, no travel fee will be applied to the contractor, as no distance can be calculated from the event venue to the contractor's address
3.  **Suggested Contractors Pop-up:** Opens with default filters per entry point
4.  **Apply Filters & Toggles:** The user can modify filters and apply toggles as needed
5.  **Browse & Select:** Browse the contractor list (sorted nearest → farthest) and select the contractor
6.  **Assign Contractor:** Click Select → opens Assign Event Price pop-up
7.  **Set Final Price:** Review auto-calculated price + apply optional adjustment → Assign Now → Confirmation

**Critical Path:** Entry Point → Pre-validation → Filter Application → Contractor Selection → Price Confirmation → Assignment Completion

## **4\. Field Details & Validations**

### **4.1 Suggested Contractors Pop-up - Common Filters & Actions**

**Field Name**

**Type**

**Required**

**Validation Rules**

Search Contractors

Text input (search)

No

\- Free-text search across name

\- Real-time filtering as the user types

Date

Read-only chip

Yes

\- Displays the Event Date

\- Format MM/DD/YYYY

Service

Radio button group / Read-only chip

Yes

\- **Global Entry Point**:

\- **If single service configured**: Radio button with one option (auto-selected) + read-only chip display

\- **If multiple services are configured:** Radio button group with all available services + chip display for the selected option

\- Default selection priority: 1. Photography → 2. Videography → 3. Content Creation

\- **All Other Entry Points**: Read-only chip displaying the pre-selected service from entry point context (services radio button will not be displayed)

Role

Radio button group / Read-only chip

Yes/No

\- **Role-Specific Entry Point:** Read-only chip displaying the pre-selected role from the clicked role card (radio button filter not displayed)

\- **All Other Entry Points:**

\- **If single role configured:** Radio button with one option (auto-selected) + read-only chip display

\- **If multiple roles are configured:** Radio button group with options limited to roles configured for the selected service + chip display for the selected option

\- **Available roles:** Lead Shooter, Second Shooter, Assistant, Drone Operator

\- **Default selection priority:** Lead Shooter > Second Shooter > Drone Operator > Assistant

Service Area

Single-select dropdown + Removable chip

Yes

\- **Default:** Auto-populated from the event's service area

\- **Dropdown Options:** Contains all service areas configured for the agency

**\- User Action:** Can select different service areas from the dropdown to filter contractors

**\- Chip Removal:** Click the cancel (×) icon on the service area chip triggers a warning message with the proceed and cancel buttons

**\- Warning:** "Removing this filter will show all contractors available for this date and role, even if the event is outside their service area or travel preferences. Only assign a contractor if you've confirmed they're okay with this event. Proceed anyway?"

**\- If Proceed:** Shows global contractor pool matching the event date, listing criteria (except the service area), if the user clicks "Proceed", click **Cancel** closes the warning

Show Invited Contractors (Pending)

Toggle

No

\- **OFF (default):** show only fully onboarded contractors

**\- ON:** include pending invite contractors

Pending contractors are assignable, and Travel Fee displays as "$0" (as they have not completed onboarding and provided travel fee rates)

Show Only Backup Shooters

Toggle

No

\- **OFF (default):** show only non-backup contractors

\- **ON:** show only contractors flagged as backup shooters by the agency

Bypass Contractor Travel Limits

Toggle

No

\- **OFF (default):** enforce each contractor's travel distance limits (both travel without fees and travel with fees limits)

\- **ON:** show contractors that even if the event location exceeds their maximum travel distance limits

\- Travel fee is still calculated based on the contractor's travel fee structure and actual distance

Reset Filters

Button (icon)

No

\- On click, reset the filters back to the default selected state

Cancel

Button

No

\- Closes the Suggested Contractors pop-up without a contractor assignment

Assign Contractor

Button

No

\- By default, disabled until a contractor is selected

\- On click, it proceeds to the "Assign Event Price" pop-up

###

### **4.2 Contractor Listing Display Columns**

**Column**

**Type**

**Required**

**Details**

Name

Text + Avatar

Yes

\- Display the contractor's full name with avatar and role icon

\- Clickable to view the contractor profile

\- Displays contractor's service specialization (i.e, Photographer)

\- When no profile exists, use the initials of the full name (e.g., John Doe → JD)

\- Allows Name Sorting: ASC (A to Z) or DSC (Z to A)

Rate

Currency

Yes

\- Display the contractor's hourly rate or "Fixed Price" based on the rate setup by the agency for the role of the service for the event, per contractor role pricing

\- Format: $XXX/hour or $XXX (Fixed)

\- Allows Rate Sorting: ASC (Low to High) or DSC (High to Low)

Fee

Currency + Tooltip

Conditional

\- The fee will be displayed for all contractors

\- Distance = (distance between the contractor's address and the event venue location)

\- **Fully onboarded contractors:** Fee calculated based on the contractor's travel fee structure:

\- If distance ≤ Travel Without Fees limit: Shows Fee = "$0"

\- If distance > Travel Without Fees but ≤ Travel With Fees limit: Fee calculated for full distance (Distance × Rate per mile)

\- If distance > Travel With Fees limit: Contractor not displayed in the list (unless Bypass toggle enabled)

\- **If the Bypass Travel Limit toggle is enabled,** the fee is calculated for the full distance (Distance × Rate per mile)

\- **Pending contractors:** Shows "$0" (as they have not completed onboarding and configured the travel fee structure)  
\- **If** **Venue is TBD:** No travel fee will be applied to the contractor; it will display “$0”, as no distance can be calculated from the event venue to the contractor's address

\- On hover, the tooltip icon displays the tooltip message

Service Area

Text

Yes

\- Display the contractor's service area

\- Shows distance calculated via Google Maps API (Distance = Distance between contractor address and event venue location)  
\- **Note:** Distance calculation will not be displayed if the **venue is TBD** and contractor onboarding is not completed

\- Format: "X.X Miles to Location"

\- Allows Distance Sorting: ASC (Nearest to Farthest) or DSC (Farthest to Nearest)

Rating

Text + Star Icon

Optional

\- Display the contractor's calculated average rating (1-5 stars) or "No ratings" for a new contractor

\- Based on completed event reviews (fetch rating from contractor profile)

Select

Button

Yes

\- A select button is displayed for each listed contractor

\- Only one contractor can be selected at a time

\- On click, the button will change to "Selected," and the "Assign Contractor" button will be enabled

\- On click select button shows an info note: “Please Note: Only assign a contractor if you’ve confirmed they’re okay with this event.”

### **4.3 Assign Event Price/Update Price Pop-up Fields**

**Field**

**Type**

**Required**

**Details/Validations**

Contractor

Text + Avatar + Icon

Yes

Display the selected contractor’s avatar, full name, role icon, and service

Contractor Rate

Display Section

Yes

\- Display the selected contractor's hourly rate or "Fixed Price" based on the contractor’s rate set up by the agency

\- Format: **Hourly**: $XXX/h Hourly Rate

**Fixed**: $XXX Fixed Price

Formula Note

Text

Yes

\- **If Hourly:** "The price is calculated by the following formula: (Hourly Rate \* Hours) + (Distance Rate \* Distance)"

**\- If Fixed:** "The price is calculated by the following formula: Fixed Price + (Distance Rate \* Distance)"

Event Price

Currency Display + Tooltip

Yes

\- **If Hourly:** Display the amount calculated using the hourly rate of the contractor (set up by the agency) × Coverage Hours (service coverage hours)

\- **If Fixed:** Display the Fixed Price amount of the contractor (set up by the agency)

\- Hourly/Fixed is based on the price set up by the agency for the contractor's role in the service for the event

\- On hover, display a tooltip showing how the event price is calculated (Hourly Rate × Hours = Calculated Amount)

Travel Fee

Currency Display + Tooltip

Conditional

\- Shown for all contractors

\- **Fully onboarded contractors:** Fee calculated based on the contractor's travel fee structure:

\- If distance ≤ Travel Without Fees limit: Displays "$0"

\- If distance > Travel Without Fees but ≤ Travel With Fees limit: Fee calculated for full distance (Distance × Rate per mile)

\- If distance > Travel With Fees limit: Contractor not selectable (unless bypass travel limit toggle was enabled)

\- If the Bypass Travel Limit toggle is enabled, the fee is calculated for the full distance (Distance × Rate per mile)

**Pending contractors:** Display travel fee as "$0" (as they have not completed onboarding and configured the travel fee structure)  
**If Venue TBD:** Display travel fee as “$0” (as no distance can be calculated from the event venue to the contractor's address)

\- On hover, display a tooltip showing how the travel fee is calculated (Distance Rate × Distance = Calculated Amount)

Add Item

Button

No

On click, it will open an input field to add an item

Add Name

Text

Yes

\- Min 2, Max 50 char

Adjust Price

Toggle button

No

\- Optional adjustment field

\- "+/-" Toggle Button: Default shows "+" (positive adjustment)

\- Clicking the "+/-" button switches between positive and negative adjustment

\- When toggled to negative, the price will display with a minus sign (e.g., -$50.00). Clicking the toggle again will remove the minus sign, reverting to positive

\- The entered amount applies as positive or negative based on the toggle state

Amount

Number

Yes

\- Maximum 6 digits (0-9)

\- Numeric input only

\- The system prevents typing after 6 digits

\- Prevents zero entry as the first digit

Cancel (X)

Button

No

On click, it will close the Add Item input section

Yes

Tick Button

No

On click, it will validate that the final price is not negative. If it is negative, a validation error will be displayed. If not, the item will be added, and the final price will be calculated based on the sum of all items

Description

Text area

No

\- Character limit: 250 characters

Final Price

Currency Display

Yes

\- Sum of (Event Price + Travel Fee + Add Item(s), if any) will be calculated

\- “Final Price” must be ≥ $0 (Display validation error if negative due to adding an item)

Payment Note

Text

Conditional

Display the payment note for the contractor if it has been added by the agency (during the setup contractor)

Added Item

Text + Tooltip

Conditional

If an item is added, it will be displayed below the Travel Fee. If the item has a description, an icon will appear next to the item name, and hovering over the icon will display the description message. If no description is provided in the add item, no tooltip icon will be shown. The item will also have a delete and edit button option

Edit (Added Item)

Button

No

Opens the item in edit mode, allowing the user to modify the name, amount, or description of the added item, and updates the final price based on the adjustments

Delete (Added Item)

Button

No

Removes the item from the list and updates the final price accordingly

Cancel

Button

No

\- Closes pop-up without assignment

\- Returns to the Suggested Contractors pop-up

Assign Now

Button

Yes

\- The button remains enabled; if validation fails on click, a relevant error message will be displayed.

\- If validation passes, the contractor will be assigned to the specific role of the service in the event, with the final price

**Update Event Price** \- Update Event Price – On click, the Update Event Price button will display the same pop-up as Assign Event Price, with all the same functionalities, along with an additional Price History tab to view changes in the price history. The pop-up heading will be 'Update Event Price', and it will open with prefilled data from the last update or, if assigned for the first time, the initially assigned data.

Price History Tab

Tab + Scrollable List

Yes

\- Displays all price-related logs: Event Price, Travel Fee, and Add Items

\- If a new item is added, Logs "\[Item Name\] is added by \[User Name\]" along with its description and timestamp

\- If an item is updated: Logs "\[Item Name\] amount is changed from $X to $Y by \[User Name\]" with description and timestamp

\- If an item is removed: Logs “\[Item Name\] is removed by \[User Name\]”

\- Shows initial assigned Event Price and Travel Fee logs

\- Scrollable if multiple history entries exist

Cancel

Button

No

Closes the pop-up without saving changes

Update Event Price

Button

Yes

Validates all fields and updates the final price for the contractor. All changes (add/edit/remove items) are logged in Price History

##

## **5\. Error Message Handling**

**Field**

**Validation Scenario**

**Error Message**

Service Area Filter

Removing service area confirmation

pop-up: "Removing this filter will show all contractors available for this date and role, even if the event is outside their service area or travel preferences. Only assign a contractor if you've confirmed they're okay with this event. Proceed anyway?"

No Results

No contractors match filters

"No contractors found based on your current filters. Try adjusting the filters to see more results."

Add item

Empty

"Please enter an item name."

Add Item

Add item > 50 character

"Item name cannot exceed 50 characters."

Add Item

Add item < 2 character

"Item name must contain at least 2 characters."

Amount

Empty

“Please enter an amount.”

Description

Description > 250 char

"Description cannot exceed 250 characters."

Price Adjustment

Negative final price

"Final price cannot be negative. Please adjust the add item pricing."

Exceeding more than 7 numbers

General

System error

"Something went wrong."

## **6\. Success Message Handling**

**Validation Scenario**

**Success Message**

Contractor assigned successfully

"Contractor has been successfully assigned to the \[Event Name\]"

Contractor event price updated successfully

"Contractor's event price has been updated successfully."

##

## **7\. Functional Logic**

### **7.1 Entry-Point Default Filter Logic**

**Service-Specific (Services Tab & Contractors Tab):**

*   Service chip = The context service (Photography/Videography/Content Creation)
*   Role chip and Filter (radio button) = If more than one role is selected by default, the selected radio button will be based on the Highest-priority configured role (Lead Shooter > Second Shooter > Drone Operator > Assistant)
*   Date = Event Date (auto-populated)
*   Service Area = Event’s service area

**Global (All Services):**

*   Service chip and Filter (radio button) = If more than one service is available, the default selected radio button will be based on the following priority order: Photography > Videography > Content Creation. If only one service is available, the radio button for that service will be selected
*   Role = highest-priority configured role of selected/default service
*   Date = Event Date (auto-populated)
*   Service Area = Event’s service area
*   Filter Panel: Service and Role selection enabled

**Role-Specific:**

*   Service chip = Current service tab context (fixed, non-editable)
*   Role chip = Clicked role card (fixed, non-editable)
*   Date = Event Date (auto-populated)
*   Service Area = Event’s service area
*   Filter Panel: No service or role selection is available; only the toggle filter and service area dropdown are available

### **7.2 Contractor Listing Criteria & Logic**

Contractors must meet all of the following criteria to be listed in the suggested contractor pop-up.

*   **Availability Check:** Contractor must be available on the event date (based on the do not book days, the contractor’s calendar, and future bookings)
*   **Contractor Setup:** The contractor must be set up by the agency
*   **Service Area Match:** The contractor's service area must include the event’s service area (unless the Service Area filter is removed or the Bypass Travel Limit toggle is enabled)
*   **Service Specialization Match:** The contractor's services must include the event service type (Photography, Videography, or Content Creation)
*   **Role Match:** The contractor must be configured for the role (by the agency) being assigned (Lead Shooter, Second Shooter, Assistant, Drone Operator)
*   **Event Type Match:** The contractor must be configured for the specific event type being assigned (e.g., Anniversary, Wedding, Rehearsal Dinner)
*   **Assignment Check:** The contractor must not already be assigned to another role in the same event
*   **Backup Filter:** Contractor must meet backup shooter criteria when the toggle is enabled (only the contractors marked as backup shooters by the agency for the selected brand's particular events, services, and roles)
*   **Travel Distance Check:** The event venue must fall within the contractor's travel-with-fees or without-fees limit unless the Bypass Travel Limit toggle is enabled or the venue is TBD

**Sorting Logic (Suggested contractor pop-up):**

*   By default, sorting: The contractors in the table are automatically listed based on how close they are to the event venue. The nearest contractor to the event shows up first, and the farther contractors are listed afterward. The distance between the contractor's address and the event location is used to sort them
*   If the event venue is TBD, all contractors matching the filters and toggles will be listed, no travel fees will be applied to those contractors, and they will be displayed in alphabetical order

###

### **7.3 Filter Interactions & Behavior**

All toggles and filters can function simultaneously with these rules:

**Service Area Removal:**

*   Triggers a warning before removal
*   On Cancel: retain the current filter
*   On Proceed: expands to global contractor pool, maintains distance sorting

**Backup Shooter Toggle:**

*   Default OFF: show only non-backup contractors
*   If toggled on, show only backup shooters (for the selected role, service, event, and brand), contractors (those flagged as backup by the agency); all should remain assignable

**Pending Contractor Toggle:**

*   Default OFF: show only fully onboarded contractors
*   If toggled On: only contractors with pending invitations (invites not accepted and onboarding not completed) will be shown
*   Travel Fee displays as "$0" for pending contractors (as they have not completed onboarding and configured travel with/without a fee structure)

**Bypass Travel Limit Toggle:**

*   Default OFF: enforce each contractor's travel distance limits (both travel without fees and travel with fees limits)
*   If toggled On: show contractors that even if the event location exceeds their maximum travel distance limits
*   Travel fees are still calculated based on the travel pay rate (per mile) \* distance (between the contractor’s address and event location) (in miles)

### **Logic for the Combination of Toggles:**

**Note:** If the backup shooters toggle is on, it will display only the backup shooters marked as backup shooters by the agency for the selected brand's particular events, services, and roles

1.  **Backup Shooter Toggle OFF + Pending Contractor Toggle OFF:  
    **
    *   Only non-backup and fully onboarded contractors are shown, matching the listing criteria
    *   Travel limits are enforced, and the travel fee calculation is based on the distance  
        
2.  **Backup Shooter Toggle ON + Pending Contractor Toggle OFF:  
    **
    *   Only backup shooters (flagged by the agency) who are fully onboarded are shown, matching the listing criteria
    *   Travel limits are enforced, and the travel fee calculation is based on the distance  
        
3.  **Backup Shooter Toggle OFF + Pending Contractor Toggle ON:  
    **
    *   Only non-backup contractors with pending invitations and incomplete onboarding are shown, matching the listing criteria
    *   Travel limits are enforced, but the travel fee is shown as "$0" for pending contractors  
        
4.  **Backup Shooter Toggle ON + Pending Contractor Toggle ON:  
    **
    *   Only backup shooter contractors with pending invitations and incomplete onboarding are shown, matching the listing criteria
    *   Travel limits are enforced, and the travel fee is shown as "$0" for pending contractors  
        
5.  **Backup Shooter Toggle OFF + Pending Contractor Toggle OFF + Bypass Travel Limit Toggle OFF:  
    **
    *   Only non-backup, fully onboarded contractors who are within the travel distance limits are shown, matching the listing criteria
    *   The travel fee is calculated as per the distance  
        
6.  **Backup Shooter Toggle ON + Pending Contractor Toggle OFF + Bypass Travel Limit Toggle OFF:  
    **
    *   Only backup shooters who are fully onboarded and within travel distance limits are shown, matching the listing criteria
    *   The travel fee is calculated as per the distance  
        
7.  **Backup Shooter Toggle OFF + Pending Contractor Toggle ON + Bypass Travel Limit Toggle OFF:  
    **
    *   Only non-backup contractors with pending invitations and incomplete onboarding, who are within travel distance limits, are shown, matching the listing criteria
    *   The travel fee is "$0" for pending contractors  
        
8.  **Backup Shooter Toggle ON + Pending Contractor Toggle ON + Bypass Travel Limit Toggle OFF:  
    **
    *   Only backup shooter contractors with pending invitations and incomplete onboarding are shown, matching the listing criteria
    *   The travel fee is "$0" for pending contractors  
        
9.  **Backup Shooter Toggle OFF + Pending Contractor Toggle OFF + Bypass Travel Limit Toggle ON:  
    **
    *   Non-backup, fully onboarded contractors, even if the event location exceeds their travel limits, are shown, matching the listing criteria
    *   The travel fee is calculated as per the distance  
        
10.  **Backup Shooter Toggle ON + Pending Contractor Toggle OFF + Bypass Travel Limit Toggle ON:  
     **
     *   Only backup shooter contractors who are fully onboarded, even if the event location exceeds their travel limits, are shown, matching the listing criteria
     *   The travel fee is calculated as per the distance  
         
11.  **Backup Shooter Toggle OFF + Pending Contractor Toggle ON + Bypass Travel Limit Toggle ON:

**
     *   Only non-backup contractors with pending invitations and incomplete onboarding, even if the event location exceeds their travel limits, are shown, matching the listing criteria
     *   The travel fee is "$0" for pending contractors  
         
12.  **Backup Shooter Toggle ON + Pending Contractor Toggle ON + Bypass Travel Limit Toggle ON:  
     **
     *   Only backup shooter contractors with pending invitations, incomplete onboarding, or those whose event location exceeds their travel limits are shown, matching the listing criteria
     *   The travel fee is "$0" for pending contractors

### **7.4 Pricing Calculation & Source Logic**

**No Travel Fee (If Venue is TBD or Pending Contractor Invitation)**

*   If the event venue is TBD or the contractor is pending onboarding, no travel fee will be applied, as no distance can be calculated from the event venue to the contractor's address, and pending contractors have not set up any travel fees. In both cases, the travel fee will be displayed as ‘$0’

**Coverage Hours Source:**

*   Pulled from Services Tab configuration → Coverage Hours field for the service (Photography/Videography/Content Creation)

**Distance Calculation:**

*   Calculate the distance via Google Maps API between the contractor’s address and the event venue

**Per-Mile Rate:**

*   Per mile rate set up by the agency fetched from agency account settings (if not changed by the agency - default $1/mile)

**Pricing Formulas:**

Hourly Pricing Model:

*   Event Price = Contractor's Hourly Rate × Coverage Hours
*   Travel Fee = Distance between event venue and the contractor’s address (miles) × Rate per Mile (set by the agency)
*   Final Price = Sum of (Event Price + Travel Fee + Add Item(s), if any)

Fixed Pricing Model:

*   Event Price = Contractor's Fixed Price for Role
*   Travel Fee = Distance (miles) × Rate per Mile
*   Final Price = Sum of (Event Price + Travel Fee + Add Item(s), if any)

**Special Pricing Cases:**

*   For pending contractors and events with the venue marked as TBD, the Travel Fee is set to $0 (displayed as '$0') because the contractors have not completed onboarding to provide travel fee rates, and without a confirmed venue, no distance can be calculated between the contractor's address and the event venue
*   Service Area Removed: Travel Fee still calculated based on actual distance (Contractor’s address and event venue)
*   Role-Specific Pricing: Price fetched based on Event Type → Service → Role combination from contractor setup (price set by the agency)

### **7.5 Assignment Flow Logic**

1.  **Contractor selection:** The user clicks "Select" on the chosen contractor
2.  **Price pop-up opens:** System fetches pricing based on the contractor's role configuration for the service in the event (hourly or fixed price)
3.  **Price Display:** Auto-calculates Event Price, Travel Fee, Final Price
4.  **Optional adjustment:**
    *   Users can add an item with a mandatory item name and price input
    *   +/- toggle button controls whether the entered amount for the add item is positive (default) or negative
    *   Click the +/- button to switch between addition and subtraction
5.  **Final Validation:** Ensures Final Price ≥ $0 and required fields are completed
6.  **Assignment Commit:** "Assign Now" creates an assignment of the contractor to the event with the final price
7.  **Confirmation:** A success message is displayed, the pop-up is closed, and the contractor is shown in the contractor's card and the user list of the event and project

### **7.6 Contractor’s Update Event Price Flow Logic**

1.  **Update Action:** The user clicks the **"Update Event Price"** option on the contractor's card from the kebab menu  
    
2.  **Pop-up Opens:  
    **

*   It has the **same fields and structure as the Assign Event Price pop-up**, but with the following differences:  
    *   **Heading:** Displays **"Update Event Price"**.  
        
    *   **Event Price and Travel Fee** are displayed as read-only  
        

1.  **Price Display and History Messages:  
    **

*   **Final Price** = Event Price + Travel Fee + Add Item adjustments.  
    
*   **Price History Messages:  
    **
    *   **New Item:** “\[Item Name\] is added by \[User Name\]” along with description and timestamp.  
        
    *   **Edit Item:** “\[Item Name\] amount is changed from $X to $Y by \[User Name\]” along with description and timestamp  
        
    *   **Remove Item:** “\[Item Name\] is removed by \[User Name\]” and timestamp  
        
*   **Important Rule:** While the user is currently adding, editing, or removing items, **the Price History tab does not update in real-time**. It only displays the **latest log entries after the price is updated** (via the **Update Price** button) or initially assigned event price  
    

1.  **Add/Edit/Remove Items:  
    **

*   Users can add new items, edit existing ones, or remove them.  
    
*   All adjustments affect the **Final Price** in real time, but only appear in the **Price History tab after update confirmation**  
    

1.  **Price History Tab:  
    **

*   Displays the **most recent confirmed price history log** (last update).  
    
*   Logs include Event Price, Travel Fee (from initial assignment), and Add Item actions with user name, description, and timestamp  
    
*   The tab is scrollable if there are multiple historical updates  
    

1.  **Final Validation:  
    **

*   Ensures **Final Price ≥ $0** and all required fields (Add Name, Amount) are valid.  
    

1.  **Update Commit:  
    **

*   Clicking **"Update Price"**:  
    *   Validates all inputs  
        
    *   Updates the contractor’s event price  
        
    *   Creates a new log entry in **Price History** based on all recent changes (added/edited/removed items)  
        

1.  **Confirmation:  
    **

*   Displays a success message, closes the pop-up, and updates the contractor card with the new price and adjustments

## **8\. Edge Cases**

**Scenario**

**Expected Behavior**

Venue or Date Missing

Pre-validation pop-up blocks entry into the Suggested Contractors flow

No contractors match filters

Show "No contractors found based on your current filters. Try adjusting the filters to see more results."

Remove Service Area

Warning pop-up: On Cancel: Retain the filter. On Proceed: Show the global pool of contractors available for the selected date and role, by default sorted by distance from nearest to farthest

The backup shooter toggle is enabled

Warning pop-up; on Cancel: revert to non-backup list; on Proceed: show backup shooters only

Bypass travel limit enabled

Show all available contractors regardless of their travel distance limits; travel fee still calculated based on actual distance; still by default sorted by distance from nearest to farthest

The contractor deleted it during the selection

Show warning: "This contractor is no longer available. Please select another contractor."

## **9\. Test Cases**

*   **Link:**

## **10\. Acceptance Criteria**

*   **Entry Point Access:** All four Assign Contractors buttons open the Suggested Contractors pop-up with the correct default filters per entry point logic
*   **Listing Logic:** Display contractors who match the availability criteria (or toggled rules), sorted by default based on distance from the event venue to the contractor’s address, from nearest to farthest. If the event venue is TBD, all contractors matching the filters and toggles will be listed, and no travel fees will be applied to those contractors
*   **Toggle Behavior:** Pending, Backup, and Bypass toggles function with appropriate warning pop-up and list updates as specified
*   **Dynamic Role Loading:** Roles are displayed in the filter dynamically based on selected services in the Global assignment flow
*   **Select Action:** Selecting a contractor and clicking the 'Assign Contractor' button opens the 'Assign Event Price' pop-up with the correct pricing model and calculations
*   **Price Calculation:** Event Price, Travel Fee, Subtotal, and Final Price computed per locked formulas for both hourly and fixed pricing
*   **Adjustment & Comment:** Price adjustment optional; comment required if adjustment ≠ 0
*   **Assignment Commit:** The "Assign Now" button assigns the contractor to a selected role for the service in the event, with the final price and updates the user list, displaying the contractor
*   **Error Handling:** Missing venue/date, negative pricing, API errors, and edge cases are handled gracefully with appropriate messaging
*   **Confirmation pop-up:** Service Area removal displays a proper warning message with Cancel/Proceed options
*   **Travel Fee Logic:** Travel fee displays "$0" for pending contractors, or in case if event venue is TBD, the Travel fee will be calculated for the onboarded contractors and the event venue is not TBD
*   **Filter Reset:** The Reset button restores the default filters
*   **Simultaneous Filters:** All toggles can be enabled simultaneously without conflicts

## **11\. Dependencies**

**Module/System**

**Dependency Type**

**Impact if Unavailable**

Event Management

Data dependency

Cannot fetch event date, venue, or service configuration; pre-validation fails

Contractor Database

Data dependency

Cannot list contractors, fetch profiles, pricing, or availability status

Services Configuration

Data dependency

Cannot determine coverage hours, service-role mappings, or pricing models

Calendar Integration/Check Availability

Functional service

Cannot validate contractor date availability; may show unavailable contractors

User Authentication

System dependency

Cannot determine user permissions for contractor assignment

Payment Processing

Data dependency (optional)

Payment calculations and post-assignment billing may be incomplete

Notification Service

External service

Contractor assignment notifications may fail; the assignment still completes

UI pop-up Components

UI dependency

Cannot open Suggested Contractors or Assign Price pop-up; blocks the entire flow

## **12\. References**

*   **Figma Designs:** [Click here](https://www.figma.com/design/ej0kxwP45mDKmZCZfAJ5O8/Pixally?node-id=15012-128349&t=DI8BqPMVvCWpIU8z-0)

✅ Events - Raw Media

## **Raw Media Tab**

## **1\. Module Overview**

*   **Module Name:** Raw Media Tab
*   **Purpose:** To display project deliverables submitted by contractors or the agency owner (for self-assigned events) after the event, organized by the agency owner first, followed by contractor roles. The agency owner can upload deliverables from the Raw Media tab, while each contractor’s delivery content is displayed based on the delivery method they selected and uploaded through the contractor portal
*   **Business Goal:** Provide agency administrators with centralized visibility into all project deliverables—whether submitted by contractors or the agency owner (for self-assigned events)—after event completion, organized by role hierarchy and delivery source

## **2\. User Roles & Permissions**

*   **Link:** [Roles and permissions - draft](https://docs.google.com/spreadsheets/d/1fPBOJVJmmtHcs9Ev9o_pneOD4Em3Z4AB-j3jrLyJvaY/edit?gid=1761753638#gid=1761753638)

![](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAABpwAAAB2CAIAAABasKe9AAAQAElEQVR4Aey9PW9jSbcuVhzb8M+wJXQbw0Z3oInOe09yYhES0O07CQkp6RMYcCi2gheNucZgMDDUZOL4duAWxGSAHqAbJHCzE9xz3hONDLTQHKBp0dlxYsdObHo9qz521f4iKVEUKT3E3pt7V61ateqpql1Vq1bV/u5v/vdP//RP//b//F88iAARKCLwn//2z//5//7feBABIkAEiAARIAKrROBv/1xsc+lCBB4JAtK9fCQpZTI3CoGtEIa1YyuyiUJuCALfGf6IABEgAkSACBABIkAEiAARIAIFBOhABIgAESACRIAIbDICiVJv739u8SACRKCIwL//Tyf//n/5H3gQASJABIhAPQL0JQLLIfCfToptLl2IwCNBQLqXjySlTCYRWBYB1o5lESP9Y0bgu/9277+zx3/5X/9X//Yf/saDCBCBIgL/5//0r0VHutweAXIgAkSACBCBx4wAm9fHnPtMO8s/ywARqEKAtaMKGboTgSICiaXeJpsUGmMoHhEgAkSACBABIkAEiAARIAJEgAgQASLw8BFgCokAEVgAASr1FgCJJESACBABIkAEiAARIAJEgAhsMgKUjQgQASJABIjA40OASr3Hl+dMMREgAkSACBABIkAEiAARIAJEgAgQASJABIjAliNApd6WZyDFJwJEYD0IMBYiQASIABEgAkSACBABIkAEiAARIAKbhACVeneTG+RKBIgAESACRIAIEAEiQASIABEgAkSACDx8BJhCInBvCFCpd2/QM2IiQASIABEgAkSACBABIkAEHh8CTDERIAJEgAgQgdUgQKXeanAkFyJABIgAESACRIAI3A0C5EoEiAARIAJEgAgQASJABEoQ2Aql3qjTyH6dz0kyRseZV+N4lPgt+TB990x5PetPFgw57b/QEC/60wVDgMwmpwNZJ30bpXLJXZQA9Ks4J/3Ou2VkXEWcD5qHzcRcltnHxcvPChEadbLCP71Rsby1MJ9dNfU1tFyM6btOVr8mrvw/Y+G8NfwpAz4RASJABLYdgUI7mzVz2540yk8E5iOQDXAWHmUsP5ApiJHvyxUI6EAE7gsBP2qww6346ocet5PM818NtyBL3Rh86oZsmpjcaMhXZ/Vb+CUQouXNY0NgK5R6SaZc/hkrp0YX54nvFjx8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)

## **3\. User Flow**

1.  User navigates to the **Raw Media** tab
2.  **Before event completion:** The Raw Media tab displays the message:
    1.  “No Raw Media Available Yet” — “Contractors will upload raw deliverables here once the event concludes. Please check back later.”
3.  **After the event completion:**
    1.  Contractors are displayed by role hierarchy (Lead Shooter > Second Shooter > Drone Operator > Assistant).
    2.  **If the contractor hasn’t submitted deliverables:**
        1.  When a contractor has not yet submitted any RAW Media, display the following information in a clear and informative manner:
            1.  **Role (with icon)** assigned for the event (Lead Shooter, Second Shooter, Drone Operator, assistant) and follows the role hierarchy
            2.  **Contractor’s Avatar and Full Name**
            3.  **Service specialization** for the event (Photographer/Videographer/Content Creator)
            4.  **Text:** “Nothing Here” **Subtext:** “This contractor is yet to provide RAW Media”
    3.  **If the contractor has submitted deliverables,** show delivery by its methods submitted by the contractor (Digital Delivery, Hard Drive, Other)
    4.  Admin can copy digital delivery URLs, view tracking info, and read custom text

**Critical Path:** Project details > Events > Raw Media Tab > View contractor deliverables by role > View delivery based on method type

## **4\. Functional Logic**

*   **Empty State (Pre-Event Display):** Before event completion, the raw media tab shows an empty state based on 2 cases
    *   **Display Message:** No Raw Media Available Yet  
        **Subtext:**
        *   Case 1 - If the **agency owner is assigned** to the event: Deliverables will be uploaded here by the agency owner or contractors once the event concludes. Please check back later.
        *   Case 2 - If the **agency owner is not assigned in the event**: Contractors will upload raw deliverables here once the event concludes. Please check back later.

### **(Post Event) – Agency Owner Upload Deliverables Section:** If the agency owner is assigned to an event (self-assigned), the system displays the “Upload Deliverables” section above the contractors’ section once the event date has passed.

### **This section includes:**

### An input field to paste delivery links (e.g., Dropbox, Google Drive, etc.)

### A “+ Add Additional Link” button to add up to 5 links maximum

### Each added link appears with an editable input field and a delete (✕) icon

*   *   **Functional Behavior:**
        *   The agency owner can edit a link directly by typing in the input box
        *   When any change is made, the Save button becomes active
        *   Clicking Save updates the link
        *   Clicking the delete (✕) icon opens a confirmation modal: “Are you sure you want to delete this link?” with options Cancel and Delete
        *   On clicking Delete, the uploaded link will be removed. On clicking Cancel, the confirmation dialog will close without making any changes
        *   Each link must be a valid URL format before saving
*   **(Post Event) – No Submission by Contractor:** If the contractor has not submitted any deliverables after the event, the system will display the contractor’s **role**, **avatar**, **name**, and **service**, along with the message:  
    **“Nothing Here – This contractor is yet to provide RAW Media.”**
*   **Post Event Contractor Display:** After event completion, show contractor cards with role, name, specialization, and chosen delivery method
*   **Role Hierarchy Display:** Contractors grouped and displayed in priority order: Lead Shooter > Second Shooter > Drone Operator > Assistant
*   **Delivery Method Categorization:** All submitted delivery methods (Digital, Hard Drive, Other) are displayed together
*   **Digital Delivery Display:** URLs are shown vertically (if more than one) with clickable links and copy icons
*   **Hard Drive Display:** Show tracking number, shipping service (entered by contractor), and shipping address (system populated)
*   **Other Delivery Display:** Show contractor-submitted text exactly as entered, multi-line supported
*   **Profile Integration:** Contractor name is clickable to open full profile view of the contractor (agency contractor management module > View profile)

## **5\. Field Details & Validations**

**5.1 Empty (Pre-Event)**

**Field Name**

**Type**

**Required**

**Validation Rules**

Empty State Message

Static Text

Yes

Display the message: “No Raw Media Available Yet”

Subtext: “Contractors will upload raw deliverables here once the event concludes. Please check back later.”

**5.2 Empty (Post Event)**

**Field Name**

**Type**

**Required**

**Validation Rules**

Contractor Role Label

Text + Icon

Yes

\- Displays the role (with icon) of the assigned contractor who will submit the deliverables for the event  
\- View only  
\- Roles: Lead Shooter, Second Shooter, Drone Operator, Assistant

Contractor Avatar/Name and specialization

Text

Yes

\- Displays the full name and avatar of the contractor for each submitted deliverable

\- Display the contractor’s specialization for the event (i.e., Photographer/Videographer/Content Creator)

\- Clickable to open contractor profile

Static Text

Text

Yes

\- Display static text until event completion and no deliverables are uploaded by the contractor  
\- Text: “Nothing Here”

\- Sub text: “This contractor is yet to provide RAW Media”

## **5.3 Deliverables Uploaded (Post Event)**

**Field Name**

**Type**

**Required**

**Validation Rules**

Contractor Role Label

Text + Icon

Yes

\- Displays the role (with icon) of the contractor who submitted the deliverables for the event  
\- View only  
\- Roles: Lead Shooter, Second Shooter, Drone Operator, Assistant

Contractor Avatar/Name and specialization

Text

Yes

\- Displays the full name and avatar of the contractor for each submitted deliverable

\- Display the contractor’s specialization for the event (i.e., Photographer/Videographer/Content Creator)

\- Clickable to open the contractor profile

Deliverable method - Digital Delivery Links

URL List

Conditional

\- Display the URLs submitted by the contractor

\- Each URL is displayed with a copyable icon to copy the link

\- Displayed only if deliverables have been submitted using the digital delivery method

Deliverable method - Hard Drive (Tracking Number)

Text

Conditional

\- Displays the tracking number entered by the contractor

\- Displayed only if deliverables have been submitted using the hard drive method

Deliverable method - Hard Drive (Shipping service)

Text

Conditional

\- Displays the shipping service entered by the contractor

\- Displayed only if deliverables have been submitted using the hard drive method

Deliverable method - Hard Drive (Shipping Address)

Text

Conditional

\- Displays the shipping address of the agency receiving the hard drive

\- This field is system-populated based on agency address data

Deliverable method - Other

Text

Conditional

\- Displays the custom text entered by the contractor, preserved exactly as provided

\- Display only if deliverables have been submitted using the “Other” method

Latest/Oldest Filter

Dropdown

Optional

Filter selection for sorting deliverables

##

## **6\. Edge Cases**

**Scenario**

**Expected Behavior**

The contractor submits all three delivery methods

Display all methods (Digital Delivery, Hard Drive, Other) under a single contractor card

Multiple URLs in digital delivery

Display as a vertical stack with individual copy icons for each URL

Long text in the "Other" section

Display full text as multi-line, preserving original formatting

## **7\. Test Cases:**

## **Link**: [**Pixally Test cases - 01.04.25**](https://docs.google.com/spreadsheets/d/1RNM15mQt_Ax15liD7LeQZTvi_N01Hax4yZXSNIcN2dI/edit?gid=491179721#gid=491179721)

## **8\. Acceptance Criteria**

*   **Pre-Event Display:** Before event completion, the system displays the "No Raw Media Available Yet" Text and its subtext
*   **Post Event Contractor Display:** After event completion, contractors are displayed by role, name, avatar, and specialization
*   **Post Event No Submission Display:** Contractors with no submitted deliverables display: "Nothing Here - This contractor has yet to provide RAW Media”
*   **Delivery Method Display:** All three delivery methods (Digital, Hard Drive, Other) are displayed when submitted by the contractor
*   **Digital Delivery Functionality:** URLs must be clickable and have individual copy icons
*   **Hard Drive Information:** Tracking number, shipping service, and shipping address displayed correctly
*   **Custom Text Preservation:** "Other" deliverable method text displayed exactly as entered by the contractor
*   **Read-only Interface:** All data displayed as view-only with no edit capabilities
*   **Profile Integration:** Contractor name/avatar is clickable to open profile view

## **9\. Dependencies**

**Module/System**

**Dependency Type**

**Impact if Unavailable**

Contractor Portal

API Integration

No raw media data available, shows "No media found"

Contractor Management

Data Dependency

Cannot display contractor profiles and role information

Authentication System

Access Control

Cannot verify agency admin permissions

## **10\. References**

*   **Figma Design**: [**Click Here**](https://www.figma.com/design/ej0kxwP45mDKmZCZfAJ5O8/Pixally?node-id=14373-91311&t=YhROSi77CifYPRM3-0)

✅ Events - Info tab

# **Functional Requirements Document (FRD) — Project Details > Events > Info Tab**

**Module:** Project Details > Events > Info Tab  
**Prepared By:** BA Team  
**Reviewed By:** KG (Project Manager)  
**Updated Date:** May 27, 2026  
**Status:** Draft  
**Version:** 1.3

## **1\. Module Overview**

**Module Name:** Project Details > Events > Info Tab

**Purpose:** The Info Tab serves as the centralized information display and editing interface for an individual event within a project. It presents core event details (timezone, date/time, primary venue) and order information (package, items included, a la carte items), and provides inline editing capabilities that trigger contractor availability checks, payment schedule impact notifications, and audit logging when changes are made.

**Business Goals:**

*   Provide agency owners and admins with a single, comprehensive view of all event-level details including scheduling, venue, and order information.  
    
*   Enable inline editing of event details with built-in safeguards that automatically detect and surface contractor scheduling conflicts when dates are changed.  
    
*   Ensure operational transparency through audit logging of all changes, contractor notifications, and financial visibility during reassignment workflows.  
    
*   Streamline the contractor reassignment process by surfacing availability status, enabling in-context replacement, and flagging financial obligations when contractors are removed.

## **2\. User Roles & Permissions**

**Role**

**View Info Tab**

**Edit Event Info**

**Edit Order Info (A La Carte)**

**Remove/Replace Contractors**

Agency Owner

Yes

Yes

Yes

Yes

Agency Admin

Yes

Yes

Yes

Yes

Project Manager

Yes

Yes

Yes

Yes

**Notes:**

*   Contractors and Clients have their own portal-specific views documented in separate FRDs.

## **3\. User Flow**

3.1 The user navigates to the Projects module from the left sidebar menu.

3.2 The system loads the project listing page with all projects displayed.

3.3 The user clicks on a specific project card to open the Project Details page.

3.4 The system loads the Project Details page with the project header (cover image, project name, date range, location, timezone, status) and the event cards row beneath it.

3.5 The user clicks on a specific event card (e.g., "Rehearsal Dinner," "Wedding," "Engagement Photoshoot") from the horizontal event cards row.

3.6 The system highlights the selected event card and loads the event's sub-tabs: Services, Contractors, Raw Media, Files/Documents, Notes, and Info.

3.7 The user clicks on the "Info" tab from the event sub-tab navigation bar.

3.8 The system loads the Info Tab content area displaying two main sections: "Event Info" (with an Edit button) and "Order Info" (with an Edit button for a la carte items).

3.9 The system displays the Event Info section in read-only mode showing: Event Name with color dot indicator, Time Zone, Start Date & Time / End Date & Time (for multi-day events) or Event Date & Time (for single-day events), and Primary Venue.

3.10 The system displays the Order Info section in read-only mode showing: Package Name (read-only), Items Included for This Event (read-only), A La Carte Items Included for This Event (with the ability to add/remove additional items), and services grouped by service type (e.g., Photography, Videography).

3.11 If the event date is TBD, the system displays "TBD" in the date field, "TBD" in the timezone field, and the venue field displays "Venue not decided" if no venue is set.

3.12 If no order information exists for the event, the system displays the empty state message: "No order information available for this event. Package and service details will appear here once an order is placed through a proposal or added manually."

3.13 The user clicks the "Edit" button on the Event Info section to initiate inline editing.

3.14 The system converts the Event Info fields to editable inline fields (text inputs, date pickers, dropdowns) and displays "Save" and "Cancel" action buttons.

3.15 The user modifies the desired fields (Time Zone, Event Date/Time, Primary Venue) and clicks "Save."

3.16 If the user changed the event date and contractors are assigned to this event, the system performs a contractor availability check and displays the "Update Event" modal showing each contractor's availability status grouped by service type.

3.17 The user reviews contractor availability in the Update Event modal and takes action on unavailable contractors by clicking "Remove Contractor" or "Replace" for each unavailable contractor.

3.18 If the user clicks "Replace," the system opens the "Suggested Contractors" modal with a list of available contractors filtered by the new event date, role, and service area.

3.19 The user selects a replacement contractor from the Suggested Contractors modal and proceeds through the event price assignment step.

3.20 After resolving all unavailable contractors, the user clicks "Save and Notify Contractors" in the Update Event modal.

3.21 The system saves the updated event details, sends email and in-app notifications to all affected contractors, logs the changes in the activity log, and displays a success toast message.

3.22 The Update Event modal closes and the system returns the user to the Info Tab with the updated event information displayed in read-only mode.

3.23 If the user clicks "Discard Changes" in the Update Event modal, the system displays a confirmation popup. If the user confirms by clicking "Yes, Discard," the system reverts the date change back to the original date, discards all contractor changes, closes the modal, and returns to the Info Tab with the original event information.

3.24 If the user only changed the venue (without changing the date), the system saves the venue change, updates the distance calculation for existing assigned contractors, sends venue change notifications (email + in-app) to all assigned contractors, and returns to read-only mode with a success toast message.

3.25 The user can edit the Order Info section to add additional a la carte items or remove only the additionally added a la carte items (not the original package a la carte items selected by the client).

3.26 The system logs all changes (event info edits, contractor removals, replacements, a la carte modifications) in the Project Details > Overview > Activity tab.

## **4\. Functional Logic**

### **4.1 Event Info Display Logic**

*   The Event Info section is displayed in read-only mode by default when the user navigates to the Info Tab.  
    
*   The section header displays the event name preceded by a color dot indicator, where the color is fetched from the Agency Settings.  
    
*   The Time Zone field displays the timezone that was selected during the event creation process, and the default timezone is inherited from the Agency Settings.  
    
*   The available Time Zone options in the dropdown are: EDT / EST, CDT / CST, MDT / MST, PDT / PST, MST, HST, and AKDT / AKST.  
    
*   For multi-day events, the system displays two separate date fields: "Start Date & Time" and "End Date & Time," each showing the date and time formatted according to the user's Date & Time Preferences configured in Settings > My Profile.  
    
*   For single-day events, the system displays a single date field labeled "Event Date & Time" showing the date and time formatted according to the user's Date & Time Preferences. The time captured represents the time contractors need to arrive at the venue; no separate end time is tracked for single-day events.  
    
*   The Primary Venue field displays the full venue address as entered during event creation, which is powered by Google Maps API autocomplete.  
    
*   When the event date is TBD (To Be Determined), the date field displays the text "TBD" instead of a date value, and the Time Zone field also displays "TBD."  
    
*   When the venue has not been decided, the Primary Venue field displays the system-generated placeholder text "Venue not decided," regardless of whether the event date is set or TBD.  
    
*   The venue and date fields are independent of each other, meaning the venue can be "not decided" even when a date is set, and vice versa.  
    
*   An "Edit" button with a pencil icon is displayed in the top-right corner of the Event Info section, allowing the user to switch to inline editing mode.  
    
*   All date and time values displayed on the Info Tab are formatted according to the user's Date & Time Preferences configured in Settings > My Profile. The available preferences are:  
    *   **Date Format:** User-selected format from a dropdown (e.g., DD/MM/YYYY, MM/DD/YYYY, YYYY-MM-DD, etc.).
    *   **Include Day of the Week:** Optional checkbox to include the day name (e.g., Sat, Sun) alongside the date.
    *   **Time Format:** User-selected radio option — 12-hour (AM/PM) or 24-hour format.
*   These preferences are applied globally across all date/time displays in the system, including the Info Tab.

### **4.2 Edit Event Info — Inline Editing**

*   When the user clicks the "Edit" button on the Event Info section, all editable fields within the section convert to their respective inline editable input controls (date pickers for date/time, dropdown for timezone, autocomplete text input for venue).  
    
*   The system displays "Save" and "Cancel" buttons at the bottom of the Event Info section when inline editing is active.  
    
*   The Time Zone field becomes an editable dropdown populated with the standard timezone options listed in Section 4.1.  
    
*   The date/time fields become editable date picker inputs that allow the user to select a new date and time.  
    
*   The Primary Venue field becomes an autocomplete text input powered by Google Maps API (Google Places API), displaying venue suggestions as the user types, with text-only display (no map preview).  
    
*   If the user clicks "Cancel" during inline editing, all fields revert to their original read-only values and the section returns to read-only display mode without saving any changes.  
    
*   If the user clicks "Save" after making changes, the system evaluates the type of change made (date change, venue change, or other field changes) and triggers the appropriate downstream logic as described in Sections 4.3 and 4.6.

### **4.3 Date Change — Contractor Availability Check**

#### **4.3.1 Date Change — Evaluation & Trigger Logic**

*   When the user changes the event date and clicks "Save," the system evaluates the change and determines which modals/pop-ups to display.  
    
*   **Primary Event Definition:** The primary event is the first event created for a project (either from lead forms or manually). When events are created through proposals based on client selection, the proposal-selected event becomes the primary event. The agency can change the primary event designation at any time. The primary event is used to determine invoice payment schedule relationships.  
    
*   **Contractor Availability Check:** If contractors are assigned to the event AND the new date is a future date OR a past date, the system performs an availability check against the new date for all assigned contractors. If any contractor is unavailable, the "Update Event" modal is displayed.  
    
*   **Contractor Availability Check NOT Required:** When changing from a future date to TBD, contractor availability check is NOT performed.  
    
*   If the event date is being changed from TBD to an actual date for the first time, no contractors can be assigned to the event (since contractor assignment is blocked when the date is TBD), so the system saves the new date directly, displays a success toast message, and returns to read-only mode without showing the Update Event modal.  
    
*   **Payment Schedule Impact Pop-up:** After the contractor availability check (if applicable), if this is the primary event AND there are unpaid payments on any linked invoice(s), the Payment Schedule Impact pop-up is displayed (see Section 4.11).  
    
*   **Flow Order for Date Changes:  
    **
    1.  User changes date and clicks Save
    2.  System validates the date change
    3.  If contractors assigned and date is future/past → Contractor Availability Modal (if any unavailable)
    4.  If primary event and unpaid payments exist → Payment Schedule Impact Pop-up
    5.  Date change is saved
*   Users can change an event date back to TBD. When changing from an actual date to TBD AND this is the primary event AND there are unpaid payments on the invoice, the system displays the Payment Schedule Impact pop-up (see Section 4.11.5). Contractor availability check is NOT performed for TBD changes.  
    
*   If no contractors are assigned to the event AND no payment schedule impact, the system saves the date change directly, displays a success toast message, and returns to read-only mode.  
    
*   The availability check verifies whether each assigned contractor has any scheduling conflicts on the new date, including conflicts with other assigned projects/events, or Do Not Book (DNB) dates set by the contractor.

#### **4.3.2 Update Event Modal — Layout & Display**

*   The Update Event modal displays a warning banner at the top (see Sections 4.3.3 and 4.3.4 for banner text logic based on availability results).  
    
*   Contractors in the Update Event modal are grouped by service type (e.g., Photography, Videography) to match the organizational structure of the event's service assignments.  
    
*   Each contractor card in the modal displays: Role badge (e.g., Lead Shooter, Second Shooter), profile photo, contractor name, profession/specialty, star rating, availability status ("Available" in green or "Not Available" in red), and two action buttons ("Remove Contractor" and "Replace").  
    
*   The modal also displays payment information for each contractor: Event Price, Amount Paid, and Distance to Location, ensuring the agency owner has full financial visibility before making removal or replacement decisions.  
    
*   The three-dot menu is NOT displayed on contractor cards in the Update Event modal (confirmed: not required).  
    
*   The modal footer contains two buttons: "Discard Changes" and "Save and Notify Contractors."

#### **4.3.3 All Contractors Available on New Date**

*   If all assigned contractors are available on the new date, the banner reads: "All contractors are available on the new event date. Click 'Save and Notify' to update and inform all contractors."  
    
*   For all contractors marked as "Available," the "Remove Contractor" and "Replace" buttons are displayed in a disabled/greyed-out state, as available contractors do not need to be removed or replaced.  
    
*   The user clicks "Save and Notify Contractors" to save the date change, notify all contractors, log the change, and return to the Info Tab with updated data.

#### **4.3.4 One or More Contractors Unavailable on New Date**

*   If one or more contractors are unavailable, the banner reads: "Some contractors are unavailable on the new event date. Please update their assignments before saving. You can remove or replace them with an available contractor."  
    
*   For contractors marked as "Available," the "Remove Contractor" and "Replace" buttons are displayed in a disabled/greyed-out state.  
    
*   For contractors marked as "Not Available," the "Remove Contractor" and "Replace" buttons are active and enabled for user interaction.  
    
*   The user must resolve each unavailable contractor (remove or replace) before saving, or use the "Remove & Notify" option in the secondary warning popup (documented in Section 4.4.3).

### **4.4 Update Event Modal — Contractor Actions**

#### **4.4.1 Remove Contractor & Unassigned Card State**

*   When the user clicks "Remove Contractor" for an unavailable contractor, the system displays a confirmation dialog before marking the contractor for removal. The dialog title is "Remove Contractor?" and the message varies based on the contractor's payment status:

**Payment Status**

**Dialog Title**

**Dialog Message**

**Buttons**

Unpaid (Single or Multiple)

Remove Contractor?

Are you sure you want to remove this contractor from this event?

Cancel | Remove

Processing (Single)

Remove Contractor?

Payment of $\[Amount\] processing. Are you sure you want to remove this contractor from this event?

Cancel | Remove

Processing (Multiple - all processing)

Remove Contractor?

Payment of $\[Total Amount\] processing across \[N\] payments. Are you sure you want to remove this contractor from this event?

Cancel | Remove

Paid (Single)

Remove Contractor?

This contractor has already been paid $\[Amount\]. Are you sure you want to remove them from this event?

Cancel | Remove

Paid (Multiple - all paid)

Remove Contractor?

This contractor has already been paid $\[Total Amount\] across \[N\] payments. Are you sure you want to remove them from this event?

Cancel | Remove

Mixed (Paid + Processing)

Remove Contractor?

This contractor has already been paid $\[Paid Total\]. Are you sure you want to remove them from this event?

Cancel | Remove

**Payment Status Priority Logic:**

*   If ANY payment is **Paid** → Show only the combined paid amount (ignore processing & unpaid amounts)  
    
*   If NO Paid payments but some are **Processing** → Show combined processing amount (ignore unpaid)  
    
*   If ALL payments are **Unpaid** → Show standard unpaid message  
    
*   Payment count ("across \[N\] payments") is shown only for Multiple Paid or Multiple Processing scenarios (not for Mixed)  
    
*   Currency symbol is displayed based on the agency's currency settings (default: USD).  
    
*   If the user clicks "Cancel," the dialog closes without any changes.  
    
*   If the user clicks "Remove," the system marks that contractor for removal from the event assignment upon final save.  
    
*   Payments are handled via Stripe; removing a contractor does not automatically cancel or refund any payments. Any payment discrepancies must be handled internally between the parties.  
    
*   Upon confirmation, the contractor card in the Update Event modal is immediately replaced with an "Unassigned" state card displaying: the role badge at the top-left (e.g., "Lead Shooter" with the role icon), a placeholder avatar (purple circle with a "?" icon) in place of the contractor's profile photo, the text "Unassigned" below the avatar, and an "Assign \[Role\]" button (e.g., "Assign Lead Shooter") that allows the user to assign a new contractor for that role. Clicking the "Assign \[Role\]" button opens the Suggested Contractors modal (documented in Section 4.5) pre-filtered for that specific role.  
    
*   When the user clicks "Replace" for an unavailable contractor, the system opens the "Suggested Contractors" modal (documented in Section 4.5) to allow the user to select a replacement.  
    
*   If multiple contractors are unavailable, the user must handle each one individually (remove or replace), as there is no bulk action to remove/replace all at once, except for the "Remove & Notify" button in the secondary warning popup (Section 4.4.3) which removes all remaining unavailable contractors at once.

#### **4.4.2 Discard Changes — Confirmation & Revert Logic**

*   When the user clicks "Discard Changes," the system displays a confirmation popup with the message: "The event date change will be reverted to the original date, and all contractor changes will be discarded. Are you sure you want to discard?" The popup provides two options: "Yes, Discard" and "Go Back."  
    
*   If the user confirms by clicking "Yes, Discard," the system reverts the event date back to the original date, discards all contractor removal/replacement actions, closes the Update Event modal, and returns the user to the Info Tab with the original event information in read-only mode.  
    
*   If the user clicks "Go Back," the popup closes and the user remains on the Update Event modal with all current selections (removals, replacements) intact.

#### **4.4.3 Save with Unresolved Unavailable Contractors — Secondary Warning Popup**

*   If the user clicks "Save and Notify Contractors" while there are still unavailable contractors that have not been removed or replaced, the system displays a secondary warning popup informing the user that unavailable contractors must be handled.  
    
*   The secondary warning popup provides two options: the user can go back to the modal to remove/replace the remaining unavailable contractors, or the user can click "Remove & Notify" to automatically remove all remaining unavailable contractors and proceed with saving.

#### **4.4.4 Save and Notify — Final Actions & Post-Save Impact**

*   Upon clicking "Save and Notify Contractors" (with all unavailable contractors resolved), the system performs the following actions: saves the new event date, removes the marked contractors from the event assignment, assigns any replacement contractors selected by the user, sends email and in-app notifications to all removed contractors informing them of their removal from the event, sends email and in-app notifications to all remaining and newly assigned contractors about the event date change, logs all changes (date change, removals, replacements) in the Project Details > Overview > Activity tab, and displays a success toast message.

**Removed Contractors — Post-Save Impact:**

*   Removed contractors are immediately unassigned from the event, and the event that now has missing contractor positions appears on the Dashboard > Unassigned Contractor List.  
    
*   After removal, the removed contractors' availability is updated on their Contractor Portal, and the specific event is no longer visible to them in their portal.  
    
*   If the removed contractor had a signed service agreement for this event, the system automatically changes the service agreement status from "Signed" to "Voided" in the Project Details > Events > Files/Documents tab. The voided agreement remains as a historical record and is not deleted.  
    
*   The removed contractor's financial data (Event Price, Amount Paid) remains as-is in the Project Details > Finance Tab and the Finance module. There is no automatic status change on the payment record; existing payment records simply persist with no modification.  
    
*   If any contractor roles remain unfilled after save (i.e., the user removed a contractor but did not assign a replacement), the Unassigned contractor card (same design: purple "?" avatar, role badge, "Assign \[Role\]" button) appears on the Events > Contractors Tab for the unfilled role.  
    

**Replacement Contractors — Post-Save Impact:**

*   For each newly assigned replacement contractor, the system additionally performs the following: sends a new event assignment email to the replacement contractor informing them of their assignment, and makes the event visible on the replacement contractor's Contractor Portal so they can view the event details.  
    
*   The system checks whether the "Automatically Send to Contractors" toggle is enabled for the relevant service agreement (configured in Contract > Service Agreement settings).  
    
*   If the toggle is ON, the system automatically sends the relevant service agreement (based on the service the contractor is assigned to, e.g., Photography, Videography) to the replacement contractor for signing.  
    
*   If the toggle is OFF, no service agreement is sent automatically, and the agency owner must manually send it later from the Files/Documents tab.

### **4.5 Suggested Contractors Modal — Replacement Flow**

*   When the user clicks "Replace" for an unavailable contractor, the system opens the "Suggested Contractors" modal, pre-filtered by the new event date, the role of the contractor being replaced (e.g., Assistant, Lead Shooter), and the event's service area.  
    
*   The Suggested Contractors modal displays a header showing the total count of suggested contractors (e.g., "Suggested Contractors (8)") and a subtitle: "Browse best fit contractors suggested by Pixally or search on your own."  
    
*   The modal includes a search bar ("Search Contractors") allowing the user to search for contractors by name.  
    
*   Applied filters are displayed as filter chips below the search bar showing: Date, Role, and Service Area, with a delete icon to clear all filters.  
    
*   The contractor list is displayed in a tabular format with the following columns: Name (with profile photo and profession), Rate (pay rate per hour), Fee (travel fee, calculated based on the venue and contractor's home address), Service Area (with distance in miles to the event location), star Rating, and Actions ("Select" button).  
    
*   Additional filters and sorting options are available (detailed logic to be documented in the Events > Contractors Tab > Assign Contractor FRD).  
    
*   The user selects a replacement contractor by clicking the "Select" button next to the desired contractor.  
    
*   After selecting a contractor, the system navigates the user to an event price assignment step where the user sets the event price for the replacement contractor (detailed logic to be documented in the Events > Contractors Tab > Assign Contractor FRD).  
    
*   The modal footer contains "Back" and "Assign Contractors" buttons, where "Back" returns the user to the Update Event modal without making a selection.  
    
*   Once the replacement contractor is assigned, the system returns to the Update Event modal with the newly assigned contractor now displayed in place of the previously unavailable contractor.

### **4.6 Venue Change Impact Logic**

*   When the user changes only the venue (without changing the event date) and clicks "Save," the system does not trigger the contractor availability check modal, as venue changes do not affect contractor scheduling availability.  
    
*   The system updates the Primary Venue field with the new venue address selected via Google Maps API autocomplete.  
    
*   Upon saving a venue change, the system automatically recalculates the distance from the new venue to each assigned contractor's home address and updates the "Distance to Location" value for all existing assigned contractors.  
    
*   The travel fee for existing assigned contractors is NOT automatically recalculated when the venue changes; the agency owner must manually adjust the travel fee for existing contractors if needed.  
    
*   However, when the agency assigns any new contractor after the venue has been updated, the new contractor's distance and travel fee will be calculated based on the new venue location.  
    
*   The system sends email and in-app notifications to all currently assigned contractors informing them of the venue change, as the venue location is critical information for contractors who need to travel to the event.  
    
*   All venue changes are logged in the Project Details > Overview > Activity tab.  
    
*   A success toast message is displayed after the venue change is saved.  
    
*   **Venue and Date Change in Separate Sessions:** If the user changes the venue in one edit session (Session 1) and saves, and then changes the event date in a separate edit session (Session 2) — triggering the Update Event modal and replacing a contractor — the replacement contractor's travel fee is calculated based on the already-updated new venue (from Session 1). Conversely, if the user changes the event date first (Session 1), replaces a contractor, saves, and then changes the venue later (Session 2), the replacement contractor (now an existing contractor) follows the same venue change rules: distance is recalculated but travel fee is NOT recalculated.

### **4.7 Order Info Display Logic**

*   The Order Info section is displayed below the Event Info section on the Info Tab.  
    
*   The section displays an "Edit" button (pencil icon) in the top-right corner, which is used for adding/removing additional a la carte items only.  
    
*   The Order Info section displays the following subsections when a package is associated with the event:  
    *   **Package Name:** Displays the name of the package selected by the client during the proposal/booking stage (e.g., "Photo/Video Silver"). This field is always read-only.
    *   **Items Included for This Event:** Displays a list of all deliverable items included in the package for this specific event (e.g., "10 hours of photoshooting," "Basic Retouch," "1 Photographer"). Each item is displayed as a separate row entry. These fields are always read-only.
    *   **A La Carte Items Included for This Event:** Displays all a la carte items associated with this event as chips/tags (e.g., "Instagram Video," "Drone Footage," "Portrait Session," "Promo Video," "Assistant"). A la carte items from the original package selection by the client are read-only and cannot be removed. Additionally added a la carte items (added by the agency) can be removed.
    *   **Services:** Displays the services associated with this event grouped by service type (e.g., Photography, Videography), showing what the agency needs to deliver for this event.
*   When no order information exists for the event (no package, no items, no a la carte items), the system displays the empty state message: "No order information available for this event. Package and service details will appear here once an order is placed through a proposal or added manually."

### **4.8 Edit Order Info — A La Carte Items**

*   The Package Name and Items Included sections are always read-only and cannot be edited from the Info Tab, as these are determined during the proposal/booking stage by the client.  
    
*   The "Edit" button on the Order Info section enables the user to add additional a la carte items to the event or remove only the a la carte items that were additionally added by the agency.  
    
*   When the user clicks "Edit," the a la carte section becomes editable, displaying an input field or dropdown to search and add new a la carte items, and showing a remove icon (X) next to each additionally added a la carte item.  
    
*   The a la carte items that were part of the original client-selected package do NOT display a remove icon and remain read-only even in edit mode.  
    
*   When the user adds or removes a la carte items and clicks "Save," the system updates the Order Info display, logs the change in the Project Details > Overview > Activity tab, and displays a success toast message.  
    
*   If the user clicks "Cancel," the a la carte items revert to their previous state without any changes being saved.

### **4.9 Order Activity Display Logic**

*   The Order Activity section is displayed below the Order Info section on the Info Tab.  
    
*   Order Activity is a dedicated log that is **separate from the general Project Activity tab**. It captures order-related changes only (package, service, and deliverable changes), whereas the general Project Activity tab captures broader project events.  
    
*   The Order Activity section logs entries from the following sources and change types:  
    *   Package added via proposal
    *   Package added manually
    *   Package group changed
    *   Hours of coverage changed (via Edit Service)
    *   Number of shooters changed (via Edit Service)
    *   Minimum number of photos changed (via Edit Service)
    *   New deliverables added
*   **Entry Structure:** Each Order Activity entry displays:  
    *   User avatar (profile photo)
    *   User name
    *   Action description
    *   Event name (or project name, where applicable)
    *   Timestamp (e.g., "17 Dec 2024 · 1:10 PM")
*   **Scope of Entries:** The scope of each entry depends on the type of change:  
    

**Change Type**

**Description Format**

**Scope**

Hours of coverage changed

"\[User\] updated hours of coverage (X → Y) for \[Service\] in '\[Event Name\]'"

Service + Event

Number of shooters changed

"\[User\] updated photographer count (X → Y) for \[Service\] in '\[Event Name\]'"

Service + Event

Minimum number of photos changed

"\[User\] updated minimum photos (X → Y) for \[Service\] in '\[Event Name\]'"

Service + Event

New deliverable added

"\[User\] added deliverable '\[Name\]' to '\[Event Name\]'"

Service + Event

Package group changed

"\[User\] changed package to '\[Package Name\]' for '\[Project Name\]'"

Project-wide

*     
    **Service + Event Scope:** For hours of coverage, number of shooters, minimum number of photos, and deliverable additions, a single entry is created that references both the service name and the event name in the description.  
    
*   **Project-wide Scope:** For package group changes, a single entry is created that references the project name (since a package group change can impact multiple events and services across the project).  
    
*   **Order Total:** Order total changes are not logged as separate Order Activity entries.  
    
*   **Display Behavior:  
    **
    *   By default, the Order Activity section displays the 5 most recent entries.
    *   If there are more than 5 entries, a "View More (+X Activity)" button is displayed, where X is the count of remaining entries beyond the 5 shown.
    *   The section is scrollable to view additional entries.
    *   Order Activity is view-only; entries cannot be clicked or interacted with.
*   **Empty State:** When no order activity exists for the event, the section can display an appropriate empty state (no entries logged yet).

### **4.10 Notification & Logging Logic**

*   All changes made on the Info Tab are logged in the Project Details > Overview > Activity tab, including: event date changes, timezone changes, venue changes, contractor removals, contractor replacements, service agreement voiding, and a la carte item additions or removals.  
    
*   Order-specific changes (package, service edits, deliverable additions) are additionally logged in the Order Activity section (see Section 4.9).  
    
*   When a contractor is removed from an event (either manually or through the "Remove & Notify" action), the system sends both an email notification and an in-app notification to the removed contractor. The removal email content is adjusted to also inform the contractor that their signed service agreement (if any) has been voided for this event.  
    
*   When a contractor is replaced, the system sends removal notifications to the outgoing contractor (including service agreement voiding information if applicable) and assignment notifications to the incoming contractor.  
    
*   When the event venue is changed, the system sends email and in-app notifications to all currently assigned contractors informing them of the new venue.  
    
*   When the event date is changed and saved, the system sends email and in-app notifications to all remaining assigned contractors informing them of the date change.  
    
*   After a contractor is removed, the event is no longer visible on the removed contractor's Contractor Portal, and the contractor's availability is updated, making them available for other agencies on that date.

### **4.10 Impact on Other Modules**

*   **Dashboard > Unassigned Contractor List:** When contractors are removed from an event (due to date change or manual removal), the event appears on the Dashboard > Unassigned Contractor List, indicating that the event has unfilled contractor positions that need to be assigned.  
    
*   **Events > Contractors Tab:** Contractor removals, replacements, and availability status changes made from the Info Tab's Update Event modal are immediately reflected in the Events > Contractors Tab. Unavailable contractors are flagged in the Contractors Tab as well. If a contractor is removed and no replacement is assigned, the Unassigned contractor card appears on the Contractors Tab for the unfilled role.  
    
*   **Contractor Portal:** Removed contractors no longer see the event on their Contractor Portal. Their availability is updated to reflect that they are no longer booked for that date, making them available for other agency assignments. Replacement contractors gain visibility of the event on their Contractor Portal immediately upon assignment.  
    
*   **Contract > Service Agreement:** When a replacement contractor is assigned and saved, the system checks the "Automatically Send to Contractors" toggle for the relevant service agreement template. If enabled, the service agreement matching the contractor's assigned service type is automatically sent to the contractor for signing. Each event assignment requires its own service agreement; previously signed agreements from other events do not carry over.  
    
*   **Files/Documents Tab:** When a contractor is removed from an event and has a signed service agreement for that event, the system automatically changes the agreement status from "Signed" to "Voided" in the Files/Documents tab. The voided agreement remains as a historical record and is not deleted.  
    
*   **Project Details > Overview > Activity Tab:** All changes (date, venue, timezone, contractor assignments, service agreement voiding, a la carte modifications) are logged as activity entries, visible to all users who have access to the project.  
    
*   **Finance Module:** Venue changes affect the distance calculation for contractor travel, which may require manual adjustment of travel fees by the agency owner. When a contractor is removed and has received advance payments, the financial data (Event Price, Amount Paid) remains as-is in the Finance Tab and Finance module with no automatic status change on the payment record. The advance payment must be settled offline or a refund must be requested.  
    
*   **Contractor Travel Fee Calculation:** When the venue is changed, distance is automatically recalculated for existing contractors, but travel fee is NOT recalculated. New contractors assigned after the venue change will have their distance and travel fee calculated based on the new venue.  
    
*   **Events > Contractors Tab > Assign Contractor:** The replacement flow initiated from the Info Tab's Update Event modal follows the same contractor assignment workflow documented in the Contractors Tab FRD, including the Suggested Contractors modal and event price assignment step.  
    
*   **Notification System:** Date changes,

venue changes, contractor removals/replacements, and service agreement voiding all trigger email and in-app notifications to affected contractors, impacting the notification queue and delivery system.  
    
*   **Raw Media Tab:** In the unlikely event that a removed contractor had already uploaded deliverables (typically deliverables are uploaded after the event is completed), the uploaded files remain in the Raw Media tab attributed to the original (removed) contractor and are not reassigned to the replacement.

### **4.11 Payment Schedule Impact on Date Changes**

#### **4.11.1 Trigger Conditions**

The Payment Schedule Impact pop-up is displayed only when ALL of the following conditions are met:

**Condition**

**Description**

Primary Event

The event being modified is the primary event of the project

Unpaid Payments

There are unpaid payment(s) on any invoice(s) linked to the project

Date Change Type

The date change falls into one of the three scenarios below

**Note:**

*   If the event is NOT the primary event, OR if all payments across all invoices are already paid, the pop-up is NOT displayed and the date change saves normally.
*   Invoices are linked to the project, not individual events. If multiple invoices exist with unpaid payments, all will be displayed in the pop-up.

#### **4.11.2 Multiple Invoices Display**

When invoices are linked to the project with unpaid payments, the pop-up displays each invoice separately.

**Invoice Card Structure:**

**Element**

**Description**

Invoice Number

Invoice reference (e.g., Invoice #INV-2024-0092)

Package Name

Name of the package (e.g., Videography Package)

Total Amount

Total invoice amount (e.g., $3,600.00)

Invoice Status

Partially Paid / Unpaid / etc.

Payment Table

Payment schedule table for this invoice

**Display Behavior:**

*   Each invoice is displayed as a separate card with its own payment schedule table
*   The pop-up is scrollable if there are multiple invoices or many payments
*   All invoices with unpaid payments are shown regardless of count

#### **4.11.3 Payment Schedule Table Display**

Each invoice displays a payment schedule table showing all payments (paid and unpaid).

**Table Columns:**

**Column**

**Description**

Amount

Payment amount (e.g., $500.00)

Due Date

The due date for the payment (e.g., Jun 15, 2025)

Payment Date

Date when payment was made. Shows "—" for unpaid payments

Payment ID

Payment reference ID (e.g., #PAY-1147). Shows "—" for unpaid payments

Status

Paid / Unpaid / Overdue

**Status Logic:**

*   **Paid:** Payment has been completed
*   **Unpaid:** Payment due date is in the future (not yet due)
*   **Overdue:** Payment due date has passed and payment is not made

**Table Behavior:**

*   The table displays ALL payments (paid + unpaid) for full visibility
*   Paid payments show the Payment Date, Payment ID, and "Paid" status
*   Unpaid payments show "—" in Payment Date and Payment ID columns

#### **4.11.4 Scenario 1: Future Date → Past Date**

When the primary event date is changed from a future date to a past date and there are unpaid payments:

**Behavior:** Payment due dates remain as originally set (no recalculation). The future payment dates are retained until user updates the invoices.

**Element**

**Content**

Title

Payment Schedule Notice

Message

The event date has been changed to a past date. **\[X\] invoice(s)** are linked to this event with unpaid payments. The previously set future payment dates shown below will be retained until you update the invoices. Please go to the **Finance Tab** and edit an invoice to update its payment schedule.

Invoice Cards

Each invoice displayed with its payment schedule table

Primary Button

No Changes

Secondary Button

Update Invoice (single) / Update Invoices (multiple)

**Example (Multiple Invoices):**

**Invoice #INV-2024-0091** | Photography Package | $6,000.00 | Partially Paid

**Amount**

**Due Date**

**Payment Date**

**Payment ID**

**Status**

$1,500.00

Aug 15, 2026

—

—

Unpaid

$1,500.00

Sep 12, 2026

—

—

Unpaid

$1,500.00

Oct 10, 2026

—

—

Unpaid

**Invoice #INV-2024-0092** | Videography Package | $3,600.00 | Partially Paid

**Amount**

**Due Date**

**Payment Date**

**Payment ID**

**Status**

$1,200.00

Mar 10, 2026

Mar 9, 2026

#PAY-1150

Paid

#### **4.11.5 Scenario 2: TBD → Past Date**

When the primary event date is changed from TBD to a past date and there are unpaid payments:

**Behavior:** Payment due dates are calculated from the smart date configuration (e.g., "30 days before event") and the new past date.

**Element**

**Content**

Title

Payment Schedule Notice

Message

The event date has been changed from TBD to a past date. **\[X\] invoice(s)** are linked to this event with unpaid payments. The payment schedule dates will be updated based on the new event date as shown below. Please go to the **Finance Tab** and edit an invoice if you wish to modify its payment schedule.

Invoice Cards

Each invoice displayed with its calculated payment schedule table

Primary Button

No Changes

Secondary Button

Update Invoice (single) / Update Invoices (multiple)

**Example (Single Invoice):**

**Invoice #INV-2024-0091** | Photography Package | $6,000.00 | Partially Paid

**Amount**

**Due Date**

**Payment Date**

**Payment ID**

**Status**

$500.00

Feb 10, 2026

Feb 9, 2026

#PAY-1147

Paid

$500.00

Mar 20, 2026

—

—

Overdue

$500.00

Apr 17, 2026

—

—

Overdue

$500.00

May 15, 2026

—

—

Unpaid

**Smart Date Calculation:**

*   The system calculates actual dates based on the smart date configuration and the new event date
*   Calculated dates are displayed in the Due Date column
*   Dates that fall before today are marked as "Overdue"

#### **4.11.6 Scenario 3: Future Date → TBD**

When the primary event date is changed from a future date to TBD and there are unpaid payments:

**Behavior:** Original future payment dates are retained and displayed. User can choose to keep original dates or update to TBD.

**Element**

**Content**

Title

Payment Schedule Notice

Message

The event date has been changed to TBD. **\[X\] invoice(s)** are linked to this event with unpaid payments. The previously set future payment dates shown below will be retained until you keep them as TBD or update to a new date.

Invoice Cards

Each invoice displayed with its payment schedule table

Primary Button

No Changes

Secondary Button

Update to TBD

**Note:** This scenario does NOT include instructional text about going to Finance Tab.

**Example (Single Invoice):**

**Invoice #INV-2024-0091** | Photography Package | $6,000.00 | Partially Paid

**Amount**

**Due Date**

**Payment Date**

**Payment ID**

**Status**

$500.00

Jun 15, 2025

Jun 14, 2025

#PAY-1147

Paid

$500.00

Jul 8, 2025

Jul 7, 2025

#PAY-1148

Paid

$500.00

Aug 1, 2025

—

—

Unpaid

#### **4.11.7 Button Actions**

**Scenario**

**Button**

**Action**

Future → Past

No Changes

Closes pop-up. Saves date change. Payment dates remain as original future dates.

Future → Past

Update Invoice / Update Invoices

Closes pop-up. Saves date change. Redirects to Finance Tab.

TBD → Past

No Changes

Closes pop-up. Saves date change. Calculated payment dates are applied.

TBD → Past

Update Invoice / Update Invoices

Closes pop-up. Saves date change. Redirects to Finance Tab.

Future → TBD

No Changes

Closes pop-up. Saves date change. Original payment dates are retained.

Future → TBD

Update to TBD

Closes pop-up. Saves date change. Payment dates are updated to TBD.

**Button Label Logic:**

*   Single invoice: "Update Invoice"
*   Multiple invoices: "Update Invoices"

#### **4.11.8 Pop-up Display Timing & Flow**

**Flow Order:**

1.  User changes date and clicks Save
2.  System validates the date change
3.  If contractors assigned AND date is future/past (not TBD) → Contractor Availability Modal displayed first (if any unavailable)
4.  User completes contractor availability actions (keep/remove/replace)
5.  If primary event AND unpaid payments exist → Payment Schedule Impact Pop-up displayed
6.  User clicks "No Changes" or "Update Invoice(s)" / "Update to TBD"
7.  Date change is saved

**Notes:**

*   The Payment Schedule Impact pop-up is displayed AFTER the contractor availability modal (if applicable).
*   If user cancels/discards on the contractor availability modal, the Payment Schedule Impact pop-up still appears as the next step.
*   Contractor availability check is NOT performed when changing to TBD (only Payment Schedule pop-up appears if applicable).
*   The pop-up is informational; clicking either button proceeds with saving the date change.

#### **4.11.9 Activity Logging**

*   If the user clicks "Update Invoice" or "Update to TBD" and subsequently changes the payment schedule dates, the payment date changes are logged in the Activity Tab.
*   The date change itself is logged regardless of whether the user updates the invoice or not.

## **5\. Field Details & Validations**

### **5.1 Event Info Fields**

**Field Name**

**Field Type**

**Required**

**Editable**

**Validation Rules**

Event Name

Text (Display)

Yes

No (Read-only on Info Tab)

Displayed with color dot indicator fetched from Agency Settings.

Time Zone

Dropdown

Yes

Yes (Inline Edit)

Must be one of: EDT/EST, CDT/CST, MDT/MST, PDT/PST, MST, HST, AKDT/AKST. Default inherited from Agency Settings during event creation. Displays "TBD" when event date is TBD.

Start Date & Time (Multi-Day)

Date Picker + Time Picker

Yes (for multi-day events)

Yes (Inline Edit)

Date and time displayed per user's Date & Time Preferences (Settings > My Profile). Can be set to TBD. TBD option available in date picker. Cannot be empty if End Date is set.

End Date & Time (Multi-Day)

Date Picker + Time Picker

Yes (for multi-day events)

Yes (Inline Edit)

Date and time displayed per user's Date & Time Preferences (Settings > My Profile). Must be after the Start Date & Time. Cannot be the same as or earlier than the Start Date.

Event Date & Time (Single-Day)

Date Picker + Time Picker

Yes (for single-day events)

Yes (Inline Edit)

Date and time displayed per user's Date & Time Preferences (Settings > My Profile). Can be set to TBD. TBD option available in date picker. Time represents contractor arrival time; no end time is captured.

Primary Venue

Autocomplete Text Input (Google Maps API)

No

Yes (Inline Edit)

Google Places API autocomplete. Text-only display (no map preview). Displays "Venue not decided" when not set.

### **5.2 Order Info Fields**

**Field Name**

**Field Type**

**Required**

**Editable**

**Validation Rules**

Package Name

Text (Display)

No

No (Read-only)

Populated from the client's package selection during proposal/booking.

Items Included for This Event

List (Display)

No

No (Read-only)

Displays individual deliverable items from the selected package.

A La Carte Items (Original)

Chips/Tags (Display)

No

No (Read-only)

Original a la carte items selected by the client. Cannot be removed.

A La Carte Items (Additional)

Chips/Tags (Editable)

No

Yes (Add/Remove)

Additional a la carte items added by the agency. Can be added or removed by the agency owner/admin.

Services

Grouped List (Display)

No

No (Read-only)

Services are displayed grouped by service type (e.g., Photography, Videography).

### **5.3 Order Activity Fields**

**Field Name**

**Field Type**

**Required**

**Editable**

**Validation Rules**

User Avatar

Image (Display)

N/A

No

Profile photo of the user who made the change.

User Name

Text (Display)

N/A

No

Name of the user who made the change.

Action Description

Text (Display)

N/A

No

Description of the change, referencing service and event (or project) as applicable.

Event/Project Name

Text (Display)

N/A

No

Event name for service/event scope; project name for project-wide scope.

Timestamp

Text (Display)

N/A

No

Date and time of the change (e.g., "17 Dec 2024 · 1:10 PM").

View More Button

Button

N/A

Yes

"View More (+X Activity)" — shown only when more than 5 entries exist.

### **5.4 Update Event Modal Fields**

**Field Name**

**Field Type**

**Required**

**Editable**

**Validation Rules**

Contractor Name

Text (Display)

N/A

No

Displays the name of the assigned contractor.

Role Badge

Badge (Display)

N/A

No

Displays the contractor's role (e.g., Lead Shooter, Second Shooter).

Profession

Text (Display)

N/A

No

Displays the contractor's profession/specialty.

Star Rating

Rating (Display)

N/A

No

Displays the contractor's rating (e.g., 5.0).

Availability Status

Status Badge (Display)

N/A

No

"Available" (green) or "Not Available" (red).

Event Price

Currency (Display)

N/A

No

Displays the contractor's event price (e.g., $1,200.00).

Amount Paid

Currency (Display)

N/A

No

Displays the amount already paid to the contractor (e.g., $800.00).

Distance to Location

Text (Display)

N/A

No

Displays distance in miles and location (e.g., "12m. to location — Boston, USA").

### **5.5 Suggested Contractors Modal Fields**

**Field Name**

**Field Type**

**Required**

**Editable**

**Validation Rules**

Search Contractors

Text Input (Search)

No

Yes

Free-text search by contractor name.

Date Filter

Filter Chip

Auto-applied

No

Pre-filtered to the new event date.

Role Filter

Filter Chip

Auto-applied

No

Pre-filtered to the role of the contractor being replaced.

Service Area Filter

Filter Chip

Auto-applied

No

Pre-filtered to the event's service area.

Contractor Name

Text (Display)

N/A

No

Displays name with profile photo and profession.

Rate

Currency (Display)

N/A

No

Displays the contractor's hourly pay rate (e.g., $100/h).

Fee

Currency (Display)

N/A

No

Travel fee calculated based on venue and contractor's home address.

Service Area

Text (Display)

N/A

No

Displays contractor's service area with distance in miles to event location.

Rating

Star Rating (Display)

N/A

No

Displays the contractor's rating (e.g., 4.5).

Actions

Button ("Select")

N/A

Yes

Clicking "Select" initiates the replacement and moves to event price assignment.

### **5.6 Unassigned Contractor Card (Post-Removal State in Update Event Modal & Contractors Tab)**

**Field Name**

**Field Type**

**Required**

**Editable**

**Validation Rules**

Role Badge

Badge (Display)

N/A

No

Displays the role of the removed contractor (e.g., "Lead Shooter") with the role icon at the top-left of the card.

Placeholder Avatar

Icon (Display)

N/A

No

A purple circle with a "?" icon, replacing the removed contractor's profile photo.

Unassigned Label

Text (Display)

N/A

No

Displays the text "Unassigned" below the placeholder avatar.

Assign \[Role\] Button

Button

N/A

Yes

Displays "Assign \[Role\]" (e.g., "Assign Lead Shooter"). Clicking this button opens the Suggested Contractors modal pre-filtered for the specific role.

### **5.7 Discard Changes Confirmation Popup**

**Field Name**

**Field Type**

**Required**

**Editable**

**Validation Rules**

Confirmation Message

Text (Display)

N/A

No

"The event date change will be reverted to the original date, and all contractor changes will be discarded. Are you sure you want to discard?"

Yes, Discard Button

Button (Primary)

N/A

Yes

Confirms the discard action. Reverts all changes and closes the modal.

Go Back Button

Button (Secondary)

N/A

Yes

Cancels the discard action. Returns the user to the Update Event modal.

### **5.8 Payment Schedule Impact Pop-up Fields**

**Field Name**

**Field Type**

**Required**

**Editable**

**Validation Rules**

Title

Text (Display)

N/A

No

"Payment Schedule Notice" - consistent across all three scenarios.

Message

Text (Display)

N/A

No

Dynamic message based on date change scenario. Includes "\[X\] invoice(s)" count (highlighted).

Invoice Cards

Card Container

N/A

No

Each invoice displayed as a separate card with its payment schedule table. Scrollable.

No Changes Button

Button (Primary)

N/A

Yes

Closes the pop-up. Saves the date change. Payment schedule behavior varies by scenario.

Update Invoice Button

Button (Secondary)

N/A

Yes

For single invoice: "Update Invoice". Redirects to Finance Tab.

Update Invoices Button

Button (Secondary)

N/A

Yes

For multiple invoices: "Update Invoices". Redirects to Finance Tab.

Update to TBD Button

Button (Secondary)

N/A

Yes

For Future → TBD only: Updates payment dates to TBD.

### **5.9 Invoice Card Fields**

**Field Name**

**Field Type**

**Required**

**Editable**

**Validation Rules**

Invoice Number

Text (Display)

N/A

No

Invoice reference (e.g., "Invoice #INV-2024-0092").

Package Name

Text (Display)

N/A

No

Name of the package associated with the invoice (e.g., "Videography Package").

Total Amount

Currency (Display)

N/A

No

Total invoice amount (e.g., "$3,600.00").

Invoice Status

Status Badge

N/A

No

Invoice payment status (e.g., "Partially Paid", "Unpaid").

Payment Schedule Table

Table (Display)

N/A

No

Payment schedule table for this specific invoice.

### **5.10 Payment Schedule Table Fields**

**Field Name**

**Field Type**

**Required**

**Editable**

**Validation Rules**

Amount

Currency (Display)

N/A

No

Payment amount formatted with currency symbol (e.g., $500.00).

Due Date

Date (Display)

N/A

No

Payment due date formatted per user's Date & Time Preferences. Shows calculated date for TBD → Past scenario.

Payment Date

Date (Display)

N/A

No

Date when payment was made. Shows "—" for unpaid payments.

Payment ID

Text (Display)

N/A

No

Payment reference ID (e.g., #PAY-1147). Shows "—" for unpaid payments.

Status

Status Badge

N/A

No

"Paid" for completed payments. "Unpaid" for payments with future due dates. "Overdue" for payments with past due dates that are not paid.

## **6\. Success Message Handling**

**Action**

**Success Message**

**Trigger Condition**

**Post-Success Action**

Save Event Info (No Date Change, No Venue Change)

"Event information updated successfully."

User saves event info changes that do not involve a date or venue change (e.g., timezone only).

Info Tab returns to read-only mode with updated values.

Save Event Date (TBD to Actual Date)

"Event date assigned successfully."

User changes event date from TBD to an actual date for the first time. No contractors are assigned (since TBD blocks assignment).

Info Tab returns to read-only mode with the new date and timezone displayed. Activity log updated.

Save and Notify (All Contractors Available)

"Event date updated successfully. Contractors have been notified."

User changes the event date, all assigned contractors are available on the new date, and user clicks "Save and Notify Contractors."

Update Event modal closes. Info Tab shows updated data. All contractors receive email and in-app notifications. Activity log updated.

Save Venue Change (Contractors Assigned)

"Event venue updated successfully. Contractors have been notified."

User changes only the venue and saves. Contractors are assigned to the event.

Info Tab returns to read-only mode. Distance recalculated for existing contractors. Email and in-app notifications sent to assigned contractors.

Save Venue Change (No Contractors)

"Event venue updated successfully."

User changes only the venue and saves. No contractors are assigned to the event.

Info Tab returns to read-only mode with updated venue.

Save and Notify Contractors (Date Change)

"Event date updated successfully. Contractors have been notified."

User resolves all unavailable contractors and clicks "Save and Notify Contractors."

Update Event modal closes. Info Tab shows updated data. Notifications sent. Activity log updated.

Remove & Notify (Warning Popup)

"Event date updated. Unavailable contractors have been removed and notified."

User clicks "Remove & Notify" in the secondary warning popup to auto-remove remaining unavailable contractors.

Modal closes. Contractors removed. Event appears on Dashboard > Unassigned Contractor List. Notifications sent.

Add A La Carte Item

"A la carte item added successfully."

User adds an additional a la carte item via the Order Info edit and saves.

Order Info section updates with the new item displayed as a chip/tag. Activity log updated.

Remove A La Carte Item (Additional)

"A la carte item removed successfully."

User removes an agency-added a la carte item via the Order Info edit and saves.

Order Info section updates without the removed item. Activity log updated.

Replace Contractor

"Contractor replaced successfully."

User selects a replacement contractor from the Suggested Contractors modal and completes the event price assignment.

Update Event modal updates with the new contractor displayed in place of the removed one.

Discard Changes Confirmed

No toast message (silent action).

User clicks "Yes, Discard" on the Discard Changes confirmation popup.

Update Event modal closes. Event date reverts to original. All contractor changes discarded. Info Tab returns to read-only mode with original data.

Save Date Change (Past Date - No Changes)

"Event date updated successfully."

User changes primary event date to past date, Payment Schedule Impact pop-up appears, user clicks "No Changes."

Pop-up closes. Info Tab returns to read-only mode with updated date. Payment schedule remains unchanged. Activity log updated.

Save Date Change (Past Date - Update Invoice)

"Event date updated successfully."

User changes primary event date to past date, Payment Schedule Impact pop-up appears, user clicks "Update Invoice."

Pop-up closes. User is redirected to Finance Tab → Invoice. Activity log updated.

Save Date Change (TBD to Past - No Changes)

"Event date updated successfully."

User changes primary event date from TBD to past date, Payment Schedule Impact pop-up appears, user clicks "No Changes."

Pop-up closes. Info Tab returns to read-only mode with updated date. Calculated payment dates are applied. Activity log updated.

Save Date Change (TBD to Past - Update Invoice)

"Event date updated successfully."

User changes primary event date from TBD to past date, Payment Schedule Impact pop-up appears, user clicks "Update Invoice."

Pop-up closes. User is redirected to Finance Tab → Invoice. Activity log updated.

Save Date Change (Future to TBD - No Changes)

"Event date updated successfully."

User changes primary event date to TBD, Payment Schedule Impact pop-up appears, user clicks "No Changes."

Pop-up closes. Info Tab returns to read-only mode with TBD. Original payment dates retained. Activity log updated.

Save Date Change (Future to TBD - Update to TBD)

"Event date updated successfully."

User changes primary event date to TBD, Payment Schedule Impact pop-up appears, user clicks "Update to TBD."

Pop-up closes. Info Tab returns to read-only mode with TBD. Payment dates updated to TBD. Activity log updated.

## **7\. Error Message Handling**

**Error Scenario**

**Error Message**

**Trigger Condition**

**Required User Action / System Response**

End Date Before Start Date

"End date and time cannot be earlier than or the same as the start date and time."

User sets the end date/time to a date/time that is before or equal to the start date/time for a multi-day event.

User must correct the end date/time to be after the start date/time.

Empty Date Field (Multi-Day)

"Both start date and end date are required for multi-day events."

User clears one date field while the other remains set for a multi-day event.

User must provide both start and end dates, or set both to TBD.

Invalid Venue Input

"Please select a valid venue from the suggestions."

User types a venue address that does not match any Google Maps API suggestion and attempts to save.

User must select a valid venue from the autocomplete suggestions.

Google Maps API Failure

"Unable to load venue suggestions. Please check your internet connection and try again."

Google Maps API fails to return results due to network or API issues.

System displays the error. User can retry or enter the venue later.

No Contractors Available for Replacement

"No contractors available for the selected date, role, and service area. Please adjust your filters or try a different date."

User clicks "Replace" but no contractors match the filter criteria in the Suggested Contractors modal.

User can adjust filters, search manually, or go back and remove the contractor instead.

Save Without Resolving Unavailable Contractors

"Some contractors are still unavailable. Please remove or replace them, or click 'Remove & Notify' to proceed."

User clicks "Save and Notify Contractors" while unavailable contractors remain unresolved in the Update Event modal.

Secondary warning popup is displayed with "Remove & Notify" and "Go Back" options.

Advance Payment Warning on Removal

Message varies based on payment status: Unpaid shows standard removal message; Processing shows processing amount; Paid shows paid amount; Mixed (Paid + Processing) shows only paid amount. Payment count shown only for Multiple Paid or Multiple Processing scenarios.

User attempts to remove a contractor who has payments in any status.

User can proceed with removal (acknowledging offline settlement) or cancel the removal.

Data Load Failure

"Unable to load event information. Please refresh the page and try again."

System fails to fetch event info data from the server.

User refreshes the page. System retries data fetch.

Session Timeout During Edit

"Your session has expired. Please log in again to continue editing."

User's session expires while in inline edit mode.

User is redirected to the login page. Unsaved changes are lost.

Duplicate A La Carte Item

"This a la carte item has already been added to this event."

User attempts to add an a la carte item that already exists for this event (either original or additional).

System prevents the duplicate addition and displays the error message.

Network Failure During Save

"Unable to save changes. Please check your internet connection and try again."

Network connectivity is lost while saving event info, order info, or contractor changes.

No changes are committed. The current edit state is preserved for retry.

## **8\. Edge Cases**

**#**

**Scenario**

**Expected Behavior**

1

User changes event date and no contractors are assigned to the event.

The system saves the date change directly without showing the Update Event modal and displays a success toast message.

2

User changes event date and ALL assigned contractors are available on the new date.

The Update Event modal is displayed showing all contractors with "Available" status. The banner text reads: "All contractors are available on the new event date. Click 'Save and Notify' to update and inform all contractors." All Remove/Replace buttons are disabled. User clicks "Save and Notify Contractors" to proceed, and all contractors are notified of the date change.

3

User changes event date and ALL assigned contractors are unavailable on the new date.

The Update Event modal is displayed showing all contractors with "Not Available" status. All Remove/Replace buttons are active. User must remove or replace all contractors, or use "Remove & Notify."

4

User changes venue and date simultaneously in a single inline edit session.

The system prioritizes the date change flow: the Update Event contractor availability modal is triggered based on the date change. The venue change is saved simultaneously. Distance is recalculated based on the new venue. Contractors receive notifications about both changes.

5

User clicks "Discard Changes" in the Update Event modal after replacing some contractors.

The system displays a confirmation popup. If the user confirms ("Yes, Discard"), the system reverts the entire date change back to the original date, discards all contractor replacements made during this session, and returns to the Info Tab with original data. If the user clicks "Go Back," they remain on the Update Event modal.

6

User removes a contractor with payments (Paid, Processing, or Mixed).

The system displays the Remove Contractor confirmation dialog with message based on payment status: Paid shows paid amount, Processing shows processing amount, Mixed (Paid + Processing) shows only paid amount. Payment count shown only for Multiple Paid or Multiple Processing. Removal is not blocked. If the user confirms, the contractor is removed and the event appears on the Unassigned Contractor List. The payment record remains as-is in the Finance module with no status change. Any payment discrepancies must be handled internally between the parties.

7

Event date is TBD and user tries to assign contractors (from Contractors Tab).

Contractor assignment is blocked when the event date is TBD. This is enforced in the Contractors Tab, not the Info Tab. The Info Tab simply displays "TBD."

8

User changes venue but Google Maps API is unavailable or returns an error.

The system displays the error message: "Unable to load venue suggestions. Please check your internet connection and try again." The venue field retains the original value.

9

User changes event from multi-day to single-day by setting start and end date to the same day.

The system prevents this by enforcing the validation that end date cannot be the same as start date. If the event needs to be converted to single-day, it should be done during the event edit flow outside of the Info Tab.

10

Multiple users edit the same event's Info Tab simultaneously.

The last save wins. The second user to save may overwrite the first user's changes. The system does not currently support real-time conflict detection. Both changes are logged in the activity log.

11

User changes primary event date from future to past with unpaid payments.

The Payment Schedule Impact pop-up is displayed with payment schedule table showing all payments. Original payment dates remain unchanged. User can click "No Changes" to proceed or "Update Invoice" to go to Finance Tab.

12

User changes primary event date from TBD to past with unpaid payments.

The Payment Schedule Impact pop-up is displayed with calculated payment dates based on smart date configuration. Past due payments show "Overdue" status. User can click "No Changes" to apply calculated dates or "Update Invoice" to edit manually.

13

User changes primary event date from future to TBD with unpaid payments.

The Payment Schedule Impact pop-up is displayed with original payment dates shown in table. User can click "No Changes" to keep original dates or "Update to TBD" to set payment dates to TBD.

14

User changes non-primary event date to past with unpaid payments.

No Payment Schedule Impact pop-up is displayed. Date change saves normally. Payment schedule is not affected by non-primary event date changes.

15

User changes primary event date with all payments already paid.

No Payment Schedule Impact pop-up is displayed. Date change saves normally. Paid payments are not affected by event date changes.

16

User clicks "Update Invoice" on Payment Schedule Impact pop-up.

The pop-up closes, date change is saved, and user is redirected to Finance Tab → Invoice for editing payment schedule.

17

User clicks "No Changes" on Payment Schedule Impact pop-up.

The pop-up closes, date change is saved, and payment schedule behavior varies by scenario (retained for Future→Past, calculated for TBD→Past, retained for Future→TBD).

18

User clicks "Update to TBD" on Payment Schedule Impact pop-up (Future → TBD).

The pop-up closes, date change is saved, and payment dates are updated to TBD state.

19

User changes primary event date from actual date back to TBD.

TBD option is now available in date picker. If unpaid payments exist, Payment Schedule Impact pop-up is displayed with "No Changes" and "Update to TBD" buttons. Contractor availability check is NOT performed for TBD dates.

20

User changes event date to past date with assigned contractors.

Contractor availability check is NOT performed for past dates. Date change saves directly. If primary event and unpaid payments, Payment Schedule Impact pop-up is displayed.

21

Invoice has many payments (6+ installments).

The payment schedule table in the pop-up is scrollable. All payments are displayed regardless of count.

22

TBD → Past: All calculated payment dates are in the past.

All unpaid payments show "Overdue" status in the table. User is informed they need to update payment dates manually if they proceed with "No Changes".

_(Additional edge cases continue in the full document)_

## **9\. Acceptance Criteria**

1.  The Info Tab displays Event Info and Order Info sections in read-only mode by default upon navigation.  
    
2.  The Event Name is displayed with the correct color dot indicator fetched from Agency Settings.  
    
3.  Multi-day events display separate "Start Date & Time" and "End Date & Time" fields, and single-day events display a single "Event Date & Time" field.  
    
4.  TBD events display "TBD" in the date and timezone fields, and "Venue not decided" is shown when no venue is set.  
    
5.  The Time Zone dropdown is populated with the correct timezone options (EDT/EST, CDT/CST, MDT/MST, PDT/PST, MST, HST, AKDT/AKST).  
    
6.  Clicking "Edit" on Event Info converts fields to inline editable inputs with "Save" and "Cancel" buttons.  
    
7.  The Primary Venue field provides Google Maps API autocomplete suggestions during inline editing.  
    
8.  Changing the event date with assigned contractors triggers the Update Event modal with accurate contractor availability status.  
    
9.  Available contractors in the Update Event modal have disabled "Remove Contractor" and "Replace" buttons.  
    
10.  Unavailable contractors in the Update Event modal have active "Remove Contractor" and "Replace" buttons.  
     
11.  The Update Event modal displays payment information (Event Price, Amount Paid, Distance) for each contractor.  
     
12.  Clicking "Replace" opens the Suggested Contractors modal pre-filtered by the new date, role, and service area.  
     
13.  The Suggested Contractors modal displays contractor name, rate, travel fee, service area, rating, and "Select" action.  
     
14.  Clicking "Discard Changes" displays a confirmation popup asking the user to confirm the discard action before reverting.  
     
15.  Confirming "Yes, Discard" on the popup reverts the date back to the original, discards all contractor changes, and closes the modal.  
     
16.  Clicking "Go Back" on the discard confirmation popup returns the user to the Update Event modal without discarding anything.  
     
17.  "Save and Notify Contractors" sends email and in-app notifications to all affected contractors.  
     
18.  Clicking "Save and Notify" with unresolved unavailable contractors shows the secondary warning popup with "Remove & Notify" option.  
     
19.  Removed contractors are unassigned from the event, and the contractor card in the Update Event modal is replaced with the Unassigned state card.  
     
20.  Clicking the "Assign \[Role\]" button on the Unassigned card opens the Suggested Contractors modal pre-filtered for that specific role.  
     
21.  The event appears on the Dashboard > Unassigned Contractor List when contractors are removed.  
     
22.  Remove Contractor dialog displays appropriate confirmation message based on payment status (Unpaid, Processing, Paid, or Mixed). For Mixed status (Paid + Processing), shows only the paid amount. Payment count is shown only for Multiple Paid or Multiple Processing scenarios.  
     
23.  Venue changes recalculate distance for existing contractors but do NOT recalculate travel fees.  
     
24.  Venue changes trigger email and in-app notifications to all assigned contractors.

25.  New contractors assigned after a venue change have distance and travel fee calculated based on the new venue.  
     
26.  Users can change an event date back to TBD. The TBD option is available in the date picker for events that already have an actual date assigned.  
     
27.  Changing the primary event date from future to past with unpaid payments displays the Payment Schedule Impact pop-up with payment schedule table.  
     
28.  Changing the primary event date from TBD to past with unpaid payments displays the Payment Schedule Impact pop-up with calculated payment dates and Overdue status for past due payments.  
     
29.  Changing the primary event date from future to TBD with unpaid payments displays the Payment Schedule Impact pop-up with original payment dates.  
     
30.  The Payment Schedule Impact pop-up displays a table with columns: Amount, Due Date, Status.  
     
31.  The Payment Schedule Impact pop-up message includes "X out of Y payments are unpaid" count.  
     
32.  The payment schedule table shows ALL payments (paid and unpaid) for full visibility.  
     
33.  The payment schedule table is scrollable if there are many payments.  
     
34.  For Future → Past scenario, payment dates remain as original future dates when "No Changes" is clicked.  
     
35.  For TBD → Past scenario, payment dates are calculated from smart date configuration and displayed with Overdue status for past due dates.  
     
36.  For Future → TBD scenario, buttons are "No Changes" and "Update to TBD" (not "Update Invoice").  
     
37.  Clicking "No Changes" closes the pop-up and saves the date change with payment schedule behavior varying by scenario.  
     
38.  Clicking "Update Invoice" closes the pop-up, saves the date change, and redirects to Finance Tab → Invoice.  
     
39.  Clicking "Update to TBD" closes the pop-up, saves the date change, and updates payment dates to TBD.  
     
40.  The Payment Schedule Impact pop-up is NOT displayed for non-primary events.  
     
41.  The Payment Schedule Impact pop-up is NOT displayed when all invoice payments are already paid.  
     
42.  Changing the event date to a past date does NOT trigger the contractor availability check modal.  
     
43.  Changing the event date to TBD does NOT trigger the contractor availability check modal.  
     
44.  Payment date changes made via "Update Invoice" or "Update to TBD" are logged in the Activity Tab.

_(Additional acceptance criteria continue in the full document)_

## **10\. Manual Test Cases**

**Test Cases File:** Click Here

## **11\. Dependencies**

**#**

**Dependency Type**

**Dependency**

**Description**

**Behavior if Unavailable**

1

Internal Module

Project Details > Overview > Activity Tab

All changes on the Info Tab are logged as activity entries in the Activity Tab.

Changes are saved but activity log entries may not appear until the Activity Tab service is restored.

2

Internal Module

Events > Contractors Tab

Contractor assignments, removals, and replacements initiated from the Info Tab are reflected in the Contractors Tab. Unassigned cards appear for unfilled roles.

Contractor changes may not be reflected in the Contractors Tab until the module is synced.

3

Internal Module

Dashboard > Unassigned Contractor List

Events with removed contractors appear on the Unassigned Contractor List.

The event may not appear on the Unassigned list until the Dashboard syncs.

4

Internal Module

Contractor Portal

Removed contractors' portal is updated to remove the event and update availability. Replacement contractors' portal is updated to show the event.

Portal update may be delayed; contractor may temporarily still see the event.

5

Internal Module

Agency Settings

Event color dot indicator and default timezone are fetched from Agency Settings.

Default values may not load; system should use fallback defaults.

6

Internal Module

Finance Module

Advance payment data (Event Price, Amount Paid) is fetched from the Finance Module for display in the Update Event modal. When contractors are removed, financial records persist as-is with no automatic status change.

Payment data may not display; the system should show "N/A" and still allow the removal flow.

6a

Internal Module

Finance Tab > Invoice

The "Update Invoice" button on the Payment Schedule Impact pop-up redirects the user to the Finance Tab → Invoice for editing payment schedule dates. Invoice payment status (unpaid/paid) is checked to determine if pop-up should display.

If Finance Tab is unavailable, the "Update Invoice" button may fail to redirect. User can manually navigate to Finance Tab later.

7

Internal Module

Packages / Proposals Module

Order Info (Package Name, Items Included, A La Carte Items) is sourced from the client's proposal/booking selections.

Order Info section shows the empty state message if data is unavailable.

8

Internal Module

Events > Contractors Tab > Assign Contractor

The replacement flow uses the same Assign Contractor workflow, including Suggested Contractors modal and event price assignment step.

Replacement flow may fail; user can remove the contractor instead and assign a new one later from the Contractors Tab.

9

External Service

Google Maps API (Google Places API)

Used for venue autocomplete search during inline editing of the Primary Venue field.

Error message is displayed. User cannot update the venue until the API is available.

10

External Service

Notification Service (Email)

Sends email notifications to contractors when events are changed, and contractors are removed or replaced. Removal email content includes service agreement voiding information.

Notifications are queued and retried. Changes are saved regardless of notification delivery status.

11

External Service

Notification Service (In-App)

Sends in-app notifications to contractors for event changes, removals, and replacements.

In-app notifications may be delayed; changes are saved regardless.

12

Configuration

Contractor Availability Data

Contractor scheduling data (other project assignments, DNB dates) is required for the availability check during date changes.

Availability check may return inaccurate results; system should err on the side of showing contractors as potentially unavailable.

13

Configuration

A La Carte Items Master List

The list of available a la carte items for adding to an event is sourced from the system's master catalog.

User cannot add new a la carte items if the catalog is unavailable.

14

Internal Module

Settings > My Profile > Date & Time Preferences

All date and time values on the Info Tab are displayed according to the user's selected date format, time format, and optional day-of-week inclusion.

If preferences are unavailable, the system should fall back to a default format (e.g., MM/DD/YYYY, 12-hour AM/PM).

15

Internal Module

Contract > Service Agreement

When a replacement contractor is assigned and saved, the system checks the "Automatically Send to Contractors" toggle for the relevant service agreement template. If enabled, the service agreement is automatically sent to the contractor for signing. Each event requires a new agreement.

If the service agreement template is unavailable or not configured, the auto-send is skipped silently. The agency owner can manually send it later from the Files/Documents tab.

16

Internal Module

Files/Documents Tab

When a contractor is removed, any signed service agreement for that event is automatically changed to "Voided" status. The voided agreement remains as a historical record.

If the Files/Documents module is unavailable, the voiding may be delayed. The removal proceeds regardless.

## **12\. References**

Figma Link - \[Click Here\]

✅ Notes

# **Functional Requirements Document (FRD) - Agency Notes Module**

## **1\. Module Overview**

*   **Module Name:** Notes Management
*   **Purpose:** Enable users to create public and private notes with the CRUD operations- view, edit, and delete notes associated with a project and its events
*   **Business Goal:** Improve project communication and documentation by providing a centralized note-taking system with role-based visibility controls

## **2\. User Roles & Permissions**

*   **Link:** [**Roles and permissions - draft**](https://docs.google.com/spreadsheets/d/1fPBOJVJmmtHcs9Ev9o_pneOD4Em3Z4AB-j3jrLyJvaY/edit?usp=sharing)

![](data:image/png;base64,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)

**Role**

**Key Permissions**

**Contractor**

**Limited access:**

*   Visibility to the Public notes shared by the agency users
*   Create public notes: accessible to agency and team members only
*   Edit and delete self-created public notes
*   Create, edit, and delete private notes

**Client**

**Limited access:**

*   Visibility to the Public notes shared by the agency users
*   Create public notes only for the agency and the team members
*   Edit and delete self-created public notes
*   Can not create a private note

## **3\. User Flow**

**Agency Portal**

**3.1 Empty State**

![](data:image/png;base64,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)

**3.2 Create Notes From Overview**

### **![](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAABN8AAAJgCAYAAAC6I8UnAAAABmJLR0QA/wD/AP+gvaeTAAAgAElEQVR4nOzdeVQV9eP/8Re7G7ivmeaKuKailltuZC6opYhblOVWWqiZmJnxMSvJrWvlQh/R0FJBP6WUZaBmmqaiqGiiqOFGuaKyiKy/P/zJNwIXlMuwPB/ncI7MvGfui3vu3Asv3zNjkZ6eni4AAAAAAAAAuS3Q0ugEAAAAAAAAQGFF+QYAAAAAAACYCeUbAAAAAAAAYCbWRgcAAKAoOnfunHbu3Gl0DBRyAwcONDoCAABAkWfBDRcAAMh7AQEBcnd3NzoGCjl+zQMAADBcIDPfAAAwUHh4uNERUAht2rRJkyZNMjoGAAAAxDXfAAAAAAAAALOhfAMAAAAAAADMhPINAAAAAAAAMBPKNwAAAAAAAMBMKN8AAAAAAAAAM6F8AwAAAAAAAMyE8g0AAAAAAAAwE8o3AAAAAAAAwEwo3wAAAAAAAAAzoXwDAAAAAAAAzITyDQAAAAAAADATyjcAAAAAAADATCjfAAAAAAAAADOxNjoAAADIuSNHjmjVqlXau3evLl++LFtbW9WsWVOdOnXS0KFDZW9vb3TEQmXAgAE6duzYA48fN26cRo8efd9xy5cv19y5cyVJlSpV0ubNmx86IwAAAPInZr4BAFDAfPrppxoyZIgcHBz0xRdfaOfOndq0aZNee+01bd68Wb169VJYWJjRMR9KQkKCevXqpbFjxxodJYu5c+cqPDw848vNzU2StGjRokzLn3vuuQfe58svv6zw8HA5OjqaKzYAAAAMRvkGAEABsmTJEi1dulTTpk3T5MmTVbduXdnZ2cnBwUHPPPOMVqxYoapVq+q1117Tn3/+aXTcHEtPT1daWprS0tKMjgIAAADkCk47BQCggDhz5owWLVokJyenjFlX/1asWDF5eXnppZde0scffyxfX988TvloSpYsqR9//NHoGFmsXbv2gcfOnj3bjEkAAABQ0DDzDQCAAiIgIECpqanq3r37Pce1aNFClSpV0q5du3Tu3Lk8SgcAAAAgO8x8AwCggAgNDZWkB7o+WP369XXx4kX98ssv8vHxybTuzs0AUlNT9eSTT2Ysd3Fx0bx58yRJMTExWrx4sX755RddvHhR9vb2atGihcaMGaMGDRpIkrZs2SJPT8+M7YOCgvTZZ59p9+7dun79era57vXYvXv3zrS/0NBQ2dnZZXz/IJnefPNNbd26NWOb5s2by9/fX5K0e/dujRgxQp999pk6deokSfLx8dHKlSszxh84cEBWVlb3fX7vJzU1VcHBwVq3bp0iIyMVFxenxx9/XP3799eQIUNkaZn9/3/++eefmj17tsLCwpScnKymTZvqjTfeUPPmzR85EwAAAIzBzDcAAAqIixcvSpJKly5937FlypSRJCUmJio8PFzt27eXpaWlNm7cmHEXTisrK4WHh6tZs2by8fHJKN4uXbqkQYMGadOmTZo2bZp+++03+fn56fr16xo2bJgOHjwoSerSpYvCw8PVuXNnSdJ//vMfDRo0SCEhIfr6669laWmpX3/99YEf+9/7+6cHzbRgwQK9++67km4Xa3eKN+l2OShJP/zwQ8YyLy8vmUwmtWnTRuHh4blSvEnSjh079Pbbb6tNmzbasGGDgoOD5ebmptmzZ2v+/PnZbpOQkKCZM2dq5MiR2rx5s7766itdv35dr776akbxCgAAgIKH8g0AgALGwsIix2NffvllpaWlZSqjJCksLEwXL17MdCqryWRSdHS0Jk+erA4dOqhEiRKqW7euZs+erfT0dH300UfZPtarr76qVq1aqVixYmratKkOHjyosmXL5uix7yYnmXr06CEbG5uMsk2Sbt26pa1bt6pGjRraunWr4uPjM9Zt2LBBffr0uW+GnGrVqpVGjBghBwcHlS1bVkOGDFHPnj21cuVKxcXFZRkfFxcnT09PNW/eXCVKlFCjRo00a9YsJScna9asWbmeDwAAAHmD8g0AgAKiYsWKkqRr167dd+ydMXe2adOmjZycnPTdd99l2n7ZsmUaNmxYphlfmzdvlqWlpTp27JhpnxUqVFCdOnX0xx9/6MKFC1kes3Hjxtlmyclj301OMpUuXVodOnTQzp07dfnyZUm3T5Ft2rSpBg0apFu3bikkJESSdP36de3du1fdunW7b4aceOaZZ+Tn55dluaOjo1JSUnTy5Mks6+zs7NSkSZNMy+rVq6dKlSrp2LFjunTpUq5mBAAAQN6gfAMAoIBwdnaWJB07duy+Y48fPy7p9uyrO1566SUlJiZqzZo1kqTTp09r37596t+/f8aYpKQkxcXFKS0tTU8//bSaNGmS6evo0aMZ2/5b8eLF75rnQR77bh4mU58+fZSW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h/XKK680Wb8zfL6vxLFbQ5K1bNmyS94eAACgHS2nfAMAdBqXW77NnDmz2Wvp6elfWr55PJ5mOSQ1K8EuVhDcc889liTrD3/4Q5PlhYWFVlBQkDVixIgWj71u3bovO71mLna+jQ4dOtRi+daWnB6Pxxo3blyzfd91112W0+m0KioqfMsMw7AkWStWrGiybn5+vhUUFHRFy7fWvF9tfT8uxN/fv9VFZ0xMTKv22Vi+ffDBB61av9G9995rSbLeeuutJstramqs+Ph4KyQkxDp+/LhveWf4fF+JY7cG5RsAAOjElvPYKQCgx7v55pubfJ+UlCRJKigoaPU+Vq1aJT8/P7lcribLY2Njdd1112n79u3Ky8trtt3Xvva1S0h86dqS0+VyNXmcsdGNN96os2fPateuXb5lGzZskCRNmTKlybrx8fG6+uqrr+g5tOb9utT344vq6upkWVaTr1tuuUUzZsxotvz48eOtyh8fHy9JbX68eOXKlZKkGTNmNFkeFBSkiRMnqrq6Whs3bmy2nZ2f7ytxbAAAgK6OATUAAN1aa8YcCwsLa/J9YGCgJLU4rllLamtrVVFR0eK+znfgwAElJiY2WRYaGtqqY1wJbc1ZUVGh//mf/9HKlSuVl5fXbMbYqqoq335Pnz6t4OBg9e7du9n+oqOjtX///it2Hl/2fl3O+9ERxo4dq+3bt+uTTz7RtGnTWrVN4zkFBwerT58+zV6PiYmRpBYLQDs/35d7bAAAgO6AO98AAGglh8PR4vKgoCCFh4crICBAZ8+ebXZHVOPX+PHjOzjx

5eV0u936yU9+ooULF2r//v1qaGiQZVl65plnJEmWZfn226dPH9XU1KiysrLZccvKyjruJNX534/7779fAQEBWrFixUXX+/73vy8/Pz/t3btXQUFBCgsLU01NjU6fPt1s3aKiIknn7kS7VHZ+vi90bAAAgO6A8g0A0CN89atf1R//+MfL2kevXr30+eef+76/5ppr9PLLL0uS5syZo7q6Om3durXZdj//+c81YMAA1dXVXdbxr4TW5qyvr9fWrVsVGxurBx98UFFRUb6CpLq6utm2jXdwNT5+2qikpET79u1rhzO5uM78flx99dV6/PHH9dFHH+m1115rcZ19+/bppZde0rx58zR06FBJ0uzZsyVJa9eubbJubW2tNm/erJCQkGaPFqi6yQAAIABJREFU/baFnZ/vix0bAACgq6N8AwCglW666Sbt379fx44dU05OjnJzczVmzBhJ0s9+9jMNHjxY//zP/6z169eroqJCZWVleumll/Rf//VfWrJkiQIC7B/tobU5/f39NW7cOB0/flxPP/20SkpKVF1drS1btujFF19stt8nnnhCERERevjhh5WZmanKykrt3r1bd911V4uPonaW87TLj370Iz322GP69re/rccee0z79+/X559/rvz8fL366qsaP368brjhBr366qtNzik5OVkPP/ywvF6vTp8+rf379+vOO+9UYWGhli5d6nv89FLY+fm+2LEBAAC6vPae0gEAgNa6lNlOQ0NDWz0bZeMskTk5Oc1e++EPf2hZltVs+YwZM3zH2rt3rzVmzBgrNDTUSkpKsp577rkmWUpLS61FixZZKSkpltPptKKioqzJkydbmZmZvnVaOnZb/jpu6XyffvrpJuskJCRc8Pxam9OyLKu4uNi6//77raSkJMvpdFoxMTHWvffeaz322GO+/Z4/y+W+ffusWbNmWX379rVCQkKsm2++2fJ6vdbEiRN963/zm9+0nn766RbzrVy5stnyr3/965f8frX2PNvqlltuaXKcy/HBBx9Yd999t+/PuE+fPlZaWpq1dOlSq7a2ttn6JSUl1sMPP2wlJydbTqfTCgsLs6ZMmWJt3rzZt05n+3xfiWN/GTHbKQAA6LyWOyzr/wZsAQDAZoZhSJJM07Q5CYCuxOFwaNmyZZo3b57dUQAAAL7I5LFTAAAAAAAAoJ1QvgEAAAAAAADthPIN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)**

**3.3 Create Notes From Event**

![](data:image/png;base64,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lImQgAd9na2qp3795pLoFOSkpi1mcAMJCNjY1GjBihZcuW6ddff1Xr1q119OhRo2MBQI5FqQggU9wrE6tVq6Z58+Zp7NixljMTHR0djY4HADlKr1690lwCXb58ebVs2dKgRACAezp16qQdO3aoYMGCcnV11eLFi42OBAA5EqUigMdy4cIFS5n4888/UyYCQAZ4eHioatWqlscFChRQ//79ZWNjY2AqAMA9VapU0Z9//qn+/fvL19dXAQEBSkpKMjoWAOQolIoAHsk/y8RZs2bpk08+oUwEACv069dPDg4OkqTExEQufQaAHKZgwYIKCgrSnDlz9OOPP8rb21vnzp174DYUjwDyE0pFAFa5ePFiqjLx448/VnR0tEaMGCEnJyej4wFArtGrVy/LL5+1a9dWo0aNDE4EAEhPv379tGHDBp09e1ZNmjTRmjVr0h23e/duPffcc0pOTs7mhABgDEpFIB8zm83av39/hsZevHhRo0aNUs2aNTVz5kzKRAB4TA0aNFCDBg0kSf379zc2DADggRo3bqyoqCg99dRTeu655/TVV1/JbDZb1l+5ckUvvPCC1q5dq++//97ApACQfWzM/3wnBJBvmM1mvf3221q1apUOHjwoOzu7dMddvHhR//vf/zRx4kQVLFhQ7777rt5++20VKlQomxMjr9m4caMmTJhgdAzAUIcOHdKePXv0/PPPq3DhwkbHAQxlMpmMjgA8lNls1nfffaf3339fHTt21OzZs1W0aFG98MILCg8PV1JSkhwdHbVv3z7VqFHD6LgAkJVM9kYnAG

CM4cOHa8qUKZKkefPmqV+/fqnWX7p0Sd9//70mTpyoAgUK6MMPP6RMRKY6ffq0Fi1apO7dOxodBTBM5cqldfZscRUubCMpweg4gCHOnDmnTZt2GB0DyBAbGxsFBASoadOm6tmzp9zd3fX8889r5cqVSklJkSQlJyerf//++vPPP5mAC0CexpmKQD40cuRIffHFFzKbzbKxsVGVKlV09OhR2dvbW8rEb7/9Vg4ODnrzzTc1bNgwFSlSxOjYyGNCQkLk5+cnszna6CiAobZs2SV398ZGxwAMExKyXH5+b4lfS5DbxMbGqkOHDtq5c2ea718bGxtNmzZNAwcONCgdAGQ5zlQE8psJEyZo9OjRlsdms1mnT5/W9OnTFRMTYykThw4dSpkIANmAQhEAcqeUlBSdPn1atra2aSZnMZvNGjp0qDp06KBKlSoZlBAAshalIpCPfPfdd3r33XfTLDebzRo2bJicnZ31wQcf6M0335Szs7MBCQEAAICcLykpSS+99JKuXr1639meExMTNWjQIK1YsSKb0wFA9mD2ZyCfmDlzpoYOHZruOrPZrMTERI0ePVojRoygUAQAAAAe4L333tPWrVuVlJR03zFJSUlauXKlFi5cmI3JACD7UCoC+cCcOXM0cODAB96ryGw2a8yYMbpz5042JgMAAAByl6ioKE2dOlVms1l2dnYPHGtjY6PXX39dFy9ezKZ0AJB9KBWBPG7RokV65ZVXHnrzc7PZrDNnzmju3LnZlAywnrNzA9nYVEvzZWtbXaVLN1OXLoO0desuQzPmNPd7zdL72rZtt1ExM11++l755ptpludXqVILo+M8tgULwizPx9GxjtXbnzz5t158caCuXbue6dkyw+M+v8yUWd87gYFfaeHC5ZmWC8jpXF1dFRMTo1mzZunZZ5+Vg4ODbGxs0i0YzWazrl+/rrffftuApACQtSgVgTzsl19+Uc+ePTM8m2JKSoo++eSTB17GARjp+vX92rHjN0lS587tZTZHy2yOVlzcbk2bNlYbN25X69bdFBERaXDSnON+r9m/v4oWdTE4aebKT98r7703WGZztBo3rm90lEzRs6ePzOZotWvX2uptd+7cLzc3Hz37rJeKFMmZt/J4nOeX2TLre2fQoJ764IOvNHLk+ExKBuR8xYoVk7+/v3777TdduHBBCxculJ+fnwoWLJimYExKSt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