Platform

An Atlassian-based, multi-department AI workflow automation platform. Webhook gateway, Temporal workers, MCP integration, an admin dashboard and a Streamlit front end, all in a single Docker Compose stack.

Quick Start

For a first-time setup we recommend bootstrap-only mode: only the admin-dashboard and its dependencies start; every other service is activated on demand, under operator control, from the Setup Wizard inside the dashboard.

cd platform
# infra/.env carries the bootstrap values (Postgres, Vault, host ports, LLM).
# It is git-ignored, so create it on a fresh clone before the first boot.
make boot               # starts postgres + vault + admin-dashboard-{api,ui}

Then open the dashboard in your browser:

http://localhost:33000

The Setup Wizard brings up the remaining services step by step and, on the final step, asks you to add the first department.

Full walkthrough: docs/runbooks/getting-started.md.

If make is not installed (the Windows default):

.\scripts\up.ps1 boot

or, on a POSIX shell:

./scripts/up.sh boot

Published host ports

Every service always listens on a fixed container port internally; only the host-published port is configurable, so a deployment can avoid clashes with other software on the same machine. All host ports are defined once in infra/.env (*_HOST_PORT variables) - change a value there and re-run docker compose up -d. Never edit the Compose file or application source.

Service	Host port	Env variable
Admin Dashboard (UI)	33000	ADMIN_DASHBOARD_UI_HOST_PORT
Admin Dashboard API	38082	ADMIN_DASHBOARD_API_HOST_PORT
Streamlit (chat)	38501	STREAMLIT_HOST_PORT
Atlassian MCP	38090	ATLASSIAN_MCP_HOST_PORT
assistant-service	38081	ASSISTANT_SERVICE_HOST_PORT
automation-service	38084	AUTOMATION_SERVICE_HOST_PORT
task-intake-service	38083	TASK_INTAKE_HOST_PORT
Postgres	35432	POSTGRES_HOST_PORT
Redis	36379	REDIS_HOST_PORT
Vault	38200	VAULT_HOST_PORT
Temporal (gRPC)	37233	TEMPORAL_HOST_PORT
Temporal UI	38233	TEMPORAL_UI_HOST_PORT
Firecrawl	33002	FIRECRAWL_HOST_PORT
MinIO (API / console)	39000 / 39001	MINIO_HOST_PORT / MINIO_CONSOLE_HOST_PORT
Traefik (HTTP / HTTPS)	8044 / 8444	- (edit Compose)

For day-to-day use you only need 33000 (dashboard) and 38501 (Streamlit chat).

Common commands

Command	Behavior
make boot	Bootstrap-only (default - postgres, vault, admin-dashboard).
make up	Alias for make boot (backward compatibility).
make up-all	Start every service at once (CI / debug). Not for production.
make ps	List running services.
make logs	Tail logs of the active services.
make down	Stop all containers (volumes preserved).
make restart	make down + make boot.
make profiles	Print the profile list derived from the manifest.
make help	Show all targets and their descriptions.

Note on make up-all: it starts all services at once (for CI tests and full-stack debugging). Do not use it on the first boot - launching 12 services in parallel before credentials are entered produces "started in the wrong order" errors. Follow the make boot + Setup Wizard flow instead.

Directory layout

Path	Contents
infra/	Docker Compose files (docker-compose.yml, docker-compose.dev.yml) and Postgres migrations.
services/	HTTP services - automation-service, assistant-service, admin-dashboard-api, atlassian-mcp (gateway).
workers/	Temporal workers - automation-worker, agent-runner-worker, execution-runner-worker.
ui/	Front ends - admin-dashboard (Next.js), streamlit-app (Streamlit).
libs/	Shared Python libraries (vault_client, audit, llm_client, etc.).
config/	Manifest files - services.manifest.json, departments.json and their schemas.
prompts/	LLM prompts - task_creation_assistant, assistant_chat, notification templates.
docs/	Runbooks, user guide, env reference.
tests/	Cross-service property/integration tests (each service also has its own tests/).
scripts/	up.sh, up.ps1 wrappers + maintenance scripts.

Next steps

• First-boot flow: docs/runbooks/getting-started.md.
• Webhook setup: docs/runbooks/webhook-setup.md.
• Department decommission: docs/runbooks/dept-decommission.md.
• Environment variables: docs/env-reference.md.
• End-user task-creation guide: docs/user-guide/.

License / Contributing

This repository is for private use. For the development workflow, read the spec documents under and the architecture decisions in.