Skip to main content

Collaboration & Team Features

Collaborate with your team through activity feeds, notifications, comments, and mentions.

Overview​

The Collaboration workspace provides real-time visibility into project changes and team activity.

Access collaboration features by clicking the Collaboration icon (handshake icon) in the left navigation.

Activity Feed​

Purpose​

See real-time updates on all project changes to stay informed and coordinated with your team.

What's Tracked​

The activity feed automatically captures:

Requirement Activities:

  • Requirement created
  • Requirement edited (text, type, status, parent changed)
  • Requirement deleted
  • Requirement moved (parent changed)
  • Requirement status changed (Draft → Approved → Implemented)

FMEA Activities:

  • FMEA item added
  • FMEA item modified (S/O/D ratings changed)
  • FMEA item deleted
  • FMEA linked to requirement
  • Action item created/completed

Collaboration Activities:

  • Comment posted
  • User @mentioned
  • Assignment created
  • Team member added/removed

Version Control Activities:

  • Requirement version created
  • Requirement reverted to previous version

How to Use​

  1. Click "Collaboration" in left navigation

  2. View activity feed (newest first)

  3. Each activity shows:

    • Icon: Activity type indicator
    • User: Who performed the action (avatar + name)
    • Action: What happened (e.g., "edited requirement")
    • Target: Which item was affected (e.g., "SYS-001")
    • Timestamp: When it happened (relative time)
    • Details: Additional context (e.g., "Changed status from Draft to Approved")

  4. Filter activities using the filter panel:

    • User: Show activities by specific user(s)
    • Type: Filter by activity type (requirement, FMEA, comment)
    • Date Range: Today, Last 7 days, Last 30 days, Custom
    • Entity: Filter by specific requirement ID

  5. Click activity to navigate:

    • Clicking a requirement activity navigates to that requirement
    • Clicking an FMEA activity navigates to FMEA workspace
    • Clicking a comment activity shows the comment thread

  6. Search activities:

    • Use search box to find specific activities
    • Search by requirement ID, user name, or action text

Activity Feed Layout​

[Icon] [Avatar] User Name
       edited requirement SYS-001
       Changed status from Draft to Approved
       2 hours ago

[Icon] [Avatar] User Name
       added FMEA item FMEA-005
       Linked to requirement CR-002
       3 hours ago

Real-Time Updates​

The activity feed auto-refreshes every 30 seconds to show new activities. You'll see a subtle notification when new activities arrive.

Notifications​

Purpose​

Get notified when you're mentioned, assigned tasks, or when items you follow change.

Notification Types​

@Mentions:

  • Someone mentions you in a comment using @YourName
  • Notification includes comment preview
  • Click to view full comment thread

Assignments:

  • You're assigned a requirement for implementation
  • You're assigned an FMEA action item
  • You're assigned a compliance issue to resolve

Followed Items (Coming Soon):

  • Requirements you "follow" are modified
  • Allows you to track specific critical requirements
  • Unfollow at any time

Deadlines (Coming Soon):

  • FMEA action item due date approaching
  • Compliance deadline approaching
  • Requirement review deadline

Team Changes:

  • Added to project team
  • Removed from project team
  • Role changed (viewer → editor → admin)

How to Use​

  1. View notifications:

    • Click notification bell icon (top-right corner)
    • Dropdown shows recent notifications
    • Red badge shows unread count

  2. Notification structure:

    • Icon: Notification type
    • Title: Summary (e.g., "@John mentioned you")
    • Preview: Additional context
    • Timestamp: When notification was created
    • Read status: Bold = unread, normal = read

  3. Actions:

    • Click notification: Navigate to item and mark as read
    • Mark as read: Click checkmark (without navigating)
    • Dismiss: Click X to remove notification
    • Mark all as read: Click "Mark All Read" button

  4. Notification settings (Coming Soon):

    • Choose notification types
    • Set quiet hours
    • Email notification preferences

Notification Bell States​

  • No badge: No unread notifications
  • Number badge: Shows count of unread (max shows "9+")
  • Red dot: New notification arrived (pulses briefly)

Comments (Coming Soon)​

Purpose​

Discuss requirements with team members, ask questions, and document decisions.

Features​

Comment Threads:

  • Add comments to any requirement
  • Reply to comments (nested threads)
  • Edit your own comments
  • Delete your own comments (admin can delete any)

@Mentions:

  • Type @ to see team member autocomplete
  • Mention multiple users in one comment
  • Mentioned users receive notifications

Rich Text:

  • Bold, italic, code formatting
  • Bulleted and numbered lists
  • Links to other requirements

