---

1. Module Overview (Technical)

What Are Feature Categories?

Feature Categories organize feature codes into logical groups that can be assigned to Class of Service. This provides a layer of abstraction between individual feature codes and CoS permissions, making it easier to manage feature access across the organization.

Architecture

Plaintext

┌─────────────────────────────────────────────────────────────────┐
│              Feature Categories System                          │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  ┌─────────────────────┐    ┌─────────────────────┐            │
│  │   Feature Codes     │    │  Feature Categories  │            │
│  ├─────────────────────┤    ├─────────────────────┤            │
│  │ *67 - Block CallerID│───▶│                     │            │
│  │ *69 - Call Return   │───▶│  "Basic Features"   │            │
│  │ *70 - Disable CW    │───▶│                     │            │
│  └─────────────────────┘    └─────────────────────┘            │
│                                      │                          │
│  ┌─────────────────────┐             │                          │
│  │ *72 - CF Activate   │───▶         ▼                          │
│  │ *73 - CF Deactivate │───▶  ┌─────────────────────┐          │
│  │ *74 - CFB Activate  │───▶  │ "Advanced Features" │          │
│  │ *92 - DND Toggle    │───▶  └─────────────────────┘          │
│  └─────────────────────┘             │                          │
│                                      │                          │
│                                      ▼                          │
│                            ┌─────────────────────┐              │
│                            │  Class of Service   │              │
│                            ├─────────────────────┤              │
│                            │ "Standard Employee" │              │
│                            │  └─ Basic Features  │              │
│                            │                     │              │
│                            │ "Manager"           │              │
│                            │  └─ Basic Features  │              │
│                            │  └─ Advanced Features│              │
│                            └─────────────────────┘              │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

Key Tables

Table	Purpose
`public.feature_code_categories`	Category definitions
`public.feature_code_cos_members`	Feature code memberships
`public.feature_code_numbers`	Individual feature codes
`public.class_of_services`	References category via `feature_code_cos_id`

Key Files

File	Description
`admin/apps/web/src/modules/featureCategories/`	Frontend module
`admin/apps/web/src/i18n/en/featureCategories.json`	Translations

---

2. Module Overview (Commercial/Business)

Business Value

Feature Categories simplify feature access management:

Without Feature Categories	With Feature Categories
Assign features individually	Assign groups of features
Repetitive per-CoS config	Reusable categories
Hard to track permissions	Clear groupings
Changes require per-CoS edits	Update category once

Use Cases

Basic vs. Advanced Features

- Basic: Call return, DND, call waiting

- Advanced: Call forwarding, conferencing

Role-Based Access

- Receptionist: All call handling features

- Executive: All features including spy modes

Tiered Service

- Bronze: Basic features

- Silver: Basic + forwarding

- Gold: All features

Feature Highlights

Feature	Benefit
Grouping	Organize related feature codes
Reusability	Assign same category to multiple CoS
Shuttle Control	Easy feature selection UI
Enable/Disable	Toggle category without deletion

---

3. Module Overview (End User/Administrator)

What Can You Do?

Create categories grouping related feature codes
Assign/remove feature codes to categories
Enable/disable categories
Assign categories to Class of Service

Administrator Workflow

Plaintext

┌─────────────────────────────────────────────────────────────────┐
│              Creating a Feature Category                        │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  Step 1: Basic Information                                      │
│  ├─ Name: "Basic Features"                                     │
│  ├─ Description: "Standard calling features for all users"    │
│  └─ Enabled: ✓                                                 │
│                                                                 │
│  Step 2: Select Feature Codes                                   │
│                                                                 │
│  ┌─────────────────────────────────────────────────────────┐    │
│  │  Available Features     │     Enabled Features         │    │
│  │ ┌─────────────────────┐ │   ┌─────────────────────┐    │    │
│  │ │ *72 CF Activate     │ │   │ *67 Block Caller ID │    │    │
│  │ │ *73 CF Deactivate   │──▶  │ *69 Call Return     │    │    │
│  │ │ *74 CFB Activate    │ │   │ *70 Disable CW      │    │    │
│  │ │ ...                 │ │   │ *92 DND Toggle      │    │    │
│  │ └─────────────────────┘ │   └─────────────────────┘    │    │
│  └─────────────────────────────────────────────────────────┘    │
│                                                                 │
│  Step 3: Save                                                   │
│                                                                 │
│  Step 4: Assign to Class of Service                             │
│  └─ Edit CoS → Select Feature Category: "Basic Features"      │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

