Experience · Repository · Active

sfdc-external

Salesforce-oriented product repository that keeps the backend as public BFF while delegating auth and connector runtime to shared Core services and owning metadata, reports and dashboard UX.

• NestJS
• Prisma
• PostgreSQL
• React 19
• Vite
• Tailwind

Spec sheet

Area

Experience / External SFDC

Public host

http://sfdc.cs.lvh.me:8080

Runtime shape

Frontend + NestJS BFF + shared package

Data store

Dedicated PostgreSQL

Salesforce access

Delegated to platform-connectors-service

Responsibilities

• Expose the product-specific BFF and public same-origin API.
• Own ACL, visibility, apps catalog, metadata, reporting and dashboards.
• Keep frontend traffic same-origin and never direct-to-Salesforce.
• Resolve contact lookups and runtime report/dashboard execution through backend-owned contracts.
• Reuse shared auth and shared connector boundaries from Core.

Interfaces and contract surface

• Same-origin /api surface
• Frontend route-guarded UI

Internal modules

Backend

sfdc backend

NestJS BFF for External SFDC, acting as the public product boundary while orchestrating auth, datasource, metadata, reporting and visibility services.

Frontend

sfdc frontend

React and Vite frontend for External SFDC, consuming only same-origin product APIs and shared route catalog helpers.

Package

sfdc shared

Internal package used by the External SFDC monorepo to share route catalog and type-level helpers between backend and frontend.

Consumers

• End users via sfdc host

Dependencies and external touchpoints

• platform-auth-service
• platform-connectors-service
• platform-local-stack

Notes

• The backend remains the public boundary for product contracts.
• All Salesforce runtime logic is intentionally centralized outside this repo.

Source references

• sfdc-external/README.md
• docs/architecture-current.md
• sfdc-external/package.json
• sfdc-external/backend/package.json
• sfdc-external/frontend/package.json
• sfdc-external/shared/package.json