Clans

The clan service provides users with the ability to unite in groups, participate in joint activities, and compete with other clans. This is an important social component of the platform that contributes to user retention and community formation.

Core Concepts

Clan

A clan is a user association with its own hierarchy, resources, and goals. Each clan has:

• Name and tag (short designation)
• Description
• Emblem (logo)
• Leader and member hierarchy
• Rating and level
• Internal resources
• Privacy settings

Clan Member

A clan member is a user who is part of a clan. Each member has:

• Role in the clan (determines access level and capabilities)
• Contribution to clan development
• Join date
• Activity statistics in the clan

Clan Role

Roles define hierarchy and rights distribution within the clan:

• Leader - clan creator or manager, has full access to all functions
• Officer (can be multiple levels) - leader's assistants with extended rights
• Member - regular clan member with basic rights
• Recruit - recently joined participant with limited rights (optional)

Clan Activities

Activities that clans can participate in:

• Clan tasks and goals
• Clan wars and competitions
• Intra-clan events
• Clan achievements

Clan Rating

Clan evaluation system based on their activity and achievements:

• Rating points
• Position in general rating
• Rating change history
• Seasonal ratings

Business Processes

Clan Creation

1. Creation Initiation

   • User selects clan creation option
   • System checks if user meets requirements (level, available resources, etc.)

2. Clan Setup

   • User specifies clan name and tag
   • Uniqueness of name and tag is verified
   • User uploads clan emblem
   • User specifies description and privacy settings

3. Creation Payment

   • If required, user pays for clan creation with in-game resources
   • System deducts resources and creates clan

4. Creation Completion

   • Clan is registered in the system
   • Creator becomes clan leader
   • Clan receives initial settings and resources

Joining a Clan

There are several ways to join a clan:

Joining by Invitation

1. Clan member with appropriate rights sends invitation to user
2. User receives invitation notification
3. User accepts or declines invitation
4. Upon acceptance, user becomes clan member with initial role

Submitting Application to Join

1. User finds clan in list or on clan profile page
2. User submits application to join
3. Authorized clan members review application
4. Application is accepted or declined
5. Upon acceptance, user becomes clan member with initial role

Open Joining

1. For clans with open admission mode
2. User finds clan and clicks "Join" button
3. System automatically adds user to clan with initial role

Clan Management

Member Management

1. Role Changes

   • Leader or officers with appropriate rights can change member roles
   • System checks validity of changes (e.g., regular member cannot promote another to officer)

2. Member Exclusion

   • Authorized clan members can exclude other members
   • Excluded member receives notification
   • Temporary ban on rejoining is imposed (optional)

3. Leadership Transfer

   • Leader can transfer their role to another member
   • Operation confirmation required
   • System changes participant roles

Clan Development

1. Clan Level Increase

   • Clan accumulates experience for member activity
   • Upon reaching threshold value, clan level increases
   • New level unlocks additional capabilities and privileges

2. Clan Improvements

   • Clans can invest resources in various improvements
   • Improvements provide additional bonuses to all clan members
   • System tracks improvement progress and applies effects

Clan Activities

Clan Tasks

1. Receiving Tasks

   • Clan gains access to special clan tasks
   • Tasks can be daily, weekly, or seasonal
   • Tasks require collective efforts of members

2. Task Completion

   • Clan members perform specific actions
   • System sums up each member's contribution
   • Overall task progress is displayed

3. Receiving Rewards

   • After task completion, clan receives rewards
   • Rewards can be distributed among members or added to clan treasury
   • Members receive notifications about clan task completion

Clan Wars

1. War Initiation

   • System automatically matches clans for competition
   • Or clans can challenge each other
   • Rules and war duration are established

2. War Participation

   • Clan members perform specific actions to earn points
   • System tracks and counts points for both clans
   • Current score and time until end are displayed

3. War Completion

   • Winner is determined after time expires
   • Clan with more points wins
   • Winner receives rewards and additional rating points

Intra-Clan Communication

1. Clan Chat

   • Clan members can communicate in general chat
   • Message history is saved
   • Possibility to create thematic channels

2. Clan Announcements

   • Leaders and officers can create important announcements
   • Announcements are displayed in special section
   • Members receive notifications about new announcements

3. Clan Events

   • Planning and announcing intra-clan events
   • Reminder system for upcoming events
   • Ability to mark participation or decline

Integration with Other Services

The clan service is closely integrated with other system components:

• User Service - managing clan membership
• Achievement Service - clan achievements and rewards
• Task Service - special tasks for clans
• Rating Service - calculating and displaying clan ratings
• Notification Service - informing about clan events
• Social Services - integration with Discord and other platforms