Team Collaboration (Project Management Context)

Overview #

Team collaboration within Corcava’s project management system focuses on specific tools and features that enable effective teamwork on projects, boards, and tasks. This includes user assignment systems, task-level communication, visibility controls, and team coordination features that are integrated directly into the project workflow.

Understanding these collaboration features will help your team work together more effectively within the project management context.

User Assignment – Assigning Team Members to Tasks #

Task User Assignment System #

How User Assignment Works:

The system uses a simple but effective user assignment model where team members can be assigned to specific tasks.

Assignment System:

• User-Task Connection – Simple connection between users and tasks
• Single Assignment Operation – Users can be assigned or unassigned from tasks
• Toggle Behavior – Assignment system works as a toggle (assign/unassign)
• Notification Integration – Assigned users receive automatic notifications

Assignment Process #

How to Assign Users to Tasks:

1. Open Task Details – Click on task to open task modal 2. Access Assignment Interface – Find user assignment section in task sidebar 3. Select Team Member – Choose from dropdown list of available team members 4. Toggle Assignment – Click to assign or unassign user from task 5. Automatic Notification – Assigned user receives TaskAssignedNotification

Assignment Interface Features:

• User Dropdown – List of available team members with profile photos
• Visual Indicators – Checkmarks show currently assigned users
• Profile Photos – User avatars for easy identification
• Toggle Functionality – Click to assign/unassign users
• Real-time Updates – Assignment changes reflected immediately

Assignment Display and Visibility #

Task Card Display:

• Assigned User Avatars – Profile photos displayed on task cards
• Multiple User Support – Multiple assigned users shown with scrollable interface
• Overflow Handling – Clean display even with many assigned users
• Visual Recognition – Quick identification of who’s working on what

Assignment Tracking:

• Activity Events – User assignments tracked in task event system
• Event Types – TYPE_USER_ATTACH_TO_TASK and TYPE_USER_DETACH_TO_TASK
• Change History – Complete record of assignment changes
• User Attribution – Track who made assignment changes

Assignment Benefits #

✅ Clear Ownership – Visual indication of who is responsible for each task ✅ Team Coordination – Easy identification of team member workloads ✅ Notification System – Automatic alerts when assigned to new tasks ✅ Activity Tracking – Complete history of assignment changes ✅ Visual Organization – Profile photos make task ownership immediately clear

---

Collaboration Tools – Task-Level Communication #

Task Comment System #

Real-time Task Discussions:

Each task includes a dedicated comment system for team communication and collaboration.

Comment Features:

• Multi-line Text Input – Textarea for detailed comments and discussions
• User Attribution – Every comment shows author name and profile photo
• Timestamp Display – Formatted date and time for each comment
• Real-time Updates – Comments appear immediately for all team members
• Comment Deletion – Authors can delete their own comments

Comment Interface:

• Simple Form – Textarea with “Add Comment” button
• Required Input – Comments must contain text to be submitted
• Visual Design – Clean, professional comment display
• User Photos – Profile images for visual user identification
• Responsive Layout – Works well on desktop and mobile devices

Communication Workflow #

Adding Comments:

1. Open Task Modal – Click on any task to open details 2. Navigate to Comments – Scroll to comments section 3. Enter Comment Text – Type message in textarea 4. Submit Comment – Click “Add Comment” button 5. Immediate Display – Comment appears instantly in task timeline

Comment Management:

• View Comments – All comments displayed in chronological order
• Delete Own Comments – Users can delete comments they created
• Comment History – Complete record of all task discussions
• Activity Integration – Comments tracked as TYPE_COMMENT events

Communication Benefits #

✅ Contextual Discussions – Comments stay with specific tasks for relevant context ✅ Team Coordination – Centralized communication about specific work items ✅ Historical Record – Complete discussion history for future reference ✅ Real-time Collaboration – Immediate communication between team members ✅ Professional Documentation – Clean communication record for client visibility

---

Visibility Controls – Permission-Based Access #

Role-Based Task Access #

Permission System Analysis:

Based on code analysis, the system implements comprehensive role-based access control for tasks and project boards.

Task Permissions by Role:
Users with ShowAllAndOwnTaskCRUD (Admins/Managers):

• ✅ View Tasks – Can see all team tasks
• ✅ Create Tasks – Can create tasks on any project
• ✅ Update Tasks – Can modify any task details
• ✅ Delete Tasks – Can delete tasks
• ✅ Assign Users – Can assign team members to tasks
• ✅ Add Comments – Can comment on all tasks

Regular Users:

• ✅ View Tasks – Can see tasks on their assigned projects
• ✅ Create Tasks – Can create tasks on assigned projects
• ✅ Update Tasks – Can modify tasks on assigned projects
• ✅ Assign Users – Can assign users to tasks
• ✅ Add Comments – Can comment on accessible tasks
• ❌ Limited Scope – Only tasks on assigned projects

Project Viewers:

• ✅ View Tasks – Can see tasks on assigned projects
• ✅ Create Tasks – Can create tasks if assigned to project
• ✅ Update Tasks – Can modify tasks on assigned projects
• ✅ Assign Users – Can assign users to tasks
• ✅ Add Comments – Can comment on accessible tasks

Viewer Managers:

