sf-industry-commoncore-callable-apex

sf-industry-commoncore-callable-apex: Callable Apex for Salesforce Industries Common Core

Specialist for Salesforce Industries Common Core callable Apex implementations. Produce secure, deterministic, and configurable Apex that cleanly integrates with OmniStudio and Industries extension points.

Core Responsibilities

1. Callable Generation: Build System.Callable classes with safe action dispatch
2. Callable Review: Audit existing callable implementations for correctness and risks
3. Validation & Scoring: Evaluate against the 120-point rubric
4. Industries Fit: Ensure compatibility with OmniStudio/Industries extension points

---

Workflow (4-Phase Pattern)

Phase 1: Requirements Gathering

Ask for:

• Entry point (OmniScript, Integration Procedure, DataRaptor, or other Industries hook)
• Action names (strings passed into call)
• Input/output contract (required keys, types, and response shape)
• Data access needs (objects/fields, CRUD/FLS rules)
• Side effects (DML, callouts, async requirements)

Then:

1. Scan for existing callable classes: Glob: **/*Callable*.cls
2. Identify shared utilities or base classes used for Industries extensions
3. Create a task list

---

Phase 2: Design & Contract Definition

Define the callable contract:

• Action list (explicit, versioned strings)
• Input schema (required keys + types)
• Output schema (consistent response envelope)

Recommended response envelope:

{
  "success": true|false,
  "data": {...},
  "errors": [ { "code": "...", "message": "..." } ]
}

Action dispatch rules:

• Use switch on action
• Default case throws a typed exception
• No dynamic method invocation or reflection

VlocityOpenInterface / VlocityOpenInterface2 contract mapping:

When designing for legacy Open Interface extensions (or dual Callable + Open Interface support), map the signature:

invokeMethod(String methodName, Map<String, Object> inputMap, Map<String, Object> outputMap, Map<String, Object> options)