Architecture Overview

Mon, 01 Jan 0001 00:00:00 +0000

Architecture Overview

psLens has only two moving parts:

The SWS framework, a small Integration Broker service installed inside your PeopleSoft environment.
The psLens application, a single Docker container hosted externally (default: fly.io) or on your own infrastructure.

Everything psLens displays (search results, alerts, reports) flows over a single HTTPS connection from the psLens container into your SWS endpoint. There is no other channel.

The Short Version

Two components, nothing else. SWS inside PeopleSoft; psLens as a Docker container outside it.
Traffic only flows one way. psLens calls SWS over HTTPS. SWS never reaches out to psLens.
One protocol. REST + HTTP basic auth + psoftQL JSON queries. No database drivers, no ODBC, no jump hosts.
One scope. SWS only answers queries against PeopleTools metadata tables that you whitelist. Anything outside the list is rejected before it touches the database.
Dedicated deployment per customer. No shared psLens app, no shared storage, no multi-tenant SaaS backend.

How the Pieces Fit

%%{init: {"flowchart": {"htmlLabels": true, "padding": 16, "nodeSpacing": 60, "rankSpacing": 80, "subGraphTitleMargin": {"top": 10, "bottom": 14}}}}%%
flowchart LR
 USER(["Your team's<br/>web browser"])
 subgraph EXT["Cedar Hills Group hosted or your own infrastructure"]
 APP["psLens<br/>Docker container"]
 end
 subgraph PS["Your PeopleSoft Environment"]
 SWS["SWS Framework<br/>REST endpoint"]
 DB[("PeopleSoft DB<br/>read-only<br/>whitelisted tables")]
 SWS --> DB
 end
 USER -- "HTTPS" --> APP
 APP -- "HTTPS · Basic auth<br/>psoftQL JSON" --> SWS

 classDef ps fill:#e8f4fd,stroke:#0d6efd,stroke-width:2px,color:#000
 classDef ext fill:#fff5e6,stroke:#fd7e14,stroke-width:2px,color:#000
 classDef user fill:#e9f7ef,stroke:#198754,stroke-width:2px,color:#000
 classDef subgraphStyle fill:#fafafa,stroke:#666,stroke-width:1px,color:#000
 class SWS,DB ps
 class APP ext
 class USER user
 class PS,EXT subgraphStyle

Your team reaches psLens with any current web browser over HTTPS. There is no desktop client to install. Everything the user sees comes from the psLens container; the browser never talks to PeopleSoft directly.

Architecture on psLens

Architecture Overview

Architecture Overview

The Short Version

How the Pieces Fit