The Challenge

Every Salesforce engagement begins the same way: establishing a current-state baseline. For most consultancies, that means manually navigating Setup — reviewing active and inactive Flows, checking Apex test coverage in the Developer Console, auditing Permission Sets and Profiles, scanning for legacy Workflow Rules and Process Builders, and piecing together org limit consumption from the Company Information page and Storage Usage reports.

CRM Infusion faced this reality on every new engagement. As the practice grew, the pre-engagement org review became a bottleneck — time-intensive, inconsistent across consultants, and impossible to standardize into a repeatable methodology. There was no standardized diagnostic framework — each engagement started from zero. Setup navigation overhead consumed 2–3 hours before a single line of work could be scoped or a Statement of Work drafted. Without a timestamped, documented snapshot of the org at engagement start, proving the measurable impact of remediation work was difficult. And translating raw Salesforce metadata findings into business-level language that a non-technical stakeholder could understand required significant translation effort on every engagement.

CRM Infusion needed a way to run a consistent, fast, and credible org health diagnostic — built from live Salesforce metadata — without relying on a consultant manually navigating Setup menus and keeping notes in a separate document.

The Solution

CRM Infusion designed and built the Org Health Scorecard — a Lightning Web Component powered by a custom Apex scoring engine and a Visualforce session bridge, deployed as a dedicated internal Lightning App within the firm’s Salesforce org. Consultants open the Org Health tab in the CRM Infusion Tools Lightning App, click Run Analysis, and within seconds receive a complete org assessment across five weighted metadata categories.

The Scorecard does not return a grade and stop. It returns a prioritized Findings list — specific issues surfaced during the metadata analysis, tagged by category and severity (High, Medium, Low), written in language a non-technical stakeholder can act on. Findings sort automatically by severity — High items surface first, giving consultants an immediate triage view without manual prioritization. The Export Findings button copies the full findings list to clipboard in a structured plain-text format, ready to paste directly into a scoping document, Statement of Work, or client-facing email.

Technical Highlights

• OrgHealthService + OrgHealthScorer — Separated by DesignService retrieves via native SOQL and System.OrgLimits.getMap(). Scorer applies weighted category logic and produces a typed ScorecardResult wrapper. Single-responsibility pattern — when the rubric evolves, only OrgHealthScorer changes.
• No HTTP Callouts or External DependenciesAll queries run natively against the org’s own metadata. No Named Credentials for org authentication, no cross-org OAuth, no managed package dependency.
• Visualforce Session BridgeOrgHealthSessionBridge resolves the Lightning Experience platform constraint where UserInfo.getSessionId() returns a restricted UI session token. The VF controller returns a full API-capable session for any future callout-based expansion.
• Modular Architecture for Future ToolsThe second tab in the CRM Infusion Tools Lightning App is already allocated for the Flow Documenter module. The Apex service pattern, Lightning App container, VF session bridge, and deployment pipeline carry forward without modification.