At the heart of TeamPulse for SuiteCRM is the Discipline Score – a single, dynamic metric (0-100) that quantifies process adherence. This engine answers the critical question: “Is this rep doing the right things?”
While traditional CRM reporting focuses on revenue – a lagging indicator – the Discipline Score tracks behavior as a leading indicator. By diagnosing behavioral breakdowns before they impact the pipeline, sales managers can intervene early. The Discipline Score transforms raw SuiteCRM activity into a structured diagnostic tool, solving the pain point of “invisible” performance declines that occur weeks before a quota miss.
Detailed Breakdown: The “What”
The final discipline score is a weighted average of five factor scores. Each factor is calculated independently on the server side using raw activity counts from the SuiteCRM database, normalized against configurable targets to ensure a “busy” rep cannot mask poor hygiene.
The Five Discipline Factors
| Component | Weight | SuiteCRM Source | What It Measures |
|---|---|---|---|
| Follow-up Consistency | 25% | Opportunities / Tasks | Speed of response to leads and deals; whether activities are logged promptly after meetings. |
| Task Completion Ratio | 20% | Tasks Module | The ratio of tasks completed on time versus those that have gone overdue. |
| CRM Update Frequency | 15% | User / Record Audit | Recency of user login and frequency of record modifications and notes. |
| Deal Hygiene Quality | 20% | Opportunities | Percentage of open deals with future steps, valid close dates, and non-stagnant stages. |
| Activity Continuity | 20% | Calls + Meetings | Daily cadence of effort; identifies multi-day gaps in CRM engagement. |
Score Interpretation Bands
- 90-100 (Exceptional): Model behavior; top process discipline.
- 70-89 (Standard/Strong): Strong performance with minor optimization opportunities.
- 50-69 (Needs Coaching): Visible process breakdown requiring intervention.
- 0-49 (Critical): Immediate intervention required to prevent pipeline decay.
Technical Engine Details
The ScoringEngine.php processes live data into these scores. To prevent data decay, scores include a daily decay component if no new activity is logged. Each component is capped at 100% to ensure a balanced assessment of a rep’s professional discipline.
[Image Placeholder: Discipline Score five-factor breakdown rings in the TeamPulse Member Drill view]
How to Use It: The “How”
Managers and Administrators can view and analyze these scores through several primary interfaces:
- Accessing the Rules: Navigate to Settings > Scoring Rules to view the current weights and factor definitions. In v0.9.9, weights are displayed as read-only progress bars based on field-validated benchmarks. Custom weight configuration via interactive sliders is planned for version 1.0.
- Monitoring the Team: On the Team Dashboard, use the Member Tiles to see aggregate scores at a glance. Tiles are color-coded: Green (>=75), Amber (50-74), and Red (<50).
- Individual Drills: Click any member tile to open the Member Drill view. This provides a deep dive into the five factors, showing specific sub-rings for each component and an 8-week trajectory chart.
- Side-by-Side Comparison: Use the Compare view to select two reps. The radar chart highlights “factor gaps,” showing exactly where a top performer’s discipline differs from a struggling peer.
[Image Placeholder: TeamPulse Team Dashboard showing color-coded member tiles with Discipline Scores]
Next Steps / Decisions
After analyzing the Discipline Score, a manager should take the following proactive steps:
- Send a Coaching Note: If a rep has high activity volume but a low Deal Hygiene score, send a coaching note via the Actions tool to address pipeline rot.
- Schedule a 1:1 Intervention: For any rep in the Critical band (0-49), use the Recommendations Engine to identify the weakest factor and schedule an immediate intervention.
- Public Recognition: Identify Exceptional Performers (90-100) on the Leaderboard and acknowledge their process discipline in team meetings to set a benchmark for others.
- Adjust Thresholds: If the entire team is flagging for stalled deals, navigate to Settings > Thresholds to adjust the sensitivity of the hygiene rules.
Troubleshooting / FAQ
Q: Why does my rep’s score seem lower than expected?
The score reflects disciplined CRM usage, not just “being busy.” A rep may have high call volume but fail in Deal Hygiene (no next steps) or Task Completion (overdue tasks). Review the five-factor breakdown in the Member Drill view to identify the specific gap.
Q: Can I change the scoring weights?
In the current version (v0.9.9), weights are displayed as read-only progress bars based on field-validated benchmarks. Custom weight configuration using interactive sliders is a planned feature for version 1.0.
Q: How often is the Discipline Score updated?
TeamPulse automatically refreshes data every 5 minutes. You can also trigger a manual refresh using the icon in the Topbar. Additionally, a SuiteCRM scheduler runs every 30 minutes to refresh the AI cache and aggregate signals.