Attachments (Future):

  • Attach images, documents
  • Inline image preview
  • File size limits apply

How to Use (When Available)​

  1. View comments:

    • Select a requirement
    • Comments appear in right panel
    • Sorted by newest first (or thread order)

  2. Add comment:

    • Click "Add Comment" button
    • Type comment (Markdown supported)
    • Use @ to mention team members
    • Click "Post Comment"

  3. Reply to comment:

    • Click "Reply" under comment
    • Type reply
    • Click "Post Reply"

  4. Edit comment:

    • Click "Edit" (three dots menu)
    • Modify text
    • Click "Save"
    • Shows "edited" indicator

  5. Delete comment:

    • Click "Delete" (three dots menu)
    • Confirm deletion
    • Comment removed (or marked as deleted if replies exist)

Comment Best Practices​

When to Comment:

  • Clarify requirement ambiguity
  • Document design decisions
  • Request review or approval
  • Report issues or concerns

Comment Etiquette:

  • Be clear and concise
  • @Mention relevant stakeholders
  • Provide context for future readers
  • Resolve discussions when complete

Team Management (Coming Soon)​

Purpose​

Add team members to projects, assign roles, and manage permissions.

Team Roles​

Viewer:

  • View requirements and FMEA
  • View comments (cannot post)
  • View analytics and reports
  • No edit permissions

Editor:

  • All viewer permissions
  • Create/edit/delete requirements
  • Create/edit FMEA items
  • Post comments
  • Cannot manage team

Admin:

  • All editor permissions
  • Add/remove team members
  • Change user roles
  • Delete project

Project Owner:

  • All admin permissions
  • Transfer ownership
  • Cannot be removed from project

How to Use (When Available)​

  1. View team members:

    • Go to Project Settings
    • Click "Team" tab
    • See list of members with roles

  2. Add team member:

    • Click "Add Member" button
    • Enter email address
    • Select role (Viewer/Editor/Admin)
    • Click "Send Invitation"
    • User receives email with access link

  3. Change role:

    • Find user in team list
    • Click role dropdown
    • Select new role
    • Permissions update immediately

  4. Remove team member:

    • Find user in team list
    • Click "Remove" button
    • Confirm removal
    • User loses project access

Assignment Tracking (Coming Soon)​

Purpose​

Assign requirements and action items to team members for implementation.

Assignment Types​

Requirement Assignments:

  • Assign requirements for implementation
  • Track who's working on what
  • See assignments in your dashboard

FMEA Action Items:

  • Assign mitigation actions
  • Set due dates
  • Track completion status

Compliance Issues:

  • Assign compliance gaps for resolution
  • Track remediation progress
  • Link to specific requirements

How to Use (When Available)​

  1. Assign requirement:

    • Select requirement
    • Click "Assign" button
    • Select team member
    • (Optional) Add due date and notes
    • Click "Assign"

  2. View your assignments:

    • Click "My Assignments" in nav
    • See list of assigned items
    • Filter by status, due date, project
    • Click to navigate to item

  3. Mark assignment complete:

    • Navigate to assigned item
    • Complete the work
    • Click "Mark Complete"
    • Notifies assigner

Best Practices​

Activity Feed​

  • Check activity feed daily to stay informed
  • Use filters to focus on relevant changes
  • Click through to review critical changes
  • Export activity feed for status reports

Notifications​

  • Respond to @mentions promptly
  • Acknowledge assignments
  • Enable important notification types
  • Disable noise (low-priority notifications)

Comments (When Available)​

  • Use comments for discussions, not requirements text
  • Resolve comment threads when decisions are made
  • @Mention decision makers for visibility
  • Keep comments professional and constructive

Team Collaboration​

  • Add team members early in project
  • Assign appropriate roles (least privilege)
  • Use assignments to clarify ownership
  • Review team activity regularly

Troubleshooting​

"Activity feed shows no activities"​

Cause: New project with no changes yet Solution: As you create/edit requirements, activities will appear

"Notifications not appearing"​

Status: Notification bell exists, backend integration in progress Workaround: Check activity feed for updates

"Can't @mention users"​

Status: Comments feature not yet integrated Workaround: Use activity feed to track changes manually

"Activity feed not updating in real-time"​

Solution: Refresh page manually, auto-refresh coming soon

Status​

FeatureBackendFrontendAvailable
Activity Feed✅⚠️Partial
Notifications✅✅Yes
Comments✅❌Not integrated
@Mentions✅❌Not integrated
Team Management✅❌Not integrated
Assignments✅❌Not integrated

⚠️ = Backend ready, frontend integration in progress ❌ = Backend ready, not yet integrated into UI