Architecture

High-level overview of the Westside Basketball platform.

System Overview

graph TD Browser[Client Browser] --> WD[westside-docs] Browser --> WA[westside-app] WD --> KC[Keycloak SSO] WA --> KC WA --> PG[PostgreSQL — CNPG] KC --> PE[pal-enterprises]

Client Dashboard

Marcus logs into pal-enterprises and sees his dashboard with these links:

flowchart LR PE[pal-enterprises] --> DOCS[westside-docs] PE --> AGENCY[westside-agency] PE --> APP[westside-app] DOCS --- D1[Contract & user stories] AGENCY --- A1[Kanban & project page] APP --- AP1[Public site + admin]

Deployment

All services run on the pal-e k3s cluster with Tailscale funnel for public URLs.

flowchart TD DEV[Local directory] -->|hostPath mount| POD[k3s Pod] POD --> SVC[Service] SVC --> ING[Tailscale Ingress] ING --> URL[westside-docs.tail5b443a.ts.net]