Quick Tips

TIP

Logical Grouping: Group features by function (call handling, forwarding, voicemail).

TIP

Meaningful Names: Use descriptive names like "Executive Features" or "Reception Desk".

---

4. Configuration Fields Reference

Category Fields

Field	Description	Example	Required
Name	Category identifier	`Basic Features`	Yes
Description	Purpose notes	`Standard for all users`	No
Enabled	Category active status	On/Off	Yes

Feature Assignment

The shuttle control allows moving feature codes between:

Available Features: Codes not in this category
Enabled Features: Codes assigned to this category

---

5. Common Scenarios & Examples

Scenario 1: Tiered Feature Access

Categories:

Category	Features
Basic	67, 69, 70, 92 (Caller ID, Call Return, CW, DND)
Call Forwarding	72, 73, 74, 75 (CF features)
Advanced	80, 82, 83 (Conferencing, Spy modes)

CoS Assignments:

CoS	Categories
Bronze	Basic
Silver	Basic, Call Forwarding
Gold	Basic, Call Forwarding, Advanced

Scenario 2: Department-Specific Features

Categories:

Category	Features
Reception Desk	All call handling, parking, paging
Sales Team	Call recording, conferencing
Support Team	Call queues, callback features

Scenario 3: Security Levels

Categories:

Category	Features
Standard	Basic calling features
Supervisor	+ Spy modes, barge-in
Admin	+ All system features

---

6. Limitations & Important Notes

Technical Limitations

WARNING

Category Assignment: Each CoS can only have one feature category assigned.

WARNING

Cascading Changes: Modifying a category affects all CoS using it.

Best Practices

Plan Categories: Design categories before creating
Document Purpose: Use descriptions
Test Changes: Verify after category modifications
Minimize Overlap: Avoid duplicate features across categories

---

7. Troubleshooting Tips

Common Issues

Symptom	Possible Cause	Solution
Feature not working	Not in assigned category	Add to category
Category not visible	Category disabled	Enable category
Changes not applied	CoS not updated	Verify CoS assignment

Diagnostic SQL

List categories:

Sql

SELECT id, name, enabled,
       (SELECT COUNT(*) FROM public.feature_code_cos_members 
        WHERE cos_id = c.id) as feature_count
FROM public.feature_code_categories c
WHERE domain_id = [domain_id];

Check category features:

Sql

SELECT f.default_number, f.name
FROM public.feature_code_cos_members m
JOIN public.feature_code_numbers f ON m.feature_code_id = f.id
WHERE m.cos_id = [category_id]
ORDER BY f.default_number;

---

8. Glossary

Term	Definition
Feature Category	Grouping of related feature codes
Feature Code	Dialpad code for PBX features (67, 72, etc.)
Class of Service	Permission profile assigned to extensions
Shuttle Control	UI for moving items between lists

---

Lua Handler Status

⚡ No Dedicated Handler Required

Feature Categories is a configuration module. Categories are used to organize feature codes for Class of Service assignment. The individual feature codes have their own handlers; the category provides organizational structure only.

---

Documentation last updated: January 2026*

Feature Categories Module Documentation

Table of Contents

1. Module Overview (Technical)

What Are Feature Categories?

Architecture

Key Tables

Key Files

2. Module Overview (Commercial/Business)

Business Value

Use Cases

Feature Highlights

3. Module Overview (End User/Administrator)

What Can You Do?

Administrator Workflow

Quick Tips

4. Configuration Fields Reference

Category Fields

Feature Assignment

5. Common Scenarios & Examples

Scenario 1: Tiered Feature Access

Scenario 2: Department-Specific Features

Scenario 3: Security Levels

6. Limitations & Important Notes

Technical Limitations

Best Practices

7. Troubleshooting Tips

Common Issues

Diagnostic SQL

8. Glossary

Lua Handler Status

⚡ No Dedicated Handler Required