Synchronized, efficient, always growing.

Roles and Permissions Guide — ClubSy

Audience: Club director (club_admin) Purpose: Clear reference of what each role can do within the application.

Table of contents

  1. Role overview
  2. Detailed permissions by role
  3. Permissions matrix by category
  4. Quick assignment guide
  5. Permissions glossary

1. Role overview

Role (slug) Display name Description
club_admin Club director Manages club, teams, members, and club events
operations_manager Operations coordinator Manages schedule, call-ups, and operational notifications
team_manager Team delegate Administrative management of squad and logistics
head_coach Head coach Manages team events and call-ups
assistant_coach Assistant coach Supports team events and call-ups
medical_staff Medical staff Manages availability and physical condition
community_manager Community Manager Manages club social media and online community
player Player Participates in call-ups and manages own availability
club_supporter Community member External user who follows clubs/teams in read-only mode

General hierarchy: club_admin > operations_manager / team_manager > head_coach / assistant_coach > medical_staff / community_manager > player > club_supporter

2. Detailed permissions by role

🏛️ Club director (club_admin)

Main club administrator. Has full control over the club and its teams, except for global platform configuration.

Club and teams

Permission Description
Manage club Edit club data
View club Read access to club information
Manage teams Create, edit, and delete teams
View teams Read access to teams

Members and communications

Permission Description
Manage members Invite, assign, and remove members
Manage invitations Create/accept/decline interclub invitations
Publish club communications Publish notices, news, and updates
Send notifications Send notifications to members or rivals
View notices View team/club notifications

Events

Permission Description
Create events Create team/club events
Edit events Modify existing events
Delete events Delete existing events
Call up participants Invite teams, roles, or individuals

Availability and call-ups

Permission Description
View team availability View other members' availability
Update team availability Modify other members' availability
Respond to own call-up Confirm or decline own invitation
Respond for others Confirm or decline on behalf of players
Take attendance Record real attendance live or post-event

Reports

Permission Description
Export reports Export advanced reports
Update own profile Edit own profile

📋 Operations coordinator (operations_manager)

Day-to-day operational management. Can manage teams, members, and schedule, but without access to event deletion or global club configuration.

Permission Description
View club Read access to club information
Manage teams Create, edit, and delete teams
View teams Read access to teams
Manage members Invite, assign, and remove members
Manage invitations Create/accept/decline interclub invitations
Create events Create team/club events
Edit events Modify existing events
Call up participants Invite teams, roles, or individuals
Take attendance Record attendance live or post-event
Publish club communications Publish notices, news, and updates
Send notifications Send notifications to members or rivals
View notices View team/club notifications
View team availability View other members' availability
Respond to own call-up Confirm or decline own invitation
Respond for others Confirm or decline on behalf of players
Update own profile Edit own profile

📁 Team delegate (team_manager)

Logistical and administrative management of the team. No own event management; does manage squad and attendance.

Permission Description
View club Read access to club information
View teams Read access to teams
Manage members Invite, assign, and remove team members
Call up participants Invite teams, roles, or individuals
Take attendance Record attendance live or post-event
View team availability View other members' availability
Update team availability Modify other members' availability
Respond to own call-up Confirm or decline own invitation
Respond for others Confirm or decline on behalf of players
Send notifications Send notifications to members or rivals
View notices View team/club notifications
Update own profile Edit own profile

🎯 Head coach (head_coach)

Technical control of events and call-ups. Creates and manages team events, but cannot manage members or club configuration.

Permission Description
View club Read access to club information
View teams Read access to teams
Create events Create team/club events
Edit events Modify existing events
Call up participants Invite teams, roles, or individuals
Take attendance Record attendance live or post-event
View team availability View other members' availability
Respond to own call-up Confirm or decline own invitation
Respond for others Confirm or decline on behalf of players
View notices View team/club notifications
Update own profile Edit own profile

🤝 Assistant coach (assistant_coach)

Coach support. Same permissions as the head coach, except they cannot delete events.

Permission Description
View club Read access to club information
View teams Read access to teams
Create events Create team/club events
Edit events Modify existing events
Call up participants Invite teams, roles, or individuals
Take attendance Record attendance live or post-event
View team availability View other members' availability
Respond to own call-up Confirm or decline own invitation
Respond for others Confirm or decline on behalf of players
View notices View team/club notifications
Update own profile Edit own profile

Difference from Head coach: same permissions. Usually distinguished by organizational context.

🏥 Medical staff (medical_staff)

Focus on availability and physical condition. Can consult and update the availability of all members, but does not create or manage events.

Permission Description
View club Read access to club information
View teams Read access to teams
View team availability View other members' availability
Update team availability Modify other members' availability
Respond to own call-up Confirm or decline own invitation
Update own profile Edit own profile

📢 Community Manager (community_manager)

External communication management. Can only publish content and send notifications; no access to sports management.

Permission Description
View club Read access to club information
Publish club communications Publish notices, news, and updates
Send notifications Send notifications to members or rivals
View notices View team/club notifications
Update own profile Edit own profile

⚽ Player (player)

Base participant role. Manages only own availability and responds to own call-ups.

Permission Description
View club Read access to club information
View teams Read access to teams
Update own availability Record own availability
Respond to own call-up Confirm or decline own invitation
Update own profile Edit own profile

👁️ Community member (club_supporter)

External user or follower. Read-only access to public club content.

Permission Description
Follow clubs/teams Follow and unfollow clubs and teams
View public calendar Read the public calendar of followed clubs/teams
View public gallery Consume public multimedia content from the club
View community notices Read publicly visible notices and news
Receive community notifications Receive segmented notifications from followed clubs
Manage community profile Update community profile and preferences

