How Plansight connects to the rest of the stack

Audit pages for the systems Plansight integrates with — what they do, how they're wired, what's confirmed, what needs a verify, and what's still pending.

Source: Plansight Dev / Bit Bucket Repos Refreshed: Weekly from Bitbucket pulls Audience: Plansight team

How it all fits together

Plansight in the middle, the integrations around it. Arrows show data direction. Bright Benefits sits downstream of the Open API as a partner consumer. Click any node to open its page.

Plansight integrations hub and spoke diagram Open API Bright Benefits — pulls sold plan data
Inbound (data into Plansight)
Outbound (data out of Plansight)
Bi-directional
Downstream (via API)

The integrations

Each card opens the full audit. Status reflects how deep the audit currently goes.

BenefitPoint

BenefitPoint

app/integrations/BenefitPoint/ · BenefitPointController.php

Broker management system integration. Bi-directional sync with Vertafore's broker platform. Includes a filterable sync map covering every plan type, product type, and benefit attribute.

Audited Overview + Sync Map
Planfacts / Open Plan

Planfacts / Open Plan Plansight-internal

app/Services/PlanfactService.php · 10 benefit parsers

AI-powered benefit document parsing (PDF → structured data). Two services: Planfacts API + OpenPlan. 1 confirmed bug, 4 likely-bug items, ~30 small items across 10 benefit types.

4 items 10 benefit pages
Employee Navigator

Employee Navigator

app/integrations/EmployeeNavigator/ · EmployeeNavigatorClientProvider.php

Benefits enrollment platform — bi-directional. Push elected plans + employer profile to EN. Pull census directly into community-rated RFPs. OAuth 2.0 with operation-pattern dispatcher. Includes a filterable sync map covering 83 fields across the census + plan-push flows.

6 items Push + Pull flows
IDEON

IDEON formerly Vericred

VericredParseService.php · code still uses Vericred name

Inbound — plan + rate data engine for ACA / community-rated quoting. ~65 plan attributes parsed; rates by rating area; benefit summary PDFs virus-scanned to S3. Working with 6 items — regex fragility, silent PDF fallback worth attention.

6 items Naming rebrand pending
Plansight Open API

Plansight Open API

app/Http/Controllers/ApiController.php · routes/api.php · swagger-api.json

Outbound — partner systems call into Plansight. Read-only today (employer list, plan types, plans by type). Bearer token auth, brokerage-isolated, Elasticsearch-backed search, manual OpenAPI spec. Strategic items: deprecation policy, write support, webhooks.

6 items Read-only · 5 endpoints
Bright Benefits

Bright Benefits via Open API

Downstream consumer · Plansight Open API

Bright Benefits pulls sold plan data (medical, dental, vision) directly from the Plansight Open API. Activation flow: user creates credentials and a benefit in Plansight, then enables Bright Benefits to consume that data.

Partner Reads via Open API
Other services

Other integrations & services

Internal infrastructure inventory

Auth, email, AI, AWS, observability, document processing, and more — the third-party services that run Plansight under the hood. Plus deprecated services worth cleaning up.

Inventory 21 active · 7 retired

A single source of truth for "how does Plansight talk to X?"

Each integration deserves a clear, current document of what it does and where the rough edges are. This site is that document.

The audit pattern

Each integration page documents: what it does, where it lives in code, the data shape that flows in or out, what's mapped, what's not mapped (intentional vs. missed), what's potentially mapped incorrectly, and a list of small concrete recommendations. Cursor-ready prompts inline so the dev can paste them straight in to investigate.

Plan Facts is the worked example — the deepest audit on the site (10 benefit type sub-pages, API ground-truth confirmations from OpenPlan + Planfacts API, 4 confirmed bugs with Cursor prompts). Other integrations follow the same pattern at appropriate depth.


How it gets refreshed

Each Bitbucket pull triggers a regen. Every page footer stamps the source commit so the version is always clear.

1

Pull fresh repos from Bitbucket

Run python3 scripts/pull-repos.py from the project root — pulls all 4 Bitbucket repos via the configured app password.

2

Open this project in Claude Code

Say "regenerate the audit." Claude reads BUILD.md for the procedure and source/analysis-notes.md for previous commit hashes.

3

Recompute findings

Diff against the previous hashes. Re-run the per-integration agents. Update only the pages that changed. Append a row to the version table.

4

Push to GitHub

Vercel auto-deploys to integrations.plansight.com. New version is live in under a minute.


Who reads what

Three readers, three different ways into the content.

Plansight developers

Per-integration pages have copy-pasteable Cursor prompts inline for any flagged item. Open the page, find the issue, paste the prompt into Cursor.

Technical team / leadership

The dashboard shows status at a glance — green / amber / red badges, item counts, summary text. Skim the cards, click into anything that needs attention.

Steve

Source of truth for "what does the integration actually do today, and where are the rough edges?" — for product decisions, customer conversations, roadmap planning.