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, CS Tools 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, tools, 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, tools, 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, CS Tools 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