Experience · Repository · Active

cs-portal

Codestorm operations portal for HR, administration, documents, productivity integrations and Salesforce-backed operational workflows.

• NestJS
• React 18
• Vite
• Tailwind
• Google APIs
• Microsoft Graph
• pdf-lib

Spec sheet

Area

Experience / Portal

Public host

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

Runtime shape

Frontend + NestJS BFF

Backend port

3003

Frontend port

5177

Datasource access

Delegated to platform-connectors-service

Responsibilities

• Own HR, administration, payroll, document and productivity workflows.
• Expose a product BFF that wraps platform auth and platform connectors behind same-origin /api routes.
• Use structured Salesforce lookup endpoints instead of browser-authored raw SOQL.
• Keep large page and service implementations split into runtime modules and thin exported wrappers.

Interfaces and contract surface

• Same-origin /api surface
• GET /api/health
• Frontend React routes

Internal modules

Backend

cs-portal backend

NestJS BFF for CS Portal, owning HR, administration, document and productivity workflows while delegating shared auth and Salesforce access to Core services.

Frontend

cs-portal frontend

React and Vite frontend for CS Portal, rendering HR, operations, administration, documents and lookup workflows through same-origin APIs.

Consumers

• Internal Codestorm operators via portal host

Dependencies and external touchpoints

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

Notes

• The backend is the only layer allowed to talk to Core services; the frontend remains same-origin.
• Recent commits extracted heavy backend services and React pages into runtime modules to keep wrappers smaller.

Source references

• cs-portal/README.md
• cs-portal/AGENTS.md
• cs-portal/package.json
• cs-portal/backend/package.json
• cs-portal/frontend/package.json
• cs-portal/docs/backend-api-map.md