Trasversale · Workspace · Active
platform-local-stack
Single local bootstrap entrypoint for the workspace, centralizing host routing, infra provisioning, observability and start-stop lifecycle scripts.
- Node.js scripts
- Docker Compose
- http-proxy
- Loki
- Grafana
- Promtail
- pgAdmin
Spec sheet
Role
Canonical local entrypoint
Proxy
Host-based reverse proxy on port 8080
Infra
Auth Postgres, Agent Postgres, SFDC Postgres, Funnel Postgres, CS Chat Postgres, Transaction Postgres, Redis, pgAdmin, Loki, Grafana, Promtail
Commands
check-paths, start:dev, stop:dev, status
Host map
auth, ai, agent, mcp, wiki, status, sfdc, funnel, portal, chat, transactions, pgadmin, grafana, loki, promtail
Responsibilities
- Resolve canonical sibling repo paths.
- Bring up shared Docker services for products and Core services.
- Inject environment conventions and route public hosts to local processes.
- Collect runtime and Docker logs for observability.
- Expose profile-based startup for core, mcp, funnel, sfdc, portal, chat, transactions, status, wiki and observability subsets.
Interfaces and contract surface
- npm run check-paths
- npm run print-layout
- npm run start:dev
- npm run stop:dev
- npm run status
Consumers
Dependencies and external touchpoints
- Docker Desktop
- Node.js >= 22
Notes
- This repo is the only canonical local bootstrap path for the workspace.
- Promtail collects both host-managed runtime logs and Docker container logs.
- The full profile now includes MCP, Agent, Status, CS Portal, CS Chat and CS Transaction Manage services in addition to the original Core and Experience processes.
Source references
platform-local-stack/README.mdREADME.mdplatform-local-stack/package.json