3. Permissions matrix by category

Legend: ✅ Has permission · ❌ Does not have permission

Global administration

Permission club_admin operations_mgr team_mgr head_coach asst_coach medical comm_mgr player supporter
Manage roles ✅ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌
Manage permissions ✅ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌
Assign roles ✅ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌
Read audit ✅ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌
Export reports ✅ ✅ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌

Club and teams

Permission club_admin operations_mgr team_mgr head_coach asst_coach medical comm_mgr player supporter
Manage club ✅ ✅ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌
View club ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ❌
Manage teams ✅ ✅ ✅ ❌ ❌ ❌ ❌ ❌ ❌ ❌
View teams ✅ ✅ ✅ ✅ ✅ ✅ ✅ ❌ ✅ ❌

Members and invitations

Permission club_admin operations_mgr team_mgr head_coach asst_coach medical comm_mgr player supporter
Manage members ✅ ✅ ✅ ✅ ❌ ❌ ❌ ❌ ❌ ❌
Manage interclub invitations ✅ ✅ ✅ ❌ ❌ ❌ ❌ ❌ ❌ ❌

Events

Permission club_admin operations_mgr team_mgr head_coach asst_coach medical comm_mgr player supporter
Create events ✅ ✅ ✅ ❌ ✅ ✅ ❌ ❌ ❌ ❌
Edit events ✅ ✅ ✅ ❌ ✅ ✅ ❌ ❌ ❌ ❌
Delete events ✅ ✅ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌
Call up participants ✅ ✅ ✅ ✅ ✅ ✅ ❌ ❌ ❌ ❌

Availability and call-ups

Permission club_admin operations_mgr team_mgr head_coach asst_coach medical comm_mgr player supporter
Update own availability ✅ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ✅ ❌
View team availability ✅ ✅ ✅ ✅ ✅ ✅ ✅ ❌ ❌ ❌
Update team availability ✅ ✅ ❌ ✅ ❌ ❌ ✅ ❌ ❌ ❌
Take attendance ✅ ✅ ✅ ✅ ✅ ✅ ❌ ❌ ❌ ❌
Respond to own call-up ✅ ✅ ✅ ✅ ✅ ✅ ✅ ❌ ✅ ❌
Respond for others ✅ ✅ ✅ ✅ ✅ ✅ ❌ ❌ ❌ ❌

Communications and notifications

Permission club_admin operations_mgr team_mgr head_coach asst_coach medical comm_mgr player supporter
Publish club communications ❌ ✅ ✅ ❌ ❌ ❌ ❌ ✅ ❌ ❌
Send notifications ✅ ✅ ✅ ✅ ❌ ❌ ❌ ✅ ❌ ❌
View notices ✅ ✅ ✅ ✅ ✅ ✅ ❌ ✅ ❌ ❌

4. Quick assignment guide

Use this guide to decide which role to assign to each person in your organization:

Situation Recommended role
Person who administers the entire platform and configures roles
Club director or president club_admin
Schedule, logistics, and communications coordinator operations_manager
Team delegate or technical secretary team_manager
Head coach who creates and manages matches/training sessions head_coach
Second coach or fitness trainer with support permissions assistant_coach
Physiotherapist or doctor who manages absences and availability medical_staff
Social media or club communications manager community_manager
Squad player player
Fan, family member, or external follower club_supporter

Warnings for the administrator

⚠️ Only club_admin can delete events. Assign these roles carefully.

⚠️ Only authorized staff can manage roles and permissions globally. Do not assign this role to operational staff.

⚠️ club_supporter is the only role without access to internal club data. Use it for external audiences.

⚠️ medical_staff can modify the availability of any team member. Make sure to assign it only to authorized medical personnel.

5. Permissions glossary

Permission slug Display name Full description
attendance.take Take attendance Record actual attendance of called-up members (live or post-event)
audit.read Read audit View audit logs
availability.read_all View team availability View other members' availability
availability.update_all Update team availability Update other members' availability
availability.update_self Update own availability Update personal availability
callups.respond_others Respond for others Confirm or decline on behalf of team players
callups.respond_self Respond to own call-up Confirm or decline own invitation
club.manage Manage club Edit club data
club.view View club Read access to club information
communications.publish_club Publish club communications Publish notices/news/updates for club members
community.follow_entities Follow clubs/teams Allows following and unfollowing clubs and teams
community.manage_profile Manage community profile Allows updating community profile and preferences
community.read_calendar_public View public calendar Allows reading the public calendar of followed clubs/teams
community.read_gallery_public View public gallery Allows consuming public multimedia content from the club
community.read_notices View community notices Allows reading publicly visible community notices/news
community.receive_notifications Receive community notifications Allows receiving segmented notifications from followed clubs/teams
events.create Create events Create team/club events
events.delete Delete events Delete existing events
events.invite Call up participants Invite teams/roles/individuals
events.update Edit events Edit existing events
invitations.manage Manage invitations Create/accept/decline interclub invitations
members.manage Manage members Invite, assign, and remove members
notifications.send Send notifications Send notifications to members or rivals
notifications.view_notices View notices View team/club notifications
permissions.manage_global Manage permissions Create/edit/delete global permissions
profile.update_self Update own profile Edit own profile
reports.export Export reports Export advanced reports
roles.manage_global Manage roles Create/edit/delete global roles
team.manage Manage teams Create/edit/delete teams
team.view View teams Read access to teams
users.assign_roles_global Assign roles Assign or revoke roles to users

Document generated from supabase_info/roles_with_permissions.json · ClubSy v1.0

Navigation