The Salesforce-to-EAM Infrastructure Ticketing System is an end-to-end municipal service request platform built on the Salesforce platform. It provides a public-facing intake portal where citizens submit infrastructure issues (potholes, water leaks, signage, etc.), routes those requests to the appropriate departmental queues via Omni-Channel, and synchronizes dispatch and status updates with a backend Enterprise Asset Management (EAM) system through asynchronous Apex integrations. The platform supports photo attachments, interactive map-based location selection, automated email notifications, and a CI/CD pipeline for streamlined deployment. This project is a prototype replacement for the City of Plano's Fix It Plano system.
Live Demo: https://orgfarm-1d35f15b8b-dev-ed.develop.my.site.com/s
For project scope, requirements, and architecture details, please refer to the internal documentation:
You will need a Salesforce Developer Edition Org, Salesforce CLI (SFDX) installed, and Visual Studio Code with the Salesforce Extension Pack.
git clone [https://github.com/darman84/eam-ticketing.git](https://github.com/darman84/eam-ticketing.git)
cd eam-ticketing
sf org login web --set-default
sf project deploy startThis repository is configured with a GitHub Actions CI/CD pipeline. Pushes and pull requests to the main branch automatically trigger code formatting (Prettier), linting (ESLint), and deployment with local Apex test execution to the target Salesforce org.
- Ensure you have configured the
SFDX_AUTH_URLrepository secret in GitHub to enable automated deployments.
- Omni-Channel User Assignment: Create Permission Sets granting access to the
Available - Asset IssuesPresence Status and assign them to your internal Service Console users. (Note: Core metadata including Queues, Queue Routing Configs, Service Channels, and Presence Statuses are automatically deployed via the CI/CD pipeline). - Service Console: Add the custom
Asset Triage DashboardLWC to yourAsset_Issue__cRecord Page layout in the Service Console. - Experience Cloud: Create a "Build Your Own (Aura)" Experience Cloud site. Place the
assetIssueReportercomponent on the home page. - Create a new Standard Page named
Ticket Status(URL slug:ticket-status) and place theassetIssueTrackercomponent on it. - Grant the Site Guest User Apex Class Access to both
AssetIssueFacadeandAssetIssueTrackerController. - Enable "Track Activities" on the
Asset_Issue__cobject in Object Manager. - Set the appropriate time zone on the Experience Cloud site.
- Once activated, your public portal will be available at
https://<your-experience-site-domain>/s/and the tracker athttps://<your-experience-site-domain>/s/ticket-status?id=<EAM-ID>.
- Navigate to the Experience Cloud site and fill out the mobile-responsive form (category, asset type, severity, description, email, Leaflet.js map location, and optional photo uploads).
- The UI polls for the generated EAM Tracking ID and displays it.
- The submitter receives an automated email containing a deep-link to track the ticket at
/s/ticket-status?id=<EAM-ID>.
Internal Service Cloud Triage
- Internal supervisors log into the Salesforce Service Console and set their Omni-Channel presence status to "Available - Asset Issues".
- Incoming
Asset_Issue__crecords are automatically routed to the correct departmental queues and pushed to available agents via Omni-Channel. - Supervisors utilize the Asset Triage Dashboard (LWC) on the
Asset_Issue__cRecord Page to view the issue's spatial location on alightning-mapalongside nearby historical maintenance data (same asset type, within 2 miles). - Supervisors dispatch the ticket, triggering a Queueable Apex job that syncs the dispatch status (PATCH) to the external EAM system.
- External EAM updates are received via REST API (
PATCH /EAM/StatusUpdate/*), triggering status update emails back to the citizen.
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change. Please make sure to update tests as appropriate.