Skip to main content

Devlog: 2026-03-17 — PSX BestEx Integration Proposal

What Happened​

Product Owner identified a strategic integration opportunity: allow PowerSeller X to call the PSSaaS BestEx API so principals can compare agency delivery (BestEx) alongside marketplace pricing (PSX) in a unified analysis.

What Was Produced​

  • ADR-019 (Proposed): Architectural decision for PSX-to-SaaS integration covering authentication (OAuth2 client credentials), tenant resolution, and ephemeral loan data approach
  • Integration Spec (Draft): Endpoint design (POST /api/bestex/integration/analyze), data mapping between PSX NormalizedLoan and PSSaaS format, request/response contracts, acceptance criteria

Key Design Decisions​

  • Loans sent by PSX are ephemeral -- not persisted in the tenant's loan table
  • The full 24-step BestEx pipeline runs without shortcuts
  • Simplified 16-field loan payload (subset of what BestEx needs)
  • Top-N ranked results returned per loan (default 5) to manage payload size
  • Machine-to-machine OAuth2, no user context needed

Status​

Both documents are Proposed/Draft -- awaiting Product Owner review. This is a cross-product decision that may warrant broader team discussion.

What's Next​

  • Product Owner reviews and approves (or revises) both documents
  • If approved, implement the integration endpoint in PSSaaS
  • Coordinate with the PowerSeller X project for the client-side integration