• ✅ Enhanced Viewer – All viewer permissions plus management capabilities
• ✅ Project Management – Can manage boards and tasks on assigned projects
• ✅ Team Coordination – Can assign and coordinate team members
• ✅ Full Collaboration – Can participate fully in assigned projects

Project-Level Visibility #

Project Assignment Control:

• Project Users Table – Explicit assignment of users to projects
• Board Access – Board visibility based on project assignment
• Task Visibility – Task access follows project assignment
• Team Isolation – Users only see tasks from their team

Visibility Rules:

• Team Membership – Must be member of same team to see tasks
• Project Assignment – Must be assigned to project to access tasks
• Permission Validation – All actions validated against user permissions
• Secure Access – Multiple layers of permission checking

Access Control Benefits #

✅ Secure Collaboration – Team members only see relevant work ✅ Project Isolation – Clear separation between different projects ✅ Role-Appropriate Access – Permissions match user responsibilities ✅ Flexible Assignment – Easy to add/remove users from projects ✅ Client Security – Client users have controlled, appropriate access

---

Team Communication Features #

Task-Specific Communication #

Comment System:

Based on code analysis, the primary team communication tool is the task comment system:

Comment Features:

• Task-Focused – Comments attached directly to specific tasks
• User Attribution – Profile photos and names for all comments
• Timestamp Display – Formatted date and time information
• Delete Capability – Users can delete their own comments
• Activity Integration – Comments tracked as task events

Communication Workflow:

• Contextual Discussions – Conversations happen within relevant tasks
• Team Visibility – All assigned team members see task comments
• Historical Preservation – Comments preserved as part of task history
• Professional Format – Clean, organized comment display

Activity-Based Communication #

Automatic Activity Updates:

The system provides automatic communication through activity tracking:

Activity Types Communicated:

• Task Creation – “User added this card to Column”
• Column Changes – “User moved this card from Column A to Column B”
• User Assignments – “User added/removed Member to/from this card”
• Description Changes – “User changed description to this card”
• Comments – Direct user comments and discussions

Communication Benefits:

• Automatic Updates – Team sees changes without manual communication
• Complete Context – Activity log provides full communication history
• User Attribution – Clear identification of who did what
• Real-time Awareness – Team stays informed of all changes

---

Getting Started with Team Collaboration #

Quick Start Guide #

Step 1: Assign Team Members to Tasks

1. Open any task by clicking on task card 2. Look for user assignment section in task sidebar 3. Click dropdown to see available team members 4. Click on team member to assign them to task 5. Verify assignment appears on task card

Step 2: Use Task Comments

1. Open task details modal 2. Scroll to comments section 3. Type a comment in the textarea 4. Click “Add Comment” to post 5. See comment appear immediately with your profile photo

Step 3: Monitor Task Activity

1. Review task event timeline to see all activities 2. Notice automatic events for task changes 3. See how user assignments appear in activity log 4. Understand how comments integrate with activity timeline

Team Collaboration Best Practices #

✅ Clear Assignment – Assign tasks to specific team members for accountability ✅ Active Communication – Use comments to discuss task details and questions ✅ Regular Updates – Provide status updates through comments ✅ Professional Tone – Maintain professional language in all communications ✅ Context Awareness – Keep discussions focused on specific task context

Collaboration Patterns #

Daily Workflow:

• Task Assignment – Assign daily tasks to appropriate team members
• Progress Comments – Team members provide updates through comments
• Question Resolution – Use comments to ask and answer questions
• Activity Monitoring – Review activity timeline for team coordination

Project Coordination:

• Work Distribution – Assign tasks based on team member skills and availability
• Communication Flow – Use task comments for work-specific discussions
• Progress Tracking – Monitor team progress through task assignments and activity
• Issue Resolution – Use comments to discuss and resolve blockers

---

Troubleshooting Collaboration Issues #

Assignment Problems #

Cannot Assign Users:

• Permission Check – Verify you have task assignment permissions
• Project Access – Ensure target user is assigned to the project
• Team Membership – Confirm user is member of the same team
• Task Access – Verify you can edit the specific task

Assignments Not Showing:

• Browser Refresh – Reload page to see latest assignments
• Permission Issues – Check if you have permission to see task details
• Network Problems – Verify internet connection stability

Communication Issues #

Comments Not Appearing:

• Permission Verification – Ensure you have comment access rights
• Browser Refresh – Reload page to see latest comments
• Network Connectivity – Check internet connection
• Task Access – Verify access to specific task

Cannot Add Comments:

• Permission Check – Verify you have comment permissions for the task
• Text Requirement – Ensure comment contains text (required field)
• Task Assignment – Confirm you have access to the task
• Browser Issues – Try refreshing page or different browser

---

Next Steps #

Now that you understand team collaboration in project management context, you’re ready to explore:

• [Automation & Integration](automation-integration.md) – Automated workflows and external integrations
• [Filtering & Search](filtering-search.md) – Find and organize tasks efficiently
• [Archive & History Management](archive-history.md) – Manage completed work and historical data
• [Permissions & Access Control](permissions-access.md) – Detailed permission system management

Remember: Team collaboration in project management is built around task-focused communication and clear user assignments. The system provides simple but effective tools for team coordination while maintaining appropriate access controls and activity tracking.